document-drive 1.19.1 → 1.20.0

package/dist/src/server/builder.d.ts

@@ -0,0 +1,30 @@
+import { ICache } from "#cache/types";
+import { IQueueManager } from "#queue/types";
+import { IDriveStorage } from "#storage/types";
+import { DocumentModelModule } from "document-model";
+import { DocumentDriveServerOptions, IEventEmitter, IListenerManager, ISynchronizationManager, ITransmitterFactory } from "./types.js";
+/**
+ * Builder class for constructing Reactor instances with proper configuration
+ */
+export declare class ReactorBuilder {
+    private documentModelModules;
+    private storage?;
+    private cache?;
+    private queueManager?;
+    private eventEmitter?;
+    private options?;
+    private synchronizationManager?;
+    private listenerManager?;
+    private transmitterFactory?;
+    constructor(documentModelModules: DocumentModelModule[]);
+    withStorage(storage: IDriveStorage): this;
+    withCache(cache: ICache): this;
+    withQueueManager(queueManager: IQueueManager): this;
+    withEventEmitter(eventEmitter: IEventEmitter): this;
+    withSynchronizationManager(synchronizationManager: ISynchronizationManager): this;
+    withListenerManager(listenerManager: IListenerManager): this;
+    withTransmitterFactory(transmitterFactory: ITransmitterFactory): this;
+    withOptions(options: DocumentDriveServerOptions): this;
+    build(): import("./base-server.js").BaseDocumentDriveServer & import("../read-mode/types.js").IReadModeDriveServer;
+}
+//# sourceMappingURL=builder.d.ts.map

package/dist/src/server/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../src/server/builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAMrD,OAAO,EAEL,0BAA0B,EAC1B,aAAa,EACb,gBAAgB,EAChB,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,oBAAoB,CAA6B;IAEzD,OAAO,CAAC,OAAO,CAAC,CAAgB;IAChC,OAAO,CAAC,KAAK,CAAC,CAAS;IACvB,OAAO,CAAC,YAAY,CAAC,CAAgB;IACrC,OAAO,CAAC,YAAY,CAAC,CAAgB;IACrC,OAAO,CAAC,OAAO,CAAC,CAA6B;IAC7C,OAAO,CAAC,sBAAsB,CAAC,CAA0B;IACzD,OAAO,CAAC,eAAe,CAAC,CAAmB;IAC3C,OAAO,CAAC,kBAAkB,CAAC,CAAsB;gBAErC,oBAAoB,EAAE,mBAAmB,EAAE;IAIhD,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAKzC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK9B,gBAAgB,CAAC,YAAY,EAAE,aAAa,GAAG,IAAI;IAKnD,gBAAgB,CAAC,YAAY,EAAE,aAAa,GAAG,IAAI;IAKnD,0BAA0B,CAC/B,sBAAsB,EAAE,uBAAuB,GAC9C,IAAI;IAKA,mBAAmB,CAAC,eAAe,EAAE,gBAAgB,GAAG,IAAI;IAK5D,sBAAsB,CAAC,kBAAkB,EAAE,mBAAmB,GAAG,IAAI;IAKrE,WAAW,CAAC,OAAO,EAAE,0BAA0B,GAAG,IAAI;IAKtD,KAAK;CA0Db"}

package/dist/src/server/builder.js

