better-supabase 0.13.0 → 0.14.0

package/dist/cloud-event-SPyXMdcd.d.ts

@@ -0,0 +1,64 @@
+/// <reference lib="esnext.temporal" />
+import { D as BlockEventPattern, T as BlockEvent, o as EventHub } from "./events-DbLjvxDX.js";
+//#region src/events/cloud-event.d.ts
+/** A CloudEvents 1.0 event. Extension attributes are lowercase alphanumerics. */
+interface CloudEvent<T = unknown> {
+  readonly specversion: "1.0";
+  readonly id: string;
+  readonly source: string;
+  readonly type: string;
+  readonly subject?: string;
+  readonly time?: string;
+  readonly datacontenttype?: string;
+  readonly dataschema?: string;
+  readonly data?: T;
+  readonly [extension: string]: unknown;
+}
+interface CloudEventOptions {
+  /** URI-reference of the producer, e.g. `https://crm.example.com` or `/crm`. */
+  readonly source: string;
+  /** Replaces the `dev.better-supabase` type prefix. */
+  readonly typePrefix?: string;
+  readonly id?: () => string;
+  readonly now?: () => Temporal.Instant;
+  /**
+   * The `dataschema` attribute: the URI (or `$id`) of the JSON Schema the
+   * event's `data` conforms to, e.g. a schema emitted next to an AsyncAPI
+   * document. A function picks one per event type and leaves it out by
+   * returning `undefined`. Defaults to none.
+   */
+  readonly dataschema?: string | ((event: DataschemaContext) => string | undefined);
+}
+/** What a `dataschema` function sees of an event. */
+interface DataschemaContext {
+  /** The CloudEvents `type`, with the configured prefix. */
+  readonly type: string;
+  /** App key of the mutated table, for row events. */
+  readonly table?: string;
+}
+/** Sends events somewhere: a queue, a bus, an outbox table, an HTTP endpoint. */
+interface EventSink {
+  send(events: readonly CloudEvent[]): void | Promise<void>;
+}
+/**
+ * A block event as a CloudEvent: `dev.better-supabase.support.started` with the
+ * event data and the actor (`actorId`) as `data` and the tenant as
+ * `partitionkey`.
+ */
+declare function blockCloudEvent(event: BlockEvent, options: CloudEventOptions): CloudEvent;
+interface ForwardBlockOptions extends CloudEventOptions {
+  /** Only forward events that match, e.g. `support.*`. Defaults to all. */
+  readonly types?: readonly BlockEventPattern[];
+  /** Sink failures never fail the block call. Defaults to the `Logger`. */
+  readonly onError?: (error: unknown, events: readonly CloudEvent[]) => void;
+}
+/**
+ * Sends a CloudEvent for every block event (`support.*`, `organization.*`, ...)
+ * to `sink`. Returns a function that stops forwarding. Like `forwardMutations`,
+ * sends are tracked on `betterSupabase.events`.
+ */
+declare function forwardBlockEvents(betterSupabase: {
+  readonly events: EventHub;
+}, sink: EventSink, options: ForwardBlockOptions): () => void;
+//#endregion
+export { ForwardBlockOptions as a, EventSink as i, CloudEventOptions as n, blockCloudEvent as o, DataschemaContext as r, forwardBlockEvents as s, CloudEvent as t };

package/dist/codecs-CQrX3ZW4.js

