@docukit/docsync 0.0.1-alpha.1

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

@@ -0,0 +1,83 @@
+import { queryClient } 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 });
+    async transaction(_mode, callback) {
+        return await this._db.transaction(async (tx) => {
+            const ctx = {
+                getSerializedDoc: async (docId) => {
+                    const doc = await tx.query.documents.findFirst({
+                        where: eq(schema.documents.docId, docId),
+                    });
+                    return doc
+                        ? {
+                            serializedDoc: doc.doc,
+                            clock: doc.clock.getTime(),
+                        }
+                        : undefined;
+                },
+                getOperations: async ({ docId, clock }) => {
+                    const clockDate = new Date(clock);
+                    const serverOps = await tx
+                        .select({ operations: schema.operations.operations })
+                        .from(schema.operations)
+                        .where(and(eq(schema.operations.docId, docId), gt(schema.operations.clock, clockDate)))
+                        .orderBy(schema.operations.clock);
+                    return serverOps.map((r) => r.operations);
+                },
+                deleteOperations: async ({ docId, count }) => {
+                    // Get the first `count` operations ordered by clock (oldest first)
+                    const toDelete = await tx
+                        .select({
+                        docId: schema.operations.docId,
+                        clock: schema.operations.clock,
+                    })
+                        .from(schema.operations)
+                        .where(eq(schema.operations.docId, docId))
+                        .orderBy(schema.operations.clock)
+                        .limit(count);
+                    if (toDelete.length > 0) {
+                        // Delete operations using their composite primary key (docId, clock)
+                        for (const op of toDelete) {
+                            await tx
+                                .delete(schema.operations)
+                                .where(and(eq(schema.operations.docId, op.docId), eq(schema.operations.clock, op.clock)));
+                        }
+                    }
+                },
+                saveOperations: async ({ docId, operations }) => {
+                    if (operations.length === 0) {
+                        // Return the latest clock for this docId
+                        const latestOp = await tx.query.operations.findFirst({
+                            where: eq(schema.operations.docId, docId),
+                            orderBy: (ops, { desc }) => [desc(ops.clock)],
+                        });
+                        return latestOp?.clock.getTime() ?? 0;
+                    }
+                    // Insert operations and return the DB-generated timestamp
+                    const inserted = await tx
+                        .insert(schema.operations)
+                        .values({
+                        docId,
+                        operations: operations,
+                    })
+                        .returning({ clock: schema.operations.clock });
+                    return inserted[0].clock.getTime();
+                },
+                saveSerializedDoc: async (_arg) => {
+                    // TODO: saveSerializedDoc needs userId to work with Postgres schema.
+                    // This will be called during operation squashing (not implemented yet).
+                    // Options:
+                    // 1. Pass userId through TransactionContext
+                    // 2. Query userId from operations table
+                    // 3. Refactor schema to not require userId on documents table
+                    throw new Error("saveSerializedDoc not implemented for PostgresProvider yet - requires userId context");
+                },
+            };
+            return callback(ctx);
+        });
+    }
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,159 @@
+import postgres from "postgres";
+export declare const queryClient: postgres.Sql<{}>;
+export declare const documents: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "docsync-documents";
+    schema: undefined;
+    columns: {
+        userId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "userId";
+            tableName: "docsync-documents";
+            dataType: "string";
+            columnType: "PgVarchar";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: 26;
+        }>;
+        docId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "docId";
+            tableName: "docsync-documents";
+            dataType: "string";
+            columnType: "PgVarchar";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: 26;
+        }>;
+        doc: import("drizzle-orm/pg-core").PgColumn<{
+            name: "doc";
+            tableName: "docsync-documents";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: unknown;
+            driverParam: unknown;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        clock: import("drizzle-orm/pg-core").PgColumn<{
+            name: "clock";
+            tableName: "docsync-documents";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        permissions: import("drizzle-orm/pg-core").PgColumn<{
+            name: "permissions";
+            tableName: "docsync-documents";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: unknown;
+            driverParam: unknown;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+export declare const operations: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "docsync-operations";
+    schema: undefined;
+    columns: {
+        docId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "docId";
+            tableName: "docsync-operations";
+            dataType: "string";
+            columnType: "PgVarchar";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: 26;
+        }>;
+        operations: import("drizzle-orm/pg-core").PgColumn<{
+            name: "operations";
+            tableName: "docsync-operations";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: unknown;
+            driverParam: unknown;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        clock: import("drizzle-orm/pg-core").PgColumn<{
+            name: "clock";
+            tableName: "docsync-operations";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,34 @@
+import { jsonb, pgTable, primaryKey, timestamp, varchar, } from "drizzle-orm/pg-core";
+import postgres from "postgres";
+export const queryClient = postgres(process.env.DOCNODE_DB_URL);
+export const documents = pgTable("docsync-documents", {
+    userId: varchar("userId", { length: 26 }).notNull(),
+    docId: varchar("docId", { length: 26 }).notNull().primaryKey(),
+    doc: jsonb("doc").notNull(),
+    clock: timestamp("clock", { precision: 3, withTimezone: true }).notNull(),
+    permissions: jsonb("permissions"), // ??
+});
+export const operations = pgTable("docsync-operations", {
+    docId: varchar("docId", { length: 26 }).notNull(),
+    operations: jsonb("operations").notNull(),
+    clock: timestamp("clock", { precision: 3, withTimezone: true })
+        .notNull()
+        .defaultNow(),
+}, (table) => [primaryKey({ columns: [table.docId, table.clock] })]);
+// TODO: decide how to implement version history
+// const snapshots_deltas = pgTable(
+//   "snapshots_deltas",
+//   {
+//     docId: varchar("docId", { length: 26 }).notNull(),
+//     docnodeId: varchar("docnodeId", { length: 26 }).notNull(),
+//     data: jsonb("data"),
+//     // Cada vez que un nodo es modificado, se guarda en la tabla snapshots-deltas con un snapshotTimestamp vacío.
+//     // Cuando el snapshot "cierra", a todos los nodos del documento que no tienen un snapshotTimestamp, se les asigna el timestamp del snapshot.
+//     // Suena como una feature que podría implementar una BD. Básicamente si quiero volver a un estado X, puedo pedirle al proveedor de la BD que
+//     // me de un backup de la tabla (aunque eso me restauraría todos los documentos, no solo uno). Además, hay que ver si el proveedor de la BD lo
+//     // provee a nivel de tabla (duplica) o a nivel de fila (duplica solo los nodos que cambiaron).
+//     snapshot_timestamp: timestamp("snapshot_timestamp").defaultNow(),
+//   },
+//   (table) => [primaryKey({ columns: [table.docId, table.docnodeId] })],
+// );
+//# sourceMappingURL=schema.js.map

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

@@ -0,0 +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"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.d.ts","sourceRoot":"","sources":["../../../src/shared/debounce.ts"],"names":[],"mappings":"AAGA,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,EAAE,EAAE,CAAC,EACL,IAAI,EAAE,MAAM,GACX,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAMlC"}

package/dist/src/shared/debounce.js

@@ -0,0 +1,10 @@
+/* eslint-disable @typescript-eslint/no-unsafe-return */
+/* eslint-disable @typescript-eslint/no-explicit-any */
+export function debounce(fn, wait) {
+    let timeout;
+    return (...args) => {
+        clearTimeout(timeout);
+        timeout = setTimeout(() => fn(...args), wait);
+    };
+}
+//# sourceMappingURL=debounce.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.js","sourceRoot":"","sources":["../../../src/shared/debounce.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,uDAAuD;AAEvD,MAAM,UAAU,QAAQ,CACtB,EAAK,EACL,IAAY;IAEZ,IAAI,OAAsC,CAAC;IAC3C,OAAO,CAAC,GAAG,IAAmB,EAAE,EAAE;QAChC,YAAY,CAAC,OAAO,CAAC,CAAC;QACtB,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;IAChD,CAAC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,17 @@
+import { Doc, type DocConfig, type Operations } from "@docukit/docnode";
+export interface DocBinding<D extends {} = {}, S extends {} = {}, O extends {} = {}> {
+    create(type: string, id?: string): {
+        doc: D;
+        docId: string;
+    };
+    deserialize(serializedDoc: S): D;
+    serialize(doc: D): S;
+    onChange(doc: D, cb: (ev: {
+        operations: O;
+    }) => void): void;
+    applyOperations(doc: D, operations: O): void;
+    dispose(doc: D): void;
+}
+export declare const createDocBinding: <D extends {}, S extends {}, O extends {} = {}>(docBinding: DocBinding<D, S, O>) => DocBinding<D, S, O>;
+export declare const DocNodeBinding: (docConfigs: DocConfig[]) => DocBinding<Doc, import("@docukit/docnode").JsonDoc, Operations>;
+//# sourceMappingURL=docBinding.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docBinding.d.ts","sourceRoot":"","sources":["../../../src/shared/docBinding.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGxE,MAAM,WAAW,UAAU,CACzB,CAAC,SAAS,EAAE,GAAG,EAAE,EACjB,CAAC,SAAS,EAAE,GAAG,EAAE,EACjB,CAAC,SAAS,EAAE,GAAG,EAAE;IAGjB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG;QAAE,GAAG,EAAE,CAAC,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D,WAAW,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,CAAC;IACjC,SAAS,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE;QAAE,UAAU,EAAE,CAAC,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAC5D,eAAe,CAAC,GAAG,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,GAAG,IAAI,CAAC;IAC7C,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC;CACvB;AAED,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,EAC5E,YAAY,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAC9B,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAEpB,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,YAAY,SAAS,EAAE,oEAmCrD,CAAC"}

package/dist/src/shared/docBinding.js

@@ -0,0 +1,41 @@
+/* eslint-disable @typescript-eslint/no-empty-object-type */
+import { Doc } from "@docukit/docnode";
+export const createDocBinding = (docBinding) => {
+    return docBinding;
+};
+export const DocNodeBinding = (docConfigs) => {
+    const docConfigsMap = new Map();
+    docConfigs.forEach((docConfig) => {
+        const type = docConfig.type ?? "";
+        if (docConfigsMap.has(type)) {
+            throw new Error(`Duplicate doc type: ${type}`);
+        }
+        docConfigsMap.set(type, docConfig);
+    });
+    return createDocBinding({
+        create: (type, id) => {
+            const docConfig = docConfigsMap.get(type);
+            if (!docConfig)
+                throw new Error(`Unknown type: ${type}`);
+            const doc = new Doc({ ...docConfig, id });
+            return { doc, docId: doc.root.id };
+        },
+        serialize: (doc) => doc.toJSON({ unsafe: true }),
+        deserialize: (serializedDoc) => {
+            const type = serializedDoc[1];
+            const docConfig = docConfigsMap.get(type);
+            if (!docConfig)
+                throw new Error(`Unknown type: ${type}`);
+            const doc = Doc.fromJSON(docConfig, serializedDoc);
+            doc.forceCommit();
+            return doc;
+        },
+        onChange: (doc, cb) => doc.onChange(cb),
+        applyOperations: (doc, operations) => {
+            doc.applyOperations(operations);
+            doc.forceCommit();
+        },
+        dispose: (doc) => doc.dispose(),
+    });
+};
+//# sourceMappingURL=docBinding.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docBinding.js","sourceRoot":"","sources":["../../../src/shared/docBinding.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,OAAO,EAAE,GAAG,EAAmC,MAAM,kBAAkB,CAAC;AAiBxE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,UAA+B,EACV,EAAE;IACvB,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,UAAuB,EAAE,EAAE;IACxD,MAAM,aAAa,GAAG,IAAI,GAAG,EAAqB,CAAC;IAEnD,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;QAC/B,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC;QAClC,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;QACjD,CAAC;QACD,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,OAAO,gBAAgB,CAAC;QACtB,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE;YACnB,MAAM,SAAS,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC1C,IAAI,CAAC,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;YACzD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,EAAE,GAAG,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;YAC1C,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACrC,CAAC;QACD,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAChD,WAAW,EAAE,CAAC,aAAa,EAAE,EAAE;YAC7B,MAAM,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;YAC9B,MAAM,SAAS,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC1C,IAAI,CAAC,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;YACzD,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;YACnD,GAAG,CAAC,WAAW,EAAE,CAAC;YAClB,OAAO,GAAG,CAAC;QACb,CAAC;QACD,QAAQ,EAAE,CAAC,GAAG,EAAE,EAA4C,EAAE,EAAE,CAC9D,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClB,eAAe,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE;YACnC,GAAG,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;YAChC,GAAG,CAAC,WAAW,EAAE,CAAC;QACpB,CAAC;QACD,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE;KAChC,CAAC,CAAC;AACL,CAAC,CAAC"}

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

@@ -0,0 +1,30 @@
+/**
+ * Creates a throttle function that batches items by key and executes a callback
+ * after a specified delay. Multiple calls with the same key within the delay
+ * period will be batched together.
+ *
+ * @param callback - Function to execute with the key and batched items
+ * @param options - Configuration options
+ * @param options.wait - Delay in milliseconds before executing the callback
+ * @returns A function that accepts a key and item to be throttled
+ *
+ * @example
+ * ```ts
+ * const throttledSave = createThrottleByKey(
+ *   async (userId, operations) => {
+ *     await saveToDatabase(userId, operations);
+ *   },
+ *   { wait: 50 }
+ * );
+ *
+ * // These will be batched together
+ * throttledSave('user1', op1);
+ * throttledSave('user1', op2);
+ * throttledSave('user1', op3);
+ * // After 50ms, callback is called once with [op1, op2, op3]
+ * ```
+ */
+export declare function createThrottleByKey<K, T>(callback: (key: K, items: T[]) => void | Promise<void>, options: {
+    wait: number;
+}): (key: K, item: T) => void;
+//# sourceMappingURL=throttle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.d.ts","sourceRoot":"","sources":["../../../src/shared/throttle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,CAAC,EACtC,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EACtD,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,IAKjB,KAAK,CAAC,EAAE,MAAM,CAAC,UAwBxB"}

package/dist/src/shared/throttle.js

@@ -0,0 +1,51 @@
+/**
+ * Creates a throttle function that batches items by key and executes a callback
+ * after a specified delay. Multiple calls with the same key within the delay
+ * period will be batched together.
+ *
+ * @param callback - Function to execute with the key and batched items
+ * @param options - Configuration options
+ * @param options.wait - Delay in milliseconds before executing the callback
+ * @returns A function that accepts a key and item to be throttled
+ *
+ * @example
+ * ```ts
+ * const throttledSave = createThrottleByKey(
+ *   async (userId, operations) => {
+ *     await saveToDatabase(userId, operations);
+ *   },
+ *   { wait: 50 }
+ * );
+ *
+ * // These will be batched together
+ * throttledSave('user1', op1);
+ * throttledSave('user1', op2);
+ * throttledSave('user1', op3);
+ * // After 50ms, callback is called once with [op1, op2, op3]
+ * ```
+ */
+export function createThrottleByKey(callback, options) {
+    const queues = new Map();
+    const timeouts = new Map();
+    return (key, item) => {
+        // Add item to queue
+        const queue = queues.get(key) ?? [];
+        queue.push(item);
+        queues.set(key, queue);
+        // If there's already a pending timeout for this key, just wait
+        if (timeouts.has(key)) {
+            return;
+        }
+        // Schedule the callback
+        const timeout = setTimeout(() => {
+            timeouts.delete(key);
+            const items = queues.get(key);
+            queues.delete(key);
+            if (items && items.length > 0) {
+                void callback(key, items);
+            }
+        }, options.wait);
+        timeouts.set(key, timeout);
+    };
+}
+//# sourceMappingURL=throttle.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.js","sourceRoot":"","sources":["../../../src/shared/throttle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAsD,EACtD,OAAyB;IAEzB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoC,CAAC;IAE7D,OAAO,CAAC,GAAM,EAAE,IAAO,EAAE,EAAE;QACzB,oBAAoB;QACpB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAEvB,+DAA+D;QAC/D,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO;QACT,CAAC;QAED,wBAAwB;QACxB,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC9B,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACrB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC9B,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAEnB,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,KAAK,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAEjB,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC7B,CAAC,CAAC;AACJ,CAAC"}