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

package/dist/private.js

@@ -0,0 +1,69 @@
+/**
+ * Private (end-to-end) collections: device approval (`replica-client-api.md` §8.3) and
+ * the recovery key, offered at setup, skippable, and recommended.
+ *
+ * The recovery-key methods are proposed in the private-collection transport
+ * contract; the replica and control components own their semantics.
+ */
+import { bool, enumOf, struct, tstr, uuid } from "./codec.js";
+import { problem } from "./wire.js";
+/** `device-kind` (policy.md). */
+export const DEVICE_KINDS = ["desktop", "mobile", "app_runtime", "cli", "hosted", "escrow", "recovery"];
+const kinds = enumOf("device-kind", DEVICE_KINDS);
+/** Unknown kinds (a newer control plane) display as "unknown" rather than failing the list. */
+const deviceKind = {
+    name: "device-kind",
+    enc: (v) => kinds.enc(v),
+    dec: (c) => {
+        try {
+            return kinds.dec(c);
+        }
+        catch {
+            return "unknown";
+        }
+    },
+};
+const pendingDeviceShape = struct("pending-device", [
+    [0, "device", uuid],
+    [1, "account", uuid],
+    [2, "kind", deviceKind],
+    [3, "sas", tstr, "opt"], // Host response only; omitted from client encodings.
+    [4, "exchangeReady", bool],
+]);
+export const pendingDevice = {
+    ...pendingDeviceShape,
+    enc: v => pendingDeviceShape.enc({ ...v, sas: undefined }),
+};
+const approvalReadinessShape = struct("approval-readiness", [
+    [0, "device", uuid],
+    [1, "sas", tstr, "opt"], // Reserved: decode-only.
+    [2, "exchangeReady", bool],
+]);
+export const approvalReadiness = {
+    ...approvalReadinessShape,
+    enc: v => approvalReadinessShape.enc({ ...v, sas: undefined }),
+};
+export const recoveryKeyStatus = struct("recovery-key-status", [
+    [0, "configured", bool],
+    [1, "device", uuid, "opt"],
+]);
+export const recoveryKeyCreated = struct("recovery-key-created", [
+    [0, "phrase", tstr],
+    [1, "device", uuid],
+]);
+/** Format either computer's local comparison code, preserving leading zeroes. */
+export function formatSas(sas) {
+    return /^\d{6}$/.test(sas) ? `${sas.slice(0, 3)} ${sas.slice(3)}` : sas;
+}
+// ------------------------------------------------------------------ account key (AK1 §6)
+/**
+ * Where an account-key unlock stands on this replica. `refused` carries the typed
+ * `AccountKeyRefusal` as a problem (`details.reason` is the refusal name).
+ */
+export const ACCOUNT_KEY_STATES = ["idle", "reading_ahead", "pending_grant", "keyed", "refused"];
+export const accountKeyState = enumOf("account-key-state", ACCOUNT_KEY_STATES);
+export const accountKeyStatus = struct("account-key-status", [
+    [0, "state", accountKeyState],
+    [1, "problem", problem, "opt"],
+]);
+//# sourceMappingURL=private.js.map

package/dist/private.js.map

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

package/dist/read-helpers.d.ts