@@ -0,0 +1,358 @@
+import { n as isRecord } from "./guards-6F2bCtQR.js";
+import { A as requiredInstant, C as optionalText, D as recordOf, I as textOf, S as optionalInstant, d as enumOrThrow, k as recordsOf, y as nullableText } from "./block-helpers-CiKtrb6g.js";
+import { s as rowFields } from "./block-fields-DBSJSeaO.js";
+import { d as money } from "./money-BZl985O-.js";
+import { i as moneyOf, t as amountText } from "./money-codec-jMP0PQLZ.js";
+//#region src/blocks/orders/codecs.ts
+const ORDER_STATUSES = [
+	"pending_payment",
+	"paid",
+	"fulfilled",
+	"completed",
+	"cancelled",
+	"refunded"
+];
+const FULFILLMENT_STATUSES = [
+	"pending",
+	"shipped",
+	"delivered",
+	"cancelled"
+];
+const RETURN_STATUSES = [
+	"requested",
+	"received",
+	"rejected"
+];
+const REFUND_STATUSES = [
+	"pending",
+	"succeeded",
+	"failed"
+];
+const PAYMENT_STATUSES = [
+	"requires_action",
+	"processing",
+	"authorized",
+	"succeeded",
+	"failed",
+	"canceled"
+];
+const PROMOTION_KINDS = [
+	"percentage",
+	"fixed",
+	"free_shipping"
+];
+const ADDRESS_FIELDS = [
+	"name",
+	"company",
+	"line1",
+	"line2",
+	"postalCode",
+	"city",
+	"state",
+	"phone"
+];
+function addressOf(value) {
+	if (!isRecord(value) || typeof value["country"] !== "string") return;
+	const fields = {};
+	for (const key of ADDRESS_FIELDS) {
+		const entry = value[key];
+		if (typeof entry === "string") fields[key] = entry;
+	}
+	return {
+		...fields,
+		country: value["country"]
+	};
+}
+function shippingOf(value, currency) {
+	if (!isRecord(value)) return;
+	return {
+		rateId: textOf(value["rateId"]),
+		name: textOf(value["name"]),
+		amount: moneyOf(value["amount"], currency)
+	};
+}
+function promotionsOf(value, currency) {
+	if (!Array.isArray(value)) return [];
+	return value.filter(isRecord).map((entry) => {
+		const code = optionalText(entry["code"]);
+		const kind = enumOrThrow(entry["kind"], PROMOTION_KINDS, "promotion kind");
+		return {
+			promotionId: textOf(entry["promotionId"]),
+			name: textOf(entry["name"]),
+			kind,
+			...code === void 0 ? {} : { code },
+			discount: moneyOf(entry["amount"] ?? "0", currency),
+			freeShipping: kind === "free_shipping"
+		};
+	});
+}
+function problemsOf(value) {
+	if (!Array.isArray(value)) return [];
+	return value.filter(isRecord).map((entry) => {
+		const lineId = optionalText(entry["lineId"]);
+		const variantId = optionalText(entry["variantId"]);
+		const code = optionalText(entry["code"]);
+		const promotionId = optionalText(entry["promotionId"]);
+		const reason = optionalText(entry["reason"]);
+		return {
+			problem: textOf(entry["problem"]),
+			...lineId === void 0 ? {} : { lineId },
+			...variantId === void 0 ? {} : { variantId },
+			...code === void 0 ? {} : { code },
+			...promotionId === void 0 ? {} : { promotionId },
+			...reason === void 0 ? {} : { reason }
+		};
+	});
+}
+function pricedCartOf(value) {
+	const row = recordOf(value, "price_cart");
+	const currency = textOf(row["currency"]);
+	const amount = (key) => moneyOf(row[key], currency);
+	const email = optionalText(row["email"]);
+	const shippingAddress = addressOf(row["shippingAddress"]);
+	const billingAddress = addressOf(row["billingAddress"]);
+	const shipping = shippingOf(row["shipping"], currency);
+	return {
+		id: textOf(row["cartId"]),
+		organizationId: textOf(row["organizationId"]),
+		customerId: textOf(row["customerId"]),
+		status: enumOrThrow(row["status"], [
+			"open",
+			"converted",
+			"abandoned"
+		], "cart status"),
+		currency,
+		...email === void 0 ? {} : { email },
+		...shippingAddress === void 0 ? {} : { shippingAddress },
+		...billingAddress === void 0 ? {} : { billingAddress },
+		lines: recordsOf(row["lines"], "orders").map((line) => {
+			const previous = line["previousUnitAmount"];
+			return {
+				id: textOf(line["id"]),
+				variantId: textOf(line["variantId"]),
+				productId: textOf(line["productId"]),
+				sku: textOf(line["sku"]),
+				title: textOf(line["title"]),
+				quantity: Number(line["quantity"]),
+				unitAmount: moneyOf(line["unitAmount"], currency),
+				...previous === null || previous === void 0 || previous === line["unitAmount"] ? {} : { previousUnitAmount: moneyOf(previous, currency) },
+				subtotal: moneyOf(line["subtotal"], currency),
+				discount: moneyOf(line["discount"], currency),
+				total: moneyOf(line["total"], currency),
+				requiresShipping: line["requiresShipping"] === true
+			};
+		}),
+		subtotal: amount("subtotal"),
+		discountTotal: amount("discountTotal"),
+		shippingTotal: amount("shippingTotal"),
+		total: amount("total"),
+		requiresShipping: row["requiresShipping"] === true,
+		weightGrams: Number(row["weightGrams"] ?? 0),
+		...shipping === void 0 ? {} : { shipping },
+		promotions: promotionsOf(row["promotions"], currency),
+		problems: problemsOf(row["problems"])
+	};
+}
+function shippingOptionsOf(value) {
+	return recordsOf(value, "orders").map((row) => ({
+		id: textOf(row["id"]),
+		name: textOf(row["name"]),
+		kind: enumOrThrow(row["kind"], ["flat", "weight"], "rate kind"),
+		amount: moneyOf(row["amount"], textOf(row["currency"]))
+	}));
+}
+function taxLineToJson(line) {
+	return {
+		lineId: line.lineId,
+		taxable: amountText(line.taxable),
+		tax: amountText(line.tax),
+		rate: line.rate,
+		inclusive: line.inclusive,
+		...line.jurisdiction === void 0 ? {} : { jurisdiction: line.jurisdiction },
+		...line.taxCategory === void 0 ? {} : { taxCategory: line.taxCategory }
+	};
+}
+function taxLineOf(value, currency) {
+	const jurisdiction = optionalText(value["jurisdiction"]);
+	const taxCategory = optionalText(value["taxCategory"]);
+	return {
+		lineId: textOf(value["lineId"]),
+		taxable: moneyOf(value["taxable"], currency),
+		tax: moneyOf(value["tax"], currency),
+		rate: textOf(value["rate"]),
+		inclusive: value["inclusive"] === true,
+		...jurisdiction === void 0 ? {} : { jurisdiction },
+		...taxCategory === void 0 ? {} : { taxCategory }
+	};
+}
+/** The quote as `place_order` stores it: amounts as text. */
+function quoteToJson(quote) {
+	return {
+		provider: quote.provider,
+		quoteId: quote.id,
+		currency: quote.currency,
+		inclusive: quote.lines.some((line) => line.inclusive),
+		totalTax: amountText(quote.totalTax),
+		...quote.expiresAt === void 0 ? {} : { expiresAt: quote.expiresAt.toString() },
+		lines: quote.lines.map(taxLineToJson)
+	};
+}
+function quoteOf(value) {
+	if (!isRecord(value) || typeof value["quoteId"] !== "string") return;
+	const currency = textOf(value["currency"]);
+	const expiresAt = optionalInstant(value["expiresAt"]);
+	return {
+		id: value["quoteId"],
+		provider: textOf(value["provider"]),
+		currency,
+		lines: recordsOf(value["lines"], "orders").map((line) => taxLineOf(line, currency)),
+		totalTax: moneyOf(value["totalTax"], currency),
+		...expiresAt === void 0 ? {} : { expiresAt }
+	};
+}
+function transactionToJson(transaction) {
+	return {
+		id: transaction.id,
+		reference: transaction.reference,
+		currency: transaction.currency,
+		totalTax: amountText(transaction.totalTax),
+		lines: transaction.lines.map(taxLineToJson)
+	};
+}
+function transactionOf(value) {
+	if (!isRecord(value) || typeof value["id"] !== "string") return;
+	const currency = textOf(value["currency"]);
+	return {
+		id: value["id"],
+		reference: textOf(value["reference"]),
+		currency,
+		totalTax: moneyOf(value["totalTax"], currency),
+		lines: recordsOf(value["lines"], "orders").map((line) => taxLineOf(line, currency))
+	};
+}
+const quantities = (value) => recordsOf(value, "orders").map((line) => ({
+	lineId: textOf(line["lineId"]),
+	quantity: Number(line["quantity"])
+}));
+const when = (key, value) => {
+	const instant = optionalInstant(value);
+	return instant === void 0 ? {} : { [key]: instant };
+};
+function orderOf(value) {
+	const row = recordOf(value, "get_order");
+	const currency = textOf(row["currency"]);
+	const amount = (key) => moneyOf(row[key], currency);
+	const shippingAddress = addressOf(row["shippingAddress"]);
+	const billingAddress = addressOf(row["billingAddress"]);
+	const shipping = shippingOf(row["shipping"], currency);
+	const taxQuote = quoteOf(row["tax"]);
+	const taxTransaction = transactionOf(row["taxTransaction"]);
+	return {
+		id: textOf(row["id"]),
+		organizationId: textOf(row["organizationId"]),
+		number: textOf(row["number"]),
+		cartId: textOf(row["cartId"]),
+		customerId: textOf(row["customerId"]),
+		email: nullableText(row["email"]),
+		status: enumOrThrow(row["status"], ORDER_STATUSES, "order status"),
+		currency,
+		subtotal: amount("subtotal"),
+		discountTotal: amount("discountTotal"),
+		shippingTotal: amount("shippingTotal"),
+		taxTotal: amount("taxTotal"),
+		total: amount("total"),
+		paidTotal: amount("paidTotal"),
+		refundedTotal: amount("refundedTotal"),
+		taxInclusive: row["taxInclusive"] === true,
+		...shippingAddress === void 0 ? {} : { shippingAddress },
+		...billingAddress === void 0 ? {} : { billingAddress },
+		...shipping === void 0 ? {} : { shipping },
+		promotions: promotionsOf(row["promotions"], currency),
+		...taxQuote === void 0 ? {} : { taxQuote },
+		...taxTransaction === void 0 ? {} : { taxTransaction },
+		invoiceNumber: nullableText(row["invoiceNumber"]),
+		...when("invoicedAt", row["invoicedAt"]),
+		placedAt: requiredInstant(row["placedAt"], "placedAt"),
+		...when("paidAt", row["paidAt"]),
+		...when("fulfilledAt", row["fulfilledAt"]),
+		...when("completedAt", row["completedAt"]),
+		...when("cancelledAt", row["cancelledAt"]),
+		cancelReason: nullableText(row["cancelReason"]),
+		fields: rowFields(row["fields"]),
+		lines: recordsOf(row["lines"], "orders").map((line) => ({
+			id: textOf(line["id"]),
+			variantId: nullableText(line["variantId"]),
+			productId: nullableText(line["productId"]),
+			sku: textOf(line["sku"]),
+			title: textOf(line["title"]),
+			quantity: Number(line["quantity"]),
+			unitAmount: moneyOf(line["unitAmount"], currency),
+			subtotal: moneyOf(line["subtotal"], currency),
+			discount: moneyOf(line["discount"], currency),
+			tax: moneyOf(line["tax"], currency),
+			total: moneyOf(line["total"], currency),
+			requiresShipping: line["requiresShipping"] === true,
+			locationId: nullableText(line["locationId"]),
+			reservationId: nullableText(line["reservationId"]),
+			fulfilled: Number(line["fulfilled"]),
+			returned: Number(line["returned"]),
+			backordered: line["backordered"] === true
+		})),
+		payments: recordsOf(row["payments"], "orders").map((payment) => ({
+			id: textOf(payment["id"]),
+			provider: textOf(payment["provider"]),
+			reference: textOf(payment["reference"]),
+			status: enumOrThrow(payment["status"], PAYMENT_STATUSES, "payment status"),
+			amount: moneyOf(payment["amount"], currency),
+			captured: moneyOf(payment["captured"], currency),
+			refunded: moneyOf(payment["refunded"], currency),
+			createdAt: requiredInstant(payment["createdAt"], "createdAt")
+		})),
+		fulfillments: recordsOf(row["fulfillments"], "orders").map((fulfillment) => ({
+			id: textOf(fulfillment["id"]),
+			status: enumOrThrow(fulfillment["status"], FULFILLMENT_STATUSES, "fulfillment status"),
+			locationId: nullableText(fulfillment["locationId"]),
+			carrier: nullableText(fulfillment["carrier"]),
+			trackingNumber: nullableText(fulfillment["trackingNumber"]),
+			trackingUrl: nullableText(fulfillment["trackingUrl"]),
+			lines: quantities(fulfillment["lines"]),
+			createdAt: requiredInstant(fulfillment["createdAt"], "createdAt"),
+			...when("shippedAt", fulfillment["shippedAt"]),
+			...when("deliveredAt", fulfillment["deliveredAt"])
+		})),
+		returns: recordsOf(row["returns"], "orders").map((entry) => ({
+			id: textOf(entry["id"]),
+			status: enumOrThrow(entry["status"], RETURN_STATUSES, "return status"),
+			reason: nullableText(entry["reason"]),
+			lines: quantities(entry["lines"]),
+			createdAt: requiredInstant(entry["createdAt"], "createdAt"),
+			...when("receivedAt", entry["receivedAt"])
+		})),
+		refunds: recordsOf(row["refunds"], "orders").map((refund) => ({
+			id: textOf(refund["id"]),
+			paymentId: textOf(refund["paymentId"]),
+			returnId: nullableText(refund["returnId"]),
+			amount: moneyOf(refund["amount"], currency),
+			status: enumOrThrow(refund["status"], REFUND_STATUSES, "refund status"),
+			reason: nullableText(refund["reason"]),
+			providerReference: nullableText(refund["providerReference"]),
+			createdAt: requiredInstant(refund["createdAt"], "createdAt"),
+			...when("completedAt", refund["completedAt"])
+		}))
+	};
+}
+/** The tax lines of a refund: each sold line's share of `amount` out of `total`. */
+function refundedTaxLines(transaction, amount, total) {
+	const share = (value) => {
+		if (total.amount === 0n) return value;
+		const part = value.amount * amount.amount / total.amount;
+		return money(part > value.amount ? value.amount : part, transaction.currency);
+	};
+	return transaction.lines.map((line) => ({
+		lineId: line.lineId,
+		amount: share(line.taxable),
+		tax: share(line.tax)
+	}));
+}
+//#endregion
+export { RETURN_STATUSES as a, quoteToJson as c, transactionToJson as d, REFUND_STATUSES as i, refundedTaxLines as l, ORDER_STATUSES as n, orderOf as o, PROMOTION_KINDS as r, pricedCartOf as s, FULFILLMENT_STATUSES as t, shippingOptionsOf as u };

