@aglyn/plugins-bookings 1.0.0-beta.230 → 1.0.0-beta.232

package/src/lib/model/booking-events.js

@@ -0,0 +1,53 @@
+/**
+ * @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 { definePluginDomainEvent } from "@aglyn/aglyn/plugin-manager/plugin-domain-events";
+export const BOOKING_CREATED_EVENT = definePluginDomainEvent('booking.created');
+export const BOOKING_RESCHEDULED_EVENT = definePluginDomainEvent('booking.rescheduled');
+export const BOOKING_CANCELED_EVENT = definePluginDomainEvent('booking.canceled');
+export const BOOKING_EVENT_DECLARATIONS = [
+    {
+        event: BOOKING_CREATED_EVENT,
+        label: 'Booking confirmed',
+        description: 'A booking was confirmed: a free one when it was made, a paid one when its payment landed.',
+        payloadKeys: [
+            'booking'
+        ]
+    },
+    {
+        event: BOOKING_RESCHEDULED_EVENT,
+        label: 'Booking rescheduled',
+        description: 'The site’s team moved a booking to another time, once per move.',
+        payloadKeys: [
+            'booking'
+        ]
+    },
+    {
+        event: BOOKING_CANCELED_EVENT,
+        label: 'Booking canceled',
+        description: 'A booking was canceled: a free one by the site’s team, a paid one by a full refund.',
+        payloadKeys: [
+            'booking'
+        ]
+    }
+];
+/**
+ * The key naming one occurrence, so the same fact raised twice is one event:
+ * a booking is confirmed once, canceled once, and moved once to each time.
+ */ export function bookingEventKey(event, bookingId, startsAtMs) {
+    return event === 'booking.rescheduled' ? `${bookingId}@${Number(startsAtMs != null ? startsAtMs : 0)}` : bookingId;
+}
+
+//# sourceMappingURL=booking-events.js.map

package/src/lib/model/booking-events.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/bookings/src/lib/model/booking-events.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 {\n  definePluginDomainEvent,\n  type PluginDomainEvent,\n  type PluginDomainEventDeclaration,\n} from '@aglyn/aglyn/plugin-manager/plugin-domain-events'\nimport type { BookingView } from './booking-view'\n\n/**\n * The booking events the bookings plugin raises (AGL-3643), for other\n * plugins — the merchant's Zapier connections first — through core's\n * domain-event outbox: written when the fact is, delivered at least once,\n * retried with backoff. A subscriber names the event and never imports this\n * plugin.\n *\n * Each payload is `{ booking }` in the public API's shape\n * (`GET /v1/sites/{siteId}/bookings/{bookingId}`), as it stood once the fact\n * was written.\n *\n * - `booking.created`: a booking is confirmed — a free one when it is made,\n *   a paid one when its payment lands. A checkout the guest never finished\n *   raises nothing.\n * - `booking.rescheduled`: the site's team moved it to another time; one\n *   event per move.\n * - `booking.canceled`: it was canceled — a free one by the site's team, a\n *   paid one by the refund that gave all of the money back.\n */\nexport interface BookingEventPayload {\n  booking: BookingView\n}\n\nexport const BOOKING_CREATED_EVENT = definePluginDomainEvent<BookingEventPayload>('booking.created')\nexport const BOOKING_RESCHEDULED_EVENT = definePluginDomainEvent<BookingEventPayload>('booking.rescheduled')\nexport const BOOKING_CANCELED_EVENT = definePluginDomainEvent<BookingEventPayload>('booking.canceled')\n\nexport type BookingEventName = 'booking.created' | 'booking.rescheduled' | 'booking.canceled'\n\nexport const BOOKING_EVENT_DECLARATIONS: ReadonlyArray<PluginDomainEventDeclaration & { event: PluginDomainEvent<unknown> }> = [\n  {\n    event: BOOKING_CREATED_EVENT,\n    label: 'Booking confirmed',\n    description: 'A booking was confirmed: a free one when it was made, a paid one when its payment landed.',\n    payloadKeys: ['booking'],\n  },\n  {\n    event: BOOKING_RESCHEDULED_EVENT,\n    label: 'Booking rescheduled',\n    description: 'The site’s team moved a booking to another time, once per move.',\n    payloadKeys: ['booking'],\n  },\n  {\n    event: BOOKING_CANCELED_EVENT,\n    label: 'Booking canceled',\n    description: 'A booking was canceled: a free one by the site’s team, a paid one by a full refund.',\n    payloadKeys: ['booking'],\n  },\n]\n\n/**\n * The key naming one occurrence, so the same fact raised twice is one event:\n * a booking is confirmed once, canceled once, and moved once to each time.\n */\nexport function bookingEventKey(event: BookingEventName, bookingId: string, startsAtMs?: number): string {\n  return event === 'booking.rescheduled' ? `${bookingId}@${Number(startsAtMs ?? 0)}` : bookingId\n}\n"],"names":["definePluginDomainEvent","BOOKING_CREATED_EVENT","BOOKING_RESCHEDULED_EVENT","BOOKING_CANCELED_EVENT","BOOKING_EVENT_DECLARATIONS","event","label","description","payloadKeys","bookingEventKey","bookingId","startsAtMs","Number"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SACEA,uBAAuB,QAGlB,mDAAkD;AA0BzD,OAAO,MAAMC,wBAAwBD,wBAA6C,mBAAkB;AACpG,OAAO,MAAME,4BAA4BF,wBAA6C,uBAAsB;AAC5G,OAAO,MAAMG,yBAAyBH,wBAA6C,oBAAmB;AAItG,OAAO,MAAMI,6BAAkH;IAC7H;QACEC,OAAOJ;QACPK,OAAO;QACPC,aAAa;QACbC,aAAa;YAAC;SAAU;IAC1B;IACA;QACEH,OAAOH;QACPI,OAAO;QACPC,aAAa;QACbC,aAAa;YAAC;SAAU;IAC1B;IACA;QACEH,OAAOF;QACPG,OAAO;QACPC,aAAa;QACbC,aAAa;YAAC;SAAU;IAC1B;CACD,CAAA;AAED;;;CAGC,GACD,OAAO,SAASC,gBAAgBJ,KAAuB,EAAEK,SAAiB,EAAEC,UAAmB;IAC7F,OAAON,UAAU,wBAAwB,GAAGK,UAAU,CAAC,EAAEE,OAAOD,qBAAAA,aAAc,IAAI,GAAGD;AACvF"}

