@tangle-network/braid 0.1.0

package/dist/app/application-support.js

@@ -0,0 +1,386 @@
+import { canonicalDigest } from '../domain/canonical.js';
+import { providerEventKey } from '../domain/events.js';
+import { redactBraidEvent } from '../domain/redaction.js';
+import { reduceEvent } from '../domain/reducer.js';
+import { usageSnapshotForRun } from '../domain/run-usage.js';
+import { AppError } from './errors.js';
+import { cancelRequestDigest, DEFAULT_CANCEL_REASON, shutdownRequestDigest, } from './operation-ledger.js';
+import { safeProviderDiagnostic } from './provider-values.js';
+import { RUN_EFFECT_KIND, runEffectRequest } from './run-admission.js';
+import { executeRun } from './run-execution.js';
+export function startApplicationRun(input) {
+    const request = runEffectRequest(input.runInput);
+    const handle = input.effects.start({
+        operationId: input.runInput.operationId,
+        effectKind: RUN_EFFECT_KIND,
+        request,
+        requestDigest: input.requestDigest,
+        serializationKey: `run:${input.admission.runId}:execution`,
+        signal: input.abort.signal,
+        metadata: { runId: input.admission.runId },
+    }, {
+        dispatch: async () => {
+            await input.context.flush();
+            await executeRun(input.context, input.runInput, input.admission, input.abort);
+            return runOutcome(input.context, input.admission.runId);
+        },
+    });
+    return handle.completion.then(async (record) => {
+        try {
+            await input.context.flush();
+        }
+        catch (error) {
+            if (input.context.storageFailure?.() === undefined)
+                throw error;
+            return { status: 'unknown', detail: 'RUN_DURABILITY_UNKNOWN' };
+        }
+        return {
+            status: record.status === 'pending' || record.status === 'conflict' ? 'unknown' : record.status,
+            ...(record.detail === undefined ? {} : { detail: record.detail }),
+        };
+    });
+}
+function runOutcome(context, runId) {
+    const run = context.currentState().runs.find((candidate) => candidate.id === runId);
+    if (!run)
+        return { status: 'unknown', detail: 'RUN_STATE_MISSING' };
+    if (run.status === 'completed')
+        return { status: 'terminal', detail: 'completed' };
+    if (run.status === 'unknown')
+        return { status: 'unknown', detail: run.error ?? 'unknown' };
+    if (run.status === 'failed')
+        return { status: 'failed', detail: 'failed' };
+    if (run.status === 'aborted' || run.status === 'cancelled')
+        return { status: 'failed', detail: run.status };
+    return { status: 'unknown', detail: 'RUN_NOT_TERMINAL' };
+}
+export function restoreApplicationOperations(events, target) {
+    const acknowledgements = new Map();
+    for (const envelope of events) {
+        const event = envelope.event;
+        if (event.kind === 'run.requested' && event.receipt) {
+            const run = target.state().runs.find((candidate) => candidate.id === event.runId);
+            if (run) {
+                target.ledger.setOperation({
+                    digest: event.requestDigest ??
+                        canonicalDigest({
+                            command: 'send',
+                            conversationId: event.receipt.conversationId,
+                            branchId: event.receipt.branchId,
+                            text: event.text,
+                            profile: event.receipt.requested.profile,
+                            connectionId: event.receipt.requested.connectionId ?? null,
+                        }),
+                    runId: run.id,
+                    admission: event.receipt,
+                    completion: Promise.resolve(),
+                });
+                if (!isTerminalStatus(run.status))
+                    target.ledger.setAbort(run.id, new AbortController());
+            }
+        }
+        else if (event.kind === 'run.cancel.requested') {
+            const restoredRun = target.state().runs.find((run) => run.id === event.runId);
+            target.ledger.setControl(event.operationId, {
+                digest: cancelRequestDigest(event.runId, event.reason ?? DEFAULT_CANCEL_REASON, restoredRun?.providerSessionId),
+                runId: event.runId,
+                control: 'cancel',
+                acknowledgement: Promise.resolve({
+                    operationId: event.operationId,
+                    outcome: 'unknown',
+                    detail: 'Cancellation was requested before the provider acknowledged it',
+                }),
+                completion: Promise.resolve(target.state()),
+                ...(restoredRun?.providerSessionId === undefined
+                    ? {}
+                    : { providerSessionId: restoredRun.providerSessionId }),
+                ...(event.reason === undefined ? {} : { reason: event.reason }),
+            });
+        }
+        else if (event.kind === 'run.control.requested') {
+            const restoredRun = target.state().runs.find((run) => run.id === event.runId);
+            const digest = event.control === 'cancel'
+                ? cancelRequestDigest(event.runId, event.reason ?? DEFAULT_CANCEL_REASON, restoredRun?.providerSessionId)
+                : event.digest;
+            target.ledger.setControl(event.operationId, {
+                digest,
+                runId: event.runId,
+                control: event.control,
+                acknowledgement: Promise.resolve({
+                    operationId: event.operationId,
+                    outcome: 'unknown',
+                    detail: 'Control acknowledgement requires provider reconciliation',
+                }),
+                completion: Promise.resolve(target.state()),
+                ...(restoredRun?.providerSessionId === undefined
+                    ? {}
+                    : { providerSessionId: restoredRun.providerSessionId }),
+                ...(event.reason === undefined ? {} : { reason: event.reason }),
+                ...(event.text === undefined ? {} : { text: event.text }),
+            });
+        }
+        else if (event.kind === 'application.shutdown.requested') {
+            target.ledger.setShutdown(event.operationId, {
+                digest: shutdownRequestDigest(),
+                completion: Promise.resolve(target.state()),
+            });
+        }
+        else if (event.kind === 'run.control.acknowledged') {
+            acknowledgements.set(event.operationId, {
+                operationId: event.operationId,
+                outcome: event.outcome,
+                ...(event.detail === undefined ? {} : { detail: event.detail }),
+            });
+        }
+    }
+    for (const [operationId, acknowledgement] of acknowledgements) {
+        const record = target.ledger.getControl(operationId);
+        if (record) {
+            target.ledger.setControl(operationId, {
+                ...record,
+                acknowledgement: Promise.resolve(acknowledgement),
+            });
+        }
+    }
+}
+export function reconcileRestartRun(context) {
+    const runId = context.currentState().activeRunId;
+    if (!runId)
+        return Promise.resolve();
+    const run = context.currentState().runs.find((candidate) => candidate.id === runId);
+    if (!run || isProvenTerminalStatus(run.status))
+        return Promise.resolve();
+    if (!context.execution.status) {
+        const unknown = context.commitAndWait({
+            kind: 'run.finished',
+            runId,
+            status: 'unknown',
+            finalText: '',
+            usage: usageSnapshotForRun(run),
+            error: 'The execution path cannot reconcile provider state after restart',
+        });
+        return Promise.resolve(unknown);
+    }
+    return reconcileRestartSnapshot(context, runId);
+}
+async function reconcileRestartSnapshot(context, runId) {
+    const status = context.execution.status;
+    if (!status)
+        return;
+    let snapshot;
+    try {
+        const run = context.findRun(runId);
+        snapshot = await status({
+            runId,
+            ...(run.providerSessionId === undefined ? {} : { providerSessionId: run.providerSessionId }),
+            ...(run.controlRef === undefined ? {} : { controlRef: run.controlRef }),
+        });
+    }
+    catch {
+        await commitRequired(context, {
+            kind: 'run.reconnecting',
+            runId,
+            ...(context.findRun(runId).lastCursor === undefined
+                ? {}
+                : { after: context.findRun(runId).lastCursor }),
+        });
+        await commitRequired(context, {
+            kind: 'run.unknown',
+            runId,
+            detail: 'Provider reconciliation failed after restart',
+        });
+        return;
+    }
+    const current = context.findRun(runId);
+    if (!snapshot ||
+        snapshot.runId !== runId ||
+        (current.providerSessionId !== undefined && snapshot.sessionId !== current.providerSessionId)) {
+        await commitRequired(context, {
+            kind: 'run.reconnecting',
+            runId,
+            ...(current.lastCursor === undefined ? {} : { after: current.lastCursor }),
+        });
+        await commitRequired(context, {
+            kind: 'run.unknown',
+            runId,
+            detail: 'Provider reconciliation returned no matching run identity',
+        });
+        return;
+    }
+    await commitRequired(context, {
+        kind: 'run.reconnecting',
+        runId,
+        ...(current.lastCursor === undefined ? {} : { after: current.lastCursor }),
+    });
+    await reconcileSnapshot(context, runId, snapshot);
+}
+async function reconcileSnapshot(context, runId, snapshot) {
+    const current = context.currentState().runs.find((candidate) => candidate.id === runId);
+    if (!current)
+        return;
+    const evidence = canonicalDigest({
+        runId,
+        sessionId: snapshot.sessionId ?? null,
+        cursor: snapshot.cursor ?? null,
+        status: snapshot.status,
+        detail: snapshot.detail ?? null,
+    });
+    await commitRequired(context, {
+        kind: 'run.reconciled',
+        runId,
+        status: snapshot.status,
+        from: current.status,
+        to: snapshot.status,
+        evidence,
+        ...(snapshot.detail === undefined ? {} : { detail: snapshot.detail }),
+    });
+    if (isTerminalStatus(snapshot.status)) {
+        await commitRequired(context, {
+            kind: 'run.finished',
+            runId,
+            status: snapshot.status,
+            finalText: snapshot.finalText ?? '',
+            usage: snapshot.usage ?? usageSnapshotForRun(current),
+            ...(snapshot.error === undefined
+                ? {}
+                : { error: safeProviderDiagnostic(snapshot.error, 'RUNTIME_RECONCILIATION_ERROR') }),
+            ...(snapshot.detail === undefined
+                ? {}
+                : { reason: safeProviderDiagnostic(snapshot.detail, 'RUNTIME_RECONCILIATION_STATUS') }),
+        });
+    }
+}
+async function commitRequired(context, event) {
+    const result = context.commitAndWait(event);
+    if (result !== undefined)
+        await result;
+}
+export function admitPersistedSend(input) {
+    const state = input.state();
+    const persisted = input.effects.current(input.operationId);
+    if (persisted && persisted.requestDigest !== input.digest) {
+        input.effects.start({
+            operationId: input.operationId,
+            effectKind: 'run.execute',
+            request: { digest: input.digest },
+        }, { dispatch: async () => ({ status: 'failed', detail: 'OPERATION_CONFLICT' }) });
+        throw new AppError('OPERATION_CONFLICT', `Operation ${input.operationId} was already used with different input`);
+    }
+    if (persisted && (persisted.status === 'pending' || persisted.status === 'conflict')) {
+        throw new AppError('OPERATION_REQUIRES_RECONCILIATION', `Operation ${input.operationId} needs provider reconciliation before it can be retried`);
+    }
+    const previous = input.operations.getOperation(input.operationId);
+    if (previous) {
+        if (previous.digest !== input.digest)
+            throw new AppError('OPERATION_CONFLICT', `Operation ${input.operationId} was already used with different input`);
+        return {
+            operationId: input.operationId,
+            runId: previous.runId,
+            revision: state.revision,
+            replayed: true,
+            admission: previous.admission,
+            completion: previous.completion.then(() => input.state()),
+        };
+    }
+    const persistedRun = state.runs.find((run) => run.operationId === input.operationId);
+    if (persisted && persistedRun) {
+        return {
+            operationId: input.operationId,
+            runId: persistedRun.id,
+            revision: state.revision,
+            replayed: true,
+            admission: persistedRun.receipt,
+            completion: Promise.resolve(input.state()),
+        };
+    }
+    if (persisted)
+        throw new AppError('OPERATION_REQUIRES_RECONCILIATION', `Operation ${input.operationId} needs provider reconciliation before it can be retried`);
+    return undefined;
+}
+export function commitApplicationEvent(input) {
+    const key = providerEventKey(input.event);
+    if (key && input.providerEventKeys.hasProviderEvent(key))
+        return input.state;
+    const redacted = redactBraidEvent(input.event);
+    const envelope = input.journal.envelope
+        ? input.journal.envelope(input.state, redacted)
+        : {
+            sequence: input.state.sequence + 1,
+            revision: input.state.revision + 1,
+            occurredAt: input.clock.now(),
+            event: redacted,
+        };
+    const result = input.journal.append(envelope);
+    if (result !== undefined && typeof result.then === 'function') {
+        throw new AppError('ASYNC_COMMIT_REQUIRED', 'This journal requires an awaited durable transition');
+    }
+    const appendResult = result;
+    if (appendResult?.appended === false)
+        return input.state;
+    const nextState = reduceEvent(input.state, envelope);
+    if (key)
+        input.providerEventKeys.addProviderEvent(key);
+    for (const subscriber of input.subscribers) {
+        try {
+            subscriber(structuredClone(nextState), structuredClone(envelope));
+        }
+        catch {
+            // A renderer cannot change the durable transition.
+        }
+    }
+    return nextState;
+}
+export async function commitApplicationEventAsync(input) {
+    const key = providerEventKey(input.event);
+    if (key && input.providerEventKeys.hasProviderEvent(key))
+        return input.state;
+    const redacted = redactBraidEvent(input.event);
+    const envelope = input.journal.envelope
+        ? input.journal.envelope(input.state, redacted)
+        : {
+            sequence: input.state.sequence + 1,
+            revision: input.state.revision + 1,
+            occurredAt: input.clock.now(),
+            event: redacted,
+        };
+    const nextState = reduceEvent(input.state, envelope);
+    const result = input.journal.appendWithState
+        ? await input.journal.appendWithState(envelope, nextState)
+        : await input.journal.append(envelope);
+    if (result?.appended === false)
+        return input.state;
+    if (key)
+        input.providerEventKeys.addProviderEvent(key);
+    for (const subscriber of input.subscribers) {
+        try {
+            subscriber(structuredClone(nextState), structuredClone(envelope));
+        }
+        catch {
+            // A renderer cannot change the durable transition.
+        }
+    }
+    return nextState;
+}
+export function isEffectStorage(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const candidate = value;
+    return (typeof candidate.reserveEffect === 'function' &&
+        typeof candidate.current === 'function' &&
+        typeof candidate.latest === 'function' &&
+        typeof candidate.appendEffect === 'function' &&
+        typeof candidate.history === 'function');
+}
+function isTerminalStatus(status) {
+    return (status === 'completed' ||
+        status === 'failed' ||
+        status === 'aborted' ||
+        status === 'cancelled' ||
+        status === 'blocked' ||
+        status === 'expired' ||
+        status === 'unknown');
+}
+function isProvenTerminalStatus(status) {
+    return isTerminalStatus(status) && status !== 'unknown';
+}
+//# sourceMappingURL=application-support.js.map

