@revolugo/common 7.12.0-alpha.4 → 7.12.0-alpha.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@revolugo/common",
-  "version": "7.12.0-alpha.4",
+  "version": "7.12.0-alpha.6",
   "private": false,
   "description": "Revolugo common",
   "author": "Revolugo",

package/src/cancellation-policies.test.ts

@@ -5,6 +5,7 @@ import { describe, expect, test } from 'vitest'
 import {
   getCurrentPenaltyPercentage,
   getPenaltyPercentage,
+  isFreelyCancellableUntilHoursBeforeCheckIn,
   sanitizeCancellationPolicies,
 } from './cancellation-policies.ts'
 import { type Dayjs, dayjs } from './utils/dayjs.ts'
@@ -1044,3 +1045,162 @@ describe('getCurrentPenaltyPercentage', () => {
     ).to.equal(PP_4)
   })
 })
+
+describe('isFreelyCancellableUntilHoursBeforeCheckIn', () => {
+  // Check-in is at the hotel's local midnight; policy dates are anchored to it.
+  const cancelTimezone = 'Europe/Paris'
+  const checkInDate = '2025-09-18'
+  const freeFrom = '2025-08-01T00:00:00Z'
+  // Local midnight of check-in in Paris (UTC+2 in September) expressed in UTC.
+  const checkInInstant = dayjs.tz(checkInDate, cancelTimezone)
+
+  function freeUntil(dateTo: string): ICancellationPolicy[] {
+    return [{ dateFrom: freeFrom, dateTo, penaltyPercentage: 0 }]
+  }
+
+  test('offers Flex when there are no policies', () => {
+    expect(
+      isFreelyCancellableUntilHoursBeforeCheckIn({
+        cancellationPolicies: [],
+        checkInDate,
+        hoursBeforeCheckIn: 48,
+        timezone: cancelTimezone,
+      }),
+    ).toBe(false)
+  })
+
+  test('offers Flex when the booking is non-refundable from the start', () => {
+    expect(
+      isFreelyCancellableUntilHoursBeforeCheckIn({
+        cancellationPolicies: [
+          { dateFrom: freeFrom, dateTo: checkInDate, penaltyPercentage: 100 },
+        ],
+        checkInDate,
+        hoursBeforeCheckIn: 48,
+        timezone: cancelTimezone,
+      }),
+    ).toBe(false)
+  })
+
+  test('offers Flex when the free window stops short of the 48h mark', () => {
+    // Free only until 7 days before check-in → Flex extends the free window.
+    const dateTo = checkInInstant.subtract(7, 'days').format()
+    expect(
+      isFreelyCancellableUntilHoursBeforeCheckIn({
+        cancellationPolicies: freeUntil(dateTo),
+        checkInDate,
+        hoursBeforeCheckIn: 48,
+        timezone: cancelTimezone,
+      }),
+    ).toBe(false)
+  })
+
+  test('suppresses Flex when free continuously until exactly the 48h mark', () => {
+    const dateTo = checkInInstant.subtract(48, 'hours').format()
+    expect(
+      isFreelyCancellableUntilHoursBeforeCheckIn({
+        cancellationPolicies: freeUntil(dateTo),
+        checkInDate,
+        hoursBeforeCheckIn: 48,
+        timezone: cancelTimezone,
+      }),
+    ).toBe(true)
+  })
+
+  test('suppresses Flex when the free window reaches closer to check-in than 48h', () => {
+    const dateTo = checkInInstant.subtract(24, 'hours').format()
+    expect(
+      isFreelyCancellableUntilHoursBeforeCheckIn({
+        cancellationPolicies: freeUntil(dateTo),
+        checkInDate,
+        hoursBeforeCheckIn: 48,
+        timezone: cancelTimezone,
+      }),
+    ).toBe(true)
+  })
+
+  test('offers Flex when a penalty head start precedes the free window', () => {
+    // 50% early then free in the middle: Flex refunds that early period in full,
+    // so it is strictly better and must be offered.
+    expect(
+      isFreelyCancellableUntilHoursBeforeCheckIn({
+        cancellationPolicies: [
+          {
+            dateFrom: '2026-06-04T00:00:00+00:00',
+            dateTo: '2026-06-15T00:00:00+00:00',
+            penaltyPercentage: 50,
+          },
+          {
+            dateFrom: '2026-06-15T00:00:00+00:00',
+            dateTo: '2026-06-16T00:00:00+00:00',
+            penaltyPercentage: 0,
+          },
+          {
+            dateFrom: '2026-06-16T00:00:00+00:00',
+            dateTo: '2026-06-18T00:00:00+00:00',
+            penaltyPercentage: 100,
+          },
+        ],
+        checkInDate: '2026-06-18',
+        hoursBeforeCheckIn: 48,
+        timezone: 'UTC',
+      }),
+    ).toBe(false)
+  })
+
+  test('suppresses Flex across two contiguous free windows reaching the 48h mark', () => {
+    expect(
+      isFreelyCancellableUntilHoursBeforeCheckIn({
+        cancellationPolicies: [
+          {
+            dateFrom: '2026-06-04T00:00:00+00:00',
+            dateTo: '2026-06-10T00:00:00+00:00',
+            penaltyPercentage: 0,
+          },
+          {
+            dateFrom: '2026-06-10T00:00:00+00:00',
+            dateTo: '2026-06-16T00:00:00+00:00',
+            penaltyPercentage: 0,
+          },
+          {
+            dateFrom: '2026-06-16T00:00:00+00:00',
+            dateTo: '2026-06-18T00:00:00+00:00',
+            penaltyPercentage: 100,
+          },
+        ],
+        checkInDate: '2026-06-18',
+        hoursBeforeCheckIn: 48,
+        timezone: 'UTC',
+      }),
+    ).toBe(true)
+  })
+
+  test('suppresses Flex for a UTC+2 policy free until local midnight 48h before check-in', () => {
+    // Real-world data: free window ends at 22:00Z = local midnight (UTC+2),
+    // exactly 48h before a check-in stored as a bare date.
+    expect(
+      isFreelyCancellableUntilHoursBeforeCheckIn({
+        cancellationPolicies: [
+          {
+            dateFrom: '2026-06-04T12:47:07+00:00',
+            dateTo: '2026-06-15T22:00:00+00:00',
+            penaltyPercentage: 0,
+          },
+          {
+            dateFrom: '2026-06-15T22:00:00+00:00',
+            dateTo: '2026-06-16T22:00:00+00:00',
+            penaltyPercentage: 50,
+          },
+          {
+            dateFrom: '2026-06-16T22:00:00+00:00',
+            dateTo: '2026-06-17T22:00:00+00:00',
+            penaltyPercentage: 100,
+          },
+        ],
+        checkInDate: '2026-06-18',
+        hoursBeforeCheckIn: 48,
+        timezone: cancelTimezone,
+      }),
+    ).toBe(true)
+  })
+})

