better-supabase 0.13.0 → 0.15.0

package/dist/blocks/timeline/index.js

@@ -0,0 +1,164 @@
+import { n as isRecord } from "../../guards-6F2bCtQR.js";
+import { B as dbTransport, C as optionalText, D as recordOf, H as rpcTransport, I as textOf, R as toInstant, U as sqlTransport, k as recordsOf, m as instantArg, n as applyTemporal, o as blockCall, w as pageOf } from "../../block-helpers-CtBdjgO4.js";
+import { r as withBlockHooks } from "../../block-hooks-BfxX3682.js";
+import { a as stripTypePrefix } from "../../cloud-event-XsM53POL.js";
+import { n as defineBlock } from "../../define-block-BGqOO8B3.js";
+import { n as optionalRecordRefOf } from "../../block-subjects-BhDKK_j7.js";
+import { n as defineListQuery } from "../../list-query-BKy2zBaT.js";
+import { t as requireOrganization } from "../../block-tenant-DHp7subc.js";
+//#region src/blocks/timeline/timeline.ts
+const ACTIVITY_SOURCES = [
+	"event",
+	"audit",
+	"delivery",
+	"run"
+];
+function sourceOf(value) {
+	return ACTIVITY_SOURCES.find((source) => source === value) ?? "event";
+}
+function activityOf(value) {
+	const row = recordOf(value, "activity_entries");
+	return {
+		id: textOf(row["id"]),
+		source: sourceOf(row["source"]),
+		organizationId: textOf(row["organization_id"]),
+		type: textOf(row["type"]),
+		actorId: optionalText(row["actor_id"]),
+		subject: optionalRecordRefOf(row["subject_type"], row["subject_id"]),
+		summary: optionalText(row["summary"]),
+		data: isRecord(row["data"]) ? row["data"] : {},
+		occurredAt: toInstant(textOf(row["occurred_at"]))
+	};
+}
+/** The activity feed over the `activity` module's functions, as the caller. */
+function createTimeline(options) {
+	applyTemporal(options);
+	const call = blockCall(options.transport, options.schema, options.mappers);
+	const tenant = () => requireOrganization(options.tenant);
+	return withBlockHooks({ list: (subject, history = {}) => tenant().andThen((organizationId) => call("list_activity", {
+		tenant: organizationId,
+		subject_type: subject?.type,
+		subject_id: subject?.id,
+		before: instantArg(pageOf(history).cursor),
+		max_rows: history.limit,
+		sources: history.sources ? [...history.sources] : void 0
+	}, (value) => recordsOf(value, "list_activity").map(activityOf))) }, options.hooks, {
+		block: "timeline",
+		...options.logger ? { logger: options.logger } : {}
+	});
+}
+const matches = (patterns, type) => patterns.some((pattern) => pattern.endsWith(".*") ? type.startsWith(pattern.slice(0, -1)) : pattern === type);
+const firstText = (data, keys) => {
+	for (const key of keys) {
+		const value = optionalText(data[key]);
+		if (value !== void 0) return value;
+	}
+};
+/** `deals/<id>` as `{ type: "deal", id }`, the shape block subjects use. */
+function subjectOf(subject) {
+	const slash = subject?.indexOf("/") ?? -1;
+	if (subject === void 0 || slash < 1) return;
+	const plural = subject.slice(0, slash);
+	return {
+		type: plural.endsWith("s") ? plural.slice(0, -1) : plural,
+		id: subject.slice(slash + 1)
+	};
+}
+/**
+* An outbox sink that writes events into the activity feed:
+* `outbox.relay('activity', activitySink({ transport }))`. Events without a
+* tenant (`partitionkey`) are skipped, and a replayed event writes nothing.
+*/
+function activitySink(options) {
+	const call = blockCall(options.transport, options.schema);
+	return { async send(events) {
+		const entries = [];
+		for (const event of events) {
+			const tenant = optionalText(event["partitionkey"]);
+			if (tenant === void 0) continue;
+			const type = stripTypePrefix(event.type, options.typePrefix);
+			if (options.types && !matches(options.types, type)) continue;
+			const described = options.describe ? options.describe(event, type) : {};
+			if (described === null) continue;
+			const data = isRecord(event.data) ? event.data : {};
+			const subject = subjectOf(event.subject);
+			entries.push({
+				event_id: event.id,
+				organization_id: tenant,
+				type,
+				actor_id: described?.actorId ?? firstText(data, [
+					"actorId",
+					"authorId",
+					"userId"
+				]),
+				subject_type: described?.subjectType ?? optionalText(data["recordType"]) ?? optionalText(data["subjectType"]) ?? subject?.type,
+				subject_id: described?.subjectId ?? optionalText(data["recordId"]) ?? optionalText(data["subjectId"]) ?? subject?.id,
+				summary: described?.summary,
+				data: described?.data ?? data,
+				occurred_at: event.time
+			});
+		}
+		if (entries.length > 0) await call("record_activity", { batch: { entries } }, () => void 0).orThrow();
+	} };
+}
+const FACETS = [
+	[
+		"type",
+		"type",
+		"type"
+	],
+	[
+		"actor",
+		"actor_id",
+		"actorId"
+	],
+	[
+		"subjectType",
+		"subject_type",
+		"subjectType"
+	],
+	[
+		"subjectId",
+		"subject_id",
+		"subjectId"
+	]
+];
+/**
+* A cursor-paged list over `activity_entries` (generate types for the
+* `better_supabase` schema to get it in your models), newest first, filtered by
+* type, actor and subject. Members with `activity.read` see their tenants'
+* entries, less those on a registered subject that `can_subject` doesn't let
+* them read (with the `subjects` module). It reads the table, so it lists no
+* audit entries; `list()` does.
+*/
+function activityListQuery(betterSupabase, table, options = {}) {
+	const meta = betterSupabase.meta.tables[table];
+	if (!meta) throw new TypeError(`activityListQuery: unknown table "${table}"`);
+	const camel = meta.columns["occurredAt"] !== void 0;
+	const facets = Object.fromEntries(FACETS.map(([key, snake, camelName]) => [key, camel ? camelName : snake]).filter(([, column]) => meta.columns[column] !== void 0));
+	const occurredAt = camel ? "occurredAt" : "occurred_at";
+	const config = {
+		facets,
+		sorts: {
+			newest: [{ [occurredAt]: "desc" }, { id: "desc" }],
+			oldest: [{ [occurredAt]: "asc" }, { id: "asc" }]
+		},
+		defaultSort: "newest",
+		pagination: "cursor",
+		...options.pageSize === void 0 ? {} : { pageSize: options.pageSize },
+		...options.maxPageSize === void 0 ? {} : { maxPageSize: options.maxPageSize }
+	};
+	return defineListQuery(betterSupabase, table, config);
+}
+//#endregion
+//#region src/blocks/timeline/manifest.ts
+/** The `activity` block's manifest (ADR 0029, ADR 0063). */
+const timelineBlock = defineBlock({
+	name: "timeline",
+	sql: ["timeline"],
+	create: createTimeline,
+	category: "collaboration",
+	recipes: []
+});
+//#endregion
+export { activityListQuery, activitySink, createTimeline, dbTransport, rpcTransport, sqlTransport, timelineBlock };

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

