@objectstack/metadata 6.9.0 → 7.1.0

package/dist/index.d.cts

@@ -358,7 +358,18 @@ declare class MetadataManager implements IMetadataService {
     importMetadata(data: unknown, options?: MetadataImportOptions): Promise<MetadataImportResult>;
     /**
      * Validate a metadata item against its type schema.
-     * Returns validation result with errors and warnings.
+     *
+     * NOTE: This is a lightweight structural check (presence of `name`,
+     * basic shape). The authoritative spec validation lives in
+     * `protocol.saveMetaItem` (write path) and is surfaced on read
+     * paths via the `_diagnostics` envelope attached by
+     * `protocol.getMetaItems` / `getMetaItem`. Both delegate to
+     * `getMetadataTypeSchema()` — the single source of truth. We
+     * deliberately do NOT run the full Zod schema here because
+     * `MetadataManager`'s registry stores *publish envelopes*
+     * (`{name, packageId, state, metadata: {...spec}}`), not raw spec
+     * documents — running spec validation against the envelope would
+     * yield false negatives.
      */
     validate(_type: string, data: unknown): Promise<MetadataValidationResult>;
     /**
@@ -863,27 +874,6 @@ declare class DatabaseLoader implements MetadataLoader {
     delete(type: string, name: string): Promise<void>;
 }
 
-/**
- * Metadata History API Routes
- *
- * REST API endpoints for metadata version history, rollback, and diff operations.
- * These routes extend the standard metadata API with history-specific functionality.
- *
- * Routes:
- * - GET /api/v1/metadata/:type/:name/history - Get version history
- * - POST /api/v1/metadata/:type/:name/rollback - Rollback to a specific version
- * - GET /api/v1/metadata/:type/:name/diff - Compare two versions
- */
-
-/**
- * Register metadata history routes on a Hono app or any HTTP server.
- *
- * @param app - The HTTP server/router instance (Hono-compatible)
- * @param metadataService - The metadata service instance
- */
-declare function registerMetadataHistoryRoutes(app: any, // Hono app or compatible
-metadataService: IMetadataService): void;
-
 /**
  * Metadata History Utilities
  *
@@ -1028,4 +1018,4 @@ declare class TypeScriptSerializer implements MetadataSerializer {
     getFormat(): MetadataFormat;
 }
 
-export { DatabaseLoader, type DatabaseLoaderOptions, HistoryCleanupManager, JSONSerializer, MemoryLoader, type MetadataLoader, MetadataManager, type MetadataManagerOptions, MetadataPlugin, type MetadataSerializer, index as Migration, RemoteLoader, type SerializeOptions, TypeScriptSerializer, type WatchCallback, YAMLSerializer, calculateChecksum, generateDiffSummary, generateSimpleDiff, registerMetadataHistoryRoutes };
+export { DatabaseLoader, type DatabaseLoaderOptions, HistoryCleanupManager, JSONSerializer, MemoryLoader, type MetadataLoader, MetadataManager, type MetadataManagerOptions, MetadataPlugin, type MetadataSerializer, index as Migration, RemoteLoader, type SerializeOptions, TypeScriptSerializer, type WatchCallback, YAMLSerializer, calculateChecksum, generateDiffSummary, generateSimpleDiff };

package/dist/index.d.ts

@@ -358,7 +358,18 @@ declare class MetadataManager implements IMetadataService {
     importMetadata(data: unknown, options?: MetadataImportOptions): Promise<MetadataImportResult>;
     /**
      * Validate a metadata item against its type schema.
-     * Returns validation result with errors and warnings.
+     *
+     * NOTE: This is a lightweight structural check (presence of `name`,
+     * basic shape). The authoritative spec validation lives in
+     * `protocol.saveMetaItem` (write path) and is surfaced on read
+     * paths via the `_diagnostics` envelope attached by
+     * `protocol.getMetaItems` / `getMetaItem`. Both delegate to
+     * `getMetadataTypeSchema()` — the single source of truth. We
+     * deliberately do NOT run the full Zod schema here because
+     * `MetadataManager`'s registry stores *publish envelopes*
+     * (`{name, packageId, state, metadata: {...spec}}`), not raw spec
+     * documents — running spec validation against the envelope would
+     * yield false negatives.
      */
     validate(_type: string, data: unknown): Promise<MetadataValidationResult>;
     /**
@@ -863,27 +874,6 @@ declare class DatabaseLoader implements MetadataLoader {
     delete(type: string, name: string): Promise<void>;
 }
 
-/**
- * Metadata History API Routes
- *
- * REST API endpoints for metadata version history, rollback, and diff operations.
- * These routes extend the standard metadata API with history-specific functionality.
- *
- * Routes:
- * - GET /api/v1/metadata/:type/:name/history - Get version history
- * - POST /api/v1/metadata/:type/:name/rollback - Rollback to a specific version
- * - GET /api/v1/metadata/:type/:name/diff - Compare two versions
- */
-
-/**
- * Register metadata history routes on a Hono app or any HTTP server.
- *
- * @param app - The HTTP server/router instance (Hono-compatible)
- * @param metadataService - The metadata service instance
- */
-declare function registerMetadataHistoryRoutes(app: any, // Hono app or compatible
-metadataService: IMetadataService): void;
-
 /**
  * Metadata History Utilities
  *
@@ -1028,4 +1018,4 @@ declare class TypeScriptSerializer implements MetadataSerializer {
     getFormat(): MetadataFormat;
 }
 
-export { DatabaseLoader, type DatabaseLoaderOptions, HistoryCleanupManager, JSONSerializer, MemoryLoader, type MetadataLoader, MetadataManager, type MetadataManagerOptions, MetadataPlugin, type MetadataSerializer, index as Migration, RemoteLoader, type SerializeOptions, TypeScriptSerializer, type WatchCallback, YAMLSerializer, calculateChecksum, generateDiffSummary, generateSimpleDiff, registerMetadataHistoryRoutes };
+export { DatabaseLoader, type DatabaseLoaderOptions, HistoryCleanupManager, JSONSerializer, MemoryLoader, type MetadataLoader, MetadataManager, type MetadataManagerOptions, MetadataPlugin, type MetadataSerializer, index as Migration, RemoteLoader, type SerializeOptions, TypeScriptSerializer, type WatchCallback, YAMLSerializer, calculateChecksum, generateDiffSummary, generateSimpleDiff };

package/dist/index.js

@@ -550,7 +550,7 @@ async function migrateProjectIdToEnvironmentId(driver) {
   const driverAny = driver;
   if (typeof driverAny.raw !== "function") {
     throw new Error(
-      "migrateProjectIdToEnvironmentId: driver must expose a .raw(sql, bindings?) method. SqlDriver (better-sqlite3/knex) and TursoDriver both support this."
+      "migrateProjectIdToEnvironmentId: driver must expose a .raw(sql, bindings?) method. migrateProjectIdToEnvironmentId: driver must expose a .raw(sql, bindings?) method. SqlDriver (better-sqlite3/knex) supports this; cloud-side TursoDriver also conforms."
     );
   }
   const results = [];
@@ -2086,7 +2086,18 @@ var _MetadataManager = class _MetadataManager {
   // ==========================================
   /**
    * Validate a metadata item against its type schema.
-   * Returns validation result with errors and warnings.
+   *
+   * NOTE: This is a lightweight structural check (presence of `name`,
+   * basic shape). The authoritative spec validation lives in
+   * `protocol.saveMetaItem` (write path) and is surfaced on read
+   * paths via the `_diagnostics` envelope attached by
+   * `protocol.getMetaItems` / `getMetaItem`. Both delegate to
+   * `getMetadataTypeSchema()` — the single source of truth. We
+   * deliberately do NOT run the full Zod schema here because
+   * `MetadataManager`'s registry stores *publish envelopes*
+   * (`{name, packageId, state, metadata: {...spec}}`), not raw spec
+   * documents — running spec validation against the envelope would
+   * yield false negatives.
    */
   async validate(_type, data) {
     if (data === null || data === void 0) {
@@ -3126,6 +3137,7 @@ var ARTIFACT_FIELD_TO_TYPE = {
   mappings: "mapping",
   analyticsCubes: "analytics_cube",
   connectors: "connector",
+  emailTemplates: "email_template",
   data: "dataset"
 };
 var MetadataPlugin = class {
@@ -3599,126 +3611,6 @@ var RemoteLoader = class {
 // src/index.ts
 import { SysMetadataObject as SysMetadataObject3, SysMetadataHistoryObject as SysMetadataHistoryObject3 } from "@objectstack/platform-objects/metadata";
 
-// src/routes/history-routes.ts
-function registerMetadataHistoryRoutes(app, metadataService) {
-  app.get("/api/v1/metadata/:type/:name/history", async (c) => {
-    if (!metadataService.getHistory) {
-      return c.json({ error: "History tracking not enabled" }, 501);
-    }
-    const { type, name } = c.req.param();
-    const query = c.req.query();
-    try {
-      const options = {};
-      if (query.limit !== void 0) {
-        const limit = parseInt(query.limit, 10);
-        if (!Number.isFinite(limit) || limit < 1) {
-          return c.json({ success: false, error: "limit must be a positive integer" }, 400);
-        }
-        options.limit = limit;
-      }
-      if (query.offset !== void 0) {
-        const offset = parseInt(query.offset, 10);
-        if (!Number.isFinite(offset) || offset < 0) {
-          return c.json({ success: false, error: "offset must be a non-negative integer" }, 400);
-        }
-        options.offset = offset;
-      }
-      if (query.since) options.since = query.since;
-      if (query.until) options.until = query.until;
-      if (query.operationType) options.operationType = query.operationType;
-      if (query.includeMetadata !== void 0) {
-        options.includeMetadata = query.includeMetadata === "true";
-      }
-      const result = await metadataService.getHistory(type, name, options);
-      return c.json({
-        success: true,
-        data: result
-      });
-    } catch (error) {
-      return c.json(
-        {
-          success: false,
-          error: error instanceof Error ? error.message : "Failed to retrieve history"
-        },
-        500
-      );
-    }
-  });
-  app.post("/api/v1/metadata/:type/:name/rollback", async (c) => {
-    if (!metadataService.rollback) {
-      return c.json({ error: "Rollback not supported" }, 501);
-    }
-    const { type, name } = c.req.param();
-    try {
-      const body = await c.req.json();
-      const { version, changeNote, recordedBy } = body;
-      if (typeof version !== "number") {
-        return c.json(
-          {
-            success: false,
-            error: "Version number is required"
-          },
-          400
-        );
-      }
-      const restoredMetadata = await metadataService.rollback(type, name, version, {
-        changeNote,
-        recordedBy
-      });
-      return c.json({
-        success: true,
-        data: {
-          type,
-          name,
-          version,
-          metadata: restoredMetadata
-        }
-      });
-    } catch (error) {
-      return c.json(
-        {
-          success: false,
-          error: error instanceof Error ? error.message : "Rollback failed"
-        },
-        500
-      );
-    }
-  });
-  app.get("/api/v1/metadata/:type/:name/diff", async (c) => {
-    if (!metadataService.diff) {
-      return c.json({ error: "Diff not supported" }, 501);
-    }
-    const { type, name } = c.req.param();
-    const query = c.req.query();
-    try {
-      const version1 = parseInt(query.version1, 10);
-      const version2 = parseInt(query.version2, 10);
-      if (isNaN(version1) || isNaN(version2)) {
-        return c.json(
-          {
-            success: false,
-            error: "Both version1 and version2 query parameters are required"
-          },
-          400
-        );
-      }
-      const diffResult = await metadataService.diff(type, name, version1, version2);
-      return c.json({
-        success: true,
-        data: diffResult
-      });
-    } catch (error) {
-      return c.json(
-        {
-          success: false,
-          error: error instanceof Error ? error.message : "Diff failed"
-        },
-        500
-      );
-    }
-  });
-}
-
 // src/utils/history-cleanup.ts
 import { DEFAULT_METADATA_TYPE_REGISTRY as DEFAULT_METADATA_TYPE_REGISTRY2 } from "@objectstack/spec/kernel";
 function executionPinnedTypes() {
@@ -4009,7 +3901,6 @@ export {
   YAMLSerializer,
   calculateChecksum,
   generateDiffSummary,
-  generateSimpleDiff,
-  registerMetadataHistoryRoutes
+  generateSimpleDiff
 };
 //# sourceMappingURL=index.js.map