package/dist/app/application-support.js.map

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

package/dist/app/application-transition.d.ts

@@ -0,0 +1,40 @@
+import type { BraidEvent } from '../domain/events.js';
+import type { BraidState } from '../domain/state.js';
+import type { Clock } from '../ports/clock.js';
+import { type ApplicationJournal } from './application-support.js';
+import type { AppSubscriber } from './application-types.js';
+import type { RunLedger } from './run-ledger.js';
+export interface TransitionHost {
+    readonly state: () => BraidState;
+    readonly setState: (state: BraidState) => void;
+    readonly journal: ApplicationJournal;
+    readonly clock: Clock;
+    readonly providerEventKeys: RunLedger;
+    readonly subscribers: ReadonlySet<AppSubscriber>;
+    readonly asynchronous: boolean;
+    readonly transitionTail: () => Promise<void>;
+    readonly setTransitionTail: (tail: Promise<void>) => void;
+    readonly storageFailure: () => unknown;
+    readonly markStorageFailure: (error: unknown) => void;
+}
+export declare function createTransitionHost(input: Omit<TransitionHost, 'state' | 'setState' | 'transitionTail' | 'setTransitionTail' | 'storageFailure' | 'markStorageFailure'> & {
+    readonly state: () => BraidState;
+    readonly setState: (state: BraidState) => void;
+    readonly transitionTail: () => Promise<void>;
+    readonly setTransitionTail: (tail: Promise<void>) => void;
+    readonly storageFailure: () => unknown;
+    readonly markStorageFailure: (error: unknown) => void;
+}): TransitionHost;
+export declare function commitEvent(host: TransitionHost, event: BraidEvent): void;
+/**
+ * Commits the one event needed to describe an uncertain external outcome.
+ *
+ * A failed journal write remains a fail-closed application state, but the
+ * terminal event gets one explicit retry so the journal can record whether
+ * the provider outcome is unknown.
+ */
+export declare function commitEventRecovery(host: TransitionHost, event: BraidEvent): void;
+export declare function commitEventAndWait(host: TransitionHost, event: BraidEvent): Promise<void>;
+export declare function commitEventAndWaitRecovery(host: TransitionHost, event: BraidEvent): Promise<void>;
+export declare function commitEventsAndWaitAtRevision(host: TransitionHost, events: readonly BraidEvent[], expectedRevision?: number): Promise<void>;
+//# sourceMappingURL=application-transition.d.ts.map

