@econ-v1/domain 0.0.0

package/dist/services/revisioned-domain-service.js

@@ -0,0 +1,205 @@
+import { DomainError } from "../errors/index.js";
+import { createOutboxIntent } from "../models/outbox.js";
+import { REVISIONED_DOMAINS, } from "../models/revisioned.js";
+import { RevisionMerge } from "./sync/revision-merge.js";
+export class RevisionedDomainService {
+    #domain;
+    #now;
+    #outbox;
+    #repository;
+    constructor(options) {
+        this.#domain = options.domain;
+        this.#now = options.now ?? (() => new Date().toISOString());
+        this.#outbox = options.outbox;
+        this.#repository = options.repository;
+    }
+    async update(input) {
+        validateWriteInput(this.#domain, input);
+        const merge = this.#merge(input.idempotencyKey);
+        const intent = await merge.createIntent(input);
+        const result = await this.#repository.command({ ...intent, idempotencyKey: input.idempotencyKey });
+        if (result.status === "accepted") {
+            await merge.handleCommandResult(intent, result);
+            return result;
+        }
+        await merge.handleCommandResult(intent, result);
+        const conflict = await this.#readConflict(conflictId(this.#domain, input.id, input.idempotencyKey));
+        if (conflict === undefined)
+            throw new Error("Revision conflict was not persisted");
+        return { conflict, status: "conflict" };
+    }
+    async listConflicts() {
+        const records = await this.#outbox.list({ domain: this.#outboxDomain(), state: "conflict" });
+        return records.map((record) => parseRevisionConflictRecord(record.payload, this.#domain));
+    }
+    async resolveConflict(conflictIdValue, resolution) {
+        if (conflictIdValue.trim() === "")
+            throw invalid("conflict id");
+        const stored = await this.#outbox.read(conflictIdValue);
+        if (stored === undefined)
+            throw new DomainError({ code: "not_found", message: "Revision conflict was not found" });
+        const conflict = parseRevisionConflictRecord(stored.payload, this.#domain);
+        if (resolution === "theirs") {
+            await this.#repository.apply(conflict.theirs);
+            await this.#outbox.delete(stored.id);
+            return { entity: conflict.theirs, status: "discarded" };
+        }
+        if (resolution !== "mine")
+            throw invalid("conflict resolution");
+        const retryKey = `${conflict.idempotencyKey}:retry:${conflict.theirs.rev}`;
+        const merge = this.#merge(retryKey);
+        const intent = await merge.createIntent({
+            baseRev: conflict.theirs.rev,
+            id: conflict.id,
+            value: conflict.mine,
+        });
+        const result = await this.#repository.command({ ...intent, idempotencyKey: retryKey });
+        if (result.status === "accepted") {
+            await merge.handleCommandResult(intent, result);
+            await this.#outbox.delete(stored.id);
+            return result;
+        }
+        await merge.handleCommandResult(intent, result);
+        const replacement = await this.#readConflict(conflictId(this.#domain, conflict.id, retryKey));
+        if (replacement === undefined)
+            throw new Error("Revision conflict retry was not persisted");
+        await this.#outbox.delete(stored.id);
+        return { conflict: replacement, status: "conflict" };
+    }
+    #merge(idempotencyKey) {
+        return new RevisionMerge({
+            parkConflict: async (conflict) => {
+                await this.#persistConflict({ ...conflict, idempotencyKey });
+            },
+            read: async (id) => await this.#repository.read(id),
+            write: async (entity) => await this.#repository.apply(entity),
+        });
+    }
+    async #persistConflict(conflict) {
+        const id = conflictId(this.#domain, conflict.id, conflict.idempotencyKey);
+        const existing = await this.#outbox.read(id);
+        if (existing !== undefined)
+            return parseRevisionConflictRecord(existing.payload, this.#domain);
+        const record = {
+            ...conflict,
+            conflictId: id,
+            createdAt: this.#now(),
+            domain: this.#domain,
+            kind: "revision-conflict.v1",
+        };
+        const entry = {
+            ...createOutboxIntent({
+                authority: "eventual",
+                createdAt: record.createdAt,
+                domain: this.#outboxDomain(),
+                id,
+                idempotencyKey: `conflict:${id}`,
+                payload: record,
+                state: "conflict",
+                updatedAt: record.createdAt,
+            }),
+            state: "conflict",
+        };
+        await this.#outbox.create(entry);
+        return record;
+    }
+    async #readConflict(id) {
+        const record = await this.#outbox.read(id);
+        return record === undefined ? undefined : parseRevisionConflictRecord(record.payload, this.#domain);
+    }
+    #outboxDomain() {
+        return `revision:${this.#domain}`;
+    }
+}
+export function parseRevisionConflictRecord(value, expectedDomain) {
+    if (!isRecord(value) || value.kind !== "revision-conflict.v1")
+        throw invalid("revision conflict payload");
+    const domain = value.domain;
+    if (!isRevisionedDomain(domain) || (expectedDomain !== undefined && domain !== expectedDomain)) {
+        throw invalid("revision conflict domain");
+    }
+    if (!nonEmptyString(value.conflictId) || !nonEmptyString(value.id) || !nonEmptyString(value.idempotencyKey)) {
+        throw invalid("revision conflict identity");
+    }
+    if (!isNonNegativeInteger(value.baseRev) || !isRevisionEntity(value.theirs) || !isJsonValue(value.mine)) {
+        throw invalid("revision conflict values");
+    }
+    return {
+        baseRev: value.baseRev,
+        conflictId: value.conflictId,
+        createdAt: requiredTimestamp(value.createdAt),
+        domain,
+        id: value.id,
+        idempotencyKey: value.idempotencyKey,
+        mine: value.mine,
+        theirs: value.theirs,
+    };
+}
+function validateWriteInput(domain, input) {
+    if (!nonEmptyString(input.id) || !nonEmptyString(input.idempotencyKey))
+        throw invalid("revision write identity");
+    if (input.baseRev !== undefined && !isNonNegativeInteger(input.baseRev))
+        throw invalid("revision base revision");
+    if (!isJsonValue(input.value))
+        throw invalid("revision value");
+    if (domain === "agent") {
+        if (!isRecord(input.value) || !nonEmptyString(input.value.name))
+            throw invalid("agent name");
+        return;
+    }
+    if (domain === "graph")
+        validateGraph(input.value);
+}
+function validateGraph(value) {
+    if (!isRecord(value) || !Array.isArray(value.nodes) || !Array.isArray(value.edges))
+        throw invalid("graph shape");
+    const nodeIds = new Set();
+    for (const node of value.nodes) {
+        if (!isRecord(node) || !nonEmptyString(node.id) || nodeIds.has(node.id))
+            throw invalid("graph node");
+        nodeIds.add(node.id);
+    }
+    for (const edge of value.edges) {
+        if (!isRecord(edge) || !nonEmptyString(edge.from) || !nonEmptyString(edge.to) ||
+            !nodeIds.has(edge.from) || !nodeIds.has(edge.to))
+            throw invalid("graph edge");
+    }
+}
+function isRevisionEntity(value) {
+    return isRecord(value) && nonEmptyString(value.id) && isNonNegativeInteger(value.rev) && isJsonValue(value.value);
+}
+function isRevisionedDomain(value) {
+    return REVISIONED_DOMAINS.includes(value);
+}
+function isJsonValue(value) {
+    if (value === null || typeof value === "string" || typeof value === "boolean")
+        return true;
+    if (typeof value === "number")
+        return Number.isFinite(value);
+    if (Array.isArray(value))
+        return value.every(isJsonValue);
+    if (!isRecord(value))
+        return false;
+    return Object.values(value).every(isJsonValue);
+}
+function isNonNegativeInteger(value) {
+    return typeof value === "number" && Number.isInteger(value) && value >= 0;
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function nonEmptyString(value) {
+    return typeof value === "string" && value.trim() !== "";
+}
+function requiredTimestamp(value) {
+    if (!nonEmptyString(value) || !Number.isFinite(Date.parse(value)))
+        throw invalid("revision conflict timestamp");
+    return value;
+}
+function invalid(field) {
+    return new DomainError({ code: "validation_failed", message: `Invalid ${field}` });
+}
+function conflictId(domain, id, idempotencyKey) {
+    return `${domain}:${id}:${idempotencyKey}`;
+}
+//# sourceMappingURL=revisioned-domain-service.js.map

package/dist/services/revisioned-domain-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"revisioned-domain-service.js","sourceRoot":"","sources":["../../src/services/revisioned-domain-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAOjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EACL,kBAAkB,GASnB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AA+BzD,MAAM,OAAO,uBAAuB;IACzB,OAAO,CAAmB;IAC1B,IAAI,CAAe;IACnB,OAAO,CAAmB;IAC1B,WAAW,CAAqC;IAEzD,YAAY,OAA+C;QACzD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;QAC9B,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAmC;QAC9C,kBAAkB,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACxC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,GAAG,MAAM,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC;QACnG,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YACjC,MAAM,KAAK,CAAC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAChD,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,KAAK,CAAC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC;QACpG,IAAI,QAAQ,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACnF,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;QAC7F,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,2BAA2B,CAAS,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACpG,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,eAAuB,EACvB,UAA8B;QAE9B,IAAI,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC;QAChE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACxD,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM,IAAI,WAAW,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC,CAAC;QACnH,MAAM,QAAQ,GAAG,2BAA2B,CAAS,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAEnF,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;YAC5B,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC9C,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACrC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;QAC1D,CAAC;QACD,IAAI,UAAU,KAAK,MAAM;YAAE,MAAM,OAAO,CAAC,qBAAqB,CAAC,CAAC;QAEhE,MAAM,QAAQ,GAAG,GAAG,QAAQ,CAAC,cAAc,UAAU,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;QAC3E,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC;YACtC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG;YAC5B,EAAE,EAAE,QAAQ,CAAC,EAAE;YACf,KAAK,EAAE,QAAQ,CAAC,IAAI;SACrB,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,GAAG,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC,CAAC;QACvF,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YACjC,MAAM,KAAK,CAAC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAChD,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACrC,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,KAAK,CAAC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC9F,IAAI,WAAW,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC5F,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACrC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IACvD,CAAC;IAED,MAAM,CAAC,cAAsB;QAC3B,OAAO,IAAI,aAAa,CAAC;YACvB,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;gBAC/B,MAAM,IAAI,CAAC,gBAAgB,CAAC,EAAE,GAAG,QAAQ,EAAE,cAAc,EAAE,CAAC,CAAC;YAC/D,CAAC;YACD,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YACnD,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC;SAC9D,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,QAAwE;QAExE,MAAM,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;QAC1E,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC7C,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,2BAA2B,CAAS,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACvG,MAAM,MAAM,GAAoC;YAC9C,GAAG,QAAQ;YACX,UAAU,EAAE,EAAE;YACd,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE;YACtB,MAAM,EAAE,IAAI,CAAC,OAAO;YACpB,IAAI,EAAE,sBAAsB;SAC7B,CAAC;QACF,MAAM,KAAK,GAAiB;YAC1B,GAAG,kBAAkB,CAAC;gBACpB,SAAS,EAAE,UAAU;gBACrB,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE;gBAC5B,EAAE;gBACF,cAAc,EAAE,YAAY,EAAE,EAAE;gBAChC,OAAO,EAAE,MAAwC;gBACjD,KAAK,EAAE,UAAU;gBACjB,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B,CAAC;YACF,KAAK,EAAE,UAAU;SAClB,CAAC;QACF,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACjC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,EAAU;QAC5B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3C,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,2BAA2B,CAAS,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9G,CAAC;IAED,aAAa;QACX,OAAO,YAAY,IAAI,CAAC,OAAO,EAAE,CAAC;IACpC,CAAC;CACF;AAED,MAAM,UAAU,2BAA2B,CACzC,KAAc,EACd,cAAiC;IAEjC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,sBAAsB;QAAE,MAAM,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAC1G,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5B,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,KAAK,SAAS,IAAI,MAAM,KAAK,cAAc,CAAC,EAAE,CAAC;QAC/F,MAAM,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAC5C,CAAC;IACD,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC;QAC5G,MAAM,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACxG,MAAM,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,SAAS,EAAE,iBAAiB,CAAC,KAAK,CAAC,SAAS,CAAC;QAC7C,MAAM;QACN,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,IAAI,EAAE,KAAK,CAAC,IAAc;QAC1B,MAAM,EAAE,KAAK,CAAC,MAAgC;KAC/C,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAA2B,MAAwB,EAAE,KAAmC;IACjH,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,cAAc,CAAC;QAAE,MAAM,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACjH,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,OAAO,CAAC;QAAE,MAAM,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACjH,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC;QAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC/D,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QACvB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;QAC7F,OAAO;IACT,CAAC;IACD,IAAI,MAAM,KAAK,OAAO;QAAE,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,aAAa,CAAC,KAAgB;IACrC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;QAAE,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC;IACjH,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;QACrG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3E,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;IAClF,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,oBAAoB,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACpH,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc;IACxC,OAAO,kBAAkB,CAAC,QAAQ,CAAC,KAAyB,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC3F,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC7D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC1D,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAc;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC5E,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;AAC1D,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAAE,MAAM,OAAO,CAAC,6BAA6B,CAAC,CAAC;IAChH,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,OAAO,CAAC,KAAa;IAC5B,OAAO,IAAI,WAAW,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,WAAW,KAAK,EAAE,EAAE,CAAC,CAAC;AACrF,CAAC;AAED,SAAS,UAAU,CAAC,MAAwB,EAAE,EAAU,EAAE,cAAsB;IAC9E,OAAO,GAAG,MAAM,IAAI,EAAE,IAAI,cAAc,EAAE,CAAC;AAC7C,CAAC"}

package/dist/services/session-service.d.ts

@@ -0,0 +1,10 @@
+import type { DeviceDelegation, DeviceIdentity, IdentityDiagnostics, IdentityPort } from "@econ-v1/ports";
+export declare class SessionService {
+    private readonly identity;
+    constructor(identity: IdentityPort);
+    initialize(): Promise<DeviceIdentity>;
+    acceptDelegation(delegation: DeviceDelegation): Promise<void>;
+    revoke(): Promise<void>;
+    diagnostics(): Promise<IdentityDiagnostics>;
+}
+//# sourceMappingURL=session-service.d.ts.map

package/dist/services/session-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-service.d.ts","sourceRoot":"","sources":["../../src/services/session-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,YAAY,EACb,MAAM,gBAAgB,CAAC;AAIxB,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,YAAY;IAE7C,UAAU,IAAI,OAAO,CAAC,cAAc,CAAC;IAIrC,gBAAgB,CAAC,UAAU,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvB,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;CAGlD"}

package/dist/services/session-service.js

@@ -0,0 +1,20 @@
+import { normalizeDelegation } from "../models/delegation.js";
+export class SessionService {
+    identity;
+    constructor(identity) {
+        this.identity = identity;
+    }
+    async initialize() {
+        return await this.identity.generate();
+    }
+    async acceptDelegation(delegation) {
+        await this.identity.storeDelegation(normalizeDelegation(delegation));
+    }
+    async revoke() {
+        await this.identity.clear();
+    }
+    async diagnostics() {
+        return await this.identity.diagnostics();
+    }
+}
+//# sourceMappingURL=session-service.js.map

package/dist/services/session-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-service.js","sourceRoot":"","sources":["../../src/services/session-service.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,QAAsB;QAAtB,aAAQ,GAAR,QAAQ,CAAc;IAAG,CAAC;IAEvD,KAAK,CAAC,UAAU;QACd,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,UAA4B;QACjD,MAAM,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,MAAM;QACV,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,WAAW;QACf,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IAC3C,CAAC;CACF"}

package/dist/services/sync/authoritative-mirror.d.ts

@@ -0,0 +1,24 @@
+import type { AuthoritativeCommand, AuthoritativeSnapshot, SyncApplyResult, SyncDelta, SyncDeltaContext, SyncStrategy } from "../../models/sync.js";
+export declare class AuthoritativeRevalidationRequiredError extends Error {
+    readonly idempotencyKey: string;
+    constructor(idempotencyKey: string);
+}
+export interface AuthoritativeMirrorOptions<TValue, TCommand, TResult> {
+    readonly apply: (snapshot: AuthoritativeSnapshot<TValue>, delta: SyncDelta<TValue>) => Promise<void>;
+    readonly execute: (command: AuthoritativeCommand<TCommand>) => Promise<TResult>;
+    readonly staleAfterMs: number;
+}
+export interface AuthoritativeCommandOptions {
+    readonly now: string;
+    readonly revalidate?: () => Promise<boolean>;
+}
+export declare class AuthoritativeMirror<TValue, TCommand, TResult> implements SyncStrategy<TValue> {
+    #private;
+    readonly kind: "authoritative-mirror";
+    constructor(options: AuthoritativeMirrorOptions<TValue, TCommand, TResult>);
+    applyDelta(delta: SyncDelta<TValue>, context: SyncDeltaContext): Promise<SyncApplyResult>;
+    snapshot(): AuthoritativeSnapshot<TValue> | undefined;
+    isStale(now: string): boolean;
+    runCommand(command: AuthoritativeCommand<TCommand>, options: AuthoritativeCommandOptions): Promise<TResult>;
+}
+//# sourceMappingURL=authoritative-mirror.d.ts.map

package/dist/services/sync/authoritative-mirror.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoritative-mirror.d.ts","sourceRoot":"","sources":["../../../src/services/sync/authoritative-mirror.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,YAAY,EACb,MAAM,sBAAsB,CAAC;AAE9B,qBAAa,sCAAuC,SAAQ,KAAK;IAC/D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;gBAEpB,cAAc,EAAE,MAAM;CAKnC;AAED,MAAM,WAAW,0BAA0B,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO;IACnE,QAAQ,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,qBAAqB,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrG,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,oBAAoB,CAAC,QAAQ,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAChF,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9C;AAED,qBAAa,mBAAmB,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CACxD,YAAW,YAAY,CAAC,MAAM,CAAC;;IAC/B,QAAQ,CAAC,IAAI,EAAG,sBAAsB,CAAU;gBAQpC,OAAO,EAAE,0BAA0B,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC;IASpE,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAc/F,QAAQ,IAAI,qBAAqB,CAAC,MAAM,CAAC,GAAG,SAAS;IAIrD,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIvB,UAAU,CACd,OAAO,EAAE,oBAAoB,CAAC,QAAQ,CAAC,EACvC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,OAAO,CAAC;CAgBpB"}

package/dist/services/sync/authoritative-mirror.js

@@ -0,0 +1,71 @@
+export class AuthoritativeRevalidationRequiredError extends Error {
+    idempotencyKey;
+    constructor(idempotencyKey) {
+        super(`Authoritative command ${idempotencyKey} requires fresh state revalidation`);
+        this.name = "AuthoritativeRevalidationRequiredError";
+        this.idempotencyKey = idempotencyKey;
+    }
+}
+export class AuthoritativeMirror {
+    kind = "authoritative-mirror";
+    #apply;
+    #execute;
+    #staleAfterMs;
+    #applied = new Set();
+    #commands = new Map();
+    #snapshot;
+    constructor(options) {
+        if (!Number.isInteger(options.staleAfterMs) || options.staleAfterMs <= 0) {
+            throw new RangeError("Authoritative mirror staleAfterMs must be a positive integer");
+        }
+        this.#apply = options.apply;
+        this.#execute = options.execute;
+        this.#staleAfterMs = options.staleAfterMs;
+    }
+    async applyDelta(delta, context) {
+        if (this.#applied.has(delta.id))
+            return { applied: false };
+        const observedAt = parseDate(context.now, "snapshot observation time");
+        const snapshot = {
+            observedAt: context.now,
+            staleAt: new Date(observedAt + this.#staleAfterMs).toISOString(),
+            value: delta.payload,
+        };
+        await this.#apply(snapshot, delta);
+        this.#snapshot = snapshot;
+        this.#applied.add(delta.id);
+        return { applied: true };
+    }
+    snapshot() {
+        return this.#snapshot;
+    }
+    isStale(now) {
+        return this.#snapshot === undefined || parseDate(now, "current time") >= Date.parse(this.#snapshot.staleAt);
+    }
+    async runCommand(command, options) {
+        const existing = this.#commands.get(command.idempotencyKey);
+        if (existing !== undefined)
+            return await existing;
+        if (this.isStale(options.now)) {
+            const fresh = options.revalidate === undefined ? false : await options.revalidate();
+            if (!fresh)
+                throw new AuthoritativeRevalidationRequiredError(command.idempotencyKey);
+        }
+        const execution = this.#execute(command);
+        this.#commands.set(command.idempotencyKey, execution);
+        try {
+            return await execution;
+        }
+        catch (error) {
+            this.#commands.delete(command.idempotencyKey);
+            throw error;
+        }
+    }
+}
+function parseDate(value, label) {
+    const parsed = Date.parse(value);
+    if (!Number.isFinite(parsed))
+        throw new RangeError(`Invalid ${label}`);
+    return parsed;
+}
+//# sourceMappingURL=authoritative-mirror.js.map

package/dist/services/sync/authoritative-mirror.js.map

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

package/dist/services/sync/index.d.ts

@@ -0,0 +1,8 @@
+export { AuthoritativeMirror, AuthoritativeRevalidationRequiredError } from "./authoritative-mirror.js";
+export type { AuthoritativeCommandOptions, AuthoritativeMirrorOptions, } from "./authoritative-mirror.js";
+export { LogSync } from "./log-sync.js";
+export type { LogSyncOptions } from "./log-sync.js";
+export { RevisionMerge } from "./revision-merge.js";
+export type { RevisionMergeOptions, RevisionWriteInput } from "./revision-merge.js";
+export type { AuthoritativeCommand, AuthoritativeSnapshot, RevisionCommandResult, RevisionConflict, RevisionEntity, RevisionIntent, SyncApplyResult, SyncDelta, SyncDeltaContext, SyncStrategy, SyncStrategyKind, } from "./strategy.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/services/sync/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/sync/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,sCAAsC,EAAE,MAAM,2BAA2B,CAAC;AACxG,YAAY,EACV,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACpF,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,GACjB,MAAM,eAAe,CAAC"}

package/dist/services/sync/index.js

@@ -0,0 +1,4 @@
+export { AuthoritativeMirror, AuthoritativeRevalidationRequiredError } from "./authoritative-mirror.js";
+export { LogSync } from "./log-sync.js";
+export { RevisionMerge } from "./revision-merge.js";
+//# sourceMappingURL=index.js.map

package/dist/services/sync/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/sync/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,sCAAsC,EAAE,MAAM,2BAA2B,CAAC;AAKxG,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/services/sync/log-sync.d.ts

@@ -0,0 +1,12 @@
+import type { SyncApplyResult, SyncDelta, SyncDeltaContext, SyncStrategy } from "../../models/sync.js";
+export interface LogSyncOptions<TPayload> {
+    readonly apply: (payload: TPayload, delta: SyncDelta<TPayload>) => Promise<void>;
+    readonly key?: (delta: SyncDelta<TPayload>) => string;
+}
+export declare class LogSync<TPayload> implements SyncStrategy<TPayload> {
+    #private;
+    readonly kind: "log";
+    constructor(options: LogSyncOptions<TPayload>);
+    applyDelta(delta: SyncDelta<TPayload>, context: SyncDeltaContext): Promise<SyncApplyResult>;
+}
+//# sourceMappingURL=log-sync.d.ts.map

package/dist/services/sync/log-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-sync.d.ts","sourceRoot":"","sources":["../../../src/services/sync/log-sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,YAAY,EACb,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,cAAc,CAAC,QAAQ;IACtC,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,QAAQ,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjF,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,QAAQ,CAAC,KAAK,MAAM,CAAC;CACvD;AAED,qBAAa,OAAO,CAAC,QAAQ,CAAE,YAAW,YAAY,CAAC,QAAQ,CAAC;;IAC9D,QAAQ,CAAC,IAAI,EAAG,KAAK,CAAU;gBAKnB,OAAO,EAAE,cAAc,CAAC,QAAQ,CAAC;IAKvC,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;CAQlG"}

package/dist/services/sync/log-sync.js

@@ -0,0 +1,20 @@
+export class LogSync {
+    kind = "log";
+    #apply;
+    #key;
+    #applied = new Set();
+    constructor(options) {
+        this.#apply = options.apply;
+        this.#key = options.key ?? ((delta) => delta.id);
+    }
+    async applyDelta(delta, context) {
+        void context;
+        const key = this.#key(delta);
+        if (this.#applied.has(key))
+            return { applied: false };
+        await this.#apply(delta.payload, delta);
+        this.#applied.add(key);
+        return { applied: true };
+    }
+}
+//# sourceMappingURL=log-sync.js.map

package/dist/services/sync/log-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-sync.js","sourceRoot":"","sources":["../../../src/services/sync/log-sync.ts"],"names":[],"mappings":"AAYA,MAAM,OAAO,OAAO;IACT,IAAI,GAAG,KAAc,CAAC;IACtB,MAAM,CAAoC;IAC1C,IAAI,CAAyC;IAC7C,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IAEtC,YAAY,OAAiC;QAC3C,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAA0B,EAAE,OAAyB;QACpE,KAAK,OAAO,CAAC;QACb,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACtD,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;CACF"}

package/dist/services/sync/revision-merge.d.ts

@@ -0,0 +1,20 @@
+import type { RevisionCommandResult, RevisionConflict, RevisionEntity, RevisionIntent, SyncApplyResult, SyncDelta, SyncDeltaContext, SyncStrategy } from "../../models/sync.js";
+export interface RevisionMergeOptions<TValue> {
+    readonly parkConflict: (conflict: RevisionConflict<TValue>) => Promise<void>;
+    readonly read: (id: string) => Promise<RevisionEntity<TValue> | undefined>;
+    readonly write: (entity: RevisionEntity<TValue>) => Promise<void>;
+}
+export interface RevisionWriteInput<TValue> {
+    readonly baseRev?: number;
+    readonly id: string;
+    readonly value: TValue;
+}
+export declare class RevisionMerge<TValue> implements SyncStrategy<RevisionEntity<TValue>> {
+    #private;
+    readonly kind: "revision-merge";
+    constructor(options: RevisionMergeOptions<TValue>);
+    applyDelta(delta: SyncDelta<RevisionEntity<TValue>>, context: SyncDeltaContext): Promise<SyncApplyResult>;
+    createIntent(input: RevisionWriteInput<TValue>): Promise<RevisionIntent<TValue>>;
+    handleCommandResult(intent: RevisionIntent<TValue>, result: RevisionCommandResult<TValue>): Promise<void>;
+}
+//# sourceMappingURL=revision-merge.d.ts.map

package/dist/services/sync/revision-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revision-merge.d.ts","sourceRoot":"","sources":["../../../src/services/sync/revision-merge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,YAAY,EACb,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,oBAAoB,CAAC,MAAM;IAC1C,QAAQ,CAAC,YAAY,EAAE,CAAC,QAAQ,EAAE,gBAAgB,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC;IAC3E,QAAQ,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACnE;AAED,MAAM,WAAW,kBAAkB,CAAC,MAAM;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,aAAa,CAAC,MAAM,CAAE,YAAW,YAAY,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;;IAChF,QAAQ,CAAC,IAAI,EAAG,gBAAgB,CAAU;gBAM9B,OAAO,EAAE,oBAAoB,CAAC,MAAM,CAAC;IAM3C,UAAU,CACd,KAAK,EAAE,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,EACxC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC;IAarB,YAAY,CAAC,KAAK,EAAE,kBAAkB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IAShF,mBAAmB,CACvB,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,EAC9B,MAAM,EAAE,qBAAqB,CAAC,MAAM,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC;CAYjB"}

package/dist/services/sync/revision-merge.js

@@ -0,0 +1,46 @@
+export class RevisionMerge {
+    kind = "revision-merge";
+    #parkConflict;
+    #read;
+    #write;
+    #applied = new Set();
+    constructor(options) {
+        this.#parkConflict = options.parkConflict;
+        this.#read = options.read;
+        this.#write = options.write;
+    }
+    async applyDelta(delta, context) {
+        void context;
+        if (this.#applied.has(delta.id))
+            return { applied: false };
+        const local = await this.#read(delta.payload.id);
+        if (local !== undefined && local.rev >= delta.payload.rev) {
+            this.#applied.add(delta.id);
+            return { applied: false };
+        }
+        await this.#write(delta.payload);
+        this.#applied.add(delta.id);
+        return { applied: true };
+    }
+    async createIntent(input) {
+        const local = await this.#read(input.id);
+        return {
+            baseRev: input.baseRev ?? local?.rev ?? 0,
+            id: input.id,
+            value: input.value,
+        };
+    }
+    async handleCommandResult(intent, result) {
+        if (result.status === "accepted") {
+            await this.#write(result.entity);
+            return;
+        }
+        await this.#parkConflict({
+            baseRev: intent.baseRev,
+            id: intent.id,
+            mine: intent.value,
+            theirs: result.theirs,
+        });
+    }
+}
+//# sourceMappingURL=revision-merge.js.map

package/dist/services/sync/revision-merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"revision-merge.js","sourceRoot":"","sources":["../../../src/services/sync/revision-merge.ts"],"names":[],"mappings":"AAuBA,MAAM,OAAO,aAAa;IACf,IAAI,GAAG,gBAAyB,CAAC;IACjC,aAAa,CAA+C;IAC5D,KAAK,CAAuC;IAC5C,MAAM,CAAwC;IAC9C,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IAEtC,YAAY,OAAqC;QAC/C,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;QAC1C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,UAAU,CACd,KAAwC,EACxC,OAAyB;QAEzB,KAAK,OAAO,CAAC;QACb,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC3D,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACjD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;YAC1D,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC5B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC5B,CAAC;QACD,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACjC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC5B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,KAAiC;QAClD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACzC,OAAO;YACL,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,KAAK,EAAE,GAAG,IAAI,CAAC;YACzC,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,mBAAmB,CACvB,MAA8B,EAC9B,MAAqC;QAErC,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YACjC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACjC,OAAO;QACT,CAAC;QACD,MAAM,IAAI,CAAC,aAAa,CAAC;YACvB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,IAAI,EAAE,MAAM,CAAC,KAAK;YAClB,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/services/sync/strategy.d.ts

@@ -0,0 +1,2 @@
+export { type AuthoritativeCommand, type AuthoritativeSnapshot, type RevisionCommandResult, type RevisionConflict, type RevisionEntity, type RevisionIntent, type SyncApplyResult, type SyncDelta, type SyncDeltaContext, type SyncStrategy, type SyncStrategyKind, } from "../../models/sync.js";
+//# sourceMappingURL=strategy.d.ts.map

package/dist/services/sync/strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.d.ts","sourceRoot":"","sources":["../../../src/services/sync/strategy.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,gBAAgB,GACtB,MAAM,sBAAsB,CAAC"}

package/dist/services/sync/strategy.js

@@ -0,0 +1,2 @@
+export {} from "../../models/sync.js";
+//# sourceMappingURL=strategy.js.map

package/dist/services/sync/strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.js","sourceRoot":"","sources":["../../../src/services/sync/strategy.ts"],"names":[],"mappings":"AAAA,OAAO,EAYN,MAAM,sBAAsB,CAAC"}

package/dist/services/transport-manager.d.ts

@@ -0,0 +1,22 @@
+import type { DelayPort, HomeNodeCandidate, HomeNodeClient, TransportState } from "@econ-v1/ports";
+export interface TransportManagerOptions {
+    readonly candidates: readonly HomeNodeCandidate[];
+    readonly dial: (candidate: HomeNodeCandidate, signal: AbortSignal) => Promise<HomeNodeClient>;
+    readonly delay?: DelayPort;
+    /** Delay before the next lower-priority candidate is allowed to race. */
+    readonly priorityGraceMs?: number;
+    /** Upper bound for one candidate dial. */
+    readonly candidateTimeoutMs?: number;
+    readonly now?: () => string;
+    readonly onState?: (state: TransportState) => void;
+}
+/** Fixed-priority home-node transport policy. Adapters own I/O; this class owns selection. */
+export declare class TransportManager {
+    #private;
+    constructor(options: TransportManagerOptions);
+    get state(): TransportState;
+    subscribe(listener: (state: TransportState) => void): () => void;
+    connect(): Promise<HomeNodeClient>;
+    markOffline(): void;
+}
+//# sourceMappingURL=transport-manager.d.ts.map

package/dist/services/transport-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-manager.d.ts","sourceRoot":"","sources":["../../src/services/transport-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,cAAc,EAAiB,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAElH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,UAAU,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAClD,QAAQ,CAAC,IAAI,EAAE,CAAC,SAAS,EAAE,iBAAiB,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAC9F,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAC3B,yEAAyE;IACzE,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,0CAA0C;IAC1C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CACpD;AAED,8FAA8F;AAC9F,qBAAa,gBAAgB;;gBAYf,OAAO,EAAE,uBAAuB;IAU5C,IAAI,KAAK,IAAI,cAAc,CAAwB;IAEnD,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GAAG,MAAM,IAAI;IAK1D,OAAO,IAAI,OAAO,CAAC,cAAc,CAAC;IAWxC,WAAW,IAAI,IAAI;CAmGpB"}