velocious 1.0.492 → 1.0.493

package/build/src/sync/sync-replay-upsert-applier.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Declarative field-map upsert applier for sync replay mutations.
+ *
+ * Owns the generic mechanics every per-resource replay handler repeats:
+ * present-key filtering, per-field type coercion, unknown-key rejection, the
+ * find-or-create upsert, the delete branch, optional snapshot serialization,
+ * and the domain after-apply tail. Apps declare only the field map and hooks.
+ */
+export default class SyncReplayUpsertApplier {
+    /**
+     * Creates a declarative upsert applier.
+     * @param {object} args - Applier configuration.
+     * @param {?} args.modelClass - Model class receiving the mutations.
+     * @param {Record<string, string | {type: string, column?: string} | ((value: ?, label: string) => ?)>} args.fields - Data-key → field-type map: a named type, a {type, column} rename spec, "ignored" for accepted-but-dropped keys, or a custom coercer function.
+     * @param {(args: {data: Record<string, ?>, mutation: ?, context: Record<string, ?>}) => Promise<?>} [args.findRecord] - Custom record resolver. Defaults to findBy({id: mutation.resourceId}).
+     * @param {(args: {mutation: ?, context: Record<string, ?>}) => Promise<?>} [args.findRecordForDelete] - Custom delete resolver. Defaults to findRecord.
+     * @param {"error" | "ignore"} [args.restArgs] - Unknown data-key handling. Defaults to "error".
+     * @param {(args: {mappedAttributes: Record<string, ?>, mutation: ?, context: Record<string, ?>, record: ?}) => Promise<Record<string, ?> | void>} [args.afterApply] - Domain tail; its returned object merges into the apply result.
+     * @param {(args: {mutation: ?, context: Record<string, ?>, record: ?}) => Promise<Record<string, ?>> | Record<string, ?>} [args.serialize] - Snapshot serializer; result lands on applyResult.serializedData.
+     */
+    constructor({ afterApply, fields, findRecord, findRecordForDelete, modelClass, restArgs, serialize }: {
+        modelClass: unknown;
+        fields: Record<string, string | {
+            type: string;
+            column?: string;
+        } | ((value: unknown, label: string) => unknown)>;
+        findRecord?: ((args: {
+            data: Record<string, unknown>;
+            mutation: unknown;
+            context: Record<string, unknown>;
+        }) => Promise<unknown>) | undefined;
+        findRecordForDelete?: ((args: {
+            mutation: unknown;
+            context: Record<string, unknown>;
+        }) => Promise<unknown>) | undefined;
+        restArgs?: "error" | "ignore" | undefined;
+        afterApply?: ((args: {
+            mappedAttributes: Record<string, unknown>;
+            mutation: unknown;
+            context: Record<string, unknown>;
+            record: unknown;
+        }) => Promise<Record<string, unknown> | void>) | undefined;
+        serialize?: ((args: {
+            mutation: unknown;
+            context: Record<string, unknown>;
+            record: unknown;
+        }) => Promise<Record<string, unknown>> | Record<string, unknown>) | undefined;
+    });
+    afterApply: ((args: {
+        mappedAttributes: Record<string, unknown>;
+        mutation: unknown;
+        context: Record<string, unknown>;
+        record: unknown;
+    }) => Promise<Record<string, unknown> | void>) | undefined;
+    fields: Record<string, string | {
+        type: string;
+        column?: string;
+    } | ((value: unknown, label: string) => unknown)>;
+    findRecord: ((args: {
+        data: Record<string, unknown>;
+        mutation: unknown;
+        context: Record<string, unknown>;
+    }) => Promise<unknown>) | undefined;
+    findRecordForDelete: ((args: {
+        mutation: unknown;
+        context: Record<string, unknown>;
+    }) => Promise<unknown>) | undefined;
+    modelClass: any;
+    restArgs: "error" | "ignore";
+    serialize: ((args: {
+        mutation: unknown;
+        context: Record<string, unknown>;
+        record: unknown;
+    }) => Promise<Record<string, unknown>> | Record<string, unknown>) | undefined;
+    /**
+     * Applies one normalized replay mutation to the declared model.
+     * @param {{actor: ?, context: Record<string, ?>, existingSync: ?, mutation: ?}} args - Replay apply arguments.
+     * @returns {Promise<Record<string, ?>>} Apply result with the record, created/deleted flags, optional serializedData, and afterApply extras.
+     */
+    apply({ context, mutation }: {
+        actor: unknown;
+        context: Record<string, unknown>;
+        existingSync: unknown;
+        mutation: unknown;
+    }): Promise<Record<string, unknown>>;
+    /**
+     * Applies a delete mutation to the declared model.
+     * @param {{context: Record<string, ?>, mutation: ?}} args - Delete arguments.
+     * @returns {Promise<Record<string, ?>>} Apply result with the deleted flag.
+     */
+    applyDelete({ context, mutation }: {
+        context: Record<string, unknown>;
+        mutation: unknown;
+    }): Promise<Record<string, unknown>>;
+    /**
+     * Maps present data keys through the declared field types.
+     * @param {Record<string, ?>} data - Normalized mutation data.
+     * @returns {Record<string, ?>} Coerced attributes keyed by column name.
+     */
+    mappedAttributes(data: Record<string, unknown>): Record<string, unknown>;
+}
+//# sourceMappingURL=sync-replay-upsert-applier.d.ts.map

package/build/src/sync/sync-replay-upsert-applier.d.ts.map

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

package/build/src/sync/sync-replay-upsert-applier.js

