@asteby/storefront 0.3.0 → 0.4.0

package/README.md

@@ -126,6 +126,57 @@ Images are `https://picsum.photos/seed/<handle>/800/800` placeholders built by
 `MOCK_IMAGE_URL`; pass `createMockStorefront({ imageUrl })` to swap them.
 `mock.reset()` restores the seed and `mock.state` exposes the live data.
 
+## Geo helpers (`@asteby/storefront/geo`)
+
+Pure TypeScript (no network, no DOM; Node 20, edge and browsers). Behaviour is
+pinned by `src/geo-vectors.json`, shared with the Go implementation.
+
+```ts
+import {
+  distanceKm, rankByDistance, formatDistance, directionsUrl, parseLatLng,
+  openStatus, formatOpeningHours, toSchemaOpeningHours,
+} from '@asteby/storefront/geo'
+
+const origin = parseLatLng('19.4326,-99.1332') // null when malformed or (0,0)
+const near = rankByDistance(shop.branches, origin!, { radiusKm: 25, limit: 3 })
+// [{ item, distanceKm }] sorted by distance, ties keep input order.
+// Items without a valid point (null, out of range or the "unset" (0,0)) are excluded.
+formatDistance(near[0]!.distanceKm, 'es-MX') // "300 m" (50 m steps) or "4.2 km"
+directionsUrl(near[0]!.item, { provider: 'google' }) // coordinates, else address text
+
+const hours = { weekly: [{ day: 1, open: '09:00', close: '19:00' }, /* 1 = Mon ... 7 = Sun */] }
+openStatus(hours, 'America/Mexico_City') // { open, closesAt, nextOpenAt } as ISO instants
+formatOpeningHours(hours, 'es-MX')       // "Lun–Vie 9:00–19:00 · Sáb 9:00–14:00"
+toSchemaOpeningHours(hours)              // ["Mo-Fr 09:00-19:00", "Sa 09:00-14:00"]
+```
+
+`openStatus` honors intervals that cross midnight, several intervals per day,
+dated `exceptions` and daylight saving time (uses `Intl.DateTimeFormat`; throws
+`RangeError` for an unknown time zone). `ShopBranch` has optional
+`opening_hours`, `timezone` and `opening_hours_text`; they arrive with Storefront
+API `locations.v1` and are not populated yet.
+
+## Locations (`client.locations`, Storefront API `locations.v1`)
+
+```ts
+const { nodes } = await sf.locations.list()                        // visible branches
+const byCp = await sf.locations.list({ postal_code: '06000' })     // ordered by distance_km
+const one = await sf.locations.get('br_centro')                    // null when unknown
+const near = await sf.locations.nearest({ lat: 19.4326, lng: -99.1332 }) // closest first, nodes[i].distance_km
+```
+
+`Location` is a `ShopBranch` whose structured fields are always present: `kind`,
+`postal_code`, `timezone`, `opening_hours`, `services`, `contacts` and
+`pickup { enabled, fee, prep_days }` (`fee: null` = free). `nearest` is
+`private, no-store`: the server rounds the point to 0.01° and never stores it,
+and the client neither logs nor keeps it (hooks such as `onRequest` do see the
+URL, so do not log it). To rank branches you already have without sending the
+point anywhere, use `rankByDistance` from `/geo` on `shop.branches`.
+The mock serves the three routes with three example branches (CDMX, Monterrey,
+Guadalajara) ordered by haversine; it knows the centroid of a few postal codes
+(`MOCK_POSTAL_CENTROIDS`), pickup is offered only where `pickup.enabled`, and
+the pickup `fee` is charged on the cart.
+
 ## API
 
 `createStorefrontClient(options)`:

package/dist/chunk-45R47HYO.js

