@medalsocial/booking 0.0.0-placeholder.0 → 0.2.0

package/dist/core/types.d.mts

@@ -0,0 +1,245 @@
+import { WizardService } from "./machine.mjs";
+//#region src/core/types.d.ts
+/**
+ * The wizard-shaped contract: what this site's own route handlers emit and what
+ * the step components take as props. Deliberately not Medal's wire types —
+ * camelCase, no nulls where a null would only mean "the serialiser had nothing"
+ * (`medal-client.ts` explains why every field arrives nullable), and epoch
+ * milliseconds rather than ISO strings for anything the machine has to format.
+ *
+ * Shared from here rather than declared beside each route so a field added to
+ * the payload cannot be added to only one of the two ends that read it.
+ */
+/**
+ * One service as step 1 wants it: `WizardService` plus the flag that decides
+ * whether the card is a button or a phone number.
+ *
+ * `bookableOnline` is not on `WizardService` because the wizard never carries a
+ * service it cannot book. It has to travel anyway — J1 step 1 has «Hull i
+ * ørene» rendering as «Ring oss for denne» rather than disappearing, so the
+ * price list stays complete — and the card, not the machine, is what needs it.
+ */
+export interface BookingServiceDto extends WizardService {
+  bookableOnline: boolean;
+}
+/**
+ * One stylist as step 2 wants it.
+ *
+ * `serviceIds` is what makes the step honest: offering a stylist who cannot do
+ * the chosen service is a server refusal three steps later, dressed up as a
+ * choice. `photoUrl` and `bio` stay nullable because an unphotographed stylist
+ * is the ordinary case, and the card falls back to initials.
+ */
+export interface BookingResourceDto {
+  id: string;
+  name: string;
+  photoUrl: string | null;
+  bio: string | null;
+  serviceIds: string[];
+  sortOrder: number;
+}
+/**
+ * One bookable slot, as step 3 wants it.
+ *
+ * `startTs` is epoch milliseconds, which is a translation and not a
+ * relabelling: `formatBookingSlot` puts every timestamp through
+ * `toISOString()`, but `pickSlot` stores `startTs` as a number and the sticky
+ * summary bar formats it with `Intl.DateTimeFormat.format`. Relaying the string
+ * would seat one in `state.startTs`, and the bar would throw on the visitor's
+ * next keystroke.
+ *
+ * No `endTs`: the wizard has nowhere to put one. A slot's end is its start plus
+ * the service's `durationMinutes`, which step 3 already has.
+ *
+ * `resourceId` stays nullable, unlike everything the services route emits. Here
+ * `null` is an answer rather than a gap — it is «Første ledige» not yet
+ * resolved to a stylist — and `pickSlot` takes it as one.
+ */
+export interface BookingSlotDto {
+  startTs: number;
+  resourceId: string | null;
+}
+/**
+ * One date the salon keeps opening hours on, as step 3 wants it.
+ *
+ * The list is what lets the step tell «stengt» from «fullt». Availability
+ * answers what can still be booked and its empty array says three things at
+ * once — closed today, past closing today, every chair taken today — and a step
+ * with one card for all three announced «Fullt i dag» at 18:45 on a Saturday
+ * the salon shut at 17:00. A date MISSING from this list is one the salon keeps
+ * no hours on; that absence is the answer, which is why there is no `closed`
+ * field to read.
+ *
+ * `dayKey` is `salonDayKey`'s `2026-08-29`, so the step can look a day up
+ * without re-deriving the salon's calendar date from an instant.
+ *
+ * `lastStartTs` is the last start THIS visit could occupy on the date, not the
+ * closing time — the gap between them is a whole service's duration, and it is
+ * the difference between «fullt» and «for sent i dag». Null when the salon
+ * posts hours for the date but is shut on it outright, which is how a public
+ * holiday arrives.
+ */
+export interface BookingDayDto {
+  dayKey: string;
+  opensTs: number;
+  closesTs: number;
+  lastStartTs: number | null;
+}
+/**
+ * One booking as the manage page wants it — the screen reached from the link in
+ * the confirmation e-mail.
+ *
+ * Deliberately carries no token. The token is the credential that produced this
+ * object and it stays on the server that fetched it; the page puts it back into
+ * its own URLs and nowhere else, and nothing here would let it leak into a
+ * client-side prop, a log line or an analytics payload.
+ *
+ * `canCancel` / `canReschedule` are **the engine's answers, relayed** — never
+ * this site's opinion. The engine enforces both windows on the write, and it
+ * computes these two with the identical comparison at read time, so relaying
+ * them is what stops the page offering a button that is certain to 409. There
+ * is no deadline field on the wire, only the window in hours, so the *sentence*
+ * about when free changes end is derived (`startTs - cancelWindowHours`); the
+ * *buttons* are not.
+ */
+export interface BookingManageDto {
+  bookingId: string;
+  status: 'pending' | 'confirmed' | 'completed' | 'cancelled' | 'no_show';
+  /** The booking this one was moved from, when it is itself a move — the id the
+   * customer's calendar entry was created under. */
+  rescheduledFromId: string | null;
+  startTs: number;
+  endTs: number;
+  serviceId: string | null;
+  /** «Unknown service» when the catalogue row was deleted; never blank. */
+  serviceName: string;
+  resourceId: string | null;
+  resourceName: string;
+  /** The child, when the parent named one. */
+  bookedForName: string | null;
+  /** Non-null when this booking is one child of a family visit. */
+  partySequenceId: string | null;
+  /** What the salon charged for THIS booking, surcharge included. */
+  amountOre: number;
+  cancelWindowHours: number;
+  rescheduleWindowHours: number;
+  canCancel: boolean;
+  canReschedule: boolean;
+}
+/**
+ * One line of a submission: a service, an instant, and whichever of the two
+ * optional answers about the child the parent actually gave.
+ *
+ * Every optional field here is optional in the strict sense — **absent**, never
+ * blank. The engine takes `booked_for_name` as `z.string().trim().min(1)
+ * .optional()`, where `''` is a 400 rather than a shrug, and
+ * `booked_for_birth_year` as `z.number().optional()`, which refuses the `null`
+ * an emptied input serialises to. The create route coalesces as a second line
+ * of defence; the step still has to send nothing rather than send emptiness,
+ * because the moment anything else consumes this shape the coalescing is gone.
+ */
+export interface BookingSubmissionItem {
+  serviceId: string;
+  /** The rest of this person's visit after `serviceId`, in order — booked as
+   * ONE appointment with one stylist. Absent for a one-service visit, never
+   * `[]`. */
+  extraServiceIds?: string[];
+  /** The stylist the slot RESOLVED to, not the visitor's «Første ledige»
+   * preference — absent when the engine is still to choose. */
+  resourceId?: string;
+  startTs: number;
+  bookedForName?: string;
+  bookedForBirthYear?: number;
+  /**
+   * The saved child this line is for (SP10). Sent only when the parent is
+   * logged in AND the phone being submitted is theirs — Medal resolves the
+   * contact by phone, and an id under somebody else's number fails the whole
+   * booking. The create route checks the same rule again.
+   */
+  bookedForPersonId?: string;
+}
+/**
+ * What step 4 hands its caller, and what `POST /api/booking/create` takes.
+ *
+ * `consentMarketing` travels even though the engine's create body has nowhere
+ * to put it: it is written separately to the GDPR consent endpoint once the
+ * booking has succeeded. Leaving it off this shape would mean a box that is
+ * ticked and then forgotten, which is worse than not offering it.
+ */
+export interface BookingSubmission {
+  items: BookingSubmissionItem[];
+  contact: {
+    phone: string;
+    name?: string;
+    email?: string;
+  };
+  notes?: string;
+  consentTerms: boolean;
+  consentMarketing: boolean;
+  /**
+   * Identifies the submission *attempt*, not the booking — one value minted
+   * when step 4 comes up and resent unchanged on every retry of it.
+   *
+   * It is what turns a double-tapped «Bekreft» into one booking: the create
+   * route hashes it together with this body to derive the `Idempotency-Key`, so
+   * an identical retry derives an identical key. Absent, the route falls back to
+   * a per-request key and the retry books twice — which is why it is on this
+   * shape rather than added by whoever posts it.
+   */
+  submissionNonce?: string;
+}
+/**
+ * The logged-in parent, as the wizard's «Bekreft» step wants them.
+ *
+ * A narrowing of `PortalProfileDto`, and the narrowing is the point. The
+ * booking page reads the portal profile on the server when the visitor happens
+ * to hold a Min side cookie, and hands the browser only what a booking form
+ * has a use for: the name and number that prefill step 4, the address the
+ * confirmation is sent to, and the children whose names step 4 asks for.
+ * `contactId`, the marketing flag and the bransjemal labels stay on the server
+ * — a prop that travels is a prop in the HTML, and none of those three is
+ * anything the wizard renders.
+ *
+ * Nulls stay nulls, as in the portal DTO: `''` would make «Vipps gave us no
+ * surname» indistinguishable from «the parent cleared the field».
+ */
+export interface BookingGuardian {
+  firstName: string | null;
+  lastName: string | null;
+  email: string;
+  phone: string | null;
+  /** The children on the profile, for step 1's «Hvem skal klippes?». */
+  family: BookingFamilyMember[];
+}
+/**
+ * One child on the logged-in parent's profile, as the wizard sees them.
+ *
+ * `personId` is the id Medal keeps for the child (SP10/SP11), absent when the
+ * profile could not name one — see `PortalFamilyMemberDto`. It is what a line
+ * item is booked for (`booked_for_person_id`) and what «Samme som sist» joins
+ * a past visit on. Optional fields are ABSENT rather than null, the rule every
+ * wizard-shaped value follows.
+ */
+export interface BookingFamilyMember {
+  name: string;
+  birthYear: number;
+  personId?: string;
+  /** 1–12, when the parent gave one — makes the age exact across the birthday. */
+  birthMonth?: number;
+  /** «Fast frisør»: the stylist this child usually sees. A preference only. */
+  preferredResourceId?: string;
+  /**
+   * The child's last COMPLETED visit, for the card's «Sist: Gutteklipp, 12.
+   * aug» and step 2's «Samme som sist». Absent for a child with none, or one
+   * the site cannot tell apart from a sibling.
+   */
+  lastVisit?: BookingLastVisit;
+}
+export interface BookingLastVisit {
+  serviceId: string;
+  serviceName: string | null;
+  resourceId: string | null;
+  startTs: number;
+}
+//#endregion
+//# sourceMappingURL=types.d.mts.map

