googlemaps-kit 0.1.2 → 0.2.0

package/dist/client/maps-tools.js

@@ -0,0 +1,187 @@
+/**
+ * Ready-made Intent tools for agents (Vercel AI SDK / OpenAI-style).
+ *
+ * @example
+ * import { sdk, createMapsTools } from 'googlemaps-kit';
+ * const maps = sdk();
+ * const tools = createMapsTools(maps);
+ * await tools.discover.execute({ query: 'coffee', nearLat: 12.98, nearLng: 77.64 });
+ */
+function nearFromArgs(args) {
+    if (args.nearLat != null && args.nearLng != null) {
+        return { lat: args.nearLat, lng: args.nearLng };
+    }
+    return undefined;
+}
+function assertApproval(requireApproval, name) {
+    if (requireApproval?.[name]) {
+        throw new Error(`Tool "${name}" requires host approval before execute (createMapsTools requireApproval).`);
+    }
+}
+/** Build Intent-backed tools for coding agents. */
+export function createMapsTools(maps, options = {}) {
+    const { requireApproval } = options;
+    const discover = {
+        description: 'Search Google Maps places near a bias point. Returns places with name, hexId, rating, lat/lng.',
+        parameters: {
+            type: 'object',
+            properties: {
+                query: { type: 'string', description: 'Search query, e.g. cafes in indiranagar' },
+                nearLat: { type: 'number' },
+                nearLng: { type: 'number' },
+                mode: { type: 'string', enum: ['fast', 'full'] },
+                limit: { type: 'number' },
+            },
+            required: ['query', 'nearLat', 'nearLng'],
+        },
+        execute: async (args) => {
+            assertApproval(requireApproval, 'discover');
+            const near = nearFromArgs(args);
+            if (!near)
+                throw new Error('discover requires nearLat and nearLng');
+            return maps.discover({
+                query: args.query,
+                near,
+                mode: args.mode,
+                limit: args.limit,
+            });
+        },
+    };
+    const resolve = {
+        description: 'Resolve a Maps URL or query to place identity (hexId/name/coords). Not a full card.',
+        parameters: {
+            type: 'object',
+            properties: {
+                query: { type: 'string' },
+                url: { type: 'string' },
+                nearLat: { type: 'number' },
+                nearLng: { type: 'number' },
+            },
+        },
+        execute: async (args) => {
+            assertApproval(requireApproval, 'resolve');
+            return maps.resolve({
+                query: args.query,
+                url: args.url,
+                near: nearFromArgs(args),
+            });
+        },
+    };
+    const profile = {
+        description: 'Fetch a place profile. Always read fields under place (place.name, place.rating).',
+        parameters: {
+            type: 'object',
+            properties: {
+                hexId: { type: 'string' },
+                name: { type: 'string' },
+                lat: { type: 'number' },
+                lng: { type: 'number' },
+                depth: { type: 'string', enum: ['card', 'full', 'complete'] },
+            },
+            required: ['hexId'],
+        },
+        execute: async (args) => {
+            assertApproval(requireApproval, 'profile');
+            return maps.profile({
+                hexId: args.hexId,
+                name: args.name,
+                lat: args.lat,
+                lng: args.lng,
+            }, { depth: args.depth ?? 'card' });
+        },
+    };
+    const route = {
+        description: 'Get directions between two coordinates. Default metrics only.',
+        parameters: {
+            type: 'object',
+            properties: {
+                fromLat: { type: 'number' },
+                fromLng: { type: 'number' },
+                toLat: { type: 'number' },
+                toLng: { type: 'number' },
+                mode: { type: 'string', enum: ['driving', 'walking', 'bicycling', 'transit'] },
+                includeSteps: { type: 'boolean' },
+            },
+            required: ['fromLat', 'fromLng', 'toLat', 'toLng'],
+        },
+        execute: async (args) => {
+            assertApproval(requireApproval, 'route');
+            return maps.route({
+                from: { lat: args.fromLat, lng: args.fromLng },
+                to: { lat: args.toLat, lng: args.toLng },
+                mode: args.mode,
+                includeSteps: args.includeSteps,
+            });
+        },
+    };
+    const opinions = {
+        description: 'List place reviews. reviewCount is page size; totalReviews needs includeAggregates.',
+        parameters: {
+            type: 'object',
+            properties: {
+                hexId: { type: 'string' },
+                name: { type: 'string' },
+                pages: { type: 'number' },
+                includeAggregates: { type: 'boolean' },
+            },
+            required: ['hexId'],
+        },
+        execute: async (args) => {
+            assertApproval(requireApproval, 'opinions');
+            return maps.opinions({ hexId: args.hexId, name: args.name }, { pages: args.pages, includeAggregates: args.includeAggregates });
+        },
+    };
+    const media = {
+        description: 'List place photos (PlacePhoto[]). Optional nearby Street View.',
+        parameters: {
+            type: 'object',
+            properties: {
+                hexId: { type: 'string' },
+                name: { type: 'string' },
+                streetView: { type: 'boolean' },
+            },
+            required: ['hexId'],
+        },
+        execute: async (args) => {
+            assertApproval(requireApproval, 'media');
+            return maps.media({ hexId: args.hexId, name: args.name }, { streetView: args.streetView });
+        },
+    };
+    const pipeline = {
+        description: 'Discover places then profile each (optional opinions). One-shot lead scrape.',
+        parameters: {
+            type: 'object',
+            properties: {
+                query: { type: 'string' },
+                nearLat: { type: 'number' },
+                nearLng: { type: 'number' },
+                maxPlaces: { type: 'number' },
+                depth: { type: 'string', enum: ['card', 'full', 'complete'] },
+                includeOpinions: { type: 'boolean' },
+            },
+            required: ['query', 'nearLat', 'nearLng'],
+        },
+        execute: async (args) => {
+            assertApproval(requireApproval, 'pipeline');
+            return maps.pipeline({
+                discover: {
+                    query: args.query,
+                    near: { lat: args.nearLat, lng: args.nearLng },
+                },
+                maxPlaces: args.maxPlaces ?? 5,
+                profile: { depth: args.depth ?? 'card' },
+                opinions: args.includeOpinions ? {} : false,
+            });
+        },
+    };
+    return {
+        discover,
+        resolve,
+        profile,
+        route,
+        opinions,
+        media,
+        pipeline,
+    };
+}
+//# sourceMappingURL=maps-tools.js.map

