better-supabase 0.13.0 → 0.15.0

package/dist/blocks/moderation/index.js

@@ -0,0 +1,199 @@
+import { n as isRecord } from "../../guards-6F2bCtQR.js";
+import { t as moderationSqlOptions } from "../../options-Bpl-WFPk.js";
+import { A as requiredInstant, B as dbTransport, C as optionalText, D as recordOf, 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 } from "../../block-helpers-CtBdjgO4.js";
+import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-BfxX3682.js";
+import { t as defineRecordBinding } from "../../record-bindings-DkBJpC5A.js";
+import { n as event, t as defineEvents } from "../../event-map-CtPFhcOp.js";
+import { n as defineBlock } from "../../define-block-BGqOO8B3.js";
+import { t as requireOrganization } from "../../block-tenant-DHp7subc.js";
+//#region src/blocks/moderation/moderation.ts
+const STATUSES = [
+	"pending",
+	"visible",
+	"hidden",
+	"removed"
+];
+const ACTIONS = [
+	"submit",
+	"approve",
+	"hide",
+	"remove",
+	"restore",
+	"ban",
+	"auto_hide"
+];
+const REPORT_STATUSES = [
+	"open",
+	"resolved",
+	"dismissed"
+];
+function optional(key, value) {
+	if (value === void 0) return {};
+	const out = {};
+	out[key] = value;
+	return out;
+}
+function itemOf(value, fn) {
+	const row = recordOf(value, fn);
+	return {
+		id: textOf(row["id"]),
+		organizationId: textOf(row["organizationId"]),
+		subject: {
+			type: textOf(row["subjectType"]),
+			id: textOf(row["subjectId"])
+		},
+		status: enumOrThrow(row["status"], STATUSES, "moderation status"),
+		openReports: Number(row["openReports"] ?? 0),
+		createdAt: requiredInstant(row["createdAt"], "createdAt"),
+		updatedAt: requiredInstant(row["updatedAt"], "updatedAt"),
+		...optional("authorId", optionalText(row["authorId"])),
+		...optional("reason", optionalText(row["reason"])),
+		...optional("decidedBy", optionalText(row["decidedBy"])),
+		...optional("decidedAt", optionalInstant(row["decidedAt"]))
+	};
+}
+function reportOf(value, fn) {
+	const row = recordOf(value, fn);
+	return {
+		id: textOf(row["id"]),
+		organizationId: textOf(row["organizationId"]),
+		itemId: textOf(row["itemId"]),
+		reason: textOf(row["reason"]),
+		status: enumOrThrow(row["status"], REPORT_STATUSES, "report status"),
+		createdAt: requiredInstant(row["createdAt"], "createdAt"),
+		...optional("reporterId", optionalText(row["reporterId"])),
+		...optional("note", optionalText(row["note"])),
+		...optional("resolvedBy", optionalText(row["resolvedBy"])),
+		...optional("resolvedAt", optionalInstant(row["resolvedAt"]))
+	};
+}
+function actionOf(value, fn) {
+	const row = recordOf(value, fn);
+	const from = optionalText(row["fromStatus"]);
+	return {
+		id: textOf(row["id"]),
+		action: enumOrThrow(row["action"], ACTIONS, "moderation action"),
+		toStatus: enumOrThrow(row["toStatus"], STATUSES, "moderation status"),
+		createdAt: requiredInstant(row["createdAt"], "createdAt"),
+		...optional("fromStatus", from === void 0 ? void 0 : enumOrThrow(from, STATUSES, "moderation status")),
+		...optional("reason", optionalText(row["reason"])),
+		...optional("actorId", optionalText(row["actorId"]))
+	};
+}
+function banOf(value, fn) {
+	const row = recordOf(value, fn);
+	return {
+		id: textOf(row["id"]),
+		organizationId: textOf(row["organizationId"]),
+		userId: textOf(row["userId"]),
+		createdAt: requiredInstant(row["createdAt"], "createdAt"),
+		...optional("reason", optionalText(row["reason"])),
+		...optional("bannedBy", optionalText(row["bannedBy"])),
+		...optional("expiresAt", optionalInstant(row["expiresAt"])),
+		...optional("liftedBy", optionalText(row["liftedBy"])),
+		...optional("liftedAt", optionalInstant(row["liftedAt"]))
+	};
+}
+function statusesOf(value) {
+	const out = {};
+	if (isRecord(value)) for (const [id, status] of Object.entries(value)) out[id] = enumOrThrow(status, STATUSES, "moderation status");
+	return out;
+}
+/** The `moderation` SQL module as typed calls. */
+function createModeration(options) {
+	applyTemporal(options);
+	const call = blockCall(options.transport, options.schema, options.mappers);
+	const tenant = () => requireOrganization(options.tenant);
+	return withBlockHooks({
+		report: (subject, report) => tenant().andThen((organizationId) => call("report_content", {
+			tenant: organizationId,
+			subject_type: subject.type,
+			subject_id: subject.id,
+			reason: report.reason,
+			note: report.note ?? null
+		}, (value) => ({
+			...reportOf(value, "report_content"),
+			autoHidden: recordOf(value, "report_content")["autoHidden"] === true
+		}))),
+		queue: (filter = {}) => tenant().andThen((organizationId) => call("moderation_queue", {
+			tenant: organizationId,
+			status: filter.status ?? null,
+			subject_type: filter.subjectType ?? null,
+			page_size: filter.pageSize ?? null,
+			before: instantArg(filter.before) ?? null
+		}, (value) => recordsOf(value, "moderation_queue").map((row) => itemOf(row, "moderation_queue")))),
+		item: (subject) => tenant().andThen((organizationId) => call("moderation_item", {
+			tenant: organizationId,
+			subject_type: subject.type,
+			subject_id: subject.id
+		}, (value) => {
+			if (!isRecord(value)) return null;
+			const fn = "moderation_item";
+			return {
+				...itemOf(value, fn),
+				reports: recordsOf(value["reports"] ?? [], fn).map((row) => reportOf(row, fn)),
+				actions: recordsOf(value["actions"] ?? [], fn).map((row) => actionOf(row, fn))
+			};
+		})),
+		decide: (itemId, decision, decide = {}) => call("moderate", {
+			item_id: itemId,
+			action: decision,
+			reason: decide.reason ?? null
+		}, (value) => itemOf(value, "moderate")),
+		statuses: (subjectType, ids) => tenant().andThen((organizationId) => call("moderation_statuses", {
+			tenant: organizationId,
+			subject_type: subjectType,
+			subject_ids: [...ids]
+		}, statusesOf)),
+		ban: (userId, ban = {}) => tenant().andThen((organizationId) => call("ban_user", {
+			tenant: organizationId,
+			user_id: userId,
+			reason: ban.reason ?? null,
+			expires_at: instantArg(ban.expiresAt) ?? null
+		}, (value) => banOf(value, "ban_user"))),
+		unban: (banId) => call("unban_user", { ban_id: banId }, (value) => value === true),
+		bans: (filter = {}) => tenant().andThen((organizationId) => call("list_bans", {
+			tenant: organizationId,
+			active: filter.active ?? true,
+			page_size: filter.pageSize ?? null
+		}, (value) => recordsOf(value, "list_bans").map((row) => banOf(row, "list_bans"))))
+	}, options.hooks, {
+		block: "moderation",
+		...options.logger ? { logger: options.logger } : {}
+	});
+}
+//#endregion
+//#region src/blocks/moderation/events.ts
+/** The `moderation` block's event types, for its manifest and `onBlockEvent`. */
+const moderationEvents = defineEvents({
+	"moderation_report.created": event(),
+	"moderation_item.decided": event(),
+	"moderation_ban.created": event(),
+	"moderation_ban.lifted": event()
+});
+//#endregion
+//#region src/blocks/moderation/record-binding.ts
+/** A record's moderation: its status, reports and log, for moderators. */
+const moderationBinding = defineRecordBinding({
+	permissions: {
+		read: "read",
+		write: "manage"
+	},
+	module: "moderation",
+	load: (client, subject) => client.item(subject),
+	events: ["moderation_report.created", "moderation_item.decided"]
+});
+//#endregion
+//#region src/blocks/moderation/manifest.ts
+/** The `moderation` block's manifest (ADR 0029). */
+const moderationBlock = defineBlock({
+	name: "moderation",
+	sql: ["moderation"],
+	options: { moderation: moderationSqlOptions },
+	events: moderationEvents,
+	create: createModeration,
+	record: moderationBinding,
+	category: "collaboration"
+});
+//#endregion
+export { createModeration, dbTransport, extendBlock, moderationBinding, moderationBlock, moderationEvents, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

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

@@ -1,20 +1,22 @@
 /// <reference lib="esnext.temporal" />
-import { T as ErrorMapper, f as Result, t as AsyncResult } from "../../result-mijqfoJN.js";
-import { i as RowFields, r as FieldsOf } from "../../block-fields-DnXkMney.js";
-import { J as NotificationEventData, o as EventHub, q as NotificationDeliveryEventData, st as SubjectEventData, wt as Events } from "../../events-DhGgwqQA.js";
-import { m as RequestContext } from "../../plugin-DouW0Kvg.js";
-import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DBPhgF3W.js";
-import { i as CursorPageOptions, r as BlockTemporalOptions } from "../../block-helpers-DyA5BAW4.js";
-import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-BadAniNI.js";
-import { t as BlockProblemOptions } from "../../problem-D_DEBfMn.js";
-import { i as EventSink, t as CloudEvent } from "../../cloud-event-CidL9jiw.js";
-import { g as SubscriberPolicy, i as AuthorizationHooks } from "../../authorization-hooks-HXVZXxUk.js";
-import { s as BlockOf } from "../../define-block-MyM4lH42.js";
-import { n as VerifyOptions } from "../../signatures-CzqfLlfV.js";
+import { T as ErrorMapper, f as Result, t as AsyncResult } from "../../result-DZeA5KS6.js";
+import { i as RowFields, r as FieldsOf } from "../../block-fields-BE7pInWZ.js";
+import { Ft as RequestContext } from "../../types-DFdg_4yN.js";
+import { Ct as Events, J as NotificationEventData, o as EventHub, q as NotificationDeliveryEventData, st as SubjectEventData } from "../../events-vcqenSYU.js";
+import { i as CursorPageOptions, r as BlockTemporalOptions } 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 { t as BlockProblemOptions } from "../../problem-DNwN8iGz.js";
+import { c as BlockOf } from "../../define-block-BVcLQ3DF.js";
+import { i as EventSink, t as CloudEvent } from "../../cloud-event-CzZTJkXv.js";
+import { g as SubscriberPolicy, i as AuthorizationHooks } from "../../authorization-hooks-Cs1vP_ej.js";
+import { p as SubscriptionStatus } from "../../topic-CJrQZQaa.js";
+import { n as TopicPort } from "../../watch-topic-BcGfvZOE.js";
+import { n as Controller, t as AuthPort } from "../../controller-BrP0gn47.js";
+import { n as VerifyOptions } from "../../signatures-Dkx9OE8j.js";
 import { a as NotificationSubject, i as NotificationItem, n as NotificationMessage, o as RenderedText, r as NotificationSendResult, t as NotificationChannel } from "../../channel-BjvGO39m.js";
 import { a as DeliveryTransport, c as UnsubscribeTarget, i as DeliverySendOptions, l as mailHeaders, n as DeliveryMessages, o as EmailMessage, r as DeliveryReceipt, s as MailCategory, t as DeliveryChannel } from "../../delivery-n6lZGuGx.js";
 import { n as EmailChannelOptions, r as emailChannel, t as ComposedEmail } from "../../email-tt2QqiSc.js";
-import { a as NotificationsControllerOptions, c as unreadCount, i as NotificationsController, n as NotificationSource, o as NotificationsSnapshot, r as NotificationsActions, s as createNotificationsController, t as NotificationFeedOptions } from "../../client-ysVOUgxM.js";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 //#region src/blocks/notifications/api-types.d.ts
 /** Notification type to the Standard Schema of its `data`. */
@@ -328,7 +330,7 @@ interface NotificationsOptions<K extends NotificationTypes, H = undefined, S ext
    * recipient it leaves out is skipped, and a throw retries the deliveries
    * later. Defaults to `server.authorization.delivery.audience`; with
    * `server.authorization` but no such policy, to `subjectReaders(transport)`,
-   * so a notification about a `config.subjects` record only reaches recipients
+   * so a notification about a `config.records` record only reaches recipients
    * who may read it. In-app recipients are decided in SQL (`holdersOf`,
    * membership).
    */
@@ -623,6 +625,56 @@ interface WatchedOutboxEvent {
  */
 export declare function watcherHandler<K extends NotificationTypes>(notifications: Pick<Notifications<K>, "sink">, options: WatcherSinkOptions<K>): (events: readonly WatchedOutboxEvent[]) => Promise<void>;
 //#endregion
+//#region src/blocks/notifications/client.d.ts
+/**
+ * Loads one list of items, e.g. a server action that calls
+ * `notifications.list()`.
+ */
+type NotificationSource<T> = () => Promise<readonly T[]>;
+interface NotificationFeedOptions<T> {
+  /**
+   * The private topic the `notifications` module broadcasts to:
+   * `fillTopic(blockConfig.notifications.options.topic, { userId })` with the
+   * template from `blocks.generated.ts`. `null` loads once without realtime.
+   */
+  readonly topic: string | null;
+  /** The notifications, newest first. */
+  readonly load: NotificationSource<T>;
+  /** More items merged in, such as running jobs or pending approvals. */
+  readonly sources?: readonly NotificationSource<T>[];
+  /** Orders the merged list. Defaults to the order the sources return. */
+  readonly sort?: (a: T, b: T) => number;
+  /** The badge number. Defaults to the items without a `readAt`. */
+  readonly count?: (items: readonly T[]) => number;
+  /** Runs for each broadcast, e.g. to show a toast for `notification_created`. */
+  readonly onMessage?: (event: string, payload: unknown) => void;
+}
+interface NotificationsControllerOptions<T> extends NotificationFeedOptions<T> {
+  readonly auth: AuthPort;
+  readonly ports: {
+    readonly topic: TopicPort;
+  };
+}
+interface NotificationsSnapshot<T> {
+  /** `undefined` until the first load. */
+  readonly items: readonly T[] | undefined;
+  readonly count: number;
+  readonly status: SubscriptionStatus;
+  readonly error: unknown;
+}
+interface NotificationsActions {
+  /** Loads again, e.g. after marking items read. */
+  readonly refresh: () => Promise<void>;
+}
+type NotificationsController<T> = Controller<NotificationsSnapshot<T>, NotificationsActions>;
+/** The default badge number: the items whose `readAt` is `null`. */
+export declare const unreadCount: (items: readonly unknown[]) => number;
+/**
+ * The signed-in user's notifications, kept current: loads them, then loads
+ * again after each broadcast on `topic` and after the channel rejoins.
+ */
+export declare function createNotificationsController<T>(options: NotificationsControllerOptions<T>): NotificationsController<T>;
+//#endregion
 //#region src/blocks/notifications/events.d.ts
 /** The events of the `notifications` block: type to data. */
 type NotificationsEvents = {
@@ -642,4 +694,4 @@ export declare const notificationsEvents: Events<NotificationsEvents>;
 /** The `notifications` block's manifest (ADR 0029). */
 export declare const notificationsBlock: BlockOf<"notifications", typeof createNotifications, NotificationsEvents, Record<never, never>, "notifier">;
 //#endregion
-export { type AvatarUrls, type BlockHooks, type BlockTransport, type BlockTransportMiddleware, type ComposedEmail, type DeliverOptions, type DeliverResult, type DeliveryChannel, type DeliveryEvent, type DeliveryEventInput, type DeliveryEventKind, type DeliveryMessages, type DeliveryReceipt, type DeliverySendOptions, type DeliveryTransport, type EmailChannelOptions, type EmailMessage, type ListOptions, type MailCategory, type NotificationActor, type NotificationChannel, type NotificationCounts, type NotificationFeedOptions, type NotificationItem, type NotificationMessage, type NotificationOf, type NotificationPage, type NotificationPreference, type NotificationSendResult, type NotificationSinkOptions, type NotificationSource, type NotificationSubject, type NotificationSubscription, type NotificationSuppression, type NotificationTypes, type NotificationUpdate, type Notifications, type NotificationsActions, type NotificationsController, type NotificationsControllerOptions, type NotificationsEvents, type NotificationsOptions, type NotificationsSnapshot, type PageOptions, type RecordedDeliveryEvent, type Rendered, type RenderedText, type ResendTransportOptions, type ResendWebhookOptions, type RpcClient, type SendInput, type SentNotification, type SinkNotification, type SubjectDelivery, type SubscriptionLevel, type SuppressInput, type SuppressionReason, type SuppressionWriter, type UnsubscribeTarget, type WatchedEventData, type WatchedOutboxEvent, type WatcherRule, type WatcherSinkOptions, createNotificationsController, dbTransport, emailChannel, extendBlock, mailHeaders, rpcTransport, sqlTransport, unreadCount, withBlockHooks, wrapTransport };
+export { type AvatarUrls, type BlockHooks, type BlockTransport, type BlockTransportMiddleware, type ComposedEmail, type DeliverOptions, type DeliverResult, type DeliveryChannel, type DeliveryEvent, type DeliveryEventInput, type DeliveryEventKind, type DeliveryMessages, type DeliveryReceipt, type DeliverySendOptions, type DeliveryTransport, type EmailChannelOptions, type EmailMessage, type ListOptions, type MailCategory, type NotificationActor, type NotificationChannel, type NotificationCounts, type NotificationFeedOptions, type NotificationItem, type NotificationMessage, type NotificationOf, type NotificationPage, type NotificationPreference, type NotificationSendResult, type NotificationSinkOptions, type NotificationSource, type NotificationSubject, type NotificationSubscription, type NotificationSuppression, type NotificationTypes, type NotificationUpdate, type Notifications, type NotificationsActions, type NotificationsController, type NotificationsControllerOptions, type NotificationsEvents, type NotificationsOptions, type NotificationsSnapshot, type PageOptions, type RecordedDeliveryEvent, type Rendered, type RenderedText, type ResendTransportOptions, type ResendWebhookOptions, type RpcClient, type SendInput, type SentNotification, type SinkNotification, type SubjectDelivery, type SubscriptionLevel, type SuppressInput, type SuppressionReason, type SuppressionWriter, type UnsubscribeTarget, type WatchedEventData, type WatchedOutboxEvent, type WatcherRule, type WatcherSinkOptions, dbTransport, emailChannel, extendBlock, mailHeaders, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

package/dist/blocks/notifications/index.js

@@ -1,25 +1,24 @@
-import { t as DbException } from "../../db-exception-CnWcYPxL.js";
-import { n as dbError } from "../../errors-D7u24ZJH.js";
-import { t as temporal } from "../../temporal-required-Dt4mcPsi.js";
-import { a as ok, r as err, s as toDbError, t as AsyncResult } from "../../result-DIT_qp4G.js";
+import { t as DbException } from "../../db-exception-Lngc1W49.js";
+import { n as dbError } from "../../errors-BVFgt8BZ.js";
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
-import { n as validate } from "../../standard-l10kE0yS.js";
-import { a as methodNotAllowed, o as problemResponse } from "../../problem-D0KDiYPk.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 { 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-BURaqwyp.js";
-import { s as verifyWebhook } from "../../signatures-D8IoN3Rw.js";
-import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-Ds0C2mUf.js";
-import { C as optionalText, E as readBodyCapped, L as toBlockError, 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-DwE32_gT.js";
-import { t as subjectReaders } from "../../subject-readers-BJzh7WF7.js";
-import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-C1r-R2r0.js";
-import { n as blockFields, s as rowFields } from "../../block-fields-Cwd4c8m-.js";
-import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
+import { r as blockEmitter } from "../../block-events-pBXPzwnW.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;
@@ -1034,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-mijqfoJN.js";
-import { wt as Events } from "../../events-DhGgwqQA.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 { s as sqlTransport, t as BlockTransport } from "../../block-transport-DBPhgF3W.js";
-import { n as BlockOptions } from "../../block-helpers-DyA5BAW4.js";
-import { n as BlockHooks } from "../../block-hooks-BadAniNI.js";
-import { s as BlockOf } from "../../define-block-MyM4lH42.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,13 +1,12 @@
-import { n as dbError } from "../../errors-D7u24ZJH.js";
-import { t as temporal } from "../../temporal-required-Dt4mcPsi.js";
-import { t as AsyncResult } from "../../result-DIT_qp4G.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-CtBdjgO4.js";
+import { r as withBlockHooks } from "../../block-hooks-BfxX3682.js";
 import { n as event, t as defineEvents } from "../../event-map-CtPFhcOp.js";
-import { i as sqlTransport } from "../../block-transport-Ds0C2mUf.js";
-import { D as recordOf, F as stringsOf, I as textOf, N as sha256Hex, O as recordOrEmpty, T as randomToken, 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-DwE32_gT.js";
-import { r as withBlockHooks } from "../../block-hooks-C1r-R2r0.js";
-import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
+import { n as defineBlock } from "../../define-block-BGqOO8B3.js";
 //#region src/blocks/oauth-server/oauth-server.ts
 const AUTH_METHODS = [
 	"none",