ramosedb 0.0.1 → 0.4.0

package/dist/client/changesets.js

@@ -0,0 +1,160 @@
+import { Store, sameResult } from "./subscription.js";
+import { OwnedOperations } from "../db/Operation.js";
+import { DatabaseView } from "./view.js";
+import { decodeChangesetList, decodeChangesetResponse, decodeReadResponse } from "../internal/changesets/protocol.js";
+const PreparedOperation = Symbol("ramose/prepared-operation");
+export class ChangesetError extends Error {
+    code;
+    status;
+    constructor(code, status) {
+        super(code);
+        this.code = code;
+        this.status = status;
+        this.name = "ChangesetError";
+    }
+}
+export const clientChangesets = (context) => {
+    const request = async (body, signal) => {
+        context.assertLive();
+        const credential = await context.credential();
+        const response = await fetch(context.endpoint, {
+            method: "POST",
+            signal: signal === undefined ? context.signal : AbortSignal.any([signal, context.signal]),
+            headers: { "content-type": "application/json", authorization: `Bearer ${credential.token}` },
+            body: JSON.stringify(body),
+        });
+        const result = await response.json();
+        context.assertLive();
+        if (!response.ok) {
+            const code = typeof result === "object" && result !== null && "code" in result && typeof result.code === "string" ? result.code : "changeset_failed";
+            throw new ChangesetError(code, response.status);
+        }
+        return result;
+    };
+    const encode = async (steps) => {
+        const registry = context.operations();
+        return Promise.all(steps.map(async (prepared) => {
+            const step = prepared[PreparedOperation];
+            const operation = step.target === undefined
+                ? registry.database.get(step.name)
+                : registry.self.get(`${step.owner.kind}\0${step.owner.name}`)?.get(step.name);
+            if (operation === undefined || operation.owner.kind !== step.owner.kind || operation.owner.name !== step.owner.name) {
+                throw new ChangesetError("unknown_operation", 400);
+            }
+            return {
+                operation: { owner: step.owner, localName: step.name },
+                operationVersion: await operation.version(),
+                input: operation.encode(step.input),
+                ...(step.target === undefined ? {} : { target: step.target }),
+            };
+        }));
+    };
+    const views = new Map();
+    const activeObservers = new Map();
+    const observers = new Map();
+    const observe = (options = {}) => {
+        const key = JSON.stringify([options.id, options.after, options.limit]);
+        const existing = activeObservers.get(key) ?? observers.get(key)?.deref();
+        if (existing !== undefined)
+            return existing;
+        const store = new Store({ status: "pending", data: undefined, stale: true, error: undefined });
+        let watching;
+        const stopWatching = () => { watching?.abort(); watching = undefined; activeObservers.delete(key); context.signal.removeEventListener("abort", stopWatching); };
+        const subscription = {
+            getSnapshot: () => store.getSnapshot(),
+            subscribe: (changed) => {
+                context.assertLive();
+                const stop = store.subscribe(changed);
+                activeObservers.set(key, subscription);
+                if (watching === undefined) {
+                    const controller = new AbortController();
+                    watching = controller;
+                    context.signal.addEventListener("abort", stopWatching, { once: true });
+                    void (async () => {
+                        let version;
+                        while (!controller.signal.aborted && !context.signal.aborted) {
+                            try {
+                                const response = decodeChangesetList(await request({ action: "watch", ...options, version }, controller.signal));
+                                if (controller.signal.aborted || context.signal.aborted)
+                                    break;
+                                version = response.version;
+                                if (!sameResult(store.getSnapshot().data, response) || store.getSnapshot().status !== "ready")
+                                    store.publish({ status: "ready", data: response, stale: false, error: undefined });
+                            }
+                            catch (cause) {
+                                if (controller.signal.aborted || context.signal.aborted)
+                                    break;
+                                store.publish({ status: "error", data: undefined, stale: true, error: cause instanceof Error ? cause : new Error("proposal subscription failed") });
+                                await new Promise((resolve) => {
+                                    const done = () => { clearTimeout(timer); controller.signal.removeEventListener("abort", done); resolve(); };
+                                    const timer = setTimeout(done, 2000);
+                                    controller.signal.addEventListener("abort", done, { once: true });
+                                });
+                            }
+                        }
+                    })();
+                }
+                return () => { stop(); if (store.size === 0)
+                    stopWatching(); };
+            },
+        };
+        for (const [cached, value] of observers)
+            if (value.deref() === undefined)
+                observers.delete(cached);
+        if (observers.size >= 128)
+            observers.delete(observers.keys().next().value);
+        observers.set(key, new WeakRef(subscription));
+        return subscription;
+    };
+    context.signal.addEventListener("abort", () => { views.clear(); observers.clear(); activeObservers.clear(); }, { once: true });
+    const proposal = async (body) => decodeChangesetResponse(await request(body));
+    return {
+        observe,
+        list: async (options = {}) => decodeChangesetList(await request({ action: "list", ...options })),
+        operations: (owner) => {
+            const registry = context.operations();
+            const kind = owner._tag === "Trait" ? "trait" : "entity";
+            const operations = [...registry.database.values(), ...registry.self.get(`${kind}\0${owner.ns}`)?.values() ?? []]
+                .filter((operation) => operation.owner.kind === kind && operation.owner.name === owner.ns);
+            return Object.freeze(Object.fromEntries(operations.map((operation) => [operation.localName,
+                (...args) => Object.freeze({ [PreparedOperation]: {
+                        owner: operation.owner, name: operation.localName,
+                        input: operation.self ? args[1] : args[0],
+                        ...(operation.self ? { target: args[0] } : {}),
+                    } }),
+            ])));
+        },
+        open: (id, revision) => {
+            const key = `${id}\0${revision}`;
+            let view = views.get(key)?.deref();
+            if (view === undefined) {
+                view = new DatabaseView({
+                    read: async (query, signal) => {
+                        const response = decodeReadResponse(await request({ action: "read", id, revision, query }, signal));
+                        if (response.revision !== revision)
+                            throw new ChangesetError("changeset_revision_conflict", 409);
+                        return response;
+                    },
+                    subscribe: (changed) => {
+                        const stopProposal = observe({ id }).subscribe(changed);
+                        const stopDatabase = context.subscribe(changed);
+                        return () => { stopProposal(); stopDatabase(); };
+                    }, assertLive: context.assertLive,
+                });
+                for (const [cached, value] of views)
+                    if (value.deref() === undefined)
+                        views.delete(cached);
+                if (views.size >= 128)
+                    views.delete(views.keys().next().value);
+                views.set(key, new WeakRef(view));
+            }
+            return view;
+        },
+        append: async (id, revision, steps) => proposal({ action: "append", id, revision, operations: await encode(steps) }),
+        prepare: async (input) => proposal({ ...input, action: "prepare", operations: await encode(input.operations) }),
+        inspect: (id) => proposal({ action: "inspect", id }),
+        commit: (id, revision) => proposal({ action: "commit", id, revision }),
+        discard: (id, revision) => proposal({ action: "discard", id, revision }),
+    };
+};
+//# sourceMappingURL=changesets.js.map

