better-supabase 0.12.0 → 0.13.0

package/dist/http-DdYadv-o.js

@@ -1,126 +0,0 @@
-import { getEnv } from "@supabase/middleware";
-import { fromSupabaseUrl } from "@supabase/server/oauth-protected-resource";
-//#region src/mcp/http.ts
-/** The RFC 9728 well-known prefix. The Supabase Edge Functions gateway never routes it to a function. */
-const WELL_KNOWN = "/.well-known/oauth-protected-resource";
-/** The path suffix `withOAuthProtectedResource` serves, reachable through `/functions/v1/<slug>`. */
-const SUFFIX = "/oauth-protected-resource";
-/** The prefix the Edge Functions gateway strips before the function sees the request. */
-const EDGE_PREFIX = "/functions/v1";
-const ALLOW_HEADERS = "Authorization, Content-Type, Accept, Mcp-Protocol-Version, Mcp-Session-Id, Mcp-Method, Mcp-Name";
-const trim = (value) => value.replace(/\/+$/, "");
-/**
-* Whether the request runs on Supabase Edge Functions, detected as
-* `@supabase/server` 1.9 does, minus its plain-Deno fallback so a Deno Deploy
-* server keeps its own URLs.
-*/
-function onEdgeFunctions() {
-	return ["SUPABASE_FUNCTION_SLUG", "SB_EXECUTION_ID"].some((key) => Boolean(getEnv(key)));
-}
-/** The public origin: `SUPABASE_PUBLIC_URL`, else the gateway's `X-Forwarded-*` headers. */
-function edgeOrigin(request) {
-	const publicUrl = getEnv("SUPABASE_PUBLIC_URL");
-	if (publicUrl) return trim(publicUrl);
-	const url = new URL(request.url);
-	const host = request.headers.get("x-forwarded-host") ?? url.hostname;
-	const proto = (request.headers.get("x-forwarded-proto") ?? url.protocol.slice(0, -1)).toLowerCase();
-	const port = host.includes(":") ? "" : request.headers.get("x-forwarded-port") ?? url.port;
-	return `${proto}://${host}${port && !(proto === "https" && port === "443" || proto === "http" && port === "80") ? `:${port}` : ""}`;
-}
-function stripMetadata(pathname) {
-	if (pathname.startsWith(WELL_KNOWN)) return pathname.slice(37);
-	if (pathname.endsWith(SUFFIX)) return pathname.slice(0, -25);
-	return pathname;
-}
-function edgePath(request) {
-	const slug = getEnv("SUPABASE_FUNCTION_SLUG");
-	if (slug) return `${EDGE_PREFIX}/${slug}`;
-	return trim(`${EDGE_PREFIX}${stripMetadata(new URL(request.url).pathname)}`);
-}
-/** A request for the RFC 9728 metadata, at the well-known prefix or the `{resource}/oauth-protected-resource` suffix. */
-function isMetadataRequest(request) {
-	const { pathname } = new URL(request.url);
-	if (pathname === WELL_KNOWN || pathname.startsWith(`${WELL_KNOWN}/`)) return true;
-	return pathname.endsWith(SUFFIX) && request.method !== "POST";
-}
-/**
-* The public URLs of an MCP endpoint. On Supabase Edge Functions they come
-* from the gateway (the request URL is internal there, without
-* `/functions/v1`), and the metadata is advertised at the suffix route.
-*/
-function discovery(options, supabaseUrl) {
-	const resource = (request) => {
-		if (typeof options.resource === "function") return options.resource(request);
-		if (options.resource) return options.resource;
-		if (onEdgeFunctions()) return `${edgeOrigin(request)}${edgePath(request)}`;
-		const url = new URL(request.url);
-		return trim(`${url.origin}${stripMetadata(url.pathname)}`);
-	};
-	return {
-		resource,
-		metadataUrl: (request) => {
-			const target = new URL(resource(request));
-			const path = trim(target.pathname);
-			return onEdgeFunctions() ? `${target.origin}${path}${SUFFIX}` : `${target.origin}${WELL_KNOWN}${path}`;
-		},
-		authorizationServers: (request) => {
-			if (options.authorizationServers) return options.authorizationServers;
-			return onEdgeFunctions() ? [`${edgeOrigin(request)}/auth/v1`] : [fromSupabaseUrl(supabaseUrl())];
-		},
-		host: (request) => {
-			return (onEdgeFunctions() ? request.headers.get("x-forwarded-host") : null) ?? request.headers.get("host");
-		}
-	};
-}
-/** The `OPTIONS` answer for the metadata route. */
-function metadataPreflight() {
-	return new Response(null, {
-		status: 204,
-		headers: {
-			"access-control-allow-origin": "*",
-			"access-control-allow-methods": "GET, OPTIONS",
-			"access-control-allow-headers": "Content-Type, Mcp-Protocol-Version"
-		}
-	});
-}
-/** The `OPTIONS` answer for the MCP endpoint. */
-function endpointPreflight(request, allowedOrigins) {
-	return withCors(new Response(null, {
-		status: 204,
-		headers: {
-			"access-control-allow-methods": "POST, OPTIONS",
-			"access-control-allow-headers": ALLOW_HEADERS,
-			"access-control-max-age": "86400"
-		}
-	}), request, allowedOrigins);
-}
-/**
-* Adds CORS headers to an endpoint response, keeping any the handler set.
-* With `allowedOrigins` a listed origin is echoed; otherwise any origin may
-* call, which is safe because the token travels in a header, not a cookie.
-*/
-function withCors(response, request, allowedOrigins) {
-	const origin = request.headers.get("origin");
-	const allow = allowedOrigins ? origin && allowedOrigins.includes(origin) ? origin : null : "*";
-	const apply = (headers) => {
-		if (allow && !headers.has("access-control-allow-origin")) {
-			headers.set("access-control-allow-origin", allow);
-			if (allow !== "*") headers.append("vary", "Origin");
-		}
-		if (!headers.has("access-control-expose-headers")) headers.set("access-control-expose-headers", "WWW-Authenticate");
-	};
-	try {
-		apply(response.headers);
-		return response;
-	} catch {
-		const headers = new Headers(response.headers);
-		apply(headers);
-		return new Response(response.body, {
-			status: response.status,
-			statusText: response.statusText,
-			headers
-		});
-	}
-}
-//#endregion
-export { withCors as a, metadataPreflight as i, endpointPreflight as n, isMetadataRequest as r, discovery as t };

