ramosedb 0.0.0-stage → 0.4.0

package/dist/client/mutation.js

@@ -0,0 +1,75 @@
+import { clientRef, invocationId } from "../db/refs.js";
+import { projectionIdentity } from "../internal/replication/projection-binding.js";
+import { resolveDatabaseReceiver } from "./query.js";
+import { encodedInputRefs } from "./operations.js";
+import { ReceiptDriver } from "./receipt.js";
+const queuedTarget = (target) => {
+    if (target === undefined)
+        return { type: "none" };
+    return target.startsWith("cr1_")
+        ? { type: "client-ref", clientRef: target }
+        : { type: "entity", entityId: target };
+};
+const allocationsFor = (operation) => operation.allocations.map((slot) => ({
+    slot: slot.slot,
+    clientRef: clientRef(),
+}));
+const enqueue = async (context, database, operation, target, input, driver) => {
+    const receiver = await resolveDatabaseReceiver(database);
+    const [catalog, storage] = await Promise.all([
+        context.catalog(),
+        context.storage(),
+    ]);
+    const [encoded, version] = [
+        operation.encode(input),
+        await operation.version(),
+    ];
+    const allocations = allocationsFor(operation);
+    const draft = {
+        invocation: driver.receipt.invocation,
+        receiver,
+        operation: {
+            catalog: catalog.key,
+            owner: operation.owner,
+            localName: operation.localName,
+        },
+        operationVersion: version,
+        target: queuedTarget(target),
+        input: encoded,
+        allocations,
+        inputRefs: encodedInputRefs(operation, encoded),
+        enqueuedAt: Date.now(),
+    };
+    context.track(receiver, driver);
+    try {
+        await storage.outbox().enqueue(draft, {
+            scope: { server: receiver.server, principal: receiver.principal },
+            ...(operation.optimistic === undefined ? {} : {
+                projection: projectionIdentity(catalog.projections.build, operation.optimistic.revision),
+            }),
+        });
+    }
+    catch (cause) {
+        context.untrack(driver);
+        throw cause;
+    }
+    driver.queue();
+    context.applied(receiver);
+    context.submit(receiver);
+};
+export const mutationNamespace = (context, database, operations, target) => {
+    const methods = {};
+    for (const [name, operation] of operations) {
+        methods[name] = (input) => {
+            context.assertLive(`mutate.${name}`);
+            const driver = new ReceiptDriver(invocationId());
+            void enqueue(context, database, operation, target, input === undefined ? {} : input, driver)
+                .catch((cause) => {
+                driver.fail(cause instanceof Error ? cause : new Error(String(cause)));
+            });
+            return driver.receipt;
+        };
+    }
+    return Object.freeze(methods);
+};
+//# sourceMappingURL=mutation.js.map

package/dist/client/mutation.js.map

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

package/dist/client/operations.d.ts

@@ -0,0 +1,39 @@
+import type { AllocationPathSegment, AllocationSlots } from "../db/allocations.ts";
+import type { MutationRef } from "../db/refs.ts";
+import type { AnySchema, AnySchemaDefinition } from "../db/Schema.ts";
+import { type AnyOptimisticProjection } from "../db/Projection.ts";
+import type { OperationInputShape, OperationWireShape } from "../internal/authorization/catalog.ts";
+import { CatalogId, type OperationVersion, type OwnerRef } from "../internal/authorization/identities.ts";
+import type { CompositionIndex } from "../internal/core/composition.ts";
+import type { InstalledProjection } from "../internal/replication/projection-binding.ts";
+export type ClientOperation = {
+    readonly owner: OwnerRef;
+    readonly localName: string;
+    readonly self: boolean;
+    readonly version: () => Promise<OperationVersion>;
+    readonly allocations: AllocationSlots;
+    readonly composers: readonly string[];
+    readonly input: OperationInputShape;
+    readonly inputWire: OperationWireShape;
+    readonly encode: (input: unknown) => unknown;
+    readonly optimistic: {
+        readonly revision: number;
+        readonly run: AnyOptimisticProjection;
+    } | undefined;
+};
+export type ClientOperations = {
+    readonly catalog: CatalogId;
+    readonly database: ReadonlyMap<string, ClientOperation>;
+    readonly self: ReadonlyMap<string, ReadonlyMap<string, ClientOperation>>;
+    readonly installed: readonly InstalledProjection[];
+};
+export declare const encodedInputRefs: (operation: ClientOperation, encoded: unknown) => readonly {
+    readonly path: readonly AllocationPathSegment[];
+    readonly ref: MutationRef;
+}[];
+export declare const installClientOperations: (definition: AnySchemaDefinition, schema: AnySchema) => ClientOperations;
+export declare const selfOperationsFor: (operations: ClientOperations, composition: CompositionIndex, focus: {
+    readonly kind: "entity" | "trait";
+    readonly name: string;
+}) => ReadonlyMap<string, ClientOperation>;
+//# sourceMappingURL=operations.d.ts.map