package/src/lib/model/booking-in-person.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @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 in-person payment a booking carries while it is being taken. */
+export interface BookingInPersonPayment {
+    paymentIntentId: string;
+    /** The whole charge: service plus tax. */
+    amountCents: number;
+    /** The service amount staff typed, before tax. */
+    serviceCents: number;
+    taxCents: number;
+    feeCents: number;
+    status: 'pending' | 'paid' | 'canceled';
+    startedAtMs: number;
+    startedBy: string;
+    paidAtMs?: number;
+    /** Which start request made it, so a retried start returns it again. */
+    attempt?: string;
+}
+/** The fields of a booking this reads; any booking document has them. */
+export interface BookingPaymentFields {
+    status?: string;
+    expiresAtMs?: number;
+    paidAmountCents?: number;
+    refundedCents?: number;
+    paymentIntentId?: string;
+    inPersonPayment?: Partial<BookingInPersonPayment> | null;
+}
+export type BookingInPersonState = 
+/** Paid already, online or in person. */
+'paid'
+/** Canceled: nothing to pay. */
+ | 'canceled'
+/** Still holding for its online Checkout: the customer is paying there. */
+ | 'awaiting-online'
+/** A card is being taken for it now. */
+ | 'collecting'
+/** Can be paid at the counter. */
+ | 'payable';
+export declare function bookingInPersonState(booking: BookingPaymentFields, nowMs?: number): BookingInPersonState;
+/** The most one in-person booking charge may be: $10,000. */
+export declare const BOOKING_IN_PERSON_MAX_CENTS = 1000000;
+/** Stripe's card minimum in USD. */
+export declare const BOOKING_IN_PERSON_MIN_CENTS = 50;
+/** Null when `serviceCents` is an amount staff may charge; otherwise why not. */
+export declare function bookingInPersonAmountProblem(serviceCents: unknown): string | null;
+/**
+ * The amount to suggest: the service's fixed price, when it has one. A
+ * `varies`, `estimate` or `contact` price suggests nothing; staff type it.
+ */
+export declare function bookingSuggestedCents(service: {
+    priceUsd?: number;
+    priceDisplay?: string;
+} | null | undefined): number | null;
+/** The start and end of the local day that holds `atMs`, in milliseconds. */
+export declare function bookingDayRange(atMs: number, offsetMinutes?: number): {
+    startMs: number;
+    endMs: number;
+};

package/src/lib/model/booking-in-person.js

@@ -0,0 +1,71 @@
+/**
+ * @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.
+ */ /*==========================================
+ * TAKING PAYMENT FOR A BOOKING IN PERSON (AGL-3618).
+ *
+ * A booking whose price was not charged online (a free booking, or one whose
+ * price `varies`, is an `estimate` or is `contact`) is paid at the counter
+ * once the work is done: staff type the amount and the customer taps or
+ * inserts a card on the register's reader. Pure: the server route, the
+ * console and the native Aglyn POS app all read a booking through these.
+ *
+ * Imports nothing, so client and server code alike may import it.
+ *=========================================*/ /** The in-person payment a booking carries while it is being taken. */ export function bookingInPersonState(booking, nowMs = Date.now()) {
+    var _booking_paidAmountCents;
+    var _booking_inPersonPayment, _booking_inPersonPayment1;
+    if (Math.round(Number((_booking_paidAmountCents = booking.paidAmountCents) != null ? _booking_paidAmountCents : 0)) > 0 || Boolean(booking.paymentIntentId) || ((_booking_inPersonPayment = booking.inPersonPayment) == null ? void 0 : _booking_inPersonPayment.status) === 'paid') {
+        return 'paid';
+    }
+    if (booking.status === 'canceled') return 'canceled';
+    if (booking.status === 'pendingPayment') {
+        var _booking_expiresAtMs;
+        // A lapsed online hold released its slot; it is not an appointment.
+        return Number((_booking_expiresAtMs = booking.expiresAtMs) != null ? _booking_expiresAtMs : 0) < nowMs ? 'canceled' : 'awaiting-online';
+    }
+    if (((_booking_inPersonPayment1 = booking.inPersonPayment) == null ? void 0 : _booking_inPersonPayment1.status) === 'pending') return 'collecting';
+    return 'payable';
+}
+/** The most one in-person booking charge may be: $10,000. */ export const BOOKING_IN_PERSON_MAX_CENTS = 1000000;
+/** Stripe's card minimum in USD. */ export const BOOKING_IN_PERSON_MIN_CENTS = 50;
+/** Null when `serviceCents` is an amount staff may charge; otherwise why not. */ export function bookingInPersonAmountProblem(serviceCents) {
+    if (typeof serviceCents !== 'number' || !Number.isInteger(serviceCents)) {
+        return 'Enter the amount to charge.';
+    }
+    if (serviceCents < BOOKING_IN_PERSON_MIN_CENTS) return 'Card payments start at $0.50.';
+    if (serviceCents > BOOKING_IN_PERSON_MAX_CENTS) return 'Charge at most $10,000 at a time.';
+    return null;
+}
+/**
+ * The amount to suggest: the service's fixed price, when it has one. A
+ * `varies`, `estimate` or `contact` price suggests nothing; staff type it.
+ */ export function bookingSuggestedCents(service) {
+    var _service_priceUsd;
+    if (!service) return null;
+    if (service.priceDisplay && service.priceDisplay !== 'fixed') return null;
+    const cents = Math.round(Number((_service_priceUsd = service.priceUsd) != null ? _service_priceUsd : 0) * 100);
+    return Number.isFinite(cents) && cents >= BOOKING_IN_PERSON_MIN_CENTS ? cents : null;
+}
+/** The start and end of the local day that holds `atMs`, in milliseconds. */ export function bookingDayRange(atMs, offsetMinutes = new Date(atMs).getTimezoneOffset()) {
+    const local = atMs - offsetMinutes * 60000;
+    const dayStart = Math.floor(local / 86400000) * 86400000;
+    const startMs = dayStart + offsetMinutes * 60000;
+    return {
+        startMs,
+        endMs: startMs + 86400000
+    };
+}
+
+//# sourceMappingURL=booking-in-person.js.map

