@powerhousedao/reactor 5.2.0-staging.9 → 6.0.0-dev.1

package/dist/src/registry/implementation.d.ts

@@ -1,16 +1,16 @@
-import type { DocumentModelModule } from "document-model";
+import type { DocumentModelModule, UpgradeManifest, UpgradeReducer, UpgradeTransition } from "document-model";
 import type { IDocumentModelRegistry } from "./interfaces.js";
 /**
  * Error thrown when a document model module is not found in the registry.
  */
 export declare class ModuleNotFoundError extends Error {
-    constructor(documentType: string);
+    constructor(documentType: string, version?: number);
 }
 /**
  * Error thrown when attempting to register a module that already exists.
  */
 export declare class DuplicateModuleError extends Error {
-    constructor(documentType: string);
+    constructor(documentType: string, version?: number);
 }
 /**
  * Error thrown when a module is invalid or malformed.
@@ -18,45 +18,53 @@ export declare class DuplicateModuleError extends Error {
 export declare class InvalidModuleError extends Error {
     constructor(message: string);
 }
+/**
+ * Error thrown when attempting to register an upgrade manifest that already exists.
+ */
+export declare class DuplicateManifestError extends Error {
+    constructor(documentType: string);
+}
+/**
+ * Error thrown when an upgrade manifest is not found.
+ */
+export declare class ManifestNotFoundError extends Error {
+    constructor(documentType: string);
+}
+/**
+ * Error thrown when attempting a downgrade operation.
+ */
+export declare class DowngradeNotSupportedError extends Error {
+    constructor(documentType: string, fromVersion: number, toVersion: number);
+}
+/**
+ * Error thrown when a required upgrade transition is missing from the manifest.
+ */
+export declare class MissingUpgradeTransitionError extends Error {
+    constructor(documentType: string, fromVersion: number, toVersion: number);
+}
+/**
+ * Error thrown when getUpgradeReducer is called with a non-single-step version increment.
+ */
+export declare class InvalidUpgradeStepError extends Error {
+    constructor(documentType: string, fromVersion: number, toVersion: number);
+}
 /**
  * In-memory implementation of the IDocumentModelRegistry interface.
- * Manages document model modules and provides centralized access to their reducers, utils, and specifications.
+ * Manages document model modules with version-aware storage and upgrade manifest support.
  */
 export declare class DocumentModelRegistry implements IDocumentModelRegistry {
     private modules;
-    /**
-     * Register multiple modules at once.
-     *
-     * @param modules Document model modules to register
-     * @throws DuplicateModuleError if a module with the same document type is already registered
-     * @throws InvalidModuleError if a module is malformed
-     */
+    private manifests;
     registerModules(...modules: DocumentModelModule<any>[]): void;
-    /**
-     * Unregister multiple document model modules at once.
-     *
-     * @param documentTypes The document types to unregister
-     * @returns true if all modules were unregistered, false if any were not found
-     */
     unregisterModules(...documentTypes: string[]): boolean;
-    /**
-     * Get a specific document model module by document type.
-     *
-     * @param documentType The document type identifier
-     * @returns The document model module
-     * @throws ModuleNotFoundError if the document type is not registered
-     */
-    getModule(documentType: string): DocumentModelModule<any>;
-    /**
-     * Get all registered document model modules.
-     * Note: This only returns loaded modules, not lazy-loaded ones.
-     *
-     * @returns Array of all registered modules
-     */
+    getModule(documentType: string, version?: number): DocumentModelModule<any>;
     getAllModules(): DocumentModelModule<any>[];
-    /**
-     * Clear all registered modules
-     */
     clear(): void;
+    getSupportedVersions(documentType: string): number[];
+    getLatestVersion(documentType: string): number;
+    registerUpgradeManifests(...manifests: UpgradeManifest<readonly number[]>[]): void;
+    getUpgradeManifest(documentType: string): UpgradeManifest<readonly number[]>;
+    computeUpgradePath(documentType: string, fromVersion: number, toVersion: number): UpgradeTransition[];
+    getUpgradeReducer(documentType: string, fromVersion: number, toVersion: number): UpgradeReducer<any, any>;
 }
 //# sourceMappingURL=implementation.d.ts.map

