@voyantjs/finance 0.19.0 → 0.21.0

package/dist/schema.js

@@ -43,6 +43,7 @@ export const paymentSessionTargetTypeEnum = pgEnum("payment_session_target_type"
     "invoice",
     "booking_payment_schedule",
     "booking_guarantee",
+    "flight_order",
     "other",
 ]);
 export const paymentInstrumentTypeEnum = pgEnum("payment_instrument_type", [
@@ -527,6 +528,15 @@ export const invoices = pgTable("invoices", {
     id: typeId("invoices"),
     invoiceNumber: text("invoice_number").notNull().unique(),
     invoiceType: invoiceTypeEnum("invoice_type").notNull().default("invoice"),
+    /**
+     * Source proforma when this row is the final invoice that
+     * superseded one. Lets the bank-transfer flow link the proforma
+     * issued at checkout to the invoice issued after payment lands —
+     * SmartBill's "convert proforma" call returns the same number
+     * series, but the local rows stay distinct so the audit trail
+     * shows both documents.
+     */
+    convertedFromInvoiceId: text("converted_from_invoice_id"),
     seriesId: typeIdRef("series_id"),
     sequence: integer("sequence"),
     templateId: typeIdRef("template_id"),
@@ -566,6 +576,7 @@ export const invoices = pgTable("invoices", {
     index("idx_invoices_fx_rate_set").on(table.fxRateSetId),
     index("idx_invoices_number").on(table.invoiceNumber),
     index("idx_invoices_due_date").on(table.dueDate),
+    index("idx_invoices_converted_from").on(table.convertedFromInvoiceId),
     // base_currency covers every base_*_cents column. If any base amount is
     // present, base_currency must be set so reporting can interpret it.
     check("ck_invoices_base_currency_amounts", sql `(
@@ -809,6 +820,80 @@ export const taxRegimes = pgTable("tax_regimes", {
     index("idx_tax_regimes_active").on(table.active),
     index("idx_tax_regimes_active_updated").on(table.active, table.updatedAt),
 ]);
+// ---------- tax_classes ----------
+//
+// Per-product tax-treatment decision. Stacks on top of `tax_regimes`
+// (the jurisdictional rate catalog) — a class points at a default
+// regime, plus optional regime-per-applies_to overrides for products
+// that mix base / addon / accommodation treatments.
+//
+// Per booking-journey-architecture §9.
+export const taxClassAppliesToEnum = pgEnum("tax_class_applies_to", [
+    "base",
+    "addon",
+    "accommodation",
+    "all",
+]);
+export const taxPolicySideEnum = pgEnum("tax_policy_side", ["sell", "buy"]);
+export const taxClasses = pgTable("tax_classes", {
+    id: typeId("tax_classes"),
+    /** Stable code for idempotent seeding (e.g. "vat-standard-ro",
+     *  "exempt-art311", "reduced-de"). */
+    code: text("code").notNull(),
+    label: text("label").notNull(),
+    description: text("description"),
+    /** Default regime resolved at quote time when no per-line rule
+     *  matches. Plain text — cross-domain refs go through link service
+     *  per schema-discipline. */
+    defaultRegimeId: text("default_regime_id"),
+    /**
+     * Regime-per-applies_to overrides. Empty / null falls through to
+     * `default_regime_id`. Parsed at quote time by the engine.
+     */
+    lines: jsonb("lines").$type(),
+    active: boolean("active").notNull().default(true),
+    createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
+    updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow(),
+}, (table) => [
+    index("idx_tax_classes_code").on(table.code),
+    index("idx_tax_classes_active").on(table.active),
+]);
+// ---------- tax_policy_profiles ----------
+//
+// Operator/jurisdiction-specific tax decision profiles. Profiles are
+// implementation presets such as "Romanian travel operator"; rules under
+// the profile map product/order facts to tax regimes for sell-side and
+// buy-side tax decisions.
+export const taxPolicyProfiles = pgTable("tax_policy_profiles", {
+    id: typeId("tax_policy_profiles"),
+    code: text("code").notNull(),
+    name: text("name").notNull(),
+    jurisdiction: text("jurisdiction"),
+    description: text("description"),
+    active: boolean("active").notNull().default(true),
+    createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
+    updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow(),
+}, (table) => [
+    index("idx_tax_policy_profiles_code").on(table.code),
+    index("idx_tax_policy_profiles_active").on(table.active),
+]);
+export const taxPolicyRules = pgTable("tax_policy_rules", {
+    id: typeId("tax_policy_rules"),
+    profileId: text("profile_id").notNull(),
+    side: taxPolicySideEnum("side").notNull().default("sell"),
+    priority: integer("priority").notNull().default(100),
+    name: text("name").notNull(),
+    appliesTo: taxClassAppliesToEnum("applies_to").notNull().default("all"),
+    condition: jsonb("condition").$type(),
+    taxRegimeId: text("tax_regime_id").notNull(),
+    active: boolean("active").notNull().default(true),
+    createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
+    updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow(),
+}, (table) => [
+    index("idx_tax_policy_rules_profile").on(table.profileId),
+    index("idx_tax_policy_rules_profile_side_priority").on(table.profileId, table.side, table.priority),
+    index("idx_tax_policy_rules_active").on(table.active),
+]);
 // ---------- invoice_external_refs ----------
 export const invoiceExternalRefs = pgTable("invoice_external_refs", {
     id: typeId("invoice_external_refs"),

package/dist/service-documents.d.ts

@@ -1,5 +1,5 @@
 import type { EventBus } from "@voyantjs/core";
-import type { StorageProvider, StorageUploadBody } from "@voyantjs/voyant-storage";
+import type { StorageProvider, StorageUploadBody } from "@voyantjs/storage";
 import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
 import { type invoiceLineItems, type invoiceRenditions, type invoices, invoiceTemplates, type payments } from "./schema.js";
 import type { GenerateInvoiceDocumentInput } from "./validation.js";

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

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

package/dist/service-issue.d.ts

@@ -0,0 +1,108 @@
+import type { EventBus } from "@voyantjs/core";
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+import { type CreateInvoiceFromBookingInput, type InvoiceFromBookingData } from "./service.js";
+/**
+ * Issue / proforma orchestration helpers that wrap the bare invoice
+ * creators with EventBus emissions so subscribers (SmartBill plugin,
+ * checkout-finalize workflow) can react.
+ *
+ * `createInvoice*` services in `service.ts` stay pure DB writers —
+ * the workflow / route layer chooses when to mark them as "issued"
+ * (a status change that's also a system signal).
+ */
+export interface InvoiceIssueRuntime {
+    eventBus?: EventBus;
+}
+export interface InvoiceIssuedEvent {
+    invoiceId: string;
+    invoiceNumber: string;
+    invoiceType: "invoice" | "proforma" | "credit_note";
+    bookingId: string | null;
+    totalCents: number;
+    currency: string;
+    /** Linkage when this invoice replaced a proforma. */
+    convertedFromInvoiceId?: string | null;
+}
+/**
+ * Create + emit an invoice from a booking. Returns the persisted row
+ * after flipping the status from `draft` → `sent`. The status flip is
+ * what consumers treat as "issued" — drafts shouldn't trigger
+ * SmartBill sync.
+ */
+export declare function issueInvoiceFromBooking(db: PostgresJsDatabase, input: CreateInvoiceFromBookingInput, bookingData: InvoiceFromBookingData, runtime?: InvoiceIssueRuntime): Promise<{
+    id: string;
+    createdAt: Date;
+    updatedAt: Date;
+    organizationId: string | null;
+    status: "void" | "draft" | "sent" | "partially_paid" | "paid" | "overdue";
+    issueDate: string;
+    currency: string;
+    notes: string | null;
+    bookingId: string;
+    personId: string | null;
+    baseCurrency: string | null;
+    fxRateSetId: string | null;
+    invoiceNumber: string;
+    invoiceType: "invoice" | "proforma" | "credit_note";
+    convertedFromInvoiceId: string | null;
+    seriesId: string | null;
+    sequence: number | null;
+    templateId: string | null;
+    taxRegimeId: string | null;
+    language: string | null;
+    subtotalCents: number;
+    baseSubtotalCents: number | null;
+    taxCents: number;
+    baseTaxCents: number | null;
+    totalCents: number;
+    baseTotalCents: number | null;
+    paidCents: number;
+    basePaidCents: number | null;
+    balanceDueCents: number;
+    baseBalanceDueCents: number | null;
+    commissionPercent: number | null;
+    commissionAmountCents: number | null;
+    dueDate: string;
+} | null>;
+/**
+ * Create + emit a proforma from a booking. Same shape as
+ * `issueInvoiceFromBooking` but marks the row as `invoiceType:
+ * 'proforma'` and emits the proforma-specific event so the
+ * SmartBill plugin can route to its proforma endpoint.
+ */
+export declare function issueProformaFromBooking(db: PostgresJsDatabase, input: CreateInvoiceFromBookingInput, bookingData: InvoiceFromBookingData, runtime?: InvoiceIssueRuntime): Promise<{
+    id: string;
+    createdAt: Date;
+    updatedAt: Date;
+    organizationId: string | null;
+    status: "void" | "draft" | "sent" | "partially_paid" | "paid" | "overdue";
+    issueDate: string;
+    currency: string;
+    notes: string | null;
+    bookingId: string;
+    personId: string | null;
+    baseCurrency: string | null;
+    fxRateSetId: string | null;
+    invoiceNumber: string;
+    invoiceType: "invoice" | "proforma" | "credit_note";
+    convertedFromInvoiceId: string | null;
+    seriesId: string | null;
+    sequence: number | null;
+    templateId: string | null;
+    taxRegimeId: string | null;
+    language: string | null;
+    subtotalCents: number;
+    baseSubtotalCents: number | null;
+    taxCents: number;
+    baseTaxCents: number | null;
+    totalCents: number;
+    baseTotalCents: number | null;
+    paidCents: number;
+    basePaidCents: number | null;
+    balanceDueCents: number;
+    baseBalanceDueCents: number | null;
+    commissionPercent: number | null;
+    commissionAmountCents: number | null;
+    dueDate: string;
+} | null>;
+//# sourceMappingURL=service-issue.d.ts.map

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

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

package/dist/service-issue.js

@@ -0,0 +1,57 @@
+import { eq } from "drizzle-orm";
+import { invoices } from "./schema.js";
+import { financeService, } from "./service.js";
+const ISSUED_EVENT = "invoice.issued";
+const PROFORMA_ISSUED_EVENT = "invoice.proforma.issued";
+/**
+ * Create + emit an invoice from a booking. Returns the persisted row
+ * after flipping the status from `draft` → `sent`. The status flip is
+ * what consumers treat as "issued" — drafts shouldn't trigger
+ * SmartBill sync.
+ */
+export async function issueInvoiceFromBooking(db, input, bookingData, runtime = {}) {
+    const draft = await financeService.createInvoiceFromBooking(db, input, bookingData);
+    if (!draft)
+        return null;
+    const [issued] = await db
+        .update(invoices)
+        .set({ status: "sent", updatedAt: new Date() })
+        .where(eq(invoices.id, draft.id))
+        .returning();
+    const row = issued ?? draft;
+    await emitIssued(runtime, ISSUED_EVENT, row);
+    return row;
+}
+/**
+ * Create + emit a proforma from a booking. Same shape as
+ * `issueInvoiceFromBooking` but marks the row as `invoiceType:
+ * 'proforma'` and emits the proforma-specific event so the
+ * SmartBill plugin can route to its proforma endpoint.
+ */
+export async function issueProformaFromBooking(db, input, bookingData, runtime = {}) {
+    const draft = await financeService.createInvoiceFromBooking(db, input, bookingData);
+    if (!draft)
+        return null;
+    const [issued] = await db
+        .update(invoices)
+        .set({ invoiceType: "proforma", status: "sent", updatedAt: new Date() })
+        .where(eq(invoices.id, draft.id))
+        .returning();
+    const row = issued ?? draft;
+    await emitIssued(runtime, PROFORMA_ISSUED_EVENT, row);
+    return row;
+}
+async function emitIssued(runtime, eventName, invoice) {
+    if (!runtime.eventBus)
+        return;
+    const payload = {
+        invoiceId: invoice.id,
+        invoiceNumber: invoice.invoiceNumber,
+        invoiceType: invoice.invoiceType,
+        bookingId: invoice.bookingId,
+        totalCents: invoice.totalCents,
+        currency: invoice.currency,
+        convertedFromInvoiceId: invoice.convertedFromInvoiceId,
+    };
+    await runtime.eventBus.emit(eventName, payload);
+}

package/dist/service-public.d.ts

@@ -33,7 +33,7 @@ export declare const publicFinanceService: {
             id: string;
             bookingPaymentScheduleId: string | null;
             guaranteeType: "other" | "voucher" | "bank_transfer" | "credit_card" | "deposit" | "preauth" | "card_on_file" | "agency_letter";
-            status: "pending" | "active" | "expired" | "cancelled" | "released" | "failed";
+            status: "pending" | "active" | "failed" | "expired" | "cancelled" | "released";
             currency: string | null;
             amountCents: number | null;
             provider: string | null;
@@ -49,13 +49,13 @@ export declare const publicFinanceService: {
     getBookingPayments(db: PostgresJsDatabase, bookingId: string): Promise<PublicBookingFinancePayments | null>;
     getPaymentSession(db: PostgresJsDatabase, sessionId: string): Promise<{
         id: string;
-        targetType: "other" | "booking" | "order" | "invoice" | "booking_payment_schedule" | "booking_guarantee";
+        targetType: "other" | "booking" | "order" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "flight_order";
         targetId: string | null;
         bookingId: string | null;
         invoiceId: string | null;
         bookingPaymentScheduleId: string | null;
         bookingGuaranteeId: string | null;
-        status: "pending" | "expired" | "cancelled" | "failed" | "paid" | "requires_redirect" | "processing" | "authorized";
+        status: "pending" | "failed" | "expired" | "cancelled" | "paid" | "requires_redirect" | "processing" | "authorized";
         provider: string | null;
         providerSessionId: string | null;
         providerPaymentId: string | null;
@@ -73,16 +73,17 @@ export declare const publicFinanceService: {
         completedAt: string | null;
         failureCode: string | null;
         failureMessage: string | null;
+        notes: string | null;
     } | null>;
     startBookingSchedulePaymentSession(db: PostgresJsDatabase, bookingId: string, scheduleId: string, input: PublicStartPaymentSessionInput): Promise<{
         id: string;
-        targetType: "other" | "booking" | "order" | "invoice" | "booking_payment_schedule" | "booking_guarantee";
+        targetType: "other" | "booking" | "order" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "flight_order";
         targetId: string | null;
         bookingId: string | null;
         invoiceId: string | null;
         bookingPaymentScheduleId: string | null;
         bookingGuaranteeId: string | null;
-        status: "pending" | "expired" | "cancelled" | "failed" | "paid" | "requires_redirect" | "processing" | "authorized";
+        status: "pending" | "failed" | "expired" | "cancelled" | "paid" | "requires_redirect" | "processing" | "authorized";
         provider: string | null;
         providerSessionId: string | null;
         providerPaymentId: string | null;
@@ -100,16 +101,17 @@ export declare const publicFinanceService: {
         completedAt: string | null;
         failureCode: string | null;
         failureMessage: string | null;
+        notes: string | null;
     } | null>;
     startBookingGuaranteePaymentSession(db: PostgresJsDatabase, bookingId: string, guaranteeId: string, input: PublicStartPaymentSessionInput): Promise<{
         id: string;
-        targetType: "other" | "booking" | "order" | "invoice" | "booking_payment_schedule" | "booking_guarantee";
+        targetType: "other" | "booking" | "order" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "flight_order";
         targetId: string | null;
         bookingId: string | null;
         invoiceId: string | null;
         bookingPaymentScheduleId: string | null;
         bookingGuaranteeId: string | null;
-        status: "pending" | "expired" | "cancelled" | "failed" | "paid" | "requires_redirect" | "processing" | "authorized";
+        status: "pending" | "failed" | "expired" | "cancelled" | "paid" | "requires_redirect" | "processing" | "authorized";
         provider: string | null;
         providerSessionId: string | null;
         providerPaymentId: string | null;
@@ -127,16 +129,17 @@ export declare const publicFinanceService: {
         completedAt: string | null;
         failureCode: string | null;
         failureMessage: string | null;
+        notes: string | null;
     } | null>;
     startInvoicePaymentSession(db: PostgresJsDatabase, invoiceId: string, input: PublicStartPaymentSessionInput): Promise<{
         id: string;
-        targetType: "other" | "booking" | "order" | "invoice" | "booking_payment_schedule" | "booking_guarantee";
+        targetType: "other" | "booking" | "order" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "flight_order";
         targetId: string | null;
         bookingId: string | null;
         invoiceId: string | null;
         bookingPaymentScheduleId: string | null;
         bookingGuaranteeId: string | null;
-        status: "pending" | "expired" | "cancelled" | "failed" | "paid" | "requires_redirect" | "processing" | "authorized";
+        status: "pending" | "failed" | "expired" | "cancelled" | "paid" | "requires_redirect" | "processing" | "authorized";
         provider: string | null;
         providerSessionId: string | null;
         providerPaymentId: string | null;
@@ -154,6 +157,7 @@ export declare const publicFinanceService: {
         completedAt: string | null;
         failureCode: string | null;
         failureMessage: string | null;
+        notes: string | null;
     } | null>;
     validateVoucher(db: PostgresJsDatabase, input: PublicValidateVoucherInput): Promise<{
         valid: false;

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

@@ -1 +1 @@
-{"version":3,"file":"service-public.d.ts","sourceRoot":"","sources":["../src/service-public.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAYjE,OAAO,KAAK,EACV,6BAA6B,EAC7B,4BAA4B,EAE5B,2BAA2B,EAC3B,yBAAyB,EACzB,8BAA8B,EAC9B,0BAA0B,EAC3B,MAAM,wBAAwB,CAAA;AAE/B,MAAM,WAAW,2BAA2B;IAC1C,0BAA0B,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAA;CAC5F;AA8HD,eAAO,MAAM,oBAAoB;4BAEzB,kBAAkB,aACX,MAAM,YACR,2BAA2B,GACnC,OAAO,CAAC,6BAA6B,GAAG,IAAI,CAAC;+BA6C1C,kBAAkB,aACX,MAAM,YACR,2BAA2B,GACnC,OAAO,CAAC,2BAA2B,GAAG,IAAI,CAAC;iCA0CxC,kBAAkB,aACX,MAAM,SACV,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAoH5B,kBAAkB,aACX,MAAM,GAChB,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC;0BA2DnB,kBAAkB,aAAa,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;2CAM3D,kBAAkB,aACX,MAAM,cACL,MAAM,SACX,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;4CA4BjC,kBAAkB,aACX,MAAM,eACJ,MAAM,SACZ,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;mCAuBjC,kBAAkB,aACX,MAAM,SACV,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAMb,kBAAkB,SAAS,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsEhF,CAAA"}
+{"version":3,"file":"service-public.d.ts","sourceRoot":"","sources":["../src/service-public.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAYjE,OAAO,KAAK,EACV,6BAA6B,EAC7B,4BAA4B,EAE5B,2BAA2B,EAC3B,yBAAyB,EACzB,8BAA8B,EAC9B,0BAA0B,EAC3B,MAAM,wBAAwB,CAAA;AAE/B,MAAM,WAAW,2BAA2B;IAC1C,0BAA0B,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAA;CAC5F;AA+HD,eAAO,MAAM,oBAAoB;4BAEzB,kBAAkB,aACX,MAAM,YACR,2BAA2B,GACnC,OAAO,CAAC,6BAA6B,GAAG,IAAI,CAAC;+BA6C1C,kBAAkB,aACX,MAAM,YACR,2BAA2B,GACnC,OAAO,CAAC,2BAA2B,GAAG,IAAI,CAAC;iCA0CxC,kBAAkB,aACX,MAAM,SACV,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAoH5B,kBAAkB,aACX,MAAM,GAChB,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC;0BA2DnB,kBAAkB,aAAa,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;2CAM3D,kBAAkB,aACX,MAAM,cACL,MAAM,SACX,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;4CA4BjC,kBAAkB,aACX,MAAM,eACJ,MAAM,SACZ,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCAuBjC,kBAAkB,aACX,MAAM,SACV,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAMb,kBAAkB,SAAS,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsEhF,CAAA"}

package/dist/service-public.js

@@ -72,6 +72,7 @@ function toPublicPaymentSession(session) {
         completedAt: normalizeDateTime(session.completedAt),
         failureCode: session.failureCode ?? null,
         failureMessage: session.failureMessage ?? null,
+        notes: session.notes ?? null,
     };
 }
 async function mapInvoiceDocument(invoice, renditions, runtime = {}) {