package/dist/client/maps-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"maps-tools.js","sourceRoot":"","sources":["../../src/client/maps-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA0BH,SAAS,YAAY,CAAC,IAA4C;IAChE,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;QACjD,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;IAClD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,cAAc,CACrB,eAA0D,EAC1D,IAAkE;IAElE,IAAI,eAAe,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,SAAS,IAAI,4EAA4E,CAC1F,CAAC;IACJ,CAAC;AACH,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,eAAe,CAAC,IAAiB,EAAE,UAAkC,EAAE;IACrF,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC;IAEpC,MAAM,QAAQ,GASV;QACF,WAAW,EACT,gGAAgG;QAClG,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yCAAyC,EAAE;gBACjF,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC3B,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC3B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE;gBAChD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC1B;YACD,QAAQ,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC;SAC1C;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,cAAc,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;YAC5C,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YAChC,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;YACpE,OAAO,IAAI,CAAC,QAAQ,CAAC;gBACnB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,IAAI;gBACJ,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,KAAK,EAAE,IAAI,CAAC,KAAK;aAClB,CAAC,CAAC;QACL,CAAC;KACF,CAAC;IAEF,MAAM,OAAO,GAGT;QACF,WAAW,EAAE,qFAAqF;QAClG,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACvB,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC3B,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC5B;SACF;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,cAAc,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;YAC3C,OAAO,IAAI,CAAC,OAAO,CAAC;gBAClB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC;aACzB,CAAC,CAAC;QACL,CAAC;KACF,CAAC;IAEF,MAAM,OAAO,GAGT;QACF,WAAW,EACT,mFAAmF;QACrF,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACxB,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACvB,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACvB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE;aAC9D;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;SACpB;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,cAAc,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;YAC3C,OAAO,IAAI,CAAC,OAAO,CACjB;gBACE,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,GAAG,EAAE,IAAI,CAAC,GAAG;aACd,EACD,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,MAAM,EAAE,CAChC,CAAC;QACJ,CAAC;KACF,CAAC;IAEF,MAAM,KAAK,GAUP;QACF,WAAW,EAAE,+DAA+D;QAC5E,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC3B,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC3B,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE;gBAC9E,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;aAClC;YACD,QAAQ,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC;SACnD;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,cAAc,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;YACzC,OAAO,IAAI,CAAC,KAAK,CAAC;gBAChB,IAAI,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE;gBAC9C,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,EAAE;gBACxC,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,YAAY,EAAE,IAAI,CAAC,YAAY;aAChC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;IAEF,MAAM,QAAQ,GAGV;QACF,WAAW,EAAE,qFAAqF;QAClG,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACxB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,iBAAiB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;aACvC;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;SACpB;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,cAAc,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;YAC5C,OAAO,IAAI,CAAC,QAAQ,CAClB,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EACtC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,EAAE,CACjE,CAAC;QACJ,CAAC;KACF,CAAC;IAEF,MAAM,KAAK,GAAwF;QACjG,WAAW,EAAE,gEAAgE;QAC7E,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACxB,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;aAChC;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;SACpB;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,cAAc,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;YACzC,OAAO,IAAI,CAAC,KAAK,CACf,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EACtC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAChC,CAAC;QACJ,CAAC;KACF,CAAC;IAEF,MAAM,QAAQ,GAUV;QACF,WAAW,EAAE,8EAA8E;QAC3F,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC3B,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC3B,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC7B,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE;gBAC7D,eAAe,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;aACrC;YACD,QAAQ,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC;SAC1C;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,cAAc,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;YAC5C,OAAO,IAAI,CAAC,QAAQ,CAAC;gBACnB,QAAQ,EAAE;oBACR,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,IAAI,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE;iBAC/C;gBACD,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,CAAC;gBAC9B,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,MAAM,EAAE;gBACxC,QAAQ,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK;aAC5C,CAAC,CAAC;QACL,CAAC;KACF,CAAC;IAEF,OAAO;QACL,QAAQ;QACR,OAAO;QACP,OAAO;QACP,KAAK;QACL,QAAQ;QACR,KAAK;QACL,QAAQ;KACA,CAAC;AACb,CAAC"}

package/dist/client/namespaces.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Domain namespaces for GMapsClient.
+ */
+import type { HttpClient } from './http-client.js';
+import type { GMapsConfig, GetPlaceFullOptions, PlaceFullResult } from '../types/common.js';
+import { AskMapsService } from '../services/ask-maps.js';
+import { BatchUrlService } from '../services/batch-url.js';
+import { CategoriesService } from '../services/categories.js';
+import { DirectionsService } from '../services/directions.js';
+import { DistanceMatrixService } from '../services/distance-matrix.js';
+import { ElevationService } from '../services/elevation.js';
+import { GeocodeService } from '../services/geocode.js';
+import { KnowledgeService } from '../services/knowledge.js';
+import { LinksService } from '../services/links.js';
+import { ListsService } from '../services/lists.js';
+import { LocalPostsService } from '../services/local-posts.js';
+import { PanoramaService } from '../services/panorama.js';
+import { PassiveAssistService } from '../services/passiveassist.js';
+import { PhotosService } from '../services/photos.js';
+import { PlacesService, type GetPlaceOptions, type PlacePreviewFetchResult } from '../services/places.js';
+import { ReviewsService } from '../services/reviews.js';
+import { RevealService } from '../services/reveal.js';
+import { SearchService } from '../services/search.js';
+import { StaticMapService } from '../services/static-map.js';
+import { SuggestService } from '../services/suggest.js';
+import { TilesService } from '../services/tiles.js';
+import { TimezoneService } from '../services/timezone.js';
+import { TrafficService } from '../services/traffic.js';
+import { TransitService } from '../services/transit.js';
+import { UgcAggregatesService } from '../services/ugc-aggregates.js';
+import type { PlaceDetails } from '../types/common.js';
+import type { AskMapsOptions, AskMapsResult } from '../services/ask-maps.js';
+export interface ServiceBundle {
+    search: SearchService;
+    places: PlacesService;
+    reviews: ReviewsService;
+    suggest: SuggestService;
+    photos: PhotosService;
+    knowledge: KnowledgeService;
+    localPosts: LocalPostsService;
+    geocode: GeocodeService;
+    timezone: TimezoneService;
+    reveal: RevealService;
+    passiveAssist: PassiveAssistService;
+    directions: DirectionsService;
+    distanceMatrix: DistanceMatrixService;
+    elevation: ElevationService;
+    transit: TransitService;
+    traffic: TrafficService;
+    tiles: TilesService;
+    staticMap: StaticMapService;
+    panorama: PanoramaService;
+    categories: CategoriesService;
+    ugcAggregates: UgcAggregatesService;
+    lists: ListsService;
+    links: LinksService;
+    batchUrl: BatchUrlService;
+    askMaps: AskMapsService;
+}
+/** Search, place details, reviews, photos, and related POI surfaces. */
+export declare class PlacesNamespace {
+    readonly search: SearchService;
+    readonly suggest: SuggestService;
+    /** Raw place-preview / enrichment service. */
+    readonly details: PlacesService;
+    readonly reviews: ReviewsService;
+    readonly photos: PhotosService;
+    readonly knowledge: KnowledgeService;
+    readonly localPosts: LocalPostsService;
+    constructor(s: ServiceBundle);
+    /** Place card (preview + parallel UGC/photo enrichment). */
+    get(options: GetPlaceOptions): Promise<PlaceDetails>;
+    getMany(places: GetPlaceOptions[], concurrency?: number): Promise<PlaceDetails[]>;
+    getFull(options: GetPlaceFullOptions): Promise<PlaceFullResult>;
+    fetchPreview(options: GetPlaceOptions & {
+        mode?: GetPlaceOptions['mode'];
+    }): Promise<PlacePreviewFetchResult>;
+}
+/** Geocode, timezone, map-click reveal, viewport chips. */
+export declare class LocationNamespace {
+    readonly geocode: GeocodeService;
+    readonly timezone: TimezoneService;
+    readonly reveal: RevealService;
+    readonly passiveAssist: PassiveAssistService;
+    constructor(s: ServiceBundle);
+}
+/** Directions, matrix, elevation, transit, traffic. */
+export declare class TravelNamespace {
+    readonly directions: DirectionsService;
+    readonly distanceMatrix: DistanceMatrixService;
+    readonly elevation: ElevationService;
+    readonly transit: TransitService;
+    readonly traffic: TrafficService;
+    constructor(s: ServiceBundle);
+}
+/** Tiles, static map, Street View. */
+export declare class MapNamespace {
+    readonly tiles: TilesService;
+    readonly staticMap: StaticMapService;
+    readonly panorama: PanoramaService;
+    constructor(s: ServiceBundle);
+}
+/** Categories, aggregates, lists, links, URL RPC. */
+export declare class MetaNamespace {
+    readonly categories: CategoriesService;
+    readonly ugcAggregates: UgcAggregatesService;
+    readonly lists: ListsService;
+    readonly links: LinksService;
+    readonly batchUrl: BatchUrlService;
+    constructor(s: ServiceBundle);
+}
+/** Signed-in Ask Maps agent (gated). */
+export declare class AgentNamespace {
+    readonly askMaps: AskMapsService;
+    private readonly isSignedIn;
+    constructor(s: ServiceBundle, isSignedIn: () => boolean);
+    ask(options: AskMapsOptions): Promise<AskMapsResult>;
+    listHistoryThreads(): Promise<import("../services/ask-maps.js").AskMapsHistoryThread[]>;
+}
+export declare function createServiceBundle(http: HttpClient, config: GMapsConfig): ServiceBundle;
+//# sourceMappingURL=namespaces.d.ts.map

package/dist/client/namespaces.d.ts.map

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

package/dist/client/namespaces.js

@@ -0,0 +1,169 @@
+/**
+ * Domain namespaces for GMapsClient.
+ */
+import { AskMapsService } from '../services/ask-maps.js';
+import { BatchUrlService } from '../services/batch-url.js';
+import { CategoriesService } from '../services/categories.js';
+import { DirectionsService } from '../services/directions.js';
+import { DistanceMatrixService } from '../services/distance-matrix.js';
+import { ElevationService } from '../services/elevation.js';
+import { GeocodeService } from '../services/geocode.js';
+import { KnowledgeService } from '../services/knowledge.js';
+import { LinksService } from '../services/links.js';
+import { ListsService } from '../services/lists.js';
+import { LocalPostsService } from '../services/local-posts.js';
+import { PanoramaService } from '../services/panorama.js';
+import { PassiveAssistService } from '../services/passiveassist.js';
+import { PhotosService } from '../services/photos.js';
+import { PlacesService } from '../services/places.js';
+import { ReviewsService } from '../services/reviews.js';
+import { RevealService } from '../services/reveal.js';
+import { SearchService } from '../services/search.js';
+import { StaticMapService } from '../services/static-map.js';
+import { SuggestService } from '../services/suggest.js';
+import { TilesService } from '../services/tiles.js';
+import { TimezoneService } from '../services/timezone.js';
+import { TrafficService } from '../services/traffic.js';
+import { TransitService } from '../services/transit.js';
+import { UgcAggregatesService } from '../services/ugc-aggregates.js';
+import { AuthRequiredError } from '../types/common.js';
+/** Search, place details, reviews, photos, and related POI surfaces. */
+export class PlacesNamespace {
+    search;
+    suggest;
+    /** Raw place-preview / enrichment service. */
+    details;
+    reviews;
+    photos;
+    knowledge;
+    localPosts;
+    constructor(s) {
+        this.search = s.search;
+        this.suggest = s.suggest;
+        this.details = s.places;
+        this.reviews = s.reviews;
+        this.photos = s.photos;
+        this.knowledge = s.knowledge;
+        this.localPosts = s.localPosts;
+    }
+    /** Place card (preview + parallel UGC/photo enrichment). */
+    get(options) {
+        return this.details.get(options);
+    }
+    getMany(places, concurrency) {
+        return this.details.getMany(places, concurrency);
+    }
+    getFull(options) {
+        return this.details.getFull(options, this.reviews);
+    }
+    fetchPreview(options) {
+        return this.details.fetchPreview(options);
+    }
+}
+/** Geocode, timezone, map-click reveal, viewport chips. */
+export class LocationNamespace {
+    geocode;
+    timezone;
+    reveal;
+    passiveAssist;
+    constructor(s) {
+        this.geocode = s.geocode;
+        this.timezone = s.timezone;
+        this.reveal = s.reveal;
+        this.passiveAssist = s.passiveAssist;
+    }
+}
+/** Directions, matrix, elevation, transit, traffic. */
+export class TravelNamespace {
+    directions;
+    distanceMatrix;
+    elevation;
+    transit;
+    traffic;
+    constructor(s) {
+        this.directions = s.directions;
+        this.distanceMatrix = s.distanceMatrix;
+        this.elevation = s.elevation;
+        this.transit = s.transit;
+        this.traffic = s.traffic;
+    }
+}
+/** Tiles, static map, Street View. */
+export class MapNamespace {
+    tiles;
+    staticMap;
+    panorama;
+    constructor(s) {
+        this.tiles = s.tiles;
+        this.staticMap = s.staticMap;
+        this.panorama = s.panorama;
+    }
+}
+/** Categories, aggregates, lists, links, URL RPC. */
+export class MetaNamespace {
+    categories;
+    ugcAggregates;
+    lists;
+    links;
+    batchUrl;
+    constructor(s) {
+        this.categories = s.categories;
+        this.ugcAggregates = s.ugcAggregates;
+        this.lists = s.lists;
+        this.links = s.links;
+        this.batchUrl = s.batchUrl;
+    }
+}
+/** Signed-in Ask Maps agent (gated). */
+export class AgentNamespace {
+    askMaps;
+    isSignedIn;
+    constructor(s, isSignedIn) {
+        this.askMaps = s.askMaps;
+        this.isSignedIn = isSignedIn;
+    }
+    async ask(options) {
+        if (!this.isSignedIn()) {
+            throw new AuthRequiredError('Ask Maps requires a signed-in session. Pass cookies via sdk({ session: \'authenticated\', cookies }) or GMAPS_COOKIES.', 'askMaps');
+        }
+        return this.askMaps.ask(options);
+    }
+    listHistoryThreads() {
+        if (!this.isSignedIn()) {
+            throw new AuthRequiredError('Ask Maps history requires a signed-in session (GMAPS_COOKIES).', 'askMapsHistory');
+        }
+        return this.askMaps.listHistoryThreads();
+    }
+}
+export function createServiceBundle(http, config) {
+    const directions = new DirectionsService(http, config);
+    const geocode = new GeocodeService(http, config);
+    return {
+        search: new SearchService(http, config),
+        places: new PlacesService(http, config),
+        reviews: new ReviewsService(http, config),
+        suggest: new SuggestService(http, config),
+        photos: new PhotosService(http, config),
+        knowledge: new KnowledgeService(http, config),
+        localPosts: new LocalPostsService(http, config),
+        geocode,
+        timezone: new TimezoneService(geocode, config),
+        reveal: new RevealService(http, config),
+        passiveAssist: new PassiveAssistService(http, config),
+        directions,
+        distanceMatrix: new DistanceMatrixService(directions, config),
+        elevation: new ElevationService(http, directions, config),
+        transit: new TransitService(http, config),
+        traffic: new TrafficService(http, config),
+        tiles: new TilesService(http, config),
+        staticMap: new StaticMapService(http, config),
+        panorama: new PanoramaService(http, config),
+        categories: new CategoriesService(http, config),
+        ugcAggregates: new UgcAggregatesService(http, config),
+        lists: new ListsService(http, config),
+        links: new LinksService(http, config),
+        batchUrl: new BatchUrlService(http, config),
+        askMaps: new AskMapsService(http, config),
+    };
+}
+//# sourceMappingURL=namespaces.js.map