package/src/lib/model/booking-in-person.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/bookings/src/lib/model/booking-in-person.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 * TAKING PAYMENT FOR A BOOKING IN PERSON (AGL-3618).\n *\n * A booking whose price was not charged online (a free booking, or one whose\n * price `varies`, is an `estimate` or is `contact`) is paid at the counter\n * once the work is done: staff type the amount and the customer taps or\n * inserts a card on the register's reader. Pure: the server route, the\n * console and the native Aglyn POS app all read a booking through these.\n *\n * Imports nothing, so client and server code alike may import it.\n *=========================================*/\n\n/** The in-person payment a booking carries while it is being taken. */\nexport interface BookingInPersonPayment {\n  paymentIntentId: string\n  /** The whole charge: service plus tax. */\n  amountCents: number\n  /** The service amount staff typed, before tax. */\n  serviceCents: number\n  taxCents: number\n  feeCents: number\n  status: 'pending' | 'paid' | 'canceled'\n  startedAtMs: number\n  startedBy: string\n  paidAtMs?: number\n  /** Which start request made it, so a retried start returns it again. */\n  attempt?: string\n}\n\n/** The fields of a booking this reads; any booking document has them. */\nexport interface BookingPaymentFields {\n  status?: string\n  expiresAtMs?: number\n  paidAmountCents?: number\n  refundedCents?: number\n  paymentIntentId?: string\n  inPersonPayment?: Partial<BookingInPersonPayment> | null\n}\n\nexport type BookingInPersonState =\n  /** Paid already, online or in person. */\n  | 'paid'\n  /** Canceled: nothing to pay. */\n  | 'canceled'\n  /** Still holding for its online Checkout: the customer is paying there. */\n  | 'awaiting-online'\n  /** A card is being taken for it now. */\n  | 'collecting'\n  /** Can be paid at the counter. */\n  | 'payable'\n\nexport function bookingInPersonState(\n  booking: BookingPaymentFields,\n  nowMs = Date.now(),\n): BookingInPersonState {\n  if (\n    Math.round(Number(booking.paidAmountCents ?? 0)) > 0 ||\n    Boolean(booking.paymentIntentId) ||\n    booking.inPersonPayment?.status === 'paid'\n  ) {\n    return 'paid'\n  }\n  if (booking.status === 'canceled') return 'canceled'\n  if (booking.status === 'pendingPayment') {\n    // A lapsed online hold released its slot; it is not an appointment.\n    return Number(booking.expiresAtMs ?? 0) < nowMs ? 'canceled' : 'awaiting-online'\n  }\n  if (booking.inPersonPayment?.status === 'pending') return 'collecting'\n  return 'payable'\n}\n\n/** The most one in-person booking charge may be: $10,000. */\nexport const BOOKING_IN_PERSON_MAX_CENTS = 1_000_000\n/** Stripe's card minimum in USD. */\nexport const BOOKING_IN_PERSON_MIN_CENTS = 50\n\n/** Null when `serviceCents` is an amount staff may charge; otherwise why not. */\nexport function bookingInPersonAmountProblem(serviceCents: unknown): string | null {\n  if (typeof serviceCents !== 'number' || !Number.isInteger(serviceCents)) {\n    return 'Enter the amount to charge.'\n  }\n  if (serviceCents < BOOKING_IN_PERSON_MIN_CENTS) return 'Card payments start at $0.50.'\n  if (serviceCents > BOOKING_IN_PERSON_MAX_CENTS) return 'Charge at most $10,000 at a time.'\n  return null\n}\n\n/**\n * The amount to suggest: the service's fixed price, when it has one. A\n * `varies`, `estimate` or `contact` price suggests nothing; staff type it.\n */\nexport function bookingSuggestedCents(service: {\n  priceUsd?: number\n  priceDisplay?: string\n} | null | undefined): number | null {\n  if (!service) return null\n  if (service.priceDisplay && service.priceDisplay !== 'fixed') return null\n  const cents = Math.round(Number(service.priceUsd ?? 0) * 100)\n  return Number.isFinite(cents) && cents >= BOOKING_IN_PERSON_MIN_CENTS ? cents : null\n}\n\n/** The start and end of the local day that holds `atMs`, in milliseconds. */\nexport function bookingDayRange(atMs: number, offsetMinutes = new Date(atMs).getTimezoneOffset()): {\n  startMs: number\n  endMs: number\n} {\n  const local = atMs - offsetMinutes * 60_000\n  const dayStart = Math.floor(local / 86_400_000) * 86_400_000\n  const startMs = dayStart + offsetMinutes * 60_000\n  return { startMs, endMs: startMs + 86_400_000 }\n}\n"],"names":["bookingInPersonState","booking","nowMs","Date","now","Math","round","Number","paidAmountCents","Boolean","paymentIntentId","inPersonPayment","status","expiresAtMs","BOOKING_IN_PERSON_MAX_CENTS","BOOKING_IN_PERSON_MIN_CENTS","bookingInPersonAmountProblem","serviceCents","isInteger","bookingSuggestedCents","service","priceDisplay","cents","priceUsd","isFinite","bookingDayRange","atMs","offsetMinutes","getTimezoneOffset","local","dayStart","floor","startMs","endMs"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;2CAU2C,GAE3C,qEAAqE,GAuCrE,OAAO,SAASA,qBACdC,OAA6B,EAC7BC,QAAQC,KAAKC,GAAG,EAAE;QAGEH;QAElBA,0BASEA;IAZJ,IACEI,KAAKC,KAAK,CAACC,QAAON,2BAAAA,QAAQO,eAAe,YAAvBP,2BAA2B,MAAM,KACnDQ,QAAQR,QAAQS,eAAe,KAC/BT,EAAAA,2BAAAA,QAAQU,eAAe,qBAAvBV,yBAAyBW,MAAM,MAAK,QACpC;QACA,OAAO;IACT;IACA,IAAIX,QAAQW,MAAM,KAAK,YAAY,OAAO;IAC1C,IAAIX,QAAQW,MAAM,KAAK,kBAAkB;YAEzBX;QADd,oEAAoE;QACpE,OAAOM,QAAON,uBAAAA,QAAQY,WAAW,YAAnBZ,uBAAuB,KAAKC,QAAQ,aAAa;IACjE;IACA,IAAID,EAAAA,4BAAAA,QAAQU,eAAe,qBAAvBV,0BAAyBW,MAAM,MAAK,WAAW,OAAO;IAC1D,OAAO;AACT;AAEA,2DAA2D,GAC3D,OAAO,MAAME,8BAA8B,QAAS;AACpD,kCAAkC,GAClC,OAAO,MAAMC,8BAA8B,GAAE;AAE7C,+EAA+E,GAC/E,OAAO,SAASC,6BAA6BC,YAAqB;IAChE,IAAI,OAAOA,iBAAiB,YAAY,CAACV,OAAOW,SAAS,CAACD,eAAe;QACvE,OAAO;IACT;IACA,IAAIA,eAAeF,6BAA6B,OAAO;IACvD,IAAIE,eAAeH,6BAA6B,OAAO;IACvD,OAAO;AACT;AAEA;;;CAGC,GACD,OAAO,SAASK,sBAAsBC,OAGlB;QAGcA;IAFhC,IAAI,CAACA,SAAS,OAAO;IACrB,IAAIA,QAAQC,YAAY,IAAID,QAAQC,YAAY,KAAK,SAAS,OAAO;IACrE,MAAMC,QAAQjB,KAAKC,KAAK,CAACC,QAAOa,oBAAAA,QAAQG,QAAQ,YAAhBH,oBAAoB,KAAK;IACzD,OAAOb,OAAOiB,QAAQ,CAACF,UAAUA,SAASP,8BAA8BO,QAAQ;AAClF;AAEA,2EAA2E,GAC3E,OAAO,SAASG,gBAAgBC,IAAY,EAAEC,gBAAgB,IAAIxB,KAAKuB,MAAME,iBAAiB,EAAE;IAI9F,MAAMC,QAAQH,OAAOC,gBAAgB;IACrC,MAAMG,WAAWzB,KAAK0B,KAAK,CAACF,QAAQ,YAAc;IAClD,MAAMG,UAAUF,WAAWH,gBAAgB;IAC3C,OAAO;QAAEK;QAASC,OAAOD,UAAU;IAAW;AAChD"}