package/dist/codecs-DAu2sYWn.d.ts

@@ -0,0 +1,222 @@
+/// <reference lib="esnext.temporal" />
+import { i as RowFields } from "./block-fields-3w4MZr8U.js";
+import { n as Money } from "./money-BNRdJQzA.js";
+import { n as Payment } from "./payments-CBzQIjoX.js";
+import { p as TaxTransaction, u as TaxQuote } from "./tax-CIIxd8Zf.js";
+//#region src/blocks/orders/codecs.d.ts
+declare const ORDER_STATUSES: readonly ["pending_payment", "paid", "fulfilled", "completed", "cancelled", "refunded"];
+type OrderStatus = (typeof ORDER_STATUSES)[number];
+declare const FULFILLMENT_STATUSES: readonly ["pending", "shipped", "delivered", "cancelled"];
+type FulfillmentStatus = (typeof FULFILLMENT_STATUSES)[number];
+declare const RETURN_STATUSES: readonly ["requested", "received", "rejected"];
+type ReturnStatus = (typeof RETURN_STATUSES)[number];
+declare const REFUND_STATUSES: readonly ["pending", "succeeded", "failed"];
+type OrderRefundStatus = (typeof REFUND_STATUSES)[number];
+/** A postal address; `country` is ISO 3166-1 alpha-2. */
+interface Address {
+  readonly country: string;
+  readonly name?: string;
+  readonly company?: string;
+  readonly line1?: string;
+  readonly line2?: string;
+  readonly postalCode?: string;
+  readonly city?: string;
+  /** The state or province code, such as `CA`. */
+  readonly state?: string;
+  readonly phone?: string;
+}
+/**
+ * Something that keeps a cart from checkout, such as `unpriced` or
+ * `shipping_required`.
+ */
+interface CartProblem {
+  readonly problem: string;
+  readonly lineId?: string;
+  readonly variantId?: string;
+  readonly code?: string;
+  /** For `promotion_unavailable`: the promotion behind the code. */
+  readonly promotionId?: string;
+  /**
+   * For `promotion_unavailable`, such as `expired`, `limit_reached` or
+   * `not_combinable`.
+   */
+  readonly reason?: string;
+}
+interface CartLine {
+  readonly id: string;
+  readonly variantId: string;
+  readonly productId: string;
+  readonly sku: string;
+  readonly title: string;
+  readonly quantity: number;
+  readonly unitAmount: Money;
+  /** The price when the line was added, when it changed since. */
+  readonly previousUnitAmount?: Money;
+  readonly subtotal: Money;
+  readonly discount: Money;
+  /** After discounts, before tax. */
+  readonly total: Money;
+  readonly requiresShipping: boolean;
+}
+declare const PROMOTION_KINDS: readonly ["percentage", "fixed", "free_shipping"];
+/** A promotion the cart gets, as the `promotions` module reports it. */
+interface AppliedPromotion {
+  readonly promotionId: string;
+  readonly name: string;
+  readonly kind: (typeof PROMOTION_KINDS)[number];
+  readonly code?: string;
+  /** Zero for free shipping, which shows in the shipping total instead. */
+  readonly discount: Money;
+  readonly freeShipping: boolean;
+}
+interface PricedCart {
+  readonly id: string;
+  readonly organizationId: string;
+  readonly customerId: string;
+  readonly status: "open" | "converted" | "abandoned";
+  readonly currency: string;
+  readonly email?: string;
+  readonly shippingAddress?: Address;
+  readonly billingAddress?: Address;
+  readonly lines: readonly CartLine[];
+  readonly subtotal: Money;
+  readonly discountTotal: Money;
+  readonly shippingTotal: Money;
+  /** Subtotal less discounts plus shipping, before tax. */
+  readonly total: Money;
+  readonly requiresShipping: boolean;
+  readonly weightGrams: number;
+  readonly shipping?: {
+    readonly rateId: string;
+    readonly name: string;
+    readonly amount: Money;
+  };
+  readonly promotions: readonly AppliedPromotion[];
+  /** Empty when the cart can check out. */
+  readonly problems: readonly CartProblem[];
+}
+interface ShippingOption {
+  readonly id: string;
+  readonly name: string;
+  readonly kind: "flat" | "weight";
+  readonly amount: Money;
+}
+interface OrderLine {
+  readonly id: string;
+  /** Null once the variant is deleted; the line keeps its SKU and title. */
+  readonly variantId: string | null;
+  readonly productId: string | null;
+  readonly sku: string;
+  readonly title: string;
+  readonly quantity: number;
+  readonly unitAmount: Money;
+  readonly subtotal: Money;
+  readonly discount: Money;
+  readonly tax: Money;
+  /** After discounts, without tax. */
+  readonly total: Money;
+  readonly requiresShipping: boolean;
+  readonly locationId: string | null;
+  readonly reservationId: string | null;
+  readonly fulfilled: number;
+  readonly returned: number;
+  /** The stock didn't cover the line when the order was placed or paid. */
+  readonly backordered: boolean;
+}
+interface OrderPayment {
+  readonly id: string;
+  readonly provider: string;
+  /** The provider's payment id. */
+  readonly reference: string;
+  readonly status: Payment["status"];
+  readonly amount: Money;
+  readonly captured: Money;
+  readonly refunded: Money;
+  readonly createdAt: Temporal.Instant;
+}
+interface QuantityLine {
+  readonly lineId: string;
+  readonly quantity: number;
+}
+interface Fulfillment {
+  readonly id: string;
+  readonly status: FulfillmentStatus;
+  readonly locationId: string | null;
+  readonly carrier: string | null;
+  readonly trackingNumber: string | null;
+  readonly trackingUrl: string | null;
+  readonly lines: readonly QuantityLine[];
+  readonly createdAt: Temporal.Instant;
+  readonly shippedAt?: Temporal.Instant;
+  readonly deliveredAt?: Temporal.Instant;
+}
+interface OrderReturn {
+  readonly id: string;
+  readonly status: ReturnStatus;
+  readonly reason: string | null;
+  readonly lines: readonly QuantityLine[];
+  readonly createdAt: Temporal.Instant;
+  readonly receivedAt?: Temporal.Instant;
+}
+interface OrderRefund {
+  readonly id: string;
+  readonly paymentId: string;
+  readonly returnId: string | null;
+  readonly amount: Money;
+  readonly status: OrderRefundStatus;
+  readonly reason: string | null;
+  readonly providerReference: string | null;
+  readonly createdAt: Temporal.Instant;
+  readonly completedAt?: Temporal.Instant;
+}
+/** An order. `F` types the extra columns the `fields` schema describes. */
+interface Order<F extends object = Record<never, never>> {
+  readonly id: string;
+  readonly organizationId: string;
+  /** Gapless per organization, from `number-sequences` when it numbers `order`. */
+  readonly number: string;
+  readonly cartId: string;
+  readonly customerId: string;
+  readonly email: string | null;
+  readonly status: OrderStatus;
+  readonly currency: string;
+  readonly subtotal: Money;
+  readonly discountTotal: Money;
+  readonly shippingTotal: Money;
+  readonly taxTotal: Money;
+  /** What the customer pays: with tax, unless the prices already include it. */
+  readonly total: Money;
+  readonly paidTotal: Money;
+  readonly refundedTotal: Money;
+  readonly taxInclusive: boolean;
+  readonly shippingAddress?: Address;
+  readonly billingAddress?: Address;
+  readonly shipping?: {
+    readonly rateId: string;
+    readonly name: string;
+    readonly amount: Money;
+  };
+  readonly promotions: readonly AppliedPromotion[];
+  /** The tax quote the order was placed with. */
+  readonly taxQuote?: TaxQuote;
+  /** The sale the tax provider recorded once the order was paid. */
+  readonly taxTransaction?: TaxTransaction;
+  /** Gapless per organization; set once the order is paid. */
+  readonly invoiceNumber: string | null;
+  readonly invoicedAt?: Temporal.Instant;
+  readonly placedAt: Temporal.Instant;
+  readonly paidAt?: Temporal.Instant;
+  readonly fulfilledAt?: Temporal.Instant;
+  readonly completedAt?: Temporal.Instant;
+  readonly cancelledAt?: Temporal.Instant;
+  readonly cancelReason: string | null;
+  readonly lines: readonly OrderLine[];
+  readonly payments: readonly OrderPayment[];
+  readonly fulfillments: readonly Fulfillment[];
+  readonly returns: readonly OrderReturn[];
+  readonly refunds: readonly OrderRefund[];
+  /** The app's extra columns (`options.extraColumns`), by column name. */
+  readonly fields: RowFields<F>;
+}
+//#endregion
+export { ShippingOption as S, PricedCart as _, FULFILLMENT_STATUSES as a, RETURN_STATUSES as b, ORDER_STATUSES as c, OrderPayment as d, OrderRefund as f, PROMOTION_KINDS as g, OrderStatus as h, CartProblem as i, Order as l, OrderReturn as m, AppliedPromotion as n, Fulfillment as o, OrderRefundStatus as p, CartLine as r, FulfillmentStatus as s, Address as t, OrderLine as u, QuantityLine as v, ReturnStatus as x, REFUND_STATUSES as y };