@superbee/core 0.2.0-pre.2 → 0.2.0-pre.20

package/dist/hosted-client/inbox.js

@@ -0,0 +1,379 @@
+import { HostedCarrierError } from "../hosted-transport/carrier.js";
+import { isWorkspaceTenantId, isAgentLabelVia } from "../hosted-transport/carrier.js";
+import { REFUSAL_CODE } from "../hosted-transport/read-adapter.js";
+import { MalformedAnswer, RemoteError } from "../remote-error.js";
+import { HostedRouteNotServed } from "./errors.js";
+/** The largest inbox answer read, in bytes: 100 entries with full notes and meta fit well inside. */
+export const INBOX_ANSWER_BYTES = 1024 * 1024;
+/** The most a note may hold after normalization, in characters. */
+export const INBOX_NOTE_MAX_LENGTH = 2000;
+// ---------------------------------------------------------------------------------------------
+// The open contract shapes.
+export const ATTENTION_OPERATION_IDS = Object.freeze({
+    request: "attention.request.v1",
+    cancel: "attention.cancel.v1",
+    list: "inbox.list.v1",
+    threads: "inbox.threads.v1",
+    summary: "inbox.summary.v1",
+    get: "inbox.get.v1",
+    open: "inbox.open.v1",
+    ack: "inbox.ack.v1",
+    directory: "members.directory.v1",
+});
+/** The kinds a person's caller may send. `ready` and `review_requested` need a document target. */
+export const PERSON_ITEM_KINDS = ["ready", "needs_input", "review_requested", "reply"];
+/** The kinds the host refuses without a document target. */
+export const TARGET_REQUIRED_KINDS = Object.freeze(["ready", "review_requested"]);
+export const INBOX_ITEM_STATES = ["unread", "read", "acknowledged", "expired", "withdrawn"];
+export const PROVENANCE_SURFACES = ["browser", "mcp", "mcp_agent", "sync", "workload", "ops", "operator_workflow", "host_job"];
+/** In a fact filter's `principalId`, the caller's own principal. */
+export const SELF_PRINCIPAL = "self";
+/** The most members one directory page lists. */
+export const DIRECTORY_PAGE_MAX = 100;
+/** Hosted's principal id shape (a lowercase namespace, a colon, a local part), as superbee-hosted's
+ * `namespacedIdPattern` states it. A directory answer naming anything else is malformed, so no id
+ * that could read as a flag or carry shell syntax reaches a printed command. */
+export const HOSTED_PRINCIPAL_ID = /^[a-z][a-z0-9._-]{0,31}:[A-Za-z0-9][A-Za-z0-9._@/-]{0,126}$/;
+/** What a directory answer may name: it starts with a letter or digit and holds only id characters,
+ * so no id the CLI prints in a ready command can read as a flag or carry shell syntax. */
+const DIRECTORY_PRINCIPAL_ID = /^[A-Za-z0-9][A-Za-z0-9._:@/-]{0,255}$/;
+// ---------------------------------------------------------------------------------------------
+// Refusals.
+/** The codes an attention refusal carries: the operation catalog's, plus the workspace header's. */
+export const ATTENTION_REFUSAL_CODES = [
+    "invalid_input",
+    "insufficient_scope",
+    "attention_disabled",
+    "not_found",
+    "target_unavailable",
+    "target_unsupported",
+    "request_conflict",
+    "version_conflict",
+    "workspace_unsupported",
+    "workspace_not_available",
+    "quota_exceeded",
+    "ticket_expired",
+    "internal_error",
+    "backend_unavailable",
+    "cancelled",
+    "deadline_exceeded",
+];
+const REFUSAL_WORDS = Object.freeze({
+    invalid_input: "the host refused the input",
+    insufficient_scope: "this sign-in may not use the inbox",
+    attention_disabled: "the inbox is not turned on for this workspace",
+    not_found: "not available: no such item, not addressed to you, or the recipient is not an active member of this workspace",
+    target_unavailable: "the document is not available to you at that version",
+    target_unsupported: "this document predates change tracking; save it once and try again",
+    request_conflict: "this ticket was already used with a different input",
+    version_conflict: "the item changed since it was read",
+    workspace_unsupported: "this connection names no single workspace",
+    workspace_not_available: "the workspace is not available to this sign-in",
+    quota_exceeded: "the request limit for this workspace was reached",
+    ticket_expired: "the ticket is too old or too far ahead; send with a new one",
+    internal_error: "the host could not complete the operation",
+    backend_unavailable: "the inbox is unavailable right now",
+    cancelled: "the host cancelled the operation",
+    deadline_exceeded: "the host's deadline passed",
+});
+/**
+ * The host refused an attention operation. `code` is the catalog's; the message is this client's
+ * own. `serverTime` comes with `ticket_expired` (the host's clock, for a caller whose clock is off).
+ */
+export class HostedAttentionRefusal extends RemoteError {
+    code;
+    operationId;
+    retryable;
+    serverTime;
+    /** What the refusal means, in this client's words, without the operation id. */
+    reason;
+    constructor(operationId, code, status, retryable, serverTime) {
+        super(`${operationId}: ${REFUSAL_WORDS[code]}`, code, status);
+        this.name = "HostedAttentionRefusal";
+        this.reason = REFUSAL_WORDS[code];
+        this.code = code;
+        this.operationId = operationId;
+        this.retryable = retryable;
+        if (serverTime !== undefined)
+            this.serverTime = serverTime;
+    }
+}
+export function isAttentionRefusal(error) {
+    return error instanceof HostedAttentionRefusal;
+}
+/**
+ * A send whose outcome is unknown after every retry: it may or may not have created the item.
+ * Sending again with `ticket` is safe for 24 hours from when it was minted: the host answers the
+ * first send's item, or creates it once.
+ */
+export class HostedAttentionOutcomeUnknown extends Error {
+    code = "attention_outcome_unknown";
+    ticket;
+    constructor(ticket, cause) {
+        super("the send may have reached the host; send again with the same ticket", { cause });
+        this.name = "HostedAttentionOutcomeUnknown";
+        this.ticket = ticket;
+    }
+}
+export function isAttentionOutcomeUnknown(error) {
+    return error instanceof HostedAttentionOutcomeUnknown;
+}
+/** A fresh UUIDv7 (RFC 9562): 48-bit millisecond time, version 7, 74 random bits. */
+export function mintAttentionTicket(now = Date.now()) {
+    const bytes = new Uint8Array(16);
+    globalThis.crypto.getRandomValues(bytes);
+    let time = Math.max(0, Math.floor(now));
+    for (let index = 5; index >= 0; index -= 1) {
+        bytes[index] = time % 256;
+        time = Math.floor(time / 256);
+    }
+    bytes[6] = (bytes[6] & 0x0f) | 0x70;
+    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+    const hex = [...bytes].map((byte) => byte.toString(16).padStart(2, "0")).join("");
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+const UUID_V7 = /^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;
+/** Whether `value` is a UUIDv7, the shape tickets and thread ids take. */
+export function isAttentionTicket(value) {
+    return typeof value === "string" && UUID_V7.test(value);
+}
+/**
+ * The inbox of `client`'s person in one workspace, over the client's carrier, prefix and signal
+ * (its credential, deadline and abort). A `within` client serves as well: no attention input
+ * names a bundle.
+ */
+export function createHostedInbox(client, options) {
+    const { tenantId } = options;
+    if (!isWorkspaceTenantId(tenantId))
+        throw new TypeError("a hosted inbox names its workspace by tenant id");
+    if (options.via !== undefined && !isAgentLabelVia(options.via))
+        throw new TypeError("a hosted inbox's via is not a token the host admits");
+    const attempts = Math.max(1, Math.floor(options.sendAttempts ?? 3));
+    const retryDelayMs = Math.max(0, options.retryDelayMs ?? 250);
+    const now = options.now ?? Date.now;
+    async function call(operationId, input, via) {
+        const route = `${client.prefix}/attention/${operationId}`;
+        const answer = await client.carrier.json(route, input, client.signal, {
+            maximum: INBOX_ANSWER_BYTES,
+            workspace: tenantId,
+            ...(via === undefined ? {} : { via }),
+        });
+        const body = answer.body;
+        if (answer.status === 200 && body?.ok === true) {
+            if (body.operationId !== operationId || !isRecord(body.data))
+                throw new MalformedAnswer("not an attention answer", route);
+            return body.data;
+        }
+        throw refusalOf(operationId, route, answer.status, body);
+    }
+    const read = (operationId, input, decode) => call(operationId, input).then((data) => decode(data, `${client.prefix}/attention/${operationId}`));
+    return {
+        tenantId,
+        list: (input = {}) => read(ATTENTION_OPERATION_IDS.list, input, decodeListPage),
+        threads: (input = {}) => read(ATTENTION_OPERATION_IDS.threads, input, decodeThreadsPage),
+        summary: (input = {}) => read(ATTENTION_OPERATION_IDS.summary, input, decodeSummary),
+        get: (itemId) => read(ATTENTION_OPERATION_IDS.get, { itemId }, entryOf),
+        open: (itemId) => read(ATTENTION_OPERATION_IDS.open, { itemId }, entryOf),
+        ack: (itemId, input) => read(ATTENTION_OPERATION_IDS.ack, { itemId, expectedRevision: input.expectedRevision, ...(input.shownVersion === undefined ? {} : { shownVersion: input.shownVersion }) }, entryOf),
+        cancel: (itemId) => read(ATTENTION_OPERATION_IDS.cancel, { itemId }, (data, route) => {
+            if (typeof data.itemId !== "string" || !isState(data.state) || !isCount(data.revision))
+                throw new MalformedAnswer("not a cancel answer", route);
+            return { itemId: data.itemId, state: data.state, revision: data.revision };
+        }),
+        directory: (input = {}) => read(ATTENTION_OPERATION_IDS.directory, input, decodeDirectoryPage),
+        async request(input) {
+            const ticket = input.ticket ?? mintAttentionTicket(now());
+            if (!isAttentionTicket(ticket))
+                throw new TypeError("a ticket is a UUIDv7");
+            const body = { ...input, ticket };
+            const route = `${client.prefix}/attention/${ATTENTION_OPERATION_IDS.request}`;
+            let unclear;
+            for (let attempt = 0; attempt < attempts; attempt += 1) {
+                if (attempt > 0)
+                    await pause(retryDelayMs, client.signal);
+                try {
+                    const data = await call(ATTENTION_OPERATION_IDS.request, body, options.via);
+                    return { ...decodeReceipt(data, route), ticket };
+                }
+                catch (error) {
+                    // Once an attempt may have landed, no later answer settles the send: a retry refused
+                    // before the host reads its ticket (a session ended, a quota spent, a removed member)
+                    // says nothing about the first delivery, so the ticket must survive for a resend.
+                    if (unclear !== undefined && !sendMayHaveLanded(error))
+                        throw new HostedAttentionOutcomeUnknown(ticket, error);
+                    // Nothing left: the credential was refused before sending, or the caller aborted.
+                    if (error instanceof HostedCarrierError && error.code === "denied")
+                        throw error;
+                    if (!sendMayHaveLanded(error))
+                        throw error;
+                    unclear = error;
+                    if (client.signal.aborted)
+                        break;
+                }
+            }
+            throw new HostedAttentionOutcomeUnknown(ticket, unclear);
+        },
+    };
+}
+/** An answer that leaves a send's outcome unknown: no answer, or a refusal the host marks retryable. */
+function sendMayHaveLanded(error) {
+    if (error instanceof HostedCarrierError)
+        return error.code === "unavailable";
+    if (error instanceof HostedAttentionRefusal)
+        return error.retryable || error.code === "internal_error";
+    if (error instanceof RemoteError && !(error instanceof MalformedAnswer) && !(error instanceof HostedRouteNotServed))
+        return error.status >= 500;
+    return false;
+}
+function pause(ms, signal) {
+    return new Promise((resolve) => {
+        if (signal.aborted || ms === 0)
+            return resolve();
+        const timer = setTimeout(done, ms);
+        function done() {
+            clearTimeout(timer);
+            signal.removeEventListener("abort", done);
+            resolve();
+        }
+        signal.addEventListener("abort", done, { once: true });
+    });
+}
+const STATUS_RETRYABLE = new Set(["backend_unavailable", "deadline_exceeded"]);
+/** Every answer but a success, as the typed error it is. Host words never travel. */
+function refusalOf(operationId, route, status, body) {
+    // A gateway from before the attention routes: the family's unknown-route answer.
+    if (status === 404 && body !== undefined && Object.keys(body).length === 1 && body.error === "not_found")
+        return new HostedRouteNotServed(route);
+    // The catalog's refusal.
+    if (body?.ok === false && isRecord(body.error) && isRefusalCode(body.error.code)) {
+        const error = body.error;
+        const code = error.code;
+        const retryable = typeof error.retryable === "boolean" ? error.retryable : STATUS_RETRYABLE.has(code);
+        const serverTime = code === "ticket_expired" && typeof error.serverTime === "number" && Number.isSafeInteger(error.serverTime) ? error.serverTime : undefined;
+        return new HostedAttentionRefusal(operationId, code, status, retryable, serverTime);
+    }
+    // The workspace header's one refusal, the same for every cause.
+    if (status === 403 && body?.ok === false && body.code === "workspace_not_available") {
+        return new HostedAttentionRefusal(operationId, "workspace_not_available", status, false);
+    }
+    // The family's own refusals (unauthenticated, an admission that is off or unavailable).
+    const familyCode = isRecord(body?.error) ? body.error.code : undefined;
+    if (typeof familyCode === "string" && REFUSAL_CODE.test(familyCode))
+        return new RemoteError(`hosted ${route} answered ${status} ${familyCode}`, familyCode, status);
+    if (status === 401)
+        return new RemoteError(`hosted ${route} answered 401`, "unauthenticated", 401);
+    if (status >= 500)
+        return new RemoteError(`hosted ${route} answered ${status}`, "RUNTIME", status);
+    return new MalformedAnswer(`not an attention answer (${status})`, route);
+}
+const isRefusalCode = (value) => typeof value === "string" && ATTENTION_REFUSAL_CODES.includes(value);
+// ---------------------------------------------------------------------------------------------
+// Decoding: the fields a caller relies on are checked; the rest of each record is passed through.
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+const isCount = (value) => typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+const isState = (value) => typeof value === "string" && INBOX_ITEM_STATES.includes(value);
+const isNullableCount = (value) => value === null || isCount(value);
+function decodeEntry(value, route) {
+    if (!isRecord(value) ||
+        typeof value.itemId !== "string" ||
+        !isCount(value.seq) ||
+        typeof value.threadId !== "string" ||
+        !isCount(value.revision) ||
+        typeof value.kind !== "string" ||
+        !isState(value.state) ||
+        !isRecord(value.recipient) ||
+        typeof value.recipient.principalId !== "string" ||
+        !isRecord(value.producer) ||
+        !isRecord(value.producerDisplay) ||
+        !(value.target === null || isRecord(value.target)) ||
+        !(value.note === null || typeof value.note === "string") ||
+        !(value.meta === null || isRecord(value.meta)) ||
+        !isCount(value.createdAt) ||
+        !isCount(value.expiresAt) ||
+        !isNullableCount(value.readAt) ||
+        !isNullableCount(value.acknowledgedAt)) {
+        throw new MalformedAnswer("not an inbox entry", route);
+    }
+    return value;
+}
+function entryOf(data, route) {
+    return decodeEntry(data.entry, route);
+}
+function decodeListPage(data, route) {
+    if (!Array.isArray(data.entries) || !isNullableCount(data.nextAfterSeq))
+        throw new MalformedAnswer("not an inbox page", route);
+    return { entries: data.entries.map((entry) => decodeEntry(entry, route)), nextAfterSeq: data.nextAfterSeq };
+}
+function decodeThreadsPage(data, route) {
+    if (!Array.isArray(data.threads) || !(data.nextBefore === null || typeof data.nextBefore === "string"))
+        throw new MalformedAnswer("not a threads page", route);
+    const threads = data.threads.map((thread) => {
+        if (!isRecord(thread) ||
+            typeof thread.threadId !== "string" ||
+            !isRecord(thread.counterpart) ||
+            typeof thread.counterpart.principalId !== "string" ||
+            !isCount(thread.lastItemAt) ||
+            !isCount(thread.openToYou) ||
+            !isCount(thread.unreadToYou) ||
+            !isCount(thread.openFromYou) ||
+            !(thread.last === null || (isRecord(thread.last) && typeof thread.last.itemId === "string" && isState(thread.last.state)))) {
+            throw new MalformedAnswer("not a thread", route);
+        }
+        return thread;
+    });
+    return { threads, nextBefore: data.nextBefore };
+}
+function decodeSummary(data, route) {
+    const count = (value) => {
+        if (!isRecord(value) || !isCount(value.count) || typeof value.capped !== "boolean")
+            throw new MalformedAnswer("not an inbox summary", route);
+        return { count: value.count, capped: value.capped };
+    };
+    if (!isCount(data.newestSeq))
+        throw new MalformedAnswer("not an inbox summary", route);
+    return { waitingThreads: count(data.waitingThreads), unreadUpdates: count(data.unreadUpdates), newestSeq: data.newestSeq };
+}
+function decodeDirectoryPage(data, route) {
+    if (!Array.isArray(data.members) || !(data.nextAfter === null || (typeof data.nextAfter === "string" && data.nextAfter !== ""))) {
+        throw new MalformedAnswer("not a directory page", route);
+    }
+    const members = data.members.map((member) => {
+        if (!isRecord(member) ||
+            typeof member.principalId !== "string" ||
+            !DIRECTORY_PRINCIPAL_ID.test(member.principalId) ||
+            !(member.displayName === null || typeof member.displayName === "string") ||
+            !(member.email === undefined || member.email === null || typeof member.email === "string") ||
+            typeof member.self !== "boolean") {
+            throw new MalformedAnswer("not a directory member", route);
+        }
+        return {
+            principalId: member.principalId,
+            displayName: member.displayName,
+            ...(member.email === undefined ? {} : { email: member.email }),
+            self: member.self,
+        };
+    });
+    return { members, nextAfter: data.nextAfter };
+}
+function decodeReceipt(data, route) {
+    const delivery = data.delivery;
+    if (typeof data.itemId !== "string" ||
+        typeof data.threadId !== "string" ||
+        !isCount(data.itemRevision) ||
+        typeof data.replayed !== "boolean" ||
+        !isRecord(delivery) ||
+        delivery.inApp !== "visible" ||
+        (delivery.email !== "pending" && delivery.email !== "off")) {
+        throw new MalformedAnswer("not an attention receipt", route);
+    }
+    return {
+        itemId: data.itemId,
+        threadId: data.threadId,
+        itemRevision: data.itemRevision,
+        replayed: data.replayed,
+        delivery: { inApp: "visible", email: delivery.email },
+    };
+}
+//# sourceMappingURL=inbox.js.map

package/dist/hosted-client/inbox.js.map

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

package/dist/hosted-client/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * `@superbee/core/hosted-client`: the headless client of a hosted Superbee's sync route family
+ * (`/sync/v1`), a supported public API under core's normal versioning. It is runtime-neutral
+ * (`fetch` and Web streams only), so it runs in Node, a browser or a Worker.
+ *
+ * The caller supplies the target (origin and sync prefix) and an async credential provider; the
+ * client supplies identity, the bundle list, reads, history, workspace qualification, operations
+ * by id, the one-call document write and the one-call blob write (`writeBlob`, journaled by
+ * `driveJournaledBlob`) over `@superbee/core/hosted-transport`, and throws typed errors only.
+ * `createHostedInbox` adds a person's inbox in one workspace over the same client, and
+ * `readDirectory` with `matchDirectoryMember` finds a teammate where the host offers the directory.
+ *
+ * Export download is Node-only (its verification needs Node), so it is the separate
+ * `@superbee/core/hosted-client/node`; nothing here imports it.
+ */
+export { bearerCredentials, createHostedClient, qualifyingCarrier, syncRoutePrefix, type HostedClient, type HostedClientOptions, type HostedClientTarget, type HostedCredentialProvider, type HostedIdentity, type HostedRunOptions, type HostedWorkspace, } from "./client.js";
+export { BUNDLE_LIST_CAP, readBundleListing, type HostedBundleListing, type HostedBundleRow, type HostedListedBundle, } from "./bundle-listing.js";
+export { hostedBundleReferenceText, isWorkspaceSlug, parseHostedBundleReference, type HostedBundleReference, } from "./reference.js";
+export { checkoutBindingDigest } from "./binding.js";
+export { createMemoryIntentStore, HostedIntentsNotListable, INTENTS_NOT_LISTABLE, type HostedIntentStore, type HostedWriteInput, type HostedWriteIntent, type HostedWriteLookupResult, type HostedWriteOptions, type HostedWriteRefusalCode, type HostedWriteResult, } from "./write.js";
+export { HostedBlobWritesNotServed, HostedRouteNotServed, isRouteNotServed, ROUTE_NOT_SERVED } from "./errors.js";
+export { driveJournaledBlob, forgetJournaledBlob, HostedBlobDeletionsNotAccepted, HostedBlobWriteNotSent, type BlobDrivePremises, type BlobDriveSnapshot, type BlobDriveStep, type BlobPin, type HostedBlobDeleteInput, type HostedBlobForgetResult, type HostedBlobHeldWrite, type HostedBlobLookupResult, type HostedBlobOperation, type HostedBlobRefusalCode, type HostedBlobWriteInput, type HostedBlobWriteOptions, type HostedBlobWriteResult, type JournaledBlobContext, type JournaledBlobForgetResult, type JournaledBlobMode, type JournaledBlobResult, } from "./blob-write.js";
+export { createMemoryBlobJournal, type BlobJournaledBackend, type MemoryBlobJournal } from "../blob-journal.js";
+export type { HostedBlobHead, HostedBlobHeads, HostedBlobRead } from "../hosted-transport/index.js";
+export { ATTENTION_OPERATION_IDS, ATTENTION_REFUSAL_CODES, createHostedInbox, DIRECTORY_PAGE_MAX, HOSTED_PRINCIPAL_ID, HostedAttentionOutcomeUnknown, HostedAttentionRefusal, INBOX_ANSWER_BYTES, INBOX_ITEM_STATES, INBOX_NOTE_MAX_LENGTH, isAttentionOutcomeUnknown, isAttentionRefusal, isAttentionTicket, mintAttentionTicket, PERSON_ITEM_KINDS, PROVENANCE_SURFACES, SELF_PRINCIPAL, TARGET_REQUIRED_KINDS, type AttentionCancelResult, type AttentionOperationId, type AttentionReceipt, type AttentionRefusalCode, type AttentionRequestInput, type DirectoryInput, type DirectoryMember, type DirectoryPage, type HostedInbox, type HostedInboxOptions, type InboxAckInput, type InboxAppMeta, type InboxCount, type InboxEntry, type InboxEntryTarget, type InboxFactMatch, type InboxItemKind, type InboxItemState, type InboxListInput, type InboxListPage, type InboxProducerDisplay, type InboxProducerFacts, type InboxRecipient, type InboxSummary, type InboxSummaryInput, type InboxThread, type InboxThreadsInput, type InboxThreadsPage, type PersonItemKind, type ProvenanceSurface, } from "./inbox.js";
+export { DIRECTORY_PAGES_MAX, directoryNameKey, matchDirectoryMember, readDirectory, type DirectoryListing, type DirectoryMatch, type DirectoryMatchBy, } from "./directory.js";
+export { MALFORMED_ANSWER, MalformedAnswer, RemoteError, isMalformedAnswer } from "../remote-error.js";
+export { HostedAnswerTooLarge, HostedCarrierError, isAnswerTooLarge } from "../hosted-transport/carrier.js";
+export { BLOB_UNRECORDED_REFUSAL_CODES, performHostedBlobDelivery, type HostedBlobDeliveryContext, type HostedBlobDeliveryOptions, type HostedBlobDeliveryOutcome, type HostedBlobDeliveryResult, } from "./blob-delivery.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/hosted-client/index.d.ts.map

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

package/dist/hosted-client/index.js

@@ -0,0 +1,32 @@
+/**
+ * `@superbee/core/hosted-client`: the headless client of a hosted Superbee's sync route family
+ * (`/sync/v1`), a supported public API under core's normal versioning. It is runtime-neutral
+ * (`fetch` and Web streams only), so it runs in Node, a browser or a Worker.
+ *
+ * The caller supplies the target (origin and sync prefix) and an async credential provider; the
+ * client supplies identity, the bundle list, reads, history, workspace qualification, operations
+ * by id, the one-call document write and the one-call blob write (`writeBlob`, journaled by
+ * `driveJournaledBlob`) over `@superbee/core/hosted-transport`, and throws typed errors only.
+ * `createHostedInbox` adds a person's inbox in one workspace over the same client, and
+ * `readDirectory` with `matchDirectoryMember` finds a teammate where the host offers the directory.
+ *
+ * Export download is Node-only (its verification needs Node), so it is the separate
+ * `@superbee/core/hosted-client/node`; nothing here imports it.
+ */
+export { bearerCredentials, createHostedClient, qualifyingCarrier, syncRoutePrefix, } from "./client.js";
+export { BUNDLE_LIST_CAP, readBundleListing, } from "./bundle-listing.js";
+export { hostedBundleReferenceText, isWorkspaceSlug, parseHostedBundleReference, } from "./reference.js";
+export { checkoutBindingDigest } from "./binding.js";
+export { createMemoryIntentStore, HostedIntentsNotListable, INTENTS_NOT_LISTABLE, } from "./write.js";
+export { HostedBlobWritesNotServed, HostedRouteNotServed, isRouteNotServed, ROUTE_NOT_SERVED } from "./errors.js";
+export { driveJournaledBlob, forgetJournaledBlob, HostedBlobDeletionsNotAccepted, HostedBlobWriteNotSent, } from "./blob-write.js";
+// The browser-safe default blob journal and the head and read shapes, re-exported (same identities).
+export { createMemoryBlobJournal } from "../blob-journal.js";
+export { ATTENTION_OPERATION_IDS, ATTENTION_REFUSAL_CODES, createHostedInbox, DIRECTORY_PAGE_MAX, HOSTED_PRINCIPAL_ID, HostedAttentionOutcomeUnknown, HostedAttentionRefusal, INBOX_ANSWER_BYTES, INBOX_ITEM_STATES, INBOX_NOTE_MAX_LENGTH, isAttentionOutcomeUnknown, isAttentionRefusal, isAttentionTicket, mintAttentionTicket, PERSON_ITEM_KINDS, PROVENANCE_SURFACES, SELF_PRINCIPAL, TARGET_REQUIRED_KINDS, } from "./inbox.js";
+export { DIRECTORY_PAGES_MAX, directoryNameKey, matchDirectoryMember, readDirectory, } from "./directory.js";
+// The other typed failures, re-exported (same identities) so a caller can tell them apart from
+// this one subpath.
+export { MALFORMED_ANSWER, MalformedAnswer, RemoteError, isMalformedAnswer } from "../remote-error.js";
+export { HostedAnswerTooLarge, HostedCarrierError, isAnswerTooLarge } from "../hosted-transport/carrier.js";
+export { BLOB_UNRECORDED_REFUSAL_CODES, performHostedBlobDelivery, } from "./blob-delivery.js";
+//# sourceMappingURL=index.js.map

package/dist/hosted-client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hosted-client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,GAQhB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,eAAe,EACf,iBAAiB,GAIlB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,yBAAyB,EACzB,eAAe,EACf,0BAA0B,GAE3B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,oBAAoB,GAQrB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAClH,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,8BAA8B,EAC9B,sBAAsB,GAkBvB,MAAM,iBAAiB,CAAC;AACzB,qGAAqG;AACrG,OAAO,EAAE,uBAAuB,EAAqD,MAAM,oBAAoB,CAAC;AAEhH,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,6BAA6B,EAC7B,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,yBAAyB,EACzB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,qBAAqB,GA+BtB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,GAId,MAAM,gBAAgB,CAAC;AACxB,+FAA+F;AAC/F,oBAAoB;AACpB,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvG,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAC5G,OAAO,EACL,6BAA6B,EAC7B,yBAAyB,GAK1B,MAAM,oBAAoB,CAAC"}

package/dist/hosted-client/journal.d.ts

@@ -0,0 +1,103 @@
+import { FileJournaledBackend, type FileJournaledBackendOptions } from "../file-journaled-backend.js";
+import type { HostedIntentStore, HostedWriteIntent } from "./write.js";
+import { type BlobJournaledBackend } from "../blob-journal.js";
+/** The marker row's key. */
+export declare const HOSTED_CLIENT_JOURNAL_MARKER = "hosted-client.journal";
+/** The schema this version of the client writes and reads. */
+export declare const HOSTED_CLIENT_JOURNAL_SCHEMA_VERSION = 1;
+/** The prefix of every held document write's meta row; the request identity follows it. */
+export declare const HOSTED_CLIENT_WRITE_PREFIX = "hosted-client.write.";
+/**
+ * The log is compacted into the snapshot once it is larger than the greater of this floor and
+ * twice the last snapshot, checked after every mutation. Settled writes leave the live state, so
+ * a steady stream of writes keeps the log under about this floor plus one record, and the work
+ * stays linear when unsettled writes hold the snapshot large.
+ */
+export declare const HOSTED_CLIENT_JOURNAL_COMPACT_FLOOR_BYTES: number;
+export type HostedClientJournalProblem = 
+/** The directory is a symbolic link, or (on POSIX) grants its group or others any permission. */
+"JOURNAL_DIRECTORY_NOT_PRIVATE"
+/** The directory holds a store this client did not create: documents, blobs, a checkout's state, or unmarked rows. */
+ | "JOURNAL_NOT_HOSTED_CLIENT"
+/** The marker names a schema this version does not read (a newer client wrote it). */
+ | "JOURNAL_SCHEMA_UNSUPPORTED";
+/** Open refused the directory; nothing in it was changed. */
+export declare class HostedClientJournalError extends Error {
+    readonly name = "HostedClientJournalError";
+    readonly code: HostedClientJournalProblem;
+    readonly directory: string;
+    /** With `JOURNAL_SCHEMA_UNSUPPORTED`: the marker's `schemaVersion`, as found. */
+    readonly schemaVersion?: unknown;
+    constructor(code: HostedClientJournalProblem, directory: string, message: string, options?: {
+        schemaVersion?: unknown;
+    });
+}
+/** True when `error` is a {@link HostedClientJournalError}, with `code` when one is named. */
+export declare function isHostedClientJournalError(error: unknown, code?: HostedClientJournalProblem): error is HostedClientJournalError;
+export interface HostedClientJournalOptions {
+    /**
+     * The journal's directory, on a local file system. Created (mode 0700) when absent; an existing
+     * one must be a real directory with no group or other permission bits.
+     */
+    readonly directory: string;
+    /** How long open waits for another process holding the directory (default 5,000 ms), then fails. */
+    readonly lock?: {
+        readonly waitMs?: number;
+    };
+}
+/**
+ * A durable {@link HostedIntentStore}: pass it as `createHostedClient({ intentStore })`. It holds
+ * the directory's exclusive lock until {@link close}; every call after close rejects.
+ *
+ * Unlike `createMemoryIntentStore`, whose calls take effect as they are made, each call here
+ * takes effect later, in the order its asynchronous steps complete: `delete` reads the row before
+ * removing it, so a `put` made after an unawaited `delete` can land first and then be removed.
+ * Await each call before the next on the same request identity, as the client does.
+ */
+export interface HostedClientJournal extends HostedIntentStore {
+    /** The journal's directory, resolved. */
+    readonly directory: string;
+    put(intent: HostedWriteIntent): Promise<void>;
+    get(requestId: string): Promise<HostedWriteIntent | undefined>;
+    delete(requestId: string): Promise<void>;
+    /** Every held write, oldest first (by `createdAt`, then request identity). */
+    list(): AsyncIterable<HostedWriteIntent>;
+    /**
+     * The journal's blob writes: pass it as `createHostedClient({ blobJournal })`. The backend's own
+     * blob intent family and transition rules; metadata it carries may not name this journal's
+     * own rows (`hosted-client.*`) or a checkout's blob-sync state.
+     */
+    readonly blobs: BlobJournaledBackend;
+    /** Let pending calls finish, then release the directory. */
+    close(): Promise<void>;
+}
+/**
+ * Open (or create) the hosted client's durable intent store in `directory`.
+ *
+ * Refusals change no file in an existing directory:
+ * - {@link HostedClientJournalError} — the directory is not private (a symbolic link, another
+ *   owner, group or other permission bits), holds files but no store, is not this client's
+ *   store, or names a newer schema;
+ * - `FilesystemMutationLockError` — another process holds the directory past `lock.waitMs`;
+ * - `FileJournalCorruptError` / `FileJournalFormatError` — the log or snapshot is damaged or in a
+ *   newer format. Nothing is repaired: moving the directory aside loses the writes it holds.
+ *
+ * The directory may hold only the backend's store files, each a regular file of its own. The
+ * decision is made on a read-only open, which changes nothing, and the directory, its listing,
+ * its files and its contents are checked again under the writable open's lock before the marker
+ * is written. Another process of the same user modifying the directory while it opens is out of
+ * scope: between the read-only decision and the writable lock, such a change can make the
+ * writable open truncate a torn or foreign log tail, remove a leftover snapshot temp, or create
+ * an empty log, and a foreign log truncated to nothing that way is adopted as an empty journal.
+ */
+export declare function openHostedClientJournal(options: HostedClientJournalOptions): Promise<HostedClientJournal>;
+/** @internal What the store's own tests vary: the lock namespace, the backend's opener (its fault seam), and the open's windows. */
+export interface JournalTestSeam {
+    readonly lockRoot?: string;
+    readonly openBackend?: (options: FileJournaledBackendOptions) => Promise<FileJournaledBackend>;
+    /** Runs where another process could act: before an absent directory is created, and before the writable open. */
+    readonly window?: (phase: "before-create" | "before-writable-open") => Promise<void>;
+}
+/** @internal {@link openHostedClientJournal} with its test seam. Not in the package's exports. */
+export declare function openHostedClientJournalWith(options: HostedClientJournalOptions, seam?: JournalTestSeam): Promise<HostedClientJournal>;
+//# sourceMappingURL=journal.d.ts.map

package/dist/hosted-client/journal.d.ts.map

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