package/src/lib/model/booking-manage.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @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.
+ */
+/**
+ * What a site's team may do to a booking once it exists (AGL-3621): check
+ * the guest in, move it, cancel it. One pure rule set, read by the routes
+ * that do it (`bookings/check-in`, `bookings/reschedule`) under their own
+ * transaction, and the rules a client mirrors to decide what to OFFER (the
+ * native Aglyn app's bookings screens port them, cased by this file's spec),
+ * so a screen can only offer what the route would then do.
+ *
+ * No I/O and no React, so client and server code alike may import it.
+ */
+/** `hosts/{hostId}/bookings/{id}`, the fields these rules read. */
+export interface ManagedBooking {
+    status?: string;
+    startsAtMs?: number;
+    endsAtMs?: number;
+    expiresAtMs?: number;
+    paidAmountCents?: number;
+    refundedCents?: number;
+    checkedInAtMs?: number;
+}
+export type BookingState = 'confirmed' | 'pendingPayment' | 'expired' | 'canceled';
+/**
+ * The booking's state as a reader should treat it. A payment hold whose
+ * fifteen minutes ran out released its slot (AGL-170) even while the
+ * document still says `pendingPayment`.
+ */
+export declare function bookingState(booking: ManagedBooking, nowMs: number): BookingState;
+export declare const BOOKING_STATE_LABELS: Readonly<Record<BookingState, string>>;
+/** The paid amount not yet refunded, in cents. */
+export declare function bookingOutstandingCents(booking: ManagedBooking): number;
+export interface BookingActions {
+    checkIn: boolean;
+    undoCheckIn: boolean;
+    reschedule: boolean;
+    /** Cancel; with `refundCents` above zero the cancel goes through the refund route. */
+    cancel: boolean;
+    refundCents: number;
+}
+/**
+ * What may be done to a booking now. A guest is checked in only on a
+ * confirmed booking; a booking moves only while it is confirmed and has not
+ * ended; and nothing is done to a canceled one.
+ */
+export declare function bookingActions(booking: ManagedBooking, nowMs: number): BookingActions;
+/** Why a check-in (or its undo) cannot be written, or null. The route's own refusal. */
+export declare function checkInRefusal(booking: ManagedBooking, checkedIn: boolean, nowMs: number): string | null;
+/** Why a booking cannot move to `startsAtMs`, or null. The slot itself is checked apart. */
+export declare function rescheduleRefusal(booking: ManagedBooking, startsAtMs: number, nowMs: number): string | null;
+/**
+ * Why a booking cannot be canceled by the cancel route, or null (AGL-3643).
+ * A canceled booking is not refused: canceling it again changes nothing. A
+ * booking with money still paid on it cancels through the refund instead, so
+ * a guest is never left canceled and charged.
+ */
+export declare function cancelRefusal(booking: ManagedBooking, nowMs: number): string | null;
+/** The booking's length, kept when it moves: what the guest booked, not what the service says today. */
+export declare function bookingDurationMs(booking: ManagedBooking, fallbackMinutes: number): number;

package/src/lib/model/booking-manage.js

