@aglyn/plugins-commerce 1.0.0-beta.231 → 1.0.0-beta.233

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

@@ -31,6 +31,8 @@ export * from './commerce-gift-cards';
 export * from './commerce-orders';
 export * from './commerce-printers';
 export * from './commerce-pos';
+export * from './commerce-pos-offline';
+export * from './commerce-pos-kiosk';
 export * from './product-modifiers';
 export * from './commerce-promotions';
 export * from './commerce-receipt';
@@ -46,6 +48,8 @@ export * from './purchase-analytics';
 export * from './tracking-url';
 export * from './buyer-notifications';
 export * from './order-fulfillment';
+export * from './order-local-fulfillment';
+export * from './local-fulfillment-settings';
 export * from './order-events';
 export * from './commerce-returns';
 export * from './order-shipping-export';
@@ -54,3 +58,4 @@ export * from './order-webhooks';
 export * from './shipstation';
 export * from './commerce-payment-methods';
 export * from './product-channel';
+export * from './product-write';

package/src/lib/model/index.js

@@ -29,6 +29,8 @@ export * from "./commerce-gift-cards.js";
 export * from "./commerce-orders.js";
 export * from "./commerce-printers.js";
 export * from "./commerce-pos.js";
+export * from "./commerce-pos-offline.js";
+export * from "./commerce-pos-kiosk.js";
 export * from "./product-modifiers.js";
 export * from "./commerce-promotions.js";
 export * from "./commerce-receipt.js";
@@ -44,6 +46,8 @@ export * from "./purchase-analytics.js";
 export * from "./tracking-url.js";
 export * from "./buyer-notifications.js";
 export * from "./order-fulfillment.js";
+export * from "./order-local-fulfillment.js";
+export * from "./local-fulfillment-settings.js";
 export * from "./order-events.js";
 export * from "./commerce-returns.js";
 export * from "./order-shipping-export.js";
@@ -52,5 +56,6 @@ export * from "./order-webhooks.js";
 export * from "./shipstation.js";
 export * from "./commerce-payment-methods.js";
 export * from "./product-channel.js";
+export * from "./product-write.js";
 
 //# sourceMappingURL=index.js.map