@@ -0,0 +1,32 @@
+import type { MdbaseClient, PagesOptions, Query, RecordRef } from "./client.js";
+import type { Include, QueryResult, RecordView } from "./wire.js";
+export declare const READ_MANY_MAX_REFS = 1000;
+export declare const READ_MANY_MAX_CONCURRENCY = 16;
+export interface ReadManyOptions {
+    /** 1..16 ordinary get calls in flight (default 8). */
+    concurrency?: number;
+}
+/** Ordered ordinary reads, not a transaction or a consistent native snapshot.
+ * Duplicate selections remain separate calls/slots. A failure stops scheduling;
+ * all already-started calls settle before the original error is delivered. */
+export declare function readMany(client: Pick<MdbaseClient, "get">, refs: readonly RecordRef[], include?: Include, signal?: AbortSignal, options?: ReadManyOptions): Promise<RecordView[]>;
+/** Alias the canonical paginator. Preserve whole pages, original opaque cursors,
+ * Include/signal and explicit onReset semantics; never flatten or auto-reset. */
+export declare function queryPages(client: Pick<MdbaseClient, "pages">, query: Query, include?: Include, signal?: AbortSignal, options?: PagesOptions): AsyncGenerator<QueryResult>;
+/** Resolve a persisted flat frontmatter key through ONE ordinary native query.
+ * Raw scalar/list strings retain order, duplicates and display aliases; null
+ * targets mean native unresolved/ambiguous/non-record links, never a Person or
+ * author inference. Missing/null/empty-list fields yield [] only from a validated
+ * complete native projection. Old producers fail unsupported, without fallback.
+ * `isCurrent` may bind an original caller scope/revision; this is not a historical
+ * witness, snapshot subscription, extra READ or replacement client. */
+export declare function resolveRecordLinks(client: Pick<MdbaseClient, "query">, selection: {
+    readonly path: string;
+    readonly field: string;
+}, options?: {
+    signal?: AbortSignal;
+    isCurrent?: () => boolean;
+}): Promise<readonly Readonly<{
+    raw: string;
+    path: string | null;
+}>[]>;

package/dist/read-helpers.js

