googlemaps-kit 0.1.3 → 0.2.0

package/dist/types/hooks.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Lifecycle hooks + progress events for Intent / HTTP.
+ */
+export type HookActionType = 'discover' | 'discoverPages' | 'resolve' | 'profile' | 'profileMany' | 'route' | 'opinions' | 'opinionsPages' | 'media' | 'mediaMany' | 'pipeline' | 'http.get' | 'http.getBytes' | 'batchexecute';
+export interface HookActionEvent {
+    type: HookActionType | string;
+    status: 'ok' | 'error';
+    durationMs: number;
+    error?: unknown;
+}
+export interface HookRetryEvent {
+    type: HookActionType | string;
+    attempt: number;
+    delayMs?: number;
+    error?: unknown;
+}
+export interface HookErrorEvent {
+    type: HookActionType | string;
+    error: unknown;
+}
+/** Wire once on `sdk({ hooks })` — fire-and-forget, never blocks the call. */
+export interface GMapsHooks {
+    onAction?: (event: HookActionEvent) => void;
+    onRetry?: (event: HookRetryEvent) => void;
+    onError?: (event: HookErrorEvent) => void;
+}
+export interface ProgressEvent {
+    /** Logical operation, e.g. `discover`, `opinions`, `profileMany`. */
+    type: string;
+    /** 1-based page / item index when known. */
+    index?: number;
+    /** Total pages / items when known. */
+    total?: number;
+    /** Items accumulated so far. */
+    loaded?: number;
+    /** Opaque key (place hexId, page offset, …). */
+    key?: string;
+    done?: boolean;
+}
+export type ProgressCallback = (event: ProgressEvent) => void;
+/** Optional in-memory TTL cache for Intent reads. */
+export interface GMapsCacheOptions {
+    /** Entry lifetime in ms (default 60_000). */
+    ttlMs?: number;
+    /** Max entries before LRU eviction (default 256). */
+    maxEntries?: number;
+}
+//# sourceMappingURL=hooks.d.ts.map

package/dist/types/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/types/hooks.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,cAAc,GACtB,UAAU,GACV,eAAe,GACf,SAAS,GACT,SAAS,GACT,aAAa,GACb,OAAO,GACP,UAAU,GACV,eAAe,GACf,OAAO,GACP,WAAW,GACX,UAAU,GACV,UAAU,GACV,eAAe,GACf,cAAc,CAAC;AAEnB,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,cAAc,GAAG,MAAM,CAAC;IAC9B,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,cAAc,GAAG,MAAM,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,cAAc,GAAG,MAAM,CAAC;IAC9B,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IAC5C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IAC1C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;AAE9D,qDAAqD;AACrD,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/types/hooks.js

@@ -0,0 +1,5 @@
+/**
+ * Lifecycle hooks + progress events for Intent / HTTP.
+ */
+export {};
+//# sourceMappingURL=hooks.js.map

package/dist/types/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/types/hooks.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/utils/abort.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Abort helpers shared by HTTP, Intent, and CLI.
+ */
+export declare function throwIfAborted(signal?: AbortSignal): void;
+/** Sleep that rejects when the signal aborts. */
+export declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;
+//# sourceMappingURL=abort.d.ts.map

package/dist/utils/abort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.d.ts","sourceRoot":"","sources":["../../src/utils/abort.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAOzD;AAED,iDAAiD;AACjD,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBrE"}

package/dist/utils/abort.js

@@ -0,0 +1,43 @@
+/**
+ * Abort helpers shared by HTTP, Intent, and CLI.
+ */
+import { GMapsError } from '../types/common.js';
+export function throwIfAborted(signal) {
+    if (!signal)
+        return;
+    if (signal.aborted) {
+        const reason = signal.reason;
+        if (reason instanceof Error)
+            throw reason;
+        throw new GMapsError(typeof reason === 'string' ? reason : 'Aborted', undefined, reason);
+    }
+}
+/** Sleep that rejects when the signal aborts. */
+export function sleep(ms, signal) {
+    if (ms <= 0) {
+        throwIfAborted(signal);
+        return Promise.resolve();
+    }
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(abortError(signal));
+            return;
+        }
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(abortError(signal));
+        };
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+function abortError(signal) {
+    const reason = signal?.reason;
+    if (reason instanceof Error)
+        return reason;
+    return new GMapsError(typeof reason === 'string' ? reason : 'Aborted', undefined, reason);
+}
+//# sourceMappingURL=abort.js.map

