googlemaps-kit 0.4.0 → 0.6.0

package/dist/utils/net.js

@@ -0,0 +1,150 @@
+/**
+ * Network pacing and failure classification: retry backoff with jitter,
+ * the concurrency/delay request scheduler, and throttle/block detection.
+ */
+export function parseRetryAfterMs(header, now = Date.now()) {
+    if (!header)
+        return undefined;
+    const trimmed = header.trim();
+    const seconds = Number(trimmed);
+    if (Number.isFinite(seconds) && seconds >= 0) {
+        return Math.round(seconds * 1000);
+    }
+    const dateMs = Date.parse(trimmed);
+    if (!Number.isNaN(dateMs)) {
+        const delta = dateMs - now;
+        return delta > 0 ? delta : undefined;
+    }
+    return undefined;
+}
+/** Exponential backoff with full jitter (AWS-style). */
+export function backoffWithJitter(baseDelayMs, attempt, maxDelayMs, rng = Math.random) {
+    const cap = maxDelayMs ?? baseDelayMs * Math.pow(2, Math.max(attempt, 4));
+    const exp = Math.min(baseDelayMs * Math.pow(2, attempt - 1), cap);
+    return Math.round(rng() * exp);
+}
+export class RequestScheduler {
+    requestDelayMs;
+    concurrency;
+    now;
+    sleepFn;
+    active = 0;
+    waiters = [];
+    lastStartAt = 0;
+    hasScheduled = false;
+    constructor(options = {}) {
+        this.requestDelayMs = options.requestDelayMs ?? 0;
+        this.concurrency = Math.max(1, options.concurrency ?? 6);
+        this.now = options.now ?? (() => Date.now());
+        this.sleepFn =
+            options.sleep ??
+                ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+    }
+    async run(fn) {
+        await this.acquire();
+        try {
+            return await fn();
+        }
+        finally {
+            this.release();
+        }
+    }
+    async acquire() {
+        while (this.active >= this.concurrency) {
+            await new Promise((resolve) => {
+                this.waiters.push(resolve);
+            });
+        }
+        this.active++;
+        await this.waitForPacing();
+    }
+    release() {
+        this.active--;
+        const next = this.waiters.shift();
+        if (next)
+            next();
+    }
+    async waitForPacing() {
+        if (this.requestDelayMs <= 0)
+            return;
+        if (this.hasScheduled) {
+            const elapsed = this.now() - this.lastStartAt;
+            if (elapsed < this.requestDelayMs) {
+                await this.sleepFn(this.requestDelayMs - elapsed);
+            }
+        }
+        this.hasScheduled = true;
+        this.lastStartAt = this.now();
+    }
+}
+import { isBatchErrorCode } from '../rpc/batch-rpc.js';
+/** listugcposts anonymous stub: `[null,null,null,null,null,1]`. */
+export function isListUgcUnauthenticatedStub(data) {
+    return (Array.isArray(data) &&
+        data.length >= 6 &&
+        data[0] === null &&
+        data[1] === null &&
+        data[2] === null &&
+        data[3] === null &&
+        data[4] === null &&
+        data[5] === 1);
+}
+/** batchexecute auth stub: `[null,null,null,null,null,true]` (~199 B). */
+export function isBatchAuthStub(data) {
+    if (!Array.isArray(data))
+        return false;
+    const json = JSON.stringify(data);
+    if (data.length === 6 && data[5] === true && json.length < 280)
+        return true;
+    if (json.length < 20)
+        return true;
+    return false;
+}
+/** batchexecute application error envelope (e.g. `[3]`). */
+function isBatchBlocked(data) {
+    return isBatchErrorCode(data);
+}
+/** HTTP 200 body that parses but carries no usable rows (cookieless batchexecute trap). */
+export function isEmptySuccessPayload(data) {
+    if (data == null)
+        return true;
+    if (typeof data === 'string') {
+        const trimmed = data.trim();
+        return trimmed.length === 0 || trimmed === '[]' || trimmed === '[3]';
+    }
+    if (Array.isArray(data)) {
+        if (data.length === 0)
+            return true;
+        if (isBatchErrorCode(data))
+            return true;
+        if (isListUgcUnauthenticatedStub(data))
+            return true;
+        if (isBatchAuthStub(data))
+            return true;
+    }
+    return false;
+}
+/** Google abuse-page markers in an HTTP 403 body. */
+export function isAutomatedQueryBlock(body) {
+    return (body.includes('automated queries') ||
+        body.includes("can't process your request right now"));
+}
+export function classifyThrottleFailure(options) {
+    if (options.status === 429)
+        return 'http-429';
+    if (options.status === 403 && options.bodyText && isAutomatedQueryBlock(options.bodyText)) {
+        return 'http-403';
+    }
+    if (options.parsed != null) {
+        if (isBatchBlocked(options.parsed))
+            return 'batch-error';
+        if (isListUgcUnauthenticatedStub(options.parsed))
+            return 'auth-stub';
+        if (isBatchAuthStub(options.parsed))
+            return 'auth-stub';
+        if (isEmptySuccessPayload(options.parsed))
+            return 'empty-200';
+    }
+    return undefined;
+}
+//# sourceMappingURL=net.js.map