@@ -0,0 +1,158 @@
+// @ts-check
+import { optionalFloat, optionalInteger, optionalString } from "typanic";
+import SyncApiClient from "./sync-api-client.js";
+/**
+ * Coercers for the declarative sync field types. All are present-key based:
+ * a field is only applied when its key exists in the mutation data.
+ * @type {Record<string, (value: ?, label: string) => ?>}
+ */
+const FIELD_TYPES = {
+    booleanOrNull: (value, label) => SyncApiClient.optionalBooleanSyncValue(value, label),
+    dateOrNull: (value, label) => optionalSyncDate(value, label),
+    floatOrNull: (value, label) => optionalFloat(value, label),
+    integerOrNull: (value, label) => optionalInteger(value, label),
+    raw: (value) => value,
+    stringOrNull: (value, label) => optionalString(value, label)
+};
+/**
+ * Parses an optional date value, failing loudly on invalid input.
+ * @param {?} value - Date, parseable string, or epoch number.
+ * @param {string} label - Field label for error messages.
+ * @returns {Date | null} Parsed date or null when absent.
+ */
+function optionalSyncDate(value, label) {
+    if (value === null || value === undefined)
+        return null;
+    if (value instanceof Date && !Number.isNaN(value.getTime()))
+        return value;
+    if (typeof value === "string" || typeof value === "number") {
+        const dateValue = new Date(value);
+        if (!Number.isNaN(dateValue.getTime()))
+            return dateValue;
+    }
+    throw new Error(`Expected ${label} to be a valid date or null`);
+}
+/**
+ * Declarative field-map upsert applier for sync replay mutations.
+ *
+ * Owns the generic mechanics every per-resource replay handler repeats:
+ * present-key filtering, per-field type coercion, unknown-key rejection, the
+ * find-or-create upsert, the delete branch, optional snapshot serialization,
+ * and the domain after-apply tail. Apps declare only the field map and hooks.
+ */
+export default class SyncReplayUpsertApplier {
+    /**
+     * Creates a declarative upsert applier.
+     * @param {object} args - Applier configuration.
+     * @param {?} args.modelClass - Model class receiving the mutations.
+     * @param {Record<string, string | {type: string, column?: string} | ((value: ?, label: string) => ?)>} args.fields - Data-key → field-type map: a named type, a {type, column} rename spec, "ignored" for accepted-but-dropped keys, or a custom coercer function.
+     * @param {(args: {data: Record<string, ?>, mutation: ?, context: Record<string, ?>}) => Promise<?>} [args.findRecord] - Custom record resolver. Defaults to findBy({id: mutation.resourceId}).
+     * @param {(args: {mutation: ?, context: Record<string, ?>}) => Promise<?>} [args.findRecordForDelete] - Custom delete resolver. Defaults to findRecord.
+     * @param {"error" | "ignore"} [args.restArgs] - Unknown data-key handling. Defaults to "error".
+     * @param {(args: {mappedAttributes: Record<string, ?>, mutation: ?, context: Record<string, ?>, record: ?}) => Promise<Record<string, ?> | void>} [args.afterApply] - Domain tail; its returned object merges into the apply result.
+     * @param {(args: {mutation: ?, context: Record<string, ?>, record: ?}) => Promise<Record<string, ?>> | Record<string, ?>} [args.serialize] - Snapshot serializer; result lands on applyResult.serializedData.
+     */
+    constructor({ afterApply, fields, findRecord, findRecordForDelete, modelClass, restArgs = "error", serialize }) {
+        if (!modelClass)
+            throw new Error("SyncReplayUpsertApplier requires a modelClass");
+        if (!fields || typeof fields !== "object")
+            throw new Error("SyncReplayUpsertApplier requires a fields map");
+        if (restArgs !== "error" && restArgs !== "ignore") {
+            throw new Error(`SyncReplayUpsertApplier restArgs must be "error" or "ignore", got: ${String(restArgs)}`);
+        }
+        for (const [fieldName, fieldSpec] of Object.entries(fields)) {
+            if (typeof fieldSpec === "function")
+                continue;
+            const fieldType = typeof fieldSpec === "string" ? fieldSpec : fieldSpec.type;
+            if (fieldType !== "ignored" && !(fieldType in FIELD_TYPES)) {
+                throw new Error(`Unknown sync field type: ${fieldType} for: ${fieldName}`);
+            }
+        }
+        this.afterApply = afterApply;
+        this.fields = fields;
+        this.findRecord = findRecord;
+        this.findRecordForDelete = findRecordForDelete;
+        this.modelClass = modelClass;
+        this.restArgs = restArgs;
+        this.serialize = serialize;
+    }
+    /**
+     * Applies one normalized replay mutation to the declared model.
+     * @param {{actor: ?, context: Record<string, ?>, existingSync: ?, mutation: ?}} args - Replay apply arguments.
+     * @returns {Promise<Record<string, ?>>} Apply result with the record, created/deleted flags, optional serializedData, and afterApply extras.
+     */
+    async apply({ context, mutation }) {
+        if (mutation.syncType === "delete")
+            return await this.applyDelete({ context, mutation });
+        const mappedAttributes = this.mappedAttributes(mutation.data);
+        const record = this.findRecord
+            ? await this.findRecord({ context, data: mutation.data, mutation })
+            : await this.modelClass.findBy({ id: mutation.resourceId });
+        /** @type {Record<string, ?>} */
+        const result = { created: false, deleted: false, record: null };
+        if (record) {
+            record.assign(mappedAttributes);
+            await record.save();
+            result.record = record;
+        }
+        else {
+            result.record = await this.modelClass.create({ id: mutation.resourceId, ...mappedAttributes });
+            result.created = true;
+        }
+        if (this.serialize)
+            result.serializedData = await this.serialize({ context, mutation, record: result.record });
+        if (this.afterApply) {
+            const afterApplyResult = await this.afterApply({ context, mappedAttributes, mutation, record: result.record });
+            if (afterApplyResult && typeof afterApplyResult === "object")
+                Object.assign(result, afterApplyResult);
+        }
+        return result;
+    }
+    /**
+     * Applies a delete mutation to the declared model.
+     * @param {{context: Record<string, ?>, mutation: ?}} args - Delete arguments.
+     * @returns {Promise<Record<string, ?>>} Apply result with the deleted flag.
+     */
+    async applyDelete({ context, mutation }) {
+        const resolveRecord = this.findRecordForDelete || this.findRecord;
+        const record = resolveRecord
+            ? await resolveRecord({ context, data: mutation.data, mutation })
+            : await this.modelClass.findBy({ id: mutation.resourceId });
+        if (!record)
+            return { created: false, deleted: false, record: null };
+        await record.destroy();
+        return { created: false, deleted: true, record };
+    }
+    /**
+     * Maps present data keys through the declared field types.
+     * @param {Record<string, ?>} data - Normalized mutation data.
+     * @returns {Record<string, ?>} Coerced attributes keyed by column name.
+     */
+    mappedAttributes(data) {
+        /** @type {Record<string, ?>} */
+        const mappedAttributes = {};
+        /** @type {string[]} */
+        const unknownKeys = [];
+        for (const [dataKey, value] of Object.entries(data)) {
+            const fieldSpec = this.fields[dataKey];
+            if (!fieldSpec) {
+                unknownKeys.push(dataKey);
+                continue;
+            }
+            if (typeof fieldSpec === "function") {
+                mappedAttributes[dataKey] = fieldSpec(value, dataKey);
+                continue;
+            }
+            const fieldType = typeof fieldSpec === "string" ? fieldSpec : fieldSpec.type;
+            if (fieldType === "ignored")
+                continue;
+            const column = typeof fieldSpec === "string" ? dataKey : fieldSpec.column || dataKey;
+            mappedAttributes[column] = FIELD_TYPES[fieldType](value, dataKey);
+        }
+        if (unknownKeys.length > 0 && this.restArgs === "error") {
+            throw new Error(`Unknown sync data keys: ${unknownKeys.join(", ")}`);
+        }
+        return mappedAttributes;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3luYy1yZXBsYXktdXBzZXJ0LWFwcGxpZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvc3luYy9zeW5jLXJlcGxheS11cHNlcnQtYXBwbGllci5qcyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxZQUFZO0FBRVosT0FBTyxFQUFDLGFBQWEsRUFBRSxlQUFlLEVBQUUsY0FBYyxFQUFDLE1BQU0sU0FBUyxDQUFBO0FBRXRFLE9BQU8sYUFBYSxNQUFNLHNCQUFzQixDQUFBO0FBRWhEOzs7O0dBSUc7QUFDSCxNQUFNLFdBQVcsR0FBRztJQUNsQixhQUFhLEVBQUUsQ0FBQyxLQUFLLEVBQUUsS0FBSyxFQUFFLEVBQUUsQ0FBQyxhQUFhLENBQUMsd0JBQXdCLENBQUMsS0FBSyxFQUFFLEtBQUssQ0FBQztJQUNyRixVQUFVLEVBQUUsQ0FBQyxLQUFLLEVBQUUsS0FBSyxFQUFFLEVBQUUsQ0FBQyxnQkFBZ0IsQ0FBQyxLQUFLLEVBQUUsS0FBSyxDQUFDO0lBQzVELFdBQVcsRUFBRSxDQUFDLEtBQUssRUFBRSxLQUFLLEVBQUUsRUFBRSxDQUFDLGFBQWEsQ0FBQyxLQUFLLEVBQUUsS0FBSyxDQUFDO0lBQzFELGFBQWEsRUFBRSxDQUFDLEtBQUssRUFBRSxLQUFLLEVBQUUsRUFBRSxDQUFDLGVBQWUsQ0FBQyxLQUFLLEVBQUUsS0FBSyxDQUFDO0lBQzlELEdBQUcsRUFBRSxDQUFDLEtBQUssRUFBRSxFQUFFLENBQUMsS0FBSztJQUNyQixZQUFZLEVBQUUsQ0FBQyxLQUFLLEVBQUUsS0FBSyxFQUFFLEVBQUUsQ0FBQyxjQUFjLENBQUMsS0FBSyxFQUFFLEtBQUssQ0FBQztDQUM3RCxDQUFBO0FBRUQ7Ozs7O0dBS0c7QUFDSCxTQUFTLGdCQUFnQixDQUFDLEtBQUssRUFBRSxLQUFLO0lBQ3BDLElBQUksS0FBSyxLQUFLLElBQUksSUFBSSxLQUFLLEtBQUssU0FBUztRQUFFLE9BQU8sSUFBSSxDQUFBO0lBRXRELElBQUksS0FBSyxZ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QU0sQ0FBQyxPQUFPLENBQUMsQ0FBQTtZQUV0QyxJQUFJLENBQUMsU0FBUyxFQUFFLENBQUM7Z0JBQ2YsV0FBVyxDQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsQ0FBQTtnQkFDekIsU0FBUTtZQUNWLENBQUM7WUFFRCxJQUFJLE9BQU8sU0FBUyxLQUFLLFVBQVUsRUFBRSxDQUFDO2dCQUNwQyxnQkFBZ0IsQ0FBQyxPQUFPLENBQUMsR0FBRyxTQUFTLENBQUMsS0FBSyxFQUFFLE9BQU8sQ0FBQyxDQUFBO2dCQUNyRCxTQUFRO1lBQ1YsQ0FBQztZQUVELE1BQU0sU0FBUyxHQUFHLE9BQU8sU0FBUyxLQUFLLFFBQVEsQ0FBQyxDQUFDLENBQUMsU0FBUyxDQUFDLENBQUMsQ0FBQyxTQUFTLENBQUMsSUFBSSxDQUFBO1lBRTVFLElBQUksU0FBUyxLQUFLLFNBQVM7Z0JBQUUsU0FBUTtZQUVyQyxNQUFNLE1BQU0sR0FBRyxPQUFPLFNBQVMsS0FBSyxRQUFRLENBQUMsQ0FBQyxDQUFDLE9BQU8sQ0FBQyxDQUFDLENBQUMsU0FBUyxDQUFDLE1BQU0sSUFBSSxPQUFPLENBQUE7WUFFcEYsZ0JBQWdCLENBQUMsTUFBTSxDQUFDLEdBQUcsV0FBVyxDQUFDLFNBQVMsQ0FBQyxDQUFDLEtBQUssRUFBRSxPQUFPLENBQUMsQ0FBQTtRQUNuRSxDQUFDO1FBRUQsSUFBSSxXQUFXLENBQUMsTUFBTSxHQUFHLENBQUMsSUFBSSxJQUFJLENBQUMsUUFBUSxLQUFLLE9BQU8sRUFBRSxDQUFDO1lBQ3hELE1BQU0sSUFBSSxLQUFLLENBQUMsMkJBQTJCLFdBQVcsQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLEVBQUUsQ0FBQyxDQUFBO1FBQ3RFLENBQUM7UUFFRCxPQUFPLGdCQUFnQixDQUFBO0lBQ3pCLENBQUM7Q0FDRiIsInNvdXJjZXNDb250ZW50IjpbIi8vIEB0cy1jaGVja1xuXG5pbXBvcnQge29wdGlvbmFsRmxvYXQsIG9wdGlvbmFsSW50ZWdlciwgb3B0aW9uYWxTdHJpbmd9IGZyb20gXCJ0eXBhbmljXCJcblxuaW1wb3J0IFN5bmNBcGlDbGllbnQgZnJvbSBcIi4vc3luYy1hcGktY2xpZW50LmpzXCJcblxuLyoqXG4gKiBDb2VyY2VycyBmb3IgdGhlIGRlY2xhcmF0aXZlIHN5bmMgZmllbGQgdHlwZXMuIEFsbCBhcmUgcHJlc2VudC1rZXkgYmFzZWQ6XG4gKiBhIGZpZWxkIGlzIG9ubHkgYXBwbGllZCB3aGVuIGl0cyBrZXkgZXhpc3RzIGluIHRoZSBtdXRhdGlvbiBkYXRhLlxuICogQHR5cGUge1JlY29yZDxzdHJpbmcsICh2YWx1ZTogPywgbGFiZWw6IHN0cmluZykgPT4gPz59XG4gKi9cbmNvbnN0IEZJRUxEX1RZUEVTID0ge1xuICBib29sZWFuT3JOdWxsOiAodmFsdWUsIGxhYmVsKSA9PiBTeW5jQXBpQ2xpZW50Lm9wdGlvbmFsQm9vbGVhblN5bmNWYWx1ZSh2YWx1ZSwgbGFiZWwpLFxuICBkYXRlT3JOdWxsOiAodmFsdWUsIGxhYmVsKSA9PiBvcHRpb25hbFN5bmNEYXRlKHZhbHVlLCBsYWJlbCksXG4gIGZsb2F0T3JOdWxsOiAodmFsdWUsIGxhYmVsKSA9PiBvcHRpb25hbEZsb2F0KHZhbHVlLCBsYWJlbCksXG4gIGludGVnZXJPck51bGw6ICh2YWx1ZSwgbGFiZWwpID0+IG9wdGlvbmFsSW50ZWdlcih2YWx1ZSwgbGFiZWwpLFxuICByYXc6ICh2YWx1ZSkgPT4gdmFsdWUsXG4gIHN0cmluZ09yTnVsbDogKHZhbHVlLCBsYWJlbCkgPT4gb3B0aW9uYWxTdHJpbmcodmFsdWUsIGxhYmVsKVxufVxuXG4vKipcbiAqIFBhcnNlcyBhbiBvcHRpb25hbCBkYXRlIHZhbHVlLCBmYWlsaW5nIGxvdWRseSBvbiBpbnZhbGlkIGlucHV0LlxuICogQHBhcmFtIHs/fSB2YWx1ZSAtIERhdGUsIHBhcnNlYWJsZSBzdHJpbmcsIG9yIGVwb2NoIG51bWJlci5cbiAqIEBwYXJhbSB7c3RyaW5nfSBsYWJlbCAtIEZpZWxkIGxhYmVsIGZvciBlcnJvciBtZXNzYWdlcy5cbiAqIEByZXR1cm5zIHtEYXRlIHwgbnVsbH0gUGFyc2VkIGRhdGUgb3IgbnVsbCB3aGVuIGFic2VudC5cbiAqL1xuZnVuY3Rpb24gb3B0aW9uYWxTeW5jRGF0ZSh2YWx1ZSwgbGFiZWwpIHtcbiAgaWYgKHZhbHVlID09PSBudWxsIHx8IHZhbHVlID09PSB1bmRlZmluZWQpIHJldHVybiBudWxsXG5cbiAgaWYgKHZhbHVlIGluc3RhbmNlb2YgRGF0ZSAmJiAhTnVtYmVyLmlzTmFOKHZhbHVlLmdldFRpbWUoKSkpIHJldHVybiB2YWx1ZVxuXG4gIGlmICh0eXBlb2YgdmFsdWUgPT09IFwic3RyaW5nXCIgfHwgdHlwZW9mIHZhbHVlID09PSBcIm51bWJlclwiKSB7XG4gICAgY29uc3QgZGF0ZVZhbHVlID0gbmV3IERhdGUodmFsdWUpXG5cbiAgICBpZiAoIU51bWJlci5pc05hTihkYXRlVmFsdWUuZ2V0VGltZSgpKSkgcmV0dXJuIGRhdGVWYWx1ZVxuICB9XG5cbiAgdGhyb3cgbmV3IEVycm9yKGBFeHBlY3RlZCAke2xhYmVsfSB0byBiZSBhIHZhbGlkIGRhdGUgb3IgbnVsbGApXG59XG5cbi8qKlxuICogRGVjbGFyYXRpdmUgZmllbGQtbWFwIHVwc2VydCBhcHBsaWVyIGZvciBzeW5jIHJlcGxheSBtdXRhdGlvbnMuXG4gKlxuICogT3ducyB0aGUgZ2VuZXJpYyBtZWNoYW5pY3MgZXZlcnkgcGVyLXJlc291cmNlIHJlcGxheSBoYW5kbGVyIHJlcGVhdHM6XG4gKiBwcmVzZW50LWtleSBmaWx0ZXJpbmcsIHBlci1maWVsZCB0eXBlIGNvZXJjaW9uLCB1bmtub3duLWtleSByZWplY3Rpb24sIHRoZVxuICogZmluZC1vci1jcmVhdGUgdXBzZXJ0LCB0aGUgZGVsZXRlIGJyYW5jaCwgb3B0aW9uYWwgc25hcHNob3Qgc2VyaWFsaXphdGlvbixcbiAqIGFuZCB0aGUgZG9tYWluIGFmdGVyLWFwcGx5IHRhaWwuIEFwcHMgZGVjbGFyZSBvbmx5IHRoZSBmaWVsZCBtYXAgYW5kIGhvb2tzLlxuICovXG5leHBvcnQgZGVmYXVsdCBjbGFzcyBTeW5jUmVwbGF5VXBzZXJ0QXBwbGllciB7XG4gIC8qKlxuICAgKiBDcmVhdGVzIGEgZGVjbGFyYXRpdmUgdXBzZXJ0IGFwcGxpZXIuXG4gICAqIEBwYXJhbSB7b2JqZWN0fSBhcmdzIC0gQXBwbGllciBjb25maWd1cmF0aW9uLlxuICAgKiBAcGFyYW0gez99IGFyZ3MubW9kZWxDbGFzcyAtIE1vZGVsIGNsYXNzIHJlY2VpdmluZyB0aGUgbXV0YXRpb25zLlxuICAgKiBAcGFyYW0ge1JlY29yZDxzdHJpbmcsIHN0cmluZyB8IHt0eXBlOiBzdHJpbmcsIGNvbHVtbj86IHN0cmluZ30gfCAoKHZhbHVlOiA/LCBsYWJlbDogc3RyaW5nKSA9PiA/KT59IGFyZ3MuZmllbGRzIC0gRGF0YS1rZXkg4oaSIGZpZWxkLXR5cGUgbWFwOiBhIG5hbWVkIHR5cGUsIGEge3R5cGUsIGNvbHVtbn0gcmVuYW1lIHNwZWMsIFwiaWdub3JlZFwiIGZvciBhY2NlcHRlZC1idXQtZHJvcHBlZCBrZXlzLCBvciBhIGN1c3RvbSBjb2VyY2VyIGZ1bmN0aW9uLlxuICAgKiBAcGFyYW0geyhhcmdzOiB7ZGF0YTogUmVjb3JkPHN0cmluZywgPz4sIG11dGF0aW9uOiA/LCBjb250ZXh0OiBSZWNvcmQ8c3RyaW5nLCA/Pn0pID0+IFByb21pc2U8Pz59IFthcmdzLmZpbmRSZWNvcmRdIC0gQ3VzdG9tIHJlY29yZCByZXNvbHZlci4gRGVmYXVsdHMgdG8gZmluZEJ5KHtpZDogbXV0YXRpb24ucmVzb3VyY2VJZH0pLlxuICAgKiBAcGFyYW0geyhhcmdzOiB7bXV0YXRpb246ID8sIGNvbnRleHQ6IFJlY29yZDxzdHJpbmcsID8+fSkgPT4gUHJvbWlzZTw/Pn0gW2FyZ3MuZmluZFJlY29yZEZvckRlbGV0ZV0gLSBDdXN0b20gZGVsZXRlIHJlc29sdmVyLiBEZWZhdWx0cyB0byBmaW5kUmVjb3JkLlxuICAgKiBAcGFyYW0ge1wiZXJyb3JcIiB8IFwiaWdub3JlXCJ9IFthcmdzLnJlc3RBcmdzXSAtIFVua25vd24gZGF0YS1rZXkgaGFuZGxpbmcuIERlZmF1bHRzIHRvIFwiZXJyb3JcIi5cbiAgICogQHBhcmFtIHsoYXJnczoge21hcHBlZEF0dHJpYnV0ZXM6IFJlY29yZDxzdHJpbmcsID8+LCBtdXRhdGlvbjogPywgY29udGV4dDogUmVjb3JkPHN0cmluZywgPz4sIHJlY29yZDogP30pID0+IFByb21pc2U8UmVjb3JkPHN0cmluZywgPz4gfCB2b2lkPn0gW2FyZ3MuYWZ0ZXJBcHBseV0gLSBEb21haW4gdGFpbDsgaXRzIHJldHVybmVkIG9iamVjdCBtZXJnZXMgaW50byB0aGUgYXBwbHkgcmVzdWx0LlxuICAgKiBAcGFyYW0geyhhcmdzOiB7bXV0YXRpb246ID8sIGNvbnRleHQ6IFJlY29yZDxzdHJpbmcsID8+LCByZWNvcmQ6ID99KSA9PiBQcm9taXNlPFJlY29yZDxzdHJpbmcsID8+PiB8IFJlY29yZDxzdHJpbmcsID8+fSBbYXJncy5zZXJpYWxpemVdIC0gU25hcHNob3Qgc2VyaWFsaXplcjsgcmVzdWx0IGxhbmRzIG9uIGFwcGx5UmVzdWx0LnNlcmlhbGl6ZWREYXRhLlxuICAgKi9cbiAgY29uc3RydWN0b3Ioe2FmdGVyQXBwbHksIGZpZWxkcywgZmluZFJlY29yZCwgZmluZFJlY29yZEZvckRlbGV0ZSwgbW9kZWxDbGFzcywgcmVzdEFyZ3MgPSBcImVycm9yXCIsIHNlcmlhbGl6ZX0pIHtcbiAgICBpZiAoIW1vZGVsQ2xhc3MpIHRocm93IG5ldyBFcnJvcihcIlN5bmNSZXBsYXlVcHNlcnRBcHBsaWVyIHJlcXVpcmVzIGEgbW9kZWxDbGFzc1wiKVxuICAgIGlmICghZmllbGRzIHx8IHR5cGVvZiBmaWVsZHMgIT09IFwib2JqZWN0XCIpIHRocm93IG5ldyBFcnJvcihcIlN5bmNSZXBsYXlVcHNlcnRBcHBsaWVyIHJlcXVpcmVzIGEgZmllbGRzIG1hcFwiKVxuICAgIGlmIChyZXN0QXJncyAhPT0gXCJlcnJvclwiICYmIHJlc3RBcmdzICE9PSBcImlnbm9yZVwiKSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoYFN5bmNSZXBsYXlVcHNlcnRBcHBsaWVyIHJlc3RBcmdzIG11c3QgYmUgXCJlcnJvclwiIG9yIFwiaWdub3JlXCIsIGdvdDogJHtTdHJpbmcocmVzdEFyZ3MpfWApXG4gICAgfVxuXG4gICAgZm9yIChjb25zdCBbZmllbGROYW1lLCBmaWVsZFNwZWNdIG9mIE9iamVjdC5lbnRyaWVzKGZpZWxkcykpIHtcbiAgICAgIGlmICh0eXBlb2YgZmllbGRTcGVjID09PSBcImZ1bmN0aW9uXCIpIGNvbnRpbnVlXG5cbiAgICAgIGNvbnN0IGZpZWxkVHlwZSA9IHR5cGVvZiBmaWVsZFNwZWMgPT09IFwic3RyaW5nXCIgPyBmaWVsZFNwZWMgOiBmaWVsZFNwZWMudHlwZVxuXG4gICAgICBpZiAoZmllbGRUeXBlICE9PSBcImlnbm9yZWRcIiAmJiAhKGZpZWxkVHlwZSBpbiBGSUVMRF9UWVBFUykpIHtcbiAgICAgICAgdGhyb3cgbmV3IEVycm9yKGBVbmtub3duIHN5bmMgZmllbGQgdHlwZTogJHtmaWVsZFR5cGV9IGZvcjogJHtmaWVsZE5hbWV9YClcbiAgICAgIH1cbiAgICB9XG5cbiAgICB0aGlzLmFmdGVyQXBwbHkgPSBhZnRlckFwcGx5XG4gICAgdGhpcy5maWVsZHMgPSBmaWVsZHNcbiAgICB0aGlzLmZpbmRSZWNvcmQgPSBmaW5kUmVjb3JkXG4gICAgdGhpcy5maW5kUmVjb3JkRm9yRGVsZXRlID0gZmluZFJlY29yZEZvckRlbGV0ZVxuICAgIHRoaXMubW9kZWxDbGFzcyA9IG1vZGVsQ2xhc3NcbiAgICB0aGlzLnJlc3RBcmdzID0gcmVzdEFyZ3NcbiAgICB0aGlzLnNlcmlhbGl6ZSA9IHNlcmlhbGl6ZVxuICB9XG5cbiAgLyoqXG4gICAqIEFwcGxpZXMgb25lIG5vcm1hbGl6ZWQgcmVwbGF5IG11dGF0aW9uIHRvIHRoZSBkZWNsYXJlZCBtb2RlbC5cbiAgICogQHBhcmFtIHt7YWN0b3I6ID8sIGNvbnRleHQ6IFJlY29yZDxzdHJpbmcsID8+LCBleGlzdGluZ1N5bmM6ID8sIG11dGF0aW9uOiA/fX0gYXJncyAtIFJlcGxheSBhcHBseSBhcmd1bWVudHMuXG4gICAqIEByZXR1cm5zIHtQcm9taXNlPFJlY29yZDxzdHJpbmcsID8+Pn0gQXBwbHkgcmVzdWx0IHdpdGggdGhlIHJlY29yZCwgY3JlYXRlZC9kZWxldGVkIGZsYWdzLCBvcHRpb25hbCBzZXJpYWxpemVkRGF0YSwgYW5kIGFmdGVyQXBwbHkgZXh0cmFzLlxuICAgKi9cbiAgYXN5bmMgYXBwbHkoe2NvbnRleHQsIG11dGF0aW9ufSkge1xuICAgIGlmIChtdXRhdGlvbi5zeW5jVHlwZSA9PT0gXCJkZWxldGVcIikgcmV0dXJuIGF3YWl0IHRoaXMuYXBwbHlEZWxldGUoe2NvbnRleHQsIG11dGF0aW9ufSlcblxuICAgIGNvbnN0IG1hcHBlZEF0dHJpYnV0ZXMgPSB0aGlzLm1hcHBlZEF0dHJpYnV0ZXMobXV0YXRpb24uZGF0YSlcbiAgICBjb25zdCByZWNvcmQgPSB0aGlzLmZpbmRSZWNvcmRcbiAgICAgID8gYXdhaXQgdGhpcy5maW5kUmVjb3JkKHtjb250ZXh0LCBkYXRhOiBtdXRhdGlvbi5kYXRhLCBtdXRhdGlvbn0pXG4gICAgICA6IGF3YWl0IHRoaXMubW9kZWxDbGFzcy5maW5kQnkoe2lkOiBtdXRhdGlvbi5yZXNvdXJjZUlkfSlcbiAgICAvKiogQHR5cGUge1JlY29yZDxzdHJpbmcsID8+fSAqL1xuICAgIGNvbnN0IHJlc3VsdCA9IHtjcmVhdGVkOiBmYWxzZSwgZGVsZXRlZDogZmFsc2UsIHJlY29yZDogbnVsbH1cblxuICAgIGlmIChyZWNvcmQpIHtcbiAgICAgIHJlY29yZC5hc3NpZ24obWFwcGVkQXR0cmlidXRlcylcbiAgICAgIGF3YWl0IHJlY29yZC5zYXZlKClcbiAgICAgIHJlc3VsdC5yZWNvcmQgPSByZWNvcmRcbiAgICB9IGVsc2Uge1xuICAgICAgcmVzdWx0LnJlY29yZCA9IGF3YWl0IHRoaXMubW9kZWxDbGFzcy5jcmVhdGUoe2lkOiBtdXRhdGlvbi5yZXNvdXJjZUlkLCAuLi5tYXBwZWRBdHRyaWJ1dGVzfSlcbiAgICAgIHJlc3VsdC5jcmVhdGVkID0gdHJ1ZVxuICAgIH1cblxuICAgIGlmICh0aGlzLnNlcmlhbGl6ZSkgcmVzdWx0LnNlcmlhbGl6ZWREYXRhID0gYXdhaXQgdGhpcy5zZXJpYWxpemUoe2NvbnRleHQsIG11dGF0aW9uLCByZWNvcmQ6IHJlc3VsdC5yZWNvcmR9KVxuXG4gICAgaWYgKHRoaXMuYWZ0ZXJBcHBseSkge1xuICAgICAgY29uc3QgYWZ0ZXJBcHBseVJlc3VsdCA9IGF3YWl0IHRoaXMuYWZ0ZXJBcHBseSh7Y29udGV4dCwgbWFwcGVkQXR0cmlidXRlcywgbXV0YXRpb24sIHJlY29yZDogcmVzdWx0LnJlY29yZH0pXG5cbiAgICAgIGlmIChhZnRlckFwcGx5UmVzdWx0ICYmIHR5cGVvZiBhZnRlckFwcGx5UmVzdWx0ID09PSBcIm9iamVjdFwiKSBPYmplY3QuYXNzaWduKHJlc3VsdCwgYWZ0ZXJBcHBseVJlc3VsdClcbiAgICB9XG5cbiAgICByZXR1cm4gcmVzdWx0XG4gIH1cblxuICAvKipcbiAgICogQXBwbGllcyBhIGRlbGV0ZSBtdXRhdGlvbiB0byB0aGUgZGVjbGFyZWQgbW9kZWwuXG4gICAqIEBwYXJhbSB7e2NvbnRleHQ6IFJlY29yZDxzdHJpbmcsID8+LCBtdXRhdGlvbjogP319IGFyZ3MgLSBEZWxldGUgYXJndW1lbnRzLlxuICAgKiBAcmV0dXJucyB7UHJvbWlzZTxSZWNvcmQ8c3RyaW5nLCA/Pj59IEFwcGx5IHJlc3VsdCB3aXRoIHRoZSBkZWxldGVkIGZsYWcuXG4gICAqL1xuICBhc3luYyBhcHBseURlbGV0ZSh7Y29udGV4dCwgbXV0YXRpb259KSB7XG4gICAgY29uc3QgcmVzb2x2ZVJlY29yZCA9IHRoaXMuZmluZFJlY29yZEZvckRlbGV0ZSB8fCB0aGlzLmZpbmRSZWNvcmRcbiAgICBjb25zdCByZWNvcmQgPSByZXNvbHZlUmVjb3JkXG4gICAgICA/IGF3YWl0IHJlc29sdmVSZWNvcmQoe2NvbnRleHQsIGRhdGE6IG11dGF0aW9uLmRhdGEsIG11dGF0aW9ufSlcbiAgICAgIDogYXdhaXQgdGhpcy5tb2RlbENsYXNzLmZpbmRCeSh7aWQ6IG11dGF0aW9uLnJlc291cmNlSWR9KVxuXG4gICAgaWYgKCFyZWNvcmQpIHJldHVybiB7Y3JlYXRlZDogZmFsc2UsIGRlbGV0ZWQ6IGZhbHNlLCByZWNvcmQ6IG51bGx9XG5cbiAgICBhd2FpdCByZWNvcmQuZGVzdHJveSgpXG5cbiAgICByZXR1cm4ge2NyZWF0ZWQ6IGZhbHNlLCBkZWxldGVkOiB0cnVlLCByZWNvcmR9XG4gIH1cblxuICAvKipcbiAgICogTWFwcyBwcmVzZW50IGRhdGEga2V5cyB0aHJvdWdoIHRoZSBkZWNsYXJlZCBmaWVsZCB0eXBlcy5cbiAgICogQHBhcmFtIHtSZWNvcmQ8c3RyaW5nLCA/Pn0gZGF0YSAtIE5vcm1hbGl6ZWQgbXV0YXRpb24gZGF0YS5cbiAgICogQHJldHVybnMge1JlY29yZDxzdHJpbmcsID8+fSBDb2VyY2VkIGF0dHJpYnV0ZXMga2V5ZWQgYnkgY29sdW1uIG5hbWUuXG4gICAqL1xuICBtYXBwZWRBdHRyaWJ1dGVzKGRhdGEpIHtcbiAgICAvKiogQHR5cGUge1JlY29yZDxzdHJpbmcsID8+fSAqL1xuICAgIGNvbnN0IG1hcHBlZEF0dHJpYnV0ZXMgPSB7fVxuICAgIC8qKiBAdHlwZSB7c3RyaW5nW119ICovXG4gICAgY29uc3QgdW5rbm93bktleXMgPSBbXVxuXG4gICAgZm9yIChjb25zdCBbZGF0YUtleSwgdmFsdWVdIG9mIE9iamVjdC5lbnRyaWVzKGRhdGEpKSB7XG4gICAgICBjb25zdCBmaWVsZFNwZWMgPSB0aGlzLmZpZWxkc1tkYXRhS2V5XVxuXG4gICAgICBpZiAoIWZpZWxkU3BlYykge1xuICAgICAgICB1bmtub3duS2V5cy5wdXNoKGRhdGFLZXkpXG4gICAgICAgIGNvbnRpbnVlXG4gICAgICB9XG5cbiAgICAgIGlmICh0eXBlb2YgZmllbGRTcGVjID09PSBcImZ1bmN0aW9uXCIpIHtcbiAgICAgICAgbWFwcGVkQXR0cmlidXRlc1tkYXRhS2V5XSA9IGZpZWxkU3BlYyh2YWx1ZSwgZGF0YUtleSlcbiAgICAgICAgY29udGludWVcbiAgICAgIH1cblxuICAgICAgY29uc3QgZmllbGRUeXBlID0gdHlwZW9mIGZpZWxkU3BlYyA9PT0gXCJzdHJpbmdcIiA/IGZpZWxkU3BlYyA6IGZpZWxkU3BlYy50eXBlXG5cbiAgICAgIGlmIChmaWVsZFR5cGUgPT09IFwiaWdub3JlZFwiKSBjb250aW51ZVxuXG4gICAgICBjb25zdCBjb2x1bW4gPSB0eXBlb2YgZmllbGRTcGVjID09PSBcInN0cmluZ1wiID8gZGF0YUtleSA6IGZpZWxkU3BlYy5jb2x1bW4gfHwgZGF0YUtleVxuXG4gICAgICBtYXBwZWRBdHRyaWJ1dGVzW2NvbHVtbl0gPSBGSUVMRF9UWVBFU1tmaWVsZFR5cGVdKHZhbHVlLCBkYXRhS2V5KVxuICAgIH1cblxuICAgIGlmICh1bmtub3duS2V5cy5sZW5ndGggPiAwICYmIHRoaXMucmVzdEFyZ3MgPT09IFwiZXJyb3JcIikge1xuICAgICAgdGhyb3cgbmV3IEVycm9yKGBVbmtub3duIHN5bmMgZGF0YSBrZXlzOiAke3Vua25vd25LZXlzLmpvaW4oXCIsIFwiKX1gKVxuICAgIH1cblxuICAgIHJldHVybiBtYXBwZWRBdHRyaWJ1dGVzXG4gIH1cbn1cbiJdfQ==

package/build/sync/sync-envelope-replay-service.js

@@ -1,5 +1,16 @@
 // @ts-check
 
+import SyncReplayUpsertApplier from "./sync-replay-upsert-applier.js"
+
+/**
+ * One declarative broadcast fanned out after a mutation applies.
+ * @typedef {object} SyncReplayBroadcast
+ * @property {string | ((args: Record<string, ?>) => string)} channel - Channel name or resolver.
+ * @property {(args: Record<string, ?>) => Record<string, ?>} broadcastParams - Channel routing params.
+ * @property {(args: Record<string, ?>) => ?} body - Broadcast body.
+ * @property {(args: Record<string, ?>) => boolean} [when] - Optional gate; skipped when it returns false.
+ */
+
 /**
  * Replays client sync envelopes through project supplied authentication,
  * authorization, application, and persistence hooks.
@@ -23,15 +34,49 @@ export default class SyncEnvelopeReplayService {
    * @param {{debug?: (...args: Array<unknown>) => void, warn?: (...args: Array<unknown>) => void}} [args.logger] - Logger used for normalization warnings.
    * @param {?} [args.syncModel] - Sync/change model enabling model-backed default hooks.
    * @param {string} [args.actorForeignKeyColumn] - Sync model column linking rows to the replay actor.
+   * @param {?} [args.authenticationTokenModel] - Token model enabling the default token-lookup authenticateReplay.
+   * @param {string} [args.authenticationTokenColumn] - Token model column holding the token. Defaults to "token".
+   * @param {string} [args.authenticationTokenParam] - Request param carrying the token. Defaults to "authenticationToken".
+   * @param {Record<string, ((args: Record<string, ?>) => Promise<?>) | ConstructorParameters<typeof SyncReplayUpsertApplier>[0]>} [args.applyHandlers] - Per-resourceType apply handlers (functions or declarative upsert-applier specs) enabling the default applyReplayMutation dispatch.
+   * @param {(args: Record<string, ?>) => Record<string, ?>} [args.persistExtraAttributes] - Extra attributes merged into the model-backed persisted row (e.g. an event scope column).
+   * @param {(args: {mutation: ?, applyResult: ?}) => ?} [args.persistSerializedData] - Overrides the persisted data payload (object results are JSON stringified).
+   * @param {(broadcast: {channel: string, params: Record<string, ?>, body: ?}) => Promise<void>} [args.broadcaster] - Delivers declarative broadcasts. Required when broadcasts are configured.
+   * @param {SyncReplayBroadcast[]} [args.broadcasts] - Broadcasts fanned out by the default afterReplayMutation.
    */
   constructor(args = {}) {
     this.logger = args.logger || console
     this.syncModel = args.syncModel || null
     this.actorForeignKeyColumn = args.actorForeignKeyColumn || "authentication_token_id"
+    this.authenticationTokenModel = args.authenticationTokenModel || null
+    this.authenticationTokenColumn = args.authenticationTokenColumn || "token"
+    this.authenticationTokenParam = args.authenticationTokenParam || "authenticationToken"
+    this.persistExtraAttributes = args.persistExtraAttributes || null
+    this.persistSerializedData = args.persistSerializedData || null
+    this.broadcaster = args.broadcaster || null
+    this.broadcasts = args.broadcasts || null
+    this.applyHandlers = args.applyHandlers ? this.builtApplyHandlers(args.applyHandlers) : null
 
     if (args.actorForeignKeyColumn !== undefined && (typeof args.actorForeignKeyColumn !== "string" || args.actorForeignKeyColumn.length < 1)) {
       throw new Error(`actorForeignKeyColumn must be a non-blank string, got: ${String(args.actorForeignKeyColumn)}`)
     }
+    if (this.broadcasts && !this.broadcaster) {
+      throw new Error("SyncEnvelopeReplayService broadcasts require a broadcaster option delivering them")
+    }
+  }
+
+  /**
+   * Wraps declarative apply-handler specs in upsert appliers.
+   * @param {Record<string, ?>} applyHandlers - Raw apply handlers.
+   * @returns {Record<string, (args: Record<string, ?>) => Promise<?>>} Callable handlers by resource type.
+   */
+  builtApplyHandlers(applyHandlers) {
+    return Object.fromEntries(Object.entries(applyHandlers).map(([resourceType, handler]) => {
+      if (typeof handler === "function") return [resourceType, handler]
+
+      const applier = new SyncReplayUpsertApplier(handler)
+
+      return [resourceType, (/** @type {Record<string, ?>} */ applyArgs) => applier.apply(/** @type {?} */ (applyArgs))]
+    }))
   }
 
   /**
@@ -91,11 +136,30 @@ export default class SyncEnvelopeReplayService {
 
   /**
    * Authenticates the sync batch actor.
-   * @param {Record<string, ?>} _params - Request params.
+   *
+   * Defaults to a token-model lookup when `authenticationTokenModel` is
+   * configured; otherwise apps override this hook.
+   * @param {Record<string, ?>} params - Request params.
    * @returns {Promise<{authenticated: true, actor: ?} | {authenticated: false, errorCode: string, errorMessage: string}>} Auth result.
    */
-  async authenticateReplay(_params) {
-    throw new Error("SyncEnvelopeReplayService.authenticateReplay must be implemented")
+  async authenticateReplay(params) {
+    if (!this.authenticationTokenModel) {
+      throw new Error("SyncEnvelopeReplayService.authenticateReplay must be implemented (or configure authenticationTokenModel)")
+    }
+
+    const token = params[this.authenticationTokenParam]
+
+    if (!token) {
+      return {authenticated: false, errorCode: "missing-authentication-token", errorMessage: "Missing authentication token"}
+    }
+
+    const actor = await this.authenticationTokenModel.findBy({[this.authenticationTokenColumn]: token})
+
+    if (!actor) {
+      return {authenticated: false, errorCode: "invalid-authentication-token", errorMessage: "Invalid authentication token"}
+    }
+
+    return {actor, authenticated: true}
   }
 
   /**
@@ -257,11 +321,20 @@ export default class SyncEnvelopeReplayService {
 
   /**
    * Applies one normalized mutation to domain models.
-   * @param {{actor: ?, context: Record<string, ?>, existingSync: ?, mutation: import("./sync-envelope-replay-service.js").SyncReplayMutation}} _args - Actor, batch context, existing sync row, and mutation.
+   *
+   * Defaults to dispatching through the configured apply-handler registry;
+   * mutations without a registered handler fail loudly.
+   * @param {{actor: ?, context: Record<string, ?>, existingSync: ?, mutation: import("./sync-envelope-replay-service.js").SyncReplayMutation}} args - Actor, batch context, existing sync row, and mutation.
    * @returns {Promise<?>} Project-specific apply result.
    */
-  async applyReplayMutation(_args) {
-    return null
+  async applyReplayMutation(args) {
+    if (!this.applyHandlers) return null
+
+    const applyHandler = this.applyHandlers[args.mutation.resourceType]
+
+    if (!applyHandler) throw new Error(`No sync apply handler registered for: ${args.mutation.resourceType}`)
+
+    return await applyHandler(args)
   }
 
   /**
@@ -281,11 +354,25 @@ export default class SyncEnvelopeReplayService {
    * @param {{actor: ?, context: Record<string, ?>, existingSync: ?, applyResult: ?, mutation: import("./sync-envelope-replay-service.js").SyncReplayMutation, shouldApply: boolean}} args - Replay persistence arguments.
    * @returns {Promise<void>}
    */
-  async persistReplayMutation({actor, existingSync, mutation}) {
+  async persistReplayMutation({actor, applyResult, context, existingSync, mutation, shouldApply}) {
     if (!this.syncModel) return
 
     const attributes = this.replayPersistAttributes({actor, mutation})
 
+    // Stale replays never applied anything, so the applyResult-driven extension
+    // hooks must not run against the default null skipped result.
+    if (this.persistExtraAttributes && shouldApply) {
+      Object.assign(attributes, this.persistExtraAttributes({actor, applyResult, context, existingSync, mutation, shouldApply}))
+    }
+
+    if (this.persistSerializedData && shouldApply) {
+      const serializedData = this.persistSerializedData({applyResult, mutation})
+
+      if (serializedData !== undefined && serializedData !== null) {
+        attributes.data = typeof serializedData === "string" ? serializedData : JSON.stringify(serializedData)
+      }
+    }
+
     if (existingSync) {
       const existingClientUpdatedAt = this.existingReplaySyncClientUpdatedAt(existingSync)
 
@@ -317,10 +404,28 @@ export default class SyncEnvelopeReplayService {
 
   /**
    * Runs side effects after a successful mutation replay and persistence.
-   * @param {{actor: ?, context: Record<string, ?>, existingSync: ?, applyResult: ?, mutation: import("./sync-envelope-replay-service.js").SyncReplayMutation, shouldApply: boolean}} _args - Replay side-effect arguments.
+   *
+   * Defaults to fanning the applied result out through the configured
+   * declarative broadcasts.
+   * @param {{actor: ?, context: Record<string, ?>, existingSync: ?, applyResult: ?, mutation: import("./sync-envelope-replay-service.js").SyncReplayMutation, shouldApply: boolean}} args - Replay side-effect arguments.
    * @returns {Promise<void>}
    */
-  async afterReplayMutation(_args) {}
+  async afterReplayMutation(args) {
+    if (!this.broadcasts || !this.broadcaster) return
+    // Stale replays never applied anything - broadcasting their skipped results
+    // would fan out stale side effects (or crash on the default null applyResult).
+    if (!args.shouldApply) return
+
+    for (const broadcast of this.broadcasts) {
+      if (broadcast.when && !broadcast.when(args)) continue
+
+      await this.broadcaster({
+        body: broadcast.body(args),
+        channel: typeof broadcast.channel === "function" ? broadcast.channel(args) : broadcast.channel,
+        params: broadcast.broadcastParams(args)
+      })
+    }
+  }
 }
 
 /**