@happyvertical/smrt-commerce 0.30.0

package/dist/collections/InvoiceLineItemCollection.d.ts

@@ -0,0 +1,90 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { InvoiceLineItem } from '../models/InvoiceLineItem.js';
+export declare class InvoiceLineItemCollection extends SmrtCollection<InvoiceLineItem> {
+    static readonly _itemClass: typeof InvoiceLineItem;
+    /**
+     * Find line items by invoice
+     *
+     * @param invoiceId - Invoice ID
+     * @returns Array of line items, sorted by sortOrder
+     */
+    findByInvoice(invoiceId: string): Promise<InvoiceLineItem[]>;
+    /**
+     * Find line items by source
+     *
+     * @param sourceType - Source type (e.g., 'campaign', 'contract')
+     * @param sourceId - Source ID
+     * @returns Array of line items
+     */
+    findBySource(sourceType: string, sourceId: string): Promise<InvoiceLineItem[]>;
+    /**
+     * Find line items by source type only
+     *
+     * @param sourceType - Source type (e.g., 'campaign')
+     * @returns Array of line items
+     */
+    findBySourceType(sourceType: string): Promise<InvoiceLineItem[]>;
+    /**
+     * Calculate total amount for an invoice
+     *
+     * @param invoiceId - Invoice ID
+     * @returns Total amount
+     */
+    getTotalForInvoice(invoiceId: string): Promise<number>;
+    /**
+     * Calculate subtotal (before tax) for an invoice
+     *
+     * @param invoiceId - Invoice ID
+     * @returns Subtotal
+     */
+    getSubtotalForInvoice(invoiceId: string): Promise<number>;
+    /**
+     * Calculate tax amount for an invoice
+     *
+     * @param invoiceId - Invoice ID
+     * @returns Tax amount
+     */
+    getTaxForInvoice(invoiceId: string): Promise<number>;
+    /**
+     * Get the next sort order for an invoice
+     *
+     * @param invoiceId - Invoice ID
+     * @returns Next sort order number
+     */
+    getNextSortOrder(invoiceId: string): Promise<number>;
+    /**
+     * Recalculate all line item amounts for an invoice
+     *
+     * @param invoiceId - Invoice ID
+     * @returns Updated line items
+     */
+    recalculateAmounts(invoiceId: string): Promise<InvoiceLineItem[]>;
+    /**
+     * Convert line items to accounting format for SDK sync
+     *
+     * @param invoiceId - Invoice ID
+     * @returns Array of line items in accounting format
+     */
+    toAccountingLineItems(invoiceId: string): Promise<any[]>;
+    /**
+     * Find all invoice line items belonging to a specific tenant
+     *
+     * @param tenantId - Tenant ID
+     * @returns Array of invoice line items for the tenant
+     */
+    findByTenant(tenantId: string): Promise<InvoiceLineItem[]>;
+    /**
+     * Find all global invoice line items (not associated with any tenant)
+     *
+     * @returns Array of global invoice line items
+     */
+    findGlobal(): Promise<InvoiceLineItem[]>;
+    /**
+     * Find invoice line items for a tenant including global line items
+     *
+     * @param tenantId - Tenant ID
+     * @returns Array of tenant-specific and global invoice line items
+     */
+    findWithGlobals(tenantId: string): Promise<InvoiceLineItem[]>;
+}
+//# sourceMappingURL=InvoiceLineItemCollection.d.ts.map

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

@@ -0,0 +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;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,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,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAS9D;;;;;OAKG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAIhE;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAI9C;;;;;OAKG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAMpE"}

package/dist/collections/PaymentAllocationCollection.d.ts