package/dist/client/changesets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changesets.js","sourceRoot":"","sources":["../../src/client/changesets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,UAAU,EAAqB,MAAM,mBAAmB,CAAC;AAGzE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,kBAAkB,EAA0B,MAAM,oCAAoC,CAAC;AAG9I,MAAM,iBAAiB,GAAkB,MAAM,CAAC,2BAA2B,CAAC,CAAC;AA+C7E,MAAM,OAAO,cAAe,SAAQ,KAAK;IAClB,IAAI;IAAmB,MAAM;IAAlD,YAAqB,IAAY,EAAW,MAAc;QACxD,KAAK,CAAC,IAAI,CAAC,CAAC;oBADO,IAAI;sBAAmB,MAAM;QAEhD,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,OAOhC,EAAoB,EAAE;IACrB,MAAM,OAAO,GAAG,KAAK,EAAE,IAAa,EAAE,MAAoB,EAAoB,EAAE;QAC9E,OAAO,CAAC,UAAU,EAAE,CAAC;QACrB,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;QAC9C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE;YAC7C,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;YACzF,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAAE,UAAU,UAAU,CAAC,KAAK,EAAE,EAAE;YAC5F,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;QACH,MAAM,MAAM,GAAY,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC9C,OAAO,CAAC,UAAU,EAAE,CAAC;QACrB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC;YACrJ,MAAM,IAAI,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,KAAK,EAAE,KAAoC,EAAE,EAAE;QAC5D,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;QACtC,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;YAC9C,MAAM,IAAI,GAAG,QAAQ,CAAC,iBAAiB,CAAC,CAAC;YACzC,MAAM,SAAS,GAAgC,IAAI,CAAC,MAAM,KAAK,SAAS;gBACtE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;gBAClC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChF,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;gBACpH,MAAM,IAAI,cAAc,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;YACrD,CAAC;YACD,OAAO;gBACL,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE;gBACtD,gBAAgB,EAAE,MAAM,SAAS,CAAC,OAAO,EAAE;gBAC3C,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;gBACnC,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;aAC9D,CAAC;QACJ,CAAC,CAAC,CAAC,CAAC;IACN,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,GAAG,EAAiC,CAAC;IACvD,MAAM,eAAe,GAAG,IAAI,GAAG,EAAsD,CAAC;IACtF,MAAM,SAAS,GAAG,IAAI,GAAG,EAA+D,CAAC;IACzF,MAAM,OAAO,GAAG,CAAC,OAAO,GAAoD,EAAE,EAA8C,EAAE;QAC5H,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QACvE,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC;QACzE,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,QAAQ,CAAC;QAC5C,MAAM,KAAK,GAAG,IAAI,KAAK,CAA+B,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QAC7H,IAAI,QAAqC,CAAC;QAC1C,MAAM,YAAY,GAAG,GAAG,EAAE,GAAG,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QAChK,MAAM,YAAY,GAA+C;YAC/D,WAAW,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE;YACtC,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;gBACrB,OAAO,CAAC,UAAU,EAAE,CAAC;gBACrB,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;gBACtC,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;gBACvC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;oBAC3B,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;oBACzC,QAAQ,GAAG,UAAU,CAAC;oBACtB,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;oBACvE,KAAK,CAAC,KAAK,IAAI,EAAE;wBACf,IAAI,OAA2B,CAAC;wBAChC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;4BAC7D,IAAI,CAAC;gCACH,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;gCACjH,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO;oCAAE,MAAM;gCAC/D,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;gCAC3B,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC,MAAM,KAAK,OAAO;oCAC3F,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;4BACvF,CAAC;4BAAC,OAAO,KAAK,EAAE,CAAC;gCACf,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO;oCAAE,MAAM;gCAC/D,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,8BAA8B,CAAC,EAAE,CAAC,CAAC;gCACpJ,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;oCAClC,MAAM,IAAI,GAAG,GAAG,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;oCAC7G,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;oCACrC,UAAU,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;gCACpE,CAAC,CAAC,CAAC;4BACL,CAAC;wBACH,CAAC;oBACH,CAAC,CAAC,EAAE,CAAC;gBACP,CAAC;gBACD,OAAO,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC;oBAAE,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC;YACjE,CAAC;SACF,CAAC;QACF,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,SAAS;YAAE,IAAI,KAAK,CAAC,KAAK,EAAE,KAAK,SAAS;gBAAE,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACnG,IAAI,SAAS,CAAC,IAAI,IAAI,GAAG;YAAE,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAM,CAAC,CAAC;QAC5E,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;QAC9C,OAAO,YAAY,CAAC;IACtB,CAAC,CAAC;IACF,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/H,MAAM,QAAQ,GAAG,KAAK,EAAE,IAAa,EAAE,EAAE,CAAC,uBAAuB,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACvF,OAAO;QACL,OAAO;QACP,IAAI,EAAE,KAAK,EAAE,OAAO,GAAG,EAAE,EAAE,EAAE,CAAC,mBAAmB,CAAC,MAAM,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;QAChG,UAAU,EAAE,CAAwB,KAAQ,EAAyB,EAAE;YACrE,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;YACzD,MAAM,UAAU,GAAG,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,KAAK,KAAK,CAAC,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;iBAC7G,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC,CAAC;YAC7F,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,SAAS;gBACxF,CAAC,GAAG,IAAwB,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,iBAAiB,CAAC,EAAE;wBACpE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,SAAS;wBACjD,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;wBACzC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;qBACzD,EAAE,CAAC;aACL,CAAC,CAAC,CAA0B,CAAC;QAChC,CAAC;QACD,IAAI,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE;YACrB,MAAM,GAAG,GAAG,GAAG,EAAE,KAAK,QAAQ,EAAE,CAAC;YACjC,IAAI,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC;YACnC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBAAC,IAAI,GAAG,IAAI,YAAY,CAAC;oBAChD,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;wBAC5B,MAAM,QAAQ,GAAG,kBAAkB,CAAC,MAAM,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;wBACpG,IAAI,QAAQ,CAAC,QAAQ,KAAK,QAAQ;4BAAE,MAAM,IAAI,cAAc,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;wBACjG,OAAO,QAAQ,CAAC;oBAClB,CAAC;oBACD,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;wBACrB,MAAM,YAAY,GAAG,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;wBACxD,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;wBAChD,OAAO,GAAG,EAAE,GAAG,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC;oBACnD,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU;iBAClC,CAAC,CAAC;gBAAC,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,KAAK;oBAAE,IAAI,KAAK,CAAC,KAAK,EAAE,KAAK,SAAS;wBAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC7F,IAAI,KAAK,CAAC,IAAI,IAAI,GAAG;oBAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAM,CAAC,CAAC;gBAChE,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;YAAC,CAAC;YACtC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACpH,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/G,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;QACpD,MAAM,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC;QACtE,OAAO,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC;KACzE,CAAC;AACJ,CAAC,CAAC"}