package/dist/core/visit.d.mts

@@ -0,0 +1,26 @@
+import { WizardItem, WizardService } from "./machine.mjs";
+//#region src/core/visit.d.ts
+/** The timing of a whole visit. */
+export interface VisitTiming {
+  durationMinutes: number;
+  bufferBeforeMinutes: number;
+  bufferAfterMinutes: number;
+}
+/** A person's services in order: the first, then the extras. */
+export declare function visitServicesOf(item: Pick<WizardItem, 'service' | 'extraServices'>): WizardService[];
+/** The timing of an ordered, non-empty list of services. Throws on an empty list. */
+export declare function visitOfServices(services: readonly WizardService[]): VisitTiming;
+/** The timing of a person's visit, from a line item or a list of services. */
+export declare function visitOf(itemOrServices: Pick<WizardItem, 'service' | 'extraServices'> | readonly WizardService[]): VisitTiming;
+/**
+ * A visit's ids joined with `+`, in order; a single service is its id
+ * unchanged. The server keys its slot cache and its `freshSlots` answer with
+ * this too, so the wizard and the server can never disagree on a visit's name.
+ */
+export declare function visitKeyOfIds(serviceIds: readonly string[]): string;
+/** The service ids joined with `+`, in order; a single service is its id unchanged. */
+export declare function visitKey(itemOrServices: Pick<WizardItem, 'service' | 'extraServices'> | readonly WizardService[]): string;
+/** The visit's price: each service priced on its own, then summed. */
+export declare function visitPriceOre(services: readonly WizardService[], priceOf: (service: WizardService) => number): number;
+//#endregion
+//# sourceMappingURL=visit.d.mts.map

