@rayfold/client 0.1.0

package/client.d.ts

@@ -0,0 +1,152 @@
+/** RayfoldClient: batches with refs, cache-coherent commands, live-updating watches. */
+import type { Frame, RequestEnvelope, RequestOp, WireError } from "@rayfold/server/protocol";
+import type { RayfoldSchemaIR } from "@rayfold/schema";
+import { RayfoldCache, type OptimisticOp } from "./cache.js";
+import { type QueueEvent, type QueueStorage, type QueuedCommand } from "./offline.js";
+import type { Transport } from "./transport.js";
+export declare class RayfoldClientError extends Error {
+    readonly code: string;
+    readonly type: string | undefined;
+    readonly data: unknown;
+    readonly path: string | undefined;
+    readonly retryable: boolean;
+    constructor(w: WireError);
+    /** Narrow on a declared domain error: `if (e.is("OutOfStock")) e.data.available` */
+    is(type: string): boolean;
+}
+export interface OpOptions {
+    shape?: string;
+    vars?: Record<string, unknown>;
+    key?: string;
+    deadline?: number;
+    simulate?: boolean;
+    live?: boolean;
+    /** Conditional write: the entity version last seen; a stale value fails with VersionConflict carrying the current entity. */
+    ifVersion?: string | number;
+}
+export interface CommandOptions extends OpOptions {
+    /**
+     * The change the command is expected to make (sub-profile `sync`, spec 08 section 5), shown in the cache at once. The
+     * server's own patch replaces it when the command succeeds; it is rolled back when the command fails. A function
+     * gets the cache, to compute the prediction from current values.
+     */
+    optimistic?: OptimisticOp[] | ((cache: RayfoldCache) => OptimisticOp[]);
+}
+export interface QueryOptions extends OpOptions {
+    /** "network" (default) always fetches; "cache" serves a fresh cached result when present. */
+    policy?: "network" | "cache";
+}
+export interface ClientOptions {
+    transport: Transport;
+    cache?: RayfoldCache;
+    /** Sent as meta.client, e.g. "web/1.2.0". */
+    client?: string;
+    /** Batch deadline in ms. */
+    deadline?: number;
+    /** Idempotency key generator for commands without an explicit key. */
+    keyGen?: () => string;
+    now?: () => number;
+    /** Schema IR (from /rayfold/manifest). Enables compact frames: the server omits redundant `$type`/`meta`, the client restores types. */
+    schema?: RayfoldSchemaIR;
+    /**
+     * Queue commands made while the server cannot be reached (sub-profile `sync`) and send them later, in order and with
+     * their idempotency keys: on `drain()`, and when the browser comes back online. Their predictions stay shown meanwhile.
+     */
+    offline?: {
+        storage?: QueueStorage;
+        drainOnReconnect?: boolean;
+    };
+}
+/** A handle to an op inside a batch. `ref("id")` produces a `$ref` usable in later ops' args. */
+export declare class OpHandle<T = unknown> {
+    readonly id: number;
+    readonly req: RequestOp;
+    readonly promise: Promise<T>;
+    private resolveFn;
+    private rejectFn;
+    readonly frames: Frame[];
+    constructor(id: number, req: RequestOp);
+    ref(path: string): {
+        $ref: string;
+    };
+    /** @internal */
+    _resolve(v: T): void;
+    /** @internal */
+    _reject(e: unknown): void;
+}
+export interface BatchResult {
+    frames: Frame[];
+}
+export declare class Batch {
+    private readonly client;
+    private readonly ops;
+    private nextId;
+    constructor(client: RayfoldClient);
+    query<T = unknown>(op: string, args?: Record<string, unknown>, o?: OpOptions): OpHandle<T>;
+    command<T = unknown>(op: string, args?: Record<string, unknown>, o?: OpOptions): OpHandle<T>;
+    private add;
+    /** Send the batch; every handle's promise settles as its frames arrive. */
+    run(opts?: {
+        signal?: AbortSignal;
+        onFrame?: (f: Frame) => void;
+    }): Promise<BatchResult>;
+}
+export declare class RayfoldClient {
+    private readonly opts;
+    readonly cache: RayfoldCache;
+    private readonly keyGen;
+    private readonly now;
+    constructor(opts: ClientOptions);
+    private readonly queue;
+    /** With a schema, every op is sent compact and types are restored on arrival. */
+    /** @internal */
+    prepare(req: RequestOp): RequestOp;
+    private typed;
+    newKey(): string;
+    batch(): Batch;
+    /** One query; returns the denormalized result. Subsequent reads of the same entities stay coherent via the cache. */
+    query<T = unknown>(op: string, args?: Record<string, unknown>, o?: QueryOptions): Promise<T>;
+    command<T = unknown>(op: string, args?: Record<string, unknown>, o?: CommandOptions): Promise<T>;
+    /** Drops the command's prediction and returns its result as the server left it, not as it was predicted. */
+    private settled;
+    /** Orders commands by when they were made, across reloads too: it starts from the clock. */
+    private nextSeq;
+    private sendCommand;
+    /** Commands waiting for the server (option `offline`), oldest first. */
+    get queued(): readonly QueuedCommand[];
+    /** Sends the waiting commands in order; resolves to how many still wait because the server is still unreachable. */
+    drain(): Promise<number>;
+    /** Follows the queue: a command queued, sent, or refused by the server when it finally went out. */
+    onQueue(fn: (e: QueueEvent) => void): () => void;
+    /** Stream items; ends when the server sends fin or the signal aborts. */
+    stream<T = unknown>(op: string, args?: Record<string, unknown>, o?: OpOptions & {
+        signal?: AbortSignal;
+    }): AsyncIterable<T>;
+    /**
+     * Watch a query: `fn` receives the current denormalized data now and again whenever a later command's
+     * patch (or another query) changes any entity the result contains. No refetch involved. `onError` gets the
+     * initial fetch's failure; without it the failure is dropped.
+     */
+    watch<T = unknown>(op: string, args: Record<string, unknown>, o: QueryOptions, fn: (data: T) => void, onError?: (e: unknown) => void): () => void;
+    /**
+     * Live query (extension `live`): the server keeps the query open and pushes patches. `fn` receives the
+     * current data now and after every server-side change. `onError` gets an error frame or a failed connection
+     * (not the abort from unsubscribing). Returns an unsubscribe function.
+     */
+    live<T = unknown>(op: string, args: Record<string, unknown>, o: OpOptions, fn: (data: T, meta: {
+        initial: boolean;
+    }) => void, onError?: (e: unknown) => void): () => void;
+    /** @internal */
+    envelope(ops: RequestOp[]): RequestEnvelope;
+    /** @internal */
+    runBatch(handles: OpHandle[], opts: {
+        signal?: AbortSignal;
+        onFrame?: (f: Frame) => void;
+    }): Promise<BatchResult>;
+    private readonly opKinds;
+    private readonly schema;
+    /** Ops are assumed safe when the transport is used with a schema-aware hint; default: name-based heuristic overridden by `markQueries`. */
+    private isQuery;
+    /** Tell the client which op names are queries so all-query batches go over the safe method. */
+    markQueries(names: string[]): void;
+}

