chore: upgrade all @objectstack/* dependencies from ^2.0.7 to ^3.0.0

Copilot · hotlong · Copilot · commit aee9b70c5e58 · 2026-02-12T07:28:52.000Z
Breaking changes addressed:
- Hub namespace renamed to Cloud in @objectstack/spec
- definePlugin removed from @objectstack/spec
- PaginatedResult.value → PaginatedResult.records in @objectstack/client
- PaginatedResult.count → PaginatedResult.total in @objectstack/client
- client.meta.getObject() → client.meta.getItem('object', name)

Co-authored-by: hotlong &lt;50353452+hotlong@users.noreply.github.com&gt;
diff --git a/apps/console/package.json b/apps/console/package.json
@@ -52,20 +52,20 @@
     "@object-ui/plugin-view": "workspace:*",
     "@object-ui/react": "workspace:*",
     "@object-ui/types": "workspace:*",
-    "@objectstack/client": "^2.0.7",
-    "@objectstack/driver-memory": "^2.0.7",
-    "@objectstack/objectql": "^2.0.7",
-    "@objectstack/plugin-msw": "^2.0.7",
-    "@objectstack/runtime": "^2.0.7",
-    "@objectstack/spec": "^2.0.7",
+    "@objectstack/client": "^3.0.0",
+    "@objectstack/driver-memory": "^3.0.0",
+    "@objectstack/objectql": "^3.0.0",
+    "@objectstack/plugin-msw": "^3.0.0",
+    "@objectstack/runtime": "^3.0.0",
+    "@objectstack/spec": "^3.0.0",
     "lucide-react": "^0.563.0",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
     "react-router-dom": "^7.13.0",
     "sonner": "^2.0.7"
   },
   "devDependencies": {
-    "@objectstack/cli": "^2.0.7",
+    "@objectstack/cli": "^3.0.0",
     "@tailwindcss/postcss": "^4.1.18",
     "@testing-library/jest-dom": "^6.6.3",
     "@testing-library/react": "^16.1.0",
diff --git a/examples/crm/package.json b/examples/crm/package.json
@@ -15,14 +15,14 @@
     "start": "tsx server.ts"
   },
   "dependencies": {
-    "@objectstack/core": "^2.0.7",
-    "@objectstack/plugin-auth": "^2.0.7",
-    "@objectstack/runtime": "^2.0.7",
-    "@objectstack/spec": "^2.0.7",
+    "@objectstack/core": "^3.0.0",
+    "@objectstack/plugin-auth": "^3.0.0",
+    "@objectstack/runtime": "^3.0.0",
+    "@objectstack/spec": "^3.0.0",
     "pino": "^8.21.0"
   },
   "devDependencies": {
-    "@objectstack/cli": "^2.0.7",
+    "@objectstack/cli": "^3.0.0",
     "typescript": "^5.0.0"
   }
 }
diff --git a/examples/kitchen-sink/package.json b/examples/kitchen-sink/package.json
@@ -14,10 +14,10 @@
     "build": "objectstack compile objectstack.config.ts"
   },
   "dependencies": {
-    "@objectstack/spec": "^2.0.7"
+    "@objectstack/spec": "^3.0.0"
   },
   "devDependencies": {
-    "@objectstack/cli": "^2.0.7",
+    "@objectstack/cli": "^3.0.0",
     "typescript": "^5.0.0"
   }
 }
diff --git a/examples/msw-todo/package.json b/examples/msw-todo/package.json
@@ -11,12 +11,12 @@
   },
   "dependencies": {
     "@object-ui/example-todo": "workspace:*",
-    "@objectstack/client": "^2.0.7",
-    "@objectstack/driver-memory": "^2.0.7",
-    "@objectstack/objectql": "^2.0.7",
-    "@objectstack/plugin-msw": "^2.0.7",
-    "@objectstack/runtime": "^2.0.7",
-    "@objectstack/spec": "^2.0.7",
+    "@objectstack/client": "^3.0.0",
+    "@objectstack/driver-memory": "^3.0.0",
+    "@objectstack/objectql": "^3.0.0",
+    "@objectstack/plugin-msw": "^3.0.0",
+    "@objectstack/runtime": "^3.0.0",
+    "@objectstack/spec": "^3.0.0",
     "react": "^18.3.1",
     "react-dom": "^18.3.1"
   },
diff --git a/examples/msw-todo/src/components/TaskList.tsx b/examples/msw-todo/src/components/TaskList.tsx
@@ -37,7 +37,7 @@ export function TaskList({ client, onEdit, refreshTrigger }: TaskListProps) {
       });
 
       // Handle both { value: [] } (OData) and [] (Raw) formats
-      const rawValues = Array.isArray(result) ? result : (result.value || []);
+      const rawValues = Array.isArray(result) ? result : (result.records || []);
       const fetchedTasks = [...rawValues] as Task[];
       
       // Client-side sort fallback (since InMemoryDriver has limited sort support)
diff --git a/examples/todo/package.json b/examples/todo/package.json
@@ -12,11 +12,11 @@
     "build": "objectstack compile objectstack.config.ts"
   },
   "dependencies": {
-    "@objectstack/client": "^2.0.7",
-    "@objectstack/spec": "^2.0.7"
+    "@objectstack/client": "^3.0.0",
+    "@objectstack/spec": "^3.0.0"
   },
   "devDependencies": {
-    "@objectstack/cli": "^2.0.7",
+    "@objectstack/cli": "^3.0.0",
     "typescript": "^5.0.0"
   }
 }
diff --git a/examples/todo/src/client-test.ts b/examples/todo/src/client-test.ts
@@ -16,7 +16,7 @@ async function main() {
 
     // 3. Get Metadata
     console.log('🔍 Fetching Object Metadata for "todo_task"...');
-    const objectMeta = await client.meta.getObject('todo_task');
+    const objectMeta = await client.meta.getItem('object', 'todo_task');
     console.log(`📋 Object Label: ${objectMeta.label}`);
 
     // 4. Query Data
@@ -26,8 +26,8 @@ async function main() {
        sort: 'status'
     });
     
-    console.log(`🎉 Found ${result.count} tasks:`);
-    result.value.forEach((task: any) => {
+    console.log(`🎉 Found ${result.total} tasks:`);
+    result.records.forEach((task: any) => {
       console.log(` - [${task.is_completed ? 'x' : ' '}] ${task.subject} (Priority: ${task.priority})`);
     });
 
@@ -64,8 +64,8 @@ async function main() {
         },
         sort: ['-priority']
     });
-    console.log(`🎉 Found ${advancedResult.count} high priority tasks:`);
-    advancedResult.value.forEach((task: any) => {
+    console.log(`🎉 Found ${advancedResult.total} high priority tasks:`);
+    advancedResult.records.forEach((task: any) => {
         console.log(` - ${task.subject} (P${task.priority}) [Has keys: ${Object.keys(task).join(', ')}]`);
     });
 
diff --git a/package.json b/package.json
@@ -73,13 +73,13 @@
   "devDependencies": {
     "@changesets/cli": "^2.29.8",
     "@eslint/js": "^9.39.1",
-    "@objectstack/cli": "^2.0.7",
-    "@objectstack/core": "^2.0.7",
-    "@objectstack/driver-memory": "^2.0.7",
-    "@objectstack/objectql": "^2.0.7",
-    "@objectstack/plugin-msw": "^2.0.7",
-    "@objectstack/runtime": "^2.0.7",
-    "@objectstack/spec": "^2.0.7",
+    "@objectstack/cli": "^3.0.0",
+    "@objectstack/core": "^3.0.0",
+    "@objectstack/driver-memory": "^3.0.0",
+    "@objectstack/objectql": "^3.0.0",
+    "@objectstack/plugin-msw": "^3.0.0",
+    "@objectstack/runtime": "^3.0.0",
+    "@objectstack/spec": "^3.0.0",
     "@playwright/test": "^1.58.2",
     "@storybook/addon-essentials": "^8.6.14",
     "@storybook/addon-interactions": "^8.6.14",
@@ -137,7 +137,7 @@
   },
   "dependencies": {
     "@hono/node-server": "^1.19.9",
-    "@objectstack/plugin-hono-server": "^2.0.7",
+    "@objectstack/plugin-hono-server": "^3.0.0",
     "coverage-v8": "0.0.1-security",
     "hono": "^4.11.9",
     "pino": "^8.21.0",
diff --git a/packages/core/package.json b/packages/core/package.json
@@ -31,7 +31,7 @@
   },
   "dependencies": {
     "@object-ui/types": "workspace:*",
-    "@objectstack/spec": "^2.0.7",
+    "@objectstack/spec": "^3.0.0",
     "lodash": "^4.17.23",
     "zod": "^4.3.6"
   },
diff --git a/packages/data-objectstack/package.json b/packages/data-objectstack/package.json
@@ -30,7 +30,7 @@
   "dependencies": {
     "@object-ui/core": "workspace:*",
     "@object-ui/types": "workspace:*",
-    "@objectstack/client": "^2.0.7"
+    "@objectstack/client": "^3.0.0"
   },
   "devDependencies": {
     "tsup": "^8.0.1",
diff --git a/packages/data-objectstack/src/index.ts b/packages/data-objectstack/src/index.ts
@@ -268,14 +268,16 @@ export class ObjectStackAdapter<T = unknown> implements DataSource<T> {
       };
     }
 
-    const resultObj = result as { value?: T[]; count?: number };
+    const resultObj = result as { records?: T[]; total?: number; value?: T[]; count?: number };
+    const records = resultObj.records || resultObj.value || [];
+    const total = resultObj.total ?? resultObj.count ?? records.length;
     return {
-      data: resultObj.value || [],
-      total: resultObj.count || (resultObj.value ? resultObj.value.length : 0),
+      data: records,
+      total,
       // Calculate page number safely
       page: params?.$skip && params.$top ? Math.floor(params.$skip / params.$top) + 1 : 1,
       pageSize: params?.$top,
-      hasMore: params?.$top ? (resultObj.value?.length || 0) === params.$top : false,
+      hasMore: params?.$top ? records.length === params.$top : false,
     };
   }
 
@@ -557,7 +559,7 @@ export class ObjectStackAdapter<T = unknown> implements DataSource<T> {
     try {
       // Use cache with automatic fetching
       const schema = await this.metadataCache.get(objectName, async () => {
-        const result: any = await this.client.meta.getObject(objectName);
+        const result: any = await this.client.meta.getItem('object', objectName);
         
         // Unwrap 'item' property if present (common API response wrapper)
         if (result && result.item) {
diff --git a/packages/plugin-charts/src/ObjectChart.tsx b/packages/plugin-charts/src/ObjectChart.tsx
@@ -28,8 +28,8 @@ export const ObjectChart = (props: any) => {
             if (Array.isArray(results)) {
                 data = results;
             } else if (results && typeof results === 'object') {
-                if (Array.isArray((results as any).value)) {
-                    data = (results as any).value;
+                if (Array.isArray((results as any).records)) {
+                    data = (results as any).records;
                 }
             }
 
diff --git a/packages/plugin-gantt/package.json b/packages/plugin-gantt/package.json
@@ -36,7 +36,7 @@
     "@object-ui/fields": "workspace:*",
     "@object-ui/react": "workspace:*",
     "@object-ui/types": "workspace:*",
-    "@objectstack/spec": "^2.0.7",
+    "@objectstack/spec": "^3.0.0",
     "lucide-react": "^0.563.0"
   },
   "peerDependencies": {
diff --git a/packages/plugin-gantt/src/ObjectGantt.tsx b/packages/plugin-gantt/src/ObjectGantt.tsx
@@ -180,8 +180,8 @@ export const ObjectGantt: React.FC<ObjectGanttProps> = ({
           } else if (result && typeof result === 'object') {
              if (Array.isArray((result as any).data)) {
                 items = (result as any).data; 
-             } else if (Array.isArray((result as any).value)) {
-                items = (result as any).value;
+             } else if (Array.isArray((result as any).records)) {
+                items = (result as any).records;
              }
           }
           setData(items);
diff --git a/packages/plugin-list/src/ListView.tsx b/packages/plugin-list/src/ListView.tsx
@@ -178,8 +178,8 @@ export const ListView: React.FC<ListViewProps> = ({
         } else if (results && typeof results === 'object') {
            if (Array.isArray((results as any).data)) {
               items = (results as any).data; 
-           } else if (Array.isArray((results as any).value)) {
-              items = (results as any).value;
+           } else if (Array.isArray((results as any).records)) {
+              items = (results as any).records;
            }
         }
         
diff --git a/packages/plugin-list/src/ObjectGallery.tsx b/packages/plugin-list/src/ObjectGallery.tsx
@@ -81,8 +81,8 @@ export const ObjectGallery: React.FC<ObjectGalleryProps> = (props) => {
                     data = results;
                 } else if (results && typeof results === 'object') {
                     const r = results as Record<string, unknown>;
-                    if (Array.isArray(r.value)) {
-                        data = r.value as Record<string, unknown>[];
+                    if (Array.isArray(r.records)) {
+                        data = r.records as Record<string, unknown>[];
                     } else if (Array.isArray(r.data)) {
                         data = r.data as Record<string, unknown>[];
                     }
diff --git a/packages/plugin-map/package.json b/packages/plugin-map/package.json
@@ -35,7 +35,7 @@
     "@object-ui/core": "workspace:*",
     "@object-ui/react": "workspace:*",
     "@object-ui/types": "workspace:*",
-    "@objectstack/spec": "^2.0.7",
+    "@objectstack/spec": "^3.0.0",
     "lucide-react": "^0.563.0",
     "maplibre-gl": "^5.17.0",
     "react-map-gl": "^8.1.0",
diff --git a/packages/plugin-map/src/ObjectMap.tsx b/packages/plugin-map/src/ObjectMap.tsx
@@ -283,8 +283,8 @@ export const ObjectMap: React.FC<ObjectMapProps> = ({
           } else if (result && typeof result === 'object') {
              if (Array.isArray((result as any).data)) {
                 items = (result as any).data; 
-             } else if (Array.isArray((result as any).value)) {
-                items = (result as any).value;
+             } else if (Array.isArray((result as any).records)) {
+                items = (result as any).records;
              }
           }
           setData(items);
diff --git a/packages/plugin-timeline/package.json b/packages/plugin-timeline/package.json
@@ -35,7 +35,7 @@
     "@object-ui/core": "workspace:*",
     "@object-ui/react": "workspace:*",
     "@object-ui/types": "workspace:*",
-    "@objectstack/spec": "^2.0.7",
+    "@objectstack/spec": "^3.0.0",
     "zod": "^4.3.6"
   },
   "peerDependencies": {
diff --git a/packages/plugin-timeline/src/ObjectTimeline.tsx b/packages/plugin-timeline/src/ObjectTimeline.tsx
@@ -73,8 +73,8 @@ export const ObjectTimeline: React.FC<ObjectTimelineProps> = ({
                 options: { $top: 100 }
             });
             let data = results;
-            if ((results as any).value) {
-                data = (results as any).value;
+            if ((results as any).records) {
+                data = (results as any).records;
             } else if ((results as any).data) {
                 data = (results as any).data;
             }
diff --git a/packages/plugin-view/src/ObjectView.tsx b/packages/plugin-view/src/ObjectView.tsx
@@ -320,8 +320,8 @@ export const ObjectView: React.FC<ObjectViewProps> = ({
         } else if (results && typeof results === 'object') {
           if (Array.isArray((results as any).data)) {
             items = (results as any).data;
-          } else if (Array.isArray((results as any).value)) {
-            items = (results as any).value;
+          } else if (Array.isArray((results as any).records)) {
+            items = (results as any).records;
           }
         }
 
diff --git a/packages/react/package.json b/packages/react/package.json
@@ -32,7 +32,7 @@
     "@object-ui/core": "workspace:*",
     "@object-ui/i18n": "workspace:*",
     "@object-ui/types": "workspace:*",
-    "@objectstack/spec": "^2.0.7",
+    "@objectstack/spec": "^3.0.0",
     "react-hook-form": "^7.71.1"
   },
   "peerDependencies": {
diff --git a/packages/types/package.json b/packages/types/package.json
@@ -82,7 +82,7 @@
     "directory": "packages/types"
   },
   "dependencies": {
-    "@objectstack/spec": "^2.0.7",
+    "@objectstack/spec": "^3.0.0",
     "zod": "^4.3.6"
   },
   "devDependencies": {
diff --git a/packages/types/src/__tests__/namespace-exports.test.ts b/packages/types/src/__tests__/namespace-exports.test.ts
@@ -1,9 +1,9 @@
 /**
- * Test to verify ObjectStack Spec v2.0.1 namespace exports
+ * Test to verify ObjectStack Spec v3.0.0 namespace exports
  */
 import { describe, it, expect } from 'vitest';
 
