@powerhousedao/reactor 5.1.0-dev.4 → 5.1.0-dev.41

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

@@ -0,0 +1,12 @@
+export type LoggerErrorHandler = (...data: any[]) => void;
+export type ILogger = {
+    level: "verbose" | "debug" | "info" | "warn" | "error";
+    verbose: (message: string, ...replacements: any[]) => void;
+    debug: (message: string, ...replacements: any[]) => void;
+    info: (message: string, ...replacements: any[]) => void;
+    warn: (message: string, ...replacements: any[]) => void;
+    error: (message: string, ...replacements: any[]) => void;
+    errorHandler: LoggerErrorHandler;
+    child: (tags: string[]) => ILogger;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/logging/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;AAE1D,MAAM,MAAM,OAAO,GAAG;IACpB,KAAK,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAEvD,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAC3D,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IACzD,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IACxD,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IACxD,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAEzD,YAAY,EAAE,kBAAkB,CAAC;IAEjC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC;CACpC,CAAC"}

package/dist/src/logging/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/logging/types.ts"],"names":[],"mappings":""}

package/dist/src/processors/index.d.ts

@@ -0,0 +1,3 @@
+export { ProcessorManager } from "./processor-manager.js";
+export type { IProcessor, IProcessorManager, ProcessorFactory, ProcessorFilter, ProcessorRecord, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/processors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/processors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EACV,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/src/processors/index.js

@@ -0,0 +1,2 @@
+export { ProcessorManager } from "./processor-manager.js";
+//# sourceMappingURL=index.js.map

package/dist/src/processors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/processors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/src/processors/processor-manager.d.ts

@@ -0,0 +1,38 @@
+import type { Kysely } from "kysely";
+import type { IOperationIndex } from "../cache/operation-index-types.js";
+import type { IWriteCache } from "../cache/write/interfaces.js";
+import { BaseReadModel } from "../read-models/base-read-model.js";
+import type { DocumentViewDatabase } from "../read-models/types.js";
+import type { IConsistencyTracker } from "../shared/consistency-tracker.js";
+import type { OperationWithContext } from "../storage/interfaces.js";
+import type { IProcessorManager, ProcessorFactory, ProcessorRecord } from "./types.js";
+/**
+ * Manages processor lifecycle based on operations.
+ * Extends BaseReadModel to receive operations from ReadModelCoordinator.
+ *
+ * Responsibilities:
+ * 1. Detect drive creation from CREATE_DOCUMENT operations
+ * 2. Create processors for each drive using registered factories
+ * 3. Route operations to matching processors based on filters
+ * 4. Clean up processors when drives are deleted or factories are unregistered
+ */
+export declare class ProcessorManager extends BaseReadModel implements IProcessorManager {
+    private factoryRegistry;
+    private processorsByDrive;
+    private factoryToProcessors;
+    private knownDriveIds;
+    constructor(db: Kysely<DocumentViewDatabase>, operationIndex: IOperationIndex, writeCache: IWriteCache, consistencyTracker: IConsistencyTracker);
+    indexOperations(items: OperationWithContext[]): Promise<void>;
+    registerFactory(identifier: string, factory: ProcessorFactory): Promise<void>;
+    unregisterFactory(identifier: string): Promise<void>;
+    getFactoryIdentifiers(): string[];
+    getProcessorsForDrive(driveId: string): ProcessorRecord[];
+    private detectAndRegisterNewDrives;
+    private detectAndCleanupDeletedDrives;
+    private isDeletedDocumentADrive;
+    private createProcessorsForDrive;
+    private cleanupDriveProcessors;
+    private safeDisconnect;
+    private routeOperationsToProcessors;
+}
+//# sourceMappingURL=processor-manager.d.ts.map

package/dist/src/processors/processor-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor-manager.d.ts","sourceRoot":"","sources":["../../../src/processors/processor-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAe,MAAM,QAAQ,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAEV,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EAChB,MAAM,YAAY,CAAC;AAUpB;;;;;;;;;GASG;AACH,qBAAa,gBACX,SAAQ,aACR,YAAW,iBAAiB;IAE5B,OAAO,CAAC,eAAe,CAA4C;IACnE,OAAO,CAAC,iBAAiB,CAA6C;IACtE,OAAO,CAAC,mBAAmB,CACf;IACZ,OAAO,CAAC,aAAa,CAA0B;gBAG7C,EAAE,EAAE,MAAM,CAAC,oBAAoB,CAAC,EAChC,cAAc,EAAE,eAAe,EAC/B,UAAU,EAAE,WAAW,EACvB,kBAAkB,EAAE,mBAAmB;IAW1B,eAAe,CAAC,KAAK,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBtE,eAAe,CACnB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,IAAI,CAAC;IAmBV,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB1D,qBAAqB,IAAI,MAAM,EAAE;IAIjC,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE;YAI3C,0BAA0B;YAyB1B,6BAA6B;IAgB3C,OAAO,CAAC,uBAAuB;YAIjB,wBAAwB;YAgCxB,sBAAsB;YAetB,cAAc;YAQd,2BAA2B;CA+B1C"}

package/dist/src/processors/processor-manager.js

@@ -0,0 +1,165 @@
+import { BaseReadModel } from "../read-models/base-read-model.js";
+import { createMinimalDriveHeader, extractDeletedDocumentId, extractDriveHeader, isDriveCreation, isDriveDeletion, matchesFilter, } from "./utils.js";
+/**
+ * Manages processor lifecycle based on operations.
+ * Extends BaseReadModel to receive operations from ReadModelCoordinator.
+ *
+ * Responsibilities:
+ * 1. Detect drive creation from CREATE_DOCUMENT operations
+ * 2. Create processors for each drive using registered factories
+ * 3. Route operations to matching processors based on filters
+ * 4. Clean up processors when drives are deleted or factories are unregistered
+ */
+export class ProcessorManager extends BaseReadModel {
+    factoryRegistry = new Map();
+    processorsByDrive = new Map();
+    factoryToProcessors = new Map();
+    knownDriveIds = new Set();
+    constructor(db, operationIndex, writeCache, consistencyTracker) {
+        super(db, operationIndex, writeCache, consistencyTracker, "processor-manager");
+    }
+    async indexOperations(items) {
+        if (items.length === 0)
+            return;
+        await this.detectAndRegisterNewDrives(items);
+        await this.detectAndCleanupDeletedDrives(items);
+        await this.routeOperationsToProcessors(items);
+        await this.db.transaction().execute(async (trx) => {
+            await this.saveState(trx, items);
+        });
+        this.updateConsistencyTracker(items);
+    }
+    async registerFactory(identifier, factory) {
+        if (this.factoryRegistry.has(identifier)) {
+            await this.unregisterFactory(identifier);
+        }
+        this.factoryRegistry.set(identifier, factory);
+        this.factoryToProcessors.set(identifier, new Map());
+        for (const driveId of this.knownDriveIds) {
+            const driveHeader = createMinimalDriveHeader(driveId);
+            await this.createProcessorsForDrive(driveId, identifier, factory, driveHeader);
+        }
+    }
+    async unregisterFactory(identifier) {
+        const factoryProcessors = this.factoryToProcessors.get(identifier);
+        if (!factoryProcessors)
+            return;
+        for (const [driveId, records] of factoryProcessors) {
+            for (const record of records) {
+                await this.safeDisconnect(record.processor);
+            }
+            const driveProcessors = this.processorsByDrive.get(driveId);
+            if (driveProcessors) {
+                const remaining = driveProcessors.filter((p) => !records.includes(p));
+                if (remaining.length > 0) {
+                    this.processorsByDrive.set(driveId, remaining);
+                }
+                else {
+                    this.processorsByDrive.delete(driveId);
+                }
+            }
+        }
+        this.factoryToProcessors.delete(identifier);
+        this.factoryRegistry.delete(identifier);
+    }
+    getFactoryIdentifiers() {
+        return Array.from(this.factoryRegistry.keys());
+    }
+    getProcessorsForDrive(driveId) {
+        return this.processorsByDrive.get(driveId) ?? [];
+    }
+    async detectAndRegisterNewDrives(operations) {
+        for (const op of operations) {
+            if (!isDriveCreation(op))
+                continue;
+            const driveId = op.context.documentId;
+            if (this.knownDriveIds.has(driveId))
+                continue;
+            this.knownDriveIds.add(driveId);
+            const driveHeader = extractDriveHeader(op);
+            if (!driveHeader)
+                continue;
+            for (const [identifier, factory] of this.factoryRegistry) {
+                await this.createProcessorsForDrive(driveId, identifier, factory, driveHeader);
+            }
+        }
+    }
+    async detectAndCleanupDeletedDrives(operations) {
+        for (const op of operations) {
+            if (!isDriveDeletion(op))
+                continue;
+            const driveId = extractDeletedDocumentId(op);
+            if (!driveId || !this.knownDriveIds.has(driveId))
+                continue;
+            if (!this.isDeletedDocumentADrive(driveId))
+                continue;
+            await this.cleanupDriveProcessors(driveId);
+            this.knownDriveIds.delete(driveId);
+        }
+    }
+    isDeletedDocumentADrive(documentId) {
+        return this.knownDriveIds.has(documentId);
+    }
+    async createProcessorsForDrive(driveId, identifier, factory, driveHeader) {
+        let records = [];
+        try {
+            records = await factory(driveHeader);
+        }
+        catch (error) {
+            console.error(`ProcessorManager: Factory '${identifier}' failed for drive '${driveId}':`, error);
+            return;
+        }
+        if (records.length === 0)
+            return;
+        const factoryProcessors = this.factoryToProcessors.get(identifier);
+        if (factoryProcessors) {
+            factoryProcessors.set(driveId, records);
+        }
+        const existingDriveProcessors = this.processorsByDrive.get(driveId) ?? [];
+        this.processorsByDrive.set(driveId, [
+            ...existingDriveProcessors,
+            ...records,
+        ]);
+    }
+    async cleanupDriveProcessors(driveId) {
+        const processors = this.processorsByDrive.get(driveId);
+        if (!processors)
+            return;
+        for (const record of processors) {
+            await this.safeDisconnect(record.processor);
+        }
+        this.processorsByDrive.delete(driveId);
+        for (const factoryProcessors of this.factoryToProcessors.values()) {
+            factoryProcessors.delete(driveId);
+        }
+    }
+    async safeDisconnect(processor) {
+        try {
+            await processor.onDisconnect();
+        }
+        catch (error) {
+            console.error("ProcessorManager: Error disconnecting processor:", error);
+        }
+    }
+    async routeOperationsToProcessors(operations) {
+        const processorOperations = new Map();
+        for (const [, records] of this.processorsByDrive) {
+            for (const { processor, filter } of records) {
+                const matching = operations.filter((op) => matchesFilter(op, filter));
+                if (matching.length === 0)
+                    continue;
+                const existing = processorOperations.get(processor) ?? [];
+                processorOperations.set(processor, [...existing, ...matching]);
+            }
+        }
+        await Promise.all(Array.from(processorOperations.entries()).map(async ([processor, ops]) => {
+            try {
+                await processor.onOperations(ops);
+            }
+            catch (error) {
+                console.error("ProcessorManager: Error in processor.onOperations:", error);
+            }
+        }));
+    }
+}
+//# sourceMappingURL=processor-manager.js.map

package/dist/src/processors/processor-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor-manager.js","sourceRoot":"","sources":["../../../src/processors/processor-manager.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,63 @@
+import type { PHDocumentHeader } from "document-model";
+import type { OperationWithContext } from "../storage/interfaces.js";
+/**
+ * Filter for matching operations to processors.
+ * All fields are optional arrays - when provided, operations must match at least one value in each specified field.
+ * When a field is undefined or empty, it matches all values for that field.
+ */
+export type ProcessorFilter = {
+    documentType?: string[];
+    scope?: string[];
+    branch?: string[];
+    documentId?: string[];
+};
+/**
+ * Describes an object that can process operations.
+ */
+export interface IProcessor {
+    /**
+     * Processes a list of operations with context.
+     * Called when operations match this processor's filter.
+     */
+    onOperations(operations: OperationWithContext[]): Promise<void>;
+    /**
+     * Called when the processor is disconnected.
+     * Used to clean up any resources allocated during processor creation.
+     */
+    onDisconnect(): Promise<void>;
+}
+/**
+ * Relates a processor to its filter configuration.
+ */
+export type ProcessorRecord = {
+    processor: IProcessor;
+    filter: ProcessorFilter;
+};
+/**
+ * A factory function that creates processor records for a given drive.
+ * Called once per drive when the drive is first detected or when the factory is registered.
+ */
+export type ProcessorFactory = (driveHeader: PHDocumentHeader) => ProcessorRecord[] | Promise<ProcessorRecord[]>;
+/**
+ * Manages processor creation and destruction based on drive operations.
+ */
+export interface IProcessorManager {
+    /**
+     * Registers a processor factory.
+     * Immediately creates processors for all existing drives.
+     */
+    registerFactory(identifier: string, factory: ProcessorFactory): Promise<void>;
+    /**
+     * Unregisters a processor factory and disconnects all processors it created.
+     */
+    unregisterFactory(identifier: string): Promise<void>;
+    /**
+     * Gets all registered factory identifiers.
+     */
+    getFactoryIdentifiers(): string[];
+    /**
+     * Gets all processor records for a specific drive.
+     */
+    getProcessorsForDrive(driveId: string): ProcessorRecord[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/processors/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,YAAY,CAAC,UAAU,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhE;;;OAGG;IACH,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,UAAU,CAAC;IACtB,MAAM,EAAE,eAAe,CAAC;CACzB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,WAAW,EAAE,gBAAgB,KAC1B,eAAe,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9E;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErD;;OAEG;IACH,qBAAqB,IAAI,MAAM,EAAE,CAAC;IAElC;;OAEG;IACH,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE,CAAC;CAC3D"}

package/dist/src/processors/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/processors/types.ts"],"names":[],"mappings":""}

package/dist/src/processors/utils.d.ts

@@ -0,0 +1,10 @@
+import type { PHDocumentHeader } from "document-model";
+import type { OperationWithContext } from "../storage/interfaces.js";
+import type { ProcessorFilter } from "./types.js";
+export declare function isDriveCreation(op: OperationWithContext): boolean;
+export declare function isDriveDeletion(op: OperationWithContext): boolean;
+export declare function extractDriveHeader(op: OperationWithContext): PHDocumentHeader | undefined;
+export declare function extractDeletedDocumentId(op: OperationWithContext): string | undefined;
+export declare function createMinimalDriveHeader(driveId: string): PHDocumentHeader;
+export declare function matchesFilter(op: OperationWithContext, filter: ProcessorFilter): boolean;
+//# sourceMappingURL=utils.d.ts.map

package/dist/src/processors/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/processors/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAIlD,wBAAgB,eAAe,CAAC,EAAE,EAAE,oBAAoB,GAAG,OAAO,CAKjE;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,oBAAoB,GAAG,OAAO,CAEjE;AAED,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,oBAAoB,GACvB,gBAAgB,GAAG,SAAS,CAQ9B;AAED,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,oBAAoB,GACvB,MAAM,GAAG,SAAS,CAGpB;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAe1E;AAED,wBAAgB,aAAa,CAC3B,EAAE,EAAE,oBAAoB,EACxB,MAAM,EAAE,eAAe,GACtB,OAAO,CA0BT"}

package/dist/src/processors/utils.js

@@ -0,0 +1,58 @@
+const DRIVE_DOCUMENT_TYPE = "powerhouse/document-drive";
+export function isDriveCreation(op) {
+    return (op.operation.action.type === "CREATE_DOCUMENT" &&
+        op.context.documentType === DRIVE_DOCUMENT_TYPE);
+}
+export function isDriveDeletion(op) {
+    return op.operation.action.type === "DELETE_DOCUMENT";
+}
+export function extractDriveHeader(op) {
+    if (!op.context.resultingState)
+        return undefined;
+    const state = JSON.parse(op.context.resultingState);
+    return state.header;
+}
+export function extractDeletedDocumentId(op) {
+    const input = op.operation.action.input;
+    return input.documentId ?? op.context.documentId;
+}
+export function createMinimalDriveHeader(driveId) {
+    return {
+        id: driveId,
+        documentType: DRIVE_DOCUMENT_TYPE,
+        sig: {
+            publicKey: {},
+            nonce: "",
+        },
+        slug: "",
+        name: "",
+        branch: "main",
+        revision: {},
+        createdAtUtcIso: new Date().toISOString(),
+        lastModifiedAtUtcIso: new Date().toISOString(),
+    };
+}
+export function matchesFilter(op, filter) {
+    if (filter.documentType && filter.documentType.length > 0) {
+        if (!filter.documentType.includes(op.context.documentType)) {
+            return false;
+        }
+    }
+    if (filter.scope && filter.scope.length > 0) {
+        if (!filter.scope.includes(op.context.scope)) {
+            return false;
+        }
+    }
+    if (filter.branch && filter.branch.length > 0) {
+        if (!filter.branch.includes(op.context.branch)) {
+            return false;
+        }
+    }
+    if (filter.documentId && filter.documentId.length > 0) {
+        if (!filter.documentId.includes(op.context.documentId)) {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=utils.js.map

package/dist/src/processors/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/processors/utils.ts"],"names":[],"mappings":"AAIA,MAAM,mBAAmB,GAAG,2BAA2B,CAAC;AAExD,MAAM,UAAU,eAAe,CAAC,EAAwB;IACtD,OAAO,CACL,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,KAAK,iBAAiB;QAC9C,EAAE,CAAC,OAAO,CAAC,YAAY,KAAK,mBAAmB,CAChD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,EAAwB;IACtD,OAAO,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,KAAK,iBAAiB,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,EAAwB;IAExB,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,cAAc;QAAE,OAAO,SAAS,CAAC;IAEjD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,cAAc,CAGjD,CAAC;IACF,OAAO,KAAK,CAAC,MAAsC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,EAAwB;IAExB,MAAM,KAAK,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,KAAgC,CAAC;IACnE,OAAO,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,OAAe;IACtD,OAAO;QACL,EAAE,EAAE,OAAO;QACX,YAAY,EAAE,mBAAmB;QACjC,GAAG,EAAE;YACH,SAAS,EAAE,EAAE;YACb,KAAK,EAAE,EAAE;SACV;QACD,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,EAAE;QACR,MAAM,EAAE,MAAM;QACd,QAAQ,EAAE,EAAE;QACZ,eAAe,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACzC,oBAAoB,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KAC/C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,EAAwB,EACxB,MAAuB;IAEvB,IAAI,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1D,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;YAC3D,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7C,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/C,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtD,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YACvD,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

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

@@ -52,6 +52,8 @@ export type Job = {
     lastError?: ErrorInfo;
     /** History of all errors from each attempt (ordered) */
     errorHistory: ErrorInfo[];
+    /** Optional metadata that flows through the job lifecycle */
+    meta?: Record<string, unknown>;
 };
 /**
  * Event types for the queue system

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/queue/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;AAE1C;;GAEG;AACH,oBAAY,aAAa;IACvB,OAAO,KAAK;IACZ,aAAa,IAAI;IACjB,OAAO,IAAI;IACX,KAAK,IAAI;IACT,OAAO,IAAI;IACX,QAAQ,IAAI;CACb;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAE9B,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,IAAI,IAAI,CAAC;IACjB,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,MAAM,GAAG,GAAG;IAChB,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAC;IAEX,iEAAiE;IACjE,IAAI,EAAE,OAAO,CAAC;IAEd,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IAEnB,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IAEd,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IAEf,0DAA0D;IAC1D,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB,6DAA6D;IAC7D,UAAU,EAAE,SAAS,EAAE,CAAC;IAExB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAElB,yDAAyD;IACzD,SAAS,EAAE,MAAM,EAAE,CAAC;IAEpB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB,wDAAwD;IACxD,YAAY,EAAE,SAAS,EAAE,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe;;CAElB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/queue/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;AAE1C;;GAEG;AACH,oBAAY,aAAa;IACvB,OAAO,KAAK;IACZ,aAAa,IAAI;IACjB,OAAO,IAAI;IACX,KAAK,IAAI;IACT,OAAO,IAAI;IACX,QAAQ,IAAI;CACb;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAE9B,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,IAAI,IAAI,CAAC;IACjB,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,MAAM,GAAG,GAAG;IAChB,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAC;IAEX,iEAAiE;IACjE,IAAI,EAAE,OAAO,CAAC;IAEd,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IAEnB,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IAEd,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IAEf,0DAA0D;IAC1D,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB,6DAA6D;IAC7D,UAAU,EAAE,SAAS,EAAE,CAAC;IAExB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAElB,yDAAyD;IACzD,SAAS,EAAE,MAAM,EAAE,CAAC;IAEpB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB,wDAAwD;IACxD,YAAY,EAAE,SAAS,EAAE,CAAC;IAE1B,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe;;CAElB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/queue/types.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,CAAN,IAAY,aAOX;AAPD,WAAY,aAAa;IACvB,wDAAY,CAAA;IACZ,mEAAiB,CAAA;IACjB,uDAAW,CAAA;IACX,mDAAS,CAAA;IACT,uDAAW,CAAA;IACX,yDAAY,CAAA;AACd,CAAC,EAPW,aAAa,KAAb,aAAa,QAOxB;AA0DD;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,aAAa,EAAE,KAAK;CACZ,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/queue/types.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,CAAN,IAAY,aAOX;AAPD,WAAY,aAAa;IACvB,wDAAY,CAAA;IACZ,mEAAiB,CAAA;IACjB,uDAAW,CAAA;IACX,mDAAS,CAAA;IACT,uDAAW,CAAA;IACX,yDAAY,CAAA;AACd,CAAC,EAPW,aAAa,KAAb,aAAa,QAOxB;AA6DD;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,aAAa,EAAE,KAAK;CACZ,CAAC"}

package/dist/src/read-models/base-read-model.d.ts

@@ -0,0 +1,60 @@
+import type { Kysely, Transaction } from "kysely";
+import type { IOperationIndex } from "../cache/operation-index-types.js";
+import type { IWriteCache } from "../cache/write/interfaces.js";
+import type { IConsistencyTracker } from "../shared/consistency-tracker.js";
+import type { ConsistencyToken } from "../shared/types.js";
+import type { OperationWithContext } from "../storage/interfaces.js";
+import type { IReadModel } from "./interfaces.js";
+import type { DocumentViewDatabase } from "./types.js";
+/**
+ * Base class for read models that provides catch-up/rewind functionality.
+ * Handles initialization, state tracking via ViewState table, and consistency tracking.
+ * Subclasses should override indexOperations() with their specific indexing logic.
+ */
+export declare class BaseReadModel implements IReadModel {
+    protected db: Kysely<DocumentViewDatabase>;
+    protected operationIndex: IOperationIndex;
+    protected writeCache: IWriteCache;
+    protected consistencyTracker: IConsistencyTracker;
+    protected readModelId: string;
+    protected lastOrdinal: number;
+    constructor(db: Kysely<DocumentViewDatabase>, operationIndex: IOperationIndex, writeCache: IWriteCache, consistencyTracker: IConsistencyTracker, readModelId: string);
+    /**
+     * Initializes the read model by loading state and catching up on missed operations.
+     */
+    init(): Promise<void>;
+    /**
+     * Indexes operations into the read model.
+     * Subclasses should override this method to implement their specific indexing logic.
+     * The overriding method should call saveState() and updateConsistencyTracker() at the end.
+     */
+    indexOperations(items: OperationWithContext[]): Promise<void>;
+    /**
+     * Waits for the read model to reach the specified consistency level.
+     */
+    waitForConsistency(token: ConsistencyToken, timeoutMs?: number, signal?: AbortSignal): Promise<void>;
+    /**
+     * Rebuilds document state for each operation using the write cache.
+     */
+    protected rebuildStateForOperations(operations: OperationWithContext[]): Promise<OperationWithContext[]>;
+    /**
+     * Loads the last processed ordinal from the ViewState table.
+     * Returns undefined if no state exists for this read model.
+     */
+    protected loadState(): Promise<number | undefined>;
+    /**
+     * Initializes the ViewState row for this read model.
+     */
+    protected initializeState(): Promise<void>;
+    /**
+     * Saves the last processed ordinal to the ViewState table.
+     * Should be called at the end of indexOperations() within a transaction.
+     */
+    protected saveState(trx: Transaction<DocumentViewDatabase>, items: OperationWithContext[]): Promise<void>;
+    /**
+     * Updates the consistency tracker with the processed operations.
+     * Should be called at the end of indexOperations() after the transaction commits.
+     */
+    protected updateConsistencyTracker(items: OperationWithContext[]): void;
+}
+//# sourceMappingURL=base-read-model.d.ts.map

package/dist/src/read-models/base-read-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-read-model.d.ts","sourceRoot":"","sources":["../../../src/read-models/base-read-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAEV,gBAAgB,EACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD;;;;GAIG;AACH,qBAAa,aAAc,YAAW,UAAU;IAI5C,SAAS,CAAC,EAAE,EAAE,MAAM,CAAC,oBAAoB,CAAC;IAC1C,SAAS,CAAC,cAAc,EAAE,eAAe;IACzC,SAAS,CAAC,UAAU,EAAE,WAAW;IACjC,SAAS,CAAC,kBAAkB,EAAE,mBAAmB;IACjD,SAAS,CAAC,WAAW,EAAE,MAAM;IAP/B,SAAS,CAAC,WAAW,EAAE,MAAM,CAAK;gBAGtB,EAAE,EAAE,MAAM,CAAC,oBAAoB,CAAC,EAChC,cAAc,EAAE,eAAe,EAC/B,UAAU,EAAE,WAAW,EACvB,kBAAkB,EAAE,mBAAmB,EACvC,WAAW,EAAE,MAAM;IAG/B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B3B;;;;OAIG;IACG,eAAe,CAAC,KAAK,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAUnE;;OAEG;IACG,kBAAkB,CACtB,KAAK,EAAE,gBAAgB,EACvB,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC;IAOhB;;OAEG;cACa,yBAAyB,CACvC,UAAU,EAAE,oBAAoB,EAAE,GACjC,OAAO,CAAC,oBAAoB,EAAE,CAAC;IA0BlC;;;OAGG;cACa,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAWxD;;OAEG;cACa,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAWhD;;;OAGG;cACa,SAAS,CACvB,GAAG,EAAE,WAAW,CAAC,oBAAoB,CAAC,EACtC,KAAK,EAAE,oBAAoB,EAAE,GAC5B,OAAO,CAAC,IAAI,CAAC;IAchB;;;OAGG;IACH,SAAS,CAAC,wBAAwB,CAAC,KAAK,EAAE,oBAAoB,EAAE,GAAG,IAAI;CAexE"}