@powerhousedao/reactor 4.1.0-dev.11 → 4.1.0-dev.110

package/dist/src/storage/migrations/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./types.js";
+export * from "./migrator.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/storage/migrations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/storage/migrations/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC"}

package/dist/src/storage/migrations/index.js

@@ -0,0 +1,3 @@
+export * from "./types.js";
+export * from "./migrator.js";
+//# sourceMappingURL=index.js.map

package/dist/src/storage/migrations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/storage/migrations/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC"}

package/dist/src/storage/migrations/migrator.d.ts

@@ -0,0 +1,5 @@
+import type { Kysely } from "kysely";
+import type { MigrationResult } from "./types.js";
+export declare function runMigrations(db: Kysely<any>): Promise<MigrationResult>;
+export declare function getMigrationStatus(db: Kysely<any>): Promise<readonly import("kysely").MigrationInfo[]>;
+//# sourceMappingURL=migrator.d.ts.map

package/dist/src/storage/migrations/migrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrator.d.ts","sourceRoot":"","sources":["../../../../src/storage/migrations/migrator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAqB,MAAM,EAAE,MAAM,QAAQ,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AA2BlD,wBAAsB,aAAa,CAAC,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,CAwB7E;AAED,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,sDAOvD"}

package/dist/src/storage/migrations/migrator.js

@@ -0,0 +1,51 @@
+import { Migrator } from "kysely";
+import * as migration001 from "./001_create_operation_table.js";
+import * as migration002 from "./002_create_keyframe_table.js";
+import * as migration003 from "./003_create_document_table.js";
+import * as migration004 from "./004_create_document_relationship_table.js";
+import * as migration005 from "./005_create_indexer_state_table.js";
+import * as migration006 from "./006_create_document_snapshot_table.js";
+import * as migration007 from "./007_create_slug_mapping_table.js";
+import * as migration008 from "./008_create_view_state_table.js";
+const migrations = {
+    "001_create_operation_table": migration001,
+    "002_create_keyframe_table": migration002,
+    "003_create_document_table": migration003,
+    "004_create_document_relationship_table": migration004,
+    "005_create_indexer_state_table": migration005,
+    "006_create_document_snapshot_table": migration006,
+    "007_create_slug_mapping_table": migration007,
+    "008_create_view_state_table": migration008,
+};
+class ProgrammaticMigrationProvider {
+    getMigrations() {
+        return Promise.resolve(migrations);
+    }
+}
+export async function runMigrations(db) {
+    const migrator = new Migrator({
+        db,
+        provider: new ProgrammaticMigrationProvider(),
+    });
+    const { error, results } = await migrator.migrateToLatest();
+    const migrationsExecuted = results?.map((result) => result.migrationName) ?? [];
+    if (error) {
+        return {
+            success: false,
+            migrationsExecuted,
+            error: error instanceof Error ? error : new Error("Unknown migration error"),
+        };
+    }
+    return {
+        success: true,
+        migrationsExecuted,
+    };
+}
+export async function getMigrationStatus(db) {
+    const migrator = new Migrator({
+        db,
+        provider: new ProgrammaticMigrationProvider(),
+    });
+    return await migrator.getMigrations();
+}
+//# sourceMappingURL=migrator.js.map

