better-supabase 0.13.0 → 0.14.0

package/dist/carrier-C7Q_21Kd.d.ts

@@ -0,0 +1,169 @@
+/// <reference lib="esnext.temporal" />
+import { b as DbError, f as Result, t as AsyncResult } from "./result-C6jDfedy.js";
+import { n as Money } from "./money-BNRdJQzA.js";
+import { n as VerifyOptions, r as WebhookInput } from "./signatures-zbu6KTNQ.js";
+//#region src/blocks/shipments/statuses.d.ts
+declare const LABEL_FORMATS: readonly ["pdf", "png", "zpl"];
+type LabelFormat = (typeof LABEL_FORMATS)[number];
+/** The stages a carrier reports, in the order a parcel goes through them. */
+declare const TRACKING_STATUSES: readonly ["label_created", "in_transit", "out_for_delivery", "delivered", "exception", "returned"];
+type TrackingStatus = (typeof TRACKING_STATUSES)[number];
+/** Where a shipment is: a draft, then the status of its latest tracking event. */
+declare const SHIPMENT_STATUSES: readonly ["draft", "label_created", "in_transit", "out_for_delivery", "delivered", "exception", "returned", "cancelled"];
+type ShipmentStatus = (typeof SHIPMENT_STATUSES)[number];
+//#endregion
+//#region src/blocks/shipments/carrier.d.ts
+/** A sender or recipient address. */
+interface ShipmentAddress {
+  readonly name?: string;
+  readonly company?: string;
+  readonly line1: string;
+  readonly line2?: string;
+  readonly city: string;
+  readonly postalCode?: string;
+  /** The state or province code, such as `CA`. */
+  readonly state?: string;
+  /** ISO 3166-1 alpha-2, such as `NL`. */
+  readonly country: string;
+  readonly phone?: string;
+  readonly email?: string;
+}
+/** One package of a shipment. */
+interface ShipmentParcel {
+  readonly weightGrams: number;
+  readonly lengthMm?: number;
+  readonly widthMm?: number;
+  readonly heightMm?: number;
+  readonly reference?: string;
+}
+interface ShipmentRateRequest {
+  readonly from: ShipmentAddress;
+  readonly to: ShipmentAddress;
+  readonly parcels: readonly ShipmentParcel[];
+  /** The currency to quote in, when the carrier offers a choice. */
+  readonly currency?: string;
+}
+interface ShipmentRate {
+  /** The carrier's `name`. */
+  readonly carrier: string;
+  /** The carrier's service code, such as `standard` or `express`. */
+  readonly service: string;
+  readonly amount: Money;
+  readonly estimatedDays?: number;
+}
+interface ShipmentLabelRequest extends ShipmentRateRequest {
+  /** A service code one of `rates` returned. */
+  readonly service: string;
+  /** The shipment's reference, printed on the label. */
+  readonly reference: string;
+}
+interface ShipmentLabel {
+  /** The carrier's id for the label; `cancel` takes it. */
+  readonly labelId: string;
+  readonly trackingNumber: string;
+  readonly service: string;
+  readonly cost: Money;
+  readonly format: LabelFormat;
+  /** Where to download the label, when the carrier hosts it. */
+  readonly labelUrl?: string;
+  /** The carrier's public tracking page. */
+  readonly trackingUrl?: string;
+}
+interface CarrierTrackingEvent {
+  /**
+   * The carrier's id for the event. A redelivered or re-polled event repeats
+   * it, so the block records each id once per shipment.
+   */
+  readonly id: string;
+  readonly status: TrackingStatus;
+  readonly occurredAt: Temporal.Instant;
+  readonly description?: string;
+  readonly location?: string;
+}
+/** The events of one tracking number, as a webhook delivers them. */
+interface CarrierTrackingUpdate {
+  readonly trackingNumber: string;
+  readonly events: readonly CarrierTrackingEvent[];
+}
+interface CarrierCancelInput {
+  readonly labelId: string;
+  readonly trackingNumber: string;
+}
+interface CarrierCallOptions {
+  /** The same key returns the first call's result instead of buying twice. */
+  readonly idempotencyKey?: string;
+  readonly signal?: AbortSignal;
+}
+/**
+ * Quotes, buys, tracks and voids shipping labels. Versioned: a breaking change
+ * ships a new `apiVersion`. Every method returns a `Result`: `invalid_input`
+ * for a request the carrier can't ship (no parcels, an unknown service),
+ * `not_found` for an unknown tracking number or label, `conflict` for a label
+ * the carrier can no longer void, and `unauthorized` for a webhook whose
+ * signature fails.
+ */
+interface ShipmentCarrier {
+  readonly apiVersion: 1;
+  /** The carrier's name, stored on each shipment it labels. */
+  readonly name: string;
+  rates(request: ShipmentRateRequest, options?: CarrierCallOptions): AsyncResult<readonly ShipmentRate[]>;
+  createLabel(request: ShipmentLabelRequest, options?: CarrierCallOptions): AsyncResult<ShipmentLabel>;
+  /** The tracking number's events so far, oldest first. */
+  track(trackingNumber: string, options?: CarrierCallOptions): AsyncResult<readonly CarrierTrackingEvent[]>;
+  /** Voids a label that hasn't shipped. */
+  cancel(input: CarrierCancelInput, options?: CarrierCallOptions): AsyncResult<{
+    readonly cancelled: true;
+  }>;
+  /**
+   * Verifies a tracking webhook with the carrier's secret and returns its
+   * updates. Unset for a carrier that only answers `track`.
+   */
+  parseWebhook?(input: WebhookInput): AsyncResult<readonly CarrierTrackingUpdate[]>;
+}
+/** Checks the carrier's `apiVersion` before a block uses it. */
+declare function shipmentCarrierOf(carrier: ShipmentCarrier): ShipmentCarrier;
+/**
+ * The first problem with a rate or label request: an address without a line,
+ * city or two-letter country, no parcels, or a parcel whose weight or size
+ * isn't a positive whole number.
+ */
+declare function invalidShipmentRequest(request: ShipmentRateRequest): DbError | undefined;
+interface FlatRateService {
+  /** The price of the first package. */
+  readonly amount: Money;
+  /** The price of each further package. Defaults to `amount`. */
+  readonly additional?: Money;
+  readonly estimatedDays?: number;
+}
+interface FlatRateCarrierOptions {
+  /** Defaults to `flat-rate`. */
+  readonly name?: string;
+  /** Services by code, such as `{ standard: { amount: money(695n, "EUR") } }`. */
+  readonly services: Readonly<Record<string, FlatRateService>>;
+  /** Prefixes generated tracking numbers. Defaults to `FR`. */
+  readonly trackingPrefix?: string;
+  /**
+   * Standard Webhooks secrets (`whsec_…`) for `parseWebhook`. Unset: the
+   * carrier has no `parseWebhook`.
+   */
+  readonly webhookSecret?: string | readonly string[];
+  /** Passed to `verifyWebhook`, such as a `seen` store against replays. */
+  readonly verify?: VerifyOptions;
+}
+/**
+ * Reads a tracking webhook body in the flat-rate format: `{ "trackingNumber":
+ * "…", "events": [{ "id", "status", "occurredAt", "description"?, "location"?
+ * }] }`, or an array of those.
+ */
+declare function trackingUpdatesOf(payload: unknown): Result<readonly CarrierTrackingUpdate[]>;
+/**
+ * A `ShipmentCarrier` with fixed prices per service and package. It stores
+ * nothing beyond the labels of recent idempotency keys: labels carry a
+ * generated tracking number and no file, `track` returns no events, and
+ * `cancel` always succeeds. With `webhookSecret` it reads Standard Webhooks
+ * tracking updates in the format of `trackingUpdatesOf`, so drivers, a
+ * forwarding service or tests can post tracking events.
+ */
+declare function flatRateCarrier(options: FlatRateCarrierOptions): ShipmentCarrier;
+//#endregion
+export { TrackingStatus as C, TRACKING_STATUSES as S, trackingUpdatesOf as _, FlatRateCarrierOptions as a, SHIPMENT_STATUSES as b, ShipmentCarrier as c, ShipmentParcel as d, ShipmentRate as f, shipmentCarrierOf as g, invalidShipmentRequest as h, CarrierTrackingUpdate as i, ShipmentLabel as l, flatRateCarrier as m, CarrierCancelInput as n, FlatRateService as o, ShipmentRateRequest as p, CarrierTrackingEvent as r, ShipmentAddress as s, CarrierCallOptions as t, ShipmentLabelRequest as u, LABEL_FORMATS as v, ShipmentStatus as x, LabelFormat as y };

package/dist/chat-sdk/index.d.ts

@@ -1,10 +1,12 @@
 /// <reference lib="esnext.temporal" />
-import { T as ErrorMapper, t as AsyncResult } from "../result-mijqfoJN.js";
-import { a as CredentialSubject, i as CredentialRef, o as CredentialToken, r as CredentialProvider } from "../provider-Dmsbl8ug.js";
-import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../block-transport-DBPhgF3W.js";
-import { o as StreamStore } from "../store-DKqbuNvw.js";
-import { c as ChatActionHook, d as IdentityRef, f as IdentityTarget, i as AuthorizationHooks, p as PrincipalByIdentity, s as ChatAction, t as ApprovalRequestRef } from "../authorization-hooks-HXVZXxUk.js";
-import { E as MessageAttachment, M as StoredInboundEvent, a as Inbox, b as DeliveryStatus, g as Conversation, w as InboxMessage, x as InboundResult } from "../inbox-CLsIrPXs.js";
+import { T as ErrorMapper, t as AsyncResult } from "../result-C6jDfedy.js";
+import { a as CredentialSubject, i as CredentialRef, o as CredentialToken, r as CredentialProvider } from "../provider-DmiaI1qt.js";
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../block-transport-d53POsem.js";
+import { o as StreamStore } from "../store-o0HwYXl8.js";
+import { u as MessageFile } from "../messaging-CZ6aWb10.js";
+import { c as ChatActionHook, d as IdentityRef, f as IdentityTarget, i as AuthorizationHooks, p as PrincipalByIdentity, s as ChatAction, t as ApprovalRequestRef } from "../authorization-hooks-dLmUO_PZ.js";
+import { S as StoredInboundEvent, c as DeliveryStatus, f as InboxFileSource, i as Conversation, l as InboundResult, p as InboxMessage, y as PendingInboxFile } from "../types-DkPE7yd2.js";
+import { a as Inbox } from "../inbox-BPBb6etH.js";
 import { Adapter, AdapterPostableMessage, Attachment, Author, Message, RawMessage, StateAdapter, WebhookOptions } from "chat";
 //#region src/chat-sdk/delivery.d.ts
 /** One status callback for a message the bot sent on a channel. */