@@ -0,0 +1,89 @@
+import InMemoryCache from "#cache/memory";
+import { BaseQueueManager } from "#queue/base";
+import { MemoryStorage } from "#storage/memory";
+import { DocumentDriveServer } from "./base-server.js";
+import { DefaultEventEmitter } from "./event-emitter.js";
+import { ListenerManager } from "./listener/listener-manager.js";
+import TransmitterFactory from "./listener/transmitter/factory.js";
+import SynchronizationManager from "./sync-manager.js";
+import { DefaultListenerManagerOptions, } from "./types.js";
+/**
+ * Builder class for constructing Reactor instances with proper configuration
+ */
+export class ReactorBuilder {
+    documentModelModules = [];
+    storage;
+    cache;
+    queueManager;
+    eventEmitter;
+    options;
+    synchronizationManager;
+    listenerManager;
+    transmitterFactory;
+    constructor(documentModelModules) {
+        this.documentModelModules = documentModelModules;
+    }
+    withStorage(storage) {
+        this.storage = storage;
+        return this;
+    }
+    withCache(cache) {
+        this.cache = cache;
+        return this;
+    }
+    withQueueManager(queueManager) {
+        this.queueManager = queueManager;
+        return this;
+    }
+    withEventEmitter(eventEmitter) {
+        this.eventEmitter = eventEmitter;
+        return this;
+    }
+    withSynchronizationManager(synchronizationManager) {
+        this.synchronizationManager = synchronizationManager;
+        return this;
+    }
+    withListenerManager(listenerManager) {
+        this.listenerManager = listenerManager;
+        return this;
+    }
+    withTransmitterFactory(transmitterFactory) {
+        this.transmitterFactory = transmitterFactory;
+        return this;
+    }
+    withOptions(options) {
+        this.options = options;
+        return this;
+    }
+    build() {
+        if (!this.documentModelModules.length) {
+            throw new Error("Document models are required to build the server");
+        }
+        if (!this.storage) {
+            this.storage = new MemoryStorage();
+        }
+        if (!this.cache) {
+            this.cache = new InMemoryCache();
+        }
+        if (!this.queueManager) {
+            this.queueManager = new BaseQueueManager();
+        }
+        if (!this.eventEmitter) {
+            this.eventEmitter = new DefaultEventEmitter();
+        }
+        if (!this.synchronizationManager) {
+            this.synchronizationManager = new SynchronizationManager(this.storage, this.cache, this.documentModelModules, this.eventEmitter);
+        }
+        if (!this.listenerManager) {
+            const config = {
+                ...DefaultListenerManagerOptions,
+                ...this.options?.listenerManager,
+            };
+            this.listenerManager = new ListenerManager(this.synchronizationManager, config);
+        }
+        if (!this.transmitterFactory) {
+            this.transmitterFactory = new TransmitterFactory(this.listenerManager);
+        }
+        return new DocumentDriveServer(this.documentModelModules, this.storage, this.cache, this.queueManager, this.eventEmitter, this.synchronizationManager, this.listenerManager, this.transmitterFactory, this.options);
+    }
+}

package/dist/src/server/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const PULL_DRIVE_INTERVAL = 5000;
+//# sourceMappingURL=constants.d.ts.map

package/dist/src/server/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/server/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,OAAO,CAAC"}

package/dist/src/server/constants.js

@@ -0,0 +1 @@
+export const PULL_DRIVE_INTERVAL = 5000;

package/dist/src/server/error.d.ts

@@ -0,0 +1,30 @@
+import type { Operation } from "document-model";
+import { ErrorStatus } from "./types.js";
+export declare class DocumentModelNotFoundError extends Error {
+    id: string;
+    constructor(id: string, cause?: unknown);
+}
+export declare class OperationError extends Error {
+    status: ErrorStatus;
+    operation: Operation | undefined;
+    constructor(status: ErrorStatus, operation?: Operation, message?: string, cause?: unknown);
+}
+export declare class ConflictOperationError extends OperationError {
+    constructor(existingOperation: Operation, newOperation: Operation);
+}
+export declare class MissingOperationError extends OperationError {
+    constructor(index: number, operation: Operation);
+}
+export declare class DriveAlreadyExistsError extends Error {
+    driveId: string;
+    constructor(driveId: string);
+}
+export declare class DriveNotFoundError extends Error {
+    driveId: string;
+    constructor(driveId: string);
+}
+export declare class SynchronizationUnitNotFoundError extends Error {
+    syncUnitId: string;
+    constructor(message: string, syncUnitId: string);
+}
+//# sourceMappingURL=error.d.ts.map

package/dist/src/server/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../src/server/error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,qBAAa,0BAA2B,SAAQ,KAAK;IAE1C,EAAE,EAAE,MAAM;gBAAV,EAAE,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,OAAO;CAIlB;AACD,qBAAa,cAAe,SAAQ,KAAK;IACvC,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,SAAS,GAAG,SAAS,CAAC;gBAG/B,MAAM,EAAE,WAAW,EACnB,SAAS,CAAC,EAAE,SAAS,EACrB,OAAO,CAAC,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,OAAO;CAMlB;AAED,qBAAa,sBAAuB,SAAQ,cAAc;gBAC5C,iBAAiB,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS;CAQlE;AAED,qBAAa,qBAAsB,SAAQ,cAAc;gBAC3C,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS;CAGhD;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,OAAO,EAAE,MAAM,CAAC;gBAEJ,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,OAAO,EAAE,MAAM,CAAC;gBAEJ,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,gCAAiC,SAAQ,KAAK;IACzD,UAAU,EAAE,MAAM,CAAC;gBAEP,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAIhD"}