package/src/cancellation-policies.ts

@@ -1,3 +1,4 @@
+// oxlint-disable max-lines
 import { compact } from './utils/compact.ts'
 import { type Dayjs, dayjs } from './utils/dayjs.ts'
 import { isEmpty } from './utils/is-empty.ts'
@@ -523,6 +524,67 @@ export function adjustForCustomers(
   }))
 }
 
+/**
+ * Whether the native cancellation policy is at least as good as Revolugo Flex
+ * (Meetch): the booking can be cancelled for free continuously from booking time
+ * until `hoursBeforeCheckIn` before check-in. When it can, Flex — which only
+ * guarantees a full refund up to that same window — brings no extra benefit and
+ * must not be offered as an addon.
+ *
+ * Flex IS better (and must be offered) as soon as the native policy charges any
+ * penalty inside that window — e.g. a non-refundable/penalty head start before a
+ * free window, a gap in coverage, or a free window that stops short of the 48h
+ * mark.
+ *
+ * `checkInDate` is interpreted at the start of day in `timezone` so the
+ * threshold shares the same time base as the policy dates (which are anchored to
+ * the hotel's local midnight). Without this, a date-only check-in parsed as UTC
+ * drifts by the hotel's UTC offset and the comparison misses by a few hours.
+ */
+export function isFreelyCancellableUntilHoursBeforeCheckIn({
+  cancellationPolicies,
+  checkInDate,
+  hoursBeforeCheckIn,
+  timezone,
+}: {
+  cancellationPolicies: ICancellationPolicy[]
+  checkInDate: string
+  hoursBeforeCheckIn: number
+  timezone: string
+}): boolean {
+  const threshold = dayjs
+    .tz(checkInDate, timezone)
+    .subtract(hoursBeforeCheckIn, 'hours')
+
+  const sanitizedPolicies = getSanitizedCancellationPolicies({
+    cancellationPolicies,
+    checkInDate,
+    timezone,
+  })
+
+  // Walk the policies from booking time, following an unbroken chain of free
+  // (0% penalty) windows. The first penalty or gap stops the chain.
+  let freeUntil: Dayjs | null = null
+  for (const policy of sanitizedPolicies) {
+    if (policy.penaltyPercentage !== 0) {
+      break
+    }
+    if (freeUntil && dayjs(policy.dateFrom).isAfter(freeUntil)) {
+      break
+    }
+
+    const dateTo = dayjs(policy.dateTo)
+    if (!freeUntil || dateTo.isAfter(freeUntil)) {
+      freeUntil = dateTo
+    }
+    if (freeUntil.isSameOrAfter(threshold)) {
+      return true
+    }
+  }
+
+  return false
+}
+
 export function isFreeCancellable(cps: ICancellationPolicy[]): boolean {
   const freeCp = cps.find(cp => cp.penaltyPercentage === 0)
   return (