package/dist/client/namespaces.js.map

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

package/dist/client/place-enrichment.d.ts

@@ -0,0 +1,19 @@
+import type { HttpClient } from './http-client.js';
+import type { GMapsConfig, PlaceDetails } from '../types/common.js';
+export interface PlaceEnrichmentInput {
+    hexId: string;
+    lat?: number;
+    lng?: number;
+    ftid?: string;
+}
+export interface PlaceEnrichment {
+    rating?: number;
+    reviewCount?: number;
+    photos?: string[];
+}
+/**
+ * Fan-out place metadata RPCs in a single batchexecute envelope (parallel to preview GET).
+ */
+export declare function fetchPlaceEnrichment(http: HttpClient, config: GMapsConfig, options: PlaceEnrichmentInput): Promise<PlaceEnrichment | null>;
+export declare function mergePlaceEnrichment(details: PlaceDetails, enrichment: PlaceEnrichment | null): PlaceDetails;
+//# sourceMappingURL=place-enrichment.d.ts.map

package/dist/client/place-enrichment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"place-enrichment.d.ts","sourceRoot":"","sources":["../../src/client/place-enrichment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AASnD,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAW,MAAM,oBAAoB,CAAC;AAG7E,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAkDjC;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,YAAY,EACrB,UAAU,EAAE,eAAe,GAAG,IAAI,GACjC,YAAY,CAYd"}