package/dist/src/server/error.js

@@ -0,0 +1,47 @@
+export class DocumentModelNotFoundError extends Error {
+    id;
+    constructor(id, cause) {
+        super(`Document model "${id}" not found`, { cause });
+        this.id = id;
+    }
+}
+export class OperationError extends Error {
+    status;
+    operation;
+    constructor(status, operation, message, cause) {
+        super(message, { cause: cause ?? operation });
+        this.status = status;
+        this.operation = operation;
+    }
+}
+export class ConflictOperationError extends OperationError {
+    constructor(existingOperation, newOperation) {
+        super("CONFLICT", newOperation, `Conflicting operation on index ${newOperation.index}`, { existingOperation, newOperation });
+    }
+}
+export class MissingOperationError extends OperationError {
+    constructor(index, operation) {
+        super("MISSING", operation, `Missing operation on index ${index}`);
+    }
+}
+export class DriveAlreadyExistsError extends Error {
+    driveId;
+    constructor(driveId) {
+        super(`Drive already exists. ID: ${driveId}`);
+        this.driveId = driveId;
+    }
+}
+export class DriveNotFoundError extends Error {
+    driveId;
+    constructor(driveId) {
+        super(`Drive with id ${driveId} not found`);
+        this.driveId = driveId;
+    }
+}
+export class SynchronizationUnitNotFoundError extends Error {
+    syncUnitId;
+    constructor(message, syncUnitId) {
+        super(message);
+        this.syncUnitId = syncUnitId;
+    }
+}

package/dist/src/server/event-emitter.d.ts

@@ -0,0 +1,8 @@
+import { Unsubscribe } from "nanoevents";
+import { DriveEvents, IEventEmitter } from "./types.js";
+export declare class DefaultEventEmitter implements IEventEmitter {
+    private emitter;
+    emit<K extends keyof DriveEvents>(event: K, ...args: Parameters<DriveEvents[K]>): void;
+    on<K extends keyof DriveEvents>(event: K, cb: DriveEvents[K]): Unsubscribe;
+}
+//# sourceMappingURL=event-emitter.d.ts.map

package/dist/src/server/event-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-emitter.d.ts","sourceRoot":"","sources":["../../../src/server/event-emitter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,WAAW,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAExD,qBAAa,mBAAoB,YAAW,aAAa;IACvD,OAAO,CAAC,OAAO,CAAmC;IAElD,IAAI,CAAC,CAAC,SAAS,MAAM,WAAW,EAC9B,KAAK,EAAE,CAAC,EACR,GAAG,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAClC,IAAI;IAIP,EAAE,CAAC,CAAC,SAAS,MAAM,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW;CAG3E"}

package/dist/src/server/event-emitter.js

@@ -0,0 +1,10 @@
+import { createNanoEvents } from "nanoevents";
+export class DefaultEventEmitter {
+    emitter = createNanoEvents();
+    emit(event, ...args) {
+        return this.emitter.emit(event, ...args);
+    }
+    on(event, cb) {
+        return this.emitter.on(event, cb);
+    }
+}

package/dist/src/server/listener/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./listener-manager.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/server/listener/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/listener/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC"}

package/dist/src/server/listener/index.js

@@ -0,0 +1 @@
+export * from "./listener-manager.js";

package/dist/src/server/listener/listener-manager.d.ts