package/dist/client/client.d.ts

@@ -0,0 +1,45 @@
+import { type ClientChangesets } from "./changesets.ts";
+import { type AnySchemaDefinition } from "../db/Schema.ts";
+import type { DatabaseMutations, MutationNamespace } from "./mutation-schema.ts";
+import { type ClientDatabase } from "./database.ts";
+import { type Subscription } from "./subscription.ts";
+import { type SyncState } from "./sync.ts";
+/**
+ * One credential and the account it belongs to, produced atomically.
+ *
+ * `token` is the bearer the server authenticates. `cacheKey` is an
+ * application/auth-provider account selector that is stable across ordinary
+ * bearer renewal; it is hashed with the server origin and database route and never
+ * transmitted or persisted raw. It nominates a cache candidate and grants no
+ * authority: only an exact prior bearer binding, or the current authenticated
+ * response, can make a stored replica observable.
+ */
+export type AuthCredential = {
+    readonly token: string;
+    readonly cacheKey: string;
+};
+/** Called once per activation. May be synchronous or asynchronous. */
+export type AuthProvider = () => AuthCredential | Promise<AuthCredential>;
+export type ClientOptions<S extends AnySchemaDefinition = AnySchemaDefinition> = {
+    readonly url: string;
+    readonly database: string;
+    readonly schema: S;
+    readonly auth: AuthProvider;
+    readonly storageName?: string;
+};
+export type Client<Mutations = MutationNamespace> = {
+    readonly changesets: ClientChangesets;
+    readonly open: () => ClientDatabase<Mutations>;
+    readonly sync: Subscription<SyncState>;
+    readonly close: () => Promise<void>;
+    readonly clearLocalData: () => Promise<void>;
+};
+/**
+ * Bind one server, one configured database route, one named schema, and one
+ * refreshable credential provider.
+ *
+ * @throws ClientConfigurationError when any of them cannot be bound. None of
+ * these become valid later, so they fail here rather than at the first query.
+ */
+export declare const createClient: <const S extends AnySchemaDefinition>(options: ClientOptions<S>) => Client<DatabaseMutations<S>>;
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,iBAAiB,CAAC;AAgCzB,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,sBAAsB,CAAC;AAO9B,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,eAAe,CAAC;AAIvB,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAkC,KAAK,SAAS,EAAmB,MAAM,WAAW,CAAC;AAE5F;;;;;;;;;GASG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,sEAAsE;AACtE,MAAM,MAAM,YAAY,GAAG,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AAE1E,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,mBAAmB,GAAG,mBAAmB,IAAI;IAC/E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,MAAM,CAAC,SAAS,GAAG,iBAAiB,IAAI;IAClD,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,cAAc,CAAC,SAAS,CAAC,CAAC;IAC/C,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C,CAAC;AAgaF;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GAAI,KAAK,CAAC,CAAC,SAAS,mBAAmB,WACrD,aAAa,CAAC,CAAC,CAAC,KACxB,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,CA4B7B,CAAC"}

