@stratasync/server 0.2.0

package/dist/mutate/mutate-service.js

@@ -0,0 +1,326 @@
+import { eq, getTableColumns } from "drizzle-orm";
+import { noopLogger } from "../config.js";
+import { mapGraphQLAction } from "../types.js";
+import { serializeSyncId, toSyncActionOutput } from "../utils/sync-utils.js";
+import { createModelHandler, createStandardDelegate, createCompositeDelegate, } from "./model-handlers.js";
+const MODEL_ID_GROUP_KEY = "__modelId__";
+const SYNC_ACTION_DEDUP_CONSTRAINT = "sync_actions_client_id_client_tx_id_unique";
+const isSyncDedupUniqueConstraintError = (error) => {
+    if (typeof error !== "object" || error === null) {
+        return false;
+    }
+    const maybeError = error;
+    return (maybeError.code === "23505" &&
+        maybeError.constraint === SYNC_ACTION_DEDUP_CONSTRAINT);
+};
+// ---------------------------------------------------------------------------
+// Service
+// ---------------------------------------------------------------------------
+export class MutateService {
+    dao;
+    db;
+    logger;
+    modelHandlers;
+    modelGroupKeys;
+    modelDelegates;
+    modelConfigs;
+    constructor(db, dao, models, logger = noopLogger) {
+        this.db = db;
+        this.dao = dao;
+        this.logger = logger;
+        this.modelConfigs = models;
+        // Build handlers, group keys, and delegates from config
+        this.modelHandlers = new Map();
+        this.modelGroupKeys = {};
+        this.modelDelegates = {};
+        for (const [name, model] of Object.entries(models)) {
+            // Group key
+            if (model.groupKey !== null) {
+                this.modelGroupKeys[name] = model.groupKey;
+            }
+            // Delegate for lookups
+            if (model.mutate.kind === "standard") {
+                const idField = model.mutate.idField ?? "id";
+                let idColumn;
+                try {
+                    const cols = getTableColumns(model.table);
+                    idColumn = cols[idField];
+                }
+                catch {
+                    // Table columns unavailable — skip delegate registration
+                }
+                if (idColumn) {
+                    this.modelDelegates[name] = async (lookupDb, id) => {
+                        const typedDb = lookupDb;
+                        const rows = await typedDb
+                            .select()
+                            .from(model.table)
+                            .where(eq(idColumn, id))
+                            .limit(1);
+                        return rows[0] ?? null;
+                    };
+                }
+            }
+            // Model handler
+            const mutateConfig = model.mutate;
+            const delegate = mutateConfig.kind === "standard"
+                ? createStandardDelegate(model.table, mutateConfig.idField ?? "id")
+                : createCompositeDelegate(model.table, mutateConfig.buildDeleteWhere);
+            const def = mutateConfig.kind === "standard"
+                ? {
+                    actions: mutateConfig.actions,
+                    delegate,
+                    insertFields: mutateConfig.insertFields,
+                    kind: "standard",
+                    onBeforeInsert: mutateConfig.onBeforeInsert,
+                    onBeforeUpdate: mutateConfig.onBeforeUpdate,
+                    updateFields: mutateConfig.updateFields,
+                }
+                : {
+                    actions: mutateConfig.actions,
+                    delegate,
+                    insertFields: mutateConfig.insertFields,
+                    kind: "composite",
+                };
+            this.modelHandlers.set(name, createModelHandler(def));
+        }
+    }
+    /**
+     * Resolve the groupId for a sync action.
+     */
+    async resolveGroupId(modelName, modelId, action, payload) {
+        const groupKey = this.modelGroupKeys[modelName];
+        if (!groupKey) {
+            return null;
+        }
+        if (groupKey === MODEL_ID_GROUP_KEY) {
+            return modelId;
+        }
+        // Try payload first
+        const payloadValue = payload[groupKey];
+        if (typeof payloadValue === "string" && payloadValue.length > 0) {
+            return payloadValue;
+        }
+        // For insert, the group key is required in payload
+        if (action === "I") {
+            this.logger.warn({ groupKey, modelName }, "Missing group key in insert payload");
+            throw new Error("Invalid mutation: missing required group identifier");
+        }
+        // For update/delete/archive/unarchive, look up from DB
+        const record = await this.lookupGroupId(modelName, modelId, groupKey);
+        if (!record) {
+            this.logger.warn({ groupKey, modelId, modelName }, "Cannot resolve group for mutation");
+            throw new Error("Invalid mutation: record not found");
+        }
+        return record;
+    }
+    async lookupGroupId(modelName, modelId, groupKey) {
+        const lookup = this.modelDelegates[modelName];
+        if (!lookup) {
+            return null;
+        }
+        const row = await lookup(this.db, modelId);
+        return row?.[groupKey];
+    }
+    static validateGroupAccess(context, groupId, modelName, logger) {
+        if (groupId !== null && !context.groups.includes(groupId)) {
+            logger.warn({ groupId, modelName, userId: context.userId }, "Access denied for mutation");
+            throw new Error("Access denied");
+        }
+    }
+    static createDuplicateTransactionResult(tx, syncId, logger) {
+        logger.debug({
+            clientTxId: tx.clientTxId,
+            syncId: serializeSyncId(syncId),
+        }, "Duplicate transaction skipped");
+        return {
+            result: MutateService.createSuccessResult(tx, syncId),
+            success: true,
+            syncId,
+        };
+    }
+    prepareTransaction(tx) {
+        const action = mapGraphQLAction(tx.action);
+        // Resolve canonical model ID for composite models
+        const modelConfig = this.modelConfigs[tx.modelName];
+        let canonicalModelId = tx.modelId;
+        if (modelConfig?.mutate.kind === "composite" &&
+            modelConfig.mutate.compositeId) {
+            canonicalModelId = modelConfig.mutate.compositeId.computeId(tx.modelName, tx.modelId, tx.payload);
+        }
+        return {
+            action,
+            canonicalModelId,
+        };
+    }
+    async applyModelMutation(tx, prepared) {
+        const handler = this.modelHandlers.get(tx.modelName);
+        if (!handler) {
+            return tx.payload;
+        }
+        return await handler(this.db, prepared.canonicalModelId, tx.payload, prepared.action);
+    }
+    async resolveAuthorizedGroupId(context, tx, prepared) {
+        const groupId = await this.resolveGroupId(tx.modelName, prepared.canonicalModelId, prepared.action, tx.payload);
+        MutateService.validateGroupAccess(context, groupId, tx.modelName, this.logger);
+        return groupId;
+    }
+    static publishSyncAction(syncAction, onAction) {
+        if (!onAction) {
+            return;
+        }
+        onAction(toSyncActionOutput(syncAction));
+    }
+    static validateTransaction(tx) {
+        const errors = [];
+        if (!tx.clientTxId) {
+            errors.push("clientTxId is required");
+        }
+        if (!tx.clientId) {
+            errors.push("clientId is required");
+        }
+        if (!tx.modelName) {
+            errors.push("modelName is required");
+        }
+        if (!tx.modelId) {
+            errors.push("modelId is required");
+        }
+        if (!tx.action) {
+            errors.push("action is required");
+        }
+        if (!["INSERT", "UPDATE", "DELETE", "ARCHIVE", "UNARCHIVE"].includes(tx.action)) {
+            errors.push(`Invalid action: ${tx.action}`);
+        }
+        return errors;
+    }
+    static createSuccessResult(tx, syncId) {
+        return {
+            clientTxId: tx.clientTxId,
+            success: true,
+            syncId: serializeSyncId(syncId),
+        };
+    }
+    async createSyncActionWithDeduplication(tx, action, canonicalModelId, data, groupId) {
+        try {
+            const syncAction = await this.dao.createSyncAction({
+                action,
+                clientId: tx.clientId,
+                clientTxId: tx.clientTxId,
+                data,
+                groupId,
+                model: tx.modelName,
+                modelId: canonicalModelId,
+            });
+            return {
+                duplicateId: null,
+                syncAction: syncAction,
+            };
+        }
+        catch (error) {
+            if (!isSyncDedupUniqueConstraintError(error)) {
+                throw error;
+            }
+            const duplicate = await this.dao.findSyncActionByClientTx(tx.clientId, tx.clientTxId);
+            if (!duplicate) {
+                throw error;
+            }
+            return { duplicateId: duplicate.id, syncAction: null };
+        }
+    }
+    async processTransaction(context, tx, onAction) {
+        try {
+            const existing = await this.dao.findSyncActionByClientTx(tx.clientId, tx.clientTxId);
+            if (existing) {
+                return MutateService.createDuplicateTransactionResult(tx, existing.id, this.logger);
+            }
+            const prepared = this.prepareTransaction(tx);
+            const data = await this.applyModelMutation(tx, prepared);
+            const groupId = await this.resolveAuthorizedGroupId(context, tx, prepared);
+            const createResult = await this.createSyncActionWithDeduplication(tx, prepared.action, prepared.canonicalModelId, data, groupId);
+            if (createResult.duplicateId !== null) {
+                return MutateService.createDuplicateTransactionResult(tx, createResult.duplicateId, this.logger);
+            }
+            const { syncAction } = createResult;
+            if (!syncAction) {
+                throw new Error("Expected syncAction after transaction creation");
+            }
+            this.logger.debug({
+                action: prepared.action,
+                modelId: prepared.canonicalModelId,
+                modelName: tx.modelName,
+                syncId: serializeSyncId(syncAction.id),
+            }, "Transaction processed");
+            MutateService.publishSyncAction(syncAction, onAction);
+            // Fire onAfterMutation hook
+            const modelConfig = this.modelConfigs[tx.modelName];
+            if (modelConfig?.mutate.onAfterMutation) {
+                try {
+                    await modelConfig.mutate.onAfterMutation({
+                        action: prepared.action,
+                        data,
+                        modelId: prepared.canonicalModelId,
+                        modelName: tx.modelName,
+                        payload: tx.payload,
+                        syncAction: { id: syncAction.id },
+                    });
+                }
+                catch (hookError) {
+                    this.logger.warn({ error: hookError, modelName: tx.modelName }, "onAfterMutation hook failed");
+                }
+            }
+            return {
+                result: MutateService.createSuccessResult(tx, syncAction.id),
+                success: true,
+                syncId: syncAction.id,
+            };
+        }
+        catch (error) {
+            this.logger.error({
+                clientTxId: tx.clientTxId,
+                error,
+                modelId: tx.modelId,
+                modelName: tx.modelName,
+            }, "Transaction failed");
+            return {
+                result: {
+                    clientTxId: tx.clientTxId,
+                    error: error instanceof Error ? error.message : "Unknown error",
+                    success: false,
+                },
+                success: false,
+            };
+        }
+    }
+    async mutate(context, input, onAction) {
+        this.logger.info({
+            transactionCount: input.transactions.length,
+            userId: context.userId,
+        }, "Mutate started");
+        const results = [];
+        let lastSyncId = 0n;
+        let success = true;
+        for (const tx of input.transactions) {
+            const processed = await this.processTransaction(context, tx, onAction);
+            results.push(processed.result);
+            if (!processed.success) {
+                success = false;
+                continue;
+            }
+            if (processed.syncId > lastSyncId) {
+                lastSyncId = processed.syncId;
+            }
+        }
+        this.logger.info({
+            lastSyncId: serializeSyncId(lastSyncId),
+            processedCount: results.length,
+            success,
+            userId: context.userId,
+        }, "Mutate completed");
+        return {
+            lastSyncId: serializeSyncId(lastSyncId),
+            results,
+            success,
+        };
+    }
+}
+//# sourceMappingURL=mutate-service.js.map

