@amalgm/live 0.2.29 → 0.2.31

package/dist/records/rail.js

@@ -0,0 +1,250 @@
+/** Portable, event-driven Send and Receive orchestration. Hosts inject effects. */
+import { nextEntitySends } from './outbox.js';
+export const ENTITY_RECORD_DELIVERY_LIMIT = 256;
+export const ENTITY_RECORD_RETRY_BASE_MS = 1_000;
+export const ENTITY_RECORD_RETRY_MAX_MS = 30_000;
+/**
+ * One rail has only two reasons to run: local work exists, or authority work
+ * may exist. Repeated reasons coalesce while the current run is in flight.
+ */
+export class EntityRecordRail {
+    #authorityId;
+    #store;
+    #cargo;
+    #authority;
+    #schedule;
+    #onInboxCommitted;
+    #onBackgroundError;
+    #started = false;
+    #stopped = false;
+    #subscribed = false;
+    #needsSubscribe = false;
+    #needsSend = false;
+    #running = null;
+    #retry = null;
+    #retryAttempt = 0;
+    #removeAvailable = null;
+    #removeDisconnect = null;
+    constructor(options) {
+        if (!options.authorityId.trim())
+            throw new Error('entity record authority is required');
+        this.#authorityId = options.authorityId;
+        this.#store = options.store;
+        this.#cargo = options.cargo;
+        this.#authority = options.authority;
+        this.#schedule = options.schedule;
+        this.#onInboxCommitted = options.onInboxCommitted ?? (() => undefined);
+        this.#onBackgroundError = options.onBackgroundError ?? (() => undefined);
+    }
+    /** Subscribe first, catch up from the durable cursor, then drain local work. */
+    async start() {
+        if (this.#started)
+            throw new Error('entity record rail already started');
+        if (this.#stopped)
+            throw new Error('entity record rail is stopped');
+        this.#started = true;
+        this.#removeAvailable = this.#authority.onAvailable((signal) => {
+            if (signal.authorityId !== this.#authorityId || this.#stopped)
+                return;
+            this.#needsSubscribe = true;
+            this.#kick();
+        });
+        this.#removeDisconnect = this.#authority.onDisconnect(() => {
+            if (this.#stopped)
+                return;
+            this.#subscribed = false;
+            this.#needsSubscribe = true;
+            this.#scheduleRetry();
+        });
+        this.#needsSubscribe = true;
+        this.#needsSend = true;
+        await this.#runExplicitly();
+    }
+    /** Record calls this only after its local outbox transaction commits. */
+    localRecordsAvailable() {
+        if (this.#stopped)
+            return;
+        this.#needsSend = true;
+        if (this.#started)
+            this.#kick();
+    }
+    /** Await all work known at this boundary; it never creates an idle query. */
+    async flush() {
+        if (!this.#started)
+            throw new Error('entity record rail has not started');
+        if (this.#stopped)
+            return;
+        this.#needsSend = true;
+        if (!this.#subscribed)
+            this.#needsSubscribe = true;
+        await this.#runExplicitly();
+    }
+    /** Stop accepting events. Closing the injected wire may interrupt a request. */
+    async stop() {
+        if (this.#stopped)
+            return;
+        this.#stopped = true;
+        this.#cancelRetry();
+        this.#removeAvailable?.();
+        this.#removeAvailable = null;
+        this.#removeDisconnect?.();
+        this.#removeDisconnect = null;
+        await this.#running?.catch(() => undefined);
+    }
+    async #runExplicitly() {
+        this.#cancelRetry();
+        try {
+            await this.#ensureRun();
+            this.#retryAttempt = 0;
+        }
+        catch (error) {
+            this.#scheduleRetry();
+            throw error;
+        }
+    }
+    #kick() {
+        if (!this.#started || this.#stopped)
+            return;
+        this.#cancelRetry();
+        void this.#ensureRun().then(() => {
+            this.#retryAttempt = 0;
+        }, (error) => {
+            this.#onBackgroundError(error);
+            this.#scheduleRetry();
+        });
+    }
+    #ensureRun() {
+        if (this.#running)
+            return this.#running;
+        const running = this.#drain();
+        this.#running = running;
+        void running.then(() => {
+            if (this.#running === running)
+                this.#running = null;
+            if (!this.#stopped && (this.#needsSubscribe || this.#needsSend))
+                this.#kick();
+        }, () => {
+            if (this.#running === running)
+                this.#running = null;
+        });
+        return running;
+    }
+    async #drain() {
+        while (!this.#stopped && (this.#needsSubscribe || this.#needsSend)) {
+            if (this.#needsSubscribe) {
+                this.#needsSubscribe = false;
+                try {
+                    await this.#catchUp();
+                    this.#subscribed = true;
+                }
+                catch (error) {
+                    this.#subscribed = false;
+                    this.#needsSubscribe = true;
+                    throw error;
+                }
+            }
+            if (this.#stopped)
+                return;
+            if (this.#needsSend) {
+                this.#needsSend = false;
+                try {
+                    if (await this.#sendPending())
+                        this.#needsSubscribe = true;
+                }
+                catch (error) {
+                    this.#needsSend = true;
+                    throw error;
+                }
+            }
+        }
+    }
+    async #catchUp() {
+        let after = await this.#store.readDeliveryCursor(this.#authorityId);
+        while (!this.#stopped) {
+            const deliveries = await this.#authority.subscribe({
+                authorityId: this.#authorityId,
+                afterDeliverySequence: after,
+                limit: ENTITY_RECORD_DELIVERY_LIMIT,
+            });
+            if (deliveries.length === 0)
+                return;
+            let stored = await this.#store.receive({
+                authorityId: this.#authorityId,
+                deliveries,
+                advanceDeliveryCursor: true,
+            });
+            if (stored.kind === 'stored')
+                this.#onInboxCommitted();
+            if (stored.kind === 'gap') {
+                const missing = await this.#authority.backfill({
+                    authorityId: this.#authorityId,
+                    entityId: stored.gap.entityId,
+                    afterGlobalSequence: stored.gap.after,
+                    throughGlobalSequence: stored.gap.received,
+                });
+                if (missing.length === 0) {
+                    throw new Error(`entity ${stored.gap.entityId} is missing sequence ${stored.gap.after + 1}`);
+                }
+                const repaired = await this.#store.receive({
+                    authorityId: this.#authorityId,
+                    deliveries: missing,
+                    advanceDeliveryCursor: false,
+                });
+                if (repaired.kind === 'gap') {
+                    throw new Error(`entity ${repaired.gap.entityId} history remained gapped after backfill`);
+                }
+                this.#onInboxCommitted();
+                stored = await this.#store.receive({
+                    authorityId: this.#authorityId,
+                    deliveries,
+                    advanceDeliveryCursor: true,
+                });
+                if (stored.kind === 'gap') {
+                    throw new Error(`entity ${stored.gap.entityId} history did not reach ${stored.gap.received}`);
+                }
+                this.#onInboxCommitted();
+            }
+            after = stored.deliveryCursor;
+            if (deliveries.length < ENTITY_RECORD_DELIVERY_LIMIT)
+                return;
+        }
+    }
+    async #sendPending() {
+        let sent = false;
+        while (!this.#stopped) {
+            const pending = await this.#store.readPending();
+            const selected = nextEntitySends(pending);
+            if (selected.length === 0)
+                return sent;
+            const results = await Promise.allSettled(selected.map(async (row) => {
+                await this.#cargo.ensure(row.record);
+                if (this.#stopped)
+                    return;
+                const accepted = await this.#authority.submit(row.record);
+                await this.#store.stampAccepted(row, accepted);
+                sent = true;
+            }));
+            const failure = results.find((result) => result.status === 'rejected');
+            if (failure)
+                throw failure.reason;
+        }
+        return sent;
+    }
+    #scheduleRetry() {
+        if (this.#stopped || this.#retry)
+            return;
+        const base = Math.min(ENTITY_RECORD_RETRY_MAX_MS, ENTITY_RECORD_RETRY_BASE_MS * (2 ** Math.min(this.#retryAttempt, 16)));
+        const random = Math.max(0, Math.min(1, this.#schedule.random()));
+        const delay = Math.round(base * (0.5 + random));
+        this.#retryAttempt += 1;
+        this.#retry = this.#schedule.schedule(delay, () => {
+            this.#retry = null;
+            this.#kick();
+        });
+    }
+    #cancelRetry() {
+        this.#retry?.cancel();
+        this.#retry = null;
+    }
+}
+//# sourceMappingURL=rail.js.map

package/dist/records/rail.js.map

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

package/dist/records/wire.d.ts

@@ -0,0 +1,63 @@
+/** Exact wire for the entity Record/Send/Receive rail. */
+import type { DeliveredEntityRecord, EntityRecordAuthorityPort, EntityRecordAvailability } from './rail.js';
+export interface EntityRecordSubmitFrame {
+    readonly type: 'entity.record.submit';
+    readonly request_id: string;
+    readonly record_json: string;
+}
+export interface EntityRecordSubscribeFrame {
+    readonly type: 'entity.record.subscribe';
+    readonly request_id: string;
+    readonly authority_id: string;
+    readonly after_delivery_sequence: number;
+    readonly limit: number;
+}
+export interface EntityRecordBackfillFrame {
+    readonly type: 'entity.record.backfill';
+    readonly request_id: string;
+    readonly authority_id: string;
+    readonly entity_id: string;
+    readonly after_global_sequence: number;
+    readonly through_global_sequence: number;
+}
+export type EntityRecordRuntimeFrame = EntityRecordSubmitFrame | EntityRecordSubscribeFrame | EntityRecordBackfillFrame;
+export interface EntityRecordAckFrame {
+    readonly type: 'entity.record.ack';
+    readonly request_id: string;
+    readonly record_json: string;
+    readonly duplicate: boolean;
+}
+export interface EntityRecordDeliveryFrame {
+    readonly delivery_sequence: number;
+    readonly record_json: string;
+}
+export interface EntityRecordSubscribedFrame {
+    readonly type: 'entity.record.subscribed';
+    readonly request_id: string;
+    readonly records: readonly EntityRecordDeliveryFrame[];
+}
+export interface EntityRecordBackfillResultFrame {
+    readonly type: 'entity.record.backfill-result';
+    readonly request_id: string;
+    readonly records: readonly EntityRecordDeliveryFrame[];
+}
+export interface EntityRecordAvailableFrame {
+    readonly type: 'entity.record.available';
+    readonly authority_id: string;
+}
+export type EntityRecordAuthorityFrame = EntityRecordAckFrame | EntityRecordSubscribedFrame | EntityRecordBackfillResultFrame | EntityRecordAvailableFrame;
+type WithoutRequestId<T> = T extends {
+    readonly request_id: string;
+} ? Omit<T, 'request_id'> : T;
+export type EntityRecordWireRequest = WithoutRequestId<EntityRecordRuntimeFrame>;
+export interface EntityRecordWirePort {
+    request(frame: EntityRecordWireRequest, acceptedTypes: readonly string[]): Promise<unknown>;
+    onFrame(listener: (frame: unknown) => void): () => void;
+    onDisconnect(listener: (error: unknown) => void): () => void;
+}
+export declare function decodeEntityRecordDeliveries(value: unknown): readonly DeliveredEntityRecord[];
+export declare function decodeEntityRecordAvailability(value: unknown): EntityRecordAvailability;
+/** Map one authenticated request/event wire onto the portable authority port. */
+export declare function createEntityRecordAuthorityPort(wire: EntityRecordWirePort): EntityRecordAuthorityPort;
+export {};
+//# sourceMappingURL=wire.d.ts.map

package/dist/records/wire.d.ts.map

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

package/dist/records/wire.js

@@ -0,0 +1,86 @@
+/** Exact wire for the entity Record/Send/Receive rail. */
+import { isRecord } from '../contracts/validate.js';
+import { decodeAcceptedEntityRecord, encodeEntityRecord } from './codec.js';
+const positiveSequence = (value) => typeof value === 'number' && Number.isSafeInteger(value) && value > 0;
+export function decodeEntityRecordDeliveries(value) {
+    if (!Array.isArray(value))
+        throw new Error('entity record authority did not return a records array');
+    return Object.freeze(value.map((item) => {
+        if (!isRecord(item)
+            || !positiveSequence(item.delivery_sequence)
+            || typeof item.record_json !== 'string') {
+            throw new Error('entity record authority returned an invalid delivery');
+        }
+        return Object.freeze({
+            deliverySequence: item.delivery_sequence,
+            record: decodeAcceptedEntityRecord(item.record_json),
+        });
+    }));
+}
+export function decodeEntityRecordAvailability(value) {
+    if (!isRecord(value)
+        || value.type !== 'entity.record.available'
+        || typeof value.authority_id !== 'string'
+        || !value.authority_id) {
+        throw new Error('entity record availability signal is invalid');
+    }
+    return Object.freeze({
+        authorityId: value.authority_id,
+    });
+}
+/** Map one authenticated request/event wire onto the portable authority port. */
+export function createEntityRecordAuthorityPort(wire) {
+    return {
+        async submit(record) {
+            const frame = await wire.request({
+                type: 'entity.record.submit',
+                record_json: encodeEntityRecord(record),
+            }, ['entity.record.ack']);
+            if (!isRecord(frame) || frame.type !== 'entity.record.ack' || typeof frame.record_json !== 'string') {
+                throw new Error('entity record acknowledgement is invalid');
+            }
+            return decodeAcceptedEntityRecord(frame.record_json);
+        },
+        async subscribe(input) {
+            const frame = await wire.request({
+                type: 'entity.record.subscribe',
+                authority_id: input.authorityId,
+                after_delivery_sequence: input.afterDeliverySequence,
+                limit: input.limit,
+            }, ['entity.record.subscribed']);
+            if (!isRecord(frame) || frame.type !== 'entity.record.subscribed') {
+                throw new Error('entity record subscription response is invalid');
+            }
+            return decodeEntityRecordDeliveries(frame.records);
+        },
+        async backfill(input) {
+            const frame = await wire.request({
+                type: 'entity.record.backfill',
+                authority_id: input.authorityId,
+                entity_id: input.entityId,
+                after_global_sequence: input.afterGlobalSequence,
+                through_global_sequence: input.throughGlobalSequence,
+            }, ['entity.record.backfill-result']);
+            if (!isRecord(frame) || frame.type !== 'entity.record.backfill-result') {
+                throw new Error('entity record backfill response is invalid');
+            }
+            return decodeEntityRecordDeliveries(frame.records);
+        },
+        onAvailable(listener) {
+            return wire.onFrame((frame) => {
+                if (!isRecord(frame) || frame.type !== 'entity.record.available')
+                    return;
+                try {
+                    listener(decodeEntityRecordAvailability(frame));
+                }
+                catch {
+                    // A malformed unsolicited frame is not authority evidence.
+                }
+            });
+        },
+        onDisconnect(listener) {
+            return wire.onDisconnect(listener);
+        },
+    };
+}
+//# sourceMappingURL=wire.js.map

package/dist/records/wire.js.map

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

package/dist-cjs/apply/content-results.js

@@ -0,0 +1,57 @@
+"use strict";
+/** Portable private-result construction for file and link adapters. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prepareTextResult = prepareTextResult;
+exports.prepareBinaryResult = prepareBinaryResult;
+exports.prepareLinkResult = prepareLinkResult;
+const content_js_1 = require("../detection/content.js");
+const bytes_js_1 = require("../entities/bytes.js");
+const exactResult = (bytes, expected, sha256Hex, label) => {
+    if (sha256Hex(bytes) !== expected) {
+        throw new Error(`${label} does not match its accepted complete result`);
+    }
+    return bytes;
+};
+/**
+ * Construct text privately. The snapshot is mandatory truth. A delta is only
+ * a shortcut over the exact immutable base; reproduceTextChange falls back to
+ * the already-verified snapshot on every base or result mismatch. The returned
+ * snapshot reference remains caller-owned immutable input; Apply never mutates
+ * it and the host streams it into private staging.
+ */
+function prepareTextResult(plan, snapshot, exactBase, sha256Hex) {
+    const verifiedSnapshot = exactResult(snapshot, plan.artifact.contentHash, sha256Hex, 'text Apply snapshot');
+    if (plan.strategy.kind === 'snapshot')
+        return verifiedSnapshot;
+    return (0, content_js_1.reproduceTextChange)(exactBase, {
+        kind: 'file.text',
+        mode: 'delta',
+        basePayloadVersion: plan.strategy.basePayloadVersion,
+        resultPayloadVersion: plan.artifact.contentHash,
+        delta: plan.strategy.delta,
+    }, verifiedSnapshot, sha256Hex);
+}
+/** Verify reusable binary blocks while streaming them into private staging. */
+async function prepareBinaryResult(plan, read, sink, sha256Hex) {
+    for (const [index, expected] of plan.manifest.chunks.entries()) {
+        const chunk = await read(index);
+        if (!(chunk instanceof Uint8Array)
+            || chunk.byteLength !== expected.bytes
+            || sha256Hex(chunk) !== expected.sha256) {
+            throw new Error(`binary Apply block ${index} failed verification`);
+        }
+        await sink.write(index, chunk);
+    }
+    const receipt = await sink.seal();
+    if (receipt.bytes !== plan.manifest.bytes
+        || receipt.contentHash !== plan.artifact.contentHash) {
+        throw new Error('binary Apply staged result failed complete verification');
+    }
+    return Object.freeze({ ...receipt });
+}
+/** A link result is only its literal UTF-8 target bytes. */
+function prepareLinkResult(plan, sha256Hex) {
+    exactResult((0, bytes_js_1.utf8Encode)(plan.targetText), plan.artifact.contentHash, sha256Hex, 'link Apply target');
+    return plan.targetText;
+}
+//# sourceMappingURL=content-results.js.map

package/dist-cjs/apply/content-results.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-results.js","sourceRoot":"","sources":["../../src/apply/content-results.ts"],"names":[],"mappings":";AAAA,uEAAuE;;AA0BvE,8CAiBC;AAeD,kDAqBC;AAGD,8CAKC;AArFD,wDAA8D;AAC9D,mDAAkD;AAIlD,MAAM,WAAW,GAAG,CAClB,KAAiB,EACjB,QAAgB,EAChB,SAAoB,EACpB,KAAa,EACD,EAAE;IACd,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,QAAQ,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,8CAA8C,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAC/B,IAAmB,EACnB,QAAoB,EACpB,SAA4B,EAC5B,SAAoB;IAEpB,MAAM,gBAAgB,GAAG,WAAW,CAClC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,EAAE,qBAAqB,CACtE,CAAC;IACF,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,gBAAgB,CAAC;IAC/D,OAAO,IAAA,gCAAmB,EAAC,SAAS,EAAE;QACpC,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,OAAO;QACb,kBAAkB,EAAE,IAAI,CAAC,QAAQ,CAAC,kBAAkB;QACpD,oBAAoB,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW;QAC/C,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK;KAC3B,EAAE,gBAAgB,EAAE,SAAS,CAAC,CAAC;AAClC,CAAC;AAcD,+EAA+E;AACxE,KAAK,UAAU,mBAAmB,CACvC,IAAqB,EACrB,IAA4C,EAC5C,IAAqB,EACrB,SAAoB;IAEpB,KAAK,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QAC/D,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,CAAC,CAAC,KAAK,YAAY,UAAU,CAAC;eAC7B,KAAK,CAAC,UAAU,KAAK,QAAQ,CAAC,KAAK;eACnC,SAAS,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,sBAAsB,KAAK,sBAAsB,CAAC,CAAC;QACrE,CAAC;QACD,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IAClC,IAAI,OAAO,CAAC,KAAK,KAAK,IAAI,CAAC,QAAQ,CAAC,KAAK;WACpC,OAAO,CAAC,WAAW,KAAK,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,4DAA4D;AAC5D,SAAgB,iBAAiB,CAAC,IAAmB,EAAE,SAAoB;IACzE,WAAW,CACT,IAAA,qBAAU,EAAC,IAAI,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,EAAE,mBAAmB,CACvF,CAAC;IACF,OAAO,IAAI,CAAC,UAAU,CAAC;AACzB,CAAC"}

package/dist-cjs/apply/contracts.js

@@ -0,0 +1,53 @@
+"use strict";
+/** Portable contracts at the Inbox -> Apply -> Verify boundary. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ENTITY_APPLY_INTENT_CONTRACT = void 0;
+exports.assertApplyIntent = assertApplyIntent;
+exports.createApplyIntent = createApplyIntent;
+exports.advanceApplyIntent = advanceApplyIntent;
+const types_js_1 = require("../entities/types.js");
+exports.ENTITY_APPLY_INTENT_CONTRACT = 'amalgm.entity-apply-intent@1';
+const HASH = /^[0-9a-f]{64}$/;
+const PHASES = new Set(['declared', 'prepared', 'revealed']);
+const sequence = (value, positive = false) => Number.isSafeInteger(value) && value >= (positive ? 1 : 0);
+function assertApplyIntent(intent) {
+    if (intent.contract !== exports.ENTITY_APPLY_INTENT_CONTRACT
+        || !intent.authorityId
+        || !types_js_1.UUID_PATTERN.test(intent.entityId)
+        || !sequence(intent.fromSequence)
+        || !sequence(intent.throughSequence, true)
+        || intent.throughSequence < intent.fromSequence + 1
+        || !intent.targetMutationId
+        || !HASH.test(intent.targetState)
+        || !(0, types_js_1.isEntityType)(intent.targetType)
+        || !PHASES.has(intent.phase)
+        || !sequence(intent.createdAt)) {
+        throw new Error('entity Apply intent is invalid');
+    }
+}
+function createApplyIntent(input) {
+    const intent = Object.freeze({
+        contract: exports.ENTITY_APPLY_INTENT_CONTRACT,
+        authorityId: input.authorityId,
+        entityId: input.entityId,
+        fromSequence: input.fromSequence,
+        throughSequence: input.target.globalSequence,
+        targetMutationId: input.target.mutationId,
+        targetState: input.target.resultState,
+        targetType: input.target.change.result.type,
+        phase: 'declared',
+        createdAt: input.createdAt,
+    });
+    assertApplyIntent(intent);
+    return intent;
+}
+function advanceApplyIntent(intent, phase) {
+    assertApplyIntent(intent);
+    const legal = intent.phase === phase
+        || (intent.phase === 'declared' && phase === 'prepared')
+        || (intent.phase === 'prepared' && phase === 'revealed');
+    if (!legal)
+        throw new Error(`entity Apply intent cannot move from ${intent.phase} to ${phase}`);
+    return Object.freeze({ ...intent, phase });
+}
+//# sourceMappingURL=contracts.js.map

package/dist-cjs/apply/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/apply/contracts.ts"],"names":[],"mappings":";AAAA,mEAAmE;;;AA2NnE,8CAcC;AAED,8CAqBC;AAED,gDAUC;AAzQD,mDAAmG;AAMtF,QAAA,4BAA4B,GAAG,8BAA8B,CAAC;AA4M3E,MAAM,IAAI,GAAG,gBAAgB,CAAC;AAC9B,MAAM,MAAM,GAAG,IAAI,GAAG,CAAmB,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;AAE/E,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAE,QAAQ,GAAG,KAAK,EAAW,EAAE,CAC5D,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE7D,SAAgB,iBAAiB,CAAC,MAAyB;IACzD,IAAI,MAAM,CAAC,QAAQ,KAAK,oCAA4B;WAC/C,CAAC,MAAM,CAAC,WAAW;WACnB,CAAC,uBAAY,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;WACnC,CAAC,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC;WAC9B,CAAC,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,IAAI,CAAC;WACvC,MAAM,CAAC,eAAe,GAAG,MAAM,CAAC,YAAY,GAAG,CAAC;WAChD,CAAC,MAAM,CAAC,gBAAgB;WACxB,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;WAC9B,CAAC,IAAA,uBAAY,EAAC,MAAM,CAAC,UAAU,CAAC;WAChC,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC;WACzB,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;AACH,CAAC;AAED,SAAgB,iBAAiB,CAAC,KAMjC;IACC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC3B,QAAQ,EAAE,oCAA4B;QACtC,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,eAAe,EAAE,KAAK,CAAC,MAAM,CAAC,cAAc;QAC5C,gBAAgB,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU;QACzC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,WAAW;QACrC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI;QAC3C,KAAK,EAAE,UAAmB;QAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC,CAAC;IACH,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAgB,kBAAkB,CAChC,MAAyB,EACzB,KAA4C;IAE5C,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,KAAK,KAAK;WAC/B,CAAC,MAAM,CAAC,KAAK,KAAK,UAAU,IAAI,KAAK,KAAK,UAAU,CAAC;WACrD,CAAC,MAAM,CAAC,KAAK,KAAK,UAAU,IAAI,KAAK,KAAK,UAAU,CAAC,CAAC;IAC3D,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,MAAM,CAAC,KAAK,OAAO,KAAK,EAAE,CAAC,CAAC;IAChG,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AAC7C,CAAC"}

package/dist-cjs/apply/index.js

@@ -0,0 +1,28 @@
+"use strict";
+/** Entity Apply and Verify subsystem. */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.planEntityApply = void 0;
+__exportStar(require("./contracts.js"), exports);
+__exportStar(require("./content-results.js"), exports);
+__exportStar(require("./local-work.js"), exports);
+var plans_js_1 = require("./plans.js");
+Object.defineProperty(exports, "planEntityApply", { enumerable: true, get: function () { return plans_js_1.planEntityApply; } });
+__exportStar(require("./rail.js"), exports);
+__exportStar(require("./repository-result.js"), exports);
+__exportStar(require("./selection.js"), exports);
+__exportStar(require("./type-adapters.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist-cjs/apply/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/apply/index.ts"],"names":[],"mappings":";AAAA,yCAAyC;;;;;;;;;;;;;;;;;AAEzC,iDAA+B;AAC/B,uDAAqC;AACrC,kDAAgC;AAChC,uCAA6C;AAApC,2GAAA,eAAe,OAAA;AACxB,4CAA0B;AAC1B,yDAAuC;AACvC,iDAA+B;AAC/B,qDAAmC"}

package/dist-cjs/apply/local-work.js

@@ -0,0 +1,20 @@
+"use strict";
+/** Pure form of the Outbox gate used by the Apply store transaction. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasLocalWorkAfter = hasLocalWorkAfter;
+/**
+ * A local result protects working ground when cloud has not sequenced it yet,
+ * or when its accepted sequence is later than the incoming target. An
+ * accepted local row at the target is no longer a blocker: that is the
+ * official position Apply should Verify against the already-equal disk.
+ */
+function hasLocalWorkAfter(rows, authorityId, entityId, targetSequence) {
+    if (!authorityId || !entityId
+        || !Number.isSafeInteger(targetSequence) || targetSequence < 1) {
+        throw new Error('Apply local-work target is invalid');
+    }
+    return rows.some((row) => row.record.authorityId === authorityId
+        && row.record.entityId === entityId
+        && (row.status === 'pending' || row.globalSequence > targetSequence));
+}
+//# sourceMappingURL=local-work.js.map

package/dist-cjs/apply/local-work.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-work.js","sourceRoot":"","sources":["../../src/apply/local-work.ts"],"names":[],"mappings":";AAAA,wEAAwE;;AAUxE,8CAaC;AAnBD;;;;;GAKG;AACH,SAAgB,iBAAiB,CAC/B,IAA0B,EAC1B,WAAmB,EACnB,QAAgB,EAChB,cAAsB;IAEtB,IAAI,CAAC,WAAW,IAAI,CAAC,QAAQ;WACxB,CAAC,MAAM,CAAC,aAAa,CAAC,cAAc,CAAC,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,KAAK,WAAW;WAC3D,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,QAAQ;WAChC,CAAC,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,GAAG,CAAC,cAAc,GAAG,cAAc,CAAC,CAAC,CAAC;AAC1E,CAAC"}