@@ -0,0 +1,104 @@
+/**
+ * @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.
+ */ /**
+ * What a site's team may do to a booking once it exists (AGL-3621): check
+ * the guest in, move it, cancel it. One pure rule set, read by the routes
+ * that do it (`bookings/check-in`, `bookings/reschedule`) under their own
+ * transaction, and the rules a client mirrors to decide what to OFFER (the
+ * native Aglyn app's bookings screens port them, cased by this file's spec),
+ * so a screen can only offer what the route would then do.
+ *
+ * No I/O and no React, so client and server code alike may import it.
+ */ /** `hosts/{hostId}/bookings/{id}`, the fields these rules read. */ /**
+ * The booking's state as a reader should treat it. A payment hold whose
+ * fifteen minutes ran out released its slot (AGL-170) even while the
+ * document still says `pendingPayment`.
+ */ export function bookingState(booking, nowMs) {
+    if (booking.status === 'canceled') return 'canceled';
+    if (booking.status === 'pendingPayment') {
+        var _booking_expiresAtMs;
+        return Number((_booking_expiresAtMs = booking.expiresAtMs) != null ? _booking_expiresAtMs : 0) < nowMs ? 'expired' : 'pendingPayment';
+    }
+    return 'confirmed';
+}
+export const BOOKING_STATE_LABELS = {
+    confirmed: 'Confirmed',
+    pendingPayment: 'Awaiting payment',
+    expired: 'Payment not finished',
+    canceled: 'Canceled'
+};
+/** The paid amount not yet refunded, in cents. */ export function bookingOutstandingCents(booking) {
+    var _booking_paidAmountCents, _booking_refundedCents;
+    const paid = Math.max(0, Math.round(Number((_booking_paidAmountCents = booking.paidAmountCents) != null ? _booking_paidAmountCents : 0)));
+    const refunded = Math.max(0, Math.round(Number((_booking_refundedCents = booking.refundedCents) != null ? _booking_refundedCents : 0)));
+    return Math.max(0, paid - refunded);
+}
+/**
+ * What may be done to a booking now. A guest is checked in only on a
+ * confirmed booking; a booking moves only while it is confirmed and has not
+ * ended; and nothing is done to a canceled one.
+ */ export function bookingActions(booking, nowMs) {
+    var _booking_checkedInAtMs, _booking_endsAtMs;
+    const state = bookingState(booking, nowMs);
+    const confirmed = state === 'confirmed';
+    const checkedIn = Number((_booking_checkedInAtMs = booking.checkedInAtMs) != null ? _booking_checkedInAtMs : 0) > 0;
+    const ended = Number((_booking_endsAtMs = booking.endsAtMs) != null ? _booking_endsAtMs : 0) <= nowMs;
+    return {
+        checkIn: confirmed && !checkedIn,
+        undoCheckIn: confirmed && checkedIn,
+        reschedule: confirmed && !checkedIn && !ended,
+        cancel: state !== 'canceled' && !checkedIn,
+        refundCents: bookingOutstandingCents(booking)
+    };
+}
+/** Why a check-in (or its undo) cannot be written, or null. The route's own refusal. */ export function checkInRefusal(booking, checkedIn, nowMs) {
+    var _booking_checkedInAtMs;
+    const state = bookingState(booking, nowMs);
+    if (state === 'canceled') return 'This booking was canceled';
+    if (state !== 'confirmed') return 'This booking is not paid yet';
+    return checkedIn || Number((_booking_checkedInAtMs = booking.checkedInAtMs) != null ? _booking_checkedInAtMs : 0) > 0 ? null : 'This guest is not checked in';
+}
+/** Why a booking cannot move to `startsAtMs`, or null. The slot itself is checked apart. */ export function rescheduleRefusal(booking, startsAtMs, nowMs) {
+    var _booking_checkedInAtMs, _booking_endsAtMs;
+    const state = bookingState(booking, nowMs);
+    if (state === 'canceled') return 'This booking was canceled';
+    if (state !== 'confirmed') return 'This booking is not paid yet';
+    if (Number((_booking_checkedInAtMs = booking.checkedInAtMs) != null ? _booking_checkedInAtMs : 0) > 0) return 'This guest is already checked in';
+    if (Number((_booking_endsAtMs = booking.endsAtMs) != null ? _booking_endsAtMs : 0) <= nowMs) return 'This booking has already ended';
+    if (!Number.isFinite(startsAtMs) || startsAtMs <= nowMs) return 'Pick a time that has not passed';
+    return null;
+}
+/**
+ * Why a booking cannot be canceled by the cancel route, or null (AGL-3643).
+ * A canceled booking is not refused: canceling it again changes nothing. A
+ * booking with money still paid on it cancels through the refund instead, so
+ * a guest is never left canceled and charged.
+ */ export function cancelRefusal(booking, nowMs) {
+    var _booking_checkedInAtMs;
+    if (bookingState(booking, nowMs) === 'canceled') return null;
+    if (Number((_booking_checkedInAtMs = booking.checkedInAtMs) != null ? _booking_checkedInAtMs : 0) > 0) return 'This guest is already checked in';
+    if (bookingOutstandingCents(booking) > 0) {
+        return 'This booking was paid. Cancel it with a refund so the guest gets their money back';
+    }
+    return null;
+}
+/** The booking's length, kept when it moves: what the guest booked, not what the service says today. */ export function bookingDurationMs(booking, fallbackMinutes) {
+    var _booking_endsAtMs, _booking_startsAtMs;
+    const stored = Number((_booking_endsAtMs = booking.endsAtMs) != null ? _booking_endsAtMs : 0) - Number((_booking_startsAtMs = booking.startsAtMs) != null ? _booking_startsAtMs : 0);
+    return stored > 0 ? stored : Math.max(5, Math.round(fallbackMinutes || 30)) * 60000;
+}
+
+//# sourceMappingURL=booking-manage.js.map