@@ -0,0 +1,181 @@
+import { uuid } from "./codec.js";
+import { mdbaseError } from "./errors.js";
+export const READ_MANY_MAX_REFS = 1000;
+export const READ_MANY_MAX_CONCURRENCY = 16;
+/** Ordered ordinary reads, not a transaction or a consistent native snapshot.
+ * Duplicate selections remain separate calls/slots. A failure stops scheduling;
+ * all already-started calls settle before the original error is delivered. */
+export async function readMany(client, refs, include, signal, options = {}) {
+    signal?.throwIfAborted();
+    const concurrency = options.concurrency ?? 8;
+    if (!Number.isSafeInteger(concurrency) ||
+        concurrency < 1 ||
+        concurrency > READ_MANY_MAX_CONCURRENCY) {
+        throw mdbaseError("invalid_request", "readMany concurrency must be 1..16", "read_many_bounds");
+    }
+    if (!Array.isArray(refs) || refs.length > READ_MANY_MAX_REFS) {
+        throw mdbaseError("invalid_request", "readMany accepts at most 1000 record selections", "read_many_bounds");
+    }
+    // Capture every selector before any get/await. A view selects its UUID, not
+    // its possibly stale path/revision; no input is promoted to a native witness.
+    const selections = Array.from(refs, capture);
+    const capturedInclude = include ? Object.freeze({ ...include }) : undefined;
+    const records = new Array(selections.length);
+    let next = 0, failed = false, failure;
+    async function worker() {
+        while (!failed && next < selections.length) {
+            try {
+                signal?.throwIfAborted();
+                const index = next++, selected = selections[index];
+                const record = await client.get(selected, capturedInclude, signal);
+                signal?.throwIfAborted();
+                if (failed)
+                    return;
+                if (typeof selected === "string" && record.id !== selected) {
+                    throw mdbaseError("invalid_request", "readMany readback belongs to another UUID", "read_many_identity_mismatch");
+                }
+                records[index] = record;
+            }
+            catch (error) {
+                if (!failed) {
+                    failed = true;
+                    failure = error;
+                }
+                return;
+            }
+        }
+    }
+    await Promise.all(Array.from({ length: Math.min(concurrency, selections.length) }, () => worker()));
+    if (failed)
+        throw failure;
+    signal?.throwIfAborted();
+    return records;
+}
+function capture(ref) {
+    if (typeof ref === "string")
+        return uuid.dec(uuid.enc(ref));
+    if (!ref || typeof ref !== "object") {
+        throw mdbaseError("invalid_request", "readMany needs UUID, path or record selections", "read_many_selection");
+    }
+    if ("id" in ref)
+        return uuid.dec(uuid.enc(ref.id));
+    if (typeof ref.path !== "string" ||
+        ref.path.length === 0 ||
+        ref.path.length > 4096 ||
+        new TextEncoder().encode(ref.path).byteLength > 4096) {
+        throw mdbaseError("invalid_request", "readMany path must be nonempty and at most 4096 UTF-8 bytes", "read_many_bounds");
+    }
+    return Object.freeze({ path: ref.path });
+}
+/** Alias the canonical paginator. Preserve whole pages, original opaque cursors,
+ * Include/signal and explicit onReset semantics; never flatten or auto-reset. */
+export function queryPages(client, query, include, signal, options = {}) {
+    return client.pages(query, include, signal, options);
+}
+/** Resolve a persisted flat frontmatter key through ONE ordinary native query.
+ * Raw scalar/list strings retain order, duplicates and display aliases; null
+ * targets mean native unresolved/ambiguous/non-record links, never a Person or
+ * author inference. Missing/null/empty-list fields yield [] only from a validated
+ * complete native projection. Old producers fail unsupported, without fallback.
+ * `isCurrent` may bind an original caller scope/revision; this is not a historical
+ * witness, snapshot subscription, extra READ or replacement client. */
+export async function resolveRecordLinks(client, selection, options = {}) {
+    const signal = options.signal;
+    const current = options.isCurrent?.bind(options);
+    const fenced = () => mdbaseError("unavailable", "original record link binding changed", "record_links_fenced");
+    function cut() {
+        signal?.throwIfAborted();
+        if (current) {
+            let valid = false;
+            try {
+                valid = current() === true;
+            }
+            catch {
+                /* no callback diagnostics */
+            }
+            if (!valid)
+                throw fenced();
+        }
+    }
+    cut();
+    const path = selection?.path, field = selection?.field;
+    const text = (value) => typeof value === "string" &&
+        value.length > 0 &&
+        value.length <= 4096 &&
+        new TextEncoder().encode(value).byteLength <= 4096;
+    if (!text(path) || !text(field)) {
+        throw mdbaseError("invalid_request", "record link path/field must be nonempty and bounded", "record_links_bounds");
+    }
+    const key = JSON.stringify(field);
+    const raw = `(${key} in raw ? raw[${key}] : null)`;
+    const target = (value) => `${value}.asFile() == null ? null : ${value}.asFile().file.path`;
+    // Canonical Core CEL type() returns a string, not CEL type constants.
+    const paths = `${raw} == null ? [] : type(${raw}) == "list" ? ${raw}.map(l, ${target("l")}) : [${target(raw)}]`;
+    if (new TextEncoder().encode(paths).byteLength > 64 * 1024) {
+        throw mdbaseError("invalid_request", "record link expression exceeds native source bound", "record_links_bounds");
+    }
+    cut();
+    const result = await client.query({
+        where: `file.path == ${JSON.stringify(path)}`,
+        limit: 2,
+        select: [
+            { name: "raw", expr: raw },
+            { name: "paths", expr: paths },
+        ],
+    }, undefined, signal);
+    cut();
+    const invalid = () => mdbaseError("unavailable", "invalid or incomplete native record link projection", "record_links_response");
+    if (result.complete !== true || result.cursor != null)
+        throw invalid();
+    if (result.columns === undefined) {
+        throw mdbaseError("upgrade_required", "native record link projection unsupported", "record_links_unsupported");
+    }
+    if (result.columns.length !== 2 ||
+        result.columns[0] !== "raw" ||
+        result.columns[1] !== "paths" ||
+        result.diagnostics?.some((issue) => issue.code === "expression_evaluation_error"))
+        throw invalid();
+    if (result.records.length === 0) {
+        throw mdbaseError("not_found", "selected record not found", "record_links_missing");
+    }
+    if (result.records.length !== 1 || result.records[0].path !== path)
+        throw invalid();
+    const values = result.records[0].values;
+    if (values === undefined) {
+        throw mdbaseError("upgrade_required", "native record link projection unsupported", "record_links_unsupported");
+    }
+    if (!(values instanceof Map) ||
+        values.size !== 2 ||
+        !values.has("raw") ||
+        !values.has("paths"))
+        throw invalid();
+    const original = values.get("raw"), resolved = values.get("paths");
+    const links = original === null
+        ? []
+        : typeof original === "string"
+            ? [original]
+            : original;
+    if (!Array.isArray(links) ||
+        !Array.isArray(resolved) ||
+        links.length !== resolved.length ||
+        links.length > 1000)
+        throw invalid();
+    let bytes = 0;
+    const entries = [];
+    for (let index = 0; index < links.length; index++) {
+        const raw = links[index], path = resolved[index];
+        if (typeof raw !== "string" ||
+            raw.length > (1 << 20) - bytes ||
+            (path !== null && !text(path)))
+            throw invalid();
+        bytes +=
+            new TextEncoder().encode(raw).byteLength +
+                (path === null ? 0 : new TextEncoder().encode(path).byteLength);
+        if (bytes > 1 << 20)
+            throw invalid();
+        entries.push(Object.freeze({ raw, path: path }));
+    }
+    cut();
+    return Object.freeze(entries);
+}
+//# sourceMappingURL=read-helpers.js.map