package/dist/utils/net.js.map

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

package/dist/utils/payload.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Payload plumbing: deep array access, the )]}'-prefixed JSON decoder, and
+ * chunked-transfer reassembly.
+ */
+export declare function safeGet<T = unknown>(obj: unknown, ...indices: Array<string | number>): T | undefined;
+import type { PbNode } from '../types/protobuf.js';
+/**
+ * Strip Google's XSSI prefix and parse the first complete JSON array.
+ * Maps endpoints return `)]}'` followed by nested JSON arrays (protobuf-over-JSON).
+ *
+ * The parsed value is always an array at runtime; an empty body yields `[]`.
+ * Callers should therefore instantiate `T` with an array-compatible wire type
+ * (e.g. `PbNode`) rather than an object type.
+ */
+export declare function parseGoogleResponse<T = PbNode>(responseText: string): T;
+export declare function isValidResponseBody(body: string): boolean;
+import type { RPCResponse } from '../types/common.js';
+/**
+ * Parse chunked batchexecute response: `\n<size>\n<payload>\n...`
+ */
+export declare function parseChunkedResponse(raw: string, _debug?: boolean): RPCResponse[];
+//# sourceMappingURL=payload.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../src/utils/payload.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAgB,OAAO,CAAC,CAAC,GAAG,OAAO,EACjC,GAAG,EAAE,OAAO,EACZ,GAAG,OAAO,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GACjC,CAAC,GAAG,SAAS,CAkBf;AAGD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAInD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,GAAG,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,CAAC,CAuCvE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGzD;AAED,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,WAAW,EAAE,CA+D/E"}

package/dist/utils/{chunked-decoder.js → payload.js}

@@ -1,6 +1,84 @@
 /**
- * Chunked response decoder for Google batchexecute format.
+ * Payload plumbing: deep array access, the )]}'-prefixed JSON decoder, and
+ * chunked-transfer reassembly.
  */
+export function safeGet(obj, ...indices) {
+    try {
+        let current = obj;
+        for (const idx of indices) {
+            if (current == null)
+                return undefined;
+            if (Array.isArray(current) && typeof idx === 'number') {
+                if (idx < 0 || idx >= current.length)
+                    return undefined;
+                current = current[idx];
+            }
+            else if (typeof current === 'object' && typeof idx === 'string') {
+                current = current[idx];
+            }
+            else {
+                return undefined;
+            }
+        }
+        return current;
+    }
+    catch {
+        return undefined;
+    }
+}
+import { GMapsParseError } from '../types/common.js';
+const XSSI_PREFIX = ")]}'";
+/**
+ * Strip Google's XSSI prefix and parse the first complete JSON array.
+ * Maps endpoints return `)]}'` followed by nested JSON arrays (protobuf-over-JSON).
+ *
+ * The parsed value is always an array at runtime; an empty body yields `[]`.
+ * Callers should therefore instantiate `T` with an array-compatible wire type
+ * (e.g. `PbNode`) rather than an object type.
+ */
+export function parseGoogleResponse(responseText) {
+    if (!responseText) {
+        return [];
+    }
+    let text = responseText.trim();
+    if (text.startsWith(XSSI_PREFIX)) {
+        text = text.slice(XSSI_PREFIX.length).trim();
+    }
+    if (!text) {
+        return [];
+    }
+    let depth = 0;
+    let start = null;
+    for (let i = 0; i < text.length; i++) {
+        const char = text[i];
+        if (char === '[') {
+            if (depth === 0)
+                start = i;
+            depth++;
+        }
+        else if (char === ']') {
+            depth--;
+            if (depth === 0 && start !== null) {
+                try {
+                    return JSON.parse(text.slice(start, i + 1));
+                }
+                catch {
+                    // continue scanning
+                }
+            }
+        }
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch (error) {
+        throw new GMapsParseError('Failed to parse Google Maps response', error);
+    }
+}
+export function isValidResponseBody(body) {
+    const stripped = body.startsWith(XSSI_PREFIX) ? body.slice(4).trim() : body.trim();
+    return stripped.length >= 100;
+}
 /**
  * Parse chunked batchexecute response: `\n<size>\n<payload>\n...`
  */
@@ -172,4 +250,4 @@ function extractWrbResponse(chunk) {
     }
     return { index: 0, id: chunk.substring(idStart, idEnd), data: null };
 }