package/client.js

@@ -0,0 +1,425 @@
+import { annotation } from "@rayfold/schema";
+import { RayfoldCache } from "./cache.js";
+import { OfflineQueue, isUnreachable, memoryQueue } from "./offline.js";
+import { restoreTypes, typeAtPath } from "./types.js";
+export class RayfoldClientError extends Error {
+    code;
+    type;
+    data;
+    path;
+    retryable;
+    constructor(w) {
+        super(w.message);
+        this.name = "RayfoldClientError";
+        this.code = w.code;
+        this.type = w.type;
+        this.data = w.data;
+        this.path = w.path;
+        this.retryable = w.retryable ?? ["unavailable", "deadline_exceeded", "aborted"].includes(w.code);
+    }
+    /** Narrow on a declared domain error: `if (e.is("OutOfStock")) e.data.available` */
+    is(type) {
+        return this.code === "domain" && this.type === type;
+    }
+}
+/** A handle to an op inside a batch. `ref("id")` produces a `$ref` usable in later ops' args. */
+export class OpHandle {
+    id;
+    req;
+    promise;
+    resolveFn;
+    rejectFn;
+    frames = [];
+    constructor(id, req) {
+        this.id = id;
+        this.req = req;
+        this.promise = new Promise((res, rej) => {
+            this.resolveFn = res;
+            this.rejectFn = rej;
+        });
+        this.promise.catch(() => { }); // avoid unhandled rejections when the caller ignores this handle
+    }
+    ref(path) {
+        return { $ref: `${this.id}.${path}` };
+    }
+    /** @internal */
+    _resolve(v) {
+        this.resolveFn(v);
+    }
+    /** @internal */
+    _reject(e) {
+        this.rejectFn(e);
+    }
+}
+export class Batch {
+    client;
+    ops = [];
+    nextId = 1;
+    constructor(client) {
+        this.client = client;
+    }
+    query(op, args = {}, o = {}) {
+        return this.add({ id: this.nextId++, op, args, ...pick(o) });
+    }
+    command(op, args = {}, o = {}) {
+        const req = { id: this.nextId++, op, args, ...pick(o) };
+        if (req.key === undefined)
+            req.key = this.client.newKey();
+        return this.add(req);
+    }
+    add(req) {
+        const h = new OpHandle(req.id, this.client.prepare(req));
+        this.ops.push(h);
+        return h;
+    }
+    /** Send the batch; every handle's promise settles as its frames arrive. */
+    async run(opts = {}) {
+        return this.client.runBatch(this.ops, opts);
+    }
+}
+export class RayfoldClient {
+    opts;
+    cache;
+    keyGen;
+    now;
+    constructor(opts) {
+        this.opts = opts;
+        this.now = opts.now ?? Date.now;
+        this.cache = opts.cache ?? new RayfoldCache(this.now, mergePolicyOf(opts.schema));
+        this.keyGen = opts.keyGen ?? (() => (globalThis.crypto?.randomUUID?.() ?? `${this.now().toString(36)}-${Math.random().toString(36).slice(2)}`).replace(/-/g, ""));
+        this.schema = opts.schema;
+        if (this.schema)
+            for (const op of Object.values(this.schema.ops))
+                if (op.kind === "query")
+                    this.opKinds.set(op.name, "query");
+        if (opts.offline) {
+            const queue = new OfflineQueue(opts.offline.storage ?? memoryQueue(), (c) => this.sendCommand(c).then((r) => this.settled(c, r)), (c) => this.cache.removeLayer(c.key), (c) => {
+                if (c.optimistic?.length)
+                    this.cache.addLayer(c.key, c.optimistic);
+            });
+            this.queue = queue;
+            const target = globalThis;
+            if (opts.offline.drainOnReconnect !== false && typeof target.addEventListener === "function")
+                target.addEventListener("online", () => void queue.drain());
+        }
+    }
+    queue;
+    /** With a schema, every op is sent compact and types are restored on arrival. */
+    /** @internal */
+    prepare(req) {
+        return this.schema ? { ...req, compact: true } : req;
+    }
+    typed(op, data, at) {
+        if (!this.schema)
+            return data;
+        const def = this.schema.ops[op];
+        if (!def)
+            return data;
+        const t = at ? typeAtPath(this.schema, def.returns, at) : def.returns;
+        return t ? restoreTypes(this.schema, t, data) : data;
+    }
+    newKey() {
+        return this.keyGen();
+    }
+    batch() {
+        return new Batch(this);
+    }
+    /** One query; returns the denormalized result. Subsequent reads of the same entities stay coherent via the cache. */
+    async query(op, args = {}, o = {}) {
+        const rk = RayfoldCache.resultKey(op, args, o.shape, o.vars);
+        if (o.policy === "cache") {
+            const cached = this.cache.getResult(rk);
+            if (cached && !cached.stale && ![...cached.keys].some((k) => this.cache.isStale(k)))
+                return this.cache.denormalize(cached.data);
+        }
+        const b = this.batch();
+        const h = b.query(op, args, o);
+        await b.run();
+        return h.promise;
+    }
+    async command(op, args = {}, o = {}) {
+        const { optimistic, ...options } = o;
+        const predicted = typeof optimistic === "function" ? optimistic(this.cache) : optimistic;
+        const command = { key: o.key ?? this.newKey(), op, args, options, queuedAt: this.now(), seq: this.nextSeq++, ...(predicted?.length ? { optimistic: predicted } : {}) };
+        if (predicted?.length)
+            this.cache.addLayer(command.key, predicted);
+        if (this.queue) {
+            await this.queue.restored;
+            // behind the commands still waiting, so the server sees them in the order they were made
+            if (this.queue.size)
+                return this.queue.add(command);
+        }
+        try {
+            return this.settled(command, await this.sendCommand(command));
+        }
+        catch (e) {
+            if (this.queue && isUnreachable(e))
+                return this.queue.add(command); // its prediction stays until it is sent
+            this.cache.removeLayer(command.key);
+            throw e;
+        }
+    }
+    /** Drops the command's prediction and returns its result as the server left it, not as it was predicted. */
+    settled(c, result) {
+        if (!c.optimistic?.length)
+            return result;
+        this.cache.removeLayer(c.key);
+        const stored = this.cache.getResult(RayfoldCache.resultKey(c.op, c.args, c.options.shape, c.options.vars));
+        return stored ? this.cache.denormalize(stored.data) : result;
+    }
+    /** Orders commands by when they were made, across reloads too: it starts from the clock. */
+    nextSeq = Date.now();
+    async sendCommand(c) {
+        const b = this.batch();
+        const h = b.command(c.op, c.args, { ...c.options, key: c.key });
+        await b.run();
+        return h.promise;
+    }
+    /** Commands waiting for the server (option `offline`), oldest first. */
+    get queued() {
+        return this.queue?.commands ?? [];
+    }
+    /** Sends the waiting commands in order; resolves to how many still wait because the server is still unreachable. */
+    drain() {
+        return this.queue ? this.queue.drain() : Promise.resolve(0);
+    }
+    /** Follows the queue: a command queued, sent, or refused by the server when it finally went out. */
+    onQueue(fn) {
+        return this.queue ? this.queue.subscribe(fn) : () => { };
+    }
+    /** Stream items; ends when the server sends fin or the signal aborts. */
+    stream(op, args = {}, o = {}) {
+        const client = this;
+        return (async function* () {
+            const req = client.prepare({ id: 1, op, args, ...pick(o) });
+            const sendOpts = {};
+            if (o.signal)
+                sendOpts.signal = o.signal;
+            for await (const f of client.opts.transport.send(client.envelope([req]), sendOpts)) {
+                if ("item" in f)
+                    yield client.cache.denormalize(client.cache.normalize(client.typed(op, f.item)));
+                else if ("error" in f) {
+                    if (f.error.code === "canceled" && o.signal?.aborted)
+                        return;
+                    throw new RayfoldClientError(f.error);
+                }
+                else if ("fin" in f && f.fin)
+                    return;
+            }
+        })();
+    }
+    /**
+     * Watch a query: `fn` receives the current denormalized data now and again whenever a later command's
+     * patch (or another query) changes any entity the result contains. No refetch involved. `onError` gets the
+     * initial fetch's failure; without it the failure is dropped.
+     */
+    watch(op, args, o, fn, onError) {
+        const rk = RayfoldCache.resultKey(op, args, o.shape, o.vars);
+        let active = true;
+        let ready = false; // ignore the cache events produced by the initial fetch itself
+        let seen; // the stored result `fn` last reported
+        // This result changed when it was replaced (a refetch), when an entity it holds changed, or when its op was
+        // invalidated. Another result of the same op changing is not a reason: the event's `ops` alone would say so.
+        const listener = ({ keys, ops }) => {
+            const r = this.cache.getResult(rk);
+            if (!r || !active || !ready)
+                return;
+            const hit = r !== seen || [...keys].some((k) => r.keys.has(k)) || (ops.has(op) && r.stale);
+            if (!hit)
+                return;
+            seen = r;
+            fn(this.cache.denormalize(r.data));
+        };
+        const off = this.cache.subscribe(listener);
+        void this.query(op, args, o).then((d) => {
+            ready = true;
+            seen = this.cache.getResult(rk);
+            if (active)
+                fn(d);
+        }, (e) => {
+            if (active)
+                onError?.(e);
+        });
+        return () => {
+            active = false;
+            off();
+        };
+    }
+    /**
+     * Live query (extension `live`): the server keeps the query open and pushes patches. `fn` receives the
+     * current data now and after every server-side change. `onError` gets an error frame or a failed connection
+     * (not the abort from unsubscribing). Returns an unsubscribe function.
+     */
+    live(op, args, o, fn, onError) {
+        const ac = new AbortController();
+        const rk = RayfoldCache.resultKey(op, args, o.shape, o.vars);
+        let initial = true;
+        const b = this.batch();
+        const h = b.query(op, args, { ...o, live: true });
+        void b
+            .run({
+            signal: ac.signal,
+            onFrame: (f) => {
+                if (!("id" in f) || f.id !== h.id)
+                    return;
+                if ("error" in f) {
+                    // after unsubscribing, the stream ends with a "canceled" frame: that is the stop, not a failure
+                    if (!ac.signal.aborted)
+                        onError?.(new RayfoldClientError(f.error));
+                    return;
+                }
+                if (("data" in f && !("at" in f)) || "patch" in f || "fin" in f) {
+                    const r = this.cache.getResult(rk);
+                    if (!r)
+                        return;
+                    fn(this.cache.denormalize(r.data), { initial });
+                    initial = false;
+                }
+            },
+        })
+            .catch((e) => {
+            if (!ac.signal.aborted)
+                onError?.(e);
+        });
+        return () => ac.abort();
+    }
+    /** @internal */
+    envelope(ops) {
+        const env = { rayfold: "0.1", ops };
+        const meta = {};
+        if (this.opts.client)
+            meta.client = this.opts.client;
+        if (this.opts.deadline !== undefined)
+            meta.deadline = this.opts.deadline;
+        if (Object.keys(meta).length)
+            env.meta = meta;
+        return env;
+    }
+    /** @internal */
+    async runBatch(handles, opts) {
+        const byId = new Map(handles.map((h) => [h.id, h]));
+        const safe = handles.every((h) => this.isQuery(h.req.op));
+        const sendOpts = { safe };
+        if (opts.signal)
+            sendOpts.signal = opts.signal;
+        const frames = [];
+        const settled = new Set();
+        const resultKeys = new Map();
+        for (const h of handles)
+            resultKeys.set(h.id, RayfoldCache.resultKey(h.req.op, h.req.args, h.req.shape, h.req.vars));
+        const resolve = (h, v) => {
+            settled.add(h.id);
+            h._resolve(v);
+        };
+        const reject = (h, e) => {
+            settled.add(h.id);
+            h._reject(e);
+        };
+        try {
+            for await (const f of this.opts.transport.send(this.envelope(handles.map((h) => h.req)), sendOpts)) {
+                frames.push(f);
+                if (!("id" in f)) {
+                    const err = new RayfoldClientError(f.error);
+                    for (const h of handles)
+                        if (!settled.has(h.id))
+                            reject(h, err);
+                    opts.onFrame?.(f);
+                    continue;
+                }
+                const h = byId.get(f.id);
+                if (!h)
+                    continue;
+                h.frames.push(f);
+                if ("error" in f) {
+                    const current = f.error.type === "VersionConflict" ? f.error.data?.current : undefined;
+                    if (current)
+                        this.cache.mergeEntities(current);
+                    reject(h, new RayfoldClientError(f.error));
+                }
+                else if ("ok" in f) {
+                    let r;
+                    this.cache.transaction(() => {
+                        r = this.cache.putResult(resultKeys.get(h.id), h.req.op, this.typed(h.req.op, f.ok));
+                        if (f.patch)
+                            this.cache.applyPatch(f.patch);
+                    });
+                    resolve(h, this.cache.denormalize(r.data));
+                }
+                else if ("data" in f && !("at" in f)) {
+                    const r = this.cache.putResult(resultKeys.get(h.id), h.req.op, this.typed(h.req.op, f.data));
+                    if (f.fin)
+                        resolve(h, this.cache.denormalize(r.data));
+                }
+                else if ("at" in f) {
+                    this.cache.mergeAt(resultKeys.get(h.id), f.at, this.typed(h.req.op, f.data, f.at));
+                }
+                else if ("patch" in f) {
+                    // a live update: `at` and `list` ops describe this op's own stored result
+                    this.cache.applyPatch(f.patch, resultKeys.get(h.id));
+                }
+                else if ("fin" in f && f.fin && !settled.has(h.id)) {
+                    const r = this.cache.getResult(resultKeys.get(h.id));
+                    resolve(h, r ? this.cache.denormalize(r.data) : undefined);
+                }
+                opts.onFrame?.(f); // after the cache has absorbed the frame
+            }
+        }
+        catch (e) {
+            for (const h of handles)
+                if (!settled.has(h.id))
+                    reject(h, e);
+            throw e;
+        }
+        for (const h of handles)
+            if (!settled.has(h.id))
+                reject(h, new RayfoldClientError({ code: "unavailable", message: "Batch ended without a result for this op" }));
+        return { frames };
+    }
+    opKinds = new Map();
+    schema;
+    /** Ops are assumed safe when the transport is used with a schema-aware hint; default: name-based heuristic overridden by `markQueries`. */
+    isQuery(op) {
+        return this.opKinds.get(op) === "query";
+    }
+    /** Tell the client which op names are queries so all-query batches go over the safe method. */
+    markQueries(names) {
+        for (const n of names)
+            this.opKinds.set(n, "query");
+    }
+}
+function pick(o) {
+    const out = {};
+    if (o.shape !== undefined)
+        out.shape = o.shape;
+    if (o.vars !== undefined)
+        out.vars = o.vars;
+    if (o.key !== undefined)
+        out.key = o.key;
+    if (o.deadline !== undefined)
+        out.deadline = o.deadline;
+    if (o.simulate !== undefined)
+        out.simulate = o.simulate;
+    if (o.live !== undefined)
+        out.live = o.live;
+    if (o.ifVersion !== undefined)
+        out.ifVersion = o.ifVersion;
+    return out;
+}
+/** A field's `@merge` policy from the schema, memoised; without a schema there is no policy to read. */
+function mergePolicyOf(schema) {
+    if (!schema)
+        return () => undefined;
+    const seen = new Map();
+    return (type, field) => {
+        const key = `${type}.${field}`;
+        if (seen.has(key))
+            return seen.get(key);
+        const def = schema.types[type];
+        const f = def && "fields" in def ? def.fields.find((x) => x.name === field) : undefined;
+        const value = f ? annotation(f, "merge")?.args["value"] : undefined;
+        const policy = value && typeof value === "object" && "$ident" in value ? String(value.$ident) : undefined;
+        seen.set(key, policy);
+        return policy;
+    };
+}
+//# sourceMappingURL=client.js.map

