@voyant-travel/finance 0.119.5

package/dist/booking-tax.d.ts

@@ -0,0 +1,124 @@
+import type { HonoExtension } from "@voyant-travel/hono/module";
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+import type { Hono } from "hono";
+export type ProductTaxFacts = {
+    hasAccommodation: boolean;
+    accommodationCountries: string[];
+};
+export type ResolvedBookingSellTaxRate = {
+    code: string;
+    label: string;
+    rate: number;
+    priceMode: "inclusive" | "exclusive";
+};
+export type BookingTaxSettings = {
+    taxPriceMode?: "inclusive" | "exclusive" | null;
+    taxPolicyProfileId?: string | null;
+};
+export type ResolveBookingTaxSettings = (db: PostgresJsDatabase) => BookingTaxSettings | null | undefined | Promise<BookingTaxSettings | null | undefined>;
+export type UpdateBookingTaxSettings = (db: PostgresJsDatabase, settings: BookingTaxSettings) => BookingTaxSettings | null | undefined | Promise<BookingTaxSettings | null | undefined>;
+export type TaxPolicyCondition = {
+    always: true;
+} | {
+    all: TaxPolicyCondition[];
+} | {
+    any: TaxPolicyCondition[];
+} | {
+    fact: keyof ProductTaxFacts;
+    eq?: unknown;
+    contains?: unknown;
+};
+export interface ResolveBookingSellTaxRateOptions {
+    settings?: BookingTaxSettings | null;
+    resolveBookingTaxSettings?: ResolveBookingTaxSettings;
+}
+export interface BookingTaxRouteOptions extends ResolveBookingSellTaxRateOptions {
+    updateBookingTaxSettings?: UpdateBookingTaxSettings;
+}
+export declare function resolveBookingSellTaxRate(db: PostgresJsDatabase, args: {
+    productId?: string | null;
+    facts?: Partial<ProductTaxFacts>;
+}, options?: ResolveBookingSellTaxRateOptions): Promise<ResolvedBookingSellTaxRate | null>;
+export declare function computeBookingItemTaxLine(taxRate: ResolvedBookingSellTaxRate | null, amountCents: number, currency: string, sortOrder?: number): {
+    code: string;
+    name: string;
+    scope: "included" | "excluded";
+    currency: string;
+    amountCents: number;
+    rateBasisPoints: number;
+    includedInPrice: boolean;
+    sortOrder: number;
+} | null;
+export declare function loadProductTaxFacts(db: PostgresJsDatabase, productId: string): Promise<ProductTaxFacts>;
+export declare function matchesTaxPolicyCondition(condition: TaxPolicyCondition | null | undefined, facts: ProductTaxFacts): boolean;
+export declare function createBookingTaxRoutes(options?: BookingTaxRouteOptions): import("hono/hono-base").HonoBase<{
+    Variables: {
+        db: PostgresJsDatabase;
+    };
+}, {
+    "/tax-settings": {
+        $get: {
+            input: {};
+            output: {
+                data: {
+                    taxPriceMode?: "inclusive" | "exclusive" | null | undefined;
+                    taxPolicyProfileId?: string | null | undefined;
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        };
+    };
+} & {
+    "/tax-settings": {
+        $patch: {
+            input: {};
+            output: {
+                data: {
+                    taxPriceMode?: "inclusive" | "exclusive" | null | undefined;
+                    taxPolicyProfileId?: string | null | undefined;
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        };
+    };
+} & {
+    "/tax-preview": {
+        $post: {
+            input: {};
+            output: {
+                data: {
+                    subtotalCents: number;
+                    taxCents: number;
+                    totalCents: number;
+                    currency: string;
+                    taxRate: null;
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        } | {
+            input: {};
+            output: {
+                data: {
+                    subtotalCents: number;
+                    taxCents: number;
+                    totalCents: number;
+                    currency: string;
+                    taxRate: {
+                        code: string;
+                        label: string;
+                        rateBasisPoints: number;
+                        priceMode: "inclusive" | "exclusive";
+                    };
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        };
+    };
+}, "/", "/tax-preview">;
+export declare function mountBookingTaxRoutes(hono: Hono, options?: BookingTaxRouteOptions): void;
+export declare function createBookingTaxHonoExtension(options?: BookingTaxRouteOptions): HonoExtension;
+//# sourceMappingURL=booking-tax.d.ts.map

package/dist/booking-tax.d.ts.map

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

package/dist/booking-tax.js

@@ -0,0 +1,264 @@
+import { ApiHttpError, parseJsonBody } from "@voyant-travel/hono";
+import { and, asc, eq, sql } from "drizzle-orm";
+import { Hono as HonoApp } from "hono";
+import { z } from "zod";
+import { taxClasses, taxPolicyProfiles, taxPolicyRules, taxRegimes } from "./schema.js";
+import { executeBoundaryRows } from "./service-boundary-sql.js";
+const taxPreviewBodySchema = z.object({
+    productId: z.string().min(1),
+    subtotalCents: z.number().int().min(0),
+    currency: z.string().min(3).max(8),
+});
+const bookingTaxSettingsPatchSchema = z.object({
+    taxPriceMode: z.enum(["inclusive", "exclusive"]).optional(),
+    taxPolicyProfileId: z.string().min(1).nullable().optional(),
+});
+export async function resolveBookingSellTaxRate(db, args, options = {}) {
+    const resolvedSettings = options.settings !== undefined
+        ? options.settings
+        : ((await options.resolveBookingTaxSettings?.(db)) ?? null);
+    const priceMode = resolvedSettings?.taxPriceMode === "exclusive" ? "exclusive" : "inclusive";
+    const policyProfile = await resolveTaxPolicyProfile(db, resolvedSettings?.taxPolicyProfileId);
+    if (policyProfile) {
+        const facts = normalizeTaxFacts(args.facts ?? (args.productId ? await loadProductTaxFacts(db, args.productId) : undefined));
+        const rules = await db
+            .select({
+            condition: taxPolicyRules.condition,
+            taxRegimeId: taxPolicyRules.taxRegimeId,
+        })
+            .from(taxPolicyRules)
+            .where(and(eq(taxPolicyRules.profileId, policyProfile.id), eq(taxPolicyRules.side, "sell"), eq(taxPolicyRules.active, true)))
+            .orderBy(asc(taxPolicyRules.priority), asc(taxPolicyRules.createdAt));
+        for (const rule of rules) {
+            if (!matchesTaxPolicyCondition(rule.condition, facts))
+                continue;
+            const resolved = await loadResolvedTaxRegime(db, rule.taxRegimeId, policyProfile.code);
+            if (resolved)
+                return { ...resolved, priceMode };
+        }
+    }
+    return args.productId ? resolveProductTaxClassRate(db, args.productId, priceMode) : null;
+}
+async function resolveBookingTaxSettingsOrDefault(db, options = {}) {
+    const settings = options.settings !== undefined
+        ? options.settings
+        : ((await options.resolveBookingTaxSettings?.(db)) ?? null);
+    return {
+        taxPriceMode: settings?.taxPriceMode === "exclusive" ? "exclusive" : "inclusive",
+        taxPolicyProfileId: settings?.taxPolicyProfileId ?? null,
+    };
+}
+export function computeBookingItemTaxLine(taxRate, amountCents, currency, sortOrder = 0) {
+    if (!taxRate || taxRate.rate <= 0 || amountCents <= 0)
+        return null;
+    const includedInPrice = taxRate.priceMode === "inclusive";
+    const taxCents = includedInPrice
+        ? Math.round(amountCents - amountCents / (1 + taxRate.rate))
+        : Math.round(amountCents * taxRate.rate);
+    if (taxCents <= 0)
+        return null;
+    return {
+        code: taxRate.code,
+        name: taxRate.label,
+        scope: includedInPrice ? "included" : "excluded",
+        currency,
+        amountCents: taxCents,
+        rateBasisPoints: Math.round(taxRate.rate * 10_000),
+        includedInPrice,
+        sortOrder,
+    };
+}
+export async function loadProductTaxFacts(db, productId) {
+    const [accommodationLocations, accommodationServices] = await Promise.all([
+        executeBoundaryRows(db, 
+        // agent-quality: raw-sql reviewed -- owner: finance; Product owns product_locations and product ids are parameter-bound through Drizzle.
+        sql `
+        SELECT country_code
+        FROM product_locations
+        WHERE product_id = ${productId}
+      `),
+        executeBoundaryRows(db, 
+        // agent-quality: raw-sql reviewed -- owner: finance; Product itinerary tables are read-only tax fact inputs with parameter-bound product id.
+        sql `
+        SELECT pds.id, pds.country_code
+        FROM product_day_services pds
+        INNER JOIN product_days pd ON pds.day_id = pd.id
+        INNER JOIN product_itineraries pi ON pd.itinerary_id = pi.id
+        WHERE pi.product_id = ${productId}
+          AND pds.service_type::text = 'accommodation'
+      `),
+    ]);
+    const accommodationCountries = [...accommodationServices, ...accommodationLocations]
+        .map((entry) => entry.country_code?.trim().toUpperCase())
+        .filter((countryCode) => Boolean(countryCode));
+    return {
+        hasAccommodation: accommodationLocations.length > 0 || accommodationServices.length > 0,
+        accommodationCountries: [...new Set(accommodationCountries)],
+    };
+}
+export function matchesTaxPolicyCondition(condition, facts) {
+    if (!condition)
+        return true;
+    if ("always" in condition)
+        return condition.always === true;
+    if ("all" in condition)
+        return condition.all.every((entry) => matchesTaxPolicyCondition(entry, facts));
+    if ("any" in condition)
+        return condition.any.some((entry) => matchesTaxPolicyCondition(entry, facts));
+    if (!("fact" in condition))
+        return false;
+    const value = facts[condition.fact];
+    if ("eq" in condition)
+        return value === condition.eq;
+    if ("contains" in condition) {
+        return Array.isArray(value) && value.includes(String(condition.contains).toUpperCase());
+    }
+    return false;
+}
+function normalizeTaxFacts(facts) {
+    return {
+        hasAccommodation: facts?.hasAccommodation === true,
+        accommodationCountries: [
+            ...new Set((facts?.accommodationCountries ?? [])
+                .map((countryCode) => countryCode.trim().toUpperCase())
+                .filter(Boolean)),
+        ],
+    };
+}
+async function resolveTaxPolicyProfile(db, configuredProfileId) {
+    if (configuredProfileId) {
+        const [configured] = await db
+            .select()
+            .from(taxPolicyProfiles)
+            .where(eq(taxPolicyProfiles.id, configuredProfileId))
+            .limit(1);
+        if (configured?.active)
+            return configured;
+    }
+    const [active] = await db
+        .select()
+        .from(taxPolicyProfiles)
+        .where(eq(taxPolicyProfiles.active, true))
+        .orderBy(asc(taxPolicyProfiles.createdAt))
+        .limit(1);
+    return active ?? null;
+}
+async function loadResolvedTaxRegime(db, taxRegimeId, codePrefix) {
+    const [regime] = await db
+        .select({
+        ratePercent: taxRegimes.ratePercent,
+        code: taxRegimes.code,
+        name: taxRegimes.name,
+    })
+        .from(taxRegimes)
+        .where(eq(taxRegimes.id, taxRegimeId))
+        .limit(1);
+    if (!regime || regime.ratePercent == null)
+        return null;
+    return {
+        code: `${codePrefix}/${regime.code}`,
+        label: regime.name,
+        rate: regime.ratePercent / 100,
+    };
+}
+async function resolveProductTaxClassRate(db, productId, priceMode) {
+    const productRows = await executeBoundaryRows(db, 
+    // agent-quality: raw-sql reviewed -- owner: finance; Product owns product tax-class assignment and product id is parameter-bound.
+    sql `
+      SELECT tax_class_id
+      FROM products
+      WHERE id = ${productId}
+      LIMIT 1
+    `);
+    const taxClassId = productRows[0]?.tax_class_id;
+    if (!taxClassId)
+        return null;
+    const classRows = await db
+        .select({
+        defaultRegimeId: taxClasses.defaultRegimeId,
+        code: taxClasses.code,
+    })
+        .from(taxClasses)
+        .where(eq(taxClasses.id, taxClassId))
+        .limit(1);
+    const klass = classRows[0];
+    if (!klass?.defaultRegimeId)
+        return null;
+    const resolved = await loadResolvedTaxRegime(db, klass.defaultRegimeId, klass.code);
+    return resolved ? { ...resolved, priceMode } : null;
+}
+export function createBookingTaxRoutes(options = {}) {
+    return new HonoApp()
+        .get("/tax-settings", async (c) => {
+        return c.json({
+            data: await resolveBookingTaxSettingsOrDefault(c.get("db"), options),
+        });
+    })
+        .patch("/tax-settings", async (c) => {
+        if (!options.updateBookingTaxSettings) {
+            throw new ApiHttpError("Booking tax settings updates are not configured", {
+                status: 409,
+                code: "booking_tax_settings_update_not_configured",
+            });
+        }
+        const current = await resolveBookingTaxSettingsOrDefault(c.get("db"), options);
+        const patch = await parseJsonBody(c, bookingTaxSettingsPatchSchema);
+        const next = await options.updateBookingTaxSettings(c.get("db"), {
+            taxPriceMode: patch.taxPriceMode ?? current.taxPriceMode,
+            taxPolicyProfileId: patch.taxPolicyProfileId === undefined
+                ? current.taxPolicyProfileId
+                : patch.taxPolicyProfileId,
+        });
+        return c.json({
+            data: await resolveBookingTaxSettingsOrDefault(c.get("db"), { settings: next }),
+        });
+    })
+        .post("/tax-preview", async (c) => {
+        const body = await parseJsonBody(c, taxPreviewBodySchema);
+        const taxRate = await resolveBookingSellTaxRate(c.get("db"), { productId: body.productId }, options);
+        const taxLine = computeBookingItemTaxLine(taxRate, body.subtotalCents, body.currency);
+        if (!taxRate || !taxLine) {
+            return c.json({
+                data: {
+                    subtotalCents: body.subtotalCents,
+                    taxCents: 0,
+                    totalCents: body.subtotalCents,
+                    currency: body.currency,
+                    taxRate: null,
+                },
+            });
+        }
+        const inclusive = taxLine.includedInPrice;
+        const displaySubtotal = inclusive
+            ? Math.max(0, body.subtotalCents - taxLine.amountCents)
+            : body.subtotalCents;
+        const total = inclusive ? body.subtotalCents : body.subtotalCents + taxLine.amountCents;
+        return c.json({
+            data: {
+                subtotalCents: displaySubtotal,
+                taxCents: taxLine.amountCents,
+                totalCents: total,
+                currency: body.currency,
+                taxRate: {
+                    code: taxRate.code,
+                    label: taxRate.label,
+                    rateBasisPoints: Math.round(taxRate.rate * 10_000),
+                    priceMode: taxRate.priceMode,
+                },
+            },
+        });
+    });
+}
+export function mountBookingTaxRoutes(hono, options = {}) {
+    hono.route("/v1/admin/bookings", createBookingTaxRoutes(options));
+}
+export function createBookingTaxHonoExtension(options = {}) {
+    const extension = {
+        name: "booking-tax",
+        module: "bookings",
+    };
+    return {
+        extension,
+        adminRoutes: createBookingTaxRoutes(options),
+    };
+}