@happyvertical/smrt-commerce 0.55.22 → 0.55.24

package/AGENTS.md

@@ -4,7 +4,7 @@ E-commerce with Contract STI hierarchy, invoice lifecycle, payment tracking, pay
 
 ## Models
 
-- **Customer** / **Vendor**: linked to Profile via string ID (not FK). Customer has creditLimit, paymentTerms, customerType (DTC / WHOLESALE / RETAIL). Vendor has leadTimeDays, minimumOrder, and `payoutAddresses: Record<string, string>` — a flat map from payout-rail-qualified currency code (`USDC-base`, `BTC`, `USD-stripe`, ...) to destination string (EVM address, BTC address, Stripe Connect account id, IBAN). Use `getPayoutAddress(currency)` for a `Map.get`-style lookup; missing entries return `undefined` (caller decides skip-vs-error).
+- **Customer** / **Vendor**: linked to Profile via string ID (not FK). `contacts` (JSON) is written via [`savePartyContacts()`](agents/customer-vendor-ui.md#contact-rows-3501). Customer has creditLimit, paymentTerms, customerType (DTC / WHOLESALE / RETAIL). Vendor has leadTimeDays, minimumOrder, and `payoutAddresses: Record<string, string>` — a flat map from payout-rail-qualified currency code (`USDC-base`, `BTC`, `USD-stripe`, ...) to destination string (EVM address, BTC address, Stripe Connect account id, IBAN). Use `getPayoutAddress(currency)` for a `Map.get`-style lookup; missing entries return `undefined` (caller decides skip-vs-error).
 - **Contract** (STI base → Estimate, Order, Lease, Agreement, PurchaseOrder, WholesaleOrder, ProductionOrder, Cart, LicenseSale): 9 contract types sharing one table. Carries `channelId` (open-ended string — `dtc-web`, `wholesale-b2b`, `pos-store-N`, etc.) so the same model serves DTC checkout, B2B portals, and POS.
 - **WholesaleOrder**: B2B order. Conventional pairing — customer has `customerType: 'wholesale'`, NET-30/60 terms, delivered via wholesale-portal channel.
 - **ProductionOrder**: manufacturing equivalent of a PurchaseOrder — commission your factory to make finished goods. Consumes raw materials per BOM (`@happyvertical/smrt-manufacturing`) and produces SKU stock (`@happyvertical/smrt-inventory`).
@@ -13,9 +13,9 @@ E-commerce with Contract STI hierarchy, invoice lifecycle, payment tracking, pay
 - **ContractLineItem**: items on contracts.
 - **Invoice**: status machine `DRAFT → SENT → VIEWED → PARTIAL → PAID` (also OVERDUE, CANCELLED, WRITTEN_OFF). `recognizeRevenue()` creates balanced AR journal entry (DR: Accounts Receivable, CR: Revenue, CR: Tax Payable).
 - **InvoiceLineItem**: fractional-quantity line items with safe minor-unit validation/recalculation on save; editor-mode recovery and existing-column migration are documented in [invoice quantity persistence](agents/invoice-quantity.md).
-- **Payment** / **PaymentAllocation**: tracks payments against invoices. Status controlled by `Invoice.updatePaymentStatus()`, not Payment model. Carries optional backend-adapter fields for PaymentBackend-routed flows: `backendId` (rail adapter id — `base-usdc`, `btc`, `stripe`, distinct from `externalProvider` which names an accounting sync destination), `backendTxRef` (chain tx hash or gateway settlement id), `nativeAmount` / `nativeCurrency` (what actually arrived), `usdAtQuote` / `usdAtConfirmation` (drift accounting for volatile-currency rails). `Payment.usdDrift()` returns the confirmation - quote delta, or `0` when either side is unset.
-- **PaymentInstrument**: reusable saved payment method ("card on file"). Stores only provider references and non-sensitive display metadata (`providerCustomerId`, `providerPaymentMethodId`, brand / last4 / expiry), never raw card data. Use `PaymentInstrumentCollection.setDefaultForCustomer()` to change the default so the single-default-per-customer invariant is enforced; generated create/update routes cannot write `isDefault` directly.
-- **PaymentIntent**: short-lived pre-payment commitment with multi-option semantics. Locks a USD price for a fixed window (default 15 minutes) and lists one or more `PaymentOption`s describing different rails (`backendId`, `currency`, `payTo`, `nativeAmount`, optional `chain` / `memo` / `x402Capable` / `expiresAt`). First option to receive payment wins; the others are implicitly retired. State machine `awaiting_payment → paid → (issued | retired)` plus `expired` and `cancelled`. Mutate via dedicated `markPaid` / `markIssued` / `expire` / `cancel` / `retire` helpers — direct status assignment bypasses the invariant checks. Idempotency via natural key `(tenant_id, offering_ref, licensee_email, idempotency_key)` and `PaymentIntentCollection.getOrCreateByIdempotencyKey()`.
+- **Payment** / **PaymentAllocation**: tracks payments against invoices (status: see Gotchas). Carries optional backend-adapter fields for PaymentBackend-routed flows: `backendId` (rail adapter id — `base-usdc`, `btc`, `stripe`, distinct from `externalProvider` which names an accounting sync destination), `backendTxRef` (chain tx hash or gateway settlement id), `nativeAmount` / `nativeCurrency` (what actually arrived), `usdAtQuote` / `usdAtConfirmation` (drift accounting for volatile-currency rails). `Payment.usdDrift()` returns the confirmation - quote delta, or `0` when either side is unset.
+- **PaymentInstrument**: reusable saved payment method ("card on file"). Stores only provider references and non-sensitive display metadata (`providerCustomerId`, `providerPaymentMethodId`, brand / last4 / expiry), never raw card data. `isDefault` is domain-managed, not API-writable: `PaymentInstrumentCollection.setDefaultForCustomer(customerId, instrumentId)` validates the target and clears the customer's other defaults (one per customer).
+- **PaymentIntent**: short-lived pre-payment commitment with multi-option semantics. Locks a USD price for a fixed window (default 15 minutes) and lists one or more `PaymentOption`s describing different rails (`backendId`, `currency`, `payTo`, `nativeAmount`, optional `chain` / `memo` / `x402Capable` / `expiresAt`). First option to receive payment wins; the others are implicitly retired. State machine `awaiting_payment → paid → (issued | retired)` plus `expired` and `cancelled`. Mutate via dedicated `markPaid` / `markIssued` / `expire` / `cancel` / `retire` helpers — direct status assignment bypasses the invariant checks. Idempotency: see the natural-key Gotcha.
 - **Payout**: operator-to-supplier remittance. Distinct from Payment because direction, status machine, and chain semantics differ. Status machine `pending → sent → confirmed → failed` (failed is terminal but resettable via `resetFromFailed()` after fixing the underlying problem). References source `paymentId` (plain string) and destination `vendorId` (foreign key). Amount invariant `supplierNet === grossAmount - operatorFee` enforced exactly on save (integer minor units, no tolerance — #2401). `PayoutCollection.createFromPayment()` is the typical entry point; it pulls native amount / currency from the source Payment.
 - **Fulfillment** / **FulfillmentLineItem**: shipment/delivery tracking.
 
@@ -36,7 +36,7 @@ retry identity, parent corrections and supported dialects.
 
 ## Ledger Integration
 
-`@happyvertical/smrt-ledgers` is a regular dependency, loaded lazily via dynamic `import()` so the coupling stays runtime-only (no hard static import; the package graph stays a DAG — see #1582). Invoice stores `arJournalId` and `revenueJournalId` as string references. `recognizeRevenue()` creates a balanced AR journal entry; `getArJournal()` returns null when no journal has been recognized yet.
+`@happyvertical/smrt-ledgers` is a regular dependency, loaded lazily via dynamic `import()` (never a static import) so the package graph stays a DAG (#1582). Invoice stores `arJournalId` and `revenueJournalId` as string references. `recognizeRevenue()` creates a balanced AR journal entry; `getArJournal()` returns null when no journal has been recognized yet.
 
 ## Billing-period close (#3060)
 
@@ -171,16 +171,15 @@ for usage.
 - **Invoice controls payment status**: not the Payment model — use `Invoice.updatePaymentStatus()`
 - **Tax rate is external**: no tax rate field on Invoice — rate must be calculated externally
 - **Profile linking**: separate `ProfileCollection.create()` needed to fetch actual Profile object
-- **PaymentIntent natural key**: `conflictColumns: ['tenant_id', 'offering_ref', 'licensee_email', 'idempotency_key']` — a retried `create` with the same tuple upserts the existing row. Use `getOrCreateByIdempotencyKey()` to branch on `{ intent, created }`. Empty natural-key inputs (e.g. blank `idempotencyKey`) disable dedup by design.
+- **PaymentIntent natural key**: `conflictColumns: ['tenant_id', 'offering_ref', 'licensee_email', 'idempotency_key']` — a retried `create` with the same tuple upserts the existing row. Use `PaymentIntentCollection.getOrCreateByIdempotencyKey()` to branch on `{ intent, created }`. Empty natural-key inputs (e.g. blank `idempotencyKey`) disable dedup by design.
 - **Payout state-machine guards**: `markSent` requires a non-empty `backendTxRef`; `markConfirmed` only valid from `SENT`; `markFailed` only valid from `PENDING` / `SENT` (a confirmed payout can't fail — that path is a refund). `resetFromFailed()` is the dedicated escape hatch from `FAILED` back to `PENDING` after an operator fixes the underlying problem; it clears `backendTxRef` so the next attempt picks up a fresh one.
-- **PaymentInstrument defaults**: `isDefault` is domain-managed, not API-writable. Call `setDefaultForCustomer(customerId, instrumentId)` so the target is validated and the customer's other instruments are cleared.
 - **LicenseSale immutability**: rights snapshot freezes on save-with-status-ACCEPTED. The captured snapshot lives in a module-scoped `WeakMap<LicenseSale, string>` so it doesn't interact with the schema or round-trip through `_meta_data`. Drafts (status != ACCEPTED) remain mutable. To "change" an issued license: `revoke()` it, then issue a new `LicenseSale` row.
 - **Vendor.payoutAddresses normalization**: the constructor accepts either a `Record<string, string>` or a pre-serialized JSON string. `initialize()` re-normalizes after the framework's option-override pass; `save()` re-normalizes defensively against direct field assignment. Non-string values inside the input map are silently dropped to preserve the typed invariant downstream.
 
 ## Commercial UI
 
 `CustomerSelect`/`VendorSelect` are the registered selectors for Customer and
-Vendor (`selects` in `src/ui.ts`); models carry `ui.widget` hints. See
+Vendor (`selects` in `src/ui.ts`); models carry `ui.widget` / `ui.format` hints. See
 [customer/vendor UI](agents/customer-vendor-ui.md#selectors-3602).
 
 See [commercial UI composition](agents/commercial-ui.md) for native form recovery, amount compatibility and backend ownership. Package-owned guides under `agents/` ship with the package.

package/README.md

@@ -84,8 +84,8 @@ await payment.recordPayment({
 
 | Export | Description |
 |--------|------------|
-| `Customer` | Customer record with creditLimit, paymentTerms, tax exemption, addresses |
-| `Vendor` | Vendor/supplier with leadTimeDays, minimumOrderAmount, currency |
+| `Customer` | Customer record with creditLimit, paymentTerms, tax exemption, addresses, contacts |
+| `Vendor` | Vendor/supplier with leadTimeDays, minimumOrderAmount, currency, contacts |
 | `Contract` | STI base class for all commercial agreements |
 | `Estimate` | Quote or proposal sent to a customer |
 | `Order` | Customer purchase order |
@@ -550,6 +550,41 @@ native forms, recovery, amount units and consumer adoption, plus the focused
 [customer/vendor](agents/customer-vendor-ui.md) and
 [quotation](agents/quote-ui.md) contracts for selector restrictions.
 
+## Customer and vendor contacts
+
+`Customer.contacts` and `Vendor.contacts` hold the people to reach at a party
+(`PartyContact`: `id`, `name`, `label`, `email`, `phone`, `address`) as a JSON
+column; existing databases need `smrt db:migrate` for the new `contacts`
+columns. The form's contact rows are written with `savePartyContacts()`:
+
+```typescript
+import {
+  applyPartyContactIntent,
+  PartyContactValidationError,
+  readPartyContactRows,
+  savePartyContacts,
+} from '@happyvertical/smrt-commerce';
+
+const form = await request.formData();
+// Throws PartyContactPayloadError when the form's contactCount marker is absent
+// (block not rendered, or fieldNames differ), so a save never deletes by accident.
+const rows = readPartyContactRows(form); // pass the form's fieldNames if overridden
+const { contacts, handled } = applyPartyContactIntent(rows, String(form.get('intent')));
+if (handled) return { values: { ...values, contacts } }; // add/remove round trip, no save
+try {
+  await savePartyContacts(vendors, vendorId, rows, { expectedTenantId });
+} catch (error) {
+  if (error instanceof PartyContactValidationError)
+    return fail(400, { values: { ...values, contacts: rows }, errors: { contacts: toMessages(error.errors) } });
+  throw error;
+}
+```
+
+`savePartyContacts` also accepts the `FormData` itself (with `fieldNames`) and
+reads it the same way. The rows replace the party's contacts: posted ids are kept, new rows get an
+id, unposted rows are removed, blank rows are dropped. See
+[customer/vendor UI](agents/customer-vendor-ui.md#contact-rows-3501).
+
 ## Customer and vendor selectors
 
 `CustomerSelect` and `VendorSelect` from `@happyvertical/smrt-commerce/svelte`

package/agents/customer-vendor-ui.md

@@ -34,7 +34,7 @@ Import the provider-free surfaces from `@happyvertical/smrt-commerce/svelte`:
 />
 ```
 
-The caller owns action URLs, server authorization, tenancy checks, request tokens, persistence, and retry behavior. Capability props only decide whether an affordance is rendered. The components never create a Profile, Customer, Vendor, or contact relationship and never generate request tokens.
+The caller owns action URLs, server authorization, tenancy checks, request tokens, persistence, and retry behavior. Capability props only decide whether an affordance is rendered. The components never create a Profile, Customer, Vendor, or contact relationship and never generate request tokens; the server writes posted contact rows with `savePartyContacts()` ([contact rows](#contact-rows-3501)).
 
 `CustomerDisplayData.creditLimitMinor` and `VendorDisplayData.minimumOrderMinor` are integer currency minor units. Detail components convert them only for display and accept an explicit `minorUnitExponent`. Form values deliberately use retained strings such as `1250.00`; the server validates and converts those major-unit strings to the model's integer minor units.
 
@@ -42,6 +42,23 @@ The caller owns action URLs, server authorization, tenancy checks, request token
 
 Forms use the provider-free `Form`, `Input`, `Select`, `Textarea`, and `Checkbox` controls from `@happyvertical/smrt-ui/forms`. They default to native `POST` submission through `preventDefault={false}`. `transport.hiddenFields`, `transport.intentName`, and the field-name maps let an application preserve its existing payload contract. Repeatable contact rows submit repeated field names in DOM order. Add and remove controls are native submitters, so they work without JavaScript; the server returns the revised rows and retained values.
 
+`CustomerForm` and `VendorForm` accept submit hooks so a host never has to find
+the form after mount (#3501). `enhance` (`PartyFormEnhance`, action-shaped) is
+applied to the mounted native `<form>` and destroyed with it; SvelteKit's
+`enhance` from `$app/forms` fits directly, or wrap it to pass a submit callback.
+An `ssr = false` app needs it, because a plain native post answers with the
+empty shell. `onsubmit` receives the native submit event (submission stays
+native unless it calls `preventDefault()`), and the `getFormElement()` instance
+method returns the native element while mounted.
+
+```svelte
+<script lang="ts">
+  import { enhance } from '$app/forms';
+</script>
+
+<VendorForm values={form?.values ?? data.values} errors={form?.errors} transport={{ action: '?/save' }} {enhance} />
+```
+
 Directory search forms accept `hiddenFields` as a string record for caller-owned GET state such as sort direction and page size. Fields whose names equal the resolved `queryName` or `statusName` are omitted so the visible search controls remain authoritative.
 
 Customer shipping and billing addresses use the shared `CountrySelect` and
@@ -73,6 +90,13 @@ Use the `extension` snippets for application fields such as construction roles a
 
 Directory entries carry caller-owned detail links and pagination links. Detail edit links and form submit buttons appear only when their capability props allow them; the server must still authorize every request.
 
+`CustomerDirectory`, `CustomerDetail`, `VendorDirectory`, and `VendorDetail`
+render a `PageHeader` (the page `h1`, a subtitle, and the add/edit action) by
+default. A host that frames every page itself passes `headless` to render only
+the body, then renders its own heading and create/edit affordance; or passes a
+`header` snippet to replace the built-in header in place (#3501). `backHref`
+stays independent of both.
+
 Directory empty and filter behavior follows this contract:
 
 | State | Empty guidance | Native form behavior |
@@ -92,6 +116,27 @@ The registry keys are `customer-directory`, `customer-detail`, `customer-form`,
 
 The form playground previews handle save, add-contact, and remove-contact intents in memory. They deliberately return a simulated validation error on save so retained values and retry behavior can be inspected without a backend.
 
+## Contact rows (#3501)
+
+`Customer.contacts` / `Vendor.contacts` store `PartyContact` rows (JSON
+column; additive schema, run `smrt db:migrate`). The root package exports the
+server half of the form's contact payload:
+
+| Export | Contract |
+| --- | --- |
+| `readPartyContactRows(form, fieldNames?)` | Zips the repeated `contactId`, `contactName`, `contactLabel`, `contactEmail`, `contactPhone`, `contactAddress` values (or the form's `fieldNames` overrides) in DOM order into raw `PartyContactInput` rows. The editable contact block always posts a hidden `contactCount` marker with its row count; a missing marker (`reason: 'missing'`) or any disagreeing count (`'misaligned'`) throws `PartyContactPayloadError`, so zero rows mean an empty list only when the block rendered. |
+| `applyPartyContactIntent(rows, intent, intents?)` | `addContact` appends a blank row; `removeContact:<n>` (or a caller `parseRemoveIntent`) drops row `n`. `handled: true` means render the returned rows and do not save, including for a stale index. |
+| `validatePartyContactRows(rows)` | Trims, drops blank rows, and returns `errors` aligned with the submitted rows using codes `too_long` (limits in `PARTY_CONTACT_MAX_LENGTHS`, matching the inputs) and `invalid_email`. |
+| `savePartyContacts(collection, partyId, formOrRows, { fieldNames?, expectedTenantId? })` | Given the posted form, reads it with `readPartyContactRows` (marker enforced); an array is taken as rows already read that way. Loads the party with `collection.get()` (so the active tenant context scopes it) and replaces its contacts: posted ids are kept, new rows get a random id, unposted rows are removed. A posted id the party does not have is `unknown_contact` on `id`. Invalid input throws `PartyContactValidationError` (`errors`, nothing written); a missing or other-tenant party throws `PartyContactPartyNotFoundError`. |
+
+Error codes are not messages: map `PartyContactValidationError.errors` to
+localized strings for `PartyFormErrors.contacts`, and return the submitted
+rows as retained `values.contacts`. A form with custom contact `fieldNames`
+must pass the same names when reading; with mismatched names the marker is
+not found and the read fails closed instead of removing every contact. Saves are a read-modify-write of the party
+row (last writer wins). Map saved contacts to `CustomerDisplayData.contacts` /
+`VendorDisplayData.contacts` for the detail screens.
+
 ## Selectors (#3602)
 
 `CustomerSelect` and `VendorSelect` are field-sized pickers built on the shared
@@ -119,6 +164,20 @@ so the scanner can read it.
 
 Widget hints (`@field({ ui: { widget } })`, #3599) are presentation-only and
 the build rejects them on non-text fields; `currency` is a currency-code
-picker for ISO 4217 strings and is never applied to minor-unit amounts.
+picker for ISO 4217 strings and is never applied to minor-unit amounts;
+amounts take `ui: { format: 'money' }` instead (#3718).
 Behaviour tests run under jsdom: `pnpm exec vitest run --config
 vitest.selects.config.ts` (also part of `pnpm test:ui`).
+
+## Record page hints (#3718)
+
+Minor-unit amounts on Contract, Invoice, their line items, Payment,
+PaymentAllocation, `Customer.creditLimit` and `Vendor.minimumOrderAmount`
+carry `ui: { format: 'money' }` (#3718; `widget: 'currency'` stays the
+currency-code picker on the text `currency` field). Payout and Payment's
+native/USD drift amounts are not hinted: their currency is a payout rail or
+fixed USD, not the record's `currency`. The line-item FKs
+(`ContractLineItem.contractId`, `InvoiceLineItem.invoiceId`,
+`FulfillmentLineItem.fulfillmentId`) carry `role: 'items'`, so record pages
+render them as a line-items table with a totals block;
+`src/__tests__/money-hints-manifest.test.ts` pins both.

package/dist/chunks/types-zVnIjSOk.js.map

@@ -1 +1 @@
-{"version":3,"file":"types-zVnIjSOk.js","names":["CustomerStatus","CustomerType","VendorStatus","ContractType","ContractStatus","FulfillmentType","FulfillmentStatus","PaymentMethod","PaymentStatus","PaymentInstrumentStatus","PayoutStatus","PaymentIntentStatus","InvoiceStatus"],"sources":["../../src/types/index.ts"],"sourcesContent":["/**\n * Commerce package type definitions\n * @packageDocumentation\n */\n\nimport type { SmrtObjectOptions } from '@happyvertical/smrt-core';\nimport type {\n  InvoiceCalculationContext,\n  InvoiceLineDraft,\n} from '../svelte/invoices/calculations.js';\n\n// ============================================================================\n// Customer/Vendor Types\n// ============================================================================\n\nexport enum CustomerStatus {\n  ACTIVE = 'active',\n  INACTIVE = 'inactive',\n  SUSPENDED = 'suspended',\n}\n\n/**\n * Customer classification — drives channel access, pricing tier, and credit terms.\n *\n * - DTC: direct-to-consumer (end shopper). Pays via storefront checkout.\n * - WHOLESALE: B2B buyer with negotiated terms (NET-30, line sheets, etc.).\n * - RETAIL: in-store walk-in / point-of-sale customer.\n */\nexport enum CustomerType {\n  DTC = 'dtc',\n  WHOLESALE = 'wholesale',\n  RETAIL = 'retail',\n}\n\nexport enum VendorStatus {\n  ACTIVE = 'active',\n  INACTIVE = 'inactive',\n  SUSPENDED = 'suspended',\n}\n\n// ============================================================================\n// Contract Types\n// ============================================================================\n\nexport enum ContractType {\n  ESTIMATE = 'estimate',\n  ORDER = 'order',\n  LEASE = 'lease',\n  AGREEMENT = 'agreement',\n  PURCHASE_ORDER = 'purchase_order',\n  WHOLESALE_ORDER = 'wholesale_order',\n  PRODUCTION_ORDER = 'production_order',\n  CART = 'cart',\n  /**\n   * Industry-neutral licensing primitive. The `LicenseSale` STI subtype\n   * carries an immutable rights snapshot, a licensee email, optional\n   * legal-entity / jurisdiction fields, and a signed-PDF reference.\n   * Any application that sells rights for a fee (stock media,\n   * music licensing, code-asset marketplace, license keys, etc.)\n   * uses this subtype.\n   */\n  LICENSE_SALE = 'license_sale',\n}\n\nexport enum ContractStatus {\n  DRAFT = 'draft',\n  SENT = 'sent',\n  ACCEPTED = 'accepted',\n  DECLINED = 'declined',\n  COMPLETED = 'completed',\n  CANCELLED = 'cancelled',\n}\n\n// ============================================================================\n// Fulfillment Types\n// ============================================================================\n\nexport enum FulfillmentType {\n  SHIPMENT = 'shipment',\n  DELIVERY = 'delivery',\n  PICKUP = 'pickup',\n  DIGITAL = 'digital',\n  SERVICE = 'service',\n}\n\nexport enum FulfillmentStatus {\n  PENDING = 'pending',\n  PROCESSING = 'processing',\n  SHIPPED = 'shipped',\n  DELIVERED = 'delivered',\n  CANCELLED = 'cancelled',\n}\n\n// ============================================================================\n// Payment Types\n// ============================================================================\n\nexport enum PaymentMethod {\n  CASH = 'cash',\n  CHECK = 'check',\n  CREDIT_CARD = 'credit_card',\n  BANK_TRANSFER = 'bank_transfer',\n  CRYPTO = 'crypto',\n  OTHER = 'other',\n}\n\nexport enum PaymentStatus {\n  PENDING = 'pending',\n  COMPLETED = 'completed',\n  FAILED = 'failed',\n  REFUNDED = 'refunded',\n  CANCELLED = 'cancelled',\n}\n\n/**\n * Lifecycle status for a saved {@link PaymentInstrument} (card on file).\n * `active` while chargeable, `expired` once the card lapses, `removed` when the\n * customer detaches it.\n */\nexport enum PaymentInstrumentStatus {\n  ACTIVE = 'active',\n  EXPIRED = 'expired',\n  REMOVED = 'removed',\n}\n\n// ============================================================================\n// Payout Types\n// ============================================================================\n\n/**\n * Status machine for {@link Payout}.\n *\n * `pending → sent → confirmed → failed`. `failed` is terminal but the\n * model exposes a dedicated `resetFromFailed()` so an operator can\n * deliberately requeue a payout after fixing the underlying problem;\n * the reset moves the row back to `pending` and clears the failure\n * metadata.\n *\n * Skipping intermediate states is rejected — a `pending` payout cannot\n * jump straight to `confirmed`, and a `sent` payout cannot regress to\n * `pending` without going through `resetFromFailed()` first.\n */\nexport enum PayoutStatus {\n  PENDING = 'pending',\n  SENT = 'sent',\n  CONFIRMED = 'confirmed',\n  FAILED = 'failed',\n}\n\n// ============================================================================\n// PaymentIntent Types\n// ============================================================================\n\n/**\n * Status machine for {@link PaymentIntent}.\n *\n * `awaiting_payment → paid → (issued | retired)`, with `expired` and\n * `cancelled` as alternate terminal states reachable from\n * `awaiting_payment`.\n *\n * - `AWAITING_PAYMENT` — open quote, accepting any of the listed\n *   payment options.\n * - `PAID` — one option was satisfied by an incoming payment. The\n *   other options are implicitly retired; later inbound funds to a\n *   retired option must be flagged for refund by the consumer.\n * - `ISSUED` — downstream rights / contract / fulfillment have been\n *   created and linked. Terminal happy-path state.\n * - `RETIRED` — paid but the satisfaction was reversed (refund,\n *   chargeback, etc.). Terminal.\n * - `EXPIRED` — the USD-price-lock window passed without payment.\n *   Terminal.\n * - `CANCELLED` — the buyer or the system explicitly cancelled the\n *   intent before it was paid. Terminal.\n */\nexport enum PaymentIntentStatus {\n  AWAITING_PAYMENT = 'awaiting_payment',\n  PAID = 'paid',\n  ISSUED = 'issued',\n  RETIRED = 'retired',\n  EXPIRED = 'expired',\n  CANCELLED = 'cancelled',\n}\n\n/**\n * One way for a {@link PaymentIntent} to be satisfied. The intent lists\n * an array of these; satisfying any one of them transitions the intent\n * to `PAID` and implicitly retires the rest.\n *\n * Industry-neutral: a marketplace that accepts USDC-on-Base and BTC\n * lists two options; a SaaS billing flow that accepts Stripe and\n * PayPal lists two; a kiosk that accepts only one rail lists one.\n */\nexport interface PaymentOption {\n  /**\n   * Stable id of the `PaymentBackend` adapter that fulfills this\n   * option — must match a `backendId` the consumer's payment-routing\n   * layer recognises. Examples: `base-usdc`, `solana-usdc`, `btc`,\n   * `stripe`, `paypal`.\n   */\n  backendId: string;\n  /**\n   * Payout-rail-qualified currency code, e.g. `USDC-base`, `BTC`,\n   * `USD-stripe`. The same convention used by\n   * `Vendor.payoutAddresses` and `Payment.nativeCurrency`.\n   */\n  currency: string;\n  /**\n   * Optional chain identifier for blockchain-backed options (`base`,\n   * `ethereum`, `solana`, ...). Pure-fiat options leave this empty.\n   */\n  chain?: string;\n  /**\n   * Destination address / account id the buyer should send funds to\n   * for this option (EVM address, BTC address, Stripe payment-intent\n   * id, etc.).\n   */\n  payTo: string;\n  /**\n   * Amount denominated in `currency`. Stored at decimal precision —\n   * a USDC option might be `199.0`, a BTC option `0.00713`.\n   */\n  nativeAmount: number;\n  /**\n   * Optional on-chain memo / payment reference (Solana memo, BTC OP_RETURN\n   * tag, Stripe metadata key). Some backends use this to disambiguate\n   * which intent an inbound payment satisfies.\n   */\n  memo?: string;\n  /**\n   * Whether this option supports the x402 HTTP-402 payment-required\n   * flow. Consumers that build agent-driven flows use this flag to\n   * filter the offered options.\n   */\n  x402Capable?: boolean;\n  /**\n   * Optional per-option expiry — when a single rail's quote becomes\n   * stale earlier than the intent-wide price-lock window (e.g. a\n   * volatile-currency option that re-quotes more aggressively). ISO\n   * 8601 string. Empty / missing means \"inherit the intent's\n   * `priceLockExpiresAt`\".\n   */\n  expiresAt?: string;\n}\n\n// ============================================================================\n// Invoice Types\n// ============================================================================\n\nexport enum InvoiceStatus {\n  DRAFT = 'draft',\n  SENT = 'sent',\n  VIEWED = 'viewed',\n  PARTIAL = 'partial',\n  PAID = 'paid',\n  OVERDUE = 'overdue',\n  CANCELLED = 'cancelled',\n  WRITTEN_OFF = 'written_off',\n}\n\n// ============================================================================\n// Common Interfaces\n// ============================================================================\n\n/**\n * Address structure used for billing and shipping\n */\nexport interface Address {\n  street1?: string;\n  street2?: string;\n  city?: string;\n  state?: string;\n  postalCode?: string;\n  country?: string;\n}\n\n/**\n * Options for recording a payment with ledger integration\n */\nexport interface RecordPaymentOptions {\n  /** The ledger to record the journal entry in */\n  ledgerId: string;\n  /** Account ID for receivables (credit side) */\n  receivablesAccountId: string;\n  /** Account ID for cash/bank (debit side) */\n  cashAccountId: string;\n}\n\n/**\n * Options for recognizing revenue on an invoice\n */\nexport interface RecognizeRevenueOptions {\n  /** Account ID for accounts receivable (debit side) */\n  arAccountId: string;\n  /** Account ID for revenue (credit side) */\n  revenueAccountId: string;\n  /** Account ID for tax payable (credit side, optional) */\n  taxAccountId?: string;\n}\n\n// ============================================================================\n// Accounting-provider sync shapes\n// ============================================================================\n\n/**\n * A single line item in the format expected by `@happyvertical/accounting`\n * providers (QBO, Stripe, …). Mirrors the object built by\n * {@link InvoiceLineItem.toAccountingLineItem}. The SDK isn't a dependency of\n * this package, so the shape is declared locally rather than imported.\n */\nexport interface AccountingLineItemInput {\n  description: string;\n  sku?: string;\n  quantity: number;\n  unitPrice: number;\n  discount?: number;\n  taxRate?: number;\n  amount: number;\n  periodStart?: Date;\n  periodEnd?: Date;\n}\n\n/**\n * An invoice in the format expected by `@happyvertical/accounting` providers.\n * Mirrors the object built by {@link Invoice.toAccountingInput}; money is in\n * currency **major** units, as the SDK expects.\n */\nexport interface AccountingInvoiceInput {\n  id: string;\n  externalId?: string;\n  invoiceNumber: string;\n  customerId: string;\n  customerExternalId?: string;\n  issueDate: Date;\n  dueDate: Date;\n  lineItems: AccountingLineItemInput[];\n  subtotal: number;\n  taxAmount: number;\n  totalAmount: number;\n  currency: string;\n  reference?: string;\n  memo?: string;\n}\n\n// ============================================================================\n// Model constructor option interfaces\n//\n// Each model's `constructor(options)` accepts a partial bag of its own fields.\n// Declaring a dedicated `XxxOptions extends SmrtObjectOptions` interface keeps\n// the constructors strongly typed (no `any`) while still allowing the\n// framework's base options (db, ai, fs, _className, …) through.\n// ============================================================================\n\n/**\n * Constructor options for {@link Customer}.\n */\nexport interface CustomerOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  profileId?: string;\n  creditLimit?: number;\n  paymentTerms?: string;\n  taxExempt?: boolean;\n  taxId?: string;\n  defaultShippingAddress?: Address;\n  defaultBillingAddress?: Address;\n  status?: CustomerStatus;\n  customerType?: CustomerType | null;\n  notes?: string;\n}\n\n/**\n * Constructor options for {@link Vendor}.\n */\nexport interface VendorOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  profileId?: string;\n  leadTimeDays?: number;\n  minimumOrderAmount?: number;\n  paymentTerms?: string;\n  currency?: string;\n  defaultContactEmail?: string;\n  defaultContactPhone?: string;\n  status?: VendorStatus;\n  notes?: string;\n  payoutAddresses?: Record<string, string> | string | null;\n}\n\n/**\n * Constructor options for {@link Contract} and its STI subtypes.\n */\nexport interface ContractOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  contractType?: ContractType;\n  status?: ContractStatus;\n  customerId?: string | null;\n  vendorId?: string | null;\n  subtotal?: number;\n  taxAmount?: number;\n  totalAmount?: number;\n  currency?: string;\n  issueDate?: Date;\n  dueDate?: Date | null;\n  expiryDate?: Date | null;\n  reference?: string;\n  notes?: string;\n  terms?: string;\n  channelId?: string;\n}\n\n/** Purchase-order header options stored in the existing STI metadata. */\nexport interface PurchaseOrderOptions extends ContractOptions {\n  /** Expected delivery calendar date (YYYY-MM-DD); empty means unspecified. */\n  expectedDate?: string;\n  /** Delivery address/instructions snapshot. */\n  shipTo?: string;\n}\n\n/**\n * Constructor options for {@link LicenseSale} (Contract STI subtype). Extends\n * {@link ContractOptions} with the licensing-specific meta fields.\n */\nexport interface LicenseSaleOptions extends ContractOptions {\n  skuId?: string;\n  paymentId?: string;\n  licenseeEmail?: string;\n  licenseeLegalEntity?: string;\n  licenseeJurisdiction?: string;\n  rightsMedium?: string;\n  rightsDistributionScope?: string;\n  rightsExclusivity?: string;\n  rightsDuration?: string;\n  rightsTerritory?: string;\n  rightsSublicensing?: boolean;\n  rightsDerivatives?: boolean;\n  pdfUrl?: string;\n  pdfHash?: string;\n  onChainHashRegistryRef?: string;\n}\n\n/**\n * Constructor options for {@link ContractLineItem}.\n */\nexport interface ContractLineItemOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  contractId?: string;\n  description?: string;\n  quantity?: number;\n  unitPrice?: number;\n  discount?: number;\n  taxRate?: number;\n  amount?: number;\n  productId?: string;\n  sku?: string;\n  startDate?: Date | null;\n  endDate?: Date | null;\n  billingPeriod?: string;\n  sortOrder?: number;\n}\n\n/**\n * How the provider collects an invoice (#3190): `charge_automatically`\n * charges the payer's saved card; `send_invoice` asks the payer to pay. Empty\n * for an invoice never pushed to a provider, or pushed before it was recorded.\n */\nexport type InvoiceCollectionMethod =\n  | ''\n  | 'send_invoice'\n  | 'charge_automatically';\n\n/**\n * Constructor options for {@link Invoice}.\n */\nexport interface InvoiceOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  customerId?: string;\n  contractId?: string;\n  invoiceNumber?: string;\n  reference?: string;\n  issueDate?: Date;\n  dueDate?: Date;\n  paidDate?: Date | null;\n  subtotal?: number;\n  taxAmount?: number;\n  providerTaxAmount?: number;\n  totalAmount?: number;\n  amountPaid?: number;\n  currency?: string;\n  status?: InvoiceStatus;\n  arJournalId?: string;\n  revenueJournalId?: string;\n  externalId?: string;\n  customerExternalId?: string;\n  externalProvider?: string;\n  syncedAt?: Date | null;\n  collectionMethod?: InvoiceCollectionMethod;\n  sentAt?: Date | null;\n  viewedAt?: Date | null;\n  remindersSent?: number;\n  lastReminderAt?: Date | null;\n  notes?: string;\n  customerNotes?: string;\n  terms?: string;\n}\n\n/** Retained editing modes, validated against resolved model fields before reuse. */\nexport interface InvoiceLineEditorState {\n  /** Lossless editor draft; never authoritative for ordinary model saves. */\n  draft: InvoiceLineDraft;\n  /** Context used to resolve that draft; caller authority must still match on reload. */\n  context: InvoiceCalculationContext;\n}\n\n/** Constructor options for {@link InvoiceLineItem}. */\nexport interface InvoiceLineItemOptions extends SmrtObjectOptions {\n  /** Optional retained editor modes and their original calculation context. */\n  invoiceEditorState?: InvoiceLineEditorState | null;\n  /** Serialized editor state loaded from persistence; malformed JSON is ignored. */\n  invoiceEditorStateJson?: string;\n  tenantId?: string | null;\n  invoiceId?: string;\n  description?: string;\n  sku?: string;\n  quantity?: number;\n  unitPrice?: number;\n  discount?: number;\n  taxRate?: number;\n  amount?: number;\n  sourceType?: string;\n  sourceId?: string;\n  periodStart?: Date | null;\n  periodEnd?: Date | null;\n  revenueAccountId?: string;\n  sortOrder?: number;\n}\n\n/**\n * Constructor options for {@link Fulfillment}.\n */\nexport interface FulfillmentOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  contractId?: string;\n  fulfillmentType?: FulfillmentType;\n  status?: FulfillmentStatus;\n  trackingNumber?: string;\n  carrier?: string;\n  shippingAddress?: Address;\n  shippedAt?: Date | null;\n  deliveredAt?: Date | null;\n  estimatedDelivery?: Date | null;\n  notes?: string;\n}\n\n/**\n * Constructor options for {@link FulfillmentLineItem}.\n */\nexport interface FulfillmentLineItemOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  fulfillmentId?: string;\n  contractLineItemId?: string;\n  quantityFulfilled?: number;\n  notes?: string;\n}\n\n/**\n * Constructor options for {@link Payment}.\n */\nexport interface PaymentOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  contractId?: string | null;\n  customerId?: string | null;\n  amount?: number;\n  currency?: string;\n  method?: PaymentMethod;\n  status?: PaymentStatus;\n  transactionId?: string;\n  reference?: string;\n  journalId?: string;\n  paidAt?: Date | null;\n  notes?: string;\n  externalId?: string;\n  externalProvider?: string;\n  syncedAt?: Date | null;\n  backendId?: string;\n  backendTxRef?: string;\n  nativeAmount?: number;\n  nativeCurrency?: string;\n  usdAtQuote?: number;\n  usdAtConfirmation?: number;\n}\n\n/**\n * Constructor options for {@link PaymentInstrument}.\n */\nexport interface PaymentInstrumentOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  customerId?: string;\n  backendId?: string;\n  providerCustomerId?: string;\n  providerPaymentMethodId?: string;\n  type?: string;\n  brand?: string;\n  last4?: string;\n  expMonth?: number;\n  expYear?: number;\n  isDefault?: boolean;\n  status?: PaymentInstrumentStatus;\n}\n\n/**\n * Constructor options for {@link PaymentAllocation}.\n */\nexport interface PaymentAllocationOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  paymentId?: string;\n  invoiceId?: string;\n  amount?: number;\n  allocatedAt?: Date;\n  allocatedBy?: string;\n  notes?: string;\n}\n\n/**\n * Constructor options for {@link PaymentIntent}.\n */\nexport interface PaymentIntentOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  skuId?: string;\n  offeringRef?: string;\n  licenseeEmail?: string;\n  customerId?: string;\n  paymentOptions?: PaymentOption[] | string;\n  usdPriceLocked?: number;\n  priceLockWindowMs?: number;\n  priceLockExpiresAt?: Date | number | string | null;\n  status?: PaymentIntentStatus;\n  idempotencyKey?: string;\n  paidOptionBackendId?: string;\n  paymentId?: string;\n  paidAt?: Date | number | string | null;\n  issuedAt?: Date | number | string | null;\n  expiredAt?: Date | number | string | null;\n  cancelledAt?: Date | number | string | null;\n  retiredAt?: Date | number | string | null;\n  notes?: string;\n}\n\n/**\n * Constructor options for {@link Payout}.\n */\nexport interface PayoutOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  paymentId?: string;\n  vendorId?: string;\n  grossAmount?: number;\n  operatorFee?: number;\n  supplierNet?: number;\n  currency?: string;\n  backendId?: string;\n  backendTxRef?: string;\n  status?: PayoutStatus;\n  sentAt?: Date | number | string | null;\n  confirmedAt?: Date | number | string | null;\n  failedAt?: Date | number | string | null;\n  failureReason?: string;\n  notes?: string;\n}\n"],"mappings":"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"}
+{"version":3,"file":"types-zVnIjSOk.js","names":["CustomerStatus","CustomerType","VendorStatus","ContractType","ContractStatus","FulfillmentType","FulfillmentStatus","PaymentMethod","PaymentStatus","PaymentInstrumentStatus","PayoutStatus","PaymentIntentStatus","InvoiceStatus"],"sources":["../../src/types/index.ts"],"sourcesContent":["/**\n * Commerce package type definitions\n * @packageDocumentation\n */\n\nimport type { SmrtObjectOptions } from '@happyvertical/smrt-core';\nimport type {\n  InvoiceCalculationContext,\n  InvoiceLineDraft,\n} from '../svelte/invoices/calculations.js';\n\n// ============================================================================\n// Customer/Vendor Types\n// ============================================================================\n\nexport enum CustomerStatus {\n  ACTIVE = 'active',\n  INACTIVE = 'inactive',\n  SUSPENDED = 'suspended',\n}\n\n/**\n * Customer classification — drives channel access, pricing tier, and credit terms.\n *\n * - DTC: direct-to-consumer (end shopper). Pays via storefront checkout.\n * - WHOLESALE: B2B buyer with negotiated terms (NET-30, line sheets, etc.).\n * - RETAIL: in-store walk-in / point-of-sale customer.\n */\nexport enum CustomerType {\n  DTC = 'dtc',\n  WHOLESALE = 'wholesale',\n  RETAIL = 'retail',\n}\n\nexport enum VendorStatus {\n  ACTIVE = 'active',\n  INACTIVE = 'inactive',\n  SUSPENDED = 'suspended',\n}\n\n// ============================================================================\n// Contract Types\n// ============================================================================\n\nexport enum ContractType {\n  ESTIMATE = 'estimate',\n  ORDER = 'order',\n  LEASE = 'lease',\n  AGREEMENT = 'agreement',\n  PURCHASE_ORDER = 'purchase_order',\n  WHOLESALE_ORDER = 'wholesale_order',\n  PRODUCTION_ORDER = 'production_order',\n  CART = 'cart',\n  /**\n   * Industry-neutral licensing primitive. The `LicenseSale` STI subtype\n   * carries an immutable rights snapshot, a licensee email, optional\n   * legal-entity / jurisdiction fields, and a signed-PDF reference.\n   * Any application that sells rights for a fee (stock media,\n   * music licensing, code-asset marketplace, license keys, etc.)\n   * uses this subtype.\n   */\n  LICENSE_SALE = 'license_sale',\n}\n\nexport enum ContractStatus {\n  DRAFT = 'draft',\n  SENT = 'sent',\n  ACCEPTED = 'accepted',\n  DECLINED = 'declined',\n  COMPLETED = 'completed',\n  CANCELLED = 'cancelled',\n}\n\n// ============================================================================\n// Fulfillment Types\n// ============================================================================\n\nexport enum FulfillmentType {\n  SHIPMENT = 'shipment',\n  DELIVERY = 'delivery',\n  PICKUP = 'pickup',\n  DIGITAL = 'digital',\n  SERVICE = 'service',\n}\n\nexport enum FulfillmentStatus {\n  PENDING = 'pending',\n  PROCESSING = 'processing',\n  SHIPPED = 'shipped',\n  DELIVERED = 'delivered',\n  CANCELLED = 'cancelled',\n}\n\n// ============================================================================\n// Payment Types\n// ============================================================================\n\nexport enum PaymentMethod {\n  CASH = 'cash',\n  CHECK = 'check',\n  CREDIT_CARD = 'credit_card',\n  BANK_TRANSFER = 'bank_transfer',\n  CRYPTO = 'crypto',\n  OTHER = 'other',\n}\n\nexport enum PaymentStatus {\n  PENDING = 'pending',\n  COMPLETED = 'completed',\n  FAILED = 'failed',\n  REFUNDED = 'refunded',\n  CANCELLED = 'cancelled',\n}\n\n/**\n * Lifecycle status for a saved {@link PaymentInstrument} (card on file).\n * `active` while chargeable, `expired` once the card lapses, `removed` when the\n * customer detaches it.\n */\nexport enum PaymentInstrumentStatus {\n  ACTIVE = 'active',\n  EXPIRED = 'expired',\n  REMOVED = 'removed',\n}\n\n// ============================================================================\n// Payout Types\n// ============================================================================\n\n/**\n * Status machine for {@link Payout}.\n *\n * `pending → sent → confirmed → failed`. `failed` is terminal but the\n * model exposes a dedicated `resetFromFailed()` so an operator can\n * deliberately requeue a payout after fixing the underlying problem;\n * the reset moves the row back to `pending` and clears the failure\n * metadata.\n *\n * Skipping intermediate states is rejected — a `pending` payout cannot\n * jump straight to `confirmed`, and a `sent` payout cannot regress to\n * `pending` without going through `resetFromFailed()` first.\n */\nexport enum PayoutStatus {\n  PENDING = 'pending',\n  SENT = 'sent',\n  CONFIRMED = 'confirmed',\n  FAILED = 'failed',\n}\n\n// ============================================================================\n// PaymentIntent Types\n// ============================================================================\n\n/**\n * Status machine for {@link PaymentIntent}.\n *\n * `awaiting_payment → paid → (issued | retired)`, with `expired` and\n * `cancelled` as alternate terminal states reachable from\n * `awaiting_payment`.\n *\n * - `AWAITING_PAYMENT` — open quote, accepting any of the listed\n *   payment options.\n * - `PAID` — one option was satisfied by an incoming payment. The\n *   other options are implicitly retired; later inbound funds to a\n *   retired option must be flagged for refund by the consumer.\n * - `ISSUED` — downstream rights / contract / fulfillment have been\n *   created and linked. Terminal happy-path state.\n * - `RETIRED` — paid but the satisfaction was reversed (refund,\n *   chargeback, etc.). Terminal.\n * - `EXPIRED` — the USD-price-lock window passed without payment.\n *   Terminal.\n * - `CANCELLED` — the buyer or the system explicitly cancelled the\n *   intent before it was paid. Terminal.\n */\nexport enum PaymentIntentStatus {\n  AWAITING_PAYMENT = 'awaiting_payment',\n  PAID = 'paid',\n  ISSUED = 'issued',\n  RETIRED = 'retired',\n  EXPIRED = 'expired',\n  CANCELLED = 'cancelled',\n}\n\n/**\n * One way for a {@link PaymentIntent} to be satisfied. The intent lists\n * an array of these; satisfying any one of them transitions the intent\n * to `PAID` and implicitly retires the rest.\n *\n * Industry-neutral: a marketplace that accepts USDC-on-Base and BTC\n * lists two options; a SaaS billing flow that accepts Stripe and\n * PayPal lists two; a kiosk that accepts only one rail lists one.\n */\nexport interface PaymentOption {\n  /**\n   * Stable id of the `PaymentBackend` adapter that fulfills this\n   * option — must match a `backendId` the consumer's payment-routing\n   * layer recognises. Examples: `base-usdc`, `solana-usdc`, `btc`,\n   * `stripe`, `paypal`.\n   */\n  backendId: string;\n  /**\n   * Payout-rail-qualified currency code, e.g. `USDC-base`, `BTC`,\n   * `USD-stripe`. The same convention used by\n   * `Vendor.payoutAddresses` and `Payment.nativeCurrency`.\n   */\n  currency: string;\n  /**\n   * Optional chain identifier for blockchain-backed options (`base`,\n   * `ethereum`, `solana`, ...). Pure-fiat options leave this empty.\n   */\n  chain?: string;\n  /**\n   * Destination address / account id the buyer should send funds to\n   * for this option (EVM address, BTC address, Stripe payment-intent\n   * id, etc.).\n   */\n  payTo: string;\n  /**\n   * Amount denominated in `currency`. Stored at decimal precision —\n   * a USDC option might be `199.0`, a BTC option `0.00713`.\n   */\n  nativeAmount: number;\n  /**\n   * Optional on-chain memo / payment reference (Solana memo, BTC OP_RETURN\n   * tag, Stripe metadata key). Some backends use this to disambiguate\n   * which intent an inbound payment satisfies.\n   */\n  memo?: string;\n  /**\n   * Whether this option supports the x402 HTTP-402 payment-required\n   * flow. Consumers that build agent-driven flows use this flag to\n   * filter the offered options.\n   */\n  x402Capable?: boolean;\n  /**\n   * Optional per-option expiry — when a single rail's quote becomes\n   * stale earlier than the intent-wide price-lock window (e.g. a\n   * volatile-currency option that re-quotes more aggressively). ISO\n   * 8601 string. Empty / missing means \"inherit the intent's\n   * `priceLockExpiresAt`\".\n   */\n  expiresAt?: string;\n}\n\n// ============================================================================\n// Invoice Types\n// ============================================================================\n\nexport enum InvoiceStatus {\n  DRAFT = 'draft',\n  SENT = 'sent',\n  VIEWED = 'viewed',\n  PARTIAL = 'partial',\n  PAID = 'paid',\n  OVERDUE = 'overdue',\n  CANCELLED = 'cancelled',\n  WRITTEN_OFF = 'written_off',\n}\n\n// ============================================================================\n// Common Interfaces\n// ============================================================================\n\n/**\n * Address structure used for billing and shipping\n */\nexport interface Address {\n  street1?: string;\n  street2?: string;\n  city?: string;\n  state?: string;\n  postalCode?: string;\n  country?: string;\n}\n\n/**\n * A person to reach at a customer or vendor, stored on the party row\n * (`Customer.contacts` / `Vendor.contacts`, #3501). Every field is plain\n * text; `id` is a stable random identifier assigned when the row is first\n * saved. Write rows through `savePartyContacts()`.\n */\nexport interface PartyContact {\n  id: string;\n  name: string;\n  /** Role or relationship, for example \"Accounts payable\". */\n  label: string;\n  email: string;\n  phone: string;\n  address: string;\n}\n\n/**\n * Options for recording a payment with ledger integration\n */\nexport interface RecordPaymentOptions {\n  /** The ledger to record the journal entry in */\n  ledgerId: string;\n  /** Account ID for receivables (credit side) */\n  receivablesAccountId: string;\n  /** Account ID for cash/bank (debit side) */\n  cashAccountId: string;\n}\n\n/**\n * Options for recognizing revenue on an invoice\n */\nexport interface RecognizeRevenueOptions {\n  /** Account ID for accounts receivable (debit side) */\n  arAccountId: string;\n  /** Account ID for revenue (credit side) */\n  revenueAccountId: string;\n  /** Account ID for tax payable (credit side, optional) */\n  taxAccountId?: string;\n}\n\n// ============================================================================\n// Accounting-provider sync shapes\n// ============================================================================\n\n/**\n * A single line item in the format expected by `@happyvertical/accounting`\n * providers (QBO, Stripe, …). Mirrors the object built by\n * {@link InvoiceLineItem.toAccountingLineItem}. The SDK isn't a dependency of\n * this package, so the shape is declared locally rather than imported.\n */\nexport interface AccountingLineItemInput {\n  description: string;\n  sku?: string;\n  quantity: number;\n  unitPrice: number;\n  discount?: number;\n  taxRate?: number;\n  amount: number;\n  periodStart?: Date;\n  periodEnd?: Date;\n}\n\n/**\n * An invoice in the format expected by `@happyvertical/accounting` providers.\n * Mirrors the object built by {@link Invoice.toAccountingInput}; money is in\n * currency **major** units, as the SDK expects.\n */\nexport interface AccountingInvoiceInput {\n  id: string;\n  externalId?: string;\n  invoiceNumber: string;\n  customerId: string;\n  customerExternalId?: string;\n  issueDate: Date;\n  dueDate: Date;\n  lineItems: AccountingLineItemInput[];\n  subtotal: number;\n  taxAmount: number;\n  totalAmount: number;\n  currency: string;\n  reference?: string;\n  memo?: string;\n}\n\n// ============================================================================\n// Model constructor option interfaces\n//\n// Each model's `constructor(options)` accepts a partial bag of its own fields.\n// Declaring a dedicated `XxxOptions extends SmrtObjectOptions` interface keeps\n// the constructors strongly typed (no `any`) while still allowing the\n// framework's base options (db, ai, fs, _className, …) through.\n// ============================================================================\n\n/**\n * Constructor options for {@link Customer}.\n */\nexport interface CustomerOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  profileId?: string;\n  creditLimit?: number;\n  paymentTerms?: string;\n  taxExempt?: boolean;\n  taxId?: string;\n  defaultShippingAddress?: Address;\n  defaultBillingAddress?: Address;\n  status?: CustomerStatus;\n  customerType?: CustomerType | null;\n  notes?: string;\n  contacts?: PartyContact[] | string | null;\n}\n\n/**\n * Constructor options for {@link Vendor}.\n */\nexport interface VendorOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  profileId?: string;\n  leadTimeDays?: number;\n  minimumOrderAmount?: number;\n  paymentTerms?: string;\n  currency?: string;\n  defaultContactEmail?: string;\n  defaultContactPhone?: string;\n  status?: VendorStatus;\n  notes?: string;\n  payoutAddresses?: Record<string, string> | string | null;\n  contacts?: PartyContact[] | string | null;\n}\n\n/**\n * Constructor options for {@link Contract} and its STI subtypes.\n */\nexport interface ContractOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  contractType?: ContractType;\n  status?: ContractStatus;\n  customerId?: string | null;\n  vendorId?: string | null;\n  subtotal?: number;\n  taxAmount?: number;\n  totalAmount?: number;\n  currency?: string;\n  issueDate?: Date;\n  dueDate?: Date | null;\n  expiryDate?: Date | null;\n  reference?: string;\n  notes?: string;\n  terms?: string;\n  channelId?: string;\n}\n\n/** Purchase-order header options stored in the existing STI metadata. */\nexport interface PurchaseOrderOptions extends ContractOptions {\n  /** Expected delivery calendar date (YYYY-MM-DD); empty means unspecified. */\n  expectedDate?: string;\n  /** Delivery address/instructions snapshot. */\n  shipTo?: string;\n}\n\n/**\n * Constructor options for {@link LicenseSale} (Contract STI subtype). Extends\n * {@link ContractOptions} with the licensing-specific meta fields.\n */\nexport interface LicenseSaleOptions extends ContractOptions {\n  skuId?: string;\n  paymentId?: string;\n  licenseeEmail?: string;\n  licenseeLegalEntity?: string;\n  licenseeJurisdiction?: string;\n  rightsMedium?: string;\n  rightsDistributionScope?: string;\n  rightsExclusivity?: string;\n  rightsDuration?: string;\n  rightsTerritory?: string;\n  rightsSublicensing?: boolean;\n  rightsDerivatives?: boolean;\n  pdfUrl?: string;\n  pdfHash?: string;\n  onChainHashRegistryRef?: string;\n}\n\n/**\n * Constructor options for {@link ContractLineItem}.\n */\nexport interface ContractLineItemOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  contractId?: string;\n  description?: string;\n  quantity?: number;\n  unitPrice?: number;\n  discount?: number;\n  taxRate?: number;\n  amount?: number;\n  productId?: string;\n  sku?: string;\n  startDate?: Date | null;\n  endDate?: Date | null;\n  billingPeriod?: string;\n  sortOrder?: number;\n}\n\n/**\n * How the provider collects an invoice (#3190): `charge_automatically`\n * charges the payer's saved card; `send_invoice` asks the payer to pay. Empty\n * for an invoice never pushed to a provider, or pushed before it was recorded.\n */\nexport type InvoiceCollectionMethod =\n  | ''\n  | 'send_invoice'\n  | 'charge_automatically';\n\n/**\n * Constructor options for {@link Invoice}.\n */\nexport interface InvoiceOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  customerId?: string;\n  contractId?: string;\n  invoiceNumber?: string;\n  reference?: string;\n  issueDate?: Date;\n  dueDate?: Date;\n  paidDate?: Date | null;\n  subtotal?: number;\n  taxAmount?: number;\n  providerTaxAmount?: number;\n  totalAmount?: number;\n  amountPaid?: number;\n  currency?: string;\n  status?: InvoiceStatus;\n  arJournalId?: string;\n  revenueJournalId?: string;\n  externalId?: string;\n  customerExternalId?: string;\n  externalProvider?: string;\n  syncedAt?: Date | null;\n  collectionMethod?: InvoiceCollectionMethod;\n  sentAt?: Date | null;\n  viewedAt?: Date | null;\n  remindersSent?: number;\n  lastReminderAt?: Date | null;\n  notes?: string;\n  customerNotes?: string;\n  terms?: string;\n}\n\n/** Retained editing modes, validated against resolved model fields before reuse. */\nexport interface InvoiceLineEditorState {\n  /** Lossless editor draft; never authoritative for ordinary model saves. */\n  draft: InvoiceLineDraft;\n  /** Context used to resolve that draft; caller authority must still match on reload. */\n  context: InvoiceCalculationContext;\n}\n\n/** Constructor options for {@link InvoiceLineItem}. */\nexport interface InvoiceLineItemOptions extends SmrtObjectOptions {\n  /** Optional retained editor modes and their original calculation context. */\n  invoiceEditorState?: InvoiceLineEditorState | null;\n  /** Serialized editor state loaded from persistence; malformed JSON is ignored. */\n  invoiceEditorStateJson?: string;\n  tenantId?: string | null;\n  invoiceId?: string;\n  description?: string;\n  sku?: string;\n  quantity?: number;\n  unitPrice?: number;\n  discount?: number;\n  taxRate?: number;\n  amount?: number;\n  sourceType?: string;\n  sourceId?: string;\n  periodStart?: Date | null;\n  periodEnd?: Date | null;\n  revenueAccountId?: string;\n  sortOrder?: number;\n}\n\n/**\n * Constructor options for {@link Fulfillment}.\n */\nexport interface FulfillmentOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  contractId?: string;\n  fulfillmentType?: FulfillmentType;\n  status?: FulfillmentStatus;\n  trackingNumber?: string;\n  carrier?: string;\n  shippingAddress?: Address;\n  shippedAt?: Date | null;\n  deliveredAt?: Date | null;\n  estimatedDelivery?: Date | null;\n  notes?: string;\n}\n\n/**\n * Constructor options for {@link FulfillmentLineItem}.\n */\nexport interface FulfillmentLineItemOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  fulfillmentId?: string;\n  contractLineItemId?: string;\n  quantityFulfilled?: number;\n  notes?: string;\n}\n\n/**\n * Constructor options for {@link Payment}.\n */\nexport interface PaymentOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  contractId?: string | null;\n  customerId?: string | null;\n  amount?: number;\n  currency?: string;\n  method?: PaymentMethod;\n  status?: PaymentStatus;\n  transactionId?: string;\n  reference?: string;\n  journalId?: string;\n  paidAt?: Date | null;\n  notes?: string;\n  externalId?: string;\n  externalProvider?: string;\n  syncedAt?: Date | null;\n  backendId?: string;\n  backendTxRef?: string;\n  nativeAmount?: number;\n  nativeCurrency?: string;\n  usdAtQuote?: number;\n  usdAtConfirmation?: number;\n}\n\n/**\n * Constructor options for {@link PaymentInstrument}.\n */\nexport interface PaymentInstrumentOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  customerId?: string;\n  backendId?: string;\n  providerCustomerId?: string;\n  providerPaymentMethodId?: string;\n  type?: string;\n  brand?: string;\n  last4?: string;\n  expMonth?: number;\n  expYear?: number;\n  isDefault?: boolean;\n  status?: PaymentInstrumentStatus;\n}\n\n/**\n * Constructor options for {@link PaymentAllocation}.\n */\nexport interface PaymentAllocationOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  paymentId?: string;\n  invoiceId?: string;\n  amount?: number;\n  allocatedAt?: Date;\n  allocatedBy?: string;\n  notes?: string;\n}\n\n/**\n * Constructor options for {@link PaymentIntent}.\n */\nexport interface PaymentIntentOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  skuId?: string;\n  offeringRef?: string;\n  licenseeEmail?: string;\n  customerId?: string;\n  paymentOptions?: PaymentOption[] | string;\n  usdPriceLocked?: number;\n  priceLockWindowMs?: number;\n  priceLockExpiresAt?: Date | number | string | null;\n  status?: PaymentIntentStatus;\n  idempotencyKey?: string;\n  paidOptionBackendId?: string;\n  paymentId?: string;\n  paidAt?: Date | number | string | null;\n  issuedAt?: Date | number | string | null;\n  expiredAt?: Date | number | string | null;\n  cancelledAt?: Date | number | string | null;\n  retiredAt?: Date | number | string | null;\n  notes?: string;\n}\n\n/**\n * Constructor options for {@link Payout}.\n */\nexport interface PayoutOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  paymentId?: string;\n  vendorId?: string;\n  grossAmount?: number;\n  operatorFee?: number;\n  supplierNet?: number;\n  currency?: string;\n  backendId?: string;\n  backendTxRef?: string;\n  status?: PayoutStatus;\n  sentAt?: Date | number | string | null;\n  confirmedAt?: Date | number | string | null;\n  failedAt?: Date | number | string | null;\n  failureReason?: string;\n  notes?: string;\n}\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -67,7 +67,8 @@ export { type InvoiceEditorStorageEngine, type InvoiceEditorStorageMigrationResu
 export { COMMERCE_MONEY_COLUMNS, COMMERCE_MONEY_MINOR_UNITS_BACKFILL, COMMERCE_NATIVE_UNIT_COLUMNS, migrateCommerceMoneyToMinorUnits, preflightCommerceMoneyMinorUnits, } from './migrations/moneyMinorUnits.js';
 export { Agreement, BillingAccount, type BillingCloseKind, BillingLineSource, type BillingLineSourceType, BillingPaymentAttempt, type BillingPaymentAttemptFlag, type BillingPaymentAttemptPurpose, type BillingPaymentAttemptTransition, BillingPeriodClose, type BillingPeriodCloseStatus, type BillingStanding, Cart, Contract, ContractLineItem, Customer, Estimate, Fulfillment, FulfillmentLineItem, Invoice, InvoiceLineItem, Lease, type LicenseRightsSnapshot, LicenseSale, Order, Payment, PaymentAllocation, PaymentInstrument, PaymentIntent, Payout, ProductionOrder, PurchaseOrder, Vendor, WholesaleOrder, } from './models/index.js';
 export { assertIntegerMinorUnits } from './money.js';
+export { applyPartyContactIntent, DEFAULT_PARTY_CONTACT_FIELD_NAMES, normalizePartyContacts, PARTY_CONTACT_MAX_LENGTHS, type PartyContactErrorCode, type PartyContactField, type PartyContactFieldNames, type PartyContactFormSource, type PartyContactInput, type PartyContactIntents, PartyContactPartyNotFoundError, PartyContactPayloadError, type PartyContactRowErrors, PartyContactValidationError, readPartyContactRows, type SavePartyContactsOptions, savePartyContacts, validatePartyContactRows, } from './party-contacts.js';
 export { AgreementsRecipe, CustomersRecipe, EstimatesRecipe, FulfillmentRecipe, InvoicingRecipe, LeasesRecipe, LicensesRecipe, PurchasesRecipe, SalesRecipe, VendorsRecipe, WholesaleRecipe, } from './recipes.js';
-export { type Address, ContractStatus, ContractType, CustomerStatus, CustomerType, FulfillmentStatus, FulfillmentType, type InvoiceCollectionMethod, InvoiceStatus, PaymentInstrumentStatus, PaymentIntentStatus, PaymentMethod, type PaymentOption, PaymentStatus, PayoutStatus, type PurchaseOrderOptions, type RecognizeRevenueOptions, type RecordPaymentOptions, VendorStatus, } from './types/index.js';
+export { type Address, ContractStatus, ContractType, CustomerStatus, CustomerType, FulfillmentStatus, FulfillmentType, type InvoiceCollectionMethod, InvoiceStatus, type PartyContact, PaymentInstrumentStatus, PaymentIntentStatus, PaymentMethod, type PaymentOption, PaymentStatus, PayoutStatus, type PurchaseOrderOptions, type RecognizeRevenueOptions, type RecordPaymentOptions, VendorStatus, } from './types/index.js';
 export { COMMERCE_MODULE_META, COMMERCE_UI_SLOTS } from './ui.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AAKH,OAAO,wBAAwB,CAAC;AAGhC,cAAc,oBAAoB,CAAC;AAEnC,OAAO,EACL,kBAAkB,EAClB,0BAA0B,EAC1B,KAAK,2BAA2B,EAChC,kBAAkB,EAClB,qBAAqB,EACrB,6BAA6B,EAC7B,iBAAiB,EACjB,yBAAyB,EACzB,KAAK,oBAAoB,EACzB,2BAA2B,EAC3B,iBAAiB,EACjB,2BAA2B,EAC3B,uBAAuB,EACvB,KAAK,4BAA4B,EACjC,KAAK,iBAAiB,EACtB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,KAAK,0BAA0B,EAC/B,KAAK,mCAAmC,EACxC,KAAK,6BAA6B,EAClC,2BAA2B,EAC3B,6BAA6B,GAC9B,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EACL,sBAAsB,EACtB,mCAAmC,EACnC,4BAA4B,EAC5B,gCAAgC,EAChC,gCAAgC,GACjC,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,SAAS,EACT,cAAc,EACd,KAAK,gBAAgB,EACrB,iBAAiB,EACjB,KAAK,qBAAqB,EAC1B,qBAAqB,EACrB,KAAK,yBAAyB,EAC9B,KAAK,4BAA4B,EACjC,KAAK,+BAA+B,EACpC,kBAAkB,EAClB,KAAK,wBAAwB,EAC7B,KAAK,eAAe,EACpB,IAAI,EACJ,QAAQ,EACR,gBAAgB,EAChB,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,mBAAmB,EACnB,OAAO,EACP,eAAe,EACf,KAAK,EACL,KAAK,qBAAqB,EAC1B,WAAW,EACX,KAAK,EACL,OAAO,EACP,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,MAAM,EACN,eAAe,EACf,aAAa,EACb,MAAM,EACN,cAAc,GACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,cAAc,EACd,eAAe,EACf,WAAW,EACX,aAAa,EACb,eAAe,GAChB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,KAAK,OAAO,EACZ,cAAc,EACd,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,KAAK,uBAAuB,EAC5B,aAAa,EACb,uBAAuB,EACvB,mBAAmB,EACnB,aAAa,EACb,KAAK,aAAa,EAClB,aAAa,EACb,YAAY,EACZ,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,YAAY,GACb,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AAKH,OAAO,wBAAwB,CAAC;AAGhC,cAAc,oBAAoB,CAAC;AAEnC,OAAO,EACL,kBAAkB,EAClB,0BAA0B,EAC1B,KAAK,2BAA2B,EAChC,kBAAkB,EAClB,qBAAqB,EACrB,6BAA6B,EAC7B,iBAAiB,EACjB,yBAAyB,EACzB,KAAK,oBAAoB,EACzB,2BAA2B,EAC3B,iBAAiB,EACjB,2BAA2B,EAC3B,uBAAuB,EACvB,KAAK,4BAA4B,EACjC,KAAK,iBAAiB,EACtB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,KAAK,0BAA0B,EAC/B,KAAK,mCAAmC,EACxC,KAAK,6BAA6B,EAClC,2BAA2B,EAC3B,6BAA6B,GAC9B,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EACL,sBAAsB,EACtB,mCAAmC,EACnC,4BAA4B,EAC5B,gCAAgC,EAChC,gCAAgC,GACjC,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,SAAS,EACT,cAAc,EACd,KAAK,gBAAgB,EACrB,iBAAiB,EACjB,KAAK,qBAAqB,EAC1B,qBAAqB,EACrB,KAAK,yBAAyB,EAC9B,KAAK,4BAA4B,EACjC,KAAK,+BAA+B,EACpC,kBAAkB,EAClB,KAAK,wBAAwB,EAC7B,KAAK,eAAe,EACpB,IAAI,EACJ,QAAQ,EACR,gBAAgB,EAChB,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,mBAAmB,EACnB,OAAO,EACP,eAAe,EACf,KAAK,EACL,KAAK,qBAAqB,EAC1B,WAAW,EACX,KAAK,EACL,OAAO,EACP,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,MAAM,EACN,eAAe,EACf,aAAa,EACb,MAAM,EACN,cAAc,GACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAErD,OAAO,EACL,uBAAuB,EACvB,iCAAiC,EACjC,sBAAsB,EACtB,yBAAyB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,8BAA8B,EAC9B,wBAAwB,EACxB,KAAK,qBAAqB,EAC1B,2BAA2B,EAC3B,oBAAoB,EACpB,KAAK,wBAAwB,EAC7B,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,cAAc,EACd,eAAe,EACf,WAAW,EACX,aAAa,EACb,eAAe,GAChB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,KAAK,OAAO,EACZ,cAAc,EACd,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,KAAK,uBAAuB,EAC5B,aAAa,EACb,KAAK,YAAY,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,aAAa,EACb,KAAK,aAAa,EAClB,aAAa,EACb,YAAY,EACZ,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,YAAY,GACb,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC"}