better-supabase 0.13.0 → 0.14.0

package/dist/table-schema-xqSXrjCN.js

@@ -1,284 +0,0 @@
-import { i as isPlainDateTime, n as isInstant } from "./temporal-DLZlWbOi.js";
-import { n as isRecord, t as isList } from "./guards-6F2bCtQR.js";
-//#region src/core/table-json-schema.ts
-/** JSON Schema for one scalar. Codec values are described by their wire form. */
-function scalarJsonSchema(kind) {
-	switch (kind.kind) {
-		case "uuid": return {
-			type: "string",
-			format: "uuid"
-		};
-		case "string": return { type: "string" };
-		case "integer": return { type: "integer" };
-		case "number": return { type: "number" };
-		case "boolean": return { type: "boolean" };
-		case "datetime": return {
-			type: "string",
-			format: "date-time"
-		};
-		case "date": return {
-			type: "string",
-			format: "date"
-		};
-		case "instant": return {
-			type: "string",
-			format: "date-time"
-		};
-		case "plainDateTime": return {
-			type: "string",
-			pattern: "^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?$"
-		};
-		case "bigint": return {
-			type: "string",
-			pattern: "^-?\\d+$"
-		};
-		case "json":
-		case "unknown":
-		case "custom": return {};
-		case "enum": return {
-			type: "string",
-			enum: [...kind.values]
-		};
-		default: return kind;
-	}
-}
-/** Wraps a column's schema for arrays and `null`. */
-function columnJsonSchema(base, field) {
-	const schema = field.array ? {
-		type: "array",
-		items: base
-	} : base;
-	if (!field.nullable) return schema;
-	if (Object.keys(schema).length === 0) return schema;
-	const { enum: values, ...rest } = schema;
-	if (isList(values)) return {
-		...rest,
-		type: ["string", "null"],
-		enum: [...values, null]
-	};
-	return typeof schema["type"] === "string" ? {
-		...schema,
-		type: [schema["type"], "null"]
-	} : { anyOf: [schema, { type: "null" }] };
-}
-const BOUND_KEYS = [
-	"minimum",
-	"exclusiveMinimum",
-	"maximum",
-	"exclusiveMaximum",
-	"minLength",
-	"maxLength"
-];
-function propertySchema(field, base) {
-	const bounds = {};
-	for (const key of BOUND_KEYS) {
-		const value = field[key];
-		if (value !== void 0) bounds[key] = value;
-	}
-	const schema = {
-		...columnJsonSchema({
-			...base,
-			...bounds
-		}, field),
-		...field.description === void 0 ? {} : { description: field.description },
-		...field.examples === void 0 ? {} : { examples: [...field.examples] }
-	};
-	return field.readOnly ? {
-		...schema,
-		readOnly: true
-	} : schema;
-}
-/**
-* The JSON Schema object for a table shape. `nested` converts a typed jsonb
-* column's own schema; without it those columns accept any value.
-*/
-function tableJsonSchema(spec, nested) {
-	const properties = {};
-	const required = [];
-	for (const [name, field] of Object.entries(spec.fields)) {
-		properties[name] = propertySchema(field, (field.schema && nested?.(field.schema)) ?? scalarJsonSchema(field));
-		if (!field.optional) required.push(name);
-	}
-	return {
-		...spec.title === void 0 ? {} : { title: spec.title },
-		...spec.description === void 0 ? {} : { description: spec.description },
-		type: "object",
-		properties,
-		...required.length > 0 ? { required } : {},
-		additionalProperties: false
-	};
-}
-//#endregion
-//#region src/core/table-schema.ts
-const SCHEMA_URIS = {
-	"draft-2020-12": "https://json-schema.org/draft/2020-12/schema",
-	"draft-07": "http://json-schema.org/draft-07/schema#"
-};
-/**
-* Rewrites a 2020-12 schema into the OpenAPI 3.0 dialect (`nullable`,
-* `example`).
-*/
-function toOpenApi30(schema) {
-	const out = {};
-	for (const [key, value] of Object.entries(schema)) if (key === "properties" && isRecord(value)) out[key] = Object.fromEntries(Object.entries(value).map(([name, child]) => [name, isRecord(child) ? toOpenApi30(child) : child]));
-	else if (key === "items" && isRecord(value)) out[key] = toOpenApi30(value);
-	else if (key === "examples" && isList(value)) {
-		if (value.length > 0) out["example"] = value[0];
-	} else if (key === "exclusiveMinimum" || key === "exclusiveMaximum") {
-		out[key === "exclusiveMinimum" ? "minimum" : "maximum"] = value;
-		out[key] = true;
-	} else out[key] = value;
-	const type = out["type"];
-	if (isList(type) && type.includes("null")) {
-		out["type"] = type.find((entry) => entry !== "null");
-		out["nullable"] = true;
-	}
-	const anyOf = out["anyOf"];
-	if (isList(anyOf) && anyOf.length === 2) {
-		const [inner, empty] = anyOf;
-		if (isRecord(inner) && isRecord(empty) && empty["type"] === "null") {
-			delete out["anyOf"];
-			return {
-				...toOpenApi30(inner),
-				...out,
-				nullable: true
-			};
-		}
-	}
-	return out;
-}
-/** The schema with the target's `$schema`, or in the OpenAPI 3.0 dialect. */
-function forTarget(schema, target) {
-	if (target === "openapi-3.0") return toOpenApi30(schema);
-	const uri = SCHEMA_URIS[target];
-	if (!uri) throw new Error(`Unsupported JSON Schema target "${target}"`);
-	return {
-		$schema: uri,
-		...schema
-	};
-}
-const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-const DATE = /^\d{4}-\d{2}-\d{2}$/;
-const DATETIME = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(?::\d{2}(?:\.\d+)?)?(?:Z|[+-]\d{2}(?::?\d{2})?)$/;
-function isJson(value) {
-	if (value === null || typeof value === "string" || typeof value === "boolean") return true;
-	if (typeof value === "number") return Number.isFinite(value);
-	if (isList(value)) return value.every(isJson);
-	if (!isRecord(value)) return false;
-	const proto = Object.getPrototypeOf(value);
-	return (proto === Object.prototype || proto === null) && Object.values(value).every(isJson);
-}
-/** The issue message for a scalar, or `undefined` when the value passes. */
-function scalarIssue(field, value) {
-	switch (field.kind) {
-		case "uuid": return typeof value === "string" && UUID.test(value) ? void 0 : "Expected a UUID";
-		case "string": return typeof value === "string" ? void 0 : "Expected a string";
-		case "integer": return Number.isSafeInteger(value) ? void 0 : "Expected an integer";
-		case "number": return typeof value === "number" && Number.isFinite(value) ? void 0 : "Expected a number";
-		case "boolean": return typeof value === "boolean" ? void 0 : "Expected a boolean";
-		case "datetime": return typeof value === "string" && DATETIME.test(value) ? void 0 : "Expected an ISO 8601 date-time with an offset";
-		case "date": return typeof value === "string" && DATE.test(value) ? void 0 : "Expected an ISO 8601 date";
-		case "instant": return isInstant(value) ? void 0 : "Expected a Temporal.Instant";
-		case "plainDateTime": return isPlainDateTime(value) ? void 0 : "Expected a Temporal.PlainDateTime";
-		case "bigint": return typeof value === "bigint" ? void 0 : "Expected a bigint";
-		case "json": return isJson(value) ? void 0 : "Expected a JSON value";
-		case "enum": return typeof value === "string" && field.values.includes(value) ? void 0 : `Expected one of ${field.values.map((entry) => JSON.stringify(entry)).join(", ")}`;
-		case "unknown": return;
-		case "custom": return value === void 0 ? "Expected a value" : void 0;
-		default: return field;
-	}
-}
-const characters = (count) => count === 1 ? "1 character" : `${count} characters`;
-function boundIssue(field, value) {
-	if (typeof value === "number") {
-		if (field.minimum !== void 0 && value < field.minimum) return `Expected at least ${field.minimum}`;
-		if (field.exclusiveMinimum !== void 0 && value <= field.exclusiveMinimum) return `Expected more than ${field.exclusiveMinimum}`;
-		if (field.maximum !== void 0 && value > field.maximum) return `Expected at most ${field.maximum}`;
-		if (field.exclusiveMaximum !== void 0 && value >= field.exclusiveMaximum) return `Expected less than ${field.exclusiveMaximum}`;
-	}
-	if (typeof value === "string") {
-		if (field.minLength !== void 0 && value.length < field.minLength) return `Expected at least ${characters(field.minLength)}`;
-		if (field.maxLength !== void 0 && value.length > field.maxLength) return `Expected at most ${characters(field.maxLength)}`;
-	}
-}
-function nestedIssues(result, path) {
-	return (result.issues ?? []).map((issue) => ({
-		message: issue.message,
-		path: [...path, ...issue.path ?? []]
-	}));
-}
-/** Checks one element; a nested schema's async result lands in `pending`. */
-function checkValue(field, value, path, issues, pending) {
-	if (field.schema) {
-		const result = field.schema["~standard"].validate(value);
-		if (result instanceof Promise) pending.push(result.then((settled) => nestedIssues(settled, path)));
-		else issues.push(...nestedIssues(result, path));
-		return;
-	}
-	const message = scalarIssue(field, value) ?? boundIssue(field, value);
-	if (message) issues.push({
-		message,
-		path: [...path]
-	});
-}
-function checkField(name, field, value, issues, pending) {
-	if (value === null && field.nullable) return;
-	if (!field.array) {
-		checkValue(field, value, [name], issues, pending);
-		return;
-	}
-	if (!isList(value)) {
-		issues.push({
-			message: "Expected an array",
-			path: [name]
-		});
-		return;
-	}
-	for (const [index, item] of value.entries()) checkValue(field, item, [name, index], issues, pending);
-}
-/**
-* A Standard Schema for one table shape, without a validation library. It
-* validates like the `zod()` and `valibot()` output, drops unknown keys, and
-* converts to JSON Schema for `draft-2020-12`, `draft-07` and `openapi-3.0`.
-* The `standardSchema()` generator emits one per Row, Insert and Update.
-*/
-function tableSchema(spec) {
-	const entries = Object.entries(spec.fields);
-	const validate = (input) => {
-		if (!isRecord(input)) return { issues: [{ message: "Expected an object" }] };
-		const issues = [];
-		const pending = [];
-		const value = {};
-		for (const [name, field] of entries) {
-			if (!Object.hasOwn(input, name)) {
-				if (!field.optional && field.kind !== "unknown") issues.push({
-					message: "Required",
-					path: [name]
-				});
-				continue;
-			}
-			value[name] = input[name];
-			checkField(name, field, input[name], issues, pending);
-		}
-		const settle = (all) => all.length > 0 ? { issues: all } : { value };
-		if (pending.length === 0) return settle(issues);
-		return Promise.all(pending).then((nested) => settle([...issues, ...nested.flat()]));
-	};
-	const convert = (direction) => (options) => forTarget(tableJsonSchema(spec, (schema) => {
-		const converted = schema["~standard"].jsonSchema?.[direction](options);
-		if (!converted) return converted;
-		const { $schema: _, ...rest } = converted;
-		return rest;
-	}), options.target);
-	return { "~standard": {
-		version: 1,
-		vendor: "better-supabase",
-		validate,
-		jsonSchema: {
-			input: convert("input"),
-			output: convert("output")
-		}
-	} };
-}
-//#endregion
-export { tableSchema as n, tableJsonSchema as r, forTarget as t };