@@ -128,12 +130,13 @@ interface InboundHandlerOptions {
   /**
    * Copies a platform file into storage for the inbox. Without it a file is
    * kept only when it has a public URL; platform URLs often need the bot's
-   * token, so copy them.
+   * token, so copy them. Either way the inbox stores it as a pending attachment
+   * that `importFiles` fetches.
    */
   readonly copyFile?: (file: Attachment, context: {
     readonly adapter: string;
     readonly threadId: string;
-  }) => Promise<MessageAttachment | null>;
+  }) => Promise<InboxFileSource | null>;
   /**
    * The URL replayed requests carry. Defaults to
    * `https://inbox.local/<adapter>`.
@@ -161,6 +164,26 @@ interface InboundHandler {
    * `null` for those.
    */
   mirror(thread: MirrorThread, message: Message): Promise<InboundResult | null>;
+  /**
+   * Fetches the channel files the inbox holds as pending attachments, writes
+   * each to Storage and confirms it; a file that fails is marked `failed`.
+   */
+  importFiles(options: ImportFilesOptions): Promise<DrainResult>;
+}
+interface ImportFilesOptions {
+  /**
+   * Writes the bytes to `file.bucket` at `file.path`, such as
+   * `supabase.storage.from(file.bucket).upload(file.path, data)` with the
+   * service role.
+   */
+  readonly write: (file: PendingInboxFile, data: Blob) => Promise<void>;
+  /**
+   * Reads a file. Defaults to fetching `file.source.url`; a source with only a
+   * `path` (in `file.source.bucket`) fails until you pass `read`.
+   */
+  readonly read?: (file: PendingInboxFile) => Promise<Blob>;
+  /** Defaults to 50. */
+  readonly limit?: number;
 }
 /** Replays stored webhook events and mirrors channel messages into the inbox. */
 export declare function inboundHandler(options: InboundHandlerOptions): InboundHandler;