-//# sourceMappingURL=chunked-decoder.js.map
+//# sourceMappingURL=payload.js.map

package/dist/utils/payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.js","sourceRoot":"","sources":["../../src/utils/payload.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,UAAU,OAAO,CACrB,GAAY,EACZ,GAAG,OAA+B;IAElC,IAAI,CAAC;QACH,IAAI,OAAO,GAAY,GAAG,CAAC;QAC3B,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,IAAI,OAAO,IAAI,IAAI;gBAAE,OAAO,SAAS,CAAC;YACtC,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;gBACtD,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,IAAI,OAAO,CAAC,MAAM;oBAAE,OAAO,SAAS,CAAC;gBACvD,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;YACzB,CAAC;iBAAM,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;gBAClE,OAAO,GAAI,OAAmC,CAAC,GAAG,CAAC,CAAC;YACtD,CAAC;iBAAM,CAAC;gBACN,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;QACD,OAAO,OAAY,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD,MAAM,WAAW,GAAG,MAAM,CAAC;AAE3B;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAa,YAAoB;IAClE,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,EAAkB,CAAC;IAC5B,CAAC;IAED,IAAI,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QACjC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/C,CAAC;IAED,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAkB,CAAC;IAC5B,CAAC;IAED,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAkB,IAAI,CAAC;IAEhC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,IAAI,KAAK,KAAK,CAAC;gBAAE,KAAK,GAAG,CAAC,CAAC;YAC3B,KAAK,EAAE,CAAC;QACV,CAAC;aAAM,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACxB,KAAK,EAAE,CAAC;YACR,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAClC,IAAI,CAAC;oBACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAM,CAAC;gBACnD,CAAC;gBAAC,MAAM,CAAC;oBACP,oBAAoB;gBACtB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,eAAe,CAAC,sCAAsC,EAAE,KAAK,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACnF,OAAO,QAAQ,CAAC,MAAM,IAAI,GAAG,CAAC;AAChC,CAAC;AAID;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAW,EAAE,MAAM,GAAG,KAAK;IAC9D,IAAI,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAE9C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,SAAS,GAAa,EAAE,CAAC;IAE7B,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,GAAG,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC;QAC9D,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAE,CAAC;QAC/B,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACtC,SAAS;QACX,CAAC;QAED,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;YAEvC,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC/D,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACpB,CAAC;gBACD,SAAS;YACX,CAAC;YAED,SAAS,GAAG,IAAI,CAAC;YACjB,UAAU,GAAG,IAAI,CAAC;YAClB,SAAS,GAAG,EAAE,CAAC;YACf,SAAS;QACX,CAAC;QAED,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAErB,MAAM,WAAW,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QAChD,IAAI,WAAW,IAAI,SAAS,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAClC,UAAU,GAAG,KAAK,CAAC;YACnB,SAAS,GAAG,CAAC,CAAC;YACd,SAAS,GAAG,EAAE,CAAC;YACf,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACpD,IAAI,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAClC,UAAU,GAAG,KAAK,CAAC;YACnB,SAAS,GAAG,CAAC,CAAC;YACd,SAAS,GAAG,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IAED,IAAI,UAAU,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YACnB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,aAAa,CAAC,MAAgB;IACrC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,YAAY,GAAkB,EAAE,CAAC;IAEvC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;YAClD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACnC,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBAC7B,YAAY,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7D,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,CAAC;YACH,IAAI,MAAe,CAAC;YACpB,IAAI,CAAC;gBACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC7B,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBACpE,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YACjC,CAAC;YAED,IAAI,cAA2B,CAAC;YAChC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1B,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,MAAsB,CAAC,CAAC,CAAC,CAAC,MAAmB,CAAC,CAAC;YAC9F,CAAC;iBAAM,CAAC;gBACN,SAAS;YACX,CAAC;YAED,YAAY,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,cAAc,CAAC,CAAC,CAAC;QACzD,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC7B,MAAM,QAAQ,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;gBAC3C,IAAI,QAAQ,EAAE,CAAC;oBACb,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC9B,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAiB;IACzC,MAAM,SAAS,GAAkB,EAAE,CAAC;IAEpC,KAAK,MAAM,OAAO,IAAI,IAAI,EAAE,CAAC;QAC3B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;YAClD,SAAS;QACX,CAAC;QAED,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAW,CAAC;QAChC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAgB,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAC3D,IAAI,YAAY,GAAY,IAAI,CAAC;QAEjC,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;YACpD,IAAI,OAAO,OAAO,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACnC,QAAQ,CAAC,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;gBAC3B,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YAC5B,CAAC;iBAAM,CAAC;gBACN,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QAED,IAAI,YAAY,KAAK,IAAI,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACvE,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QAC5B,CAAC;QAED,IAAI,YAAY,KAAK,IAAI,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YACpD,QAAQ,CAAC,IAAI,GAAG,YAAY,CAAC;QAC/B,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;gBAC7B,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC;YACrB,CAAC;iBAAM,IAAI,OAAO,OAAO,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;gBAC1C,QAAQ,CAAC,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;QAED,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAa;IACvC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,SAAS,GAAG,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YAC3C,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,OAAO,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,OAAO,GAAG,QAAQ,GAAG,CAAC,CAAC;IAC3B,OAAO,OAAO,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;QAC9G,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,KAAK,GAAG,OAAO,CAAC;IACpB,OAAO,KAAK,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC;QACpG,KAAK,EAAE,CAAC;IACV,CAAC;IAED,IAAI,OAAO,IAAI,KAAK,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACvE,CAAC"}

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