package/dist/image-url-pIVlO6R1.js

@@ -1,41 +0,0 @@
-//#region src/storage/image-url.ts
-/** Storage's image transformation limits. */
-const MAX_SIDE = 2500;
-const QUALITY = {
-	min: 20,
-	max: 100
-};
-const clamp = (value, min, max) => Math.min(max, Math.max(min, Math.round(value)));
-/**
-* Turns public Storage object URLs into Supabase image transformation URLs
-* (`/render/image/public`) at a given size. Any other URL (local files,
-* other hosts, signed URLs) comes back as `undefined`: a signed URL's token
-* covers the transform it was signed with, so sign it with `renderUrl()`.
-*
-* ```ts
-* const imageUrl = storageImageUrl({ url: SUPABASE_URL })
-* imageUrl(avatar, { width: 96 }) ?? avatar
-* ```
-*/
-function storageImageUrl(options) {
-	const storage = `${options.url.replace(/\/+$/, "")}/storage/v1`;
-	const publicPrefixes = [`${storage}/object/public/`, `${storage}/render/image/public/`].map((prefix) => ({
-		prefix,
-		length: new URL(prefix).pathname.length
-	}));
-	return (src, size) => {
-		const prefix = publicPrefixes.find((candidate) => src.startsWith(candidate.prefix));
-		if (prefix === void 0) return;
-		const source = new URL(src);
-		const object = source.pathname.slice(prefix.length);
-		const target = new URL(`${storage}/render/image/public/${object}`);
-		for (const [key, value] of source.searchParams) target.searchParams.set(key, value);
-		target.searchParams.set("width", String(clamp(size.width, 1, MAX_SIDE)));
-		if (size.height !== void 0) target.searchParams.set("height", String(clamp(size.height, 1, MAX_SIDE)));
-		if (size.quality !== void 0) target.searchParams.set("quality", String(clamp(size.quality, QUALITY.min, QUALITY.max)));
-		if (options.resize) target.searchParams.set("resize", options.resize);
-		return target.toString();
-	};
-}
-//#endregion
-export { storageImageUrl as t };

package/dist/impersonation-D5chOkrO.d.ts