@@ -0,0 +1,27 @@
+import { StrandUpdateSource } from "#server/listener/transmitter/types";
+import { DriveUpdateErrorHandler, GetStrandsOptions, IListenerManager, ISynchronizationManager, Listener, ListenerManagerOptions, ListenerState, ListenerUpdate, StrandUpdate, SynchronizationUnit, SynchronizationUnitQuery } from "#server/types";
+export declare class ListenerManager implements IListenerManager {
+    static LISTENER_UPDATE_DELAY: number;
+    protected logger: import("../../utils/logger.js").ConsoleLogger;
+    protected syncManager: ISynchronizationManager;
+    protected options: ListenerManagerOptions;
+    protected listenerStateByDriveId: Map<string, Map<string, ListenerState>>;
+    constructor(syncManager: ISynchronizationManager, options?: ListenerManagerOptions);
+    initialize(handler: DriveUpdateErrorHandler): Promise<void>;
+    driveHasListeners(driveId: string): boolean;
+    setListener(driveId: string, listener: Listener): Promise<void>;
+    removeListener(driveId: string, listenerId: string): Promise<boolean>;
+    removeSyncUnits(driveId: string, syncUnits: Pick<SynchronizationUnit, "syncId">[]): Promise<void>;
+    updateSynchronizationRevisions(driveId: string, syncUnits: SynchronizationUnit[], source: StrandUpdateSource, willUpdate?: (listeners: Listener[]) => void, onError?: (error: Error, driveId: string, listener: ListenerState) => void, forceSync?: boolean): Promise<ListenerUpdate[]>;
+    updateListenerRevision(listenerId: string, driveId: string, syncId: string, listenerRev: number): Promise<void>;
+    triggerUpdate: (immediate: boolean, source: StrandUpdateSource, onError?: ((error: Error, driveId: string, listener: ListenerState) => void) | undefined, maxContinues?: number | undefined) => Promise<ListenerUpdate[]>;
+    private _triggerUpdate;
+    private _checkFilter;
+    getListenerSyncUnits(driveId: string, listenerId: string): never[] | Promise<SynchronizationUnit[]>;
+    getListenerSyncUnitIds(driveId: string, listenerId: string): Promise<SynchronizationUnitQuery[]>;
+    removeDrive(driveId: string): Promise<void>;
+    getStrands(driveId: string, listenerId: string, options?: GetStrandsOptions): Promise<StrandUpdate[]>;
+    getListenerState(driveId: string, listenerId: string): ListenerState;
+    setListenerState(driveId: string, listenerId: string, listenerState: ListenerState): void;
+}
+//# sourceMappingURL=listener-manager.d.ts.map

package/dist/src/server/listener/listener-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listener-manager.d.ts","sourceRoot":"","sources":["../../../../src/server/listener/listener-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAEL,uBAAuB,EAEvB,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,QAAQ,EACR,sBAAsB,EACtB,aAAa,EACb,cAAc,EAEd,YAAY,EACZ,mBAAmB,EACnB,wBAAwB,EACzB,MAAM,eAAe,CAAC;AAQvB,qBAAa,eAAgB,YAAW,gBAAgB;IACtD,MAAM,CAAC,qBAAqB,SAAO;IAEnC,SAAS,CAAC,MAAM,gDAGb;IAEH,SAAS,CAAC,WAAW,EAAE,uBAAuB,CAAC;IAC/C,SAAS,CAAC,OAAO,EAAE,sBAAsB,CAAC;IAG1C,SAAS,CAAC,sBAAsB,0CAG5B;gBAGF,WAAW,EAAE,uBAAuB,EACpC,OAAO,GAAE,sBAAsD;IAQ3D,UAAU,CAAC,OAAO,EAAE,uBAAuB;IAcjD,iBAAiB,CAAC,OAAO,EAAE,MAAM;IAI3B,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ;IA+B/C,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAWlD,eAAe,CACnB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,IAAI,CAAC,mBAAmB,EAAE,QAAQ,CAAC,EAAE,GAC/C,OAAO,CAAC,IAAI,CAAC;IAaV,8BAA8B,CAClC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,mBAAmB,EAAE,EAChC,MAAM,EAAE,kBAAkB,EAC1B,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,IAAI,EAC5C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,KAAK,IAAI,EAC1E,SAAS,UAAQ;IA2Cb,sBAAsB,CAC1B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IAuBhB,aAAa,sEAOO,KAAK,WAAW,MAAM,YAAY,aAAa,KAAK,IAAI,+EAJ1E;YAEY,cAAc;IA8N5B,OAAO,CAAC,YAAY;IAsBpB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAexD,sBAAsB,CACpB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,wBAAwB,EAAE,CAAC;IAehC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB3C,UAAU,CACd,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,YAAY,EAAE,CAAC;IAoE1B,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAepD,gBAAgB,CACd,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,aAAa;CAU/B"}