package/src/lib/model/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/index.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 * Commerce domain model (AGL-411): pure types + logic relocated from the\n * core `@aglyn/aglyn` app-utils — the commerce plugin owns its domain.\n * Context-free and framework-free, so both the plugin's client components\n * and its `/server` handlers (and other plugins/apps via\n * `@aglyn/plugins-commerce/model`) can import it.\n */\nexport * from './commerce'\nexport * from './commerce-cart'\nexport * from './commerce-connect-transfer'\nexport * from './commerce-discounts'\nexport * from './commerce-dispute'\nexport * from './commerce-topics'\nexport * from './commerce-gift-cards'\nexport * from './commerce-orders'\nexport * from './commerce-printers'\nexport * from './commerce-pos'\nexport * from './product-modifiers'\nexport * from './commerce-promotions'\nexport * from './commerce-receipt'\nexport * from './commerce-reservations'\nexport * from './commerce-shipping'\nexport * from './commerce-stock-holds'\nexport * from './commerce-subscription-status'\nexport * from './commerce-tax'\nexport * from './commerce-tax-decision'\nexport * from './order-figures'\nexport * from './order-list-fields'\nexport * from './purchase-analytics'\nexport * from './tracking-url'\nexport * from './buyer-notifications'\nexport * from './order-fulfillment'\nexport * from './order-events'\nexport * from './commerce-returns'\nexport * from './order-shipping-export'\nexport * from './order-status-view'\nexport * from './order-webhooks'\nexport * from './shipstation'\nexport * from './commerce-payment-methods'\nexport * from './product-channel'\n"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;CAMC,GACD,cAAc,gBAAY;AAC1B,cAAc,qBAAiB;AAC/B,cAAc,iCAA6B;AAC3C,cAAc,0BAAsB;AACpC,cAAc,wBAAoB;AAClC,cAAc,uBAAmB;AACjC,cAAc,2BAAuB;AACrC,cAAc,uBAAmB;AACjC,cAAc,yBAAqB;AACnC,cAAc,oBAAgB;AAC9B,cAAc,yBAAqB;AACnC,cAAc,2BAAuB;AACrC,cAAc,wBAAoB;AAClC,cAAc,6BAAyB;AACvC,cAAc,yBAAqB;AACnC,cAAc,4BAAwB;AACtC,cAAc,oCAAgC;AAC9C,cAAc,oBAAgB;AAC9B,cAAc,6BAAyB;AACvC,cAAc,qBAAiB;AAC/B,cAAc,yBAAqB;AACnC,cAAc,0BAAsB;AACpC,cAAc,oBAAgB;AAC9B,cAAc,2BAAuB;AACrC,cAAc,yBAAqB;AACnC,cAAc,oBAAgB;AAC9B,cAAc,wBAAoB;AAClC,cAAc,6BAAyB;AACvC,cAAc,yBAAqB;AACnC,cAAc,sBAAkB;AAChC,cAAc,mBAAe;AAC7B,cAAc,gCAA4B;AAC1C,cAAc,uBAAmB"}
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/index.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 * Commerce domain model (AGL-411): pure types + logic relocated from the\n * core `@aglyn/aglyn` app-utils — the commerce plugin owns its domain.\n * Context-free and framework-free, so both the plugin's client components\n * and its `/server` handlers (and other plugins/apps via\n * `@aglyn/plugins-commerce/model`) can import it.\n */\nexport * from './commerce'\nexport * from './commerce-cart'\nexport * from './commerce-connect-transfer'\nexport * from './commerce-discounts'\nexport * from './commerce-dispute'\nexport * from './commerce-topics'\nexport * from './commerce-gift-cards'\nexport * from './commerce-orders'\nexport * from './commerce-printers'\nexport * from './commerce-pos'\nexport * from './commerce-pos-offline'\nexport * from './commerce-pos-kiosk'\nexport * from './product-modifiers'\nexport * from './commerce-promotions'\nexport * from './commerce-receipt'\nexport * from './commerce-reservations'\nexport * from './commerce-shipping'\nexport * from './commerce-stock-holds'\nexport * from './commerce-subscription-status'\nexport * from './commerce-tax'\nexport * from './commerce-tax-decision'\nexport * from './order-figures'\nexport * from './order-list-fields'\nexport * from './purchase-analytics'\nexport * from './tracking-url'\nexport * from './buyer-notifications'\nexport * from './order-fulfillment'\nexport * from './order-local-fulfillment'\nexport * from './local-fulfillment-settings'\nexport * from './order-events'\nexport * from './commerce-returns'\nexport * from './order-shipping-export'\nexport * from './order-status-view'\nexport * from './order-webhooks'\nexport * from './shipstation'\nexport * from './commerce-payment-methods'\nexport * from './product-channel'\nexport * from './product-write'\n"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;CAMC,GACD,cAAc,gBAAY;AAC1B,cAAc,qBAAiB;AAC/B,cAAc,iCAA6B;AAC3C,cAAc,0BAAsB;AACpC,cAAc,wBAAoB;AAClC,cAAc,uBAAmB;AACjC,cAAc,2BAAuB;AACrC,cAAc,uBAAmB;AACjC,cAAc,yBAAqB;AACnC,cAAc,oBAAgB;AAC9B,cAAc,4BAAwB;AACtC,cAAc,0BAAsB;AACpC,cAAc,yBAAqB;AACnC,cAAc,2BAAuB;AACrC,cAAc,wBAAoB;AAClC,cAAc,6BAAyB;AACvC,cAAc,yBAAqB;AACnC,cAAc,4BAAwB;AACtC,cAAc,oCAAgC;AAC9C,cAAc,oBAAgB;AAC9B,cAAc,6BAAyB;AACvC,cAAc,qBAAiB;AAC/B,cAAc,yBAAqB;AACnC,cAAc,0BAAsB;AACpC,cAAc,oBAAgB;AAC9B,cAAc,2BAAuB;AACrC,cAAc,yBAAqB;AACnC,cAAc,+BAA2B;AACzC,cAAc,kCAA8B;AAC5C,cAAc,oBAAgB;AAC9B,cAAc,wBAAoB;AAClC,cAAc,6BAAyB;AACvC,cAAc,yBAAqB;AACnC,cAAc,sBAAkB;AAChC,cAAc,mBAAe;AAC7B,cAAc,gCAA4B;AAC1C,cAAc,uBAAmB;AACjC,cAAc,qBAAiB"}

package/src/lib/model/local-fulfillment-settings.d.ts

