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

package/dist/application/people-readiness.js

@@ -0,0 +1,213 @@
+import { collectionPeopleDto } from "../app-host/collection-people.js";
+import { mdbaseError } from "../errors.js";
+const snapshot = (code, checking = false) => Object.freeze({
+    checking,
+    assessment: null,
+    problem: code === null ? null : Object.freeze({ code }),
+});
+const fenced = snapshot("people_fenced");
+const ready = Object.freeze({
+    checking: false,
+    assessment: Object.freeze({ status: "ready", problem: null }),
+    problem: null,
+});
+const cancelled = () => mdbaseError("cancelled", "People readiness ended", "people_readiness_fenced");
+function profile(row) {
+    return {
+        issuer: row.issuer,
+        subject: row.subject,
+        name: row.name,
+        ...(row.accountId === undefined ? {} : { account_id: row.accountId }),
+    };
+}
+/** Mandatory launch account/member metadata facet. Sequential READs on the SAME
+ * public People client, not directory()/native Person or author inference.
+ * Reuse the bounded metadata DTO validator; never retain names/IDs in snapshots.
+ * Caller cancellation fences delivery while the original assessment/READ remains
+ * occupied. Close releases only owned listeners, never the borrowed authority. */
+export function createApplicationPeopleReadiness(input) {
+    const scope = input.scope, account = scope.account, installation = scope.installation, collection = scope.collection;
+    const generation = input.generation, lifetime = input.signal, people = input.people;
+    const isCurrent = input.isCurrent.bind(input);
+    const readCurrent = typeof people?.current === "function"
+        ? people.current.bind(people)
+        : undefined;
+    const readMembers = typeof people?.members === "function"
+        ? people.members.bind(people)
+        : undefined;
+    const listeners = new Set();
+    let value = snapshot(null), closed = false, started = false;
+    let pending = null;
+    function current() {
+        try {
+            if (closed || lifetime.aborted || isCurrent() !== true)
+                return false;
+            return (!closed &&
+                !lifetime.aborted &&
+                input.scope === scope &&
+                input.generation === generation &&
+                input.signal === lifetime &&
+                input.people === people &&
+                !!generation &&
+                generation.length <= 256 &&
+                [account, installation, collection].every((id) => typeof id === "string" && !!id && id.length <= 128) &&
+                scope.account === account &&
+                scope.installation === installation &&
+                scope.collection === collection);
+        }
+        catch {
+            return false;
+        }
+    }
+    function publish(next) {
+        value = current() ? next : fenced;
+        for (const listener of [...listeners]) {
+            try {
+                listener();
+            }
+            catch {
+                /* content-free */
+            }
+        }
+        if (!current())
+            value = fenced;
+    }
+    function getSnapshot() {
+        if (!current())
+            value = fenced;
+        return value;
+    }
+    function close() {
+        if (closed)
+            return;
+        closed = true;
+        lifetime.removeEventListener("abort", close);
+        value = fenced;
+        for (const listener of [...listeners]) {
+            try {
+                listener();
+            }
+            catch {
+                /* owned listeners only */
+            }
+        }
+        listeners.clear(); // pending remains occupied until its original READ settles
+    }
+    lifetime.addEventListener("abort", close, { once: true });
+    if (lifetime.aborted)
+        close();
+    function deliver(work, signal) {
+        if (!current() || signal?.aborted)
+            return Promise.reject(cancelled());
+        return new Promise((resolve, reject) => {
+            let settled = false;
+            const finish = (result, error) => {
+                if (settled)
+                    return;
+                settled = true;
+                signal?.removeEventListener("abort", abort);
+                lifetime.removeEventListener("abort", abort);
+                listeners.delete(ended);
+                if (error !== undefined)
+                    reject(error);
+                else
+                    resolve(result);
+            };
+            const abort = () => finish(undefined, cancelled()), ended = () => {
+                if (!current())
+                    abort();
+            };
+            listeners.add(ended);
+            signal?.addEventListener("abort", abort, { once: true });
+            lifetime.addEventListener("abort", abort, { once: true });
+            work.then(() => {
+                if (!current() || signal?.aborted)
+                    abort();
+                else
+                    finish(getSnapshot());
+            }, () => finish(undefined, cancelled()));
+            if (!current() || signal?.aborted)
+                abort();
+        });
+    }
+    function refresh(options = {}) {
+        const signal = options.signal;
+        if (!current() || signal?.aborted)
+            return Promise.reject(cancelled());
+        if (pending)
+            return Promise.reject(mdbaseError("unavailable", "People readiness READ is occupied", "people_readiness_busy"));
+        const work = Promise.resolve().then(async () => {
+            if (!current())
+                return fenced;
+            if (!readCurrent || !readMembers)
+                return snapshot("people_unsupported");
+            try {
+                const identity = await readCurrent({ signal: lifetime });
+                if (!current())
+                    return fenced;
+                collectionPeopleDto("identity", {
+                    ...profile(identity),
+                    ...(identity.personSettingsUrl === undefined
+                        ? {}
+                        : { person_settings_url: identity.personSettingsUrl }),
+                });
+                if (!current())
+                    return fenced;
+                const members = await readMembers({ signal: lifetime });
+                if (!current())
+                    return fenced;
+                if (!Array.isArray(members) || members.length > 1000)
+                    return snapshot("people_response");
+                collectionPeopleDto("members", {
+                    members: Array.from(members, (row) => ({
+                        ...profile(row),
+                        role: row.role,
+                    })),
+                });
+                if (!current())
+                    return fenced;
+                return ready;
+            }
+            catch {
+                return snapshot(current() ? "people_unavailable" : "people_fenced");
+            }
+        });
+        pending = work;
+        publish(snapshot(null, true));
+        const settled = work
+            .then((result) => {
+            publish(result);
+            return getSnapshot();
+        }, () => {
+            publish(snapshot("people_unavailable"));
+            return getSnapshot();
+        })
+            .finally(() => {
+            if (pending === work)
+                pending = null;
+        });
+        return deliver(settled, signal);
+    }
+    return Object.freeze({
+        getSnapshot,
+        subscribe(listener) {
+            if (closed)
+                return () => { };
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+        start(options = {}) {
+            if (started)
+                return deliver(pending ?? Promise.resolve(getSnapshot()), options.signal);
+            if (!current() || options.signal?.aborted)
+                return Promise.reject(cancelled());
+            started = true;
+            return refresh(options);
+        },
+        refresh,
+        close,
+    });
+}
+//# sourceMappingURL=people-readiness.js.map

package/dist/application/people-readiness.js.map

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

package/dist/application/phase.d.ts

@@ -0,0 +1,108 @@
+/**
+ * The one derived state model (R1). `applicationPhase` maps the raw snapshot
+ * (sign-in status, selection, readiness) to a single phase, so the shared UI
+ * and apps never hand-roll a "ready" check. Pure: no IO, timers or globals.
+ *
+ * Rules:
+ * - `ready` needs a current connection for the usable collection; without one
+ *   the collection is still `opening`.
+ * - Once `ready`, a collection stays `ready` through re-checks, busy/changed
+ *   results and other transient problems (`rechecking`, `problem` carry them).
+ *   Only a settled non-ready outcome (setup needed, incompatible, approval
+ *   lost), a durable problem, or a different/cleared selection replaces it.
+ */
+import { type MdbaseErrorDescription } from "../describe-error.js";
+import type { ApplicationApprovalOutcome } from "./collection-selection.js";
+import type { AppInstallationCollection } from "../app-host/installation-sign-in.js";
+import type { MdbaseApplicationConnection, MdbaseApplicationSnapshot, MdbaseUnavailableType } from "./entry.js";
+/** A described problem: plain copy plus one typed action (see describeError). */
+export type MdbaseProblem = MdbaseErrorDescription;
+/** One collection this app may open, as listed in `snapshot.collections`. */
+export type MdbaseCollectionSummary = AppInstallationCollection;
+/** SDK-6: how the last `approve()` ended (`added`, `unchanged`, `declined`, `closed`). */
+export type MdbaseApprovalOutcome = ApplicationApprovalOutcome;
+export type MdbasePhase = 
+/** The SDK is starting: show the app's wordmark or the cached list. */
+{
+    readonly kind: "starting";
+}
+/** Not signed in. `notice` explains why when sign-in just ended (window closed, signed out). */
+ | {
+    readonly kind: "signed_out";
+    readonly notice: MdbaseProblem | null;
+}
+/** Waiting for the Connect window: sign in, add a collection or approve one. */
+ | {
+    readonly kind: "authorizing";
+    readonly purpose: "sign_in" | "add" | "approve";
+    readonly collectionId: string | null;
+}
+/** Signed in, nothing open: choose from `snapshot.collections` or add one. */
+ | {
+    readonly kind: "choosing";
+    readonly lastApproval: MdbaseApprovalOutcome | null;
+}
+/** SDK-9: `slow` turns on when opening takes longer than usual. */
+ | {
+    readonly kind: "opening";
+    readonly collectionId: string;
+    readonly displayName: string | null;
+    readonly slow: boolean;
+    readonly progress?: import("../app-host/opening-progress.js").AppOpeningProgress | null;
+}
+/** The requested collection is not approved for this app (yet). */
+ | {
+    readonly kind: "needs_approval";
+    readonly collectionId: string;
+    readonly displayName: string | null;
+    readonly declined: boolean;
+}
+/** Open, but needs a one-time setup: `setup.plan()` then `setup.apply(plan)`. */
+ | {
+    readonly kind: "needs_setup";
+    readonly collectionId: string;
+    readonly collection: MdbaseCollectionSummary;
+}
+/** Open and usable. `rechecking` and `problem` are informational only. */
+ | {
+    readonly kind: "ready";
+    readonly collectionId: string;
+    readonly collection: MdbaseCollectionSummary;
+    readonly connection: MdbaseApplicationConnection;
+    readonly rechecking: boolean;
+    readonly problem: MdbaseProblem | null;
+    readonly unavailableTypes: readonly MdbaseUnavailableType[];
+}
+/** Can't continue: show `problem` with its action. */
+ | {
+    readonly kind: "problem";
+    readonly collectionId: string | null;
+    readonly problem: MdbaseProblem;
+}
+/** The SDK can't run here (SSR, Node, an unsupported browser). */
+ | {
+    readonly kind: "unavailable";
+    readonly problem: MdbaseProblem;
+} | {
+    readonly kind: "closed";
+};
+export type MdbasePhaseKind = MdbasePhase["kind"];
+/** Opening longer than this reads `slow` (SDK-9). */
+export declare const SLOW_OPENING_MS = 15000;
+export interface ApplicationPhaseOptions {
+    /** The connection for the usable collection (entry.connection(id)). */
+    readonly connection?: MdbaseApplicationConnection | null;
+    /** The previous phase: keeps `ready` through transient states. */
+    readonly previous?: MdbasePhase | null;
+    /** Set when the current opening has lasted SLOW_OPENING_MS. */
+    readonly slow?: boolean;
+    readonly cpOrigin?: string;
+}
+type Snapshot = Pick<MdbaseApplicationSnapshot, "status" | "signIn" | "collections" | "selectedCollectionId" | "problem" | "readiness" | "selection"> & Partial<Pick<MdbaseApplicationSnapshot, "problemDetail" | "removedScopeIds" | "recoveryAccountLabel" | "openingProgress">>;
+/** Derive the phase of a public application snapshot. */
+export declare function applicationPhase(s: Snapshot, options?: ApplicationPhaseOptions): MdbasePhase;
+/** True when the phase is ready for this collection with a current connection. */
+export declare function isReadyPhase(phase: MdbasePhase | null | undefined, collectionId?: string): phase is Extract<MdbasePhase, {
+    kind: "ready";
+}>;
+export {};

package/dist/application/phase.js

@@ -0,0 +1,113 @@
+/**
+ * The one derived state model (R1). `applicationPhase` maps the raw snapshot
+ * (sign-in status, selection, readiness) to a single phase, so the shared UI
+ * and apps never hand-roll a "ready" check. Pure: no IO, timers or globals.
+ *
+ * Rules:
+ * - `ready` needs a current connection for the usable collection; without one
+ *   the collection is still `opening`.
+ * - Once `ready`, a collection stays `ready` through re-checks, busy/changed
+ *   results and other transient problems (`rechecking`, `problem` carry them).
+ *   Only a settled non-ready outcome (setup needed, incompatible, approval
+ *   lost), a durable problem, or a different/cleared selection replaces it.
+ */
+import { describeError } from "../describe-error.js";
+/** Opening longer than this reads `slow` (SDK-9). */
+export const SLOW_OPENING_MS = 15_000;
+const current = (c, id) => {
+    try {
+        return !!c && c.id === id && c.isCurrent();
+    }
+    catch {
+        return false;
+    }
+};
+const describe = (input, cpOrigin) => describeError(input, cpOrigin ? { cpOrigin } : {});
+const fallback = (code, cpOrigin) => describe(code, cpOrigin);
+/** Derive the phase of a public application snapshot. */
+export function applicationPhase(s, options = {}) {
+    const next = derive(s, options);
+    const phase = hold(next, s, options);
+    return phase.kind === "opening" && s.status === "opening" && s.selectedCollectionId === phase.collectionId && s.openingProgress
+        ? { ...phase, progress: s.openingProgress } : phase;
+}
+function derive(s, o) {
+    const cp = o.cpOrigin, sel = s.selection, requested = sel?.requested ?? null;
+    if (s.status === "closed")
+        return { kind: "closed" };
+    if (s.problem === "application_not_yet_available" || s.problem === "application_worker_unavailable" || s.problem === "browser_unsupported" || s.problem === "application_storage_unavailable")
+        return { kind: "unavailable", problem: fallback(s.problem, cp) };
+    if (sel?.state === "invalid")
+        return { kind: "problem", collectionId: null, problem: fallback(sel.problem ?? "application_selection_invalid", cp) };
+    const paired = s.signIn?.state === "paired";
+    if (sel?.state === "approving" || s.status === "authorizing") {
+        // Signing in shows the sign-in window; a paired session is adding or approving.
+        const approval = sel?.approval ?? null;
+        if (!paired)
+            return { kind: "authorizing", purpose: "sign_in", collectionId: approval?.collectionId ?? requested?.collectionId ?? null };
+        return approval?.kind === "add" ? { kind: "authorizing", purpose: "add", collectionId: null }
+            : { kind: "authorizing", purpose: "approve", collectionId: approval?.collectionId ?? requested?.collectionId ?? null };
+    }
+    if (s.status === "not_started" || s.status === "starting") {
+        // A returning user with a remembered request goes straight to opening (P4).
+        const id = requested?.collectionId ?? null;
+        return id && s.status === "starting" ? { kind: "opening", collectionId: id, displayName: requested?.displayName ?? null, slow: !!o.slow } : { kind: "starting" };
+    }
+    if (s.status === "signed_out")
+        return { kind: "signed_out", notice: s.problem ? describe(s, cp) : null };
+    if (s.status === "blocked") {
+        const id = s.selectedCollectionId ?? requested?.collectionId ?? null;
+        if (s.problem === "recovery_account_mismatch")
+            return { kind: "problem", collectionId: id, problem: describeError(s, { cpOrigin: cp, recoveryAccountLabel: s.recoveryAccountLabel }) };
+        return { kind: "problem", collectionId: id, problem: id && s.removedScopeIds?.includes(id) ? fallback("installation_scope_removed", cp) : describe(s, cp) ?? fallback("open_failed", cp) };
+    }
+    if (sel?.state === "approval_required" && requested?.collectionId && s.removedScopeIds?.includes(requested.collectionId))
+        return { kind: "problem", collectionId: requested.collectionId, problem: fallback("installation_scope_removed", cp) };
+    if (sel?.state === "approval_required" && requested?.collectionId)
+        return { kind: "needs_approval", collectionId: requested.collectionId, displayName: requested.displayName, declined: sel.problem === "application_selection_not_approved" };
+    if (sel?.state === "pending" && requested?.collectionId)
+        return { kind: "opening", collectionId: requested.collectionId, displayName: requested.displayName, slow: !!o.slow };
+    const usable = sel?.usable ?? (s.status === "ready" || s.status === "setup_required" ? s.collections.find(c => c.collectionId === s.selectedCollectionId) ?? null : null);
+    if (s.status === "setup_required" && usable) {
+        // Settled setup outcomes: incompatible collections are problems, not setup.
+        if (s.readiness.assessment?.status === "incompatible")
+            return { kind: "problem", collectionId: usable.collectionId, problem: describe(s.readiness, cp) ?? fallback("incompatible", cp) };
+        return { kind: "needs_setup", collectionId: usable.collectionId, collection: usable };
+    }
+    if (s.status === "ready" && usable && current(o.connection, usable.collectionId)) {
+        return { kind: "ready", collectionId: usable.collectionId, collection: usable, connection: o.connection, rechecking: s.readiness.checking,
+            problem: null, unavailableTypes: s.readiness.assessment?.unavailableTypes ?? [] };
+    }
+    const opening = s.status === "opening" || s.status === "ready" || sel?.state === "opening" || sel?.state === "usable";
+    const id = s.selectedCollectionId ?? requested?.collectionId ?? null;
+    if (opening && id) {
+        const name = s.collections.find(c => c.collectionId === id)?.displayName ?? requested?.displayName ?? null;
+        return { kind: "opening", collectionId: id, displayName: name, slow: !!o.slow };
+    }
+    return { kind: "choosing", lastApproval: sel?.lastApproval ?? null };
+}
+/** Never demote READY for transient states of the SAME open collection. */
+function hold(next, s, o) {
+    const prev = o.previous;
+    // Applying setup re-checks the collection. Keep the setup screen through it,
+    // so the setup review stays mounted and can show the apply's outcome or
+    // failure, rather than an "opening" screen that drops it.
+    if (prev?.kind === "needs_setup" && next.kind === "opening" && next.collectionId === prev.collectionId &&
+        s.selectedCollectionId === prev.collectionId && s.readiness.checking)
+        return prev;
+    if (!prev || prev.kind !== "ready" || next.kind === "ready" || !current(o.connection, prev.collectionId))
+        return next;
+    // The same collection is still the one the session has selected.
+    if (s.selectedCollectionId !== prev.collectionId)
+        return next;
+    if (next.kind === "opening" && next.collectionId === prev.collectionId)
+        return { ...prev, connection: o.connection, rechecking: true, problem: null };
+    if (next.kind === "problem" && next.problem.transient)
+        return { ...prev, connection: o.connection, rechecking: true, problem: next.problem };
+    return next;
+}
+/** True when the phase is ready for this collection with a current connection. */
+export function isReadyPhase(phase, collectionId) {
+    return phase?.kind === "ready" && (collectionId === undefined || phase.collectionId === collectionId);
+}
+//# sourceMappingURL=phase.js.map

package/dist/application/phase.js.map

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

package/dist/application/portal-reservation.d.ts

@@ -0,0 +1,38 @@
+import type { AppWebSignInPortal } from "../app-host/web-sign-in-session.js";
+export declare class ApplicationPortalError extends Error {
+    readonly reason: "application_popup_blocked" | "application_popup_fenced" | "application_popup_binding" | "application_popup_unavailable" | "application_popup_stop_failed";
+    constructor(reason: "application_popup_blocked" | "application_popup_fenced" | "application_popup_binding" | "application_popup_unavailable" | "application_popup_stop_failed");
+}
+/** Private UI port only. Apps reach it solely through the narrower public
+ * `signIn` opener (openerApplicationPortalHost), never directly. */
+export interface ApplicationPopupWindow {
+    navigate(uri: string): void;
+    close(): void;
+    focus?(): void;
+    /** True once the person closed the window. Absent where unknown (openers). */
+    closed?(): boolean;
+}
+export interface ApplicationPortalHost {
+    readonly cpOrigin: string;
+    readonly signal: AbortSignal;
+    readonly allowLoopbackHttp?: boolean;
+    isCurrent(): boolean;
+    /** MUST be synchronous and UI-gesture owned. */
+    open(): ApplicationPopupWindow | null;
+}
+/** Reserve before ANY startup/expiry await. Window lifetime and original caller
+ * remain pinned; this helper neither starts/retries authorization nor owns keys. */
+export declare function reserveApplicationPortal(host: ApplicationPortalHost): AppWebSignInPortal & {
+    readonly closed: boolean;
+    focus(): void;
+};
+/** Default SDK UI adapter. No app callback, browser-runtime or manual URL input. */
+export declare function browserApplicationPortalHost(cpOrigin: string, signal: AbortSignal, isCurrent: () => boolean, allowLoopbackHttp?: boolean): ApplicationPortalHost;
+/** System-browser/extension adapter for the public `signIn` opener. Opening is
+ * deferred to the first CP-bound navigate; opener failures are not retried and
+ * the pairing request persists, so `start()` resumes it in a later context. */
+export declare function openerApplicationPortalHost(cpOrigin: string, signal: AbortSignal, isCurrent: () => boolean, opener: {
+    open(url: string): void | Promise<void>;
+    close?(): void | Promise<void>;
+    readonly returnUrl?: string;
+}, allowLoopbackHttp?: boolean): ApplicationPortalHost;