package/dist/src/registry/implementation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"implementation.d.ts","sourceRoot":"","sources":["../../../src/registry/implementation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAE9D;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,YAAY,EAAE,MAAM;CAIjC;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,YAAY,EAAE,MAAM;CAIjC;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED;;;GAGG;AACH,qBAAa,qBAAsB,YAAW,sBAAsB;IAClE,OAAO,CAAC,OAAO,CAA+C;IAE9D;;;;;;OAMG;IACH,eAAe,CAAC,GAAG,OAAO,EAAE,mBAAmB,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI;IAY7D;;;;;OAKG;IACH,iBAAiB,CAAC,GAAG,aAAa,EAAE,MAAM,EAAE,GAAG,OAAO;IAatD;;;;;;OAMG;IACH,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,mBAAmB,CAAC,GAAG,CAAC;IAUzD;;;;;OAKG;IACH,aAAa,IAAI,mBAAmB,CAAC,GAAG,CAAC,EAAE;IAI3C;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}
+{"version":3,"file":"implementation.d.ts","sourceRoot":"","sources":["../../../src/registry/implementation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAE9D;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAOnD;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAOnD;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,YAAY,EAAE,MAAM;CAIjC;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,YAAY,EAAE,MAAM;CAIjC;AAED;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;gBACvC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAMzE;AAED;;GAEG;AACH,qBAAa,6BAA8B,SAAQ,KAAK;gBAC1C,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAMzE;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAMzE;AAED;;;GAGG;AACH,qBAAa,qBAAsB,YAAW,sBAAsB;IAClE,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,SAAS,CAA4C;IAE7D,eAAe,CAAC,GAAG,OAAO,EAAE,mBAAmB,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI;IAmB7D,iBAAiB,CAAC,GAAG,aAAa,EAAE,MAAM,EAAE,GAAG,OAAO;IAoBtD,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAAC,GAAG,CAAC;IA4B3E,aAAa,IAAI,mBAAmB,CAAC,GAAG,CAAC,EAAE;IAI3C,KAAK,IAAI,IAAI;IAKb,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE;IAgBpD,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAqB9C,wBAAwB,CACtB,GAAG,SAAS,EAAE,eAAe,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,GACjD,IAAI;IAWP,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,eAAe,CAAC,SAAS,MAAM,EAAE,CAAC;IAS5E,kBAAkB,CAChB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,iBAAiB,EAAE;IA+BtB,iBAAiB,CACf,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC;CAoB5B"}

package/dist/src/registry/implementation.js

@@ -2,8 +2,9 @@
  * Error thrown when a document model module is not found in the registry.
  */
 export class ModuleNotFoundError extends Error {
-    constructor(documentType) {
-        super(`Document model module not found for type: ${documentType}`);
+    constructor(documentType, version) {
+        const versionSuffix = version !== undefined ? ` version ${version}` : "";
+        super(`Document model module not found for type: ${documentType}${versionSuffix}`);
         this.name = "ModuleNotFoundError";
     }
 }
@@ -11,8 +12,9 @@ export class ModuleNotFoundError extends Error {
  * Error thrown when attempting to register a module that already exists.
  */
 export class DuplicateModuleError extends Error {
-    constructor(documentType) {
-        super(`Document model module already registered for type: ${documentType}`);
+    constructor(documentType, version) {
+        const versionSuffix = version !== undefined ? ` (version ${version})` : "";
+        super(`Document model module already registered for type: ${documentType}${versionSuffix}`);
         this.name = "DuplicateModuleError";
     }
 }
@@ -25,72 +27,190 @@ export class InvalidModuleError extends Error {
         this.name = "InvalidModuleError";
     }
 }
+/**
+ * Error thrown when attempting to register an upgrade manifest that already exists.
+ */
+export class DuplicateManifestError extends Error {
+    constructor(documentType) {
+        super(`Upgrade manifest already registered for type: ${documentType}`);
+        this.name = "DuplicateManifestError";
+    }
+}
+/**
+ * Error thrown when an upgrade manifest is not found.
+ */
+export class ManifestNotFoundError extends Error {
+    constructor(documentType) {
+        super(`Upgrade manifest not found for type: ${documentType}`);
+        this.name = "ManifestNotFoundError";
+    }
+}
+/**
+ * Error thrown when attempting a downgrade operation.
+ */
+export class DowngradeNotSupportedError extends Error {
+    constructor(documentType, fromVersion, toVersion) {
+        super(`Downgrade not supported for ${documentType}: cannot go from version ${fromVersion} to ${toVersion}`);
+        this.name = "DowngradeNotSupportedError";
+    }
+}
+/**
+ * Error thrown when a required upgrade transition is missing from the manifest.
+ */
+export class MissingUpgradeTransitionError extends Error {
+    constructor(documentType, fromVersion, toVersion) {
+        super(`Missing upgrade transition for ${documentType}: v${fromVersion} to v${toVersion}`);
+        this.name = "MissingUpgradeTransitionError";
+    }
+}
+/**
+ * Error thrown when getUpgradeReducer is called with a non-single-step version increment.
+ */
+export class InvalidUpgradeStepError extends Error {
+    constructor(documentType, fromVersion, toVersion) {
+        super(`Invalid upgrade step for ${documentType}: must be single version increment, got v${fromVersion} to v${toVersion}`);
+        this.name = "InvalidUpgradeStepError";
+    }
+}
 /**
  * In-memory implementation of the IDocumentModelRegistry interface.
- * Manages document model modules and provides centralized access to their reducers, utils, and specifications.
+ * Manages document model modules with version-aware storage and upgrade manifest support.
  */
 export class DocumentModelRegistry {
-    modules = new Map();
-    /**
-     * Register multiple modules at once.
-     *
-     * @param modules Document model modules to register
-     * @throws DuplicateModuleError if a module with the same document type is already registered
-     * @throws InvalidModuleError if a module is malformed
-     */
+    modules = [];
+    manifests = [];
     registerModules(...modules) {
         for (const module of modules) {
             const documentType = module.documentModel.global.id;
-            if (this.modules.has(documentType)) {
-                throw new DuplicateModuleError(documentType);
+            const version = module.version ?? 1;
+            for (let i = 0; i < this.modules.length; i++) {
+                const existing = this.modules[i];
+                const existingType = existing.documentModel.global.id;
+                const existingVersion = existing.version ?? 1;
+                if (existingType === documentType && existingVersion === version) {
+                    throw new DuplicateModuleError(documentType, version);
+                }
             }
-            this.modules.set(documentType, module);
+            this.modules.push(module);
         }
     }
-    /**
-     * Unregister multiple document model modules at once.
-     *
-     * @param documentTypes The document types to unregister
-     * @returns true if all modules were unregistered, false if any were not found
-     */
     unregisterModules(...documentTypes) {
         let allFound = true;
         for (const documentType of documentTypes) {
-            const wasDeleted = this.modules.delete(documentType);
-            if (!wasDeleted) {
+            const hasModule = this.modules.some((m) => m.documentModel.global.id === documentType);
+            if (!hasModule) {
                 allFound = false;
             }
+            this.modules = this.modules.filter((m) => m.documentModel.global.id !== documentType);
         }
         return allFound;
     }
-    /**
-     * Get a specific document model module by document type.
-     *
-     * @param documentType The document type identifier
-     * @returns The document model module
-     * @throws ModuleNotFoundError if the document type is not registered
-     */
-    getModule(documentType) {
-        const module = this.modules.get(documentType);
-        if (module) {
-            return module;
+    getModule(documentType, version) {
+        let latestModule;
+        let latestVersion = -1;
+        for (let i = 0; i < this.modules.length; i++) {
+            const module = this.modules[i];
+            const moduleType = module.documentModel.global.id;
+            const moduleVersion = module.version ?? 1;
+            if (moduleType === documentType) {
+                if (version !== undefined && moduleVersion === version) {
+                    return module;
+                }
+                if (moduleVersion > latestVersion) {
+                    latestModule = module;
+                    latestVersion = moduleVersion;
+                }
+            }
         }
-        throw new ModuleNotFoundError(documentType);
-    }
-    /**
-     * Get all registered document model modules.
-     * Note: This only returns loaded modules, not lazy-loaded ones.
-     *
-     * @returns Array of all registered modules
-     */
+        if (version === undefined && latestModule !== undefined) {
+            return latestModule;
+        }
+        throw new ModuleNotFoundError(documentType, version);
+    }
     getAllModules() {
-        return Array.from(this.modules.values());
+        return [...this.modules];
     }
-    /**
-     * Clear all registered modules
-     */
     clear() {
-        this.modules.clear();
+        this.modules = [];
+        this.manifests = [];
+    }
+    getSupportedVersions(documentType) {
+        const versions = [];
+        for (const module of this.modules) {
+            if (module.documentModel.global.id === documentType) {
+                versions.push(module.version ?? 1);
+            }
+        }
+        if (versions.length === 0) {
+            throw new ModuleNotFoundError(documentType);
+        }
+        return versions.sort((a, b) => a - b);
+    }
+    getLatestVersion(documentType) {
+        let latest = -1;
+        let found = false;
+        for (const module of this.modules) {
+            if (module.documentModel.global.id === documentType) {
+                found = true;
+                const version = module.version ?? 1;
+                if (version > latest) {
+                    latest = version;
+                }
+            }
+        }
+        if (!found) {
+            throw new ModuleNotFoundError(documentType);
+        }
+        return latest;
+    }
+    registerUpgradeManifests(...manifests) {
+        for (const manifest of manifests) {
+            for (let i = 0; i < this.manifests.length; i++) {
+                if (this.manifests[i].documentType === manifest.documentType) {
+                    throw new DuplicateManifestError(manifest.documentType);
+                }
+            }
+            this.manifests.push(manifest);
+        }
+    }
+    getUpgradeManifest(documentType) {
+        for (let i = 0; i < this.manifests.length; i++) {
+            if (this.manifests[i].documentType === documentType) {
+                return this.manifests[i];
+            }
+        }
+        throw new ManifestNotFoundError(documentType);
+    }
+    computeUpgradePath(documentType, fromVersion, toVersion) {
+        if (fromVersion === toVersion) {
+            return [];
+        }
+        if (toVersion < fromVersion) {
+            throw new DowngradeNotSupportedError(documentType, fromVersion, toVersion);
+        }
+        const manifest = this.getUpgradeManifest(documentType);
+        const path = [];
+        for (let v = fromVersion + 1; v <= toVersion; v++) {
+            const key = `v${v}`;
+            if (!(key in manifest.upgrades)) {
+                throw new MissingUpgradeTransitionError(documentType, v - 1, v);
+            }
+            const transition = manifest.upgrades[key];
+            path.push(transition);
+        }
+        return path;
+    }
+    getUpgradeReducer(documentType, fromVersion, toVersion) {
+        if (toVersion !== fromVersion + 1) {
+            throw new InvalidUpgradeStepError(documentType, fromVersion, toVersion);
+        }
+        const manifest = this.getUpgradeManifest(documentType);
+        const key = `v${toVersion}`;
+        if (!(key in manifest.upgrades)) {
+            throw new MissingUpgradeTransitionError(documentType, fromVersion, toVersion);
+        }
+        const transition = manifest.upgrades[key];
+        return transition.upgradeReducer;
     }
 }
 //# sourceMappingURL=implementation.js.map

package/dist/src/registry/implementation.js.map

@@ -1 +1 @@
-{"version":3,"file":"implementation.js","sourceRoot":"","sources":["../../../src/registry/implementation.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,YAAoB;QAC9B,KAAK,CAAC,6CAA6C,YAAY,EAAE,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,YAAoB;QAC9B,KAAK,CAAC,sDAAsD,YAAY,EAAE,CAAC,CAAC;QAC5E,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,kCAAkC,OAAO,EAAE,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,qBAAqB;IACxB,OAAO,GAAG,IAAI,GAAG,EAAoC,CAAC;IAE9D;;;;;;OAMG;IACH,eAAe,CAAC,GAAG,OAAmC;QACpD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,YAAY,GAAG,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;YAEpD,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;gBACnC,MAAM,IAAI,oBAAoB,CAAC,YAAY,CAAC,CAAC;YAC/C,CAAC;YAED,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,iBAAiB,CAAC,GAAG,aAAuB;QAC1C,IAAI,QAAQ,GAAG,IAAI,CAAC;QAEpB,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;YACzC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YACrD,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,QAAQ,GAAG,KAAK,CAAC;YACnB,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;OAMG;IACH,SAAS,CAAC,YAAoB;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAE9C,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,IAAI,mBAAmB,CAAC,YAAY,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;OAKG;IACH,aAAa;QACX,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF"}
+{"version":3,"file":"implementation.js","sourceRoot":"","sources":["../../../src/registry/implementation.ts"],"names":[],"mappings":"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"}

package/dist/src/registry/interfaces.d.ts

@@ -1,39 +1,100 @@
-import type { DocumentModelModule } from "document-model";
+import type { DocumentModelModule, UpgradeManifest, UpgradeReducer, UpgradeTransition } from "document-model";
 /**
  * Registry for managing document model modules.
  * Provides centralized access to document models' reducers, utils, and specifications.
+ * Supports version-aware module storage and upgrade manifest management.
  */
 export interface IDocumentModelRegistry {
     /**
      * Register multiple modules at once.
+     * Modules without a version field default to version 1.
      *
      * @param modules Document model modules to register
-     * @throws Error if a module with the same document type is already registered
+     * @throws DuplicateModuleError if a module with the same document type and version is already registered
      */
     registerModules(...modules: DocumentModelModule<any>[]): void;
     /**
-     * Unregister multiple document model modules at once.
+     * Unregister all versions of the specified document types.
      *
      * @param documentTypes The document types to unregister
      * @returns true if all modules were unregistered, false if any were not found
      */
     unregisterModules(...documentTypes: string[]): boolean;
     /**
-     * Get a specific document model module by document type.
+     * Get a specific document model module by document type and optional version.
+     * If version is not specified, returns the latest version.
      *
      * @param documentType The document type identifier
+     * @param version Optional version number to retrieve
      * @returns The document model module
-     * @throws Error if the document type is not registered
+     * @throws ModuleNotFoundError if the document type or version is not registered
      */
-    getModule(documentType: string): DocumentModelModule<any>;
+    getModule(documentType: string, version?: number): DocumentModelModule<any>;
     /**
-     * Get all registered document model modules
+     * Get all registered document model modules.
+     *
      * @returns Array of all registered modules
      */
     getAllModules(): DocumentModelModule<any>[];
     /**
-     * Clear all registered modules
+     * Clear all registered modules and upgrade manifests.
      */
     clear(): void;
+    /**
+     * Get all supported versions for a document type, sorted in ascending order.
+     *
+     * @param documentType The document type identifier
+     * @returns Array of version numbers sorted ascending
+     * @throws ModuleNotFoundError if no modules are registered for the document type
+     */
+    getSupportedVersions(documentType: string): number[];
+    /**
+     * Get the latest (highest) version number for a document type.
+     *
+     * @param documentType The document type identifier
+     * @returns The highest version number registered for this document type
+     * @throws ModuleNotFoundError if no modules are registered for the document type
+     */
+    getLatestVersion(documentType: string): number;
+    /**
+     * Register upgrade manifests that define upgrade paths between versions.
+     *
+     * @param manifests Upgrade manifests to register
+     * @throws DuplicateManifestError if a manifest for the same document type is already registered
+     */
+    registerUpgradeManifests(...manifests: UpgradeManifest<readonly number[]>[]): void;
+    /**
+     * Get the upgrade manifest for a document type.
+     *
+     * @param documentType The document type identifier
+     * @returns The upgrade manifest
+     * @throws ManifestNotFoundError if no manifest is registered for the document type
+     */
+    getUpgradeManifest(documentType: string): UpgradeManifest<readonly number[]>;
+    /**
+     * Compute the upgrade path from one version to another.
+     * Returns the sequence of upgrade transitions needed.
+     *
+     * @param documentType The document type identifier
+     * @param fromVersion The starting version
+     * @param toVersion The target version
+     * @returns Array of upgrade transitions in order
+     * @throws DowngradeNotSupportedError if toVersion is less than fromVersion
+     * @throws ManifestNotFoundError if no upgrade manifest is registered
+     * @throws MissingUpgradeTransitionError if any transition in the path is missing
+     */
+    computeUpgradePath(documentType: string, fromVersion: number, toVersion: number): UpgradeTransition[];
+    /**
+     * Get the upgrade reducer for a single-step version transition.
+     *
+     * @param documentType The document type identifier
+     * @param fromVersion The starting version
+     * @param toVersion The target version (must be fromVersion + 1)
+     * @returns The upgrade reducer function
+     * @throws InvalidUpgradeStepError if toVersion is not fromVersion + 1
+     * @throws ManifestNotFoundError if no upgrade manifest is registered
+     * @throws MissingUpgradeTransitionError if the transition is not found
+     */
+    getUpgradeReducer(documentType: string, fromVersion: number, toVersion: number): UpgradeReducer<any, any>;
 }
 //# sourceMappingURL=interfaces.d.ts.map

package/dist/src/registry/interfaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../src/registry/interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;OAKG;IACH,eAAe,CAAC,GAAG,OAAO,EAAE,mBAAmB,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC;IAE9D;;;;;OAKG;IACH,iBAAiB,CAAC,GAAG,aAAa,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAEvD;;;;;;OAMG;IACH,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAE1D;;;OAGG;IACH,aAAa,IAAI,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC;IAE5C;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;CACf"}
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../src/registry/interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AAExB;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;;OAMG;IACH,eAAe,CAAC,GAAG,OAAO,EAAE,mBAAmB,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC;IAE9D;;;;;OAKG;IACH,iBAAiB,CAAC,GAAG,aAAa,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAEvD;;;;;;;;OAQG;IACH,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAE5E;;;;OAIG;IACH,aAAa,IAAI,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC;IAE5C;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;;;;;OAMG;IACH,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAErD;;;;;;OAMG;IACH,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;IAE/C;;;;;OAKG;IACH,wBAAwB,CACtB,GAAG,SAAS,EAAE,eAAe,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,GACjD,IAAI,CAAC;IAER;;;;;;OAMG;IACH,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,eAAe,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IAE7E;;;;;;;;;;;OAWG;IACH,kBAAkB,CAChB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,iBAAiB,EAAE,CAAC;IAEvB;;;;;;;;;;OAUG;IACH,iBAAiB,CACf,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;CAC7B"}

package/dist/src/shared/errors.d.ts

@@ -22,4 +22,20 @@ export declare class InvalidSignatureError extends Error {
     readonly reason: string;
     constructor(documentId: string, reason: string);
 }
+/**
+ * Error thrown when attempting to downgrade a document version.
+ */
+export declare class DowngradeNotSupportedError extends Error {
+    readonly documentType: string;
+    readonly fromVersion: number;
+    readonly toVersion: number;
+    constructor(documentType: string, fromVersion: number, toVersion: number);
+}
+/**
+ * Error thrown when an upgrade manifest is required but not registered.
+ */
+export declare class UpgradeManifestNotFoundError extends Error {
+    readonly documentType: string;
+    constructor(documentType: string);
+}
 //# sourceMappingURL=errors.d.ts.map

package/dist/src/shared/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/shared/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;gBAEnC,UAAU,EAAE,MAAM,EAAE,eAAe,GAAE,MAAM,GAAG,IAAW;CAYtE;AAED;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,KAAK,EAAE,MAAM,CAAC;gBAElB,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAU9C;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,MAAM,EAAE,MAAM,CAAC;gBAEnB,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAQ/C"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/shared/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;gBAEnC,UAAU,EAAE,MAAM,EAAE,eAAe,GAAE,MAAM,GAAG,IAAW;CAYtE;AAED;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,KAAK,EAAE,MAAM,CAAC;gBAElB,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAU9C;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,MAAM,EAAE,MAAM,CAAC;gBAEnB,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAQ/C;AAED;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,SAAgB,YAAY,EAAE,MAAM,CAAC;IACrC,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,SAAgB,SAAS,EAAE,MAAM,CAAC;gBAEtB,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAWzE;AAED;;GAEG;AACH,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,SAAgB,YAAY,EAAE,MAAM,CAAC;gBAEzB,YAAY,EAAE,MAAM;CAOjC"}

package/dist/src/shared/errors.js

@@ -44,4 +44,32 @@ export class InvalidSignatureError extends Error {
         Error.captureStackTrace(this, InvalidSignatureError);
     }
 }
+/**
+ * Error thrown when attempting to downgrade a document version.
+ */
+export class DowngradeNotSupportedError extends Error {
+    documentType;
+    fromVersion;
+    toVersion;
+    constructor(documentType, fromVersion, toVersion) {
+        super(`Downgrade not supported for ${documentType}: cannot upgrade from version ${fromVersion} to ${toVersion}`);
+        this.name = "DowngradeNotSupportedError";
+        this.documentType = documentType;
+        this.fromVersion = fromVersion;
+        this.toVersion = toVersion;
+        Error.captureStackTrace(this, DowngradeNotSupportedError);
+    }
+}
+/**
+ * Error thrown when an upgrade manifest is required but not registered.
+ */
+export class UpgradeManifestNotFoundError extends Error {
+    documentType;
+    constructor(documentType) {
+        super(`No upgrade manifest registered for document type: ${documentType}`);
+        this.name = "UpgradeManifestNotFoundError";
+        this.documentType = documentType;
+        Error.captureStackTrace(this, UpgradeManifestNotFoundError);
+    }
+}
 //# sourceMappingURL=errors.js.map

package/dist/src/shared/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/shared/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7B,UAAU,CAAS;IACnB,eAAe,CAAgB;IAE/C,YAAY,UAAkB,EAAE,kBAAiC,IAAI;QACnE,MAAM,OAAO,GAAG,eAAe;YAC7B,CAAC,CAAC,YAAY,UAAU,mBAAmB,eAAe,EAAE;YAC5D,CAAC,CAAC,YAAY,UAAU,mBAAmB,CAAC;QAE9C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QAEvC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;IACtD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IACpC,UAAU,CAAS;IACnB,KAAK,CAAS;IAE9B,YAAY,UAAkB,EAAE,KAAa;QAC3C,MAAM,OAAO,GAAG,YAAY,UAAU,wHAAwH,KAAK,GAAG,CAAC;QAEvK,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;QAC1C,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QAEnB,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,2BAA2B,CAAC,CAAC;IAC7D,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9B,UAAU,CAAS;IACnB,MAAM,CAAS;IAE/B,YAAY,UAAkB,EAAE,MAAc;QAC5C,KAAK,CAAC,iCAAiC,UAAU,KAAK,MAAM,EAAE,CAAC,CAAC;QAChE,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;IACvD,CAAC;CACF"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/shared/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7B,UAAU,CAAS;IACnB,eAAe,CAAgB;IAE/C,YAAY,UAAkB,EAAE,kBAAiC,IAAI;QACnE,MAAM,OAAO,GAAG,eAAe;YAC7B,CAAC,CAAC,YAAY,UAAU,mBAAmB,eAAe,EAAE;YAC5D,CAAC,CAAC,YAAY,UAAU,mBAAmB,CAAC;QAE9C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QAEvC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;IACtD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IACpC,UAAU,CAAS;IACnB,KAAK,CAAS;IAE9B,YAAY,UAAkB,EAAE,KAAa;QAC3C,MAAM,OAAO,GAAG,YAAY,UAAU,wHAAwH,KAAK,GAAG,CAAC;QAEvK,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;QAC1C,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QAEnB,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,2BAA2B,CAAC,CAAC;IAC7D,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9B,UAAU,CAAS;IACnB,MAAM,CAAS;IAE/B,YAAY,UAAkB,EAAE,MAAc;QAC5C,KAAK,CAAC,iCAAiC,UAAU,KAAK,MAAM,EAAE,CAAC,CAAC;QAChE,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;IACvD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IACnC,YAAY,CAAS;IACrB,WAAW,CAAS;IACpB,SAAS,CAAS;IAElC,YAAY,YAAoB,EAAE,WAAmB,EAAE,SAAiB;QACtE,KAAK,CACH,+BAA+B,YAAY,iCAAiC,WAAW,OAAO,SAAS,EAAE,CAC1G,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;QACzC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAE3B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,0BAA0B,CAAC,CAAC;IAC5D,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IACrC,YAAY,CAAS;IAErC,YAAY,YAAoB;QAC9B,KAAK,CAAC,qDAAqD,YAAY,EAAE,CAAC,CAAC;QAC3E,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;QAC3C,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QAEjC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,4BAA4B,CAAC,CAAC;IAC9D,CAAC;CACF"}

package/dist/src/shared/types.d.ts

@@ -54,6 +54,10 @@ export type JobInfo = {
      * A token for coordinating reads, only valid once a job reaches COMPLETED.
      */
     consistencyToken: ConsistencyToken;
+    /**
+     * Optional metadata that flows through the job lifecycle.
+     */
+    meta?: Record<string, unknown>;
 };
 /**
  * Job execution statuses

package/dist/src/shared/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/shared/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,kBAAkB,yCAAyC,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B;;;;;;;;OAQG;IACH,IAAI,UAAU,IAAI,OAAO,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,oBAAY,eAAe;IACzB,IAAI,SAAS;IACb,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,oBAAY,sBAAsB;IAChC,KAAK,UAAU;IACf,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,SAAS,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,YAAY,CAAC,EAAE,SAAS,EAAE,CAAC;IAC3B,MAAM,CAAC,EAAE,GAAG,CAAC;IAEb;;OAEG;IACH,gBAAgB,EAAE,gBAAgB,CAAC;CACpC,CAAC;AAEF;;GAEG;AACH,oBAAY,SAAS;IACnB,wCAAwC;IACxC,OAAO,YAAY;IACnB,sCAAsC;IACtC,OAAO,YAAY;IACnB,oFAAoF;IACpF,eAAe,oBAAoB;IACnC,6EAA6E;IAC7E,iBAAiB,sBAAsB;IACvC,kCAAkC;IAClC,MAAM,WAAW;CAClB;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;IAC5B,OAAO,EAAE,CAAC,EAAE,CAAC;IACb,OAAO,EAAE,aAAa,CAAC;IAEvB,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,GAAG,MAAM,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,CAAC,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,qBAAqB,EAAE,CAAC;CACtC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/shared/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,kBAAkB,yCAAyC,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B;;;;;;;;OAQG;IACH,IAAI,UAAU,IAAI,OAAO,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,oBAAY,eAAe;IACzB,IAAI,SAAS;IACb,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,oBAAY,sBAAsB;IAChC,KAAK,UAAU;IACf,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,SAAS,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,YAAY,CAAC,EAAE,SAAS,EAAE,CAAC;IAC3B,MAAM,CAAC,EAAE,GAAG,CAAC;IAEb;;OAEG;IACH,gBAAgB,EAAE,gBAAgB,CAAC;IAEnC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAEF;;GAEG;AACH,oBAAY,SAAS;IACnB,wCAAwC;IACxC,OAAO,YAAY;IACnB,sCAAsC;IACtC,OAAO,YAAY;IACnB,oFAAoF;IACpF,eAAe,oBAAoB;IACnC,6EAA6E;IAC7E,iBAAiB,sBAAsB;IACvC,kCAAkC;IAClC,MAAM,WAAW;CAClB;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;IAC5B,OAAO,EAAE,CAAC,EAAE,CAAC;IACb,OAAO,EAAE,aAAa,CAAC;IAEvB,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,GAAG,MAAM,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,CAAC,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,qBAAqB,EAAE,CAAC;CACtC,CAAC"}

package/dist/src/shared/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/shared/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,sCAAsC,CAAC;AA0BzE;;GAEG;AACH,MAAM,CAAN,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,gCAAa,CAAA;IACb,sCAAmB,CAAA;AACrB,CAAC,EAHW,eAAe,KAAf,eAAe,QAG1B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,sBAGX;AAHD,WAAY,sBAAsB;IAChC,yCAAe,CAAA;IACf,6CAAmB,CAAA;AACrB,CAAC,EAHW,sBAAsB,KAAtB,sBAAsB,QAGjC;AAoBD;;GAEG;AACH,MAAM,CAAN,IAAY,SAWX;AAXD,WAAY,SAAS;IACnB,wCAAwC;IACxC,gCAAmB,CAAA;IACnB,sCAAsC;IACtC,gCAAmB,CAAA;IACnB,oFAAoF;IACpF,gDAAmC,CAAA;IACnC,6EAA6E;IAC7E,oDAAuC,CAAA;IACvC,kCAAkC;IAClC,8BAAiB,CAAA;AACnB,CAAC,EAXW,SAAS,KAAT,SAAS,QAWpB"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/shared/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,sCAAsC,CAAC;AA0BzE;;GAEG;AACH,MAAM,CAAN,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,gCAAa,CAAA;IACb,sCAAmB,CAAA;AACrB,CAAC,EAHW,eAAe,KAAf,eAAe,QAG1B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,sBAGX;AAHD,WAAY,sBAAsB;IAChC,yCAAe,CAAA;IACf,6CAAmB,CAAA;AACrB,CAAC,EAHW,sBAAsB,KAAtB,sBAAsB,QAGjC;AAyBD;;GAEG;AACH,MAAM,CAAN,IAAY,SAWX;AAXD,WAAY,SAAS;IACnB,wCAAwC;IACxC,gCAAmB,CAAA;IACnB,sCAAsC;IACtC,gCAAmB,CAAA;IACnB,oFAAoF;IACpF,gDAAmC,CAAA;IACnC,6EAA6E;IAC7E,oDAAuC,CAAA;IACvC,kCAAkC;IAClC,8BAAiB,CAAA;AACnB,CAAC,EAXW,SAAS,KAAT,SAAS,QAWpB"}

package/dist/src/signer/passthrough-signer.d.ts

@@ -1,6 +1,12 @@
-import type { Signature } from "document-model";
-import type { ISigner } from "./types.js";
+import type { ISigner, Signature } from "document-model";
+/**
+ * A no-op signer that returns empty values for all methods.
+ * Used when signing is not required.
+ */
 export declare class PassthroughSigner implements ISigner {
-    sign(): Promise<Signature>;
+    publicKey(): Promise<JsonWebKey>;
+    sign(): Promise<Uint8Array>;
+    verify(): Promise<void>;
+    signAction(): Promise<Signature>;
 }
 //# sourceMappingURL=passthrough-signer.d.ts.map

package/dist/src/signer/passthrough-signer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"passthrough-signer.d.ts","sourceRoot":"","sources":["../../../src/signer/passthrough-signer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,qBAAa,iBAAkB,YAAW,OAAO;IAC/C,IAAI,IAAI,OAAO,CAAC,SAAS,CAAC;CAG3B"}
+{"version":3,"file":"passthrough-signer.d.ts","sourceRoot":"","sources":["../../../src/signer/passthrough-signer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEzD;;;GAGG;AACH,qBAAa,iBAAkB,YAAW,OAAO;IAC/C,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC;IAIhC,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC;IAI3B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvB,UAAU,IAAI,OAAO,CAAC,SAAS,CAAC;CAGjC"}