@happyvertical/smrt-commerce 0.51.32 → 0.51.33

package/dist/__tests__/foreign-key-fixtures.d.ts

@@ -0,0 +1,13 @@
+interface CommerceForeignKeyFixtures {
+    db: {
+        type: 'sqlite';
+        url: string;
+    };
+    customerIds?: string[];
+    vendorIds?: string[];
+    contractIds?: string[];
+}
+/** Seed only the real same-package parents referenced by a test scenario. */
+export declare function seedCommerceForeignKeyFixtures({ db, customerIds, vendorIds, contractIds, }: CommerceForeignKeyFixtures): Promise<void>;
+export {};
+//# sourceMappingURL=foreign-key-fixtures.d.ts.map

package/dist/__tests__/foreign-key-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"foreign-key-fixtures.d.ts","sourceRoot":"","sources":["../../src/__tests__/foreign-key-fixtures.ts"],"names":[],"mappings":"AAIA,UAAU,0BAA0B;IAClC,EAAE,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,6EAA6E;AAC7E,wBAAsB,8BAA8B,CAAC,EACnD,EAAE,EACF,WAAgB,EAChB,SAAc,EACd,WAAgB,GACjB,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CA2B5C"}

package/dist/__tests__/helpers/anchor-fixture.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Helpers for billing-cycle anchor tests (#3116), shared by the SQLite suite
+ * and the PostgreSQL lane. Scenarios run at fixed future dates with no usage
+ * charges, so only flat plans are billed.
+ */
+import type { TenantSubscription } from '@happyvertical/smrt-subscriptions';
+import type { BillingRuntime } from '../../billing/runtime.js';
+import { type BillingLineSource } from '../../models/billing.js';
+import { type BillingWorld } from './billing-fixture.js';
+export declare const at: (iso: string) => Date;
+export declare const DAY = 86400000;
+export declare function subscriptionOf(world: BillingWorld, tenantId: string): Promise<TenantSubscription>;
+export declare function updateSubscription(world: BillingWorld, tenantId: string, patch: Partial<Pick<TenantSubscription, 'startedAt' | 'canceledAt' | 'trialEndsAt' | 'status'>>): Promise<TenantSubscription>;
+/** Put SITE (billed to NETWORK) out of the way so NETWORK has nothing due. */
+export declare function parkNetwork(world: BillingWorld): Promise<void>;
+/** Subscribe another tenant to the provider's site plan, billed to NETWORK. */
+export declare function addNetworkSite(world: BillingWorld, tenantId: string, startedAt: Date): Promise<TenantSubscription>;
+/** A payer's invoices from the provider runtime, oldest period first. */
+export declare function invoicesOf(world: BillingWorld, payer: string, runtime?: BillingRuntime): Promise<import("../../index.js").Invoice[]>;
+export declare function flatClaims(world: BillingWorld, subscriptionId?: string): Promise<BillingLineSource[]>;
+/** Claimed windows as ISO pairs with amounts, in time order. */
+export declare function claimedWindows(world: BillingWorld, subscriptionId: string): Promise<Array<[string, string, number]>>;
+/** Assert that no two flat claims of one subscription cover the same time. */
+export declare function overlappingClaims(world: BillingWorld): Promise<string[]>;
+/**
+ * Hold a runtime's first flat-plan claim insert for `lineKey` until
+ * `release()`: `reached` resolves once the claim has read the existing
+ * coverage and is about to insert, so a test can interleave a second worker
+ * deterministically.
+ */
+export declare function holdFlatClaim(runtime: BillingRuntime, lineKey: string): {
+    reached: Promise<void>;
+    release: () => void;
+    restore: () => void;
+};
+//# sourceMappingURL=anchor-fixture.d.ts.map

package/dist/__tests__/helpers/anchor-fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor-fixture.d.ts","sourceRoot":"","sources":["../../../src/__tests__/helpers/anchor-fixture.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAG5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D,OAAO,EACL,KAAK,iBAAiB,EAEvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,KAAK,YAAY,EAIlB,MAAM,sBAAsB,CAAC;AAE9B,eAAO,MAAM,EAAE,GAAI,KAAK,MAAM,SAAkB,CAAC;AACjD,eAAO,MAAM,GAAG,WAAa,CAAC;AAE9B,wBAAsB,cAAc,CAClC,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,kBAAkB,CAAC,CAM7B;AAED,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,CACZ,IAAI,CACF,kBAAkB,EAClB,WAAW,GAAG,YAAY,GAAG,aAAa,GAAG,QAAQ,CACtD,CACF,GACA,OAAO,CAAC,kBAAkB,CAAC,CAO7B;AAED,8EAA8E;AAC9E,wBAAsB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpE;AAED,+EAA+E;AAC/E,wBAAsB,cAAc,CAClC,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,IAAI,GACd,OAAO,CAAC,kBAAkB,CAAC,CAgB7B;AAED,yEAAyE;AACzE,wBAAsB,UAAU,CAC9B,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,cAA+B,+CAUzC;AAED,wBAAsB,UAAU,CAC9B,KAAK,EAAE,YAAY,EACnB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAW9B;AAED,gEAAgE;AAChE,wBAAsB,cAAc,CAClC,KAAK,EAAE,YAAY,EACnB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAM1C;AAED,8EAA8E;AAC9E,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,MAAM,EAAE,CAAC,CAqBnB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM;;mBAGhD,IAAI;;EAqBzB"}

package/dist/__tests__/helpers/billing-fixture.d.ts

@@ -0,0 +1,51 @@
+/**
+ * A small reseller world for billing-period close tests (#3060), shared by
+ * the SQLite suite and the PostgreSQL lane.
+ *
+ * PROVIDER sells to NETWORK (a reseller that pays for SITE's usage and plan)
+ * and to SOLO (billed for itself). NETWORK resells to SITE (retail usage) and
+ * to SITE2 (NETWORK's own flat plan).
+ */
+import type { DatabaseInterface } from '@happyvertical/smrt-core/migrations';
+import { BillingAdjustmentCollection, ClientChargeCollection, CommercialUsageService, ResellerBillingService, SubscriptionPlanCollection, TenantSubscriptionCollection } from '@happyvertical/smrt-subscriptions';
+import { BillingRelationshipService } from '@happyvertical/smrt-tenancy';
+import { type BillingLedgerAccounts, BillingRuntime, type PayerStandingChange } from '../../billing/runtime.js';
+import { FakeStripe } from './fake-stripe.js';
+export declare const PROVIDER = "00000000-0000-4000-8000-00000000000a";
+export declare const NETWORK = "aaaaaaaa-1111-4111-8111-aaaaaaaaaaaa";
+export declare const SITE = "cccccccc-3333-4333-8333-cccccccccccc";
+export declare const SITE2 = "eeeeeeee-5555-4555-8555-eeeeeeeeeeee";
+export declare const SOLO = "dddddddd-4444-4444-8444-dddddddddddd";
+export declare const STRANGER = "ffffffff-6666-4666-8666-ffffffffffff";
+/** The current UTC calendar month, closable by passing `now: periodEnd + 1d`. */
+export declare function currentMonth(): {
+    periodStart: Date;
+    periodEnd: Date;
+    now: Date;
+};
+export declare function nextMonth(period: {
+    periodEnd: Date;
+}): {
+    periodStart: Date;
+    periodEnd: Date;
+    now: Date;
+};
+export interface BillingWorld {
+    db: DatabaseInterface;
+    stripe: FakeStripe;
+    provider: BillingRuntime;
+    reseller: BillingRuntime;
+    commercial: CommercialUsageService;
+    relationships: BillingRelationshipService;
+    resellerBilling: ResellerBillingService;
+    ledger: BillingLedgerAccounts;
+    standingChanges: PayerStandingChange[];
+    subscriptions: TenantSubscriptionCollection;
+    plans: SubscriptionPlanCollection;
+    charges: ClientChargeCollection;
+    adjustments: BillingAdjustmentCollection;
+    /** Record and rate one usage event (10 tokens) for a tenant. */
+    usage(tenantId: string, quantity?: number): Promise<void>;
+}
+export declare function createBillingWorld(db: DatabaseInterface): Promise<BillingWorld>;
+//# sourceMappingURL=billing-fixture.d.ts.map

package/dist/__tests__/helpers/billing-fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-fixture.d.ts","sourceRoot":"","sources":["../../../src/__tests__/helpers/billing-fixture.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAE7E,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EACtB,sBAAsB,EAGtB,sBAAsB,EACtB,0BAA0B,EAC1B,4BAA4B,EAE7B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,0BAA0B,EAG3B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,KAAK,qBAAqB,EAC1B,cAAc,EACd,KAAK,mBAAmB,EACzB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,UAAU,EAAkB,MAAM,kBAAkB,CAAC;AAE9D,eAAO,MAAM,QAAQ,yCAAyC,CAAC;AAC/D,eAAO,MAAM,OAAO,yCAAyC,CAAC;AAC9D,eAAO,MAAM,IAAI,yCAAyC,CAAC;AAC3D,eAAO,MAAM,KAAK,yCAAyC,CAAC;AAC5D,eAAO,MAAM,IAAI,yCAAyC,CAAC;AAC3D,eAAO,MAAM,QAAQ,yCAAyC,CAAC;AAE/D,iFAAiF;AACjF,wBAAgB,YAAY,IAAI;IAC9B,WAAW,EAAE,IAAI,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,GAAG,EAAE,IAAI,CAAC;CACX,CAaA;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE;IAAE,SAAS,EAAE,IAAI,CAAA;CAAE;;;;EAUpD;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,iBAAiB,CAAC;IACtB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,EAAE,cAAc,CAAC;IACzB,UAAU,EAAE,sBAAsB,CAAC;IACnC,aAAa,EAAE,0BAA0B,CAAC;IAC1C,eAAe,EAAE,sBAAsB,CAAC;IACxC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,eAAe,EAAE,mBAAmB,EAAE,CAAC;IACvC,aAAa,EAAE,4BAA4B,CAAC;IAC5C,KAAK,EAAE,0BAA0B,CAAC;IAClC,OAAO,EAAE,sBAAsB,CAAC;IAChC,WAAW,EAAE,2BAA2B,CAAC;IACzC,gEAAgE;IAChE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3D;AAID,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,iBAAiB,GACpB,OAAO,CAAC,YAAY,CAAC,CA6OvB"}

package/dist/__tests__/helpers/consumer-license-sale.d.ts

@@ -0,0 +1,13 @@
+import { type SmrtObject } from '@happyvertical/smrt-core';
+export declare const CONSUMER_PACKAGE = "@fixture/market-core";
+export declare function defineConsumerLicenseSale(): Promise<{
+    ctor: typeof SmrtObject;
+    dispose: () => void;
+}>;
+/**
+ * Each `LicenseSale` keeps its own identity and table, the schema planner
+ * keeps commerce's `contracts` free of the consumer's class, and commerce's
+ * `LicenseSale` still round-trips through its own table.
+ */
+export declare function assertLicenseSalesCoexist(consumer: typeof SmrtObject): Promise<void>;
+//# sourceMappingURL=consumer-license-sale.d.ts.map

package/dist/__tests__/helpers/consumer-license-sale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer-license-sale.d.ts","sourceRoot":"","sources":["../../../src/__tests__/helpers/consumer-license-sale.ts"],"names":[],"mappings":"AAwBA,OAAO,EAEL,KAAK,UAAU,EAGhB,MAAM,0BAA0B,CAAC;AAKlC,eAAO,MAAM,gBAAgB,yBAAyB,CAAC;AAEvD,wBAAsB,yBAAyB,IAAI,OAAO,CAAC;IACzD,IAAI,EAAE,OAAO,UAAU,CAAC;IACxB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC,CAgCD;AAED;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,OAAO,UAAU,GAC1B,OAAO,CAAC,IAAI,CAAC,CA2Cf"}

package/dist/__tests__/helpers/fake-stripe.d.ts

@@ -0,0 +1,146 @@
+import type { StripeAccountingProvider } from '@happyvertical/accounting';
+export declare const WEBHOOK_SECRET = "whsec_test_billing";
+interface FakeCustomer {
+    id: string;
+    created: number;
+    name?: string;
+    email?: string;
+    address?: Record<string, string>;
+    tax_exempt?: string;
+    default_payment_method?: string;
+    metadata: Record<string, string>;
+}
+interface FakeInvoiceItem {
+    id: string;
+    customer: string;
+    currency: string;
+    quantity: number;
+    unit_amount: number;
+    description: string;
+    invoice: string | null;
+    metadata: Record<string, string>;
+}
+interface FakeInvoice {
+    id: string;
+    customer: string;
+    currency: string;
+    status: 'draft' | 'open' | 'paid' | 'void' | 'uncollectible';
+    collection_method: 'send_invoice' | 'charge_automatically';
+    auto_advance: boolean;
+    finalized: number;
+    due_date: number | null;
+    created: number;
+    automatic_tax: boolean;
+    items: string[];
+    subtotal: number;
+    tax: number;
+    total: number;
+    amount_paid: number;
+    amount_remaining: number;
+    metadata: Record<string, string>;
+    sent: number;
+}
+interface FakeSession {
+    id: string;
+    url: string;
+    mode: string;
+    currency: string | null;
+    amount_subtotal: number | null;
+    amount_tax: number;
+    amount_total: number | null;
+    customer: string | null;
+    status: 'open' | 'complete' | 'expired';
+    payment_status: 'paid' | 'unpaid' | 'no_payment_required';
+    automatic_tax: boolean;
+    customer_update_address: boolean;
+    billing_address_collection: string | null;
+    setup_future_usage: string | null;
+    payment_method: string | null;
+    metadata: Record<string, string>;
+}
+/** How a saved payment method answers an off-session charge. */
+export type FakeCardBehavior = 'succeed' | 'processing' | 'decline' | 'authentication_required';
+interface FakePaymentIntent {
+    id: string;
+    object: 'payment_intent';
+    created: number;
+    amount: number;
+    currency: string;
+    customer: string;
+    payment_method: string;
+    status: string;
+    last_payment_error: Record<string, string> | null;
+    metadata: Record<string, string>;
+}
+export declare class FakeStripe {
+    readonly customers: Map<string, FakeCustomer>;
+    readonly invoiceItems: Map<string, FakeInvoiceItem>;
+    readonly invoices: Map<string, FakeInvoice>;
+    readonly sessions: Map<string, FakeSession>;
+    readonly paymentIntents: Map<string, FakePaymentIntent>;
+    /** False while Stripe's search index lags behind writes. */
+    searchable: boolean;
+    /** Behavior of each saved payment method (default `succeed`). */
+    readonly cards: Map<string, FakeCardBehavior>;
+    readonly subscriptions: Map<string, Record<string, unknown>>;
+    readonly requests: Array<{
+        method: string;
+        path: string;
+        key?: string;
+    }>;
+    private readonly idempotent;
+    private failures;
+    private counter;
+    private nextId;
+    /** Make the next matching request(s) fail. */
+    fail(method: string, path: RegExp, when?: 'before' | 'after', times?: number): void;
+    provider(): Promise<StripeAccountingProvider>;
+    readonly fetch: (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+    private route;
+    private applyCustomer;
+    private recalculate;
+    private customerView;
+    private sessionView;
+    private view;
+    /** Customer pays an open invoice in full. */
+    pay(invoiceId: string): void;
+    /**
+     * Stripe's automatic collection of a finalized `charge_automatically`
+     * invoice: charges the customer's default card. Returns the outcome.
+     */
+    collect(invoiceId: string): 'paid' | 'failed';
+    /**
+     * The customer finishes a checkout: a payment session is paid with tax
+     * from the collected (or customer) address; a setup session saves
+     * `paymentMethod`. A collected address is saved to the customer when the
+     * session asked to.
+     */
+    completeSession(sessionId: string, options?: {
+        paymentMethod?: string;
+        address?: Record<string, string>;
+    }): FakeSession;
+    private createPaymentIntent;
+    /** A processing PaymentIntent settles (Stripe then sends its event). */
+    settlePaymentIntent(intentId: string, status: 'succeeded' | 'failed'): FakePaymentIntent;
+    setInvoiceStatus(invoiceId: string, status: FakeInvoice['status']): void;
+    lineItemsOf(invoiceId: string): FakeInvoiceItem[];
+}
+/** A signed Stripe webhook delivery for `event`. */
+export declare function signedEvent(event: Record<string, unknown>): {
+    payload: string;
+    signature: string;
+};
+export declare function invoiceEvent(type: string, invoiceId: string): Record<string, unknown>;
+export declare function checkoutEvent(session: {
+    id: string;
+    mode?: string;
+    currency: string | null;
+    amount_subtotal: number | null;
+    amount_total?: number | null;
+    metadata: Record<string, string>;
+}, paymentStatus?: string, type?: string): Record<string, unknown>;
+/** A `payment_intent.*` event for a PaymentIntent the fake holds. */
+export declare function paymentIntentEvent(type: string, intent: Record<string, unknown>): Record<string, unknown>;
+export declare function subscriptionEvent(type: string, subscriptionId: string): Record<string, unknown>;
+export {};
+//# sourceMappingURL=fake-stripe.d.ts.map

package/dist/__tests__/helpers/fake-stripe.d.ts.map

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

package/dist/billing/cards.d.ts

@@ -1,7 +1,17 @@
-import { DatabaseInterface } from '@happyvertical/smrt-core/migrations';
-import { BillingAccount } from '../models/billing.js';
-import { BillingProviderCheckoutSession, BillingProviderCheckoutState } from './provider.js';
-import { BillingRuntime } from './runtime.js';
+/**
+ * Card on file (#3139): a provider checkout that saves a payment method
+ * without charging, and the settlement that makes it the payer's default.
+ *
+ * A completed setup (or a credit purchase that saved its card) is applied
+ * from the provider's checkout event: `observe()` re-reads the session and
+ * makes the saved method the provider customer's default; `project()`
+ * records it as the payer customer's default commerce `PaymentInstrument`
+ * and adopts the billing address collected at checkout as the tax location.
+ */
+import type { DatabaseInterface } from '@happyvertical/smrt-core/migrations';
+import type { BillingAccount } from '../models/billing.js';
+import type { BillingProviderCheckoutSession, BillingProviderCheckoutState } from './provider.js';
+import type { BillingRuntime } from './runtime.js';
 export declare const CARD_SETUP_PURPOSE = "card_setup";
 /** Checkout metadata flag: the session saves its payment method. */
 export declare const SAVE_CARD_METADATA = "smrt_save_card";

package/dist/billing/credits.d.ts

@@ -1,5 +1,5 @@
-import { BillingProviderCheckoutSession } from './provider.js';
-import { BillingRuntime } from './runtime.js';
+import type { BillingProviderCheckoutSession } from './provider.js';
+import type { BillingRuntime } from './runtime.js';
 export declare const CREDIT_PURCHASE_PURPOSE = "credit_purchase";
 export interface CreateCreditCheckoutInput {
     /** The `period: 'balance'` spending policy to credit. */

package/dist/billing/cycles.d.ts

@@ -1,4 +1,24 @@
-import { BillingPeriod } from './period-close.js';
+/**
+ * Billing-cycle schedule and proration math (#3116).
+ *
+ * A payer's billing periods are a pure function of its account's
+ * `billingAnchorAt`:
+ *
+ * - no anchor: UTC calendar months (the default, and the only schedule before
+ *   #3116);
+ * - an anchor `A`: monthly periods `[A + k months, A + (k + 1) months)` at
+ *   `A`'s UTC time of day. A day past the end of a shorter month is clamped to
+ *   its last day, always computed from `A` itself, so an anchor on the 31st
+ *   runs Jan 31 → Feb 28 (29) → Mar 31 without drifting. Before `A` the
+ *   schedule stays calendar months, and the month `A` falls in ends early at
+ *   `A` (a *stub* period), so an account that moves from calendar months to an
+ *   anchor has no gap and no overlap.
+ *
+ * Every period carries the full cycle it belongs to (`cycleStart`/`cycleEnd`);
+ * that cycle's length is the proration denominator, so a stub is billed as the
+ * fraction of its calendar month it covers.
+ */
+import type { BillingPeriod } from './period-close.js';
 /** A period of a payer's schedule and the full cycle it prorates against. */
 export interface ScheduledBillingPeriod extends BillingPeriod {
     /** Start of the full monthly cycle (equals `periodStart` except for a stub). */

package/dist/billing/events.d.ts

@@ -1,7 +1,17 @@
-import { ForgeProjector } from '@happyvertical/smrt-jobs';
-import { SavedCard } from './cards.js';
-import { BillingProviderCheckoutState, BillingProviderEvent, BillingProviderInvoiceState, BillingProviderSubscriptionState } from './provider.js';
-import { BillingRuntime } from './runtime.js';
+/**
+ * Provider event processing (#3060): verified webhook deliveries queued in
+ * smrt-jobs' durable delivery inbox are applied here.
+ *
+ * `observe()` re-reads the invoice or subscription from the provider, so an
+ * event is applied against current provider state rather than the snapshot it
+ * carried; out-of-order and duplicate deliveries therefore converge. The
+ * application writes, the inbox completion, and the host standing hook share
+ * one transaction.
+ */
+import { type ForgeProjector } from '@happyvertical/smrt-jobs';
+import { type SavedCard } from './cards.js';
+import type { BillingProviderCheckoutState, BillingProviderEvent, BillingProviderInvoiceState, BillingProviderSubscriptionState } from './provider.js';
+import type { BillingRuntime } from './runtime.js';
 type InvoiceEvent = Extract<BillingProviderEvent, {
     kind: 'invoice';
 }>;

package/dist/billing/jobs.d.ts

@@ -1,6 +1,6 @@
-import { SmrtJob } from '@happyvertical/smrt-jobs';
-import { PeriodCloseResult } from './period-close.js';
-import { BillingRuntime } from './runtime.js';
+import { type SmrtJob } from '@happyvertical/smrt-jobs';
+import type { PeriodCloseResult } from './period-close.js';
+import type { BillingRuntime } from './runtime.js';
 /** Make a runtime available to billing jobs under `name`. */
 export declare function registerBillingRuntime(name: string, runtime: BillingRuntime): void;
 export declare function unregisterBillingRuntime(name: string): void;

package/dist/billing/period-close.d.ts

@@ -1,4 +1,4 @@
-import { BillingRuntime } from './runtime.js';
+import type { BillingRuntime } from './runtime.js';
 export interface BillingPeriod {
     /** Inclusive start. */
     periodStart: Date;

package/dist/billing/provider.d.ts

@@ -1,5 +1,15 @@
-import { SubscriptionStatus } from '@happyvertical/smrt-subscriptions';
-import { Address } from '../types/index.js';
+/**
+ * The provider-neutral port period close, webhook intake, and credit
+ * purchases talk to (#3060).
+ *
+ * Every amount crossing this port is **integer minor units** of the named
+ * currency, like the rest of commerce. Adapters (see
+ * {@link createStripeBillingProvider}) own the conversion to the provider's
+ * representation and every provider call; this package never calls a payment
+ * provider directly.
+ */
+import type { SubscriptionStatus } from '@happyvertical/smrt-subscriptions';
+import type { Address } from '../types/index.js';
 export interface BillingProviderCustomerInput {
     /** The local billing account id, recorded on the provider customer. */
     accountId: string;

package/dist/billing/runtime.d.ts

@@ -1,20 +1,25 @@
-import { SmrtClassOptions } from '@happyvertical/smrt-core';
-import { DatabaseInterface } from '@happyvertical/smrt-core/migrations';
+/**
+ * One seller's billing wiring (#3060): its payment provider, ledger accounts,
+ * billing-owner reader, and the collections period close and provider events
+ * write through.
+ */
+import type { SmrtClassOptions } from '@happyvertical/smrt-core';
+import type { DatabaseInterface } from '@happyvertical/smrt-core/migrations';
 import { JournalCollection } from '@happyvertical/smrt-ledgers';
-import { AutoTopUpHook, BillingAdjustmentCollection, BillingRelationshipReader, ClientChargeCollection, PriceBookCollection, RetailChargeCollection, SpendingPolicyCollection, SubscriptionPlanCollection, TenantSubscriptionCollection } from '@happyvertical/smrt-subscriptions';
+import { type AutoTopUpHook, BillingAdjustmentCollection, type 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 { PaymentInstrumentCollection } from '../collections/PaymentInstrumentCollection.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 { CreateCardSetupCheckoutInput } from './cards.js';
-import { CreateCreditCheckoutInput } from './credits.js';
-import { ScheduledBillingPeriod } from './cycles.js';
-import { ClosePeriodInput, PeriodCloseResult } from './period-close.js';
-import { BillingProvider, BillingProviderCheckoutSession } from './provider.js';
-import { AutoTopUpFailureHook, AutoTopUpHookOptions } from './top-up.js';
+import { type BillingAccount, BillingAccountCollection, type BillingCloseKind, BillingLineSourceCollection, BillingPeriodCloseCollection, type BillingStanding } from '../models/billing.js';
+import type { Invoice } from '../models/Invoice.js';
+import { type Address } from '../types/index.js';
+import { type CreateCardSetupCheckoutInput } from './cards.js';
+import { type CreateCreditCheckoutInput } from './credits.js';
+import { type ScheduledBillingPeriod } from './cycles.js';
+import { type ClosePeriodInput, type PeriodCloseResult } from './period-close.js';
+import type { BillingProvider, BillingProviderCheckoutSession } from './provider.js';
+import { type AutoTopUpFailureHook, type AutoTopUpHookOptions } from './top-up.js';
 /** Ledger accounts billing posts to, in the seller's books. */
 export interface BillingLedgerAccounts {
     /** Accounts receivable (debited when an invoice is issued). */

package/dist/billing/stripe.d.ts

@@ -1,5 +1,14 @@
-import { StripeAccountingProvider, WebhookEvent } from '@happyvertical/accounting';
-import { BillingProvider, BillingProviderEvent } from './provider.js';
+/**
+ * Stripe adapter for the {@link BillingProvider} port (#3060).
+ *
+ * Every provider call goes through `@happyvertical/accounting`'s Stripe
+ * provider; this module only maps between commerce's integer minor units and
+ * the SDK's major-unit contract, and normalizes verified webhook events. The
+ * SDK's `*Minor` fields (checkout prices, session totals, off-session charges)
+ * are already ISO minor units and pass through unconverted (#3139).
+ */
+import type { StripeAccountingProvider, WebhookEvent } from '@happyvertical/accounting';
+import { type BillingProvider, type BillingProviderEvent } from './provider.js';
 export interface StripeBillingProviderOptions {
     /** A Stripe provider from `getAccountingProvider({ type: 'stripe', … })`. */
     stripe: StripeAccountingProvider;

package/dist/billing/top-up.d.ts

@@ -1,7 +1,7 @@
-import { DatabaseInterface } from '@happyvertical/smrt-core/migrations';
-import { AutoTopUpGrant, AutoTopUpHook, AutoTopUpRequest } from '@happyvertical/smrt-subscriptions';
-import { BillingChargeStatus } from './provider.js';
-import { BillingRuntime } from './runtime.js';
+import type { DatabaseInterface } from '@happyvertical/smrt-core/migrations';
+import { type AutoTopUpGrant, type AutoTopUpHook, type AutoTopUpRequest } from '@happyvertical/smrt-subscriptions';
+import type { BillingChargeStatus } from './provider.js';
+import type { BillingRuntime } from './runtime.js';
 /** Prefix of every auto top-up charge key (the provider idempotency key). */
 export declare const AUTO_TOP_UP_CHARGE_PREFIX = "smrt-auto-top-up:";
 /** `Payment.reference` of an auto top-up attempt: prefix + policy id. */

package/dist/collections/ContractCollection.d.ts

@@ -1,3 +1,7 @@
+/**
+ * ContractCollection - Collection manager for Contract objects (STI)
+ * @packageDocumentation
+ */
 import { SmrtCollection } from '@happyvertical/smrt-core';
 import { Contract } from '../models/Contract.js';
 import { ContractStatus, ContractType } from '../types/index.js';

package/dist/collections/ContractLineItemCollection.d.ts

@@ -1,3 +1,7 @@
+/**
+ * ContractLineItemCollection - Collection manager for ContractLineItem objects
+ * @packageDocumentation
+ */
 import { SmrtCollection } from '@happyvertical/smrt-core';
 import { ContractLineItem } from '../models/ContractLineItem.js';
 export declare class ContractLineItemCollection extends SmrtCollection<ContractLineItem> {

package/dist/collections/CustomerCollection.d.ts

@@ -1,3 +1,7 @@
+/**
+ * CustomerCollection - Collection manager for Customer objects
+ * @packageDocumentation
+ */
 import { SmrtCollection } from '@happyvertical/smrt-core';
 import { Customer } from '../models/Customer.js';
 import { CustomerStatus } from '../types/index.js';

package/dist/collections/FulfillmentCollection.d.ts

@@ -1,6 +1,10 @@
+/**
+ * FulfillmentCollection - Collection manager for Fulfillment objects
+ * @packageDocumentation
+ */
 import { SmrtCollection } from '@happyvertical/smrt-core';
 import { Fulfillment } from '../models/Fulfillment.js';
-import { FulfillmentStatus, FulfillmentType } from '../types/index.js';
+import { FulfillmentStatus, type FulfillmentType } from '../types/index.js';
 export declare class FulfillmentCollection extends SmrtCollection<Fulfillment> {
     static readonly _itemClass: typeof Fulfillment;
     /**

package/dist/collections/FulfillmentLineItemCollection.d.ts

@@ -1,3 +1,7 @@
+/**
+ * FulfillmentLineItemCollection - Collection manager for FulfillmentLineItem objects
+ * @packageDocumentation
+ */
 import { SmrtCollection } from '@happyvertical/smrt-core';
 import { FulfillmentLineItem } from '../models/FulfillmentLineItem.js';
 export declare class FulfillmentLineItemCollection extends SmrtCollection<FulfillmentLineItem> {

package/dist/collections/InvoiceCollection.d.ts

@@ -1,3 +1,7 @@
+/**
+ * InvoiceCollection - Collection manager for Invoice objects
+ * @packageDocumentation
+ */
 import { SmrtCollection } from '@happyvertical/smrt-core';
 import { Invoice } from '../models/Invoice.js';
 import { InvoiceStatus } from '../types/index.js';

package/dist/collections/InvoiceLineItemCollection.d.ts

@@ -1,6 +1,10 @@
+/**
+ * InvoiceLineItemCollection - Collection manager for InvoiceLineItem objects
+ * @packageDocumentation
+ */
 import { SmrtCollection } from '@happyvertical/smrt-core';
 import { InvoiceLineItem } from '../models/InvoiceLineItem.js';
-import { AccountingLineItemInput } from '../types/index.js';
+import type { AccountingLineItemInput } from '../types/index.js';
 export declare class InvoiceLineItemCollection extends SmrtCollection<InvoiceLineItem> {
     static readonly _itemClass: typeof InvoiceLineItem;
     /**

package/dist/collections/PaymentAllocationCollection.d.ts

@@ -1,3 +1,7 @@
+/**
+ * PaymentAllocationCollection - Collection manager for PaymentAllocation objects
+ * @packageDocumentation
+ */
 import { SmrtCollection } from '@happyvertical/smrt-core';
 import { PaymentAllocation } from '../models/PaymentAllocation.js';
 export declare class PaymentAllocationCollection extends SmrtCollection<PaymentAllocation> {

package/dist/collections/PaymentCollection.d.ts

@@ -1,6 +1,10 @@
+/**
+ * PaymentCollection - Collection manager for Payment objects
+ * @packageDocumentation
+ */
 import { SmrtCollection } from '@happyvertical/smrt-core';
 import { Payment } from '../models/Payment.js';
-import { PaymentMethod, PaymentStatus } from '../types/index.js';
+import { type PaymentMethod, PaymentStatus } from '../types/index.js';
 export declare class PaymentCollection extends SmrtCollection<Payment> {
     static readonly _itemClass: typeof Payment;
     /**

package/dist/collections/PaymentInstrumentCollection.d.ts

@@ -1,3 +1,7 @@
+/**
+ * PaymentInstrumentCollection - Collection manager for PaymentInstrument objects
+ * @packageDocumentation
+ */
 import { SmrtCollection } from '@happyvertical/smrt-core';
 import { PaymentInstrument } from '../models/PaymentInstrument.js';
 export declare class PaymentInstrumentCollection extends SmrtCollection<PaymentInstrument> {

package/dist/collections/PaymentIntentCollection.d.ts

@@ -1,6 +1,17 @@
+/**
+ * PaymentIntentCollection — collection manager for {@link PaymentIntent}.
+ *
+ * Adds helpers for the common query shapes (find by idempotency key,
+ * find still-open intents, find by licensee email, find expired) and a
+ * `getOrCreateByIdempotencyKey` helper that callers use to implement
+ * safe at-least-once retries from the marketplace's PaymentIntent
+ * issuance handler.
+ *
+ * @packageDocumentation
+ */
 import { SmrtCollection } from '@happyvertical/smrt-core';
 import { PaymentIntent } from '../models/PaymentIntent.js';
-import { PaymentIntentStatus, PaymentOption } from '../types/index.js';
+import { PaymentIntentStatus, type PaymentOption } from '../types/index.js';
 export interface PaymentIntentIdempotencyArgs {
     /** Caller-supplied scope (Sku id / tier id / etc.) */
     offeringRef: string;

package/dist/collections/PayoutCollection.d.ts

@@ -1,5 +1,16 @@
+/**
+ * PayoutCollection — collection manager for {@link Payout} rows.
+ *
+ * Adds helpers for the common operator-side query shapes: payouts for
+ * a specific vendor, payouts derived from a specific source payment,
+ * status-bucketed lookups for the operator dashboard, and a
+ * `createFromPayment` convenience that wires up the source-payment
+ * link in one call.
+ *
+ * @packageDocumentation
+ */
 import { SmrtCollection } from '@happyvertical/smrt-core';
-import { Payment } from '../models/Payment.js';
+import type { Payment } from '../models/Payment.js';
 import { Payout } from '../models/Payout.js';
 import { PayoutStatus } from '../types/index.js';
 export interface CreatePayoutFromPaymentArgs {