@@ -0,0 +1,86 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { PaymentAllocation } from '../models/PaymentAllocation.js';
+export declare class PaymentAllocationCollection extends SmrtCollection<PaymentAllocation> {
+    static readonly _itemClass: typeof PaymentAllocation;
+    /**
+     * Find allocations by payment
+     *
+     * @param paymentId - Payment ID
+     * @returns Array of allocations
+     */
+    findByPayment(paymentId: string): Promise<PaymentAllocation[]>;
+    /**
+     * Find allocations by invoice
+     *
+     * @param invoiceId - Invoice ID
+     * @returns Array of allocations
+     */
+    findByInvoice(invoiceId: string): Promise<PaymentAllocation[]>;
+    /**
+     * Get total amount allocated to an invoice
+     *
+     * @param invoiceId - Invoice ID
+     * @returns Total allocated amount
+     */
+    getTotalAllocatedToInvoice(invoiceId: string): Promise<number>;
+    /**
+     * Get total amount allocated from a payment
+     *
+     * @param paymentId - Payment ID
+     * @returns Total allocated amount
+     */
+    getTotalAllocatedFromPayment(paymentId: string): Promise<number>;
+    /**
+     * Get remaining unallocated amount from a payment.
+     *
+     * @param paymentId - Payment ID
+     * @param paymentAmount - Total payment amount
+     * @returns Unallocated amount
+     * @throws Error if payment is over-allocated (indicates data integrity issue)
+     */
+    getUnallocatedFromPayment(paymentId: string, paymentAmount: number): Promise<number>;
+    /**
+     * Find allocation by payment and invoice
+     *
+     * @param paymentId - Payment ID
+     * @param invoiceId - Invoice ID
+     * @returns Allocation or null
+     */
+    findByPaymentAndInvoice(paymentId: string, invoiceId: string): Promise<PaymentAllocation | null>;
+    /**
+     * Find allocations by allocator
+     *
+     * @param allocatedBy - User/agent ID who made the allocation
+     * @returns Array of allocations
+     */
+    findByAllocator(allocatedBy: string): Promise<PaymentAllocation[]>;
+    /**
+     * Find allocations in date range
+     *
+     * @param startDate - Start date
+     * @param endDate - End date
+     * @returns Array of allocations
+     */
+    findByDateRange(startDate: Date, endDate: Date): Promise<PaymentAllocation[]>;
+    /**
+     * Find all payment allocations belonging to a specific tenant
+     *
+     * @param tenantId - Tenant ID
+     * @returns Array of payment allocations for the tenant
+     */
+    findByTenant(tenantId: string): Promise<PaymentAllocation[]>;
+    /**
+     * Find all global payment allocations (not associated with any tenant)
+     *
+     * @returns Array of global payment allocations
+     */
+    findGlobal(): Promise<PaymentAllocation[]>;
+    /**
+     * Find payment allocations for a tenant including global allocations
+     *
+     * @param tenantId - Tenant ID
+     * @returns Array of tenant-specific and global payment allocations
+     */
+    findWithGlobals(tenantId: string): Promise<PaymentAllocation[]>;
+}
+//# sourceMappingURL=PaymentAllocationCollection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PaymentAllocationCollection.d.ts","sourceRoot":"","sources":["../../src/collections/PaymentAllocationCollection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAEnE,qBAAa,2BAA4B,SAAQ,cAAc,CAAC,iBAAiB,CAAC;IAChF,MAAM,CAAC,QAAQ,CAAC,UAAU,2BAAqB;IAE/C;;;;;OAKG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAOpE;;;;;OAKG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAOpE;;;;;OAKG;IACG,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKpE;;;;;OAKG;IACG,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKtE;;;;;;;OAOG;IACG,yBAAyB,CAC7B,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC;IAclB;;;;;;OAMG;IACG,uBAAuB,CAC3B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAQpC;;;;;OAKG;IACG,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAOxE;;;;;;OAMG;IACG,eAAe,CACnB,SAAS,EAAE,IAAI,EACf,OAAO,EAAE,IAAI,GACZ,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAc/B;;;;;OAKG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIlE;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIhD;;;;;OAKG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;CAMtE"}

package/dist/collections/PaymentCollection.d.ts