package/dist/tags-Co-QIHeK.js

@@ -1,84 +0,0 @@
-import { t as AsyncResult } from "./result-DIT_qp4G.js";
-import { n as isRecord } from "./guards-6F2bCtQR.js";
-import { C as optionalText, D as recordOf, I as textOf, 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 { t as rankBetweenResult } from "./rank-result-C6vsw27N.js";
-//#region src/blocks/tags/tags.ts
-function tagOf(value) {
-	const row = recordOf(value, "tag");
-	const optional = (key) => {
-		const found = optionalText(row[key]);
-		return found === void 0 ? {} : { [key]: found };
-	};
-	return {
-		id: textOf(row["id"]),
-		name: optionalText(row["name"]) ?? "",
-		slug: optionalText(row["slug"]) ?? "",
-		...optional("rank"),
-		...optional("kind"),
-		...optional("color"),
-		...optional("description"),
-		fields: isRecord(row["fields"]) ? row["fields"] : {}
-	};
-}
-const tagsOf = (value) => (Array.isArray(value) ? value : []).map(tagOf);
-/** The `tags` SQL module as typed calls. */
-function createTags(options) {
-	applyTemporal(options);
-	const call = blockCall(options.transport, options.schema, options.mappers);
-	const fields = blockFields(options.fields, "tag fields");
-	return withBlockHooks({
-		create: (organizationId, kind, name, color, description, extra) => fields.args(extra).andThen((checked) => call("create_tag", {
-			tenant: organizationId,
-			kind,
-			name,
-			color: color ?? null,
-			description: description ?? null,
-			fields: checked
-		}, (value) => ({
-			...tagOf(value),
-			name
-		})).andThen(fields.row)),
-		update: (id, name, extra) => fields.args(extra).andThen((checked) => call("update_tag", {
-			tag_id: id,
-			name,
-			fields: checked
-		}, (value) => value === true)),
-		reorder: (id, neighbors) => {
-			const key = rankBetweenResult(neighbors);
-			if (!key.ok) return AsyncResult.err(key.error);
-			return call("rank_tag", {
-				tag_id: id,
-				rank: key.data
-			}, () => key.data);
-		},
-		delete: (id) => call("delete_tag", { tag_id: id }, (value) => value === true),
-		tag: (organizationId, subjectType, subjectId, tagId) => call("tag", {
-			tenant: organizationId,
-			subject_type: subjectType,
-			subject_id: subjectId,
-			tag_id: tagId
-		}, (value) => value === true),
-		untag: (organizationId, subjectType, subjectId, tagId) => call("untag", {
-			tenant: organizationId,
-			subject_type: subjectType,
-			subject_id: subjectId,
-			tag_id: tagId
-		}, (value) => value === true),
-		list: (organizationId, kind) => call("list_tags", {
-			tenant: organizationId,
-			kind: kind ?? null
-		}, tagsOf).andThen(fields.rows),
-		forSubject: (organizationId, subjectType, subjectId) => call("subject_tags", {
-			tenant: organizationId,
-			subject_type: subjectType,
-			subject_id: subjectId
-		}, tagsOf).andThen(fields.rows)
-	}, options.hooks, {
-		block: "tags",
-		...options.logger ? { logger: options.logger } : {}
-	});
-}
-//#endregion
-export { createTags as t };

package/dist/tags-tbiuHHMV.d.ts

@@ -1,30 +0,0 @@
-import { Ut as CacheAdapter, Wt as CacheTarget } from "./define-D0LSXmUP.js";
-//#region src/core/tags.d.ts
-interface TagOptions {
-  /** The tenant the read is scoped to; `"*"` is every tenant's reads. */
-  readonly tenant?: string;
-}
-/**
- * `bs:<table>`, `bs:<table>:<id>`, or `bs:<table>@<tenant>` for a read scoped
- * to one tenant. Mutations invalidate the table tag, the tag of their tenant
- * (`bs:<table>@*` without one) and the tags of the changed rows.
- */
-declare function tagFor(table: string, id?: string | number, options?: TagOptions): string;
-/**
- * The tags a mutation invalidates: `bs:<table>` for every table in the target,
- * the tenant's `bs:<table>@<tenant>` (every tenant's `bs:<table>@*` when the
- * mutation has no tenant) and `bs:<table>:<id>` per changed row.
- */
-declare function cacheTagsOf(target: CacheTarget): string[];
-/**
- * A `CacheAdapter` for any tag-based cache: it hands `invalidate` the tags from
- * `cacheTagsOf`, e.g. a CDN purge by tag, SvelteKit's `invalidate`, or a Redis
- * set of keys per tag. Tag your reads with `tagFor`.
- *
- * ```ts
- * betterSupabase.cache(tagCache((tags) => purgeCdn(tags), "cdn"));
- * ```
- */
-declare function tagCache(invalidate: (tags: readonly string[]) => void | Promise<void>, name?: string): CacheAdapter;
-//#endregion
-export { tagFor as i, cacheTagsOf as n, tagCache as r, TagOptions as t };

package/dist/tax-BHSCb5Rw.d.ts

@@ -1,280 +0,0 @@
-/// <reference lib="esnext.temporal" />
-import { b as DbError, f as Result, t as AsyncResult } from "./result-mijqfoJN.js";
-import { r as WebhookInput } from "./signatures-CzqfLlfV.js";
-import { n as Money } from "./money-BNRdJQzA.js";
-//#region src/commerce/payments.d.ts
-/**
- * Where a payment stands. `requires_action`: the customer still has to act
- * (pick a method, confirm, pass 3-D Secure). `authorized`: the funds are held
- * and wait for `capture`.
- */
-type PaymentStatus = "requires_action" | "processing" | "authorized" | "succeeded" | "failed" | "canceled";
-interface Payment {
-  /** The provider's id, stored with the order as its payment reference. */
-  readonly id: string;
-  /** The provider's `name`. */
-  readonly provider: string;
-  readonly status: PaymentStatus;
-  readonly amount: Money;
-  /** What was captured so far; zero until the payment succeeds. */
-  readonly captured: Money;
-  /** What was refunded so far. */
-  readonly refunded: Money;
-  /** The order or cart the payment is for, as `createPayment` got it. */
-  readonly reference: string;
-  /**
-   * The secret a client confirms the payment with (Stripe's `client_secret`).
-   * Hand it to the paying browser only; never store or log it.
-   */
-  readonly clientSecret?: string;
-  /** Where to send the customer to finish, when the provider redirects. */
-  readonly redirectUrl?: string;
-  readonly metadata: Readonly<Record<string, string>>;
-}
-interface CreatePaymentInput {
-  /** More than zero, in a currency the provider charges. */
-  readonly amount: Money;
-  /** The order or cart this pays for. Webhook events carry it back. */
-  readonly reference: string;
-  /** `manual` holds the funds until `capture`. Defaults to `automatic`. */
-  readonly capture?: "automatic" | "manual";
-  /** The provider's customer id. */
-  readonly customer?: string;
-  readonly description?: string;
-  /** Where a redirecting payment method returns the customer. */
-  readonly returnUrl?: string;
-  readonly metadata?: Readonly<Record<string, string>>;
-}
-interface PaymentCallOptions {
-  /** The same key returns the first call's result instead of paying twice. */
-  readonly idempotencyKey?: string;
-  readonly signal?: AbortSignal;
-}
-type RefundStatus = "pending" | "succeeded" | "failed" | "canceled";
-interface Refund {
-  readonly id: string;
-  readonly paymentId: string;
-  readonly amount: Money;
-  readonly status: RefundStatus;
-}
-interface RefundInput {
-  /** Defaults to what is left of the captured amount. */
-  readonly amount?: Money;
-  readonly reason?: string;
-}
-type PaymentEventType = "payment.requires_action" | "payment.processing" | "payment.authorized" | "payment.succeeded" | "payment.failed" | "payment.canceled" | "refund.succeeded" | "refund.failed";
-/** A provider's webhook event in one shape for every provider. */
-interface PaymentEvent {
-  /**
-   * The provider's event id. A redelivered event repeats it, so key the
-   * handling on it (the webhook inbox and the `idempotency` module do).
-   */
-  readonly id: string;
-  readonly type: PaymentEventType;
-  readonly paymentId: string;
-  /** The payment's `reference`, when the event carries it. */
-  readonly reference?: string;
-  /** The payment's amount, or the refund's for `refund.*`. */
-  readonly amount?: Money;
-  readonly refundId?: string;
-  readonly occurredAt: Temporal.Instant;
-}
-/**
- * Takes payments for orders. Versioned: a breaking change ships a new
- * `apiVersion`. Every method returns a `Result`: `invalid_input` for an amount
- * the provider can't charge or a refund above what was captured, `not_found`
- * for an unknown payment, `unauthorized` for a webhook whose signature fails,
- * and `raised` with the hint `PAYMENT_DECLINED` when the provider declines.
- */
-interface PaymentProvider {
-  readonly apiVersion: 1;
-  readonly name: string;
-  createPayment(input: CreatePaymentInput, options?: PaymentCallOptions): AsyncResult<Payment>;
-  /** Captures an authorized payment, all of it unless `amount` is less. */
-  capture(paymentId: string, input?: {
-    readonly amount?: Money;
-  }, options?: PaymentCallOptions): AsyncResult<Payment>;
-  refund(paymentId: string, input?: RefundInput, options?: PaymentCallOptions): AsyncResult<Refund>;
-  /**
-   * Verifies a webhook delivery with the provider's secret and returns its
-   * events, none for types the contract doesn't cover.
-   */
-  parseWebhook(input: WebhookInput): AsyncResult<readonly PaymentEvent[]>;
-  /** Releases a payment that was not captured yet. */
-  cancel?(paymentId: string, options?: PaymentCallOptions): AsyncResult<Payment>;
-  get?(paymentId: string, options?: {
-    readonly signal?: AbortSignal;
-  }): AsyncResult<Payment>;
-}
-/** Checks the provider's `apiVersion` before a block uses it. */
-declare function paymentProviderOf(provider: PaymentProvider): PaymentProvider;
-/** The error for an amount a payment can't carry: not money, or not above zero. */
-declare function invalidPaymentAmount(amount: unknown): DbError | undefined;
-//#endregion
-//#region src/commerce/tax.d.ts
-/** Where the goods go (or the customer is, for services). */
-interface TaxAddress {
-  /** ISO 3166-1 alpha-2, such as `NL`. */
-  readonly country: string;
-  /** The state or province code, such as `CA`. */
-  readonly state?: string;
-  readonly postalCode?: string;
-  readonly city?: string;
-  readonly line1?: string;
-  readonly line2?: string;
-}
-interface TaxCartLine {
-  /** The cart line's id; the quote's line for it carries the same `lineId`. */
-  readonly id: string;
-  /** The line's total after discounts, in the cart's currency. */
-  readonly amount: Money;
-  readonly quantity?: number;
-  /**
-   * The product's tax category: a key of the provider's rates or a provider tax
-   * code.
-   */
-  readonly taxCategory?: string;
-  /** The amount already contains the tax (prices shown with VAT). */
-  readonly inclusive?: boolean;
-}
-interface TaxCart {
-  readonly currency: string;
-  readonly lines: readonly TaxCartLine[];
-  readonly shipping?: {
-    readonly amount: Money;
-    readonly taxCategory?: string;
-    readonly inclusive?: boolean;
-  };
-  readonly address: TaxAddress;
-  readonly customer?: {
-    /** The provider's customer id. */
-    readonly id?: string;
-    /** No tax at all, such as a reverse-charged B2B sale. */
-    readonly exempt?: boolean;
-  };
-  /** The cart or order the quote is for. */
-  readonly reference?: string;
-}
-/** The lineId of the shipping line in a quote. */
-declare const SHIPPING_LINE = "shipping";
-interface TaxLine {
-  /** The cart line's `id`, or `SHIPPING_LINE`. */
-  readonly lineId: string;
-  /** The amount the tax is computed on, without the tax. */
-  readonly taxable: Money;
-  readonly tax: Money;
-  /** The decimal fraction applied, such as `"0.21"`. */
-  readonly rate: string;
-  readonly inclusive: boolean;
-  /**
-   * The jurisdiction: Stripe's name (`Netherlands`) or the `fixedRates` region
-   * (`NL`).
-   */
-  readonly jurisdiction?: string;
-  readonly taxCategory?: string;
-}
-interface TaxQuote {
-  /**
-   * The provider's id for the calculation; `commit` turns it into a
-   * transaction.
-   */
-  readonly id: string;
-  /** The provider's `name`. */
-  readonly provider: string;
-  readonly currency: string;
-  /** One per cart line, in cart order, then the shipping line when there is one. */
-  readonly lines: readonly TaxLine[];
-  /** The tax of every line, shipping included. */
-  readonly totalTax: Money;
-  /** When the provider stops accepting the quote for `commit`. */
-  readonly expiresAt?: Temporal.Instant;
-}
-/** A recorded sale or reversal. Store it with the order to reverse it later. */
-interface TaxTransaction {
-  readonly id: string;
-  /** The order number for a sale, the refund's id for a reversal. */
-  readonly reference: string;
-  readonly currency: string;
-  /** Negative for a reversal. */
-  readonly totalTax: Money;
-  readonly lines: readonly TaxLine[];
-}
-interface TaxCommitInput {
-  readonly quote: TaxQuote;
-  /** The order number, unique per sale. */
-  readonly reference: string;
-}
-interface TaxReverseInput {
-  /** The sale `commit` returned. */
-  readonly transaction: TaxTransaction;
-  /** The refund's id, unique per reversal. */
-  readonly reference: string;
-  /**
-   * The refunded part of each line, as positive amounts without tax and their
-   * tax. Unset: the whole sale is reversed.
-   */
-  readonly lines?: readonly {
-    readonly lineId: string;
-    readonly amount: Money;
-    readonly tax: Money;
-  }[];
-}
-interface TaxCallOptions {
-  /** The same key returns the first call's result instead of recording twice. */
-  readonly idempotencyKey?: string;
-  readonly signal?: AbortSignal;
-}
-/**
- * Computes and records sales tax. Versioned: a breaking change ships a new
- * `apiVersion`. Every method returns a `Result`: `invalid_input` for a cart
- * that mixes currencies or a reversal above the sale, and `not_found` for an
- * address the provider has no rate for.
- */
-interface TaxProvider {
-  readonly apiVersion: 1;
-  readonly name: string;
-  quote(cart: TaxCart, options?: TaxCallOptions): AsyncResult<TaxQuote>;
-  commit(input: TaxCommitInput, options?: TaxCallOptions): AsyncResult<TaxTransaction>;
-  reverse(input: TaxReverseInput, options?: TaxCallOptions): AsyncResult<TaxTransaction>;
-}
-/** Checks the provider's `apiVersion` before a block uses it. */
-declare function taxProviderOf(provider: TaxProvider): TaxProvider;
-/**
- * The first problem with a cart: a line or shipping amount that isn't money, is
- * negative or is in another currency, or a country that isn't two capital
- * letters.
- */
-declare function invalidTaxCart(cart: TaxCart): DbError | undefined;
-/** The lines and total of a reversal, checked against the sale. */
-declare function reversalOf(input: TaxReverseInput): Result<{
-  readonly lines: readonly TaxLine[];
-  readonly totalTax: Money;
-}>;
-/** Rates per tax category, such as `{ standard: "0.21", reduced: "0.09" }`. */
-type TaxRates = Readonly<Record<string, string>>;
-interface FixedRatesOptions {
-  /** Defaults to `fixed-rates`. */
-  readonly name?: string;
-  /**
-   * Rates per region: a country code (`NL`) or a country and state (`US-CA`),
-   * which wins over its country.
-   */
-  readonly rates: Readonly<Record<string, TaxRates>>;
-  /** The category of a line without one. Defaults to `standard`. */
-  readonly defaultCategory?: string;
-  /** The category of shipping. Defaults to `defaultCategory`. */
-  readonly shippingCategory?: string;
-  /**
-   * A region without rates: `error` returns `not_found` (the default), `zero`
-   * quotes no tax.
-   */
-  readonly unknownRegion?: "error" | "zero";
-}
-/**
- * A `TaxProvider` with fixed rates per country (and state) and tax category,
- * rounded half to even per line. It keeps nothing: `commit` and `reverse`
- * return the transaction for the app to store.
- */
-declare function fixedRates(options: FixedRatesOptions): TaxProvider;
-//#endregion
-export { PaymentProvider as C, RefundStatus as D, RefundInput as E, invalidPaymentAmount as O, PaymentEventType as S, Refund as T, taxProviderOf as _, TaxCart as a, PaymentCallOptions as b, TaxLine as c, TaxRates as d, TaxReverseInput as f, reversalOf as g, invalidTaxCart as h, TaxCallOptions as i, paymentProviderOf as k, TaxProvider as l, fixedRates as m, SHIPPING_LINE as n, TaxCartLine as o, TaxTransaction as p, TaxAddress as r, TaxCommitInput as s, FixedRatesOptions as t, TaxQuote as u, CreatePaymentInput as v, PaymentStatus as w, PaymentEvent as x, Payment as y };