@stratasync/server 0.2.0

package/dist/fastify/validation.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Zod validation schemas for sync API endpoints
+ */
+import { z } from "zod";
+/**
+ * GET /sync/bootstrap - Bootstrap query params
+ */
+export declare const BootstrapQuerySchema: z.ZodObject<{
+    onlyModels: z.ZodOptional<z.ZodString>;
+    schemaHash: z.ZodOptional<z.ZodString>;
+    syncGroups: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type BootstrapQuery = z.infer<typeof BootstrapQuerySchema>;
+/**
+ * POST /sync/batch - Batch load request body
+ */
+export declare const BatchLoadBodySchema: z.ZodObject<{
+    firstSyncId: z.ZodOptional<z.ZodString>;
+    requests: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        indexedKey: z.ZodString;
+        keyValue: z.ZodString;
+        modelName: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        groupId: z.ZodString;
+        modelName: z.ZodString;
+    }, z.core.$strip>]>>;
+}, z.core.$strip>;
+export type BatchLoadBody = z.infer<typeof BatchLoadBodySchema>;
+/**
+ * GET /sync/deltas - Delta query params
+ */
+export declare const DeltaQuerySchema: z.ZodObject<{
+    after: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodString>;
+    syncGroups: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DeltaQuery = z.infer<typeof DeltaQuerySchema>;
+/**
+ * POST /sync/mutate - Mutate request body
+ */
+export declare const MutateBodySchema: z.ZodObject<{
+    batchId: z.ZodString;
+    transactions: z.ZodArray<z.ZodObject<{
+        action: z.ZodEnum<{
+            INSERT: "INSERT";
+            UPDATE: "UPDATE";
+            DELETE: "DELETE";
+            ARCHIVE: "ARCHIVE";
+            UNARCHIVE: "UNARCHIVE";
+        }>;
+        clientId: z.ZodString;
+        clientTxId: z.ZodString;
+        modelId: z.ZodString;
+        modelName: z.ZodString;
+        payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type MutateBody = z.infer<typeof MutateBodySchema>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/fastify/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/fastify/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;iBAI/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAqBlE;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;iBAQ9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;iBAI3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAyB1D;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;iBAK3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/fastify/validation.js

@@ -0,0 +1,79 @@
+/**
+ * Zod validation schemas for sync API endpoints
+ */
+import { z } from "zod";
+/**
+ * GET /sync/bootstrap - Bootstrap query params
+ */
+export const BootstrapQuerySchema = z.object({
+    onlyModels: z.string().optional(),
+    schemaHash: z.string().optional(),
+    syncGroups: z.string().optional(),
+});
+/**
+ * Individual batch request -- either indexed (by key/value) or group-based
+ */
+const BatchRequestIndexedSchema = z.object({
+    indexedKey: z.string().min(1),
+    keyValue: z.string().min(1),
+    modelName: z.string().min(1, "Model name is required"),
+});
+const BatchRequestGroupSchema = z.object({
+    groupId: z.string().min(1, "Group ID is required"),
+    modelName: z.string().min(1, "Model name is required"),
+});
+const BatchRequestSchema = z.union([
+    BatchRequestIndexedSchema,
+    BatchRequestGroupSchema,
+]);
+/**
+ * POST /sync/batch - Batch load request body
+ */
+export const BatchLoadBodySchema = z.object({
+    firstSyncId: z
+        .string()
+        .regex(/^\d+$/, "firstSyncId must be a numeric string")
+        .optional(),
+    requests: z
+        .array(BatchRequestSchema)
+        .min(1, "At least one request is required"),
+});
+/**
+ * GET /sync/deltas - Delta query params
+ */
+export const DeltaQuerySchema = z.object({
+    after: z.string().regex(/^\d+$/, "After must be a numeric string").optional(),
+    limit: z.string().regex(/^\d+$/, "Limit must be a numeric string").optional(),
+    syncGroups: z.string().optional(),
+});
+/**
+ * Transaction action enum
+ */
+const TransactionActionSchema = z.enum([
+    "INSERT",
+    "UPDATE",
+    "DELETE",
+    "ARCHIVE",
+    "UNARCHIVE",
+]);
+/**
+ * Individual transaction in a mutate request
+ */
+const TransactionSchema = z.object({
+    action: TransactionActionSchema,
+    clientId: z.string().min(1, "Client ID is required"),
+    clientTxId: z.string().min(1, "Client transaction ID is required"),
+    modelId: z.string().uuid("Model ID must be a valid UUID"),
+    modelName: z.string().min(1, "Model name is required"),
+    payload: z.record(z.string(), z.unknown()),
+});
+/**
+ * POST /sync/mutate - Mutate request body
+ */
+export const MutateBodySchema = z.object({
+    batchId: z.string().min(1, "Batch ID is required"),
+    transactions: z
+        .array(TransactionSchema)
+        .min(1, "At least one transaction is required"),
+});
+//# sourceMappingURL=validation.js.map

package/dist/fastify/validation.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+export type { BootstrapRequest, DeltaPacket, GraphQLTransactionAction, ModelAction, MutateInput, MutateResult, SerializedSyncActionOutput, SyncActionOutput, SyncIdString, SyncUserContext, TransactionInput, TransactionResult, } from "./types.js";
+export { mapGraphQLAction } from "./types.js";
+export type { BootstrapFieldDef, BootstrapFilterContext, BootstrapModelConfig, CompositeMutateConfig, CursorConfig, FieldSpec, FieldType, MutationContext, RedisClient, StandardMutateConfig, SyncAuthConfig, SyncAuthPayload, SyncLogger, SyncModelConfig, SyncServer, SyncServerConfig, WebSocketConnectionContext, WebSocketHooks, } from "./config.js";
+export { noopLogger } from "./config.js";
+export { dateOnlyStringToEpoch, epochToDateOnlyString, toDateOnlyDateOrNull, toDateOnlyEpoch, toDateOnlyStringOrNull, toInstantDateOrNull, toInstantEpoch, } from "./utils/dates.js";
+export { getColumn, parseSyncActionOutput, parseSyncIdString, serializeSyncActionOutput, serializeSyncId, toSyncActionOutput, } from "./utils/sync-utils.js";
+export { dedupeSyncGroups, resolvePublishedDeltaGroups, resolveRequestedSyncGroups, } from "./utils/sync-scope.js";
+export { createCompositeSyncId, DEFAULT_COMPOSITE_ID_NAMESPACE, } from "./utils/composite-ids.js";
+export type { SyncDb, SyncDbSelectBuilder, SyncDbWhereResult } from "./db.js";
+export { SyncDao } from "./dao/sync-dao.js";
+export type { SyncActionInsert, SyncDaoTables } from "./dao/sync-dao.js";
+export type { DeltaPublisherLike, DeltaSubscriberCallback, DeltaSubscriberLike, } from "./delta/delta-publisher.js";
+export { createCompositeDeltaPublisher, createDeltaPublisher, createDeltaSubscriber, createInMemoryDeltaBus, createInMemoryDeltaPublisher, createInMemoryDeltaSubscriber, safeJsonStringify, } from "./delta/delta-publisher.js";
+export { buildInsertData, buildUpdateData, parseTemporalInput, serializeSyncData, } from "./mutate/field-codecs.js";
+export { handleArchiveMutation } from "./mutate/archive-mutation.js";
+export type { ModelDef, MutationDelegate, StandardModelDef, CompositeModelDef, } from "./mutate/model-handlers.js";
+export { createCompositeDelegate, createModelHandler, createStandardDelegate, } from "./mutate/model-handlers.js";
+export { BootstrapService } from "./bootstrap/bootstrap-service.js";
+export { DeltaService } from "./delta/delta-service.js";
+export { MutateService } from "./mutate/mutate-service.js";
+export { createSyncServer } from "./create-sync-server.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,gBAAgB,EAChB,WAAW,EACX,wBAAwB,EACxB,WAAW,EACX,WAAW,EACX,YAAY,EACZ,0BAA0B,EAC1B,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG9C,YAAY,EACV,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,YAAY,EACZ,SAAS,EACT,SAAS,EACT,eAAe,EACf,WAAW,EACX,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,UAAU,EACV,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,0BAA0B,EAC1B,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACnB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,SAAS,EACT,qBAAqB,EACrB,iBAAiB,EACjB,yBAAyB,EACzB,eAAe,EACf,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,gBAAgB,EAChB,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,qBAAqB,EACrB,8BAA8B,GAC/B,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EAAE,MAAM,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAG9E,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGzE,YAAY,EACV,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,6BAA6B,EAC7B,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,4BAA4B,EAC5B,6BAA6B,EAC7B,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EACL,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAGrE,YAAY,EACV,QAAQ,EACR,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAG3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,22 @@
+export { mapGraphQLAction } from "./types.js";
+export { noopLogger } from "./config.js";
+// Utilities
+export { dateOnlyStringToEpoch, epochToDateOnlyString, toDateOnlyDateOrNull, toDateOnlyEpoch, toDateOnlyStringOrNull, toInstantDateOrNull, toInstantEpoch, } from "./utils/dates.js";
+export { getColumn, parseSyncActionOutput, parseSyncIdString, serializeSyncActionOutput, serializeSyncId, toSyncActionOutput, } from "./utils/sync-utils.js";
+export { dedupeSyncGroups, resolvePublishedDeltaGroups, resolveRequestedSyncGroups, } from "./utils/sync-scope.js";
+export { createCompositeSyncId, DEFAULT_COMPOSITE_ID_NAMESPACE, } from "./utils/composite-ids.js";
+// DAO
+export { SyncDao } from "./dao/sync-dao.js";
+export { createCompositeDeltaPublisher, createDeltaPublisher, createDeltaSubscriber, createInMemoryDeltaBus, createInMemoryDeltaPublisher, createInMemoryDeltaSubscriber, safeJsonStringify, } from "./delta/delta-publisher.js";
+// Field codecs
+export { buildInsertData, buildUpdateData, parseTemporalInput, serializeSyncData, } from "./mutate/field-codecs.js";
+// Archive mutation
+export { handleArchiveMutation } from "./mutate/archive-mutation.js";
+export { createCompositeDelegate, createModelHandler, createStandardDelegate, } from "./mutate/model-handlers.js";
+// Services
+export { BootstrapService } from "./bootstrap/bootstrap-service.js";
+export { DeltaService } from "./delta/delta-service.js";
+export { MutateService } from "./mutate/mutate-service.js";
+// Factory
+export { createSyncServer } from "./create-sync-server.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAuB9C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,YAAY;AACZ,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACnB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,SAAS,EACT,qBAAqB,EACrB,iBAAiB,EACjB,yBAAyB,EACzB,eAAe,EACf,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,gBAAgB,EAChB,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,qBAAqB,EACrB,8BAA8B,GAC/B,MAAM,0BAA0B,CAAC;AAKlC,MAAM;AACN,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAS5C,OAAO,EACL,6BAA6B,EAC7B,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,4BAA4B,EAC5B,6BAA6B,EAC7B,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AAEpC,eAAe;AACf,OAAO,EACL,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAElC,mBAAmB;AACnB,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AASrE,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AAEpC,WAAW;AACX,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,UAAU;AACV,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/mutate/archive-mutation.d.ts

@@ -0,0 +1,10 @@
+interface ArchiveMutationOptions {
+    db: unknown;
+    modelId: string;
+    payload: Record<string, unknown>;
+    action: "A" | "V";
+    updateById: (db: unknown, id: string, data: Record<string, unknown>) => Promise<void>;
+}
+export declare const handleArchiveMutation: (options: ArchiveMutationOptions) => Promise<Record<string, unknown>>;
+export {};
+//# sourceMappingURL=archive-mutation.d.ts.map

package/dist/mutate/archive-mutation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive-mutation.d.ts","sourceRoot":"","sources":["../../src/mutate/archive-mutation.ts"],"names":[],"mappings":"AAGA,UAAU,sBAAsB;IAC9B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,MAAM,EAAE,GAAG,GAAG,GAAG,CAAC;IAClB,UAAU,EAAE,CACV,EAAE,EAAE,OAAO,EACX,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED,eAAO,MAAM,qBAAqB,GAChC,SAAS,sBAAsB,KAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBjC,CAAC"}

package/dist/mutate/archive-mutation.js

@@ -0,0 +1,14 @@
+import { toInstantEpoch } from "../utils/dates.js";
+import { parseTemporalInput } from "./field-codecs.js";
+export const handleArchiveMutation = async (options) => {
+    if (options.action === "A") {
+        const archivedAt = parseTemporalInput("instant", options.payload.archivedAt, "archivedAt");
+        await options.updateById(options.db, options.modelId, { archivedAt });
+        return {
+            archivedAt: toInstantEpoch(archivedAt),
+        };
+    }
+    await options.updateById(options.db, options.modelId, { archivedAt: null });
+    return { archivedAt: null };
+};
+//# sourceMappingURL=archive-mutation.js.map

package/dist/mutate/archive-mutation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive-mutation.js","sourceRoot":"","sources":["../../src/mutate/archive-mutation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAcvD,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,EACxC,OAA+B,EACG,EAAE;IACpC,IAAI,OAAO,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,kBAAkB,CACnC,SAAS,EACT,OAAO,CAAC,OAAO,CAAC,UAAU,EAC1B,YAAY,CACb,CAAC;QAEF,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;QAEtE,OAAO;YACL,UAAU,EAAE,cAAc,CAAC,UAAU,CAAC;SACvC,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5E,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;AAC9B,CAAC,CAAC"}

package/dist/mutate/field-codecs.d.ts

@@ -0,0 +1,15 @@
+export type FieldType = "string" | "stringNull" | "number" | "date" | "dateNow" | "dateOnly";
+export interface FieldSpec {
+    type: FieldType;
+    defaultValue?: unknown;
+}
+type TemporalInputKind = "dateOnly" | "instant";
+export declare const parseTemporalInput: (kind: TemporalInputKind, value: unknown, key: string) => Date | null;
+export declare const buildInsertData: (modelId: string | null, payload: Record<string, unknown>, fields: Record<string, FieldSpec>) => Record<string, unknown>;
+export declare const buildUpdateData: (payload: Record<string, unknown>, allowedFields: Set<string>, fieldSpecs: Record<string, FieldSpec>) => Record<string, unknown>;
+export declare const serializeSyncData: (data: Record<string, unknown>, fieldSpecs: Record<string, FieldSpec>, options?: {
+    modelId?: string | null;
+    keys?: Iterable<string>;
+}) => Record<string, unknown>;
+export {};
+//# sourceMappingURL=field-codecs.d.ts.map

package/dist/mutate/field-codecs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-codecs.d.ts","sourceRoot":"","sources":["../../src/mutate/field-codecs.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,YAAY,GACZ,QAAQ,GACR,MAAM,GACN,SAAS,GACT,UAAU,CAAC;AAEf,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,KAAK,iBAAiB,GAAG,UAAU,GAAG,SAAS,CAAC;AAEhD,eAAO,MAAM,kBAAkB,GAC7B,MAAM,iBAAiB,EACvB,OAAO,OAAO,EACd,KAAK,MAAM,KACV,IAAI,GAAG,IAmBT,CAAC;AAqDF,eAAO,MAAM,eAAe,GAC1B,SAAS,MAAM,GAAG,IAAI,EACtB,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,KAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAYxB,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,eAAe,GAAG,CAAC,MAAM,CAAC,EAC1B,YAAY,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,KACpC,MAAM,CAAC,MAAM,EAAE,OAAO,CAYxB,CAAC;AAoBF,eAAO,MAAM,iBAAiB,GAC5B,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,YAAY,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EACrC,UAAS;IACP,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;CACpB,KACL,MAAM,CAAC,MAAM,EAAE,OAAO,CAaxB,CAAC"}

package/dist/mutate/field-codecs.js

@@ -0,0 +1,103 @@
+import { toDateOnlyDateOrNull, toDateOnlyEpoch, toInstantDateOrNull, toInstantEpoch, } from "../utils/dates.js";
+export const parseTemporalInput = (kind, value, key) => {
+    if (value === null || value === undefined) {
+        return null;
+    }
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+        throw new TypeError(`Invalid ${kind} value for ${key}`);
+    }
+    const parsed = kind === "dateOnly"
+        ? toDateOnlyDateOrNull(value)
+        : toInstantDateOrNull(value);
+    if (parsed === null) {
+        throw new Error(`Invalid ${kind} value for ${key}`);
+    }
+    return parsed;
+};
+const coerceInsertValue = (key, raw, spec) => {
+    switch (spec.type) {
+        case "dateOnly": {
+            return parseTemporalInput("dateOnly", raw, key);
+        }
+        case "date": {
+            return parseTemporalInput("instant", raw, key);
+        }
+        case "dateNow": {
+            return raw === null || raw === undefined
+                ? new Date()
+                : parseTemporalInput("instant", raw, key);
+        }
+        case "number": {
+            return raw ?? spec.defaultValue ?? 0;
+        }
+        case "string": {
+            return raw ?? spec.defaultValue;
+        }
+        case "stringNull": {
+            return raw ?? null;
+        }
+        default: {
+            return raw ?? spec.defaultValue;
+        }
+    }
+};
+const coerceUpdateValue = (key, raw, spec) => {
+    switch (spec?.type) {
+        case "dateOnly": {
+            return parseTemporalInput("dateOnly", raw, key);
+        }
+        case "date":
+        case "dateNow": {
+            return parseTemporalInput("instant", raw, key);
+        }
+        default: {
+            return raw;
+        }
+    }
+};
+export const buildInsertData = (modelId, payload, fields) => {
+    const data = {};
+    if (modelId !== null) {
+        data.id = modelId;
+    }
+    for (const [column, spec] of Object.entries(fields)) {
+        data[column] = coerceInsertValue(column, payload[column], spec);
+    }
+    return data;
+};
+export const buildUpdateData = (payload, allowedFields, fieldSpecs) => {
+    const updateData = {};
+    for (const [key, value] of Object.entries(payload)) {
+        if (!allowedFields.has(key) || value === undefined) {
+            continue;
+        }
+        updateData[key] = coerceUpdateValue(key, value, fieldSpecs[key]);
+    }
+    return updateData;
+};
+const serializeSyncValue = (value, spec) => {
+    switch (spec?.type) {
+        case "dateOnly": {
+            return toDateOnlyEpoch(value);
+        }
+        case "date":
+        case "dateNow": {
+            return toInstantEpoch(value);
+        }
+        default: {
+            return value;
+        }
+    }
+};
+export const serializeSyncData = (data, fieldSpecs, options = {}) => {
+    const keys = options.keys ? [...options.keys] : Object.keys(data);
+    const serialized = {};
+    if (typeof options.modelId === "string") {
+        serialized.id = options.modelId;
+    }
+    for (const key of keys) {
+        serialized[key] = serializeSyncValue(data[key], fieldSpecs[key]);
+    }
+    return serialized;
+};
+//# sourceMappingURL=field-codecs.js.map

package/dist/mutate/field-codecs.js.map

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

package/dist/mutate/model-handlers.d.ts

@@ -0,0 +1,32 @@
+import type { SQL } from "drizzle-orm";
+import type { AnyPgTable } from "drizzle-orm/pg-core";
+import type { ModelAction } from "../types.js";
+import type { FieldSpec } from "./field-codecs.js";
+export interface MutationDelegate {
+    insert: (db: unknown, data: Record<string, unknown>) => Promise<void>;
+    updateById?: (db: unknown, id: string, data: Record<string, unknown>) => Promise<void>;
+    deleteById?: (db: unknown, id: string) => Promise<void>;
+    deleteByPayload?: (db: unknown, payload: Record<string, unknown>) => Promise<void>;
+}
+export declare const createStandardDelegate: <TTable extends AnyPgTable>(table: TTable, idField: string) => MutationDelegate;
+export declare const createCompositeDelegate: <TTable extends AnyPgTable>(table: TTable, buildDeleteWhere: (payload: Record<string, unknown>) => SQL<unknown>) => MutationDelegate;
+export interface StandardModelDef {
+    kind: "standard";
+    delegate: MutationDelegate;
+    actions: Set<ModelAction>;
+    insertFields: Record<string, FieldSpec>;
+    updateFields?: Set<string>;
+    onBeforeInsert?: (db: unknown, modelId: string, payload: Record<string, unknown>, data: Record<string, unknown>) => Record<string, unknown> | Promise<Record<string, unknown>>;
+    onBeforeUpdate?: (db: unknown, modelId: string, payload: Record<string, unknown>, data: Record<string, unknown>) => Record<string, unknown> | Promise<Record<string, unknown>>;
+}
+export interface CompositeModelDef {
+    kind: "composite";
+    delegate: MutationDelegate;
+    actions: Set<ModelAction>;
+    insertFields: Record<string, FieldSpec>;
+}
+export type ModelDef = StandardModelDef | CompositeModelDef;
+type ModelHandler = (db: unknown, modelId: string, payload: Record<string, unknown>, action: ModelAction) => Promise<Record<string, unknown>>;
+export declare const createModelHandler: (def: ModelDef) => ModelHandler;
+export {};
+//# sourceMappingURL=model-handlers.d.ts.map

package/dist/mutate/model-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-handlers.d.ts","sourceRoot":"","sources":["../../src/mutate/model-handlers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAoB,GAAG,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAWnD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,UAAU,CAAC,EAAE,CACX,EAAE,EAAE,OAAO,EACX,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,UAAU,CAAC,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,eAAe,CAAC,EAAE,CAChB,EAAE,EAAE,OAAO,EACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED,eAAO,MAAM,sBAAsB,GAAI,MAAM,SAAS,UAAU,EAC9D,OAAO,MAAM,EACb,SAAS,MAAM,KACd,gBAiCF,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,MAAM,SAAS,UAAU,EAC/D,OAAO,MAAM,EACb,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,GAAG,CAAC,OAAO,CAAC,KACnE,gBAeD,CAAC;AAMH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,OAAO,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACxC,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,cAAc,CAAC,EAAE,CACf,EAAE,EAAE,OAAO,EACX,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAChE,cAAc,CAAC,EAAE,CACf,EAAE,EAAE,OAAO,EACX,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACjE;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,OAAO,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACzC;AAED,MAAM,MAAM,QAAQ,GAAG,gBAAgB,GAAG,iBAAiB,CAAC;AAM5D,KAAK,YAAY,GAAG,CAClB,EAAE,EAAE,OAAO,EACX,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,MAAM,EAAE,WAAW,KAChB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAmFtC,eAAO,MAAM,kBAAkB,GAC5B,KAAK,QAAQ,KAAG,YA4ChB,CAAC"}

package/dist/mutate/model-handlers.js

@@ -0,0 +1,131 @@
+import { eq } from "drizzle-orm";
+import { getColumn } from "../utils/sync-utils.js";
+import { handleArchiveMutation } from "./archive-mutation.js";
+import { buildInsertData, buildUpdateData, serializeSyncData, } from "./field-codecs.js";
+export const createStandardDelegate = (table, idField) => {
+    const idColumn = getColumn(table, idField);
+    return {
+        deleteById: async (db, id) => {
+            await db
+                .delete(table)
+                .where(eq(idColumn, id));
+        },
+        insert: async (db, data) => {
+            await db
+                .insert(table)
+                .values(data);
+        },
+        updateById: async (db, id, data) => {
+            await db
+                .update(table)
+                .set(data)
+                .where(eq(idColumn, id));
+        },
+    };
+};
+export const createCompositeDelegate = (table, buildDeleteWhere) => ({
+    deleteByPayload: async (db, payload) => {
+        await db
+            .delete(table)
+            .where(buildDeleteWhere(payload));
+    },
+    insert: async (db, data) => {
+        await db
+            .insert(table)
+            .values(data);
+    },
+});
+const handleInsert = async (db, def, modelId, payload) => {
+    const hasId = def.kind === "standard";
+    let data = buildInsertData(hasId ? modelId : null, payload, def.insertFields);
+    if (def.kind === "standard" && def.onBeforeInsert) {
+        data = await def.onBeforeInsert(db, modelId, payload, data);
+    }
+    await def.delegate.insert(db, data);
+    return serializeSyncData(data, def.insertFields, {
+        modelId: hasId ? modelId : null,
+    });
+};
+const handleUpdate = async (db, def, modelId, payload) => {
+    if (def.kind !== "standard" || !def.updateFields) {
+        throw new Error("Update not configured for this model");
+    }
+    if (!def.delegate.updateById) {
+        throw new Error("Update delegate missing for this model");
+    }
+    let updateData = buildUpdateData(payload, def.updateFields, def.insertFields);
+    if (def.onBeforeUpdate) {
+        updateData = await def.onBeforeUpdate(db, modelId, payload, updateData);
+    }
+    if (Object.keys(updateData).length === 0) {
+        return {};
+    }
+    await def.delegate.updateById(db, modelId, updateData);
+    return serializeSyncData(updateData, def.insertFields, {
+        keys: Object.keys(updateData),
+    });
+};
+const handleDelete = async (db, def, modelId, payload) => {
+    if (def.kind === "composite") {
+        if (!def.delegate.deleteByPayload) {
+            throw new Error("Composite delete delegate missing for this model");
+        }
+        await def.delegate.deleteByPayload(db, payload);
+        return payload;
+    }
+    if (!def.delegate.deleteById) {
+        throw new Error("Delete delegate missing for this model");
+    }
+    await def.delegate.deleteById(db, modelId);
+    return payload;
+};
+const getStandardUpdateDelegate = (def, actionLabel) => {
+    if (!def.delegate.updateById) {
+        throw new Error(`${actionLabel} delegate missing for this model`);
+    }
+    return def.delegate.updateById;
+};
+export const createModelHandler = (def) => (db, modelId, payload, action) => {
+    if (!def.actions.has(action)) {
+        throw new Error(`Unsupported action "${action}" for this model`);
+    }
+    switch (action) {
+        case "I": {
+            return handleInsert(db, def, modelId, payload);
+        }
+        case "U": {
+            return handleUpdate(db, def, modelId, payload);
+        }
+        case "D": {
+            return handleDelete(db, def, modelId, payload);
+        }
+        case "A": {
+            if (def.kind !== "standard") {
+                throw new Error("Archive not configured for this model");
+            }
+            return handleArchiveMutation({
+                action: "A",
+                db,
+                modelId,
+                payload,
+                updateById: getStandardUpdateDelegate(def, "Archive"),
+            });
+        }
+        case "V": {
+            if (def.kind !== "standard") {
+                throw new Error("Unarchive not configured for this model");
+            }
+            return handleArchiveMutation({
+                action: "V",
+                db,
+                modelId,
+                payload,
+                updateById: getStandardUpdateDelegate(def, "Unarchive"),
+            });
+        }
+        default: {
+            throw new Error(`Unknown action: ${action}`);
+        }
+    }
+};
+//# sourceMappingURL=model-handlers.js.map

package/dist/mutate/model-handlers.js.map

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

package/dist/mutate/mutate-service.d.ts

@@ -0,0 +1,30 @@
+import type { SyncLogger, SyncModelConfig } from "../config.js";
+import type { SyncDao } from "../dao/sync-dao.js";
+import type { MutateInput, MutateResult, SyncActionOutput, SyncUserContext, TransactionInput } from "../types.js";
+export declare class MutateService {
+    private readonly dao;
+    private readonly db;
+    private readonly logger;
+    private readonly modelHandlers;
+    private readonly modelGroupKeys;
+    private readonly modelDelegates;
+    private readonly modelConfigs;
+    constructor(db: unknown, dao: SyncDao, models: Record<string, SyncModelConfig>, logger?: SyncLogger);
+    /**
+     * Resolve the groupId for a sync action.
+     */
+    private resolveGroupId;
+    private lookupGroupId;
+    private static validateGroupAccess;
+    private static createDuplicateTransactionResult;
+    private prepareTransaction;
+    private applyModelMutation;
+    private resolveAuthorizedGroupId;
+    private static publishSyncAction;
+    static validateTransaction(tx: TransactionInput): string[];
+    private static createSuccessResult;
+    private createSyncActionWithDeduplication;
+    private processTransaction;
+    mutate(context: SyncUserContext, input: MutateInput, onAction?: (action: SyncActionOutput) => void): Promise<MutateResult>;
+}
+//# sourceMappingURL=mutate-service.d.ts.map

package/dist/mutate/mutate-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutate-service.d.ts","sourceRoot":"","sources":["../../src/mutate/mutate-service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEhE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EAEZ,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAEjB,MAAM,aAAa,CAAC;AAmFrB,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAU;IAC9B,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAU;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAQ5B;IACF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyB;IACxD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA8B;IAC7D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkC;gBAG7D,EAAE,EAAE,OAAO,EACX,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EACvC,MAAM,GAAE,UAAuB;IAuEjC;;OAEG;YACW,cAAc;YA0Cd,aAAa;IAc3B,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAelC,OAAO,CAAC,MAAM,CAAC,gCAAgC;IAoB/C,OAAO,CAAC,kBAAkB;YAwBZ,kBAAkB;YAkBlB,wBAAwB;IAsBtC,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAWhC,MAAM,CAAC,mBAAmB,CAAC,EAAE,EAAE,gBAAgB,GAAG,MAAM,EAAE;IA6B1D,OAAO,CAAC,MAAM,CAAC,mBAAmB;YAWpB,iCAAiC;YAoCjC,kBAAkB;IAyG1B,MAAM,CACV,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,WAAW,EAClB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,GAC5C,OAAO,CAAC,YAAY,CAAC;CAyCzB"}