-describe('ObjectStack Spec v2.0.1 Namespace Exports', () => {
+describe('ObjectStack Spec v3.0.0 Namespace Exports', () => {
   it('should export Data namespace', async () => {
     const types = await import('../index');
     // Data namespace should exist and have content
@@ -13,9 +13,8 @@ describe('ObjectStack Spec v2.0.1 Namespace Exports', () => {
   it('should export UI types via spec', async () => {
     // Verify that types can be imported from @object-ui/types
     const types = await import('../index');
-    // defineStack and definePlugin should be exported
+    // defineStack should be exported
     expect(typeof types.defineStack).toBe('function');
-    expect(typeof types.definePlugin).toBe('function');
   });
 
   it('should export ObjectStack schemas', async () => {
diff --git a/packages/types/src/index.ts b/packages/types/src/index.ts
@@ -788,7 +788,7 @@ export type {
   System,
   AI,
   API,
-  Hub,
+  Cloud,
   Automation,
   Shared,
   QA,
@@ -801,14 +801,14 @@ export type {
 } from '@objectstack/spec';
 
 // ============================================================================
-// ObjectStack Protocol Utilities - defineStack, definePlugin
+// ObjectStack Protocol Utilities - defineStack
 // ============================================================================
 /**
  * Re-export ObjectStack Protocol utility functions and top-level types.
  *
  * @example
  * ```typescript
- * import { defineStack, definePlugin } from '@object-ui/types';
+ * import { defineStack } from '@object-ui/types';
  *
  * export default defineStack({
  *   manifest: { id: 'com.example.app', version: '1.0.0', type: 'app', name: 'My App' },
@@ -819,7 +819,6 @@ export type {
  */
 export {
   defineStack,
-  definePlugin,
   ObjectStackSchema,
   ObjectStackDefinitionSchema,
   ObjectStackCapabilitiesSchema,
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml

Original file line number	Diff line number	Diff line change
`@@ -14,10 +14,10 @@`
`14`	`14`	`"build": "objectstack compile objectstack.config.ts"`
`15`	`15`	`},`
`16`	`16`	`"dependencies": {`
`17`		`- "@objectstack/spec": "^2.0.7"`
	`17`	`+ "@objectstack/spec": "^3.0.0"`
`18`	`18`	`},`
`19`	`19`	`"devDependencies": {`
`20`		`- "@objectstack/cli": "^2.0.7",`
	`20`	`+ "@objectstack/cli": "^3.0.0",`
`21`	`21`	`"typescript": "^5.0.0"`
`22`	`22`	`}`
`23`	`23`	`}`