@@ -0,0 +1,178 @@
+/**
+ * @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 OpeningHoursRow } from '@aglyn/aglyn/app-utils/local-business';
+import type { InventoryLocation, PostalAddress } from './commerce';
+import type { PickupLocationSettings } from './order-local-fulfillment';
+/**
+ * Buy online, pick up in store, and the store's own local delivery (AGL-3624):
+ * what a merchant configures, and the pure decisions checkout takes from it.
+ *
+ * PICKUP is per location. A location of `hosts/{hostId}/locations` (AGL-286,
+ * the same stock buckets the register sells from) offers pickup when its
+ * `pickup.enabled` is on, with its own hours and arrival instructions. The
+ * buyer picks one at the cart; the order is routed there and its stock comes
+ * off that location's bucket.
+ *
+ * LOCAL DELIVERY is per store, on `settings/store.localDelivery`: zones
+ * matched by postal code (no outside service needed) or by distance from the
+ * store (only where the store's address check returns map coordinates — see
+ * `server/local-fulfillment.ts`), each with a fee, an order minimum and a
+ * free-over threshold, and delivery windows written in the same
+ * `Mo-Fr 09:00-12:00` syntax as a business's opening hours.
+ */
+/** A pickup location as the cart and the order show it. Public facts only. */
+export interface PickupLocationOption {
+    id: string;
+    name: string;
+    address?: string;
+    hours?: string;
+    instructions?: string;
+    readyWithinMinutes?: number;
+}
+export declare const PICKUP_INSTRUCTIONS_MAX = 400;
+export declare const PICKUP_HOURS_MAX = 600;
+export declare const PICKUP_LOCATIONS_MAX = 25;
+/** A stored pickup block made safe; never throws. */
+export declare function normalizePickupSettings(value: unknown): PickupLocationSettings;
+/** A postal address on one line, or the location's free-text address. */
+export declare function formatPostalAddressLine(address?: PostalAddress | null, fallback?: string | null): string;
+/**
+ * The locations a buyer may pick up from, default location first, then by
+ * name. A location without pickup switched on is never offered, however
+ * complete the rest of it is.
+ */
+export declare function pickupLocationOptions(locations: ReadonlyArray<(InventoryLocation & {
+    id: string;
+}) | null | undefined>): PickupLocationOption[];
+/** "Usually ready in 2 hours" from a preparation time, or `''`. */
+export declare function pickupReadyWithinLabel(minutes: number | undefined): string;
+export interface LocalDeliveryCoordinates {
+    lat: number;
+    lng: number;
+}
+export interface LocalDeliveryZone {
+    id: string;
+    name: string;
+    /**
+     * `postcode` matches the buyer's postal code against `postcodes`;
+     * `radius` measures the distance from the store's `origin`.
+     */
+    kind: 'postcode' | 'radius';
+    /**
+     * Codes this zone delivers to: `10001` exactly, `100*` by prefix, or
+     * `10001-10099` as a numeric range.
+     */
+    postcodes?: string[];
+    /** Kilometers from the store's origin, for a `radius` zone. */
+    radiusKm?: number;
+    /** The delivery fee, in cents. */
+    feeCents: number;
+    /** The smallest order (items, in cents) this zone delivers. */
+    minimumCents?: number;
+    /** Items total (cents) at or above which delivery is free. */
+    freeOverCents?: number;
+}
+/** `settings/store.localDelivery`. */
+export interface LocalDeliverySettings {
+    enabled?: boolean;
+    /** The one country delivered within, ISO-3166 alpha-2. */
+    country?: string;
+    /** The location orders leave from, and whose stock they take. */
+    locationId?: string;
+    /** Where radius zones measure from, as the store's address check placed it. */
+    origin?: LocalDeliveryCoordinates;
+    zones?: LocalDeliveryZone[];
+    /** Delivery windows, one line per set of days: `Mo-Fr 09:00-12:00`. */
+    windows?: string;
+    /** How long before a window opens an order must be placed, in minutes. */
+    leadTimeMinutes?: number;
+    /** How many days ahead a window can be booked. */
+    daysAhead?: number;
+    /** What the buyer is told about delivery: "We call when we're 10 minutes away". */
+    instructions?: string;
+}
+export declare const LOCAL_DELIVERY_ZONES_MAX = 20;
+export declare const LOCAL_DELIVERY_POSTCODES_MAX = 200;
+export declare const LOCAL_DELIVERY_DEFAULT_LEAD_MINUTES = 120;
+export declare const LOCAL_DELIVERY_DEFAULT_DAYS_AHEAD = 7;
+export declare const LOCAL_DELIVERY_MAX_DAYS_AHEAD = 30;
+/** A cart offers at most this many windows; the earliest are kept. */
+export declare const LOCAL_DELIVERY_WINDOWS_OFFERED_MAX = 40;
+export declare const LOCAL_DELIVERY_RADIUS_MAX_KM = 200;
+/**
+ * One postal code as zones compare it: upper-cased with spaces removed, and a
+ * US ZIP+4 cut to its five digits so `10001-1234` is in the `10001` zone.
+ */
+export declare function normalizePostcode(value: unknown, country?: string): string;
+/** Whether a postal code is one a zone entry names. */
+export declare function postcodePatternMatches(pattern: string, postcode: string): boolean;
+/** The stored settings made safe; never throws. */
+export declare function normalizeLocalDeliverySettings(value: unknown): LocalDeliverySettings;
+/** Great-circle distance in kilometers (haversine). */
+export declare function distanceKm(a: LocalDeliveryCoordinates, b: LocalDeliveryCoordinates): number;
+/** Whether any zone measures distance, so checkout needs the full address placed on a map. */
+export declare function localDeliveryHasRadiusZones(settings: LocalDeliverySettings | undefined): boolean;
+/**
+ * The zone a destination falls in, or `null`. Postal-code zones are asked
+ * first, in the order the store listed them, so a store can carve a cheaper
+ * neighbourhood out of a wider one by listing it above. Radius zones answer
+ * only with both ends on a map — the store's origin and the destination's
+ * coordinates — and the tightest radius that reaches wins.
+ */
+export declare function matchLocalDeliveryZone(settings: LocalDeliverySettings | undefined, destination: {
+    country?: string;
+    postalCode?: string;
+    coordinates?: LocalDeliveryCoordinates | null;
+}): LocalDeliveryZone | null;
+/** What a zone charges for an order of `itemsCents`. */
+export declare function localDeliveryFeeCents(zone: LocalDeliveryZone, itemsCents: number): number;
+/** How far an order of `itemsCents` is below the zone's minimum; 0 when it meets it. */
+export declare function localDeliveryMinimumShortfall(zone: LocalDeliveryZone, itemsCents: number): number;
+/** One bookable delivery window. `id` is its start instant, which is what the buyer sends back. */
+export interface LocalDeliveryWindow {
+    id: string;
+    startMs: number;
+    endMs: number;
+}
+/** The windows rows a store's settings parse to. Lines that do not read are dropped. */
+export declare function localDeliveryWindowRows(settings: LocalDeliverySettings | undefined): OpeningHoursRow[];
+/**
+ * The windows a buyer may book now, soonest first: every row on every day
+ * from today to `daysAhead`, in the store's time zone, that opens at least
+ * the lead time from now. Pure in `nowMs`, so a spec can stand at any hour.
+ */
+export declare function upcomingLocalDeliveryWindows(settings: LocalDeliverySettings | undefined, context: {
+    nowMs: number;
+    timeZone: string;
+}): LocalDeliveryWindow[];
+/** The bookable window starting at `startMs`, or `null` when no such window is open now. */
+export declare function findLocalDeliveryWindow(settings: LocalDeliverySettings | undefined, startMs: unknown, context: {
+    nowMs: number;
+    timeZone: string;
+}): LocalDeliveryWindow | null;
+/** Whether checkout can offer local delivery at all. */
+export declare function localDeliveryOffered(settings: LocalDeliverySettings | undefined): boolean;
+/**
+ * What stops saved settings from offering delivery, in the console's words.
+ * Empty when checkout will offer it (or when it is switched off).
+ */
+export declare function localDeliveryProblems(settings: LocalDeliverySettings | undefined): string[];
+/** "Tue, Oct 14, 9:00 AM – 12:00 PM" in the store's zone. */
+export declare function formatLocalDeliveryWindow(window: {
+    startMs: number;
+    endMs: number;
+}, timeZone: string): string;