package/src/lib/model/booking-manage.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/bookings/src/lib/model/booking-manage.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 * What a site's team may do to a booking once it exists (AGL-3621): check\n * the guest in, move it, cancel it. One pure rule set, read by the routes\n * that do it (`bookings/check-in`, `bookings/reschedule`) under their own\n * transaction, and the rules a client mirrors to decide what to OFFER (the\n * native Aglyn app's bookings screens port them, cased by this file's spec),\n * so a screen can only offer what the route would then do.\n *\n * No I/O and no React, so client and server code alike may import it.\n */\n\n/** `hosts/{hostId}/bookings/{id}`, the fields these rules read. */\nexport interface ManagedBooking {\n  status?: string\n  startsAtMs?: number\n  endsAtMs?: number\n  expiresAtMs?: number\n  paidAmountCents?: number\n  refundedCents?: number\n  checkedInAtMs?: number\n}\n\nexport type BookingState = 'confirmed' | 'pendingPayment' | 'expired' | 'canceled'\n\n/**\n * The booking's state as a reader should treat it. A payment hold whose\n * fifteen minutes ran out released its slot (AGL-170) even while the\n * document still says `pendingPayment`.\n */\nexport function bookingState(booking: ManagedBooking, nowMs: number): BookingState {\n  if (booking.status === 'canceled') return 'canceled'\n  if (booking.status === 'pendingPayment') {\n    return Number(booking.expiresAtMs ?? 0) < nowMs ? 'expired' : 'pendingPayment'\n  }\n  return 'confirmed'\n}\n\nexport const BOOKING_STATE_LABELS: Readonly<Record<BookingState, string>> = {\n  confirmed: 'Confirmed',\n  pendingPayment: 'Awaiting payment',\n  expired: 'Payment not finished',\n  canceled: 'Canceled',\n}\n\n/** The paid amount not yet refunded, in cents. */\nexport function bookingOutstandingCents(booking: ManagedBooking): number {\n  const paid = Math.max(0, Math.round(Number(booking.paidAmountCents ?? 0)))\n  const refunded = Math.max(0, Math.round(Number(booking.refundedCents ?? 0)))\n  return Math.max(0, paid - refunded)\n}\n\nexport interface BookingActions {\n  checkIn: boolean\n  undoCheckIn: boolean\n  reschedule: boolean\n  /** Cancel; with `refundCents` above zero the cancel goes through the refund route. */\n  cancel: boolean\n  refundCents: number\n}\n\n/**\n * What may be done to a booking now. A guest is checked in only on a\n * confirmed booking; a booking moves only while it is confirmed and has not\n * ended; and nothing is done to a canceled one.\n */\nexport function bookingActions(booking: ManagedBooking, nowMs: number): BookingActions {\n  const state = bookingState(booking, nowMs)\n  const confirmed = state === 'confirmed'\n  const checkedIn = Number(booking.checkedInAtMs ?? 0) > 0\n  const ended = Number(booking.endsAtMs ?? 0) <= nowMs\n  return {\n    checkIn: confirmed && !checkedIn,\n    undoCheckIn: confirmed && checkedIn,\n    reschedule: confirmed && !checkedIn && !ended,\n    cancel: state !== 'canceled' && !checkedIn,\n    refundCents: bookingOutstandingCents(booking),\n  }\n}\n\n/** Why a check-in (or its undo) cannot be written, or null. The route's own refusal. */\nexport function checkInRefusal(booking: ManagedBooking, checkedIn: boolean, nowMs: number): string | null {\n  const state = bookingState(booking, nowMs)\n  if (state === 'canceled') return 'This booking was canceled'\n  if (state !== 'confirmed') return 'This booking is not paid yet'\n  return checkedIn || Number(booking.checkedInAtMs ?? 0) > 0 ? null : 'This guest is not checked in'\n}\n\n/** Why a booking cannot move to `startsAtMs`, or null. The slot itself is checked apart. */\nexport function rescheduleRefusal(booking: ManagedBooking, startsAtMs: number, nowMs: number): string | null {\n  const state = bookingState(booking, nowMs)\n  if (state === 'canceled') return 'This booking was canceled'\n  if (state !== 'confirmed') return 'This booking is not paid yet'\n  if (Number(booking.checkedInAtMs ?? 0) > 0) return 'This guest is already checked in'\n  if (Number(booking.endsAtMs ?? 0) <= nowMs) return 'This booking has already ended'\n  if (!Number.isFinite(startsAtMs) || startsAtMs <= nowMs) return 'Pick a time that has not passed'\n  return null\n}\n\n/**\n * Why a booking cannot be canceled by the cancel route, or null (AGL-3643).\n * A canceled booking is not refused: canceling it again changes nothing. A\n * booking with money still paid on it cancels through the refund instead, so\n * a guest is never left canceled and charged.\n */\nexport function cancelRefusal(booking: ManagedBooking, nowMs: number): string | null {\n  if (bookingState(booking, nowMs) === 'canceled') return null\n  if (Number(booking.checkedInAtMs ?? 0) > 0) return 'This guest is already checked in'\n  if (bookingOutstandingCents(booking) > 0) {\n    return 'This booking was paid. Cancel it with a refund so the guest gets their money back'\n  }\n  return null\n}\n\n/** The booking's length, kept when it moves: what the guest booked, not what the service says today. */\nexport function bookingDurationMs(booking: ManagedBooking, fallbackMinutes: number): number {\n  const stored = Number(booking.endsAtMs ?? 0) - Number(booking.startsAtMs ?? 0)\n  return stored > 0 ? stored : Math.max(5, Math.round(fallbackMinutes || 30)) * 60_000\n}\n"],"names":["bookingState","booking","nowMs","status","Number","expiresAtMs","BOOKING_STATE_LABELS","confirmed","pendingPayment","expired","canceled","bookingOutstandingCents","paid","Math","max","round","paidAmountCents","refunded","refundedCents","bookingActions","state","checkedIn","checkedInAtMs","ended","endsAtMs","checkIn","undoCheckIn","reschedule","cancel","refundCents","checkInRefusal","rescheduleRefusal","startsAtMs","isFinite","cancelRefusal","bookingDurationMs","fallbackMinutes","stored"],"mappings":"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"}

package/src/lib/model/booking-view.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @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 BookingState } from './booking-manage';
+/**
+ * A booking as the customer REST API publishes it (AGL-3643):
+ * `GET /v1/sites/{siteId}/bookings/{bookingId}`, and the `booking` every
+ * booking event carries, so a subscriber reads one documented object rather
+ * than the plugin's storage.
+ *
+ * Money is integer cents, in US dollars — a booking is charged in USD. Times
+ * are ISO 8601 in UTC, with the zone the booking was made in beside them.
+ * Never Stripe's handles, the CRM reference or the reminder stamps: those are
+ * how the platform runs a booking, not what one is.
+ *
+ * Pure: no I/O, so the API handler, the event raisers and a spec share it.
+ */
+export interface BookingView {
+    id: string;
+    object: 'booking';
+    serviceId: string | null;
+    serviceName: string | null;
+    /**
+     * `confirmed`, `pendingPayment` (a paid booking whose checkout is still
+     * open), `expired` (that checkout ran out and the slot was released) or
+     * `canceled`.
+     */
+    status: BookingState;
+    name: string | null;
+    email: string | null;
+    phone: string | null;
+    address: Record<string, unknown> | string | null;
+    startsAt: string | null;
+    endsAt: string | null;
+    timeZone: string | null;
+    currency: 'usd';
+    /** What the guest paid, tax included; 0 for a free booking. */
+    paidCents: number;
+    taxCents: number;
+    refundedCents: number;
+    checkedIn: boolean;
+    checkedInAt: string | null;
+    /** Where a moved booking started before its latest move, else `null`. */
+    rescheduledFrom: string | null;
+    created: string | null;
+}
+/** Epoch milliseconds, a Firestore Timestamp or a Date, as ISO 8601. */
+export declare function bookingInstant(value: unknown): string | null;
+/** One stored booking as the API publishes it. `nowMs` decides an expired hold. */
+export declare function bookingViewFromData(id: string, data: Record<string, unknown>, nowMs?: number): BookingView;

package/src/lib/model/booking-view.js

