better-supabase 0.14.0 → 0.15.0

package/dist/blocks/notifications/index.js

@@ -1,24 +1,24 @@
 import { t as DbException } from "../../db-exception-Lngc1W49.js";
-import { n as dbError } from "../../errors-03ysrOt4.js";
-import { t as temporal } from "../../temporal-required-B8qQHYbI.js";
-import { a as ok, r as err, s as toDbError, t as AsyncResult } from "../../result-B3m7xtRY.js";
+import { n as dbError } from "../../errors-BVFgt8BZ.js";
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
-import { n as validate } from "../../standard-DtkpFGkS.js";
-import { a as methodNotAllowed, o as problemResponse } from "../../problem-BWElIgIb.js";
+import { t as temporal } from "../../temporal-required-Dy0GGD8E.js";
+import { a as ok, r as err, s as toDbError, t as AsyncResult } from "../../result-ntFBW2p2.js";
+import { n as validate } from "../../standard-BA3mLh6w.js";
+import { a as methodNotAllowed, o as problemResponse } from "../../problem-Bf0cJ7tk.js";
 import { t as MAX_BATCH } from "../../batch-limit-DKVQDz4o.js";
-import { t as notificationsSqlOptions } from "../../options-Dmg1Da9P.js";
-import { B as dbTransport, C as optionalText, E as readBodyCapped, H as rpcTransport, L as toBlockError, U as sqlTransport, c as chunksOf, f as errorText, i as batchResultsOf, n as applyTemporal, o as blockCall, s as budget, v as nullableInstant, w as pageOf, y as nullableText } from "../../block-helpers-CiKtrb6g.js";
-import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-BymdcD0V.js";
+import { t as notificationsSqlOptions } from "../../options-Bt0bYMLl.js";
+import { n as whileSignedIn, t as defineController } from "../../controller-BEliOBOv.js";
+import { B as dbTransport, C as optionalText, E as readBodyCapped, H as rpcTransport, L as toBlockError, U as sqlTransport, c as chunksOf, f as errorText, i as batchResultsOf, n as applyTemporal, o as blockCall, s as budget, v as nullableInstant, w as pageOf, y as nullableText } from "../../block-helpers-CtBdjgO4.js";
+import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-BfxX3682.js";
 import { a as stripTypePrefix } from "../../cloud-event-XsM53POL.js";
 import { n as event, t as defineEvents } from "../../event-map-CtPFhcOp.js";
 import { r as blockEmitter } from "../../block-events-pBXPzwnW.js";
-import { s as verifyWebhook } from "../../signatures-GUBuhLOB.js";
-import { t as subjectReaders } from "../../subject-readers-CsTpx44c.js";
-import { n as blockFields, s as rowFields } from "../../block-fields-DBSJSeaO.js";
-import { n as defineBlock } from "../../define-block-Dze77QTw.js";
+import { s as verifyWebhook } from "../../signatures-CNcoq392.js";
+import { t as subjectReaders } from "../../subject-readers-B-pQ9Mmo.js";
+import { n as blockFields, s as rowFields } from "../../block-fields-DE_FgpOU.js";
+import { n as defineBlock } from "../../define-block-BGqOO8B3.js";
 import { t as allowedSubscribers } from "../../subscribers-BvZxcd63.js";
 import { t as mailHeaders } from "../../delivery-Bm0jxmzI.js";
-import { n as unreadCount, t as createNotificationsController } from "../../client-Y_HnZGF4.js";
 //#region src/blocks/notifications/email.ts
 function defaultCompose(message) {
 	const text = message.text;
@@ -1033,6 +1033,55 @@ function rowEvent(row) {
 	};
 }
 //#endregion
