@happyvertical/smrt-commerce 0.51.22 → 0.51.24

package/dist/billing/runtime.d.ts

@@ -0,0 +1,168 @@
+import { SmrtClassOptions } from '@happyvertical/smrt-core';
+import { DatabaseInterface } from '@happyvertical/smrt-core/migrations';
+import { JournalCollection } from '@happyvertical/smrt-ledgers';
+import { BillingAdjustmentCollection, BillingRelationshipReader, ClientChargeCollection, PriceBookCollection, RetailChargeCollection, SpendingPolicyCollection, SubscriptionPlanCollection, TenantSubscriptionCollection } from '@happyvertical/smrt-subscriptions';
+import { CustomerCollection } from '../collections/CustomerCollection.js';
+import { InvoiceCollection } from '../collections/InvoiceCollection.js';
+import { InvoiceLineItemCollection } from '../collections/InvoiceLineItemCollection.js';
+import { BillingAccount, BillingAccountCollection, BillingCloseKind, BillingLineSourceCollection, BillingPeriodCloseCollection, BillingStanding } from '../models/billing.js';
+import { Invoice } from '../models/Invoice.js';
+import { Address } from '../types/index.js';
+import { CreateCreditCheckoutInput } from './credits.js';
+import { ClosePeriodInput, PeriodCloseResult } from './period-close.js';
+import { BillingProvider, BillingProviderCheckoutSession } from './provider.js';
+/** Ledger accounts billing posts to, in the seller's books. */
+export interface BillingLedgerAccounts {
+    /** Accounts receivable (debited when an invoice is issued). */
+    arAccountId: string;
+    /** Revenue (credited with the invoice subtotal). */
+    revenueAccountId: string;
+    /** Tax payable (credited with provider-calculated tax). */
+    taxAccountId: string;
+    /** Cash or clearing account payments settle into. */
+    cashAccountId: string;
+    /** Liability credited when prepaid credit is purchased. */
+    prepaidCreditAccountId: string;
+}
+/** A payer's standing changed after a provider invoice event. */
+export interface PayerStandingChange {
+    sellerTenantId: string;
+    payerTenantId: string;
+    billingAccountId: string;
+    invoiceId: string;
+    previous: BillingStanding;
+    standing: BillingStanding;
+    /**
+     * The event transaction's database handle. Host writes made through it
+     * (for example suspending the tenant) commit or roll back with the event.
+     */
+    db: DatabaseInterface;
+}
+/**
+ * Host hook for suspension or reinstatement. It runs inside the event's
+ * transaction and may run again if the event is retried, so it must be
+ * idempotent.
+ */
+export type PayerStandingHook = (change: PayerStandingChange) => void | Promise<void>;
+export interface BillingRuntimeOptions extends SmrtClassOptions {
+    /** The tenant that issues invoices. */
+    sellerTenantId: string;
+    kind: BillingCloseKind;
+    provider: BillingProvider;
+    /** smrt-tenancy's `BillingRelationshipService` (read access required). */
+    billingRelationships: BillingRelationshipReader;
+    ledger: BillingLedgerAccounts;
+    /** Invoice number prefix (default `INV`). */
+    invoiceNumberPrefix?: string;
+    onPayerStanding?: PayerStandingHook;
+    /** How long one worker may hold a period close (default 10 minutes). */
+    leaseMs?: number;
+    /** Page size for charge scans (default 500). */
+    pageSize?: number;
+}
+export interface UpsertBillingAccountInput {
+    payerTenantId: string;
+    name: string;
+    email?: string;
+    /** The payer's tax location; required when `automaticTax` is on. */
+    billingAddress?: Address;
+    taxExempt?: boolean;
+    taxId?: string;
+    automaticTax?: boolean;
+    flatDiscountBasisPoints?: number;
+    paymentTermsDays?: number;
+    /** Link an existing provider customer (for example from checkout). */
+    providerCustomerId?: string;
+}
+/** A synced account: its provider customer id is always present. */
+export interface SyncedBillingAccount {
+    account: BillingAccount;
+    providerCustomerId: string;
+    automaticTax: boolean;
+}
+/**
+ * Billing for one seller. Construct once per process with
+ * {@link BillingRuntime.create}; register it with `registerBillingRuntime()`
+ * to drive it from smrt-jobs.
+ *
+ * Period close and event processing are privileged system operations: they
+ * read every payer's charges and write in a system context. Call them only
+ * from trusted host code (a job, an operator action), never from a
+ * tenant-facing route.
+ */
+export declare class BillingRuntime {
+    readonly db: DatabaseInterface;
+    readonly accounts: BillingAccountCollection;
+    readonly closes: BillingPeriodCloseCollection;
+    readonly sources: BillingLineSourceCollection;
+    readonly customers: CustomerCollection;
+    readonly invoices: InvoiceCollection;
+    readonly lineItems: InvoiceLineItemCollection;
+    readonly journals: JournalCollection;
+    readonly charges: ClientChargeCollection;
+    readonly adjustments: BillingAdjustmentCollection;
+    readonly retailCharges: RetailChargeCollection;
+    readonly books: PriceBookCollection;
+    readonly subscriptions: TenantSubscriptionCollection;
+    readonly plans: SubscriptionPlanCollection;
+    readonly policies: SpendingPolicyCollection;
+    readonly sellerTenantId: string;
+    readonly kind: BillingCloseKind;
+    readonly provider: BillingProvider;
+    readonly billingRelationships: BillingRelationshipReader;
+    readonly ledger: BillingLedgerAccounts;
+    readonly invoiceNumberPrefix: string;
+    readonly onPayerStanding?: PayerStandingHook;
+    readonly leaseMs: number;
+    readonly pageSize: number;
+    /** The inbox provider namespace for this runtime's events (per seller). */
+    readonly eventProvider: string;
+    private constructor();
+    static create(options: BillingRuntimeOptions): Promise<BillingRuntime>;
+    getAccount(payerTenantId: string): Promise<BillingAccount | null>;
+    private accountId;
+    /**
+     * Create or update a payer's account and its commerce `Customer` (in the
+     * seller's tenant). The customer's billing address is the payer's tax
+     * location for provider-calculated tax.
+     */
+    upsertAccount(input: UpsertBillingAccountInput): Promise<BillingAccount>;
+    /**
+     * Create or update the provider customer, including its tax location.
+     * Creating a customer is not idempotent at the provider; an attempt that
+     * dies between creation and this save leaves an unused provider customer.
+     */
+    ensureProviderCustomer(account: BillingAccount): Promise<SyncedBillingAccount>;
+    /** Close a billing period (default: the previous calendar month, UTC). */
+    closePeriod(input?: ClosePeriodInput): Promise<PeriodCloseResult>;
+    getInvoice(invoiceId: string): Promise<Invoice>;
+    /** Take the close's lease; returns the token, or null if another holds it. */
+    acquireCloseLease(closeId: string, now?: Date): Promise<string | null>;
+    releaseCloseLease(closeId: string, token: string): Promise<void>;
+    /**
+     * Verify and durably enqueue a provider webhook. Returns `accepted: false`
+     * for a duplicate delivery or an event this package does not act on.
+     * Respond 2xx whenever this resolves; a verification failure throws
+     * `BillingWebhookVerificationError`. An ignored event's `type` names what
+     * was ignored: alert on one ending in `:unverified_credit_purchase` (a
+     * paid checkout that claims to be a credit purchase but failed
+     * verification, for example after a webhook-secret rotation).
+     */
+    acceptWebhook(payload: string, signature: string): Promise<{
+        accepted: boolean;
+        eventId: string;
+        kind: string;
+        type?: string;
+    }>;
+    /** Apply up to `limit` queued provider events; returns how many ran. */
+    processEvents(limit?: number): Promise<number>;
+    /**
+     * Start a provider checkout that credits a prepaid balance policy when
+     * paid. The caller pays: the policy's tenant for its own balance, or the
+     * parent that set a delegated balance.
+     */
+    createCreditCheckout(input: CreateCreditCheckoutInput): Promise<BillingProviderCheckoutSession>;
+    /** Run in a system context (cross-tenant reads and payer-owned writes). */
+    system<T>(operation: () => Promise<T>): Promise<T>;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/billing/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/billing/runtime.ts"],"names":[],"mappings":"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"}

package/dist/billing/stripe.d.ts

@@ -0,0 +1,12 @@
+import { StripeAccountingProvider, WebhookEvent } from '@happyvertical/accounting';
+import { BillingProvider, BillingProviderEvent } from './provider.js';
+export interface StripeBillingProviderOptions {
+    /** A Stripe provider from `getAccountingProvider({ type: 'stripe', … })`. */
+    stripe: StripeAccountingProvider;
+    /** Webhook endpoint signing secret (`whsec_…`). */
+    webhookSecret: string;
+}
+export declare function createStripeBillingProvider(options: StripeBillingProviderOptions): BillingProvider;
+/** Normalize a verified, parsed Stripe event. Exported for tests. */
+export declare function normalizeStripeEvent(event: WebhookEvent, webhookSecret: string): Promise<BillingProviderEvent>;
+//# sourceMappingURL=stripe.d.ts.map

package/dist/billing/stripe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe.d.ts","sourceRoot":"","sources":["../../src/billing/stripe.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EACV,wBAAwB,EAExB,YAAY,EACb,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAEL,KAAK,eAAe,EAIpB,KAAK,oBAAoB,EAM1B,MAAM,eAAe,CAAC;AAQvB,MAAM,WAAW,4BAA4B;IAC3C,6EAA6E;IAC7E,MAAM,EAAE,wBAAwB,CAAC;IACjC,mDAAmD;IACnD,aAAa,EAAE,MAAM,CAAC;CACvB;AAqDD,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,4BAA4B,GACpC,eAAe,CAkJjB;AAED,qEAAqE;AACrE,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,YAAY,EACnB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,oBAAoB,CAAC,CAoE/B"}

package/dist/billing/units.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Money-unit and identity helpers for billing-period close (#3060).
+ *
+ * Commerce stores money as integer minor units. `@happyvertical/accounting`
+ * takes and returns currency *major* units and converts to the provider's own
+ * representation itself, so the only conversion this package performs is the
+ * ISO 4217 one: minor units ÷ 10^exponent.
+ */
+/** Upper-case, validate, and return an ISO 4217-shaped currency code. */
+export declare function normalizeCurrency(currency: string): string;
+/** The ISO 4217 minor-unit exponent of a currency (2 for USD, 0 for JPY). */
+export declare function currencyMinorUnitExponent(currency: string): number;
+/** Integer minor units → major units (`1999` USD → `19.99`). */
+export declare function minorToMajorUnits(amount: number, currency: string): number;
+/**
+ * Major units → integer minor units. Rejects a value that is not a whole
+ * number of minor units instead of rounding it: a provider amount that does
+ * not round-trip exactly means the two sides disagree about the currency.
+ */
+export declare function majorToMinorUnits(amount: number, currency: string): number;
+/**
+ * A stable UUID derived from its parts (SHA-256, version/variant bits set).
+ * Deterministic ids are what make every period-close write replay-safe: a
+ * retry recomputes the same identity instead of creating a second row.
+ */
+export declare function deterministicId(parts: string[]): Promise<string>;
+/** Validate and lower-case a tenant UUID. */
+export declare function canonicalTenantId(id: string, label?: string): string;
+/** Lower-case a possibly-empty tenant id for comparison. */
+export declare function tenantKey(id: string | null | undefined): string;
+//# sourceMappingURL=units.d.ts.map

package/dist/billing/units.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"units.d.ts","sourceRoot":"","sources":["../../src/billing/units.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,yEAAyE;AACzE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQ1D;AAED,6EAA6E;AAC7E,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOlE;AAED,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAO1E;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAY1E;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAetE;AAKD,6CAA6C;AAC7C,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,SAAc,GAAG,MAAM,CAKzE;AAED,4DAA4D;AAC5D,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAE/D"}

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

@@ -1 +1 @@
-{"version":3,"file":"types-CRnln577.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';\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}.\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/**\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 * 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  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  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/**\n * Constructor options for {@link InvoiceLineItem}.\n */\nexport interface InvoiceLineItemOptions extends SmrtObjectOptions {\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-CRnln577.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';\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/**\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 * 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  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/**\n * Constructor options for {@link InvoiceLineItem}.\n */\nexport interface InvoiceLineItemOptions extends SmrtObjectOptions {\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/chunks/units--tTn2ps8.js

@@ -0,0 +1,52 @@
+//#region src/billing/units.ts
+var CURRENCY_PATTERN = /^[A-Z]{3}$/;
+function normalizeCurrency(currency) {
+	const code = String(currency ?? "").trim().toUpperCase();
+	if (!CURRENCY_PATTERN.test(code)) throw new Error(`Currency '${currency}' must be a three-letter code.`);
+	return code;
+}
+function currencyMinorUnitExponent(currency) {
+	const code = normalizeCurrency(currency);
+	const digits = new Intl.NumberFormat("en", {
+		style: "currency",
+		currency: code
+	}).resolvedOptions().maximumFractionDigits;
+	return typeof digits === "number" ? digits : 2;
+}
+function minorToMajorUnits(amount, currency) {
+	if (!Number.isSafeInteger(amount)) throw new Error(`Amount ${amount} must be a safe integer number of minor units.`);
+	return amount / 10 ** currencyMinorUnitExponent(currency);
+}
+function majorToMinorUnits(amount, currency) {
+	if (!Number.isFinite(amount)) throw new Error(`Provider amount ${amount} is not a finite number.`);
+	const scaled = amount * 10 ** currencyMinorUnitExponent(currency);
+	const minor = Math.round(scaled);
+	if (Math.abs(scaled - minor) > 1e-6 || !Number.isSafeInteger(minor)) throw new Error(`Provider amount ${amount} ${normalizeCurrency(currency)} is not a whole number of minor units.`);
+	return minor;
+}
+async function deterministicId(parts) {
+	const bytes = new TextEncoder().encode(JSON.stringify(parts));
+	const uuid = new Uint8Array(await crypto.subtle.digest("SHA-256", bytes)).slice(0, 16);
+	uuid[6] = uuid[6] & 15 | 80;
+	uuid[8] = uuid[8] & 63 | 128;
+	const joined = Array.from(uuid, (byte) => byte.toString(16).padStart(2, "0")).join("");
+	return [
+		joined.slice(0, 8),
+		joined.slice(8, 12),
+		joined.slice(12, 16),
+		joined.slice(16, 20),
+		joined.slice(20)
+	].join("-");
+}
+var UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function canonicalTenantId(id, label = "Tenant ID") {
+	if (typeof id !== "string" || !UUID_PATTERN.test(id)) throw new Error(`${label} must be a UUID.`);
+	return id.toLowerCase();
+}
+function tenantKey(id) {
+	return id ? String(id).toLowerCase() : "";
+}
+//#endregion
+export { minorToMajorUnits as a, majorToMinorUnits as i, currencyMinorUnitExponent as n, normalizeCurrency as o, deterministicId as r, tenantKey as s, canonicalTenantId as t };
+
+//# sourceMappingURL=units--tTn2ps8.js.map

package/dist/chunks/units--tTn2ps8.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"units--tTn2ps8.js","names":[],"sources":["../../src/billing/units.ts"],"sourcesContent":["/**\n * Money-unit and identity helpers for billing-period close (#3060).\n *\n * Commerce stores money as integer minor units. `@happyvertical/accounting`\n * takes and returns currency *major* units and converts to the provider's own\n * representation itself, so the only conversion this package performs is the\n * ISO 4217 one: minor units ÷ 10^exponent.\n */\n\nconst CURRENCY_PATTERN = /^[A-Z]{3}$/;\n\n/** Upper-case, validate, and return an ISO 4217-shaped currency code. */\nexport function normalizeCurrency(currency: string): string {\n  const code = String(currency ?? '')\n    .trim()\n    .toUpperCase();\n  if (!CURRENCY_PATTERN.test(code)) {\n    throw new Error(`Currency '${currency}' must be a three-letter code.`);\n  }\n  return code;\n}\n\n/** The ISO 4217 minor-unit exponent of a currency (2 for USD, 0 for JPY). */\nexport function currencyMinorUnitExponent(currency: string): number {\n  const code = normalizeCurrency(currency);\n  const digits = new Intl.NumberFormat('en', {\n    style: 'currency',\n    currency: code,\n  }).resolvedOptions().maximumFractionDigits;\n  return typeof digits === 'number' ? digits : 2;\n}\n\n/** Integer minor units → major units (`1999` USD → `19.99`). */\nexport function minorToMajorUnits(amount: number, currency: string): number {\n  if (!Number.isSafeInteger(amount)) {\n    throw new Error(\n      `Amount ${amount} must be a safe integer number of minor units.`,\n    );\n  }\n  return amount / 10 ** currencyMinorUnitExponent(currency);\n}\n\n/**\n * Major units → integer minor units. Rejects a value that is not a whole\n * number of minor units instead of rounding it: a provider amount that does\n * not round-trip exactly means the two sides disagree about the currency.\n */\nexport function majorToMinorUnits(amount: number, currency: string): number {\n  if (!Number.isFinite(amount)) {\n    throw new Error(`Provider amount ${amount} is not a finite number.`);\n  }\n  const scaled = amount * 10 ** currencyMinorUnitExponent(currency);\n  const minor = Math.round(scaled);\n  if (Math.abs(scaled - minor) > 1e-6 || !Number.isSafeInteger(minor)) {\n    throw new Error(\n      `Provider amount ${amount} ${normalizeCurrency(currency)} is not a whole number of minor units.`,\n    );\n  }\n  return minor;\n}\n\n/**\n * A stable UUID derived from its parts (SHA-256, version/variant bits set).\n * Deterministic ids are what make every period-close write replay-safe: a\n * retry recomputes the same identity instead of creating a second row.\n */\nexport async function deterministicId(parts: string[]): Promise<string> {\n  const bytes = new TextEncoder().encode(JSON.stringify(parts));\n  const digest = new Uint8Array(await crypto.subtle.digest('SHA-256', bytes));\n  const uuid = digest.slice(0, 16);\n  uuid[6] = (uuid[6] & 0x0f) | 0x50;\n  uuid[8] = (uuid[8] & 0x3f) | 0x80;\n  const hex = Array.from(uuid, (byte) => byte.toString(16).padStart(2, '0'));\n  const joined = hex.join('');\n  return [\n    joined.slice(0, 8),\n    joined.slice(8, 12),\n    joined.slice(12, 16),\n    joined.slice(16, 20),\n    joined.slice(20),\n  ].join('-');\n}\n\nconst UUID_PATTERN =\n  /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n\n/** Validate and lower-case a tenant UUID. */\nexport function canonicalTenantId(id: string, label = 'Tenant ID'): string {\n  if (typeof id !== 'string' || !UUID_PATTERN.test(id)) {\n    throw new Error(`${label} must be a UUID.`);\n  }\n  return id.toLowerCase();\n}\n\n/** Lower-case a possibly-empty tenant id for comparison. */\nexport function tenantKey(id: string | null | undefined): string {\n  return id ? String(id).toLowerCase() : '';\n}\n"],"mappings":";AASA,IAAM,mBAAmB;AAGlB,SAAS,kBAAkB,UAA0B;CAC1D,MAAM,OAAO,OAAO,YAAY,EAAE,CAAA,CAC/B,KAAK,CAAA,CACL,YAAY;CACf,IAAI,CAAC,iBAAiB,KAAK,IAAI,GAC7B,MAAM,IAAI,MAAM,aAAa,SAAQ,+BAAgC;CAEvE,OAAO;AACT;AAGO,SAAS,0BAA0B,UAA0B;CAClE,MAAM,OAAO,kBAAkB,QAAQ;CACvC,MAAM,SAAS,IAAI,KAAK,aAAa,MAAM;EACzC,OAAO;EACP,UAAU;CACZ,CAAC,CAAA,CAAE,gBAAgB,CAAA,CAAE;CACrB,OAAO,OAAO,WAAW,WAAW,SAAS;AAC/C;AAGO,SAAS,kBAAkB,QAAgB,UAA0B;CAC1E,IAAI,CAAC,OAAO,cAAc,MAAM,GAC9B,MAAM,IAAI,MACR,UAAU,OAAM,+CAClB;CAEF,OAAO,SAAS,MAAM,0BAA0B,QAAQ;AAC1D;AAOO,SAAS,kBAAkB,QAAgB,UAA0B;CAC1E,IAAI,CAAC,OAAO,SAAS,MAAM,GACzB,MAAM,IAAI,MAAM,mBAAmB,OAAM,yBAA0B;CAErE,MAAM,SAAS,SAAS,MAAM,0BAA0B,QAAQ;CAChE,MAAM,QAAQ,KAAK,MAAM,MAAM;CAC/B,IAAI,KAAK,IAAI,SAAS,KAAK,IAAI,QAAQ,CAAC,OAAO,cAAc,KAAK,GAChE,MAAM,IAAI,MACR,mBAAmB,OAAM,GAAI,kBAAkB,QAAQ,EAAC,uCAC1D;CAEF,OAAO;AACT;AAOA,eAAsB,gBAAgB,OAAkC;CACtE,MAAM,QAAQ,IAAI,YAAY,CAAA,CAAE,OAAO,KAAK,UAAU,KAAK,CAAC;CAE5D,MAAM,OAAO,IADM,WAAW,MAAM,OAAO,OAAO,OAAO,WAAW,KAAK,CAC5D,CAAA,CAAO,MAAM,GAAG,EAAE;CAC/B,KAAK,KAAM,KAAK,KAAK,KAAQ;CAC7B,KAAK,KAAM,KAAK,KAAK,KAAQ;CAE7B,MAAM,SADM,MAAM,KAAK,OAAO,SAAS,KAAK,SAAS,EAAE,CAAA,CAAE,SAAS,GAAG,GAAG,CACzD,CAAA,CAAI,KAAK,EAAE;CAC1B,OAAO;EACL,OAAO,MAAM,GAAG,CAAC;EACjB,OAAO,MAAM,GAAG,EAAE;EAClB,OAAO,MAAM,IAAI,EAAE;EACnB,OAAO,MAAM,IAAI,EAAE;EACnB,OAAO,MAAM,EAAE;CACjB,CAAA,CAAE,KAAK,GAAG;AACZ;AAEA,IAAM,eACJ;AAGK,SAAS,kBAAkB,IAAY,QAAQ,aAAqB;CACzE,IAAI,OAAO,OAAO,YAAY,CAAC,aAAa,KAAK,EAAE,GACjD,MAAM,IAAI,MAAM,GAAG,MAAK,iBAAkB;CAE5C,OAAO,GAAG,YAAY;AACxB;AAGO,SAAS,UAAU,IAAuC;CAC/D,OAAO,KAAK,OAAO,EAAE,CAAA,CAAE,YAAY,IAAI;AACzC"}

package/dist/collections/InvoiceLineItemCollection.d.ts

@@ -64,7 +64,8 @@ export declare class InvoiceLineItemCollection extends SmrtCollection<InvoiceLin
      * Convert line items to accounting format for SDK sync
      *
      * @param invoiceId - Invoice ID
-     * @returns Array of line items in accounting format
+     * @returns Array of line items in accounting format, money in integer
+     *   minor units (`Invoice.toAccountingInput()` converts to major units)
      */
     toAccountingLineItems(invoiceId: string): Promise<AccountingLineItemInput[]>;
     /**

package/dist/collections/InvoiceLineItemCollection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InvoiceLineItemCollection.d.ts","sourceRoot":"","sources":["../../src/collections/InvoiceLineItemCollection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAEjE,qBAAa,yBAA0B,SAAQ,cAAc,CAAC,eAAe,CAAC;IAC5E,MAAM,CAAC,QAAQ,CAAC,UAAU,yBAAmB;IAE7C;;;;;OAKG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAOlE;;;;;;OAMG;IACG,YAAY,CAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,eAAe,EAAE,CAAC;IAO7B;;;;;OAKG;IACG,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAOtE;;;;;OAKG;IACG,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK5D;;;;;OAKG;IACG,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK/D;;;;;OAKG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK1D;;;;;OAKG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ1D;;;;;OAKG;IACG,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAYvE;;;;;OAKG;IACG,qBAAqB,CACzB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,uBAAuB,EAAE,CAAC;IASrC;;;;;OAKG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAIhE;;;;;;;;OAQG;IACG,UAAU,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAI9C;;;;;;;;OAQG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAOpE"}
+{"version":3,"file":"InvoiceLineItemCollection.d.ts","sourceRoot":"","sources":["../../src/collections/InvoiceLineItemCollection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAEjE,qBAAa,yBAA0B,SAAQ,cAAc,CAAC,eAAe,CAAC;IAC5E,MAAM,CAAC,QAAQ,CAAC,UAAU,yBAAmB;IAE7C;;;;;OAKG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAOlE;;;;;;OAMG;IACG,YAAY,CAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,eAAe,EAAE,CAAC;IAO7B;;;;;OAKG;IACG,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAOtE;;;;;OAKG;IACG,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK5D;;;;;OAKG;IACG,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK/D;;;;;OAKG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK1D;;;;;OAKG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ1D;;;;;OAKG;IACG,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAYvE;;;;;;OAMG;IACG,qBAAqB,CACzB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,uBAAuB,EAAE,CAAC;IASrC;;;;;OAKG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAIhE;;;;;;;;OAQG;IACG,UAAU,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAI9C;;;;;;;;OAQG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAOpE"}

package/dist/index.d.ts

@@ -1,6 +1,7 @@
+export * from './billing/index.js';
 export { ContractCollection, ContractLineItemCollection, type CreatePayoutFromPaymentArgs, CustomerCollection, FulfillmentCollection, FulfillmentLineItemCollection, InvoiceCollection, InvoiceLineItemCollection, type InvoiceNumberOptions, PaymentAllocationCollection, PaymentCollection, PaymentInstrumentCollection, PaymentIntentCollection, type PaymentIntentIdempotencyArgs, type PaymentIntentSeed, PayoutCollection, UNPAID_STATUSES, VendorCollection, } from './collections/index.js';
 export { COMMERCE_MONEY_COLUMNS, COMMERCE_MONEY_MINOR_UNITS_BACKFILL, COMMERCE_NATIVE_UNIT_COLUMNS, migrateCommerceMoneyToMinorUnits, preflightCommerceMoneyMinorUnits, } from './migrations/moneyMinorUnits.js';
-export { Agreement, 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 { Agreement, BillingAccount, type BillingCloseKind, BillingLineSource, type BillingLineSourceType, 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 { type Address, ContractStatus, ContractType, CustomerStatus, CustomerType, FulfillmentStatus, FulfillmentType, InvoiceStatus, PaymentInstrumentStatus, PaymentIntentStatus, PaymentMethod, type PaymentOption, PaymentStatus, PayoutStatus, type RecognizeRevenueOptions, type RecordPaymentOptions, VendorStatus, } from './types/index.js';
 export { COMMERCE_MODULE_META, COMMERCE_UI_SLOTS } from './ui.js';

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,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;AAEhC,OAAO,EACL,sBAAsB,EACtB,mCAAmC,EACnC,4BAA4B,EAC5B,gCAAgC,EAChC,gCAAgC,GACjC,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,SAAS,EACT,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;AAGrD,OAAO,EACL,KAAK,OAAO,EACZ,cAAc,EACd,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,mBAAmB,EACnB,aAAa,EACb,KAAK,aAAa,EAClB,aAAa,EACb,YAAY,EACZ,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;AAEhC,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,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;AAGrD,OAAO,EACL,KAAK,OAAO,EACZ,cAAc,EACd,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,mBAAmB,EACnB,aAAa,EACb,KAAK,aAAa,EAClB,aAAa,EACb,YAAY,EACZ,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,YAAY,GACb,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC"}