@happyvertical/smrt-commerce 0.56.0 → 0.56.1

package/dist/invoice-accounting-sync.d.ts

@@ -0,0 +1,96 @@
+/** Frozen Invoice projection and guarded accounting-provider synchronization. */
+import type { AccountingProvider, QuickBooksCreditMemoRequest, QuickBooksInvoiceRequest } from '@happyvertical/accounting';
+import type { DatabaseInterface } from '@happyvertical/smrt-core/migrations';
+import { type FrozenAccountingDocumentSnapshot, type FrozenQuickBooksTaxMapping } from './accounting-snapshot.js';
+import type { Invoice } from './models/Invoice.js';
+import { type AccountingInvoiceInput } from './types/index.js';
+export interface QuickBooksFrozenInvoiceMapping extends FrozenQuickBooksTaxMapping {
+    readonly realmId: string;
+    readonly environment: 'sandbox' | 'production';
+}
+export interface FrozenInvoiceAccountingOptions {
+    readonly mapping: QuickBooksFrozenInvoiceMapping;
+}
+export interface FrozenInvoiceAccountingInput extends FrozenInvoiceAccountingOptions {
+    readonly db: DatabaseInterface;
+    readonly tenantId: string;
+    readonly invoiceId: string;
+}
+export interface FrozenInvoiceAccountingSnapshot {
+    readonly document: FrozenAccountingDocumentSnapshot;
+    readonly moneySnapshotId: string;
+    readonly creditedInvoiceScope?: Readonly<{
+        provider: 'quickbooks';
+        realmId: string;
+        environment: 'sandbox' | 'production';
+    }>;
+}
+type FrozenSyncStatus = 'in_flight' | 'unknown' | 'rejected' | 'synced';
+export interface FrozenAccountingSyncResult {
+    readonly status: 'synced' | 'unchanged';
+    readonly externalId: string;
+    readonly syncedAt: Date;
+    readonly moneySnapshotId: string;
+}
+export interface SyncFrozenInvoiceToAccountingInput extends FrozenInvoiceAccountingInput {
+    readonly provider: Pick<AccountingProvider, 'type' | 'invoices' | 'creditMemos'>;
+}
+export interface ReconcileFrozenInvoiceAccountingInput extends FrozenInvoiceAccountingInput {
+    /** The request descriptor observed before checking QuickBooks. */
+    readonly requestId: string;
+    /** The unresolved local owner observed with that request descriptor. */
+    readonly attemptId: string;
+    /**
+     * Required only for an interrupted `in_flight` record. The trusted server
+     * caller must first establish that the original process/request owner can no
+     * longer complete. A provider lookup reporting absence is not sufficient.
+     */
+    readonly confirmInterruptedOwnerStopped?: true;
+    /**
+     * The authoritative result of looking up that request in QuickBooks.
+     * `absent` means QuickBooks confirmed that no document was created.
+     */
+    readonly outcome: {
+        readonly status: 'found';
+        readonly externalId: string;
+        readonly syncedAt: Date;
+    } | {
+        readonly status: 'absent';
+    };
+}
+export interface FrozenAccountingReconciliationReady {
+    readonly status: 'ready';
+    readonly moneySnapshotId: string;
+    readonly requestId: string;
+}
+/** Load and validate one authoritative issued snapshot without provider I/O. */
+export declare function loadFrozenInvoiceAccountingSnapshot(input: Omit<FrozenInvoiceAccountingInput, 'mapping'>): Promise<FrozenInvoiceAccountingSnapshot>;
+/** Convert authoritative persisted facts into the released SDK invoice shape. */
+export declare function toFrozenInvoiceAccountingInput(input: FrozenInvoiceAccountingInput): Promise<AccountingInvoiceInput>;
+/**
+ * Push one frozen invoice exactly once per provider/realm/environment/snapshot.
+ * Local and remote writes are intentionally separate phases. An unknown remote
+ * outcome is persisted and requires reconciliation instead of a blind replay.
+ */
+export declare function syncFrozenInvoiceToAccounting(input: SyncFrozenInvoiceToAccountingInput): Promise<FrozenAccountingSyncResult>;
+/**
+ * Record an authoritative QuickBooks lookup after an unknown/interrupted push.
+ * The caller must first query the exact persisted request descriptor and must
+ * only report `absent` when the provider confirms that no document exists.
+ */
+export declare function reconcileFrozenInvoiceAccountingSync(input: ReconcileFrozenInvoiceAccountingInput): Promise<FrozenAccountingSyncResult | FrozenAccountingReconciliationReady>;
+/** Read the persisted coordination state for diagnostics/reconciliation. */
+export declare function readFrozenAccountingSyncState(invoice: Invoice): Readonly<{
+    status: FrozenSyncStatus;
+    provider: string;
+    realmId: string;
+    environment: string;
+    moneySnapshotId: string;
+    requestId: string;
+    attemptId: string;
+    startedAt: string;
+    documentKind: 'invoice' | 'creditMemo';
+    request: QuickBooksInvoiceRequest | QuickBooksCreditMemoRequest;
+}> | null;
+export {};
+//# sourceMappingURL=invoice-accounting-sync.d.ts.map

package/dist/invoice-accounting-sync.d.ts.map

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

package/dist/invoice-mcp.d.ts

@@ -0,0 +1,16 @@
+/** Stored-money projection for the generated Invoice MCP get tool. */
+import type { PublicJsonOptions } from '@happyvertical/smrt-core';
+import { getInvoiceMoneyFacts } from './document-money.js';
+import type { Invoice } from './models/Invoice.js';
+export type InvoiceMcpGetResult = Record<string, unknown> & {
+    money?: Awaited<ReturnType<typeof getInvoiceMoneyFacts>>;
+};
+/**
+ * Serialize one already-authorized Invoice get response.
+ *
+ * Legacy tenants keep the ordinary public Invoice shape. Money-v2 tenants get
+ * the authoritative stored snapshot and DocumentTax rows under `money`; this
+ * function never resolves current tax codes or recalculates totals.
+ */
+export declare function serializeInvoiceMcpGet(invoice: Invoice, options?: PublicJsonOptions): Promise<InvoiceMcpGetResult>;
+//# sourceMappingURL=invoice-mcp.d.ts.map

package/dist/invoice-mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-mcp.d.ts","sourceRoot":"","sources":["../src/invoice-mcp.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAEtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAIlE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAInD,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAC1D,KAAK,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC;CAC1D,CAAC;AAsFF;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,CAuC9B"}

package/dist/invoice-posting.d.ts

@@ -0,0 +1,9 @@
+/** Atomic money-v2 revenue posting and cancellation reversal. */
+import type { Journal } from '@happyvertical/smrt-ledgers';
+import type { Invoice } from './models/Invoice.js';
+import { type CancelRevenueOptions, type RecognizeRevenueOptions } from './types/index.js';
+/** Return null for legacy tenants so Invoice can preserve its old path. */
+export declare function recognizeInvoiceRevenueV2(input: Invoice, options: RecognizeRevenueOptions): Promise<Journal | null>;
+/** Atomically reverse a posted v2 invoice and move it to CANCELLED. */
+export declare function cancelInvoiceWithRevenueReversal(input: Invoice, options: CancelRevenueOptions): Promise<Journal | null>;
+//# sourceMappingURL=invoice-posting.d.ts.map

package/dist/invoice-posting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-posting.d.ts","sourceRoot":"","sources":["../src/invoice-posting.ts"],"names":[],"mappings":"AAAA,iEAAiE;AAGjE,OAAO,KAAK,EAAE,OAAO,EAAoB,MAAM,6BAA6B,CAAC;AAW7E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAInD,OAAO,EACL,KAAK,oBAAoB,EAEzB,KAAK,uBAAuB,EAC7B,MAAM,kBAAkB,CAAC;AAgK1B,2EAA2E;AAC3E,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CA0GzB;AA6BD,uEAAuE;AACvE,wBAAsB,gCAAgC,CACpD,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAsHzB"}

package/dist/invoice-record-screen.d.ts

@@ -0,0 +1,60 @@
+/** Commerce composition data for the generic record screen. */
+import type { DatabaseInterface } from '@happyvertical/smrt-core/migrations';
+import { type InvoiceMoneyFacts } from './document-money.js';
+/** A frozen component row shaped for `RecordScreen.lineItemStoredTotals`. */
+export interface InvoiceRecordTaxComponent {
+    taxComponentId: string;
+    name: string;
+    percent: string;
+    taxable: number;
+    tax: number;
+}
+/** The immutable totals projection that the generic record widget displays. */
+export interface InvoiceRecordStoredTotals {
+    subtotal: number;
+    discount: number;
+    tax: number;
+    total: number;
+    lineAmountType: 'exclusive' | 'inclusive' | 'none';
+    roundingScope: 'line' | 'document';
+    showNetSubtotal: boolean;
+    taxes: readonly InvoiceRecordTaxComponent[];
+}
+/** A credit-note summary safe to show beside its source invoice. */
+export interface InvoiceRecordCreditNote {
+    id: string;
+    invoiceNumber: string;
+    status: string;
+    issueDate: string;
+    totalMinor: number;
+}
+/** Tenant-scoped, stored-only data for an invoice record screen. */
+export interface InvoiceRecordScreenData {
+    invoiceId: string;
+    kind: InvoiceMoneyFacts['kind'];
+    status: InvoiceMoneyFacts['status'];
+    currency: string;
+    storedTotals: InvoiceRecordStoredTotals;
+    creditNotes: readonly InvoiceRecordCreditNote[];
+}
+export interface LoadInvoiceRecordScreenDataInput {
+    db: DatabaseInterface;
+    tenantId: string;
+    invoiceId: string;
+    /** Hosts choose whether inclusive taxed records disclose their net subtotal. */
+    showNetSubtotal?: boolean;
+}
+/**
+ * Maps only persisted invoice and `DocumentTax` fields to the generic widget
+ * contract. No tax, discount, or total is calculated here.
+ */
+export declare function invoiceRecordStoredTotals(facts: InvoiceMoneyFacts, options?: {
+    showNetSubtotal?: boolean;
+}): InvoiceRecordStoredTotals;
+/**
+ * Loads a v2 invoice's frozen record-screen data in one tenant money read
+ * scope. Callers must already be executing for the same tenant; this helper
+ * never switches a principal from its supplied id.
+ */
+export declare function loadInvoiceRecordScreenData(input: LoadInvoiceRecordScreenDataInput): Promise<InvoiceRecordScreenData>;
+//# sourceMappingURL=invoice-record-screen.d.ts.map

package/dist/invoice-record-screen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-record-screen.d.ts","sourceRoot":"","sources":["../src/invoice-record-screen.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAE/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAG7E,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,qBAAqB,CAAC;AAI7B,6EAA6E;AAC7E,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,+EAA+E;AAC/E,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,WAAW,GAAG,WAAW,GAAG,MAAM,CAAC;IACnD,aAAa,EAAE,MAAM,GAAG,UAAU,CAAC;IACnC,eAAe,EAAE,OAAO,CAAC;IACzB,KAAK,EAAE,SAAS,yBAAyB,EAAE,CAAC;CAC7C;AAED,oEAAoE;AACpE,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,oEAAoE;AACpE,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,yBAAyB,CAAC;IACxC,WAAW,EAAE,SAAS,uBAAuB,EAAE,CAAC;CACjD;AAED,MAAM,WAAW,gCAAgC;IAC/C,EAAE,EAAE,iBAAiB,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AA8BD;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,iBAAiB,EACxB,OAAO,GAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAO,GAC1C,yBAAyB,CAuB3B;AAED;;;;GAIG;AACH,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,gCAAgC,GACtC,OAAO,CAAC,uBAAuB,CAAC,CA2ClC"}

package/dist/invoices.d.ts

@@ -1,3 +1,5 @@
 /** Svelte-free invoice draft calculation and validation for server handlers. */
+export type { MoneyValidationCode } from './money.js';
+export { MoneyValidationError } from './money.js';
 export * from './svelte/invoices/calculations.js';
 //# sourceMappingURL=invoices.d.ts.map

package/dist/invoices.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"invoices.d.ts","sourceRoot":"","sources":["../src/invoices.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,cAAc,mCAAmC,CAAC"}
+{"version":3,"file":"invoices.d.ts","sourceRoot":"","sources":["../src/invoices.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAEhF,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,cAAc,mCAAmC,CAAC"}

package/dist/invoices.js

@@ -1,2 +1,3 @@
-import { i as resolveInvoiceLineDraft, n as calculateInvoiceLine, r as calculateInvoiceMinorLine, t as calculateInvoiceDraft } from "./chunks/calculations-Bz7RB3qK.js";
-export { calculateInvoiceDraft, calculateInvoiceLine, calculateInvoiceMinorLine, resolveInvoiceLineDraft };
+import { i as resolveInvoiceLineDraft, n as calculateInvoiceLine, r as calculateInvoiceMinorLine, t as calculateInvoiceDraft } from "./chunks/calculations-DaHR17il.js";
+import { MoneyValidationError } from "./money.js";
+export { MoneyValidationError, calculateInvoiceDraft, calculateInvoiceLine, calculateInvoiceMinorLine, resolveInvoiceLineDraft };