package/dist/utils/abort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.js","sourceRoot":"","sources":["../../src/utils/abort.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,MAAM,UAAU,cAAc,CAAC,MAAoB;IACjD,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC7B,IAAI,MAAM,YAAY,KAAK;YAAE,MAAM,MAAM,CAAC;QAC1C,MAAM,IAAI,UAAU,CAAC,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAC3F,CAAC;AACH,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,KAAK,CAAC,EAAU,EAAE,MAAoB;IACpD,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;QACZ,cAAc,CAAC,MAAM,CAAC,CAAC;QACvB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IACD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;YAC3B,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9C,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7B,CAAC,CAAC;QACF,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,UAAU,CAAC,MAAoB;IACtC,MAAM,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC;IAC9B,IAAI,MAAM,YAAY,KAAK;QAAE,OAAO,MAAM,CAAC;IAC3C,OAAO,IAAI,UAAU,CAAC,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;AAC5F,CAAC"}

package/dist/utils/coords.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Shared coordinate helpers — aliases between lat/lng and latitude/longitude.
+ */
+export interface CoordFields {
+    latitude?: number;
+    longitude?: number;
+    lat?: number;
+    lng?: number;
+}
+export interface CoordinatesLike {
+    lat: number;
+    lng: number;
+}
+/** Copy latitude↔lat and longitude↔lng so both spellings are populated. */
+export declare function applyCoordAliases<T extends CoordFields>(obj: T): T;
+/**
+ * Normalize any coords-shaped object to `{ lat, lng }`.
+ * Accepts `lat`/`lng` or `latitude`/`longitude`.
+ */
+export declare function toCoordinates(value: CoordFields | {
+    lat: number;
+    lng: number;
+} | null | undefined): CoordinatesLike | undefined;
+//# sourceMappingURL=coords.d.ts.map

package/dist/utils/coords.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coords.d.ts","sourceRoot":"","sources":["../../src/utils/coords.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,WAAW,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAYlE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,WAAW,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,GACnE,eAAe,GAAG,SAAS,CAa7B"}

package/dist/utils/coords.js

@@ -0,0 +1,37 @@
+/**
+ * Shared coordinate helpers — aliases between lat/lng and latitude/longitude.
+ */
+/** Copy latitude↔lat and longitude↔lng so both spellings are populated. */
+export function applyCoordAliases(obj) {
+    const lat = obj.lat ?? obj.latitude;
+    const lng = obj.lng ?? obj.longitude;
+    if (lat != null) {
+        obj.lat = lat;
+        obj.latitude = lat;
+    }
+    if (lng != null) {
+        obj.lng = lng;
+        obj.longitude = lng;
+    }
+    return obj;
+}
+/**
+ * Normalize any coords-shaped object to `{ lat, lng }`.
+ * Accepts `lat`/`lng` or `latitude`/`longitude`.
+ */
+export function toCoordinates(value) {
+    if (!value || typeof value !== 'object')
+        return undefined;
+    const lat = 'lat' in value && typeof value.lat === 'number'
+        ? value.lat
+        : value.latitude;
+    const lng = 'lng' in value && typeof value.lng === 'number'
+        ? value.lng
+        : value.longitude;
+    if (typeof lat !== 'number' || typeof lng !== 'number')
+        return undefined;
+    if (!Number.isFinite(lat) || !Number.isFinite(lng))
+        return undefined;
+    return { lat, lng };
+}
+//# sourceMappingURL=coords.js.map