package/dist/core/visit.mjs

@@ -0,0 +1,40 @@
+//#region src/core/visit.ts
+/** A person's services in order: the first, then the extras. */
+function visitServicesOf(item) {
+	return [item.service, ...item.extraServices ?? []];
+}
+/** The timing of an ordered, non-empty list of services. Throws on an empty list. */
+function visitOfServices(services) {
+	const first = services[0];
+	const last = services[services.length - 1];
+	if (!first || !last) throw new Error("a visit needs at least one service");
+	return {
+		durationMinutes: services.reduce((sum, s) => sum + s.durationMinutes, 0),
+		bufferBeforeMinutes: first.bufferBeforeMinutes,
+		bufferAfterMinutes: last.bufferAfterMinutes
+	};
+}
+/** The timing of a person's visit, from a line item or a list of services. */
+function visitOf(itemOrServices) {
+	return visitOfServices(Array.isArray(itemOrServices) ? itemOrServices : visitServicesOf(itemOrServices));
+}
+/**
+* A visit's ids joined with `+`, in order; a single service is its id
+* unchanged. The server keys its slot cache and its `freshSlots` answer with
+* this too, so the wizard and the server can never disagree on a visit's name.
+*/
+function visitKeyOfIds(serviceIds) {
+	return serviceIds.join("+");
+}
+/** The service ids joined with `+`, in order; a single service is its id unchanged. */
+function visitKey(itemOrServices) {
+	return visitKeyOfIds((Array.isArray(itemOrServices) ? itemOrServices : visitServicesOf(itemOrServices)).map((s) => s.id));
+}
+/** The visit's price: each service priced on its own, then summed. */
+function visitPriceOre(services, priceOf) {
+	return services.reduce((sum, s) => sum + priceOf(s), 0);
+}
+//#endregion
+export { visitKey, visitKeyOfIds, visitOf, visitOfServices, visitPriceOre, visitServicesOf };
+
+//# sourceMappingURL=visit.mjs.map

package/dist/core/visit.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"visit.mjs","names":[],"sources":["../../src/core/visit.ts"],"sourcesContent":["/**\n * One person, several services, ONE visit — performed back to back by one\n * stylist. The engine's model: the duration is the SUM of the services', the\n * buffer before is the FIRST service's, the buffer after is the LAST's, there\n * is no buffer between a person's own services, and each service is priced on\n * its own. Everything that times or prices a line goes through these helpers so\n * a one-service line and a three-service line share one path.\n */\n\nimport type { WizardItem, WizardService } from './machine';\n\n/** The timing of a whole visit. */\nexport interface VisitTiming {\n  durationMinutes: number;\n  bufferBeforeMinutes: number;\n  bufferAfterMinutes: number;\n}\n\n/** A person's services in order: the first, then the extras. */\nexport function visitServicesOf(\n  item: Pick<WizardItem, 'service' | 'extraServices'>\n): WizardService[] {\n  return [item.service, ...(item.extraServices ?? [])];\n}\n\n/** The timing of an ordered, non-empty list of services. Throws on an empty list. */\nexport function visitOfServices(services: readonly WizardService[]): VisitTiming {\n  const first = services[0];\n  const last = services[services.length - 1];\n  if (!first || !last) throw new Error('a visit needs at least one service');\n  return {\n    durationMinutes: services.reduce((sum, s) => sum + s.durationMinutes, 0),\n    bufferBeforeMinutes: first.bufferBeforeMinutes,\n    bufferAfterMinutes: last.bufferAfterMinutes,\n  };\n}\n\n/** The timing of a person's visit, from a line item or a list of services. */\nexport function visitOf(\n  itemOrServices: Pick<WizardItem, 'service' | 'extraServices'> | readonly WizardService[]\n): VisitTiming {\n  return visitOfServices(\n    Array.isArray(itemOrServices)\n      ? itemOrServices\n      : visitServicesOf(itemOrServices as Pick<WizardItem, 'service' | 'extraServices'>)\n  );\n}\n\n/**\n * A visit's ids joined with `+`, in order; a single service is its id\n * unchanged. The server keys its slot cache and its `freshSlots` answer with\n * this too, so the wizard and the server can never disagree on a visit's name.\n */\nexport function visitKeyOfIds(serviceIds: readonly string[]): string {\n  return serviceIds.join('+');\n}\n\n/** The service ids joined with `+`, in order; a single service is its id unchanged. */\nexport function visitKey(\n  itemOrServices: Pick<WizardItem, 'service' | 'extraServices'> | readonly WizardService[]\n): string {\n  const services = Array.isArray(itemOrServices)\n    ? (itemOrServices as readonly WizardService[])\n    : visitServicesOf(itemOrServices as Pick<WizardItem, 'service' | 'extraServices'>);\n  return visitKeyOfIds(services.map((s) => s.id));\n}\n\n/** The visit's price: each service priced on its own, then summed. */\nexport function visitPriceOre(\n  services: readonly WizardService[],\n  priceOf: (service: WizardService) => number\n): number {\n  return services.reduce((sum, s) => sum + priceOf(s), 0);\n}\n"],"mappings":";;AAmBA,SAAgB,gBACd,MACiB;CACjB,OAAO,CAAC,KAAK,SAAS,GAAI,KAAK,iBAAiB,CAAC,CAAE;AACrD;;AAGA,SAAgB,gBAAgB,UAAiD;CAC/E,MAAM,QAAQ,SAAS;CACvB,MAAM,OAAO,SAAS,SAAS,SAAS;CACxC,IAAI,CAAC,SAAS,CAAC,MAAM,MAAM,IAAI,MAAM,oCAAoC;CACzE,OAAO;EACL,iBAAiB,SAAS,QAAQ,KAAK,MAAM,MAAM,EAAE,iBAAiB,CAAC;EACvE,qBAAqB,MAAM;EAC3B,oBAAoB,KAAK;CAC3B;AACF;;AAGA,SAAgB,QACd,gBACa;CACb,OAAO,gBACL,MAAM,QAAQ,cAAc,IACxB,iBACA,gBAAgB,cAA+D,CACrF;AACF;;;;;;AAOA,SAAgB,cAAc,YAAuC;CACnE,OAAO,WAAW,KAAK,GAAG;AAC5B;;AAGA,SAAgB,SACd,gBACQ;CAIR,OAAO,eAHU,MAAM,QAAQ,cAAc,IACxC,iBACD,gBAAgB,cAA+D,EAAA,CACrD,KAAK,MAAM,EAAE,EAAE,CAAC;AAChD;;AAGA,SAAgB,cACd,UACA,SACQ;CACR,OAAO,SAAS,QAAQ,KAAK,MAAM,MAAM,QAAQ,CAAC,GAAG,CAAC;AACxD"}