package/dist/client/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../src/client/operations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,qBAAqB,EACrB,eAAe,EAChB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAMjD,OAAO,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,qBAAqB,CAAC;AAK7B,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,sCAAsC,CAAC;AAK9C,OAAO,EACL,SAAS,EAET,KAAK,gBAAgB,EACrB,KAAK,QAAQ,EACd,MAAM,yCAAyC,CAAC;AAEjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+CAA+C,CAAC;AAIzF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAClD,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAC7C,QAAQ,CAAC,UAAU,EACf;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,uBAAuB,CAAA;KAAE,GACpE,SAAS,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACxD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;IACzE,QAAQ,CAAC,SAAS,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACpD,CAAC;AAiJF,eAAO,MAAM,gBAAgB,cAChB,eAAe,WACjB,OAAO,KACf,SAAS;IACV,QAAQ,CAAC,IAAI,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAChD,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;CAC3B,EAMG,CAAC;AAiCL,eAAO,MAAM,uBAAuB,eACtB,mBAAmB,UACvB,SAAS,KAChB,gBA2CF,CAAC;AAEF,eAAO,MAAM,iBAAiB,eAChB,gBAAgB,eACf,gBAAgB,SACtB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,KAClE,WAAW,CAAC,MAAM,EAAE,eAAe,CAwBrC,CAAC"}

package/dist/client/operations.js

