@mdbase-dev/sdk 0.0.0-stage → 0.1.0-beta.149

package/dist/application/readiness.js

@@ -0,0 +1,223 @@
+import { describeError } from "../describe-error.js";
+import { isMdbaseError } from "../errors.js";
+import { createAppCollectionReadiness } from "../app-host/collection-readiness.js";
+const GATING = ["configuration", "files"], ADVISORY = ["people", "notifications"];
+export class ApplicationReadinessError extends Error {
+    code;
+    detail;
+    constructor(code, detail) {
+        super("SDK application readiness unavailable");
+        this.code = code;
+        this.detail = detail;
+        this.name = "ApplicationReadinessError";
+    }
+}
+const empty = (code, checking = false, detail) => Object.freeze({ checking, assessment: null, problem: code ? Object.freeze({ code, ...(detail ? { detail } : {}) }) : null });
+function nativeFacet(value) {
+    const convert = (problem) => problem ? Object.freeze({ code: `readiness_${problem.reason}`, ...(problem.detail ? { detail: problem.detail } : {}) }) : null;
+    const problem = convert(value.problem);
+    const types = value.assessment?.unavailableTypes;
+    return Object.freeze({ checking: value.checking, assessment: value.assessment ? Object.freeze({ status: value.assessment.status, problem: convert(value.assessment.problem),
+            ...(types?.length ? { unavailableTypes: types } : {}) }) : null, problem });
+}
+/** Aggregate semantic evidence is SDK-owned. A compiler/transport/setup receipt
+ * or a subset of successful facets never substitutes for current native witness.
+ * Refresh sequences borrowed CONTROL facets; caller abort fences delivery only. */
+export class ApplicationReadiness {
+    connection;
+    signal;
+    observed;
+    native;
+    sources;
+    listeners = new Set();
+    stops = [];
+    pending = null;
+    closing = null;
+    checking = false;
+    closed = false;
+    /** People and notifications refreshing after the gating facets (P5). */
+    advisory = Promise.resolve();
+    /** The last settled aggregate of this connection, kept while it is re-checked. */
+    lastReady = null;
+    constructor(options) {
+        this.connection = options.connection;
+        this.signal = options.signal;
+        this.observed = options.isCurrent;
+        this.sources = Object.freeze({ configuration: options.configuration, files: options.files, people: options.people, notifications: options.notifications });
+        this.native = options.nativeRequirements ? createAppCollectionReadiness(this.connection.records, options.nativeRequirements, { collection: this.connection.id, generation: this.connection.generation, signal: this.signal, isCurrent: () => this.current() }) : null;
+        if (this.native)
+            this.stops.push(this.native.subscribe(this.changed));
+        for (const source of Object.values(this.sources))
+            if (source)
+                this.stops.push(source.subscribe(this.changed));
+        this.signal.addEventListener("abort", this.abort, { once: true });
+    }
+    fenceDetail() {
+        try {
+            if (this.signal.aborted)
+                return "scope_aborted";
+            if (this.closed)
+                return "scope_closed";
+            if (this.observed() !== true)
+                return "observer_not_current";
+            if (!this.connection.isCurrent())
+                return "connection_not_current";
+            if (this.connection.records.collection !== this.connection.id)
+                return "collection_mismatch";
+            return null;
+        }
+        catch {
+            return "currentness_check_failed";
+        }
+    }
+    current() { return this.fenceDetail() === null; }
+    /** The retained connection may stop being current because its native session
+     * ended. Keep the typed closing reason while this scope's lifetime is still
+     * live; never replace it with the generic fencing/busy placeholder. */
+    connectionProblem() {
+        if (!this.closed && !this.signal.aborted && this.connection.records.collection === this.connection.id && this.connection.records.link === "closed") {
+            const error = this.connection.records.linkProblem;
+            if (isMdbaseError(error)) {
+                const described = describeError(error);
+                return described && described.key !== "unknown" ? described.key : error.code;
+            }
+        }
+        return "readiness_fenced";
+    }
+    changed = () => { for (const listener of [...this.listeners])
+        try {
+            listener();
+        }
+        catch { /* observers do not own evidence */ } };
+    abort = () => { void this.close().catch(() => { }); };
+    subscribe(listener) { this.listeners.add(listener); return () => { this.listeners.delete(listener); }; }
+    getSnapshot() {
+        const current = this.current(), unsupported = empty(current ? "readiness_unsupported" : "readiness_fenced");
+        let native = unsupported;
+        if (current && this.native) {
+            const value = this.native.getSnapshot(), witness = value.assessment?.witness;
+            const detail = witness && witness.collection !== this.connection.id ? "native_witness_collection_mismatch" : witness && witness.generation !== this.connection.generation ? "native_witness_generation_mismatch" : null;
+            native = detail ? empty("readiness_fenced", false, detail) : nativeFacet(value);
+        }
+        const read = (name) => {
+            if (!current)
+                return unsupported;
+            const source = this.sources[name];
+            if (!source)
+                return empty(`${name}_unsupported`);
+            try {
+                const value = source.getSnapshot();
+                return Object.freeze({ checking: value.checking, assessment: value.assessment ? Object.freeze({ ...value.assessment, problem: value.assessment.problem ? Object.freeze({ ...value.assessment.problem }) : null }) : null, problem: value.problem ? Object.freeze({ ...value.problem }) : null });
+            }
+            catch {
+                return empty(`${name}_unavailable`);
+            }
+        };
+        const facets = Object.freeze({ capabilities: native, contracts: native, configuration: read("configuration"), files: read("files"), people: read("people"), notifications: read("notifications") });
+        // Notifications and people are advisory: an app opens with reminders off
+        // (Connect's approval lets the person leave them off) and reads
+        // facets.notifications to offer turning them on; people (members, the
+        // signed-in person) load after the collection is ready and report through
+        // facets.people. Neither gates READY or the aggregate problem (P5).
+        const values = [facets.capabilities, facets.contracts, facets.configuration, facets.files], checking = current && (this.checking || values.some(value => value.checking));
+        let assessment = null, problem = null;
+        if (!current)
+            problem = Object.freeze({ code: "readiness_fenced" });
+        else if (!checking) {
+            const failed = ["capabilities", "contracts", ...GATING].find(name => facets[name].problem);
+            problem = failed ? facets[failed].problem : null;
+            if (failed && problem?.code === "readiness_fenced" && !problem.detail)
+                problem = Object.freeze({ ...problem, detail: `${failed}_facet` });
+            if (values.every(value => value.assessment !== null)) {
+                const incompatible = values.find(value => value.assessment?.status === "incompatible"), setup = values.find(value => value.assessment?.status === "setup_required"), selected = incompatible ?? setup;
+                const types = native.assessment?.unavailableTypes;
+                assessment = Object.freeze({ status: incompatible ? "incompatible" : setup ? "setup_required" : "ready", problem: selected?.assessment?.problem ?? null, ...(types?.length ? { unavailableTypes: types } : {}) });
+            }
+        }
+        // Source getters/observers can synchronously retire the connection.
+        const detail = this.fenceDetail();
+        if (detail) {
+            this.lastReady = null;
+            return Object.freeze({ checking: false, assessment: null, problem: Object.freeze({ code: this.connectionProblem(), detail }), facets: Object.freeze({ capabilities: empty("readiness_fenced", false, detail), contracts: empty("readiness_fenced", false, detail), configuration: empty("readiness_fenced", false, detail), files: empty("readiness_fenced", false, detail), people: empty("readiness_fenced", false, detail), notifications: empty("readiness_fenced", false, detail) }) });
+        }
+        // A collection that was READY stays READY while a change (this device's or
+        // another's) is re-checked: re-checks and concurrent-change retries are not
+        // problems. A settled non-ready assessment or any other problem replaces it.
+        // Every operation is still checked by the replica itself.
+        // A settled non-ready assessment is kept the same way through background
+        // facet re-checks, but not through an explicit refresh (an action re-checking).
+        const transient = !problem || /_(changed|busy)$/.test(problem.code);
+        if (problem === null && assessment !== null && !checking)
+            this.lastReady = Object.freeze({ checking, assessment, problem, facets });
+        else if (this.lastReady && transient && (checking || assessment === null) && (this.lastReady.assessment?.status === "ready" || !this.checking))
+            return Object.freeze({ ...this.lastReady, facets });
+        else
+            this.lastReady = null;
+        return Object.freeze({ checking, assessment, problem, facets });
+    }
+    refresh(options = {}) {
+        const caller = options.signal;
+        const detail = this.fenceDetail() ?? (caller?.aborted ? "caller_aborted" : null);
+        if (detail)
+            return Promise.reject(new ApplicationReadinessError("application_readiness_fenced", detail));
+        if (this.pending)
+            return Promise.reject(new ApplicationReadinessError("application_readiness_busy"));
+        this.checking = true;
+        const pending = Promise.resolve().then(async () => {
+            if (!this.current())
+                return this.getSnapshot();
+            // Advisory facets from the previous refresh still hold the control slot.
+            await this.advisory;
+            if (this.native)
+                await this.native.start();
+            // Gating facets one at a time (one native control slot); advisory facets
+            // (people, notifications) after them, outside `checking` (P5).
+            for (const name of GATING) {
+                const source = this.sources[name];
+                if (!this.current())
+                    break;
+                if (source)
+                    await source.refresh(); // original lifetime READ, no caller cancellation loan
+            }
+            return this.getSnapshot();
+        }).finally(() => {
+            if (this.pending !== pending)
+                return;
+            this.pending = null;
+            this.checking = false;
+            const advisory = (async () => { for (const name of ADVISORY) {
+                const source = this.sources[name];
+                if (!this.current())
+                    break;
+                if (source)
+                    await source.refresh().catch(() => { });
+            } })();
+            this.advisory = advisory;
+            this.changed();
+        }).then(() => this.getSnapshot());
+        this.pending = pending;
+        this.changed();
+        return pending.then(value => { const detail = this.fenceDetail() ?? (caller?.aborted ? "caller_aborted" : null); if (detail)
+            throw new ApplicationReadinessError("application_readiness_fenced", detail); return value; });
+    }
+    close() {
+        if (this.closing)
+            return this.closing;
+        this.closed = true;
+        this.checking = false;
+        this.signal.removeEventListener("abort", this.abort);
+        this.closing = Promise.resolve().then(async () => {
+            for (const stop of this.stops.splice(0))
+                stop();
+            for (const source of Object.values(this.sources))
+                await source?.close();
+            await this.native?.close();
+            await this.pending?.catch(() => { });
+            await this.advisory;
+            this.listeners.clear();
+        });
+        this.changed();
+        return this.closing;
+    }
+}
+//# sourceMappingURL=readiness.js.map