package/dist/mutate/mutate-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutate-service.js","sourceRoot":"","sources":["../../src/mutate/mutate-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGlD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAY1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAG7B,MAAM,kBAAkB,GAAG,aAAa,CAAC;AAEzC,MAAM,4BAA4B,GAChC,4CAA4C,CAAC;AAc/C,MAAM,gCAAgC,GAAG,CAAC,KAAc,EAAW,EAAE;IACnE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,UAAU,GAAG,KAGlB,CAAC;IAEF,OAAO,CACL,UAAU,CAAC,IAAI,KAAK,OAAO;QAC3B,UAAU,CAAC,UAAU,KAAK,4BAA4B,CACvD,CAAC;AACJ,CAAC,CAAC;AAsCF,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,MAAM,OAAO,aAAa;IACP,GAAG,CAAU;IACb,EAAE,CAAU;IACZ,MAAM,CAAa;IACnB,aAAa,CAQ5B;IACe,cAAc,CAAyB;IACvC,cAAc,CAA8B;IAC5C,YAAY,CAAkC;IAE/D,YACE,EAAW,EACX,GAAY,EACZ,MAAuC,EACvC,SAAqB,UAAU;QAE/B,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC;QAE3B,wDAAwD;QACxD,IAAI,CAAC,aAAa,GAAG,IAAI,GAAG,EAAE,CAAC;QAC/B,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;QAEzB,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACnD,YAAY;YACZ,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;gBAC5B,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC;YAC7C,CAAC;YAED,uBAAuB;YACvB,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBACrC,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC;gBAC7C,IAAI,QAAiB,CAAC;gBACtB,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,CAA4B,CAAC;oBACrE,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC3B,CAAC;gBAAC,MAAM,CAAC;oBACP,yDAAyD;gBAC3D,CAAC;gBAED,IAAI,QAAQ,EAAE,CAAC;oBACb,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE;wBACjD,MAAM,OAAO,GAAG,QAAkB,CAAC;wBACnC,MAAM,IAAI,GAAG,MAAM,OAAO;6BACvB,MAAM,EAAE;6BACR,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;6BACjB,KAAK,CAAC,EAAE,CAAC,QAAiB,EAAE,EAAE,CAAC,CAAC;6BAChC,KAAK,CAAC,CAAC,CAAC,CAAC;wBACZ,OAAQ,IAAI,CAAC,CAAC,CAAyC,IAAI,IAAI,CAAC;oBAClE,CAAC,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,gBAAgB;YAChB,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC;YAClC,MAAM,QAAQ,GACZ,YAAY,CAAC,IAAI,KAAK,UAAU;gBAC9B,CAAC,CAAC,sBAAsB,CAAC,KAAK,CAAC,KAAK,EAAE,YAAY,CAAC,OAAO,IAAI,IAAI,CAAC;gBACnE,CAAC,CAAC,uBAAuB,CAAC,KAAK,CAAC,KAAK,EAAE,YAAY,CAAC,gBAAgB,CAAC,CAAC;YAE1E,MAAM,GAAG,GACP,YAAY,CAAC,IAAI,KAAK,UAAU;gBAC9B,CAAC,CAAC;oBACE,OAAO,EAAE,YAAY,CAAC,OAAO;oBAC7B,QAAQ;oBACR,YAAY,EAAE,YAAY,CAAC,YAAY;oBACvC,IAAI,EAAE,UAAU;oBAChB,cAAc,EAAE,YAAY,CAAC,cAAc;oBAC3C,cAAc,EAAE,YAAY,CAAC,cAAc;oBAC3C,YAAY,EAAE,YAAY,CAAC,YAAY;iBACxC;gBACH,CAAC,CAAC;oBACE,OAAO,EAAE,YAAY,CAAC,OAAO;oBAC7B,QAAQ;oBACR,YAAY,EAAE,YAAY,CAAC,YAAY;oBACvC,IAAI,EAAE,WAAW;iBAClB,CAAC;YAER,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,cAAc,CAC1B,SAAiB,EACjB,OAAe,EACf,MAAc,EACd,OAAgC;QAEhC,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,QAAQ,KAAK,kBAAkB,EAAE,CAAC;YACpC,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,oBAAoB;QACpB,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QACvC,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChE,OAAO,YAAY,CAAC;QACtB,CAAC;QAED,mDAAmD;QACnD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,EAAE,QAAQ,EAAE,SAAS,EAAE,EACvB,qCAAqC,CACtC,CAAC;YACF,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;QAED,uDAAuD;QACvD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QACtE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,EAChC,mCAAmC,CACpC,CAAC;YACF,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,KAAK,CAAC,aAAa,CACzB,SAAiB,EACjB,OAAe,EACf,QAAgB;QAEhB,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAC3C,OAAQ,GAAsC,EAAE,CAAC,QAAQ,CAAkB,CAAC;IAC9E,CAAC;IAEO,MAAM,CAAC,mBAAmB,CAChC,OAAwB,EACxB,OAAsB,EACtB,SAAiB,EACjB,MAAkB;QAElB,IAAI,OAAO,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1D,MAAM,CAAC,IAAI,CACT,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,EAC9C,4BAA4B,CAC7B,CAAC;YACF,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,gCAAgC,CAC7C,EAAoB,EACpB,MAAc,EACd,MAAkB;QAElB,MAAM,CAAC,KAAK,CACV;YACE,UAAU,EAAE,EAAE,CAAC,UAAU;YACzB,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC;SAChC,EACD,+BAA+B,CAChC,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,aAAa,CAAC,mBAAmB,CAAC,EAAE,EAAE,MAAM,CAAC;YACrD,OAAO,EAAE,IAAI;YACb,MAAM;SACP,CAAC;IACJ,CAAC;IAEO,kBAAkB,CAAC,EAAoB;QAC7C,MAAM,MAAM,GAAG,gBAAgB,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;QAE3C,kDAAkD;QAClD,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;QACpD,IAAI,gBAAgB,GAAG,EAAE,CAAC,OAAO,CAAC;QAElC,IACE,WAAW,EAAE,MAAM,CAAC,IAAI,KAAK,WAAW;YACxC,WAAW,CAAC,MAAM,CAAC,WAAW,EAC9B,CAAC;YACD,gBAAgB,GAAG,WAAW,CAAC,MAAM,CAAC,WAAW,CAAC,SAAS,CACzD,EAAE,CAAC,SAAS,EACZ,EAAE,CAAC,OAAO,EACV,EAAE,CAAC,OAAO,CACX,CAAC;QACJ,CAAC;QAED,OAAO;YACL,MAAM;YACN,gBAAgB;SACjB,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAC9B,EAAoB,EACpB,QAA6B;QAE7B,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;QAErD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,EAAE,CAAC,OAAO,CAAC;QACpB,CAAC;QAED,OAAO,MAAM,OAAO,CAClB,IAAI,CAAC,EAAE,EACP,QAAQ,CAAC,gBAAgB,EACzB,EAAE,CAAC,OAAO,EACV,QAAQ,CAAC,MAAM,CAChB,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,wBAAwB,CACpC,OAAwB,EACxB,EAAoB,EACpB,QAA6B;QAE7B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CACvC,EAAE,CAAC,SAAS,EACZ,QAAQ,CAAC,gBAAgB,EACzB,QAAQ,CAAC,MAAM,EACf,EAAE,CAAC,OAAO,CACX,CAAC;QAEF,aAAa,CAAC,mBAAmB,CAC/B,OAAO,EACP,OAAO,EACP,EAAE,CAAC,SAAS,EACZ,IAAI,CAAC,MAAM,CACZ,CAAC;QAEF,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,MAAM,CAAC,iBAAiB,CAC9B,UAAyB,EACzB,QAA6C;QAE7C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO;QACT,CAAC;QAED,QAAQ,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,CAAC,mBAAmB,CAAC,EAAoB;QAC7C,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,IAAI,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC;YACnB,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACxC,CAAC;QACD,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACtC,CAAC;QACD,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC;YAClB,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC;YAChB,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACrC,CAAC;QACD,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACpC,CAAC;QACD,IACE,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,QAAQ,CAC9D,EAAE,CAAC,MAAM,CACV,EACD,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9C,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,MAAM,CAAC,mBAAmB,CAChC,EAAoB,EACpB,MAAc;QAEd,OAAO;YACL,UAAU,EAAE,EAAE,CAAC,UAAU;YACzB,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC;SAChC,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,iCAAiC,CAC7C,EAAoB,EACpB,MAAc,EACd,gBAAwB,EACxB,IAA6B,EAC7B,OAAsB;QAEtB,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC;gBACjD,MAAM;gBACN,QAAQ,EAAE,EAAE,CAAC,QAAQ;gBACrB,UAAU,EAAE,EAAE,CAAC,UAAU;gBACzB,IAAI;gBACJ,OAAO;gBACP,KAAK,EAAE,EAAE,CAAC,SAAS;gBACnB,OAAO,EAAE,gBAAgB;aAC1B,CAAC,CAAC;YACH,OAAO;gBACL,WAAW,EAAE,IAAI;gBACjB,UAAU,EAAE,UAAsC;aACnD,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,gCAAgC,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC7C,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,wBAAwB,CACvD,EAAE,CAAC,QAAQ,EACX,EAAE,CAAC,UAAU,CACd,CAAC;YACF,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,MAAM,KAAK,CAAC;YACd,CAAC;YACD,OAAO,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;QACzD,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAC9B,OAAwB,EACxB,EAAoB,EACpB,QAA6C;QAE7C,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,wBAAwB,CACtD,EAAE,CAAC,QAAQ,EACX,EAAE,CAAC,UAAU,CACd,CAAC;YACF,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,aAAa,CAAC,gCAAgC,CACnD,EAAE,EACF,QAAQ,CAAC,EAAE,EACX,IAAI,CAAC,MAAM,CACZ,CAAC;YACJ,CAAC;YAED,MAAM,QAAQ,GAAG,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;YAC7C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;YACzD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,wBAAwB,CACjD,OAAO,EACP,EAAE,EACF,QAAQ,CACT,CAAC;YAEF,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,iCAAiC,CAC/D,EAAE,EACF,QAAQ,CAAC,MAAM,EACf,QAAQ,CAAC,gBAAgB,EACzB,IAAI,EACJ,OAAO,CACR,CAAC;YAEF,IAAI,YAAY,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;gBACtC,OAAO,aAAa,CAAC,gCAAgC,CACnD,EAAE,EACF,YAAY,CAAC,WAAW,EACxB,IAAI,CAAC,MAAM,CACZ,CAAC;YACJ,CAAC;YAED,MAAM,EAAE,UAAU,EAAE,GAAG,YAAY,CAAC;YACpC,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;YACpE,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,KAAK,CACf;gBACE,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,OAAO,EAAE,QAAQ,CAAC,gBAAgB;gBAClC,SAAS,EAAE,EAAE,CAAC,SAAS;gBACvB,MAAM,EAAE,eAAe,CAAC,UAAU,CAAC,EAAE,CAAC;aACvC,EACD,uBAAuB,CACxB,CAAC;YAEF,aAAa,CAAC,iBAAiB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YAEtD,4BAA4B;YAC5B,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;YACpD,IAAI,WAAW,EAAE,MAAM,CAAC,eAAe,EAAE,CAAC;gBACxC,IAAI,CAAC;oBACH,MAAM,WAAW,CAAC,MAAM,CAAC,eAAe,CAAC;wBACvC,MAAM,EAAE,QAAQ,CAAC,MAAM;wBACvB,IAAI;wBACJ,OAAO,EAAE,QAAQ,CAAC,gBAAgB;wBAClC,SAAS,EAAE,EAAE,CAAC,SAAS;wBACvB,OAAO,EAAE,EAAE,CAAC,OAAO;wBACnB,UAAU,EAAE,EAAE,EAAE,EAAE,UAAU,CAAC,EAAE,EAAE;qBAClC,CAAC,CAAC;gBACL,CAAC;gBAAC,OAAO,SAAS,EAAE,CAAC;oBACnB,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,EAC7C,6BAA6B,CAC9B,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,OAAO;gBACL,MAAM,EAAE,aAAa,CAAC,mBAAmB,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE,CAAC;gBAC5D,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,UAAU,CAAC,EAAE;aACtB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CACf;gBACE,UAAU,EAAE,EAAE,CAAC,UAAU;gBACzB,KAAK;gBACL,OAAO,EAAE,EAAE,CAAC,OAAO;gBACnB,SAAS,EAAE,EAAE,CAAC,SAAS;aACxB,EACD,oBAAoB,CACrB,CAAC;YACF,OAAO;gBACL,MAAM,EAAE;oBACN,UAAU,EAAE,EAAE,CAAC,UAAU;oBACzB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;oBAC/D,OAAO,EAAE,KAAK;iBACf;gBACD,OAAO,EAAE,KAAK;aACf,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CACV,OAAwB,EACxB,KAAkB,EAClB,QAA6C;QAE7C,IAAI,CAAC,MAAM,CAAC,IAAI,CACd;YACE,gBAAgB,EAAE,KAAK,CAAC,YAAY,CAAC,MAAM;YAC3C,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,EACD,gBAAgB,CACjB,CAAC;QAEF,MAAM,OAAO,GAAwB,EAAE,CAAC;QACxC,IAAI,UAAU,GAAG,EAAE,CAAC;QACpB,IAAI,OAAO,GAAG,IAAI,CAAC;QAEnB,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;YACpC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC;YACvE,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAC/B,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;gBACvB,OAAO,GAAG,KAAK,CAAC;gBAChB,SAAS;YACX,CAAC;YACD,IAAI,SAAS,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;gBAClC,UAAU,GAAG,SAAS,CAAC,MAAM,CAAC;YAChC,CAAC;QACH,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,IAAI,CACd;YACE,UAAU,EAAE,eAAe,CAAC,UAAU,CAAC;YACvC,cAAc,EAAE,OAAO,CAAC,MAAM;YAC9B,OAAO;YACP,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,EACD,kBAAkB,CACnB,CAAC;QAEF,OAAO;YACL,UAAU,EAAE,eAAe,CAAC,UAAU,CAAC;YACvC,OAAO;YACP,OAAO;SACR,CAAC;IACJ,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Sync action types
+ */
+type TransactionAction = "I" | "U" | "D" | "A" | "V";
+export type GraphQLTransactionAction = "INSERT" | "UPDATE" | "DELETE" | "ARCHIVE" | "UNARCHIVE";
+/**
+ * Maps GraphQL action names to internal codes
+ */
+export declare const mapGraphQLAction: (action: GraphQLTransactionAction) => TransactionAction;
+/**
+ * Transaction input for mutations
+ */
+export interface TransactionInput {
+    clientTxId: string;
+    clientId: string;
+    modelName: string;
+    modelId: string;
+    action: GraphQLTransactionAction;
+    payload: Record<string, unknown>;
+}
+/**
+ * Mutation batch input
+ */
+export interface MutateInput {
+    batchId: string;
+    transactions: TransactionInput[];
+}
+/**
+ * Transaction result
+ */
+export interface TransactionResult {
+    clientTxId: string;
+    success: boolean;
+    syncId?: string;
+    error?: string;
+}
+/**
+ * Mutation result
+ */
+export interface MutateResult {
+    success: boolean;
+    lastSyncId: string;
+    results: TransactionResult[];
+}
+export type SyncIdString = string;
+/**
+ * Delta packet for sync
+ */
+export interface DeltaPacket {
+    lastSyncId: SyncIdString;
+    hasMore: boolean;
+    actions: SyncActionOutput[];
+}
+/**
+ * Sync action output
+ */
+export interface SyncActionOutput {
+    syncId: SyncIdString;
+    modelName: string;
+    modelId: string;
+    action: string;
+    data: Record<string, unknown>;
+    groupId?: string;
+    clientTxId?: string;
+    clientId?: string;
+    createdAt: Date;
+}
+export interface SerializedSyncActionOutput {
+    syncId: SyncIdString;
+    modelName: string;
+    modelId: string;
+    action: string;
+    data: Record<string, unknown>;
+    groupId?: string;
+    clientTxId?: string;
+    clientId?: string;
+    createdAt: string;
+}
+/**
+ * Bootstrap request
+ */
+export interface BootstrapRequest {
+    schemaHash: string;
+    groups?: string[];
+    models?: string[];
+}
+/**
+ * Sync user context
+ */
+export interface SyncUserContext {
+    userId: string;
+    groups: string[];
+    email?: string;
+    name?: string | null;
+}
+/**
+ * Model action type
+ */
+export type ModelAction = "I" | "U" | "D" | "A" | "V";
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,KAAK,iBAAiB,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AACrD,MAAM,MAAM,wBAAwB,GAChC,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,WAAW,CAAC;AAMhB;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,wBAAwB,KAC/B,iBAqBF,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,wBAAwB,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,gBAAgB,EAAE,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,YAAY,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC"}