@@ -0,0 +1,183 @@
+import * as Effect from "effect/Effect";
+import * as Result from "effect/Result";
+import { reachableTraits } from "../db/compose.js";
+import { isOwnedOperation, OwnedOperations, } from "../db/Operation.js";
+import { normalizeProjectionRevision, } from "../db/Projection.js";
+import { snapshotOwnedOperations, } from "../internal/authorization/authoring/operations.js";
+import { inputEntityRefHandles, wireEntityRefPaths, } from "../internal/authorization/entity-targets.js";
+import { CatalogId, DigestHex, } from "../internal/authorization/identities.js";
+import { hashOperationVersion } from "../internal/authorization/operation-version.js";
+const NO_ARTIFACT = DigestHex.make("0".repeat(64));
+const ownerKey = (owner) => `${owner.kind}\u0000${owner.name}`;
+const invalid = (detail) => {
+    throw new Error(`ramose/client: ${detail}`);
+};
+const authoredOperations = (schema) => {
+    const entities = Object.values(schema.entities);
+    const owners = [
+        ...entities.map((entity) => ({ kind: "entity", owner: entity })),
+        ...[...reachableTraits(entities).values()]
+            .map((trait) => ({ kind: "trait", owner: trait })),
+    ];
+    const authored = new Map();
+    for (const { kind, owner } of owners) {
+        const declared = owner[OwnedOperations] ?? {};
+        for (const [localName, candidate] of Object.entries(declared)) {
+            if (!isOwnedOperation(candidate))
+                continue;
+            const name = owner.ns;
+            authored.set(`${kind} ${name} ${localName}`, candidate);
+        }
+    }
+    return authored;
+};
+const MASK_ROUND_STRIDE = 1_000_000;
+const maskedRef = (round, index) => Number.MIN_SAFE_INTEGER + round * MASK_ROUND_STRIDE + index;
+const readPath = (value, path) => path.reduce((cursor, segment) => cursor === null || typeof cursor !== "object"
+    ? undefined
+    : cursor[segment], value);
+const writePath = (value, path, replacement) => {
+    const [segment, ...rest] = path;
+    if (segment === undefined)
+        return replacement;
+    const child = writePath(readPath(value, [segment]), rest, replacement);
+    if (typeof segment === "number") {
+        return value.map((item, index) => index === segment ? child : item);
+    }
+    return { ...value, [segment]: child };
+};
+const maskedRefWirePaths = (snapshot, encoded, round, issued) => {
+    const positions = new Map();
+    const repeated = new Set();
+    const holds = (candidate) => typeof candidate === "number" && Number.isSafeInteger(candidate) &&
+        candidate >= maskedRef(round, 0) && candidate < maskedRef(round, issued);
+    for (const path of wireEntityRefPaths(snapshot.inputWireShape, encoded, holds)) {
+        const mask = readPath(encoded, path);
+        if (positions.has(mask))
+            repeated.add(mask);
+        positions.set(mask, path);
+    }
+    for (const mask of repeated)
+        positions.delete(mask);
+    return positions;
+};
+const encodeMasked = (snapshot, input, handles, round) => {
+    const encoded = snapshot.inputCodec.encode(handles.reduce((value, path, index) => writePath(value, path, maskedRef(round, index)), input));
+    const positions = maskedRefWirePaths(snapshot, encoded, round, handles.length);
+    return {
+        encoded,
+        at: (index) => positions.get(maskedRef(round, index)) ??
+            (readPath(encoded, handles[index]) === maskedRef(round, index)
+                ? handles[index]
+                : undefined),
+    };
+};
+const samePosition = (left, right) => left.length === right.length &&
+    left.every((segment, index) => segment === right[index]);
+const encodeInput = (snapshot, input) => {
+    const handles = inputEntityRefHandles(snapshot.inputShape, input);
+    if (handles.length === 0)
+        return snapshot.inputCodec.encode(input);
+    const first = encodeMasked(snapshot, input, handles, 0);
+    const second = encodeMasked(snapshot, input, handles, 1);
+    return handles.reduce((value, path, index) => {
+        const at = first.at(index);
+        const again = second.at(index);
+        if (at === undefined || again === undefined || !samePosition(at, again)) {
+            return invalid(`${snapshot.owner.name}.${snapshot.localName} moved the entity ` +
+                `reference at '${path.join(".")}' while encoding`);
+        }
+        return writePath(value, at, readPath(input, path));
+    }, first.encoded);
+};
+export const encodedInputRefs = (operation, encoded) => inputEntityRefHandles(operation.inputWire, encoded).flatMap((path) => {
+    const ref = readPath(encoded, path);
+    return typeof ref === "string"
+        ? [{ path, ref: ref }]
+        : [];
+});
+const clientOperation = (snapshot, authored) => {
+    const declaration = authored.get(`${snapshot.owner.kind} ${snapshot.owner.name} ${snapshot.localName}`);
+    const projection = declaration?.optimistic;
+    let version;
+    return {
+        owner: snapshot.owner,
+        localName: snapshot.localName,
+        self: snapshot.self,
+        version: () => {
+            version ??= Effect.runPromise(hashOperationVersion(snapshot.versionDescriptor));
+            return version;
+        },
+        allocations: snapshot.versionDescriptor.allocations,
+        composers: snapshot.composers.map((entity) => entity.name),
+        input: snapshot.inputShape,
+        inputWire: snapshot.inputWireShape,
+        encode: (input) => encodeInput(snapshot, input),
+        optimistic: projection === undefined ? undefined : {
+            revision: normalizeProjectionRevision(declaration?.optimisticRevision),
+            run: projection,
+        },
+    };
+};
+export const installClientOperations = (definition, schema) => {
+    const catalog = CatalogId.make(definition.key);
+    const lowered = snapshotOwnedOperations(catalog, [schema], NO_ARTIFACT);
+    if (Result.isFailure(lowered)) {
+        invalid(`catalog operations could not be lowered: ${lowered.failure.message}`);
+    }
+    const authored = authoredOperations(schema);
+    const operations = lowered.success
+        .map((snapshot) => clientOperation(snapshot, authored));
+    const database = new Map();
+    const self = new Map();
+    const installed = [];
+    for (const operation of operations) {
+        installed.push({
+            operation: {
+                catalog,
+                owner: operation.owner,
+                localName: operation.localName,
+            },
+            projection: operation.optimistic,
+        });
+        if (!operation.self) {
+            if (database.has(operation.localName)) {
+                invalid(`two catalog operations answer to db.mutate.${operation.localName}`);
+            }
+            database.set(operation.localName, operation);
+            continue;
+        }
+        const key = ownerKey(operation.owner);
+        const owned = self.get(key) ?? new Map();
+        owned.set(operation.localName, operation);
+        self.set(key, owned);
+    }
+    return Object.freeze({
+        catalog,
+        database,
+        self,
+        installed: Object.freeze(installed),
+    });
+};
+export const selfOperationsFor = (operations, composition, focus) => {
+    const typeName = focus.name;
+    const owners = [{ kind: focus.kind, name: typeName }];
+    for (const trait of focus.kind === "entity"
+        ? composition.transitiveTraits(`:${typeName}`)
+        : []) {
+        owners.push({ kind: "trait", name: trait.startsWith(":") ? trait.slice(1) : trait });
+    }
+    const methods = new Map();
+    for (const owner of owners) {
+        for (const [name, operation] of operations.self.get(ownerKey(owner)) ?? []) {
+            const existing = methods.get(name);
+            if (existing !== undefined) {
+                invalid(`${typeName}.mutate.${name} is declared by both ${existing.owner.kind} ` +
+                    `'${existing.owner.name}' and ${owner.kind} '${owner.name}'`);
+            }
+            methods.set(name, operation);
+        }
+    }
+    return methods;
+};
+//# sourceMappingURL=operations.js.map