package/dist/application/readiness.js.map

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

package/dist/application/registration-refusal.d.ts

@@ -0,0 +1,16 @@
+/** The typed part of a CP application-registration refusal: its code and at most a
+ * few JSON-pointer paths into the app's own manifest. Never the server message,
+ * URLs or other text. No network, Worker or wasm imports. */
+export interface RegistrationRefusal {
+    readonly code: string;
+    readonly paths: readonly string[];
+}
+/** Bytes read from a refusal body; anything larger is treated as untyped. */
+export declare const REGISTRATION_REFUSAL_MAX_BYTES = 8192;
+/** `{error: {code, details: {issues: [{path}]}}}` (CP `apiError`), or an already
+ * sanitized refusal (object, or the `MdbaseError.details` map); null for anything
+ * else. Never throws. */
+export declare function registrationRefusal(value: unknown): RegistrationRefusal | null;
+/** Plain copy for app developers, e.g. "This app's registration was rejected
+ * (invalid manifest: /homepage, /icon)." */
+export declare function registrationRefusalMessage(refusal: RegistrationRefusal | null): string;

package/dist/application/registration-refusal.js

@@ -0,0 +1,41 @@
+/** Bytes read from a refusal body; anything larger is treated as untyped. */
+export const REGISTRATION_REFUSAL_MAX_BYTES = 8192;
+const MAX_PATHS = 5;
+const CODE = /^[a-z][a-z0-9_]{0,63}$/;
+const POINTER = /^(?:\/[A-Za-z0-9_-]{1,64}){1,6}$/;
+const obj = (v) => v !== null && typeof v === "object" && !Array.isArray(v) ? v : null;
+/** `{error: {code, details: {issues: [{path}]}}}` (CP `apiError`), or an already
+ * sanitized refusal (object, or the `MdbaseError.details` map); null for anything
+ * else. Never throws. */
+export function registrationRefusal(value) {
+    try {
+        if (value instanceof Map)
+            value = { code: value.get("code"), paths: value.get("paths") };
+        const o = obj(value), error = obj(o?.error) ?? o;
+        const code = error?.code;
+        if (typeof code !== "string" || !CODE.test(code))
+            return null;
+        const issues = obj(error.details)?.issues;
+        const candidates = Array.isArray(error.paths) ? error.paths : Array.isArray(issues) ? issues.slice(0, 64).map((issue) => obj(issue)?.path) : [];
+        const paths = [];
+        for (const path of candidates.slice(0, 64)) {
+            if (typeof path === "string" && POINTER.test(path) && !paths.includes(path))
+                paths.push(path);
+            if (paths.length === MAX_PATHS)
+                break;
+        }
+        return Object.freeze({ code, paths: Object.freeze(paths) });
+    }
+    catch {
+        return null; /* hostile getters never replace the refusal */
+    }
+}
+/** Plain copy for app developers, e.g. "This app's registration was rejected
+ * (invalid manifest: /homepage, /icon)." */
+export function registrationRefusalMessage(refusal) {
+    if (!refusal)
+        return "This app's registration was rejected by mdbase.";
+    const label = refusal.code === "invalid_application_manifest" ? "invalid manifest" : refusal.code.replaceAll("_", " ");
+    return `This app's registration was rejected (${label}${refusal.paths.length ? `: ${refusal.paths.join(", ")}` : ""}).`;
+}
+//# sourceMappingURL=registration-refusal.js.map