@@ -1,25 +0,0 @@
-//#region src/auth/impersonation.d.ts
-/** The admin acting as the user, from the RFC 8693 `act` claim. */
-interface Impersonator {
-  /** `act.kind`: a support session or an impersonated session. */
-  readonly kind: "support" | "impersonation";
-  readonly id: string;
-  readonly reason?: string;
-  /** The support session, when the admin started one (`act.session_id`). */
-  readonly sessionId?: string;
-  /** Whether the support session blocks writes (`act.read_only`). */
-  readonly readOnly?: boolean;
-}
-/** `actingAs(userId, claims, { actor, reason })`: who acts, and why (recorded by the audit module). */
-interface ImpersonationOptions {
-  readonly actor: string;
-  readonly reason: string;
-}
-/**
- * The admin in `claims.act`: a support session or an impersonated session
- * (`actorOf` reads the same level, so the two always agree). `undefined`
- * for a normal session, an OAuth client or agent chain, and an invalid `act`.
- */
-declare function impersonatorOf(claims: Readonly<Record<string, unknown>>): Impersonator | undefined;
-//#endregion
-export { Impersonator as n, impersonatorOf as r, ImpersonationOptions as t };

package/dist/impersonation-DxU6yHJV.js

@@ -1,62 +0,0 @@
-import { n as actorOf } from "./actor-CAL8mMih.js";
-//#region src/auth/impersonation.ts
-/** The `act` claim for an impersonated session. */
-function actClaim(options) {
-	return {
-		kind: "impersonation",
-		sub: options.actor,
-		reason: options.reason
-	};
-}
-/** The `act` claim that `impersonatorOf` reads back as `impersonator`. */
-function impersonatorClaim(impersonator) {
-	const reason = impersonator.reason === void 0 ? {} : { reason: impersonator.reason };
-	return impersonator.kind === "support" ? {
-		kind: "support",
-		sub: impersonator.id,
-		session_id: impersonator.sessionId,
-		read_only: impersonator.readOnly ?? true,
-		...reason
-	} : {
-		kind: "impersonation",
-		sub: impersonator.id,
-		...reason
-	};
-}
-/**
-* The admin in `claims.act`: a support session or an impersonated session
-* (`actorOf` reads the same level, so the two always agree). `undefined`
-* for a normal session, an OAuth client or agent chain, and an invalid `act`.
-*/
-function impersonatorOf(claims) {
-	const outcome = actorOf(claims);
-	const actor = outcome.ok ? outcome.actor : void 0;
-	if (actor === void 0) return;
-	switch (actor.kind) {
-		case "oauth-client":
-		case "agent": return;
-		case "support":
-		case "impersonation": return { ...actor };
-		default: return actor;
-	}
-}
-/**
-* The repository context of a signed-in user: the actor, with the
-* impersonator from `act`, and the claims. Every adapter builds it here, so
-* plugins see the same actor on the server, in middleware and in the browser.
-*/
-function userContext(user, claims) {
-	const impersonator = impersonatorOf(claims);
-	return {
-		actor: {
-			id: user.id,
-			kind: "user",
-			...user.role ? { role: user.role } : {},
-			...user.email ? { email: user.email } : {},
-			...impersonator ? { impersonator: impersonator.id } : {}
-		},
-		claims
-	};
-}
-//#endregion
-export { userContext as i, impersonatorClaim as n, impersonatorOf as r, actClaim as t };

package/dist/inbox-Du5aPwKB.d.ts