@@ -0,0 +1,96 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { Payment } from '../models/Payment.js';
+import { PaymentMethod, PaymentStatus } from '../types/index.js';
+export declare class PaymentCollection extends SmrtCollection<Payment> {
+    static readonly _itemClass: typeof Payment;
+    /**
+     * Find payments by contract
+     *
+     * @param contractId - Contract ID
+     * @returns Array of payments
+     */
+    findByContract(contractId: string): Promise<Payment[]>;
+    /**
+     * Find payments by customer
+     *
+     * @param customerId - Customer ID
+     * @returns Array of payments
+     */
+    findByCustomer(customerId: string): Promise<Payment[]>;
+    /**
+     * Find payments by status
+     *
+     * @param status - Payment status
+     * @returns Array of payments
+     */
+    findByStatus(status: PaymentStatus): Promise<Payment[]>;
+    /**
+     * Find payments by method
+     *
+     * @param method - Payment method
+     * @returns Array of payments
+     */
+    findByMethod(method: PaymentMethod): Promise<Payment[]>;
+    /**
+     * Find all pending payments
+     *
+     * @returns Array of pending payments
+     */
+    findPending(): Promise<Payment[]>;
+    /**
+     * Find all completed payments
+     *
+     * @returns Array of completed payments
+     */
+    findCompleted(): Promise<Payment[]>;
+    /**
+     * Find payment by transaction ID
+     *
+     * @param transactionId - External transaction ID
+     * @returns Payment or null
+     */
+    findByTransactionId(transactionId: string): Promise<Payment | null>;
+    /**
+     * Find payments in date range
+     *
+     * @param startDate - Start date
+     * @param endDate - End date
+     * @returns Array of payments
+     */
+    findByDateRange(startDate: Date, endDate: Date): Promise<Payment[]>;
+    /**
+     * Calculate total payments for a contract
+     *
+     * @param contractId - Contract ID
+     * @returns Total amount paid
+     */
+    getTotalForContract(contractId: string): Promise<number>;
+    /**
+     * Find payments linked to a ledger journal
+     *
+     * @param journalId - Journal ID from smrt-ledgers
+     * @returns Payment or null
+     */
+    findByJournal(journalId: string): Promise<Payment | null>;
+    /**
+     * Find all payments belonging to a specific tenant
+     *
+     * @param tenantId - Tenant ID
+     * @returns Array of payments for the tenant
+     */
+    findByTenant(tenantId: string): Promise<Payment[]>;
+    /**
+     * Find all global payments (not associated with any tenant)
+     *
+     * @returns Array of global payments
+     */
+    findGlobal(): Promise<Payment[]>;
+    /**
+     * Find payments for a tenant including global payments
+     *
+     * @param tenantId - Tenant ID
+     * @returns Array of tenant-specific and global payments
+     */
+    findWithGlobals(tenantId: string): Promise<Payment[]>;
+}
+//# sourceMappingURL=PaymentCollection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PaymentCollection.d.ts","sourceRoot":"","sources":["../../src/collections/PaymentCollection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,KAAK,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEtE,qBAAa,iBAAkB,SAAQ,cAAc,CAAC,OAAO,CAAC;IAC5D,MAAM,CAAC,QAAQ,CAAC,UAAU,iBAAW;IAErC;;;;;OAKG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAO5D;;;;;OAKG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAO5D;;;;;OAKG;IACG,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAO7D;;;;;OAKG;IACG,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAO7D;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAIvC;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAIzC;;;;;OAKG;IACG,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAQzE;;;;;;OAMG;IACG,eAAe,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAUzE;;;;;OAKG;IACG,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAW9D;;;;;OAKG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAY/D;;;;;OAKG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAIxD;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAItC;;;;;OAKG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CAM5D"}

package/dist/collections/PaymentIntentCollection.d.ts