package/dist/application/registration-refusal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registration-refusal.js","sourceRoot":"","sources":["../../src/application/registration-refusal.ts"],"names":[],"mappings":"AAQA,6EAA6E;AAC7E,MAAM,CAAC,MAAM,8BAA8B,GAAG,IAAI,CAAC;AACnD,MAAM,SAAS,GAAG,CAAC,CAAC;AACpB,MAAM,IAAI,GAAG,wBAAwB,CAAC;AACtC,MAAM,OAAO,GAAG,kCAAkC,CAAC;AACnD,MAAM,GAAG,GAAG,CAAC,CAAU,EAAkC,EAAE,CACzD,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAA4B,CAAC,CAAC,CAAC,IAAI,CAAC;AAEjG;;yBAEyB;AACzB,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IAAI,CAAC;QACH,IAAI,KAAK,YAAY,GAAG;YAAE,KAAK,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QACzF,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,KAAK,EAAE,IAAI,CAAC;QACzB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAC9D,MAAM,MAAM,GAAG,GAAG,CAAC,KAAM,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAC3C,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,KAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAClJ,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;YAC3C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9F,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;gBAAE,MAAM;QACxC,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,CAAC,+CAA+C;IAC9D,CAAC;AACH,CAAC;AAED;4CAC4C;AAC5C,MAAM,UAAU,0BAA0B,CAAC,OAAmC;IAC5E,IAAI,CAAC,OAAO;QAAE,OAAO,iDAAiD,CAAC;IACvE,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,KAAK,8BAA8B,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACvH,OAAO,yCAAyC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;AAC1H,CAAC"}