package/dist/utils/coords.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coords.js","sourceRoot":"","sources":["../../src/utils/coords.ts"],"names":[],"mappings":"AAAA;;GAEG;AAcH,2EAA2E;AAC3E,MAAM,UAAU,iBAAiB,CAAwB,GAAM;IAC7D,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC;IACpC,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC;IACrC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAChB,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC;QACd,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC;IACrB,CAAC;IACD,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAChB,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC;QACd,GAAG,CAAC,SAAS,GAAG,GAAG,CAAC;IACtB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAoE;IAEpE,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC1D,MAAM,GAAG,GACP,KAAK,IAAI,KAAK,IAAI,OAAQ,KAA2B,CAAC,GAAG,KAAK,QAAQ;QACpE,CAAC,CAAE,KAAyB,CAAC,GAAG;QAChC,CAAC,CAAE,KAAqB,CAAC,QAAQ,CAAC;IACtC,MAAM,GAAG,GACP,KAAK,IAAI,KAAK,IAAI,OAAQ,KAA2B,CAAC,GAAG,KAAK,QAAQ;QACpE,CAAC,CAAE,KAAyB,CAAC,GAAG;QAChC,CAAC,CAAE,KAAqB,CAAC,SAAS,CAAC;IACvC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACzE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IACrE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AACtB,CAAC"}

package/dist/utils/export-results.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Export helpers for discover / place results (CSV + GeoJSON).
+ */
+import type { PlaceDetails, SearchResult } from '../types/common.js';
+import type { PlaceProfile } from '../types/dx.js';
+export type ExportablePlace = SearchResult | PlaceDetails | PlaceProfile;
+/** Flat CSV for spreadsheets / agents. */
+export declare function toCsv(rows: ExportablePlace[]): string;
+export interface GeoJsonFeatureCollection {
+    type: 'FeatureCollection';
+    features: Array<{
+        type: 'Feature';
+        geometry: {
+            type: 'Point';
+            coordinates: [number, number];
+        } | null;
+        properties: Record<string, unknown>;
+    }>;
+}
+/** GeoJSON FeatureCollection (skips rows without coords unless includeMissing). */
+export declare function toGeoJSON(rows: ExportablePlace[], options?: {
+    includeMissing?: boolean;
+}): GeoJsonFeatureCollection;
+//# sourceMappingURL=export-results.d.ts.map

package/dist/utils/export-results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-results.d.ts","sourceRoot":"","sources":["../../src/utils/export-results.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,YAAY,GAAG,YAAY,CAAC;AAoDzE,0CAA0C;AAC1C,wBAAgB,KAAK,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,MAAM,CAoCrD;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,SAAS,CAAC;QAChB,QAAQ,EAAE;YAAE,IAAI,EAAE,OAAO,CAAC;YAAC,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;SAAE,GAAG,IAAI,CAAC;QAClE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC,CAAC,CAAC;CACJ;AAED,mFAAmF;AACnF,wBAAgB,SAAS,CACvB,IAAI,EAAE,eAAe,EAAE,EACvB,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,GACzC,wBAAwB,CAyB1B"}

package/dist/utils/export-results.js

