@docukit/docsync 0.0.1-alpha.1

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

@@ -0,0 +1,387 @@
+/**
+ * DocSync Type Definitions
+ *
+ * This file contains all type definitions for the DocSync library.
+ * It is organized into collapsible regions for better navigation.
+ */
+import type { DocBinding } from "./docBinding.js";
+export type Result<D, E = Error> = {
+    data: D;
+    error?: never;
+} | {
+    data?: never;
+    error: E;
+};
+export type QueryResult<D, E = Error> = {
+    status: "loading";
+    data?: never;
+    error?: never;
+} | {
+    status: "success";
+    data: D;
+    error?: never;
+} | {
+    status: "error";
+    data?: never;
+    error: E;
+};
+export type DocSyncEvents<S, O> = {
+    "sync-operations": {
+        request: {
+            docId: string;
+            operations?: O[];
+            clock: number;
+            presence?: unknown;
+        };
+        response: Result<{
+            docId: string;
+            operations?: O[];
+            serializedDoc?: S;
+            clock: number;
+        }, {
+            type: "AuthorizationError" | "DatabaseError" | "ValidationError";
+            message: string;
+        }>;
+    };
+    presence: {
+        request: {
+            docId: string;
+            presence: unknown;
+        };
+        response: Result<void>;
+    };
+    "delete-doc": {
+        request: {
+            docId: string;
+        };
+        response: {
+            success: boolean;
+        };
+    };
+    "unsubscribe-doc": {
+        request: {
+            docId: string;
+        };
+        response: {
+            success: boolean;
+        };
+    };
+};
+export type DocSyncEventName = keyof DocSyncEvents<unknown, unknown>;
+export type AuthorizeEvent<TContext = {}, S = unknown, O = unknown> = {
+    [K in DocSyncEventName]: {
+        type: K;
+        payload: DocSyncEvents<S, O>[K]["request"];
+        userId: string;
+        context: TContext;
+    };
+}[DocSyncEventName];
+/**
+ * Client-side event definitions.
+ *
+ * Based on "wide events" philosophy from loggingsucks.com:
+ * 1. **Optional fields** added as they become available
+ * 2. **Can have partial data** (error + partial response can coexist) - **SERVER EVENTS ONLY**
+ * 3. **One operation = one event** (sync start + complete + error = single wide event)
+ * 4. **Separate concerns = separate events** (connect ≠ disconnect)
+ *
+ * ## Events
+ *
+ * **Client (6):** `onConnect`, `onDisconnect`, `onChange`, `onSync`, `onDocLoad`, `onDocUnload`
+ * **Server (3):** `onClientConnect`, `onClientDisconnect`, `onSyncRequest`
+ *
+ * **Wide events:** `onSyncRequest` (server)
+ * **Strict Result events:** `onSync` (client) - uses Result type for mutually exclusive data/error
+ */
+/** Emitted when WebSocket connection is lost */
+export type DisconnectEvent = {
+    reason: string;
+};
+/** Emitted when document content changes */
+export type ChangeEvent<O = unknown> = {
+    docId: string;
+    origin: "local" | "broadcast" | "remote";
+    operations: O[];
+};
+/** Emitted once after sync completes (success or error) */
+export type SyncEvent<O = unknown, S = unknown> = {
+    req: {
+        docId: string;
+        operations: O[];
+        clock: number;
+    };
+} & Result<{
+    operations?: O[];
+    clock: number;
+    serializedDoc?: S;
+}, {
+    type: "NetworkError" | "AuthorizationError" | "DatabaseError" | "ValidationError";
+    message: string;
+}>;
+/** Emitted when document is loaded */
+export type DocLoadEvent = {
+    docId: string;
+    source: "cache" | "local" | "created";
+    refCount: number;
+};
+/** Emitted when document is unloaded. If refCount is 0, the document is removed from the cache. */
+export type DocUnloadEvent = {
+    docId: string;
+    refCount: number;
+};
+export type ConnectHandler = () => void;
+export type DisconnectHandler = (event: DisconnectEvent) => void;
+export type ChangeHandler<O = {}> = {
+    (event: ChangeEvent<O>): void;
+};
+export type SyncHandler<O = {}> = {
+    (event: SyncEvent<O>): void;
+};
+export type DocLoadHandler = (event: DocLoadEvent) => void;
+export type DocUnloadHandler = (event: DocUnloadEvent) => void;
+/**
+ * Server-side event definitions.
+ * These events follow the "wide events" philosophy for comprehensive logging.
+ */
+/** Emitted when client successfully authenticates and connects */
+export type ClientConnectEvent<TContext = unknown> = {
+    userId: string;
+    deviceId: string;
+    socketId: string;
+    context: TContext;
+};
+/**
+ * Emitted when client disconnects.
+ *
+ * Also emitted when a connection attempt fails (e.g., authentication failure).
+ * In that case, userId and deviceId may not be available.
+ *
+ * Common `reason` values from Socket.IO:
+ * - "transport close" - Connection lost
+ * - "client namespace disconnect" - Client explicitly disconnected
+ * - "server namespace disconnect" - Server closed connection
+ * - "Authentication failed: invalid token" - Auth failed during connection attempt
+ */
+export type ClientDisconnectEvent = {
+    userId: string;
+    deviceId: string;
+    socketId: string;
+    reason: string;
+};
+/**
+ * Emitted once after sync-operations request completes.
+ *
+ * Common error.type values:
+ * - "AuthorizationError" - Access denied (authorization failed)
+ * - "DatabaseError" - Database operation failed
+ * - "ValidationError" - Invalid request data
+ */
+export type SyncRequestEvent<O = unknown, S = unknown> = {
+    userId: string;
+    deviceId: string;
+    socketId: string;
+    status: "success" | "error";
+    req: {
+        docId: string;
+        operations?: O[];
+        clock: number;
+        presence?: unknown;
+    };
+    res?: {
+        operations?: O[];
+        clock?: number;
+        serializedDoc?: S;
+    };
+    durationMs?: number;
+    devicesCount?: number;
+    clientsCount?: number;
+    error?: {
+        type: "AuthorizationError" | "DatabaseError" | "ValidationError";
+        message: string;
+        stack?: string;
+    };
+};
+export type ClientConnectHandler<TContext = unknown> = (event: ClientConnectEvent<TContext>) => void;
+export type ClientDisconnectHandler = (event: ClientDisconnectEvent) => void;
+export type SyncRequestHandler<O = unknown, S = unknown> = (event: SyncRequestEvent<O, S>) => void;
+/**
+ * State for deferred operations (batching and debouncing).
+ * Used to track pending timeouts and their associated data.
+ */
+export type DeferredState<T> = {
+    timeout?: ReturnType<typeof setTimeout>;
+    data: T;
+};
+export type Identity = {
+    userId: string;
+    secret: string;
+};
+/**
+ * Arguments for {@link DocSyncClient["getDoc"]}.
+ *
+ * - `{ type, id }` → Try to get an existing doc by ID. Returns `undefined` if not found.
+ * - `{ type, createIfMissing: true }` → Create a new doc with auto-generated ID (ulid).
+ * - `{ type, id, createIfMissing: true }` → Get existing doc or create it if not found.
+ */
+export type GetDocArgs = {
+    type: string;
+    id: string;
+    createIfMissing?: boolean;
+} | {
+    type: string;
+    createIfMissing: true;
+};
+export type DocData<D> = {
+    doc: D;
+    docId: string;
+};
+/**
+ * Presence is a record of user IDs to their presence data.
+ * It is used to track the presence of users in a document.
+ */
+export type Presence<T = unknown> = Record<string, T>;
+export type BroadcastMessage<O> = {
+    type: "OPERATIONS";
+    operations: O;
+    docId: string;
+    presence?: Record<string, unknown>;
+} | {
+    type: "PRESENCE";
+    docId: string;
+    presence: Record<string, unknown>;
+};
+export type ClientConfig<D extends {} = {}, S extends {} = {}, O extends {} = {}> = {
+    docBinding: DocBinding<D, S, O>;
+    server: {
+        url: string;
+        auth: {
+            /**
+             * Server authentication token.
+             *
+             * - Passed verbatim to the server on connection.
+             * - Validation is delegated to the server via `onAuth`.
+             * - This library does not issue, refresh, or rotate tokens.
+             */
+            getToken: () => Promise<string>;
+        };
+    };
+    local: {
+        provider: new (identity: Identity) => Provider<any, any, "client">;
+        /**
+         * Resolves the local storage identity.
+         *
+         * Used exclusively for:
+         * - Namespacing local persistence (userId)
+         * - Deriving encryption keys for data at rest (secret)
+         *
+         * About the secret:
+         * - Must never be persisted client-side (localStorage, IndexedDB, etc).
+         * - Re-encryption is not supported, so losing the secret makes local data permanently unrecoverable.
+         *
+         */
+        getIdentity: () => Promise<Identity>;
+    };
+};
+/**
+ * Server configuration with generic context type.
+ *
+ * @typeParam TContext - Application-defined context shape returned by authenticate
+ *                       and passed to authorize. Defaults to empty object.
+ */
+export type ServerConfig<TContext, D extends {}, S extends {}, O extends {}> = {
+    docBinding: DocBinding<D, S, O>;
+    port?: number;
+    provider: new () => Provider<NoInfer<S>, NoInfer<O>, "server">;
+    /**
+     * Authenticates a WebSocket connection.
+     *
+     * - Called once per connection attempt.
+     * - Must validate the provided token.
+     * - Must resolve the canonical userId.
+     * - May optionally return a context object that will be passed to authorize.
+     *
+     * @returns User info with optional context, or undefined if authentication fails.
+     */
+    authenticate(ev: {
+        token: string;
+    }): Promise<{
+        userId: string;
+        context?: TContext;
+    } | undefined>;
+    /**
+     * Authorizes an operation.
+     *
+     * - Called for each operation (get-doc, apply-operations, create-doc, save-doc).
+     * - Receives the cached context from authenticate.
+     * - Can use cached context for fast checks or fetch fresh data for consistency.
+     *
+     * @returns true to allow, false to deny.
+     */
+    authorize?(ev: AuthorizeEvent<TContext, S, O>): Promise<boolean>;
+};
+export type SerializedDocPayload<S> = {
+    serializedDoc: S;
+    docId: string;
+    clock: number;
+};
+/**
+ * Context passed to transaction callbacks.
+ * All operations share the same underlying transaction.
+ */
+export type TransactionContext<S, O, P extends "server" | "client"> = {
+    getSerializedDoc(docId: string): Promise<{
+        serializedDoc: S;
+        clock: number;
+    } | undefined>;
+    getOperations(arg: P extends "server" ? {
+        docId: string;
+        clock: number;
+    } : {
+        docId: string;
+    }): Promise<O[][]>;
+    deleteOperations(arg: {
+        docId: string;
+        count: number;
+    }): Promise<void>;
+    saveOperations(arg: {
+        docId: string;
+        operations: O[];
+    }): Promise<P extends "server" ? number : void>;
+    saveSerializedDoc(arg: SerializedDocPayload<S>): Promise<void>;
+};
+/**
+ * Storage provider for client or server.
+ * All operations must be performed within a transaction.
+ */
+export type Provider<S, O, P extends "server" | "client"> = {
+    /**
+     * Run operations in a single atomic transaction.
+     * If any operation fails, all changes are rolled back.
+     */
+    transaction<T>(mode: "readonly" | "readwrite", callback: (ctx: TransactionContext<S, O, P>) => Promise<T>): Promise<T>;
+};
+/**
+ * Socket.IO type definitions derived from DocSync events.
+ */
+type ClientToServerEvents<S, O> = {
+    [K in DocSyncEventName]: (payload: DocSyncEvents<S, O>[K]["request"], cb: (res: DocSyncEvents<S, O>[K]["response"]) => void) => void;
+};
+type ServerToClientEvents = {
+    dirty: (payload: {
+        docId: string;
+    }) => void;
+    presence: (payload: {
+        docId: string;
+        presence: Presence;
+    }) => void;
+};
+export type ServerSocket<S, O> = import("socket.io").Server<ClientToServerEvents<S, O>, ServerToClientEvents>;
+export type ClientSocket<S, O> = import("socket.io-client").Socket<ServerToClientEvents, ClientToServerEvents<S, O>>;
+/**
+ * Server socket event handlers type - TypeScript errors if any event is missing.
+ */
+export type SocketHandlers<S, O> = {
+    [K in DocSyncEventName]: (payload: DocSyncEvents<S, O>[K]["request"], cb: (res: DocSyncEvents<S, O>[K]["response"]) => void) => void | Promise<void>;
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/src/shared/types.js

@@ -0,0 +1,6 @@
+// TODO: review this line! Importing socket.io and socket.io-client
+// as dynamic imports produces environment pollution errors.
+/* eslint-disable @typescript-eslint/consistent-type-imports */
+export {};
+// #endregion
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/shared/types.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,4DAA4D;AAC5D,+DAA+D;;AAqf/D,aAAa"}

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

@@ -0,0 +1,2 @@
+export declare function throttle<T extends (...args: unknown[]) => void>(fn: T, wait: number): (...args: Parameters<T>) => void;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/shared/utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,EAC7D,EAAE,EAAE,CAAC,EACL,IAAI,EAAE,MAAM,IAIJ,GAAG,MAAM,UAAU,CAAC,CAAC,CAAC,UAO/B"}

package/dist/src/shared/utils.js

@@ -0,0 +1,11 @@
+export function throttle(fn, wait) {
+    let last = 0;
+    return (...args) => {
+        const now = Date.now();
+        if (now - last >= wait) {
+            last = now;
+            fn(...args);
+        }
+    };
+}
+//# sourceMappingURL=utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/shared/utils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,QAAQ,CACtB,EAAK,EACL,IAAY;IAEZ,IAAI,IAAI,GAAG,CAAC,CAAC;IAEb,OAAO,CAAC,GAAG,IAAmB,EAAE,EAAE;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,GAAG,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,GAAG,GAAG,CAAC;YACX,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QACd,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}