@@ -1,400 +0,0 @@
-/// <reference lib="esnext.temporal" />
-import { T as ErrorMapper, t as AsyncResult } from "./result-BREt7qOh.js";
-import { n as Logger } from "./logger-DWVYUmwi.js";
-import { t as BlockTransport } from "./block-transport-DezJPPA0.js";
-import { i as CursorPageOptions, r as BlockTemporalOptions } from "./block-helpers-CjcQM1yA.js";
-import { n as BlockHooks } from "./block-hooks-DcPJHztl.js";
-//#region src/blocks/inbox/types.d.ts
-/** The channels an inbox can sit on. */
-type InboxChannel = "in_app" | "email" | "slack" | "teams" | "discord" | "telegram" | "whatsapp" | "messenger" | "instagram" | "sms" | "github" | "linear" | "other";
-/** `bot`: the bot answers; `human`: staff answer; `paused`: nobody answers. */
-type BotMode = "bot" | "human" | "paused";
-type ConversationStatus = "open" | "pending" | "snoozed" | "resolved";
-type ConversationPriority = "low" | "normal" | "high" | "urgent";
-type MessageDirection = "inbound" | "outbound";
-type MessageKind = "message" | "note";
-type AuthorType = "contact" | "agent" | "bot" | "system";
-type DeliveryStatus = "queued" | "sent" | "delivered" | "read" | "failed";
-interface InboxRow {
-  readonly id: string;
-  readonly tenant: string;
-  readonly name: string;
-  readonly channel: InboxChannel;
-  readonly address: string | null;
-  readonly installationId: string | null;
-  readonly botMode: BotMode;
-  readonly settings: Readonly<Record<string, unknown>>;
-  readonly createdAt: Temporal.Instant;
-  readonly archivedAt: Temporal.Instant | null;
-}
-interface Contact {
-  readonly id: string;
-  readonly tenant?: string;
-  readonly userId: string | null;
-  readonly name: string | null;
-  readonly email: string | null;
-  readonly phone: string | null;
-  readonly avatarUrl: string | null;
-  readonly metadata?: Readonly<Record<string, unknown>>;
-}
-interface Conversation {
-  readonly id: string;
-  readonly tenant: string;
-  readonly inboxId: string;
-  readonly contactId: string;
-  readonly subject: string | null;
-  readonly status: ConversationStatus;
-  readonly priority: ConversationPriority;
-  readonly assigneeId: string | null;
-  readonly teamId: string | null;
-  readonly botMode: BotMode;
-  /** The Chat SDK thread id, or `inbox:<id>` for the in-app widget. */
-  readonly threadId: string;
-  readonly snoozedUntil: Temporal.Instant | null;
-  readonly lastMessageAt: Temporal.Instant | null;
-  readonly preview: string | null;
-  readonly firstResponseAt: Temporal.Instant | null;
-  readonly resolvedAt: Temporal.Instant | null;
-  readonly metadata: Readonly<Record<string, unknown>>;
-  readonly createdAt: Temporal.Instant;
-  readonly contact: Contact | null;
-  readonly inbox: {
-    readonly id: string;
-    readonly name: string;
-    readonly channel: InboxChannel;
-  } | null;
-  /** When the caller last read it. */
-  readonly lastReadAt: Temporal.Instant | null;
-  /** When the contact last read it; `null` for contacts and before they read. */
-  readonly contactReadAt: Temporal.Instant | null;
-  /** In lists: whether a message arrived after `lastReadAt`. */
-  readonly unread?: boolean;
-}
-interface MessageAttachment {
-  readonly path?: string;
-  readonly url?: string;
-  readonly name?: string;
-  readonly contentType?: string;
-  readonly size?: number;
-}
-interface MessageDelivery {
-  readonly channel: string;
-  readonly status: DeliveryStatus;
-  readonly error: string | null;
-}
-interface InboxMessage {
-  readonly id: string;
-  readonly conversationId: string;
-  readonly direction: MessageDirection;
-  readonly kind: MessageKind;
-  readonly authorType: AuthorType;
-  readonly authorId: string | null;
-  readonly body: string;
-  readonly format: "text" | "markdown";
-  readonly attachments: readonly MessageAttachment[];
-  /** Emoji to the actors (user ids or channel ids) who reacted. */
-  readonly reactions: Readonly<Record<string, readonly string[]>>;
-  readonly mentions: readonly string[];
-  readonly externalId: string | null;
-  readonly replyTo: string | null;
-  readonly metadata: Readonly<Record<string, unknown>>;
-  readonly createdAt: Temporal.Instant;
-  readonly editedAt: Temporal.Instant | null;
-  readonly deletedAt: Temporal.Instant | null;
-  readonly delivery?: MessageDelivery | null;
-}
-interface ConversationEvent {
-  readonly id: string;
-  readonly type: string;
-  readonly actorId: string | null;
-  readonly data: Readonly<Record<string, unknown>>;
-  readonly createdAt: Temporal.Instant;
-}
-interface InboxCounts {
-  readonly open: number;
-  readonly mine: number;
-  readonly unassigned: number;
-  readonly unread: number;
-}
-/** What `purgeContact` erased. */
-interface PurgedContact {
-  readonly conversations: number;
-  readonly messages: number;
-  /** Storage paths of the erased messages' attachments, for the caller to remove. */
-  readonly attachments: readonly string[];
-}
-interface InboundResult {
-  readonly conversationId: string;
-  readonly messageId: string;
-  readonly contactId: string;
-  readonly tenant: string;
-  /** A new conversation was opened for the thread. */
-  readonly created: boolean;
-  /** The message's `externalId` was already stored. */
-  readonly duplicate: boolean;
-}
-interface MessageTemplate {
-  readonly id: string;
-  readonly tenant: string;
-  readonly inboxId: string | null;
-  readonly name: string;
-  readonly channel: string;
-  readonly language: string;
-  readonly body: string;
-  readonly variables: readonly string[];
-  /** The provider's approved template name (WhatsApp). */
-  readonly externalId: string | null;
-}
-interface StoredInboundEvent {
-  readonly id: string;
-  readonly adapter: string;
-  readonly externalId: string | null;
-  readonly inboxId: string | null;
-  readonly tenant: string | null;
-  readonly headers: Readonly<Record<string, string>>;
-  readonly body: string;
-  readonly attempts: number;
-  readonly receivedAt: Temporal.Instant;
-}
-//#endregion
-//#region src/blocks/inbox/inbox.d.ts
-interface InboxOptions extends BlockTemporalOptions {
-  /**
-   * `sqlTransport(postgres.asUser(claims))` or `rpcTransport(supabase)` for a
-   * member or a contact; over the service role for webhooks and workers.
-   */
-  readonly transport: BlockTransport;
-  /** The module schema, or its API schema: `defineBlocks` passes it from `blocks.generated.ts`. Default `better_supabase`. */
-  readonly schema?: string;
-  readonly mappers?: readonly ErrorMapper[];
-  /** `withBlockHooks` hooks around the methods (ADR 0015). */
-  readonly hooks?: InboxHooks;
-  /** Receives the errors `after` hooks throw. */
-  readonly logger?: Logger;
-}
-interface CreateInboxInput {
-  readonly tenant: string;
-  readonly name: string;
-  readonly channel?: InboxChannel;
-  /** The channel's address: a phone number, a Slack team id, an email. */
-  readonly address?: string;
-  readonly botMode?: BotMode;
-  /** `widget: true` lets signed-in visitors open conversations in an in-app inbox. */
-  readonly settings?: Readonly<Record<string, unknown>>;
-}
-interface InboxPatch {
-  readonly name?: string;
-  readonly botMode?: BotMode;
-  readonly settings?: Readonly<Record<string, unknown>>;
-  readonly address?: string | null;
-  readonly installationId?: string | null;
-  readonly archived?: boolean;
-}
-interface ContactInput {
-  readonly id?: string;
-  readonly userId?: string;
-  readonly name?: string;
-  readonly email?: string;
-  readonly phone?: string;
-  readonly avatarUrl?: string;
-  readonly metadata?: Readonly<Record<string, unknown>>;
-  /** The contact's id on a channel, such as a WhatsApp number. */
-  readonly identity?: {
-    readonly channel: string;
-    readonly externalId: string;
-  };
-}
-interface MessageInput {
-  readonly body: string;
-  /** `note` is an internal note only staff see. */
-  readonly kind?: "message" | "note";
-  readonly format?: "text" | "markdown";
-  readonly attachments?: readonly MessageAttachment[];
-  /** User ids; those who cannot read the inbox are dropped. */
-  readonly mentions?: readonly string[];
-  readonly replyTo?: string;
-  readonly externalId?: string;
-  readonly metadata?: Readonly<Record<string, unknown>>;
-  /** For the service: who writes. Defaults to `bot`. */
-  readonly authorType?: "contact" | "bot" | "system";
-  /** For the service: the caller posts to the channel itself, so no outbound job is queued. */
-  readonly deliveredByCaller?: boolean;
-}
-interface StartConversationInput {
-  /**
-   * A contact id or the fields to find or create one. Leave it out on a
-   * widget inbox to open the conversation as the signed-in visitor, staff
-   * included.
-   */
-  readonly contact?: string | ContactInput;
-  readonly subject?: string;
-  readonly priority?: ConversationPriority;
-  readonly botMode?: BotMode;
-  /** The Chat SDK thread id. Defaults to `inbox:<conversation id>`. */
-  readonly threadId?: string;
-  readonly assigneeId?: string;
-  readonly metadata?: Readonly<Record<string, unknown>>;
-  readonly message?: string | MessageInput;
-}
-interface InboundInput {
-  readonly inboxId: string;
-  readonly threadId: string;
-  readonly contact: ContactInput & {
-    /** Shorthand for `identity` on the inbox's channel. */
-    readonly externalId?: string;
-  };
-  readonly message: Omit<MessageInput, "kind" | "authorType">;
-  readonly subject?: string;
-  /** `outbound` records a message sent from the platform by someone else. */
-  readonly direction?: "inbound" | "outbound";
-  readonly metadata?: Readonly<Record<string, unknown>>;
-}
-interface ConversationFilter extends CursorPageOptions<Pick<Conversation, "id" | "lastMessageAt">> {
-  readonly inboxId?: string;
-  /** Defaults to `open`. */
-  readonly status?: ConversationStatus | "all";
-  readonly assignee?: "me" | "unassigned" | (string & {});
-  readonly teamId?: string;
-  readonly contactId?: string;
-  readonly search?: string;
-  /** The last item of the previous page. */
-  readonly cursor?: Pick<Conversation, "id" | "lastMessageAt">;
-  /** Up to 200. Defaults to 50. */
-  readonly limit?: number;
-}
-interface TemplateInput {
-  readonly name: string;
-  readonly channel: string;
-  readonly body: string;
-  readonly language?: string;
-  readonly inboxId?: string;
-  readonly variables?: readonly string[];
-  readonly externalId?: string;
-}
-/** The `inbox` SQL module as typed calls. */
-/** Hooks for `Inbox`: the top-level methods, and each group's under its name. */
-type InboxHooks = BlockHooks<Inbox> & {
-  readonly inboxes?: BlockHooks<Inbox["inboxes"]>;
-  readonly contacts?: BlockHooks<Inbox["contacts"]>;
-  readonly conversations?: BlockHooks<Inbox["conversations"]>;
-  readonly messages?: BlockHooks<Inbox["messages"]>;
-  readonly deliveries?: BlockHooks<Inbox["deliveries"]>;
-  readonly templates?: BlockHooks<Inbox["templates"]>;
-  readonly inbound?: BlockHooks<Inbox["inbound"]>;
-};
-interface Inbox {
-  readonly inboxes: {
-    create(input: CreateInboxInput): AsyncResult<InboxRow>;
-    update(id: string, patch: InboxPatch): AsyncResult<InboxRow>;
-    /** `null` removes the member. */
-    setMember(inboxId: string, userId: string, role: "agent" | "lead" | null): AsyncResult<boolean>;
-    createTeam(tenant: string, name: string): AsyncResult<{
-      readonly id: string;
-      readonly name: string;
-    }>;
-    setTeamMember(teamId: string, userId: string, present?: boolean): AsyncResult<boolean>;
-  };
-  readonly contacts: {
-    /** Finds the contact by id, identity, user or email, filling in what is missing. */
-    upsert(tenant: string, input: ContactInput): AsyncResult<Contact>;
-  };
-  readonly conversations: {
-    open(inboxId: string, input?: StartConversationInput): AsyncResult<Conversation>;
-    list(tenant: string | null, filter?: ConversationFilter): AsyncResult<readonly Conversation[]>;
-    get(conversationId: string): AsyncResult<Conversation | null>;
-    assign(conversationId: string, to: {
-      readonly assigneeId: string | null;
-      readonly teamId?: string | null;
-    }): AsyncResult<Conversation>;
-    setStatus(conversationId: string, status: ConversationStatus, options?: {
-      readonly snoozedUntil?: Temporal.Instant;
-    }): AsyncResult<Conversation>;
-    snooze(conversationId: string, until: Temporal.Instant): AsyncResult<Conversation>;
-    resolve(conversationId: string): AsyncResult<Conversation>;
-    reopen(conversationId: string): AsyncResult<Conversation>;
-    /** Hands a bot conversation to staff (`bot_mode = 'human'`) and tells them. */
-    handoff(conversationId: string, reason?: string): AsyncResult<Conversation>;
-    setBotMode(conversationId: string, mode: BotMode, reason?: string): AsyncResult<Conversation>;
-    markRead(conversationId: string): AsyncResult<Temporal.Instant>;
-    /** A typing ping on `inbox:<id>`; the service names the bot in `actor`. */
-    typing(conversationId: string, typing?: boolean, actor?: string): AsyncResult<boolean>;
-    events(conversationId: string): AsyncResult<readonly ConversationEvent[]>;
-    counts(tenant: string): AsyncResult<InboxCounts>;
-  };
-  readonly messages: {
-    send(conversationId: string, input: MessageInput): AsyncResult<InboxMessage>;
-    /** An internal note only staff see. */
-    note(conversationId: string, body: string, input?: Pick<MessageInput, "mentions" | "attachments" | "format">): AsyncResult<InboxMessage>;
-    list(conversationId: string, options?: CursorPageOptions<Temporal.Instant>): AsyncResult<readonly InboxMessage[]>;
-    get(messageId: string): AsyncResult<InboxMessage | null>;
-    edit(messageId: string, body: string): AsyncResult<InboxMessage>;
-    /** Leaves a tombstone with an empty body. */
-    remove(messageId: string): AsyncResult<InboxMessage>;
-    react(messageId: string, emoji: string, options?: {
-      readonly present?: boolean;
-      readonly actor?: string;
-    }): AsyncResult<Readonly<Record<string, readonly string[]>>>;
-  };
-  readonly deliveries: {
-    /** Service only: after posting a message on its channel. */
-    record(input: {
-      readonly messageId: string;
-      readonly channel: string;
-      readonly externalId?: string;
-      readonly status?: DeliveryStatus;
-      readonly error?: string;
-    }): AsyncResult<void>;
-    /** Service only: a status callback; returns how many deliveries moved. */
-    setStatus(input: {
-      readonly channel: string;
-      readonly externalId: string;
-      readonly status: DeliveryStatus;
-      readonly error?: string;
-    }): AsyncResult<number>;
-  };
-  readonly templates: {
-    upsert(tenant: string, input: TemplateInput): AsyncResult<MessageTemplate>;
-    delete(id: string): AsyncResult<boolean>;
-  };
-  /** Service only: channel messages, the webhook store and its sweeps. */
-  readonly inbound: {
-    /** A message that arrived on a channel: finds or opens the thread's conversation. */
-    record(input: InboundInput): AsyncResult<InboundResult>;
-    store(input: {
-      readonly adapter: string;
-      readonly body: string;
-      readonly externalId?: string;
-      readonly headers?: Readonly<Record<string, string>>;
-      readonly inboxId?: string;
-      readonly tenant?: string;
-    }): AsyncResult<{
-      readonly id: string;
-      readonly duplicate: boolean;
-    }>;
-    setStatus(id: string, status: "processing" | "processed" | "ignored" | "failed", error?: string): AsyncResult<boolean>;
-    pending(options?: {
-      readonly limit?: number;
-      readonly maxAttempts?: number;
-    }): AsyncResult<readonly StoredInboundEvent[]>;
-    purge(options?: {
-      readonly olderThan?: number | string;
-      readonly batch?: number;
-    }): AsyncResult<number>;
-  };
-  /** Service only: reopens snoozed conversations whose time came. */
-  wakeSnoozed(): AsyncResult<number>;
-  /**
-   * Erases a contact and its conversations for a data subject request
-   * (`inbox.manage` or the service). Remove the returned attachment paths
-   * from Storage afterwards.
-   */
-  purgeContact(contactId: string): AsyncResult<PurgedContact>;
-}
-/**
- * The `inbox` SQL module as typed calls: inboxes, contacts, conversations,
- * messages and notes, assignment, bot hand-off, read state, deliveries and
- * the stored webhook events. The database checks every permission.
- */
-declare function createInbox(options: InboxOptions): Inbox;
-//#endregion
-export { MessageTemplate as A, InboxCounts as C, MessageDelivery as D, MessageAttachment as E, StoredInboundEvent as M, MessageDirection as O, InboxChannel as S, InboxRow as T, ConversationEvent as _, Inbox as a, DeliveryStatus as b, InboxPatch as c, TemplateInput as d, createInbox as f, Conversation as g, Contact as h, InboundInput as i, PurgedContact as j, MessageKind as k, MessageInput as l, BotMode as m, ConversationFilter as n, InboxHooks as o, AuthorType as p, CreateInboxInput as r, InboxOptions as s, ContactInput as t, StartConversationInput as u, ConversationPriority as v, InboxMessage as w, InboundResult as x, ConversationStatus as y };