better-supabase 0.12.0 → 0.14.0

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

@@ -1,19 +1,133 @@
 /// <reference lib="esnext.temporal" />
-import { t as AsyncResult } from "../../result-BREt7qOh.js";
-import { N as CommerceSubjectEventData, wt as Events } from "../../events-P3raDX2E.js";
+import { t as AsyncResult } from "../../result-C6jDfedy.js";
+import { t as StandardSchemaV1 } from "../../standard-DbQsD2xZ.js";
+import { r as FieldsOf } from "../../block-fields-3w4MZr8U.js";
+import { Ct as Events, M as CommerceSubjectEventData } from "../../events-DbLjvxDX.js";
 import { n as Logger } from "../../logger-DWVYUmwi.js";
-import { t as StandardSchemaV1 } from "../../standard-BcUQuUgu.js";
-import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DezJPPA0.js";
-import { n as BlockOptions } from "../../block-helpers-CjcQM1yA.js";
-import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-DcPJHztl.js";
-import { r as FieldsOf } from "../../block-fields-DnaDbgZS.js";
-import { g as JobHandler } from "../../types-BEEFkNFY.js";
-import { s as BlockOf } from "../../define-block-BHxLHLys.js";
-import { r as WebhookInput } from "../../signatures-BXlDXV3D.js";
-import { n as Money } from "../../money-DFpWzQvk.js";
-import { n as MetricDefinition } from "../../metric-definition-95HFoW1V.js";
-import { C as PaymentProvider, l as TaxProvider, p as TaxTransaction, x as PaymentEvent, y as Payment } from "../../tax-DMWDUzKt.js";
-import { S as ShippingOption, _ as PricedCart, a as FULFILLMENT_STATUSES, b as RETURN_STATUSES, c as ORDER_STATUSES, d as OrderPayment, f as OrderRefund, h as OrderStatus, i as CartProblem, l as Order, m as OrderReturn, n as AppliedPromotion, o as Fulfillment, p as OrderRefundStatus, r as CartLine, s as FulfillmentStatus, t as Address, u as OrderLine, v as QuantityLine, x as ReturnStatus, y as REFUND_STATUSES } from "../../codecs-RwFNK8Jh.js";
+import { n as BlockOptions } 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 { g as JobHandler } from "../../types-CGUDoF5I.js";
+import { c as BlockOf } from "../../define-block-COpcS6aT.js";
+import { n as Money } from "../../money-BNRdJQzA.js";
+import { r as WebhookInput } from "../../signatures-zbu6KTNQ.js";
+import { i as PaymentEvent, n as Payment, o as PaymentProvider } from "../../payments-CBzQIjoX.js";
+import { n as MetricDefinition } from "../../metric-definition-EAYI1r2n.js";
+import { l as TaxProvider, p as TaxTransaction } from "../../tax-CIIxd8Zf.js";
+import { S as ShippingOption, _ as PricedCart, a as FULFILLMENT_STATUSES, b as RETURN_STATUSES, c as ORDER_STATUSES, d as OrderPayment, f as OrderRefund, h as OrderStatus, i as CartProblem, l as Order, m as OrderReturn, n as AppliedPromotion, o as Fulfillment, p as OrderRefundStatus, r as CartLine, s as FulfillmentStatus, t as Address, u as OrderLine, v as QuantityLine, x as ReturnStatus, y as REFUND_STATUSES } from "../../codecs-DAu2sYWn.js";
+//#region src/blocks/orders/kitchen.d.ts
+/** Where a line is in the kitchen, in order. */
+type PreparationState = "queued" | "preparing" | "ready" | "served";
+export declare const PREPARATION_STATES: readonly PreparationState[];
+/** The Realtime event every preparation change sends on `kitchenTopic`. */
+export declare const KITCHEN_EVENT = "preparation";
+/**
+ * The private Realtime channel a kitchen display and an order board join: every
+ * change to a line's state or station is sent there.
+ */
+export declare const kitchenTopic: (organizationId: string) => string;
+/** A place lines are prepared at, such as a grill, a bar or a cold station. */
+interface KitchenStation {
+  readonly id: string;
+  readonly organizationId: string;
+  /** Lowercase letters, digits, `-` and `_`. */
+  readonly key: string;
+  readonly name: string;
+  readonly position: number;
+  /** Lines of a product no station claims go here. */
+  readonly isDefault: boolean;
+  readonly active: boolean;
+  /** The catalog products routed to this station. */
+  readonly productIds: readonly string[];
+  readonly createdAt: Temporal.Instant;
+  readonly updatedAt: Temporal.Instant;
+}
+interface KitchenStationInput {
+  readonly key?: string;
+  readonly name?: string;
+  readonly position?: number;
+  readonly default?: boolean;
+  readonly active?: boolean;
+  /** Replaces the products routed to the station. */
+  readonly productIds?: readonly string[];
+}
+/** One order line at a station. */
+interface PreparationLine {
+  readonly lineId: string;
+  readonly orderId: string;
+  readonly stationId?: string;
+  readonly title: string;
+  readonly sku: string;
+  readonly quantity: number;
+  readonly position: number;
+  readonly state: PreparationState;
+  /** The note for the cook, such as `no onions`. */
+  readonly note?: string;
+  readonly queuedAt: Temporal.Instant;
+  readonly startedAt?: Temporal.Instant;
+  readonly readyAt?: Temporal.Instant;
+  readonly servedAt?: Temporal.Instant;
+}
+/** A kitchen display ticket: one order's lines at a station. */
+interface KitchenTicket {
+  readonly orderId: string;
+  readonly number: string;
+  readonly sentAt: Temporal.Instant;
+  readonly lines: readonly PreparationLine[];
+}
+/** An order on the order-state board, in its least advanced line's state. */
+interface OrderBoardCard {
+  readonly orderId: string;
+  readonly number: string;
+  readonly customerId?: string;
+  readonly status: string;
+  readonly state: PreparationState;
+  readonly sentAt: Temporal.Instant;
+  /** When the last line became ready, once every line is. */
+  readonly readyAt?: Temporal.Instant;
+  readonly servedAt?: Temporal.Instant;
+  readonly counts: Readonly<Record<PreparationState, number>>;
+}
+interface KitchenQueueQuery {
+  /** One station's tickets. Default: every station. */
+  readonly stationId?: string;
+  /** Default: queued, preparing and ready. */
+  readonly states?: readonly PreparationState[];
+  /** Default 100, at most 500 tickets. */
+  readonly pageSize?: number;
+}
+interface OrderBoardQuery {
+  /** Orders sent to the kitchen since. Default: the last 24 hours. */
+  readonly since?: Temporal.Instant;
+  /** Default 200, at most 1000 orders. */
+  readonly pageSize?: number;
+}
+/**
+ * The kitchen of `blocks.orders.options.kitchen`: stations, line states, a
+ * kitchen display's queue and an order-state board. Members need
+ * `orders.prepare` (or `orders.manage`) to move lines, and `orders.manage` to
+ * change stations.
+ */
+interface OrderKitchen {
+  saveStation(organizationId: string, input: KitchenStationInput, stationId?: string): AsyncResult<KitchenStation>;
+  deleteStation(stationId: string): AsyncResult<boolean>;
+  stations(organizationId: string): AsyncResult<readonly KitchenStation[]>;
+  /**
+   * Queues the order's lines not sent yet at their product's station. `notes`
+   * maps a line id to a note for the cook. Returns how many it queued.
+   */
+  send(orderId: string, notes?: Readonly<Record<string, string>>): AsyncResult<number>;
+  /** Moves one line; moving back clears the later times. */
+  setState(lineId: string, state: PreparationState): AsyncResult<PreparationLine>;
+  /**
+   * Moves every line of the order behind `state` up to it, at one station or
+   * all. Returns how many lines moved.
+   */
+  bump(orderId: string, state: PreparationState, stationId?: string): AsyncResult<number>;
+  queue(organizationId: string, query?: KitchenQueueQuery): AsyncResult<readonly KitchenTicket[]>;
+  board(organizationId: string, query?: OrderBoardQuery): AsyncResult<readonly OrderBoardCard[]>;
+}
+//#endregion
 //#region src/blocks/orders/metrics.d.ts
 interface OrderMetricsOptions {
   /** The orders module's schema. Default `better_supabase`. */
@@ -26,11 +140,14 @@ interface OrderMetricsOptions {
 type OrderMetrics = readonly [MetricDefinition<"orders">, MetricDefinition<"revenue">, MetricDefinition<"average_order_value">];
 /**
  * Metric definitions over the orders table: orders placed, and revenue and
- * average order value from paid orders, in minor units of `currency`. Pass
- * them to `blocks.metrics.options.metrics` and `createMetrics`.
+ * average order value from paid orders, in minor units of `currency`. Pass them
+ * to `blocks.metrics.options.metrics` and `createMetrics`.
  */
 export declare function orderMetrics(options: OrderMetricsOptions): OrderMetrics;
-/** The events that add rows to `orderMetrics`, for `metricsSink` or `createBlocks({ metricEvents })`. */
+/**
+ * The events that add rows to `orderMetrics`, for `metricsSink` or
+ * `createBlocks({ metricEvents })`.
+ */
 export declare const ORDER_METRIC_EVENTS: {
   readonly "order.placed": readonly ["orders"];
   readonly "order.paid": readonly ["revenue", "average_order_value"];
@@ -48,7 +165,10 @@ interface OrdersOptions<S extends StandardSchemaV1 | undefined = undefined> exte
   readonly payments?: PaymentProvider;
   /** Quotes tax at checkout and records the sale once the order is paid. */
   readonly tax?: TaxProvider;
-  /** The tax category of each cart line, such as `standard` or a provider tax code. */
+  /**
+   * The tax category of each cart line, such as `standard` or a provider tax
+   * code.
+   */
   readonly taxCategory?: string | ((line: CartLine) => string | undefined);
   /** The tax category of the shipping line. */
   readonly shippingTaxCategory?: string;
@@ -58,7 +178,10 @@ interface OrdersOptions<S extends StandardSchemaV1 | undefined = undefined> exte
   readonly capture?: "automatic" | "manual";
   /** `withBlockHooks` hooks around any orders method. */
   readonly hooks?: NoInfer<BlockHooks<Orders<FieldsOf<S>>>>;
-  /** Receives the errors `after` hooks throw and failed tax calls. Default: `console`. */
+  /**
+   * Receives the errors `after` hooks throw and failed tax calls. Default:
+   * `console`.
+   */
   readonly logger?: Logger;
 }
 interface ShippingRateInput {
@@ -166,7 +289,10 @@ interface Orders<F extends object = Record<never, never>> {
     readonly id: string;
   }>;
   deleteShippingRate(rateId: string): AsyncResult<boolean>;
-  /** The caller's open cart in the organization and currency, created when there is none. */
+  /**
+   * The caller's open cart in the organization and currency, created when there
+   * is none.
+   */
   createCart(organizationId: string, input: CartInput): AsyncResult<{
     readonly id: string;
     readonly currency: string;
@@ -188,17 +314,20 @@ interface Orders<F extends object = Record<never, never>> {
   /** The cart at today's prices, with what keeps it from checkout. */
   priceCart(cartId: string): AsyncResult<PricedCart>;
   /**
-   * Moves an anonymous user's open carts to the user they signed in as.
-   * Service only. Resolves to the number of carts moved or merged.
+   * Moves an anonymous user's open carts to the user they signed in as. Service
+   * only. Resolves to the number of carts moved or merged.
    */
   mergeCarts(fromUserId: string, toUserId: string): AsyncResult<number>;
   /**
-   * Prices the cart, quotes tax, places the order (reserving its stock)
-   * and creates the payment. Repeating it for the same cart returns the
-   * same order and, through the idempotency key, the same payment.
+   * Prices the cart, quotes tax, places the order (reserving its stock) and
+   * creates the payment. Repeating it for the same cart returns the same order
+   * and, through the idempotency key, the same payment.
    */
   checkout(cartId: string, input?: CheckoutInput<F>): AsyncResult<Checkout<F>>;
-  /** Stores a payment's state on its order; the order is paid once its total is captured. Service only. */
+  /**
+   * Stores a payment's state on its order; the order is paid once its total is
+   * captured. Service only.
+   */
   recordPayment(orderId: string | null, payment: Payment): AsyncResult<PaymentRecord>;
   /** Captures the order's authorized payments. */
   capture(orderId: string): AsyncResult<Order<F>>;
@@ -206,7 +335,10 @@ interface Orders<F extends object = Record<never, never>> {
   handlePaymentEvent(event: PaymentEvent): AsyncResult<PaymentEventOutcome>;
   /** Verifies a provider webhook and applies its events. */
   webhook(input: WebhookInput): AsyncResult<readonly PaymentEventOutcome[]>;
-  /** Records the paid order's sale with the tax provider; retries a failed commit. */
+  /**
+   * Records the paid order's sale with the tax provider; retries a failed
+   * commit.
+   */
   commitTax(orderId: string): AsyncResult<TaxTransaction | null>;
   /** Cancels an unpaid order, releasing its stock and its open payments. */
   cancelOrder(orderId: string, reason?: string): AsyncResult<boolean>;
@@ -224,20 +356,31 @@ interface Orders<F extends object = Record<never, never>> {
     readonly id: string;
     readonly quantity: number;
   }>;
-  /** Receives the returned units; `restock` (default true) puts tracked ones back in stock. */
+  /**
+   * Receives the returned units; `restock` (default true) puts tracked ones
+   * back in stock.
+   */
   receiveReturn(returnId: string, options?: {
     readonly restock?: boolean;
     readonly locationId?: string;
   }): AsyncResult<boolean>;
   rejectReturn(returnId: string): AsyncResult<boolean>;
-  /** Refunds through the payment provider and reverses the refunded part of the tax. */
+  /**
+   * Refunds through the payment provider and reverses the refunded part of the
+   * tax.
+   */
   refund(orderId: string, input?: RefundRequest): AsyncResult<RefundOutcome>;
   /** The invoice of a paid order. */
   invoice(orderId: string): AsyncResult<Invoice<F>>;
   /** The handler for a scheduled job that runs `expireOrders`. */
   readonly job: JobHandler<unknown>;
+  /** Stations and line states, with `blocks.orders.options.kitchen`. */
+  readonly kitchen: OrderKitchen;
 }
-/** Carts, checkout, payments, fulfillments, returns, refunds and invoices over the `orders` SQL module. */
+/**
+ * Carts, checkout, payments, fulfillments, returns, refunds and invoices over
+ * the `orders` SQL module.
+ */
 export declare function createOrders<S extends StandardSchemaV1 | undefined = undefined>(options: OrdersOptions<S>): Orders<FieldsOf<S>>;
 //#endregion
 //#region src/blocks/orders/events.d.ts
@@ -253,6 +396,8 @@ type OrdersEvents = {
   readonly "fulfillment.delivered": CommerceSubjectEventData;
   readonly "return.requested": CommerceSubjectEventData;
   readonly "return.received": CommerceSubjectEventData;
+  readonly "order.prepared": CommerceSubjectEventData;
+  readonly "order.served": CommerceSubjectEventData;
 };
 /** The `orders` block's event types, for its manifest and `onBlockEvent`. */
 export declare const ordersEvents: Events<OrdersEvents>;
@@ -261,4 +406,4 @@ export declare const ordersEvents: Events<OrdersEvents>;
 /** The `orders` block's manifest (ADR 0029). */
 export declare const ordersBlock: BlockOf<"orders", typeof createOrders, OrdersEvents>;
 //#endregion
-export { type Address, type AppliedPromotion, type BlockHooks, type BlockTransport, type BlockTransportMiddleware, type CartDetails, type CartInput, type CartLine, type CartProblem, type Checkout, type CheckoutInput, FULFILLMENT_STATUSES, type Fulfillment, type FulfillmentInput, type FulfillmentStatus, type Invoice, ORDER_STATUSES, type Order, type OrderLine, type OrderMetrics, type OrderMetricsOptions, type OrderPayment, type OrderRefund, type OrderRefundStatus, type OrderReturn, type OrderStatus, type Orders, type OrdersEvents, type OrdersOptions, type PaymentEventOutcome, type PaymentRecord, type PricedCart, type QuantityLine, REFUND_STATUSES, RETURN_STATUSES, type RefundOutcome, type RefundRequest, type ReturnStatus, type RpcClient, type ShippingOption, type ShippingRateInput, type TrackingInput, dbTransport, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };
+export { type Address, type AppliedPromotion, type BlockHooks, type BlockTransport, type BlockTransportMiddleware, type CartDetails, type CartInput, type CartLine, type CartProblem, type Checkout, type CheckoutInput, FULFILLMENT_STATUSES, type Fulfillment, type FulfillmentInput, type FulfillmentStatus, type Invoice, type KitchenQueueQuery, type KitchenStation, type KitchenStationInput, type KitchenTicket, ORDER_STATUSES, type Order, type OrderBoardCard, type OrderBoardQuery, type OrderKitchen, type OrderLine, type OrderMetrics, type OrderMetricsOptions, type OrderPayment, type OrderRefund, type OrderRefundStatus, type OrderReturn, type OrderStatus, type Orders, type OrdersEvents, type OrdersOptions, type PaymentEventOutcome, type PaymentRecord, type PreparationLine, type PreparationState, type PricedCart, type QuantityLine, REFUND_STATUSES, RETURN_STATUSES, type RefundOutcome, type RefundRequest, type ReturnStatus, type RpcClient, type ShippingOption, type ShippingRateInput, type TrackingInput, dbTransport, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

package/dist/blocks/orders/index.js

@@ -1,24 +1,149 @@
-import { n as dbError } from "../../errors-BV1SKTVs.js";
-import { a as ok, r as err, t as AsyncResult } from "../../result-DIeYscA3.js";
+import { n as dbError } from "../../errors-03ysrOt4.js";
+import { a as ok, r as err, t as AsyncResult } from "../../result-B3m7xtRY.js";
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
-import { t as ordersSqlOptions } from "../../options-QKP9FFcK.js";
+import { t as ordersSqlOptions } from "../../options-BZOliZvb.js";
 import { r as defineMetric } from "../../metric-definition-BjxVn4R5.js";
-import { n as event, t as defineEvents } from "../../event-map-Dy2vKHai.js";
-import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-J7ZepTq2.js";
-import { D as recordOf, I as textOf, d as enumOrThrow, n as applyTemporal, o as blockCall, y as nullableText } from "../../block-helpers-DkVZNDrj.js";
-import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-C22vuIUd.js";
-import { n as blockFields, o as readFields } from "../../block-fields-Bv1hV855.js";
-import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
-import { d as money } from "../../money-95Rff2vT.js";
-import { n as paymentProviderOf } from "../../payments-CzjCdIcz.js";
-import { a as taxProviderOf } from "../../tax-wm9g2mD2.js";
-import { i as moneyOf, t as amountText } from "../../money-codec-C21MWw50.js";
-import { a as RETURN_STATUSES, c as quoteToJson, d as transactionToJson, i as REFUND_STATUSES, l as refundedTaxLines, n as ORDER_STATUSES, o as orderOf, s as pricedCartOf, t as FULFILLMENT_STATUSES, u as shippingOptionsOf } from "../../codecs-D-rpDifG.js";
+import { A as requiredInstant, B as dbTransport, C as optionalText, D as recordOf, F as stringsOf, H as rpcTransport, I as textOf, S as optionalInstant, U as sqlTransport, d as enumOrThrow, k as recordsOf, m as instantArg, n as applyTemporal, o as blockCall, y as nullableText } from "../../block-helpers-CiKtrb6g.js";
+import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-BymdcD0V.js";
+import { n as event, t as defineEvents } from "../../event-map-CtPFhcOp.js";
+import { n as blockFields, o as readFields } from "../../block-fields-DBSJSeaO.js";
+import { n as defineBlock } from "../../define-block-Dze77QTw.js";
+import { d as money } from "../../money-BZl985O-.js";
+import { i as moneyOf, t as amountText } from "../../money-codec-jMP0PQLZ.js";
+import { n as paymentProviderOf } from "../../payments-BtScsgPS.js";
+import { a as taxProviderOf } from "../../tax-DmOMjrYc.js";
+import { a as RETURN_STATUSES, c as quoteToJson, d as transactionToJson, i as REFUND_STATUSES, l as refundedTaxLines, n as ORDER_STATUSES, o as orderOf, s as pricedCartOf, t as FULFILLMENT_STATUSES, u as shippingOptionsOf } from "../../codecs-CQrX3ZW4.js";
+//#region src/blocks/orders/kitchen.ts
+const PREPARATION_STATES = [
+	"queued",
+	"preparing",
+	"ready",
+	"served"
+];
+/** The Realtime event every preparation change sends on `kitchenTopic`. */
+const KITCHEN_EVENT = "preparation";
+/**
+* The private Realtime channel a kitchen display and an order board join: every
+* change to a line's state or station is sent there.
+*/
+const kitchenTopic = (organizationId) => `kitchen:${organizationId}`;
+const countOf = (value) => typeof value === "number" ? value : Number(value ?? 0);
+function stationOf(value) {
+	const row = recordOf(value, "kitchen station");
+	return {
+		id: textOf(row["id"]),
+		organizationId: textOf(row["organizationId"]),
+		key: textOf(row["key"]),
+		name: textOf(row["name"]),
+		position: countOf(row["position"]),
+		isDefault: row["isDefault"] === true,
+		active: row["active"] !== false,
+		productIds: stringsOf(row["productIds"]),
+		createdAt: requiredInstant(row["createdAt"], "createdAt"),
+		updatedAt: requiredInstant(row["updatedAt"], "updatedAt")
+	};
+}
+const stateOf = (value) => enumOrThrow(value, PREPARATION_STATES, "preparation state");
+function optional(key, value) {
+	return value === void 0 ? {} : { [key]: value };
+}
+function preparationLineOf(value) {
+	const row = recordOf(value, "preparation line");
+	return {
+		lineId: textOf(row["lineId"]),
+		orderId: textOf(row["orderId"]),
+		...optional("stationId", optionalText(row["stationId"])),
+		title: textOf(row["title"]),
+		sku: textOf(row["sku"]),
+		quantity: countOf(row["quantity"]),
+		position: countOf(row["position"]),
+		state: stateOf(row["state"]),
+		...optional("note", optionalText(row["note"])),
+		queuedAt: requiredInstant(row["queuedAt"], "queuedAt"),
+		...optional("startedAt", optionalInstant(row["startedAt"])),
+		...optional("readyAt", optionalInstant(row["readyAt"])),
+		...optional("servedAt", optionalInstant(row["servedAt"]))
+	};
+}
+function ticketOf(row) {
+	return {
+		orderId: textOf(row["orderId"]),
+		number: textOf(row["number"]),
+		sentAt: requiredInstant(row["sentAt"], "sentAt"),
+		lines: recordsOf(row["lines"], "ticket lines").map(preparationLineOf)
+	};
+}
+function cardOf(row) {
+	const counts = recordOf(row["counts"] ?? {}, "board counts");
+	return {
+		orderId: textOf(row["orderId"]),
+		number: textOf(row["number"]),
+		...optional("customerId", optionalText(row["customerId"])),
+		status: textOf(row["status"]),
+		state: stateOf(row["state"]),
+		sentAt: requiredInstant(row["sentAt"], "sentAt"),
+		...optional("readyAt", optionalInstant(row["readyAt"])),
+		...optional("servedAt", optionalInstant(row["servedAt"])),
+		counts: {
+			queued: countOf(counts["queued"]),
+			preparing: countOf(counts["preparing"]),
+			ready: countOf(counts["ready"]),
+			served: countOf(counts["served"])
+		}
+	};
+}
+function stationArg(input) {
+	return {
+		...optional("key", input.key),
+		...optional("name", input.name),
+		...optional("position", input.position),
+		...optional("default", input.default),
+		...optional("active", input.active),
+		...optional("productIds", input.productIds)
+	};
+}
+/** The kitchen methods over the orders SQL functions. */
+function orderKitchen(call) {
+	return {
+		saveStation: (organizationId, input, stationId) => call("save_kitchen_station", {
+			tenant: organizationId,
+			station: stationId ?? null,
+			attrs: stationArg(input)
+		}, stationOf),
+		deleteStation: (stationId) => call("delete_kitchen_station", { station: stationId }, (value) => value === true),
+		stations: (organizationId) => call("kitchen_stations", { tenant: organizationId }, (value) => recordsOf(value, "kitchen_stations").map(stationOf)),
+		send: (orderId, notes) => call("send_order_to_kitchen", {
+			order_id: orderId,
+			notes: notes ?? null
+		}, countOf),
+		setState: (lineId, state) => call("set_line_preparation", {
+			line: lineId,
+			state
+		}, preparationLineOf),
+		bump: (orderId, state, stationId) => call("bump_kitchen_ticket", {
+			order_id: orderId,
+			station: stationId ?? null,
+			state
+		}, countOf),
+		queue: (organizationId, query = {}) => call("kitchen_queue", {
+			tenant: organizationId,
+			station: query.stationId ?? null,
+			states: query.states ?? null,
+			page_size: query.pageSize ?? null
+		}, (value) => recordsOf(value, "kitchen_queue").map(ticketOf)),
+		board: (organizationId, query = {}) => call("order_board", {
+			tenant: organizationId,
+			since: instantArg(query.since) ?? null,
+			page_size: query.pageSize ?? null
+		}, (value) => recordsOf(value, "order_board").map(cardOf))
+	};
+}
+//#endregion
 //#region src/blocks/orders/metrics.ts
 /**
 * Metric definitions over the orders table: orders placed, and revenue and
-* average order value from paid orders, in minor units of `currency`. Pass
-* them to `blocks.metrics.options.metrics` and `createMetrics`.
+* average order value from paid orders, in minor units of `currency`. Pass them
+* to `blocks.metrics.options.metrics` and `createMetrics`.
 */
 function orderMetrics(options) {
 	const shared = {
@@ -54,7 +179,10 @@ function orderMetrics(options) {
 		})
 	];
 }
-/** The events that add rows to `orderMetrics`, for `metricsSink` or `createBlocks({ metricEvents })`. */
+/**
+* The events that add rows to `orderMetrics`, for `metricsSink` or
+* `createBlocks({ metricEvents })`.
+*/
 const ORDER_METRIC_EVENTS = {
 	"order.placed": ["orders"],
 	"order.paid": ["revenue", "average_order_value"]
@@ -89,7 +217,10 @@ const PAYMENT_EVENT_STATUS = {
 function refundStatusOf(status) {
 	return status === "canceled" ? "failed" : status;
 }
-/** Carts, checkout, payments, fulfillments, returns, refunds and invoices over the `orders` SQL module. */
+/**
+* Carts, checkout, payments, fulfillments, returns, refunds and invoices over
+* the `orders` SQL module.
+*/
 function createOrders(options) {
 	applyTemporal(options);
 	const fields = blockFields(options.fields, "order fields");
@@ -129,7 +260,10 @@ function createOrders(options) {
 		}, isTrue);
 		return stored.ok ? ok(committed.data) : stored;
 	});
-	/** Commits the tax once a payment paid the order; a failure is logged and retried with `commitTax`. */
+	/**
+	* Commits the tax once a payment paid the order; a failure is logged and
+	* retried with `commitTax`.
+	*/
 	const afterPayment = async (record) => {
 		if (!record.newlyPaid) return;
 		const committed = await commitTax(record.orderId);
@@ -430,7 +564,7 @@ function createOrders(options) {
 		return ok(cancelled);
 	});
 	const expireOrders = (maxRows) => service("expire_orders", { max_rows: maxRows ?? null }, Number);
-	return withBlockHooks({
+	const orders = {
 		saveShippingRate: (organizationId, input) => call("save_shipping_rate", {
 			tenant: organizationId,
 			rate: input.id ?? null,
@@ -552,8 +686,10 @@ function createOrders(options) {
 		}))),
 		job: async (payload) => {
 			await expireOrders(maxRowsOf(payload)).orThrow();
-		}
-	}, options.hooks, {
+		},
+		kitchen: orderKitchen(call)
+	};
+	return withBlockHooks(orders, options.hooks, {
 		block: "orders",
 		...options.logger ? { logger: options.logger } : {}
 	});
@@ -571,7 +707,9 @@ const ordersEvents = defineEvents({
 	"fulfillment.shipped": event(),
 	"fulfillment.delivered": event(),
 	"return.requested": event(),
-	"return.received": event()
+	"return.received": event(),
+	"order.prepared": event(),
+	"order.served": event()
 });
 //#endregion
 //#region src/blocks/orders/manifest.ts
@@ -583,7 +721,11 @@ const ordersBlock = defineBlock({
 	events: ordersEvents,
 	create: createOrders,
 	category: "commerce",
-	recipes: ["order-detail"]
+	recipes: [
+		"order-detail",
+		"kitchen-display",
+		"order-state-board"
+	]
 });
 //#endregion
-export { FULFILLMENT_STATUSES, ORDER_METRIC_EVENTS, ORDER_STATUSES, REFUND_STATUSES, RETURN_STATUSES, createOrders, dbTransport, extendBlock, orderMetrics, ordersBlock, ordersEvents, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };
+export { FULFILLMENT_STATUSES, KITCHEN_EVENT, ORDER_METRIC_EVENTS, ORDER_STATUSES, PREPARATION_STATES, REFUND_STATUSES, RETURN_STATUSES, createOrders, dbTransport, extendBlock, kitchenTopic, orderMetrics, ordersBlock, ordersEvents, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

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

@@ -1,8 +1,8 @@
-import { W as InvitationEventData, Z as OrganizationEventData, wt as Events } from "../../events-P3raDX2E.js";
-import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DezJPPA0.js";
-import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-DcPJHztl.js";
-import { s as BlockOf } from "../../define-block-BHxLHLys.js";
-import { A as OrganizationInvitationRow, C as InvitationChanges, D as InvitationStatus, E as InvitationSent, F as SlugProblem, I as SwitchResult, L as createOrganizations, M as OrganizationMembership, N as Organizations, O as InviteRequest, P as OrganizationsOptions, S as Invitation, T as InvitationPreview, _ as OrganizationsSnapshot, a as InvitationsControllerOptions, b as createOrganizationsController, c as MembersActions, d as MembersSnapshot, f as OrganizationRowSource, g as OrganizationsControllerOptions, h as OrganizationsController, i as InvitationsController, j as OrganizationMember, k as OrganizationAttributes, l as MembersController, m as OrganizationsActions, n as InvitationDraft, o as InvitationsSnapshot, p as OrganizationSource, r as InvitationsActions, s as MemberChange, t as InvitationChange, u as MembersControllerOptions, v as createInvitationsController, w as InvitationErrorHint, x as CreateOrganizationOptions, y as createMembersController } from "../../client-BuneNd-C.js";
+import { Ct as Events, W as InvitationEventData, Z as OrganizationEventData } from "../../events-DbLjvxDX.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 } from "../../define-block-COpcS6aT.js";
+import { A as OrganizationInvitationRow, C as InvitationChanges, D as InvitationStatus, E as InvitationSent, F as SlugProblem, I as SwitchResult, L as createOrganizations, M as OrganizationMembership, N as Organizations, O as InviteRequest, P as OrganizationsOptions, S as Invitation, T as InvitationPreview, _ as OrganizationsSnapshot, a as InvitationsControllerOptions, b as createOrganizationsController, c as MembersActions, d as MembersSnapshot, f as OrganizationRowSource, g as OrganizationsControllerOptions, h as OrganizationsController, i as InvitationsController, j as OrganizationMember, k as OrganizationAttributes, l as MembersController, m as OrganizationsActions, n as InvitationDraft, o as InvitationsSnapshot, p as OrganizationSource, r as InvitationsActions, s as MemberChange, t as InvitationChange, u as MembersControllerOptions, v as createInvitationsController, w as InvitationErrorHint, x as CreateOrganizationOptions, y as createMembersController } from "../../client-B2GCMvfd.js";
 //#region src/blocks/organizations/events.d.ts
 /** The events of the `organizations` block: type to data. */
 type OrganizationsEvents = {

package/dist/blocks/organizations/index.js

@@ -1,32 +1,10 @@
 import { n as organizationsSqlOptions, t as invitationsSqlOptions } from "../../options-Bp7sgKvl.js";
-import { n as event, t as defineEvents } from "../../event-map-Dy2vKHai.js";
-import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-J7ZepTq2.js";
-import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-C22vuIUd.js";
-import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
-import { t as createOrganizations } from "../../organizations-CO2qg44D.js";
-import { n as createMembersController, r as createOrganizationsController, t as createInvitationsController } from "../../client-CcPxbHeT.js";
-//#region src/blocks/organizations/events.ts
-/** The `organizations` block's event types, for its manifest and `onBlockEvent`. */
-const organizationsEvents = defineEvents({
-	"organization.created": event(),
-	"organization.updated": event(),
-	"organization.deleted": event(),
-	"organization.member_added": event(),
-	"organization.member_removed": event(),
-	"organization.member_left": event(),
-	"organization.member_suspended": event(),
-	"organization.member_resumed": event(),
-	"organization.role_changed": event(),
-	"organization.ownership_transferred": event(),
-	"organization.switched": event(),
-	"invitation.created": event(),
-	"invitation.resent": event(),
-	"invitation.updated": event(),
-	"invitation.accepted": event(),
-	"invitation.declined": event(),
-	"invitation.revoked": event()
-});
-//#endregion
+import { B as dbTransport, H as rpcTransport, U as sqlTransport } from "../../block-helpers-CiKtrb6g.js";
+import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-BymdcD0V.js";
+import { n as defineBlock } from "../../define-block-Dze77QTw.js";
+import { t as createOrganizations } from "../../organizations-DtehZg3J.js";
+import { t as organizationsEvents } from "../../events-SqJLbb8q.js";
+import { n as createMembersController, r as createOrganizationsController, t as createInvitationsController } from "../../client-PPSwiJaK.js";
 //#region src/blocks/organizations/manifest.ts
 /** The `organizations` block's manifest (ADR 0029). */
 const organizationsBlock = defineBlock({