@objectstack/metadata 4.0.5 → 4.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@objectstack/metadata",
-  "version": "4.0.5",
+  "version": "4.1.0",
   "license": "Apache-2.0",
   "description": "Metadata loading, saving, and persistence for ObjectStack",
   "type": "module",
@@ -18,9 +18,9 @@
       "require": "./dist/node.cjs"
     },
     "./migrations": {
-      "types": "./dist/migrations/migrate-env-id-to-project-id.d.ts",
-      "import": "./dist/migrations/migrate-env-id-to-project-id.js",
-      "require": "./dist/migrations/migrate-env-id-to-project-id.cjs"
+      "types": "./dist/migrations/index.d.ts",
+      "import": "./dist/migrations/index.js",
+      "require": "./dist/migrations/index.cjs"
     }
   },
   "files": [
@@ -39,16 +39,16 @@
     "glob": "^13.0.6",
     "js-yaml": "^4.1.1",
     "zod": "^4.4.3",
-    "@objectstack/core": "4.0.5",
-    "@objectstack/platform-objects": "4.0.5",
-    "@objectstack/spec": "4.0.5",
-    "@objectstack/types": "4.0.5"
+    "@objectstack/core": "4.1.0",
+    "@objectstack/platform-objects": "4.1.0",
+    "@objectstack/spec": "4.1.0",
+    "@objectstack/types": "4.1.0"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "^25.6.2",
+    "@types/node": "^25.9.1",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.5"
+    "vitest": "^4.1.7"
   },
   "author": "ObjectStack",
   "repository": {

package/dist/migrations/migrate-env-id-to-project-id.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/migrations/migrate-env-id-to-project-id.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/**\n * Migration: env_id → project_id\n *\n * Renames the `env_id` column to `project_id` across all metadata tables:\n *   - sys_metadata\n *   - sys_metadata_history\n *   - sys_object\n *   - sys_view\n *   - sys_flow\n *   - sys_agent\n *   - sys_tool\n *\n * Safe to run multiple times (idempotent): checks for column existence before\n * attempting to rename. If `project_id` already exists, the step is skipped.\n *\n * Usage:\n *   import { migrateEnvIdToProjectId } from '@objectstack/metadata/migrations';\n *   await migrateEnvIdToProjectId(driver);\n */\n\nimport type { IDataDriver } from '@objectstack/spec/contracts';\n\nconst AFFECTED_TABLES = [\n    'sys_metadata',\n    'sys_metadata_history',\n    'sys_object',\n    'sys_view',\n    'sys_flow',\n    'sys_agent',\n    'sys_tool',\n] as const;\n\nexport interface MigrationResult {\n    table: string;\n    status: 'renamed' | 'already_done' | 'table_missing' | 'error';\n    error?: string;\n}\n\n/**\n * Rename `env_id` → `project_id` on all metadata tables.\n *\n * @param driver  An IDataDriver with access to the target database.\n *                Must expose a raw query method: `driver.raw(sql, bindings?)`.\n * @returns       Per-table migration results.\n */\nexport async function migrateEnvIdToProjectId(driver: IDataDriver): Promise<MigrationResult[]> {\n    const driverAny = driver as any;\n\n    if (typeof driverAny.raw !== 'function') {\n        throw new Error(\n            'migrateEnvIdToProjectId: driver must expose a .raw(sql, bindings?) method. ' +\n            'SqlDriver (better-sqlite3/knex) and TursoDriver both support this.'\n        );\n    }\n\n    const results: MigrationResult[] = [];\n\n    for (const table of AFFECTED_TABLES) {\n        try {\n            // Detect dialect: SQLite uses PRAGMA, others use information_schema.\n            const hasColumn = await _columnExists(driverAny, table, 'env_id');\n            const alreadyMigrated = await _columnExists(driverAny, table, 'project_id');\n\n            if (alreadyMigrated && !hasColumn) {\n                results.push({ table, status: 'already_done' });\n                continue;\n            }\n\n            if (!hasColumn) {\n                // Neither column exists — table might not exist yet.\n                results.push({ table, status: 'table_missing' });\n                continue;\n            }\n\n            // Perform the rename.  SQLite ≥ 3.25.0 supports ALTER TABLE RENAME COLUMN.\n            await driverAny.raw(`ALTER TABLE \"${table}\" RENAME COLUMN env_id TO project_id`);\n\n            results.push({ table, status: 'renamed' });\n        } catch (err: any) {\n            results.push({ table, status: 'error', error: err?.message ?? String(err) });\n        }\n    }\n\n    return results;\n}\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\nasync function _columnExists(driver: any, table: string, column: string): Promise<boolean> {\n    try {\n        // SQLite: PRAGMA table_info returns rows with `name` column.\n        const rows: any[] = await driver.raw(`PRAGMA table_info(\"${table}\")`);\n        if (Array.isArray(rows) && rows.length > 0) {\n            // knex wraps PRAGMA result; handle both `rows` and `rows[0]` shapes.\n            const list: any[] = Array.isArray(rows[0]) ? rows[0] : rows;\n            return list.some((r: any) => r?.name === column);\n        }\n\n        // Fallback for non-SQLite: query information_schema.\n        const result: any[] = await driver.raw(\n            `SELECT column_name FROM information_schema.columns WHERE table_name = ? AND column_name = ?`,\n            [table, column]\n        );\n        const list: any[] = Array.isArray(result[0]) ? result[0] : result;\n        return list.length > 0;\n    } catch {\n        return false;\n    }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAwBA,IAAM,kBAAkB;AAAA,EACpB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACJ;AAeA,eAAsB,wBAAwB,QAAiD;AAC3F,QAAM,YAAY;AAElB,MAAI,OAAO,UAAU,QAAQ,YAAY;AACrC,UAAM,IAAI;AAAA,MACN;AAAA,IAEJ;AAAA,EACJ;AAEA,QAAM,UAA6B,CAAC;AAEpC,aAAW,SAAS,iBAAiB;AACjC,QAAI;AAEA,YAAM,YAAY,MAAM,cAAc,WAAW,OAAO,QAAQ;AAChE,YAAM,kBAAkB,MAAM,cAAc,WAAW,OAAO,YAAY;AAE1E,UAAI,mBAAmB,CAAC,WAAW;AAC/B,gBAAQ,KAAK,EAAE,OAAO,QAAQ,eAAe,CAAC;AAC9C;AAAA,MACJ;AAEA,UAAI,CAAC,WAAW;AAEZ,gBAAQ,KAAK,EAAE,OAAO,QAAQ,gBAAgB,CAAC;AAC/C;AAAA,MACJ;AAGA,YAAM,UAAU,IAAI,gBAAgB,KAAK,sCAAsC;AAE/E,cAAQ,KAAK,EAAE,OAAO,QAAQ,UAAU,CAAC;AAAA,IAC7C,SAAS,KAAU;AACf,cAAQ,KAAK,EAAE,OAAO,QAAQ,SAAS,OAAO,KAAK,WAAW,OAAO,GAAG,EAAE,CAAC;AAAA,IAC/E;AAAA,EACJ;AAEA,SAAO;AACX;AAMA,eAAe,cAAc,QAAa,OAAe,QAAkC;AACvF,MAAI;AAEA,UAAM,OAAc,MAAM,OAAO,IAAI,sBAAsB,KAAK,IAAI;AACpE,QAAI,MAAM,QAAQ,IAAI,KAAK,KAAK,SAAS,GAAG;AAExC,YAAMA,QAAc,MAAM,QAAQ,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI;AACvD,aAAOA,MAAK,KAAK,CAAC,MAAW,GAAG,SAAS,MAAM;AAAA,IACnD;AAGA,UAAM,SAAgB,MAAM,OAAO;AAAA,MAC/B;AAAA,MACA,CAAC,OAAO,MAAM;AAAA,IAClB;AACA,UAAM,OAAc,MAAM,QAAQ,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI;AAC3D,WAAO,KAAK,SAAS;AAAA,EACzB,QAAQ;AACJ,WAAO;AAAA,EACX;AACJ;","names":["list"]}

package/dist/migrations/migrate-env-id-to-project-id.d.cts

@@ -1,37 +0,0 @@
-import { IDataDriver } from '@objectstack/spec/contracts';
-
-/**
- * Migration: env_id → project_id
- *
- * Renames the `env_id` column to `project_id` across all metadata tables:
- *   - sys_metadata
- *   - sys_metadata_history
- *   - sys_object
- *   - sys_view
- *   - sys_flow
- *   - sys_agent
- *   - sys_tool
- *
- * Safe to run multiple times (idempotent): checks for column existence before
- * attempting to rename. If `project_id` already exists, the step is skipped.
- *
- * Usage:
- *   import { migrateEnvIdToProjectId } from '@objectstack/metadata/migrations';
- *   await migrateEnvIdToProjectId(driver);
- */
-
-interface MigrationResult {
-    table: string;
-    status: 'renamed' | 'already_done' | 'table_missing' | 'error';
-    error?: string;
-}
-/**
- * Rename `env_id` → `project_id` on all metadata tables.
- *
- * @param driver  An IDataDriver with access to the target database.
- *                Must expose a raw query method: `driver.raw(sql, bindings?)`.
- * @returns       Per-table migration results.
- */
-declare function migrateEnvIdToProjectId(driver: IDataDriver): Promise<MigrationResult[]>;
-
-export { type MigrationResult, migrateEnvIdToProjectId };

package/dist/migrations/migrate-env-id-to-project-id.d.ts

@@ -1,37 +0,0 @@
-import { IDataDriver } from '@objectstack/spec/contracts';
-
-/**
- * Migration: env_id → project_id
- *
- * Renames the `env_id` column to `project_id` across all metadata tables:
- *   - sys_metadata
- *   - sys_metadata_history
- *   - sys_object
- *   - sys_view
- *   - sys_flow
- *   - sys_agent
- *   - sys_tool
- *
- * Safe to run multiple times (idempotent): checks for column existence before
- * attempting to rename. If `project_id` already exists, the step is skipped.
- *
- * Usage:
- *   import { migrateEnvIdToProjectId } from '@objectstack/metadata/migrations';
- *   await migrateEnvIdToProjectId(driver);
- */
-
-interface MigrationResult {
-    table: string;
-    status: 'renamed' | 'already_done' | 'table_missing' | 'error';
-    error?: string;
-}
-/**
- * Rename `env_id` → `project_id` on all metadata tables.
- *
- * @param driver  An IDataDriver with access to the target database.
- *                Must expose a raw query method: `driver.raw(sql, bindings?)`.
- * @returns       Per-table migration results.
- */
-declare function migrateEnvIdToProjectId(driver: IDataDriver): Promise<MigrationResult[]>;
-
-export { type MigrationResult, migrateEnvIdToProjectId };

package/dist/migrations/migrate-env-id-to-project-id.js

@@ -1,59 +0,0 @@
-// src/migrations/migrate-env-id-to-project-id.ts
-var AFFECTED_TABLES = [
-  "sys_metadata",
-  "sys_metadata_history",
-  "sys_object",
-  "sys_view",
-  "sys_flow",
-  "sys_agent",
-  "sys_tool"
-];
-async function migrateEnvIdToProjectId(driver) {
-  const driverAny = driver;
-  if (typeof driverAny.raw !== "function") {
-    throw new Error(
-      "migrateEnvIdToProjectId: driver must expose a .raw(sql, bindings?) method. SqlDriver (better-sqlite3/knex) and TursoDriver both support this."
-    );
-  }
-  const results = [];
-  for (const table of AFFECTED_TABLES) {
-    try {
-      const hasColumn = await _columnExists(driverAny, table, "env_id");
-      const alreadyMigrated = await _columnExists(driverAny, table, "project_id");
-      if (alreadyMigrated && !hasColumn) {
-        results.push({ table, status: "already_done" });
-        continue;
-      }
-      if (!hasColumn) {
-        results.push({ table, status: "table_missing" });
-        continue;
-      }
-      await driverAny.raw(`ALTER TABLE "${table}" RENAME COLUMN env_id TO project_id`);
-      results.push({ table, status: "renamed" });
-    } catch (err) {
-      results.push({ table, status: "error", error: err?.message ?? String(err) });
-    }
-  }
-  return results;
-}
-async function _columnExists(driver, table, column) {
-  try {
-    const rows = await driver.raw(`PRAGMA table_info("${table}")`);
-    if (Array.isArray(rows) && rows.length > 0) {
-      const list2 = Array.isArray(rows[0]) ? rows[0] : rows;
-      return list2.some((r) => r?.name === column);
-    }
-    const result = await driver.raw(
-      `SELECT column_name FROM information_schema.columns WHERE table_name = ? AND column_name = ?`,
-      [table, column]
-    );
-    const list = Array.isArray(result[0]) ? result[0] : result;
-    return list.length > 0;
-  } catch {
-    return false;
-  }
-}
-export {
-  migrateEnvIdToProjectId
-};
-//# sourceMappingURL=migrate-env-id-to-project-id.js.map

package/dist/migrations/migrate-env-id-to-project-id.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/migrations/migrate-env-id-to-project-id.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/**\n * Migration: env_id → project_id\n *\n * Renames the `env_id` column to `project_id` across all metadata tables:\n *   - sys_metadata\n *   - sys_metadata_history\n *   - sys_object\n *   - sys_view\n *   - sys_flow\n *   - sys_agent\n *   - sys_tool\n *\n * Safe to run multiple times (idempotent): checks for column existence before\n * attempting to rename. If `project_id` already exists, the step is skipped.\n *\n * Usage:\n *   import { migrateEnvIdToProjectId } from '@objectstack/metadata/migrations';\n *   await migrateEnvIdToProjectId(driver);\n */\n\nimport type { IDataDriver } from '@objectstack/spec/contracts';\n\nconst AFFECTED_TABLES = [\n    'sys_metadata',\n    'sys_metadata_history',\n    'sys_object',\n    'sys_view',\n    'sys_flow',\n    'sys_agent',\n    'sys_tool',\n] as const;\n\nexport interface MigrationResult {\n    table: string;\n    status: 'renamed' | 'already_done' | 'table_missing' | 'error';\n    error?: string;\n}\n\n/**\n * Rename `env_id` → `project_id` on all metadata tables.\n *\n * @param driver  An IDataDriver with access to the target database.\n *                Must expose a raw query method: `driver.raw(sql, bindings?)`.\n * @returns       Per-table migration results.\n */\nexport async function migrateEnvIdToProjectId(driver: IDataDriver): Promise<MigrationResult[]> {\n    const driverAny = driver as any;\n\n    if (typeof driverAny.raw !== 'function') {\n        throw new Error(\n            'migrateEnvIdToProjectId: driver must expose a .raw(sql, bindings?) method. ' +\n            'SqlDriver (better-sqlite3/knex) and TursoDriver both support this.'\n        );\n    }\n\n    const results: MigrationResult[] = [];\n\n    for (const table of AFFECTED_TABLES) {\n        try {\n            // Detect dialect: SQLite uses PRAGMA, others use information_schema.\n            const hasColumn = await _columnExists(driverAny, table, 'env_id');\n            const alreadyMigrated = await _columnExists(driverAny, table, 'project_id');\n\n            if (alreadyMigrated && !hasColumn) {\n                results.push({ table, status: 'already_done' });\n                continue;\n            }\n\n            if (!hasColumn) {\n                // Neither column exists — table might not exist yet.\n                results.push({ table, status: 'table_missing' });\n                continue;\n            }\n\n            // Perform the rename.  SQLite ≥ 3.25.0 supports ALTER TABLE RENAME COLUMN.\n            await driverAny.raw(`ALTER TABLE \"${table}\" RENAME COLUMN env_id TO project_id`);\n\n            results.push({ table, status: 'renamed' });\n        } catch (err: any) {\n            results.push({ table, status: 'error', error: err?.message ?? String(err) });\n        }\n    }\n\n    return results;\n}\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\nasync function _columnExists(driver: any, table: string, column: string): Promise<boolean> {\n    try {\n        // SQLite: PRAGMA table_info returns rows with `name` column.\n        const rows: any[] = await driver.raw(`PRAGMA table_info(\"${table}\")`);\n        if (Array.isArray(rows) && rows.length > 0) {\n            // knex wraps PRAGMA result; handle both `rows` and `rows[0]` shapes.\n            const list: any[] = Array.isArray(rows[0]) ? rows[0] : rows;\n            return list.some((r: any) => r?.name === column);\n        }\n\n        // Fallback for non-SQLite: query information_schema.\n        const result: any[] = await driver.raw(\n            `SELECT column_name FROM information_schema.columns WHERE table_name = ? AND column_name = ?`,\n            [table, column]\n        );\n        const list: any[] = Array.isArray(result[0]) ? result[0] : result;\n        return list.length > 0;\n    } catch {\n        return false;\n    }\n}\n"],"mappings":";AAwBA,IAAM,kBAAkB;AAAA,EACpB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACJ;AAeA,eAAsB,wBAAwB,QAAiD;AAC3F,QAAM,YAAY;AAElB,MAAI,OAAO,UAAU,QAAQ,YAAY;AACrC,UAAM,IAAI;AAAA,MACN;AAAA,IAEJ;AAAA,EACJ;AAEA,QAAM,UAA6B,CAAC;AAEpC,aAAW,SAAS,iBAAiB;AACjC,QAAI;AAEA,YAAM,YAAY,MAAM,cAAc,WAAW,OAAO,QAAQ;AAChE,YAAM,kBAAkB,MAAM,cAAc,WAAW,OAAO,YAAY;AAE1E,UAAI,mBAAmB,CAAC,WAAW;AAC/B,gBAAQ,KAAK,EAAE,OAAO,QAAQ,eAAe,CAAC;AAC9C;AAAA,MACJ;AAEA,UAAI,CAAC,WAAW;AAEZ,gBAAQ,KAAK,EAAE,OAAO,QAAQ,gBAAgB,CAAC;AAC/C;AAAA,MACJ;AAGA,YAAM,UAAU,IAAI,gBAAgB,KAAK,sCAAsC;AAE/E,cAAQ,KAAK,EAAE,OAAO,QAAQ,UAAU,CAAC;AAAA,IAC7C,SAAS,KAAU;AACf,cAAQ,KAAK,EAAE,OAAO,QAAQ,SAAS,OAAO,KAAK,WAAW,OAAO,GAAG,EAAE,CAAC;AAAA,IAC/E;AAAA,EACJ;AAEA,SAAO;AACX;AAMA,eAAe,cAAc,QAAa,OAAe,QAAkC;AACvF,MAAI;AAEA,UAAM,OAAc,MAAM,OAAO,IAAI,sBAAsB,KAAK,IAAI;AACpE,QAAI,MAAM,QAAQ,IAAI,KAAK,KAAK,SAAS,GAAG;AAExC,YAAMA,QAAc,MAAM,QAAQ,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI;AACvD,aAAOA,MAAK,KAAK,CAAC,MAAW,GAAG,SAAS,MAAM;AAAA,IACnD;AAGA,UAAM,SAAgB,MAAM,OAAO;AAAA,MAC/B;AAAA,MACA,CAAC,OAAO,MAAM;AAAA,IAClB;AACA,UAAM,OAAc,MAAM,QAAQ,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI;AAC3D,WAAO,KAAK,SAAS;AAAA,EACzB,QAAQ;AACJ,WAAO;AAAA,EACX;AACJ;","names":["list"]}