package/dist/client/place-enrichment.js

@@ -0,0 +1,71 @@
+import { extractPlacePhotos } from '../parsers/photos.js';
+import { extractPlaceUgcAggregates } from '../parsers/ugc-aggregates.js';
+import { buildListEntityPhotosBatchArgs, buildPlaceUgcAggregatesArgs, } from '../rpc/batch-request-builders.js';
+import { BATCH_SERVICES } from '../rpc/batch-services.js';
+import { createRpcClient, isBatchErrorCode, parseBatchPayload } from '../rpc/batch-rpc.js';
+import { dedupePhotos } from '../utils/photo-url.js';
+/**
+ * Fan-out place metadata RPCs in a single batchexecute envelope (parallel to preview GET).
+ */
+export async function fetchPlaceEnrichment(http, config, options) {
+    if (!options.hexId)
+        return null;
+    try {
+        const rpc = await createRpcClient(http, config);
+        const psi = await http.resolvePsi();
+        const calls = [
+            {
+                id: BATCH_SERVICES.PLACE_UGC_AGGREGATES,
+                args: buildPlaceUgcAggregatesArgs(options.hexId, psi),
+            },
+        ];
+        const hasCoords = options.lat != null && options.lng != null;
+        if (hasCoords) {
+            calls.push({
+                id: BATCH_SERVICES.LIST_ENTITY_PHOTOS,
+                args: buildListEntityPhotosBatchArgs({
+                    hexId: options.hexId,
+                    psi,
+                    featureId: options.ftid,
+                    pageSize: 12,
+                }),
+            });
+        }
+        const responses = await rpc.getBatchClient().execute(calls);
+        const out = {};
+        const aggregatesRoot = parseBatchPayload(responses[0]?.data);
+        if (!isBatchErrorCode(aggregatesRoot)) {
+            const aggregates = extractPlaceUgcAggregates(aggregatesRoot);
+            if (aggregates.rating != null)
+                out.rating = aggregates.rating;
+            if (aggregates.totalCount != null)
+                out.reviewCount = aggregates.totalCount;
+        }
+        if (hasCoords && responses[1]) {
+            const photosRoot = parseBatchPayload(responses[1].data);
+            if (!isBatchErrorCode(photosRoot)) {
+                const parsed = extractPlacePhotos(photosRoot, { pageSize: 12, source: 'batchexecute' });
+                const urls = parsed.photos.map((p) => p.url).filter(Boolean);
+                if (urls.length > 0)
+                    out.photos = urls;
+            }
+        }
+        return Object.keys(out).length > 0 ? out : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function mergePlaceEnrichment(details, enrichment) {
+    if (!enrichment)
+        return details;
+    return {
+        ...details,
+        rating: details.rating ?? enrichment.rating,
+        reviewCount: details.reviewCount ?? enrichment.reviewCount,
+        photos: enrichment.photos && enrichment.photos.length > 0
+            ? dedupePhotos([...(details.photos ?? []), ...enrichment.photos], 50)
+            : details.photos,
+    };
+}
+//# sourceMappingURL=place-enrichment.js.map

package/dist/client/place-enrichment.js.map

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

package/dist/client/product-namespaces.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Auth + surface catalog namespaces — product-facing wrappers over kit internals.
+ */
+import { type AuthStatusOptions } from '../auth/auth-status.js';
+import type { HttpClient } from './http-client.js';
+import type { AuthStatus, GMapsConfig } from '../types/common.js';
+import { KNOWN_SURFACES, type KnownSurfaceName, type SurfaceInfo, type SurfaceStatus } from '../known-surfaces.js';
+/** Session / cookie status for apps (no secret values returned). */
+export declare class AuthNamespace {
+    private readonly auth;
+    constructor(http: HttpClient, config: GMapsConfig);
+    /** Live or cached auth probe — cookie names/lengths only, never values. */
+    status(options?: AuthStatusOptions): Promise<AuthStatus>;
+    /** One-line summary for logs (`signed-in, cookies=12, …`). */
+    summarize(options?: AuthStatusOptions): Promise<string>;
+}
+/** Catalog of Maps surfaces this kit knows about (working / auth / blocked / …). */
+export declare class SurfacesNamespace {
+    /** All surface names. */
+    list(): KnownSurfaceName[];
+    /** Surfaces filtered by status (`working`, `auth-required`, …). */
+    listByStatus(status: SurfaceStatus): KnownSurfaceName[];
+    /** Metadata for one surface. */
+    get(name: KnownSurfaceName): SurfaceInfo;
+    /** Full catalog object (read-only snapshot). */
+    catalog(): typeof KNOWN_SURFACES;
+    /** Names marked working (anonymous or with documented path). */
+    working(): KnownSurfaceName[];
+}
+//# sourceMappingURL=product-namespaces.d.ts.map

package/dist/client/product-namespaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-namespaces.d.ts","sourceRoot":"","sources":["../../src/client/product-namespaces.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAoC,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAClG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EACL,cAAc,EAGd,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAE9B,oEAAoE;AACpE,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;gBAEvB,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW;IAOjD,2EAA2E;IAC3E,MAAM,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC;IAIxD,8DAA8D;IACxD,SAAS,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;CAG9D;AAED,oFAAoF;AACpF,qBAAa,iBAAiB;IAC5B,yBAAyB;IACzB,IAAI,IAAI,gBAAgB,EAAE;IAI1B,mEAAmE;IACnE,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,gBAAgB,EAAE;IAIvD,gCAAgC;IAChC,GAAG,CAAC,IAAI,EAAE,gBAAgB,GAAG,WAAW;IAIxC,gDAAgD;IAChD,OAAO,IAAI,OAAO,cAAc;IAIhC,gEAAgE;IAChE,OAAO,IAAI,gBAAgB,EAAE;CAG9B"}