@@ -1,7 +1,7 @@
 /**
  * PlaceRef + route endpoint normalization (shared by Intent API and services).
  */
-import type { Coordinates } from '../types/common.js';
+import type { Coordinates, LocationRef } from '../types/common.js';
 import type { NormalizedPlaceRef, PlaceRef } from '../types/dx.js';
 /**
  * Normalize a PlaceRef for service calls.
@@ -16,12 +16,22 @@ type CoordLoose = {
     latitude?: number;
     longitude?: number;
 };
+/**
+ * Parse `"12.98,77.64"` into coords. Place names return undefined.
+ */
+export declare function parseLatLngString(value: string): Coordinates | undefined;
+/**
+ * Resolve a bias center. Coords and `"lat,lng"` strings are sync;
+ * place names call `geocode` and use the first hit.
+ */
+export declare function resolveBiasCenter(value: LocationRef | CoordLoose | null | undefined, geocode: (query: string) => Promise<Coordinates | null>): Promise<Coordinates>;
 /**
  * Resolve search bias center from Intent (`near`) or service (`location`) spelling.
+ * Sync — coords or `"lat,lng"` only. Place names need `resolveBiasCenter`.
  */
 export declare function resolveSearchCenter(options: {
-    near?: Coordinates | CoordLoose;
-    location?: Coordinates | CoordLoose;
+    near?: LocationRef | CoordLoose;
+    location?: LocationRef | CoordLoose;
 }): Coordinates;
 /**
  * Resolve directions endpoints from Intent (`from`/`to`) or service (`origin`/`destination`).
@@ -35,5 +45,32 @@ export declare function resolveDirectionsEndpoints(options: {
     origin: string | Coordinates;
     destination: string | Coordinates;
 };
+/**
+ * Build a `google.com/maps/place/…` referer for a place name.
+ *
+ * Percent-encodes the name so non-ASCII titles (accents, CJK, Indic scripts)
+ * cannot produce a header value `fetch` refuses to serialise as a ByteString.
+ */
+export declare function buildPlaceReferer(name?: string): string;
+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;
+} | string | null | undefined): CoordinatesLike | undefined;
 export {};
 //# sourceMappingURL=place-ref.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"place-ref.d.ts","sourceRoot":"","sources":["../../src/utils/place-ref.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAgBnE;;;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,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAMxE;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,WAAW,GAAG,UAAU,GAAG,IAAI,GAAG,SAAS,EAClD,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,GACtD,OAAO,CAAC,WAAW,CAAC,CAwBtB;AAED;;;GAGG;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,CAgBd;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;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAIvD;AAED,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,MAAM,GAAG,IAAI,GAAG,SAAS,GAC5E,eAAe,GAAG,SAAS,CAc7B"}

package/dist/utils/place-ref.js