package/dist/app/application-transition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-transition.d.ts","sourceRoot":"","sources":["../../src/app/application-transition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EACL,KAAK,kBAAkB,EAGxB,MAAM,0BAA0B,CAAA;AACjC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAE3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,UAAU,CAAA;IAChC,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAA;IAC9C,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAA;IACpC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,iBAAiB,EAAE,SAAS,CAAA;IACrC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,aAAa,CAAC,CAAA;IAChD,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5C,QAAQ,CAAC,iBAAiB,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAA;IACzD,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,CAAA;IACtC,QAAQ,CAAC,kBAAkB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CACtD;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,IAAI,CACT,cAAc,EACZ,OAAO,GACP,UAAU,GACV,gBAAgB,GAChB,mBAAmB,GACnB,gBAAgB,GAChB,oBAAoB,CACvB,GAAG;IACF,QAAQ,CAAC,KAAK,EAAE,MAAM,UAAU,CAAA;IAChC,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAA;IAC9C,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5C,QAAQ,CAAC,iBAAiB,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAA;IACzD,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,CAAA;IACtC,QAAQ,CAAC,kBAAkB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CACtD,GACA,cAAc,CAEhB;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAEzE;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAEjF;AA6BD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzF;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjG;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,SAAS,UAAU,EAAE,EAC7B,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,IAAI,CAAC,CA+Bf"}

