@voyantjs/finance 0.20.0 → 0.21.0

package/dist/schema.js

@@ -528,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"),
@@ -567,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 `(
@@ -810,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-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;
@@ -55,7 +55,7 @@ export declare const publicFinanceService: {
         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;
@@ -83,7 +83,7 @@ export declare const publicFinanceService: {
         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;
@@ -111,7 +111,7 @@ export declare const publicFinanceService: {
         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;
@@ -139,7 +139,7 @@ export declare const publicFinanceService: {
         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;