better-supabase 0.14.0 → 0.15.0

package/dist/undo-B696duxr.d.ts

@@ -1,46 +0,0 @@
-import { T as ErrorMapper, t as AsyncResult } from "./result-C6jDfedy.js";
-import { n as Logger } from "./logger-DWVYUmwi.js";
-import { t as BlockTransport } from "./block-transport-d53POsem.js";
-import { n as BlockHooks } from "./block-hooks-CmjPKqQ_.js";
-//#region src/blocks/undo/undo.d.ts
-/** One call that reverses part of a change. */
-interface UndoCall {
-  readonly fn: string;
-  readonly args: Readonly<Record<string, unknown>>;
-}
-/**
- * What a block method returns when its change has an inverse. It is plain JSON,
- * so it can travel from a server action to a toast and back. Applying it runs
- * the calls in order as the caller, so the same permission checks apply as for
- * any other write.
- */
-interface UndoToken {
-  readonly v: 1;
-  readonly calls: readonly UndoCall[];
-}
-/** The functions an undo token may call: the inverses the blocks return. */
-declare const UNDO_FUNCTIONS: readonly string[];
-declare function undoToken(calls: readonly UndoCall[]): UndoToken;
-/** Whether a value is an undo token whose calls are all allowed. */
-declare function isUndoToken(value: unknown, allowed?: readonly string[]): value is UndoToken;
-interface UndoOptions {
-  readonly transport: BlockTransport;
-  readonly schema?: string;
-  readonly mappers?: readonly ErrorMapper[];
-  /** Extra functions a token may call, for an app's own inverses. */
-  readonly allow?: readonly string[];
-  /**
-   * `withBlockHooks` hooks around `apply`, such as a rule on which tokens a
-   * user may apply.
-   */
-  readonly hooks?: BlockHooks<Undo>;
-  /** Receives the errors `after` hooks throw. Default: `console`. */
-  readonly logger?: Logger;
-}
-interface Undo {
-  /** Runs a token's calls in order; stops at the first error. */
-  apply(token: unknown): AsyncResult<number>;
-}
-declare function createUndo(options: UndoOptions): Undo;
-//#endregion
-export { UndoToken as a, undoToken as c, UndoOptions as i, Undo as n, createUndo as o, UndoCall as r, isUndoToken as s, UNDO_FUNCTIONS as t };

package/dist/undo-vutx78k8.js

@@ -1,44 +0,0 @@
-import { n as dbError } from "./errors-03ysrOt4.js";
-import { a as ok, t as AsyncResult } from "./result-B3m7xtRY.js";
-import { n as isRecord } from "./guards-6F2bCtQR.js";
-import { o as blockCall } from "./block-helpers-CiKtrb6g.js";
-import { r as withBlockHooks } from "./block-hooks-BymdcD0V.js";
-//#region src/blocks/undo/undo.ts
-/** The functions an undo token may call: the inverses the blocks return. */
-const UNDO_FUNCTIONS = [
-	"link",
-	"unlink",
-	"revert_audit_entries"
-];
-function undoToken(calls) {
-	return {
-		v: 1,
-		calls
-	};
-}
-/** Whether a value is an undo token whose calls are all allowed. */
-function isUndoToken(value, allowed = UNDO_FUNCTIONS) {
-	return isRecord(value) && value["v"] === 1 && Array.isArray(value["calls"]) && value["calls"].length > 0 && value["calls"].every((call) => isRecord(call) && typeof call["fn"] === "string" && allowed.includes(call["fn"]) && isRecord(call["args"]));
-}
-function createUndo(options) {
-	const call = blockCall(options.transport, options.schema, options.mappers);
-	const allowed = [...UNDO_FUNCTIONS, ...options.allow ?? []];
-	return withBlockHooks({ apply: (token) => {
-		if (!isUndoToken(token, allowed)) return AsyncResult.err(dbError("validation", "not an undo token this app accepts", { issues: [{
-			message: "not an undo token this app accepts",
-			path: []
-		}] }));
-		return AsyncResult.from(async () => {
-			for (const step of token.calls) {
-				const result = await call(step.fn, step.args, () => void 0);
-				if (!result.ok) return result;
-			}
-			return ok(token.calls.length);
-		});
-	} }, options.hooks, {
-		block: "undo",
-		...options.logger ? { logger: options.logger } : {}
-	});
-}
-//#endregion
-export { undoToken as i, createUndo as n, isUndoToken as r, UNDO_FUNCTIONS as t };

package/dist/upload-claim-D_wgDbi7.js

@@ -1,33 +0,0 @@
-import { n as dbError } from "./errors-03ysrOt4.js";
-import { a as ok, r as err, t as AsyncResult } from "./result-B3m7xtRY.js";
-import { t as fromStorageError } from "./errors-DZx8w-MH.js";
-//#region src/blocks/upload-claim.ts
-function refusal(cause, hints) {
-	const error = fromStorageError(cause, "storage.objects");
-	if (error.kind === "not_found") return dbError("not_found", "The file was not uploaded yet", { hint: hints.notUploaded });
-	if (error.kind === "forbidden") return dbError("forbidden", error.message, {
-		hint: hints.forbidden,
-		...error.code === void 0 ? {} : { code: error.code }
-	});
-	return error;
-}
-/**
-* Claims an object a browser uploaded to a signed upload URL, so a support
-* session records it. Succeeds without a request when the storage has no claim
-* step.
-*/
-function claimUpload(storage, file, hints) {
-	return AsyncResult.from(async () => {
-		if (!storage.claimSignedUpload) return ok(void 0);
-		try {
-			const { error } = await storage.claimSignedUpload(file.bucket, file.path);
-			return error ? err(refusal(error, hints)) : ok(void 0);
-		} catch (cause) {
-			return err(refusal(cause, hints));
-		}
-	});
-}
-/** Whether `storage` has a claim step, so a block needs the file's path first. */
-const claimsUploads = (storage) => storage.claimSignedUpload !== void 0;
-//#endregion
-export { claimsUploads as n, claimUpload as t };

package/dist/usage-BI1E2940.js

@@ -1,264 +0,0 @@
-import { n as isRecord } from "./guards-6F2bCtQR.js";
-import { C as optionalText, D as recordOf, I as textOf, M as seconds, R as toInstant, k as recordsOf, n as applyTemporal, o as blockCall, t as DEFAULT_BLOCK_SCHEMA, u as eachLimit, w as pageOf } from "./block-helpers-CiKtrb6g.js";
-import { r as withBlockHooks } from "./block-hooks-BymdcD0V.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
-export { reportUsageToStripe as n, createUsage as t };

package/dist/usage-DBcVGqnr.d.ts