package/dist/client/client.js

@@ -0,0 +1,425 @@
+import { clientChangesets } from "./changesets.js";
+import { isSchemaDefinition, } from "../db/Schema.js";
+import { DEFAULT_REPLICA_DATABASE_NAME, IndexedDbReplicaStorage, } from "../internal/replication/indexeddb.js";
+import { replicaDatabaseKey, replicaDatabaseScopeOf, replicaScopeKey, replicaScopeOf, } from "../internal/replication/replica-lifecycle.js";
+import { observeActivation } from "./activation.js";
+import { platformLocks, replicaLeaderKey, SyncLeadership, } from "../internal/replication/leadership.js";
+import { replicationActivationAddress } from "../internal/replication/transport.js";
+import { completeSchema } from "../internal/authorization/read-tables.js";
+import { compositionFromSchema } from "../db/composition.js";
+import { installClientCatalog } from "./catalog.js";
+import { installClientOperations, selfOperationsFor, } from "./operations.js";
+import { SubmissionLoop } from "./submission.js";
+import { ClientClosedError, ClientConfigurationError, ClientLocalDataError, } from "./errors.js";
+import { ClientDatabaseHandle, } from "./database.js";
+import { fencedReceiver, } from "./query.js";
+import { Store } from "./subscription.js";
+import { aggregateSyncStatus, syncState } from "./sync.js";
+const nonEmpty = (value) => typeof value === "string" && value.length > 0;
+const settled = (status) => status !== "idle" && status !== "connecting";
+const SCOPE_CONFIRMATION_TIMEOUT_MS = 10_000;
+class RamoseClient {
+    options;
+    server;
+    lifetime = new AbortController();
+    syncStore = new Store(syncState("idle"));
+    sync = this.syncStore.subscription;
+    root;
+    catalogBuild;
+    storageHandle;
+    confirmed;
+    operations;
+    compositionIndex;
+    submissionLoop;
+    leadership;
+    leaderName;
+    releaseInvalidation;
+    releaseNotices;
+    releaseActivation;
+    terminal;
+    termination;
+    clearing = false;
+    constructor(options, server) {
+        this.options = options;
+        this.server = server;
+        this.changesets = clientChangesets({
+            signal: this.lifetime.signal,
+            endpoint: `${this.server}/db/${encodeURIComponent(this.options.database)}/changesets`,
+            credential: () => this.credential(),
+            operations: () => this.clientOperations(),
+            assertLive: () => this.assertLive("changesets"),
+            subscribe: (changed) => this.rootHandle().viewChanges.subscribe(changed),
+        });
+    }
+    changesets;
+    open() {
+        this.assertLive("open");
+        return this.rootHandle();
+    }
+    rootHandle() {
+        if (this.root !== undefined)
+            return this.root;
+        const root = new ClientDatabaseHandle({
+            ...this.databaseContext(),
+        });
+        this.root = root;
+        return root;
+    }
+    databaseContext() {
+        return {
+            server: this.server,
+            root: this.options.database,
+            catalog: () => this.catalog(),
+            storage: () => this.storage(),
+            credential: () => this.credential(),
+            assertLive: (operation) => this.assertLive(operation),
+            live: () => this.terminal === undefined,
+            onSyncChange: () => this.refreshSync(),
+            onConfirmed: (identity) => {
+                this.confirm(identity);
+                this.elect(identity);
+            },
+            onFenced: () => {
+                void this.terminate(this.clearing ? "cleared" : "fenced");
+            },
+            mutations: this.mutationContext(),
+        };
+    }
+    handles() {
+        return this.root === undefined ? [] : [this.root];
+    }
+    handleByKey(key) {
+        if (key === undefined)
+            return this.handles();
+        return this.handles().filter((handle) => {
+            const scope = handle.confirmedScope();
+            return scope !== undefined && replicaDatabaseKey(scope) === key;
+        });
+    }
+    receive(notice) {
+        const identity = this.confirmed;
+        if (this.terminal !== undefined || identity === undefined)
+            return;
+        const scope = replicaScopeOf(identity);
+        if (replicaScopeKey(scope) !== notice.scope)
+            return;
+        switch (notice.kind) {
+            case "replica":
+                for (const handle of this.handleByKey(notice.database)) {
+                    void handle.refreshCommitted();
+                }
+                return;
+            case "reset":
+                for (const handle of this.handleByKey(notice.database)) {
+                    void handle.revalidate().then(() => handle.refreshCommitted());
+                }
+                return;
+            case "layer":
+                for (const handle of this.handleByKey(notice.database)) {
+                    void handle.refreshOptimistic();
+                }
+                this.submissions().request(scope);
+                return;
+            case "receipt":
+            case "fence":
+                for (const handle of this.handleByKey(notice.database)) {
+                    void handle.refreshOptimistic();
+                }
+                void this.submissions().settleFromDurable();
+                return;
+            case "selector":
+                for (const handle of this.handles()) {
+                    handle.reactivateRefused();
+                }
+                this.submissions().request(scope);
+                return;
+        }
+    }
+    wake() {
+        if (this.terminal !== undefined)
+            return;
+        const revalidated = this.revalidate();
+        for (const handle of this.handles()) {
+            void handle.refreshOptimistic();
+            handle.reactivateRefused();
+            handle.reactivateOffline();
+        }
+        void revalidated.then(() => {
+            if (this.terminal !== undefined)
+                return;
+            for (const handle of this.handles())
+                void handle.refreshCommitted();
+            void this.submissions().settleFromDurable();
+            const identity = this.confirmed;
+            if (identity !== undefined)
+                this.submissions().request(replicaScopeOf(identity));
+        });
+    }
+    async revalidate() {
+        await Promise.all(this.handles().map((handle) => handle.revalidate()));
+    }
+    confirm(identity, held = true) {
+        const previous = this.confirmed;
+        if (held || previous === undefined)
+            this.confirmed = identity;
+        if (previous === undefined ||
+            replicaScopeKey(replicaScopeOf(previous)) ===
+                replicaScopeKey(replicaScopeOf(identity)))
+            return;
+        void this.revalidate();
+    }
+    composition() {
+        this.compositionIndex ??= compositionFromSchema(completeSchema(this.options.schema));
+        return this.compositionIndex;
+    }
+    clientOperations() {
+        this.operations ??= installClientOperations(this.options.schema, completeSchema(this.options.schema));
+        return this.operations;
+    }
+    mutationContext() {
+        return {
+            databaseOperations: () => this.clientOperations().database,
+            selfOperations: (focus) => selfOperationsFor(this.clientOperations(), this.composition(), focus),
+            catalog: () => this.catalog(),
+            storage: () => this.storage(),
+            assertLive: (operation) => this.assertLive(operation),
+            submit: (receiver) => this.submissions().request(receiver),
+            applied: (receiver) => this.observeLayers(replicaDatabaseKey(receiver)),
+            track: (receiver, driver) => this.submissions().track(receiver, driver),
+            untrack: (driver) => this.submissions().untrack(driver.receipt.invocation),
+        };
+    }
+    observeLayers(database) {
+        if (this.terminal !== undefined)
+            return;
+        for (const handle of this.handleByKey(database)) {
+            void handle.refreshOptimistic();
+        }
+    }
+    closeSubmissions() {
+        this.submissionLoop?.close();
+    }
+    elect(identity) {
+        if (this.terminal !== undefined)
+            return;
+        const scope = replicaScopeOf(identity);
+        const name = replicaLeaderKey(replicaDatabaseScopeOf(identity), this.storageName());
+        if (this.leaderName === name)
+            return;
+        this.leaderName = name;
+        const stood = this.leadership;
+        if (stood !== undefined)
+            void stood.release();
+        const leadership = SyncLeadership.begin({
+            name,
+            locks: platformLocks(),
+            claim: async () => (await this.storage()).claimLeadership(name, scope),
+            onLeading: () => {
+                if (this.terminal === undefined)
+                    this.submissions().request(scope);
+            },
+        });
+        this.leadership = leadership;
+        this.releaseInvalidation?.();
+        this.releaseInvalidation = undefined;
+        void this.storage().then((storage) => {
+            const release = storage.onInvalidated(() => void leadership.release());
+            if (this.leadership === leadership)
+                this.releaseInvalidation = release;
+            else
+                release();
+        }, () => undefined);
+    }
+    submissions() {
+        this.submissionLoop ??= new SubmissionLoop({
+            storage: () => this.storage(),
+            leadership: () => this.leadership,
+            credential: () => this.credential(),
+            endpoint: (receiver, credential) => this.endpointFor(receiver, credential),
+            resolve: (receiver) => this.resolveReceiver(receiver),
+            retire: (receiver) => this.retireReceiver(receiver),
+            revalidate: () => this.revalidate(),
+            reconcile: async (receiver, progress) => {
+                await this.databaseFor(receiver)?.reconcileSubmissions(progress);
+            },
+            live: () => this.terminal === undefined,
+        });
+        return this.submissionLoop;
+    }
+    resolveReceiver(receiver) {
+        if (this.terminal !== undefined)
+            return;
+        this.databaseFor(receiver)?.reactivateOffline();
+    }
+    retireReceiver(_receiver) { }
+    databaseFor(receiver) {
+        const root = this.root;
+        const scope = root?.confirmedScope();
+        return scope !== undefined &&
+            replicaDatabaseKey(scope) === replicaDatabaseKey(receiver)
+            ? root
+            : undefined;
+    }
+    endpointFor(receiver, credential) {
+        const handle = this.databaseFor(receiver);
+        if (handle === undefined)
+            return undefined;
+        if (!handle.authenticatedBy(credential))
+            return undefined;
+        const fenced = fencedReceiver(handle.syncStatus());
+        if (fenced !== undefined)
+            return undefined;
+        return {
+            origin: this.server,
+            database: this.options.database,
+            credential: credential.token,
+        };
+    }
+    assertLive(operation) {
+        if (this.terminal !== undefined) {
+            throw new ClientClosedError({ operation, reason: this.terminal });
+        }
+    }
+    catalog() {
+        this.catalogBuild ??= installClientCatalog(this.options.schema, this.clientOperations().installed);
+        return this.catalogBuild;
+    }
+    storageName() {
+        return this.options.storageName ?? DEFAULT_REPLICA_DATABASE_NAME;
+    }
+    storage() {
+        this.storageHandle ??= IndexedDbReplicaStorage.open(this.storageName())
+            .then((storage) => {
+            if (this.terminal !== undefined)
+                return storage;
+            this.releaseNotices = storage.notices((notice) => this.receive(notice));
+            this.releaseActivation ??= observeActivation(() => this.wake());
+            return storage;
+        });
+        return this.storageHandle;
+    }
+    async credential() {
+        const credential = await this.options.auth();
+        if (credential === null || typeof credential !== "object" ||
+            !nonEmpty(credential.token) || !nonEmpty(credential.cacheKey)) {
+            throw new ClientConfigurationError({
+                message: "auth() must return { token, cacheKey } as non-empty strings",
+            });
+        }
+        return { token: credential.token, cacheKey: credential.cacheKey };
+    }
+    refreshSync() {
+        if (this.terminal !== undefined) {
+            this.syncStore.publish(syncState("closed"));
+            return;
+        }
+        const statuses = this.root === undefined ? [] : [this.root.syncStatus()];
+        this.syncStore.publish(syncState(aggregateSyncStatus(statuses)));
+    }
+    async close() {
+        await this.terminate("closed");
+    }
+    async clearLocalData() {
+        this.assertLive("clearLocalData");
+        if (this.confirmed === undefined)
+            await this.confirmScope();
+        const identity = this.confirmed;
+        if (identity === undefined) {
+            throw new ClientLocalDataError({ reason: "no-confirmed-scope" });
+        }
+        const storage = await this.storage();
+        this.clearing = true;
+        try {
+            await storage.clearScope(replicaScopeOf(identity));
+        }
+        catch (cause) {
+            this.clearing = false;
+            throw new ClientLocalDataError({ reason: "storage", cause });
+        }
+        await this.terminate("cleared");
+    }
+    async confirmScope() {
+        const root = this.rootHandle();
+        void root.activate();
+        if (settled(root.sync.getSnapshot().status))
+            return;
+        await new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                stop();
+                resolve();
+            }, SCOPE_CONFIRMATION_TIMEOUT_MS);
+            const release = root.sync.subscribe(() => {
+                if (!settled(root.sync.getSnapshot().status))
+                    return;
+                stop();
+                resolve();
+            });
+            const stop = () => {
+                clearTimeout(timer);
+                release();
+            };
+            if (settled(root.sync.getSnapshot().status)) {
+                stop();
+                resolve();
+            }
+        });
+    }
+    async terminate(reason) {
+        this.termination ??= this.shutdown(reason);
+        await this.termination;
+    }
+    async shutdown(reason) {
+        this.terminal = reason;
+        this.lifetime.abort();
+        this.releaseActivation?.();
+        this.releaseActivation = undefined;
+        this.releaseNotices?.();
+        this.releaseNotices = undefined;
+        this.releaseInvalidation?.();
+        this.releaseInvalidation = undefined;
+        this.closeSubmissions();
+        await this.submissionLoop?.settled();
+        await this.leadership?.release();
+        await this.root?.close();
+        await this.storageHandle?.then((storage) => storage.close(), () => undefined);
+        this.syncStore.publish(syncState("closed"));
+    }
+}
+/**
+ * Bind one server, one configured database route, one named schema, and one
+ * refreshable credential provider.
+ *
+ * @throws ClientConfigurationError when any of them cannot be bound. None of
+ * these become valid later, so they fail here rather than at the first query.
+ */
+export const createClient = (options) => {
+    if (!nonEmpty(options?.database)) {
+        throw new ClientConfigurationError({
+            message: "createClient needs a configured database route",
+        });
+    }
+    if (!isSchemaDefinition(options.schema)) {
+        throw new ClientConfigurationError({
+            message: "createClient needs a named Ramose schema",
+        });
+    }
+    if (typeof options.auth !== "function") {
+        throw new ClientConfigurationError({
+            message: "createClient needs an auth() provider returning { token, cacheKey }",
+        });
+    }
+    let server;
+    try {
+        server = replicationActivationAddress({
+            server: options.url,
+            root: options.database,
+        }).origin;
+    }
+    catch (cause) {
+        throw new ClientConfigurationError({
+            message: cause instanceof Error ? cause.message : String(cause),
+        });
+    }
+    return new RamoseClient(options, server);
+};
+//# sourceMappingURL=client.js.map