@grapecity-software/js-collaboration-ot 18.0.7 → 18.1.0

package/dist/index.d.ts

@@ -1,243 +1,345 @@
-import { IMiddleware, IHook, Connection, IFeature } from "@grapecity-software/js-collaboration";
+import { IFeature, Connection, IMiddleware, IHook } from "@grapecity-software/js-collaboration";
 
-/**
- * The interface of ot type, user can customize the ot behavior of the collaboration.
- * @template S The type of snapshot data.
- * @template T The type of op data.
- */
-export interface OT_Type<S = unknown, T = unknown> {
-    /**
-     * The type uri of the document.
-     */
-    uri: string;
-    /**
-     * Create a snapshot data from op data.
-     * @param data - snapshot data
-     * @returns snapshot data
-     */
-    create?(data: S): S;
-    /**
-     * Create snapshot fragments from op data.
-     * @param data - snapshot data
-     * @returns snapshot fragments
-     */
-    createFragments?(data: S): ISnapshotFragments;
-    /**
-     * Create snapshot data from snapshot fragments.
-     * @param fragments - snapshot fragments
-     * @returns snapshot data
-     */
-    composeFragments?(fragments: ISnapshotFragments): S;
+export interface IOp<T = unknown> {
+    v: number;
+    create?: ICreateComponent;
+    op?: T;
+    del?: boolean;
+}
+
+export interface ICreateComponent {
+    type: string;
+    data: unknown;
+}
+
+export interface ISnapshot<S = unknown> {
+    id: string;
+    v: number;
+    type?: string;
+    data?: S;
     /**
-     * Transform op1, to handling conflicts.
-     * @param op1 The op to be transformed.
-     * @param op2 The basis of the operation being transformed (op1 is transformed based on op2).
-     * @param side Indicates which parameter's corresponding op arrives at the server later.
-     * @returns The transformed op1.
+     * only server side has this field
      */
-    transform(op1: T, op2: T, side: 'left' | 'right'): T;
+    fragments?: ISnapshotFragments;
+}
+
+export type ISnapshotFragments<S = unknown> = { [key: string]: S };
+
+export interface ISnapshotFragmentsChanges<S = unknown> {
+    createFragments?: { [key: string]: S };
+    updateFragments?: { [key: string]: S };
+    deleteFragments?: string[];
+    deleteSnapshot?: boolean;
+}
+
+export interface ISnapshotFragmentsRequest<S = unknown> {
+    getFragment(id: string): Promise<S | undefined>;
+    createFragment(id: string, data: S): void;
+    updateFragment(id: string, data: S): void;
+    deleteFragment(id: string): void;
+}
+
+export interface ISnapshotMeta {
+    mtime?: number;
+    ctime?: number;
+}
+
+export interface IRequestMessage<T> {
     /**
-     * Apply op to snapshot data.
-     * @param snapshot - snapshot data
-     * @param op - op data
-     * @returns snapshot data
+     * message action
      */
-    apply?(snapshot: S, op: T): S;
+    a: MessageActions;
     /**
-     * Apply op to snapshot fragments.
-     * @param request - snapshot fragments request
-     * @param op - op data
-     * @returns snapshot data
+     * version
      */
-    applyFragments?(request: ISnapshotFragmentsRequest, op: T): S;
+    v?: number;
+    create?: ICreateComponent;
+    op?: T;
+    del?: boolean;
+    error?: IErrorData;
+}
+
+export interface IRequestMessageExtra {
+    source?: unknown;
+}
+
+export interface IErrorData {
+    code: number;
+    message: string;
+}
+
+export interface IReplyMessage<S, T> {
+    a: MessageActions;
+    v?: number;
+    create?: ICreateComponent;
+    op?: T;
+    del?: boolean;
+    error?: IErrorData;
+    data?: ISnapshot<S>;
 }
 
 /**
- * The types manager for collaboration, provide a way to register ot type and get types through type uri.
+ * Message actions.
  */
-export class TypesManager {
-    /**
-     * Register ot type.
-     * @param {OT_Type} type The type object which is user-defined.
-     */
-    static register<S, T> (type: OT_Type<S, T>): void;
-    /**
-     * Get ot type through the type uri.
-     * @param {string} typeUri The type uri.
-     * @return {OT_Type} The type object of specified type uri.
-     */
-    static getType<S, T> (typeUri: string): OT_Type<S, T>;
+export enum MessageActions {
+    fetch,
+    fetchOps,
+    fetchHistorySnapshot,
+    subscribe,
+    unsubscribe,
+    op,
 }
 
 /**
- * The feature of ot document.
- * @param service - service to be used by document services
- * @returns The ot document feature.
+ * Creates a feature for operational transformation (OT) documents.
+ * @param {DocumentServices<S, T>} [service] - The document service to be used by the feature.
+ * @returns {IFeature} The OT document feature.
  * @example
  * const server = new Server({ httpServer });
  * server.useFeature(documentFeature());
  */
 export declare function documentFeature<S = unknown, T = unknown>(service?: DocumentServices<S, T>): IFeature;
-
 /**
- * The document services for collaboration.
- * @template S The type of snapshot data.
- * @template T The type of op data.
+ * Provides document services for collaborative operational transformation.
+ * @template S - The type of snapshot data.
+ * @template T - The type of operation data.
  */
 export declare class DocumentServices<S, T> {
+    constructor(config?: IDocConfig<S, T>);
+
     /**
-     * The database adapter.
-     * @template S The type of snapshot data.
-     * @template T The type of op data.
+     * The database adapter for storing document data.
+     * @template S - The type of snapshot data.
+     * @template T - The type of operation data.
      */
-    db: IDataBaseAdapter<S, T>;
+    db: IDatabaseAdapter<S, T>;
     /**
-     * The milestone database adapter.
-     * @template S The type of snapshot data.
+     * The milestone database adapter for snapshot milestones.
+     * @template S - The type of snapshot data.
      */
-    milestoneDb: IMilestoneDataBaseAdapter<S>;
+    milestoneDb: IMilestoneDatabaseAdapter<S>;
     /**
-     * The maximum number of retries when submitting an operation.
-     * @default undefined - no limitation
+     * The maximum number of retries for submitting an operation.
+     * @default undefined - No retry limit.
      */
     maxSubmitRetries?: number;
     /**
-     * The batch size of snapshot when submit snapshot.
+     * The batch size for submitting snapshots.
      * @default 100
      */
     submitSnapshotBatchSize: number;
-
-    constructor(config?: IDocConfig<S, T>);
-
     /**
-     * Register middleware to document services
-     * @param action - action name
-     * @param middleware - the middleware to register
+     * Registers a middleware for a specific action in the document services.
+     * @template K - The type of the action name, extending keyof IDocMiddlewareContext<S, T>.
+     * @param {K} action - The name of the action to associate with the middleware.
+     * @param {IMiddleware<IDocMiddlewareContext<S, T>[K]>} middleware - The middleware to register.
      */
     use<K extends keyof IDocMiddlewareContext<S, T>>(action: K, middleware: IMiddleware<IDocMiddlewareContext<S, T>[K]>): void;
     /**
-     * Register hook to document services
-     * @param hookName - hook name
-     * @param hook - the hook to register
+     * Registers a hook for a specific event in the document services.
+     * @template K - The type of the hook name, extending keyof IDocHookContext.
+     * @param {K} hookName - The name of the hook to register.
+     * @param {IHook<IDocHookContext[K]>} hook - The hook to register.
      */
     on<K extends keyof IDocHookContext>(hookName: K, hook: IHook<IDocHookContext[K]>): void;
 
     /**
-     * Fetch latest snapshot
-     * @param id - document id
+     * Fetches the latest snapshot of a document.
+     * @param {string} id - The ID of the document.
+     * @param {IContext} [context] - The context for the operation (optional).
+     * @returns {Promise<ISnapshot<S>>} A promise resolving to the document snapshot.
      */
     fetch(id: string, context?: IContext): Promise<ISnapshot<S>>;
     /**
-     * Get operations between two versions, include from version, but not include to version
-     * @param id - document id
-     * @param from - from version
-     * @param to - to version
+     * Retrieves operations between two versions (inclusive of 'from', exclusive of 'to').
+     * @param {string} id - The ID of the document.
+     * @param {number} from - The starting version.
+     * @param {number} [to] - The ending version (optional).
+     * @param {IContext} [context] - The context for the operation (optional).
+     * @returns {Promise<IOp<T>[]>} A promise resolving to an array of operations.
      */
     getOps(id: string, from: number, to?: number, context?: IContext): Promise<IOp<T>[]>;
     /**
-     * Submit operation.
-     * @param id - document id
-     * @param op - operation
-     * @param context - context
-     * @param afterCommitCallback - callback after commit op to database
+     * Submits an operation to the document (must include an {op:}, {create:}, or {del:} field).
+     * @param {string} id - The ID of the document.
+     * @param {IOp<T>} op - The operation to submit.
+     * @param {IContext} [context] - The context for the operation (optional).
+     * @returns {Promise<IOp<T>[]>} A promise resolving to the resulting operations.
      */
-    submit(id: string, op: IOp<T>, context?: IContext, afterCommitCallback?: IAfterCommitCallback<S, T>): Promise<IOp<T>[]>;
+    submit(id: string, op: IOp<T>, context?: IContext): Promise<IOp<T>[]>;
     /**
-     * Fetch history snapshot by version
-     * @param id - document id
+     * Fetches a historical snapshot of a document by version.
+     * @param {string} id - The ID of the document.
+     * @param {number} [version] - The version of the snapshot (optional).
+     * @param {IContext} [context] - The context for the operation (optional).
+     * @returns {Promise<ISnapshot<S>>} A promise resolving to the historical snapshot.
      */
     fetchHistorySnapshot(id: string, version?: number, context?: IContext): Promise<ISnapshot<S>>;
 }
 
 export interface IDocConfig<S, T> {
-    db?: IDataBaseAdapter<S, T>,
-    milestoneDb?: IMilestoneDataBaseAdapter<S>,
+    db?: IDatabaseAdapter<S, T>;
+    milestoneDb?: IMilestoneDatabaseAdapter<S>;
     maxSubmitRetries?: number;
     submitSnapshotBatchSize?: number;
 }
 
+export interface ICustomOptions {
+    [key: string]: unknown;
+}
+
+export interface IContext {
+    connection?: Connection;
+    options?: ICustomOptions;
+}
+export type SnapshotTypes = 'current' | 'byVersion';
+
+export interface IDocHookContext {
+    submitRequestEnd: unknown;
+    timing: unknown;
+}
+
 /**
- * The context of doc middleware.
+ * Defines the context for document middleware operations.
  */
 export interface IDocMiddlewareContext<S, T> {
     /**
-     * The doc received a message from a client.
+     * Context for when the document receives a message from a client.
      */
     receive: IDocReceiveMiddlewareContext<T>;
-
     /**
-     * Start submitting an operation.
+     * Context for initiating the submission of an operation.
      */
     submit: IDocSubmitMiddlewareContext<S, T>;
     /**
-     * An operation prepare commit to the database.
+     * Context for preparing an operation to be committed to the database.
      */
     commit: IDocSubmitMiddlewareContext<S, T>;
     /**
-     * An operation were successfully written to the database.
+     * Context for after an operation has been successfully written to the database.
      */
     afterWrite: IDocSubmitMiddlewareContext<S, T>;
-
     /**
-     * Start submitting snapshot.
+     * Context for initiating the submission of a snapshot.
      */
     submitSnapshot: IDocSubmitSnapshotMiddlewareContext<S, T>;
     /**
-     * The operation is to be applied to the snapshot.
+     * Context for applying an operation to the snapshot.
      */
     apply: IDocSubmitSnapshotMiddlewareContext<S, T>;
     /**
-     * An snapshot prepare commit to the database.
+     * Context for preparing a snapshot to be committed to the database.
      */
     commitSnapshot: IDocSubmitSnapshotMiddlewareContext<S, T>;
-
     /**
-     * One or more snapshots were loaded from the database for a fetch or subscribe.
+     * Context for when one or more snapshots are loaded from the database for fetch or subscribe operations.
      */
     readSnapshots: IDocReadSnapshotsMiddlewareContext<S>;
     /**
-     * An operation was loaded from the database.
+     * Context for when an operation is loaded from the database.
      */
     readOp: IDocReadOpMiddlewareContext<T>;
-
     /**
-     * The doc is about to send a non-error reply to a client message.
+     * Context for when the document is about to send a non-error reply to a client message.
      */
     reply: IDocReplyMiddlewareContext<S, T>;
 }
+
+/**
+ * Base interface for document middleware context.
+ */
 export interface IDocMiddlewareContextBase {
     connection?: Connection;
 }
-export interface IDocReceiveMiddlewareContext<T> extends IDocMiddlewareContextBase {
-    request: IRequestMessage<T>;
-}
+
+/**
+ * Context for reading an operation in document middleware.
+ */
 export interface IDocReadOpMiddlewareContext<T> extends IDocMiddlewareContextBase {
     id: string;
     op: IOp<T>;
 }
+
+/**
+ * Context for receiving a message in document middleware.
+ */
+export interface IDocReceiveMiddlewareContext<T> extends IDocMiddlewareContextBase {
+    request: IRequestMessage<T>;
+}
+
+/**
+ * Context for replying to a client message in document middleware.
+ */
 export interface IDocReplyMiddlewareContext<S, T> extends IDocMiddlewareContextBase {
     request: IRequestMessage<T>;
     reply: IReplyMessage<S, T>;
 }
+
+/**
+ * Context for submitting an operation in document middleware.
+ */
 export interface IDocSubmitMiddlewareContext<S, T> extends IDocMiddlewareContextBase {
     request: SubmitRequest<S, T>;
 }
+
+/**
+ * Context for submitting a snapshot in document middleware.
+ */
 export interface IDocSubmitSnapshotMiddlewareContext<S, T> extends IDocMiddlewareContextBase {
     request: SubmitSnapshotRequest<S, T>;
 }
+
+/**
+ * Context for reading snapshots in document middleware.
+ */
 export interface IDocReadSnapshotsMiddlewareContext<S> extends IDocMiddlewareContextBase {
     request: ReadSnapshotsRequest<S>;
 }
 
-export interface IDocHookContext {
-    submitRequestEnd: unknown,
-    timing: unknown
+export interface IDocument {
+    id: string;
+    version: number;
+    snapshotVersion: number;
+    type?: string;
+}
+
+export interface ICommitSnapshot<S = unknown> extends ISnapshot<S> {
+    fromVersion: number;
+    fragmentsChanges: ISnapshotFragmentsChanges;
+}
+
+/**
+ * Context object passed to "readSnapshots" middleware functions.
+ * @param {ISnapshot<S>[]} snapshots - snapshots being read
+ * @param {keyof Backend.prototype.SNAPSHOT_TYPES} snapshotType - the type of snapshot read being
+ */
+export declare class ReadSnapshotsRequest<S> {
+    /**
+     * The snapshots being read.
+     */
+    snapshots: ISnapshot<S>[];
+    /**
+     * The type of snapshot being read.
+     */
+    snapshotType: SnapshotTypes;
+
+    /**
+     * Rejects the read of a specific snapshot silently, preventing its data from being sent to the client.
+     * Sets a special error code that avoids passing the error to user code while still performing actions like canceling subscriptions.
+     * @param {ISnapshot<S>} snapshot - The snapshot to reject.
+     * @param {string} errorMessage - The reason for rejection.
+     */
+    rejectSnapshotReadSilent(snapshot: ISnapshot<S>, errorMessage: string): void;
+}
+
+export interface IAfterCommitCallback<S, T> {
+    (request: SubmitRequest<S, T>): void;
 }
 
 export declare class SubmitRequest<S, T> {
     doc: DocumentServices<S, T>;
-    id: string;
     context: IContext;
+    id: string;
     op: IOp<T>;
     extra: unknown;
     retries: number;
@@ -246,6 +348,21 @@ export declare class SubmitRequest<S, T> {
     document: IDocument | null;
     ops: IOp<T>[];
 }
+
+/**
+ * The trigger source of submit snapshot.
+ */
+export enum SubmitSnapshotTrigger {
+    submitOp = 'submitOp',
+    fetchSnapshot = 'fetchSnapshot',
+    manual = 'manual',
+}
+
+export interface ISubmitSnapshotContext<T> extends IContext {
+    trigger?: SubmitSnapshotTrigger;
+    op?: IOp<T>;
+}
+
 export declare class SubmitSnapshotRequest<S, T> {
     doc: DocumentServices<S, T>;
     id: string;
@@ -262,187 +379,181 @@ export declare class SubmitSnapshotRequest<S, T> {
     document: IDocument | null;
     snapshot: ICommitSnapshot<S> | null;
 }
-export interface ISubmitSnapshotContext<T> extends IContext {
-    trigger?: SubmitSnapshotTrigger;
-    op?: IOp<T>;
-}
+
 /**
- * The trigger source of submit snapshot.
+ * Defines the interface for customizing operational transformation (OT) behavior in collaboration.
+ * @template S The type of snapshot data.
+ * @template T The type of op data.
  */
-export declare enum SubmitSnapshotTrigger {
-    submitOp = 'submitOp',
-    fetchSnapshot = 'fetchSnapshot',
-    manual = 'manual'
-}
-
-export declare class ReadSnapshotsRequest<S> {
-    snapshots: ISnapshot<S>[];
-    snapshotType: SnapshotTypes;
-    rejectSnapshotReadSilent(snapshot: ISnapshot<S>, errorMessage: string): void;
-}
-
-export type SnapshotTypes = 'current' | 'byVersion';
-
-export interface IDocument {
-    id: string;
-    version: number;
-    snapshotVersion: number;
-    type?: string;
-}
-
-export interface ISnapshot<S = unknown> {
-    id: string;
-    v: number;
-    type?: string;
-    data?: S;
-    fragments?: ISnapshotFragments;
-    m?: ISnapshotMeta;
-}
-export interface ISnapshotMeta {
-    mtime?: number;
-    ctime?: number;
-}
-
-export type ISnapshotFragments<S = unknown> = { [key: string]: S };
-
-export interface ISnapshotFragmentsChanges<S = unknown> {
-    createFragments?: { [key: string]: S };
-    updateFragments?: { [key: string]: S };
-    deleteFragments?: string[];
-    deleteSnapshot?: boolean;
-}
-
-export interface ICommitSnapshot<S = unknown> extends ISnapshot<S> {
-    fromVersion: number;
-    fragmentsChanges: ISnapshotFragmentsChanges;
-}
-
-export interface ISnapshotFragmentsRequest<S = unknown> {
-    getFragment(id: string): Promise<S | undefined>;
-
-    createFragment(id: string, data: S): void;
-    updateFragment(id: string, data: S): void;
-    deleteFragment(id: string): void;
-}
-
-export interface IOp<T = unknown> {
-    v: number;
-    create?: ICreateComponent;
-    op?: T;
-    del?: boolean;
-}
-export interface ICreateComponent {
-    type: string;
-    data: unknown;
-}
-
-
-export interface IRequestMessage<T> {
+export interface OT_Type<S = unknown, T = unknown> {
     /**
-     * message action
+     * The URI identifying the document type.
      */
-    a: MessageActions;
+    uri: string;
     /**
-     * version
+     * Creates initial snapshot data from provided data.
+     * @param {S} data - The initial snapshot data.
+     * @returns {S} The created snapshot data.
      */
-    v?: number;
-    create?: ICreateComponent;
-    op?: T;
-    del?: boolean;
-    error?: IErrorData;
-}
-export interface IRequestMessageExtra {
-    source?: unknown;
+    create?(data: S): S;
+    /**
+     * Generates snapshot fragments from snapshot data.
+     * @param {S} data - The snapshot data.
+     * @returns {ISnapshotFragments} The generated snapshot fragments.
+     */
+    createFragments?(data: S): ISnapshotFragments;
+    /**
+     * Composes snapshot data from snapshot fragments.
+     * @param {ISnapshotFragments} fragments - The snapshot fragments.
+     * @returns {S} The composed snapshot data.
+     */
+    composeFragments?(fragments: ISnapshotFragments): S;
+    /**
+     * Transforms an operation to resolve conflicts with another operation.
+     * @param {T} op1 - The operation to transform.
+     * @param {T} op2 - The operation serving as the basis for transformation.
+     * @param {'left' | 'right'} side - Indicates which operation arrived at the server later.
+     * @returns {T} The transformed operation.
+     */
+    transform(op1: T, op2: T, side: 'left' | 'right'): T;
+    /**
+     * Applies an operation to snapshot data.
+     * @param {S} snapshot - The current snapshot data.
+     * @param {T} op - The operation to apply.
+     * @returns {S} The updated snapshot data.
+     */
+    apply?(snapshot: S, op: T): S;
+    /**
+     * Applies an operation to snapshot fragments asynchronously.
+     * @param {ISnapshotFragmentsRequest} request - The request containing snapshot fragments.
+     * @param {T} op - The operation to apply.
+     * @returns {Promise<void>} A promise that resolves when the operation is applied.
+     */
+    applyFragments?(request: ISnapshotFragmentsRequest, op: T): Promise<void>;
 }
+
 /**
- * Message actions.
+ * Manages operational transformation (OT) types for collaboration, enabling registration and retrieval by URI.
  */
-export declare enum MessageActions {
-    fetch = 'fetch',
-    fetchOps = 'fetchOps',
-    fetchHistorySnapshot = 'fetchHistorySnapshot',
-    subscribe = 'subscribe',
-    unsubscribe = 'unsubscribe',
-    op = 'op',
-}
-
-export interface IReplyMessage<S, T> {
-    a: string;
-    v?: number;
-    create?: ICreateComponent;
-    op?: T;
-    del?: boolean;
-    error?: IErrorData;
-    data?: ISnapshot<S>;
+export declare class TypesManager {
+    /**
+     * Registers a custom OT type.
+     * @template S - The type of snapshot data.
+     * @template T - The type of operation data.
+     * @param {OT_Type<S, T>} type - The user-defined OT type to register.
+     */
+    static register<S, T>(type: OT_Type<S, T>): void;
+    /**
+     * Retrieves an OT type by its URI.
+     * @template S - The type of snapshot data.
+     * @template T - The type of operation data.
+     * @param {string} typeUri - The URI of the type to retrieve.
+     * @returns {OT_Type<S, T>} The OT type associated with the specified URI.
+     */
+    static getType<S, T>(typeUri: string): OT_Type<S, T>;
 }
 
 /**
- * The data base adapter interface.
+ * Defines the interface for a database adapter in operational transformation.
+ * @template S - The type of snapshot data.
+ * @template T - The type of operation data.
  */
-export interface IDataBaseAdapter<S = unknown, T = unknown> {
+export interface IDatabaseAdapter<S = unknown, T = unknown> {
     /**
-     * Get the ops between two versions, include from version, exclude to version.
+     * Retrieves operations between two versions (inclusive of 'from', exclusive of 'to').
+     * @param {string} id - The document ID.
+     * @param {number} from - The starting version.
+     * @param {number} [to] - The ending version (optional).
+     * @param {unknown} [options] - Additional options (optional).
+     * @returns {Promise<IOp<T>[]>} A promise resolving to an array of operations.
      */
     getOps(id: string, from: number, to?: number, options?: unknown): Promise<IOp<T>[]>;
     /**
-     * Get the document info by id.
+     * Retrieves document information by ID.
+     * @param {string} id - The document ID.
+     * @param {unknown} [options] - Additional options (optional).
+     * @returns {Promise<IDocument | undefined | null>} A promise resolving to the document info or undefined/null if not found.
      */
     getDocument(id: string, options?: unknown): Promise<IDocument | undefined | null>;
-
     /**
-     * Get the snapshot by id.
+     * Retrieves the snapshot of a document by ID.
+     * @param {string} id - The document ID.
+     * @param {unknown} [options] - Additional options (optional).
+     * @returns {Promise<ISnapshot<S> | undefined | null>} A promise resolving to the snapshot or undefined/null if not found.
      */
     getSnapshot(id: string, options?: unknown): Promise<ISnapshot<S> | undefined | null>;
+    /**
+     * Retrieves a specific fragment of a document by ID.
+     * @param {string} id - The document ID.
+     * @param {string} fragmentId - The ID of the fragment.
+     * @param {unknown} [options] - Additional options (optional).
+     * @returns {Promise<S | undefined | null>} A promise resolving to the fragment data or undefined/null if not found.
+     */
     getFragment(id: string, fragmentId: string, options?: unknown): Promise<S | undefined | null>;
+    /**
+     * Retrieves multiple fragments of a document by ID.
+     * @param {string} id - The document ID.
+     * @param {string[]} [fragmentIds] - The IDs of the fragments (optional).
+     * @param {unknown} [options] - Additional options (optional).
+     * @returns {Promise<{ [id: string]: S }>} A promise resolving to an object mapping fragment IDs to their data.
+     */
     getFragments(id: string, fragmentIds?: string[], options?: unknown): Promise<{ [id: string]: S }>;
-
+    /**
+     * Commits an operation to the database.
+     * @param {string} id - The document ID.
+     * @param {IOp<T>} op - The operation to commit.
+     * @param {IDocument} document - The document metadata.
+     * @param {unknown} [options] - Additional options (optional).
+     * @returns {Promise<boolean>} A promise resolving to true if the operation was committed, false otherwise.
+     */
     commitOp(id: string, op: IOp<T>, document: IDocument, options?: unknown): Promise<boolean>;
+    /**
+     * Commits a snapshot to the database.
+     * @param {string} id - The document ID.
+     * @param {ICommitSnapshot<S>} snapshot - The snapshot to commit.
+     * @param {unknown} [options] - Additional options (optional).
+     * @returns {Promise<boolean>} A promise resolving to true if the snapshot was committed, false otherwise.
+     */
     commitSnapshot(id: string, snapshot: ICommitSnapshot<S>, options?: unknown): Promise<boolean>;
-
     /**
-     * Get the committed op version, if the op is committed, return the committed version, otherwise return undefined.
+     * Retrieves the committed version of an operation, if it exists.
+     * @param {string} id - The document ID.
+     * @param {number} to - The ending version to check up to.
+     * @param {IOp<T>} op - The operation to verify.
+     * @returns {Promise<number | undefined>} A promise resolving to the committed version or undefined if not committed.
      */
     getCommittedOpVersion(id: string, to: number, op: IOp): Promise<number | undefined>;
-
     /**
-     * Close the database.
+     * Closes the database connection.
+     * @returns {Promise<void>} A promise that resolves when the database is closed.
      */
     close(): Promise<void>;
 }
 
 /**
- * The milestone data base adapter interface.
+ * Abstract base class implementing the database adapter interface.
+ * @template S - The type of snapshot data.
+ * @template T - The type of operation data.
  */
-export interface IMilestoneDataBaseAdapter<S> {
-    /**
-     * The interval of saving milestone snapshot.
-     * default is 1000.
-     */
-    interval: number;
-    saveMilestoneSnapshot(snapshot: ISnapshot<S>): Promise<boolean>;
-    getMilestoneSnapshot(id: string, version: number): Promise<ISnapshot<S> | undefined>;
-}
-
-export declare abstract class Db<S, T> implements IDataBaseAdapter<S, T> {
+export declare abstract class Db<S, T> implements IDatabaseAdapter<S, T> {
     abstract getOps(id: string, from: number, to?: number, options?: unknown): Promise<IOp<T>[]>;
     abstract getDocument(id: string, options?: unknown): Promise<IDocument | undefined | null>;
     abstract getSnapshot(id: string, options?: unknown): Promise<ISnapshot<S> | undefined | null>;
     abstract getFragment(id: string, fragmentId: string, options?: unknown): Promise<S | undefined | null>;
-    abstract getFragments(id: string, fragmentIds?: string[], options?: unknown): Promise<{
-        [id: string]: S;
-    }>;
+    abstract getFragments(id: string, fragmentIds?: string[], options?: unknown): Promise<{ [id: string]: S }>;
     abstract commitOp(id: string, op: IOp<T>, document: IDocument, options?: unknown): Promise<boolean>;
     abstract commitSnapshot(id: string, snapshot: ICommitSnapshot<S>, options?: unknown): Promise<boolean>;
     abstract close(): Promise<void>;
+    /**
+     * Retrieves the committed version of an operation if it exists.
+     */
     getCommittedOpVersion(id: string, to: number, op: IOp<object>): Promise<number | undefined>;
 }
 
 export declare class MemoryDb<S = unknown, T = unknown> extends Db<S, T> {
     getSnapshot(roomId: string): Promise<ISnapshot<S> | undefined>;
     getDocument(roomId: string): Promise<IDocument | undefined>;
-    getFragments(roomId: string): Promise<{
-        [key: string]: S;
-    }>;
+    getFragments(roomId: string): Promise<{ [key: string]: S }>;
     getFragment(roomId: string, fragmentId: string): Promise<S | undefined>;
     getOps(roomId: string, fromVersion: number, toVersion?: number): Promise<IOp<T>[]>;
     commitOp(id: string, op: IOp<T>, document: IDocument): Promise<boolean>;
@@ -450,19 +561,21 @@ export declare class MemoryDb<S = unknown, T = unknown> extends Db<S, T> {
     close(): Promise<void>;
 }
 
-export interface IContext {
-    connection?: Connection;
-    options?: ICustomOptions;
-}
-
-export interface ICustomOptions {
-    [key: string]: unknown;
-}
-export interface IErrorData {
-    code: string;
-    message: string;
+/**
+ * Defines the interface for a milestone database adapter.
+ */
+export interface IMilestoneDatabaseAdapter<S> {
+    /**
+     * The interval for saving milestone snapshots.
+     * @default 1000
+     */
+    interval: number;
+    /**
+     * Saves a milestone snapshot.
+     */
+    saveMilestoneSnapshot(snapshot: ISnapshot<S>): Promise<boolean>;
+    /**
+     * Retrieves a milestone snapshot by document ID and version.
+     */
+    getMilestoneSnapshot(id: string, version: number): Promise<ISnapshot<S> | undefined>;
 }
-
-export interface IAfterCommitCallback<S, T> {
-    (request: SubmitRequest<S, T>): void;
-}

package/dist/index.js

@@ -1 +1 @@
-!function(t,e){if("object"==typeof exports&&"object"==typeof module)module.exports=e(require("@grapecity-software/js-collaboration"));else if("function"==typeof define&&define.amd)define(["@grapecity-software/js-collaboration"],e);else{var s="object"==typeof exports?e(require("@grapecity-software/js-collaboration")):e(t["@grapecity-software/js-collaboration"]);for(var r in s)("object"==typeof exports?exports:t)[r]=s[r]}}(this,(t=>(()=>{"use strict";var e={619:(t,e)=>{Object.defineProperty(e,"__esModule",{value:!0}),e.Db=void 0,e.Db=class{async getCommittedOpVersion(t,e,s){const r=await this.getOps(t,0,e);for(let t=r.length;t--;){const e=r[t];if(s.src===e.src&&s.seq===e.seq)return e.v}}}},985:(t,e,s)=>{Object.defineProperty(e,"__esModule",{value:!0}),e.MemoryDb=void 0;const r=s(619);class n extends r.Db{constructor(t){var e;super(),this.ops=new Map,this.documents=new Map,this.fragments=new Map,this.mockWaitTime=null!==(e=null==t?void 0:t.mockWaitTime)&&void 0!==e?e:0}async getSnapshot(t){return this.execute((async()=>{const e=this.documents.get(t);if(!e)return;const s=await this.getFragments(t);return{id:t,v:e.snapshotVersion,type:e.type,fragments:s}}))}getDocument(t){return this.execute((()=>{const e=this.documents.get(t);if(e)return JSON.parse(JSON.stringify(e))}))}getFragments(t){return this.execute((()=>{const e=this.fragments.get(t);return e?JSON.parse(JSON.stringify(Object.fromEntries(e))):void 0}))}getFragment(t,e){return this.execute((()=>{var s;const r=null===(s=this.fragments.get(t))||void 0===s?void 0:s.get(e);if(r)return JSON.parse(JSON.stringify(r))}))}getOps(t,e,s){return this.execute((()=>{const r=this.ops.get(t);if(!r)return[];s=null!=s?s:Number.MAX_SAFE_INTEGER;const n=r.filter((t=>t.v>=e&&t.v<s));return JSON.parse(JSON.stringify(n))}))}commitOp(t,e,s){return this.execute((()=>{var r;if(e=JSON.parse(JSON.stringify(e)),s=JSON.parse(JSON.stringify(s)),e.create){if(this.documents.has(t))return!1;const{version:r,snapshotVersion:n,type:i}=s;return this.documents.set(t,{id:t,version:r,snapshotVersion:n,type:i}),this.ops.set(t,[e]),this.fragments.set(t,new Map),!0}if(e.del)return!!this.documents.has(t)&&(this.documents.delete(t),this.ops.delete(t),this.fragments.delete(t),!0);{const n=null===(r=this.ops.get(t))||void 0===r?void 0:r.length;return e.v===n&&(this.ops.get(t).push(e),this.documents.get(t).version=s.version,!0)}}))}commitSnapshot(t,e){return this.execute((()=>{var s,r,n;e=JSON.parse(JSON.stringify(e));const i=this.documents.get(t);if(e.fromVersion!==i.snapshotVersion)return!1;if(e.v<=i.snapshotVersion)return!1;i.snapshotVersion=e.v;const o=e.fragmentsChanges;if(o.deleteSnapshot)this.fragments.delete(t);else{const e=this.fragments.get(t);Object.entries(null!==(s=o.createFragments)&&void 0!==s?s:{}).forEach((async([t,s])=>{e.set(t,s)})),Object.entries(null!==(r=o.updateFragments)&&void 0!==r?r:{}).forEach((async([t,s])=>{e.set(t,s)})),null===(n=o.deleteFragments)||void 0===n||n.forEach((t=>{e.delete(t)}))}return!0}))}close(){return this.execute((()=>{}))}dump(){const t={ops:this.ops,documents:this.documents,fragments:this.fragments};return JSON.parse(JSON.stringify(t,((t,e)=>e instanceof Map?Object.fromEntries(e.entries()):e)))}_wait(){return new Promise((t=>setTimeout(t,this.mockWaitTime)))}async execute(t){return await this._wait(),await t()}}e.MemoryDb=n},347:(t,e,s)=>{Object.defineProperty(e,"__esModule",{value:!0}),e.DocumentController=void 0;const r=s(127),n=s(961),i=s(660),o=i.MessageActions,a=i.OTError.CODES;function c(t){return{id:t.id,v:t.v,data:t.data,type:t.type}}e.DocumentController=class{constructor(t){this.service=t}async trigger(t,e){await this.service.trigger(t,e)}send(t,e){t.send(JSON.stringify(e),i.OT_DOC_MESSAGE_TYPE)}_sendOp(t,e){const s={a:o.op,v:e.v,src:e.src,seq:e.seq};"op"in e&&(s.op=e.op),e.create&&(s.create=e.create),e.del&&(s.del=!0),this.send(t,s)}_broadcastOp(t,e){const s={a:i.MessageActions.op,v:e.v,src:e.src,seq:e.seq};"op"in e&&(s.op=e.op),e.create&&(s.create=e.create),e.del&&(s.del=!0),t.broadcast(JSON.stringify(s),i.OT_DOC_MESSAGE_TYPE)}_sendOps(t,e){for(let s=0;s<e.length;s++)this._sendOp(t,e[s])}async _reply(t,e,s){s.a=e.a;const r={connection:t,request:e,reply:s};try{await this.trigger("reply",r),this.send(t,r.reply)}catch(s){this._replyError(t,e,s)}}async _replyError(t,e,s){e.error=function(t){return t instanceof i.OTError?{code:t.code,message:t.message}:"string"==typeof t?{code:a.ERR_UNKNOWN_ERROR,message:t}:(r.logger.warn("unknown error",t),void((null==t?void 0:t.stack)&&r.logger.info(t.stack)))}(s),this.send(t,e)}async _messageHandler(t,e){const s=this;if("string"!=typeof e)return void s.close(t,new i.OTError(a.ERR_MESSAGE_BADLY_FORMED,"Received non-object message"));let r;try{r=JSON.parse(e)}catch(e){return void s.close(t,new i.OTError(a.ERR_MESSAGE_BADLY_FORMED,"Received non-object message"))}try{this.trigger("receive",Object.assign(Object.assign({},s),{request:r}));const e=await s._handleMessage(t,r);s._reply(t,r,e||{})}catch(e){s._replyError(t,r,e)}}_checkRequest(t){if(t.a===o.op&&!(0,n.isNullOrUndefined)(t.v)&&("number"!=typeof t.v||t.v<0))return"Invalid version"}async _handleMessage(t,e){const s=this._checkRequest(e);if(s)throw new i.OTError(a.ERR_MESSAGE_BADLY_FORMED,s);switch(e.a){case o.fetch:return await this._fetch(t,e.v);case o.subscribe:return await this._subscribe(t,e.v);case o.unsubscribe:return this._unsubscribe();case o.op:return await this._submit(t,e);case o.fetchHistorySnapshot:return await this._fetchSnapshot(t,e);default:throw new i.OTError(a.ERR_MESSAGE_BADLY_FORMED,"Invalid or unknown message")}}async _fetch(t,e){return(0,n.isNullOrUndefined)(e)?{data:c(await this.service.fetch(t.roomId,void 0))}:await this._fetchOps(t,e)}async _fetchOps(t,e){const s=await this.service.getOps(t.roomId,e,void 0,void 0);this._sendOps(t,s)}async _subscribe(t,e){const s=await this.service.subscribe(t.roomId,e);if((null==s?void 0:s.ops)&&this._sendOps(t,s),null==s?void 0:s.snapshot)return{data:c(s.snapshot)}}_unsubscribe(){}async _submit(t,e){const s=function(t,e){const s=t.src||e;return t.op?function(t,e,s,r,n){return{src:t,seq:e,v:s,op:r,x:n,m:void 0}}(s,t.seq,t.v,t.op,t.x):t.create?function(t,e,s,r,n){return{src:t,seq:e,v:s,create:r,x:n,m:void 0}}(s,t.seq,t.v,t.create,t.x):t.del?function(t,e,s,r,n){return{src:t,seq:e,v:s,del:r,x:n,m:void 0}}(s,t.seq,t.v,t.del,t.x):void 0}(e,t.id);if(!s)throw new i.OTError(a.ERR_MESSAGE_BADLY_FORMED,"Invalid op message");if(s.seq>=i.util.MAX_SAFE_INTEGER)throw new i.OTError(a.ERR_CONNECTION_SEQ_INTEGER_OVERFLOW,"Connection seq has exceeded the max safe integer, maybe from being open for too long");return await this._submitOp(t,s)}async _submitOp(t,e){const s=this;try{const r=await this.service.submit(t.roomId,e,{connection:t},(e=>{s._broadcastOp(t,e.op)}));return s._sendOps(t,r),{src:e.src,seq:e.seq,v:e.v}}catch(t){if(t instanceof i.OTError&&t.code===a.ERR_OP_ALREADY_SUBMITTED)return{src:e.src,seq:e.seq,v:e.v};throw t}}async _fetchSnapshot(t,e){return void 0!==e.v?{id:e.id,data:await this.service.fetchHistorySnapshot(t.roomId,e.v)}:void 0!==e.ts?{id:e.id,data:await this.service.fetchHistorySnapshotByTimestamp(t.roomId,e.ts)}:void 0}close(t,e){e&&r.logger.warn("Connection closed due to error",t.id,e.stack||e),t.close()}}},763:(t,e,s)=>{Object.defineProperty(e,"__esModule",{value:!0}),e.documentFeature=function(t){const e=t||new r.DocumentServices,s=new n.DocumentController(e);return{middlewares:{message:async(t,e)=>t.type!==i.OT_DOC_MESSAGE_TYPE?await e():s._messageHandler(t.connection,t.data)}}};const r=s(89),n=s(347),i=s(660)},89:(t,e,s)=>{Object.defineProperty(e,"__esModule",{value:!0}),e.DocumentServices=void 0;const r=s(660),n=s(127),i=s(961),o=s(985),a=s(259),c=s(551),_=s(155),u=s(936),p=s(469),h=s(36),d=s(769),O=r.OTError.CODES;class E extends n.Middleware{constructor(t){var e,s,r;super(),t=null!=t?t:{},this.db=null!==(e=t.db)&&void 0!==e?e:new o.MemoryDb,this.milestoneDb=null!==(s=t.milestoneDb)&&void 0!==s?s:new u.MilestoneDB,this.maxSubmitRetries=t.maxSubmitRetries,this.submitSnapshotBatchSize=null!==(r=t.submitSnapshotBatchSize)&&void 0!==r?r:10}async fetch(t,e){const s=Date.now(),r=this;let n=await r._getSnapshot(t,e);return[n]=await r._sanitizeSnapshots([n],a.SnapshotTypes.current,e),r._emitTiming("fetch",Date.now()-s,{context:e,id:t}),n}async getOps(t,e,s,r){const n=Date.now(),i=await this._getSanitizedOps(t,e,s,r);return this._emitTiming("getOps",Date.now()-n,Object.assign(Object.assign({},r),{id:t,from:e,to:s})),i}async subscribe(t,e,s){const r=this,n=Date.now();if((0,i.isNullOrUndefined)(e)){const i=await r.fetch(t,s);return r._emitTiming("subscribe.snapshot",Date.now()-n,Object.assign(Object.assign({},s),{id:t,version:e})),{snapshot:i}}{const i=await r._getSanitizedOps(t,e,void 0,s);return r._emitTiming("subscribe.ops",Date.now()-n,Object.assign(Object.assign({},s),{id:t,version:e})),{ops:i}}}async submit(t,e,s,r){const n=this,i=new c.SubmitRequest(this,t,e,s),o=Object.assign(Object.assign({},s),{request:i});try{const s=_.ot.checkOp(e);if(s)throw s;return await n.trigger("submit",o),await i.submit(r),await n.trigger("afterWrite",o),await n._sanitizeOps(t,i.ops,o),n._emitTiming("submit.total",Date.now()-i.start,i),n.emit("submitRequestEnd",{request:i}),i.ops}catch(t){throw n.emit("submitRequestEnd",{error:t,request:i}),t}}async fetchHistorySnapshotByTimestamp(t,e,s){const r=Date.now();let n=await this._fetchHistorySnapshotByTimestamp(t,e);const i=[n],o=a.SnapshotTypes.byTimestamp;return[n]=await this._sanitizeSnapshots(i,o,s),this._emitTiming("fetchSnapshot",Date.now()-r,Object.assign({},s)),n}async _fetchHistorySnapshotByTimestamp(t,e){const s=this.db,r=this.milestoneDb;let n,i=0;if(void 0===e)return await this._getSnapshot(t);let o=await r.getMilestoneSnapshotAtOrBeforeTime(t,e);const a=o;o&&(i=o.v),o=await r.getMilestoneSnapshotAtOrAfterTime(t,e),o&&(n=o.v);const c=await s.getOps(t,i,n,{metadata:!0});return function(t,e){for(let s=0;s<t.length;s++){const r=t[s];if((r.m&&r.m.ts)>e)return void(t.length=s)}}(c,e),o=await this._buildSnapshotFromOps(t,a,c),o}async fetchHistorySnapshot(t,e,s){const r=Date.now();let n=await this._fetchHistorySnapshot(t,e);const i=[n],o=a.SnapshotTypes.byVersion;return[n]=await this._sanitizeSnapshots(i,o,s),this._emitTiming("fetchSnapshot",Date.now()-r,Object.assign(Object.assign({},s),{version:e})),n}async _fetchHistorySnapshot(t,e){const s=this.db;if(void 0===e)return await this._getSnapshot(t);const n=await this.milestoneDb.getMilestoneSnapshot(t,e),i=n?n.v:0,o=await s.getOps(t,i,e),a=await this._buildSnapshotFromOps(t,n,o);if(e>a.v)throw new r.OTError(O.ERR_OP_VERSION_NEWER_THAN_CURRENT_SNAPSHOT,"Requested version exceeds latest snapshot version");return a}async _buildSnapshotFromOps(t,e,s){const r=null!=e?e:{id:t,v:0},n=new h.SnapshotFragmentsRequest(t,void 0,r.fragments),i=await _.ot.applyOps(r,s,n);if(i)throw i;return n.applyChangesToSnapshot(r),_.ot.composeFragments(r),r}async _sanitizeSnapshots(t,e,s){const r=new p.ReadSnapshotsRequest(t,e);if(await this.trigger("readSnapshots",Object.assign(Object.assign({},s),{request:r})),r.hasSnapshotRejection())throw r.getReadSnapshotsError();return t}async _getSanitizedOps(t,e,s,r){const n=await this.db.getOps(t,e,s,null==r?void 0:r.options);return await this._sanitizeOps(t,n,r),n}async _sanitizeOps(t,e,s){for(const r of e)await this._sanitizeOp(t,r,s)}async _sanitizeOp(t,e,s){await this.trigger("readOp",Object.assign(Object.assign({},s),{id:t,op:e}))}async _getSnapshot(t,e){var s;const r=null==e?void 0:e.options,n=await this.db.getDocument(t,r);if(!n)return{id:t,v:0};if(n.snapshotVersion<n.version){const s=new d.SubmitSnapshotRequest(this,t,n,Object.assign(Object.assign({},e),{trigger:d.SubmitSnapshotTrigger.fetchSnapshot}));await s.submitSnapshot()}const i=null!==(s=await this.db.getSnapshot(t,r))&&void 0!==s?s:{id:t,v:0};return _.ot.composeFragments(i),i}_emitTiming(t,e,s){this.emit("timing",{action:t,cost:e,m:s})}}e.DocumentServices=E},259:(t,e)=>{Object.defineProperty(e,"__esModule",{value:!0}),e.Hooks=e.SnapshotTypes=void 0,e.SnapshotTypes={current:"current",byVersion:"byVersion",byTimestamp:"byTimestamp"},e.Hooks={submitRequestEnd:"submitRequestEnd",timing:"timing"}},936:(t,e,s)=>{Object.defineProperty(e,"__esModule",{value:!0}),e.MilestoneDB=void 0;const r=s(660),n=s(961),i=r.OTError.CODES;e.MilestoneDB=class{constructor(t){var e;this.interval=null!==(e=null==t?void 0:t.interval)&&void 0!==e?e:1e3,this.map=new Map}saveMilestoneSnapshot(t){return new Promise((e=>{let s=this.map.get(t.id);s||(s=[],this.map.set(t.id,s)),s.push(t),s.sort(((t,e)=>t.v-e.v)),e(!0)}))}getMilestoneSnapshot(t,e){const s=function(t){return function(e,s){return!(0,n.isNullOrUndefined)(t)&&s.v>t}}(e);return this._findMilestoneSnapshot(t,s)}getMilestoneSnapshotAtOrBeforeTime(t,e){const s=function(t){return function(e,s){if((0,n.isNullOrUndefined)(t))return!!e;const r=s&&s.m&&s.m.mtime;return void 0!==r&&r>t}}(e);return this._findMilestoneSnapshot(t,s)}getMilestoneSnapshotAtOrAfterTime(t,e){const s=function(t){return function(e){if((0,n.isNullOrUndefined)(t))return!1;const s=e&&e.m&&e.m.mtime;return void 0!==s&&s>=t}}(e);return this._findMilestoneSnapshot(t,s)}_findMilestoneSnapshot(t,e){return new Promise((s=>{if(!t)throw new r.OTError(i.ERR_MILESTONE_ARGUMENT_INVALID,"Missing ID");const n=this._getMilestoneSnapshots(t);let o;for(let t=0;t<n.length;t++){const s=n[t];if(e(o,s))break;o=s}s(o)}))}_getMilestoneSnapshots(t){var e;return null!==(e=this.map.get(t))&&void 0!==e?e:[]}}},155:(t,e,s)=>{Object.defineProperty(e,"__esModule",{value:!0}),e.ot=e.composeFragments=e.applyOps=e.transform=e.apply=e.normalizeType=e.checkOp=void 0;const r=s(961),n=s(660),i=n.OTError.CODES,o="default";e.checkOp=function(t){if((0,r.isNullOrUndefined)(t)||"object"!=typeof t)return new n.OTError(i.ERR_OT_OP_BADLY_FORMED,"Op must be an object");if((0,r.isNullOrUndefined)(t.create)){if((0,r.isNullOrUndefined)(t.del)){if(!("op"in t))return new n.OTError(i.ERR_OT_OP_BADLY_FORMED,"Missing op, create, or del")}else if(!0!==t.del)return new n.OTError(i.ERR_OT_OP_BADLY_FORMED,"del value must be true")}else{if("object"!=typeof t.create)return new n.OTError(i.ERR_OT_OP_BADLY_FORMED,"Create data must be an object");const e=t.create.type;if("string"!=typeof e)return new n.OTError(i.ERR_OT_OP_BADLY_FORMED,"Missing create type");const s=n.TypesManager.map[e];if((0,r.isNullOrUndefined)(s)||"object"!=typeof s)return new n.OTError(i.ERR_DOC_TYPE_NOT_RECOGNIZED,"Unknown type")}return(0,r.isNullOrUndefined)(t.src)||"string"==typeof t.src?(0,r.isNullOrUndefined)(t.seq)||"number"==typeof t.seq?(0,r.isNullOrUndefined)(t.src)&&!(0,r.isNullOrUndefined)(t.seq)||!(0,r.isNullOrUndefined)(t.src)&&(0,r.isNullOrUndefined)(t.seq)?new n.OTError(i.ERR_OT_OP_BADLY_FORMED,"Both src and seq must be set together"):(0,r.isNullOrUndefined)(t.m)||"object"==typeof t.m?void 0:new n.OTError(i.ERR_OT_OP_BADLY_FORMED,"op.m must be an object or null"):new n.OTError(i.ERR_OT_OP_BADLY_FORMED,"seq must be a number"):new n.OTError(i.ERR_OT_OP_BADLY_FORMED,"src must be a string")},e.normalizeType=function(t){return n.TypesManager.map[t]&&n.TypesManager.map[t].uri},e.apply=async function(t,e,s){if("object"!=typeof t)return new n.OTError(i.ERR_APPLY_SNAPSHOT_NOT_PROVIDED,"Missing snapshot");if(!(0,r.isNullOrUndefined)(t.v)&&!(0,r.isNullOrUndefined)(e.v)&&t.v!==e.v)return new n.OTError(i.ERR_APPLY_OP_VERSION_DOES_NOT_MATCH_SNAPSHOT,"Version mismatch");if(e.create){const r=e.create,a=n.TypesManager.map[r.type];if(!a)return new n.OTError(i.ERR_DOC_TYPE_NOT_RECOGNIZED,"Unknown type");try{let e;e=a.createFragments?a.createFragments(r.data):{[o]:a.create(r.data)},s.create(e),t.type=a.uri,t.v++}catch(t){return t}}else if(e.del)s.delete(),t.data=void 0,t.type=void 0,t.v++;else if("op"in e){const r=await async function(t,e,s){if(!t.type)return new n.OTError(i.ERR_DOC_DOES_NOT_EXIST,"Document does not exist");if(void 0===e)return new n.OTError(i.ERR_OT_OP_NOT_PROVIDED,"Missing op");const r=n.TypesManager.map[t.type];if(!r)return new n.OTError(i.ERR_DOC_TYPE_NOT_RECOGNIZED,"Unknown type");try{if(r.applyFragments)await r.applyFragments(s,e);else{const t=await s.getFragment(o),n=r.apply(t,e);s.updateFragment(o,n)}}catch(t){return new n.OTError(i.ERR_OT_OP_NOT_APPLIED,t.message)}}(t,e.op,s);if(r)return r;t.v++}else t.v++},e.transform=function(t,e,s){if(!(0,r.isNullOrUndefined)(e.v)&&e.v!==s.v)return new n.OTError(i.ERR_OP_VERSION_MISMATCH_DURING_TRANSFORM,"Version mismatch");if(s.del){if(e.create||"op"in e)return new n.OTError(i.ERR_DOC_WAS_DELETED,"Document was deleted")}else{if(s.create&&("op"in e||e.create||e.del)||"op"in s&&e.create)return new n.OTError(i.ERR_DOC_ALREADY_CREATED,"Document was created remotely");if("op"in s&&"op"in e){if(!t)return new n.OTError(i.ERR_DOC_DOES_NOT_EXIST,"Document does not exist");if("string"==typeof t&&!(t=n.TypesManager.map[t]))return new n.OTError(i.ERR_DOC_TYPE_NOT_RECOGNIZED,"Unknown type");try{e.op=t.transform(e.op,s.op,"left")}catch(t){return new n.OTError(i.ERR_OT_OP_TRANSFORM_FAILED,"Op transform failed")}}}(0,r.isNullOrUndefined)(e.v)||e.v++},e.applyOps=async function(t,s,r){for(let n=0;n<s.length;n++){const i=s[n];t.v=i.v;const o=await(0,e.apply)(t,i,r);if(o)return o}},e.composeFragments=function(t){if(!t.type)return;const e=n.TypesManager.map[t.type];e&&t.fragments&&(e.composeFragments?t.data=e.composeFragments(t.fragments):t.data=t.fragments[o])},e.ot={checkOp:e.checkOp,normalizeType:e.normalizeType,apply:e.apply,transform:e.transform,applyOps:e.applyOps,composeFragments:e.composeFragments}},469:(t,e,s)=>{Object.defineProperty(e,"__esModule",{value:!0}),e.ReadSnapshotsRequest=void 0;const r=s(660),n=s(961);e.ReadSnapshotsRequest=class{constructor(t,e){this.snapshots=t,this.snapshotType=e,this._idToError=null}rejectSnapshotRead(t,e){this._idToError||(this._idToError=Object.create(null)),this._idToError[t.id]=e}rejectSnapshotReadSilent(t,e){this.rejectSnapshotRead(t,this.silentRejectionError(e))}silentRejectionError(t){return new r.OTError(r.OTError.CODES.ERR_SNAPSHOT_READ_SILENT_REJECTION,t)}hasSnapshotRejection(){return!(0,n.isNullOrUndefined)(this._idToError)}getReadSnapshotsError(){const t=this.snapshots,e=this._idToError;if(0===t.length)return;if(1===t.length){return e[t[0].id]||void 0}const s=new r.OTError(r.OTError.CODES.ERR_SNAPSHOT_READS_REJECTED);return s.idToError=e,s}}},36:(t,e)=>{function s(t,e){var s,r,n;const i=null!==(s=t.fragments)&&void 0!==s?s:{};if(e.deleteSnapshot)t.fragments={};else{for(const[t,s]of Object.entries(null!==(r=e.createFragments)&&void 0!==r?r:{}))i[t]=s;for(const[t,s]of Object.entries(null!==(n=e.updateFragments)&&void 0!==n?n:{}))i[t]=s;e.deleteFragments&&e.deleteFragments.length>0&&e.deleteFragments.forEach((t=>delete i[t])),t.fragments=i}}Object.defineProperty(e,"__esModule",{value:!0}),e.SnapshotFragmentsRequest=void 0,e.applyChangesToSnapshot=s,e.SnapshotFragmentsRequest=class{constructor(t,e,s){this._fragmentsMap=new Map,this._createFragments=new Map,this._updateFragments=new Map,this._deleteFragments=new Set,this._deleteSnapshot=!1,this._docId=t,this._db=e,s&&Object.entries(s).forEach((([t,e])=>{this._fragmentsMap.set(t,e)}))}async _loadFragment(t){const e=await this._db.getFragment(this._docId,t);this._fragmentsMap.set(t,e)}async getFragment(t){return this._db&&!this._fragmentsMap.has(t)&&await this._loadFragment(t),this._fragmentsMap.get(t)}createFragment(t,e){this._createFragments.set(t,e),this._fragmentsMap.set(t,e)}updateFragment(t,e){this._createFragments.has(t)?this._createFragments.set(t,e):this._updateFragments.set(t,e),this._fragmentsMap.set(t,e)}deleteFragment(t){this._deleteFragments.add(t),this._createFragments.delete(t),this._updateFragments.delete(t),this._fragmentsMap.delete(t)}create(t){Object.entries(t).forEach((([t,e])=>{this.createFragment(t,e)}))}delete(){this._deleteSnapshot=!0,this._createFragments.clear(),this._updateFragments.clear(),this._deleteFragments.clear(),this._fragmentsMap.clear()}getChanges(){return{createFragments:Object.fromEntries(this._createFragments.entries()),updateFragments:Object.fromEntries(this._updateFragments.entries()),deleteFragments:Array.from(this._deleteFragments),deleteSnapshot:this._deleteSnapshot}}applyChangesToSnapshot(t){s(t,this.getChanges())}}},551:function(t,e,s){var r=this&&this.__createBinding||(Object.create?function(t,e,s,r){void 0===r&&(r=s);var n=Object.getOwnPropertyDescriptor(e,s);n&&!("get"in n?!e.__esModule:n.writable||n.configurable)||(n={enumerable:!0,get:function(){return e[s]}}),Object.defineProperty(t,r,n)}:function(t,e,s,r){void 0===r&&(r=s),t[r]=e[s]}),n=this&&this.__setModuleDefault||(Object.create?function(t,e){Object.defineProperty(t,"default",{enumerable:!0,value:e})}:function(t,e){t.default=e}),i=this&&this.__importStar||function(t){if(t&&t.__esModule)return t;var e={};if(null!=t)for(var s in t)"default"!==s&&Object.prototype.hasOwnProperty.call(t,s)&&r(e,t,s);return n(e,t),e};Object.defineProperty(e,"__esModule",{value:!0}),e.SubmitRequest=void 0;const o=s(961),a=s(660),c=i(s(155)),_=s(769),u=a.OTError.CODES,p=a.TypesManager.getType;e.SubmitRequest=class{constructor(t,e,s,r){this.doc=t,this.context=r||{},this.id=e,this.op=s,this.extra=s.x,delete s.x,this.start=Date.now(),this._addOpMeta(),this.maxRetries=t.maxSubmitRetries,this.retries=0,this.ops=[]}async submit(t){var e;const s=this,r=this.doc.db,n=this.id,i=this.op,a=null!==(e=await r.getDocument(n))&&void 0!==e?e:{id:n,version:0,snapshotVersion:0};s.document=a;const c=a.version;if((0,o.isNullOrUndefined)(i.v)){if(i.create&&a.type&&i.src){const t=await r.getCommittedOpVersion(n,c,i);throw(0,o.isNullOrUndefined)(t)?s.alreadyCreatedError():(i.v=t,s.alreadySubmittedError())}i.v=c}if(i.v>c)throw s.newerVersionError();if(i.v<c){const t=Date.now(),e=i.v,o=await r.getOps(n,e,c);if(!o||o.length!==c-e)throw s.missingOpsError();const a=s._transformOp(o);if(a)throw a;if(i.v!==c)throw s.versionAfterTransformError();s.doc._emitTiming("submit.transform",Date.now()-t,s)}if(i.create&&a.type)throw s.alreadyCreatedError();s._updateDocument(),await s.commitOp(t)}_addOpMeta(){this.op.m={ts:this.start},this.op.create&&(this.op.create.type=c.normalizeType(this.op.create.type))}_updateDocument(){if(!this.document)return;const t=this.document,e=this.op;e.create?(t.type=c.normalizeType(e.create.type),t.snapshotVersion=0):e.del&&(t.type=void 0),t.version++,this._updateDocumentMeta()}_updateDocumentMeta(){const t=this.document.m||(this.document.m={});this.op.create&&(t.ctime=this.start),t.mtime=this.start}_transformOp(t){const e=p(this.document.type);for(let s=0;s<t.length;s++){const r=t[s];if(this.op.src&&this.op.src===r.src&&this.op.seq===r.seq)return this.alreadySubmittedError();if(this.op.v!==r.v)return this.versionDuringTransformError();const n=c.transform(e,this.op,r);if(n)return n;delete r.m,this.ops.push(r)}}async commitOp(t){const e=this,s=this.doc;await e._trigger("commit");const r=Date.now();if(!await s.db.commitOp(e.id,e.op,e.document,e.options))return await e._retry(t);e.op.m=void 0,s._emitTiming("commit.op",Date.now()-r,e),null==t||t(e);const n=new _.SubmitSnapshotRequest(s,e.id,e.document,Object.assign(Object.assign({},e.context),{trigger:_.SubmitSnapshotTrigger.submitOp,op:e.op}));await n.submitSnapshot()}async _retry(t){if(this.retries++,null!=this.maxRetries&&this.retries>this.maxRetries)throw this.maxRetriesError();this.doc._emitTiming("submit.retry",Date.now()-this.start,this),await this.submit(t)}async _trigger(t){const e=Object.assign(Object.assign({},this.context),{request:this});await this.doc.trigger(t,e),this.context.options=e.options}alreadyCreatedError(){return new a.OTError(u.ERR_DOC_ALREADY_CREATED,"Invalid op submitted. Document already created")}rejectedError(){return new a.OTError(u.ERR_OP_SUBMIT_REJECTED,"Op submit rejected")}alreadySubmittedError(){return new a.OTError(u.ERR_OP_ALREADY_SUBMITTED,"Op already submitted")}maxRetriesError(){return new a.OTError(u.ERR_MAX_SUBMIT_RETRIES_EXCEEDED,"Op submit failed. Exceeded max submit retries of "+this.maxRetries)}versionDuringTransformError(){return new a.OTError(u.ERR_OP_VERSION_MISMATCH_DURING_TRANSFORM,"Op submit failed. Versions mismatched during op transform")}newerVersionError(){return new a.OTError(u.ERR_OP_VERSION_NEWER_THAN_CURRENT_SNAPSHOT,"Invalid op submitted. Op version newer than current snapshot")}missingOpsError(){return new a.OTError(u.ERR_SUBMIT_TRANSFORM_OPS_NOT_FOUND,"Op submit failed. DB missing ops needed to transform it up to the current snapshot version")}versionAfterTransformError(){return new a.OTError(u.ERR_OP_VERSION_MISMATCH_AFTER_TRANSFORM,"Op submit failed. Op version mismatches snapshot after op transform")}}},769:function(t,e,s){var r=this&&this.__createBinding||(Object.create?function(t,e,s,r){void 0===r&&(r=s);var n=Object.getOwnPropertyDescriptor(e,s);n&&!("get"in n?!e.__esModule:n.writable||n.configurable)||(n={enumerable:!0,get:function(){return e[s]}}),Object.defineProperty(t,r,n)}:function(t,e,s,r){void 0===r&&(r=s),t[r]=e[s]}),n=this&&this.__setModuleDefault||(Object.create?function(t,e){Object.defineProperty(t,"default",{enumerable:!0,value:e})}:function(t,e){t.default=e}),i=this&&this.__importStar||function(t){if(t&&t.__esModule)return t;var e={};if(null!=t)for(var s in t)"default"!==s&&Object.prototype.hasOwnProperty.call(t,s)&&r(e,t,s);return n(e,t),e};Object.defineProperty(e,"__esModule",{value:!0}),e.SubmitSnapshotRequest=e.SubmitSnapshotTrigger=void 0;const o=s(127),a=s(660),c=s(36),_=i(s(155)),u=a.OTError.CODES;var p;!function(t){t.submitOp="submitOp",t.fetchSnapshot="fetchSnapshot",t.manual="manual"}(p||(e.SubmitSnapshotTrigger=p={})),e.SubmitSnapshotRequest=class{constructor(t,e,s,r){this.doc=t,this.context=r||{},this.id=e,this.document=s,this.fromVersion=s.snapshotVersion,this.toVersion=s.version,this.start=Date.now(),this.saveSnapshot=null,this.saveMilestoneSnapshot=null,this.maxRetries=t.maxSubmitRetries,this.retries=0,this.snapshot=null}async submitSnapshot(){const t=this,e=this.doc;if(await t._trigger("submitSnapshot"),!t._shouldSubmitSnapshot())return;const s=await e.db.getOps(t.id,t.fromVersion,t.toVersion);s&&s.length===t.toVersion-t.fromVersion&&(t.ops=s,await this.apply())}_addSnapshotMeta(){if(!this.snapshot)return;const t=this.snapshot;this.ops.forEach((e=>{const s=t.m||(t.m={});e.create&&(s.ctime=this.start),s.mtime=this.start}))}async apply(){const t=this,e=this.doc.db,s=this.id,r=this.ops,n=t.document,i=Date.now();t.snapshot={id:s,fromVersion:n.snapshotVersion,v:n.snapshotVersion,type:n.type},t._addSnapshotMeta(),await t._trigger("apply");const a=t.snapshot,u=new c.SnapshotFragmentsRequest(s,e),p=await _.applyOps(a,r,u);p?o.logger.error("submit.snapshot.apply",p):(a.fragmentsChanges=u.getChanges(),t.doc._emitTiming("submit.snapshot.apply",Date.now()-i,t),await this.commitSnapshot())}async commitSnapshot(){const t=this,e=this.doc;await t._trigger("commitSnapshot");const s=Date.now();if(!await e.db.commitSnapshot(t.id,t.snapshot,t.context.options))return this._retry();if(e._emitTiming("commit.snapshot",Date.now()-s,t),t._shouldSaveMilestoneSnapshot(t.snapshot)){const e=await t.doc.db.getSnapshot(t.id);(0,c.applyChangesToSnapshot)(e,t.snapshot.fragmentsChanges),t.doc.milestoneDb.saveMilestoneSnapshot(e)}}async _retry(){if(this.retries++,null!=this.maxRetries&&this.retries>this.maxRetries)throw this.maxRetriesError();const t=await this.doc.db.getDocument(this.id,this.context.options);if(t){if(t.snapshotVersion!==this.fromVersion){if(t.snapshotVersion>=this.toVersion)return;return this.document=t,this.fromVersion=t.snapshotVersion,this.doc._emitTiming("submit.snapshot.retry",Date.now()-this.start,this),await this.submitSnapshot()}return this.doc._emitTiming("submit.snapshot.retry",Date.now()-this.start,this),await this.submitSnapshot()}}_shouldSubmitSnapshot(){var t,e;const s=this.fromVersion,r=this.toVersion,n=null===(t=this.context)||void 0===t?void 0:t.trigger,i=null===(e=this.context)||void 0===e?void 0:e.op;return!(n!==p.submitOp||!i||!i.create&&!i.del)||n===p.fetchSnapshot||0===s||!(r<=s)&&(null===this.saveSnapshot?r-s>=this.doc.submitSnapshotBatchSize:this.saveSnapshot)}_shouldSaveMilestoneSnapshot(t){return null===this.saveMilestoneSnapshot?t&&t.v%this.doc.milestoneDb.interval==0:this.saveMilestoneSnapshot}async _trigger(t){const e=Object.assign(Object.assign({},this.context),{request:this});await this.doc.trigger(t,e),this.context.options=e.options}maxRetriesError(){return new a.OTError(u.ERR_MAX_SUBMIT_SNAPSHOT_RETRIES_EXCEEDED,"Snapshot submit failed. Exceeded max submit retries of "+this.maxRetries)}}},961:(t,e)=>{Object.defineProperty(e,"__esModule",{value:!0}),e.isNullOrUndefined=function(t){return null==t}},127:e=>{e.exports=t},872:(t,e)=>{var s;Object.defineProperty(e,"__esModule",{value:!0}),e.OTError=e.ERROR_CODES=void 0,function(t){t[t.ERR_APPLY_OP_VERSION_DOES_NOT_MATCH_SNAPSHOT=0]="ERR_APPLY_OP_VERSION_DOES_NOT_MATCH_SNAPSHOT",t[t.ERR_APPLY_SNAPSHOT_NOT_PROVIDED=1]="ERR_APPLY_SNAPSHOT_NOT_PROVIDED",t[t.ERR_CONNECTION_SEQ_INTEGER_OVERFLOW=2]="ERR_CONNECTION_SEQ_INTEGER_OVERFLOW",t[t.ERR_DOC_MISSING_VERSION=3]="ERR_DOC_MISSING_VERSION",t[t.ERR_DOC_ALREADY_CREATED=4]="ERR_DOC_ALREADY_CREATED",t[t.ERR_DOC_DOES_NOT_EXIST=5]="ERR_DOC_DOES_NOT_EXIST",t[t.ERR_DOC_TYPE_NOT_RECOGNIZED=6]="ERR_DOC_TYPE_NOT_RECOGNIZED",t[t.ERR_DOC_WAS_DELETED=7]="ERR_DOC_WAS_DELETED",t[t.ERR_INGESTED_SNAPSHOT_HAS_NO_VERSION=8]="ERR_INGESTED_SNAPSHOT_HAS_NO_VERSION",t[t.ERR_MAX_SUBMIT_RETRIES_EXCEEDED=9]="ERR_MAX_SUBMIT_RETRIES_EXCEEDED",t[t.ERR_MAX_SUBMIT_SNAPSHOT_RETRIES_EXCEEDED=10]="ERR_MAX_SUBMIT_SNAPSHOT_RETRIES_EXCEEDED",t[t.ERR_MESSAGE_BADLY_FORMED=11]="ERR_MESSAGE_BADLY_FORMED",t[t.ERR_MILESTONE_ARGUMENT_INVALID=12]="ERR_MILESTONE_ARGUMENT_INVALID",t[t.ERR_OP_ALREADY_SUBMITTED=13]="ERR_OP_ALREADY_SUBMITTED",t[t.ERR_OP_SUBMIT_REJECTED=14]="ERR_OP_SUBMIT_REJECTED",t[t.ERR_PENDING_OP_REMOVED_BY_OP_SUBMIT_REJECTED=15]="ERR_PENDING_OP_REMOVED_BY_OP_SUBMIT_REJECTED",t[t.ERR_HARD_ROLLBACK_FETCH_FAILED=16]="ERR_HARD_ROLLBACK_FETCH_FAILED",t[t.ERR_OP_VERSION_MISMATCH_AFTER_TRANSFORM=17]="ERR_OP_VERSION_MISMATCH_AFTER_TRANSFORM",t[t.ERR_OP_VERSION_MISMATCH_DURING_TRANSFORM=18]="ERR_OP_VERSION_MISMATCH_DURING_TRANSFORM",t[t.ERR_OP_VERSION_NEWER_THAN_CURRENT_SNAPSHOT=19]="ERR_OP_VERSION_NEWER_THAN_CURRENT_SNAPSHOT",t[t.ERR_OT_OP_BADLY_FORMED=20]="ERR_OT_OP_BADLY_FORMED",t[t.ERR_OT_OP_NOT_APPLIED=21]="ERR_OT_OP_NOT_APPLIED",t[t.ERR_OT_OP_NOT_PROVIDED=22]="ERR_OT_OP_NOT_PROVIDED",t[t.ERR_OT_OP_TRANSFORM_FAILED=23]="ERR_OT_OP_TRANSFORM_FAILED",t[t.ERR_SNAPSHOT_READ_SILENT_REJECTION=24]="ERR_SNAPSHOT_READ_SILENT_REJECTION",t[t.ERR_SNAPSHOT_READS_REJECTED=25]="ERR_SNAPSHOT_READS_REJECTED",t[t.ERR_SUBMIT_TRANSFORM_OPS_NOT_FOUND=26]="ERR_SUBMIT_TRANSFORM_OPS_NOT_FOUND",t[t.ERR_UNKNOWN_ERROR=27]="ERR_UNKNOWN_ERROR",t[t.ERR_INFLIGHT_OP_MISSING=28]="ERR_INFLIGHT_OP_MISSING"}(s||(e.ERROR_CODES=s={}));class r extends Error{constructor(t,e){super(e),this.code=t,this.name="OTError",this.code=t}}e.OTError=r,r.CODES=s},660:function(t,e,s){var r=this&&this.__createBinding||(Object.create?function(t,e,s,r){void 0===r&&(r=s);var n=Object.getOwnPropertyDescriptor(e,s);n&&!("get"in n?!e.__esModule:n.writable||n.configurable)||(n={enumerable:!0,get:function(){return e[s]}}),Object.defineProperty(t,r,n)}:function(t,e,s,r){void 0===r&&(r=s),t[r]=e[s]}),n=this&&this.__exportStar||function(t,e){for(var s in t)"default"===s||Object.prototype.hasOwnProperty.call(e,s)||r(e,t,s)};Object.defineProperty(e,"__esModule",{value:!0}),e.OT_DOC_MESSAGE_TYPE=void 0,n(s(872),e),n(s(549),e),n(s(712),e),n(s(802),e),e.OT_DOC_MESSAGE_TYPE="ot-doc"},549:(t,e)=>{var s;Object.defineProperty(e,"__esModule",{value:!0}),e.MessageActions=void 0,function(t){t.fetch="fetch",t.fetchOps="fetchOps",t.fetchHistorySnapshot="fetchHistorySnapshot",t.subscribe="subscribe",t.unsubscribe="unsubscribe",t.op="op"}(s||(e.MessageActions=s={}))},712:(t,e)=>{Object.defineProperty(e,"__esModule",{value:!0}),e.TypesManager=void 0;const s={uri:"default",create:()=>{throw new Error("Function not implemented.")},apply:()=>{throw new Error("Function not implemented.")},transform:()=>{throw new Error("Function not implemented.")}};class r{static get defaultType(){return s}static register(t){t.uri&&(r.map[t.uri]=t),t.name&&(r.map[t.name]=t)}static getType(t){return r.map[t]}}e.TypesManager=r,r.map={},r.register(s)},802:(t,e)=>{function s(t,e,s){let r=!1;return t.forEach((function(t){t&&(t(e,s),r=!0)})),r}function r(t){return t?JSON.parse(JSON.stringify(t)):t}Object.defineProperty(e,"__esModule",{value:!0}),e.util=e.nextTick=e.MAX_SAFE_INTEGER=void 0,e.callEach=s,e.clone=r,e.MAX_SAFE_INTEGER=9007199254740991,e.nextTick=function(t){if("undefined"!=typeof process&&process.nextTick)return process.nextTick(t);setTimeout((function(){t()}))},e.util={MAX_SAFE_INTEGER:e.MAX_SAFE_INTEGER,callEach:s,nextTick:e.nextTick,clone:r}}},s={};function r(t){var n=s[t];if(void 0!==n)return n.exports;var i=s[t]={exports:{}};return e[t].call(i.exports,i,i.exports,r),i.exports}var n={};return(()=>{var t=n;Object.defineProperty(t,"__esModule",{value:!0}),t.documentFeature=t.MemoryDb=t.Db=t.DocumentServices=t.TypesManager=void 0,r(259),r(36);const e=r(660);Object.defineProperty(t,"TypesManager",{enumerable:!0,get:function(){return e.TypesManager}});const s=r(89);Object.defineProperty(t,"DocumentServices",{enumerable:!0,get:function(){return s.DocumentServices}});const i=r(619);Object.defineProperty(t,"Db",{enumerable:!0,get:function(){return i.Db}});const o=r(985);Object.defineProperty(t,"MemoryDb",{enumerable:!0,get:function(){return o.MemoryDb}});const a=r(763);Object.defineProperty(t,"documentFeature",{enumerable:!0,get:function(){return a.documentFeature}})})(),n})()));
+!function(t,e){if("object"==typeof exports&&"object"==typeof module)module.exports=e(require("@grapecity-software/js-collaboration"));else if("function"==typeof define&&define.amd)define(["@grapecity-software/js-collaboration"],e);else{var s="object"==typeof exports?e(require("@grapecity-software/js-collaboration")):e(t["@grapecity-software/js-collaboration"]);for(var r in s)("object"==typeof exports?exports:t)[r]=s[r]}}(this,(t=>(()=>{"use strict";var e={619:(t,e)=>{Object.defineProperty(e,"__esModule",{value:!0}),e.Db=void 0,e.Db=class{async getCommittedOpVersion(t,e,s){const r=await this.getOps(t,0,e);for(let t=r.length;t--;){const e=r[t];if(s.src===e.src&&s.seq===e.seq)return e.v}}}},985:(t,e,s)=>{Object.defineProperty(e,"__esModule",{value:!0}),e.MemoryDb=void 0;const r=s(619);class n extends r.Db{constructor(t){var e;super(),this.ops=new Map,this.documents=new Map,this.fragments=new Map,this.mockWaitTime=null!==(e=null==t?void 0:t.mockWaitTime)&&void 0!==e?e:0}async getSnapshot(t){return this.execute((async()=>{const e=this.documents.get(t);if(!e)return;const s=await this.getFragments(t);return{id:t,v:e.snapshotVersion,type:e.type,fragments:s}}))}getDocument(t){return this.execute((()=>{const e=this.documents.get(t);if(e)return JSON.parse(JSON.stringify(e))}))}getFragments(t){return this.execute((()=>{const e=this.fragments.get(t);return e?JSON.parse(JSON.stringify(Object.fromEntries(e))):void 0}))}getFragment(t,e){return this.execute((()=>{var s;const r=null===(s=this.fragments.get(t))||void 0===s?void 0:s.get(e);if(r)return JSON.parse(JSON.stringify(r))}))}getOps(t,e,s){return this.execute((()=>{const r=this.ops.get(t);if(!r)return[];s=null!=s?s:Number.MAX_SAFE_INTEGER;const n=r.filter((t=>t.v>=e&&t.v<s));return JSON.parse(JSON.stringify(n))}))}commitOp(t,e,s){return this.execute((()=>{var r;if(e=JSON.parse(JSON.stringify(e)),s=JSON.parse(JSON.stringify(s)),e.create){if(this.documents.has(t))return!1;const{version:r,snapshotVersion:n,type:i}=s;return this.documents.set(t,{id:t,version:r,snapshotVersion:n,type:i}),this.ops.set(t,[e]),this.fragments.set(t,new Map),!0}if(e.del)return!!this.documents.has(t)&&(this.documents.delete(t),this.ops.delete(t),this.fragments.delete(t),!0);{const n=null===(r=this.ops.get(t))||void 0===r?void 0:r.length;return e.v===n&&(this.ops.get(t).push(e),this.documents.get(t).version=s.version,!0)}}))}commitSnapshot(t,e){return this.execute((()=>{var s,r,n;e=JSON.parse(JSON.stringify(e));const i=this.documents.get(t);if(e.fromVersion!==i.snapshotVersion)return!1;if(e.v<=i.snapshotVersion)return!1;i.snapshotVersion=e.v;const o=e.fragmentsChanges;if(o.deleteSnapshot)this.fragments.delete(t);else{const e=this.fragments.get(t);Object.entries(null!==(s=o.createFragments)&&void 0!==s?s:{}).forEach((async([t,s])=>{e.set(t,s)})),Object.entries(null!==(r=o.updateFragments)&&void 0!==r?r:{}).forEach((async([t,s])=>{e.set(t,s)})),null===(n=o.deleteFragments)||void 0===n||n.forEach((t=>{e.delete(t)}))}return!0}))}close(){return this.execute((()=>{}))}dump(){const t={ops:this.ops,documents:this.documents,fragments:this.fragments};return JSON.parse(JSON.stringify(t,((t,e)=>e instanceof Map?Object.fromEntries(e.entries()):e)))}_wait(){return new Promise((t=>setTimeout(t,this.mockWaitTime)))}async execute(t){return await this._wait(),await t()}}e.MemoryDb=n},347:(t,e,s)=>{Object.defineProperty(e,"__esModule",{value:!0}),e.DocumentController=void 0;const r=s(127),n=s(961),i=s(660),o=r.LoggerManager.createLogger("OT.Document"),a=i.MessageActions,c=i.OTError.CODES;function _(t){return{id:t.id,v:t.v,data:t.data,type:t.type}}e.DocumentController=class{constructor(t){this.service=t}async trigger(t,e,s){await this.service.trigger(t,e,s)}send(t,e){t.send(JSON.stringify(e),i.OT_DOC_MESSAGE_TYPE)}_sendOp(t,e){const s={a:a.op,v:e.v,src:e.src,seq:e.seq};"op"in e&&(s.op=e.op),e.create&&(s.create=e.create),e.del&&(s.del=!0),this.send(t,s)}_broadcastOp(t,e){const s={a:i.MessageActions.op,v:e.v,src:e.src,seq:e.seq};"op"in e&&(s.op=e.op),e.create&&(s.create=e.create),e.del&&(s.del=!0),t.broadcast(JSON.stringify(s),i.OT_DOC_MESSAGE_TYPE)}_sendOps(t,e){if(e&&!e.length)for(let s=0;s<e.length;s++)this._sendOp(t,e[s])}async _reply(t,e,s){s.a=e.a;const r={connection:t,request:e,reply:s};await this.trigger("reply",r,(s=>{s?this._replyError(t,e,s):this.send(t,r.reply)}))}async _replyError(t,e,s){e.error=function(t){return t instanceof i.OTError?{code:t.code,message:t.message}:t instanceof Error?{code:c.ERR_UNKNOWN_ERROR,message:t.message}:"string"==typeof t?{code:c.ERR_UNKNOWN_ERROR,message:t}:void o.warn("unknown error",t)}(s),this.send(t,e)}async _messageHandler(t,e){const s=this;if("string"!=typeof e)return void s.close(t,new i.OTError(c.ERR_MESSAGE_BADLY_FORMED,"Received non-object message"));let r;try{r=JSON.parse(e)}catch(e){return void s.close(t,new i.OTError(c.ERR_MESSAGE_BADLY_FORMED,"Received non-object message"))}await this.trigger("receive",{connection:t,request:r},(async e=>{e?await s._replyError(t,r,e):await s._handleMessage(t,r,((e,n)=>{e?s._replyError(t,r,e):s._reply(t,r,n||{})}))}))}_checkRequest(t){if(t.a===a.op&&!(0,n.isNullOrUndefined)(t.v)&&("number"!=typeof t.v||t.v<0))return"Invalid version"}async _handleMessage(t,e,s){const r=this._checkRequest(e);if(r)return s(new i.OTError(c.ERR_MESSAGE_BADLY_FORMED,r));switch(e.a){case a.fetch:return await this._fetch(t,e.v,s);case a.subscribe:return await this._subscribe(t,e.v,s);case a.unsubscribe:return this._unsubscribe();case a.op:return await this._submit(t,e,s);case a.fetchHistorySnapshot:return await this._fetchHistorySnapshot(t,e,s);default:return await s(new i.OTError(c.ERR_MESSAGE_BADLY_FORMED,"Invalid or unknown message"))}}async _fetch(t,e,s){if(!(0,n.isNullOrUndefined)(e))return await this._fetchOps(t,e,s);await this.service._fetch(t.roomId,{connection:t},((t,e)=>t?s(t):s(null,{data:_(e)})))}async _fetchOps(t,e,s){await this.service._getOps(t.roomId,e,void 0,{connection:t},((e,r)=>e?s(e):(this._sendOps(t,r),s())))}async _subscribe(t,e,s){const r=this;await this.service._subscribe(t.roomId,e,{connection:t},((e,n)=>{if(e)return s(e);const{ops:i,snapshot:o}=n;return i&&r._sendOps(t,i),o?s(null,{data:_(o)}):s()}))}_unsubscribe(){}async _submit(t,e,s){const r=function(t,e){const s=t.src||e;return t.op?function(t,e,s,r,n){return{src:t,seq:e,v:s,op:r,x:n,m:void 0}}(s,t.seq,t.v,t.op,t.x):t.create?function(t,e,s,r,n){return{src:t,seq:e,v:s,create:r,x:n,m:void 0}}(s,t.seq,t.v,t.create,t.x):t.del?function(t,e,s,r,n){return{src:t,seq:e,v:s,del:r,x:n,m:void 0}}(s,t.seq,t.v,t.del,t.x):void 0}(e,t.id);return r?r.seq>=i.util.MAX_SAFE_INTEGER?s(new i.OTError(c.ERR_CONNECTION_SEQ_INTEGER_OVERFLOW,"Connection seq has exceeded the max safe integer, maybe from being open for too long")):await this._submitOp(t,r,s):s(new i.OTError(c.ERR_MESSAGE_BADLY_FORMED,"Invalid op message"))}async _submitOp(t,e,s){const r=this;await this.service._submit(t.roomId,e,{connection:t},(e=>{r._broadcastOp(t,e.op)}),((n,o)=>{const a={src:e.src,seq:e.seq,v:e.v};return n?n instanceof i.OTError&&n.code==c.ERR_OP_ALREADY_SUBMITTED?s(null,a):s(n):(r._sendOps(t,o),s(null,a))}))}async _fetchHistorySnapshot(t,e,s){if(void 0===e.v)return s(new i.OTError(c.ERR_MESSAGE_BADLY_FORMED,"Invalid fetch history snapshot message"));await this.service._fetchHistorySnapshot(t.roomId,e.v,{connection:t},((t,r)=>t?s(t):s(null,{id:e.id,data:r})))}close(t,e){e&&o.warn("Connection closed due to error",t.id,e.stack||e),t.close()}}},763:(t,e,s)=>{Object.defineProperty(e,"__esModule",{value:!0}),e.documentFeature=function(t){const e=t||new r.DocumentServices,s=new n.DocumentController(e);return{middlewares:{message:async(t,e)=>t.type!==i.OT_DOC_MESSAGE_TYPE?await e():s._messageHandler(t.connection,t.data)}}};const r=s(89),n=s(347),i=s(660)},89:(t,e,s)=>{Object.defineProperty(e,"__esModule",{value:!0}),e.DocumentServices=void 0;const r=s(660),n=s(127),i=s(961),o=s(985),a=s(259),c=s(551),_=s(155),u=s(936),p=s(469),h=s(36),O=s(769),d=r.OTError.CODES;class E extends n.Middleware{constructor(t){var e,s,r;super(),t=null!=t?t:{},this.db=null!==(e=t.db)&&void 0!==e?e:new o.MemoryDb,this.milestoneDb=null!==(s=t.milestoneDb)&&void 0!==s?s:new u.MilestoneDB,this.maxSubmitRetries=t.maxSubmitRetries,this.submitSnapshotBatchSize=null!==(r=t.submitSnapshotBatchSize)&&void 0!==r?r:10}async fetch(t,e){let s;const r=await this._fetch(t,e||{},(t=>{s=t}));if(s)throw s;return r}async _fetch(t,e,s){const r=Date.now(),n=this;try{const i=await n._getSnapshot(t,e);return await n._sanitizeSnapshots([i],a.SnapshotTypes.current,e,(async o=>o?s(o):(await n._emitTiming("fetch",Date.now()-r,Object.assign(Object.assign({},e),{id:t})),s(null,i)))),i}catch(t){await s(t)}}async getOps(t,e,s,r){let n;const i=await this._getOps(t,e,s,r||{},(t=>{n=t}));if(n)throw n;return i}async _getOps(t,e,s,r,n){const i=this,o=Date.now();return await i._getSanitizedOps(t,e,s,r||{},(async(a,c)=>a?n(a):(await i._emitTiming("getOps",Date.now()-o,Object.assign(Object.assign({},r),{id:t,from:e,to:s})),n(null,c))))}async _subscribe(t,e,s,r){const n=this,o=Date.now();(0,i.isNullOrUndefined)(e)?await n._fetch(t,s,(async(i,a)=>i?r(i):(await n._emitTiming("subscribe.snapshot",Date.now()-o,Object.assign(Object.assign({},s),{id:t,version:e})),r(null,{snapshot:a})))):await n._getSanitizedOps(t,e,void 0,s,(async(i,a)=>i?r(i):(await n._emitTiming("subscribe.ops",Date.now()-o,Object.assign(Object.assign({},s),{id:t,version:e})),r(null,{ops:a}))))}async submit(t,e,s,r){let n;const i=await this._submit(t,e,s||{},r||(()=>{}),(t=>{n=t}));if(n)throw n;return i}async _submit(t,e,s,r,n){const i=this,o=new c.SubmitRequest(this,t,e,s),a=Object.assign(Object.assign({},s),{request:o}),u=(t,e)=>(i.emit("submitRequestEnd",{request:o,err:t}),n(t,e)),p=_.ot.checkOp(e);return p?(u(p),[]):(await i.trigger("submit",a,(async e=>{if(e)return u(e);await o.submit(r,(async e=>{if(e)return u(e);await i._sanitizeOps(t,o.ops,a,(async t=>t?u(t):(i._emitTiming("submit.op.total",Date.now()-o.start,o),u(null,o.ops))))}))})),o.ops)}async fetchHistorySnapshotByTimestamp(t,e,s){const r=Date.now(),n=await this._fetchHistorySnapshotByTimestamp(t,e),i=[n],o=a.SnapshotTypes.byTimestamp;return await this._sanitizeSnapshots(i,o,s||{},(()=>{})),this._emitTiming("fetchSnapshot",Date.now()-r,Object.assign({},s)),n}async _fetchHistorySnapshotByTimestamp(t,e){const s=this.db,r=this.milestoneDb;let n,i=0;if(void 0===e)return await this._getSnapshot(t);let o=await r.getMilestoneSnapshotAtOrBeforeTime(t,e);const a=o;o&&(i=o.v),o=await r.getMilestoneSnapshotAtOrAfterTime(t,e),o&&(n=o.v);const c=await s.getOps(t,i,n,{metadata:!0});return function(t,e){for(let s=0;s<t.length;s++){const r=t[s];if((r.m&&r.m.ts)>e)return void(t.length=s)}}(c,e),o=await this._buildSnapshotFromOps(t,a,c),o}async fetchHistorySnapshot(t,e,s){let r;const n=await this._fetchHistorySnapshot(t,e,s||{},(t=>{r=t}));if(r)throw r;return n}async _fetchHistorySnapshot(t,e,s,r){try{const n=Date.now(),i=await this._fetchHistorySnapshotImp(t,e),o=a.SnapshotTypes.byVersion;return await this._sanitizeSnapshots([i],o,s,(async t=>t?r(t):(await this._emitTiming("fetchSnapshot",Date.now()-n,Object.assign(Object.assign({},s),{version:e})),r(null,i)))),i}catch(t){await r(t)}}async _fetchHistorySnapshotImp(t,e){const s=this.db;if(void 0===e)return await this._getSnapshot(t);const n=await this.milestoneDb.getMilestoneSnapshot(t,e),i=n?n.v:0,o=await s.getOps(t,i,e),a=await this._buildSnapshotFromOps(t,n,o);if(e>a.v)throw new r.OTError(d.ERR_OP_VERSION_NEWER_THAN_CURRENT_SNAPSHOT,"Requested version exceeds latest snapshot version");return a}async _buildSnapshotFromOps(t,e,s){const r=null!=e?e:{id:t,v:0},n=new h.SnapshotFragmentsRequest(t,void 0,r.fragments),i=await _.ot.applyOps(r,s,n);if(i)throw i;return n.applyChangesToSnapshot(r),_.ot.composeFragments(r),r}async _sanitizeSnapshots(t,e,s,r){const n=new p.ReadSnapshotsRequest(t,e);await this.trigger("readSnapshots",Object.assign(Object.assign({},s),{request:n}),(t=>t?r(t):n.hasSnapshotRejection()?r(n.getReadSnapshotsError()):r()))}async _getSanitizedOps(t,e,s,r,n){const i=await this.db.getOps(t,e,s,null==r?void 0:r.options);return await this._sanitizeOps(t,i,r,(t=>t?n(t):n(null,i))),i}async _sanitizeOps(t,e,s,r){for(const n of e){let e;if(await this._sanitizeOp(t,n,s,(t=>{e=t})),e)return r(e)}return r()}async _sanitizeOp(t,e,s,r){await this.trigger("readOp",Object.assign(Object.assign({},s),{id:t,op:e}),r)}async _getSnapshot(t,e){var s;const r=null==e?void 0:e.options,n=await this.db.getDocument(t,r);if(!n)return{id:t,v:0};if(n.snapshotVersion<n.version){const s=new O.SubmitSnapshotRequest(this,t,n,Object.assign(Object.assign({},e),{trigger:O.SubmitSnapshotTrigger.fetchSnapshot}));await s.submitSnapshot((t=>{if(t)throw t}))}const i=null!==(s=await this.db.getSnapshot(t,r))&&void 0!==s?s:{id:t,v:0};return _.ot.composeFragments(i),i}_emitTiming(t,e,s){return this.emit("timing",{action:t,cost:e,m:s})}}e.DocumentServices=E},259:(t,e)=>{Object.defineProperty(e,"__esModule",{value:!0}),e.Hooks=e.SnapshotTypes=void 0,e.SnapshotTypes={current:"current",byVersion:"byVersion",byTimestamp:"byTimestamp"},e.Hooks={submitRequestEnd:"submitRequestEnd",timing:"timing"}},936:(t,e,s)=>{Object.defineProperty(e,"__esModule",{value:!0}),e.MilestoneDB=void 0;const r=s(660),n=s(961),i=r.OTError.CODES;e.MilestoneDB=class{constructor(t){var e;this.interval=null!==(e=null==t?void 0:t.interval)&&void 0!==e?e:1e3,this.map=new Map}saveMilestoneSnapshot(t){return new Promise((e=>{let s=this.map.get(t.id);s||(s=[],this.map.set(t.id,s)),s.push(t),s.sort(((t,e)=>t.v-e.v)),e(!0)}))}getMilestoneSnapshot(t,e){const s=function(t){return function(e,s){return!(0,n.isNullOrUndefined)(t)&&s.v>t}}(e);return this._findMilestoneSnapshot(t,s)}getMilestoneSnapshotAtOrBeforeTime(t,e){const s=function(t){return function(e,s){if((0,n.isNullOrUndefined)(t))return!!e;const r=s&&s.m&&s.m.mtime;return void 0!==r&&r>t}}(e);return this._findMilestoneSnapshot(t,s)}getMilestoneSnapshotAtOrAfterTime(t,e){const s=function(t){return function(e){if((0,n.isNullOrUndefined)(t))return!1;const s=e&&e.m&&e.m.mtime;return void 0!==s&&s>=t}}(e);return this._findMilestoneSnapshot(t,s)}_findMilestoneSnapshot(t,e){return new Promise((s=>{if(!t)throw new r.OTError(i.ERR_MILESTONE_ARGUMENT_INVALID,"Missing ID");const n=this._getMilestoneSnapshots(t);let o;for(let t=0;t<n.length;t++){const s=n[t];if(e(o,s))break;o=s}s(o)}))}_getMilestoneSnapshots(t){var e;return null!==(e=this.map.get(t))&&void 0!==e?e:[]}}},155:(t,e,s)=>{Object.defineProperty(e,"__esModule",{value:!0}),e.ot=e.composeFragments=e.applyOps=e.transform=e.apply=e.normalizeType=e.checkOp=void 0;const r=s(513),n=s(961),i=s(660),o=i.OTError.CODES,a="default";e.checkOp=function(t){if((0,n.isNullOrUndefined)(t)||"object"!=typeof t)return new i.OTError(o.ERR_OT_OP_BADLY_FORMED,"Op must be an object");if((0,n.isNullOrUndefined)(t.create)){if((0,n.isNullOrUndefined)(t.del)){if(!("op"in t))return new i.OTError(o.ERR_OT_OP_BADLY_FORMED,"Missing op, create, or del")}else if(!0!==t.del)return new i.OTError(o.ERR_OT_OP_BADLY_FORMED,"del value must be true")}else{if("object"!=typeof t.create)return new i.OTError(o.ERR_OT_OP_BADLY_FORMED,"Create data must be an object");const e=t.create.type;if("string"!=typeof e)return new i.OTError(o.ERR_OT_OP_BADLY_FORMED,"Missing create type");const s=r.TypesManager.map[e];if((0,n.isNullOrUndefined)(s)||"object"!=typeof s)return new i.OTError(o.ERR_DOC_TYPE_NOT_RECOGNIZED,"Unknown type")}return(0,n.isNullOrUndefined)(t.src)||"string"==typeof t.src?(0,n.isNullOrUndefined)(t.seq)||"number"==typeof t.seq?(0,n.isNullOrUndefined)(t.src)&&!(0,n.isNullOrUndefined)(t.seq)||!(0,n.isNullOrUndefined)(t.src)&&(0,n.isNullOrUndefined)(t.seq)?new i.OTError(o.ERR_OT_OP_BADLY_FORMED,"Both src and seq must be set together"):(0,n.isNullOrUndefined)(t.m)||"object"==typeof t.m?void 0:new i.OTError(o.ERR_OT_OP_BADLY_FORMED,"op.m must be an object or null"):new i.OTError(o.ERR_OT_OP_BADLY_FORMED,"seq must be a number"):new i.OTError(o.ERR_OT_OP_BADLY_FORMED,"src must be a string")},e.normalizeType=function(t){return r.TypesManager.map[t]&&r.TypesManager.map[t].uri},e.apply=async function(t,e,s){if("object"!=typeof t)return new i.OTError(o.ERR_APPLY_SNAPSHOT_NOT_PROVIDED,"Missing snapshot");if(!(0,n.isNullOrUndefined)(t.v)&&!(0,n.isNullOrUndefined)(e.v)&&t.v!==e.v)return new i.OTError(o.ERR_APPLY_OP_VERSION_DOES_NOT_MATCH_SNAPSHOT,"Version mismatch");if(e.create){const n=e.create,c=r.TypesManager.map[n.type];if(!c)return new i.OTError(o.ERR_DOC_TYPE_NOT_RECOGNIZED,"Unknown type");try{let e;e=c.createFragments?c.createFragments(n.data):{[a]:c.create(n.data)},s.create(e),t.type=c.uri,t.v++}catch(t){return t}}else if(e.del)s.delete(),t.data=void 0,t.type=void 0,t.v++;else if("op"in e){const n=await async function(t,e,s){if(!t.type)return new i.OTError(o.ERR_DOC_DOES_NOT_EXIST,"Document does not exist");if(void 0===e)return new i.OTError(o.ERR_OT_OP_NOT_PROVIDED,"Missing op");const n=r.TypesManager.map[t.type];if(!n)return new i.OTError(o.ERR_DOC_TYPE_NOT_RECOGNIZED,"Unknown type");try{if(n.applyFragments)await n.applyFragments(s,e);else{const t=await s.getFragment(a),r=n.apply(t,e);s.updateFragment(a,r)}}catch(t){return new i.OTError(o.ERR_OT_OP_NOT_APPLIED,t.message)}}(t,e.op,s);if(n)return n;t.v++}else t.v++},e.transform=function(t,e,s){if(!(0,n.isNullOrUndefined)(e.v)&&e.v!==s.v)return new i.OTError(o.ERR_OP_VERSION_MISMATCH_DURING_TRANSFORM,"Version mismatch");if(s.del){if(e.create||"op"in e)return new i.OTError(o.ERR_DOC_WAS_DELETED,"Document was deleted")}else{if(s.create&&("op"in e||e.create||e.del)||"op"in s&&e.create)return new i.OTError(o.ERR_DOC_ALREADY_CREATED,"Document was created remotely");if("op"in s&&"op"in e){if(!t)return new i.OTError(o.ERR_DOC_DOES_NOT_EXIST,"Document does not exist");if("string"==typeof t&&!(t=r.TypesManager.map[t]))return new i.OTError(o.ERR_DOC_TYPE_NOT_RECOGNIZED,"Unknown type");try{e.op=t.transform(e.op,s.op,"left")}catch(t){return new i.OTError(o.ERR_OT_OP_TRANSFORM_FAILED,"Op transform failed")}}}(0,n.isNullOrUndefined)(e.v)||e.v++},e.applyOps=async function(t,s,r){for(let n=0;n<s.length;n++){const i=s[n];t.v=i.v;const o=await(0,e.apply)(t,i,r);if(o)return o}},e.composeFragments=function(t){if(!t.type)return;const e=r.TypesManager.map[t.type];e&&t.fragments&&(e.composeFragments?t.data=e.composeFragments(t.fragments):t.data=t.fragments[a])},e.ot={checkOp:e.checkOp,normalizeType:e.normalizeType,apply:e.apply,transform:e.transform,applyOps:e.applyOps,composeFragments:e.composeFragments}},469:(t,e,s)=>{Object.defineProperty(e,"__esModule",{value:!0}),e.ReadSnapshotsRequest=void 0;const r=s(660),n=s(961);e.ReadSnapshotsRequest=class{constructor(t,e){this._idToError=null,this.snapshots=t,this.snapshotType=e}rejectSnapshotRead(t,e){this._idToError||(this._idToError=Object.create(null)),this._idToError[t.id]=e}rejectSnapshotReadSilent(t,e){this.rejectSnapshotRead(t,this.silentRejectionError(e))}silentRejectionError(t){return new r.OTError(r.OTError.CODES.ERR_SNAPSHOT_READ_SILENT_REJECTION,t)}hasSnapshotRejection(){return!(0,n.isNullOrUndefined)(this._idToError)}getReadSnapshotsError(){const t=this.snapshots,e=this._idToError;if(0===t.length)return;if(1===t.length){return e[t[0].id]||void 0}const s=new r.OTError(r.OTError.CODES.ERR_SNAPSHOT_READS_REJECTED);return s.idToError=e,s}}},36:(t,e)=>{function s(t,e){var s,r,n;const i=null!==(s=t.fragments)&&void 0!==s?s:{};if(e.deleteSnapshot)t.fragments={};else{for(const[t,s]of Object.entries(null!==(r=e.createFragments)&&void 0!==r?r:{}))i[t]=s;for(const[t,s]of Object.entries(null!==(n=e.updateFragments)&&void 0!==n?n:{}))i[t]=s;e.deleteFragments&&e.deleteFragments.length>0&&e.deleteFragments.forEach((t=>delete i[t])),t.fragments=i}}Object.defineProperty(e,"__esModule",{value:!0}),e.SnapshotFragmentsRequest=void 0,e.applyChangesToSnapshot=s,e.SnapshotFragmentsRequest=class{constructor(t,e,s){this._fragmentsMap=new Map,this._createFragments=new Map,this._updateFragments=new Map,this._deleteFragments=new Set,this._deleteSnapshot=!1,this._docId=t,this._db=e,s&&Object.entries(s).forEach((([t,e])=>{this._fragmentsMap.set(t,e)}))}async _loadFragment(t){const e=await this._db.getFragment(this._docId,t);this._fragmentsMap.set(t,e)}async getFragment(t){return this._db&&!this._fragmentsMap.has(t)&&await this._loadFragment(t),this._fragmentsMap.get(t)}createFragment(t,e){this._deleteFragments.has(t)?(this._deleteFragments.delete(t),this._updateFragments.set(t,e)):this._createFragments.set(t,e),this._fragmentsMap.set(t,e)}updateFragment(t,e){this._deleteFragments.has(t)||(this._createFragments.has(t)?this._createFragments.set(t,e):this._updateFragments.set(t,e),this._fragmentsMap.set(t,e))}deleteFragment(t){this._deleteFragments.add(t),this._createFragments.delete(t),this._updateFragments.delete(t),this._fragmentsMap.set(t,void 0)}create(t){Object.entries(t).forEach((([t,e])=>{this.createFragment(t,e)}))}delete(){this._deleteSnapshot=!0,this._createFragments.clear(),this._updateFragments.clear(),this._deleteFragments.clear(),this._fragmentsMap.clear()}getChanges(){return{createFragments:Object.fromEntries(this._createFragments.entries()),updateFragments:Object.fromEntries(this._updateFragments.entries()),deleteFragments:Array.from(this._deleteFragments),deleteSnapshot:this._deleteSnapshot}}applyChangesToSnapshot(t){s(t,this.getChanges())}}},551:function(t,e,s){var r=this&&this.__createBinding||(Object.create?function(t,e,s,r){void 0===r&&(r=s);var n=Object.getOwnPropertyDescriptor(e,s);n&&!("get"in n?!e.__esModule:n.writable||n.configurable)||(n={enumerable:!0,get:function(){return e[s]}}),Object.defineProperty(t,r,n)}:function(t,e,s,r){void 0===r&&(r=s),t[r]=e[s]}),n=this&&this.__setModuleDefault||(Object.create?function(t,e){Object.defineProperty(t,"default",{enumerable:!0,value:e})}:function(t,e){t.default=e}),i=this&&this.__importStar||function(t){if(t&&t.__esModule)return t;var e={};if(null!=t)for(var s in t)"default"!==s&&Object.prototype.hasOwnProperty.call(t,s)&&r(e,t,s);return n(e,t),e};Object.defineProperty(e,"__esModule",{value:!0}),e.SubmitRequest=void 0;const o=s(961),a=s(660),c=i(s(155)),_=s(769),u=s(513),p=a.OTError.CODES,h=u.TypesManager.getType;e.SubmitRequest=class{constructor(t,e,s,r){this.doc=t,this.context=r||{},this.id=e,this.op=s,this.extra=s.x,delete s.x,this.start=Date.now(),this._addOpMeta(),this.maxRetries=t.maxSubmitRetries,this.retries=0,this.ops=[]}async submit(t,e){var s;const r=this,n=this.doc.db,i=this.id,a=this.op,c=Date.now(),_=null!==(s=await n.getDocument(i))&&void 0!==s?s:{id:i,version:0,snapshotVersion:0};r.document=_,await r.doc._emitTiming("submit.op.db.getDocumentInfo",Date.now()-c,r);const u=_.version;if((0,o.isNullOrUndefined)(a.v)){if(a.create&&_.type&&a.src){const t=await n.getCommittedOpVersion(i,u,a);return(0,o.isNullOrUndefined)(t)?e(r.alreadyCreatedError()):(a.v=t,e(r.alreadySubmittedError()))}a.v=u}if(a.v>u)return e(r.newerVersionError());if(a.v<u){const t=Date.now(),s=a.v,o=await n.getOps(i,s,u);if(r.doc._emitTiming("submit.op.db.getOpsForTransform",Date.now()-t,r),!o||o.length!==u-s)return e(r.missingOpsError());const c=Date.now(),_=r._transformOp(o);if(_)return e(_);if(await r.doc._emitTiming("submit.op.transform",Date.now()-c,r),a.v!==u)return e(r.versionAfterTransformError())}if(a.create&&_.type)return e(r.alreadyCreatedError());r._updateDocument(),await r.commitOp(t,e)}_addOpMeta(){this.op.m={ts:this.start},this.op.create&&(this.op.create.type=c.normalizeType(this.op.create.type))}_updateDocument(){if(!this.document)return;const t=this.document,e=this.op;e.create?(t.type=c.normalizeType(e.create.type),t.snapshotVersion=0):e.del&&(t.type=void 0),t.version++,this._updateDocumentMeta()}_updateDocumentMeta(){const t=this.document.m||(this.document.m={});this.op.create&&(t.ctime=this.start),t.mtime=this.start}_transformOp(t){const e=h(this.document.type);for(let s=0;s<t.length;s++){const r=t[s];if(this.op.src&&this.op.src===r.src&&this.op.seq===r.seq)return this.alreadySubmittedError();if(this.op.v!==r.v)return this.versionDuringTransformError();const n=c.transform(e,this.op,r);if(n)return n;delete r.m,this.ops.push(r)}}async commitOp(t,e){const s=this,r=this.doc;await s._trigger("commit",(async n=>{if(n)return e(n);const i=Date.now();if(!await r.db.commitOp(s.id,s.op,s.document,s.options))return await s._retry(t,e);s.op.m=void 0,await r._emitTiming("submit.op.db.commit",Date.now()-i,s),t(s),await s._trigger("afterWrite",(async t=>{if(t)return e(t);const n=new _.SubmitSnapshotRequest(r,s.id,s.document,Object.assign(Object.assign({},s.context),{trigger:_.SubmitSnapshotTrigger.submitOp,op:s.op}));await n.submitSnapshot(e)}))}))}async _retry(t,e){if(this.retries++,null!=this.maxRetries&&this.retries>this.maxRetries)return e(this.maxRetriesError());await this.doc._emitTiming("submit.op.retry",Date.now()-this.start,this),await this.submit(t,e)}async _trigger(t,e){const s=Object.assign(Object.assign({},this.context),{request:this});await this.doc.trigger(t,s,e),this.context.options=s.options}alreadyCreatedError(){return new a.OTError(p.ERR_DOC_ALREADY_CREATED,"Invalid op submitted. Document already created")}rejectedError(){return new a.OTError(p.ERR_OP_SUBMIT_REJECTED,"Op submit rejected")}alreadySubmittedError(){return new a.OTError(p.ERR_OP_ALREADY_SUBMITTED,"Op already submitted")}maxRetriesError(){return new a.OTError(p.ERR_MAX_SUBMIT_RETRIES_EXCEEDED,"Op submit failed. Exceeded max submit retries of "+this.maxRetries)}versionDuringTransformError(){return new a.OTError(p.ERR_OP_VERSION_MISMATCH_DURING_TRANSFORM,"Op submit failed. Versions mismatched during op transform")}newerVersionError(){return new a.OTError(p.ERR_OP_VERSION_NEWER_THAN_CURRENT_SNAPSHOT,"Invalid op submitted. Op version newer than current snapshot")}missingOpsError(){return new a.OTError(p.ERR_SUBMIT_TRANSFORM_OPS_NOT_FOUND,"Op submit failed. DB missing ops needed to transform it up to the current snapshot version")}versionAfterTransformError(){return new a.OTError(p.ERR_OP_VERSION_MISMATCH_AFTER_TRANSFORM,"Op submit failed. Op version mismatches snapshot after op transform")}}},769:function(t,e,s){var r=this&&this.__createBinding||(Object.create?function(t,e,s,r){void 0===r&&(r=s);var n=Object.getOwnPropertyDescriptor(e,s);n&&!("get"in n?!e.__esModule:n.writable||n.configurable)||(n={enumerable:!0,get:function(){return e[s]}}),Object.defineProperty(t,r,n)}:function(t,e,s,r){void 0===r&&(r=s),t[r]=e[s]}),n=this&&this.__setModuleDefault||(Object.create?function(t,e){Object.defineProperty(t,"default",{enumerable:!0,value:e})}:function(t,e){t.default=e}),i=this&&this.__importStar||function(t){if(t&&t.__esModule)return t;var e={};if(null!=t)for(var s in t)"default"!==s&&Object.prototype.hasOwnProperty.call(t,s)&&r(e,t,s);return n(e,t),e};Object.defineProperty(e,"__esModule",{value:!0}),e.SubmitSnapshotRequest=e.SubmitSnapshotTrigger=void 0;const o=s(127),a=s(660),c=s(36),_=i(s(155)),u=a.OTError.CODES,p=o.LoggerManager.createLogger("OT.Document");var h;!function(t){t.submitOp="submitOp",t.fetchSnapshot="fetchSnapshot",t.manual="manual"}(h||(e.SubmitSnapshotTrigger=h={})),e.SubmitSnapshotRequest=class{constructor(t,e,s,r){this.doc=t,this.context=r||{},this.id=e,this.document=s,this.fromVersion=s.snapshotVersion,this.toVersion=s.version,this.start=Date.now(),this.saveSnapshot=null,this.saveMilestoneSnapshot=null,this.maxRetries=t.maxSubmitRetries,this.retries=0,this.snapshot=null}async submitSnapshot(t){const e=this,s=this.doc;await e._trigger("submitSnapshot",(async r=>{if(r)return t(r);if(!e._shouldSubmitSnapshot())return t();const n=Date.now(),i=await s.db.getOps(e.id,e.fromVersion,e.toVersion);if(await e.doc._emitTiming("submit.snapshot.db.getOpsForApply",Date.now()-n,e),!i||i.length!==e.toVersion-e.fromVersion)return p.error("submit.snapshot.missingApplyOps",{id:e.id,fromVersion:e.fromVersion,toVersion:e.toVersion}),t();e.ops=i,await this.apply((async e=>{if(e)return t(e);await this.commitSnapshot(t)}))}))}_addSnapshotMeta(){if(!this.snapshot)return;const t=this.snapshot;this.ops.forEach((e=>{const s=t.m||(t.m={});e.create&&(s.ctime=this.start),s.mtime=this.start}))}async apply(t){const e=this,s=this.doc.db,r=this.id,n=this.ops,i=e.document,o=Date.now();e.snapshot={id:r,fromVersion:i.snapshotVersion,v:i.snapshotVersion,type:i.type},e._addSnapshotMeta(),await e._trigger("apply",(async i=>{if(i)return t(i);const a=e.snapshot,u=new c.SnapshotFragmentsRequest(r,s),h=await _.applyOps(a,n,u);return h?(p.error("submit.snapshot.apply",h),t(h)):(a.fragmentsChanges=u.getChanges(),e.doc._emitTiming("submit.snapshot.apply",Date.now()-o,e),t())}))}async commitSnapshot(t){const e=this,s=this.doc;await e._trigger("commitSnapshot",(async r=>{if(r)return t(r);const n=Date.now();if(!await s.db.commitSnapshot(e.id,e.snapshot,e.context.options))return await this._retry(t);if(await s._emitTiming("submit.snapshot.db.commit",Date.now()-n,e),e._shouldSaveMilestoneSnapshot(e.snapshot)){const t=await e.doc.db.getSnapshot(e.id);(0,c.applyChangesToSnapshot)(t,e.snapshot.fragmentsChanges),await e.doc.milestoneDb.saveMilestoneSnapshot(t)}return t()}))}async _retry(t){if(this.retries++,null!=this.maxRetries&&this.retries>this.maxRetries)return t(this.maxRetriesError());const e=Date.now(),s=await this.doc.db.getDocument(this.id,this.context.options);return this.doc._emitTiming("submit.snapshot.retry.db.getDocumentInfo",Date.now()-e,this),s?s.snapshotVersion!==this.fromVersion?s.snapshotVersion>=this.toVersion?t():(this.document=s,this.fromVersion=s.snapshotVersion,await this.doc._emitTiming("submit.snapshot.retry",Date.now()-this.start,this),await this.submitSnapshot(t)):(await this.doc._emitTiming("submit.snapshot.retry",Date.now()-this.start,this),await this.submitSnapshot(t)):t()}_shouldSubmitSnapshot(){var t,e;const s=this.fromVersion,r=this.toVersion,n=null===(t=this.context)||void 0===t?void 0:t.trigger,i=null===(e=this.context)||void 0===e?void 0:e.op;return!(n!==h.submitOp||!i||!i.create&&!i.del)||n===h.fetchSnapshot||0===s||!(r<=s)&&(null===this.saveSnapshot?r-s>=this.doc.submitSnapshotBatchSize:this.saveSnapshot)}_shouldSaveMilestoneSnapshot(t){return null===this.saveMilestoneSnapshot?t&&t.v%this.doc.milestoneDb.interval==0:this.saveMilestoneSnapshot}async _trigger(t,e){const s=Object.assign(Object.assign({},this.context),{request:this});await this.doc.trigger(t,s,e),this.context.options=s.options}maxRetriesError(){return new a.OTError(u.ERR_MAX_SUBMIT_SNAPSHOT_RETRIES_EXCEEDED,"Snapshot submit failed. Exceeded max submit retries of "+this.maxRetries)}}},513:(t,e)=>{Object.defineProperty(e,"__esModule",{value:!0}),e.TypesManager=void 0;const s={uri:"default",create:()=>{throw new Error("Function not implemented.")},apply:()=>{throw new Error("Function not implemented.")},transform:()=>{throw new Error("Function not implemented.")}};class r{static get defaultType(){return s}static register(t){t.uri&&(r.map[t.uri]=t),t.name&&(r.map[t.name]=t)}static getType(t){return r.map[t]}}e.TypesManager=r,r.map={},r.register(s)},961:(t,e)=>{Object.defineProperty(e,"__esModule",{value:!0}),e.isNullOrUndefined=function(t){return null==t}},127:e=>{e.exports=t},872:(t,e)=>{var s;Object.defineProperty(e,"__esModule",{value:!0}),e.OTError=e.ERROR_CODES=void 0,function(t){t[t.ERR_DOC_ALREADY_CREATED=0]="ERR_DOC_ALREADY_CREATED",t[t.ERR_DOC_DOES_NOT_EXIST=1]="ERR_DOC_DOES_NOT_EXIST",t[t.ERR_DOC_TYPE_NOT_RECOGNIZED=2]="ERR_DOC_TYPE_NOT_RECOGNIZED",t[t.ERR_DOC_WAS_DELETED=3]="ERR_DOC_WAS_DELETED",t[t.ERR_MAX_SUBMIT_RETRIES_EXCEEDED=4]="ERR_MAX_SUBMIT_RETRIES_EXCEEDED",t[t.ERR_MAX_SUBMIT_SNAPSHOT_RETRIES_EXCEEDED=5]="ERR_MAX_SUBMIT_SNAPSHOT_RETRIES_EXCEEDED",t[t.ERR_MESSAGE_BADLY_FORMED=6]="ERR_MESSAGE_BADLY_FORMED",t[t.ERR_OP_ALREADY_SUBMITTED=7]="ERR_OP_ALREADY_SUBMITTED",t[t.ERR_HARD_ROLLBACK_FETCH_FAILED=8]="ERR_HARD_ROLLBACK_FETCH_FAILED",t[t.ERR_OT_OP_NOT_APPLIED=9]="ERR_OT_OP_NOT_APPLIED",t[t.ERR_OT_OP_TRANSFORM_FAILED=10]="ERR_OT_OP_TRANSFORM_FAILED",t[t.ERR_SNAPSHOT_READS_REJECTED=11]="ERR_SNAPSHOT_READS_REJECTED",t[t.ERR_SUBMIT_TRANSFORM_OPS_NOT_FOUND=12]="ERR_SUBMIT_TRANSFORM_OPS_NOT_FOUND",t[t.ERR_UNKNOWN_ERROR=13]="ERR_UNKNOWN_ERROR",t[t.ERR_APPLY_OP_VERSION_DOES_NOT_MATCH_SNAPSHOT=14]="ERR_APPLY_OP_VERSION_DOES_NOT_MATCH_SNAPSHOT",t[t.ERR_APPLY_SNAPSHOT_NOT_PROVIDED=15]="ERR_APPLY_SNAPSHOT_NOT_PROVIDED",t[t.ERR_CONNECTION_SEQ_INTEGER_OVERFLOW=16]="ERR_CONNECTION_SEQ_INTEGER_OVERFLOW",t[t.ERR_DOC_MISSING_VERSION=17]="ERR_DOC_MISSING_VERSION",t[t.ERR_INGESTED_SNAPSHOT_HAS_NO_VERSION=18]="ERR_INGESTED_SNAPSHOT_HAS_NO_VERSION",t[t.ERR_MILESTONE_ARGUMENT_INVALID=19]="ERR_MILESTONE_ARGUMENT_INVALID",t[t.ERR_OP_SUBMIT_REJECTED=20]="ERR_OP_SUBMIT_REJECTED",t[t.ERR_PENDING_OP_REMOVED_BY_OP_SUBMIT_REJECTED=21]="ERR_PENDING_OP_REMOVED_BY_OP_SUBMIT_REJECTED",t[t.ERR_OP_VERSION_MISMATCH_AFTER_TRANSFORM=22]="ERR_OP_VERSION_MISMATCH_AFTER_TRANSFORM",t[t.ERR_OP_VERSION_MISMATCH_DURING_TRANSFORM=23]="ERR_OP_VERSION_MISMATCH_DURING_TRANSFORM",t[t.ERR_OP_VERSION_NEWER_THAN_CURRENT_SNAPSHOT=24]="ERR_OP_VERSION_NEWER_THAN_CURRENT_SNAPSHOT",t[t.ERR_OT_OP_BADLY_FORMED=25]="ERR_OT_OP_BADLY_FORMED",t[t.ERR_OT_OP_NOT_PROVIDED=26]="ERR_OT_OP_NOT_PROVIDED",t[t.ERR_SNAPSHOT_READ_SILENT_REJECTION=27]="ERR_SNAPSHOT_READ_SILENT_REJECTION",t[t.ERR_INFLIGHT_OP_MISSING=28]="ERR_INFLIGHT_OP_MISSING",t[t.ERR_HISTORY_SNAPSHOT_NOT_FOUND=29]="ERR_HISTORY_SNAPSHOT_NOT_FOUND"}(s||(e.ERROR_CODES=s={}));class r extends Error{constructor(t,e){super(e),this.code=t,this.name="OTError",this.code=t}}e.OTError=r,r.CODES=s},660:function(t,e,s){var r=this&&this.__createBinding||(Object.create?function(t,e,s,r){void 0===r&&(r=s);var n=Object.getOwnPropertyDescriptor(e,s);n&&!("get"in n?!e.__esModule:n.writable||n.configurable)||(n={enumerable:!0,get:function(){return e[s]}}),Object.defineProperty(t,r,n)}:function(t,e,s,r){void 0===r&&(r=s),t[r]=e[s]}),n=this&&this.__exportStar||function(t,e){for(var s in t)"default"===s||Object.prototype.hasOwnProperty.call(e,s)||r(e,t,s)};Object.defineProperty(e,"__esModule",{value:!0}),e.OT_DOC_MESSAGE_TYPE=void 0,n(s(872),e),n(s(549),e),n(s(802),e),e.OT_DOC_MESSAGE_TYPE="ot-doc"},549:(t,e)=>{var s;Object.defineProperty(e,"__esModule",{value:!0}),e.MessageActions=void 0,function(t){t[t.fetch=0]="fetch",t[t.fetchOps=1]="fetchOps",t[t.fetchHistorySnapshot=2]="fetchHistorySnapshot",t[t.subscribe=3]="subscribe",t[t.unsubscribe=4]="unsubscribe",t[t.op=5]="op"}(s||(e.MessageActions=s={}))},802:(t,e)=>{function s(t,e,s){let r=!1;return t.forEach((function(t){t&&(t(e,s),r=!0)})),r}function r(t){return t?JSON.parse(JSON.stringify(t)):t}Object.defineProperty(e,"__esModule",{value:!0}),e.util=e.nextTick=e.MAX_SAFE_INTEGER=void 0,e.callEach=s,e.clone=r,e.MAX_SAFE_INTEGER=9007199254740991,e.nextTick=function(t){if("undefined"!=typeof process&&process.nextTick)return process.nextTick(t);setTimeout((function(){t()}))},e.util={MAX_SAFE_INTEGER:e.MAX_SAFE_INTEGER,callEach:s,nextTick:e.nextTick,clone:r}}},s={};function r(t){var n=s[t];if(void 0!==n)return n.exports;var i=s[t]={exports:{}};return e[t].call(i.exports,i,i.exports,r),i.exports}var n={};return(()=>{var t=n;Object.defineProperty(t,"__esModule",{value:!0}),t.documentFeature=t.MemoryDb=t.Db=t.DocumentServices=t.TypesManager=void 0,r(259),r(36);const e=r(89);Object.defineProperty(t,"DocumentServices",{enumerable:!0,get:function(){return e.DocumentServices}});const s=r(619);Object.defineProperty(t,"Db",{enumerable:!0,get:function(){return s.Db}});const i=r(985);Object.defineProperty(t,"MemoryDb",{enumerable:!0,get:function(){return i.MemoryDb}});const o=r(763);Object.defineProperty(t,"documentFeature",{enumerable:!0,get:function(){return o.documentFeature}});const a=r(513);Object.defineProperty(t,"TypesManager",{enumerable:!0,get:function(){return a.TypesManager}})})(),n})()));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grapecity-software/js-collaboration-ot",
-  "version": "18.0.7",
+  "version": "18.1.0",
   "type": "commonjs",
   "main": "./dist/index.js",
   "exports": {
@@ -25,7 +25,7 @@
   "license": "Commercial",
   "description": "SpreadJS Collaboration plugin",
   "dependencies": {
-    "@grapecity-software/js-collaboration": "18.0.7"
+    "@grapecity-software/js-collaboration": "18.1.0"
   },
   "homepage": "http://www.grapecity.com.cn/"
 }

package/wrapper.mjs

@@ -1,4 +1,4 @@
 import * as OTModule from "./dist/index.js";
 import OT from "./dist/index.js";
-const { TypesManager, DocumentServices, Db, MemoryDb, documentFeature }  = { ...(OT ?? {}), ...OTModule };
-export { OT as default, TypesManager, DocumentServices, Db, MemoryDb, documentFeature };
+const { IDatabaseAdapter, TypesManager, DocumentServices, Db, MemoryDb, documentFeature }  = { ...(OT ?? {}), ...OTModule };
+export { OT as default, TypesManager, DocumentServices, Db, MemoryDb, IDatabaseAdapter, documentFeature };