@voyantjs/finance 0.52.1 → 0.52.3

package/dist/service-bookings-dual-create.d.ts

@@ -6,8 +6,18 @@ import { type BookingCreateOutcome, type BookingCreateResult } from "./service-b
 export declare const dualCreateBookingSchema: z.ZodObject<{
     primary: z.ZodObject<{
         organizationId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
-        bookingNumber: z.ZodString;
         personId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        bookingNumber: z.ZodString;
+        contactFirstName: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactLastName: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactEmail: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactPhone: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactPreferredLanguage: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactCountry: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactRegion: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactCity: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactAddressLine1: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactPostalCode: z.ZodNullable<z.ZodOptional<z.ZodString>>;
         internalNotes: z.ZodNullable<z.ZodOptional<z.ZodString>>;
         productId: z.ZodString;
         optionId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
@@ -23,8 +33,8 @@ export declare const dualCreateBookingSchema: z.ZodObject<{
                 occupant: "occupant";
             }>>;
             travelerCategory: z.ZodNullable<z.ZodOptional<z.ZodEnum<{
-                child: "child";
                 other: "other";
+                child: "child";
                 adult: "adult";
                 infant: "infant";
                 senior: "senior";
@@ -40,6 +50,16 @@ export declare const dualCreateBookingSchema: z.ZodObject<{
         catalogSellAmountCents: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
         confirmedSellAmountCents: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
         priceOverrideReason: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        initialStatus: z.ZodOptional<z.ZodEnum<{
+            expired: "expired";
+            cancelled: "cancelled";
+            completed: "completed";
+            draft: "draft";
+            on_hold: "on_hold";
+            awaiting_payment: "awaiting_payment";
+            confirmed: "confirmed";
+            in_progress: "in_progress";
+        }>>;
         itemLines: z.ZodOptional<z.ZodArray<z.ZodObject<{
             optionUnitId: z.ZodString;
             quantity: z.ZodNumber;
@@ -48,6 +68,7 @@ export declare const dualCreateBookingSchema: z.ZodObject<{
             unitSellAmountCents: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
             totalSellAmountCents: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
         }, z.core.$strip>>>;
+        suppressNotifications: z.ZodOptional<z.ZodBoolean>;
         paymentSchedules: z.ZodOptional<z.ZodArray<z.ZodObject<{
             scheduleType: z.ZodDefault<z.ZodEnum<{
                 other: "other";
@@ -57,9 +78,9 @@ export declare const dualCreateBookingSchema: z.ZodObject<{
                 hold: "hold";
             }>>;
             status: z.ZodDefault<z.ZodEnum<{
-                pending: "pending";
-                cancelled: "cancelled";
                 expired: "expired";
+                cancelled: "cancelled";
+                pending: "pending";
                 paid: "paid";
                 due: "due";
                 waived: "waived";
@@ -80,8 +101,18 @@ export declare const dualCreateBookingSchema: z.ZodObject<{
     }, z.core.$strip>;
     secondary: z.ZodObject<{
         organizationId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
-        bookingNumber: z.ZodString;
         personId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        bookingNumber: z.ZodString;
+        contactFirstName: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactLastName: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactEmail: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactPhone: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactPreferredLanguage: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactCountry: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactRegion: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactCity: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactAddressLine1: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactPostalCode: z.ZodNullable<z.ZodOptional<z.ZodString>>;
         internalNotes: z.ZodNullable<z.ZodOptional<z.ZodString>>;
         productId: z.ZodString;
         optionId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
@@ -97,8 +128,8 @@ export declare const dualCreateBookingSchema: z.ZodObject<{
                 occupant: "occupant";
             }>>;
             travelerCategory: z.ZodNullable<z.ZodOptional<z.ZodEnum<{
-                child: "child";
                 other: "other";
+                child: "child";
                 adult: "adult";
                 infant: "infant";
                 senior: "senior";
@@ -114,6 +145,16 @@ export declare const dualCreateBookingSchema: z.ZodObject<{
         catalogSellAmountCents: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
         confirmedSellAmountCents: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
         priceOverrideReason: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        initialStatus: z.ZodOptional<z.ZodEnum<{
+            expired: "expired";
+            cancelled: "cancelled";
+            completed: "completed";
+            draft: "draft";
+            on_hold: "on_hold";
+            awaiting_payment: "awaiting_payment";
+            confirmed: "confirmed";
+            in_progress: "in_progress";
+        }>>;
         itemLines: z.ZodOptional<z.ZodArray<z.ZodObject<{
             optionUnitId: z.ZodString;
             quantity: z.ZodNumber;
@@ -122,6 +163,7 @@ export declare const dualCreateBookingSchema: z.ZodObject<{
             unitSellAmountCents: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
             totalSellAmountCents: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
         }, z.core.$strip>>>;
+        suppressNotifications: z.ZodOptional<z.ZodBoolean>;
         paymentSchedules: z.ZodOptional<z.ZodArray<z.ZodObject<{
             scheduleType: z.ZodDefault<z.ZodEnum<{
                 other: "other";
@@ -131,9 +173,9 @@ export declare const dualCreateBookingSchema: z.ZodObject<{
                 hold: "hold";
             }>>;
             status: z.ZodDefault<z.ZodEnum<{
-                pending: "pending";
-                cancelled: "cancelled";
                 expired: "expired";
+                cancelled: "cancelled";
+                pending: "pending";
                 paid: "paid";
                 due: "due";
                 waived: "waived";

package/dist/service-bookings-dual-create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service-bookings-dual-create.d.ts","sourceRoot":"","sources":["../src/service-bookings-dual-create.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AACjF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EAGzB,MAAM,6BAA6B,CAAA;AAkBpC,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIlC,CAAA;AAEF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAI5E,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAA;IACf,gBAAgB,EAAE,MAAM,CAAA;IACxB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,UAAU,EAAE,IAAI,CAAA;CACjB;AAID,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,mBAAmB,CAAA;IAC5B,SAAS,EAAE,mBAAmB,CAAA;IAC9B,KAAK,EAAE,YAAY,CAAA;IACnB,aAAa,EAAE,kBAAkB,CAAA;IACjC,eAAe,EAAE,kBAAkB,CAAA;CACpC;AAED,MAAM,MAAM,wBAAwB,GAChC;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,uBAAuB,CAAA;CAAE,GACjD;IACE,MAAM,EAAE,gBAAgB,GAAG,kBAAkB,CAAA;IAC7C,MAAM,EAAE,OAAO,CAAC,oBAAoB,EAAE;QAAE,MAAM,EAAE,IAAI,CAAA;KAAE,CAAC,CAAA;CACxD,CAAA;AAqBL;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,kBAAkB,EACtB,QAAQ,EAAE,sBAAsB,EAChC,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,wBAAwB,CAAA;CAC9B,GACL,OAAO,CAAC,wBAAwB,CAAC,CAkFnC"}
+{"version":3,"file":"service-bookings-dual-create.d.ts","sourceRoot":"","sources":["../src/service-bookings-dual-create.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AACjF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EAGzB,MAAM,6BAA6B,CAAA;AAkBpC,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIlC,CAAA;AAEF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAI5E,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAA;IACf,gBAAgB,EAAE,MAAM,CAAA;IACxB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,UAAU,EAAE,IAAI,CAAA;CACjB;AAID,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,mBAAmB,CAAA;IAC5B,SAAS,EAAE,mBAAmB,CAAA;IAC9B,KAAK,EAAE,YAAY,CAAA;IACnB,aAAa,EAAE,kBAAkB,CAAA;IACjC,eAAe,EAAE,kBAAkB,CAAA;CACpC;AAED,MAAM,MAAM,wBAAwB,GAChC;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,uBAAuB,CAAA;CAAE,GACjD;IACE,MAAM,EAAE,gBAAgB,GAAG,kBAAkB,CAAA;IAC7C,MAAM,EAAE,OAAO,CAAC,oBAAoB,EAAE;QAAE,MAAM,EAAE,IAAI,CAAA;KAAE,CAAC,CAAA;CACxD,CAAA;AAqBL;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,kBAAkB,EACtB,QAAQ,EAAE,sBAAsB,EAChC,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,wBAAwB,CAAA;CAC9B,GACL,OAAO,CAAC,wBAAwB,CAAC,CAkFnC"}

package/dist/service-issue.d.ts

@@ -1,5 +1,7 @@
+import { type ActionLedgerRequestContextValues } from "@voyantjs/action-ledger";
 import type { EventBus } from "@voyantjs/core";
 import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+import { invoices } from "./schema.js";
 import { type CreateInvoiceFromBookingInput, type InvoiceFromBookingData } from "./service.js";
 /**
  * Issue / proforma orchestration helpers that wrap the bare invoice
@@ -12,6 +14,8 @@ import { type CreateInvoiceFromBookingInput, type InvoiceFromBookingData } from
  */
 export interface InvoiceIssueRuntime {
     eventBus?: EventBus;
+    actionLedgerContext?: ActionLedgerRequestContextValues;
+    actionLedgerAuthorizationSource?: string | null;
 }
 export interface InvoiceIssuedEvent {
     invoiceId: string;
@@ -52,17 +56,14 @@ export interface InvoiceIssuedLineItem {
  */
 export declare function issueInvoiceFromBooking(db: PostgresJsDatabase, input: CreateInvoiceFromBookingInput, bookingData: InvoiceFromBookingData, runtime?: InvoiceIssueRuntime): Promise<{
     id: string;
-    createdAt: Date;
-    updatedAt: Date;
+    status: "draft" | "sent" | "partially_paid" | "paid" | "overdue" | "void";
     organizationId: string | null;
-    status: "void" | "draft" | "sent" | "partially_paid" | "paid" | "overdue";
-    issueDate: string;
+    createdAt: Date;
     currency: string;
     notes: string | null;
+    updatedAt: Date;
     bookingId: string;
     personId: string | null;
-    baseCurrency: string | null;
-    fxRateSetId: string | null;
     invoiceNumber: string;
     invoiceType: "invoice" | "proforma" | "credit_note";
     convertedFromInvoiceId: string | null;
@@ -71,6 +72,8 @@ export declare function issueInvoiceFromBooking(db: PostgresJsDatabase, input: C
     templateId: string | null;
     taxRegimeId: string | null;
     language: string | null;
+    baseCurrency: string | null;
+    fxRateSetId: string | null;
     subtotalCents: number;
     baseSubtotalCents: number | null;
     taxCents: number;
@@ -83,6 +86,7 @@ export declare function issueInvoiceFromBooking(db: PostgresJsDatabase, input: C
     baseBalanceDueCents: number | null;
     commissionPercent: number | null;
     commissionAmountCents: number | null;
+    issueDate: string;
     dueDate: string;
 } | null>;
 /**
@@ -93,17 +97,14 @@ export declare function issueInvoiceFromBooking(db: PostgresJsDatabase, input: C
  */
 export declare function issueProformaFromBooking(db: PostgresJsDatabase, input: CreateInvoiceFromBookingInput, bookingData: InvoiceFromBookingData, runtime?: InvoiceIssueRuntime): Promise<{
     id: string;
-    createdAt: Date;
-    updatedAt: Date;
+    status: "draft" | "sent" | "partially_paid" | "paid" | "overdue" | "void";
     organizationId: string | null;
-    status: "void" | "draft" | "sent" | "partially_paid" | "paid" | "overdue";
-    issueDate: string;
+    createdAt: Date;
     currency: string;
     notes: string | null;
+    updatedAt: Date;
     bookingId: string;
     personId: string | null;
-    baseCurrency: string | null;
-    fxRateSetId: string | null;
     invoiceNumber: string;
     invoiceType: "invoice" | "proforma" | "credit_note";
     convertedFromInvoiceId: string | null;
@@ -112,6 +113,8 @@ export declare function issueProformaFromBooking(db: PostgresJsDatabase, input:
     templateId: string | null;
     taxRegimeId: string | null;
     language: string | null;
+    baseCurrency: string | null;
+    fxRateSetId: string | null;
     subtotalCents: number;
     baseSubtotalCents: number | null;
     taxCents: number;
@@ -124,6 +127,33 @@ export declare function issueProformaFromBooking(db: PostgresJsDatabase, input:
     baseBalanceDueCents: number | null;
     commissionPercent: number | null;
     commissionAmountCents: number | null;
+    issueDate: string;
     dueDate: string;
 } | null>;
+/**
+ * Convert an issued proforma into a final invoice. Copies the proforma's
+ * line items verbatim (totals + taxes already match the booking the
+ * customer accepted) and voids the proforma so it stops counting against
+ * outstanding balances. The new invoice carries `convertedFromInvoiceId`
+ * so the audit chain is preserved; downstream subscribers (SmartBill
+ * etc.) see the linkage on the emitted `invoice.issued` event.
+ *
+ * Number derivation: `PRO-` prefix → `INV-`; otherwise the original
+ * number is suffixed with `-INV`. Callers can override via the optional
+ * `invoiceNumber` argument when they want a series-derived number.
+ */
+export declare function convertProformaToInvoice(db: PostgresJsDatabase, proformaId: string, options?: {
+    invoiceNumber?: string;
+    issueDate?: string;
+    dueDate?: string;
+}, runtime?: InvoiceIssueRuntime): Promise<{
+    status: "ok";
+    invoice: typeof invoices.$inferSelect;
+} | {
+    status: "not_found";
+} | {
+    status: "not_proforma";
+} | {
+    status: "already_converted";
+}>;
 //# sourceMappingURL=service-issue.d.ts.map

package/dist/service-issue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service-issue.d.ts","sourceRoot":"","sources":["../src/service-issue.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAE9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAGjE,OAAO,EACL,KAAK,6BAA6B,EAElC,KAAK,sBAAsB,EAC5B,MAAM,cAAc,CAAA;AAErB;;;;;;;;GAQG;AAEH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,SAAS,GAAG,UAAU,GAAG,aAAa,CAAA;IACnD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,qDAAqD;IACrD,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,SAAS,CAAC,EAAE,qBAAqB,EAAE,CAAA;IACnC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAKD;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,EAAE,EAAE,kBAAkB,EACtB,KAAK,EAAE,6BAA6B,EACpC,WAAW,EAAE,sBAAsB,EACnC,OAAO,GAAE,mBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAclC;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,EAAE,EAAE,kBAAkB,EACtB,KAAK,EAAE,6BAA6B,EACpC,WAAW,EAAE,sBAAsB,EACnC,OAAO,GAAE,mBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAclC"}
+{"version":3,"file":"service-issue.d.ts","sourceRoot":"","sources":["../src/service-issue.ts"],"names":[],"mappings":"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"}

package/dist/service-issue.js

@@ -1,7 +1,8 @@
+import { appendActionLedgerMutation, } from "@voyantjs/action-ledger";
 import { bookings } from "@voyantjs/bookings/schema";
 import { asc, eq } from "drizzle-orm";
-import { invoiceLineItems, invoices } from "./schema.js";
-import { financeService, } from "./service.js";
+import { invoiceLineItems, invoices, payments } from "./schema.js";
+import { buildInvoiceIssuedActionLedgerInput, financeService, } from "./service.js";
 const ISSUED_EVENT = "invoice.issued";
 const PROFORMA_ISSUED_EVENT = "invoice.proforma.issued";
 /**
@@ -14,11 +15,21 @@ export async function issueInvoiceFromBooking(db, input, bookingData, runtime =
     const draft = await financeService.createInvoiceFromBooking(db, input, bookingData);
     if (!draft)
         return null;
-    const [issued] = await db
+    const updateIssuedInvoice = (writer) => writer
         .update(invoices)
         .set({ status: "sent", updatedAt: new Date() })
         .where(eq(invoices.id, draft.id))
         .returning();
+    const actionLedgerContext = runtime.actionLedgerContext;
+    const issued = actionLedgerContext
+        ? await db.transaction(async (tx) => {
+            const [row] = await updateIssuedInvoice(tx);
+            if (row) {
+                await appendActionLedgerMutation(tx, await buildInvoiceIssuedActionLedgerInput(actionLedgerContext, { invoice: row }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+            }
+            return row;
+        })
+        : (await updateIssuedInvoice(db))[0];
     const row = issued ?? draft;
     await emitIssued(db, runtime, ISSUED_EVENT, row);
     return row;
@@ -33,11 +44,21 @@ export async function issueProformaFromBooking(db, input, bookingData, runtime =
     const draft = await financeService.createInvoiceFromBooking(db, input, bookingData);
     if (!draft)
         return null;
-    const [issued] = await db
+    const updateIssuedInvoice = (writer) => writer
         .update(invoices)
         .set({ invoiceType: "proforma", status: "sent", updatedAt: new Date() })
         .where(eq(invoices.id, draft.id))
         .returning();
+    const actionLedgerContext = runtime.actionLedgerContext;
+    const issued = actionLedgerContext
+        ? await db.transaction(async (tx) => {
+            const [row] = await updateIssuedInvoice(tx);
+            if (row) {
+                await appendActionLedgerMutation(tx, await buildInvoiceIssuedActionLedgerInput(actionLedgerContext, { invoice: row }, { authorizationSource: runtime.actionLedgerAuthorizationSource }));
+            }
+            return row;
+        })
+        : (await updateIssuedInvoice(db))[0];
     const row = issued ?? draft;
     await emitIssued(db, runtime, PROFORMA_ISSUED_EVENT, row);
     return row;
@@ -84,6 +105,122 @@ async function emitIssued(db, runtime, eventName, invoice) {
     };
     await runtime.eventBus.emit(eventName, payload);
 }
+/**
+ * Convert an issued proforma into a final invoice. Copies the proforma's
+ * line items verbatim (totals + taxes already match the booking the
+ * customer accepted) and voids the proforma so it stops counting against
+ * outstanding balances. The new invoice carries `convertedFromInvoiceId`
+ * so the audit chain is preserved; downstream subscribers (SmartBill
+ * etc.) see the linkage on the emitted `invoice.issued` event.
+ *
+ * Number derivation: `PRO-` prefix → `INV-`; otherwise the original
+ * number is suffixed with `-INV`. Callers can override via the optional
+ * `invoiceNumber` argument when they want a series-derived number.
+ */
+export async function convertProformaToInvoice(db, proformaId, options = {}, runtime = {}) {
+    const [proforma] = await db.select().from(invoices).where(eq(invoices.id, proformaId)).limit(1);
+    if (!proforma)
+        return { status: "not_found" };
+    if (proforma.invoiceType !== "proforma")
+        return { status: "not_proforma" };
+    if (proforma.status === "void")
+        return { status: "already_converted" };
+    const [existing] = await db
+        .select({ id: invoices.id })
+        .from(invoices)
+        .where(eq(invoices.convertedFromInvoiceId, proformaId))
+        .limit(1);
+    if (existing)
+        return { status: "already_converted" };
+    const lineItems = await db
+        .select()
+        .from(invoiceLineItems)
+        .where(eq(invoiceLineItems.invoiceId, proformaId))
+        .orderBy(asc(invoiceLineItems.sortOrder));
+    const newInvoiceNumber = options.invoiceNumber ?? deriveInvoiceNumberFromProforma(proforma.invoiceNumber);
+    const todayIso = new Date().toISOString().slice(0, 10);
+    const issueDate = options.issueDate ?? todayIso;
+    const dueDate = options.dueDate ?? toDateString(proforma.dueDate);
+    const created = await db.transaction(async (tx) => {
+        const [inserted] = await tx
+            .insert(invoices)
+            .values({
+            invoiceNumber: newInvoiceNumber,
+            invoiceType: "invoice",
+            convertedFromInvoiceId: proforma.id,
+            seriesId: proforma.seriesId,
+            templateId: proforma.templateId,
+            taxRegimeId: proforma.taxRegimeId,
+            language: proforma.language,
+            bookingId: proforma.bookingId,
+            personId: proforma.personId,
+            organizationId: proforma.organizationId,
+            status: "sent",
+            currency: proforma.currency,
+            baseCurrency: proforma.baseCurrency,
+            fxRateSetId: proforma.fxRateSetId,
+            subtotalCents: proforma.subtotalCents,
+            baseSubtotalCents: proforma.baseSubtotalCents,
+            taxCents: proforma.taxCents,
+            baseTaxCents: proforma.baseTaxCents,
+            totalCents: proforma.totalCents,
+            baseTotalCents: proforma.baseTotalCents,
+            // Carry the proforma's settled amounts forward — a partially
+            // (or fully) paid proforma must convert to an invoice that
+            // reflects those payments, otherwise the new invoice shows the
+            // full total as outstanding and the payment rows reassigned
+            // below would orphan the balance.
+            paidCents: proforma.paidCents,
+            basePaidCents: proforma.basePaidCents,
+            balanceDueCents: proforma.totalCents - proforma.paidCents,
+            baseBalanceDueCents: proforma.baseTotalCents !== null && proforma.basePaidCents !== null
+                ? proforma.baseTotalCents - proforma.basePaidCents
+                : proforma.baseTotalCents,
+            commissionPercent: proforma.commissionPercent,
+            commissionAmountCents: proforma.commissionAmountCents,
+            issueDate,
+            dueDate,
+            notes: proforma.notes,
+        })
+            .returning();
+        if (!inserted)
+            return null;
+        if (lineItems.length > 0) {
+            await tx.insert(invoiceLineItems).values(lineItems.map((line) => ({
+                invoiceId: inserted.id,
+                bookingItemId: line.bookingItemId,
+                description: line.description,
+                quantity: line.quantity,
+                unitPriceCents: line.unitPriceCents,
+                totalCents: line.totalCents,
+                taxRate: line.taxRate,
+                sortOrder: line.sortOrder,
+            })));
+        }
+        // Reassign payments off the proforma so they don't sit attached to
+        // a void document. The proforma's payment rows become the final
+        // invoice's payment history.
+        await tx
+            .update(payments)
+            .set({ invoiceId: inserted.id, updatedAt: new Date() })
+            .where(eq(payments.invoiceId, proforma.id));
+        await tx
+            .update(invoices)
+            .set({ status: "void", updatedAt: new Date() })
+            .where(eq(invoices.id, proforma.id));
+        return inserted;
+    });
+    if (!created)
+        return { status: "not_found" };
+    await emitIssued(db, runtime, ISSUED_EVENT, created);
+    return { status: "ok", invoice: created };
+}
+function deriveInvoiceNumberFromProforma(proformaNumber) {
+    if (/^PRO-/i.test(proformaNumber)) {
+        return proformaNumber.replace(/^PRO-/i, "INV-");
+    }
+    return `${proformaNumber}-INV`;
+}
 function buildClientName(booking) {
     const name = [booking?.contactFirstName, booking?.contactLastName]
         .filter((part) => typeof part === "string" && part.length > 0)

package/dist/service-public.d.ts

@@ -13,8 +13,8 @@ export declare const publicFinanceService: {
             id: string;
             label: string;
             provider: string | null;
-            instrumentType: "other" | "voucher" | "wallet" | "credit_card" | "debit_card" | "cash" | "direct_bill" | "bank_account";
-            status: "active" | "expired" | "revoked" | "inactive" | "failed_verification";
+            instrumentType: "credit_card" | "debit_card" | "cash" | "wallet" | "direct_bill" | "voucher" | "other" | "bank_account";
+            status: "expired" | "active" | "inactive" | "revoked" | "failed_verification";
             brand: string | null;
             last4: string | null;
             expiryMonth: number | null;
@@ -24,7 +24,7 @@ export declare const publicFinanceService: {
         schedules: {
             id: string;
             scheduleType: "other" | "deposit" | "installment" | "balance" | "hold";
-            status: "pending" | "cancelled" | "expired" | "paid" | "due" | "waived";
+            status: "expired" | "cancelled" | "pending" | "paid" | "due" | "waived";
             dueDate: string;
             currency: string;
             amountCents: number;
@@ -33,8 +33,8 @@ export declare const publicFinanceService: {
         guarantees: {
             id: string;
             bookingPaymentScheduleId: string | null;
-            guaranteeType: "other" | "voucher" | "bank_transfer" | "credit_card" | "deposit" | "preauth" | "card_on_file" | "agency_letter";
-            status: "pending" | "failed" | "cancelled" | "active" | "expired" | "released";
+            guaranteeType: "bank_transfer" | "credit_card" | "voucher" | "other" | "deposit" | "preauth" | "card_on_file" | "agency_letter";
+            status: "failed" | "expired" | "cancelled" | "pending" | "active" | "released";
             currency: string | null;
             amountCents: number | null;
             provider: string | null;
@@ -56,7 +56,7 @@ export declare const publicFinanceService: {
         invoiceId: string | null;
         bookingPaymentScheduleId: string | null;
         bookingGuaranteeId: string | null;
-        status: "pending" | "failed" | "cancelled" | "expired" | "paid" | "requires_redirect" | "processing" | "authorized";
+        status: "failed" | "expired" | "cancelled" | "pending" | "processing" | "paid" | "requires_redirect" | "authorized";
         provider: string | null;
         providerSessionId: string | null;
         providerPaymentId: string | null;
@@ -64,7 +64,7 @@ export declare const publicFinanceService: {
         clientReference: string | null;
         currency: string;
         amountCents: number;
-        paymentMethod: "other" | "voucher" | "wallet" | "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "direct_bill" | null;
+        paymentMethod: "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "wallet" | "direct_bill" | "voucher" | "other" | null;
         payerEmail: string | null;
         payerName: string | null;
         redirectUrl: string | null;
@@ -85,7 +85,7 @@ export declare const publicFinanceService: {
         invoiceId: string | null;
         bookingPaymentScheduleId: string | null;
         bookingGuaranteeId: string | null;
-        status: "pending" | "failed" | "cancelled" | "expired" | "paid" | "requires_redirect" | "processing" | "authorized";
+        status: "failed" | "expired" | "cancelled" | "pending" | "processing" | "paid" | "requires_redirect" | "authorized";
         provider: string | null;
         providerSessionId: string | null;
         providerPaymentId: string | null;
@@ -93,7 +93,7 @@ export declare const publicFinanceService: {
         clientReference: string | null;
         currency: string;
         amountCents: number;
-        paymentMethod: "other" | "voucher" | "wallet" | "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "direct_bill" | null;
+        paymentMethod: "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "wallet" | "direct_bill" | "voucher" | "other" | null;
         payerEmail: string | null;
         payerName: string | null;
         redirectUrl: string | null;
@@ -113,7 +113,7 @@ export declare const publicFinanceService: {
         invoiceId: string | null;
         bookingPaymentScheduleId: string | null;
         bookingGuaranteeId: string | null;
-        status: "pending" | "failed" | "cancelled" | "expired" | "paid" | "requires_redirect" | "processing" | "authorized";
+        status: "failed" | "expired" | "cancelled" | "pending" | "processing" | "paid" | "requires_redirect" | "authorized";
         provider: string | null;
         providerSessionId: string | null;
         providerPaymentId: string | null;
@@ -121,7 +121,7 @@ export declare const publicFinanceService: {
         clientReference: string | null;
         currency: string;
         amountCents: number;
-        paymentMethod: "other" | "voucher" | "wallet" | "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "direct_bill" | null;
+        paymentMethod: "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "wallet" | "direct_bill" | "voucher" | "other" | null;
         payerEmail: string | null;
         payerName: string | null;
         redirectUrl: string | null;
@@ -141,7 +141,7 @@ export declare const publicFinanceService: {
         invoiceId: string | null;
         bookingPaymentScheduleId: string | null;
         bookingGuaranteeId: string | null;
-        status: "pending" | "failed" | "cancelled" | "expired" | "paid" | "requires_redirect" | "processing" | "authorized";
+        status: "failed" | "expired" | "cancelled" | "pending" | "processing" | "paid" | "requires_redirect" | "authorized";
         provider: string | null;
         providerSessionId: string | null;
         providerPaymentId: string | null;
@@ -149,7 +149,7 @@ export declare const publicFinanceService: {
         clientReference: string | null;
         currency: string;
         amountCents: number;
-        paymentMethod: "other" | "voucher" | "wallet" | "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "direct_bill" | null;
+        paymentMethod: "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "wallet" | "direct_bill" | "voucher" | "other" | null;
         payerEmail: string | null;
         payerName: string | null;
         redirectUrl: string | null;

package/dist/service-vouchers.d.ts

@@ -25,7 +25,7 @@ export declare const vouchersService: {
             id: string;
             code: string;
             seriesCode: string | null;
-            status: "void" | "active" | "expired" | "redeemed";
+            status: "expired" | "void" | "active" | "redeemed";
             currency: string;
             initialAmountCents: number;
             remainingAmountCents: number;
@@ -58,7 +58,7 @@ export declare const vouchersService: {
         id: string;
         code: string;
         seriesCode: string | null;
-        status: "void" | "active" | "expired" | "redeemed";
+        status: "expired" | "void" | "active" | "redeemed";
         currency: string;
         initialAmountCents: number;
         remainingAmountCents: number;
@@ -76,29 +76,29 @@ export declare const vouchersService: {
     } | null>;
     create(db: PostgresJsDatabase, input: CreateVoucherInput, issuedByUserId?: string): Promise<{
         id: string;
+        status: "expired" | "void" | "active" | "redeemed";
         createdAt: Date;
-        updatedAt: Date;
         expiresAt: Date | null;
-        status: "void" | "active" | "expired" | "redeemed";
-        currency: string;
-        notes: string | null;
         code: string;
-        sourceType: "manual" | "refund" | "cancellation_credit" | "gift" | "promo";
         seriesCode: string | null;
+        currency: string;
         initialAmountCents: number;
         remainingAmountCents: number;
         issuedToPersonId: string | null;
         issuedToOrganizationId: string | null;
+        sourceType: "manual" | "refund" | "cancellation_credit" | "gift" | "promo";
         sourceBookingId: string | null;
         sourcePaymentId: string | null;
         validFrom: Date | null;
+        notes: string | null;
         issuedByUserId: string | null;
+        updatedAt: Date;
     } | null>;
     update(db: PostgresJsDatabase, id: string, input: UpdateVoucherInput): Promise<{
         id: string;
         code: string;
         seriesCode: string | null;
-        status: "void" | "active" | "expired" | "redeemed";
+        status: "expired" | "void" | "active" | "redeemed";
         currency: string;
         initialAmountCents: number;
         remainingAmountCents: number;
@@ -126,7 +126,7 @@ export declare const vouchersService: {
             id: string;
             code: string;
             seriesCode: string | null;
-            status: "void" | "active" | "expired" | "redeemed";
+            status: "expired" | "void" | "active" | "redeemed";
             currency: string;
             initialAmountCents: number;
             remainingAmountCents: number;
@@ -145,8 +145,8 @@ export declare const vouchersService: {
         redemption: {
             id: string;
             createdAt: Date;
-            bookingId: string;
             voucherId: string;
+            bookingId: string;
             paymentId: string | null;
             amountCents: number;
             createdByUserId: string | null;