better-supabase 0.14.0 → 0.15.1

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-d53POsem.js";
-import { c as BlockOf } from "../../define-block-COpcS6aT.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-B696duxr.js";
-import { a as UndoStackOptions, i as UndoSnapshot, n as UndoController, o as createUndoController, r as UndoEntry, t as UndoActions } from "../../client-COuIfjbB.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-DvvcM54N.js";
+import { n as Controller } from "../../controller-DyPPMFSw.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 { B as dbTransport, H as rpcTransport, U as sqlTransport } from "../../block-helpers-CiKtrb6g.js";
-import { n as defineBlock } from "../../define-block-Dze77QTw.js";
-import { i as undoToken, n as createUndo, r as isUndoToken, t as UNDO_FUNCTIONS } from "../../undo-vutx78k8.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-DvvcM54N.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-d53POsem.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-DBcVGqnr.js";
-import { c as BlockOf } from "../../define-block-COpcS6aT.js";
-import { a as UsageMeterSnapshot, i as UsageMeterControllerOptions, n as UsageMeterActions, o as createUsageMeterController, r as UsageMeterController, t as MeterReading } from "../../client-Bn0qqRBg.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-Dp45V42p.js";
+import { c as BlockOf } from "../../define-block-DvvcM54N.js";
+import { n as Controller, t as AuthPort } from "../../controller-DyPPMFSw.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 };

package/dist/blocks/usage/index.js

@@ -1,8 +1,269 @@
+import { n as isRecord } from "../../guards-6F2bCtQR.js";
 import { t as usageSqlOptions } from "../../options-B9q8CROT.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 reportUsageToStripe, t as createUsage } from "../../usage-BI1E2940.js";
