better-supabase 0.12.0 → 0.14.0

package/dist/blocks/entitlements/react/index.d.ts

@@ -1,20 +1,23 @@
-import { t as EntitlementClaimOptions } from "../../../entitlements-CtBGXb3B.js";
-import { i as FeatureGateSnapshot, t as FeatureGateActions } from "../../../client-BJN0IMEp.js";
+import { t as EntitlementClaimOptions } from "../../../entitlements-DDevu4ZE.js";
+import { i as FeatureGateSnapshot, t as FeatureGateActions } from "../../../client-D-LPdEDQ.js";
 //#region src/blocks/entitlements/react/index.d.ts
 export interface UseFeatureGateOptions {
   /** The organization to check. Default the session's active one. */
   readonly organizationId?: string | null;
-  /** `config.claims.features` (default `features`), or `{ claim, keys }` for short codes. */
+  /**
+   * `config.claims.features` (default `features`), or `{ claim, keys }` for
+   * short codes.
+   */
   readonly claim?: string | EntitlementClaimOptions;
   /** The tenant claim, `config.claims.tenant` (default `tenant_id`). */
   readonly tenantClaim?: string;
 }
 export interface FeatureGateState extends FeatureGateSnapshot, FeatureGateActions {}
 /**
- * Whether the active organization's plan includes `feature`, from the
- * provider session's plan-features claim; `allowed` is `undefined` while
- * the session loads. UX only: RLS enforces the feature. The same hook runs
- * in React DOM and React Native.
+ * Whether the active organization's plan includes `feature`, from the provider
+ * session's plan-features claim; `allowed` is `undefined` while the session
+ * loads. UX only: RLS enforces the feature. The same hook runs in React DOM and
+ * React Native.
  *
  * ```tsx
  * const { allowed } = useFeatureGate("exports");

package/dist/blocks/entitlements/react/index.js

@@ -1,13 +1,13 @@
 "use client";
-import { t as createFeatureGateController } from "../../../client-Ezlbskjq.js";
-import { t as useController } from "../../../react-controller-Xn-IU44p.js";
-import { t as useBlockEnv } from "../../../react-env-Cc7Vf6eb.js";
+import { t as useController } from "../../../react-controller-CKSdtJ10.js";
+import { t as useBlockEnv } from "../../../react-env-CfA3EdBH.js";
+import { t as createFeatureGateController } from "../../../client-kRvHKAKS.js";
 //#region src/blocks/entitlements/react/index.ts
 /**
-* Whether the active organization's plan includes `feature`, from the
-* provider session's plan-features claim; `allowed` is `undefined` while
-* the session loads. UX only: RLS enforces the feature. The same hook runs
-* in React DOM and React Native.
+* Whether the active organization's plan includes `feature`, from the provider
+* session's plan-features claim; `allowed` is `undefined` while the session
+* loads. UX only: RLS enforces the feature. The same hook runs in React DOM and
+* React Native.
 *
 * ```tsx
 * const { allowed } = useFeatureGate("exports");

package/dist/blocks/entitlements/react/server.d.ts

@@ -1,6 +1,9 @@
 import { FeatureGateState, UseFeatureGateOptions, useFeatureGate as useFeatureGate$1 } from "./index.js";
 //#region src/blocks/entitlements/react/server.d.ts
-/** The `react-server` build of `useFeatureGate`: call `hasEntitlement(session, organizationId, feature)` instead. */
+/**
+ * The `react-server` build of `useFeatureGate`: call `hasEntitlement(session,
+ * organizationId, feature)` instead.
+ */
 export declare const useFeatureGate: typeof useFeatureGate$1;
 //#endregion
 export type { FeatureGateState, UseFeatureGateOptions };

package/dist/blocks/entitlements/react/server.js

@@ -1,5 +1,8 @@
 //#region src/blocks/entitlements/react/server.ts