@@ -0,0 +1,144 @@
+// src/geo.ts
+var RAD = Math.PI / 180;
+function distanceKm(a, b) {
+  const dLat = (b.lat - a.lat) * RAD;
+  const dLng = (b.lng - a.lng) * RAD;
+  const h = Math.sin(dLat / 2) ** 2 + Math.cos(a.lat * RAD) * Math.cos(b.lat * RAD) * Math.sin(dLng / 2) ** 2;
+  return 2 * 6371.0088 * Math.atan2(Math.sqrt(h), Math.sqrt(1 - h));
+}
+function isValidPoint(p) {
+  const { lat, lng } = p ?? {};
+  return Number.isFinite(lat) && Number.isFinite(lng) && Math.abs(lat) <= 90 && Math.abs(lng) <= 180 && !(lat === 0 && lng === 0);
+}
+function parseLatLng(s) {
+  const [a, b, ...rest] = (s ?? "").split(",");
+  const p = !rest.length && a?.trim() && b?.trim() ? { lat: Number(a), lng: Number(b) } : null;
+  return isValidPoint(p) ? p : null;
+}
+function rankByDistance(items, origin, { radiusKm, limit, getPoint = (i) => i } = {}) {
+  const out = [];
+  for (const item of items) {
+    const p = getPoint(item);
+    if (!isValidPoint(p)) continue;
+    const d = distanceKm(origin, p);
+    if (radiusKm === void 0 || d <= radiusKm) out.push({ item, distanceKm: d });
+  }
+  out.sort((x, y) => x.distanceKm - y.distanceKm);
+  return limit === void 0 ? out : out.slice(0, Math.max(0, limit));
+}
+function formatDistance(km, locale = "es-MX") {
+  const m = Math.round(km * 1e3 / 50) * 50;
+  const [value, unit, digits] = m < 1e3 ? [m, "meter", 0] : [km, "kilometer", 1];
+  return new Intl.NumberFormat(locale, {
+    style: "unit",
+    unit,
+    minimumFractionDigits: digits,
+    maximumFractionDigits: digits
+  }).format(value);
+}
+function directionsUrl(location, { provider = "google" } = {}) {
+  const ll = isValidPoint(location) ? `${location.lat},${location.lng}` : null;
+  const text = [location.address, location.city].filter(Boolean).join(", ");
+  const dest = ll ?? text;
+  if (!dest) return null;
+  const q = encodeURIComponent(dest);
+  if (provider === "apple") return `https://maps.apple.com/?daddr=${q}`;
+  if (provider === "geo") return ll ? `geo:${ll}?q=${ll}` : `geo:0,0?q=${q}`;
+  return `https://www.google.com/maps/dir/?api=1&destination=${q}`;
+}
+var toMin = (t) => {
+  const m = /^(\d{1,2}):(\d{2})$/.exec(t ?? "");
+  return m ? Number(m[1]) * 60 + Number(m[2]) : NaN;
+};
+var interval = (open, close) => {
+  const s = toMin(open);
+  let e = toMin(close);
+  if (Number.isNaN(s) || Number.isNaN(e)) return [];
+  if (e <= s) e += 1440;
+  return [[s, e]];
+};
+var dayIntervals = (h, day, date) => {
+  const x = h.exceptions?.find((e) => e.date === date);
+  if (x?.closed) return [];
+  if (x && x.open && x.close) return interval(x.open, x.close);
+  return h.weekly.filter((w) => w.day === day).flatMap((w) => interval(w.open, w.close));
+};
+function openStatus(hours, timeZone, now = /* @__PURE__ */ new Date()) {
+  const fmt = new Intl.DateTimeFormat("en-US", {
+    timeZone,
+    hourCycle: "h23",
+    year: "numeric",
+    month: "numeric",
+    day: "numeric",
+    hour: "numeric",
+    minute: "numeric"
+  });
+  const wall = (ms) => {
+    const p = {};
+    for (const { type, value } of fmt.formatToParts(ms)) p[type] = Number(value);
+    return Date.UTC(p.year, p.month - 1, p.day, (p.hour ?? 0) % 24, p.minute) / 6e4;
+  };
+  const nowMs = now.getTime();
+  const w = wall(nowMs);
+  const day0 = Math.floor(w / 1440) * 1440;
+  const offset = (ms) => wall(ms) - Math.floor(ms / 6e4);
+  const toInstant = (t) => {
+    const guess = (t - offset(nowMs)) * 6e4;
+    return new Date((t - offset(guess)) * 6e4).toISOString();
+  };
+  const all = [];
+  for (let d = -1; d <= 8; d++) {
+    const at = new Date((day0 + d * 1440) * 6e4);
+    const day = at.getUTCDay() || 7;
+    for (const [s, e] of dayIntervals(hours, day, at.toISOString().slice(0, 10))) all.push([day0 + d * 1440 + s, day0 + d * 1440 + e]);
+  }
+  all.sort((a, b) => a[0] - b[0]);
+  const merged = [];
+  for (const iv of all) {
+    const last = merged[merged.length - 1];
+    if (last && iv[0] <= last[1]) last[1] = Math.max(last[1], iv[1]);
+    else merged.push([iv[0], iv[1]]);
+  }
+  const current = merged.find(([s, e]) => s <= w && w < e);
+  if (current) return { open: true, closesAt: toInstant(current[1]), nextOpenAt: null };
+  const next = merged.find(([s]) => s > w);
+  return { open: false, closesAt: null, nextOpenAt: next ? toInstant(next[0]) : null };
+}
+var runs = (h) => {
+  const out = [];
+  for (let day = 1; day <= 7; day++) {
+    const iv = h.weekly.filter((x) => x.day === day).flatMap((x) => interval(x.open, x.close)).sort((a, b) => a[0] - b[0]);
+    if (!iv.length) continue;
+    const last = out[out.length - 1];
+    if (last && last.to === day - 1 && JSON.stringify(last.iv) === JSON.stringify(iv)) last.to = day;
+    else out.push({ from: day, to: day, iv });
+  }
+  return out;
+};
+var hm = (min) => [min && min % 1440 === 0 ? 24 : Math.floor(min / 60) % 24, String(min % 60).padStart(2, "0")];
+function formatOpeningHours(hours, locale = "es-MX") {
+  const en = /^en/i.test(locale);
+  const name = (d) => {
+    const s = new Intl.DateTimeFormat(locale, { weekday: "short", timeZone: "UTC" }).format(Date.UTC(2024, 0, d)).replace(/\.$/, "");
+    return s.charAt(0).toUpperCase() + s.slice(1);
+  };
+  const time = (min) => {
+    const [h, m] = hm(min);
+    return en ? `${h % 12 || 12}:${m} ${h % 24 < 12 ? "AM" : "PM"}` : `${h}:${m}`;
+  };
+  return runs(hours).map((r) => `${name(r.from)}${r.from === r.to ? "" : "\u2013" + name(r.to)} ${r.iv.map(([s, e]) => `${time(s)}\u2013${time(e)}`).join(", ")}`).join(" \xB7 ");
+}
+function toSchemaOpeningHours(hours) {
+  const code = ["Mo", "Tu", "We", "Th", "Fr", "Sa", "Su"];
+  const t = (min) => {
+    const [h, m] = hm(min);
+    return `${String(h).padStart(2, "0")}:${m}`;
+  };
+  return runs(hours).flatMap(
+    (r) => r.iv.map(([s, e]) => `${code[r.from - 1]}${r.from === r.to ? "" : "-" + code[r.to - 1]} ${t(s)}-${t(e)}`)
+  );
+}
+
+export { directionsUrl, distanceKm, formatDistance, formatOpeningHours, isValidPoint, openStatus, parseLatLng, rankByDistance, toSchemaOpeningHours };
+//# sourceMappingURL=chunk-45R47HYO.js.map
+//# sourceMappingURL=chunk-45R47HYO.js.map