package/dist/client/operations.js.map

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

package/dist/client/query.d.ts

@@ -0,0 +1,53 @@
+import { type AnyComposer } from "../db/Composer.ts";
+import type { AnyEntity } from "../db/Entity.ts";
+import type { Eid } from "../db/Eid.ts";
+import type { MutationRef } from "../db/refs.ts";
+import type { EntityRow, FluentQuery, WhereEq } from "../db/query/fluent.ts";
+import type { FocusAttr } from "../db/query/focus.ts";
+import type { IdRow } from "../db/query/lib.ts";
+import { type Cursor, type Page, type Pipeline, type QueryObject, type QueryOrderKey } from "../db/query/index.ts";
+import type { OrderDir, OrderEmpty } from "../db/shapes.ts";
+import { type ReplicaDatabaseScope } from "../internal/replication/replica-lifecycle.ts";
+import type { EntityHandle } from "./entity.ts";
+import { DatabaseReceiverError } from "./errors.ts";
+import type { EntityMutations } from "./mutation-schema.ts";
+import type { ClientDatabase } from "./database.ts";
+import type { SyncStatus } from "./sync.ts";
+declare const EntityFocusBrand: unique symbol;
+export type EntityFocused<N extends AnyComposer, Row, Out> = QueryObject<Row, Out> & {
+    readonly [EntityFocusBrand]: N;
+};
+export type EntityResult<N extends AnyComposer, Row, Out> = EntityResultOf<EntityHandle<ClientValue<Row>, EntityMutations<N>, [
+    N
+] extends [AnyEntity] ? N : AnyEntity>, Out>;
+/** The live handle, fields, and owned mutations inferred from a schema definition. */
+export type EntityHandleFor<N extends AnyComposer> = EntityResult<N, EntityRow<N>, EntityRow<N>>;
+type EntityResultOf<Handle, Out> = [Out] extends [readonly unknown[]] ? readonly Handle[] : [Out] extends [{
+    readonly rows: readonly unknown[];
+}] ? Omit<Out, "rows"> & {
+    readonly rows: readonly Handle[];
+} : null extends Out ? Handle | null : Handle;
+export interface ClientQuery<N extends AnyComposer, Row = EntityRow<N>, Out = readonly Row[]> extends FluentQuery<N, Row, Out> {
+    readonly [EntityFocusBrand]: N;
+    where<const W extends WhereEq<N>>(eq: W): ClientQuery<N, Row, Out>;
+    where(...stages: ReadonlyArray<(q: Pipeline<Row, N>) => Pipeline<Row, N>>): ClientQuery<N, Row, Out>;
+    orderBy(key: QueryOrderKey<Row> | FocusAttr<N>, dir?: OrderDir, opts?: {
+        readonly empty?: OrderEmpty;
+    }): ClientQuery<N, Row, Out>;
+    limit(n: number): ClientQuery<N, Row, Out>;
+    offset(n: number): ClientQuery<N, Row, Out>;
+    after(cursor: Cursor | null): EntityFocused<N, Row, Page<Row>>;
+    ids(): ClientQuery<N, IdRow<N>>;
+    one(): EntityFocused<N, Row, Row | null>;
+    oneOrFail(): EntityFocused<N, Row, Row>;
+}
+export type ClientValue<A> = A extends Eid<infer E extends AnyEntity> ? MutationRef<E> : A extends Date | Uint8Array ? A : A extends readonly (infer Item)[] ? readonly ClientValue<Item>[] : A extends object ? {
+    readonly [K in keyof A]: K extends ":db/id" ? MutationRef | Extract<A[K], undefined> : ClientValue<A[K]>;
+} : A;
+export declare const ENTITY_FOCUS: symbol;
+export declare const entityFocusOf: (query: unknown) => AnyComposer | undefined;
+export declare const clientQueryFrom: <N extends AnyComposer>(entity: N) => ClientQuery<N>;
+export declare const fencedReceiver: (status: SyncStatus) => DatabaseReceiverError | undefined;
+export declare const resolveDatabaseReceiver: (database: ClientDatabase) => Promise<ReplicaDatabaseScope>;
+export {};
+//# sourceMappingURL=query.d.ts.map