package/src/lib/model/local-fulfillment-settings.js

@@ -0,0 +1,361 @@
+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 { parseOpeningHours } from "@aglyn/aglyn/app-utils/local-business";
+import { zonedDateTime, zonedWallTimeToInstant } from "@aglyn/shared-util-timestamp/zoned-time";
+export const PICKUP_INSTRUCTIONS_MAX = 400;
+export const PICKUP_HOURS_MAX = 600;
+export const PICKUP_LOCATIONS_MAX = 25;
+const text = (value, max)=>typeof value === 'string' ? value.trim().slice(0, max) : '';
+const wholeMinutes = (value, max)=>{
+    const minutes = Math.round(Number(value));
+    return Number.isFinite(minutes) && minutes > 0 ? Math.min(minutes, max) : undefined;
+};
+/** A stored pickup block made safe; never throws. */ export function normalizePickupSettings(value) {
+    if (!value || typeof value !== 'object') return {};
+    const raw = value;
+    const settings = {};
+    if (raw['enabled'] === true) settings.enabled = true;
+    const hours = text(raw['hours'], PICKUP_HOURS_MAX);
+    if (hours) settings.hours = hours;
+    const instructions = text(raw['instructions'], PICKUP_INSTRUCTIONS_MAX);
+    if (instructions) settings.instructions = instructions;
+    const ready = wholeMinutes(raw['readyWithinMinutes'], 14 * 24 * 60);
+    if (ready) settings.readyWithinMinutes = ready;
+    return settings;
+}
+/** A postal address on one line, or the location's free-text address. */ export function formatPostalAddressLine(address, fallback) {
+    const parts = [
+        address == null ? void 0 : address.line1,
+        address == null ? void 0 : address.line2,
+        [
+            address == null ? void 0 : address.city,
+            address == null ? void 0 : address.state
+        ].filter(Boolean).join(', '),
+        address == null ? void 0 : address.postalCode
+    ].map((part)=>String(part != null ? part : '').trim()).filter(Boolean);
+    return parts.length ? parts.join(', ') : String(fallback != null ? fallback : '').trim();
+}
+/**
+ * The locations a buyer may pick up from, default location first, then by
+ * name. A location without pickup switched on is never offered, however
+ * complete the rest of it is.
+ */ export function pickupLocationOptions(locations) {
+    return locations.filter((location)=>Boolean((location == null ? void 0 : location.id) && normalizePickupSettings(location.pickup).enabled)).sort((a, b)=>{
+        var _a_name, _b_name;
+        return Number(Boolean(b.isDefault)) - Number(Boolean(a.isDefault)) || String((_a_name = a.name) != null ? _a_name : '').localeCompare(String((_b_name = b.name) != null ? _b_name : ''));
+    }).slice(0, PICKUP_LOCATIONS_MAX).map((location)=>{
+        const pickup = normalizePickupSettings(location.pickup);
+        const address = formatPostalAddressLine(location.postalAddress, location.address);
+        return _extends({
+            id: location.id,
+            name: String(location.name || 'Store').slice(0, 80)
+        }, address ? {
+            address
+        } : {}, pickup.hours ? {
+            hours: pickup.hours
+        } : {}, pickup.instructions ? {
+            instructions: pickup.instructions
+        } : {}, pickup.readyWithinMinutes ? {
+            readyWithinMinutes: pickup.readyWithinMinutes
+        } : {});
+    });
+}
+/** "Usually ready in 2 hours" from a preparation time, or `''`. */ export function pickupReadyWithinLabel(minutes) {
+    if (!minutes || minutes <= 0) return '';
+    if (minutes < 60) return `Usually ready in ${minutes} minutes`;
+    const hours = Math.round(minutes / 60);
+    if (hours < 48) return `Usually ready in ${hours} hour${hours === 1 ? '' : 's'}`;
+    const days = Math.round(hours / 24);
+    return `Usually ready in ${days} days`;
+}
+export const LOCAL_DELIVERY_ZONES_MAX = 20;
+export const LOCAL_DELIVERY_POSTCODES_MAX = 200;
+export const LOCAL_DELIVERY_DEFAULT_LEAD_MINUTES = 120;
+export const LOCAL_DELIVERY_DEFAULT_DAYS_AHEAD = 7;
+export const LOCAL_DELIVERY_MAX_DAYS_AHEAD = 30;
+/** A cart offers at most this many windows; the earliest are kept. */ export const LOCAL_DELIVERY_WINDOWS_OFFERED_MAX = 40;
+export const LOCAL_DELIVERY_RADIUS_MAX_KM = 200;
+const wholeCents = (value)=>{
+    const cents = Math.round(Number(value != null ? value : 0));
+    return Number.isFinite(cents) && cents > 0 ? cents : 0;
+};
+const coordinates = (value)=>{
+    if (!value || typeof value !== 'object') return undefined;
+    const lat = Number(value['lat']);
+    const lng = Number(value['lng']);
+    if (!Number.isFinite(lat) || !Number.isFinite(lng)) return undefined;
+    if (Math.abs(lat) > 90 || Math.abs(lng) > 180) return undefined;
+    return {
+        lat,
+        lng
+    };
+};
+/**
+ * One postal code as zones compare it: upper-cased with spaces removed, and a
+ * US ZIP+4 cut to its five digits so `10001-1234` is in the `10001` zone.
+ */ export function normalizePostcode(value, country) {
+    const code = String(value != null ? value : '').toUpperCase().replace(/\s+/g, '').slice(0, 16);
+    if (String(country != null ? country : '').toUpperCase() === 'US') {
+        const zip = /^(\d{5})(?:-?\d{4})?$/.exec(code);
+        if (zip) return zip[1];
+    }
+    return code;
+}
+/** One zone entry as the console saves it: trimmed, upper-cased, spaces gone. */ function normalizePostcodePattern(value) {
+    return String(value != null ? value : '').toUpperCase().replace(/\s+/g, '').slice(0, 24);
+}
+/** Whether a postal code is one a zone entry names. */ export function postcodePatternMatches(pattern, postcode) {
+    const entry = normalizePostcodePattern(pattern);
+    const code = String(postcode != null ? postcode : '').toUpperCase().replace(/\s+/g, '');
+    if (!entry || !code) return false;
+    if (entry.endsWith('*')) {
+        const prefix = entry.slice(0, -1);
+        return prefix.length > 0 && code.startsWith(prefix);
+    }
+    const range = /^(\d+)-(\d+)$/.exec(entry);
+    if (range && range[1].length === range[2].length && /^\d+$/.test(code)) {
+        if (code.length !== range[1].length) return false;
+        const value = Number(code);
+        const low = Math.min(Number(range[1]), Number(range[2]));
+        const high = Math.max(Number(range[1]), Number(range[2]));
+        return value >= low && value <= high;
+    }
+    return entry === code;
+}
+/** A stored zone made safe, or `null` when it cannot deliver anywhere. */ function normalizeZone(value) {
+    if (!value || typeof value !== 'object') return null;
+    const raw = value;
+    const id = text(raw['id'], 60);
+    if (!id) return null;
+    const kind = raw['kind'] === 'radius' ? 'radius' : 'postcode';
+    const zone = {
+        id,
+        name: text(raw['name'], 80) || 'Local delivery',
+        kind,
+        feeCents: wholeCents(raw['feeCents'])
+    };
+    if (kind === 'postcode') {
+        const codes = Array.isArray(raw['postcodes']) ? raw['postcodes'] : [];
+        zone.postcodes = [
+            ...new Set(codes.map(normalizePostcodePattern).filter(Boolean))
+        ].slice(0, LOCAL_DELIVERY_POSTCODES_MAX);
+    } else {
+        const radius = Number(raw['radiusKm']);
+        zone.radiusKm = Number.isFinite(radius) && radius > 0 ? Math.min(Math.round(radius * 10) / 10, LOCAL_DELIVERY_RADIUS_MAX_KM) : 0;
+    }
+    const minimum = wholeCents(raw['minimumCents']);
+    if (minimum) zone.minimumCents = minimum;
+    const freeOver = wholeCents(raw['freeOverCents']);
+    if (freeOver) zone.freeOverCents = freeOver;
+    return zone;
+}
+/** The stored settings made safe; never throws. */ export function normalizeLocalDeliverySettings(value) {
+    var _raw_country;
+    if (!value || typeof value !== 'object') return {};
+    const raw = value;
+    const settings = {};
+    if (raw['enabled'] === true) settings.enabled = true;
+    const country = String((_raw_country = raw['country']) != null ? _raw_country : '').trim().toUpperCase();
+    if (/^[A-Z]{2}$/.test(country)) settings.country = country;
+    const locationId = text(raw['locationId'], 120);
+    if (locationId) settings.locationId = locationId;
+    const origin = coordinates(raw['origin']);
+    if (origin) settings.origin = origin;
+    const zones = (Array.isArray(raw['zones']) ? raw['zones'] : []).map(normalizeZone).filter((zone)=>Boolean(zone)).slice(0, LOCAL_DELIVERY_ZONES_MAX);
+    if (zones.length) settings.zones = zones;
+    const windows = text(raw['windows'], PICKUP_HOURS_MAX);
+    if (windows) settings.windows = windows;
+    const lead = Math.round(Number(raw['leadTimeMinutes']));
+    if (Number.isFinite(lead) && lead >= 0) settings.leadTimeMinutes = Math.min(lead, 14 * 24 * 60);
+    const days = Math.round(Number(raw['daysAhead']));
+    if (Number.isFinite(days) && days >= 1) settings.daysAhead = Math.min(days, LOCAL_DELIVERY_MAX_DAYS_AHEAD);
+    const instructions = text(raw['instructions'], PICKUP_INSTRUCTIONS_MAX);
+    if (instructions) settings.instructions = instructions;
+    return settings;
+}
+/** Great-circle distance in kilometers (haversine). */ export function distanceKm(a, b) {
+    const radians = (degrees)=>degrees * Math.PI / 180;
+    const dLat = radians(b.lat - a.lat);
+    const dLng = radians(b.lng - a.lng);
+    const h = Math.sin(dLat / 2) ** 2 + Math.cos(radians(a.lat)) * Math.cos(radians(b.lat)) * Math.sin(dLng / 2) ** 2;
+    return 2 * 6371 * Math.asin(Math.min(1, Math.sqrt(h)));
+}
+/** Whether any zone measures distance, so checkout needs the full address placed on a map. */ export function localDeliveryHasRadiusZones(settings) {
+    var _ref;
+    return Boolean(settings == null ? void 0 : settings.origin) && ((_ref = settings == null ? void 0 : settings.zones) != null ? _ref : []).some((zone)=>{
+        var _zone_radiusKm;
+        return zone.kind === 'radius' && ((_zone_radiusKm = zone.radiusKm) != null ? _zone_radiusKm : 0) > 0;
+    });
+}
+/**
+ * The zone a destination falls in, or `null`. Postal-code zones are asked
+ * first, in the order the store listed them, so a store can carve a cheaper
+ * neighbourhood out of a wider one by listing it above. Radius zones answer
+ * only with both ends on a map — the store's origin and the destination's
+ * coordinates — and the tightest radius that reaches wins.
+ */ export function matchLocalDeliveryZone(settings, destination) {
+    var _destination_country, _settings_zones, _zones_filter_sort_;
+    if (!(settings == null ? void 0 : settings.country)) return null;
+    const country = String((_destination_country = destination.country) != null ? _destination_country : settings.country).toUpperCase();
+    if (country !== settings.country) return null;
+    const postcode = normalizePostcode(destination.postalCode, settings.country);
+    const zones = (_settings_zones = settings.zones) != null ? _settings_zones : [];
+    if (postcode) {
+        for (const zone of zones){
+            var _zone_postcodes;
+            if (zone.kind !== 'postcode') continue;
+            if (((_zone_postcodes = zone.postcodes) != null ? _zone_postcodes : []).some((pattern)=>postcodePatternMatches(pattern, postcode))) return zone;
+        }
+    }
+    const at = destination.coordinates ? coordinates(destination.coordinates) : undefined;
+    if (!at || !settings.origin) return null;
+    const distance = distanceKm(settings.origin, at);
+    return (_zones_filter_sort_ = zones.filter((zone)=>{
+        var _zone_radiusKm, _zone_radiusKm1;
+        return zone.kind === 'radius' && ((_zone_radiusKm = zone.radiusKm) != null ? _zone_radiusKm : 0) > 0 && distance <= ((_zone_radiusKm1 = zone.radiusKm) != null ? _zone_radiusKm1 : 0);
+    }).sort((a, b)=>{
+        var _a_radiusKm, _b_radiusKm;
+        return ((_a_radiusKm = a.radiusKm) != null ? _a_radiusKm : 0) - ((_b_radiusKm = b.radiusKm) != null ? _b_radiusKm : 0);
+    })[0]) != null ? _zones_filter_sort_ : null;
+}
+/** What a zone charges for an order of `itemsCents`. */ export function localDeliveryFeeCents(zone, itemsCents) {
+    if (zone.freeOverCents && itemsCents >= zone.freeOverCents) return 0;
+    return Math.max(0, Math.round(zone.feeCents || 0));
+}
+/** How far an order of `itemsCents` is below the zone's minimum; 0 when it meets it. */ export function localDeliveryMinimumShortfall(zone, itemsCents) {
+    var _zone_minimumCents;
+    return Math.max(0, ((_zone_minimumCents = zone.minimumCents) != null ? _zone_minimumCents : 0) - Math.max(0, Math.round(itemsCents || 0)));
+}
+const DAY_NAMES = [
+    'Sunday',
+    'Monday',
+    'Tuesday',
+    'Wednesday',
+    'Thursday',
+    'Friday',
+    'Saturday'
+];
+/** The windows rows a store's settings parse to. Lines that do not read are dropped. */ export function localDeliveryWindowRows(settings) {
+    var _ref;
+    return parseOpeningHours((_ref = settings == null ? void 0 : settings.windows) != null ? _ref : '');
+}
+/**
+ * The windows a buyer may book now, soonest first: every row on every day
+ * from today to `daysAhead`, in the store's time zone, that opens at least
+ * the lead time from now. Pure in `nowMs`, so a spec can stand at any hour.
+ */ export function upcomingLocalDeliveryWindows(settings, context) {
+    var _ref, _ref1;
+    const rows = localDeliveryWindowRows(settings);
+    if (!rows.length) return [];
+    const lead = ((_ref = settings == null ? void 0 : settings.leadTimeMinutes) != null ? _ref : LOCAL_DELIVERY_DEFAULT_LEAD_MINUTES) * 60000;
+    const daysAhead = (_ref1 = settings == null ? void 0 : settings.daysAhead) != null ? _ref1 : LOCAL_DELIVERY_DEFAULT_DAYS_AHEAD;
+    const today = zonedDateTime(context.nowMs, context.timeZone);
+    const windows = [];
+    const seen = new Set();
+    for(let offset = 0; offset <= daysAhead; offset++){
+        // Noon of the day, so a daylight-saving change never lands it on the
+        // wrong calendar date.
+        const noon = zonedWallTimeToInstant({
+            year: today.year,
+            month: today.month,
+            day: today.day + offset,
+            hour: 12
+        }, context.timeZone);
+        const day = zonedDateTime(noon, context.timeZone);
+        const name = DAY_NAMES[day.weekday];
+        for (const row of rows){
+            if (!row.days.includes(name)) continue;
+            const [openHour, openMinute] = row.opens.split(':').map(Number);
+            const [closeHour, closeMinute] = row.closes.split(':').map(Number);
+            const startMs = zonedWallTimeToInstant({
+                year: day.year,
+                month: day.month,
+                day: day.day,
+                hour: openHour,
+                minute: openMinute
+            }, context.timeZone);
+            const overnight = closeHour * 60 + closeMinute <= openHour * 60 + openMinute;
+            const endMs = zonedWallTimeToInstant({
+                year: day.year,
+                month: day.month,
+                day: day.day + (overnight ? 1 : 0),
+                hour: closeHour,
+                minute: closeMinute
+            }, context.timeZone);
+            if (startMs < context.nowMs + lead || seen.has(startMs)) continue;
+            seen.add(startMs);
+            windows.push({
+                id: String(startMs),
+                startMs,
+                endMs
+            });
+        }
+    }
+    return windows.sort((a, b)=>a.startMs - b.startMs).slice(0, LOCAL_DELIVERY_WINDOWS_OFFERED_MAX);
+}
+/** The bookable window starting at `startMs`, or `null` when no such window is open now. */ export function findLocalDeliveryWindow(settings, startMs, context) {
+    var _upcomingLocalDeliveryWindows_find;
+    const wanted = Math.round(Number(startMs));
+    if (!Number.isFinite(wanted)) return null;
+    return (_upcomingLocalDeliveryWindows_find = upcomingLocalDeliveryWindows(settings, context).find((window)=>window.startMs === wanted)) != null ? _upcomingLocalDeliveryWindows_find : null;
+}
+/** Whether checkout can offer local delivery at all. */ export function localDeliveryOffered(settings) {
+    var _settings_zones;
+    return Boolean((settings == null ? void 0 : settings.enabled) && settings.country && ((_settings_zones = settings.zones) != null ? _settings_zones : []).length > 0 && localDeliveryWindowRows(settings).length > 0);
+}
+/**
+ * What stops saved settings from offering delivery, in the console's words.
+ * Empty when checkout will offer it (or when it is switched off).
+ */ export function localDeliveryProblems(settings) {
+    var _settings_zones;
+    if (!(settings == null ? void 0 : settings.enabled)) return [];
+    const problems = [];
+    if (!settings.country) problems.push('Choose the country you deliver in.');
+    const zones = (_settings_zones = settings.zones) != null ? _settings_zones : [];
+    if (!zones.length) problems.push('Add at least one delivery zone.');
+    for (const zone of zones){
+        var _zone_postcodes;
+        if (zone.kind === 'postcode' && !((_zone_postcodes = zone.postcodes) != null ? _zone_postcodes : []).length) {
+            problems.push(`"${zone.name}" lists no postal codes.`);
+        }
+        if (zone.kind === 'radius' && !settings.origin) {
+            problems.push(`"${zone.name}" measures distance, but your store has no map position yet.`);
+        }
+    }
+    if (!localDeliveryWindowRows(settings).length) problems.push('Add at least one delivery window.');
+    return problems;
+}
+/** "Tue, Oct 14, 9:00 AM – 12:00 PM" in the store's zone. */ export function formatLocalDeliveryWindow(window, timeZone) {
+    try {
+        const day = new Intl.DateTimeFormat('en-US', {
+            timeZone,
+            weekday: 'short',
+            month: 'short',
+            day: 'numeric'
+        }).format(new Date(window.startMs));
+        const time = new Intl.DateTimeFormat('en-US', {
+            timeZone,
+            hour: 'numeric',
+            minute: '2-digit'
+        });
+        return `${day}, ${time.format(new Date(window.startMs))} – ${time.format(new Date(window.endMs))}`;
+    } catch (unused) {
+        return new Date(window.startMs).toISOString();
+    }
+}
+
+//# sourceMappingURL=local-fulfillment-settings.js.map