@@ -0,0 +1,105 @@
+/**
+ * Export helpers for discover / place results (CSV + GeoJSON).
+ */
+function asPlaceFields(row) {
+    if ('place' in row && row.place) {
+        const p = row.place;
+        return {
+            name: p.name,
+            hexId: p.hexId,
+            placeId: p.placeId,
+            address: p.address,
+            lat: p.lat ?? p.latitude,
+            lng: p.lng ?? p.longitude,
+            rating: p.rating,
+            reviewCount: p.reviewCount,
+            phone: p.phone,
+            website: p.website,
+            category: p.categories?.[0],
+        };
+    }
+    const r = row;
+    return {
+        name: r.name,
+        hexId: r.hexId,
+        placeId: r.placeId,
+        address: r.address,
+        lat: r.lat ?? r.latitude,
+        lng: r.lng ?? r.longitude,
+        rating: r.rating,
+        reviewCount: r.reviewCount,
+        phone: r.phone,
+        website: r.website,
+        category: 'category' in r ? r.category : r.categories?.[0],
+    };
+}
+function csvEscape(value) {
+    if (/[",\n\r]/.test(value))
+        return `"${value.replace(/"/g, '""')}"`;
+    return value;
+}
+/** Flat CSV for spreadsheets / agents. */
+export function toCsv(rows) {
+    const header = [
+        'name',
+        'hexId',
+        'placeId',
+        'address',
+        'lat',
+        'lng',
+        'rating',
+        'reviewCount',
+        'phone',
+        'website',
+        'category',
+    ];
+    const lines = [header.join(',')];
+    for (const row of rows) {
+        const f = asPlaceFields(row);
+        lines.push([
+            f.name ?? '',
+            f.hexId ?? '',
+            f.placeId ?? '',
+            f.address ?? '',
+            f.lat ?? '',
+            f.lng ?? '',
+            f.rating ?? '',
+            f.reviewCount ?? '',
+            f.phone ?? '',
+            f.website ?? '',
+            f.category ?? '',
+        ]
+            .map((v) => csvEscape(String(v)))
+            .join(','));
+    }
+    return lines.join('\n');
+}
+/** GeoJSON FeatureCollection (skips rows without coords unless includeMissing). */
+export function toGeoJSON(rows, options = {}) {
+    const features = [];
+    for (const row of rows) {
+        const f = asPlaceFields(row);
+        const hasCoords = f.lat != null && f.lng != null;
+        if (!hasCoords && !options.includeMissing)
+            continue;
+        features.push({
+            type: 'Feature',
+            geometry: hasCoords
+                ? { type: 'Point', coordinates: [f.lng, f.lat] }
+                : null,
+            properties: {
+                name: f.name,
+                hexId: f.hexId,
+                placeId: f.placeId,
+                address: f.address,
+                rating: f.rating,
+                reviewCount: f.reviewCount,
+                phone: f.phone,
+                website: f.website,
+                category: f.category,
+            },
+        });
+    }
+    return { type: 'FeatureCollection', features };
+}
+//# sourceMappingURL=export-results.js.map

package/dist/utils/export-results.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-results.js","sourceRoot":"","sources":["../../src/utils/export-results.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,SAAS,aAAa,CAAC,GAAoB;IAazC,IAAI,OAAO,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QAChC,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC;QACpB,OAAO;YACL,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,QAAQ;YACxB,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,SAAS;YACzB,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,QAAQ,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;SAC5B,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,GAAG,GAAkC,CAAC;IAC7C,OAAO;QACL,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,QAAQ;QACxB,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,SAAS;QACzB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,QAAQ,EAAE,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;KAC3D,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;IACpE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,KAAK,CAAC,IAAuB;IAC3C,MAAM,MAAM,GAAG;QACb,MAAM;QACN,OAAO;QACP,SAAS;QACT,SAAS;QACT,KAAK;QACL,KAAK;QACL,QAAQ;QACR,aAAa;QACb,OAAO;QACP,SAAS;QACT,UAAU;KACX,CAAC;IACF,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;QAC7B,KAAK,CAAC,IAAI,CACR;YACE,CAAC,CAAC,IAAI,IAAI,EAAE;YACZ,CAAC,CAAC,KAAK,IAAI,EAAE;YACb,CAAC,CAAC,OAAO,IAAI,EAAE;YACf,CAAC,CAAC,OAAO,IAAI,EAAE;YACf,CAAC,CAAC,GAAG,IAAI,EAAE;YACX,CAAC,CAAC,GAAG,IAAI,EAAE;YACX,CAAC,CAAC,MAAM,IAAI,EAAE;YACd,CAAC,CAAC,WAAW,IAAI,EAAE;YACnB,CAAC,CAAC,KAAK,IAAI,EAAE;YACb,CAAC,CAAC,OAAO,IAAI,EAAE;YACf,CAAC,CAAC,QAAQ,IAAI,EAAE;SACjB;aACE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;aAChC,IAAI,CAAC,GAAG,CAAC,CACb,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAWD,mFAAmF;AACnF,MAAM,UAAU,SAAS,CACvB,IAAuB,EACvB,UAAwC,EAAE;IAE1C,MAAM,QAAQ,GAAyC,EAAE,CAAC;IAC1D,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,SAAS,GAAG,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC;QACjD,IAAI,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC,cAAc;YAAE,SAAS;QACpD,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,SAAS;gBACjB,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,GAAI,EAAE,CAAC,CAAC,GAAI,CAAC,EAAE;gBAClD,CAAC,CAAC,IAAI;YACR,UAAU,EAAE;gBACV,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,QAAQ,EAAE,CAAC,CAAC,QAAQ;aACrB;SACF,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,CAAC;AACjD,CAAC"}

package/dist/utils/hooks.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Fire lifecycle hooks without letting user callbacks break the call path.
+ */
+import type { GMapsHooks, HookActionEvent, HookErrorEvent, HookRetryEvent } from '../types/hooks.js';
+export declare function fireAction(hooks: GMapsHooks | undefined, event: HookActionEvent): void;
+export declare function fireRetry(hooks: GMapsHooks | undefined, event: HookRetryEvent): void;
+export declare function fireError(hooks: GMapsHooks | undefined, event: HookErrorEvent): void;
+/** Wrap an Intent call with onAction / onError timing. */
+export declare function withActionHook<T>(hooks: GMapsHooks | undefined, type: string, fn: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/utils/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/utils/hooks.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAErG,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAMtF;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI,CAMpF;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI,CAMpF;AAED,0DAA0D;AAC1D,wBAAsB,cAAc,CAAC,CAAC,EACpC,KAAK,EAAE,UAAU,GAAG,SAAS,EAC7B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAgBZ"}

package/dist/utils/hooks.js

@@ -0,0 +1,47 @@
+/**
+ * Fire lifecycle hooks without letting user callbacks break the call path.
+ */
+export function fireAction(hooks, event) {
+    try {
+        hooks?.onAction?.(event);
+    }
+    catch {
+        // ignore hook failures
+    }
+}
+export function fireRetry(hooks, event) {
+    try {
+        hooks?.onRetry?.(event);
+    }
+    catch {
+        // ignore
+    }
+}
+export function fireError(hooks, event) {
+    try {
+        hooks?.onError?.(event);
+    }
+    catch {
+        // ignore
+    }
+}
+/** Wrap an Intent call with onAction / onError timing. */
+export async function withActionHook(hooks, type, fn) {
+    const start = performance.now();
+    try {
+        const result = await fn();
+        fireAction(hooks, { type, status: 'ok', durationMs: performance.now() - start });
+        return result;
+    }
+    catch (error) {
+        fireAction(hooks, {
+            type,
+            status: 'error',
+            durationMs: performance.now() - start,
+            error,
+        });
+        fireError(hooks, { type, error });
+        throw error;
+    }
+}
+//# sourceMappingURL=hooks.js.map

package/dist/utils/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/utils/hooks.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,UAAU,UAAU,CAAC,KAA6B,EAAE,KAAsB;IAC9E,IAAI,CAAC;QACH,KAAK,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,uBAAuB;IACzB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAA6B,EAAE,KAAqB;IAC5E,IAAI,CAAC;QACH,KAAK,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,SAAS;IACX,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAA6B,EAAE,KAAqB;IAC5E,IAAI,CAAC;QACH,KAAK,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,SAAS;IACX,CAAC;AACH,CAAC;AAED,0DAA0D;AAC1D,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAA6B,EAC7B,IAAY,EACZ,EAAoB;IAEpB,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;QAC1B,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;QACjF,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,UAAU,CAAC,KAAK,EAAE;YAChB,IAAI;YACJ,MAAM,EAAE,OAAO;YACf,UAAU,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK;YACrC,KAAK;SACN,CAAC,CAAC;QACH,SAAS,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAClC,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/utils/place-ref.d.ts

@@ -0,0 +1,39 @@
+/**
+ * PlaceRef + route endpoint normalization (shared by Intent API and services).
+ */
+import type { Coordinates } from '../types/common.js';
+import type { NormalizedPlaceRef, PlaceRef } from '../types/dx.js';
+/**
+ * Normalize a PlaceRef for service calls.
+ * Accepts: hexId string, ChIJ placeId string, or object with hexId and/or placeId.
+ */
+export declare function normalizePlaceRef(ref: PlaceRef): NormalizedPlaceRef;
+/** Resolve route endpoint: address string, coords, or PlaceRef with coords. */
+export declare function resolveRouteEndpoint(value: string | Coordinates | PlaceRef | CoordLoose): string | Coordinates;
+type CoordLoose = {
+    lat?: number;
+    lng?: number;
+    latitude?: number;
+    longitude?: number;
+};
+/**
+ * Resolve search bias center from Intent (`near`) or service (`location`) spelling.
+ */
+export declare function resolveSearchCenter(options: {
+    near?: Coordinates | CoordLoose;
+    location?: Coordinates | CoordLoose;
+}): Coordinates;
+/**
+ * Resolve directions endpoints from Intent (`from`/`to`) or service (`origin`/`destination`).
+ */
+export declare function resolveDirectionsEndpoints(options: {
+    from?: string | Coordinates | PlaceRef;
+    to?: string | Coordinates | PlaceRef;
+    origin?: string | Coordinates | PlaceRef;
+    destination?: string | Coordinates | PlaceRef;
+}): {
+    origin: string | Coordinates;
+    destination: string | Coordinates;
+};
+export {};
+//# sourceMappingURL=place-ref.d.ts.map

package/dist/utils/place-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"place-ref.d.ts","sourceRoot":"","sources":["../../src/utils/place-ref.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAenE;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,QAAQ,GAAG,kBAAkB,CAiDnE;AAED,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,GAClD,MAAM,GAAG,WAAW,CAgCtB;AAED,KAAK,UAAU,GAAG;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,IAAI,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC;IAChC,QAAQ,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC;CACrC,GAAG,WAAW,CAQd;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE;IAClD,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACvC,EAAE,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACzC,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;CAC/C,GAAG;IAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAAA;CAAE,CAYtE"}

package/dist/utils/place-ref.js

@@ -0,0 +1,109 @@
+/**
+ * PlaceRef + route endpoint normalization (shared by Intent API and services).
+ */
+import { GMapsError } from '../types/common.js';
+import { placeIdToFeatureId } from './ids.js';
+import { toCoordinates } from './coords.js';
+const HEX_ID_RE = /^0x[0-9a-f]+:0x[0-9a-f]+$/i;
+const PLACE_ID_RE = /^ChIJ[\w-]+$/;
+function tryPlaceIdToHex(placeId) {
+    try {
+        return placeIdToFeatureId(placeId);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Normalize a PlaceRef for service calls.
+ * Accepts: hexId string, ChIJ placeId string, or object with hexId and/or placeId.
+ */
+export function normalizePlaceRef(ref) {
+    if (typeof ref === 'string') {
+        const trimmed = ref.trim();
+        if (!trimmed) {
+            throw new GMapsError('PlaceRef string must be a non-empty hexId or placeId');
+        }
+        if (HEX_ID_RE.test(trimmed)) {
+            return { hexId: trimmed };
+        }
+        if (PLACE_ID_RE.test(trimmed)) {
+            const hexId = tryPlaceIdToHex(trimmed);
+            if (!hexId) {
+                throw new GMapsError(`Could not convert placeId to hexId: ${trimmed}`);
+            }
+            return { hexId, placeId: trimmed };
+        }
+        throw new GMapsError('PlaceRef string must be a hexId (0x…:0x…) or ChIJ placeId — got an unrecognized id');
+    }
+    let hexId = ref.hexId?.trim();
+    const placeId = ref.placeId?.trim();
+    if (!hexId && placeId) {
+        hexId = tryPlaceIdToHex(placeId);
+        if (!hexId) {
+            throw new GMapsError(`PlaceRef has placeId but could not convert to hexId: ${placeId}`);
+        }
+    }
+    if (!hexId) {
+        throw new GMapsError('PlaceRef requires hexId (0x…:0x…) or placeId (ChIJ…). ' +
+            'If you called resolve(), check that the result includes hexId before profile/media/opinions.');
+    }
+    return {
+        hexId,
+        name: ref.name,
+        lat: ref.lat ?? ref.latitude,
+        lng: ref.lng ?? ref.longitude,
+        placeId: placeId ?? ref.placeId,
+        ftid: ref.ftid,
+        reviewCount: ref.reviewCount,
+    };
+}
+/** Resolve route endpoint: address string, coords, or PlaceRef with coords. */
+export function resolveRouteEndpoint(value) {
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        if (HEX_ID_RE.test(trimmed)) {
+            throw new GMapsError('Route endpoint cannot be a bare hexId — pass { lat, lng }, a PlaceRef with coords, or an address string');
+        }
+        if (PLACE_ID_RE.test(trimmed)) {
+            throw new GMapsError('Route endpoint cannot be a bare placeId — pass { lat, lng } or an address string');
+        }
+        return value;
+    }
+    if (typeof value === 'object' && value !== null && 'hexId' in value && value.hexId) {
+        const place = normalizePlaceRef(value);
+        if (place.lat == null || place.lng == null) {
+            throw new GMapsError('PlaceRef route endpoint requires lat/lng (or latitude/longitude). Profile the place first or pass an address.');
+        }
+        return { lat: place.lat, lng: place.lng };
+    }
+    const coords = toCoordinates(value);
+    if (coords)
+        return coords;
+    throw new GMapsError('Invalid route endpoint — expected address string, { lat, lng }, or PlaceRef with coordinates');
+}
+/**
+ * Resolve search bias center from Intent (`near`) or service (`location`) spelling.
+ */
+export function resolveSearchCenter(options) {
+    const coords = toCoordinates(options.near) ?? toCoordinates(options.location);
+    if (!coords) {
+        throw new GMapsError('Search requires a bias center — pass near: { lat, lng } (Intent) or location: { lat, lng } (search service)');
+    }
+    return coords;
+}
+/**
+ * Resolve directions endpoints from Intent (`from`/`to`) or service (`origin`/`destination`).
+ */
+export function resolveDirectionsEndpoints(options) {
+    const originRaw = options.from ?? options.origin;
+    const destRaw = options.to ?? options.destination;
+    if (originRaw == null || destRaw == null) {
+        throw new GMapsError('Directions require from/to (Intent) or origin/destination (directions service)');
+    }
+    return {
+        origin: resolveRouteEndpoint(originRaw),
+        destination: resolveRouteEndpoint(destRaw),
+    };
+}
+//# sourceMappingURL=place-ref.js.map

package/dist/utils/place-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"place-ref.js","sourceRoot":"","sources":["../../src/utils/place-ref.ts"],"names":[],"mappings":"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"}

package/dist/utils/pooled.d.ts

@@ -2,5 +2,7 @@
  * Run async tasks with bounded concurrency (same pattern as scripts/capture-maps-all.ts).
  */
 export declare function pooled<T>(items: T[], limit: number, worker: (item: T, index: number) => Promise<void>): Promise<void>;
+/** Like {@link pooled} but collects return values in input order. */
+export declare function pooledMap<T, R>(items: T[], limit: number, worker: (item: T, index: number) => Promise<R>): Promise<R[]>;
 export declare function sleep(ms: number): Promise<void>;
 //# sourceMappingURL=pooled.d.ts.map

package/dist/utils/pooled.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pooled.d.ts","sourceRoot":"","sources":["../../src/utils/pooled.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAsB,MAAM,CAAC,CAAC,EAC5B,KAAK,EAAE,CAAC,EAAE,EACV,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAChD,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}
+{"version":3,"file":"pooled.d.ts","sourceRoot":"","sources":["../../src/utils/pooled.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAsB,MAAM,CAAC,CAAC,EAC5B,KAAK,EAAE,CAAC,EAAE,EACV,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAChD,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,qEAAqE;AACrE,wBAAsB,SAAS,CAAC,CAAC,EAAE,CAAC,EAClC,KAAK,EAAE,CAAC,EAAE,EACV,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAC7C,OAAO,CAAC,CAAC,EAAE,CAAC,CAMd;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/dist/utils/pooled.js

@@ -13,6 +13,14 @@ export async function pooled(items, limit, worker) {
     });
     await Promise.all(runners);
 }
+/** Like {@link pooled} but collects return values in input order. */
+export async function pooledMap(items, limit, worker) {
+    const results = new Array(items.length);
+    await pooled(items, limit, async (item, index) => {
+        results[index] = await worker(item, index);
+    });
+    return results;
+}
 export function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }

package/dist/utils/pooled.js.map

@@ -1 +1 @@
-{"version":3,"file":"pooled.js","sourceRoot":"","sources":["../../src/utils/pooled.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,KAAU,EACV,KAAa,EACb,MAAiD;IAEjD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAE/B,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,IAAI,EAAE;QAC/E,OAAO,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC;YACvB,MAAM,MAAM,CAAC,KAAK,CAAC,KAAK,CAAE,EAAE,KAAK,CAAC,CAAC;QACrC,CAAC;IACH,CAAC,CAAC,CAAC;IACH,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}
+{"version":3,"file":"pooled.js","sourceRoot":"","sources":["../../src/utils/pooled.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,KAAU,EACV,KAAa,EACb,MAAiD;IAEjD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAE/B,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,IAAI,EAAE;QAC/E,OAAO,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC;YACvB,MAAM,MAAM,CAAC,KAAK,CAAC,KAAK,CAAE,EAAE,KAAK,CAAC,CAAC;QACrC,CAAC;IACH,CAAC,CAAC,CAAC;IACH,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED,qEAAqE;AACrE,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,KAAU,EACV,KAAa,EACb,MAA8C;IAE9C,MAAM,OAAO,GAAG,IAAI,KAAK,CAAI,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QAC/C,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/utils/request-context.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Per-async-call request context (AbortSignal) without threading through every service.
+ */
+export interface RequestContext {
+    signal?: AbortSignal;
+}
+export declare function runWithRequestContext<T>(ctx: RequestContext, fn: () => Promise<T>): Promise<T>;
+export declare function getRequestSignal(): AbortSignal | undefined;
+//# sourceMappingURL=request-context.d.ts.map

package/dist/utils/request-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.d.ts","sourceRoot":"","sources":["../../src/utils/request-context.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAID,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,GAAG,EAAE,cAAc,EACnB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAEZ;AAED,wBAAgB,gBAAgB,IAAI,WAAW,GAAG,SAAS,CAE1D"}

package/dist/utils/request-context.js

@@ -0,0 +1,12 @@
+/**
+ * Per-async-call request context (AbortSignal) without threading through every service.
+ */
+import { AsyncLocalStorage } from 'node:async_hooks';
+const store = new AsyncLocalStorage();
+export function runWithRequestContext(ctx, fn) {
+    return store.run(ctx, fn);
+}
+export function getRequestSignal() {
+    return store.getStore()?.signal;
+}
+//# sourceMappingURL=request-context.js.map

package/dist/utils/request-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.js","sourceRoot":"","sources":["../../src/utils/request-context.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAMrD,MAAM,KAAK,GAAG,IAAI,iBAAiB,EAAkB,CAAC;AAEtD,MAAM,UAAU,qBAAqB,CACnC,GAAmB,EACnB,EAAoB;IAEpB,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,KAAK,CAAC,QAAQ,EAAE,EAAE,MAAM,CAAC;AAClC,CAAC"}