googlemaps-kit 0.1.3 → 0.2.1

package/dist/types/dx.d.ts

@@ -0,0 +1,289 @@
+/**
+ * Developer-experience types: PlaceRef, Intent API options, client capabilities.
+ *
+ * Intent methods return these shapes so agents/devs always know where fields live.
+ */
+import type { Coordinates, KnowledgeEntity, LocalPost, PlaceDetails, PlaceFullMeta, ReviewsResult, SearchMode, SearchResult, TravelMode } from './common.js';
+import type { SearchClientFilters } from './search-filters.js';
+import type { ReviewClientFilters } from './reviews.js';
+import type { PhotoCategory, PlacePhoto, PhotosSource } from './photos.js';
+import type { PanoramaRef } from './panorama.js';
+import type { DirectionsResult } from './directions.js';
+import type { ProgressCallback } from './hooks.js';
+/** Shared cancellation / progress knobs for Intent methods. */
+export interface IntentCallOptions {
+    /** Cancel in-flight HTTP when aborted. */
+    signal?: AbortSignal;
+    /** Progress for multi-page / multi-item work. */
+    onProgress?: ProgressCallback;
+}
+/** Session profile selected at client construction. */
+export type SessionMode = 'anonymous' | 'authenticated';
+/**
+ * Profile depth for Intent `profile()`.
+ * - `card` — place details only (~1 parallel preview+enrich round-trip)
+ * - `full` — details + reviews (+ optional local posts)
+ * - `complete` — full + knowledge fallback
+ */
+export type ProfileDepth = 'card' | 'full' | 'complete';
+/** Review transport for Intent `opinions()` / `reviews.list({ source })`. */
+export type ReviewSource = 'auto' | 'boq' | 'embedded' | 'rpc';
+/**
+ * Stable place identity. Prefer hexId; ChIJ placeId is auto-converted.
+ * Accepts `lat`/`lng` (preferred) or search-row `latitude`/`longitude`.
+ */
+export type PlaceRef = string | {
+    hexId?: string;
+    name?: string;
+    lat?: number;
+    lng?: number;
+    /** Search-row alias for lat. */
+    latitude?: number;
+    /** Search-row alias for lng. */
+    longitude?: number;
+    placeId?: string;
+    ftid?: string;
+    /**
+     * When set (e.g. from a search hit), profile skips incomplete-payload retry —
+     * saves ~400–900 ms on truncated previews.
+     */
+    reviewCount?: number;
+};
+export interface NormalizedPlaceRef {
+    hexId: string;
+    name?: string;
+    lat?: number;
+    lng?: number;
+    placeId?: string;
+    ftid?: string;
+    reviewCount?: number;
+}
+/** Capability flags for `maps.capabilities()`. */
+export interface ClientCapabilities {
+    session: SessionMode;
+    signedIn: boolean;
+    search: true;
+    placeDetails: true;
+    reviewsBoq: true;
+    reviewsRpc: boolean;
+    photos: true;
+    directions: true;
+    askMaps: boolean;
+    askMapsHistory: boolean;
+    privateLists: boolean;
+    legacyRpc: boolean;
+}
+export type AuthCapability = keyof Pick<ClientCapabilities, 'askMaps' | 'askMapsHistory' | 'reviewsRpc' | 'privateLists' | 'legacyRpc'>;
+/** Input for `maps.discover()`. */
+export interface DiscoverOptions extends IntentCallOptions {
+    /** Free-text query, e.g. "coffee" or "cafes in indiranagar". */
+    query: string;
+    /**
+     * Bias center (Intent spelling). Required unless `location` is set.
+     * Same meaning as search service `location`.
+     */
+    near?: Coordinates;
+    /**
+     * Alias for `near` — accepted so agents can copy search-service examples.
+     */
+    location?: Coordinates;
+    /**
+     * `fast` (default) — ~5 rows, name/rating/coords/thumbnail, ~400 ms warm.
+     * `full` — up to 20 rows with hours/phone/attributes.
+     */
+    mode?: SearchMode;
+    limit?: number;
+    radiusMeters?: number;
+    /** Pagination offset (pass `pagination.nextOffset` from a prior discover). */
+    offset?: number;
+    /** Session token from a prior page (`pagination` does not expose psi — use searchPage for psi). */
+    psi?: string;
+    filters?: SearchClientFilters;
+}
+/** Input for `maps.discoverPages()` / multi-page discover. */
+export interface DiscoverPagesOptions extends DiscoverOptions {
+    /** Max search pages to yield (default 5). */
+    maxPages?: number;
+}
+/**
+ * Output of `maps.discover()`.
+ *
+ * @example
+ * const { places, timingMs } = await maps.discover({ query: 'coffee', near });
+ * const top = places[0]!; // { name, hexId, rating, lat, lng, thumbnailUrl, … }
+ */
+export interface DiscoverResult {
+    places: SearchResult[];
+    /** Wall time for the single search request. */
+    timingMs: number;
+    /** Effective mode used for this call. */
+    mode: SearchMode;
+    pagination: {
+        offset: number;
+        pageSize: number;
+        hasMore: boolean;
+        nextOffset?: number;
+        psi?: string;
+    };
+}
+/** Input for `maps.resolve()`. */
+export interface ResolveOptions extends IntentCallOptions {
+    /** Free-text query (geocode / suggest / search). */
+    query?: string;
+    /** Short or full Maps URL. */
+    url?: string;
+    /** Bias for suggest / search (strongly recommended for queries). */
+    near?: Coordinates;
+    /** Alias for `near`. */
+    location?: Coordinates;
+}
+/**
+ * Output of `maps.resolve()` — identity only, not a full place card.
+ * Call `profile(resolved)` next when you need hours/phone/photos.
+ *
+ * Always check `hexId` (or `placeId`) before profile/media — viewport-only
+ * URL resolves may return coords without an id.
+ */
+export interface ResolvedPlace {
+    hexId?: string;
+    placeId?: string;
+    name?: string;
+    address?: string;
+    lat?: number;
+    lng?: number;
+    ftid?: string;
+    source: 'url' | 'geocode' | 'suggest' | 'search';
+}
+/** Input for `maps.profile()`. */
+export interface ProfileOptions extends IntentCallOptions {
+    /**
+     * `card` (default) — place details only.
+     * `full` — + reviews (local posts off unless `includeLocalPosts: true`).
+     * `complete` — + knowledge fallback.
+     */
+    depth?: ProfileDepth;
+    maxReviewPages?: number;
+    includeLocalPosts?: boolean;
+}
+/** Input for `maps.profileMany()`. */
+export interface ProfileManyOptions extends ProfileOptions {
+    /** Max parallel profiles (default client concurrency). */
+    concurrency?: number;
+}
+/**
+ * Output of `maps.profile()` — always the same shape.
+ * Place fields live under `place` at every depth (never a bare PlaceDetails union).
+ *
+ * Wrong: `profile().name` — Right: `profile().place.name`
+ * (Contrast: `maps.places.get()` returns bare PlaceDetails.)
+ *
+ * @example
+ * const { place, reviews, depth } = await maps.profile(hit, { depth: 'full' });
+ * console.log(place.name, place.rating, reviews?.totalReviews ?? reviews?.reviews.length);
+ */
+export interface PlaceProfile {
+    /** Place card fields (name, rating, hours, photos URLs, …). */
+    place: PlaceDetails;
+    /** Present when depth is `full` or `complete`. */
+    reviews?: ReviewsResult;
+    localPosts?: LocalPost[];
+    /** Present when depth is `complete`. */
+    knowledge?: KnowledgeEntity;
+    depth: ProfileDepth;
+    meta?: PlaceFullMeta;
+}
+/** Input for `maps.route()`. Also accepts origin/destination aliases. */
+export interface RouteOptions extends IntentCallOptions {
+    /** Intent spelling (preferred). */
+    from?: Coordinates | string | PlaceRef;
+    to?: Coordinates | string | PlaceRef;
+    /** Alias for `from` — directions service spelling. */
+    origin?: Coordinates | string | PlaceRef;
+    /** Alias for `to`. */
+    destination?: Coordinates | string | PlaceRef;
+    mode?: TravelMode;
+    /**
+     * Turn-by-turn steps (may scrape dir HTML — slower).
+     * Default false: duration/distance only.
+     */
+    includeSteps?: boolean;
+}
+/** Output of `maps.route()` — same as directions service. */
+export type RouteResult = DirectionsResult;
+/** Input for `maps.opinions()`. */
+export interface OpinionsOptions extends IntentCallOptions {
+    /** Boq pages to fetch (default 1). */
+    pages?: number;
+    /** Reviews per page (default 10). */
+    limit?: number;
+    source?: ReviewSource;
+    /**
+     * Attach place-wide rating histogram (extra batchexecute).
+     * Default **false** for latency — set true when you need star distribution / `totalReviews`.
+     */
+    includeAggregates?: boolean;
+    filters?: ReviewClientFilters;
+}
+/** Input for `maps.opinionsPages()` — stream Boq pages. */
+export interface OpinionsPagesOptions extends OpinionsOptions {
+    /** Max Boq pages to yield (default 10). */
+    maxPages?: number;
+}
+/**
+ * Output of `maps.opinions()`.
+ * - `reviewCount` = length of this page (`reviews.length`), NOT the place total
+ * - `totalReviews` = place-wide total (needs `includeAggregates: true` or embedded fallback)
+ */
+export type OpinionsResult = ReviewsResult;
+/** Input for `maps.media()`. */
+export interface MediaOptions extends IntentCallOptions {
+    /** Include photo gallery (default true). */
+    photos?: boolean;
+    /** Include nearby Street View panos (default false — extra request). */
+    streetView?: boolean;
+    pageSize?: number;
+    category?: PhotoCategory;
+    source?: PhotosSource;
+}
+/** Input for `maps.mediaMany()`. */
+export interface MediaManyOptions extends MediaOptions {
+    concurrency?: number;
+}
+/**
+ * Output of `maps.media()` — flat photo list (not nested `.photos.photos`).
+ * Note: `PlaceDetails.photos` / search `photos` are URL strings; media returns `PlacePhoto` objects.
+ *
+ * @example
+ * const { photos, nextPageToken } = await maps.media(hit);
+ * console.log(photos[0]?.normalizedUrl);
+ */
+export interface MediaResult {
+    photos: PlacePhoto[];
+    /** Photos in this page (not necessarily gallery total). */
+    photoCount: number;
+    nextPageToken?: string;
+    photoSource?: PhotosSource;
+    panoramas?: PanoramaRef[];
+}
+/** One step of `maps.pipeline()` — discover → profile → optional opinions. */
+export interface PipelineOptions extends IntentCallOptions {
+    discover: DiscoverOptions;
+    /** Cap places after discover (default all). */
+    maxPlaces?: number;
+    /** Profile depth options (default `{ depth: 'card' }`). Pass `false` to skip. */
+    profile?: ProfileOptions | false;
+    /** Opinions options. Default off — pass `{}` or options to enable. */
+    opinions?: OpinionsOptions | false;
+    concurrency?: number;
+}
+export interface PipelinePlaceRow {
+    hit: SearchResult;
+    profile?: PlaceProfile;
+    opinions?: OpinionsResult;
+}
+export interface PipelineResult {
+    places: PipelinePlaceRow[];
+    discover: DiscoverResult;
+    timingMs: number;
+}
+//# sourceMappingURL=dx.d.ts.map

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

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

package/dist/types/dx.js

@@ -0,0 +1,7 @@
+/**
+ * Developer-experience types: PlaceRef, Intent API options, client capabilities.
+ *
+ * Intent methods return these shapes so agents/devs always know where fields live.
+ */
+export {};
+//# sourceMappingURL=dx.js.map

package/dist/types/dx.js.map

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

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":"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"}

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