package/dist/core/wire.d.mts

@@ -0,0 +1,37 @@
+import { BookingResource, BookingScheduleDay, BookingService, BookingSlot, ManageSummary } from "@medalsocial/sdk";
+//#region src/core/wire.d.ts
+/**
+ * Wire types are the SDK's, `Pick`ed down to exactly the fields this site
+ * reads: the SDK growing a column (it has several this site never looks at)
+ * then neither widens what the routes pass to the browser nor breaks a
+ * fixture, while a change to the TYPE of a field the site does read still
+ * fails the build.
+ *
+ * Nullable, not optional: the serialiser emits every field as `value ?? null`,
+ * so each key is always present and may be `null` — a different thing from
+ * being absent. Coalescing the nulls away belongs in the route handler.
+ */
+export type MedalService = Pick<BookingService, 'id' | 'name' | 'description' | 'category' | 'duration_minutes' | 'buffer_before_minutes' | 'buffer_after_minutes' | 'price_ore' | 'bookable_online' | 'max_per_booking' | 'weekend_surcharge_pct'> &
+/**
+ * SP10's service age range, inclusive whole years — `null` where the salon
+ * set none. Optional here although the SDK's `BookingService` always has
+ * them: a Medal that predates SP10 sends neither, and `toServiceDto` reads
+ * them defensively.
+ */
+Partial<Pick<BookingService, 'age_min_years' | 'age_max_years'>>;
+export type MedalResource = Pick<BookingResource, 'id' | 'name' | 'photo_url' | 'bio' | 'service_ids' | 'sort_order'>;
+export type MedalSlot = BookingSlot;
+export type MedalScheduleDay = BookingScheduleDay;
+/**
+ * Three fields are narrower than the SDK's, on the engine's own word: it falls
+ * back to «Unknown service» / «Unknown resource» rather than `null` when the
+ * catalogue row is gone, and a booking always has a status. `getManage`
+ * makes the narrowing true by construction instead of asserting it.
+ */
+export type MedalManageSummary = Omit<ManageSummary, 'status' | 'service_name' | 'resource_name'> & {
+  status: NonNullable<ManageSummary['status']>;
+  service_name: string;
+  resource_name: string;
+};
+//#endregion
+//# sourceMappingURL=wire.d.mts.map

package/dist/next/cache/memory.d.mts

@@ -0,0 +1,14 @@
+import { BookingCacheAdapter } from "../options.mjs";
+import "server-only";
+//#region src/next/cache/memory.d.ts
+export interface MemoryCacheAdapterOptions {
+  /** Most entries held at once. Default 500. */
+  maxEntries?: number;
+  /** A ceiling on every entry's TTL, in seconds. Default: none. */
+  maxTtlSeconds?: number;
+  /** The clock, for tests. Default `Date.now`. */
+  now?: () => number;
+}
+export declare function memoryCacheAdapter(options?: MemoryCacheAdapterOptions): BookingCacheAdapter;
+//#endregion
+//# sourceMappingURL=memory.d.mts.map

package/dist/next/cache/memory.mjs

@@ -0,0 +1,51 @@
+import "server-only";
+//#region src/next/cache/memory.ts
+function memoryCacheAdapter(options = {}) {
+	const maxEntries = Math.max(1, options.maxEntries ?? 500);
+	const now = options.now ?? Date.now;
+	const entries = /* @__PURE__ */ new Map();
+	function live(key) {
+		const entry = entries.get(key);
+		if (entry === void 0) return void 0;
+		if (entry.expiresAt <= now()) {
+			entries.delete(key);
+			return;
+		}
+		return entry;
+	}
+	return {
+		async get(key) {
+			const entry = live(key);
+			if (entry === void 0) return void 0;
+			entries.delete(key);
+			entries.set(key, entry);
+			return JSON.parse(entry.json);
+		},
+		async put(key, value, ttlSeconds, putOptions) {
+			const ttl = Math.min(ttlSeconds, options.maxTtlSeconds ?? ttlSeconds);
+			if (!(ttl > 0)) return;
+			const json = JSON.stringify(value);
+			if (json === void 0) return;
+			entries.delete(key);
+			entries.set(key, {
+				json,
+				expiresAt: now() + ttl * 1e3,
+				tags: putOptions?.tags ?? []
+			});
+			while (entries.size > maxEntries) {
+				const oldest = entries.keys().next().value;
+				entries.delete(oldest);
+			}
+		},
+		async delete(keys) {
+			for (const key of keys) entries.delete(key);
+		},
+		async expireTag(tag) {
+			for (const [key, entry] of entries) if (entry.tags.includes(tag)) entries.delete(key);
+		}
+	};
+}
+//#endregion
+export { memoryCacheAdapter };
+
+//# sourceMappingURL=memory.mjs.map