package/dist/read-helpers.js.map

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

package/dist/records/session.d.ts

@@ -0,0 +1,60 @@
+import type { MdbaseClient } from "../client.js";
+import { type PlainValue } from "../values.js";
+import { type Problem, type RecordView } from "../wire.js";
+import type { RecordFlushOptions, RecordFlushResult, RecordOpenOptions, RecordRecoveryRef, RecordResolution, RecordSessionSnapshot } from "./types.js";
+export declare class RecordSessionImpl {
+    private readonly client;
+    private readonly reserve;
+    private base;
+    private body;
+    private patch;
+    private remote;
+    private captured;
+    private lastReceipt;
+    private state;
+    private why;
+    private snapshot;
+    private listeners;
+    private life;
+    private running;
+    /** Whether `running` may submit the draft, or only settles a captured write. */
+    private writing;
+    private refreshRunning;
+    private refreshAgain;
+    private timer;
+    private active;
+    private idle;
+    private defaultTimeout;
+    constructor(client: MdbaseClient, record: RecordView, reserve: (bytes: number) => void);
+    restore(signal: AbortSignal | undefined, hint?: RecordRecoveryRef): Promise<void>;
+    get id(): string;
+    get dirty(): boolean;
+    get retained(): boolean;
+    getSnapshot: () => RecordSessionSnapshot;
+    subscribe: (listener: () => void) => (() => void);
+    resume(options: RecordOpenOptions): void;
+    suspend(): void;
+    private ensure;
+    setBody: (body: string) => void;
+    patchFrontmatter: (patch: Map<string, PlainValue> | {
+        [key: string]: PlainValue | undefined;
+    }) => void;
+    private edited;
+    private charge;
+    private publish;
+    private clearTimer;
+    private schedule;
+    private read;
+    /** Native change notifications are hints only; hydrate the same UUID. */
+    refresh: () => Promise<void>;
+    observerProblem(why: Problem): void;
+    flush: (options?: RecordFlushOptions) => Promise<RecordFlushResult>;
+    /**
+     * Run a drive. `write` submits the draft; otherwise it only settles a
+     * captured write. A flush arriving during a settle-only drive runs after it.
+     */
+    private start;
+    private drive;
+    private settle;
+    resolve: (choice: RecordResolution) => void;
+}