@@ -1,13 +1,14 @@
 /// <reference lib="esnext.temporal" />
-import { t as AsyncResult } from "../../result-mijqfoJN.js";
-import { t as StandardSchemaV1 } from "../../standard-16AIDny5.js";
-import { n as ExtraFields, r as FieldsOf } from "../../block-fields-DnXkMney.js";
-import { A as CollaborationEventData, wt as Events } from "../../events-DhGgwqQA.js";
+import { t as AsyncResult } from "../../result-DZeA5KS6.js";
+import { t as StandardSchemaV1 } from "../../standard-DBV730sF.js";
+import { n as ExtraFields, r as FieldsOf } from "../../block-fields-BE7pInWZ.js";
+import { Dt as HasFlag, Mt as Plugin, Pt as RepositoryExtension, Z as PrimaryKeyValue } from "../../types-DFdg_4yN.js";
+import { A as CollaborationEventData, Ct as Events } from "../../events-vcqenSYU.js";
 import { n as Logger } from "../../logger-DWVYUmwi.js";
-import { a as dbTransport, o as rpcTransport, 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 { 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";
 //#region src/blocks/trash/trash.d.ts
 interface TrashOptions<S extends StandardSchemaV1 | undefined = undefined> extends BlockOptions {
   /**
@@ -63,6 +64,43 @@ interface Trash<F extends object = Record<never, never>> {
 /** The `trash` SQL module as typed calls. */
 export declare function createTrash<S extends StandardSchemaV1 | undefined = undefined>(options: TrashOptions<S>): Trash<FieldsOf<S>>;
 //#endregion
+//#region src/blocks/trash/extension.d.ts
+interface TrashFindArgs {
+  /** Include soft-deleted rows of the queried table. */
+  readonly withDeleted?: boolean;
+  /** Only return soft-deleted rows of the queried table. */
+  readonly onlyDeleted?: boolean;
+}
+interface TrashDeleteArgs {
+  /** Delete the row for real instead of setting the soft-delete column. */
+  readonly hard?: boolean;
+}
+interface TrashMethods<K> {
+  /** Clears the soft-delete column. `not_found` when the row does not exist. */
+  readonly restore: (key: K, args?: {
+    readonly signal?: AbortSignal;
+  }) => AsyncResult<void>;
+}
+interface TrashExtension extends RepositoryExtension {
+  readonly methods: HasFlag<this["M"], this["T"], "softDelete"> extends true ? TrashMethods<PrimaryKeyValue<this["M"], this["T"]>> : unknown;
+  readonly findArgs: HasFlag<this["M"], this["T"], "softDelete"> extends true ? TrashFindArgs : unknown;
+  readonly deleteArgs: HasFlag<this["M"], this["T"], "softDelete"> extends true ? TrashDeleteArgs : unknown;
+}
+/**
+ * The `trash` block's repository extension, for tables generated with
+ * `Flags.softDelete`:
+ *
+ * - Reads, updates and deletes skip deleted rows, including inside includes and
+ *   relation filters (`withDeleted` / `onlyDeleted` change the root table);
+ * - `delete` sets the column instead (`{ hard: true }` really deletes);
+ * - `restore(key)` clears it.
+ *
+ * Deletes become updates without `RETURNING`, so a SELECT policy that hides
+ * deleted rows does not make them fail. `delete({ where }, { returning: true
+ * })` keeps `RETURNING`, which needs a SELECT policy that still shows the row.
+ */
+export declare function trashExtension(): Plugin<"softDelete", TrashExtension>;
+//#endregion
 //#region src/blocks/trash/events.d.ts
 /** The events of the `trash` block: type to data. */
 type TrashEvents = {
@@ -77,4 +115,4 @@ export declare const trashEvents: Events<TrashEvents>;
 /** The `trash` block's manifest (ADR 0029). */
 export declare const trashBlock: BlockOf<"trash", typeof createTrash, TrashEvents>;
 //#endregion
-export { type BlockTransport, type Trash, type TrashBatch, type TrashEvents, type TrashItem, type TrashListOptions, type TrashOptions, dbTransport, rpcTransport, sqlTransport };
+export { type BlockTransport, type Trash, type TrashBatch, type TrashDeleteArgs, type TrashEvents, type TrashExtension, type TrashFindArgs, type TrashItem, type TrashListOptions, type TrashMethods, type TrashOptions, dbTransport, rpcTransport, sqlTransport };

package/dist/blocks/trash/index.js

@@ -1,11 +1,11 @@
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
-import { t as trashSqlOptions } from "../../options-CUqQ9pm7.js";
+import { t as trashSqlOptions } from "../../options-DWbA9buW.js";
+import { A as requiredInstant, B as dbTransport, C as optionalText, D as recordOf, H as rpcTransport, I as textOf, 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 event, t as defineEvents } from "../../event-map-CtPFhcOp.js";
-import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-Ds0C2mUf.js";
-import { A as requiredInstant, C as optionalText, D as recordOf, I as textOf, k as recordsOf, n as applyTemporal, o as blockCall } from "../../block-helpers-DwE32_gT.js";
-import { r as withBlockHooks } from "../../block-hooks-C1r-R2r0.js";
-import { n as blockFields } from "../../block-fields-Cwd4c8m-.js";
-import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
+import { n as blockFields } from "../../block-fields-DE_FgpOU.js";
+import { n as defineBlock } from "../../define-block-BGqOO8B3.js";
+import { t as trashExtension } from "../../extension-DzCc0IOd.js";
 //#region src/blocks/trash/trash.ts
 function batchOf(value, fn) {
 	const row = recordOf(value, fn);
@@ -73,7 +73,8 @@ const trashBlock = defineBlock({
 	events: trashEvents,
 	create: createTrash,
 	category: "content",
-	recipes: ["undo-toast", "trash-bin"]
+	recipes: ["undo-toast", "trash-bin"],
+	extension: "trashExtension"
 });
 //#endregion
-export { createTrash, dbTransport, rpcTransport, sqlTransport, trashBlock, trashEvents };
+export { createTrash, dbTransport, rpcTransport, sqlTransport, trashBlock, trashEvents, trashExtension };

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

@@ -1,9 +1,52 @@
-import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DBPhgF3W.js";
-import { s as BlockOf } from "../../define-block-MyM4lH42.js";
-import { a as UndoToken, c as undoToken, i as UndoOptions, n as Undo, o as createUndo, r as UndoCall, s as isUndoToken, t as UNDO_FUNCTIONS } from "../../undo-CClrTbm9.js";
-import { a as UndoStackOptions, i as UndoSnapshot, n as UndoController, o as createUndoController, r as UndoEntry, t as UndoActions } from "../../client-Y-kaHabc.js";
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DWZSJrwN.js";
+import { c as BlockOf } from "../../define-block-BVcLQ3DF.js";
+import { n as Controller } from "../../controller-BrP0gn47.js";
+import { a as UndoToken, c as undoToken, i as UndoOptions, n as Undo, o as createUndo, r as UndoCall, s as isUndoToken, t as UNDO_FUNCTIONS } from "../../undo-B1jwnVyN.js";
+//#region src/blocks/undo/client.d.ts
+interface UndoEntry {
+  readonly id: number;
+  /** What the toast or menu shows, e.g. "Moved 3 tasks". */
+  readonly label: string;
+  readonly token: UndoToken;
+}
+interface UndoStackOptions {
+  /**
+   * Applies a token, e.g. a server action that calls
+   * `createUndo().apply(token)`.
+   */
+  readonly apply: (token: UndoToken) => Promise<unknown>;
+  /** How many entries to keep; older ones drop off. Default 20. */
+  readonly limit?: number | undefined;
+}
+interface UndoSnapshot {
+  /** Newest last. */
+  readonly entries: readonly UndoEntry[];
+  readonly canUndo: boolean;
+  /** Whether an undo is running. */
+  readonly pending: boolean;
+  /** What the last failed undo threw; cleared by the next push or undo. */
+  readonly error: unknown;
+}
+interface UndoActions {
+  /** Adds a token; a `null` token (a change with no inverse) is ignored. */
+  readonly push: (token: UndoToken | null | undefined, label?: string) => void;
+  /**
+   * Applies the newest entry and removes it. A failed undo removes it too,
+   * since its rows changed since, and sets `error`. Resolves whether it
+   * worked.
+   */
+  readonly undo: () => Promise<boolean>;
+  readonly clear: () => void;
+}
+type UndoController = Controller<UndoSnapshot, UndoActions>;
+/**
+ * A stack of undo tokens on the client, for a toast's Undo button or a Cmd+Z
+ * handler.
+ */
+export declare function createUndoController(options: UndoStackOptions): UndoController;
+//#endregion
 //#region src/blocks/undo/manifest.d.ts
 /** The `undo` block's manifest (ADR 0029). */
 export declare const undoBlock: BlockOf<"undo", typeof createUndo>;
 //#endregion
-export { type BlockTransport, UNDO_FUNCTIONS, type Undo, type UndoActions, type UndoCall, type UndoController, type UndoEntry, type UndoOptions, type UndoSnapshot, type UndoStackOptions, type UndoToken, createUndo, createUndoController, dbTransport, isUndoToken, rpcTransport, sqlTransport, undoToken };
+export { type BlockTransport, UNDO_FUNCTIONS, type Undo, type UndoActions, type UndoCall, type UndoController, type UndoEntry, type UndoOptions, type UndoSnapshot, type UndoStackOptions, type UndoToken, createUndo, dbTransport, isUndoToken, rpcTransport, sqlTransport, undoToken };

package/dist/blocks/undo/index.js

@@ -1,7 +1,63 @@
-import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-Ds0C2mUf.js";
-import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
-import { i as undoToken, n as createUndo, r as isUndoToken, t as UNDO_FUNCTIONS } from "../../undo-HHonvNeg.js";
-import { t as createUndoController } from "../../client-BNaOcfeH.js";
+import { t as defineController } from "../../controller-BEliOBOv.js";
+import { B as dbTransport, H as rpcTransport, U as sqlTransport } from "../../block-helpers-CtBdjgO4.js";
+import { n as defineBlock } from "../../define-block-BGqOO8B3.js";
+import { i as undoToken, n as createUndo, r as isUndoToken, t as UNDO_FUNCTIONS } from "../../undo-BjCChCmH.js";
+//#region src/blocks/undo/client.ts
+/**
+* A stack of undo tokens on the client, for a toast's Undo button or a Cmd+Z
+* handler.
+*/
+function createUndoController(options) {
+	return defineController({
+		entries: [],
+		canUndo: false,
+		pending: false,
+		error: void 0
+	}, (state) => {
+		let nextId = 0;
+		const show = (entries, pending, error) => {
+			state.set({
+				entries,
+				pending,
+				error,
+				canUndo: entries.length > 0 && !pending
+			});
+		};
+		return { actions: {
+			push: (token, label = "") => {
+				if (!token) return;
+				nextId += 1;
+				const limit = Math.max(1, options.limit ?? 20);
+				const { entries, pending } = state.get();
+				show([...entries, {
+					id: nextId,
+					label,
+					token
+				}].slice(-limit), pending, void 0);
+			},
+			undo: async () => {
+				const { entries, pending } = state.get();
+				const top = entries.at(-1);
+				if (!top || pending) return false;
+				show(entries.slice(0, -1), true, void 0);
+				let error;
+				let worked = true;
+				try {
+					await options.apply(top.token);
+				} catch (cause) {
+					error = cause;
+					worked = false;
+				}
+				show(state.get().entries, false, error);
+				return worked;
+			},
+			clear: () => {
+				show([], state.get().pending, void 0);
+			}
+		} };
+	});
+}
+//#endregion
 //#region src/blocks/undo/manifest.ts
 /** The `undo` block's manifest (ADR 0029). */
 const undoBlock = defineBlock({

package/dist/blocks/updated-at/index.d.ts

@@ -0,0 +1,20 @@
+/// <reference lib="esnext.temporal" />
+import { Mt as Plugin } from "../../types-DFdg_4yN.js";
+import { t as UpdatedAtSqlOptions } from "../../options-DChZoVfs.js";
+import { r as Block } from "../../define-block-BVcLQ3DF.js";
+//#region src/blocks/updated-at/extension.d.ts
+/**
+ * The `updated-at` block's repository extension. Stamps the columns generated
+ * as `Flags.timestamps`: `createdAt` on insert, `updatedAt` on insert and
+ * update. A call that sets either column fails with `invalid_request` unless it
+ * passes `{ override: true }`, which keeps the caller's values. The block's
+ * `track_updated_at` trigger covers writes that bypass the app, and every write
+ * when the runtime has no Temporal.
+ */
+export declare function updatedAtExtension(): Plugin<"timestamps">;
+//#endregion
+//#region src/blocks/updated-at/manifest.d.ts
+/** The `updated-at` block's manifest (ADR 0029). */
+export declare const updatedAtBlock: Block<"updated-at">;
+//#endregion
+export type { UpdatedAtSqlOptions };

package/dist/blocks/updated-at/index.js

@@ -0,0 +1,14 @@
+import { t as updatedAtSqlOptions } from "../../options-C-dQHH5-.js";
+import { n as defineBlock } from "../../define-block-BGqOO8B3.js";
+import { t as updatedAtExtension } from "../../extension-B0EjCYhO.js";
+//#region src/blocks/updated-at/manifest.ts
+/** The `updated-at` block's manifest (ADR 0029). */
+const updatedAtBlock = defineBlock({
+	name: "updated-at",
+	sql: ["updated-at"],
+	options: { "updated-at": updatedAtSqlOptions },
+	category: "database",
+	extension: "updatedAtExtension"
+});
+//#endregion
+export { updatedAtBlock, updatedAtExtension };

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

@@ -1,10 +1,44 @@
-import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DBPhgF3W.js";
-import { n as StripeSource, t as StripeClient } from "../../stripe-BSEwKCni.js";
-import { _ as reportUsageToStripe, a as Usage, c as UsageEntry, d as UsageMeterInfo, f as UsageOptions, g as createUsage, h as UsageStatus, i as ReportUsageResult, l as UsageHistoryEntry, m as UsageRecorded, n as RecordUsageOptions, o as UsageBatchRecorded, p as UsagePeriod, r as ReportUsageOptions, s as UsageBreakdownEntry, t as PurgeUsageOptions, u as UsageHistoryOptions } from "../../usage-BFwuH7GK.js";
-import { s as BlockOf } from "../../define-block-MyM4lH42.js";
-import { a as UsageMeterSnapshot, i as UsageMeterControllerOptions, n as UsageMeterActions, o as createUsageMeterController, r as UsageMeterController, t as MeterReading } from "../../client-BP-8vn9G.js";
+import { b as DbError } from "../../result-DZeA5KS6.js";
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DWZSJrwN.js";
+import { n as StripeSource, t as StripeClient } from "../../stripe-X22LjuH-.js";
+import { _ as reportUsageToStripe, a as Usage, c as UsageEntry, d as UsageMeterInfo, f as UsageOptions, g as createUsage, h as UsageStatus, i as ReportUsageResult, l as UsageHistoryEntry, m as UsageRecorded, n as RecordUsageOptions, o as UsageBatchRecorded, p as UsagePeriod, r as ReportUsageOptions, s as UsageBreakdownEntry, t as PurgeUsageOptions, u as UsageHistoryOptions } from "../../usage-D7QkrwzV.js";
+import { c as BlockOf } from "../../define-block-BVcLQ3DF.js";
+import { n as Controller, t as AuthPort } from "../../controller-BrP0gn47.js";
 //#region src/blocks/usage/manifest.d.ts
 /** The `usage` block's manifest (ADR 0029). */
 export declare const usageBlock: BlockOf<"usage", typeof createUsage>;
 //#endregion
-export { type BlockTransport, type MeterReading, type PurgeUsageOptions, type RecordUsageOptions, type ReportUsageOptions, type ReportUsageResult, type StripeClient, type StripeSource, type Usage, type UsageBatchRecorded, type UsageBreakdownEntry, type UsageEntry, type UsageHistoryEntry, type UsageHistoryOptions, type UsageMeterActions, type UsageMeterController, type UsageMeterControllerOptions, type UsageMeterInfo, type UsageMeterSnapshot, type UsageOptions, type UsagePeriod, type UsageRecorded, type UsageStatus, createUsage, createUsageMeterController, dbTransport, reportUsageToStripe, rpcTransport, sqlTransport };
+//#region src/blocks/usage/client.d.ts
+interface UsageMeterControllerOptions {
+  /** `createUsage({ transport })`, or a `Pick` with `overview`. */
+  readonly client: Pick<Usage, "overview">;
+  readonly auth: AuthPort;
+  /** The organization whose usage to read; the meter waits without one. */
+  readonly organizationId: string | null;
+  /**
+   * Only these meters, in this order. Default every meter with usage or a
+   * quota.
+   */
+  readonly meters?: readonly string[];
+}
+/** One meter against its quota. */
+interface MeterReading extends UsageStatus {
+  /** `used / limit` from 0 to 1, or `undefined` without a limit. */
+  readonly fraction: number | undefined;
+  /** True once the period's quota is used up. */
+  readonly exceeded: boolean;
+}
+interface UsageMeterSnapshot {
+  /** `undefined` until the first load. */
+  readonly meters: readonly MeterReading[] | undefined;
+  readonly error: DbError | undefined;
+}
+interface UsageMeterActions {
+  /** Reads the usage again, such as after the app records some. */
+  readonly refresh: () => Promise<void>;
+}
+type UsageMeterController = Controller<UsageMeterSnapshot, UsageMeterActions>;
+/** This period's usage of an organization against its plan's quotas, per meter. */
+export declare function createUsageMeterController(options: UsageMeterControllerOptions): UsageMeterController;
+//#endregion
+export { type BlockTransport, type MeterReading, type PurgeUsageOptions, type RecordUsageOptions, type ReportUsageOptions, type ReportUsageResult, type StripeClient, type StripeSource, type Usage, type UsageBatchRecorded, type UsageBreakdownEntry, type UsageEntry, type UsageHistoryEntry, type UsageHistoryOptions, type UsageMeterActions, type UsageMeterController, type UsageMeterControllerOptions, type UsageMeterInfo, type UsageMeterSnapshot, type UsageOptions, type UsagePeriod, type UsageRecorded, type UsageStatus, createUsage, dbTransport, reportUsageToStripe, rpcTransport, sqlTransport };