+//#region src/blocks/notifications/client.ts
+/** The default badge number: the items whose `readAt` is `null`. */
+const unreadCount = (items) => items.filter((item) => typeof item === "object" && item !== null && "readAt" in item && item.readAt === null).length;
+/**
+* The signed-in user's notifications, kept current: loads them, then loads
+* again after each broadcast on `topic` and after the channel rejoins.
+*/
+function createNotificationsController(options) {
+	const countOf = options.count ?? unreadCount;
+	return defineController({
+		items: void 0,
+		count: 0,
+		status: "closed",
+		error: void 0
+	}, (state) => {
+		const refresh = async () => {
+			try {
+				const merged = (await Promise.all([options.load, ...options.sources ?? []].map((source) => source()))).flat();
+				const items = options.sort ? merged.toSorted(options.sort) : merged;
+				state.set({
+					items,
+					count: countOf(items),
+					error: void 0
+				});
+			} catch (cause) {
+				state.set({ error: cause });
+			}
+		};
+		return {
+			actions: { refresh },
+			start: () => whileSignedIn(options.auth, () => {
+				refresh();
+				if (!options.topic) return;
+				const { leave } = options.ports.topic(options.topic, {
+					onMessage: (event, payload) => {
+						options.onMessage?.(event, payload);
+						refresh();
+					},
+					onRejoin: () => void refresh(),
+					onStatus: (status) => {
+						state.set({ status });
+					}
+				});
+				return leave;
+			})
+		};
+	});
+}
+//#endregion
 //#region src/blocks/notifications/events.ts
 /** The `notifications` block's event types, for its manifest and `onBlockEvent`. */
 const notificationsEvents = defineEvents({

package/dist/blocks/numbering/index.d.ts

@@ -0,0 +1,45 @@
+import { T as ErrorMapper, t as AsyncResult } from "../../result-DZeA5KS6.js";
+import { $ as SaasEventData, Ct as Events } from "../../events-vcqenSYU.js";
+import { n as Logger } from "../../logger-DWVYUmwi.js";
+import { t as BlockTransport } from "../../block-transport-DWZSJrwN.js";
+import { n as BlockHooks } from "../../block-hooks-DZN2w69m.js";
+import { c as BlockOf } from "../../define-block-BVcLQ3DF.js";
+//#region src/blocks/numbering/numbering.d.ts
+interface NumberingOptions {
+  readonly transport: BlockTransport;
+  readonly schema?: string;
+  readonly mappers?: readonly ErrorMapper[];
+  /** `withBlockHooks` hooks around the client's methods. */
+  readonly hooks?: BlockHooks<Numbering>;
+  /** Receives the errors `after` hooks throw. Default: `console`. */
+  readonly logger?: Logger;
+}
+interface Numbering {
+  /**
+   * Allocates the next gapless number. Service role only: a client round trip
+   * would commit the number before the document does. Documents take their
+   * number from the column trigger instead.
+   */
+  next(organizationId: string, entity: string, at?: string): AsyncResult<string>;
+  /**
+   * The number the next document would get, formatted, without assigning it.
+   * Needs the `assign` permission in the organization; a concurrent document
+   * can still take it first.
+   */
+  preview(organizationId: string, entity: string, at?: string): AsyncResult<string>;
+}
+export declare function createNumbering(options: NumberingOptions): Numbering;
+//#endregion
+//#region src/blocks/numbering/events.d.ts
+/** The events of the `numbering` block: type to data. */
+type NumberingEvents = {
+  readonly "number.assigned": SaasEventData;
+};
+/** The `numbering` block's event types, for its manifest and `onBlockEvent`. */
+export declare const numberingEvents: Events<NumberingEvents>;
+//#endregion
+//#region src/blocks/numbering/manifest.d.ts
+/** The `numbering` block's manifest (ADR 0029). */
+export declare const numberingBlock: BlockOf<"numbering", typeof createNumbering, NumberingEvents>;
+//#endregion
+export type { Numbering, NumberingEvents, NumberingOptions };

package/dist/blocks/numbering/index.js

@@ -0,0 +1,49 @@
+import { t as numberingSqlOptions } from "../../options-D_bBVCXg.js";
+import { o as blockCall } from "../../block-helpers-CtBdjgO4.js";
+import { r as withBlockHooks } from "../../block-hooks-BfxX3682.js";
+import { n as event, t as defineEvents } from "../../event-map-CtPFhcOp.js";
+import { n as defineBlock } from "../../define-block-BGqOO8B3.js";
+//#region src/blocks/numbering/numbering.ts
+function createNumbering(options) {
+	const call = blockCall(options.transport, options.schema, options.mappers);
+	const text = (value) => {
+		if (typeof value === "string") return value;
+		throw new TypeError("preview_number did not return a number");
+	};
+	return withBlockHooks({
+		next: (organizationId, entity, at) => call("next_number", {
+			tenant: organizationId,
+			p_entity: entity,
+			at: at ?? null
+		}, (value) => {
+			if (typeof value === "number" || typeof value === "bigint") return String(value);
+			if (typeof value === "string") return value;
+			throw new TypeError("next_number did not return a number");
+		}),
+		preview: (organizationId, entity, at) => call("preview_number", {
+			p_tenant: organizationId,
+			p_entity: entity,
+			...at === void 0 ? {} : { p_at: at }
+		}, text)
+	}, options.hooks, {
+		block: "numbering",
+		...options.logger ? { logger: options.logger } : {}
+	});
+}
+//#endregion
+//#region src/blocks/numbering/events.ts
+/** The `numbering` block's event types, for its manifest and `onBlockEvent`. */
+const numberingEvents = defineEvents({ "number.assigned": event() });
+//#endregion
+//#region src/blocks/numbering/manifest.ts
+/** The `numbering` block's manifest (ADR 0029). */
+const numberingBlock = defineBlock({
+	name: "numbering",
+	sql: ["numbering"],
+	options: { numbering: numberingSqlOptions },
+	events: numberingEvents,
+	create: createNumbering,
+	category: "database"
+});
+//#endregion
+export { createNumbering, numberingBlock, numberingEvents };

package/dist/blocks/oauth-server/index.d.ts

@@ -1,11 +1,11 @@
 /// <reference lib="esnext.temporal" />
-import { t as AsyncResult } from "../../result-C6jDfedy.js";
-import { Ct as Events } from "../../events-DbLjvxDX.js";
+import { t as AsyncResult } from "../../result-DZeA5KS6.js";
+import { Ct as Events } from "../../events-vcqenSYU.js";
 import { n as Logger } from "../../logger-DWVYUmwi.js";
-import { n as BlockOptions } from "../../block-helpers-BaugZlJV.js";
-import { s as sqlTransport, t as BlockTransport } from "../../block-transport-d53POsem.js";
-import { n as BlockHooks } from "../../block-hooks-CmjPKqQ_.js";
-import { c as BlockOf } from "../../define-block-COpcS6aT.js";
+import { n as BlockOptions } from "../../block-helpers-CRpAHrp_.js";
+import { s as sqlTransport, t as BlockTransport } from "../../block-transport-DWZSJrwN.js";
+import { n as BlockHooks } from "../../block-hooks-DZN2w69m.js";
+import { c as BlockOf } from "../../define-block-BVcLQ3DF.js";
 //#region src/blocks/oauth-server/oauth-server.d.ts
 declare const AUTH_METHODS: readonly ["none", "client_secret_basic", "client_secret_post"];
 declare const GRANT_TYPES: readonly ["authorization_code", "refresh_token", "client_credentials", "urn:ietf:params:oauth:grant-type:device_code"];

package/dist/blocks/oauth-server/index.js

@@ -1,12 +1,12 @@
-import { n as dbError } from "../../errors-03ysrOt4.js";
-import { t as temporal } from "../../temporal-required-B8qQHYbI.js";
-import { t as AsyncResult } from "../../result-B3m7xtRY.js";
+import { n as dbError } from "../../errors-BVFgt8BZ.js";
+import { t as temporal } from "../../temporal-required-Dy0GGD8E.js";
+import { t as AsyncResult } from "../../result-ntFBW2p2.js";
 import { a as toBase64Url } from "../../base64-B9Wlsdj7.js";
 import { t as oauthServerSqlOptions } from "../../options-CEMawFrr.js";
-import { D as recordOf, F as stringsOf, I as textOf, N as sha256Hex, O as recordOrEmpty, T as randomToken, U as sqlTransport, d as enumOrThrow, h as instantOf, j as run, k as recordsOf, n as applyTemporal, o as blockCall, v as nullableInstant, y as nullableText } from "../../block-helpers-CiKtrb6g.js";
-import { r as withBlockHooks } from "../../block-hooks-BymdcD0V.js";
+import { D as recordOf, F as stringsOf, I as textOf, N as sha256Hex, O as recordOrEmpty, T as randomToken, U as sqlTransport, d as enumOrThrow, h as instantOf, j as run, k as recordsOf, n as applyTemporal, o as blockCall, v as nullableInstant, y as nullableText } from "../../block-helpers-CtBdjgO4.js";
+import { r as withBlockHooks } from "../../block-hooks-BfxX3682.js";
 import { n as event, t as defineEvents } from "../../event-map-CtPFhcOp.js";
-import { n as defineBlock } from "../../define-block-Dze77QTw.js";
+import { n as defineBlock } from "../../define-block-BGqOO8B3.js";
 //#region src/blocks/oauth-server/oauth-server.ts
 const AUTH_METHODS = [
 	"none",

package/dist/blocks/onboarding/index.d.ts

@@ -1,8 +1,116 @@
-import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-d53POsem.js";
-import { c as BlockOf } from "../../define-block-COpcS6aT.js";
-import { _ as defineChecklist, a as OnboardingSnapshot, c as ChecklistProgress, d as ChecklistStep, f as ChecklistSubject, g as createOnboarding, h as StepProgress, i as OnboardingControllerOptions, l as ChecklistScope, m as OnboardingOptions, n as OnboardingController, o as createOnboardingController, p as Onboarding, r as OnboardingControllerClient, s as Checklist, t as OnboardingActions, u as ChecklistSpec } from "../../client-DzOL3lsV.js";
+/// <reference lib="esnext.temporal" />
+import { b as DbError, t as AsyncResult } from "../../result-DZeA5KS6.js";
+import { n as Logger } from "../../logger-DWVYUmwi.js";
+import { n as BlockOptions } from "../../block-helpers-CRpAHrp_.js";
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DWZSJrwN.js";
+import { n as BlockHooks } from "../../block-hooks-DZN2w69m.js";
+import { c as BlockOf } from "../../define-block-BVcLQ3DF.js";
+import { n as Controller, t as AuthPort } from "../../controller-BrP0gn47.js";
+//#region src/blocks/onboarding/onboarding.d.ts
+type ChecklistScope = "user" | "organization";
+/** One step. `events` completes it when the outbox records one of those types. */
+interface ChecklistStep<Id extends string = string> {
+  readonly id: Id;
+  readonly title?: string;
+  readonly description?: string;
+  /** Where the step is done in the app, for a "Start" link. */
+  readonly href?: string;
+  readonly events?: readonly string[];
+}
+interface ChecklistSpec<Id extends string, Scope extends ChecklistScope> {
+  readonly id: string;
+  /** `user` tracks each user; `organization` tracks each tenant. */
+  readonly scope: Scope;
+  readonly steps: readonly ChecklistStep<Id>[];
+}
+interface OnboardingOptions extends BlockOptions {
+  /** `withBlockHooks` hooks around the client's methods. */
+  readonly hooks?: BlockHooks<Onboarding>;
+  /** Receives the errors `after` hooks throw. Default: `console`. */
+  readonly logger?: Logger;
+}
+/** A step with the subject's progress. */
+interface StepProgress<Id extends string> extends ChecklistStep<Id> {
+  readonly completed: boolean;
+  readonly completedAt: Temporal.Instant | undefined;
+  readonly completedBy: string | undefined;
+}
+interface ChecklistProgress<Id extends string> {
+  readonly steps: readonly StepProgress<Id>[];
+  readonly completed: number;
+  readonly total: number;
+  /** Every step is complete. */
+  readonly done: boolean;
+  /** The first step not done yet. */
+  readonly next: StepProgress<Id> | undefined;
+}
+/** The organization for an organization checklist; nothing for a user one. */
+type ChecklistSubject<Scope extends ChecklistScope> = Scope extends "organization" ? [organizationId: string] : [];
+/**
+ * The onboarding block: progress through any checklist `defineChecklist`
+ * declared.
+ */
+interface Onboarding {
+  /**
+   * The subject's progress: the caller's for a user checklist, the
+   * organization's otherwise.
+   */
+  progress<Id extends string, Scope extends ChecklistScope>(checklist: Checklist<Id, Scope>, ...subject: ChecklistSubject<Scope>): AsyncResult<ChecklistProgress<Id>>;
+  /** Marks a step done; `false` when it already was. */
+  complete<Id extends string, Scope extends ChecklistScope>(checklist: Checklist<Id, Scope>, step: Id, ...subject: ChecklistSubject<Scope>): AsyncResult<boolean>;
+  /** Marks a step not done; `false` when it wasn't. */
+  reset<Id extends string, Scope extends ChecklistScope>(checklist: Checklist<Id, Scope>, step: Id, ...subject: ChecklistSubject<Scope>): AsyncResult<boolean>;
+}
+/**
+ * A checklist `defineChecklist` checked; pass it to the onboarding client's
+ * methods.
+ */
+type Checklist<Id extends string, Scope extends ChecklistScope> = ChecklistSpec<Id, Scope>;
+/**
+ * Declares an onboarding checklist. Pass the result to
+ * `blocks.onboarding.options.checklists` so the database knows its steps, and
+ * to the methods of `createOnboarding` to read and complete them.
+ */
+export declare function defineChecklist<const Id extends string, const Scope extends ChecklistScope>(spec: ChecklistSpec<Id, Scope>): Checklist<Id, Scope>;
+/**
+ * The onboarding block: reads and completes the steps of the checklists in
+ * `blocks.onboarding.options.checklists`, for the caller or an organization.
+ */
+export declare function createOnboarding(options: OnboardingOptions): Onboarding;
+//#endregion
+//#region src/blocks/onboarding/client.d.ts
+/** The calls the controller makes for one checklist; `createOnboarding` fits. */
+interface OnboardingControllerClient<Id extends string, Scope extends ChecklistScope> {
+  progress(checklist: Checklist<Id, Scope>, ...subject: ChecklistSubject<Scope>): AsyncResult<ChecklistProgress<Id>>;
+  complete(checklist: Checklist<Id, Scope>, step: Id, ...subject: ChecklistSubject<Scope>): AsyncResult<boolean>;
+  reset(checklist: Checklist<Id, Scope>, step: Id, ...subject: ChecklistSubject<Scope>): AsyncResult<boolean>;
+}
+interface OnboardingControllerOptions<Id extends string, Scope extends ChecklistScope> {
+  /** `createOnboarding({ transport })`. */
+  readonly client: OnboardingControllerClient<Id, Scope>;
+  /** The checklist, from `defineChecklist`. */
+  readonly checklist: Checklist<Id, Scope>;
+  readonly auth: AuthPort;
+  /** The organization, for an organization checklist; it waits without one. */
+  readonly organizationId?: string | null;
+}
+interface OnboardingSnapshot<Id extends string> {
+  /** `undefined` until the first load. */
+  readonly progress: ChecklistProgress<Id> | undefined;
+  readonly error: DbError | undefined;
+}
+interface OnboardingActions<Id extends string> {
+  /** Marks a step done, then loads the progress again. */
+  readonly complete: (step: Id) => Promise<void>;
+  readonly reset: (step: Id) => Promise<void>;
+  readonly refresh: () => Promise<void>;
+}
+type OnboardingController<Id extends string> = Controller<OnboardingSnapshot<Id>, OnboardingActions<Id>>;
+/** A checklist's progress for the signed-in user, or for an organization. */
+export declare function createOnboardingController<Id extends string, Scope extends ChecklistScope>(options: OnboardingControllerOptions<Id, Scope>): OnboardingController<Id>;
+//#endregion
 //#region src/blocks/onboarding/manifest.d.ts
 /** The `onboarding` block's manifest (ADR 0029). */
 export declare const onboardingBlock: BlockOf<"onboarding", typeof createOnboarding>;
 //#endregion
-export { type BlockTransport, type Checklist, type ChecklistProgress, type ChecklistScope, type ChecklistSpec, type ChecklistStep, type ChecklistSubject, type Onboarding, type OnboardingActions, type OnboardingController, type OnboardingControllerClient, type OnboardingControllerOptions, type OnboardingOptions, type OnboardingSnapshot, type StepProgress, createOnboarding, createOnboardingController, dbTransport, defineChecklist, rpcTransport, sqlTransport };
+export { type BlockTransport, type Checklist, type ChecklistProgress, type ChecklistScope, type ChecklistSpec, type ChecklistStep, type ChecklistSubject, type Onboarding, type OnboardingActions, type OnboardingController, type OnboardingControllerClient, type OnboardingControllerOptions, type OnboardingOptions, type OnboardingSnapshot, type StepProgress, dbTransport, rpcTransport, sqlTransport };

package/dist/blocks/onboarding/index.js

@@ -1,8 +1,111 @@
 import { t as onboardingSqlOptions } from "../../options-C_pb1Nd3.js";
-import { B as dbTransport, H as rpcTransport, U as sqlTransport } from "../../block-helpers-CiKtrb6g.js";
-import { n as defineBlock } from "../../define-block-Dze77QTw.js";
-import { n as defineChecklist, t as createOnboarding } from "../../onboarding-CGMuX7sP.js";
-import { t as createOnboardingController } from "../../client-pxXoQOdC.js";
+import { n as whileSignedIn, t as defineController } from "../../controller-BEliOBOv.js";
+import { B as dbTransport, C as optionalText, H as rpcTransport, I as textOf, S as optionalInstant, U as sqlTransport, k as recordsOf, n as applyTemporal, o as blockCall } from "../../block-helpers-CtBdjgO4.js";
+import { r as withBlockHooks } from "../../block-hooks-BfxX3682.js";
+import { n as defineBlock } from "../../define-block-BGqOO8B3.js";
+//#region src/blocks/onboarding/onboarding.ts
+const ID = /^[a-z][a-z0-9_.-]{0,63}$/;
+/**
+* Declares an onboarding checklist. Pass the result to
+* `blocks.onboarding.options.checklists` so the database knows its steps, and
+* to the methods of `createOnboarding` to read and complete them.
+*/
+function defineChecklist(spec) {
+	if (!ID.test(spec.id)) throw new TypeError(`defineChecklist: "${spec.id}" is not a checklist id`);
+	const seen = /* @__PURE__ */ new Set();
+	for (const step of spec.steps) {
+		if (!ID.test(step.id) || seen.has(step.id)) throw new TypeError(`defineChecklist(${spec.id}): step "${step.id}" is not a unique step id`);
+		seen.add(step.id);
+	}
+	return spec;
+}
+/**
+* The onboarding block: reads and completes the steps of the checklists in
+* `blocks.onboarding.options.checklists`, for the caller or an organization.
+*/
+function createOnboarding(options) {
+	applyTemporal(options);
+	const call = blockCall(options.transport, options.schema, options.mappers);
+	const tenantOf = (subject) => ({ tenant: subject[0] ?? null });
+	return withBlockHooks({
+		progress: (checklist, ...subject) => call("onboarding_progress", {
+			checklist: checklist.id,
+			...tenantOf(subject)
+		}, (value) => progressOf(checklist.steps, value)),
+		complete: (checklist, step, ...subject) => call("complete_onboarding_step", {
+			checklist: checklist.id,
+			step,
+			...tenantOf(subject)
+		}, (value) => value === true),
+		reset: (checklist, step, ...subject) => call("reset_onboarding_step", {
+			checklist: checklist.id,
+			step,
+			...tenantOf(subject)
+		}, (value) => value === true)
+	}, options.hooks, {
+		block: "onboarding",
+		...options.logger ? { logger: options.logger } : {}
+	});
+}
+function progressOf(steps, value) {
+	const rows = new Map(recordsOf(value, "onboarding_progress").map((row) => [textOf(row["step"]), row]));
+	const list = steps.map((step) => {
+		const row = rows.get(step.id);
+		return {
+			...step,
+			completed: row !== void 0,
+			completedAt: optionalInstant(row?.["completedAt"]),
+			completedBy: optionalText(row?.["completedBy"])
+		};
+	});
+	const completed = list.filter((step) => step.completed).length;
+	return {
+		steps: list,
+		completed,
+		total: list.length,
+		done: completed === list.length,
+		next: list.find((step) => !step.completed)
+	};
+}
+//#endregion
+//#region src/blocks/onboarding/client.ts
+/** A checklist's progress for the signed-in user, or for an organization. */
+function createOnboardingController(options) {
+	const { client, checklist } = options;
+	const organizationId = options.organizationId ?? null;
+	const ready = checklist.scope === "user" || organizationId !== null;
+	const subject = checklist.scope === "organization" && organizationId !== null ? [organizationId] : [];
+	return defineController({
+		progress: void 0,
+		error: void 0
+	}, (state) => {
+		const refresh = async () => {
+			const run = state.run();
+			const result = await client.progress(checklist, ...subject);
+			if (run !== state.run()) return;
+			state.set(result.ok ? {
+				progress: result.data,
+				error: void 0
+			} : { error: result.error });
+		};
+		const change = async (action, step) => {
+			const result = await client[action](checklist, step, ...subject);
+			if (result.ok) await refresh();
+			else state.set({ error: result.error });
+		};
+		return {
+			actions: {
+				refresh,
+				complete: (step) => change("complete", step),
+				reset: (step) => change("reset", step)
+			},
+			start: () => ready ? whileSignedIn(options.auth, () => {
+				refresh();
+			}) : void 0
+		};
+	});
+}
+//#endregion
 //#region src/blocks/onboarding/manifest.ts
 /** The `onboarding` block's manifest (ADR 0029). */
 const onboardingBlock = defineBlock({

package/dist/blocks/orders/index.d.ts

@@ -1,20 +1,21 @@
 /// <reference lib="esnext.temporal" />
-import { t as AsyncResult } from "../../result-C6jDfedy.js";
-import { t as StandardSchemaV1 } from "../../standard-DbQsD2xZ.js";
-import { r as FieldsOf } from "../../block-fields-3w4MZr8U.js";
-import { Ct as Events, M as CommerceSubjectEventData } from "../../events-DbLjvxDX.js";
+import { f as Result, t as AsyncResult } from "../../result-DZeA5KS6.js";
+import { t as StandardSchemaV1 } from "../../standard-DBV730sF.js";
+import { r as FieldsOf } from "../../block-fields-BE7pInWZ.js";
+import { Ct as Events, M as CommerceSubjectEventData } from "../../events-vcqenSYU.js";
 import { n as Logger } from "../../logger-DWVYUmwi.js";
-import { n as BlockOptions } from "../../block-helpers-BaugZlJV.js";
-import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-d53POsem.js";
-import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-CmjPKqQ_.js";
-import { g as JobHandler } from "../../types-CGUDoF5I.js";
-import { c as BlockOf } from "../../define-block-COpcS6aT.js";
+import { n as BlockOptions } from "../../block-helpers-CRpAHrp_.js";
+import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DWZSJrwN.js";
+import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-DZN2w69m.js";
+import { g as JobHandler } from "../../types-SFRomQF7.js";
+import { Bt as Action, c as BlockOf } from "../../define-block-BVcLQ3DF.js";
 import { n as Money } from "../../money-BNRdJQzA.js";
-import { r as WebhookInput } from "../../signatures-zbu6KTNQ.js";
-import { i as PaymentEvent, n as Payment, o as PaymentProvider } from "../../payments-CBzQIjoX.js";
+import { n as ConversionContext, t as ConversionClients } from "../../conversion-BAbucuXq.js";
+import { r as WebhookInput } from "../../signatures-Dkx9OE8j.js";
+import { i as PaymentEvent, n as Payment, o as PaymentProvider } from "../../payments-BYcN34Fp.js";
 import { n as MetricDefinition } from "../../metric-definition-EAYI1r2n.js";
-import { l as TaxProvider, p as TaxTransaction } from "../../tax-CIIxd8Zf.js";
-import { S as ShippingOption, _ as PricedCart, a as FULFILLMENT_STATUSES, b as RETURN_STATUSES, c as ORDER_STATUSES, d as OrderPayment, f as OrderRefund, h as OrderStatus, i as CartProblem, l as Order, m as OrderReturn, n as AppliedPromotion, o as Fulfillment, p as OrderRefundStatus, r as CartLine, s as FulfillmentStatus, t as Address, u as OrderLine, v as QuantityLine, x as ReturnStatus, y as REFUND_STATUSES } from "../../codecs-DAu2sYWn.js";
+import { l as TaxProvider, p as TaxTransaction } from "../../tax-DPShHual.js";
+import { S as ShippingOption, _ as PricedCart, a as FULFILLMENT_STATUSES, b as RETURN_STATUSES, c as ORDER_STATUSES, d as OrderPayment, f as OrderRefund, h as OrderStatus, i as CartProblem, l as Order, m as OrderReturn, n as AppliedPromotion, o as Fulfillment, p as OrderRefundStatus, r as CartLine, s as FulfillmentStatus, t as Address, u as OrderLine, v as QuantityLine, x as ReturnStatus, y as REFUND_STATUSES } from "../../codecs-CMWlhHZ0.js";
 //#region src/blocks/orders/kitchen.d.ts
 /** Where a line is in the kitchen, in order. */
 type PreparationState = "queued" | "preparing" | "ready" | "served";
@@ -406,4 +407,24 @@ export declare const ordersEvents: Events<OrdersEvents>;
 /** The `orders` block's manifest (ADR 0029). */
 export declare const ordersBlock: BlockOf<"orders", typeof createOrders, OrdersEvents>;
 //#endregion
-export { type Address, type AppliedPromotion, type BlockHooks, type BlockTransport, type BlockTransportMiddleware, type CartDetails, type CartInput, type CartLine, type CartProblem, type Checkout, type CheckoutInput, FULFILLMENT_STATUSES, type Fulfillment, type FulfillmentInput, type FulfillmentStatus, type Invoice, type KitchenQueueQuery, type KitchenStation, type KitchenStationInput, type KitchenTicket, ORDER_STATUSES, type Order, type OrderBoardCard, type OrderBoardQuery, type OrderKitchen, type OrderLine, type OrderMetrics, type OrderMetricsOptions, type OrderPayment, type OrderRefund, type OrderRefundStatus, type OrderReturn, type OrderStatus, type Orders, type OrdersEvents, type OrdersOptions, type PaymentEventOutcome, type PaymentRecord, type PreparationLine, type PreparationState, type PricedCart, type QuantityLine, REFUND_STATUSES, RETURN_STATUSES, type RefundOutcome, type RefundRequest, type ReturnStatus, type RpcClient, type ShippingOption, type ShippingRateInput, type TrackingInput, dbTransport, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };
+//#region src/blocks/orders/actions.d.ts
+interface OrderFromQuoteOptions<C extends ConversionClients> {
+  /** The clients for one organization, over a service connection. */
+  readonly clients: (tenant: string) => C | PromiseLike<C>;
+  /**
+   * Creates the order for an accepted quote and returns its id, such as a cart
+   * of the quote's variants and `orders.checkout`. The orders block has no
+   * conversion from a quote, so the app supplies it.
+   */
+  readonly create: (context: ConversionContext<C>) => PromiseLike<Result<{
+    readonly id: string;
+  }>>;
+}
+/**
+ * The `orders.from_quote` action, which the quotes block's default automation
+ * runs on `quote.accepted` once an organization turns it on: an order linked
+ * `created_from` the quote, so an accepted quote orders once.
+ */
+export declare function orderFromQuoteAction<C extends ConversionClients>(options: OrderFromQuoteOptions<C>): Action;
+//#endregion
+export { type Address, type AppliedPromotion, type BlockHooks, type BlockTransport, type BlockTransportMiddleware, type CartDetails, type CartInput, type CartLine, type CartProblem, type Checkout, type CheckoutInput, FULFILLMENT_STATUSES, type Fulfillment, type FulfillmentInput, type FulfillmentStatus, type Invoice, type KitchenQueueQuery, type KitchenStation, type KitchenStationInput, type KitchenTicket, ORDER_STATUSES, type Order, type OrderBoardCard, type OrderBoardQuery, type OrderFromQuoteOptions, type OrderKitchen, type OrderLine, type OrderMetrics, type OrderMetricsOptions, type OrderPayment, type OrderRefund, type OrderRefundStatus, type OrderReturn, type OrderStatus, type Orders, type OrdersEvents, type OrdersOptions, type PaymentEventOutcome, type PaymentRecord, type PreparationLine, type PreparationState, type PricedCart, type QuantityLine, REFUND_STATUSES, RETURN_STATUSES, type RefundOutcome, type RefundRequest, type ReturnStatus, type RpcClient, type ShippingOption, type ShippingRateInput, type TrackingInput, dbTransport, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

package/dist/blocks/orders/index.js

@@ -1,18 +1,19 @@
-import { n as dbError } from "../../errors-03ysrOt4.js";
-import { a as ok, r as err, t as AsyncResult } from "../../result-B3m7xtRY.js";
+import { n as dbError } from "../../errors-BVFgt8BZ.js";
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
+import { a as ok, r as err, t as AsyncResult } from "../../result-ntFBW2p2.js";
 import { t as ordersSqlOptions } from "../../options-BZOliZvb.js";
 import { r as defineMetric } from "../../metric-definition-BjxVn4R5.js";
-import { A as requiredInstant, B as dbTransport, C as optionalText, D as recordOf, F as stringsOf, H as rpcTransport, I as textOf, S as optionalInstant, U as sqlTransport, d as enumOrThrow, k as recordsOf, m as instantArg, n as applyTemporal, o as blockCall, y as nullableText } from "../../block-helpers-CiKtrb6g.js";
-import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-BymdcD0V.js";
+import { A as requiredInstant, B as dbTransport, C as optionalText, D as recordOf, F as stringsOf, H as rpcTransport, I as textOf, S as optionalInstant, U as sqlTransport, d as enumOrThrow, k as recordsOf, m as instantArg, n as applyTemporal, o as blockCall, y as nullableText } from "../../block-helpers-CtBdjgO4.js";
+import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-BfxX3682.js";
 import { n as event, t as defineEvents } from "../../event-map-CtPFhcOp.js";
-import { n as blockFields, o as readFields } from "../../block-fields-DBSJSeaO.js";
-import { n as defineBlock } from "../../define-block-Dze77QTw.js";
+import { n as blockFields, o as readFields } from "../../block-fields-DE_FgpOU.js";
+import { n as defineBlock } from "../../define-block-BGqOO8B3.js";
+import { t as defineConversionAction } from "../../conversion-Dq1S7xzE.js";
 import { d as money } from "../../money-BZl985O-.js";
-import { i as moneyOf, t as amountText } from "../../money-codec-jMP0PQLZ.js";
-import { n as paymentProviderOf } from "../../payments-BtScsgPS.js";
-import { a as taxProviderOf } from "../../tax-DmOMjrYc.js";
-import { a as RETURN_STATUSES, c as quoteToJson, d as transactionToJson, i as REFUND_STATUSES, l as refundedTaxLines, n as ORDER_STATUSES, o as orderOf, s as pricedCartOf, t as FULFILLMENT_STATUSES, u as shippingOptionsOf } from "../../codecs-CQrX3ZW4.js";
+import { i as moneyOf, t as amountText } from "../../money-codec-BzddguAQ.js";
+import { n as paymentProviderOf } from "../../payments-BXvabJOw.js";
+import { a as taxProviderOf } from "../../tax-BkCNWWMc.js";
+import { a as RETURN_STATUSES, c as quoteToJson, d as transactionToJson, i as REFUND_STATUSES, l as refundedTaxLines, n as ORDER_STATUSES, o as orderOf, s as pricedCartOf, t as FULFILLMENT_STATUSES, u as shippingOptionsOf } from "../../codecs-TylXqU_I.js";
 //#region src/blocks/orders/kitchen.ts
 const PREPARATION_STATES = [
 	"queued",
@@ -725,7 +726,43 @@ const ordersBlock = defineBlock({
 		"order-detail",
 		"kitchen-display",
 		"order-state-board"
-	]
+	],
+	actions: [{
+		kind: "orders.from_quote",
+		title: "Order the accepted quote"
+	}],
+	providers: [{
+		option: "payments",
+		type: "PaymentProvider",
+		from: "better-supabase/commerce",
+		required: false,
+		description: "Takes payments; without one, payments are recorded by hand.",
+		example: "stripePayments({ stripe })"
+	}, {
+		option: "tax",
+		type: "TaxProvider",
+		from: "better-supabase/commerce",
+		required: false,
+		description: "Computes tax on order lines.",
+		example: "fixedRates({ rates })"
+	}]
 });
 //#endregion
-export { FULFILLMENT_STATUSES, KITCHEN_EVENT, ORDER_METRIC_EVENTS, ORDER_STATUSES, PREPARATION_STATES, REFUND_STATUSES, RETURN_STATUSES, createOrders, dbTransport, extendBlock, kitchenTopic, orderMetrics, ordersBlock, ordersEvents, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };
+//#region src/blocks/orders/actions.ts
+/**
+* The `orders.from_quote` action, which the quotes block's default automation
+* runs on `quote.accepted` once an organization turns it on: an order linked
+* `created_from` the quote, so an accepted quote orders once.
+*/
+function orderFromQuoteAction(options) {
+	return defineConversionAction({
+		kind: "orders.from_quote",
+		title: "Order the accepted quote",
+		targetType: "order",
+		clients: options.clients,
+		map: () => void 0,
+		create: (_, context) => options.create(context)
+	});
+}
+//#endregion
+export { FULFILLMENT_STATUSES, KITCHEN_EVENT, ORDER_METRIC_EVENTS, ORDER_STATUSES, PREPARATION_STATES, REFUND_STATUSES, RETURN_STATUSES, createOrders, dbTransport, extendBlock, kitchenTopic, orderFromQuoteAction, orderMetrics, ordersBlock, ordersEvents, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };