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

package/src/lib/model/commerce-check-in-product.d.ts

@@ -30,7 +30,33 @@ export interface ProductCheckIn {
     enabled: boolean;
     /** People one item admits, 1–{@link CHECK_IN_MAX_HEADCOUNT}; absent is 1. */
     headcount?: number;
+    /**
+     * Ask the buyer which day they will use it (a day pass bought ahead), as an
+     * optional date at checkout. Without an answer the item is due on the day
+     * it was bought, as every check-in item always has been. Absent is off.
+     */
+    askUseDate?: boolean;
 }
+/** The furthest ahead a buyer may choose a use day: about two years. */
+export declare const CHECK_IN_USE_DAY_MAX_AHEAD_DAYS = 730;
+/** Whether a value is a real calendar day written `YYYY-MM-DD`. */
+export declare function isCheckInDayKey(value: unknown): value is string;
+/** The day key `days` after (or before, when negative) another. */
+export declare function addCheckInDays(dayKey: string, days: number): string;
+/**
+ * A day as the window and the cart read it: "Sat, Nov 1". It lives here, not
+ * beside the rain checks, because the storefront cart prints a line's use day,
+ * and reaching `commerce-check-in.ts` from the cart pulls the check-in window,
+ * the POS helpers and the receipt into the plugin's eager bytes
+ * (`check:plugin-budgets`).
+ */
+export declare function checkInDayLabel(dayKey: string | null | undefined): string;
+/**
+ * Why a chosen use day cannot be sold, or null: a day that is not a date, a
+ * day before `todayKey` (today on the store's calendar), or one further
+ * ahead than {@link CHECK_IN_USE_DAY_MAX_AHEAD_DAYS}.
+ */
+export declare function checkInUseDayProblem(value: unknown, todayKey: string): string | null;
 /** A stored check-in setting made safe, or `undefined` when it says nothing. */
 export declare function normalizeProductCheckIn(value: unknown): ProductCheckIn | undefined;
 /** Why a check-in setting cannot be saved, or `null`. */

package/src/lib/model/commerce-check-in-product.js

@@ -1,3 +1,4 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
 /**
  * @license
  * Copyright 2026 Aglyn LLC
@@ -18,6 +19,61 @@
  * check-in and how many people one item admits. It has no imports, so the
  * native contracts and the console read the same shape and rules.
  */ /** The most people one item admits. */ export const CHECK_IN_MAX_HEADCOUNT = 50;
+/*==========================================
+ * THE USE DAY (pass dates, AGL-4043)
+ *
+ * The day an item is for is a day key, `YYYY-MM-DD` on the store's own
+ * calendar (its time zone): the same key a check-in's `dayKey`, the day
+ * totals' `from`/`to` and the check-in day picker use. An order line
+ * carries the buyer's answer as `useDayKey`; a line without one is due on
+ * the day the order was placed.
+ *=========================================*/ /** The furthest ahead a buyer may choose a use day: about two years. */ export const CHECK_IN_USE_DAY_MAX_AHEAD_DAYS = 730;
+const DAY_KEY = /^(\d{4})-(\d{2})-(\d{2})$/;
+/** UTC midnight of a real `YYYY-MM-DD` calendar day, or null. */ function dayKeyMs(value) {
+    const match = typeof value === 'string' ? DAY_KEY.exec(value) : null;
+    if (!match) return null;
+    const year = Number(match[1]);
+    const month = Number(match[2]);
+    const day = Number(match[3]);
+    const ms = Date.UTC(year, month - 1, day);
+    const check = new Date(ms);
+    return check.getUTCFullYear() === year && check.getUTCMonth() === month - 1 && check.getUTCDate() === day ? ms : null;
+}
+/** Whether a value is a real calendar day written `YYYY-MM-DD`. */ export function isCheckInDayKey(value) {
+    return dayKeyMs(value) !== null;
+}
+/** The day key `days` after (or before, when negative) another. */ export function addCheckInDays(dayKey, days) {
+    const ms = dayKeyMs(dayKey);
+    if (ms === null) return dayKey;
+    return new Date(ms + Math.round(days) * 86400000).toISOString().slice(0, 10);
+}
+/**
+ * A day as the window and the cart read it: "Sat, Nov 1". It lives here, not
+ * beside the rain checks, because the storefront cart prints a line's use day,
+ * and reaching `commerce-check-in.ts` from the cart pulls the check-in window,
+ * the POS helpers and the receipt into the plugin's eager bytes
+ * (`check:plugin-budgets`).
+ */ export function checkInDayLabel(dayKey) {
+    if (!isCheckInDayKey(dayKey)) return '';
+    return new Intl.DateTimeFormat('en-US', {
+        weekday: 'short',
+        month: 'short',
+        day: 'numeric',
+        timeZone: 'UTC'
+    }).format(new Date(`${dayKey}T00:00:00Z`));
+}
+/**
+ * Why a chosen use day cannot be sold, or null: a day that is not a date, a
+ * day before `todayKey` (today on the store's calendar), or one further
+ * ahead than {@link CHECK_IN_USE_DAY_MAX_AHEAD_DAYS}.
+ */ export function checkInUseDayProblem(value, todayKey) {
+    if (!isCheckInDayKey(value)) return 'Choose the day as a date.';
+    if (value < todayKey) return 'That day has passed. Choose today or a later day.';
+    if (value > addCheckInDays(todayKey, CHECK_IN_USE_DAY_MAX_AHEAD_DAYS)) {
+        return 'Choose a day within the next two years.';
+    }
+    return null;
+}
 function headcountOf(value) {
     const count = Math.round(Number(value));
     return Number.isFinite(count) && count >= 1 ? Math.min(count, CHECK_IN_MAX_HEADCOUNT) : 1;
@@ -26,10 +82,12 @@ function headcountOf(value) {
     if (!value || typeof value !== 'object') return undefined;
     const raw = value;
     if (typeof raw['enabled'] !== 'boolean') return undefined;
-    return raw['enabled'] ? {
+    return raw['enabled'] ? _extends({
         enabled: true,
         headcount: headcountOf(raw['headcount'])
-    } : {
+    }, raw['askUseDate'] === true ? {
+        askUseDate: true
+    } : {}) : {
         enabled: false
     };
 }
@@ -38,6 +96,10 @@ function headcountOf(value) {
     if (typeof value !== 'object' || typeof value.enabled !== 'boolean') {
         return 'Check-in must be on or off';
     }
+    const askUseDate = value.askUseDate;
+    if (askUseDate !== undefined && typeof askUseDate !== 'boolean') {
+        return 'Asking for a use date must be on or off';
+    }
     const headcount = value.headcount;
     if (headcount === undefined) return null;
     if (!Number.isInteger(headcount) || headcount < 1 || headcount > CHECK_IN_MAX_HEADCOUNT) {

package/src/lib/model/commerce-check-in-product.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/commerce-check-in-product.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 * The product and variant check-in setting (AGL-4043): whether an item needs\n * check-in and how many people one item admits. It has no imports, so the\n * native contracts and the console read the same shape and rules.\n */\n\n/** The most people one item admits. */\nexport const CHECK_IN_MAX_HEADCOUNT = 50\n\n/**\n * Whether a product (or one variant) needs check-in (AGL-4043), and how\n * many people one item admits. On a product it is the default for every\n * variant; on a variant it overrides the product's.\n */\nexport interface ProductCheckIn {\n  enabled: boolean\n  /** People one item admits, 1–{@link CHECK_IN_MAX_HEADCOUNT}; absent is 1. */\n  headcount?: number\n}\n\nfunction headcountOf(value: unknown): number {\n  const count = Math.round(Number(value))\n  return Number.isFinite(count) && count >= 1 ? Math.min(count, CHECK_IN_MAX_HEADCOUNT) : 1\n}\n\n/** A stored check-in setting made safe, or `undefined` when it says nothing. */\nexport function normalizeProductCheckIn(value: unknown): ProductCheckIn | undefined {\n  if (!value || typeof value !== 'object') return undefined\n  const raw = value as Record<string, unknown>\n  if (typeof raw['enabled'] !== 'boolean') return undefined\n  return raw['enabled']\n    ? { enabled: true, headcount: headcountOf(raw['headcount']) }\n    : { enabled: false }\n}\n\n/** Why a check-in setting cannot be saved, or `null`. */\nexport function productCheckInProblem(value: unknown): string | null {\n  if (value === undefined || value === null) return null\n  if (typeof value !== 'object' || typeof (value as ProductCheckIn).enabled !== 'boolean') {\n    return 'Check-in must be on or off'\n  }\n  const headcount = (value as ProductCheckIn).headcount\n  if (headcount === undefined) return null\n  if (!Number.isInteger(headcount) || headcount < 1 || headcount > CHECK_IN_MAX_HEADCOUNT) {\n    return `People per item must be a whole number from 1 to ${CHECK_IN_MAX_HEADCOUNT}`\n  }\n  return null\n}\n"],"names":["CHECK_IN_MAX_HEADCOUNT","headcountOf","value","count","Math","round","Number","isFinite","min","normalizeProductCheckIn","undefined","raw","enabled","headcount","productCheckInProblem","isInteger"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;CAIC,GAED,qCAAqC,GACrC,OAAO,MAAMA,yBAAyB,GAAE;AAaxC,SAASC,YAAYC,KAAc;IACjC,MAAMC,QAAQC,KAAKC,KAAK,CAACC,OAAOJ;IAChC,OAAOI,OAAOC,QAAQ,CAACJ,UAAUA,SAAS,IAAIC,KAAKI,GAAG,CAACL,OAAOH,0BAA0B;AAC1F;AAEA,8EAA8E,GAC9E,OAAO,SAASS,wBAAwBP,KAAc;IACpD,IAAI,CAACA,SAAS,OAAOA,UAAU,UAAU,OAAOQ;IAChD,MAAMC,MAAMT;IACZ,IAAI,OAAOS,GAAG,CAAC,UAAU,KAAK,WAAW,OAAOD;IAChD,OAAOC,GAAG,CAAC,UAAU,GACjB;QAAEC,SAAS;QAAMC,WAAWZ,YAAYU,GAAG,CAAC,YAAY;IAAE,IAC1D;QAAEC,SAAS;IAAM;AACvB;AAEA,uDAAuD,GACvD,OAAO,SAASE,sBAAsBZ,KAAc;IAClD,IAAIA,UAAUQ,aAAaR,UAAU,MAAM,OAAO;IAClD,IAAI,OAAOA,UAAU,YAAY,OAAO,AAACA,MAAyBU,OAAO,KAAK,WAAW;QACvF,OAAO;IACT;IACA,MAAMC,YAAY,AAACX,MAAyBW,SAAS;IACrD,IAAIA,cAAcH,WAAW,OAAO;IACpC,IAAI,CAACJ,OAAOS,SAAS,CAACF,cAAcA,YAAY,KAAKA,YAAYb,wBAAwB;QACvF,OAAO,CAAC,iDAAiD,EAAEA,wBAAwB;IACrF;IACA,OAAO;AACT"}
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/commerce-check-in-product.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 * The product and variant check-in setting (AGL-4043): whether an item needs\n * check-in and how many people one item admits. It has no imports, so the\n * native contracts and the console read the same shape and rules.\n */\n\n/** The most people one item admits. */\nexport const CHECK_IN_MAX_HEADCOUNT = 50\n\n/**\n * Whether a product (or one variant) needs check-in (AGL-4043), and how\n * many people one item admits. On a product it is the default for every\n * variant; on a variant it overrides the product's.\n */\nexport interface ProductCheckIn {\n  enabled: boolean\n  /** People one item admits, 1–{@link CHECK_IN_MAX_HEADCOUNT}; absent is 1. */\n  headcount?: number\n  /**\n   * Ask the buyer which day they will use it (a day pass bought ahead), as an\n   * optional date at checkout. Without an answer the item is due on the day\n   * it was bought, as every check-in item always has been. Absent is off.\n   */\n  askUseDate?: boolean\n}\n\n/*==========================================\n * THE USE DAY (pass dates, AGL-4043)\n *\n * The day an item is for is a day key, `YYYY-MM-DD` on the store's own\n * calendar (its time zone): the same key a check-in's `dayKey`, the day\n * totals' `from`/`to` and the check-in day picker use. An order line\n * carries the buyer's answer as `useDayKey`; a line without one is due on\n * the day the order was placed.\n *=========================================*/\n\n/** The furthest ahead a buyer may choose a use day: about two years. */\nexport const CHECK_IN_USE_DAY_MAX_AHEAD_DAYS = 730\n\nconst DAY_KEY = /^(\\d{4})-(\\d{2})-(\\d{2})$/\n\n/** UTC midnight of a real `YYYY-MM-DD` calendar day, or null. */\nfunction dayKeyMs(value: unknown): number | null {\n  const match = typeof value === 'string' ? DAY_KEY.exec(value) : null\n  if (!match) return null\n  const year = Number(match[1])\n  const month = Number(match[2])\n  const day = Number(match[3])\n  const ms = Date.UTC(year, month - 1, day)\n  const check = new Date(ms)\n  return check.getUTCFullYear() === year && check.getUTCMonth() === month - 1 && check.getUTCDate() === day\n    ? ms\n    : null\n}\n\n/** Whether a value is a real calendar day written `YYYY-MM-DD`. */\nexport function isCheckInDayKey(value: unknown): value is string {\n  return dayKeyMs(value) !== null\n}\n\n/** The day key `days` after (or before, when negative) another. */\nexport function addCheckInDays(dayKey: string, days: number): string {\n  const ms = dayKeyMs(dayKey)\n  if (ms === null) return dayKey\n  return new Date(ms + Math.round(days) * 86_400_000).toISOString().slice(0, 10)\n}\n\n/**\n * A day as the window and the cart read it: \"Sat, Nov 1\". It lives here, not\n * beside the rain checks, because the storefront cart prints a line's use day,\n * and reaching `commerce-check-in.ts` from the cart pulls the check-in window,\n * the POS helpers and the receipt into the plugin's eager bytes\n * (`check:plugin-budgets`).\n */\nexport function checkInDayLabel(dayKey: string | null | undefined): string {\n  if (!isCheckInDayKey(dayKey)) return ''\n  return new Intl.DateTimeFormat('en-US', {\n    weekday: 'short',\n    month: 'short',\n    day: 'numeric',\n    timeZone: 'UTC',\n  }).format(new Date(`${dayKey}T00:00:00Z`))\n}\n\n/**\n * Why a chosen use day cannot be sold, or null: a day that is not a date, a\n * day before `todayKey` (today on the store's calendar), or one further\n * ahead than {@link CHECK_IN_USE_DAY_MAX_AHEAD_DAYS}.\n */\nexport function checkInUseDayProblem(value: unknown, todayKey: string): string | null {\n  if (!isCheckInDayKey(value)) return 'Choose the day as a date.'\n  if (value < todayKey) return 'That day has passed. Choose today or a later day.'\n  if (value > addCheckInDays(todayKey, CHECK_IN_USE_DAY_MAX_AHEAD_DAYS)) {\n    return 'Choose a day within the next two years.'\n  }\n  return null\n}\n\nfunction headcountOf(value: unknown): number {\n  const count = Math.round(Number(value))\n  return Number.isFinite(count) && count >= 1 ? Math.min(count, CHECK_IN_MAX_HEADCOUNT) : 1\n}\n\n/** A stored check-in setting made safe, or `undefined` when it says nothing. */\nexport function normalizeProductCheckIn(value: unknown): ProductCheckIn | undefined {\n  if (!value || typeof value !== 'object') return undefined\n  const raw = value as Record<string, unknown>\n  if (typeof raw['enabled'] !== 'boolean') return undefined\n  return raw['enabled']\n    ? {\n        enabled: true,\n        headcount: headcountOf(raw['headcount']),\n        ...(raw['askUseDate'] === true ? { askUseDate: true } : {}),\n      }\n    : { enabled: false }\n}\n\n/** Why a check-in setting cannot be saved, or `null`. */\nexport function productCheckInProblem(value: unknown): string | null {\n  if (value === undefined || value === null) return null\n  if (typeof value !== 'object' || typeof (value as ProductCheckIn).enabled !== 'boolean') {\n    return 'Check-in must be on or off'\n  }\n  const askUseDate = (value as ProductCheckIn).askUseDate\n  if (askUseDate !== undefined && typeof askUseDate !== 'boolean') {\n    return 'Asking for a use date must be on or off'\n  }\n  const headcount = (value as ProductCheckIn).headcount\n  if (headcount === undefined) return null\n  if (!Number.isInteger(headcount) || headcount < 1 || headcount > CHECK_IN_MAX_HEADCOUNT) {\n    return `People per item must be a whole number from 1 to ${CHECK_IN_MAX_HEADCOUNT}`\n  }\n  return null\n}\n"],"names":["CHECK_IN_MAX_HEADCOUNT","CHECK_IN_USE_DAY_MAX_AHEAD_DAYS","DAY_KEY","dayKeyMs","value","match","exec","year","Number","month","day","ms","Date","UTC","check","getUTCFullYear","getUTCMonth","getUTCDate","isCheckInDayKey","addCheckInDays","dayKey","days","Math","round","toISOString","slice","checkInDayLabel","Intl","DateTimeFormat","weekday","timeZone","format","checkInUseDayProblem","todayKey","headcountOf","count","isFinite","min","normalizeProductCheckIn","undefined","raw","enabled","headcount","askUseDate","productCheckInProblem","isInteger"],"mappings":"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"}

package/src/lib/model/commerce-check-in-record.d.ts

@@ -0,0 +1,127 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { OrderChannel } from './commerce-orders';
+export declare const POS_CHECK_IN_ROUTE = "/api/commerce/pos-check-in";
+/** The most check-ins one tap records. */
+export declare const CHECK_IN_BATCH_MAX = 50;
+/** A wristband's number or color, at most this many characters. */
+export declare const CHECK_IN_WRISTBAND_MAX = 24;
+/** Colors offered as quick picks for a wristband. Any word is accepted. */
+export declare const CHECK_IN_WRISTBAND_COLORS: readonly string[];
+export type CheckInStatus = 'expected' | 'checked_in';
+export interface CheckInWristband {
+    number: string | null;
+    color: string | null;
+}
+/**
+ * A rain check on one person's pass: who gave it, when, and the day it was
+ * due before. `open` waits to be claimed on any later day; `date` moved it
+ * to `toDayKey`.
+ */
+export interface CheckInRainCheck {
+    kind: 'open' | 'date';
+    /** The day the pass was due on before this rain check. */
+    fromDayKey: string;
+    /** The day it was moved to; null while open. */
+    toDayKey: string | null;
+    /** The day an open rain check was used, once it is checked in. */
+    claimedDayKey: string | null;
+    byUid: string;
+    byName: string | null;
+    atMs: number;
+}
+/** `hosts/{hostId}/checkIns/{id}`: one person due on one day. Server-written only. */
+export interface HostCheckIn {
+    source: 'order' | 'reservation';
+    orderId: string | null;
+    /** The order's number as the console shows it (`#1042`), or null for a stay. */
+    orderLabel: string | null;
+    /** Where the order was sold, or `reservation`. */
+    channel: OrderChannel | 'reservation';
+    reservationId: string | null;
+    lineIndex: number | null;
+    /** This person's place among the line's or stay's check-ins, from 0. */
+    unitIndex: number;
+    /** How many check-ins the line or stay makes that day. */
+    unitCount: number;
+    productId: string | null;
+    variantId: string | null;
+    itemName: string;
+    variantLabel: string | null;
+    /** The day, `YYYY-MM-DD` in the site's time zone. */
+    dayKey: string;
+    /** Who the check-in is for, as one key: the address, else the contact, else the name, else the order. */
+    customerKey: string;
+    customerName: string | null;
+    customerEmail: string | null;
+    customerEmailLower: string | null;
+    customerPhone: string | null;
+    /** The contact the register attached to the sale, when it was one. */
+    contactId: string | null;
+    /** The name's, the address's, the phone's and the order number's search prefixes. */
+    searchTokens: string[];
+    status: CheckInStatus;
+    checkedInAtMs: number | null;
+    checkedInBy: string | null;
+    checkedInByName: string | null;
+    wristband: CheckInWristband | null;
+    /** The attempt that checked this person in, so a retried tap is not "already checked in". */
+    checkInAttempt: string | null;
+    /** The last undo, kept so a reversed check-in still says who reversed it. */
+    undoneAtMs: number | null;
+    undoneBy: string | null;
+    /**
+     * A rain check on this pass, or null. Absent on a check-in written before
+     * rain checks existed, which reads as null.
+     */
+    rainCheck?: CheckInRainCheck | null;
+    /**
+     * True while an open rain check waits to be used: what a later day's
+     * search and customer lookup ask (`rainCheckOpen == true`, `dayKey <` the
+     * day). Absent reads as false.
+     */
+    rainCheckOpen?: boolean;
+    /** The last rain check taken back: when and by whom. */
+    rainCheckUndoneAtMs?: number | null;
+    rainCheckUndoneBy?: string | null;
+    createdAtMs: number;
+    updatedAtMs: number;
+}
+/** One check-in as the routes answer it. */
+export type CheckInRow = HostCheckIn & {
+    id: string;
+};
+/** A customer with something due on a day, as the search lists them. */
+export interface CheckInCustomer {
+    customerKey: string;
+    name: string | null;
+    email: string | null;
+    phone: string | null;
+    contactId: string | null;
+    /** Every check-in the customer has on the day. */
+    unitsDue: number;
+    unitsCheckedIn: number;
+    /** What the check-ins are for, item names once each. */
+    items: string[];
+}
+export interface CheckInDayTotals {
+    /** Everyone due on the day, less the open rain checks waiting on it. */
+    expected: number;
+    checkedIn: number;
+    /** Passes on the day with an open rain check: not expected until used. */
+    rainChecks: number;
+}

package/src/lib/model/commerce-check-in-record.js

@@ -0,0 +1,36 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /*==========================================
+ * THE CHECK-IN RECORD (AGL-4043): what `/api/commerce/pos-check-in` stores
+ * and answers, in a module with no runtime imports so the native register
+ * reads the same shapes (`tools/scripts/native-contracts.json`). The rules
+ * over them live in `commerce-check-in.ts`, which re-exports all of this.
+ *=========================================*/ export const POS_CHECK_IN_ROUTE = '/api/commerce/pos-check-in';
+/** The most check-ins one tap records. */ export const CHECK_IN_BATCH_MAX = 50;
+/** A wristband's number or color, at most this many characters. */ export const CHECK_IN_WRISTBAND_MAX = 24;
+/** Colors offered as quick picks for a wristband. Any word is accepted. */ export const CHECK_IN_WRISTBAND_COLORS = [
+    'Red',
+    'Orange',
+    'Yellow',
+    'Green',
+    'Blue',
+    'Purple',
+    'Pink',
+    'White',
+    'Black'
+];
+
+//# sourceMappingURL=commerce-check-in-record.js.map

package/src/lib/model/commerce-check-in-record.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/commerce-check-in-record.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\nimport type { OrderChannel } from './commerce-orders'\n\n/*==========================================\n * THE CHECK-IN RECORD (AGL-4043): what `/api/commerce/pos-check-in` stores\n * and answers, in a module with no runtime imports so the native register\n * reads the same shapes (`tools/scripts/native-contracts.json`). The rules\n * over them live in `commerce-check-in.ts`, which re-exports all of this.\n *=========================================*/\n\nexport const POS_CHECK_IN_ROUTE = '/api/commerce/pos-check-in'\n\n/** The most check-ins one tap records. */\nexport const CHECK_IN_BATCH_MAX = 50\n\n/** A wristband's number or color, at most this many characters. */\nexport const CHECK_IN_WRISTBAND_MAX = 24\n\n/** Colors offered as quick picks for a wristband. Any word is accepted. */\nexport const CHECK_IN_WRISTBAND_COLORS: readonly string[] = [\n  'Red',\n  'Orange',\n  'Yellow',\n  'Green',\n  'Blue',\n  'Purple',\n  'Pink',\n  'White',\n  'Black',\n]\n\nexport type CheckInStatus = 'expected' | 'checked_in'\n\nexport interface CheckInWristband {\n  number: string | null\n  color: string | null\n}\n\n/**\n * A rain check on one person's pass: who gave it, when, and the day it was\n * due before. `open` waits to be claimed on any later day; `date` moved it\n * to `toDayKey`.\n */\nexport interface CheckInRainCheck {\n  kind: 'open' | 'date'\n  /** The day the pass was due on before this rain check. */\n  fromDayKey: string\n  /** The day it was moved to; null while open. */\n  toDayKey: string | null\n  /** The day an open rain check was used, once it is checked in. */\n  claimedDayKey: string | null\n  byUid: string\n  byName: string | null\n  atMs: number\n}\n\n/** `hosts/{hostId}/checkIns/{id}`: one person due on one day. Server-written only. */\nexport interface HostCheckIn {\n  source: 'order' | 'reservation'\n  orderId: string | null\n  /** The order's number as the console shows it (`#1042`), or null for a stay. */\n  orderLabel: string | null\n  /** Where the order was sold, or `reservation`. */\n  channel: OrderChannel | 'reservation'\n  reservationId: string | null\n  lineIndex: number | null\n  /** This person's place among the line's or stay's check-ins, from 0. */\n  unitIndex: number\n  /** How many check-ins the line or stay makes that day. */\n  unitCount: number\n  productId: string | null\n  variantId: string | null\n  itemName: string\n  variantLabel: string | null\n  /** The day, `YYYY-MM-DD` in the site's time zone. */\n  dayKey: string\n  /** Who the check-in is for, as one key: the address, else the contact, else the name, else the order. */\n  customerKey: string\n  customerName: string | null\n  customerEmail: string | null\n  customerEmailLower: string | null\n  customerPhone: string | null\n  /** The contact the register attached to the sale, when it was one. */\n  contactId: string | null\n  /** The name's, the address's, the phone's and the order number's search prefixes. */\n  searchTokens: string[]\n  status: CheckInStatus\n  checkedInAtMs: number | null\n  checkedInBy: string | null\n  checkedInByName: string | null\n  wristband: CheckInWristband | null\n  /** The attempt that checked this person in, so a retried tap is not \"already checked in\". */\n  checkInAttempt: string | null\n  /** The last undo, kept so a reversed check-in still says who reversed it. */\n  undoneAtMs: number | null\n  undoneBy: string | null\n  /**\n   * A rain check on this pass, or null. Absent on a check-in written before\n   * rain checks existed, which reads as null.\n   */\n  rainCheck?: CheckInRainCheck | null\n  /**\n   * True while an open rain check waits to be used: what a later day's\n   * search and customer lookup ask (`rainCheckOpen == true`, `dayKey <` the\n   * day). Absent reads as false.\n   */\n  rainCheckOpen?: boolean\n  /** The last rain check taken back: when and by whom. */\n  rainCheckUndoneAtMs?: number | null\n  rainCheckUndoneBy?: string | null\n  createdAtMs: number\n  updatedAtMs: number\n}\n\n/** One check-in as the routes answer it. */\nexport type CheckInRow = HostCheckIn & { id: string }\n\n/** A customer with something due on a day, as the search lists them. */\nexport interface CheckInCustomer {\n  customerKey: string\n  name: string | null\n  email: string | null\n  phone: string | null\n  contactId: string | null\n  /** Every check-in the customer has on the day. */\n  unitsDue: number\n  unitsCheckedIn: number\n  /** What the check-ins are for, item names once each. */\n  items: string[]\n}\n\nexport interface CheckInDayTotals {\n  /** Everyone due on the day, less the open rain checks waiting on it. */\n  expected: number\n  checkedIn: number\n  /** Passes on the day with an open rain check: not expected until used. */\n  rainChecks: number\n}\n"],"names":["POS_CHECK_IN_ROUTE","CHECK_IN_BATCH_MAX","CHECK_IN_WRISTBAND_MAX","CHECK_IN_WRISTBAND_COLORS"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAID;;;;;2CAK2C,GAE3C,OAAO,MAAMA,qBAAqB,6BAA4B;AAE9D,wCAAwC,GACxC,OAAO,MAAMC,qBAAqB,GAAE;AAEpC,iEAAiE,GACjE,OAAO,MAAMC,yBAAyB,GAAE;AAExC,yEAAyE,GACzE,OAAO,MAAMC,4BAA+C;IAC1D;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;CACD,CAAA"}

package/src/lib/model/commerce-check-in.d.ts

@@ -1,8 +1,9 @@
 import type { ProductVariant } from './commerce';
-import { type HostOrder, type OrderChannel } from './commerce-orders';
-import type { HostReservation } from './commerce-reservations';
-export { CHECK_IN_MAX_HEADCOUNT, normalizeProductCheckIn, productCheckInProblem, type ProductCheckIn, } from './commerce-check-in-product';
-export declare const POS_CHECK_IN_ROUTE = "/api/commerce/pos-check-in";
+import { type HostOrder } from './commerce-orders';
+import { type HostReservation } from './commerce-reservations';
+export { CHECK_IN_BATCH_MAX, CHECK_IN_WRISTBAND_COLORS, CHECK_IN_WRISTBAND_MAX, POS_CHECK_IN_ROUTE, type CheckInCustomer, type CheckInDayTotals, type CheckInRainCheck, type CheckInRow, type CheckInStatus, type CheckInWristband, type HostCheckIn, } from './commerce-check-in-record';
+import { type CheckInCustomer, type CheckInDayTotals, type CheckInRow, type CheckInStatus, type CheckInWristband, type HostCheckIn } from './commerce-check-in-record';
+export { addCheckInDays, checkInDayLabel, CHECK_IN_MAX_HEADCOUNT, CHECK_IN_USE_DAY_MAX_AHEAD_DAYS, checkInUseDayProblem, isCheckInDayKey, normalizeProductCheckIn, productCheckInProblem, type ProductCheckIn, } from './commerce-check-in-product';
 /** The most check-ins one order line makes, whatever its quantity. */
 export declare const CHECK_IN_MAX_UNITS_PER_LINE = 200;
 /** The most check-ins, orders or stays one day reads. */
@@ -11,81 +12,10 @@ export declare const CHECK_IN_DAY_CEILING = 3000;
 export declare const CHECK_IN_SEARCH_ROWS = 100;
 /** The most customers one search answers. */
 export declare const CHECK_IN_SEARCH_CUSTOMERS = 20;
-/** The most check-ins one tap records. */
-export declare const CHECK_IN_BATCH_MAX = 50;
-/** A wristband's number or color, at most this many characters. */
-export declare const CHECK_IN_WRISTBAND_MAX = 24;
-/** Colors offered as quick picks for a wristband. Any word is accepted. */
-export declare const CHECK_IN_WRISTBAND_COLORS: readonly ["Red", "Orange", "Yellow", "Green", "Blue", "Purple", "Pink", "White", "Black"];
 /** The order statuses whose check-in lines are due. */
 export declare const CHECK_IN_ORDER_STATUSES: readonly ["paid", "partially_fulfilled", "fulfilled", "delivered"];
 /** The stay statuses whose days are due. */
 export declare const CHECK_IN_RESERVATION_STATUSES: readonly ["confirmed", "checked_in"];
-export type CheckInStatus = 'expected' | 'checked_in';
-export interface CheckInWristband {
-    number: string | null;
-    color: string | null;
-}
-/** `hosts/{hostId}/checkIns/{id}`: one person due on one day. Server-written only. */
-export interface HostCheckIn {
-    source: 'order' | 'reservation';
-    orderId: string | null;
-    /** The order's number as the console shows it (`#1042`), or null for a stay. */
-    orderLabel: string | null;
-    /** Where the order was sold, or `reservation`. */
-    channel: OrderChannel | 'reservation';
-    reservationId: string | null;
-    lineIndex: number | null;
-    /** This person's place among the line's or stay's check-ins, from 0. */
-    unitIndex: number;
-    /** How many check-ins the line or stay makes that day. */
-    unitCount: number;
-    productId: string | null;
-    variantId: string | null;
-    itemName: string;
-    variantLabel: string | null;
-    /** The day, `YYYY-MM-DD` in the site's time zone. */
-    dayKey: string;
-    /** Who the check-in is for, as one key: the address, else the contact, else the name, else the order. */
-    customerKey: string;
-    customerName: string | null;
-    customerEmail: string | null;
-    customerEmailLower: string | null;
-    customerPhone: string | null;
-    /** The contact the register attached to the sale, when it was one. */
-    contactId: string | null;
-    /** The name's, the address's, the phone's and the order number's search prefixes. */
-    searchTokens: string[];
-    status: CheckInStatus;
-    checkedInAtMs: number | null;
-    checkedInBy: string | null;
-    checkedInByName: string | null;
-    wristband: CheckInWristband | null;
-    /** The attempt that checked this person in, so a retried tap is not "already checked in". */
-    checkInAttempt: string | null;
-    /** The last undo, kept so a reversed check-in still says who reversed it. */
-    undoneAtMs: number | null;
-    undoneBy: string | null;
-    createdAtMs: number;
-    updatedAtMs: number;
-}
-/** One check-in as the routes answer it. */
-export type CheckInRow = HostCheckIn & {
-    id: string;
-};
-/** A customer with something due on a day, as the search lists them. */
-export interface CheckInCustomer {
-    customerKey: string;
-    name: string | null;
-    email: string | null;
-    phone: string | null;
-    contactId: string | null;
-    /** Every check-in the customer has on the day. */
-    unitsDue: number;
-    unitsCheckedIn: number;
-    /** What the check-ins are for, item names once each. */
-    items: string[];
-}
 /**
  * Whether one variant of a product needs check-in, and for how many people
  * per item: the variant's own setting, else the product's; `null` when not.
@@ -97,7 +27,10 @@ export declare function productCheckInFor(product: {
     }>;
 } | null | undefined, variantId: string | null | undefined): {
     headcount: number;
+    askUseDate: boolean;
 } | null;
+/** Whether a product's variant asks the buyer which day they will use it. */
+export declare function productAsksUseDate(product: Parameters<typeof productCheckInFor>[0], variantId: string | null | undefined): boolean;
 /** Whether any variant of a product needs check-in. */
 export declare function productNeedsCheckIn(product: Parameters<typeof productCheckInFor>[0]): boolean;
 /** The digits of a phone number, without a leading US/Canada 1 when it has eleven. */
@@ -127,29 +60,86 @@ export declare function orderCheckInId(orderId: string, lineIndex: number, unitI
 export declare function reservationCheckInId(reservationId: string, dayKey: string, unitIndex?: number): string;
 /** A due check-in before the server stamps its times and status. */
 export type DueCheckIn = Omit<HostCheckIn, 'status' | 'checkedInAtMs' | 'checkedInBy' | 'checkedInByName' | 'wristband' | 'checkInAttempt' | 'undoneAtMs' | 'undoneBy' | 'createdAtMs' | 'updatedAtMs'>;
-/** The customer fields a due check-in copies from its source, which a later read may refresh. */
-export declare const CHECK_IN_CUSTOMER_FIELDS: readonly ["customerKey", "customerName", "customerEmail", "customerEmailLower", "customerPhone", "contactId", "searchTokens"];
+/**
+ * The fields a due check-in copies from its source, which a later read may
+ * refresh: the customer's, and how many check-ins its line or stay makes that
+ * day (a stay checked in per guest changes it when its guests or the store's
+ * control change).
+ */
+export declare const CHECK_IN_CUSTOMER_FIELDS: readonly ["unitCount", "customerKey", "customerName", "customerEmail", "customerEmailLower", "customerPhone", "contactId", "searchTokens"];
 /** Whether an order's lines are due at all. */
 export declare function orderIsDueForCheckIn(order: Pick<HostOrder, 'status'> | null | undefined): boolean;
 /**
- * The check-ins an order makes on its day, keyed by document id. `products`
- * holds the products its lines name, as stored now: the setting is read at
- * the window, so turning it on covers passes already sold today.
+ * Every check-in an order makes, keyed by document id, each on its own day:
+ * the day the buyer chose for its line (`useDayKey`), else `purchaseDayKey`,
+ * the day the order was placed on the site's calendar. A caller working one
+ * day keeps the entries whose `dayKey` is that day; the rest are still owed,
+ * on theirs. `products` holds the products its lines name, as stored now:
+ * the setting is read at the window, so turning it on covers passes already
+ * sold today.
  */
 export declare function dueCheckInsForOrder(input: {
     orderId: string;
     order: Partial<HostOrder>;
     products: ReadonlyMap<string, Parameters<typeof productCheckInFor>[0]>;
-    dayKey: string;
+    purchaseDayKey: string;
 }): Map<string, DueCheckIn>;
 /** UTC midnight of a `YYYY-MM-DD` day, as a stay's days are stored. */
 export declare function checkInDayMs(dayKey: string): number | null;
-/** The check-in a stay makes on a day it covers; empty on any other day. */
+/** Where the store's stay check-in control lives (AGL-4043): `hosts/{hostId}/settings/checkIn.stays`. */
+export declare const STAY_CHECK_IN_SETTINGS_DOC = "checkIn";
+/** One stay's stored check-in on one day, as far as how many it needs goes. */
+export interface StayCheckInSlot {
+    id: string;
+    status: CheckInStatus;
+    unitIndex: number;
+}
+/**
+ * Which check-ins one stay keeps on one day when it needs `unitCount` of
+ * them (AGL-4043): when staff change a stay's guests, or the store switches
+ * between one check-in per stay and one per guest.
+ *
+ * A guest already checked in is never dropped, whatever their place: staff
+ * check a family in in any order, so the third guest may be in while the
+ * first is still on the way. The waiting ones fill what is left, lowest place
+ * first, and the rest are dropped; new places are the lowest free ones.
+ * `checkedIn` above `unitCount` is a count that cannot be honored without
+ * taking back a check-in: the guests route refuses it, and a reconcile keeps
+ * every checked-in guest and drops every waiting one.
+ */
+export declare function stayCheckInPlan(input: {
+    unitCount: number;
+    existing: ReadonlyArray<StayCheckInSlot>;
+}): {
+    /** Every place the stay is due under that day: the checked-in, the waiting kept, the new. */
+    unitIndexes: number[];
+    /** New places to write. */
+    create: number[];
+    /** Waiting check-ins it no longer needs. */
+    drop: string[];
+    /** How many of its guests are checked in that day. */
+    checkedIn: number;
+};
+/** Stored check-ins of stays grouped by stay, as {@link stayCheckInPlan} reads them. */
+export declare function storedStayCheckIns(docs: ReadonlyArray<{
+    id: string;
+    get(field: string): unknown;
+}>): Map<string, StayCheckInSlot[]>;
+/**
+ * The check-ins a stay makes on a day it covers; empty on any other day. One
+ * per stay, or with `perGuest` one per guest (`guests`, at least one), each
+ * with its own wristband: the resource's setting under the store's control
+ * (`stayChecksInPerGuest`). Given the stay's check-ins already stored that
+ * day (`existing`), its places follow {@link stayCheckInPlan}, so a guest
+ * checked in is kept and a waiting one beyond the count is not due.
+ */
 export declare function dueCheckInsForReservation(input: {
     reservationId: string;
     reservation: Partial<HostReservation>;
     resourceName: string | null;
     dayKey: string;
+    perGuest?: boolean;
+    existing?: ReadonlyArray<StayCheckInSlot>;
 }): Map<string, DueCheckIn>;
 /** A due check-in as first written. */
 export declare function newCheckInDocument(due: DueCheckIn, nowMs: number): HostCheckIn;
@@ -172,11 +162,25 @@ export declare function describeWristband(wristband: CheckInWristband | null | u
 export declare function checkInCustomers(rows: ReadonlyArray<CheckInRow>): CheckInCustomer[];
 /** A day's check-ins in the order the window reads them: by name, then item, then unit. */
 export declare function sortCheckInRows<T extends Pick<CheckInRow, 'customerName' | 'customerEmail' | 'itemName' | 'unitIndex' | 'id'>>(rows: ReadonlyArray<T>): T[];
-export interface CheckInDayTotals {
-    expected: number;
-    checkedIn: number;
-}
-export declare function checkInDayTotals(rows: ReadonlyArray<Pick<CheckInRow, 'status'>>): CheckInDayTotals;
+/** Whether a check-in waits on an open rain check (not yet used). */
+export declare function checkInRainCheckIsOpen(row: Pick<HostCheckIn, 'status' | 'rainCheckOpen'>): boolean;
+export declare function checkInDayTotals(rows: ReadonlyArray<Pick<CheckInRow, 'status' | 'rainCheckOpen'>>): CheckInDayTotals;
+/**
+ * Why a pass cannot be rain-checked as asked, or null. Only a pass bought as
+ * an order line (a stay's dates change on the Reservations card), only while
+ * nobody has used it, and a dated one only to a day after the one it is on
+ * that has not passed (`todayKey` on the store's calendar).
+ */
+export declare function rainCheckProblem(row: Pick<HostCheckIn, 'source' | 'status' | 'dayKey'>, ask: {
+    kind: 'open' | 'date';
+    dayKey?: string | null;
+}, todayKey: string): string | null;
+/** What the window says about a pass's rain check: "Rain check from Sat, Oct 25". */
+export declare function rainCheckLabel(row: Pick<HostCheckIn, 'rainCheck' | 'rainCheckOpen' | 'status'>): string;
+/** The check-in's status in words: "Checked in", "Expected" or "Rain check". */
+export declare function checkInStatusLabel(row: Pick<HostCheckIn, 'status' | 'rainCheckOpen'>): string;
+/** The day after `dayKey`: the first day an open rain check is good on. */
+export declare function checkInNextDay(dayKey: string): string;
 /** A time on the site's clock: "9:14 AM". */
 export declare function checkInTimeLabel(ms: number | null | undefined, timeZone: string): string;
 /** "Already checked in at 9:14 AM by Sam". */