package/dist/src/storage/migrations/migrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrator.js","sourceRoot":"","sources":["../../../../src/storage/migrations/migrator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAGlC,OAAO,KAAK,YAAY,MAAM,iCAAiC,CAAC;AAChE,OAAO,KAAK,YAAY,MAAM,gCAAgC,CAAC;AAC/D,OAAO,KAAK,YAAY,MAAM,gCAAgC,CAAC;AAC/D,OAAO,KAAK,YAAY,MAAM,6CAA6C,CAAC;AAC5E,OAAO,KAAK,YAAY,MAAM,qCAAqC,CAAC;AACpE,OAAO,KAAK,YAAY,MAAM,yCAAyC,CAAC;AACxE,OAAO,KAAK,YAAY,MAAM,oCAAoC,CAAC;AACnE,OAAO,KAAK,YAAY,MAAM,kCAAkC,CAAC;AAEjE,MAAM,UAAU,GAAG;IACjB,4BAA4B,EAAE,YAAY;IAC1C,2BAA2B,EAAE,YAAY;IACzC,2BAA2B,EAAE,YAAY;IACzC,wCAAwC,EAAE,YAAY;IACtD,gCAAgC,EAAE,YAAY;IAC9C,oCAAoC,EAAE,YAAY;IAClD,+BAA+B,EAAE,YAAY;IAC7C,6BAA6B,EAAE,YAAY;CAC5C,CAAC;AAEF,MAAM,6BAA6B;IACjC,aAAa;QACX,OAAO,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACrC,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,EAAe;IACjD,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC;QAC5B,EAAE;QACF,QAAQ,EAAE,IAAI,6BAA6B,EAAE;KAC9C,CAAC,CAAC;IAEH,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,QAAQ,CAAC,eAAe,EAAE,CAAC;IAE5D,MAAM,kBAAkB,GACtB,OAAO,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;IAEvD,IAAI,KAAK,EAAE,CAAC;QACV,OAAO;YACL,OAAO,EAAE,KAAK;YACd,kBAAkB;YAClB,KAAK,EACH,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,yBAAyB,CAAC;SACxE,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI;QACb,kBAAkB;KACnB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,EAAe;IACtD,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC;QAC5B,EAAE;QACF,QAAQ,EAAE,IAAI,6BAA6B,EAAE;KAC9C,CAAC,CAAC;IAEH,OAAO,MAAM,QAAQ,CAAC,aAAa,EAAE,CAAC;AACxC,CAAC"}

package/dist/src/storage/migrations/run-migrations.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=run-migrations.d.ts.map

package/dist/src/storage/migrations/run-migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-migrations.d.ts","sourceRoot":"","sources":["../../../../src/storage/migrations/run-migrations.ts"],"names":[],"mappings":""}

package/dist/src/storage/migrations/run-migrations.js