@@ -221,13 +244,16 @@ interface MaintainOptions {
 }
 interface MaintainResult {
   readonly woken: number;
+  /** Scheduled replies sent. */
+  readonly published: number;
   readonly purgedEvents: number;
   readonly replayed: DrainResult;
   readonly purgedState: number;
 }
 /**
- * The inbox's periodic work: wake snoozed conversations, replay and purge
- * webhook events, sweep state. Run it from a cron job.
+ * The inbox's periodic work: wake snoozed conversations, send the scheduled
+ * replies whose time came, replay and purge webhook events, sweep state. Run it
+ * from a cron job.
  */
 export declare function maintain(options: MaintainOptions): Promise<MaintainResult>;
 //#endregion
@@ -384,6 +410,12 @@ interface InboxAdapterOptions {
    * stays a visitor and gets no ticket.
    */
   readonly identities?: Omit<BotJobsOptions<unknown, unknown>, "enqueue">;
+  /**
+   * Reads a scanned attachment, such as from Storage with the service role. The
+   * bot gets each clean file with its attachment id in `fetchMetadata`; with
+   * `download` it can also read the bytes.
+   */
+  readonly download?: (file: MessageFile) => Promise<ArrayBuffer>;
 }
 interface InboxAdapter extends Adapter<string, InboxMessage> {
   readonly name: "inbox";
@@ -500,4 +532,4 @@ interface SupabaseState extends StateAdapter {
  */
 export declare function createSupabaseState(options: SupabaseStateOptions): SupabaseState;
 //#endregion
-export { type ApprovalPromptOptions, type BlockTransport, type BotJobEnqueueOptions, type BotJobs, type BotJobsOptions, type ChannelAdapterOptions, type ChatActionDecision, type ChatActionRefusal, type ChatActionsOptions, type ChatIdentityOptions, type ChatInstallation, type ChatInstallations, type ChatInstallationsOptions, type ChatLike, type DeliverOptions, type DeliveryParser, type DeliveryUpdate, type DrainResult, type EnqueuedBotJob, type InboundHandler, type InboundHandlerOptions, type InboxAdapter, type InboxAdapterOptions, type InboxBotJob, type InboxOutboundJob, type InboxWebhookOptions, type InstallInput, type MaintainOptions, type MaintainResult, type MirrorThread, type ParsedDeliveries, type SupabaseState, type SupabaseStateOptions, dbTransport, rpcTransport, sqlTransport };
+export { type ApprovalPromptOptions, type BlockTransport, type BotJobEnqueueOptions, type BotJobs, type BotJobsOptions, type ChannelAdapterOptions, type ChatActionDecision, type ChatActionRefusal, type ChatActionsOptions, type ChatIdentityOptions, type ChatInstallation, type ChatInstallations, type ChatInstallationsOptions, type ChatLike, type DeliverOptions, type DeliveryParser, type DeliveryUpdate, type DrainResult, type EnqueuedBotJob, type ImportFilesOptions, type InboundHandler, type InboundHandlerOptions, type InboxAdapter, type InboxAdapterOptions, type InboxBotJob, type InboxOutboundJob, type InboxWebhookOptions, type InstallInput, type MaintainOptions, type MaintainResult, type MirrorThread, type ParsedDeliveries, type SupabaseState, type SupabaseStateOptions, dbTransport, rpcTransport, sqlTransport };

package/dist/chat-sdk/index.js

@@ -1,8 +1,7 @@
 import { s as nowInstant } from "../temporal-DLZlWbOi.js";
 import { n as isRecord } from "../guards-6F2bCtQR.js";
-import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../block-transport-Ds0C2mUf.js";
-import { C as optionalText, I as textOf, R as toInstant, T as randomToken, f as errorText, j as run, o as blockCall } from "../block-helpers-DwE32_gT.js";
-import { r as writeToStore } from "../tee-1fsH3bEz.js";
+import { B as dbTransport, C as optionalText, H as rpcTransport, I as textOf, R as toInstant, T as randomToken, U as sqlTransport, f as errorText, j as run, o as blockCall } from "../block-helpers-CiKtrb6g.js";
+import { r as writeToStore } from "../tee-DwkUvJD_.js";
 import { BaseFormatConverter, Message, defaultEmojiResolver, parseMarkdown, stringifyMarkdown } from "chat";
 //#region src/chat-sdk/delivery.ts
 const STATUSES = {
@@ -154,6 +153,12 @@ function webhook(options) {
 		return new Response("ok", { status: 200 });
 	};
 }
+async function readSource(file) {
+	if (file.source.url === void 0) throw new Error(`file ${file.id} has no URL; pass read`);
+	const response = await fetch(file.source.url);
+	if (!response.ok) throw new Error(`${file.source.url} answered ${String(response.status)}`);
+	return response.blob();
+}
 /** Replays stored webhook events and mirrors channel messages into the inbox. */
 function inboundHandler(options) {
 	const { chat, inbox } = options;
@@ -237,7 +242,7 @@ function inboundHandler(options) {
 			if (await chat.getState().get(echoKey(adapter, message.id)) !== null) return null;
 			const inboxId = options.inboxes[adapter];
 			if (inboxId === void 0) throw new Error(`inboundHandler: no inbox for adapter "${adapter}"`);
-			const attachments = await files(message, adapter, thread.id);
+			const sources = await files(message, adapter, thread.id);
 			return inbox.inbound.record({
 				inboxId,
 				threadId: thread.id,
@@ -249,9 +254,27 @@ function inboundHandler(options) {
 				message: {
 					body: message.text,
 					externalId: message.id,
-					...attachments.length > 0 ? { attachments } : {}
+					...sources.length > 0 ? { files: sources } : {}
 				}
 			}).orThrow();
+		},
+		importFiles: async (importOptions) => {
+			const read = importOptions.read ?? readSource;
+			const pending = await inbox.files.pending(importOptions.limit ?? 50).orThrow();
+			let processed = 0;
+			let failed = 0;
+			for (const file of pending) try {
+				await importOptions.write(file, await read(file));
+				await inbox.files.stored(file.id).orThrow();
+				processed += 1;
+			} catch (error) {
+				await inbox.files.failed(file.id, errorText(error));
+				failed += 1;
+			}
+			return {
+				processed,
+				failed
+			};
 		}
 	};
 }
@@ -275,7 +298,7 @@ function deliver(options) {
 	const { chat, inbox } = options;
 	return async (job) => {
 		const message = await inbox.messages.get(job.message_id).orThrow();
-		if (message?.kind !== "message" || message.deletedAt !== null) return null;
+		if (message?.kind !== "message" || message.deletedAt !== void 0) return null;
 		const conversation = await inbox.conversations.get(message.conversationId).orThrow();
 		if (!conversation) return null;
 		const name = options.adapterFor?.(conversation) ?? (conversation.inbox?.channel === "sms" ? "twilio" : conversation.inbox?.channel);
@@ -309,17 +332,20 @@ function deliver(options) {
 	};
 }
 /**
-* The inbox's periodic work: wake snoozed conversations, replay and purge
-* webhook events, sweep state. Run it from a cron job.
+* The inbox's periodic work: wake snoozed conversations, send the scheduled
+* replies whose time came, replay and purge webhook events, sweep state. Run it
+* from a cron job.
 */
 async function maintain(options) {
 	const woken = await options.inbox.wakeSnoozed().orThrow();
+	const published = await options.inbox.publishDue().orThrow();
 	const replayed = options.handler ? await options.handler.drain() : {
 		processed: 0,
 		failed: 0
 	};
 	return {
 		woken,
+		published,
 		purgedEvents: await options.inbox.inbound.purge({ olderThan: options.keepEvents ?? "7 days" }).orThrow(),
 		replayed,
 		purgedState: options.state ? await options.state.purge() : 0
@@ -500,16 +526,16 @@ function bodyOf(message) {
 	};
 }
 const emojiOf = (value) => typeof value === "string" ? value : defaultEmojiResolver.toGChat(value);
-function attachmentsOf(message) {
+function attachmentsOf(message, download) {
 	return message.attachments.flatMap((file) => {
-		const url = file.url;
-		if (url === void 0) return [];
+		if (file.status !== "clean") return [];
 		return [{
-			type: file.contentType?.startsWith("image/") ? "image" : file.contentType?.startsWith("video/") ? "video" : file.contentType?.startsWith("audio/") ? "audio" : "file",
-			url,
-			...file.name === void 0 ? {} : { name: file.name },
-			...file.contentType === void 0 ? {} : { mimeType: file.contentType },
-			...file.size === void 0 ? {} : { size: file.size }
+			type: file.mimeType?.startsWith("image/") ? "image" : file.mimeType?.startsWith("video/") ? "video" : file.mimeType?.startsWith("audio/") ? "audio" : "file",
+			name: file.name,
+			fetchMetadata: { attachmentId: file.id },
+			...file.mimeType === void 0 ? {} : { mimeType: file.mimeType },
+			...file.size === void 0 ? {} : { size: file.size },
+			...download === void 0 ? {} : { fetchData: () => download(file) }
 		}];
 	});
 }
@@ -560,11 +586,11 @@ function inboxAdapter(options) {
 				...raw.authorType === "system" ? { isSystem: true } : {}
 			},
 			metadata: {
-				dateSent: new Date(raw.createdAt.epochMilliseconds),
-				edited: raw.editedAt !== null,
-				...raw.editedAt === null ? {} : { editedAt: new Date(raw.editedAt.epochMilliseconds) }
+				dateSent: new Date((raw.sentAt ?? raw.createdAt).epochMilliseconds),
+				edited: raw.editedAt !== void 0,
+				...raw.editedAt === void 0 ? {} : { editedAt: new Date(raw.editedAt.epochMilliseconds) }
 			},
-			attachments: attachmentsOf(raw)
+			attachments: attachmentsOf(raw, options.download)
 		});
 	};
 	const rawOf = (message) => ({
@@ -586,8 +612,9 @@ function inboxAdapter(options) {
 		const message = await inbox.messages.get(job.message_id).orThrow();
 		if (message?.conversationId !== job.conversation_id || message.authorType !== "contact" || message.kind !== "message") return;
 		const parsed = parseMessage(message);
-		if (ticketJobs !== void 0 && message.authorId !== null) {
-			const { result } = await ticketJobs.enqueue(inboxIdentityOf(message.authorId), parsed);
+		const contactId = ticketJobs === void 0 ? void 0 : (await inbox.conversations.get(message.conversationId).orThrow())?.contactId;
+		if (ticketJobs !== void 0 && contactId !== void 0) {
+			const { result } = await ticketJobs.enqueue(inboxIdentityOf(contactId), parsed);
 			if (result !== void 0) tickets.set(message.id, result);
 		}
 		try {
@@ -672,7 +699,7 @@ function inboxAdapter(options) {
 			const oldest = page[0];
 			return {
 				messages: visible.map(parseMessage),
-				...oldest !== void 0 && page.length >= limit ? { nextCursor: oldest.createdAt.toString() } : {}
+				...oldest !== void 0 && page.length >= limit ? { nextCursor: (oldest.sentAt ?? oldest.createdAt).toString() } : {}
 			};
 		},
 		fetchThread: async (threadId) => {

package/dist/chat-sdk/react/index.d.ts

@@ -1,3 +1,3 @@
-import { l as InboxSource } from "../../client-BU5Yd0yO.js";
-import { a as UseInboxOptions, c as useInbox, i as UseConversationOptions, l as useInboxWidget, n as InboxListState, o as UseInboxWidgetOptions, r as InboxWidgetState, s as useConversation, t as ConversationState } from "../../index-DLjs7j_z.js";
+import { u as InboxSource } from "../../client-7_4Y21ue.js";
+import { a as UseInboxOptions, c as useInbox, i as UseConversationOptions, l as useInboxWidget, n as InboxListState, o as UseInboxWidgetOptions, r as InboxWidgetState, s as useConversation, t as ConversationState } from "../../index-U0o7kU0s.js";
 export { type ConversationState, type InboxListState, type InboxSource, type InboxWidgetState, type UseConversationOptions, type UseInboxOptions, type UseInboxWidgetOptions, useConversation, useInbox, useInboxWidget };

package/dist/chat-sdk/react/server.d.ts

@@ -1,4 +1,4 @@
-import { l as InboxSource } from "../../client-BU5Yd0yO.js";
-import { a as UseInboxOptions, i as UseConversationOptions, n as InboxListState, o as UseInboxWidgetOptions, r as InboxWidgetState, t as ConversationState } from "../../index-DLjs7j_z.js";
+import { u as InboxSource } from "../../client-7_4Y21ue.js";
+import { a as UseInboxOptions, i as UseConversationOptions, n as InboxListState, o as UseInboxWidgetOptions, r as InboxWidgetState, t as ConversationState } from "../../index-U0o7kU0s.js";
 import { useConversation, useInbox, useInboxWidget } from "../../blocks/inbox/react/server.js";
 export { type ConversationState, type InboxListState, type InboxSource, type InboxWidgetState, type UseConversationOptions, type UseInboxOptions, type UseInboxWidgetOptions, useConversation, useInbox, useInboxWidget };

package/dist/cli/add-Bf3kE6PY.js

@@ -0,0 +1,75 @@
+import { n as CliError } from "./errors-BTe6A15O.js";
+import { D as providerLabel, _ as providerOwnsMemberships, g as layoutFor, m as MEMBERSHIP_CLAIM_MODULES } from "./module-migration-CbX-jRhV.js";
+import { n as applyPlan } from "./files-C5JfVnj5.js";
+import { n as addBlocksToJson, s as keyText, t as addBlocksToConfig } from "./config-edit-D46H0UHp.js";
+import { a as write, i as unlistedModuleFiles, n as nextStep } from "./write-3qdrpS1v.js";
+import { basename, dirname } from "node:path";
+import { readFile } from "node:fs/promises";
+import { SQL_MODULES, resolveModules } from "better-supabase/sql";
+//#region src/cli/sql/add.ts
+async function addModules(config, args, names, deps) {
+	if (names.length === 0) throw new CliError("input_required", "Name at least one module.", {
+		missing: ["<module>"],
+		choices: { "<module>": Object.keys(SQL_MODULES) }
+	});
+	const unknown = names.filter((name) => !(name in SQL_MODULES));
+	if (unknown.length > 0) throw new CliError("usage", `Unknown module ${unknown.join(", ")}. Available: ${Object.keys(SQL_MODULES).join(", ")}`);
+	const owner = config.authorization && providerOwnsMemberships(config) ? providerLabel(config.authorization) : void 0;
+	const hookModules = names.filter((name) => MEMBERSHIP_CLAIM_MODULES.has(name));
+	if (owner && hookModules.length > 0 && args["allow-hook-overlap"] !== true) return {
+		code: 1,
+		error: [
+			`The access token hook of ${owner} writes the memberships claim.`,
+			`${hookModules.join(" and ")} would add a second source for it. Use the provider's hook instead,`,
+			"or pass --allow-hook-overlap to write the modules anyway."
+		].join("\n")
+	};
+	const listed = [...config.blockNames, ...names.filter((name) => !config.blockNames.includes(name))];
+	const sqlLayout = await layoutFor(config, args, listed);
+	const added = resolveModules(names, sqlLayout).map((module) => module.name);
+	const lines = await write(config, args, listed, sqlLayout, deps.now, added);
+	const pulledIn = resolveModules(names, sqlLayout).map((module) => module.name).filter((name) => MEMBERSHIP_CLAIM_MODULES.has(name) && !names.includes(name));
+	if (owner && pulledIn.length > 0) lines.push("", `${pulledIn.join(" and ")} came along as a dependency: its memberships table backs has_organization_role() and has_entitlement().`, `The hook of ${owner} still writes the memberships claim, so don't call better_supabase.membership_claims from a hook.`, "Make better_supabase.memberships one of the provider's membership sources if both should agree.");
+	const untracked = resolveModules(names, sqlLayout).map((module) => module.name).filter((name) => !config.blockNames.includes(name));
+	if (untracked.length > 0) lines.push("", ...await listInConfig(args, untracked, deps));
+	if (args["dry-run"] !== true) lines.push(...await unlistedModuleFiles(config, names, sqlLayout));
+	return {
+		code: 0,
+		output: lines.join("\n"),
+		data: {
+			added,
+			pulledIn,
+			untracked
+		},
+		next: [await nextStep(config)]
+	};
+}
+/**
+* Lists `untracked` in `blocks` of the config file, so `sql sync --check` keeps
+* them current, or prints the snippet when the file isn't a literal object the
+* edit can follow.
+*/
+async function listInConfig(args, untracked, deps) {
+	const file = deps.configFile;
+	if (file === void 0) return ["Add them to blocks in better-supabase.config.ts so `sql sync --check` keeps them current:", ...untracked.map((name) => `  ${keyText(name)}: {},`)];
+	const source = await readFile(file, "utf-8");
+	const edit = file.endsWith(".json") ? addBlocksToJson(source, untracked) : addBlocksToConfig(source, untracked);
+	if (!edit.ok) return [
+		`${basename(file)} wasn't changed: ${edit.reason}.`,
+		"Add them to blocks so `sql sync --check` keeps them current:",
+		...untracked.map((name) => `  ${keyText(name)}: {},`)
+	];
+	await applyPlan({
+		root: dirname(file),
+		regenerate: "better-supabase sql add",
+		files: [{
+			path: file,
+			contents: edit.text,
+			policy: "edit"
+		}]
+	}, { "dry-run": args["dry-run"] });
+	if (args["dry-run"] === true) return [`Would add ${untracked.join(", ")} to blocks in ${basename(file)}.`];
+	return [`Added ${untracked.join(", ")} to blocks in ${basename(file)}.`];
+}
+//#endregion
+export { addModules as t };