@@ -3,9 +3,10 @@
  */
 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-]+$/;
+/** Exact `lat,lng` text — not "Indiranagar, Bengaluru". */
+const LAT_LNG_STRING_RE = /^-?\d+(?:\.\d+)?\s*,\s*-?\d+(?:\.\d+)?$/;
 function tryPlaceIdToHex(placeId) {
     try {
         return placeIdToFeatureId(placeId);
@@ -82,11 +83,55 @@ export function resolveRouteEndpoint(value) {
         return coords;
     throw new GMapsError('Invalid route endpoint — expected address string, { lat, lng }, or PlaceRef with coordinates');
 }
+/**
+ * Parse `"12.98,77.64"` into coords. Place names return undefined.
+ */
+export function parseLatLngString(value) {
+    const trimmed = value.trim();
+    if (!LAT_LNG_STRING_RE.test(trimmed))
+        return undefined;
+    const [lat, lng] = trimmed.split(',').map((s) => Number(s.trim()));
+    if (!Number.isFinite(lat) || !Number.isFinite(lng))
+        return undefined;
+    return { lat: lat, lng: lng };
+}
+/**
+ * Resolve a bias center. Coords and `"lat,lng"` strings are sync;
+ * place names call `geocode` and use the first hit.
+ */
+export async function resolveBiasCenter(value, geocode) {
+    if (value == null || value === '') {
+        throw new GMapsError('Search requires a bias center — pass near: { lat, lng } or a place name');
+    }
+    if (typeof value === 'string') {
+        const parsed = parseLatLngString(value);
+        if (parsed)
+            return parsed;
+        const hit = await geocode(value.trim());
+        if (!hit) {
+            throw new GMapsError(`Could not geocode near "${value.trim()}" — pass lat,lng or a more specific place name`);
+        }
+        return hit;
+    }
+    const coords = toCoordinates(value);
+    if (!coords) {
+        throw new GMapsError('Search requires a bias center — pass near: { lat, lng } or a place name');
+    }
+    return coords;
+}
 /**
  * Resolve search bias center from Intent (`near`) or service (`location`) spelling.
+ * Sync — coords or `"lat,lng"` only. Place names need `resolveBiasCenter`.
  */
 export function resolveSearchCenter(options) {
-    const coords = toCoordinates(options.near) ?? toCoordinates(options.location);
+    const raw = options.near ?? options.location;
+    if (typeof raw === 'string') {
+        const parsed = parseLatLngString(raw);
+        if (parsed)
+            return parsed;
+        throw new GMapsError('Place names as near/location must be geocoded (resolveBiasCenter). Pass { lat, lng } into resolveSearchCenter.');
+    }
+    const coords = toCoordinates(raw);
     if (!coords) {
         throw new GMapsError('Search requires a bias center — pass near: { lat, lng } (Intent) or location: { lat, lng } (search service)');
     }
@@ -106,4 +151,51 @@ export function resolveDirectionsEndpoints(options) {
         destination: resolveRouteEndpoint(destRaw),
     };
 }
+/**
+ * Build a `google.com/maps/place/…` referer for a place name.
+ *
+ * Percent-encodes the name so non-ASCII titles (accents, CJK, Indic scripts)
+ * cannot produce a header value `fetch` refuses to serialise as a ByteString.
+ */
+export function buildPlaceReferer(name) {
+    if (!name)
+        return 'https://www.google.com/maps/';
+    const slug = encodeURIComponent(name.trim()).replace(/%20/g, '+');
+    return `https://www.google.com/maps/place/${slug}/`;
+}
+/** 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 (typeof value === 'string')
+        return parseLatLngString(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=place-ref.js.map

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "googlemaps-kit",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "TypeScript SDK + Bubble Tea TUI for Google Maps consumer surfaces",
   "type": "module",
   "main": "./dist/index.js",
@@ -26,7 +26,7 @@
     "dist",
     "LICENSE",
     "README.md",
-    "assets/banner.png"
+    ".github/assets/banner.png"
   ],
   "sideEffects": false,
   "engines": {
@@ -38,8 +38,9 @@
     "clean": "rm -rf dist",
     "type-check": "tsc -p tsconfig.check.json --noEmit",
     "prepublishOnly": "npm run clean && npm run build && npm run type-check && npm test",
-    "test": "vitest run",
+    "test": "vitest run tests/unit",
     "test:watch": "vitest",
+    "test:live": "GMAPS_LIVE=1 vitest run tests/live",
     "preexample": "npm run build",
     "example:quick-start": "tsx examples/quick-start.ts",
     "example:search": "tsx examples/search-text.ts",
@@ -51,9 +52,12 @@
     "example:geocode": "tsx examples/geocode.ts",
     "example:suggest": "tsx examples/suggest.ts",
     "example:maps-url": "tsx examples/maps-url.ts",
+    "example:grid-search": "tsx examples/grid-search.ts",
     "examples:all": "npm run build && tsx examples/run-all.ts",
     "verify:all": "tsx scripts/verify-all.ts",
-    "smoke:daily": "tsx scripts/smoke-daily.ts"
+    "smoke:daily": "tsx scripts/smoke-daily.ts",
+    "api:serve": "tsx src/server/api-server.ts",
+    "api:build": "tsc -p tsconfig.server.json"
   },
   "keywords": [
     "google-maps",
@@ -64,7 +68,6 @@
     "google-maps-without-api-key",
     "unofficial-google-maps-api",
     "free-google-maps-api",
-    "reverse-engineering-google-maps",
     "google-maps-reviews-api",
     "google-maps-directions",
     "local-business-scraper",

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

@@ -1,30 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"}

package/dist/client/product-namespaces.js

@@ -1,47 +0,0 @@
-/**
- * Auth + surface catalog namespaces — product-facing wrappers over kit internals.
- */
-import { AuthService, summarizeAuthStatus } from '../auth/auth-status.js';
-import { KNOWN_SURFACES, getSurfaceInfo, listSurfacesByStatus, } from '../known-surfaces.js';
-/** Session / cookie status for apps (no secret values returned). */
-export class AuthNamespace {
-    auth;
-    constructor(http, config) {
-        this.auth = new AuthService(http, {
-            cookies: config.cookies,
-            authToken: config.authToken,
-        });
-    }
-    /** Live or cached auth probe — cookie names/lengths only, never values. */
-    status(options) {
-        return this.auth.getStatus(options);
-    }
-    /** One-line summary for logs (`signed-in, cookies=12, …`). */
-    async summarize(options) {
-        return summarizeAuthStatus(await this.status(options));
-    }
-}
-/** Catalog of Maps surfaces this kit knows about (working / auth / blocked / …). */
-export class SurfacesNamespace {
-    /** All surface names. */
-    list() {
-        return Object.keys(KNOWN_SURFACES);
-    }
-    /** Surfaces filtered by status (`working`, `auth-required`, …). */
-    listByStatus(status) {
-        return listSurfacesByStatus(status);
-    }
-    /** Metadata for one surface. */
-    get(name) {
-        return getSurfaceInfo(name);
-    }
-    /** Full catalog object (read-only snapshot). */
-    catalog() {
-        return KNOWN_SURFACES;
-    }
-    /** Names marked working (anonymous or with documented path). */
-    working() {
-        return listSurfacesByStatus('working');
-    }
-}
-//# sourceMappingURL=product-namespaces.js.map

package/dist/client/product-namespaces.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"product-namespaces.js","sourceRoot":"","sources":["../../src/client/product-namespaces.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAA0B,MAAM,wBAAwB,CAAC;AAGlG,OAAO,EACL,cAAc,EACd,cAAc,EACd,oBAAoB,GAIrB,MAAM,sBAAsB,CAAC;AAE9B,oEAAoE;AACpE,MAAM,OAAO,aAAa;IACP,IAAI,CAAc;IAEnC,YAAY,IAAgB,EAAE,MAAmB;QAC/C,IAAI,CAAC,IAAI,GAAG,IAAI,WAAW,CAAC,IAAI,EAAE;YAChC,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,2EAA2E;IAC3E,MAAM,CAAC,OAA2B;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,8DAA8D;IAC9D,KAAK,CAAC,SAAS,CAAC,OAA2B;QACzC,OAAO,mBAAmB,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACzD,CAAC;CACF;AAED,oFAAoF;AACpF,MAAM,OAAO,iBAAiB;IAC5B,yBAAyB;IACzB,IAAI;QACF,OAAO,MAAM,CAAC,IAAI,CAAC,cAAc,CAAuB,CAAC;IAC3D,CAAC;IAED,mEAAmE;IACnE,YAAY,CAAC,MAAqB;QAChC,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IAED,gCAAgC;IAChC,GAAG,CAAC,IAAsB;QACxB,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,gDAAgD;IAChD,OAAO;QACL,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,gEAAgE;IAChE,OAAO;QACL,OAAO,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC;CACF"}