package/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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","sourcesContent":["/** RayfoldClient: batches with refs, cache-coherent commands, live-updating watches. */\nimport type { Frame, PatchOp, RequestEnvelope, RequestOp, WireError } from \"@rayfold/server/protocol\";\nimport type { RayfoldSchemaIR } from \"@rayfold/schema\";\nimport { annotation } from \"@rayfold/schema\";\nimport { RayfoldCache, type CacheListener, type CachedResult, type MergePolicy, type OptimisticOp } from \"./cache.ts\";\nimport { OfflineQueue, isUnreachable, memoryQueue, type QueueEvent, type QueueStorage, type QueuedCommand } from \"./offline.ts\";\nimport type { Transport } from \"./transport.ts\";\nimport { restoreTypes, typeAtPath } from \"./types.ts\";\n\nexport class RayfoldClientError extends Error {\n  readonly code: string;\n  readonly type: string | undefined;\n  readonly data: unknown;\n  readonly path: string | undefined;\n  readonly retryable: boolean;\n  constructor(w: WireError) {\n    super(w.message);\n    this.name = \"RayfoldClientError\";\n    this.code = w.code;\n    this.type = w.type;\n    this.data = w.data;\n    this.path = w.path;\n    this.retryable = w.retryable ?? [\"unavailable\", \"deadline_exceeded\", \"aborted\"].includes(w.code);\n  }\n  /** Narrow on a declared domain error: `if (e.is(\"OutOfStock\")) e.data.available` */\n  is(type: string): boolean {\n    return this.code === \"domain\" && this.type === type;\n  }\n}\n\nexport interface OpOptions {\n  shape?: string;\n  vars?: Record<string, unknown>;\n  key?: string;\n  deadline?: number;\n  simulate?: boolean;\n  live?: boolean;\n  /** Conditional write: the entity version last seen; a stale value fails with VersionConflict carrying the current entity. */\n  ifVersion?: string | number;\n}\n\nexport interface CommandOptions extends OpOptions {\n  /**\n   * The change the command is expected to make (sub-profile `sync`, spec 08 section 5), shown in the cache at once. The\n   * server's own patch replaces it when the command succeeds; it is rolled back when the command fails. A function\n   * gets the cache, to compute the prediction from current values.\n   */\n  optimistic?: OptimisticOp[] | ((cache: RayfoldCache) => OptimisticOp[]);\n}\n\nexport interface QueryOptions extends OpOptions {\n  /** \"network\" (default) always fetches; \"cache\" serves a fresh cached result when present. */\n  policy?: \"network\" | \"cache\";\n}\n\nexport interface ClientOptions {\n  transport: Transport;\n  cache?: RayfoldCache;\n  /** Sent as meta.client, e.g. \"web/1.2.0\". */\n  client?: string;\n  /** Batch deadline in ms. */\n  deadline?: number;\n  /** Idempotency key generator for commands without an explicit key. */\n  keyGen?: () => string;\n  now?: () => number;\n  /** Schema IR (from /rayfold/manifest). Enables compact frames: the server omits redundant `$type`/`meta`, the client restores types. */\n  schema?: RayfoldSchemaIR;\n  /**\n   * Queue commands made while the server cannot be reached (sub-profile `sync`) and send them later, in order and with\n   * their idempotency keys: on `drain()`, and when the browser comes back online. Their predictions stay shown meanwhile.\n   */\n  offline?: { storage?: QueueStorage; drainOnReconnect?: boolean };\n}\n\n/** A handle to an op inside a batch. `ref(\"id\")` produces a `$ref` usable in later ops' args. */\nexport class OpHandle<T = unknown> {\n  readonly promise: Promise<T>;\n  private resolveFn!: (v: T) => void;\n  private rejectFn!: (e: unknown) => void;\n  readonly frames: Frame[] = [];\n  constructor(\n    readonly id: number,\n    readonly req: RequestOp,\n  ) {\n    this.promise = new Promise<T>((res, rej) => {\n      this.resolveFn = res;\n      this.rejectFn = rej;\n    });\n    this.promise.catch(() => {}); // avoid unhandled rejections when the caller ignores this handle\n  }\n  ref(path: string): { $ref: string } {\n    return { $ref: `${this.id}.${path}` };\n  }\n  /** @internal */\n  _resolve(v: T): void {\n    this.resolveFn(v);\n  }\n  /** @internal */\n  _reject(e: unknown): void {\n    this.rejectFn(e);\n  }\n}\n\nexport interface BatchResult {\n  frames: Frame[];\n}\n\nexport class Batch {\n  private readonly ops: OpHandle[] = [];\n  private nextId = 1;\n  constructor(private readonly client: RayfoldClient) {}\n\n  query<T = unknown>(op: string, args: Record<string, unknown> = {}, o: OpOptions = {}): OpHandle<T> {\n    return this.add<T>({ id: this.nextId++, op, args, ...pick(o) });\n  }\n  command<T = unknown>(op: string, args: Record<string, unknown> = {}, o: OpOptions = {}): OpHandle<T> {\n    const req: RequestOp = { id: this.nextId++, op, args, ...pick(o) };\n    if (req.key === undefined) req.key = this.client.newKey();\n    return this.add<T>(req);\n  }\n  private add<T>(req: RequestOp): OpHandle<T> {\n    const h = new OpHandle<T>(req.id, this.client.prepare(req));\n    this.ops.push(h as unknown as OpHandle);\n    return h;\n  }\n  /** Send the batch; every handle's promise settles as its frames arrive. */\n  async run(opts: { signal?: AbortSignal; onFrame?: (f: Frame) => void } = {}): Promise<BatchResult> {\n    return this.client.runBatch(this.ops, opts);\n  }\n}\n\nexport class RayfoldClient {\n  readonly cache: RayfoldCache;\n  private readonly keyGen: () => string;\n  private readonly now: () => number;\n\n  constructor(private readonly opts: ClientOptions) {\n    this.now = opts.now ?? Date.now;\n    this.cache = opts.cache ?? new RayfoldCache(this.now, mergePolicyOf(opts.schema));\n    this.keyGen = opts.keyGen ?? (() => (globalThis.crypto?.randomUUID?.() ?? `${this.now().toString(36)}-${Math.random().toString(36).slice(2)}`).replace(/-/g, \"\"));\n    this.schema = opts.schema;\n    if (this.schema) for (const op of Object.values(this.schema.ops)) if (op.kind === \"query\") this.opKinds.set(op.name, \"query\");\n    if (opts.offline) {\n      const queue = new OfflineQueue(\n        opts.offline.storage ?? memoryQueue(),\n        (c) => this.sendCommand(c).then((r) => this.settled(c, r)),\n        (c) => this.cache.removeLayer(c.key),\n        (c) => {\n          if (c.optimistic?.length) this.cache.addLayer(c.key, c.optimistic);\n        },\n      );\n      this.queue = queue;\n      const target = globalThis as { addEventListener?: (type: string, fn: () => void) => void };\n      if (opts.offline.drainOnReconnect !== false && typeof target.addEventListener === \"function\") target.addEventListener(\"online\", () => void queue.drain());\n    }\n  }\n\n  private readonly queue: OfflineQueue | undefined;\n\n  /** With a schema, every op is sent compact and types are restored on arrival. */\n  /** @internal */\n  prepare(req: RequestOp): RequestOp {\n    return this.schema ? { ...req, compact: true } : req;\n  }\n  private typed(op: string, data: unknown, at?: string): unknown {\n    if (!this.schema) return data;\n    const def = this.schema.ops[op];\n    if (!def) return data;\n    const t = at ? typeAtPath(this.schema, def.returns, at) : def.returns;\n    return t ? restoreTypes(this.schema, t, data) : data;\n  }\n\n  newKey(): string {\n    return this.keyGen();\n  }\n\n  batch(): Batch {\n    return new Batch(this);\n  }\n\n  /** One query; returns the denormalized result. Subsequent reads of the same entities stay coherent via the cache. */\n  async query<T = unknown>(op: string, args: Record<string, unknown> = {}, o: QueryOptions = {}): Promise<T> {\n    const rk = RayfoldCache.resultKey(op, args, o.shape, o.vars);\n    if (o.policy === \"cache\") {\n      const cached = this.cache.getResult(rk);\n      if (cached && !cached.stale && ![...cached.keys].some((k) => this.cache.isStale(k))) return this.cache.denormalize(cached.data) as T;\n    }\n    const b = this.batch();\n    const h = b.query<T>(op, args, o);\n    await b.run();\n    return h.promise;\n  }\n\n  async command<T = unknown>(op: string, args: Record<string, unknown> = {}, o: CommandOptions = {}): Promise<T> {\n    const { optimistic, ...options } = o;\n    const predicted = typeof optimistic === \"function\" ? optimistic(this.cache) : optimistic;\n    const command: QueuedCommand = { key: o.key ?? this.newKey(), op, args, options, queuedAt: this.now(), seq: this.nextSeq++, ...(predicted?.length ? { optimistic: predicted } : {}) };\n    if (predicted?.length) this.cache.addLayer(command.key, predicted);\n    if (this.queue) {\n      await this.queue.restored;\n      // behind the commands still waiting, so the server sees them in the order they were made\n      if (this.queue.size) return this.queue.add<T>(command);\n    }\n    try {\n      return this.settled(command, await this.sendCommand<T>(command));\n    } catch (e) {\n      if (this.queue && isUnreachable(e)) return this.queue.add<T>(command); // its prediction stays until it is sent\n      this.cache.removeLayer(command.key);\n      throw e;\n    }\n  }\n\n  /** Drops the command's prediction and returns its result as the server left it, not as it was predicted. */\n  private settled<T>(c: QueuedCommand, result: T): T {\n    if (!c.optimistic?.length) return result;\n    this.cache.removeLayer(c.key);\n    const stored = this.cache.getResult(RayfoldCache.resultKey(c.op, c.args, c.options.shape, c.options.vars));\n    return stored ? (this.cache.denormalize(stored.data) as T) : result;\n  }\n\n  /** Orders commands by when they were made, across reloads too: it starts from the clock. */\n  private nextSeq = Date.now();\n\n  private async sendCommand<T>(c: QueuedCommand): Promise<T> {\n    const b = this.batch();\n    const h = b.command<T>(c.op, c.args, { ...c.options, key: c.key });\n    await b.run();\n    return h.promise;\n  }\n\n  /** Commands waiting for the server (option `offline`), oldest first. */\n  get queued(): readonly QueuedCommand[] {\n    return this.queue?.commands ?? [];\n  }\n\n  /** Sends the waiting commands in order; resolves to how many still wait because the server is still unreachable. */\n  drain(): Promise<number> {\n    return this.queue ? this.queue.drain() : Promise.resolve(0);\n  }\n\n  /** Follows the queue: a command queued, sent, or refused by the server when it finally went out. */\n  onQueue(fn: (e: QueueEvent) => void): () => void {\n    return this.queue ? this.queue.subscribe(fn) : () => {};\n  }\n\n  /** Stream items; ends when the server sends fin or the signal aborts. */\n  stream<T = unknown>(op: string, args: Record<string, unknown> = {}, o: OpOptions & { signal?: AbortSignal } = {}): AsyncIterable<T> {\n    const client = this;\n    return (async function* () {\n      const req: RequestOp = client.prepare({ id: 1, op, args, ...pick(o) });\n      const sendOpts: { signal?: AbortSignal } = {};\n      if (o.signal) sendOpts.signal = o.signal;\n      for await (const f of client.opts.transport.send(client.envelope([req]), sendOpts)) {\n        if (\"item\" in f) yield client.cache.denormalize(client.cache.normalize(client.typed(op, f.item))) as T;\n        else if (\"error\" in f) {\n          if (f.error.code === \"canceled\" && o.signal?.aborted) return;\n          throw new RayfoldClientError(f.error);\n        } else if (\"fin\" in f && f.fin) return;\n      }\n    })();\n  }\n\n  /**\n   * Watch a query: `fn` receives the current denormalized data now and again whenever a later command's\n   * patch (or another query) changes any entity the result contains. No refetch involved. `onError` gets the\n   * initial fetch's failure; without it the failure is dropped.\n   */\n  watch<T = unknown>(op: string, args: Record<string, unknown>, o: QueryOptions, fn: (data: T) => void, onError?: (e: unknown) => void): () => void {\n    const rk = RayfoldCache.resultKey(op, args, o.shape, o.vars);\n    let active = true;\n    let ready = false; // ignore the cache events produced by the initial fetch itself\n    let seen: CachedResult | undefined; // the stored result `fn` last reported\n    // This result changed when it was replaced (a refetch), when an entity it holds changed, or when its op was\n    // invalidated. Another result of the same op changing is not a reason: the event's `ops` alone would say so.\n    const listener: CacheListener = ({ keys, ops }) => {\n      const r = this.cache.getResult(rk);\n      if (!r || !active || !ready) return;\n      const hit = r !== seen || [...keys].some((k) => r.keys.has(k)) || (ops.has(op) && r.stale);\n      if (!hit) return;\n      seen = r;\n      fn(this.cache.denormalize(r.data) as T);\n    };\n    const off = this.cache.subscribe(listener);\n    void this.query<T>(op, args, o).then(\n      (d) => {\n        ready = true;\n        seen = this.cache.getResult(rk);\n        if (active) fn(d);\n      },\n      (e: unknown) => {\n        if (active) onError?.(e);\n      },\n    );\n    return () => {\n      active = false;\n      off();\n    };\n  }\n\n  /**\n   * Live query (extension `live`): the server keeps the query open and pushes patches. `fn` receives the\n   * current data now and after every server-side change. `onError` gets an error frame or a failed connection\n   * (not the abort from unsubscribing). Returns an unsubscribe function.\n   */\n  live<T = unknown>(op: string, args: Record<string, unknown>, o: OpOptions, fn: (data: T, meta: { initial: boolean }) => void, onError?: (e: unknown) => void): () => void {\n    const ac = new AbortController();\n    const rk = RayfoldCache.resultKey(op, args, o.shape, o.vars);\n    let initial = true;\n    const b = this.batch();\n    const h = b.query<T>(op, args, { ...o, live: true });\n    void b\n      .run({\n        signal: ac.signal,\n        onFrame: (f) => {\n          if (!(\"id\" in f) || f.id !== h.id) return;\n          if (\"error\" in f) {\n            // after unsubscribing, the stream ends with a \"canceled\" frame: that is the stop, not a failure\n            if (!ac.signal.aborted) onError?.(new RayfoldClientError(f.error));\n            return;\n          }\n          if ((\"data\" in f && !(\"at\" in f)) || \"patch\" in f || \"fin\" in f) {\n            const r = this.cache.getResult(rk);\n            if (!r) return;\n            fn(this.cache.denormalize(r.data) as T, { initial });\n            initial = false;\n          }\n        },\n      })\n      .catch((e: unknown) => {\n        if (!ac.signal.aborted) onError?.(e);\n      });\n    return () => ac.abort();\n  }\n\n  /** @internal */\n  envelope(ops: RequestOp[]): RequestEnvelope {\n    const env: RequestEnvelope = { rayfold: \"0.1\", ops };\n    const meta: RequestEnvelope[\"meta\"] = {};\n    if (this.opts.client) meta.client = this.opts.client;\n    if (this.opts.deadline !== undefined) meta.deadline = this.opts.deadline;\n    if (Object.keys(meta).length) env.meta = meta;\n    return env;\n  }\n\n  /** @internal */\n  async runBatch(handles: OpHandle[], opts: { signal?: AbortSignal; onFrame?: (f: Frame) => void }): Promise<BatchResult> {\n    const byId = new Map(handles.map((h) => [h.id, h]));\n    const safe = handles.every((h) => this.isQuery(h.req.op));\n    const sendOpts: { signal?: AbortSignal; safe?: boolean } = { safe };\n    if (opts.signal) sendOpts.signal = opts.signal;\n    const frames: Frame[] = [];\n    const settled = new Set<number>();\n    const resultKeys = new Map<number, string>();\n    for (const h of handles) resultKeys.set(h.id, RayfoldCache.resultKey(h.req.op, h.req.args, h.req.shape, h.req.vars));\n    const resolve = (h: OpHandle, v: unknown) => {\n      settled.add(h.id);\n      h._resolve(v);\n    };\n    const reject = (h: OpHandle, e: unknown) => {\n      settled.add(h.id);\n      h._reject(e);\n    };\n    try {\n      for await (const f of this.opts.transport.send(this.envelope(handles.map((h) => h.req)), sendOpts)) {\n        frames.push(f);\n        if (!(\"id\" in f)) {\n          const err = new RayfoldClientError(f.error);\n          for (const h of handles) if (!settled.has(h.id)) reject(h, err);\n          opts.onFrame?.(f);\n          continue;\n        }\n        const h = byId.get(f.id);\n        if (!h) continue;\n        h.frames.push(f);\n        if (\"error\" in f) {\n          const current = f.error.type === \"VersionConflict\" ? (f.error.data as { current?: unknown } | undefined)?.current : undefined;\n          if (current) this.cache.mergeEntities(current);\n          reject(h, new RayfoldClientError(f.error));\n        } else if (\"ok\" in f) {\n          let r!: ReturnType<RayfoldCache[\"putResult\"]>;\n          this.cache.transaction(() => {\n            r = this.cache.putResult(resultKeys.get(h.id)!, h.req.op, this.typed(h.req.op, f.ok));\n            if (f.patch) this.cache.applyPatch(f.patch as PatchOp[]);\n          });\n          resolve(h, this.cache.denormalize(r.data));\n        } else if (\"data\" in f && !(\"at\" in f)) {\n          const r = this.cache.putResult(resultKeys.get(h.id)!, h.req.op, this.typed(h.req.op, f.data));\n          if (f.fin) resolve(h, this.cache.denormalize(r.data));\n        } else if (\"at\" in f) {\n          this.cache.mergeAt(resultKeys.get(h.id)!, f.at, this.typed(h.req.op, f.data, f.at));\n        } else if (\"patch\" in f) {\n          // a live update: `at` and `list` ops describe this op's own stored result\n          this.cache.applyPatch(f.patch as PatchOp[], resultKeys.get(h.id)!);\n        } else if (\"fin\" in f && f.fin && !settled.has(h.id)) {\n          const r = this.cache.getResult(resultKeys.get(h.id)!);\n          resolve(h, r ? this.cache.denormalize(r.data) : undefined);\n        }\n        opts.onFrame?.(f); // after the cache has absorbed the frame\n      }\n    } catch (e) {\n      for (const h of handles) if (!settled.has(h.id)) reject(h, e);\n      throw e;\n    }\n    for (const h of handles) if (!settled.has(h.id)) reject(h, new RayfoldClientError({ code: \"unavailable\", message: \"Batch ended without a result for this op\" }));\n    return { frames };\n  }\n\n  private readonly opKinds = new Map<string, \"query\" | \"other\">();\n  private readonly schema: RayfoldSchemaIR | undefined;\n  /** Ops are assumed safe when the transport is used with a schema-aware hint; default: name-based heuristic overridden by `markQueries`. */\n  private isQuery(op: string): boolean {\n    return this.opKinds.get(op) === \"query\";\n  }\n  /** Tell the client which op names are queries so all-query batches go over the safe method. */\n  markQueries(names: string[]): void {\n    for (const n of names) this.opKinds.set(n, \"query\");\n  }\n}\n\nfunction pick(o: OpOptions): Partial<RequestOp> {\n  const out: Partial<RequestOp> = {};\n  if (o.shape !== undefined) out.shape = o.shape;\n  if (o.vars !== undefined) out.vars = o.vars as never;\n  if (o.key !== undefined) out.key = o.key;\n  if (o.deadline !== undefined) out.deadline = o.deadline;\n  if (o.simulate !== undefined) out.simulate = o.simulate;\n  if (o.live !== undefined) out.live = o.live;\n  if (o.ifVersion !== undefined) out.ifVersion = o.ifVersion;\n  return out;\n}\n\n/** A field's `@merge` policy from the schema, memoised; without a schema there is no policy to read. */\nfunction mergePolicyOf(schema: RayfoldSchemaIR | undefined): (type: string, field: string) => MergePolicy | undefined {\n  if (!schema) return () => undefined;\n  const seen = new Map<string, MergePolicy | undefined>();\n  return (type, field) => {\n    const key = `${type}.${field}`;\n    if (seen.has(key)) return seen.get(key);\n    const def = schema.types[type];\n    const f = def && \"fields\" in def ? def.fields.find((x) => x.name === field) : undefined;\n    const value = f ? annotation(f, \"merge\")?.args[\"value\"] : undefined;\n    const policy = value && typeof value === \"object\" && \"$ident\" in value ? (String((value as { $ident: string }).$ident) as MergePolicy) : undefined;\n    seen.set(key, policy);\n    return policy;\n  };\n}\n"]}

package/index.d.ts

@@ -0,0 +1,6 @@
+export { RayfoldCache, entityKey, isRef, type EntityKey, type Ref, type CachedResult, type CacheListener, type OptimisticOp } from "./cache.js";
+export { createFetchTransport, createLocalTransport, type Transport, type FetchTransportOptions } from "./transport.js";
+export { RayfoldClient, RayfoldClientError, Batch, OpHandle, type ClientOptions, type OpOptions, type CommandOptions, type QueryOptions, type BatchResult } from "./client.js";
+export { localStorageQueue, memoryQueue, isUnreachable, type QueueStorage, type QueuedCommand, type QueueEvent } from "./offline.js";
+export { createWebSocketTransport, type WsTransportOptions } from "./ws-transport.js";
+export { restoreTypes, typeAtPath } from "./types.js";