@@ -0,0 +1,66 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { PaymentIntent } from '../models/PaymentIntent.js';
+import { PaymentIntentStatus, PaymentOption } from '../types/index.js';
+export interface PaymentIntentIdempotencyArgs {
+    /** Caller-supplied scope (Sku id / tier id / etc.) */
+    offeringRef: string;
+    /** Buyer email — second factor of the natural key */
+    licenseeEmail: string;
+    /** Caller-supplied idempotency key */
+    idempotencyKey: string;
+    /** Optional tenant scope, when called outside an active tenant context */
+    tenantId?: string | null;
+}
+export interface PaymentIntentSeed extends Partial<Omit<PaymentIntentIdempotencyArgs, 'tenantId'>> {
+    tenantId?: string | null;
+    skuId?: string;
+    customerId?: string;
+    paymentOptions: PaymentOption[];
+    usdPriceLocked: number;
+    priceLockWindowMs?: number;
+}
+export declare class PaymentIntentCollection extends SmrtCollection<PaymentIntent> {
+    static readonly _itemClass: typeof PaymentIntent;
+    /**
+     * Look up an existing intent by its natural key. Returns `null` when
+     * any of the three components are empty — empty natural-key inputs
+     * disable dedup by design, so a `null` return tells the caller to
+     * fall through to a fresh `create`.
+     */
+    findByIdempotencyKey(args: PaymentIntentIdempotencyArgs): Promise<PaymentIntent | null>;
+    /**
+     * Idempotency-aware create. If an intent already exists with the
+     * same `(tenantId, offeringRef, licenseeEmail, idempotencyKey)`
+     * tuple, returns the existing row. Otherwise creates a new one
+     * with the supplied seed.
+     *
+     * Returns a `{ intent, created }` pair so callers can branch on
+     * whether they're handling a fresh quote or a replay (e.g. to
+     * skip a duplicate "intent created" webhook emission).
+     */
+    getOrCreateByIdempotencyKey(seed: PaymentIntentSeed): Promise<{
+        intent: PaymentIntent;
+        created: boolean;
+    }>;
+    /**
+     * Open intents — `AWAITING_PAYMENT` and not yet past the price-
+     * lock window. The price-lock check is `Date.now()`-based, so a
+     * stale-but-not-yet-marked-EXPIRED row drops out of this list even
+     * before a cleanup job advances its status.
+     */
+    findOpen(): Promise<PaymentIntent[]>;
+    /**
+     * `AWAITING_PAYMENT` intents whose price-lock window has already
+     * passed. The expected use is a periodic cleanup job that loads
+     * this list, calls `intent.expire(); await intent.save()` on each,
+     * and emits whatever downstream signal the application needs.
+     */
+    findStale(): Promise<PaymentIntent[]>;
+    findByLicenseeEmail(email: string): Promise<PaymentIntent[]>;
+    findByOfferingRef(offeringRef: string): Promise<PaymentIntent[]>;
+    findByStatus(status: PaymentIntentStatus): Promise<PaymentIntent[]>;
+    findByTenant(tenantId: string): Promise<PaymentIntent[]>;
+    findGlobal(): Promise<PaymentIntent[]>;
+    findWithGlobals(tenantId: string): Promise<PaymentIntent[]>;
+}
+//# sourceMappingURL=PaymentIntentCollection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PaymentIntentCollection.d.ts","sourceRoot":"","sources":["../../src/collections/PaymentIntentCollection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE5E,MAAM,WAAW,4BAA4B;IAC3C,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,aAAa,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,iBACf,SAAQ,OAAO,CAAC,IAAI,CAAC,4BAA4B,EAAE,UAAU,CAAC,CAAC;IAC/D,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,qBAAa,uBAAwB,SAAQ,cAAc,CAAC,aAAa,CAAC;IACxE,MAAM,CAAC,QAAQ,CAAC,UAAU,uBAAiB;IAE3C;;;;;OAKG;IACG,oBAAoB,CACxB,IAAI,EAAE,4BAA4B,GACjC,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAgBhC;;;;;;;;;OASG;IACG,2BAA2B,CAC/B,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC;QAAE,MAAM,EAAE,aAAa,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAavD;;;;;OAKG;IACG,QAAQ,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAY1C;;;;;OAKG;IACG,SAAS,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAWrC,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAO5D,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAOhE,YAAY,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAWnE,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAIxD,UAAU,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAItC,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;CAMlE"}

package/dist/collections/PayoutCollection.d.ts

@@ -0,0 +1,47 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { Payment } from '../models/Payment.js';
+import { Payout } from '../models/Payout.js';
+import { PayoutStatus } from '../types/index.js';
+export interface CreatePayoutFromPaymentArgs {
+    /** Source Payment row */
+    payment: Payment;
+    /** Destination vendor id */
+    vendorId: string;
+    /** Operator fee in the payment's native currency */
+    operatorFee: number;
+    /** Backend that will send the payout — defaults to the payment's */
+    backendId?: string;
+    /** Optional initial notes */
+    notes?: string;
+}
+export declare class PayoutCollection extends SmrtCollection<Payout> {
+    static readonly _itemClass: typeof Payout;
+    /**
+     * Build a `PENDING` payout linked to a source payment. The gross
+     * defaults to the payment's `nativeAmount` (falling back to
+     * `amount` if no backend rail was recorded), the currency defaults
+     * to the payment's `nativeCurrency` (falling back to `currency`),
+     * and `supplierNet` is computed as `gross - operatorFee`.
+     *
+     * The returned instance is initialized but not persisted. The caller
+     * is still responsible for `await payout.save()` — keeping create /
+     * save as separate steps lets callers stitch the payout into an
+     * application-level transaction.
+     */
+    createFromPayment(args: CreatePayoutFromPaymentArgs): Promise<Payout>;
+    findByPayment(paymentId: string): Promise<Payout[]>;
+    findByVendor(vendorId: string): Promise<Payout[]>;
+    findByStatus(status: PayoutStatus): Promise<Payout[]>;
+    findPending(): Promise<Payout[]>;
+    findFailed(): Promise<Payout[]>;
+    findByBackendTxRef(backendTxRef: string): Promise<Payout | null>;
+    /**
+     * Total funds delivered to a vendor in confirmed payouts. Useful for
+     * a vendor-balance widget on the operator dashboard.
+     */
+    getConfirmedTotalForVendor(vendorId: string): Promise<number>;
+    findByTenant(tenantId: string): Promise<Payout[]>;
+    findGlobal(): Promise<Payout[]>;
+    findWithGlobals(tenantId: string): Promise<Payout[]>;
+}
+//# sourceMappingURL=PayoutCollection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PayoutCollection.d.ts","sourceRoot":"","sources":["../../src/collections/PayoutCollection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,WAAW,2BAA2B;IAC1C,yBAAyB;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,gBAAiB,SAAQ,cAAc,CAAC,MAAM,CAAC;IAC1D,MAAM,CAAC,QAAQ,CAAC,UAAU,gBAAU;IAEpC;;;;;;;;;;;OAWG;IACG,iBAAiB,CAAC,IAAI,EAAE,2BAA2B,GAAG,OAAO,CAAC,MAAM,CAAC;IA6BrE,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAOnD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAOjD,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAOrD,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAIhC,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAI/B,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAStE;;;OAGG;IACG,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAW7D,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIjD,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAI/B,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAM3D"}

package/dist/collections/VendorCollection.d.ts

@@ -0,0 +1,59 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { Vendor } from '../models/Vendor.js';
+import { VendorStatus } from '../types/index.js';
+export declare class VendorCollection extends SmrtCollection<Vendor> {
+    static readonly _itemClass: typeof Vendor;
+    /**
+     * Find vendors by profile ID
+     *
+     * @param profileId - Profile ID from smrt-profiles
+     * @returns Array of vendors linked to this profile
+     */
+    findByProfile(profileId: string): Promise<Vendor[]>;
+    /**
+     * Find all active vendors
+     *
+     * @returns Array of active vendors
+     */
+    findActive(): Promise<Vendor[]>;
+    /**
+     * Find vendors by status
+     *
+     * @param status - Vendor status
+     * @returns Array of vendors
+     */
+    findByStatus(status: VendorStatus): Promise<Vendor[]>;
+    /**
+     * Get or create a vendor for a profile
+     *
+     * @param profileId - Profile ID
+     * @param defaults - Default values if creating
+     * @returns Vendor
+     */
+    getOrCreateForProfile(profileId: string, defaults?: Partial<{
+        leadTimeDays: number;
+        minimumOrderAmount: number;
+        paymentTerms: string;
+    }>): Promise<Vendor>;
+    /**
+     * Find all vendors belonging to a specific tenant
+     *
+     * @param tenantId - Tenant ID
+     * @returns Array of vendors for the tenant
+     */
+    findByTenant(tenantId: string): Promise<Vendor[]>;
+    /**
+     * Find all global vendors (not associated with any tenant)
+     *
+     * @returns Array of global vendors
+     */
+    findGlobal(): Promise<Vendor[]>;
+    /**
+     * Find vendors for a tenant including global vendors
+     *
+     * @param tenantId - Tenant ID
+     * @returns Array of tenant-specific and global vendors
+     */
+    findWithGlobals(tenantId: string): Promise<Vendor[]>;
+}
+//# sourceMappingURL=VendorCollection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"VendorCollection.d.ts","sourceRoot":"","sources":["../../src/collections/VendorCollection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,qBAAa,gBAAiB,SAAQ,cAAc,CAAC,MAAM,CAAC;IAC1D,MAAM,CAAC,QAAQ,CAAC,UAAU,gBAAU;IAEpC;;;;;OAKG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAOzD;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAOrC;;;;;OAKG;IACG,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAO3D;;;;;;OAMG;IACG,qBAAqB,CACzB,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,OAAO,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;QACrB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,YAAY,EAAE,MAAM,CAAC;KACtB,CAAM,GACN,OAAO,CAAC,MAAM,CAAC;IAqBlB;;;;;OAKG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIvD;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAIrC;;;;;OAKG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAM3D"}

package/dist/collections/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Collection exports for smrt-commerce
+ * @packageDocumentation
+ */
+export { ContractCollection } from './ContractCollection.js';
+export { CustomerCollection } from './CustomerCollection.js';
+export { FulfillmentCollection } from './FulfillmentCollection.js';
+export { InvoiceCollection, type InvoiceNumberOptions, UNPAID_STATUSES, } from './InvoiceCollection.js';
+export { InvoiceLineItemCollection } from './InvoiceLineItemCollection.js';
+export { PaymentAllocationCollection } from './PaymentAllocationCollection.js';
+export { PaymentCollection } from './PaymentCollection.js';
+export { PaymentIntentCollection, type PaymentIntentIdempotencyArgs, type PaymentIntentSeed, } from './PaymentIntentCollection.js';
+export { type CreatePayoutFromPaymentArgs, PayoutCollection, } from './PayoutCollection.js';
+export { VendorCollection } from './VendorCollection.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/collections/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EACL,iBAAiB,EACjB,KAAK,oBAAoB,EACzB,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EACL,uBAAuB,EACvB,KAAK,4BAA4B,EACjC,KAAK,iBAAiB,GACvB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,KAAK,2BAA2B,EAChC,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { ContractCollection, type CreatePayoutFromPaymentArgs, CustomerCollection, FulfillmentCollection, InvoiceCollection, InvoiceLineItemCollection, type InvoiceNumberOptions, PaymentAllocationCollection, PaymentCollection, PaymentIntentCollection, type PaymentIntentIdempotencyArgs, type PaymentIntentSeed, PayoutCollection, UNPAID_STATUSES, VendorCollection, } from './collections/index.js';
+export { Agreement, Cart, Contract, ContractLineItem, Customer, Estimate, Fulfillment, FulfillmentLineItem, Invoice, InvoiceLineItem, Lease, type LicenseRightsSnapshot, LicenseSale, Order, Payment, PaymentAllocation, PaymentIntent, Payout, ProductionOrder, PurchaseOrder, Vendor, WholesaleOrder, } from './models/index.js';
+export { type Address, ContractStatus, ContractType, CustomerStatus, CustomerType, FulfillmentStatus, FulfillmentType, InvoiceStatus, 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';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AAKH,OAAO,wBAAwB,CAAC;AAGhC,OAAO,EACL,kBAAkB,EAClB,KAAK,2BAA2B,EAChC,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,yBAAyB,EACzB,KAAK,oBAAoB,EACzB,2BAA2B,EAC3B,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,4BAA4B,EACjC,KAAK,iBAAiB,EACtB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAEhC,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,aAAa,EACb,MAAM,EACN,eAAe,EACf,aAAa,EACb,MAAM,EACN,cAAc,GACf,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,KAAK,OAAO,EACZ,cAAc,EACd,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,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"}