@@ -0,0 +1,58 @@
+import { Kysely } from "kysely";
+import { KyselyPGlite } from "kysely-pglite";
+import { runMigrations, getMigrationStatus } from "./migrator.js";
+async function main() {
+    const command = process.argv[2];
+    const kyselyPGlite = await KyselyPGlite.create();
+    const db = new Kysely({
+        dialect: kyselyPGlite.dialect,
+    });
+    try {
+        if (command === "up" || !command) {
+            console.log("Running migrations...");
+            const result = await runMigrations(db);
+            if (!result.success) {
+                console.error("Migration failed:", result.error?.message);
+                process.exit(1);
+            }
+            if (result.migrationsExecuted.length === 0) {
+                console.log("No migrations to run - database is up to date");
+            }
+            else {
+                console.log(`Successfully executed ${result.migrationsExecuted.length} migration(s):`);
+                for (const name of result.migrationsExecuted) {
+                    console.log(`  - ${name}`);
+                }
+            }
+        }
+        else if (command === "status") {
+            console.log("Checking migration status...");
+            const migrations = await getMigrationStatus(db);
+            console.log("\nMigration Status:");
+            console.log("=================");
+            for (const migration of migrations) {
+                const status = migration.executedAt
+                    ? `✓ Executed at ${migration.executedAt.toISOString()}`
+                    : "○ Pending";
+                console.log(`${status} - ${migration.name}`);
+            }
+        }
+        else {
+            console.error(`Unknown command: ${command}`);
+            console.log("\nUsage:");
+            console.log("  pnpm migrate       - Run pending migrations");
+            console.log("  pnpm migrate up    - Run pending migrations");
+            console.log("  pnpm migrate status - Show migration status");
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        console.error("Error:", error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+    finally {
+        await db.destroy();
+    }
+}
+void main();
+//# sourceMappingURL=run-migrations.js.map

package/dist/src/storage/migrations/run-migrations.js.map

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

package/dist/src/storage/migrations/types.d.ts

@@ -0,0 +1,9 @@
+import type { Migration } from "kysely";
+export type MigrationStrategy = "auto" | "manual" | "none";
+export interface MigrationResult {
+    success: boolean;
+    migrationsExecuted: string[];
+    error?: Error;
+}
+export type ReactorMigration = Migration;
+//# sourceMappingURL=types.d.ts.map

package/dist/src/storage/migrations/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/storage/migrations/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAExC,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE3D,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,MAAM,gBAAgB,GAAG,SAAS,CAAC"}

package/dist/src/storage/migrations/types.js

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

package/dist/src/storage/migrations/types.js.map

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

package/dist/src/storage/txn.d.ts

@@ -0,0 +1,15 @@
+import type { Operation } from "document-model";
+import { type AtomicTxn as IAtomicTxn } from "./interfaces.js";
+import type { InsertableOperation } from "./kysely/types.js";
+export declare class AtomicTransaction implements IAtomicTxn {
+    private documentId;
+    private documentType;
+    private scope;
+    private branch;
+    private baseRevision;
+    private operations;
+    constructor(documentId: string, documentType: string, scope: string, branch: string, baseRevision: number);
+    addOperations(...operations: Operation[]): void;
+    getOperations(): InsertableOperation[];
+}
+//# sourceMappingURL=txn.d.ts.map

package/dist/src/storage/txn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"txn.d.ts","sourceRoot":"","sources":["../../../src/storage/txn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EAAE,KAAK,SAAS,IAAI,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,qBAAa,iBAAkB,YAAW,UAAU;IAIhD,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,YAAY;IAPtB,OAAO,CAAC,UAAU,CAA6B;gBAGrC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM;IAK9B,aAAa,CAAC,GAAG,UAAU,EAAE,SAAS,EAAE,GAAG,IAAI;IAsB/C,aAAa,IAAI,mBAAmB,EAAE;CAGvC"}

package/dist/src/storage/txn.js

@@ -0,0 +1,43 @@
+import { v4 as uuidv4 } from "uuid";
+import {} from "./interfaces.js";
+export class AtomicTransaction {
+    documentId;
+    documentType;
+    scope;
+    branch;
+    baseRevision;
+    operations = [];
+    constructor(documentId, documentType, scope, branch, baseRevision) {
+        this.documentId = documentId;
+        this.documentType = documentType;
+        this.scope = scope;
+        this.branch = branch;
+        this.baseRevision = baseRevision;
+        //
+    }
+    addOperations(...operations) {
+        for (const op of operations) {
+            this.operations.push({
+                // WRONG
+                jobId: uuidv4(),
+                // WRONG
+                opId: op.id || uuidv4(),
+                prevOpId: "", // Will be set during apply
+                documentId: this.documentId,
+                documentType: this.documentType,
+                scope: this.scope,
+                branch: this.branch,
+                timestampUtcMs: new Date(op.timestampUtcMs),
+                index: op.index,
+                action: JSON.stringify(op.action),
+                skip: op.skip,
+                error: op.error || null,
+                hash: op.hash,
+            });
+        }
+    }
+    getOperations() {
+        return this.operations;
+    }
+}
+//# sourceMappingURL=txn.js.map

package/dist/src/storage/txn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"txn.js","sourceRoot":"","sources":["../../../src/storage/txn.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,EAAgC,MAAM,iBAAiB,CAAC;AAG/D,MAAM,OAAO,iBAAiB;IAIlB;IACA;IACA;IACA;IACA;IAPF,UAAU,GAA0B,EAAE,CAAC;IAE/C,YACU,UAAkB,EAClB,YAAoB,EACpB,KAAa,EACb,MAAc,EACd,YAAoB;QAJpB,eAAU,GAAV,UAAU,CAAQ;QAClB,iBAAY,GAAZ,YAAY,CAAQ;QACpB,UAAK,GAAL,KAAK,CAAQ;QACb,WAAM,GAAN,MAAM,CAAQ;QACd,iBAAY,GAAZ,YAAY,CAAQ;QAE5B,EAAE;IACJ,CAAC;IAED,aAAa,CAAC,GAAG,UAAuB;QACtC,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;YAC5B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;gBACnB,QAAQ;gBACR,KAAK,EAAE,MAAM,EAAE;gBACf,QAAQ;gBACR,IAAI,EAAE,EAAE,CAAC,EAAE,IAAI,MAAM,EAAE;gBACvB,QAAQ,EAAE,EAAE,EAAE,2BAA2B;gBACzC,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,cAAc,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,cAAc,CAAC;gBAC3C,KAAK,EAAE,EAAE,CAAC,KAAK;gBACf,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,CAAC;gBACjC,IAAI,EAAE,EAAE,CAAC,IAAI;gBACb,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,IAAI;gBACvB,IAAI,EAAE,EAAE,CAAC,IAAI;aACd,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;CACF"}

package/dist/src/subs/default-error-handler.d.ts

@@ -0,0 +1,13 @@
+import type { ISubscriptionErrorHandler, SubscriptionErrorContext } from "./types.js";
+/**
+ * Default error handler that re-throws subscription errors.
+ * This ensures that errors are not silently swallowed.
+ */
+export declare class DefaultSubscriptionErrorHandler implements ISubscriptionErrorHandler {
+    handleError(error: unknown, context: SubscriptionErrorContext): void;
+}
+/**
+ * Creates a default subscription error handler instance
+ */
+export declare function createDefaultSubscriptionErrorHandler(): ISubscriptionErrorHandler;
+//# sourceMappingURL=default-error-handler.d.ts.map

package/dist/src/subs/default-error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-error-handler.d.ts","sourceRoot":"","sources":["../../../src/subs/default-error-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,wBAAwB,EACzB,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,qBAAa,+BACX,YAAW,yBAAyB;IAEpC,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,wBAAwB,GAAG,IAAI;CAcrE;AAED;;GAEG;AACH,wBAAgB,qCAAqC,IAAI,yBAAyB,CAEjF"}

package/dist/src/subs/default-error-handler.js

@@ -0,0 +1,27 @@
+/**
+ * Default error handler that re-throws subscription errors.
+ * This ensures that errors are not silently swallowed.
+ */
+export class DefaultSubscriptionErrorHandler {
+    handleError(error, context) {
+        const errorMessage = `Subscription error in ${context.eventType} (${context.subscriptionId})`;
+        if (error instanceof Error) {
+            // Preserve the original error with additional context
+            const enhancedError = new Error(`${errorMessage}: ${error.message}`);
+            enhancedError.cause = error;
+            enhancedError.stack = error.stack;
+            throw enhancedError;
+        }
+        else {
+            // Handle non-Error objects
+            throw new Error(`${errorMessage}: ${String(error)}`);
+        }
+    }
+}
+/**
+ * Creates a default subscription error handler instance
+ */
+export function createDefaultSubscriptionErrorHandler() {
+    return new DefaultSubscriptionErrorHandler();
+}
+//# sourceMappingURL=default-error-handler.js.map

package/dist/src/subs/default-error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-error-handler.js","sourceRoot":"","sources":["../../../src/subs/default-error-handler.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,OAAO,+BAA+B;IAG1C,WAAW,CAAC,KAAc,EAAE,OAAiC;QAC3D,MAAM,YAAY,GAAG,yBAAyB,OAAO,CAAC,SAAS,KAAK,OAAO,CAAC,cAAc,GAAG,CAAC;QAE9F,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,sDAAsD;YACtD,MAAM,aAAa,GAAG,IAAI,KAAK,CAAC,GAAG,YAAY,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACrE,aAAa,CAAC,KAAK,GAAG,KAAK,CAAC;YAC5B,aAAa,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;YAClC,MAAM,aAAa,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,2BAA2B;YAC3B,MAAM,IAAI,KAAK,CAAC,GAAG,YAAY,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,qCAAqC;IACnD,OAAO,IAAI,+BAA+B,EAAE,CAAC;AAC/C,CAAC"}

package/dist/src/subs/react-subscription-manager.d.ts

@@ -0,0 +1,45 @@
+import type { PHDocument } from "document-model";
+import type { PagedResults, RelationshipChangeType, SearchFilter, ViewFilter } from "../shared/types.js";
+import type { IReactorSubscriptionManager, ISubscriptionErrorHandler } from "./types.js";
+type DocumentCreatedCallback = (result: PagedResults<string>) => void;
+type DocumentDeletedCallback = (documentIds: string[]) => void;
+type DocumentStateUpdatedCallback = (result: PagedResults<PHDocument>) => void;
+type RelationshipChangedCallback = (parentId: string, childId: string, changeType: RelationshipChangeType) => void;
+export declare class ReactorSubscriptionManager implements IReactorSubscriptionManager {
+    private createdSubscriptions;
+    private deletedSubscriptions;
+    private updatedSubscriptions;
+    private relationshipSubscriptions;
+    private subscriptionCounter;
+    private errorHandler;
+    constructor(errorHandler: ISubscriptionErrorHandler);
+    onDocumentCreated(callback: DocumentCreatedCallback, search?: SearchFilter): () => void;
+    onDocumentDeleted(callback: DocumentDeletedCallback, search?: SearchFilter): () => void;
+    onDocumentStateUpdated(callback: DocumentStateUpdatedCallback, search?: SearchFilter, view?: ViewFilter): () => void;
+    onRelationshipChanged(callback: RelationshipChangedCallback, search?: SearchFilter): () => void;
+    /**
+     * Notify subscribers about created documents
+     */
+    notifyDocumentsCreated(documentIds: string[], documentTypes?: Map<string, string>, parentIds?: Map<string, string | null>): void;
+    /**
+     * Notify subscribers about deleted documents
+     */
+    notifyDocumentsDeleted(documentIds: string[], documentTypes?: Map<string, string>, parentIds?: Map<string, string | null>): void;
+    /**
+     * Notify subscribers about updated documents
+     */
+    notifyDocumentsUpdated(documents: PHDocument[]): void;
+    /**
+     * Notify subscribers about relationship changes
+     */
+    notifyRelationshipChanged(parentId: string, childId: string, changeType: RelationshipChangeType, childType?: string): void;
+    /**
+     * Clear all subscriptions
+     */
+    clearAll(): void;
+    private filterDocumentIds;
+    private filterDocuments;
+    private matchesRelationshipFilter;
+}
+export {};
+//# sourceMappingURL=react-subscription-manager.d.ts.map

package/dist/src/subs/react-subscription-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-subscription-manager.d.ts","sourceRoot":"","sources":["../../../src/subs/react-subscription-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EACV,YAAY,EACZ,sBAAsB,EACtB,YAAY,EACZ,UAAU,EACX,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EACV,2BAA2B,EAC3B,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAEpB,KAAK,uBAAuB,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;AACtE,KAAK,uBAAuB,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;AAC/D,KAAK,4BAA4B,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;AAC/E,KAAK,2BAA2B,GAAG,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,sBAAsB,KAC/B,IAAI,CAAC;AASV,qBAAa,0BAA2B,YAAW,2BAA2B;IAC5E,OAAO,CAAC,oBAAoB,CAGxB;IACJ,OAAO,CAAC,oBAAoB,CAGxB;IACJ,OAAO,CAAC,oBAAoB,CAGxB;IACJ,OAAO,CAAC,yBAAyB,CAG7B;IAEJ,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,YAAY,CAA4B;gBAEpC,YAAY,EAAE,yBAAyB;IAInD,iBAAiB,CACf,QAAQ,EAAE,uBAAuB,EACjC,MAAM,CAAC,EAAE,YAAY,GACpB,MAAM,IAAI;IASb,iBAAiB,CACf,QAAQ,EAAE,uBAAuB,EACjC,MAAM,CAAC,EAAE,YAAY,GACpB,MAAM,IAAI;IASb,sBAAsB,CACpB,QAAQ,EAAE,4BAA4B,EACtC,MAAM,CAAC,EAAE,YAAY,EACrB,IAAI,CAAC,EAAE,UAAU,GAChB,MAAM,IAAI;IASb,qBAAqB,CACnB,QAAQ,EAAE,2BAA2B,EACrC,MAAM,CAAC,EAAE,YAAY,GACpB,MAAM,IAAI;IASb;;OAEG;IACH,sBAAsB,CACpB,WAAW,EAAE,MAAM,EAAE,EACrB,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,GACrC,IAAI;IA+BP;;OAEG;IACH,sBAAsB,CACpB,WAAW,EAAE,MAAM,EAAE,EACrB,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,GACrC,IAAI;IAuBP;;OAEG;IACH,sBAAsB,CAAC,SAAS,EAAE,UAAU,EAAE,GAAG,IAAI;IA0BrD;;OAEG;IACH,yBAAyB,CACvB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,sBAAsB,EAClC,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI;IAuBP;;OAEG;IACH,QAAQ,IAAI,IAAI;IAOhB,OAAO,CAAC,iBAAiB;IAyBzB,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,yBAAyB;CAclC"}

package/dist/src/subs/react-subscription-manager.js

@@ -0,0 +1,185 @@
+export class ReactorSubscriptionManager {
+    createdSubscriptions = new Map();
+    deletedSubscriptions = new Map();
+    updatedSubscriptions = new Map();
+    relationshipSubscriptions = new Map();
+    subscriptionCounter = 0;
+    errorHandler;
+    constructor(errorHandler) {
+        this.errorHandler = errorHandler;
+    }
+    onDocumentCreated(callback, search) {
+        const id = `created-${++this.subscriptionCounter}`;
+        this.createdSubscriptions.set(id, { id, callback, search });
+        return () => {
+            this.createdSubscriptions.delete(id);
+        };
+    }
+    onDocumentDeleted(callback, search) {
+        const id = `deleted-${++this.subscriptionCounter}`;
+        this.deletedSubscriptions.set(id, { id, callback, search });
+        return () => {
+            this.deletedSubscriptions.delete(id);
+        };
+    }
+    onDocumentStateUpdated(callback, search, view) {
+        const id = `updated-${++this.subscriptionCounter}`;
+        this.updatedSubscriptions.set(id, { id, callback, search, view });
+        return () => {
+            this.updatedSubscriptions.delete(id);
+        };
+    }
+    onRelationshipChanged(callback, search) {
+        const id = `relationship-${++this.subscriptionCounter}`;
+        this.relationshipSubscriptions.set(id, { id, callback, search });
+        return () => {
+            this.relationshipSubscriptions.delete(id);
+        };
+    }
+    /**
+     * Notify subscribers about created documents
+     */
+    notifyDocumentsCreated(documentIds, documentTypes, parentIds) {
+        const result = {
+            results: documentIds,
+            options: { cursor: "", limit: documentIds.length },
+        };
+        for (const subscription of this.createdSubscriptions.values()) {
+            const filteredIds = this.filterDocumentIds(documentIds, subscription.search, documentTypes, parentIds);
+            if (filteredIds.length > 0) {
+                try {
+                    subscription.callback({
+                        ...result,
+                        results: filteredIds,
+                    });
+                }
+                catch (error) {
+                    this.errorHandler.handleError(error, {
+                        eventType: "created",
+                        subscriptionId: subscription.id,
+                        eventData: filteredIds,
+                    });
+                }
+            }
+        }
+    }
+    /**
+     * Notify subscribers about deleted documents
+     */
+    notifyDocumentsDeleted(documentIds, documentTypes, parentIds) {
+        for (const subscription of this.deletedSubscriptions.values()) {
+            const filteredIds = this.filterDocumentIds(documentIds, subscription.search, documentTypes, parentIds);
+            if (filteredIds.length > 0) {
+                try {
+                    subscription.callback(filteredIds);
+                }
+                catch (error) {
+                    this.errorHandler.handleError(error, {
+                        eventType: "deleted",
+                        subscriptionId: subscription.id,
+                        eventData: filteredIds,
+                    });
+                }
+            }
+        }
+    }
+    /**
+     * Notify subscribers about updated documents
+     */
+    notifyDocumentsUpdated(documents) {
+        const result = {
+            results: documents,
+            options: { cursor: "", limit: documents.length },
+        };
+        for (const subscription of this.updatedSubscriptions.values()) {
+            const filteredDocs = this.filterDocuments(documents, subscription.search);
+            if (filteredDocs.length > 0) {
+                try {
+                    subscription.callback({
+                        ...result,
+                        results: filteredDocs,
+                    });
+                }
+                catch (error) {
+                    this.errorHandler.handleError(error, {
+                        eventType: "updated",
+                        subscriptionId: subscription.id,
+                        eventData: filteredDocs,
+                    });
+                }
+            }
+        }
+    }
+    /**
+     * Notify subscribers about relationship changes
+     */
+    notifyRelationshipChanged(parentId, childId, changeType, childType) {
+        for (const subscription of this.relationshipSubscriptions.values()) {
+            if (this.matchesRelationshipFilter(parentId, childId, childType, subscription.search)) {
+                try {
+                    subscription.callback(parentId, childId, changeType);
+                }
+                catch (error) {
+                    this.errorHandler.handleError(error, {
+                        eventType: "relationshipChanged",
+                        subscriptionId: subscription.id,
+                        eventData: { parentId, childId, changeType },
+                    });
+                }
+            }
+        }
+    }
+    /**
+     * Clear all subscriptions
+     */
+    clearAll() {
+        this.createdSubscriptions.clear();
+        this.deletedSubscriptions.clear();
+        this.updatedSubscriptions.clear();
+        this.relationshipSubscriptions.clear();
+    }
+    filterDocumentIds(documentIds, search, documentTypes, parentIds) {
+        if (!search)
+            return documentIds;
+        return documentIds.filter((id) => {
+            if (search.ids && !search.ids.includes(id))
+                return false;
+            if (search.type && documentTypes) {
+                const docType = documentTypes.get(id);
+                if (docType !== search.type)
+                    return false;
+            }
+            if (search.parentId && parentIds) {
+                const parentId = parentIds.get(id);
+                if (parentId !== search.parentId)
+                    return false;
+            }
+            return true;
+        });
+    }
+    filterDocuments(documents, search) {
+        if (!search)
+            return documents;
+        return documents.filter((doc) => {
+            if (search.ids && !search.ids.includes(doc.header.id))
+                return false;
+            if (search.type && doc.header.documentType !== search.type)
+                return false;
+            if (search.slugs && !search.slugs.includes(doc.header.slug))
+                return false;
+            return true;
+        });
+    }
+    matchesRelationshipFilter(parentId, childId, childType, search) {
+        if (!search)
+            return true;
+        if (search.parentId && parentId !== search.parentId)
+            return false;
+        if (search.ids && !search.ids.includes(childId))
+            return false;
+        if (search.type && childType && childType !== search.type)
+            return false;
+        return true;
+    }
+}
+//# sourceMappingURL=react-subscription-manager.js.map

package/dist/src/subs/react-subscription-manager.js.map

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

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

@@ -0,0 +1,64 @@
+import type { PHDocument } from "document-model";
+import type { PagedResults, RelationshipChangeType, SearchFilter, ViewFilter } from "../shared/types.js";
+/**
+ * Error handler for subscription callback errors
+ */
+export interface ISubscriptionErrorHandler {
+    /**
+     * Called when a subscription callback throws an error
+     * @param error - The error that was thrown
+     * @param context - Context about which subscription failed
+     */
+    handleError(error: unknown, context: SubscriptionErrorContext): void;
+}
+/**
+ * Context information about a subscription error
+ */
+export interface SubscriptionErrorContext {
+    /** The type of event that was being processed */
+    eventType: "created" | "deleted" | "updated" | "relationshipChanged";
+    /** The subscription ID that failed */
+    subscriptionId: string;
+    /** Optional additional data about the event */
+    eventData?: unknown;
+}
+/**
+ * Interface for subscribing to document events in the reactor.
+ */
+export interface IReactorSubscriptionManager {
+    /**
+     * Subscribes to document creation events
+     *
+     * @param callback - Function called when documents are created
+     * @param search - Optional search filter to limit which documents trigger events
+     * @param view - Optional filter containing branch and scopes information
+     * @returns A function that unsubscribes from the events
+     */
+    onDocumentCreated(callback: (result: PagedResults<string>) => void, search?: SearchFilter): () => void;
+    /**
+     * Subscribes to document deletion events
+     *
+     * @param callback - Function called when documents are deleted
+     * @param search - Optional search filter to limit which documents trigger events
+     * @returns A function that unsubscribes from the events
+     */
+    onDocumentDeleted(callback: (documentIds: string[]) => void, search?: SearchFilter): () => void;
+    /**
+     * Subscribes to document state updates
+     *
+     * @param callback - Function called when documents are updated
+     * @param search - Optional search filter to limit which documents trigger events
+     * @param view - Optional filter containing branch and scopes information
+     * @returns A function that unsubscribes from the events
+     */
+    onDocumentStateUpdated(callback: (result: PagedResults<PHDocument>) => void, search?: SearchFilter, view?: ViewFilter): () => void;
+    /**
+     * Subscribes to parent-child relationship change events
+     *
+     * @param callback - Function called when parent-child relationships change
+     * @param search - Optional search filter to limit which documents trigger events
+     * @returns A function that unsubscribes from the events
+     */
+    onRelationshipChanged(callback: (parentId: string, childId: string, changeType: RelationshipChangeType) => void, search?: SearchFilter): () => void;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/subs/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EACV,YAAY,EACZ,sBAAsB,EACtB,YAAY,EACZ,UAAU,EACX,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAAC;CACtE;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,iDAAiD;IACjD,SAAS,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,qBAAqB,CAAC;IACrE,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;;;;;OAOG;IACH,iBAAiB,CACf,QAAQ,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,KAAK,IAAI,EAChD,MAAM,CAAC,EAAE,YAAY,GACpB,MAAM,IAAI,CAAC;IAEd;;;;;;OAMG;IACH,iBAAiB,CACf,QAAQ,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,IAAI,EACzC,MAAM,CAAC,EAAE,YAAY,GACpB,MAAM,IAAI,CAAC;IAEd;;;;;;;OAOG;IACH,sBAAsB,CACpB,QAAQ,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC,UAAU,CAAC,KAAK,IAAI,EACpD,MAAM,CAAC,EAAE,YAAY,EACrB,IAAI,CAAC,EAAE,UAAU,GAChB,MAAM,IAAI,CAAC;IAEd;;;;;;OAMG;IACH,qBAAqB,CACnB,QAAQ,EAAE,CACR,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,sBAAsB,KAC/B,IAAI,EACT,MAAM,CAAC,EAAE,YAAY,GACpB,MAAM,IAAI,CAAC;CACf"}

package/dist/src/subs/types.js

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

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

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