package/dist/client/query.d.ts.map

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

package/dist/client/query.js

@@ -0,0 +1,85 @@
+import {} from "../db/Composer.js";
+import { from as queryFrom, } from "../db/query/index.js";
+import { replicaDatabaseScopeOf } from "../internal/replication/replica-lifecycle.js";
+import { DatabaseReceiverError } from "./errors.js";
+const CHAIN = ["where", "orderBy", "limit", "offset", "ids", "after"];
+export const ENTITY_FOCUS = Symbol.for("ramose/client/entity-focus");
+export const entityFocusOf = (query) => {
+    if (query === null || typeof query !== "object")
+        return undefined;
+    const focus = query[ENTITY_FOCUS];
+    return focus === undefined ? undefined : focus;
+};
+const decorate = (fluent, ns) => {
+    const wrapped = { ...fluent };
+    wrapped[ENTITY_FOCUS] = ns;
+    for (const key of CHAIN) {
+        const method = fluent[key];
+        if (typeof method !== "function")
+            continue;
+        wrapped[key] = (...args) => decorate(method.apply(fluent, args), ns);
+    }
+    for (const key of ["one", "oneOrFail"]) {
+        wrapped[key] = () => Object.assign({ [ENTITY_FOCUS]: ns }, fluent[key].call(fluent));
+    }
+    return wrapped;
+};
+export const clientQueryFrom = (entity) => {
+    const base = queryFrom(entity);
+    return decorate(base, entity);
+};
+const settleOn = (source, attempt) => new Promise((resolve, reject) => {
+    let stop;
+    let done = false;
+    const settle = () => {
+        if (done)
+            return;
+        done = attempt(resolve, reject);
+        if (done)
+            stop?.();
+    };
+    settle();
+    if (done)
+        return;
+    stop = source.subscribe(settle);
+    if (done)
+        stop();
+});
+export const fencedReceiver = (status) => {
+    switch (status) {
+        case "authentication-required":
+            return new DatabaseReceiverError({
+                reason: "unauthorized",
+                message: "this database's credential no longer opens it",
+            });
+        case "update-required":
+            return new DatabaseReceiverError({
+                reason: "update-required",
+                message: "this build cannot read or replay against this database",
+            });
+        case "closed":
+            return new DatabaseReceiverError({
+                reason: "closed",
+                message: "this database was closed before its receiver was known",
+            });
+        default:
+            return undefined;
+    }
+};
+export const resolveDatabaseReceiver = (database) => {
+    const handle = database;
+    void handle.activate();
+    return settleOn(handle.sync, (resolve, reject) => {
+        const fenced = fencedReceiver(handle.syncStatus());
+        if (fenced !== undefined) {
+            reject(fenced);
+            return true;
+        }
+        const identity = handle.confirmedIdentity();
+        if (identity === undefined)
+            return false;
+        resolve(replicaDatabaseScopeOf(identity));
+        return true;
+    });
+};
+//# sourceMappingURL=query.js.map

package/dist/client/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/client/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,MAAM,mBAAmB,CAAC;AAOrD,OAAO,EACL,IAAI,IAAI,SAAS,GAMlB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,sBAAsB,EAA6B,MAAM,8CAA8C,CAAC;AAEjH,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAmEpD,MAAM,KAAK,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAU,CAAC;AAE/E,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAW,CAAC;AAE/E,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAc,EAA2B,EAAE;IACvE,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAClE,MAAM,KAAK,GAAI,KAAiC,CAAC,YAAY,CAAC,CAAC;IAC/D,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,KAAqB,CAAC;AAClE,CAAC,CAAC;AAEF,MAAM,QAAQ,GAAG,CACf,MAAiB,EACjB,EAAe,EACJ,EAAE;IACb,MAAM,OAAO,GAAG,EAAE,GAAG,MAAM,EAAiD,CAAC;IAC7E,OAAO,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC;IAC3B,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,MAAM,MAAM,GAAI,MAA6C,CAAC,GAAG,CAAC,CAAC;QACnE,IAAI,OAAO,MAAM,KAAK,UAAU;YAAE,SAAS;QAC3C,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAe,EAAa,EAAE,CAC/C,QAAQ,CAAE,MAAyC,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IACjF,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,WAAW,CAAU,EAAE,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,GAAG,GAAY,EAAE,CAAC,MAAM,CAAC,MAAM,CACzC,EAAE,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,EACrB,MAAmD,CAAC,GAAG,CAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CACxE,CAAC;IACJ,CAAC;IACD,OAAO,OAA+B,CAAC;AACzC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAwB,MAAS,EAAkB,EAAE;IAClF,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAyB,CAAC;IACvD,OAAO,QAAQ,CAAC,IAAI,EAAE,MAAM,CAA8B,CAAC;AAC7D,CAAC,CAAC;AAEF,MAAM,QAAQ,GAAG,CACf,MAA6B,EAC7B,OAGY,EACA,EAAE,CACd,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;IACjC,IAAI,IAA8B,CAAC;IACnC,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,MAAM,MAAM,GAAG,GAAS,EAAE;QACxB,IAAI,IAAI;YAAE,OAAO;QACjB,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAChC,IAAI,IAAI;YAAE,IAAI,EAAE,EAAE,CAAC;IACrB,CAAC,CAAC;IACF,MAAM,EAAE,CAAC;IACT,IAAI,IAAI;QAAE,OAAO;IACjB,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,IAAI;QAAE,IAAI,EAAE,CAAC;AACnB,CAAC,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,MAAkB,EACiB,EAAE;IACrC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,yBAAyB;YAC5B,OAAO,IAAI,qBAAqB,CAAC;gBAC/B,MAAM,EAAE,cAAc;gBACtB,OAAO,EAAE,+CAA+C;aACzD,CAAC,CAAC;QACL,KAAK,iBAAiB;YACpB,OAAO,IAAI,qBAAqB,CAAC;gBAC/B,MAAM,EAAE,iBAAiB;gBACzB,OAAO,EAAE,wDAAwD;aAClE,CAAC,CAAC;QACL,KAAK,QAAQ;YACX,OAAO,IAAI,qBAAqB,CAAC;gBAC/B,MAAM,EAAE,QAAQ;gBAChB,OAAO,EAAE,wDAAwD;aAClE,CAAC,CAAC;QACL;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,QAAwB,EACO,EAAE;IACjC,MAAM,MAAM,GAAG,QAAgC,CAAC;IAChD,KAAK,MAAM,CAAC,QAAQ,EAAE,CAAC;IACvB,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC/C,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QACnD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,CAAC,MAAM,CAAC,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,CAAC,iBAAiB,EAAE,CAAC;QAC5C,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QACzC,OAAO,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/client/receipt.d.ts

@@ -0,0 +1,53 @@
+import type { InvocationId } from "../db/refs.ts";
+import { type Subscription } from "./subscription.ts";
+/**
+ * Why the authoritative server refused an invocation it had.
+ *
+ * The code is the server's own opaque classification; it is reported so an
+ * application can branch, never interpreted here.
+ */
+export declare class MutationRejectedError extends Error {
+    readonly _tag: "MutationRejectedError";
+    readonly code: string;
+    constructor(code: string);
+}
+/**
+ * One receipt's current state.
+ *
+ * A discriminated union, in the same style as the query snapshot, so a
+ * framework adapter renders it with a `switch` and no second state machine.
+ */
+export type ReceiptState = {
+    readonly status: "pending";
+} | {
+    readonly status: "queued";
+} | {
+    readonly status: "committed";
+} | {
+    readonly status: "rejected";
+    readonly error: MutationRejectedError;
+} | {
+    readonly status: "failed";
+    readonly error: Error;
+};
+/** What `db.mutate.…()` and `entity.mutate.…()` return. */
+export interface Receipt extends Subscription<ReceiptState> {
+    readonly invocation: InvocationId;
+    readonly queued: Promise<void>;
+    readonly committed: Promise<void>;
+}
+export declare class ReceiptDriver {
+    private readonly store;
+    private settleQueued;
+    private failQueued;
+    private settleCommitted;
+    private failCommitted;
+    readonly receipt: Receipt;
+    constructor(invocation: InvocationId);
+    private get settled();
+    queue(): void;
+    commit(): void;
+    reject(code: string): void;
+    fail(error: Error): void;
+}
+//# sourceMappingURL=receipt.d.ts.map

package/dist/client/receipt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipt.d.ts","sourceRoot":"","sources":["../../src/client/receipt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE7D;;;;;GAKG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,EAAG,uBAAuB,CAAU;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,YAAY,IAAI,EAAE,MAAM,EAIvB;CACF;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GAC9B;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAA;CAAE,GAC7B;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAAE,GAChC;IAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAA;CAAE,GACtE;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAEzD,2DAA2D;AAC3D,MAAM,WAAW,OAAQ,SAAQ,YAAY,CAAC,YAAY,CAAC;IACzD,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAMD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;IAC1D,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,eAAe,CAAc;IACrC,OAAO,CAAC,aAAa,CAA0B;IAC/C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,YAAY,UAAU,EAAE,YAAY,EAkBnC;IAED,OAAO,KAAK,OAAO,GAGlB;IAED,KAAK,IAAI,IAAI,CAIZ;IAED,MAAM,IAAI,IAAI,CAKb;IAED,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAMzB;IAED,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAKvB;CACF"}

package/dist/client/receipt.js

@@ -0,0 +1,79 @@
+import { Store } from "./subscription.js";
+/**
+ * Why the authoritative server refused an invocation it had.
+ *
+ * The code is the server's own opaque classification; it is reported so an
+ * application can branch, never interpreted here.
+ */
+export class MutationRejectedError extends Error {
+    _tag = "MutationRejectedError";
+    code;
+    constructor(code) {
+        super(`ramose/client: the server rejected this invocation (${code})`);
+        this.name = "MutationRejectedError";
+        this.code = code;
+    }
+}
+const PENDING = Object.freeze({ status: "pending" });
+const QUEUED = Object.freeze({ status: "queued" });
+const COMMITTED = Object.freeze({ status: "committed" });
+export class ReceiptDriver {
+    store = new Store(PENDING);
+    settleQueued;
+    failQueued;
+    settleCommitted;
+    failCommitted;
+    receipt;
+    constructor(invocation) {
+        const queued = new Promise((resolve, reject) => {
+            this.settleQueued = resolve;
+            this.failQueued = reject;
+        });
+        const committed = new Promise((resolve, reject) => {
+            this.settleCommitted = resolve;
+            this.failCommitted = reject;
+        });
+        queued.catch(() => undefined);
+        committed.catch(() => undefined);
+        this.receipt = Object.freeze({
+            invocation,
+            queued,
+            committed,
+            subscribe: this.store.subscription.subscribe,
+            getSnapshot: this.store.subscription.getSnapshot,
+        });
+    }
+    get settled() {
+        const status = this.store.getSnapshot().status;
+        return status === "committed" || status === "rejected" || status === "failed";
+    }
+    queue() {
+        if (this.settled || this.store.getSnapshot().status === "queued")
+            return;
+        this.store.publish(QUEUED);
+        this.settleQueued();
+    }
+    commit() {
+        if (this.settled)
+            return;
+        this.queue();
+        this.store.publish(COMMITTED);
+        this.settleCommitted();
+    }
+    reject(code) {
+        if (this.settled)
+            return;
+        const error = new MutationRejectedError(code);
+        this.queue();
+        this.store.publish(Object.freeze({ status: "rejected", error }));
+        this.failCommitted(error);
+    }
+    fail(error) {
+        if (this.settled || this.store.getSnapshot().status === "queued")
+            return;
+        this.store.publish(Object.freeze({ status: "failed", error }));
+        this.failQueued(error);
+        this.failCommitted(error);
+    }
+}
+//# sourceMappingURL=receipt.js.map

package/dist/client/receipt.js.map

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