@docukit/docsync 0.0.1-alpha.1 → 0.2.0-alpha.1

package/dist/src/server/providers/postgres/index.js

@@ -1,9 +1,12 @@
-import { queryClient } from "./schema.js";
+import { queryClient, checkConnection } from "./schema.js";
 import { drizzle } from "drizzle-orm/postgres-js";
 import * as schema from "./schema.js";
 import { eq, gt, and } from "drizzle-orm";
 export class PostgresProvider {
     _db = drizzle(queryClient, { schema });
+    constructor() {
+        checkConnection();
+    }
     async transaction(_mode, callback) {
         return await this._db.transaction(async (tx) => {
             const ctx = {
@@ -12,10 +15,7 @@ export class PostgresProvider {
                         where: eq(schema.documents.docId, docId),
                     });
                     return doc
-                        ? {
-                            serializedDoc: doc.doc,
-                            clock: doc.clock.getTime(),
-                        }
+                        ? { serializedDoc: doc.doc, clock: doc.clock.getTime() }
                         : undefined;
                 },
                 getOperations: async ({ docId, clock }) => {
@@ -59,13 +59,11 @@ export class PostgresProvider {
                     // Insert operations and return the DB-generated timestamp
                     const inserted = await tx
                         .insert(schema.operations)
-                        .values({
-                        docId,
-                        operations: operations,
-                    })
+                        .values({ docId, operations: operations })
                         .returning({ clock: schema.operations.clock });
                     return inserted[0].clock.getTime();
                 },
+                // eslint-disable-next-line @typescript-eslint/require-await -- not implemented yet
                 saveSerializedDoc: async (_arg) => {
                     // TODO: saveSerializedDoc needs userId to work with Postgres schema.
                     // This will be called during operation squashing (not implemented yet).

package/dist/src/server/providers/postgres/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/server/providers/postgres/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/server/providers/postgres/index.ts"],"names":[],"mappings":"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"}

package/dist/src/server/providers/postgres/schema.d.ts

@@ -1,5 +1,6 @@
 import postgres from "postgres";
 export declare const queryClient: postgres.Sql<{}>;
+export declare function checkConnection(): void;
 export declare const documents: import("drizzle-orm/pg-core").PgTableWithColumns<{
     name: "docsync-documents";
     schema: undefined;

package/dist/src/server/providers/postgres/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../../src/server/providers/postgres/schema.ts"],"names":[],"mappings":"AAOA,OAAO,QAAQ,MAAM,UAAU,CAAC;AAEhC,eAAO,MAAM,WAAW,kBAAwC,CAAC;AAEjE,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMpB,CAAC;AAEH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUtB,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../../src/server/providers/postgres/schema.ts"],"names":[],"mappings":"AAOA,OAAO,QAAQ,MAAM,UAAU,CAAC;AAMhC,eAAO,MAAM,WAAW,kBAKtB,CAAC;AAEH,wBAAgB,eAAe,SAW9B;AAED,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMpB,CAAC;AAEH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUtB,CAAC"}

package/dist/src/server/providers/postgres/schema.js

@@ -1,6 +1,23 @@
 import { jsonb, pgTable, primaryKey, timestamp, varchar, } from "drizzle-orm/pg-core";
 import postgres from "postgres";
-export const queryClient = postgres(process.env.DOCNODE_DB_URL);
+const DOCNODE_DB_URL = process.env.DOCNODE_DB_URL ??
+    "postgres://docukit:docukit@localhost:5433/docukit";
+export const queryClient = postgres(DOCNODE_DB_URL, {
+    onnotice: () => void {},
+    connect_timeout: 5,
+    idle_timeout: 0,
+    connection: { application_name: "docukit" },
+});
+export function checkConnection() {
+    queryClient `SELECT 1`.catch(() => {
+        console.error(`\n[DocSync] Failed to connect to PostgreSQL at: ${DOCNODE_DB_URL}\n` +
+            (process.env.DOCNODE_DB_URL
+                ? "Check that DOCNODE_DB_URL in your .env is correct and the database is running."
+                : "Make sure Docker is running (pnpm dev starts it automatically).") +
+            "\n");
+        process.exit(1);
+    });
+}
 export const documents = pgTable("docsync-documents", {
     userId: varchar("userId", { length: 26 }).notNull(),
     docId: varchar("docId", { length: 26 }).notNull().primaryKey(),

package/dist/src/server/providers/postgres/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../../src/server/providers/postgres/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,OAAO,EACP,UAAU,EACV,SAAS,EACT,OAAO,GACR,MAAM,qBAAqB,CAAC;AAC7B,OAAO,QAAQ,MAAM,UAAU,CAAC;AAEhC,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAe,CAAC,CAAC;AAEjE,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC,mBAAmB,EAAE;IACpD,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE;IACnD,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,UAAU,EAAE;IAC9D,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE;IAC3B,KAAK,EAAE,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE;IACzE,WAAW,EAAE,KAAK,CAAC,aAAa,CAAC,EAAE,KAAK;CACzC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG,OAAO,CAC/B,oBAAoB,EACpB;IACE,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE;IACjD,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;IACzC,KAAK,EAAE,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;SAC5D,OAAO,EAAE;SACT,UAAU,EAAE;CAChB,EACD,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CACjE,CAAC;AAEF,gDAAgD;AAChD,oCAAoC;AACpC,wBAAwB;AACxB,MAAM;AACN,yDAAyD;AACzD,iEAAiE;AACjE,2BAA2B;AAE3B,oHAAoH;AACpH,mJAAmJ;AACnJ,mJAAmJ;AACnJ,oJAAoJ;AACpJ,qGAAqG;AACrG,wEAAwE;AACxE,OAAO;AACP,0EAA0E;AAC1E,KAAK"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../../src/server/providers/postgres/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,OAAO,EACP,UAAU,EACV,SAAS,EACT,OAAO,GACR,MAAM,qBAAqB,CAAC;AAC7B,OAAO,QAAQ,MAAM,UAAU,CAAC;AAEhC,MAAM,cAAc,GAClB,OAAO,CAAC,GAAG,CAAC,cAAc;IAC1B,mDAAmD,CAAC;AAEtD,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC,cAAc,EAAE;IAClD,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE;IACvB,eAAe,EAAE,CAAC;IAClB,YAAY,EAAE,CAAC;IACf,UAAU,EAAE,EAAE,gBAAgB,EAAE,SAAS,EAAE;CAC5C,CAAC,CAAC;AAEH,MAAM,UAAU,eAAe;IAC7B,WAAW,CAAA,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE;QAC/B,OAAO,CAAC,KAAK,CACX,mDAAmD,cAAc,IAAI;YACnE,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc;gBACzB,CAAC,CAAC,gFAAgF;gBAClF,CAAC,CAAC,iEAAiE,CAAC;YACtE,IAAI,CACP,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC,mBAAmB,EAAE;IACpD,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE;IACnD,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,UAAU,EAAE;IAC9D,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE;IAC3B,KAAK,EAAE,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE;IACzE,WAAW,EAAE,KAAK,CAAC,aAAa,CAAC,EAAE,KAAK;CACzC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG,OAAO,CAC/B,oBAAoB,EACpB;IACE,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE;IACjD,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;IACzC,KAAK,EAAE,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;SAC5D,OAAO,EAAE;SACT,UAAU,EAAE;CAChB,EACD,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CACjE,CAAC;AAEF,gDAAgD;AAChD,oCAAoC;AACpC,wBAAwB;AACxB,MAAM;AACN,yDAAyD;AACzD,iEAAiE;AACjE,2BAA2B;AAE3B,oHAAoH;AACpH,mJAAmJ;AACnJ,mJAAmJ;AACnJ,oJAAoJ;AACpJ,qGAAqG;AACrG,wEAAwE;AACxE,OAAO;AACP,0EAA0E;AAC1E,KAAK"}

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

@@ -0,0 +1,107 @@
+import type { ClientToServerEvents, DocBinding, DocSyncEventName, MaybePromise, ServerToClientEvents, SerializedDocPayload } from "../shared/types.js";
+/** 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.
+ */
+export type ClientDisconnectEvent = {
+    userId: string;
+    deviceId: string;
+    socketId: string;
+    reason: string;
+};
+/** Emitted once after sync request completes. */
+export type SyncRequestEvent<O = unknown, S = unknown> = {
+    userId: string;
+    deviceId: string;
+    socketId: string;
+    status: "success" | "error";
+    req: {
+        type: string;
+        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 ClientConnectEventListener<TContext = unknown> = (event: ClientConnectEvent<TContext>) => void;
+export type ClientDisconnectEventListener = (event: ClientDisconnectEvent) => void;
+export type SyncRequestEventListener<O = unknown, S = unknown> = (event: SyncRequestEvent<O, S>) => void;
+/**
+ * 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 () => ServerProvider<NoInfer<S>, NoInfer<O>>;
+    authenticate(ev: {
+        token: string;
+    }): MaybePromise<{
+        userId: string;
+        context?: TContext;
+    } | undefined>;
+    authorize?(ev: {
+        type: DocSyncEventName;
+        req: unknown;
+        userId: string;
+        context: TContext;
+    }): MaybePromise<boolean>;
+};
+/**
+ * Context passed to server transaction callbacks.
+ * All operations share the same underlying transaction.
+ */
+export type ServerProviderContext<S, O> = {
+    getSerializedDoc(docId: string): Promise<{
+        serializedDoc: S;
+        clock: number;
+    } | undefined>;
+    getOperations(arg: {
+        docId: string;
+        clock: number;
+    }): Promise<O[][]>;
+    deleteOperations(arg: {
+        docId: string;
+        count: number;
+    }): Promise<void>;
+    saveOperations(arg: {
+        docId: string;
+        operations: O[];
+    }): Promise<number>;
+    saveSerializedDoc(arg: SerializedDocPayload<S>): Promise<void>;
+};
+/**
+ * Storage provider for the server.
+ * All operations must be performed within a transaction.
+ */
+export type ServerProvider<S, O> = {
+    transaction<T>(mode: "readonly" | "readwrite", callback: (ctx: ServerProviderContext<S, O>) => Promise<T>): Promise<T>;
+};
+export type ServerSocket<S, O> = import("socket.io").Server<ClientToServerEvents<S, O>, ServerToClientEvents>;
+/** Per-connection socket on the server (has .id, .join, .emit, .on, etc.). */
+export type ServerConnectionSocket<S, O> = import("socket.io").Socket<ClientToServerEvents<S, O>, ServerToClientEvents>;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/src/server/types.js

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

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

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

package/dist/src/server/utils/applyPresenceUpdate.d.ts

@@ -0,0 +1,11 @@
+import type { Presence } from "../../shared/types.js";
+import type { ServerConnectionSocket } from "../types.js";
+/**
+ * Updates server presence state for a document and broadcasts the change
+ * to other clients in the doc room. Handlers import and call this directly.
+ */
+export declare function applyPresenceUpdate(presenceByDoc: Map<string, Presence>, socket: ServerConnectionSocket<{}, {}>, clientId: string, args: {
+    docId: string;
+    presence: unknown;
+}): void;
+//# sourceMappingURL=applyPresenceUpdate.d.ts.map

package/dist/src/server/utils/applyPresenceUpdate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applyPresenceUpdate.d.ts","sourceRoot":"","sources":["../../../../src/server/utils/applyPresenceUpdate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,EACpC,MAAM,EAAE,sBAAsB,CAAC,EAAE,EAAE,EAAE,CAAC,EACtC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,GACzC,IAAI,CAmBN"}

package/dist/src/server/utils/applyPresenceUpdate.js

@@ -0,0 +1,25 @@
+/**
+ * Updates server presence state for a document and broadcasts the change
+ * to other clients in the doc room. Handlers import and call this directly.
+ */
+export function applyPresenceUpdate(presenceByDoc, socket, clientId, args) {
+    const { docId, presence } = args;
+    const currentPresence = presenceByDoc.get(docId) ?? {};
+    if (presence === null || presence === undefined) {
+        delete currentPresence[clientId];
+        if (Object.keys(currentPresence).length > 0) {
+            presenceByDoc.set(docId, currentPresence);
+        }
+        else {
+            presenceByDoc.delete(docId);
+        }
+    }
+    else {
+        const newPresence = { ...currentPresence, [clientId]: presence };
+        presenceByDoc.set(docId, newPresence);
+    }
+    socket
+        .to(`doc:${docId}`)
+        .emit("presence", { docId, presence: { [clientId]: presence ?? null } });
+}
+//# sourceMappingURL=applyPresenceUpdate.js.map

package/dist/src/server/utils/applyPresenceUpdate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"applyPresenceUpdate.js","sourceRoot":"","sources":["../../../../src/server/utils/applyPresenceUpdate.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,aAAoC,EACpC,MAAsC,EACtC,QAAgB,EAChB,IAA0C;IAE1C,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IACjC,MAAM,eAAe,GAAG,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAEvD,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAChD,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAC;QACjC,IAAI,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;QAC5C,CAAC;aAAM,CAAC;YACN,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,WAAW,GAAG,EAAE,GAAG,eAAe,EAAE,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;QACjE,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IACxC,CAAC;IAED,MAAM;SACH,EAAE,CAAC,OAAO,KAAK,EAAE,CAAC;SAClB,IAAI,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,QAAQ,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;AAC7E,CAAC"}

package/dist/src/server/utils/authorizeMiddleware.d.ts

@@ -0,0 +1,4 @@
+import type { DocSyncServer } from "../index.js";
+import type { ServerConfig } from "../types.js";
+export declare function authorizeMiddleware<TContext = {}, D extends {} = {}, S extends {} = {}, O extends {} = {}>(server: DocSyncServer<TContext, D, S, O>, authorize: ServerConfig<TContext, D, S, O>["authorize"] | undefined): void;
+//# sourceMappingURL=authorizeMiddleware.d.ts.map

package/dist/src/server/utils/authorizeMiddleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authorizeMiddleware.d.ts","sourceRoot":"","sources":["../../../../src/server/utils/authorizeMiddleware.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,wBAAgB,mBAAmB,CACjC,QAAQ,GAAG,EAAE,EACb,CAAC,SAAS,EAAE,GAAG,EAAE,EACjB,CAAC,SAAS,EAAE,GAAG,EAAE,EACjB,CAAC,SAAS,EAAE,GAAG,EAAE,EAEjB,MAAM,EAAE,aAAa,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EACxC,SAAS,EAAE,YAAY,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,SAAS,GAClE,IAAI,CAgEN"}

package/dist/src/server/utils/authorizeMiddleware.js

@@ -0,0 +1,73 @@
+export function authorizeMiddleware(server, authorize) {
+    const io = server["_io"];
+    io.on("connection", (socket) => {
+        socket.use((packet, next) => {
+            void (async () => {
+                const rawPacket = packet;
+                const [eventName, payload, maybeAck] = rawPacket;
+                if (eventName !== "sync" && eventName !== "presence") {
+                    next();
+                    return;
+                }
+                if (!authorize) {
+                    next();
+                    return;
+                }
+                const { userId, context, deviceId } = socket.data;
+                const startTime = Date.now();
+                const authorized = await authorize({
+                    type: eventName,
+                    payload,
+                    userId,
+                    context,
+                });
+                if (authorized) {
+                    next();
+                    return;
+                }
+                if (eventName === "sync") {
+                    const errorEvent = {
+                        type: "AuthorizationError",
+                        message: "Access denied",
+                    };
+                    const req = getSyncEventReq(payload);
+                    server["_events"].emit("syncRequest", {
+                        userId,
+                        deviceId,
+                        socketId: socket.id,
+                        status: "error",
+                        req,
+                        error: errorEvent,
+                        durationMs: Date.now() - startTime,
+                    });
+                    if (isAckFn(maybeAck)) {
+                        maybeAck({ error: errorEvent });
+                    }
+                    return;
+                }
+                if (isAckFn(maybeAck)) {
+                    maybeAck({
+                        error: { type: "AuthorizationError", message: "Access denied" },
+                    });
+                }
+            })().catch((error) => {
+                next(error instanceof Error ? error : new Error(String(error)));
+            });
+        });
+    });
+}
+function isAckFn(value) {
+    return typeof value === "function";
+}
+function isSyncRequest(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const maybe = value;
+    return typeof maybe.docId === "string" && typeof maybe.clock === "number";
+}
+function getSyncEventReq(payload) {
+    if (!isSyncRequest(payload))
+        return { docId: "unknown", clock: 0 };
+    return { docId: payload.docId, clock: payload.clock };
+}
+//# sourceMappingURL=authorizeMiddleware.js.map

package/dist/src/server/utils/authorizeMiddleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authorizeMiddleware.js","sourceRoot":"","sources":["../../../../src/server/utils/authorizeMiddleware.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,mBAAmB,CAMjC,MAAwC,EACxC,SAAmE;IAEnE,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAEzB,EAAE,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;QAC7B,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;YAC1B,KAAK,CAAC,KAAK,IAAI,EAAE;gBACf,MAAM,SAAS,GAAc,MAAmB,CAAC;gBACjD,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC,GAAG,SAAS,CAAC;gBACjD,IAAI,SAAS,KAAK,MAAM,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;oBACrD,IAAI,EAAE,CAAC;oBACP,OAAO;gBACT,CAAC;gBAED,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,IAAI,EAAE,CAAC;oBACP,OAAO;gBACT,CAAC;gBAED,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;gBAClD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC7B,MAAM,UAAU,GAAG,MAAM,SAAS,CAAC;oBACjC,IAAI,EAAE,SAAS;oBACf,OAAO;oBACP,MAAM;oBACN,OAAO;iBACR,CAAC,CAAC;gBAEH,IAAI,UAAU,EAAE,CAAC;oBACf,IAAI,EAAE,CAAC;oBACP,OAAO;gBACT,CAAC;gBAED,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;oBACzB,MAAM,UAAU,GAAG;wBACjB,IAAI,EAAE,oBAA6B;wBACnC,OAAO,EAAE,eAAe;qBACzB,CAAC;oBACF,MAAM,GAAG,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;oBACrC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,aAAa,EAAE;wBACpC,MAAM;wBACN,QAAQ;wBACR,QAAQ,EAAE,MAAM,CAAC,EAAE;wBACnB,MAAM,EAAE,OAAO;wBACf,GAAG;wBACH,KAAK,EAAE,UAAU;wBACjB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;qBACnC,CAAC,CAAC;oBAEH,IAAI,OAAO,CAAqB,QAAQ,CAAC,EAAE,CAAC;wBAC1C,QAAQ,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;oBAClC,CAAC;oBACD,OAAO;gBACT,CAAC;gBAED,IAAI,OAAO,CAAmB,QAAQ,CAAC,EAAE,CAAC;oBACxC,QAAQ,CAAC;wBACP,KAAK,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,eAAe,EAAE;qBAChE,CAAC,CAAC;gBACL,CAAC;YACH,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBAC5B,IAAI,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAClE,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,OAAO,CAAI,KAAc;IAChC,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC;AACrC,CAAC;AAED,SAAS,aAAa,CAAI,KAAc;IACtC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,KAAK,GAAG,KAA6C,CAAC;IAC5D,OAAO,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC;AAC5E,CAAC;AAED,SAAS,eAAe,CAAC,OAAgB;IACvC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IACnE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;AACxD,CAAC"}

package/dist/src/server/utils/events.d.ts

@@ -0,0 +1,16 @@
+import type { ClientConnectEvent, ClientDisconnectEvent, SyncRequestEvent } from "../types.js";
+export type ServerEventMap<TContext = unknown, O = unknown, S = unknown> = {
+    clientConnect: ClientConnectEvent<TContext>;
+    clientDisconnect: ClientDisconnectEvent;
+    syncRequest: SyncRequestEvent<O, S>;
+};
+export type ServerEventName = keyof ServerEventMap;
+export type ServerEventEmitter<TContext = unknown, O = unknown, S = unknown> = {
+    listeners: {
+        [K in ServerEventName]: Set<(payload: ServerEventMap<TContext, O, S>[K]) => void>;
+    };
+    on<K extends ServerEventName>(event: K, cb: (payload: ServerEventMap<TContext, O, S>[K]) => void): () => void;
+    emit<K extends ServerEventName>(event: K, payload: ServerEventMap<TContext, O, S>[K]): void;
+};
+export declare function createServerEventEmitter<TContext = unknown, O = unknown, S = unknown>(): ServerEventEmitter<TContext, O, S>;
+//# sourceMappingURL=events.d.ts.map

package/dist/src/server/utils/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../src/server/utils/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAMrB,MAAM,MAAM,cAAc,CAAC,QAAQ,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI;IACzE,aAAa,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC5C,gBAAgB,EAAE,qBAAqB,CAAC;IACxC,WAAW,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,MAAM,cAAc,CAAC;AAEnD,MAAM,MAAM,kBAAkB,CAAC,QAAQ,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI;IAC7E,SAAS,EAAE;SACR,CAAC,IAAI,eAAe,GAAG,GAAG,CACzB,CAAC,OAAO,EAAE,cAAc,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CACrD;KACF,CAAC;IACF,EAAE,CAAC,CAAC,SAAS,eAAe,EAC1B,KAAK,EAAE,CAAC,EACR,EAAE,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,GACvD,MAAM,IAAI,CAAC;IACd,IAAI,CAAC,CAAC,SAAS,eAAe,EAC5B,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,cAAc,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GACzC,IAAI,CAAC;CACT,CAAC;AAEF,wBAAgB,wBAAwB,CACtC,QAAQ,GAAG,OAAO,EAClB,CAAC,GAAG,OAAO,EACX,CAAC,GAAG,OAAO,KACR,kBAAkB,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,CAmCtC"}

package/dist/src/server/utils/events.js

@@ -0,0 +1,22 @@
+export function createServerEventEmitter() {
+    const listeners = {
+        clientConnect: new Set(),
+        clientDisconnect: new Set(),
+        syncRequest: new Set(),
+    };
+    function on(event, cb) {
+        const set = listeners[event];
+        set.add(cb);
+        return () => {
+            set.delete(cb);
+        };
+    }
+    function emit(event, payload) {
+        const set = listeners[event];
+        for (const fn of set) {
+            fn(payload);
+        }
+    }
+    return { listeners, on, emit };
+}
+//# sourceMappingURL=events.js.map

package/dist/src/server/utils/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../../src/server/utils/events.ts"],"names":[],"mappings":"AAkCA,MAAM,UAAU,wBAAwB;IAKtC,MAAM,SAAS,GAIX;QACF,aAAa,EAAE,IAAI,GAAG,EAAE;QACxB,gBAAgB,EAAE,IAAI,GAAG,EAAE;QAC3B,WAAW,EAAE,IAAI,GAAG,EAAE;KACvB,CAAC;IAEF,SAAS,EAAE,CACT,KAAQ,EACR,EAAwD;QAExD,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;QAC7B,GAAG,CAAC,GAAG,CAAC,EAAkE,CAAC,CAAC;QAC5E,OAAO,GAAG,EAAE;YACV,GAAG,CAAC,MAAM,CACR,EAAkE,CACnE,CAAC;QACJ,CAAC,CAAC;IACJ,CAAC;IAED,SAAS,IAAI,CACX,KAAQ,EACR,OAA0C;QAE1C,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;QAC7B,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;YACpB,EAAqD,CAAC,OAAO,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACjC,CAAC"}

package/dist/src/server/utils/rateLimitMiddleware.d.ts

@@ -0,0 +1,6 @@
+import type { DocSyncServer } from "../index.js";
+/**
+ * Registers a per-user, per-endpoint 50ms hard rate limit for this server.
+ */
+export declare function rateLimitMiddleware<TContext = {}, D extends {} = {}, S extends {} = {}, O extends {} = {}>(server: DocSyncServer<TContext, D, S, O>): void;
+//# sourceMappingURL=rateLimitMiddleware.d.ts.map

package/dist/src/server/utils/rateLimitMiddleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rateLimitMiddleware.d.ts","sourceRoot":"","sources":["../../../../src/server/utils/rateLimitMiddleware.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,GAAG,EAAE,EACb,CAAC,SAAS,EAAE,GAAG,EAAE,EACjB,CAAC,SAAS,EAAE,GAAG,EAAE,EACjB,CAAC,SAAS,EAAE,GAAG,EAAE,EACjB,MAAM,EAAE,aAAa,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CA6BhD"}

package/dist/src/server/utils/rateLimitMiddleware.js

@@ -0,0 +1,65 @@
+const RATE_LIMIT_WINDOW_MS = 50;
+/**
+ * Registers a per-user, per-endpoint 50ms hard rate limit for this server.
+ */
+export function rateLimitMiddleware(server) {
+    const endpointLastHitAtMap = new Map();
+    const io = server["_io"];
+    io.on("connection", (socket) => {
+        const { userId } = socket.data;
+        socket.use((packet, next) => {
+            const [eventName] = packet;
+            if (!isDocSyncEndpoint(eventName)) {
+                next();
+                return;
+            }
+            // Rate-limit key is per user and per endpoint.
+            const key = `${userId}:${eventName}`;
+            const now = Date.now();
+            const lastHitAt = endpointLastHitAtMap.get(key);
+            // Hard reject requests that arrive inside the 50ms cooldown window.
+            if (lastHitAt !== undefined && now - lastHitAt < RATE_LIMIT_WINDOW_MS) {
+                rejectPacket(packet, eventName);
+                return;
+            }
+            endpointLastHitAtMap.set(key, now);
+            next();
+        });
+    });
+}
+function rejectPacket(packet, eventName) {
+    const maybeAck = packet.at(-1);
+    if (eventName === "sync") {
+        if (!isAckFn(maybeAck))
+            return;
+        maybeAck({
+            error: { type: "NetworkError", message: "Rate limit exceeded" },
+        });
+        return;
+    }
+    if (eventName === "presence") {
+        if (!isAckFn(maybeAck))
+            return;
+        maybeAck({
+            error: { type: "NetworkError", message: "Rate limit exceeded" },
+        });
+        return;
+    }
+    if (eventName === "unsubscribe-doc") {
+        if (!isAckFn(maybeAck))
+            return;
+        maybeAck({
+            error: { type: "NetworkError", message: "Rate limit exceeded" },
+        });
+    }
+}
+function isAckFn(value) {
+    return typeof value === "function";
+}
+function isDocSyncEndpoint(eventName) {
+    return (eventName === "sync" ||
+        eventName === "presence" ||
+        eventName === "delete-doc" ||
+        eventName === "unsubscribe-doc");
+}
+//# sourceMappingURL=rateLimitMiddleware.js.map

package/dist/src/server/utils/rateLimitMiddleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rateLimitMiddleware.js","sourceRoot":"","sources":["../../../../src/server/utils/rateLimitMiddleware.ts"],"names":[],"mappings":"AAQA,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEhC;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAKjC,MAAwC;IACxC,MAAM,oBAAoB,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvD,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAEzB,EAAE,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;QAC7B,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;QAE/B,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;YAC1B,MAAM,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC;YAC3B,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;gBAClC,IAAI,EAAE,CAAC;gBACP,OAAO;YACT,CAAC;YAED,+CAA+C;YAC/C,MAAM,GAAG,GAAG,GAAG,MAAM,IAAI,SAAS,EAAE,CAAC;YACrC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,MAAM,SAAS,GAAG,oBAAoB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAEhD,oEAAoE;YACpE,IAAI,SAAS,KAAK,SAAS,IAAI,GAAG,GAAG,SAAS,GAAG,oBAAoB,EAAE,CAAC;gBACtE,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;gBAChC,OAAO;YACT,CAAC;YAED,oBAAoB,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YACnC,IAAI,EAAE,CAAC;QACT,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,YAAY,CAAC,MAAiB,EAAE,SAA2B;IAClE,MAAM,QAAQ,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAE/B,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;QACzB,IAAI,CAAC,OAAO,CAAe,QAAQ,CAAC;YAAE,OAAO;QAC7C,QAAQ,CAAC;YACP,KAAK,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,qBAAqB,EAAE;SAChE,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAmB,QAAQ,CAAC;YAAE,OAAO;QACjD,QAAQ,CAAC;YACP,KAAK,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,qBAAqB,EAAE;SAChE,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,IAAI,SAAS,KAAK,iBAAiB,EAAE,CAAC;QACpC,IAAI,CAAC,OAAO,CAAyB,QAAQ,CAAC;YAAE,OAAO;QACvD,QAAQ,CAAC;YACP,KAAK,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,qBAAqB,EAAE;SAChE,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAI,KAAc;IAChC,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC;AACrC,CAAC;AAED,SAAS,iBAAiB,CAAC,SAAiB;IAC1C,OAAO,CACL,SAAS,KAAK,MAAM;QACpB,SAAS,KAAK,UAAU;QACxB,SAAS,KAAK,YAAY;QAC1B,SAAS,KAAK,iBAAiB,CAChC,CAAC;AACJ,CAAC"}