package/dist/next/cache/memory.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.mjs","names":[],"sources":["../../../src/next/cache/memory.ts"],"sourcesContent":["/**\n * `@medalsocial/booking/next/cache/memory` — a per-process LRU cache.\n *\n * For a site on Node (`next start`, Docker, a VM): one map in this process,\n * bounded by `maxEntries` (least recently used goes first) and by each\n * entry's TTL, with tag expiry for the data cache. Nothing is shared between\n * processes, so each instance warms on its own; the TTLs the package writes\n * (30 s to an hour) bound how far two instances can disagree.\n *\n * Values are stored as JSON and parsed on the way out, so a caller can never\n * mutate a cached entry through the object it was handed — the same\n * guarantee a real cache gives.\n */\n\nimport 'server-only';\n\nimport type { BookingCacheAdapter } from '../options';\n\nexport interface MemoryCacheAdapterOptions {\n  /** Most entries held at once. Default 500. */\n  maxEntries?: number;\n  /** A ceiling on every entry's TTL, in seconds. Default: none. */\n  maxTtlSeconds?: number;\n  /** The clock, for tests. Default `Date.now`. */\n  now?: () => number;\n}\n\ninterface Entry {\n  json: string;\n  expiresAt: number;\n  tags: readonly string[];\n}\n\nexport function memoryCacheAdapter(options: MemoryCacheAdapterOptions = {}): BookingCacheAdapter {\n  const maxEntries = Math.max(1, options.maxEntries ?? 500);\n  const now = options.now ?? Date.now;\n  const entries = new Map<string, Entry>();\n\n  function live(key: string): Entry | undefined {\n    const entry = entries.get(key);\n    if (entry === undefined) return undefined;\n    if (entry.expiresAt <= now()) {\n      entries.delete(key);\n      return undefined;\n    }\n    return entry;\n  }\n\n  return {\n    async get<T>(key: string) {\n      const entry = live(key);\n      if (entry === undefined) return undefined;\n      // Most recently used moves to the end of the insertion order.\n      entries.delete(key);\n      entries.set(key, entry);\n      return JSON.parse(entry.json) as T;\n    },\n\n    async put(key, value, ttlSeconds, putOptions) {\n      const ttl = Math.min(ttlSeconds, options.maxTtlSeconds ?? ttlSeconds);\n      if (!(ttl > 0)) return;\n      const json = JSON.stringify(value);\n      if (json === undefined) return;\n      entries.delete(key);\n      entries.set(key, { json, expiresAt: now() + ttl * 1000, tags: putOptions?.tags ?? [] });\n      while (entries.size > maxEntries) {\n        const oldest = entries.keys().next().value as string;\n        entries.delete(oldest);\n      }\n    },\n\n    async delete(keys) {\n      for (const key of keys) entries.delete(key);\n    },\n\n    async expireTag(tag) {\n      for (const [key, entry] of entries) {\n        if (entry.tags.includes(tag)) entries.delete(key);\n      }\n    },\n  };\n}\n"],"mappings":";;AAiCA,SAAgB,mBAAmB,UAAqC,CAAC,GAAwB;CAC/F,MAAM,aAAa,KAAK,IAAI,GAAG,QAAQ,cAAc,GAAG;CACxD,MAAM,MAAM,QAAQ,OAAO,KAAK;CAChC,MAAM,0BAAU,IAAI,IAAmB;CAEvC,SAAS,KAAK,KAAgC;EAC5C,MAAM,QAAQ,QAAQ,IAAI,GAAG;EAC7B,IAAI,UAAU,KAAA,GAAW,OAAO,KAAA;EAChC,IAAI,MAAM,aAAa,IAAI,GAAG;GAC5B,QAAQ,OAAO,GAAG;GAClB;EACF;EACA,OAAO;CACT;CAEA,OAAO;EACL,MAAM,IAAO,KAAa;GACxB,MAAM,QAAQ,KAAK,GAAG;GACtB,IAAI,UAAU,KAAA,GAAW,OAAO,KAAA;GAEhC,QAAQ,OAAO,GAAG;GAClB,QAAQ,IAAI,KAAK,KAAK;GACtB,OAAO,KAAK,MAAM,MAAM,IAAI;EAC9B;EAEA,MAAM,IAAI,KAAK,OAAO,YAAY,YAAY;GAC5C,MAAM,MAAM,KAAK,IAAI,YAAY,QAAQ,iBAAiB,UAAU;GACpE,IAAI,EAAE,MAAM,IAAI;GAChB,MAAM,OAAO,KAAK,UAAU,KAAK;GACjC,IAAI,SAAS,KAAA,GAAW;GACxB,QAAQ,OAAO,GAAG;GAClB,QAAQ,IAAI,KAAK;IAAE;IAAM,WAAW,IAAI,IAAI,MAAM;IAAM,MAAM,YAAY,QAAQ,CAAC;GAAE,CAAC;GACtF,OAAO,QAAQ,OAAO,YAAY;IAChC,MAAM,SAAS,QAAQ,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;IACrC,QAAQ,OAAO,MAAM;GACvB;EACF;EAEA,MAAM,OAAO,MAAM;GACjB,KAAK,MAAM,OAAO,MAAM,QAAQ,OAAO,GAAG;EAC5C;EAEA,MAAM,UAAU,KAAK;GACnB,KAAK,MAAM,CAAC,KAAK,UAAU,SACzB,IAAI,MAAM,KAAK,SAAS,GAAG,GAAG,QAAQ,OAAO,GAAG;EAEpD;CACF;AACF"}

package/dist/next/cache/next-data.d.mts

@@ -0,0 +1,6 @@
+import { BookingCacheAdapter } from "../options.mjs";
+import "server-only";
+//#region src/next/cache/next-data.d.ts
+export declare function nextDataCacheAdapter(): BookingCacheAdapter;
+//#endregion
+//# sourceMappingURL=next-data.d.mts.map

package/dist/next/cache/next-data.mjs

@@ -0,0 +1,35 @@
+import "server-only";
+import { after } from "next/server";
+import { revalidateTag, unstable_cache } from "next/cache";
+//#region src/next/cache/next-data.ts
+function nextDataCacheAdapter() {
+	return {
+		async get() {},
+		async put() {},
+		async delete() {},
+		load(keyParts, args, fill, options) {
+			return unstable_cache(async () => fill(), [...keyParts], {
+				revalidate: options.ttlSeconds,
+				tags: [...options.tags]
+			})(...args);
+		},
+		/** Synchronous under the promise, so a throw reaches the caller's `try`. */
+		expireTag(tag) {
+			revalidateTag(tag, { expire: 0 });
+			return Promise.resolve();
+		},
+		/** `after()`, inside a request; outside one there is nothing to hand to. */
+		defer(work) {
+			try {
+				after(() => work);
+				return true;
+			} catch {
+				return false;
+			}
+		}
+	};
+}
+//#endregion
+export { nextDataCacheAdapter };
+
+//# sourceMappingURL=next-data.mjs.map

package/dist/next/cache/next-data.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-data.mjs","names":[],"sources":["../../../src/next/cache/next-data.ts"],"sourcesContent":["/**\n * `@medalsocial/booking/next/cache/next-data` — Next's data cache.\n *\n * `unstable_cache` for the reads and `revalidateTag` for the expiry: the data\n * cache a Next deployment already has (on OpenNext, R2 plus the Durable Object\n * tag cache; on Vercel, its own). Use it for `cache.data`.\n *\n * READ-THROUGH ONLY. Next's data cache wraps a function; it has no `get` or\n * `put` by key and no per-key delete. So this adapter does everything through\n * `load` (keys are the key parts plus the call's arguments, exactly as\n * `unstable_cache` forms them) and `expireTag`; its `get` is always a miss and\n * `put`/`delete` do nothing. As `cache.edge` it would therefore cache nothing —\n * pair it with the `workers` or `memory` adapter there.\n */\n\nimport 'server-only';\n\nimport { revalidateTag, unstable_cache } from 'next/cache';\nimport { after } from 'next/server';\nimport type { BookingCacheAdapter } from '../options';\n\nexport function nextDataCacheAdapter(): BookingCacheAdapter {\n  return {\n    async get() {\n      return undefined;\n    },\n    async put() {},\n    async delete() {},\n\n    load(keyParts, args, fill, options) {\n      // One wrapper per call: the tags can name the call's own service, and\n      // the callback's text is part of Next's key, so it is the same text for\n      // every call.\n      const loader = unstable_cache(async () => fill(), [...keyParts], {\n        revalidate: options.ttlSeconds,\n        tags: [...options.tags],\n      });\n      return (loader as (...callArgs: unknown[]) => Promise<Awaited<ReturnType<typeof fill>>>)(\n        ...args\n      );\n    },\n\n    /** Synchronous under the promise, so a throw reaches the caller's `try`. */\n    expireTag(tag) {\n      revalidateTag(tag, { expire: 0 });\n      return Promise.resolve();\n    },\n\n    /** `after()`, inside a request; outside one there is nothing to hand to. */\n    defer(work) {\n      try {\n        after(() => work);\n        return true;\n      } catch {\n        return false;\n      }\n    },\n  };\n}\n"],"mappings":";;;;AAqBA,SAAgB,uBAA4C;CAC1D,OAAO;EACL,MAAM,MAAM,CAEZ;EACA,MAAM,MAAM,CAAC;EACb,MAAM,SAAS,CAAC;EAEhB,KAAK,UAAU,MAAM,MAAM,SAAS;GAQlC,OAJe,eAAe,YAAY,KAAK,GAAG,CAAC,GAAG,QAAQ,GAAG;IAC/D,YAAY,QAAQ;IACpB,MAAM,CAAC,GAAG,QAAQ,IAAI;GACxB,CACa,CAAC,CACZ,GAAG,IACL;EACF;;EAGA,UAAU,KAAK;GACb,cAAc,KAAK,EAAE,QAAQ,EAAE,CAAC;GAChC,OAAO,QAAQ,QAAQ;EACzB;;EAGA,MAAM,MAAM;GACV,IAAI;IACF,YAAY,IAAI;IAChB,OAAO;GACT,QAAQ;IACN,OAAO;GACT;EACF;CACF;AACF"}

package/dist/next/cache/noop.d.mts

@@ -0,0 +1,6 @@
+import { BookingCacheAdapter } from "../options.mjs";
+import "server-only";
+//#region src/next/cache/noop.d.ts
+export declare function noopCacheAdapter(): BookingCacheAdapter;
+//#endregion
+//# sourceMappingURL=noop.d.mts.map

package/dist/next/cache/noop.mjs

@@ -0,0 +1,15 @@
+import "server-only";
+//#region src/next/cache/noop.ts
+function noopCacheAdapter() {
+	return {
+		async get() {},
+		async put() {},
+		async delete() {},
+		async expireTag() {},
+		key: () => null
+	};
+}
+//#endregion
+export { noopCacheAdapter };
+
+//# sourceMappingURL=noop.mjs.map

package/dist/next/cache/noop.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop.mjs","names":[],"sources":["../../../src/next/cache/noop.ts"],"sourcesContent":["/**\n * `@medalsocial/booking/next/cache/noop` — a cache that never holds anything.\n *\n * Every read is a miss and every write is dropped, and its `key()` answers\n * `null`, so the booking seed takes its «no cache here» path (`bypass`) and\n * reads Medal through the data cache. For tests, draft mode, and a site that\n * wants every request live.\n */\n\nimport 'server-only';\n\nimport type { BookingCacheAdapter } from '../options';\n\nexport function noopCacheAdapter(): BookingCacheAdapter {\n  return {\n    async get() {\n      return undefined;\n    },\n    async put() {},\n    async delete() {},\n    async expireTag() {},\n    key: () => null,\n  };\n}\n"],"mappings":";;AAaA,SAAgB,mBAAwC;CACtD,OAAO;EACL,MAAM,MAAM,CAEZ;EACA,MAAM,MAAM,CAAC;EACb,MAAM,SAAS,CAAC;EAChB,MAAM,YAAY,CAAC;EACnB,WAAW;CACb;AACF"}

package/dist/next/cache/workers.d.mts

@@ -0,0 +1,29 @@
+import { BookingCacheAdapter } from "../options.mjs";
+import "server-only";
+//#region src/next/cache/workers.d.ts
+/** The slice of the Worker context this adapter reads. */
+export interface WorkerContext {
+  ctx?: {
+    waitUntil?: (promise: Promise<unknown>) => void;
+  };
+  env?: Record<string, unknown>;
+}
+/** A value, or a function that reads it when it is needed. */
+type Lazy<T> = T | (() => T);
+export interface WorkersCacheAdapterOptions {
+  /** The site's own origin (`https://example.com`). Without one nothing is cached. */
+  origin: Lazy<string | undefined>;
+  /** The deployed version for keys. Default: `env.CF_VERSION_METADATA.id`. */
+  version?: Lazy<string | undefined>;
+  /**
+   * The Worker context for this request. Default: the one OpenNext publishes
+   * on `globalThis` (what its `getCloudflareContext()` returns). Pass
+   * `() => getCloudflareContext()` to be explicit.
+   */
+  context?: () => WorkerContext | undefined;
+  /** The cache. Default `caches.default`. */
+  cache?: () => Cache | undefined;
+}
+export declare function workersCacheAdapter(options: WorkersCacheAdapterOptions): BookingCacheAdapter;
+//#endregion
+//# sourceMappingURL=workers.d.mts.map

package/dist/next/cache/workers.mjs

@@ -0,0 +1,74 @@
+import "server-only";
+//#region src/next/cache/workers.ts
+/** Where `@opennextjs/cloudflare` keeps the request's `{ env, ctx, cf }`. */
+const OPENNEXT_CONTEXT = Symbol.for("__cloudflare-context__");
+function defaultContext() {
+	return globalThis[OPENNEXT_CONTEXT];
+}
+function defaultCache() {
+	return globalThis.caches?.default;
+}
+function read(value) {
+	return typeof value === "function" ? value() : value;
+}
+function workersCacheAdapter(options) {
+	const cacheOf = options.cache ?? defaultCache;
+	function context() {
+		try {
+			return (options.context ?? defaultContext)();
+		} catch {
+			return;
+		}
+	}
+	function originOf() {
+		const origin = read(options.origin);
+		if (!origin) return null;
+		try {
+			return new URL(origin).origin;
+		} catch {
+			return null;
+		}
+	}
+	/** The cache, or a refusal: every operation goes through here. */
+	function cache() {
+		const found = cacheOf();
+		if (!found) throw new Error("The Workers Cache API is not available here");
+		return found;
+	}
+	return {
+		key(key) {
+			if (!cacheOf()) return null;
+			const origin = originOf();
+			return origin === null ? null : `${origin}${key}`;
+		},
+		version() {
+			if (options.version !== void 0) return read(options.version) || void 0;
+			const metadata = context()?.env?.CF_VERSION_METADATA;
+			return typeof metadata?.id === "string" && metadata.id !== "" ? metadata.id : void 0;
+		},
+		async get(key) {
+			const hit = await cache().match(key);
+			return hit ? await hit.json() : void 0;
+		},
+		async put(key, value, ttlSeconds) {
+			await cache().put(key, new Response(JSON.stringify(value), { headers: {
+				"Content-Type": "application/json",
+				"Cache-Control": `public, max-age=${ttlSeconds}`
+			} }));
+		},
+		async delete(keys) {
+			const found = cache();
+			await Promise.all(keys.map((key) => found.delete(key)));
+		},
+		defer(work) {
+			const ctx = context()?.ctx;
+			if (typeof ctx?.waitUntil !== "function") return false;
+			ctx.waitUntil(work);
+			return true;
+		}
+	};
+}
+//#endregion
+export { workersCacheAdapter };
+
+//# sourceMappingURL=workers.mjs.map

package/dist/next/cache/workers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers.mjs","names":[],"sources":["../../../src/next/cache/workers.ts"],"sourcesContent":["/**\n * `@medalsocial/booking/next/cache/workers` — the Cloudflare Workers Cache API.\n *\n * `caches.default`: per colo, a few milliseconds to read, no global purge —\n * changing the key is the purge. Use it for `cache.edge` on Workers (OpenNext).\n *\n * KEYS are `<origin><package key>`, so with the package's edge keys:\n * `<origin>/__medal-edge/booking-seed/v1/<env>[-<version>]/…`. On the site's\n * own origin because Cache API entries belong to the zone, and with the\n * deployed version in the path (from the `CF_VERSION_METADATA` binding unless\n * `version` is passed) so a deploy starts cold instead of reading entries an\n * older build wrote.\n *\n * `defer` hands work to the Worker's `ctx.waitUntil`, which keeps the isolate\n * alive for it after the response has gone; a floating promise on Workers is\n * cancelled when the response goes out.\n *\n * Off Workers (no `caches.default`, `next dev`, `next start`) and with no\n * origin configured, `key()` answers `null` and the package reads live, the\n * way it would with the `noop` adapter.\n */\n\nimport 'server-only';\n\nimport type { BookingCacheAdapter } from '../options';\n\n/** The slice of the Worker context this adapter reads. */\nexport interface WorkerContext {\n  ctx?: { waitUntil?: (promise: Promise<unknown>) => void };\n  env?: Record<string, unknown>;\n}\n\n/** A value, or a function that reads it when it is needed. */\ntype Lazy<T> = T | (() => T);\n\nexport interface WorkersCacheAdapterOptions {\n  /** The site's own origin (`https://example.com`). Without one nothing is cached. */\n  origin: Lazy<string | undefined>;\n  /** The deployed version for keys. Default: `env.CF_VERSION_METADATA.id`. */\n  version?: Lazy<string | undefined>;\n  /**\n   * The Worker context for this request. Default: the one OpenNext publishes\n   * on `globalThis` (what its `getCloudflareContext()` returns). Pass\n   * `() => getCloudflareContext()` to be explicit.\n   */\n  context?: () => WorkerContext | undefined;\n  /** The cache. Default `caches.default`. */\n  cache?: () => Cache | undefined;\n}\n\n/** Where `@opennextjs/cloudflare` keeps the request's `{ env, ctx, cf }`. */\nconst OPENNEXT_CONTEXT = Symbol.for('__cloudflare-context__');\n\nfunction defaultContext(): WorkerContext | undefined {\n  return (globalThis as Record<symbol, WorkerContext | undefined>)[OPENNEXT_CONTEXT];\n}\n\nfunction defaultCache(): Cache | undefined {\n  const storage = (globalThis as { caches?: CacheStorage & { default?: Cache } }).caches;\n  return storage?.default;\n}\n\nfunction read<T>(value: Lazy<T>): T {\n  return typeof value === 'function' ? (value as () => T)() : value;\n}\n\nexport function workersCacheAdapter(options: WorkersCacheAdapterOptions): BookingCacheAdapter {\n  const cacheOf = options.cache ?? defaultCache;\n\n  function context(): WorkerContext | undefined {\n    try {\n      return (options.context ?? defaultContext)();\n    } catch {\n      // Not on Workers, or outside a request.\n      return undefined;\n    }\n  }\n\n  function originOf(): string | null {\n    const origin = read(options.origin);\n    if (!origin) return null;\n    try {\n      return new URL(origin).origin;\n    } catch {\n      return null;\n    }\n  }\n\n  /** The cache, or a refusal: every operation goes through here. */\n  function cache(): Cache {\n    const found = cacheOf();\n    if (!found) throw new Error('The Workers Cache API is not available here');\n    return found;\n  }\n\n  return {\n    key(key) {\n      if (!cacheOf()) return null;\n      const origin = originOf();\n      return origin === null ? null : `${origin}${key}`;\n    },\n\n    version() {\n      if (options.version !== undefined) return read(options.version) || undefined;\n      const metadata = context()?.env?.CF_VERSION_METADATA as { id?: unknown } | undefined;\n      return typeof metadata?.id === 'string' && metadata.id !== '' ? metadata.id : undefined;\n    },\n\n    async get<T>(key: string) {\n      const hit = await cache().match(key);\n      return hit ? ((await hit.json()) as T) : undefined;\n    },\n\n    async put(key, value, ttlSeconds) {\n      await cache().put(\n        key,\n        new Response(JSON.stringify(value), {\n          headers: {\n            'Content-Type': 'application/json',\n            'Cache-Control': `public, max-age=${ttlSeconds}`,\n          },\n        })\n      );\n    },\n\n    async delete(keys) {\n      const found = cache();\n      await Promise.all(keys.map((key) => found.delete(key)));\n    },\n\n    defer(work) {\n      const ctx = context()?.ctx;\n      if (typeof ctx?.waitUntil !== 'function') return false;\n      ctx.waitUntil(work);\n      return true;\n    },\n  };\n}\n"],"mappings":";;;AAmDA,MAAM,mBAAmB,OAAO,IAAI,wBAAwB;AAE5D,SAAS,iBAA4C;CACnD,OAAQ,WAAyD;AACnE;AAEA,SAAS,eAAkC;CAEzC,OADiB,WAA+D,QAChE;AAClB;AAEA,SAAS,KAAQ,OAAmB;CAClC,OAAO,OAAO,UAAU,aAAc,MAAkB,IAAI;AAC9D;AAEA,SAAgB,oBAAoB,SAA0D;CAC5F,MAAM,UAAU,QAAQ,SAAS;CAEjC,SAAS,UAAqC;EAC5C,IAAI;GACF,QAAQ,QAAQ,WAAW,eAAA,CAAgB;EAC7C,QAAQ;GAEN;EACF;CACF;CAEA,SAAS,WAA0B;EACjC,MAAM,SAAS,KAAK,QAAQ,MAAM;EAClC,IAAI,CAAC,QAAQ,OAAO;EACpB,IAAI;GACF,OAAO,IAAI,IAAI,MAAM,CAAC,CAAC;EACzB,QAAQ;GACN,OAAO;EACT;CACF;;CAGA,SAAS,QAAe;EACtB,MAAM,QAAQ,QAAQ;EACtB,IAAI,CAAC,OAAO,MAAM,IAAI,MAAM,6CAA6C;EACzE,OAAO;CACT;CAEA,OAAO;EACL,IAAI,KAAK;GACP,IAAI,CAAC,QAAQ,GAAG,OAAO;GACvB,MAAM,SAAS,SAAS;GACxB,OAAO,WAAW,OAAO,OAAO,GAAG,SAAS;EAC9C;EAEA,UAAU;GACR,IAAI,QAAQ,YAAY,KAAA,GAAW,OAAO,KAAK,QAAQ,OAAO,KAAK,KAAA;GACnE,MAAM,WAAW,QAAQ,CAAC,EAAE,KAAK;GACjC,OAAO,OAAO,UAAU,OAAO,YAAY,SAAS,OAAO,KAAK,SAAS,KAAK,KAAA;EAChF;EAEA,MAAM,IAAO,KAAa;GACxB,MAAM,MAAM,MAAM,MAAM,CAAC,CAAC,MAAM,GAAG;GACnC,OAAO,MAAQ,MAAM,IAAI,KAAK,IAAW,KAAA;EAC3C;EAEA,MAAM,IAAI,KAAK,OAAO,YAAY;GAChC,MAAM,MAAM,CAAC,CAAC,IACZ,KACA,IAAI,SAAS,KAAK,UAAU,KAAK,GAAG,EAClC,SAAS;IACP,gBAAgB;IAChB,iBAAiB,mBAAmB;GACtC,EACF,CAAC,CACH;EACF;EAEA,MAAM,OAAO,MAAM;GACjB,MAAM,QAAQ,MAAM;GACpB,MAAM,QAAQ,IAAI,KAAK,KAAK,QAAQ,MAAM,OAAO,GAAG,CAAC,CAAC;EACxD;EAEA,MAAM,MAAM;GACV,MAAM,MAAM,QAAQ,CAAC,EAAE;GACvB,IAAI,OAAO,KAAK,cAAc,YAAY,OAAO;GACjD,IAAI,UAAU,IAAI;GAClB,OAAO;EACT;CACF;AACF"}