-/** The `react-server` build of `useFeatureGate`: call `hasEntitlement(session, organizationId, feature)` instead. */
+/**
+* The `react-server` build of `useFeatureGate`: call `hasEntitlement(session,
+* organizationId, feature)` instead.
+*/
 const useFeatureGate = () => {
 	throw new Error("better-supabase: useFeatureGate() runs in Client Components only. In Server Components call `hasEntitlement(session, organizationId, feature)` instead.");
 };

package/dist/blocks/entitlements/solid/index.d.ts

@@ -1,6 +1,6 @@
-import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
-import { t as SolidController } from "../../../solid-controller-CWotGxcG.js";
-import { i as FeatureGateSnapshot, r as FeatureGateControllerOptions, t as FeatureGateActions } from "../../../client-BJN0IMEp.js";
+import { t as BlockOptions } from "../../../block-env-kFcaaJLM.js";
+import { t as SolidController } from "../../../solid-bind-C1jeq4Qm.js";
+import { i as FeatureGateSnapshot, r as FeatureGateControllerOptions, t as FeatureGateActions } from "../../../client-D-LPdEDQ.js";
 //#region src/blocks/entitlements/solid/index.d.ts
 /**
  * `createFeatureGateController` as a Solid primitive: `state()` reads the

package/dist/blocks/entitlements/solid/index.js

@@ -1,5 +1,5 @@
-import { t as createFeatureGateController } from "../../../client-Ezlbskjq.js";
-import { t as useBlockController } from "../../../solid-controller-DLsmrczT.js";
+import { t as createFeatureGateController } from "../../../client-kRvHKAKS.js";
+import { t as useBlockController } from "../../../solid-controller-DGuv7V8a.js";
 //#region src/blocks/entitlements/solid/index.ts
 /**
 * `createFeatureGateController` as a Solid primitive: `state()` reads the

package/dist/blocks/entitlements/svelte/index.d.ts

@@ -1,6 +1,6 @@
-import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
-import { t as SvelteController } from "../../../svelte-controller-sS4X66yL.js";
-import { i as FeatureGateSnapshot, r as FeatureGateControllerOptions, t as FeatureGateActions } from "../../../client-BJN0IMEp.js";
+import { t as BlockOptions } from "../../../block-env-kFcaaJLM.js";
+import { t as SvelteController } from "../../../svelte-bind-Ja6CtQGp.js";
+import { i as FeatureGateSnapshot, r as FeatureGateControllerOptions, t as FeatureGateActions } from "../../../client-D-LPdEDQ.js";
 //#region src/blocks/entitlements/svelte/index.d.ts
 /**
  * `createFeatureGateController` as a Svelte readable store of the snapshot,

package/dist/blocks/entitlements/svelte/index.js

@@ -1,5 +1,5 @@
-import { t as createFeatureGateController } from "../../../client-Ezlbskjq.js";
-import { t as useBlockController } from "../../../svelte-controller-CDAujo-_.js";
+import { t as createFeatureGateController } from "../../../client-kRvHKAKS.js";
+import { t as useBlockController } from "../../../svelte-controller-oFKC9AYu.js";
 //#region src/blocks/entitlements/svelte/index.ts
 /**
 * `createFeatureGateController` as a Svelte readable store of the snapshot,

package/dist/blocks/entitlements/vue/index.d.ts

@@ -1,6 +1,6 @@
-import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
-import { t as VueController } from "../../../vue-controller-BUo1oove.js";
-import { i as FeatureGateSnapshot, r as FeatureGateControllerOptions, t as FeatureGateActions } from "../../../client-BJN0IMEp.js";
+import { t as BlockOptions } from "../../../block-env-kFcaaJLM.js";
+import { t as VueController } from "../../../vue-bind-TPkbLl4z.js";
+import { i as FeatureGateSnapshot, r as FeatureGateControllerOptions, t as FeatureGateActions } from "../../../client-D-LPdEDQ.js";
 //#region src/blocks/entitlements/vue/index.d.ts
 /**
  * `createFeatureGateController` as a Vue composable: `state` is a shallow ref

package/dist/blocks/entitlements/vue/index.js

@@ -1,5 +1,5 @@
-import { t as createFeatureGateController } from "../../../client-Ezlbskjq.js";
-import { t as useBlockController } from "../../../vue-controller-C9tFzqAc.js";
+import { t as createFeatureGateController } from "../../../client-kRvHKAKS.js";
+import { t as useBlockController } from "../../../vue-controller-WtbuT-Ux.js";
 //#region src/blocks/entitlements/vue/index.ts
 /**
 * `createFeatureGateController` as a Vue composable: `state` is a shallow ref

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

@@ -0,0 +1,214 @@
+/// <reference lib="esnext.temporal" />
+import { T as ErrorMapper, t as AsyncResult } from "../../result-C6jDfedy.js";
+import { t as StandardSchemaV1 } from "../../standard-DbQsD2xZ.js";
+import { n as ExtraFields, r as FieldsOf } from "../../block-fields-3w4MZr8U.js";
+import { Ct as Events } from "../../events-DbLjvxDX.js";
+import { n as Logger } from "../../logger-DWVYUmwi.js";
+import { a as BlockTenantOptions, r as BlockTemporalOptions } from "../../block-helpers-BaugZlJV.js";
+import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-d53POsem.js";
+import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-CmjPKqQ_.js";
+import { c as BlockOf, rn as EntitySchema } from "../../define-block-COpcS6aT.js";
+import { n as Money } from "../../money-BNRdJQzA.js";
+//#region src/blocks/expenses/expenses.d.ts
+type ExpenseReportStatus = "draft" | "submitted" | "approved" | "rejected" | "reimbursed" | "cancelled";
+interface ExpensesOptions<S extends StandardSchemaV1 | undefined = undefined> extends BlockTemporalOptions, BlockTenantOptions {
+  readonly transport: BlockTransport;
+  /**
+   * The module schema, or its API schema: `defineBlocks` passes it from
+   * `blocks.generated.ts`.
+   */
+  readonly schema?: string;
+  /**
+   * A Standard Schema for the report's extra columns
+   * (`blocks.expenses.options.extraColumns`), keyed by database name. It types
+   * and parses them on reads, and validates them on `create`.
+   */
+  readonly fields?: S;
+  /** `withBlockHooks` hooks around the client's methods. */
+  readonly hooks?: NoInfer<BlockHooks<Expenses<FieldsOf<S>>>>;
+  /** Receives the errors `after` hooks throw. Default: `console`. */
+  readonly logger?: Logger;
+  readonly mappers?: readonly ErrorMapper[];
+}
+/** A spend category with its policy. */
+interface ExpenseCategory {
+  readonly id: string;
+  readonly organizationId: string;
+  readonly key: string;
+  readonly name: string;
+  /** The most one report may spend in this category. */
+  readonly limit?: Money;
+  /** A line above this amount needs a receipt attached. */
+  readonly receiptOver?: Money;
+  readonly archivedAt?: Temporal.Instant;
+  readonly createdAt: Temporal.Instant;
+  readonly updatedAt: Temporal.Instant;
+}
+interface ExpenseCategoryInput {
+  readonly key: string;
+  readonly name: string;
+  readonly limit?: Money;
+  /** Needs the attachments block, where receipts live. */
+  readonly receiptOver?: Money;
+}
+interface ExpenseLine {
+  readonly id: string;
+  readonly reportId: string;
+  readonly categoryId: string;
+  readonly spentOn: Temporal.PlainDate;
+  readonly description: string;
+  readonly merchant?: string;
+  readonly amount: Money;
+  /** Receipts attached to the line (attachments with the line as subject). */
+  readonly receipts: number;
+  readonly createdAt: Temporal.Instant;
+  readonly updatedAt: Temporal.Instant;
+}
+interface ExpenseLineInput {
+  readonly categoryId: string;
+  readonly spentOn: Temporal.PlainDate;
+  /** In the report's currency. */
+  readonly amount: Money;
+  readonly description: string;
+  readonly merchant?: string;
+}
+type ExpenseLineUpdate = Partial<ExpenseLineInput>;
+/** A member's expense report. `F` types the extra columns. */
+interface ExpenseReport<F extends object = Record<never, never>> {
+  readonly id: string;
+  readonly organizationId: string;
+  readonly userId: string;
+  readonly title: string;
+  readonly note?: string;
+  readonly status: ExpenseReportStatus;
+  readonly total: Money;
+  readonly lines: readonly ExpenseLine[];
+  readonly approvalId?: string;
+  readonly submittedAt?: Temporal.Instant;
+  readonly approvedAt?: Temporal.Instant;
+  readonly approvalTransactionId?: string;
+  readonly reimbursedAt?: Temporal.Instant;
+  readonly reimbursementTransactionId?: string;
+  readonly cancelledAt?: Temporal.Instant;
+  readonly createdAt: Temporal.Instant;
+  readonly updatedAt: Temporal.Instant;
+  /** The extra columns, keyed by database name. */
+  readonly fields: ExtraFields<F>;
+}
+interface ExpenseReportInput<F extends object = Record<never, never>> {
+  readonly title: string;
+  /** Three-letter code; every line is in it. */
+  readonly currency: string;
+  readonly note?: string;
+  /** The extra columns to set. */
+  readonly fields?: Partial<F>;
+}
+/**
+ * A spend policy finding: what `submit` refuses with
+ * `EXPENSE_POLICY_VIOLATION`.
+ */
+type ExpensePolicyViolation = {
+  readonly kind: "limit";
+  readonly categoryId: string;
+  readonly category: string;
+  readonly limit: Money;
+  readonly total: Money;
+} | {
+  readonly kind: "receipt";
+  readonly lineId: string;
+  readonly categoryId: string;
+  readonly category: string;
+  readonly receiptOver: Money;
+  readonly amount: Money;
+} | {
+  readonly kind: "archived";
+  readonly categoryId: string;
+  readonly category: string;
+};
+interface ExpenseReportListOptions {
+  readonly status?: ExpenseReportStatus;
+  /** One member's reports. Needs `expenses.read` for another member. */
+  readonly userId?: string;
+  /** Every member's reports. Needs `expenses.read`. */
+  readonly everyone?: boolean;
+  readonly pageSize?: number;
+}
+interface ReimbursementInput {
+  readonly paidAt?: Temporal.Instant;
+  readonly reference?: string;
+}
+interface Expenses<F extends object = Record<never, never>> {
+  /** Creates or updates the category with this key. Needs `expenses.manage`. */
+  saveCategory(input: ExpenseCategoryInput): AsyncResult<ExpenseCategory>;
+  archiveCategory(categoryId: string): AsyncResult<ExpenseCategory>;
+  categories(options?: {
+    readonly includeArchived?: boolean;
+  }): AsyncResult<readonly ExpenseCategory[]>;
+  /** A draft report of the caller. Needs `expenses.submit`. */
+  create(input: ExpenseReportInput<F>): AsyncResult<ExpenseReport<F>>;
+  addLine(reportId: string, line: ExpenseLineInput): AsyncResult<ExpenseLine>;
+  updateLine(lineId: string, update: ExpenseLineUpdate): AsyncResult<ExpenseLine>;
+  removeLine(lineId: string): AsyncResult<ExpenseReport<F>>;
+  /** The spend policy findings `submit` would refuse. */
+  check(reportId: string): AsyncResult<readonly ExpensePolicyViolation[]>;
+  /**
+   * Opens an approval for a draft or rejected report. Fails with
+   * `EXPENSE_POLICY_VIOLATION` while the report breaks the spend policy.
+   */
+  submit(reportId: string): AsyncResult<ExpenseReport<F>>;
+  /**
+   * Pays an approved report out of the member's payable. Needs
+   * `expenses.manage`.
+   */
+  reimburse(reportId: string, input?: ReimbursementInput): AsyncResult<ExpenseReport<F>>;
+  cancel(reportId: string): AsyncResult<ExpenseReport<F>>;
+  get(reportId: string): AsyncResult<ExpenseReport<F>>;
+  list(options?: ExpenseReportListOptions): AsyncResult<readonly ExpenseReport<F>[]>;
+}
+/** The `expenses` SQL module as typed calls. */
+export declare function createExpenses<S extends StandardSchemaV1 | undefined = undefined>(options: ExpensesOptions<S>): Expenses<FieldsOf<S>>;
+//#endregion
+//#region src/blocks/expenses/events.d.ts
+/** An expense report as its events carry it. */
+interface ExpenseReportEventData {
+  readonly organizationId: string;
+  readonly id: string;
+  /** The member who spent the money. */
+  readonly userId: string;
+  readonly status: "draft" | "submitted" | "approved" | "rejected" | "reimbursed" | "cancelled";
+  /** Minor units, as text. */
+  readonly total: string;
+  readonly currency: string;
+}
+/** `expense_report.submitted`: the report went to approval. */
+interface ExpenseReportSubmittedEventData extends ExpenseReportEventData {
+  readonly approvalId: string;
+}
+/** `expense_report.approved` and `.reimbursed`: posted on the ledger. */
+interface ExpenseReportPostedEventData extends ExpenseReportEventData {
+  readonly transactionId: string;
+}
+/** The events of the `expenses` block: type to data. */
+type ExpensesEvents = {
+  readonly "expense_report.created": ExpenseReportEventData;
+  readonly "expense_report.submitted": ExpenseReportSubmittedEventData;
+  readonly "expense_report.approved": ExpenseReportPostedEventData;
+  readonly "expense_report.reimbursed": ExpenseReportPostedEventData;
+  readonly "expense_report.cancelled": ExpenseReportEventData;
+};
+/** The `expenses` block's event types, for its manifest and `onBlockEvent`. */
+export declare const expensesEvents: Events<ExpensesEvents>;
+//#endregion
+//#region src/blocks/expenses/manifest.d.ts
+/** The `expenses` block's manifest (ADR 0029). */
+export declare const expensesBlock: BlockOf<"expenses", typeof createExpenses, ExpensesEvents>;
+//#endregion
+//#region src/blocks/expenses/schemas.d.ts
+/** What `create` takes. */
+export declare const expenseReportInputSchema: EntitySchema<ExpenseReportInput>;
+/** What `addLine` takes, with the bounds the SQL checks. */
+export declare const expenseLineInputSchema: EntitySchema<ExpenseLineInput>;
+/** What `saveCategory` takes. */
+export declare const expenseCategoryInputSchema: EntitySchema<ExpenseCategoryInput>;
+//#endregion
+export { type BlockHooks, type BlockTransport, type BlockTransportMiddleware, type ExpenseCategory, type ExpenseCategoryInput, type ExpenseLine, type ExpenseLineInput, type ExpenseLineUpdate, type ExpensePolicyViolation, type ExpenseReport, type ExpenseReportEventData, type ExpenseReportInput, type ExpenseReportListOptions, type ExpenseReportPostedEventData, type ExpenseReportStatus, type ExpenseReportSubmittedEventData, type Expenses, type ExpensesEvents, type ExpensesOptions, type ReimbursementInput, type RpcClient, dbTransport, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

package/dist/blocks/expenses/index.js

@@ -0,0 +1,279 @@
+import { n as dbError } from "../../errors-03ysrOt4.js";
+import { t as temporal } from "../../temporal-required-B8qQHYbI.js";
+import { t as AsyncResult } from "../../result-B3m7xtRY.js";
+import { n as isRecord } from "../../guards-6F2bCtQR.js";
+import { t as expensesSqlOptions } from "../../options-BPDiwSa-.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, m as instantArg, n as applyTemporal, o as blockCall } from "../../block-helpers-CiKtrb6g.js";
+import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-BymdcD0V.js";
+import { n as entitySchema, r as moneyField } from "../../entity-schema-BXXC1NnT.js";
+import { n as event, t as defineEvents } from "../../event-map-CtPFhcOp.js";
+import { n as blockFields } from "../../block-fields-DBSJSeaO.js";
+import { n as defineBlock } from "../../define-block-Dze77QTw.js";
+import { t as requireTenant } from "../../block-tenant-C1sNV8_4.js";
+import { i as moneyOf, t as amountText } from "../../money-codec-jMP0PQLZ.js";
+//#region src/blocks/expenses/expenses.ts
+function optional(key, value) {
+	return value === void 0 ? {} : { [key]: value };
+}
+function optionalInstant(value, field) {
+	return value === null || value === void 0 ? void 0 : requiredInstant(value, field);
+}
+function optionalMoney(value, currency, field) {
+	return value === null || value === void 0 ? void 0 : moneyOf(value, currency, field);
+}
+function categoryOf(value, fn) {
+	const row = recordOf(value, fn);
+	const currency = row["currency"];
+	return {
+		id: textOf(row["id"]),
+		organizationId: textOf(row["organizationId"]),
+		key: textOf(row["key"]),
+		name: textOf(row["name"]),
+		createdAt: requiredInstant(row["createdAt"], "createdAt"),
+		updatedAt: requiredInstant(row["updatedAt"], "updatedAt"),
+		...optional("limit", optionalMoney(row["limitAmount"], currency, "limit")),
+		...optional("receiptOver", optionalMoney(row["receiptOver"], currency, "receiptOver")),
+		...optional("archivedAt", optionalInstant(row["archivedAt"], "archivedAt"))
+	};
+}
+function lineOf(value, fn) {
+	const row = recordOf(value, fn);
+	return {
+		id: textOf(row["id"]),
+		reportId: textOf(row["reportId"]),
+		categoryId: textOf(row["categoryId"]),
+		spentOn: temporal().PlainDate.from(textOf(row["spentOn"])),
+		description: textOf(row["description"]),
+		amount: moneyOf(row["amount"], row["currency"], "amount"),
+		receipts: Number(row["receipts"] ?? 0),
+		createdAt: requiredInstant(row["createdAt"], "createdAt"),
+		updatedAt: requiredInstant(row["updatedAt"], "updatedAt"),
+		...optional("merchant", optionalText(row["merchant"]))
+	};
+}
+function reportOf(value, fn) {
+	const row = recordOf(value, fn);
+	return {
+		id: textOf(row["id"]),
+		organizationId: textOf(row["organizationId"]),
+		userId: textOf(row["userId"]),
+		title: textOf(row["title"]),
+		status: textOf(row["status"]),
+		total: moneyOf(row["total"], row["currency"], "total"),
+		lines: recordsOf(row["lines"] ?? [], fn).map((line) => lineOf(line, fn)),
+		fields: isRecord(row["fields"]) ? row["fields"] : {},
+		createdAt: requiredInstant(row["createdAt"], "createdAt"),
+		updatedAt: requiredInstant(row["updatedAt"], "updatedAt"),
+		...optional("note", optionalText(row["note"])),
+		...optional("approvalId", optionalText(row["approvalId"])),
+		...optional("submittedAt", optionalInstant(row["submittedAt"], "submittedAt")),
+		...optional("approvedAt", optionalInstant(row["approvedAt"], "approvedAt")),
+		...optional("approvalTransactionId", optionalText(row["approvalTransactionId"])),
+		...optional("reimbursedAt", optionalInstant(row["reimbursedAt"], "reimbursedAt")),
+		...optional("reimbursementTransactionId", optionalText(row["reimbursementTransactionId"])),
+		...optional("cancelledAt", optionalInstant(row["cancelledAt"], "cancelledAt"))
+	};
+}
+function violationOf(value) {
+	const row = recordOf(value, "check_expense_report");
+	const kind = textOf(row["kind"]);
+	const base = {
+		categoryId: textOf(row["categoryId"]),
+		category: textOf(row["category"])
+	};
+	switch (kind) {
+		case "limit": return {
+			kind,
+			...base,
+			limit: moneyOf(row["limit"], row["currency"], "limit"),
+			total: moneyOf(row["total"], row["currency"], "total")
+		};
+		case "receipt": return {
+			kind,
+			...base,
+			lineId: textOf(row["lineId"]),
+			receiptOver: moneyOf(row["receiptOver"], row["currency"], "receiptOver"),
+			amount: moneyOf(row["amount"], row["currency"], "amount")
+		};
+		case "archived": return {
+			kind,
+			...base
+		};
+		default: throw new TypeError(`check_expense_report returned kind ${kind}`);
+	}
+}
+/** The `expenses` SQL module as typed calls. */
+function createExpenses(options) {
+	applyTemporal(options);
+	const call = blockCall(options.transport, options.schema, options.mappers);
+	const tenant = () => requireTenant(options.tenant);
+	const report = (fn) => (value) => reportOf(value, fn);
+	const line = (fn) => (value) => lineOf(value, fn);
+	const category = (fn) => (value) => categoryOf(value, fn);
+	const fields = blockFields(options.fields, "expense report fields");
+	return withBlockHooks({
+		saveCategory: (input) => {
+			const currency = input.limit?.currency ?? input.receiptOver?.currency;
+			if (input.limit !== void 0 && input.receiptOver !== void 0 && input.limit.currency !== input.receiptOver.currency) return AsyncResult.err(dbError("invalid_input", "the limit and the receipt threshold are in one currency", { hint: "EXPENSE_CATEGORY_INVALID" }));
+			return tenant().andThen((organizationId) => call("save_expense_category", {
+				tenant: organizationId,
+				key: input.key,
+				name: input.name,
+				currency: currency ?? null,
+				limit_amount: input.limit ? amountText(input.limit) : null,
+				receipt_over: input.receiptOver ? amountText(input.receiptOver) : null
+			}, category("save_expense_category")));
+		},
+		archiveCategory: (categoryId) => call("archive_expense_category", { category_id: categoryId }, category("archive_expense_category")),
+		categories: (list = {}) => tenant().andThen((organizationId) => call("list_expense_categories", {
+			tenant: organizationId,
+			include_archived: list.includeArchived ?? false
+		}, (value) => recordsOf(value, "list_expense_categories").map(category("list_expense_categories")))),
+		create: (input) => fields.args(input.fields).andThen((checked) => tenant().andThen((organizationId) => call("create_expense_report", {
+			tenant: organizationId,
+			title: input.title,
+			currency: input.currency,
+			note: input.note ?? null,
+			...checked === void 0 ? {} : { fields: checked }
+		}, report("create_expense_report")).andThen(fields.row))),
+		addLine: (reportId, input) => call("add_expense_line", {
+			report_id: reportId,
+			category_id: input.categoryId,
+			spent_on: input.spentOn.toString(),
+			amount: amountText(input.amount),
+			description: input.description,
+			merchant: input.merchant ?? null,
+			currency: input.amount.currency
+		}, line("add_expense_line")),
+		updateLine: (lineId, update) => call("update_expense_line", {
+			line_id: lineId,
+			category_id: update.categoryId ?? null,
+			spent_on: update.spentOn?.toString() ?? null,
+			amount: update.amount ? amountText(update.amount) : null,
+			description: update.description ?? null,
+			merchant: update.merchant ?? null,
+			currency: update.amount?.currency ?? null
+		}, line("update_expense_line")),
+		removeLine: (lineId) => call("remove_expense_line", { line_id: lineId }, report("remove_expense_line")).andThen(fields.row),
+		check: (reportId) => call("check_expense_report", { report_id: reportId }, (value) => recordsOf(value, "check_expense_report").map(violationOf)),
+		submit: (reportId) => call("submit_expense_report", { report_id: reportId }, report("submit_expense_report")).andThen(fields.row),
+		reimburse: (reportId, input = {}) => call("reimburse_expense_report", {
+			report_id: reportId,
+			paid_at: instantArg(input.paidAt) ?? null,
+			reference: input.reference ?? null
+		}, report("reimburse_expense_report")).andThen(fields.row),
+		cancel: (reportId) => call("cancel_expense_report", { report_id: reportId }, report("cancel_expense_report")).andThen(fields.row),
+		get: (reportId) => call("get_expense_report", { report_id: reportId }, report("get_expense_report")).andThen(fields.row),
+		list: (list = {}) => tenant().andThen((organizationId) => call("list_expense_reports", {
+			tenant: organizationId,
+			user_id: list.userId ?? null,
+			status: list.status ?? null,
+			everyone: list.everyone ?? false,
+			page_size: list.pageSize ?? null
+		}, (value) => recordsOf(value, "list_expense_reports").map(report("list_expense_reports"))).andThen(fields.rows))
+	}, options.hooks, {
+		block: "expenses",
+		...options.logger ? { logger: options.logger } : {}
+	});
+}
+//#endregion
+//#region src/blocks/expenses/events.ts
+/** The `expenses` block's event types, for its manifest and `onBlockEvent`. */
+const expensesEvents = defineEvents({
+	"expense_report.created": event(),
+	"expense_report.submitted": event(),
+	"expense_report.approved": event(),
+	"expense_report.reimbursed": event(),
+	"expense_report.cancelled": event()
+});
+//#endregion
+//#region src/blocks/expenses/schemas.ts
+/** What `create` takes. */
+const expenseReportInputSchema = entitySchema({
+	title: "ExpenseReportInput",
+	fields: {
+		title: {
+			kind: "string",
+			minLength: 1,
+			maxLength: 200
+		},
+		currency: {
+			kind: "string",
+			minLength: 3,
+			maxLength: 3,
+			description: "A three-letter currency code; every line is in it."
+		},
+		note: {
+			kind: "string",
+			optional: true,
+			maxLength: 2e3
+		},
+		fields: {
+			kind: "json",
+			optional: true,
+			description: "The extra columns to set."
+		}
+	}
+});
+/** What `addLine` takes, with the bounds the SQL checks. */
+const expenseLineInputSchema = entitySchema({
+	title: "ExpenseLineInput",
+	fields: {
+		categoryId: { kind: "uuid" },
+		spentOn: { kind: "plainDate" },
+		amount: moneyField,
+		description: {
+			kind: "string",
+			minLength: 1,
+			maxLength: 500
+		},
+		merchant: {
+			kind: "string",
+			optional: true,
+			maxLength: 200
+		}
+	}
+});
+/** What `saveCategory` takes. */
+const expenseCategoryInputSchema = entitySchema({
+	title: "ExpenseCategoryInput",
+	fields: {
+		key: {
+			kind: "string",
+			minLength: 1,
+			maxLength: 63,
+			description: "Lowercase letters, digits and underscores."
+		},
+		name: {
+			kind: "string",
+			minLength: 1,
+			maxLength: 200
+		},
+		limit: {
+			...moneyField,
+			optional: true
+		},
+		receiptOver: {
+			...moneyField,
+			optional: true
+		}
+	}
+});
+//#endregion
+//#region src/blocks/expenses/manifest.ts
+/** The `expenses` block's manifest (ADR 0029). */
+const expensesBlock = defineBlock({
+	name: "expenses",
+	sql: ["expenses"],
+	options: { expenses: expensesSqlOptions },
+	events: expensesEvents,
+	schemas: {
+		expense_report: { input: expenseReportInputSchema },
+		expense_line: { input: expenseLineInputSchema },
+		expense_category: { input: expenseCategoryInputSchema }
+	},
+	create: createExpenses,
+	category: "commerce"
+});
+//#endregion
+export { createExpenses, dbTransport, expenseCategoryInputSchema, expenseLineInputSchema, expenseReportInputSchema, expensesBlock, expensesEvents, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };