@voyant-travel/finance 0.137.4 → 0.137.6

package/dist/order-payment-sessions.d.ts

@@ -20,6 +20,8 @@ export interface EnsureOrderSessionParams {
     payerName?: string | null;
     /** Human summary surfaced as `payment_sessions.notes`. */
     notes?: string | null;
+    /** Payment method to stamp on a newly-created session, when known. */
+    paymentMethod?: CreatePaymentSessionInput["paymentMethod"] | null;
 }
 /**
  * Best-effort provider start hook. Called after a session is created so the

package/dist/order-payment-sessions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"order-payment-sessions.d.ts","sourceRoot":"","sources":["../src/order-payment-sessions.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAExF,2EAA2E;AAC3E,MAAM,MAAM,6BAA6B,GAAG,yBAAyB,CAAC,YAAY,CAAC,CAAA;AAEnF,wDAAwD;AACxD,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,kFAAkF;AAClF,MAAM,WAAW,wBAAwB;IACvC,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAA;IAChB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,2EAA2E;IAC3E,WAAW,EAAE,MAAM,CAAA;IACnB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,EAAE,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAOpG,MAAM,WAAW,oBAAoB;IACnC;;;;;;;OAOG;IACH,aAAa,CACX,EAAE,EAAE,kBAAkB,EACtB,MAAM,EAAE,wBAAwB,EAChC,aAAa,CAAC,EAAE,yBAAyB,GACxC,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC,CAAA;IAC7C;;;;OAIG;IACH,aAAa,CACX,EAAE,EAAE,kBAAkB,EACtB,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC,CAAA;CACpD;AAED,MAAM,WAAW,iCAAiC;IAChD,mFAAmF;IACnF,UAAU,EAAE,6BAA6B,CAAA;IACzC;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB;;;OAGG;IACH,aAAa,CAAC,EAAE,yBAAyB,CAAC,eAAe,CAAC,GAAG,IAAI,CAAA;CAClE;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,iCAAiC,GACzC,oBAAoB,CAuFtB"}
+{"version":3,"file":"order-payment-sessions.d.ts","sourceRoot":"","sources":["../src/order-payment-sessions.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAExF,2EAA2E;AAC3E,MAAM,MAAM,6BAA6B,GAAG,yBAAyB,CAAC,YAAY,CAAC,CAAA;AAEnF,wDAAwD;AACxD,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,kFAAkF;AAClF,MAAM,WAAW,wBAAwB;IACvC,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAA;IAChB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,2EAA2E;IAC3E,WAAW,EAAE,MAAM,CAAA;IACnB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,sEAAsE;IACtE,aAAa,CAAC,EAAE,yBAAyB,CAAC,eAAe,CAAC,GAAG,IAAI,CAAA;CAClE;AAED;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,EAAE,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAOpG,MAAM,WAAW,oBAAoB;IACnC;;;;;;;OAOG;IACH,aAAa,CACX,EAAE,EAAE,kBAAkB,EACtB,MAAM,EAAE,wBAAwB,EAChC,aAAa,CAAC,EAAE,yBAAyB,GACxC,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC,CAAA;IAC7C;;;;OAIG;IACH,aAAa,CACX,EAAE,EAAE,kBAAkB,EACtB,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC,CAAA;CACpD;AAED,MAAM,WAAW,iCAAiC;IAChD,mFAAmF;IACnF,UAAU,EAAE,6BAA6B,CAAA;IACzC;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB;;;OAGG;IACH,aAAa,CAAC,EAAE,yBAAyB,CAAC,eAAe,CAAC,GAAG,IAAI,CAAA;CAClE;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,iCAAiC,GACzC,oBAAoB,CAuFtB"}

package/dist/order-payment-sessions.js

@@ -50,7 +50,7 @@ export function createOrderPaymentSessions(options) {
                 amountCents: params.amountCents,
                 status: "pending",
                 provider,
-                paymentMethod,
+                paymentMethod: params.paymentMethod ?? paymentMethod,
                 payerEmail: params.payerEmail ?? null,
                 payerName: params.payerName ?? null,
                 notes: params.notes ?? null,

package/dist/payment-policy.d.ts

@@ -49,6 +49,7 @@ export interface PaymentPolicy {
 /** Default policy: 100% up-front, no deposit. Safe fallback for
  *  agencies that haven't configured anything yet. */
 export declare const noDepositPolicy: PaymentPolicy;
+export declare function isPaymentPolicy(value: unknown): value is PaymentPolicy;
 export type PaymentScheduleEntryType = "deposit" | "balance" | "full";
 export interface ComputedScheduleEntry {
     scheduleType: PaymentScheduleEntryType;

package/dist/payment-policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"payment-policy.d.ts","sourceRoot":"","sources":["../src/payment-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,aAAa,CAAA;AAE5D,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,WAAW,CAAA;IACjB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,WAAW,CAAA;IACpB;gEAC4D;IAC5D,gCAAgC,EAAE,MAAM,CAAA;IACxC,uDAAuD;IACvD,6BAA6B,EAAE,MAAM,CAAA;IACrC;;+DAE2D;IAC3D,wBAAwB,EAAE,MAAM,CAAA;CACjC;AAED;qDACqD;AACrD,eAAO,MAAM,eAAe,EAAE,aAK7B,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAA;AAErE,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,wBAAwB,CAAA;IACtC,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,wEAAwE;IACxE,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IACxC,oEAAoE;IACpE,KAAK,CAAC,EAAE,IAAI,CAAA;CACb;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,oBAAoB,EAC3B,MAAM,EAAE,aAAa,GACpB,qBAAqB,EAAE,CA8DzB;AAaD,8DAA8D;AAC9D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAgBtF;AAED,MAAM,MAAM,mBAAmB,GAC3B,SAAS,GACT,SAAS,GACT,UAAU,GACV,UAAU,GACV,kBAAkB,CAAA;AAEtB,MAAM,WAAW,0BAA0B;IACzC,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;IACpC,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;IACpC,cAAc,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;IACrC,cAAc,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;IACrC,eAAe,EAAE,aAAa,CAAA;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,aAAa,CAAA;IACrB,MAAM,EAAE,mBAAmB,CAAA;CAC5B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,0BAA0B,GACjC,qBAAqB,CAMvB;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,aAAa,EACrB,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACxC,KAAK,GAAE,IAAiB,GACvB,OAAO,CAKT"}
+{"version":3,"file":"payment-policy.d.ts","sourceRoot":"","sources":["../src/payment-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,aAAa,CAAA;AAE5D,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,WAAW,CAAA;IACjB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,WAAW,CAAA;IACpB;gEAC4D;IAC5D,gCAAgC,EAAE,MAAM,CAAA;IACxC,uDAAuD;IACvD,6BAA6B,EAAE,MAAM,CAAA;IACrC;;+DAE2D;IAC3D,wBAAwB,EAAE,MAAM,CAAA;CACjC;AAED;qDACqD;AACrD,eAAO,MAAM,eAAe,EAAE,aAK7B,CAAA;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAStE;AAmBD,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAA;AAErE,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,wBAAwB,CAAA;IACtC,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,wEAAwE;IACxE,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IACxC,oEAAoE;IACpE,KAAK,CAAC,EAAE,IAAI,CAAA;CACb;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,oBAAoB,EAC3B,MAAM,EAAE,aAAa,GACpB,qBAAqB,EAAE,CA+DzB;AAaD,8DAA8D;AAC9D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAgBtF;AAED,MAAM,MAAM,mBAAmB,GAC3B,SAAS,GACT,SAAS,GACT,UAAU,GACV,UAAU,GACV,kBAAkB,CAAA;AAEtB,MAAM,WAAW,0BAA0B;IACzC,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;IACpC,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;IACpC,cAAc,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;IACrC,cAAc,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;IACrC,eAAe,EAAE,aAAa,CAAA;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,aAAa,CAAA;IACrB,MAAM,EAAE,mBAAmB,CAAA;CAC5B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,0BAA0B,GACjC,qBAAqB,CAevB;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,aAAa,EACrB,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACxC,KAAK,GAAE,IAAiB,GACvB,OAAO,CAMT"}

package/dist/payment-policy.js

@@ -34,6 +34,32 @@ export const noDepositPolicy = {
     balanceDueDaysBeforeDeparture: 0,
     balanceDueMinDaysFromNow: 0,
 };
+export function isPaymentPolicy(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const policy = value;
+    return (isDepositRule(policy.deposit) &&
+        isNonNegativeInteger(policy.minDaysBeforeDepartureForDeposit) &&
+        isNonNegativeInteger(policy.balanceDueDaysBeforeDeparture) &&
+        isNonNegativeInteger(policy.balanceDueMinDaysFromNow));
+}
+function isDepositRule(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const rule = value;
+    if (rule.kind === "none")
+        return true;
+    if (rule.kind === "percent") {
+        return typeof rule.percent === "number" && rule.percent >= 0 && rule.percent <= 100;
+    }
+    if (rule.kind === "fixed_cents") {
+        return isNonNegativeInteger(rule.amountCents);
+    }
+    return false;
+}
+function isNonNegativeInteger(value) {
+    return typeof value === "number" && Number.isInteger(value) && value >= 0;
+}
 /**
  * Compute the customer-facing payment schedule for a booking.
  *
@@ -42,13 +68,14 @@ export const noDepositPolicy = {
  * scheduled for today.
  */
 export function computePaymentSchedule(input, policy) {
+    const effectivePolicy = isPaymentPolicy(policy) ? policy : noDepositPolicy;
     const total = Math.max(0, Math.round(input.totalCents));
     const today = input.today ?? new Date();
     const todayIso = isoDate(today);
     if (total === 0) {
         return [{ scheduleType: "full", amountCents: 0, currency: input.currency, dueDate: todayIso }];
     }
-    if (policy.deposit.kind === "none") {
+    if (effectivePolicy.deposit.kind === "none") {
         return [
             { scheduleType: "full", amountCents: total, currency: input.currency, dueDate: todayIso },
         ];
@@ -63,12 +90,12 @@ export function computePaymentSchedule(input, policy) {
         ];
     }
     const daysUntilDeparture = wholeDaysBetween(today, departure);
-    if (daysUntilDeparture < policy.minDaysBeforeDepartureForDeposit) {
+    if (daysUntilDeparture < effectivePolicy.minDaysBeforeDepartureForDeposit) {
         return [
             { scheduleType: "full", amountCents: total, currency: input.currency, dueDate: todayIso },
         ];
     }
-    const depositCents = clampCents(computeDepositCents(total, policy.deposit), 0, total);
+    const depositCents = clampCents(computeDepositCents(total, effectivePolicy.deposit), 0, total);
     const balanceCents = total - depositCents;
     if (depositCents <= 0 || balanceCents <= 0) {
         // Edge: a policy that resolves to 0% deposit or 100% deposit
@@ -78,8 +105,8 @@ export function computePaymentSchedule(input, policy) {
             { scheduleType: "full", amountCents: total, currency: input.currency, dueDate: todayIso },
         ];
     }
-    const rawBalanceDue = addDays(departure, -policy.balanceDueDaysBeforeDeparture);
-    const earliestBalanceDue = addDays(today, policy.balanceDueMinDaysFromNow);
+    const rawBalanceDue = addDays(departure, -effectivePolicy.balanceDueDaysBeforeDeparture);
+    const earliestBalanceDue = addDays(today, effectivePolicy.balanceDueMinDaysFromNow);
     const balanceDue = rawBalanceDue.getTime() > earliestBalanceDue.getTime() ? rawBalanceDue : earliestBalanceDue;
     return [
         {
@@ -108,7 +135,7 @@ function computeDepositCents(total, rule) {
 }
 /** True when this policy is empty / "inherit from parent". */
 export function isPaymentPolicyEmpty(policy) {
-    if (!policy)
+    if (!isPaymentPolicy(policy))
         return true;
     if (policy.deposit.kind === "none")
         return true;
@@ -139,15 +166,20 @@ export function isPaymentPolicyEmpty(policy) {
  * proves useful.
  */
 export function resolveEffectivePaymentPolicy(layers) {
-    if (layers.bookingPolicy)
+    if (isPaymentPolicy(layers.bookingPolicy))
         return { policy: layers.bookingPolicy, source: "booking" };
-    if (layers.listingPolicy)
+    if (isPaymentPolicy(layers.listingPolicy))
         return { policy: layers.listingPolicy, source: "listing" };
-    if (layers.categoryPolicy)
+    if (isPaymentPolicy(layers.categoryPolicy)) {
         return { policy: layers.categoryPolicy, source: "category" };
-    if (layers.supplierPolicy)
+    }
+    if (isPaymentPolicy(layers.supplierPolicy)) {
         return { policy: layers.supplierPolicy, source: "supplier" };
-    return { policy: layers.operatorDefault, source: "operator_default" };
+    }
+    return {
+        policy: isPaymentPolicy(layers.operatorDefault) ? layers.operatorDefault : noDepositPolicy,
+        source: "operator_default",
+    };
 }
 /**
  * Predicate the storefront UI uses to decide whether to surface the
@@ -155,12 +187,13 @@ export function resolveEffectivePaymentPolicy(layers) {
  * the policy + departure date resolve to a single full-payment row.
  */
 export function policyShouldRequireFullPayment(policy, departureDate, today = new Date()) {
-    if (policy.deposit.kind === "none")
+    const effectivePolicy = isPaymentPolicy(policy) ? policy : noDepositPolicy;
+    if (effectivePolicy.deposit.kind === "none")
         return true;
     const departure = parseIsoDate(departureDate);
     if (!departure)
         return true;
-    return wholeDaysBetween(today, departure) < policy.minDaysBeforeDepartureForDeposit;
+    return wholeDaysBetween(today, departure) < effectivePolicy.minDaysBeforeDepartureForDeposit;
 }
 // ─────────────────────────────────────────────────────────────────
 // Helpers

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyant-travel/finance",
-  "version": "0.137.4",
+  "version": "0.137.6",
   "license": "Apache-2.0",
   "type": "module",
   "exports": {