package/dist/chunk-45R47HYO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/geo.ts"],"names":[],"mappings":"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","file":"chunk-45R47HYO.js","sourcesContent":["/**\n * Geo helpers: pure TypeScript, no network and no DOM. Works in Node 20, edge\n * runtimes and browsers. Behaviour is pinned by `geo-vectors.json`, which the\n * Go side copies verbatim, so keep both implementations in sync.\n */\n\nexport type GeoPoint = { lat: number; lng: number }\n\n/** `(0, 0)` means \"unset\" on this platform, so it is never a valid point. */\ntype MaybePoint = { lat?: number | null; lng?: number | null } | null | undefined\n\nexport type OpeningHours = {\n  /** `day`: 1 = Monday ... 7 = Sunday. Several entries per day are allowed. A `close` at or before `open` crosses midnight. */\n  weekly: { day: number; open: string; close: string }[]\n  /** Dated overrides of the weekly rule. `closed`, or both `open` and `close`. */\n  exceptions?: { date: string; closed?: true; open?: string; close?: string; note?: string }[]\n}\n\nexport type OpenStatus = {\n  open: boolean\n  /** ISO instant (UTC) when the current interval ends; `null` when closed. */\n  closesAt: string | null\n  /** ISO instant (UTC) of the next opening; `null` when open or none within 8 days. */\n  nextOpenAt: string | null\n}\n\nconst RAD = Math.PI / 180\n\n/** Great-circle distance in km (haversine, earth radius 6371.0088 km). */\nexport function distanceKm(a: GeoPoint, b: GeoPoint): number {\n  const dLat = (b.lat - a.lat) * RAD\n  const dLng = (b.lng - a.lng) * RAD\n  const h = Math.sin(dLat / 2) ** 2 + Math.cos(a.lat * RAD) * Math.cos(b.lat * RAD) * Math.sin(dLng / 2) ** 2\n  return 2 * 6371.0088 * Math.atan2(Math.sqrt(h), Math.sqrt(1 - h))\n}\n\n/** Finite, in range and not the `(0, 0)` \"unset\" pair. */\nexport function isValidPoint(p: MaybePoint): p is GeoPoint {\n  const { lat, lng } = p ?? {}\n  // Number.isFinite is false for null, undefined and non-numbers.\n  return Number.isFinite(lat) && Number.isFinite(lng) && Math.abs(lat!) <= 90 && Math.abs(lng!) <= 180 && !(lat === 0 && lng === 0)\n}\n\n/** `'19.43,-99.13'` (spaces allowed) to a point; `null` when malformed or invalid. */\nexport function parseLatLng(s: string | null | undefined): GeoPoint | null {\n  const [a, b, ...rest] = (s ?? '').split(',')\n  const p = !rest.length && a?.trim() && b?.trim() ? { lat: Number(a), lng: Number(b) } : null\n  return isValidPoint(p) ? p : null\n}\n\nexport type RankOptions<T> = {\n  /** Keep items at most this far away (inclusive). */\n  radiusKm?: number\n  /** Keep the first N after sorting. */\n  limit?: number\n  /** Defaults to reading `lat` / `lng` from the item. */\n  getPoint?: (item: T) => MaybePoint\n}\n\n/**\n * Sorts by distance from `origin` (stable: ties keep input order). Items without\n * a valid point are EXCLUDED, not placed last, because they have no distance.\n */\nexport function rankByDistance<T>(\n  items: readonly T[],\n  origin: GeoPoint,\n  { radiusKm, limit, getPoint = (i) => i as MaybePoint }: RankOptions<T> = {},\n): { item: T; distanceKm: number }[] {\n  const out: { item: T; distanceKm: number }[] = []\n  for (const item of items) {\n    const p = getPoint(item)\n    if (!isValidPoint(p)) continue\n    const d = distanceKm(origin, p)\n    if (radiusKm === undefined || d <= radiusKm) out.push({ item, distanceKm: d })\n  }\n  // Array.prototype.sort is stable (ES2019), so ties keep input order.\n  out.sort((x, y) => x.distanceKm - y.distanceKm)\n  return limit === undefined ? out : out.slice(0, Math.max(0, limit))\n}\n\n/** Under 1 km: meters rounded to 50 m. Otherwise km with one decimal. */\nexport function formatDistance(km: number, locale = 'es-MX'): string {\n  const m = Math.round((km * 1000) / 50) * 50\n  const [value, unit, digits] = m < 1000 ? [m, 'meter', 0] : [km, 'kilometer', 1]\n  return new Intl.NumberFormat(locale, {\n    style: 'unit', unit, minimumFractionDigits: digits, maximumFractionDigits: digits,\n  }).format(value)\n}\n\n/** Destination for directions: coordinates when valid, else the address text. */\nexport function directionsUrl(\n  location: { lat?: number | null; lng?: number | null; address?: string | null; city?: string | null },\n  { provider = 'google' }: { provider?: 'google' | 'apple' | 'geo' } = {},\n): string | null {\n  const ll = isValidPoint(location) ? `${location.lat},${location.lng}` : null\n  const text = [location.address, location.city].filter(Boolean).join(', ')\n  const dest = ll ?? text\n  if (!dest) return null\n  const q = encodeURIComponent(dest)\n  if (provider === 'apple') return `https://maps.apple.com/?daddr=${q}`\n  if (provider === 'geo') return ll ? `geo:${ll}?q=${ll}` : `geo:0,0?q=${q}`\n  return `https://www.google.com/maps/dir/?api=1&destination=${q}`\n}\n\n// --- opening hours -------------------------------------------------------\n\nconst toMin = (t: string | undefined): number => {\n  const m = /^(\\d{1,2}):(\\d{2})$/.exec(t ?? '')\n  return m ? Number(m[1]) * 60 + Number(m[2]) : NaN\n}\n\ntype Iv = [number, number]\n\n/** Intervals in minutes; an end at or before the start crosses midnight. */\nconst interval = (open: string | undefined, close: string | undefined): Iv[] => {\n  const s = toMin(open)\n  let e = toMin(close)\n  if (Number.isNaN(s) || Number.isNaN(e)) return []\n  if (e <= s) e += 1440\n  return [[s, e]]\n}\n\nconst dayIntervals = (h: OpeningHours, day: number, date: string): Iv[] => {\n  const x = h.exceptions?.find((e) => e.date === date)\n  if (x?.closed) return []\n  if (x && x.open && x.close) return interval(x.open, x.close)\n  return h.weekly.filter((w) => w.day === day).flatMap((w) => interval(w.open, w.close))\n}\n\n/**\n * Whether the place is open at `now` in the IANA `timeZone` (throws RangeError\n * for an unknown zone). Looks 8 days ahead for the next opening. Handles\n * intervals crossing midnight, several per day, dated exceptions and DST.\n */\nexport function openStatus(hours: OpeningHours, timeZone: string, now: Date = new Date()): OpenStatus {\n  const fmt = new Intl.DateTimeFormat('en-US', {\n    timeZone, hourCycle: 'h23', year: 'numeric', month: 'numeric', day: 'numeric', hour: 'numeric', minute: 'numeric',\n  })\n  // Wall-clock minutes since the epoch as seen in `timeZone`.\n  const wall = (ms: number): number => {\n    const p: Record<string, number> = {}\n    for (const { type, value } of fmt.formatToParts(ms)) p[type] = Number(value)\n    return Date.UTC(p.year!, p.month! - 1, p.day!, (p.hour ?? 0) % 24, p.minute!) / 60000\n  }\n  const nowMs = now.getTime()\n  const w = wall(nowMs)\n  const day0 = Math.floor(w / 1440) * 1440\n  // Offset from UTC, in minutes, at an instant.\n  const offset = (ms: number): number => wall(ms) - Math.floor(ms / 60000)\n  const toInstant = (t: number): string => {\n    const guess = (t - offset(nowMs)) * 60000\n    return new Date((t - offset(guess)) * 60000).toISOString()\n  }\n\n  const all: Iv[] = []\n  for (let d = -1; d <= 8; d++) {\n    const at = new Date((day0 + d * 1440) * 60000)\n    const day = at.getUTCDay() || 7\n    for (const [s, e] of dayIntervals(hours, day, at.toISOString().slice(0, 10))) all.push([day0 + d * 1440 + s, day0 + d * 1440 + e])\n  }\n  all.sort((a, b) => a[0] - b[0])\n  const merged: Iv[] = []\n  for (const iv of all) {\n    const last = merged[merged.length - 1]\n    if (last && iv[0] <= last[1]) last[1] = Math.max(last[1], iv[1])\n    else merged.push([iv[0], iv[1]])\n  }\n  const current = merged.find(([s, e]) => s <= w && w < e)\n  if (current) return { open: true, closesAt: toInstant(current[1]), nextOpenAt: null }\n  const next = merged.find(([s]) => s > w)\n  return { open: false, closesAt: null, nextOpenAt: next ? toInstant(next[0]) : null }\n}\n\ntype Run = { from: number; to: number; iv: Iv[] }\n\n/** Consecutive days (1..7) with identical intervals, in week order. */\nconst runs = (h: OpeningHours): Run[] => {\n  const out: Run[] = []\n  for (let day = 1; day <= 7; day++) {\n    const iv = h.weekly.filter((x) => x.day === day).flatMap((x) => interval(x.open, x.close)).sort((a, b) => a[0] - b[0])\n    if (!iv.length) continue\n    const last = out[out.length - 1]\n    if (last && last.to === day - 1 && JSON.stringify(last.iv) === JSON.stringify(iv)) last.to = day\n    else out.push({ from: day, to: day, iv })\n  }\n  return out\n}\n\n/** Hour (24 for an end at midnight) and padded minutes of a minute-of-day value. */\nconst hm = (min: number): [number, string] => [min && min % 1440 === 0 ? 24 : Math.floor(min / 60) % 24, String(min % 60).padStart(2, '0')]\n\n/** Compact text, e.g. `Lun–Vie 9:00–19:00 · Sáb 9:00–14:00` (24 h) or `Mon–Fri 9:00 AM–7:00 PM` (en). */\nexport function formatOpeningHours(hours: OpeningHours, locale = 'es-MX'): string {\n  const en = /^en/i.test(locale)\n  const name = (d: number): string => {\n    const s = new Intl.DateTimeFormat(locale, { weekday: 'short', timeZone: 'UTC' }).format(Date.UTC(2024, 0, d)).replace(/\\.$/, '')\n    return s.charAt(0).toUpperCase() + s.slice(1)\n  }\n  const time = (min: number): string => {\n    const [h, m] = hm(min)\n    return en ? `${h % 12 || 12}:${m} ${h % 24 < 12 ? 'AM' : 'PM'}` : `${h}:${m}`\n  }\n  return runs(hours)\n    .map((r) => `${name(r.from)}${r.from === r.to ? '' : '–' + name(r.to)} ${r.iv.map(([s, e]) => `${time(s)}–${time(e)}`).join(', ')}`)\n    .join(' · ')\n}\n\n/** schema.org `openingHours` strings, one per interval, e.g. `Mo-Fr 09:00-19:00`. */\nexport function toSchemaOpeningHours(hours: OpeningHours): string[] {\n  const code = ['Mo', 'Tu', 'We', 'Th', 'Fr', 'Sa', 'Su']\n  const t = (min: number): string => { const [h, m] = hm(min); return `${String(h).padStart(2, '0')}:${m}` }\n  return runs(hours).flatMap((r) =>\n    r.iv.map(([s, e]) => `${code[r.from - 1]}${r.from === r.to ? '' : '-' + code[r.to - 1]} ${t(s)}-${t(e)}`),\n  )\n}\n"]}

package/dist/geo.cjs

@@ -0,0 +1,154 @@
+'use strict';
+
+// src/geo.ts
+var RAD = Math.PI / 180;
+function distanceKm(a, b) {
+  const dLat = (b.lat - a.lat) * RAD;
+  const dLng = (b.lng - a.lng) * RAD;
+  const h = Math.sin(dLat / 2) ** 2 + Math.cos(a.lat * RAD) * Math.cos(b.lat * RAD) * Math.sin(dLng / 2) ** 2;
+  return 2 * 6371.0088 * Math.atan2(Math.sqrt(h), Math.sqrt(1 - h));
+}
+function isValidPoint(p) {
+  const { lat, lng } = p ?? {};
+  return Number.isFinite(lat) && Number.isFinite(lng) && Math.abs(lat) <= 90 && Math.abs(lng) <= 180 && !(lat === 0 && lng === 0);
+}
+function parseLatLng(s) {
+  const [a, b, ...rest] = (s ?? "").split(",");
+  const p = !rest.length && a?.trim() && b?.trim() ? { lat: Number(a), lng: Number(b) } : null;
+  return isValidPoint(p) ? p : null;
+}
+function rankByDistance(items, origin, { radiusKm, limit, getPoint = (i) => i } = {}) {
+  const out = [];
+  for (const item of items) {
+    const p = getPoint(item);
+    if (!isValidPoint(p)) continue;
+    const d = distanceKm(origin, p);
+    if (radiusKm === void 0 || d <= radiusKm) out.push({ item, distanceKm: d });
+  }
+  out.sort((x, y) => x.distanceKm - y.distanceKm);
+  return limit === void 0 ? out : out.slice(0, Math.max(0, limit));
+}
+function formatDistance(km, locale = "es-MX") {
+  const m = Math.round(km * 1e3 / 50) * 50;
+  const [value, unit, digits] = m < 1e3 ? [m, "meter", 0] : [km, "kilometer", 1];
+  return new Intl.NumberFormat(locale, {
+    style: "unit",
+    unit,
+    minimumFractionDigits: digits,
+    maximumFractionDigits: digits
+  }).format(value);
+}
+function directionsUrl(location, { provider = "google" } = {}) {
+  const ll = isValidPoint(location) ? `${location.lat},${location.lng}` : null;
+  const text = [location.address, location.city].filter(Boolean).join(", ");
+  const dest = ll ?? text;
+  if (!dest) return null;
+  const q = encodeURIComponent(dest);
+  if (provider === "apple") return `https://maps.apple.com/?daddr=${q}`;
+  if (provider === "geo") return ll ? `geo:${ll}?q=${ll}` : `geo:0,0?q=${q}`;
+  return `https://www.google.com/maps/dir/?api=1&destination=${q}`;
+}
+var toMin = (t) => {
+  const m = /^(\d{1,2}):(\d{2})$/.exec(t ?? "");
+  return m ? Number(m[1]) * 60 + Number(m[2]) : NaN;
+};
+var interval = (open, close) => {
+  const s = toMin(open);
+  let e = toMin(close);
+  if (Number.isNaN(s) || Number.isNaN(e)) return [];
+  if (e <= s) e += 1440;
+  return [[s, e]];
+};
+var dayIntervals = (h, day, date) => {
+  const x = h.exceptions?.find((e) => e.date === date);
+  if (x?.closed) return [];
+  if (x && x.open && x.close) return interval(x.open, x.close);
+  return h.weekly.filter((w) => w.day === day).flatMap((w) => interval(w.open, w.close));
+};
+function openStatus(hours, timeZone, now = /* @__PURE__ */ new Date()) {
+  const fmt = new Intl.DateTimeFormat("en-US", {
+    timeZone,
+    hourCycle: "h23",
+    year: "numeric",
+    month: "numeric",
+    day: "numeric",
+    hour: "numeric",
+    minute: "numeric"
+  });
+  const wall = (ms) => {
+    const p = {};
+    for (const { type, value } of fmt.formatToParts(ms)) p[type] = Number(value);
+    return Date.UTC(p.year, p.month - 1, p.day, (p.hour ?? 0) % 24, p.minute) / 6e4;
+  };
+  const nowMs = now.getTime();
+  const w = wall(nowMs);
+  const day0 = Math.floor(w / 1440) * 1440;
+  const offset = (ms) => wall(ms) - Math.floor(ms / 6e4);
+  const toInstant = (t) => {
+    const guess = (t - offset(nowMs)) * 6e4;
+    return new Date((t - offset(guess)) * 6e4).toISOString();
+  };
+  const all = [];
+  for (let d = -1; d <= 8; d++) {
+    const at = new Date((day0 + d * 1440) * 6e4);
+    const day = at.getUTCDay() || 7;
+    for (const [s, e] of dayIntervals(hours, day, at.toISOString().slice(0, 10))) all.push([day0 + d * 1440 + s, day0 + d * 1440 + e]);
+  }
+  all.sort((a, b) => a[0] - b[0]);
+  const merged = [];
+  for (const iv of all) {
+    const last = merged[merged.length - 1];
+    if (last && iv[0] <= last[1]) last[1] = Math.max(last[1], iv[1]);
+    else merged.push([iv[0], iv[1]]);
+  }
+  const current = merged.find(([s, e]) => s <= w && w < e);
+  if (current) return { open: true, closesAt: toInstant(current[1]), nextOpenAt: null };
+  const next = merged.find(([s]) => s > w);
+  return { open: false, closesAt: null, nextOpenAt: next ? toInstant(next[0]) : null };
+}
+var runs = (h) => {
+  const out = [];
+  for (let day = 1; day <= 7; day++) {
+    const iv = h.weekly.filter((x) => x.day === day).flatMap((x) => interval(x.open, x.close)).sort((a, b) => a[0] - b[0]);
+    if (!iv.length) continue;
+    const last = out[out.length - 1];
+    if (last && last.to === day - 1 && JSON.stringify(last.iv) === JSON.stringify(iv)) last.to = day;
+    else out.push({ from: day, to: day, iv });
+  }
+  return out;
+};
+var hm = (min) => [min && min % 1440 === 0 ? 24 : Math.floor(min / 60) % 24, String(min % 60).padStart(2, "0")];
+function formatOpeningHours(hours, locale = "es-MX") {
+  const en = /^en/i.test(locale);
+  const name = (d) => {
+    const s = new Intl.DateTimeFormat(locale, { weekday: "short", timeZone: "UTC" }).format(Date.UTC(2024, 0, d)).replace(/\.$/, "");
+    return s.charAt(0).toUpperCase() + s.slice(1);
+  };
+  const time = (min) => {
+    const [h, m] = hm(min);
+    return en ? `${h % 12 || 12}:${m} ${h % 24 < 12 ? "AM" : "PM"}` : `${h}:${m}`;
+  };
+  return runs(hours).map((r) => `${name(r.from)}${r.from === r.to ? "" : "\u2013" + name(r.to)} ${r.iv.map(([s, e]) => `${time(s)}\u2013${time(e)}`).join(", ")}`).join(" \xB7 ");
+}
+function toSchemaOpeningHours(hours) {
+  const code = ["Mo", "Tu", "We", "Th", "Fr", "Sa", "Su"];
+  const t = (min) => {
+    const [h, m] = hm(min);
+    return `${String(h).padStart(2, "0")}:${m}`;
+  };
+  return runs(hours).flatMap(
+    (r) => r.iv.map(([s, e]) => `${code[r.from - 1]}${r.from === r.to ? "" : "-" + code[r.to - 1]} ${t(s)}-${t(e)}`)
+  );
+}
+
+exports.directionsUrl = directionsUrl;
+exports.distanceKm = distanceKm;
+exports.formatDistance = formatDistance;
+exports.formatOpeningHours = formatOpeningHours;
+exports.isValidPoint = isValidPoint;
+exports.openStatus = openStatus;
+exports.parseLatLng = parseLatLng;
+exports.rankByDistance = rankByDistance;
+exports.toSchemaOpeningHours = toSchemaOpeningHours;
+//# sourceMappingURL=geo.cjs.map
+//# sourceMappingURL=geo.cjs.map

package/dist/geo.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/geo.ts"],"names":[],"mappings":"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","file":"geo.cjs","sourcesContent":["/**\n * Geo helpers: pure TypeScript, no network and no DOM. Works in Node 20, edge\n * runtimes and browsers. Behaviour is pinned by `geo-vectors.json`, which the\n * Go side copies verbatim, so keep both implementations in sync.\n */\n\nexport type GeoPoint = { lat: number; lng: number }\n\n/** `(0, 0)` means \"unset\" on this platform, so it is never a valid point. */\ntype MaybePoint = { lat?: number | null; lng?: number | null } | null | undefined\n\nexport type OpeningHours = {\n  /** `day`: 1 = Monday ... 7 = Sunday. Several entries per day are allowed. A `close` at or before `open` crosses midnight. */\n  weekly: { day: number; open: string; close: string }[]\n  /** Dated overrides of the weekly rule. `closed`, or both `open` and `close`. */\n  exceptions?: { date: string; closed?: true; open?: string; close?: string; note?: string }[]\n}\n\nexport type OpenStatus = {\n  open: boolean\n  /** ISO instant (UTC) when the current interval ends; `null` when closed. */\n  closesAt: string | null\n  /** ISO instant (UTC) of the next opening; `null` when open or none within 8 days. */\n  nextOpenAt: string | null\n}\n\nconst RAD = Math.PI / 180\n\n/** Great-circle distance in km (haversine, earth radius 6371.0088 km). */\nexport function distanceKm(a: GeoPoint, b: GeoPoint): number {\n  const dLat = (b.lat - a.lat) * RAD\n  const dLng = (b.lng - a.lng) * RAD\n  const h = Math.sin(dLat / 2) ** 2 + Math.cos(a.lat * RAD) * Math.cos(b.lat * RAD) * Math.sin(dLng / 2) ** 2\n  return 2 * 6371.0088 * Math.atan2(Math.sqrt(h), Math.sqrt(1 - h))\n}\n\n/** Finite, in range and not the `(0, 0)` \"unset\" pair. */\nexport function isValidPoint(p: MaybePoint): p is GeoPoint {\n  const { lat, lng } = p ?? {}\n  // Number.isFinite is false for null, undefined and non-numbers.\n  return Number.isFinite(lat) && Number.isFinite(lng) && Math.abs(lat!) <= 90 && Math.abs(lng!) <= 180 && !(lat === 0 && lng === 0)\n}\n\n/** `'19.43,-99.13'` (spaces allowed) to a point; `null` when malformed or invalid. */\nexport function parseLatLng(s: string | null | undefined): GeoPoint | null {\n  const [a, b, ...rest] = (s ?? '').split(',')\n  const p = !rest.length && a?.trim() && b?.trim() ? { lat: Number(a), lng: Number(b) } : null\n  return isValidPoint(p) ? p : null\n}\n\nexport type RankOptions<T> = {\n  /** Keep items at most this far away (inclusive). */\n  radiusKm?: number\n  /** Keep the first N after sorting. */\n  limit?: number\n  /** Defaults to reading `lat` / `lng` from the item. */\n  getPoint?: (item: T) => MaybePoint\n}\n\n/**\n * Sorts by distance from `origin` (stable: ties keep input order). Items without\n * a valid point are EXCLUDED, not placed last, because they have no distance.\n */\nexport function rankByDistance<T>(\n  items: readonly T[],\n  origin: GeoPoint,\n  { radiusKm, limit, getPoint = (i) => i as MaybePoint }: RankOptions<T> = {},\n): { item: T; distanceKm: number }[] {\n  const out: { item: T; distanceKm: number }[] = []\n  for (const item of items) {\n    const p = getPoint(item)\n    if (!isValidPoint(p)) continue\n    const d = distanceKm(origin, p)\n    if (radiusKm === undefined || d <= radiusKm) out.push({ item, distanceKm: d })\n  }\n  // Array.prototype.sort is stable (ES2019), so ties keep input order.\n  out.sort((x, y) => x.distanceKm - y.distanceKm)\n  return limit === undefined ? out : out.slice(0, Math.max(0, limit))\n}\n\n/** Under 1 km: meters rounded to 50 m. Otherwise km with one decimal. */\nexport function formatDistance(km: number, locale = 'es-MX'): string {\n  const m = Math.round((km * 1000) / 50) * 50\n  const [value, unit, digits] = m < 1000 ? [m, 'meter', 0] : [km, 'kilometer', 1]\n  return new Intl.NumberFormat(locale, {\n    style: 'unit', unit, minimumFractionDigits: digits, maximumFractionDigits: digits,\n  }).format(value)\n}\n\n/** Destination for directions: coordinates when valid, else the address text. */\nexport function directionsUrl(\n  location: { lat?: number | null; lng?: number | null; address?: string | null; city?: string | null },\n  { provider = 'google' }: { provider?: 'google' | 'apple' | 'geo' } = {},\n): string | null {\n  const ll = isValidPoint(location) ? `${location.lat},${location.lng}` : null\n  const text = [location.address, location.city].filter(Boolean).join(', ')\n  const dest = ll ?? text\n  if (!dest) return null\n  const q = encodeURIComponent(dest)\n  if (provider === 'apple') return `https://maps.apple.com/?daddr=${q}`\n  if (provider === 'geo') return ll ? `geo:${ll}?q=${ll}` : `geo:0,0?q=${q}`\n  return `https://www.google.com/maps/dir/?api=1&destination=${q}`\n}\n\n// --- opening hours -------------------------------------------------------\n\nconst toMin = (t: string | undefined): number => {\n  const m = /^(\\d{1,2}):(\\d{2})$/.exec(t ?? '')\n  return m ? Number(m[1]) * 60 + Number(m[2]) : NaN\n}\n\ntype Iv = [number, number]\n\n/** Intervals in minutes; an end at or before the start crosses midnight. */\nconst interval = (open: string | undefined, close: string | undefined): Iv[] => {\n  const s = toMin(open)\n  let e = toMin(close)\n  if (Number.isNaN(s) || Number.isNaN(e)) return []\n  if (e <= s) e += 1440\n  return [[s, e]]\n}\n\nconst dayIntervals = (h: OpeningHours, day: number, date: string): Iv[] => {\n  const x = h.exceptions?.find((e) => e.date === date)\n  if (x?.closed) return []\n  if (x && x.open && x.close) return interval(x.open, x.close)\n  return h.weekly.filter((w) => w.day === day).flatMap((w) => interval(w.open, w.close))\n}\n\n/**\n * Whether the place is open at `now` in the IANA `timeZone` (throws RangeError\n * for an unknown zone). Looks 8 days ahead for the next opening. Handles\n * intervals crossing midnight, several per day, dated exceptions and DST.\n */\nexport function openStatus(hours: OpeningHours, timeZone: string, now: Date = new Date()): OpenStatus {\n  const fmt = new Intl.DateTimeFormat('en-US', {\n    timeZone, hourCycle: 'h23', year: 'numeric', month: 'numeric', day: 'numeric', hour: 'numeric', minute: 'numeric',\n  })\n  // Wall-clock minutes since the epoch as seen in `timeZone`.\n  const wall = (ms: number): number => {\n    const p: Record<string, number> = {}\n    for (const { type, value } of fmt.formatToParts(ms)) p[type] = Number(value)\n    return Date.UTC(p.year!, p.month! - 1, p.day!, (p.hour ?? 0) % 24, p.minute!) / 60000\n  }\n  const nowMs = now.getTime()\n  const w = wall(nowMs)\n  const day0 = Math.floor(w / 1440) * 1440\n  // Offset from UTC, in minutes, at an instant.\n  const offset = (ms: number): number => wall(ms) - Math.floor(ms / 60000)\n  const toInstant = (t: number): string => {\n    const guess = (t - offset(nowMs)) * 60000\n    return new Date((t - offset(guess)) * 60000).toISOString()\n  }\n\n  const all: Iv[] = []\n  for (let d = -1; d <= 8; d++) {\n    const at = new Date((day0 + d * 1440) * 60000)\n    const day = at.getUTCDay() || 7\n    for (const [s, e] of dayIntervals(hours, day, at.toISOString().slice(0, 10))) all.push([day0 + d * 1440 + s, day0 + d * 1440 + e])\n  }\n  all.sort((a, b) => a[0] - b[0])\n  const merged: Iv[] = []\n  for (const iv of all) {\n    const last = merged[merged.length - 1]\n    if (last && iv[0] <= last[1]) last[1] = Math.max(last[1], iv[1])\n    else merged.push([iv[0], iv[1]])\n  }\n  const current = merged.find(([s, e]) => s <= w && w < e)\n  if (current) return { open: true, closesAt: toInstant(current[1]), nextOpenAt: null }\n  const next = merged.find(([s]) => s > w)\n  return { open: false, closesAt: null, nextOpenAt: next ? toInstant(next[0]) : null }\n}\n\ntype Run = { from: number; to: number; iv: Iv[] }\n\n/** Consecutive days (1..7) with identical intervals, in week order. */\nconst runs = (h: OpeningHours): Run[] => {\n  const out: Run[] = []\n  for (let day = 1; day <= 7; day++) {\n    const iv = h.weekly.filter((x) => x.day === day).flatMap((x) => interval(x.open, x.close)).sort((a, b) => a[0] - b[0])\n    if (!iv.length) continue\n    const last = out[out.length - 1]\n    if (last && last.to === day - 1 && JSON.stringify(last.iv) === JSON.stringify(iv)) last.to = day\n    else out.push({ from: day, to: day, iv })\n  }\n  return out\n}\n\n/** Hour (24 for an end at midnight) and padded minutes of a minute-of-day value. */\nconst hm = (min: number): [number, string] => [min && min % 1440 === 0 ? 24 : Math.floor(min / 60) % 24, String(min % 60).padStart(2, '0')]\n\n/** Compact text, e.g. `Lun–Vie 9:00–19:00 · Sáb 9:00–14:00` (24 h) or `Mon–Fri 9:00 AM–7:00 PM` (en). */\nexport function formatOpeningHours(hours: OpeningHours, locale = 'es-MX'): string {\n  const en = /^en/i.test(locale)\n  const name = (d: number): string => {\n    const s = new Intl.DateTimeFormat(locale, { weekday: 'short', timeZone: 'UTC' }).format(Date.UTC(2024, 0, d)).replace(/\\.$/, '')\n    return s.charAt(0).toUpperCase() + s.slice(1)\n  }\n  const time = (min: number): string => {\n    const [h, m] = hm(min)\n    return en ? `${h % 12 || 12}:${m} ${h % 24 < 12 ? 'AM' : 'PM'}` : `${h}:${m}`\n  }\n  return runs(hours)\n    .map((r) => `${name(r.from)}${r.from === r.to ? '' : '–' + name(r.to)} ${r.iv.map(([s, e]) => `${time(s)}–${time(e)}`).join(', ')}`)\n    .join(' · ')\n}\n\n/** schema.org `openingHours` strings, one per interval, e.g. `Mo-Fr 09:00-19:00`. */\nexport function toSchemaOpeningHours(hours: OpeningHours): string[] {\n  const code = ['Mo', 'Tu', 'We', 'Th', 'Fr', 'Sa', 'Su']\n  const t = (min: number): string => { const [h, m] = hm(min); return `${String(h).padStart(2, '0')}:${m}` }\n  return runs(hours).flatMap((r) =>\n    r.iv.map(([s, e]) => `${code[r.from - 1]}${r.from === r.to ? '' : '-' + code[r.to - 1]} ${t(s)}-${t(e)}`),\n  )\n}\n"]}

package/dist/geo.d.cts

@@ -0,0 +1,82 @@
+/**
+ * Geo helpers: pure TypeScript, no network and no DOM. Works in Node 20, edge
+ * runtimes and browsers. Behaviour is pinned by `geo-vectors.json`, which the
+ * Go side copies verbatim, so keep both implementations in sync.
+ */
+type GeoPoint = {
+    lat: number;
+    lng: number;
+};
+/** `(0, 0)` means "unset" on this platform, so it is never a valid point. */
+type MaybePoint = {
+    lat?: number | null;
+    lng?: number | null;
+} | null | undefined;
+type OpeningHours = {
+    /** `day`: 1 = Monday ... 7 = Sunday. Several entries per day are allowed. A `close` at or before `open` crosses midnight. */
+    weekly: {
+        day: number;
+        open: string;
+        close: string;
+    }[];
+    /** Dated overrides of the weekly rule. `closed`, or both `open` and `close`. */
+    exceptions?: {
+        date: string;
+        closed?: true;
+        open?: string;
+        close?: string;
+        note?: string;
+    }[];
+};
+type OpenStatus = {
+    open: boolean;
+    /** ISO instant (UTC) when the current interval ends; `null` when closed. */
+    closesAt: string | null;
+    /** ISO instant (UTC) of the next opening; `null` when open or none within 8 days. */
+    nextOpenAt: string | null;
+};
+/** Great-circle distance in km (haversine, earth radius 6371.0088 km). */
+declare function distanceKm(a: GeoPoint, b: GeoPoint): number;
+/** Finite, in range and not the `(0, 0)` "unset" pair. */
+declare function isValidPoint(p: MaybePoint): p is GeoPoint;
+/** `'19.43,-99.13'` (spaces allowed) to a point; `null` when malformed or invalid. */
+declare function parseLatLng(s: string | null | undefined): GeoPoint | null;
+type RankOptions<T> = {
+    /** Keep items at most this far away (inclusive). */
+    radiusKm?: number;
+    /** Keep the first N after sorting. */
+    limit?: number;
+    /** Defaults to reading `lat` / `lng` from the item. */
+    getPoint?: (item: T) => MaybePoint;
+};
+/**
+ * Sorts by distance from `origin` (stable: ties keep input order). Items without
+ * a valid point are EXCLUDED, not placed last, because they have no distance.
+ */
+declare function rankByDistance<T>(items: readonly T[], origin: GeoPoint, { radiusKm, limit, getPoint }?: RankOptions<T>): {
+    item: T;
+    distanceKm: number;
+}[];
+/** Under 1 km: meters rounded to 50 m. Otherwise km with one decimal. */
+declare function formatDistance(km: number, locale?: string): string;
+/** Destination for directions: coordinates when valid, else the address text. */
+declare function directionsUrl(location: {
+    lat?: number | null;
+    lng?: number | null;
+    address?: string | null;
+    city?: string | null;
+}, { provider }?: {
+    provider?: 'google' | 'apple' | 'geo';
+}): string | null;
+/**
+ * Whether the place is open at `now` in the IANA `timeZone` (throws RangeError
+ * for an unknown zone). Looks 8 days ahead for the next opening. Handles
+ * intervals crossing midnight, several per day, dated exceptions and DST.
+ */
+declare function openStatus(hours: OpeningHours, timeZone: string, now?: Date): OpenStatus;
+/** Compact text, e.g. `Lun–Vie 9:00–19:00 · Sáb 9:00–14:00` (24 h) or `Mon–Fri 9:00 AM–7:00 PM` (en). */
+declare function formatOpeningHours(hours: OpeningHours, locale?: string): string;
+/** schema.org `openingHours` strings, one per interval, e.g. `Mo-Fr 09:00-19:00`. */
+declare function toSchemaOpeningHours(hours: OpeningHours): string[];
+
+export { type GeoPoint, type OpenStatus, type OpeningHours, type RankOptions, directionsUrl, distanceKm, formatDistance, formatOpeningHours, isValidPoint, openStatus, parseLatLng, rankByDistance, toSchemaOpeningHours };

package/dist/geo.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Geo helpers: pure TypeScript, no network and no DOM. Works in Node 20, edge
+ * runtimes and browsers. Behaviour is pinned by `geo-vectors.json`, which the
+ * Go side copies verbatim, so keep both implementations in sync.
+ */
+type GeoPoint = {
+    lat: number;
+    lng: number;
+};
+/** `(0, 0)` means "unset" on this platform, so it is never a valid point. */
+type MaybePoint = {
+    lat?: number | null;
+    lng?: number | null;
+} | null | undefined;
+type OpeningHours = {
+    /** `day`: 1 = Monday ... 7 = Sunday. Several entries per day are allowed. A `close` at or before `open` crosses midnight. */
+    weekly: {
+        day: number;
+        open: string;
+        close: string;
+    }[];
+    /** Dated overrides of the weekly rule. `closed`, or both `open` and `close`. */
+    exceptions?: {
+        date: string;
+        closed?: true;
+        open?: string;
+        close?: string;
+        note?: string;
+    }[];
+};
+type OpenStatus = {
+    open: boolean;
+    /** ISO instant (UTC) when the current interval ends; `null` when closed. */
+    closesAt: string | null;
+    /** ISO instant (UTC) of the next opening; `null` when open or none within 8 days. */
+    nextOpenAt: string | null;
+};
+/** Great-circle distance in km (haversine, earth radius 6371.0088 km). */
+declare function distanceKm(a: GeoPoint, b: GeoPoint): number;
+/** Finite, in range and not the `(0, 0)` "unset" pair. */
+declare function isValidPoint(p: MaybePoint): p is GeoPoint;
+/** `'19.43,-99.13'` (spaces allowed) to a point; `null` when malformed or invalid. */
+declare function parseLatLng(s: string | null | undefined): GeoPoint | null;
+type RankOptions<T> = {
+    /** Keep items at most this far away (inclusive). */
+    radiusKm?: number;
+    /** Keep the first N after sorting. */
+    limit?: number;
+    /** Defaults to reading `lat` / `lng` from the item. */
+    getPoint?: (item: T) => MaybePoint;
+};
+/**
+ * Sorts by distance from `origin` (stable: ties keep input order). Items without
+ * a valid point are EXCLUDED, not placed last, because they have no distance.
+ */
+declare function rankByDistance<T>(items: readonly T[], origin: GeoPoint, { radiusKm, limit, getPoint }?: RankOptions<T>): {
+    item: T;
+    distanceKm: number;
+}[];
+/** Under 1 km: meters rounded to 50 m. Otherwise km with one decimal. */
+declare function formatDistance(km: number, locale?: string): string;
+/** Destination for directions: coordinates when valid, else the address text. */
+declare function directionsUrl(location: {
+    lat?: number | null;
+    lng?: number | null;
+    address?: string | null;
+    city?: string | null;
+}, { provider }?: {
+    provider?: 'google' | 'apple' | 'geo';
+}): string | null;
+/**
+ * Whether the place is open at `now` in the IANA `timeZone` (throws RangeError
+ * for an unknown zone). Looks 8 days ahead for the next opening. Handles
+ * intervals crossing midnight, several per day, dated exceptions and DST.
+ */
+declare function openStatus(hours: OpeningHours, timeZone: string, now?: Date): OpenStatus;
+/** Compact text, e.g. `Lun–Vie 9:00–19:00 · Sáb 9:00–14:00` (24 h) or `Mon–Fri 9:00 AM–7:00 PM` (en). */
+declare function formatOpeningHours(hours: OpeningHours, locale?: string): string;
+/** schema.org `openingHours` strings, one per interval, e.g. `Mo-Fr 09:00-19:00`. */
+declare function toSchemaOpeningHours(hours: OpeningHours): string[];
+
+export { type GeoPoint, type OpenStatus, type OpeningHours, type RankOptions, directionsUrl, distanceKm, formatDistance, formatOpeningHours, isValidPoint, openStatus, parseLatLng, rankByDistance, toSchemaOpeningHours };

package/dist/geo.js

@@ -0,0 +1,3 @@
+export { directionsUrl, distanceKm, formatDistance, formatOpeningHours, isValidPoint, openStatus, parseLatLng, rankByDistance, toSchemaOpeningHours } from './chunk-45R47HYO.js';
+//# sourceMappingURL=geo.js.map
+//# sourceMappingURL=geo.js.map

package/dist/geo.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"geo.js"}

package/dist/index.cjs

@@ -33,6 +33,10 @@ var STATUS_CODES = {
 function defaultCodeForStatus(status) {
   return STATUS_CODES[status] ?? (status >= 500 ? "server_error" : "invalid_response");
 }
+function isValidPoint(p) {
+  const { lat, lng } = p ?? {};
+  return Number.isFinite(lat) && Number.isFinite(lng) && Math.abs(lat) <= 90 && Math.abs(lng) <= 180 && !(lat === 0 && lng === 0);
+}
 
 // src/money.ts
 function parseMoney(money) {
@@ -254,6 +258,22 @@ function createStorefrontClient(config) {
       /** `null` when the collection does not exist. */
       get: (handle, options) => getOrNull(`/storefront/collections/${enc(handle)}`, void 0, options)
     },
+    locations: {
+      /** Branches of the shop. With `postal_code` they come ordered by distance (`distance_km`). */
+      list: (params, options) => get("/storefront/locations", params, options),
+      /** `null` when the branch does not exist or is not visible. */
+      get: (id, options) => getOrNull(`/storefront/locations/${enc(id)}`, void 0, options),
+      /**
+       * Branches ordered by distance to a point, closest first. The server rounds the coordinates (0.01°, ~1 km)
+       * and never stores them; this client does not log or keep them either. The answer is `private, no-store`
+       * (it depends on the buyer's position), so do not put it in a shared cache. Note `onRequest` hooks and
+       * `fetch` wrappers do see the URL: do not log it. Throws `TypeError` for an invalid point.
+       */
+      nearest: (point, options) => {
+        if (!isValidPoint(point)) throw new TypeError("locations.nearest: lat/lng must be a valid point");
+        return get("/storefront/locations/nearest", { lat: point.lat, lng: point.lng }, { cache: "no-store", ...options });
+      }
+    },
     stock: {
       /** Stock for up to 250 SKUs. */
       get: (skus, options) => get("/storefront/stock", { sku: skus }, options)