package/dist/app/application-transition.js

@@ -0,0 +1,125 @@
+import { commitApplicationEvent, commitApplicationEventAsync, } from './application-support.js';
+import { AppError } from './errors.js';
+export function createTransitionHost(input) {
+    return input;
+}
+export function commitEvent(host, event) {
+    commitEventInternal(host, event, false);
+}
+/**
+ * Commits the one event needed to describe an uncertain external outcome.
+ *
+ * A failed journal write remains a fail-closed application state, but the
+ * terminal event gets one explicit retry so the journal can record whether
+ * the provider outcome is unknown.
+ */
+export function commitEventRecovery(host, event) {
+    commitEventInternal(host, event, true);
+}
+function commitEventInternal(host, event, recovery) {
+    if (!recovery && host.storageFailure() !== undefined)
+        throw new AppError('STORAGE_FAILURE', 'Durable storage is unavailable; reopen Braid to continue');
+    if (host.asynchronous) {
+        void commitEventAndWaitInternal(host, event, recovery).catch(() => undefined);
+        return;
+    }
+    try {
+        host.setState(commitApplicationEvent({
+            state: host.state(),
+            event,
+            journal: host.journal,
+            clock: host.clock,
+            providerEventKeys: host.providerEventKeys,
+            subscribers: host.subscribers,
+        }));
+    }
+    catch (error) {
+        host.markStorageFailure(error);
+        throw error;
+    }
+}
+export function commitEventAndWait(host, event) {
+    return commitEventAndWaitInternal(host, event, false);
+}
+export function commitEventAndWaitRecovery(host, event) {
+    return commitEventAndWaitInternal(host, event, true);
+}
+export function commitEventsAndWaitAtRevision(host, events, expectedRevision) {
+    if (events.length === 0)
+        return Promise.resolve();
+    assertExpectedRevision(host.state(), expectedRevision);
+    if (!host.asynchronous) {
+        for (const event of events)
+            commitEvent(host, event);
+        return Promise.resolve();
+    }
+    const predecessor = host.transitionTail();
+    const task = predecessor.then(async () => {
+        const failure = host.storageFailure();
+        if (failure !== undefined)
+            throw failure;
+        assertExpectedRevision(host.state(), expectedRevision);
+        for (const event of events) {
+            host.setState(await commitApplicationEventAsync({
+                state: host.state(),
+                event,
+                journal: host.journal,
+                clock: host.clock,
+                providerEventKeys: host.providerEventKeys,
+                subscribers: host.subscribers,
+            }));
+        }
+    });
+    const next = task.catch((error) => {
+        if (!isRevisionError(error))
+            host.markStorageFailure(error);
+    });
+    host.setTransitionTail(next);
+    return task;
+}
+function assertExpectedRevision(state, expectedRevision) {
+    if (expectedRevision === undefined)
+        return;
+    if (!Number.isInteger(expectedRevision) || expectedRevision < 0) {
+        throw new AppError('INVALID_EXPECTED_REVISION', 'expectedRevision must be a non-negative integer');
+    }
+    if (state.revision !== expectedRevision) {
+        throw new AppError('STALE_REVISION', `The application changed at revision ${state.revision}; expected ${expectedRevision}`);
+    }
+}
+function isRevisionError(error) {
+    return (error instanceof AppError &&
+        (error.code === 'STALE_REVISION' || error.code === 'INVALID_EXPECTED_REVISION'));
+}
+function commitEventAndWaitInternal(host, event, recovery) {
+    if (!host.asynchronous) {
+        if (recovery)
+            commitEventRecovery(host, event);
+        else
+            commitEvent(host, event);
+        return Promise.resolve();
+    }
+    const predecessor = recovery
+        ? host.transitionTail().catch(() => undefined)
+        : host.transitionTail();
+    const task = predecessor.then(async () => {
+        const failure = host.storageFailure();
+        if (!recovery && failure !== undefined)
+            throw failure;
+        host.setState(await commitApplicationEventAsync({
+            state: host.state(),
+            event,
+            journal: host.journal,
+            clock: host.clock,
+            providerEventKeys: host.providerEventKeys,
+            subscribers: host.subscribers,
+        }));
+    });
+    const next = task.catch((error) => {
+        host.markStorageFailure(error);
+        throw error;
+    });
+    host.setTransitionTail(next);
+    return task;
+}
+//# sourceMappingURL=application-transition.js.map

package/dist/app/application-transition.js.map

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