@@ -1,232 +0,0 @@
-/// <reference lib="esnext.temporal" />
-import { t as AsyncResult } from "./result-C6jDfedy.js";
-import { n as Logger } from "./logger-DWVYUmwi.js";
-import { i as CursorPageOptions, n as BlockOptions } from "./block-helpers-BaugZlJV.js";
-import { t as BlockTransport } from "./block-transport-d53POsem.js";
-import { n as BlockHooks } from "./block-hooks-CmjPKqQ_.js";
-import { g as JobHandler } from "./types-CGUDoF5I.js";
-import { n as StripeSource } from "./stripe-X22LjuH-.js";
-//#region src/blocks/usage/usage.d.ts
-interface UsageOptions extends BlockOptions {
-  /**
-   * `withBlockHooks` hooks around the client's methods, such as a check before
-   * `consume`.
-   */
-  readonly hooks?: BlockHooks<Usage>;
-  /** Receives the errors `after` hooks throw. Default: `console`. */
-  readonly logger?: Logger;
-}
-interface RecordUsageOptions {
-  /** Default 1. */
-  readonly quantity?: number;
-  /** A retried call with the same key counts once. */
-  readonly idempotencyKey?: string;
-  /**
-   * What used it, such as `feature:summary` or `api:/v1/search`, kept in the
-   * history with `blocks.usage.options.history`.
-   */
-  readonly source?: string;
-  /** More detail for the history entry, such as a document id. */
-  readonly metadata?: Readonly<Record<string, unknown>>;
-  /**
-   * Who used it, for a service transport recording on a user's behalf. Ignored
-   * for other callers, whose own user id is recorded.
-   */
-  readonly actor?: string;
-}
-/** One meter of a batch. */
-interface UsageEntry {
-  readonly meter: string;
-  /** Default 1. */
-  readonly quantity?: number;
-}
-interface UsageBatchRecorded {
-  /** False when the idempotency key was seen before for every meter. */
-  readonly recorded: boolean;
-  /** Today's usage per meter (UTC). */
-  readonly today: Readonly<Record<string, number>>;
-  /** Usage per meter in its quota's current period, as `current()` reports it. */
-  readonly used: Readonly<Record<string, number>>;
-}
-/** One entry of the usage history. */
-interface UsageHistoryEntry {
-  readonly id: number;
-  readonly meter: string;
-  readonly quantity: number;
-  /** The user who used it, or `undefined` for service usage without one. */
-  readonly actor: string | undefined;
-  readonly source: string | undefined;
-  readonly metadata: Readonly<Record<string, unknown>>;
-  readonly recordedAt: Temporal.Instant;
-}
-/** Usage of a meter in its current window per actor and source. */
-interface UsageBreakdownEntry {
-  readonly actor: string | undefined;
-  readonly source: string | undefined;
-  readonly quantity: number;
-}
-interface UsageHistoryOptions extends CursorPageOptions<number> {
-  readonly meter?: string;
-  /** Defaults to 100, at most 1000. */
-  readonly limit?: number;
-  /** Only entries with a lower id, for the next page. */
-  readonly cursor?: number;
-}
-interface UsageRecorded {
-  /** False when the idempotency key was seen before. */
-  readonly recorded: boolean;
-  /** Today's usage of the meter (UTC). */
-  readonly today: number;
-  /** Usage in the quota's current period, as `current()` reports it. */
-  readonly used: number;
-}
-/**
- * A quota period: a UTC calendar period, or `billing` for the window the app's
- * `usage_billing_period(tenant)` function returns.
- */
-type UsagePeriod = "day" | "week" | "month" | "year" | "billing";
-/** One meter of `blocks.usage.options.meters`. */
-interface UsageMeterInfo {
-  readonly unit?: string;
-  readonly category?: string;
-  readonly label?: string;
-  /** `counter` when the catalog gives no kind. */
-  readonly kind?: "counter" | "distinct" | "computed";
-  /** The window a distinct or computed meter measures. */
-  readonly period?: UsagePeriod;
-}
-interface UsageStatus {
-  readonly meter: string;
-  /** Usage in the current period. */
-  readonly used: number;
-  /** `undefined` without a quota and for an unlimited one. */
-  readonly limit: number | undefined;
-  readonly remaining: number | undefined;
-  readonly unlimited: boolean;
-  readonly period: UsagePeriod;
-  /** When the current period started. */
-  readonly startsAt: Temporal.Instant | undefined;
-  readonly resetsAt: Temporal.Instant;
-  /** From the meter catalog, when the module has one. */
-  readonly unit?: string;
-  readonly category?: string;
-  readonly label?: string;
-}
-interface Usage {
-  /** Adds usage without checking the quota (metering only). */
-  record(organizationId: string, meter: string, options?: RecordUsageOptions): AsyncResult<UsageRecorded>;
-  /**
-   * Counts `subject` once in the current period of a `distinct` meter (active
-   * users, say). Repeating a subject changes nothing, and quotas and Stripe
-   * reporting read the meter like a counter.
-   */
-  track(organizationId: string, meter: string, subject: string, options?: {
-    readonly period?: UsagePeriod;
-  }): AsyncResult<UsageRecorded>;
-  /**
-   * Recomputes `computed` meters from their query for every tenant it returns,
-   * or for one meter. Service role only; returns the rows written. The
-   * migration schedules it hourly when pg_cron is installed.
-   */
-  refresh(meter?: string): AsyncResult<number>;
-  /** Adds usage when it fits the quota, or returns `quota_exceeded`. */
-  consume(organizationId: string, meter: string, options?: RecordUsageOptions): AsyncResult<UsageRecorded>;
-  /**
-   * Adds several meters in one transaction, all or none, such as input and
-   * output tokens of one call. The idempotency key covers the batch.
-   */
-  recordMany(organizationId: string, entries: readonly UsageEntry[], options?: Omit<RecordUsageOptions, "quantity">): AsyncResult<UsageBatchRecorded>;
-  /**
-   * Like `recordMany`, but checks each meter's quota first; when one doesn't
-   * fit, nothing is recorded and the result is `quota_exceeded`.
-   */
-  consumeMany(organizationId: string, entries: readonly UsageEntry[], options?: Omit<RecordUsageOptions, "quantity">): AsyncResult<UsageBatchRecorded>;
-  current(organizationId: string, meter: string): AsyncResult<UsageStatus>;
-  overview(organizationId: string): AsyncResult<readonly UsageStatus[]>;
-  /** Units left in the period, or `undefined` without a quota. */
-  remaining(organizationId: string, meter: string): AsyncResult<number | undefined>;
-  /** The meter catalog (`options.meters`), empty without one. */
-  meters(): AsyncResult<Readonly<Record<string, UsageMeterInfo>>>;
-  /**
-   * The tenant's usage entries, newest first, with who and what used each
-   * (`usage.read`). Empty without `blocks.usage.options.history`.
-   */
-  history(organizationId: string, options?: UsageHistoryOptions): AsyncResult<readonly UsageHistoryEntry[]>;
-  /**
-   * The meter's usage in its current quota window per actor and source, largest
-   * first (`usage.read`). Empty without the history option.
-   */
-  breakdown(organizationId: string, meter: string): AsyncResult<readonly UsageBreakdownEntry[]>;
-  /**
-   * Deletes up to `batch` history entries older than `olderThan` (default 400
-   * days, `purge_usage_history`); returns how many.
-   */
-  purgeHistory(options?: PurgeUsageOptions): AsyncResult<number>;
-  /**
-   * Deletes up to `batch` idempotency keys of recorded usage older than
-   * `olderThan` (default 30 days, `purge_usage_events`); returns how many. A
-   * retry with a purged key records again.
-   */
-  purgeEvents(options?: PurgeUsageOptions): AsyncResult<number>;
-  /**
-   * A job handler that runs `purgeHistory` and `purgeEvents`; schedule it
-   * nightly.
-   */
-  purgeJob(options?: {
-    readonly history?: PurgeUsageOptions;
-    readonly events?: PurgeUsageOptions;
-  }): JobHandler<unknown>;
-}
-interface PurgeUsageOptions {
-  /** Seconds, or an interval such as `"90 days"`. */
-  readonly olderThan?: number | string;
-  /** Defaults to 10000. */
-  readonly batch?: number;
-}
-/** Usage metering and quotas over the `usage` module's functions. */
-declare function createUsage(options: UsageOptions): Usage;
-interface ReportUsageOptions {
-  /**
-   * A service-role transport: the reporting functions are granted to
-   * `service_role` only.
-   */
-  readonly transport: BlockTransport;
-  readonly stripe: StripeSource;
-  readonly schema?: string;
-  /** The Stripe meter's `event_name` for a meter; default the meter itself. */
-  readonly eventName?: (meter: string) => string | undefined;
-  /**
-   * The tenant's Stripe customer. Default: `tenant_stripe_customer()` from the
-   * `entitlements` module (`config.entitlements.customer`).
-   */
-  readonly customer?: (organizationId: string) => Promise<string | undefined>;
-  /** Counters per run, default 500. */
-  readonly batch?: number;
-  /**
-   * Send only the usage above the tenant's quota (the allowance its plan
-   * includes) in each quota window, instead of every unit. A meter without a
-   * quota sends everything, and one with an unlimited quota sends nothing.
-   */
-  readonly overage?: boolean;
-}
-interface ReportUsageResult {
-  /**
-   * Meter events sent; usage inside the quota with `overage` is marked without
-   * one.
-   */
-  readonly reported: number;
-  /**
-   * Counters left for a later run: no customer, or no event name. They don't
-   * hold up the other counters of the batch.
-   */
-  readonly skipped: number;
-}
-/**
- * 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.
- */
-declare function reportUsageToStripe(options: ReportUsageOptions): Promise<ReportUsageResult>;
-//#endregion
-export { reportUsageToStripe as _, Usage as a, UsageEntry as c, UsageMeterInfo as d, UsageOptions as f, createUsage as g, UsageStatus as h, ReportUsageResult as i, UsageHistoryEntry as l, UsageRecorded as m, RecordUsageOptions as n, UsageBatchRecorded as o, UsagePeriod as p, ReportUsageOptions as r, UsageBreakdownEntry as s, PurgeUsageOptions as t, UsageHistoryOptions as u };