@@ -0,0 +1,70 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @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 { bookingState } from "./booking-manage.js";
+const text = (value)=>{
+    const out = typeof value === 'string' ? value.trim() : '';
+    return out ? out : null;
+};
+const cents = (value)=>{
+    const out = Math.round(Number(value != null ? value : 0));
+    return Number.isFinite(out) && out > 0 ? out : 0;
+};
+/** Epoch milliseconds, a Firestore Timestamp or a Date, as ISO 8601. */ export function bookingInstant(value) {
+    if (value == null) return null;
+    if (typeof value === 'number') return Number.isFinite(value) && value > 0 ? new Date(value).toISOString() : null;
+    if (value instanceof Date) return Number.isNaN(value.getTime()) ? null : value.toISOString();
+    const stamp = value;
+    if (typeof stamp.toMillis === 'function') return bookingInstant(stamp.toMillis());
+    if (typeof stamp.toDate === 'function') return bookingInstant(stamp.toDate());
+    return null;
+}
+function addressOf(value) {
+    if (typeof value === 'string') return text(value);
+    if (value && typeof value === 'object' && !Array.isArray(value)) return _extends({}, value);
+    return null;
+}
+/** One stored booking as the API publishes it. `nowMs` decides an expired hold. */ export function bookingViewFromData(id, data, nowMs = Date.now()) {
+    var _data_checkedInAtMs, _data_expiresAtMs, _data_startsAtMs, _data_endsAtMs, _data_rescheduledFromMs;
+    const checkedInAtMs = Number((_data_checkedInAtMs = data['checkedInAtMs']) != null ? _data_checkedInAtMs : 0);
+    return {
+        id,
+        object: 'booking',
+        serviceId: text(data['serviceId']),
+        serviceName: text(data['serviceName']),
+        status: bookingState({
+            status: typeof data['status'] === 'string' ? data['status'] : undefined,
+            expiresAtMs: Number((_data_expiresAtMs = data['expiresAtMs']) != null ? _data_expiresAtMs : 0) || undefined
+        }, nowMs),
+        name: text(data['name']),
+        email: text(data['email']),
+        phone: text(data['phone']),
+        address: addressOf(data['address']),
+        startsAt: bookingInstant(Number((_data_startsAtMs = data['startsAtMs']) != null ? _data_startsAtMs : 0)),
+        endsAt: bookingInstant(Number((_data_endsAtMs = data['endsAtMs']) != null ? _data_endsAtMs : 0)),
+        timeZone: text(data['timezone']),
+        currency: 'usd',
+        paidCents: cents(data['paidAmountCents']),
+        taxCents: cents(data['taxCents']),
+        refundedCents: cents(data['refundedCents']),
+        checkedIn: checkedInAtMs > 0,
+        checkedInAt: checkedInAtMs > 0 ? bookingInstant(checkedInAtMs) : null,
+        rescheduledFrom: bookingInstant(Number((_data_rescheduledFromMs = data['rescheduledFromMs']) != null ? _data_rescheduledFromMs : 0)),
+        created: bookingInstant(data['createdAt'])
+    };
+}
+
+//# sourceMappingURL=booking-view.js.map