package/dist/application/registration.d.ts

@@ -0,0 +1,26 @@
+import { type MdbaseApplicationDeclaration } from "./declaration.js";
+export interface ApplicationRegistrationOptions {
+    readonly declaration: Readonly<MdbaseApplicationDeclaration>;
+    readonly signal: AbortSignal;
+    isCurrent(): boolean;
+    readonly fetch?: typeof fetch;
+}
+export interface ApplicationRegistration {
+    readonly id: string;
+    readonly name: string;
+    readonly manifestDigest: string;
+    /** Set when the declaration named an application UUID and the CP registered
+     * this exact manifest under a different one (a changed manifest gets a new
+     * UUID). The registered `id` is used; the declared one is kept here only for
+     * the developer note. */
+    readonly supersededDeclaredId?: string;
+}
+export declare function manifestDigest(manifest: unknown): Promise<string>;
+/** SDK-internal public metadata resolution, BEFORE Worker/DB/key allocation.
+ * The sole retry exception is the exact immutable register upsert: CP uniqueness
+ * preserves the same application row and reconciliation job for identical body
+ * bytes. This does not authorize retrying enrollment/create/other unknown writes.
+ * No app-supplied endpoint, trust or storage rebinding. P5: a verified receipt
+ * is remembered per CP origin and canonical manifest digest, so a warm open
+ * registers only when the manifest changed (the CP binds the id to the digest). */
+export declare function resolveApplicationRegistration(input: ApplicationRegistrationOptions): Promise<Readonly<ApplicationRegistration>>;