@aglyn/plugins-commerce 1.0.0-beta.285 → 1.0.0-beta.287

package/src/lib/model/commerce-reservations.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/commerce-reservations.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Reservations v1 (AGL-304): bookable units (cabins) with date-range\n * stays, seasonal pricing, deposits, and cancellation windows —\n * extending the appointment-slot bookings (AGL-159) rather than\n * replacing them. Dates are day-precision epoch-ms at UTC midnight\n * (`dayMs`); nights = checkout day − checkin day. Pure — the\n * reservation APIs and console own I/O.\n */\n\nimport type { StorefrontTaxMode } from './commerce-tax-decision'\n\nexport const DAY_MS = 24 * 60 * 60 * 1000\n\n/** Seasonal pricing window by month-day (year-agnostic, inclusive). */\nexport interface ResourceSeason {\n  /** 'MM-DD' inclusive start, e.g. '06-01'. */\n  from: string\n  /** 'MM-DD' inclusive end; may wrap the year (e.g. '12-15'..'01-05'). */\n  to: string\n  /** Multiplier on the nightly rate, e.g. 1.5 for peak. */\n  multiplier: number\n  label?: string\n}\n\n/** `hosts/{hostId}/resources/{id}` doc. */\nexport interface HostResource {\n  name: string\n  description?: string\n  /**\n   * Sleeps N; display only. Never availability: how many guests one unit\n   * takes says nothing about how many units there are (see `units`).\n   */\n  capacity?: number\n  /**\n   * How many identical units this one resource holds (AGL-4044): 12 RV\n   * hookups, 30 tent sites, 4 matching cabins. Each night can take this many\n   * stays at once. Absent means 1, which is every resource written before the\n   * field existed, and one unit behaves exactly as a resource always has.\n   * An integer from 1 to {@link MAX_RESOURCE_UNITS}; read it through\n   * {@link resourceUnits}, never raw.\n   */\n  units?: number\n  photoUrls?: string[]\n  amenities?: string[]\n  nightlyRateUsd: number\n  /** Friday/Saturday nights multiply by this (default 1). */\n  weekendMultiplier?: number\n  seasons?: ResourceSeason[]\n  minNights?: number\n  /** Deposit due at reservation: percent of total (1-100). */\n  depositPct?: number\n  /** Free cancellation until this many hours before check-in. */\n  cancellationHours?: number\n  /** Manually blocked day ranges (maintenance etc.), dayMs pairs. */\n  blocks?: Array<{ fromDayMs: number; toDayMs: number }>\n}\n\nexport type ReservationStatus =\n  | 'pending'\n  | 'confirmed'\n  | 'checked_in'\n  | 'checked_out'\n  | 'cancelled'\n  | 'no_show'\n\n/** `hosts/{hostId}/reservations/{id}` doc. */\nexport interface HostReservation {\n  resourceId: string\n  status: ReservationStatus\n  /** UTC-midnight day of arrival. */\n  checkInDayMs: number\n  /** UTC-midnight day of departure (exclusive). */\n  checkOutDayMs: number\n  guestName?: string | null\n  guestEmail?: string | null\n  nights?: number\n  totalCents?: number\n  depositCents?: number\n  /** Payments applied so far (deposit, folio settlements). */\n  paidCents?: number\n  /** POS folio lines charged to the stay (AGL-317). */\n  folio?: Array<{\n    orderId: string\n    amountCents: number\n    note?: string\n    atMs: number\n  }>\n  checkoutSessionId?: string\n  createdAtMs?: number\n  /**\n   * WHICH tax regime the paid deposit carried (AGL-1969), stamped at\n   * confirmation from the same `storefrontTaxModeOf` derivation every order\n   * door uses (AGL-2451).\n   *\n   * `manual` on a stay whose merchant had set a lodging rate\n   * (`TaxSettings.lodging`), `none` where they had not — which is the default\n   * and every store that has not opted in. Never `stripe-automatic` from this\n   * path: Stripe Tax cannot compute occupancy tax without a lodging tax code\n   * `reserve.ts` does not send, so the rate is always the merchant's own and\n   * is never computed against Aglyn's registrations (AGL-1904).\n   *\n   * ABSENT is a fourth state and is not `none` — it means the reservation was\n   * confirmed before this field existed. See `StorefrontTaxMode`.\n   */\n  taxMode?: StorefrontTaxMode\n  /**\n   * The lodging tax charged on top of `paidCents` (AGL-1969), from the\n   * merchant's own rate. Absent, never zero, where none was charged.\n   *\n   * SEPARATE FROM `paidCents` on purpose: that field is the money applied to\n   * the STAY and the console divides it by `totalCents` to show what is still\n   * owed. Tax is not part of the stay's price and is not the merchant's\n   * revenue.\n   *\n   * LIMITATION, stated rather than decided: this is the rate applied to what\n   * was CHARGED, which on a deposit-taking resource is the deposit rather than\n   * the stay. Whether a jurisdiction wants occupancy tax on the full stay at\n   * booking, on the deposit, or on redemption is not a question this codebase\n   * answers — see `reserve.ts` and the merchant copy on the Taxes card.\n   */\n  taxCents?: number\n}\n\n/** UTC midnight for an instant. */\nexport function toDayMs(atMs: number): number {\n  return Math.floor(atMs / DAY_MS) * DAY_MS\n}\n\nfunction monthDay(dayMs: number): string {\n  const date = new Date(dayMs)\n  const month = String(date.getUTCMonth() + 1).padStart(2, '0')\n  const day = String(date.getUTCDate()).padStart(2, '0')\n  return `${month}-${day}`\n}\n\nfunction inSeason(dayKey: string, season: ResourceSeason): boolean {\n  if (season.from <= season.to) {\n    return dayKey >= season.from && dayKey <= season.to\n  }\n  // Wrapping season (e.g. 12-15 .. 01-05).\n  return dayKey >= season.from || dayKey <= season.to\n}\n\n/** Per-night rate in cents for one specific night. */\nexport function nightlyRateCents(\n  resource: Pick<\n    HostResource,\n    'nightlyRateUsd' | 'weekendMultiplier' | 'seasons'\n  >,\n  dayMs: number,\n): number {\n  let rate = resource.nightlyRateUsd * 100\n  const weekday = new Date(dayMs).getUTCDay()\n  if ((weekday === 5 || weekday === 6) && resource.weekendMultiplier) {\n    rate *= resource.weekendMultiplier\n  }\n  const dayKey = monthDay(dayMs)\n  for (const season of resource.seasons ?? []) {\n    if (inSeason(dayKey, season)) {\n      rate *= season.multiplier\n      break\n    }\n  }\n  return Math.round(rate)\n}\n\nexport interface ReservationQuote {\n  nights: number\n  subtotalCents: number\n  depositCents: number\n  totalCents: number\n  /** Per-night breakdown for the quote UI. */\n  nightlyCents: number[]\n  problem?: string\n}\n\n/** Prices a stay; `problem` set (and zeros) when the range is invalid. */\nexport function computeReservationQuote(\n  resource: HostResource,\n  checkInDayMs: number,\n  checkOutDayMs: number,\n): ReservationQuote {\n  const empty: ReservationQuote = {\n    nights: 0,\n    subtotalCents: 0,\n    depositCents: 0,\n    totalCents: 0,\n    nightlyCents: [],\n  }\n  const nights = Math.round((checkOutDayMs - checkInDayMs) / DAY_MS)\n  if (!(nights > 0)) return { ...empty, problem: 'Choose at least one night' }\n  if (resource.minNights && nights < resource.minNights) {\n    return { ...empty, problem: `Minimum stay is ${resource.minNights} nights` }\n  }\n  const nightlyCents: number[] = []\n  for (let day = checkInDayMs; day < checkOutDayMs; day += DAY_MS) {\n    nightlyCents.push(nightlyRateCents(resource, day))\n  }\n  const subtotalCents = nightlyCents.reduce((sum, cents) => sum + cents, 0)\n  const depositPct = Math.min(100, Math.max(0, resource.depositPct ?? 100))\n  const depositCents = Math.round((subtotalCents * depositPct) / 100)\n  return {\n    nights,\n    subtotalCents,\n    depositCents,\n    totalCents: subtotalCents,\n    nightlyCents,\n  }\n}\n\n/**\n * How long an unpaid `pending` reservation stands between the next guest and\n * the dates it named.\n *\n * A `pending` row is written before the Stripe session opens, and nothing ever\n * clears one: `process-abandoned.ts` sweeps `checkouts`, not `reservations`.\n * So the hold has to lapse by the clock rather than by a job, or one guest who\n * closed the tab at the payment screen takes those dates off the market\n * permanently.\n */\nexport const PENDING_RESERVATION_HOLD_MS = 30 * 60 * 1000\n\n/**\n * Does this reservation still stand between a guest and its dates?\n *\n * THE one answer, because four surfaces ask it — the booking door, the booking\n * transaction's re-read, the storefront availability endpoint behind the\n * date-picker, and the console's walk-in check — and they were not asking it\n * the same way. Only the booking door aged out a stale `pending`, so the\n * storefront painted dates unavailable that the booking door would have sold,\n * and the front desk was told a room was taken while it stood empty.\n *\n * A `pending` row carrying no `createdAtMs` releases rather than holds: an\n * unbounded hold on a row that cannot prove its own age is the failure this\n * lapse exists to prevent, and the booking door re-checks inside its\n * transaction before any money moves.\n */\nexport function reservationHoldsDates(\n  reservation: Pick<HostReservation, 'status'> & { createdAtMs?: number },\n  nowMs: number = Date.now(),\n): boolean {\n  if (reservation.status === 'cancelled' || reservation.status === 'no_show') {\n    return false\n  }\n  if (reservation.status !== 'pending') return true\n  const createdAtMs = Number(reservation.createdAtMs ?? 0)\n  return createdAtMs > 0 && nowMs - createdAtMs < PENDING_RESERVATION_HOLD_MS\n}\n\n/** The most identical units one resource can hold (AGL-4044). */\nexport const MAX_RESOURCE_UNITS = 500\n\n/**\n * How many units a resource holds: the stored `units` as a whole number from 1\n * to {@link MAX_RESOURCE_UNITS}, and 1 for anything else (absent, zero,\n * negative, not a number). Closing a resource is what `blocks` are for, so no\n * stored value can make a resource hold no units at all.\n */\nexport function resourceUnits(\n  resource: Pick<HostResource, 'units'> | null | undefined,\n): number {\n  const units = Math.floor(Number(resource?.units))\n  if (!Number.isFinite(units) || units < 1) return 1\n  return Math.min(MAX_RESOURCE_UNITS, units)\n}\n\n/** A reservation as an availability check reads it. */\nexport type HeldStay = Pick<\n  HostReservation,\n  'checkInDayMs' | 'checkOutDayMs' | 'status'\n> & {\n  createdAtMs?: number\n}\n\n/**\n * How many units are taken on each night from `fromDayMs` up to (not\n * including) `toDayMs`, one entry per night, counting only the stays that\n * still hold their dates ({@link reservationHoldsDates}). A stay takes a night\n * when it overlaps it, with the same `[checkIn, checkOut)` semantics as\n * {@link isRangeAvailable}: a stay that leaves the morning another arrives\n * does not take that night.\n */\nexport function unitsTakenByNight(\n  reservations: HeldStay[],\n  fromDayMs: number,\n  toDayMs: number,\n  nowMs: number = Date.now(),\n): number[] {\n  const live = reservations.filter((reservation) =>\n    reservationHoldsDates(reservation, nowMs),\n  )\n  const taken: number[] = []\n  for (let night = fromDayMs; night < toDayMs; night += DAY_MS) {\n    const nightEnd = Math.min(night + DAY_MS, toDayMs)\n    let count = 0\n    for (const reservation of live) {\n      if (\n        reservation.checkInDayMs < nightEnd &&\n        reservation.checkOutDayMs > night\n      ) {\n        count++\n      }\n    }\n    taken.push(count)\n  }\n  return taken\n}\n\n/** One night of a resource: how many of its units are still free. */\nexport interface ResourceNightUnits {\n  dayMs: number\n  unitsLeft: number\n  units: number\n}\n\n/**\n * Units left on each of `nights` nights from `fromDayMs`: the resource's\n * units less the stays holding that night, and none on a blocked night,\n * because a block closes the whole resource.\n */\nexport function unitsLeftByNight(\n  resource: Pick<HostResource, 'units' | 'blocks'>,\n  reservations: HeldStay[],\n  fromDayMs: number,\n  nights: number,\n  nowMs: number = Date.now(),\n): ResourceNightUnits[] {\n  const units = resourceUnits(resource)\n  const toDayMs = fromDayMs + Math.max(0, Math.floor(nights)) * DAY_MS\n  return unitsTakenByNight(reservations, fromDayMs, toDayMs, nowMs).map(\n    (taken, index) => {\n      const dayMs = fromDayMs + index * DAY_MS\n      const blocked = (resource.blocks ?? []).some(\n        (block) => dayMs < block.toDayMs && dayMs + DAY_MS > block.fromDayMs,\n      )\n      return {\n        dayMs,\n        units,\n        unitsLeft: blocked ? 0 : Math.max(0, units - taken),\n      }\n    },\n  )\n}\n\n/**\n * Availability: a candidate range is free when, on EVERY night in it, fewer\n * live reservations overlap that night than the resource has units\n * (AGL-4044), and no manual block touches it. `[checkIn, checkOut)`\n * semantics, so back-to-back stays touch without conflict. A block closes the\n * whole resource, every unit at once.\n *\n * One unit (the default, and every resource written before `units`) takes\n * the original path unchanged: the range conflicts when it overlaps any live\n * reservation at all.\n *\n * `nowMs` is a parameter so the pending lapse is testable without freezing the\n * clock. A caller passing reservations without `createdAtMs` gets the same\n * answer as before for every status but `pending`.\n */\nexport function isRangeAvailable(\n  resource: Pick<HostResource, 'blocks' | 'units'>,\n  reservations: HeldStay[],\n  checkInDayMs: number,\n  checkOutDayMs: number,\n  nowMs: number = Date.now(),\n): boolean {\n  if (!(checkOutDayMs > checkInDayMs)) return false\n  for (const block of resource.blocks ?? []) {\n    if (checkInDayMs < block.toDayMs && checkOutDayMs > block.fromDayMs) {\n      return false\n    }\n  }\n  const units = resourceUnits(resource)\n  if (units === 1) {\n    for (const reservation of reservations) {\n      if (!reservationHoldsDates(reservation, nowMs)) continue\n      if (\n        checkInDayMs < reservation.checkOutDayMs &&\n        checkOutDayMs > reservation.checkInDayMs\n      ) {\n        return false\n      }\n    }\n    return true\n  }\n  return unitsTakenByNight(\n    reservations,\n    checkInDayMs,\n    checkOutDayMs,\n    nowMs,\n  ).every((taken) => taken < units)\n}\n\n/**\n * The widget's scarcity line starts at this many units left (AGL-4044):\n * \"Only 2 left\". Never on a one-unit resource, where every free night would\n * read \"Only 1 left\", and never on a night nothing is booked on.\n */\nexport const FEW_UNITS_LEFT = 3\n\n/**\n * The fewest units left across `[checkInDayMs, checkOutDayMs)` when that is\n * {@link FEW_UNITS_LEFT} or fewer and at least one, else null. `fewLeft`\n * lists only the scarce nights, as the availability endpoint sends them; a\n * night it leaves out has more than {@link FEW_UNITS_LEFT} free.\n */\nexport function fewestUnitsLeft(\n  fewLeft: Array<{ dayMs: number; unitsLeft: number }> | null | undefined,\n  checkInDayMs: number,\n  checkOutDayMs: number,\n): number | null {\n  let fewest: number | null = null\n  for (const night of fewLeft ?? []) {\n    if (night.dayMs < checkInDayMs || night.dayMs >= checkOutDayMs) continue\n    if (!(night.unitsLeft >= 1) || night.unitsLeft > FEW_UNITS_LEFT) continue\n    fewest = fewest === null ? night.unitsLeft : Math.min(fewest, night.unitsLeft)\n  }\n  return fewest\n}\n\n/** Free-cancellation check against the policy window. */\nexport function canCancelReservation(\n  resource: Pick<HostResource, 'cancellationHours'>,\n  reservation: Pick<HostReservation, 'checkInDayMs' | 'status'>,\n  nowMs = Date.now(),\n): boolean {\n  if (!['pending', 'confirmed'].includes(reservation.status)) return false\n  const windowMs = (resource.cancellationHours ?? 0) * 60 * 60 * 1000\n  return nowMs <= reservation.checkInDayMs - windowMs\n}\n"],"names":["DAY_MS","toDayMs","atMs","Math","floor","monthDay","dayMs","date","Date","month","String","getUTCMonth","padStart","day","getUTCDate","inSeason","dayKey","season","from","to","nightlyRateCents","resource","rate","nightlyRateUsd","weekday","getUTCDay","weekendMultiplier","seasons","multiplier","round","computeReservationQuote","checkInDayMs","checkOutDayMs","empty","nights","subtotalCents","depositCents","totalCents","nightlyCents","problem","minNights","push","reduce","sum","cents","depositPct","min","max","PENDING_RESERVATION_HOLD_MS","reservationHoldsDates","reservation","nowMs","now","status","createdAtMs","Number","MAX_RESOURCE_UNITS","resourceUnits","units","isFinite","unitsTakenByNight","reservations","fromDayMs","live","filter","taken","night","nightEnd","count","unitsLeftByNight","map","index","blocked","blocks","some","block","unitsLeft","isRangeAvailable","every","FEW_UNITS_LEFT","fewestUnitsLeft","fewLeft","fewest","canCancelReservation","includes","windowMs","cancellationHours"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/commerce-reservations.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Reservations v1 (AGL-304): bookable units (cabins) with date-range\n * stays, seasonal pricing, deposits, and cancellation windows —\n * extending the appointment-slot bookings (AGL-159) rather than\n * replacing them. Dates are day-precision epoch-ms at UTC midnight\n * (`dayMs`); nights = checkout day − checkin day. Pure — the\n * reservation APIs and console own I/O.\n */\n\nimport type { StorefrontTaxMode } from './commerce-tax-decision'\n\nexport const DAY_MS = 24 * 60 * 60 * 1000\n\n/** Seasonal pricing window by month-day (year-agnostic, inclusive). */\nexport interface ResourceSeason {\n  /** 'MM-DD' inclusive start, e.g. '06-01'. */\n  from: string\n  /** 'MM-DD' inclusive end; may wrap the year (e.g. '12-15'..'01-05'). */\n  to: string\n  /** Multiplier on the nightly rate, e.g. 1.5 for peak. */\n  multiplier: number\n  label?: string\n}\n\n/** `hosts/{hostId}/resources/{id}` doc. */\nexport interface HostResource {\n  name: string\n  description?: string\n  /**\n   * Sleeps N; display only. Never availability: how many guests one unit\n   * takes says nothing about how many units there are (see `units`).\n   */\n  capacity?: number\n  /**\n   * How many identical units this one resource holds (AGL-4044): 12 RV\n   * hookups, 30 tent sites, 4 matching cabins. Each night can take this many\n   * stays at once. Absent means 1, which is every resource written before the\n   * field existed, and one unit behaves exactly as a resource always has.\n   * An integer from 1 to {@link MAX_RESOURCE_UNITS}; read it through\n   * {@link resourceUnits}, never raw.\n   */\n  units?: number\n  /**\n   * When the booking widget's scarcity line (\"Only 2 left\") starts, for a\n   * resource with several units (AGL-4044): it shows once this many units or\n   * fewer are free on a night of the stay. Absent is\n   * {@link FEW_UNITS_LEFT}, the line every several-unit resource has always\n   * had; 0 never shows it. A whole number from 0 to\n   * {@link MAX_RESOURCE_UNITS}; read it through {@link resourceFewLeftAt},\n   * never raw.\n   */\n  fewLeftAt?: number\n  /**\n   * How a stay on this resource is checked in at the window (AGL-4043):\n   * `false` or absent, one check-in (and wristband) per stay per day; `true`,\n   * one per guest per day, from the stay's {@link HostReservation.guests}.\n   * The store's quick control on the check-in screen can set every resource\n   * at once (`settings/checkIn.stays`).\n   */\n  checkInPerGuest?: boolean\n  photoUrls?: string[]\n  amenities?: string[]\n  nightlyRateUsd: number\n  /** Friday/Saturday nights multiply by this (default 1). */\n  weekendMultiplier?: number\n  seasons?: ResourceSeason[]\n  minNights?: number\n  /** Deposit due at reservation: percent of total (1-100). */\n  depositPct?: number\n  /** Free cancellation until this many hours before check-in. */\n  cancellationHours?: number\n  /** Manually blocked day ranges (maintenance etc.), dayMs pairs. */\n  blocks?: Array<{ fromDayMs: number; toDayMs: number }>\n}\n\nexport type ReservationStatus =\n  | 'pending'\n  | 'confirmed'\n  | 'checked_in'\n  | 'checked_out'\n  | 'cancelled'\n  | 'no_show'\n\n/** `hosts/{hostId}/reservations/{id}` doc. */\nexport interface HostReservation {\n  resourceId: string\n  status: ReservationStatus\n  /** UTC-midnight day of arrival. */\n  checkInDayMs: number\n  /** UTC-midnight day of departure (exclusive). */\n  checkOutDayMs: number\n  guestName?: string | null\n  guestEmail?: string | null\n  /**\n   * How many guests the stay is for (AGL-4043), 1 up to what the resource\n   * sleeps ({@link resourceGuestCeiling}); absent on a stay booked before the\n   * field existed, or without an answer, which reads as 1. Checking in one\n   * guest at a time asks it.\n   */\n  guests?: number\n  /** When staff last changed {@link guests} after booking, and who (AGL-4043). */\n  guestsChangedAtMs?: number\n  guestsChangedBy?: string\n  nights?: number\n  totalCents?: number\n  depositCents?: number\n  /** Payments applied so far (deposit, folio settlements). */\n  paidCents?: number\n  /** POS folio lines charged to the stay (AGL-317). */\n  folio?: Array<{\n    orderId: string\n    amountCents: number\n    note?: string\n    atMs: number\n  }>\n  checkoutSessionId?: string\n  createdAtMs?: number\n  /**\n   * WHICH tax regime the paid deposit carried (AGL-1969), stamped at\n   * confirmation from the same `storefrontTaxModeOf` derivation every order\n   * door uses (AGL-2451).\n   *\n   * `manual` on a stay whose merchant had set a lodging rate\n   * (`TaxSettings.lodging`), `none` where they had not — which is the default\n   * and every store that has not opted in. Never `stripe-automatic` from this\n   * path: Stripe Tax cannot compute occupancy tax without a lodging tax code\n   * `reserve.ts` does not send, so the rate is always the merchant's own and\n   * is never computed against Aglyn's registrations (AGL-1904).\n   *\n   * ABSENT is a fourth state and is not `none` — it means the reservation was\n   * confirmed before this field existed. See `StorefrontTaxMode`.\n   */\n  taxMode?: StorefrontTaxMode\n  /**\n   * The lodging tax charged on top of `paidCents` (AGL-1969), from the\n   * merchant's own rate. Absent, never zero, where none was charged.\n   *\n   * SEPARATE FROM `paidCents` on purpose: that field is the money applied to\n   * the STAY and the console divides it by `totalCents` to show what is still\n   * owed. Tax is not part of the stay's price and is not the merchant's\n   * revenue.\n   *\n   * LIMITATION, stated rather than decided: this is the rate applied to what\n   * was CHARGED, which on a deposit-taking resource is the deposit rather than\n   * the stay. Whether a jurisdiction wants occupancy tax on the full stay at\n   * booking, on the deposit, or on redemption is not a question this codebase\n   * answers — see `reserve.ts` and the merchant copy on the Taxes card.\n   */\n  taxCents?: number\n}\n\n/** UTC midnight for an instant. */\nexport function toDayMs(atMs: number): number {\n  return Math.floor(atMs / DAY_MS) * DAY_MS\n}\n\nfunction monthDay(dayMs: number): string {\n  const date = new Date(dayMs)\n  const month = String(date.getUTCMonth() + 1).padStart(2, '0')\n  const day = String(date.getUTCDate()).padStart(2, '0')\n  return `${month}-${day}`\n}\n\nfunction inSeason(dayKey: string, season: ResourceSeason): boolean {\n  if (season.from <= season.to) {\n    return dayKey >= season.from && dayKey <= season.to\n  }\n  // Wrapping season (e.g. 12-15 .. 01-05).\n  return dayKey >= season.from || dayKey <= season.to\n}\n\n/** Per-night rate in cents for one specific night. */\nexport function nightlyRateCents(\n  resource: Pick<\n    HostResource,\n    'nightlyRateUsd' | 'weekendMultiplier' | 'seasons'\n  >,\n  dayMs: number,\n): number {\n  let rate = resource.nightlyRateUsd * 100\n  const weekday = new Date(dayMs).getUTCDay()\n  if ((weekday === 5 || weekday === 6) && resource.weekendMultiplier) {\n    rate *= resource.weekendMultiplier\n  }\n  const dayKey = monthDay(dayMs)\n  for (const season of resource.seasons ?? []) {\n    if (inSeason(dayKey, season)) {\n      rate *= season.multiplier\n      break\n    }\n  }\n  return Math.round(rate)\n}\n\nexport interface ReservationQuote {\n  nights: number\n  subtotalCents: number\n  depositCents: number\n  totalCents: number\n  /** Per-night breakdown for the quote UI. */\n  nightlyCents: number[]\n  problem?: string\n}\n\n/** Prices a stay; `problem` set (and zeros) when the range is invalid. */\nexport function computeReservationQuote(\n  resource: HostResource,\n  checkInDayMs: number,\n  checkOutDayMs: number,\n): ReservationQuote {\n  const empty: ReservationQuote = {\n    nights: 0,\n    subtotalCents: 0,\n    depositCents: 0,\n    totalCents: 0,\n    nightlyCents: [],\n  }\n  const nights = Math.round((checkOutDayMs - checkInDayMs) / DAY_MS)\n  if (!(nights > 0)) return { ...empty, problem: 'Choose at least one night' }\n  if (resource.minNights && nights < resource.minNights) {\n    return { ...empty, problem: `Minimum stay is ${resource.minNights} nights` }\n  }\n  const nightlyCents: number[] = []\n  for (let day = checkInDayMs; day < checkOutDayMs; day += DAY_MS) {\n    nightlyCents.push(nightlyRateCents(resource, day))\n  }\n  const subtotalCents = nightlyCents.reduce((sum, cents) => sum + cents, 0)\n  const depositPct = Math.min(100, Math.max(0, resource.depositPct ?? 100))\n  const depositCents = Math.round((subtotalCents * depositPct) / 100)\n  return {\n    nights,\n    subtotalCents,\n    depositCents,\n    totalCents: subtotalCents,\n    nightlyCents,\n  }\n}\n\n/**\n * How long an unpaid `pending` reservation stands between the next guest and\n * the dates it named.\n *\n * A `pending` row is written before the Stripe session opens, and nothing ever\n * clears one: `process-abandoned.ts` sweeps `checkouts`, not `reservations`.\n * So the hold has to lapse by the clock rather than by a job, or one guest who\n * closed the tab at the payment screen takes those dates off the market\n * permanently.\n */\nexport const PENDING_RESERVATION_HOLD_MS = 30 * 60 * 1000\n\n/**\n * Does this reservation still stand between a guest and its dates?\n *\n * THE one answer, because four surfaces ask it — the booking door, the booking\n * transaction's re-read, the storefront availability endpoint behind the\n * date-picker, and the console's walk-in check — and they were not asking it\n * the same way. Only the booking door aged out a stale `pending`, so the\n * storefront painted dates unavailable that the booking door would have sold,\n * and the front desk was told a room was taken while it stood empty.\n *\n * A `pending` row carrying no `createdAtMs` releases rather than holds: an\n * unbounded hold on a row that cannot prove its own age is the failure this\n * lapse exists to prevent, and the booking door re-checks inside its\n * transaction before any money moves.\n */\nexport function reservationHoldsDates(\n  reservation: Pick<HostReservation, 'status'> & { createdAtMs?: number },\n  nowMs: number = Date.now(),\n): boolean {\n  if (reservation.status === 'cancelled' || reservation.status === 'no_show') {\n    return false\n  }\n  if (reservation.status !== 'pending') return true\n  const createdAtMs = Number(reservation.createdAtMs ?? 0)\n  return createdAtMs > 0 && nowMs - createdAtMs < PENDING_RESERVATION_HOLD_MS\n}\n\n/** The most identical units one resource can hold (AGL-4044). */\nexport const MAX_RESOURCE_UNITS = 500\n\n/**\n * How many units a resource holds: the stored `units` as a whole number from 1\n * to {@link MAX_RESOURCE_UNITS}, and 1 for anything else (absent, zero,\n * negative, not a number). Closing a resource is what `blocks` are for, so no\n * stored value can make a resource hold no units at all.\n */\nexport function resourceUnits(\n  resource: Pick<HostResource, 'units'> | null | undefined,\n): number {\n  const units = Math.floor(Number(resource?.units))\n  if (!Number.isFinite(units) || units < 1) return 1\n  return Math.min(MAX_RESOURCE_UNITS, units)\n}\n\n/** A reservation as an availability check reads it. */\nexport type HeldStay = Pick<\n  HostReservation,\n  'checkInDayMs' | 'checkOutDayMs' | 'status'\n> & {\n  createdAtMs?: number\n}\n\n/**\n * How many units are taken on each night from `fromDayMs` up to (not\n * including) `toDayMs`, one entry per night, counting only the stays that\n * still hold their dates ({@link reservationHoldsDates}). A stay takes a night\n * when it overlaps it, with the same `[checkIn, checkOut)` semantics as\n * {@link isRangeAvailable}: a stay that leaves the morning another arrives\n * does not take that night.\n */\nexport function unitsTakenByNight(\n  reservations: HeldStay[],\n  fromDayMs: number,\n  toDayMs: number,\n  nowMs: number = Date.now(),\n): number[] {\n  const live = reservations.filter((reservation) =>\n    reservationHoldsDates(reservation, nowMs),\n  )\n  const taken: number[] = []\n  for (let night = fromDayMs; night < toDayMs; night += DAY_MS) {\n    const nightEnd = Math.min(night + DAY_MS, toDayMs)\n    let count = 0\n    for (const reservation of live) {\n      if (\n        reservation.checkInDayMs < nightEnd &&\n        reservation.checkOutDayMs > night\n      ) {\n        count++\n      }\n    }\n    taken.push(count)\n  }\n  return taken\n}\n\n/** One night of a resource: how many of its units are still free. */\nexport interface ResourceNightUnits {\n  dayMs: number\n  unitsLeft: number\n  units: number\n}\n\n/**\n * Units left on each of `nights` nights from `fromDayMs`: the resource's\n * units less the stays holding that night, and none on a blocked night,\n * because a block closes the whole resource.\n */\nexport function unitsLeftByNight(\n  resource: Pick<HostResource, 'units' | 'blocks'>,\n  reservations: HeldStay[],\n  fromDayMs: number,\n  nights: number,\n  nowMs: number = Date.now(),\n): ResourceNightUnits[] {\n  const units = resourceUnits(resource)\n  const toDayMs = fromDayMs + Math.max(0, Math.floor(nights)) * DAY_MS\n  return unitsTakenByNight(reservations, fromDayMs, toDayMs, nowMs).map(\n    (taken, index) => {\n      const dayMs = fromDayMs + index * DAY_MS\n      const blocked = (resource.blocks ?? []).some(\n        (block) => dayMs < block.toDayMs && dayMs + DAY_MS > block.fromDayMs,\n      )\n      return {\n        dayMs,\n        units,\n        unitsLeft: blocked ? 0 : Math.max(0, units - taken),\n      }\n    },\n  )\n}\n\n/**\n * Availability: a candidate range is free when, on EVERY night in it, fewer\n * live reservations overlap that night than the resource has units\n * (AGL-4044), and no manual block touches it. `[checkIn, checkOut)`\n * semantics, so back-to-back stays touch without conflict. A block closes the\n * whole resource, every unit at once.\n *\n * One unit (the default, and every resource written before `units`) takes\n * the original path unchanged: the range conflicts when it overlaps any live\n * reservation at all.\n *\n * `nowMs` is a parameter so the pending lapse is testable without freezing the\n * clock. A caller passing reservations without `createdAtMs` gets the same\n * answer as before for every status but `pending`.\n */\nexport function isRangeAvailable(\n  resource: Pick<HostResource, 'blocks' | 'units'>,\n  reservations: HeldStay[],\n  checkInDayMs: number,\n  checkOutDayMs: number,\n  nowMs: number = Date.now(),\n): boolean {\n  if (!(checkOutDayMs > checkInDayMs)) return false\n  for (const block of resource.blocks ?? []) {\n    if (checkInDayMs < block.toDayMs && checkOutDayMs > block.fromDayMs) {\n      return false\n    }\n  }\n  const units = resourceUnits(resource)\n  if (units === 1) {\n    for (const reservation of reservations) {\n      if (!reservationHoldsDates(reservation, nowMs)) continue\n      if (\n        checkInDayMs < reservation.checkOutDayMs &&\n        checkOutDayMs > reservation.checkInDayMs\n      ) {\n        return false\n      }\n    }\n    return true\n  }\n  return unitsTakenByNight(\n    reservations,\n    checkInDayMs,\n    checkOutDayMs,\n    nowMs,\n  ).every((taken) => taken < units)\n}\n\n/**\n * The widget's scarcity line starts at this many units left (AGL-4044):\n * \"Only 2 left\". Never on a one-unit resource, where every free night would\n * read \"Only 1 left\", and never on a night nothing is booked on.\n * A resource may set its own threshold, {@link HostResource.fewLeftAt}.\n */\nexport const FEW_UNITS_LEFT = 3\n\n/**\n * When a resource's scarcity line starts: its own `fewLeftAt` as a whole\n * number from 0 (never) to {@link MAX_RESOURCE_UNITS}, and\n * {@link FEW_UNITS_LEFT} for anything else (absent, negative, not a number),\n * so a resource saved before the setting existed reads exactly as it did.\n */\nexport function resourceFewLeftAt(\n  resource: Pick<HostResource, 'fewLeftAt'> | null | undefined,\n): number {\n  const raw = resource?.fewLeftAt\n  if (raw === undefined || raw === null || (raw as unknown) === '') return FEW_UNITS_LEFT\n  const at = Math.floor(Number(raw))\n  if (!Number.isFinite(at) || at < 0) return FEW_UNITS_LEFT\n  return Math.min(MAX_RESOURCE_UNITS, at)\n}\n\n/**\n * The fewest units left across `[checkInDayMs, checkOutDayMs)` when that is\n * `fewLeftAt` or fewer and at least one, else null. `fewLeft` lists only the\n * scarce nights, as the availability endpoint sends them; a night it leaves\n * out has more than the resource's threshold free. `fewLeftAt` is the\n * resource's threshold ({@link resourceFewLeftAt}); 0 never shows the line.\n */\nexport function fewestUnitsLeft(\n  fewLeft: Array<{ dayMs: number; unitsLeft: number }> | null | undefined,\n  checkInDayMs: number,\n  checkOutDayMs: number,\n  fewLeftAt: number = FEW_UNITS_LEFT,\n): number | null {\n  let fewest: number | null = null\n  for (const night of fewLeft ?? []) {\n    if (night.dayMs < checkInDayMs || night.dayMs >= checkOutDayMs) continue\n    if (!(night.unitsLeft >= 1) || night.unitsLeft > fewLeftAt) continue\n    fewest = fewest === null ? night.unitsLeft : Math.min(fewest, night.unitsLeft)\n  }\n  return fewest\n}\n\n/** The most guests one stay may name when its resource says nothing of how many it sleeps. */\nexport const MAX_RESERVATION_GUESTS = 50\n\n/** Where staff change a stay's guest count after it is booked (AGL-4043): `{ hostId, reservationId, guests }`. */\nexport const RESERVATION_GUESTS_ROUTE = '/api/commerce/reservations/guests'\n\n/**\n * The most guests a stay on this resource may name: what one unit sleeps\n * (`capacity`), else {@link MAX_RESERVATION_GUESTS}.\n */\nexport function resourceGuestCeiling(resource: Pick<HostResource, 'capacity'> | null | undefined): number {\n  const sleeps = Math.floor(Number(resource?.capacity))\n  return Number.isFinite(sleeps) && sleeps >= 1 ? Math.min(sleeps, MAX_RESERVATION_GUESTS) : MAX_RESERVATION_GUESTS\n}\n\n/** How many guests a stay is for: its `guests` as a whole number of at least 1, else 1. */\nexport function reservationGuests(reservation: Pick<HostReservation, 'guests'> | null | undefined): number {\n  const guests = Math.floor(Number(reservation?.guests))\n  return Number.isFinite(guests) && guests >= 1 ? Math.min(guests, MAX_RESERVATION_GUESTS) : 1\n}\n\n/**\n * Why a guest count cannot be booked on a resource, or null. Absent (or\n * empty) is fine: the stay is for one guest as far as check-in is concerned.\n */\nexport function reservationGuestsProblem(\n  guests: unknown,\n  resource: Pick<HostResource, 'capacity'> | null | undefined,\n): string | null {\n  if (guests === undefined || guests === null || guests === '') return null\n  const count = Number(guests)\n  const ceiling = resourceGuestCeiling(resource)\n  if (!Number.isInteger(count) || count < 1 || count > ceiling) {\n    return ceiling === 1 ? 'This stay sleeps 1 guest' : `Guests must be a whole number from 1 to ${ceiling}`\n  }\n  return null\n}\n\n/**\n * How the store checks stays in (AGL-4043), the quick control on the\n * check-in screen: `resource` follows each resource's own setting\n * ({@link HostResource.checkInPerGuest}); `stay` and `guest` set every\n * resource at once. Stored at `hosts/{hostId}/settings/checkIn.stays`.\n */\nexport type StayCheckInMode = 'resource' | 'stay' | 'guest'\n\nexport const STAY_CHECK_IN_MODES: readonly StayCheckInMode[] = ['resource', 'stay', 'guest']\n\n/** A stored mode made safe: anything unknown follows each resource. */\nexport function readStayCheckInMode(value: unknown): StayCheckInMode {\n  return value === 'stay' || value === 'guest' ? value : 'resource'\n}\n\n/** Whether a stay on this resource is checked in one guest at a time, under the store's mode. */\nexport function stayChecksInPerGuest(\n  resource: Pick<HostResource, 'checkInPerGuest'> | null | undefined,\n  mode: StayCheckInMode,\n): boolean {\n  if (mode === 'guest') return true\n  if (mode === 'stay') return false\n  return resource?.checkInPerGuest === true\n}\n\n/** Free-cancellation check against the policy window. */\nexport function canCancelReservation(\n  resource: Pick<HostResource, 'cancellationHours'>,\n  reservation: Pick<HostReservation, 'checkInDayMs' | 'status'>,\n  nowMs = Date.now(),\n): boolean {\n  if (!['pending', 'confirmed'].includes(reservation.status)) return false\n  const windowMs = (resource.cancellationHours ?? 0) * 60 * 60 * 1000\n  return nowMs <= reservation.checkInDayMs - windowMs\n}\n"],"names":["DAY_MS","toDayMs","atMs","Math","floor","monthDay","dayMs","date","Date","month","String","getUTCMonth","padStart","day","getUTCDate","inSeason","dayKey","season","from","to","nightlyRateCents","resource","rate","nightlyRateUsd","weekday","getUTCDay","weekendMultiplier","seasons","multiplier","round","computeReservationQuote","checkInDayMs","checkOutDayMs","empty","nights","subtotalCents","depositCents","totalCents","nightlyCents","problem","minNights","push","reduce","sum","cents","depositPct","min","max","PENDING_RESERVATION_HOLD_MS","reservationHoldsDates","reservation","nowMs","now","status","createdAtMs","Number","MAX_RESOURCE_UNITS","resourceUnits","units","isFinite","unitsTakenByNight","reservations","fromDayMs","live","filter","taken","night","nightEnd","count","unitsLeftByNight","map","index","blocked","blocks","some","block","unitsLeft","isRangeAvailable","every","FEW_UNITS_LEFT","resourceFewLeftAt","raw","fewLeftAt","undefined","at","fewestUnitsLeft","fewLeft","fewest","MAX_RESERVATION_GUESTS","RESERVATION_GUESTS_ROUTE","resourceGuestCeiling","sleeps","capacity","reservationGuests","guests","reservationGuestsProblem","ceiling","isInteger","STAY_CHECK_IN_MODES","readStayCheckInMode","value","stayChecksInPerGuest","mode","checkInPerGuest","canCancelReservation","includes","windowMs","cancellationHours"],"mappings":"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"}

package/src/lib/model/commerce.d.ts

@@ -76,6 +76,11 @@ export interface ProductVariant {
      * product's own setting; absent follows the product.
      */
     checkIn?: ProductCheckIn;
+    /**
+     * Whether the self-service kiosk offers this variant (AGL-4038), within the
+     * product's own choice: `false` leaves it out; absent follows the product.
+     */
+    offerOnKiosk?: boolean;
 }
 /** A product's packed size and customs facts (AGL-3612). */
 export interface ProductShippingFacts {
@@ -169,6 +174,13 @@ export interface HostProduct {
     name: string;
     /** Host-unique URL segment for /products/{slug}. */
     slug: string;
+    /**
+     * A SAMPLE a guided start made for the merchant to replace (AGL-4065): the
+     * store's brief named kinds of product and no product. Products shows it
+     * as a sample; the storefront never reads it; the merchant's save clears
+     * it (`productSaveFields`).
+     */
+    sample?: boolean;
     description?: string;
     type: ProductType;
     status: ProductStatus;
@@ -263,6 +275,31 @@ export interface HostProduct {
      * {@link productSellsOnline}, never as a truthy field.
      */
     sellOnline?: boolean;
+    /**
+     * What the site's review surfaces do with the reviews of a product sold in
+     * person only (`sellOnline: false`, AGL-4060): `show` (or absent) lists
+     * them, marked "Sold in store" and never linked; `hide` keeps them off
+     * every online surface — the store-wide reviews list and its average. A
+     * product sold online ignores it. Read it through
+     * {@link productReviewsOnline}.
+     */
+    inStoreReviews?: 'show' | 'hide';
+    /**
+     * Whether the self-service kiosk offers the product (AGL-4038): `false`
+     * leaves it off the kiosk's grid and refuses it in a kiosk's cart, while
+     * the register, the POS apps and the site sell it as before. Absent reads
+     * as `true`, so every product stored before the choice is offered as it
+     * was; read it through `productOfferedOnKiosk` (`commerce-kiosk-offer.ts`). A variant's own
+     * `offerOnKiosk` narrows it further.
+     */
+    offerOnKiosk?: boolean;
+    /**
+     * The point of sale hardware item this product IS (AGL-4038), by its id in
+     * the hardware catalog (`POS_HARDWARE_SKUS`): a sale of it on the
+     * platform's own store becomes a hardware order for the buyer's workspace.
+     * Read only on that store; on any other store it means nothing.
+     */
+    hardwareSku?: string;
     /**
      * A pass, a camping spot, parking: each item sold is somebody to check in
      * at the window on the day it was bought, `headcount` people per item
@@ -741,6 +778,12 @@ export declare function smartCollectionMatches(product: MembershipProduct, colle
 export declare function productSellsOnline(product: {
     sellOnline?: unknown;
 } | null | undefined): boolean;
+/** Whether a product is a sample a guided start made for the merchant to replace (AGL-4065). */
+export declare function productIsSample(product: {
+    sample?: unknown;
+} | null | undefined): boolean;
+/** What Products says beside a sample (AGL-4065). */
+export declare const PRODUCT_SAMPLE_NOTE = "A sample made from the kinds of product your site\u2019s brief named. Replace it with your own product: saving your changes makes it yours.";
 /**
  * Whether a shopper online may see or buy a product (AGL-4060): live, active
  * and sold online. Every online surface (the product page, grids, search,
@@ -752,6 +795,29 @@ export declare function productListedOnline(product: {
     status?: unknown;
     sellOnline?: unknown;
 } | null | undefined): boolean;
+/** The choices a product sold in person only has for its reviews on the site (AGL-4060). */
+export declare const IN_STORE_REVIEWS_CHOICES: readonly ["show", "hide"];
+/**
+ * How a product's reviews appear on the site's online review surfaces
+ * (AGL-4060), or `null` when there is no product to say (deleted, a draft):
+ *
+ * - `listed`: sold online, so named and linked to its page;
+ * - `sold-in-store`: sold in person only, and the store shows its reviews —
+ *   the default — named, marked "Sold in store", never linked (there is no
+ *   page to link to);
+ * - `hidden`: sold in person only, and the store chose to keep its reviews
+ *   off the site: in no list and no average.
+ *
+ * The store's choice is honored whatever the product's status, so a hidden
+ * product archived later stays hidden.
+ */
+export type ProductReviewsOnline = 'listed' | 'sold-in-store' | 'hidden';
+export declare function productReviewsOnline(product: {
+    deletedAt?: unknown;
+    status?: unknown;
+    sellOnline?: unknown;
+    inStoreReviews?: unknown;
+} | null | undefined): ProductReviewsOnline | null;
 /**
  * Smart-collection membership: draft/archived/deleted products never
  * match; manual collections answer from productIds.

package/src/lib/model/commerce.js

@@ -767,6 +767,10 @@ export function smartCollectionMatches(product, collection) {
  */ export function productSellsOnline(product) {
     return (product == null ? void 0 : product.sellOnline) !== false;
 }
+/** Whether a product is a sample a guided start made for the merchant to replace (AGL-4065). */ export function productIsSample(product) {
+    return (product == null ? void 0 : product.sample) === true;
+}
+/** What Products says beside a sample (AGL-4065). */ export const PRODUCT_SAMPLE_NOTE = 'A sample made from the kinds of product your site’s brief named. Replace it with your own product: saving your changes makes it yours.';
 /**
  * Whether a shopper online may see or buy a product (AGL-4060): live, active
  * and sold online. Every online surface (the product page, grids, search,
@@ -775,6 +779,17 @@ export function smartCollectionMatches(product, collection) {
  */ export function productListedOnline(product) {
     return Boolean(product) && !(product == null ? void 0 : product.deletedAt) && (product == null ? void 0 : product.status) === 'active' && productSellsOnline(product);
 }
+/** The choices a product sold in person only has for its reviews on the site (AGL-4060). */ export const IN_STORE_REVIEWS_CHOICES = [
+    'show',
+    'hide'
+];
+export function productReviewsOnline(product) {
+    if (!product) return null;
+    if (!productSellsOnline(product) && product.inStoreReviews === 'hide') return 'hidden';
+    if (productListedOnline(product)) return 'listed';
+    if (!product.deletedAt && product.status === 'active' && !productSellsOnline(product)) return 'sold-in-store';
+    return null;
+}
 /**
  * Smart-collection membership: draft/archived/deleted products never
  * match; manual collections answer from productIds.