package/src/lib/model/booking-view.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/bookings/src/lib/model/booking-view.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 { bookingState, type BookingState } from './booking-manage'\n\n/**\n * A booking as the customer REST API publishes it (AGL-3643):\n * `GET /v1/sites/{siteId}/bookings/{bookingId}`, and the `booking` every\n * booking event carries, so a subscriber reads one documented object rather\n * than the plugin's storage.\n *\n * Money is integer cents, in US dollars — a booking is charged in USD. Times\n * are ISO 8601 in UTC, with the zone the booking was made in beside them.\n * Never Stripe's handles, the CRM reference or the reminder stamps: those are\n * how the platform runs a booking, not what one is.\n *\n * Pure: no I/O, so the API handler, the event raisers and a spec share it.\n */\nexport interface BookingView {\n  id: string\n  object: 'booking'\n  serviceId: string | null\n  serviceName: string | null\n  /**\n   * `confirmed`, `pendingPayment` (a paid booking whose checkout is still\n   * open), `expired` (that checkout ran out and the slot was released) or\n   * `canceled`.\n   */\n  status: BookingState\n  name: string | null\n  email: string | null\n  phone: string | null\n  address: Record<string, unknown> | string | null\n  startsAt: string | null\n  endsAt: string | null\n  timeZone: string | null\n  currency: 'usd'\n  /** What the guest paid, tax included; 0 for a free booking. */\n  paidCents: number\n  taxCents: number\n  refundedCents: number\n  checkedIn: boolean\n  checkedInAt: string | null\n  /** Where a moved booking started before its latest move, else `null`. */\n  rescheduledFrom: string | null\n  created: string | null\n}\n\nconst text = (value: unknown): string | null => {\n  const out = typeof value === 'string' ? value.trim() : ''\n  return out ? out : null\n}\n\nconst cents = (value: unknown): number => {\n  const out = Math.round(Number(value ?? 0))\n  return Number.isFinite(out) && out > 0 ? out : 0\n}\n\n/** Epoch milliseconds, a Firestore Timestamp or a Date, as ISO 8601. */\nexport function bookingInstant(value: unknown): string | null {\n  if (value == null) return null\n  if (typeof value === 'number') return Number.isFinite(value) && value > 0 ? new Date(value).toISOString() : null\n  if (value instanceof Date) return Number.isNaN(value.getTime()) ? null : value.toISOString()\n  const stamp = value as { toMillis?: () => number; toDate?: () => Date }\n  if (typeof stamp.toMillis === 'function') return bookingInstant(stamp.toMillis())\n  if (typeof stamp.toDate === 'function') return bookingInstant(stamp.toDate())\n  return null\n}\n\nfunction addressOf(value: unknown): BookingView['address'] {\n  if (typeof value === 'string') return text(value)\n  if (value && typeof value === 'object' && !Array.isArray(value)) return { ...(value as Record<string, unknown>) }\n  return null\n}\n\n/** One stored booking as the API publishes it. `nowMs` decides an expired hold. */\nexport function bookingViewFromData(id: string, data: Record<string, unknown>, nowMs = Date.now()): BookingView {\n  const checkedInAtMs = Number(data['checkedInAtMs'] ?? 0)\n  return {\n    id,\n    object: 'booking',\n    serviceId: text(data['serviceId']),\n    serviceName: text(data['serviceName']),\n    status: bookingState(\n      {\n        status: typeof data['status'] === 'string' ? data['status'] : undefined,\n        expiresAtMs: Number(data['expiresAtMs'] ?? 0) || undefined,\n      },\n      nowMs,\n    ),\n    name: text(data['name']),\n    email: text(data['email']),\n    phone: text(data['phone']),\n    address: addressOf(data['address']),\n    startsAt: bookingInstant(Number(data['startsAtMs'] ?? 0)),\n    endsAt: bookingInstant(Number(data['endsAtMs'] ?? 0)),\n    timeZone: text(data['timezone']),\n    currency: 'usd',\n    paidCents: cents(data['paidAmountCents']),\n    taxCents: cents(data['taxCents']),\n    refundedCents: cents(data['refundedCents']),\n    checkedIn: checkedInAtMs > 0,\n    checkedInAt: checkedInAtMs > 0 ? bookingInstant(checkedInAtMs) : null,\n    rescheduledFrom: bookingInstant(Number(data['rescheduledFromMs'] ?? 0)),\n    created: bookingInstant(data['createdAt']),\n  }\n}\n"],"names":["bookingState","text","value","out","trim","cents","Math","round","Number","isFinite","bookingInstant","Date","toISOString","isNaN","getTime","stamp","toMillis","toDate","addressOf","Array","isArray","bookingViewFromData","id","data","nowMs","now","checkedInAtMs","object","serviceId","serviceName","status","undefined","expiresAtMs","name","email","phone","address","startsAt","endsAt","timeZone","currency","paidCents","taxCents","refundedCents","checkedIn","checkedInAt","rescheduledFrom","created"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,YAAY,QAA2B,sBAAkB;AA6ClE,MAAMC,OAAO,CAACC;IACZ,MAAMC,MAAM,OAAOD,UAAU,WAAWA,MAAME,IAAI,KAAK;IACvD,OAAOD,MAAMA,MAAM;AACrB;AAEA,MAAME,QAAQ,CAACH;IACb,MAAMC,MAAMG,KAAKC,KAAK,CAACC,OAAON,gBAAAA,QAAS;IACvC,OAAOM,OAAOC,QAAQ,CAACN,QAAQA,MAAM,IAAIA,MAAM;AACjD;AAEA,sEAAsE,GACtE,OAAO,SAASO,eAAeR,KAAc;IAC3C,IAAIA,SAAS,MAAM,OAAO;IAC1B,IAAI,OAAOA,UAAU,UAAU,OAAOM,OAAOC,QAAQ,CAACP,UAAUA,QAAQ,IAAI,IAAIS,KAAKT,OAAOU,WAAW,KAAK;IAC5G,IAAIV,iBAAiBS,MAAM,OAAOH,OAAOK,KAAK,CAACX,MAAMY,OAAO,MAAM,OAAOZ,MAAMU,WAAW;IAC1F,MAAMG,QAAQb;IACd,IAAI,OAAOa,MAAMC,QAAQ,KAAK,YAAY,OAAON,eAAeK,MAAMC,QAAQ;IAC9E,IAAI,OAAOD,MAAME,MAAM,KAAK,YAAY,OAAOP,eAAeK,MAAME,MAAM;IAC1E,OAAO;AACT;AAEA,SAASC,UAAUhB,KAAc;IAC/B,IAAI,OAAOA,UAAU,UAAU,OAAOD,KAAKC;IAC3C,IAAIA,SAAS,OAAOA,UAAU,YAAY,CAACiB,MAAMC,OAAO,CAAClB,QAAQ,OAAO,aAAMA;IAC9E,OAAO;AACT;AAEA,iFAAiF,GACjF,OAAO,SAASmB,oBAAoBC,EAAU,EAAEC,IAA6B,EAAEC,QAAQb,KAAKc,GAAG,EAAE;QAClEF,qBASHA,mBAQQA,kBACFA,gBAQSA;IA1BzC,MAAMG,gBAAgBlB,QAAOe,sBAAAA,IAAI,CAAC,gBAAgB,YAArBA,sBAAyB;IACtD,OAAO;QACLD;QACAK,QAAQ;QACRC,WAAW3B,KAAKsB,IAAI,CAAC,YAAY;QACjCM,aAAa5B,KAAKsB,IAAI,CAAC,cAAc;QACrCO,QAAQ9B,aACN;YACE8B,QAAQ,OAAOP,IAAI,CAAC,SAAS,KAAK,WAAWA,IAAI,CAAC,SAAS,GAAGQ;YAC9DC,aAAaxB,QAAOe,oBAAAA,IAAI,CAAC,cAAc,YAAnBA,oBAAuB,MAAMQ;QACnD,GACAP;QAEFS,MAAMhC,KAAKsB,IAAI,CAAC,OAAO;QACvBW,OAAOjC,KAAKsB,IAAI,CAAC,QAAQ;QACzBY,OAAOlC,KAAKsB,IAAI,CAAC,QAAQ;QACzBa,SAASlB,UAAUK,IAAI,CAAC,UAAU;QAClCc,UAAU3B,eAAeF,QAAOe,mBAAAA,IAAI,CAAC,aAAa,YAAlBA,mBAAsB;QACtDe,QAAQ5B,eAAeF,QAAOe,iBAAAA,IAAI,CAAC,WAAW,YAAhBA,iBAAoB;QAClDgB,UAAUtC,KAAKsB,IAAI,CAAC,WAAW;QAC/BiB,UAAU;QACVC,WAAWpC,MAAMkB,IAAI,CAAC,kBAAkB;QACxCmB,UAAUrC,MAAMkB,IAAI,CAAC,WAAW;QAChCoB,eAAetC,MAAMkB,IAAI,CAAC,gBAAgB;QAC1CqB,WAAWlB,gBAAgB;QAC3BmB,aAAanB,gBAAgB,IAAIhB,eAAegB,iBAAiB;QACjEoB,iBAAiBpC,eAAeF,QAAOe,0BAAAA,IAAI,CAAC,oBAAoB,YAAzBA,0BAA6B;QACpEwB,SAASrC,eAAea,IAAI,CAAC,YAAY;IAC3C;AACF"}

package/src/lib/server/api-v1/bookings.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @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 ApiV1Context } from '@aglyn/tenant-data-admin/server/api-v1-kit';
+/**
+ * A site's bookings on the customer REST API,
+ * `/v1/sites/{siteId}/bookings/…` (AGL-3643). Registered from this plugin's
+ * console server declarations; the console's `/v1` router owns the pipeline
+ * in front — the key, the plan's API access, the request quota, the rate
+ * limit — and refuses a site the key's organization does not own before it
+ * hands a request here.
+ *
+ * Read-only: `bookings:read`, and the `bookings` plan feature. The scope is
+ * asked first and the plan second, the order every commerce resource asks
+ * them in (AGL-900), so a key without the scope is told about the scope
+ * whatever plan its organization is on.
+ */
+/** The statuses a booking is stored with, and so the ones `?status=` takes. */
+export declare const BOOKING_LIST_STATUSES: readonly ["confirmed", "pendingPayment", "canceled"];
+export declare function handleBookings(request: Request, ctx: ApiV1Context, segments: string[], url: URL): Promise<Response>;