-import { t as createUsageMeterController } from "../../client-DScMvaty.js";
+import { n as whileSignedIn, t as defineController } from "../../controller-BEliOBOv.js";
+import { B as dbTransport, C as optionalText, D as recordOf, H as rpcTransport, I as textOf, M as seconds, R as toInstant, U as sqlTransport, k as recordsOf, n as applyTemporal, o as blockCall, t as DEFAULT_BLOCK_SCHEMA, u as eachLimit, w as pageOf } from "../../block-helpers-CtBdjgO4.js";
+import { r as withBlockHooks } from "../../block-hooks-BfxX3682.js";
+import { n as defineBlock } from "../../define-block-BGqOO8B3.js";
+import { t as lazyStripe } from "../../stripe-BJUfp5jM.js";
+//#region src/blocks/usage/usage.ts
+const numberOf = (value) => typeof value === "number" ? value : Number(value);
+const optionalNumber = (value) => value === null || value === void 0 ? void 0 : numberOf(value);
+const PERIODS = /* @__PURE__ */ new Set([
+	"day",
+	"week",
+	"month",
+	"year",
+	"billing"
+]);
+const periodOf = (value) => {
+	const text = textOf(value);
+	return PERIODS.has(text) ? text : "month";
+};
+function recordedOf(value) {
+	const row = recordOf(value, "record_usage");
+	return {
+		recorded: row["recorded"] === true,
+		today: numberOf(row["today"]),
+		used: numberOf(row["used"])
+	};
+}
+const perMeter = (value) => isRecord(value) ? Object.fromEntries(Object.entries(value).map(([meter, used]) => [meter, numberOf(used)])) : {};
+function statusOf(value) {
+	const row = recordOf(value, "usage_status");
+	return {
+		meter: textOf(row["meter"]),
+		used: numberOf(row["used"]),
+		limit: optionalNumber(row["limit"]),
+		remaining: optionalNumber(row["remaining"]),
+		unlimited: row["unlimited"] === true,
+		period: periodOf(row["period"]),
+		startsAt: row["starts_at"] === void 0 || row["starts_at"] === null ? void 0 : toInstant(textOf(row["starts_at"])),
+		resetsAt: toInstant(textOf(row["resets_at"])),
+		...meterInfo(row)
+	};
+}
+function meterInfo(row) {
+	const unit = optionalText(row["unit"]);
+	const category = optionalText(row["category"]);
+	const label = optionalText(row["label"]);
+	const kind = optionalText(row["kind"]);
+	const period = optionalText(row["period"]);
+	return {
+		...unit === void 0 ? {} : { unit },
+		...category === void 0 ? {} : { category },
+		...label === void 0 ? {} : { label },
+		...kind === "counter" || kind === "distinct" || kind === "computed" ? { kind } : {},
+		...period === "day" || period === "week" || period === "month" || period === "year" || period === "billing" ? { period } : {}
+	};
+}
+/** Usage metering and quotas over the `usage` module's functions. */
+function createUsage(options) {
+	applyTemporal(options);
+	const call = blockCall(options.transport, options.schema, options.mappers);
+	const args = (organizationId, meter, record = {}) => ({
+		tenant: organizationId,
+		meter,
+		quantity: record.quantity ?? 1,
+		idempotency_key: record.idempotencyKey,
+		source: record.source,
+		metadata: record.metadata,
+		actor: record.actor
+	});
+	const batch = (check) => (organizationId, entries, record = {}) => call("record_usage_batch", {
+		tenant: organizationId,
+		entries: JSON.stringify(entries.map((entry) => ({
+			meter: entry.meter,
+			quantity: entry.quantity ?? 1
+		}))),
+		idempotency_key: record.idempotencyKey,
+		check,
+		source: record.source,
+		metadata: record.metadata,
+		actor: record.actor
+	}, (value) => {
+		const row = recordOf(value, "record_usage_batch");
+		return {
+			recorded: row["recorded"] === true,
+			today: perMeter(row["today"]),
+			used: perMeter(row["used"])
+		};
+	});
+	const current = (organizationId, meter) => call("usage_status", {
+		tenant: organizationId,
+		meter
+	}, statusOf);
+	const purge = (fn) => (purgeOptions = {}) => call(fn, {
+		older_than: purgeOptions.olderThan === void 0 ? void 0 : seconds(purgeOptions.olderThan),
+		batch: purgeOptions.batch
+	}, (value) => Number(value ?? 0));
+	const purgeHistory = purge("purge_usage_history");
+	const purgeEvents = purge("purge_usage_events");
+	const client = {
+		purgeHistory,
+		purgeEvents,
+		purgeJob: (jobOptions = {}) => async () => ({
+			history: await purgeHistory(jobOptions.history).orThrow(),
+			events: await purgeEvents(jobOptions.events).orThrow()
+		}),
+		record: (organizationId, meter, record) => call("record_usage", args(organizationId, meter, record), recordedOf),
+		track: (organizationId, meter, subject, trackOptions = {}) => call("track_usage", {
+			tenant: organizationId,
+			meter,
+			subject,
+			period: trackOptions.period ?? "month"
+		}, recordedOf),
+		refresh: (meter) => call("usage_refresh", { meter }, (value) => Number(value ?? 0)),
+		consume: (organizationId, meter, record) => call("consume_quota", args(organizationId, meter, record), recordedOf),
+		recordMany: batch(false),
+		consumeMany: batch(true),
+		current,
+		overview: (organizationId) => call("usage_overview", { tenant: organizationId }, (value) => (Array.isArray(value) ? value : []).map(statusOf)),
+		remaining: (organizationId, meter) => current(organizationId, meter).map((status) => status.remaining),
+		history: (organizationId, list = {}) => call("usage_history", {
+			tenant: organizationId,
+			meter: list.meter,
+			max_rows: list.limit ?? 100,
+			before_id: pageOf(list).cursor
+		}, (value) => (Array.isArray(value) ? value.filter(isRecord) : []).map((row) => ({
+			id: numberOf(row["id"]),
+			meter: textOf(row["meter"]),
+			quantity: numberOf(row["quantity"]),
+			actor: optionalText(row["actor"]),
+			source: optionalText(row["source"]),
+			metadata: isRecord(row["metadata"]) ? row["metadata"] : {},
+			recordedAt: toInstant(textOf(row["recorded_at"]))
+		}))),
+		breakdown: (organizationId, meter) => call("usage_breakdown", {
+			tenant: organizationId,
+			meter
+		}, (value) => (Array.isArray(value) ? value.filter(isRecord) : []).map((row) => ({
+			actor: optionalText(row["actor"]),
+			source: optionalText(row["source"]),
+			quantity: numberOf(row["quantity"])
+		}))),
+		meters: () => call("usage_meters", {}, (value) => {
+			const row = isRecord(value) ? value : {};
+			return Object.fromEntries(Object.entries(row).map(([meter, info]) => [meter, meterInfo(isRecord(info) ? info : {})]));
+		})
+	};
+	return withBlockHooks(client, options.hooks, {
+		block: "usage",
+		...options.logger ? { logger: options.logger } : {}
+	});
+}
+/** Customer lookups, and meter events with their marks, in flight at once. */
+const REPORT_CONCURRENCY = 8;
+/**
+* Sends unreported usage to Stripe as meter events, one per counter and delta.
+* The event `identifier` is the tenant, meter, day and new total, so a run that
+* fails after sending and before marking resends the same event, and Stripe
+* drops the duplicate. Run it from a job or a cron route.
+*/
+async function reportUsageToStripe(options) {
+	const call = blockCall(options.transport, options.schema);
+	const entitlements = blockCall(options.transport, DEFAULT_BLOCK_SCHEMA);
+	const stripe = await lazyStripe(options.stripe)();
+	const customers = /* @__PURE__ */ new Map();
+	const customerOf = options.customer ?? (async (organizationId) => entitlements("tenant_stripe_customer", { tenant: organizationId }, optionalText).orThrow());
+	const limit = options.batch ?? 500;
+	const skipMeters = /* @__PURE__ */ new Set();
+	const skipTenants = /* @__PURE__ */ new Set();
+	/**
+	* Sends the meter event when there is a delta, then marks the total; `true`
+	* when it sent one.
+	*/
+	const send = async (pending) => {
+		const { organizationId, meter, day, value, delta, identifier } = pending;
+		if (delta > 0) await stripe.billing.meterEvents.create({
+			event_name: pending.eventName,
+			payload: {
+				stripe_customer_id: pending.customer,
+				value: String(delta)
+			},
+			identifier,
+			timestamp: Math.floor(Math.min(Date.now(), Date.parse(`${day}T23:59:59Z`)) / 1e3)
+		}, { idempotencyKey: identifier });
+		await call("mark_usage_reported", {
+			tenant: organizationId,
+			meter,
+			day,
+			value
+		}, () => void 0).orThrow();
+		return delta > 0;
+	};
+	let reported = 0;
+	let skipped = 0;
+	let handled = 0;
+	for (;;) {
+		const rows = await call("unreported_usage", {
+			max_rows: limit - handled,
+			skip_meters: [...skipMeters],
+			skip_tenants: [...skipTenants]
+		}, (value) => recordsOf(value, "unreported_usage")).orThrow();
+		let passedOver = false;
+		const eventNameOf = (meter) => options.eventName ? options.eventName(meter) : meter;
+		const lookups = /* @__PURE__ */ new Set();
+		for (const row of rows) {
+			const organizationId = textOf(row["organization_id"]);
+			if (!customers.has(organizationId) && !skipTenants.has(organizationId) && eventNameOf(textOf(row["meter"])) !== void 0) lookups.add(organizationId);
+		}
+		await eachLimit([...lookups], REPORT_CONCURRENCY, async (organizationId) => {
+			customers.set(organizationId, await customerOf(organizationId));
+		});
+		const sends = [];
+		for (const row of rows) {
+			const organizationId = textOf(row["organization_id"]);
+			const meter = textOf(row["meter"]);
+			if (skipMeters.has(meter) || skipTenants.has(organizationId)) {
+				skipped += 1;
+				continue;
+			}
+			const eventName = eventNameOf(meter);
+			if (eventName === void 0) {
+				skipMeters.add(meter);
+				skipped += 1;
+				passedOver = true;
+				continue;
+			}
+			const customer = customers.get(organizationId);
+			if (customer === void 0) {
+				skipTenants.add(organizationId);
+				skipped += 1;
+				passedOver = true;
+				continue;
+			}
+			handled += 1;
+			const day = textOf(row["day"]).slice(0, 10);
+			const value = numberOf(row["value"]);
+			const previous = numberOf(row["reported_value"]);
+			const included = optionalNumber(row["included"]);
+			const before = numberOf(row["window_before"] ?? 0);
+			const delta = options.overage === true && row["unlimited"] === true ? 0 : options.overage === true && included !== void 0 ? Math.max(0, before + value - included) - Math.max(0, before + previous - included) : value - previous;
+			const identifier = `${organizationId}:${meter}:${day}:${String(value)}`;
+			sends.push({
+				organizationId,
+				meter,
+				day,
+				value,
+				delta,
+				eventName,
+				customer,
+				identifier
+			});
+		}
+		const sent = [];
+		await eachLimit(sends, REPORT_CONCURRENCY, async (pending, index) => {
+			sent[index] = await send(pending);
+		});
+		reported += sent.filter(Boolean).length;
+		if (!passedOver || handled >= limit || rows.length === 0) break;
+	}
+	return {
+		reported,
+		skipped
+	};
+}
+//#endregion
 //#region src/blocks/usage/manifest.ts
 /** The `usage` block's manifest (ADR 0029). */
 const usageBlock = defineBlock({
@@ -14,4 +275,40 @@ const usageBlock = defineBlock({
 	recipes: ["usage-meter"]
 });
 //#endregion
+//#region src/blocks/usage/client.ts
+function readingOf(status) {
+	const limit = status.unlimited ? void 0 : status.limit;
+	return {
+		...status,
+		fraction: limit === void 0 ? void 0 : limit === 0 ? 1 : Math.min(1, status.used / limit),
+		exceeded: limit !== void 0 && status.used >= limit
+	};
+}
+/** This period's usage of an organization against its plan's quotas, per meter. */
+function createUsageMeterController(options) {
+	const { client, organizationId, meters } = options;
+	const pick = (all) => meters === void 0 ? all : meters.flatMap((meter) => all.filter((each) => each.meter === meter));
+	return defineController({
+		meters: void 0,
+		error: void 0
+	}, (state) => {
+		const refresh = async () => {
+			if (organizationId === null) return;
+			const run = state.run();
+			const result = await client.overview(organizationId);
+			if (run !== state.run()) return;
+			state.set(result.ok ? {
+				meters: pick(result.data).map(readingOf),
+				error: void 0
+			} : { error: result.error });
+		};
+		return {
+			actions: { refresh },
+			start: () => organizationId === null ? void 0 : whileSignedIn(options.auth, () => {
+				refresh();
+			})
+		};
+	});
+}
+//#endregion
 export { createUsage, createUsageMeterController, dbTransport, reportUsageToStripe, rpcTransport, sqlTransport, usageBlock };

package/dist/blocks/vercel-marketplace/index.d.ts

@@ -1,12 +1,12 @@
 /// <reference lib="esnext.temporal" />
-import { T as ErrorMapper, b as DbError, t as AsyncResult } from "../../result-C6jDfedy.js";
-import { Ct as Events } from "../../events-DbLjvxDX.js";
+import { T as ErrorMapper, b as DbError, t as AsyncResult } from "../../result-DZeA5KS6.js";
+import { Ct as Events } from "../../events-vcqenSYU.js";
 import { n as Logger } from "../../logger-DWVYUmwi.js";
-import { r as BlockTemporalOptions } 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 { a as ProblemFormat, t as BlockProblemOptions } from "../../problem-DpHB7tWl.js";
-import { c as BlockOf } from "../../define-block-COpcS6aT.js";
+import { r as BlockTemporalOptions } 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 { a as ProblemFormat, t as BlockProblemOptions } from "../../problem-DNwN8iGz.js";
+import { c as BlockOf } from "../../define-block-DvvcM54N.js";
 import { n as Jwks } from "../../jws-D0toeQlA.js";
 //#region src/blocks/vercel-marketplace/partner-api.d.ts
 /** The Vercel environments a resource's secrets reach. */

package/dist/blocks/vercel-marketplace/index.js

@@ -1,16 +1,16 @@
-import { n as dbError, r as dbErrorOf } from "../../errors-03ysrOt4.js";
-import { a as ok, r as err, t as AsyncResult } from "../../result-B3m7xtRY.js";
+import { n as dbError, r as dbErrorOf } from "../../errors-BVFgt8BZ.js";
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
-import { a as methodNotAllowed, o as problemResponse } from "../../problem-BWElIgIb.js";
+import { a as ok, r as err, t as AsyncResult } from "../../result-ntFBW2p2.js";
+import { a as methodNotAllowed, o as problemResponse } from "../../problem-Bf0cJ7tk.js";
 import { t as vercelMarketplaceSqlOptions } from "../../options-RKYdmIdV.js";
-import { C as optionalText, D as recordOf, I as textOf, U as sqlTransport, f as errorText, k as recordsOf, n as applyTemporal, o as blockCall } from "../../block-helpers-CiKtrb6g.js";
-import { r as withBlockHooks } from "../../block-hooks-BymdcD0V.js";
+import { C as optionalText, D as recordOf, I as textOf, U as sqlTransport, f as errorText, 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 { r as timingSafeEqual } from "../../hmac-B3CTTlfv.js";
-import { t as cronRoute } from "../../cron-route-Y0eJ-FNi.js";
+import { t as cronRoute } from "../../cron-route-UU9i5i9J.js";
 import { c as verifyCompact, t as JwsError } from "../../jws-DOgHJKHb.js";
-import { t as jwksSource } from "../../jwks-cache-CRymV-Dr.js";
-import { n as defineBlock } from "../../define-block-Dze77QTw.js";
+import { t as jwksSource } from "../../jwks-cache-DEsKI0hJ.js";
+import { n as defineBlock } from "../../define-block-BGqOO8B3.js";
 //#region src/blocks/vercel-marketplace/partner-api.ts
 const VERCEL_ENVIRONMENTS = [
 	"production",