package/dist/types.js

@@ -0,0 +1,29 @@
+const assertNever = (_value, message) => {
+    throw new Error(message);
+};
+/**
+ * Maps GraphQL action names to internal codes
+ */
+export const mapGraphQLAction = (action) => {
+    switch (action) {
+        case "INSERT": {
+            return "I";
+        }
+        case "UPDATE": {
+            return "U";
+        }
+        case "DELETE": {
+            return "D";
+        }
+        case "ARCHIVE": {
+            return "A";
+        }
+        case "UNARCHIVE": {
+            return "V";
+        }
+        default: {
+            return assertNever(action, `Unsupported action: ${action}`);
+        }
+    }
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,GAAG,CAAC,MAAa,EAAE,OAAe,EAAS,EAAE;IAC5D,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,MAAgC,EACb,EAAE;IACrB,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,OAAO,GAAG,CAAC;QACb,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,OAAO,GAAG,CAAC;QACb,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,OAAO,GAAG,CAAC;QACb,CAAC;QACD,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,OAAO,GAAG,CAAC;QACb,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,OAAO,GAAG,CAAC;QACb,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,OAAO,WAAW,CAAC,MAAM,EAAE,uBAAuB,MAAM,EAAE,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;AACH,CAAC,CAAC"}

package/dist/utils/composite-ids.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Default namespace for composite sync IDs.
+ * Keep this stable. Changing it will regenerate all composite IDs.
+ */
+export declare const DEFAULT_COMPOSITE_ID_NAMESPACE = "92a73695-d772-4b43-9fb4-d79f5fbef300";
+/**
+ * Creates a deterministic composite sync ID using UUIDv5.
+ *
+ * @param model - The model name (e.g., "TaskLabel")
+ * @param parts - The composite key parts in stable order
+ * @param namespace - UUID namespace (defaults to the built-in sync namespace)
+ */
+export declare const createCompositeSyncId: (model: string, parts: readonly string[], namespace?: string) => string;
+//# sourceMappingURL=composite-ids.d.ts.map

package/dist/utils/composite-ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composite-ids.d.ts","sourceRoot":"","sources":["../../src/utils/composite-ids.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,8BAA8B,yCACH,CAAC;AAEzC;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAChC,OAAO,MAAM,EACb,OAAO,SAAS,MAAM,EAAE,EACxB,YAAW,MAAuC,KACjD,MAAgE,CAAC"}

package/dist/utils/composite-ids.js

@@ -0,0 +1,15 @@
+import { v5 as uuidv5 } from "uuid";
+/**
+ * Default namespace for composite sync IDs.
+ * Keep this stable. Changing it will regenerate all composite IDs.
+ */
+export const DEFAULT_COMPOSITE_ID_NAMESPACE = "92a73695-d772-4b43-9fb4-d79f5fbef300";
+/**
+ * Creates a deterministic composite sync ID using UUIDv5.
+ *
+ * @param model - The model name (e.g., "TaskLabel")
+ * @param parts - The composite key parts in stable order
+ * @param namespace - UUID namespace (defaults to the built-in sync namespace)
+ */
+export const createCompositeSyncId = (model, parts, namespace = DEFAULT_COMPOSITE_ID_NAMESPACE) => uuidv5(`${model}:${JSON.stringify(parts)}`, namespace);
+//# sourceMappingURL=composite-ids.js.map

package/dist/utils/composite-ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composite-ids.js","sourceRoot":"","sources":["../../src/utils/composite-ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,CAAC;AAEpC;;;GAGG;AACH,MAAM,CAAC,MAAM,8BAA8B,GACzC,sCAAsC,CAAC;AAEzC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,KAAa,EACb,KAAwB,EACxB,YAAoB,8BAA8B,EAC1C,EAAE,CAAC,MAAM,CAAC,GAAG,KAAK,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC"}

package/dist/utils/dates.d.ts

@@ -0,0 +1,8 @@
+export declare const dateOnlyStringToEpoch: (value: string | null) => number | null;
+export declare const toDateOnlyEpoch: (value: unknown) => number | null;
+export declare const epochToDateOnlyString: (value: number | null) => string | null;
+export declare const toDateOnlyStringOrNull: (value: unknown) => string | null;
+export declare const toDateOnlyDateOrNull: (value: unknown) => Date | null;
+export declare const toInstantEpoch: (value: unknown) => number | null;
+export declare const toInstantDateOrNull: (value: unknown) => Date | null;
+//# sourceMappingURL=dates.d.ts.map

package/dist/utils/dates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.d.ts","sourceRoot":"","sources":["../../src/utils/dates.ts"],"names":[],"mappings":"AA6DA,eAAO,MAAM,qBAAqB,GAAI,OAAO,MAAM,GAAG,IAAI,KAAG,MAAM,GAAG,IAYrE,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,IA8BzD,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,OAAO,MAAM,GAAG,IAAI,KAAG,MAAM,GAAG,IAWrE,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,IAClB,CAAC;AAEhD,eAAO,MAAM,oBAAoB,GAAI,OAAO,OAAO,KAAG,IAAI,GAAG,IAG5D,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,IAmBxD,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,OAAO,OAAO,KAAG,IAAI,GAAG,IAG3D,CAAC"}

package/dist/utils/dates.js

@@ -0,0 +1,101 @@
+const DATE_ONLY_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+const INSTANT_PATTERN = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,9})?(?:Z|[+-]\d{2}:\d{2})$/;
+const DATE_ONLY_DAY_MS = 24 * 60 * 60 * 1000;
+const pad = (value) => String(value).padStart(2, "0");
+const parseDateOnlyParts = (value) => {
+    if (!DATE_ONLY_PATTERN.test(value)) {
+        return null;
+    }
+    const [yearRaw, monthRaw, dayRaw] = value.split("-");
+    const year = Number(yearRaw);
+    const month = Number(monthRaw);
+    const day = Number(dayRaw);
+    if (!(Number.isInteger(year) &&
+        Number.isInteger(month) &&
+        Number.isInteger(day))) {
+        return null;
+    }
+    const epoch = Date.UTC(year, month - 1, day);
+    const candidate = new Date(epoch);
+    if (candidate.getUTCFullYear() !== year ||
+        candidate.getUTCMonth() + 1 !== month ||
+        candidate.getUTCDate() !== day) {
+        return null;
+    }
+    return { day, month, year };
+};
+const isCanonicalDateOnlyEpoch = (value) => Number.isFinite(value) && value % DATE_ONLY_DAY_MS === 0;
+const parseInstantString = (value) => {
+    const trimmed = value.trim();
+    if (trimmed.length === 0 ||
+        DATE_ONLY_PATTERN.test(trimmed) ||
+        !INSTANT_PATTERN.test(trimmed)) {
+        return null;
+    }
+    const parsed = Date.parse(trimmed);
+    return Number.isNaN(parsed) ? null : parsed;
+};
+export const dateOnlyStringToEpoch = (value) => {
+    if (typeof value !== "string") {
+        return null;
+    }
+    const parts = parseDateOnlyParts(value.trim());
+    if (!parts) {
+        return null;
+    }
+    return Date.UTC(parts.year, parts.month - 1, parts.day);
+};
+export const toDateOnlyEpoch = (value) => {
+    if (value === null || value === undefined) {
+        return null;
+    }
+    if (value instanceof Date) {
+        const epoch = value.getTime();
+        if (Number.isNaN(epoch)) {
+            return null;
+        }
+        const canonicalEpoch = Date.UTC(value.getUTCFullYear(), value.getUTCMonth(), value.getUTCDate());
+        return epoch === canonicalEpoch ? canonicalEpoch : null;
+    }
+    if (typeof value === "number") {
+        return isCanonicalDateOnlyEpoch(value) ? value : null;
+    }
+    if (typeof value === "string") {
+        return dateOnlyStringToEpoch(value);
+    }
+    return null;
+};
+export const epochToDateOnlyString = (value) => {
+    const epoch = toDateOnlyEpoch(value);
+    if (epoch === null) {
+        return null;
+    }
+    const date = new Date(epoch);
+    return `${date.getUTCFullYear()}-${pad(date.getUTCMonth() + 1)}-${pad(date.getUTCDate())}`;
+};
+export const toDateOnlyStringOrNull = (value) => epochToDateOnlyString(toDateOnlyEpoch(value));
+export const toDateOnlyDateOrNull = (value) => {
+    const epoch = toDateOnlyEpoch(value);
+    return epoch === null ? null : new Date(epoch);
+};
+export const toInstantEpoch = (value) => {
+    if (value === null || value === undefined) {
+        return null;
+    }
+    if (value instanceof Date) {
+        const epoch = value.getTime();
+        return Number.isNaN(epoch) ? null : epoch;
+    }
+    if (typeof value === "number") {
+        return Number.isFinite(value) ? value : null;
+    }
+    if (typeof value === "string") {
+        return parseInstantString(value);
+    }
+    return null;
+};
+export const toInstantDateOrNull = (value) => {
+    const epoch = toInstantEpoch(value);
+    return epoch === null ? null : new Date(epoch);
+};
+//# sourceMappingURL=dates.js.map

package/dist/utils/dates.js.map

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

package/dist/utils/sync-scope.d.ts

@@ -0,0 +1,4 @@
+export declare const resolveRequestedSyncGroups: (authorizedGroups: string[], requestedGroups?: string[]) => string[];
+export declare const resolvePublishedDeltaGroups: (groupId: string | null | undefined, fallbackGroups: string[]) => string[];
+export declare const dedupeSyncGroups: (groups: string[]) => string[];
+//# sourceMappingURL=sync-scope.d.ts.map

package/dist/utils/sync-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-scope.d.ts","sourceRoot":"","sources":["../../src/utils/sync-scope.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,0BAA0B,GACrC,kBAAkB,MAAM,EAAE,EAC1B,kBAAkB,MAAM,EAAE,KACzB,MAAM,EAOR,CAAC;AAEF,eAAO,MAAM,2BAA2B,GACtC,SAAS,MAAM,GAAG,IAAI,GAAG,SAAS,EAClC,gBAAgB,MAAM,EAAE,KACvB,MAAM,EAMR,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,QAAQ,MAAM,EAAE,KAAG,MAAM,EAEzD,CAAC"}