googlemaps-kit 0.6.0 → 0.7.0

package/dist/known-surfaces.d.ts

@@ -207,12 +207,6 @@ export declare const KNOWN_SURFACES: {
         readonly path: "/maps/vt/proto + viewport share URLs";
         readonly notes: "Composable tile sessions (map.tiles) and buildViewportLink — not the billed Maps JavaScript API.";
     };
-    readonly aerialView: {
-        readonly status: "auth-required";
-        readonly method: "GET";
-        readonly path: "aerialview.googleapis.com/v1/videos:*";
-        readonly notes: "Aerial View API only — consumer place preview does not expose cinematic video URIs. map.aerialView with GMAPS_AERIAL_VIEW_API_KEY.";
-    };
     readonly mapsUrlBuilders: {
         readonly status: "working";
         readonly method: "N/A";

package/dist/known-surfaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"known-surfaces.d.ts","sourceRoot":"","sources":["../src/known-surfaces.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,UAAU,GACV,eAAe,GACf,SAAS,GACT,YAAY,GACZ,iBAAiB,CAAC;AAEtB,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqeqB,CAAC;AAEjD,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,cAAc,CAAC;AAE3D,wBAAgB,cAAc,CAAC,IAAI,EAAE,gBAAgB,GAAG,WAAW,CAElE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,gBAAgB,EAAE,CAI9E"}
+{"version":3,"file":"known-surfaces.d.ts","sourceRoot":"","sources":["../src/known-surfaces.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,UAAU,GACV,eAAe,GACf,SAAS,GACT,YAAY,GACZ,iBAAiB,CAAC;AAEtB,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8dqB,CAAC;AAEjD,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,cAAc,CAAC;AAE3D,wBAAgB,cAAc,CAAC,IAAI,EAAE,gBAAgB,GAAG,WAAW,CAElE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,gBAAgB,EAAE,CAI9E"}

package/dist/known-surfaces.js

@@ -200,12 +200,6 @@ export const KNOWN_SURFACES = {
         path: '/maps/vt/proto + viewport share URLs',
         notes: 'Composable tile sessions (map.tiles) and buildViewportLink — not the billed Maps JavaScript API.',
     },
-    aerialView: {
-        status: 'auth-required',
-        method: 'GET',
-        path: 'aerialview.googleapis.com/v1/videos:*',
-        notes: 'Aerial View API only — consumer place preview does not expose cinematic video URIs. map.aerialView with GMAPS_AERIAL_VIEW_API_KEY.',
-    },
     mapsUrlBuilders: {
         status: 'working',
         method: 'N/A',

package/dist/known-surfaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"known-surfaces.js","sourceRoot":"","sources":["../src/known-surfaces.ts"],"names":[],"mappings":"AAAA;;GAEG;AAiBH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,MAAM,EAAE;QACN,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,iBAAiB;QACvB,KAAK,EACH,wIAAwI;KAC3I;IACD,aAAa,EAAE;QACb,MAAM,EAAE,UAAU;QAClB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,iBAAiB;QACvB,KAAK,EACH,sHAAsH;KACzH;IACD,OAAO,EAAE;QACP,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,iBAAiB;QACvB,KAAK,EACH,kHAAkH;KACrH;IACD,YAAY,EAAE;QACZ,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,qBAAqB;QAC3B,KAAK,EACH,sIAAsI;KACzI;IACD,UAAU,EAAE;QACV,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,mCAAmC;QACzC,KAAK,EACH,4FAA4F;KAC/F;IACD,eAAe,EAAE;QACf,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,gCAAgC;QACtC,KAAK,EAAE,yFAAyF;KACjG;IACD,UAAU,EAAE;QACV,MAAM,EAAE,eAAe;QACvB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,wBAAwB;QAC9B,KAAK,EAAE,mDAAmD;KAC3D;IACD,UAAU,EAAE;QACV,MAAM,EAAE,YAAY;QACpB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,0BAA0B;QAChC,KAAK,EACH,yHAAyH;KAC5H;IACD,YAAY,EAAE;QACZ,MAAM,EAAE,iBAAiB;QACzB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,8BAA8B;QACpC,KAAK,EACH,4GAA4G;KAC/G;IACD,iBAAiB,EAAE;QACjB,MAAM,EAAE,UAAU;QAClB,MAAM,EAAE,OAAO;QACf,IAAI,EAAE,sBAAsB;QAC5B,KAAK,EACH,kHAAkH;KACrH;IACD,UAAU,EAAE;QACV,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,0BAA0B;QAChC,KAAK,EACH,sFAAsF;KACzF;IACD,wBAAwB,EAAE;QACxB,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,qCAAqC;QAC3C,KAAK,EAAE,2EAA2E;KACnF;IACD,qBAAqB,EAAE;QACrB,MAAM,EAAE,iBAAiB;QACzB,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,4EAA4E;QAClF,KAAK,EACH,sGAAsG;KACzG;IACD,aAAa,EAAE;QACb,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,6BAA6B;QACnC,KAAK,EACH,kGAAkG;KACrG;IACD,MAAM,EAAE;QACN,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,sBAAsB;QAC5B,KAAK,EAAE,qEAAqE;KAC7E;IACD,OAAO,EAAE;QACP,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,iCAAiC;QACvC,KAAK,EAAE,uEAAuE;KAC/E;IACD,cAAc,EAAE;QACd,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,uBAAuB;QAC7B,KAAK,EACH,qFAAqF;KACxF;IACD,gBAAgB,EAAE;QAChB,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,oBAAoB;QAC1B,KAAK,EAAE,mFAAmF;KAC3F;IACD,aAAa,EAAE;QACb,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,gBAAgB;QACtB,KAAK,EACH,maAAma;KACta;IACD,cAAc,EAAE;QACd,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,kEAAkE;KAC1E;IACD,QAAQ,EAAE;QACR,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,uCAAuC;QAC7C,KAAK,EAAE,gDAAgD;KACxD;IACD,eAAe,EAAE;QACf,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,wDAAwD;QAC9D,KAAK,EAAE,4DAA4D;KACpE;IACD,UAAU,EAAE;QACV,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,kCAAkC;QACxC,KAAK,EAAE,4DAA4D;KACpE;IACD,WAAW,EAAE;QACX,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,qBAAqB;QAC3B,KAAK,EACH,kHAAkH;KACrH;IACD,UAAU,EAAE;QACV,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,wCAAwC;QAC9C,KAAK,EAAE,mFAAmF;KAC3F;IACD,MAAM,EAAE;QACN,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,sBAAsB;QAC5B,KAAK,EACH,+FAA+F;KAClG;IACD,cAAc,EAAE;QACd,MAAM,EAAE,UAAU;QAClB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,0BAA0B;QAChC,KAAK,EACH,4FAA4F;KAC/F;IACD,SAAS,EAAE;QACT,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,oEAAoE;QAC1E,KAAK,EACH,uLAAuL;KAC1L;IACD,QAAQ,EAAE;QACR,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,iBAAiB;QACvB,KAAK,EACH,mFAAmF;KACtF;IACD,SAAS,EAAE;QACT,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,oCAAoC;QAC1C,KAAK,EACH,6FAA6F;KAChG;IACD,gBAAgB,EAAE;QAChB,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,iDAAiD;QACvD,KAAK,EACH,0GAA0G;KAC7G;IACD,SAAS,EAAE;QACT,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,mEAAmE;QACzE,KAAK,EACH,+EAA+E;KAClF;IACD,WAAW,EAAE;QACX,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,sCAAsC;QAC5C,KAAK,EACH,kGAAkG;KACrG;IACD,UAAU,EAAE;QACV,MAAM,EAAE,eAAe;QACvB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,uCAAuC;QAC7C,KAAK,EACH,oIAAoI;KACvI;IACD,eAAe,EAAE;QACf,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,2CAA2C;QACjD,KAAK,EAAE,qFAAqF;KAC7F;IACD,YAAY,EAAE;QACZ,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,0EAA0E;QAChF,KAAK,EAAE,8CAA8C;KACtD;IACD,eAAe,EAAE;QACf,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,0DAA0D;QAChE,KAAK,EAAE,0EAA0E;KAClF;IACD,kBAAkB,EAAE;QAClB,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,qFAAqF;QAC3F,KAAK,EAAE,oEAAoE;KAC5E;IACD,cAAc,EAAE;QACd,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,iEAAiE;QACvE,KAAK,EAAE,2EAA2E;KACnF;IACD,aAAa,EAAE;QACb,MAAM,EAAE,eAAe;QACvB,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,wEAAwE;QAC9E,KAAK,EACH,wGAAwG;KAC3G;IACD,iBAAiB,EAAE;QACjB,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,0EAA0E;QAChF,KAAK,EACH,+FAA+F;KAClG;IACD,YAAY,EAAE;QACZ,MAAM,EAAE,eAAe;QACvB,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,4EAA4E;QAClF,KAAK,EAAE,kDAAkD;KAC1D;IACD,mBAAmB,EAAE;QACnB,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,UAAU;QAClB,IAAI,EAAE,+DAA+D;QACrE,KAAK,EAAE,yEAAyE;KACjF;IACD,oBAAoB,EAAE;QACpB,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,6EAA6E;QACnF,KAAK,EACH,qFAAqF;KACxF;IACD,aAAa,EAAE;QACb,MAAM,EAAE,iBAAiB;QACzB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,sBAAsB;QAC5B,KAAK,EAAE,0DAA0D;KAClE;IACD,sBAAsB,EAAE;QACtB,MAAM,EAAE,iBAAiB;QACzB,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,qCAAqC;QAC3C,KAAK,EAAE,2EAA2E;KACnF;IACD,gBAAgB,EAAE;QAChB,MAAM,EAAE,eAAe;QACvB,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,qCAAqC;QAC3C,KAAK,EACH,sFAAsF;KACzF;IACD,oBAAoB,EAAE;QACpB,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,qCAAqC;QAC3C,KAAK,EACH,8FAA8F;KACjG;IACD,aAAa,EAAE;QACb,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,mDAAmD;QACzD,KAAK,EACH,wNAAwN;KAC3N;IACD,gBAAgB,EAAE;QAChB,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,2BAA2B;QACjC,KAAK,EACH,2IAA2I;KAC9I;IACD,UAAU,EAAE;QACV,MAAM,EAAE,UAAU;QAClB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,uCAAuC;QAC7C,KAAK,EACH,sMAAsM;KACzM;IACD,aAAa,EAAE;QACb,MAAM,EAAE,UAAU;QAClB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,iBAAiB;QACvB,KAAK,EACH,mJAAmJ;KACtJ;IACD,YAAY,EAAE;QACZ,MAAM,EAAE,UAAU;QAClB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,mCAAmC;QACzC,KAAK,EACH,6HAA6H;KAChI;IACD,eAAe,EAAE;QACf,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,yCAAyC;QAC/C,KAAK,EACH,yGAAyG;KAC5G;IACD,gBAAgB,EAAE;QAChB,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,8CAA8C;QACpD,KAAK,EACH,sQAAsQ;KACzQ;IACD,YAAY,EAAE;QACZ,MAAM,EAAE,UAAU;QAClB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,iBAAiB;QACvB,KAAK,EACH,+JAA+J;KAClK;IACD,WAAW,EAAE;QACX,MAAM,EAAE,UAAU;QAClB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,kDAAkD;QACxD,KAAK,EACH,qWAAqW;KACxW;IACD,cAAc,EAAE;QACd,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,yDAAyD;QAC/D,KAAK,EACH,oTAAoT;KACvT;IACD,gBAAgB,EAAE;QAChB,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,iCAAiC;QACvC,KAAK,EACH,qLAAqL;KACxL;IACD,YAAY,EAAE;QACZ,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,kCAAkC;QACxC,KAAK,EACH,mNAAmN;KACtN;IACD,SAAS,EAAE;QACT,MAAM,EAAE,eAAe;QACvB,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,0EAA0E;QAChF,KAAK,EACH,iQAAiQ;KACpQ;IACD,kBAAkB,EAAE;QAClB,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,+DAA+D;QACrE,KAAK,EACH,gPAAgP;KACnP;IACD,gBAAgB,EAAE;QAChB,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,gFAAgF;QACtF,KAAK,EACH,+TAA+T;KAClU;IACD,aAAa,EAAE;QACb,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,oCAAoC;QAC1C,KAAK,EACH,iVAAiV;KACpV;IACD,iBAAiB,EAAE;QACjB,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,iDAAiD;QACvD,KAAK,EACH,sRAAsR;KACzR;IACD,mBAAmB,EAAE;QACnB,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,sEAAsE;QAC5E,KAAK,EACH,+UAA+U;KAClV;IACD,UAAU,EAAE;QACV,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,mDAAmD;QACzD,KAAK,EACH,qSAAqS;KACxS;IACD,eAAe,EAAE;QACf,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,kDAAkD;QACxD,KAAK,EACH,4QAA4Q;KAC/Q;IACD,qBAAqB,EAAE;QACrB,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,yEAAyE;QAC/E,KAAK,EACH,yUAAyU;KAC5U;IACD,aAAa,EAAE;QACb,MAAM,EAAE,eAAe;QACvB,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,0EAA0E;QAChF,KAAK,EACH,2MAA2M;KAC9M;IACD,YAAY,EAAE;QACZ,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,wDAAwD;QAC9D,KAAK,EACH,+GAA+G;KAClH;IACD,oBAAoB,EAAE;QACpB,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,qDAAqD;QAC3D,KAAK,EACH,sFAAsF;KACzF;CAC6C,CAAC;AAIjD,MAAM,UAAU,cAAc,CAAC,IAAsB;IACnD,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAqB;IACxD,OAAQ,MAAM,CAAC,IAAI,CAAC,cAAc,CAAwB,CAAC,MAAM,CAC/D,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,CACjD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"known-surfaces.js","sourceRoot":"","sources":["../src/known-surfaces.ts"],"names":[],"mappings":"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"}

package/dist/lens/client.d.ts

@@ -0,0 +1,14 @@
+import type { LensConfig, LensSearchLinkOptions, LensSearchSession, LensUploadOptions } from './types.js';
+/** Builds the image-URL navigation offered by Google's shipped Lens upload service. */
+export declare function buildLensSearchUrl(url: string, options?: LensSearchLinkOptions): string;
+/** Starts anonymous Lens uploads; result recognition remains subject to Google's access checks. */
+export declare class LensClient {
+    private readonly fetcher;
+    private readonly locale;
+    private readonly timeoutMs;
+    constructor(config?: LensConfig);
+    searchUrl(url: string): string;
+    /** Uploads caller-supplied image bytes and returns Google's redirect without loading result pages. */
+    createSearch(image: Uint8Array | Blob, options?: LensUploadOptions): Promise<LensSearchSession>;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/lens/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAS1G,uFAAuF;AACvF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,MAAM,CAS3F;AAED,mGAAmG;AACnG,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBACvB,MAAM,GAAE,UAAe;IAOnC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAE9B,sGAAsG;IAChG,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAiD1G"}

package/dist/lens/client.js

@@ -0,0 +1,116 @@
+import { LensError } from './errors.js';
+function imageUrl(value) {
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        throw new TypeError('Lens requires an absolute HTTP or HTTPS image URL');
+    }
+    if (!['http:', 'https:'].includes(url.protocol) || url.username || url.password)
+        throw new TypeError('Lens requires an HTTP or HTTPS image URL without credentials');
+    return url.toString();
+}
+/** Builds the image-URL navigation offered by Google's shipped Lens upload service. */
+export function buildLensSearchUrl(url, options = {}) {
+    const endpoint = new URL('https://lens.google.com/v3/upload');
+    endpoint.searchParams.set('url', imageUrl(url));
+    endpoint.searchParams.set('ep', 'gsbubu');
+    endpoint.searchParams.set('st', String(Date.now()));
+    endpoint.searchParams.set('vpw', '1280');
+    endpoint.searchParams.set('vph', '720');
+    if (options.locale)
+        endpoint.searchParams.set('hl', options.locale);
+    return endpoint.toString();
+}
+/** Starts anonymous Lens uploads; result recognition remains subject to Google's access checks. */
+export class LensClient {
+    fetcher;
+    locale;
+    timeoutMs;
+    constructor(config = {}) {
+        this.fetcher = config.fetch ?? globalThis.fetch;
+        this.locale = config.locale ?? 'en-US';
+        this.timeoutMs = config.timeoutMs ?? 30_000;
+        if (!Number.isFinite(this.timeoutMs) || this.timeoutMs <= 0 || this.timeoutMs > 2_147_483_647)
+            throw new RangeError('timeoutMs must be positive and no greater than 2147483647');
+    }
+    searchUrl(url) { return buildLensSearchUrl(url, { locale: this.locale }); }
+    /** Uploads caller-supplied image bytes and returns Google's redirect without loading result pages. */
+    async createSearch(image, options = {}) {
+        const mimeType = options.mimeType ?? ((image instanceof Blob ? image.type : '') || 'image/png');
+        if (!['image/png', 'image/jpeg', 'image/webp', 'image/gif'].includes(mimeType))
+            throw new TypeError('Lens supports PNG, JPEG, WebP, or GIF image bytes');
+        const blob = image instanceof Blob ? new Blob([image], { type: mimeType }) : image instanceof Uint8Array ? new Blob([new Uint8Array(image).buffer], { type: mimeType }) : undefined;
+        if (!blob || blob.size === 0)
+            throw new TypeError('A nonempty image Blob or Uint8Array is required');
+        if ((options.width === undefined) !== (options.height === undefined))
+            throw new TypeError('width and height must be provided together');
+        if (options.width !== undefined && (!Number.isSafeInteger(options.width) || options.width <= 0 || !Number.isSafeInteger(options.height) || options.height <= 0))
+            throw new RangeError('Image dimensions must be positive integers');
+        if (options.signal?.aborted)
+            throw options.signal.reason ?? new DOMException('The operation was aborted', 'AbortError');
+        const body = new FormData();
+        // The shipped UEShwc service submits encoded_image and optional processed_image_dimensions.
+        body.set('encoded_image', blob, options.filename ?? `image.${mimeType === 'image/jpeg' ? 'jpg' : mimeType.slice(6)}`);
+        if (options.width !== undefined)
+            body.set('processed_image_dimensions', `${options.width},${options.height}`);
+        const endpoint = new URL('https://lens.google.com/v3/upload');
+        endpoint.searchParams.set('ep', 'gsbubb');
+        endpoint.searchParams.set('st', String(Date.now()));
+        endpoint.searchParams.set('hl', this.locale);
+        endpoint.searchParams.set('vpw', '1280');
+        endpoint.searchParams.set('vph', '720');
+        const controller = new AbortController();
+        const abort = () => controller.abort(options.signal?.reason ?? new DOMException('The operation was aborted', 'AbortError'));
+        options.signal?.addEventListener('abort', abort, { once: true });
+        const timer = setTimeout(() => controller.abort(new LensError('Lens upload timed out', 'timeout')), this.timeoutMs);
+        timer.unref?.();
+        try {
+            const response = await this.fetcher(endpoint.toString(), { method: 'POST', body, redirect: 'manual', signal: controller.signal });
+            const text = await response.text();
+            if (controller.signal.aborted)
+                throw controller.signal.reason;
+            const retry = response.headers.get('retry-after');
+            const retryAfterMs = retry && /^\d+(?:\.\d+)?$/.test(retry) ? Number(retry) * 1000 : undefined;
+            if (response.status === 429)
+                throw new LensError('Google Lens rate limited this request', 'rate-limit', 429, retryAfterMs);
+            if (/g-recaptcha|Our systems have detected unusual traffic|\/sorry\//i.test(text) || response.url.includes('/sorry/'))
+                throw new LensError('Google Lens returned a traffic challenge', 'blocked', response.status);
+            if (response.status === 401)
+                throw new LensError('Google Lens requires authentication', 'auth-required', 401);
+            const location = response.headers.get('location');
+            if (location && [301, 302, 303, 307, 308].includes(response.status)) {
+                let target;
+                try {
+                    target = new URL(location, endpoint);
+                }
+                catch {
+                    throw new LensError('Google Lens returned a malformed redirect', 'parse', response.status);
+                }
+                if (target.hostname === 'accounts.google.com' || target.pathname.includes('ServiceLogin'))
+                    throw new LensError('Google Lens requires authentication', 'auth-required', response.status);
+                if (target.protocol !== 'https:' || !['www.google.com', 'google.com', 'lens.google.com'].includes(target.hostname) || target.username || target.password || target.port)
+                    throw new LensError('Google Lens returned an unexpected redirect', 'parse', response.status);
+                if (target.pathname.startsWith('/sorry/'))
+                    throw new LensError('Google Lens requires a traffic challenge', 'blocked', response.status);
+                return { url: target.toString(), raw: { status: response.status, location, body: text } };
+            }
+            if (!response.ok)
+                throw new LensError(`Google Lens returned HTTP ${response.status}`, 'http', response.status, retryAfterMs);
+            throw new LensError('Google Lens did not provide a results redirect', 'parse', response.status);
+        }
+        catch (cause) {
+            if (controller.signal.aborted)
+                throw controller.signal.reason;
+            if (cause instanceof LensError)
+                throw cause;
+            throw new LensError('Google Lens upload failed', 'network', undefined, undefined, { cause });
+        }
+        finally {
+            clearTimeout(timer);
+            options.signal?.removeEventListener('abort', abort);
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/lens/client.js.map

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

package/dist/lens/errors.d.ts

@@ -0,0 +1,8 @@
+export type LensErrorKind = 'http' | 'blocked' | 'auth-required' | 'rate-limit' | 'parse' | 'network' | 'timeout';
+export declare class LensError extends Error {
+    readonly kind: LensErrorKind;
+    readonly status?: number | undefined;
+    readonly retryAfterMs?: number | undefined;
+    constructor(message: string, kind: LensErrorKind, status?: number | undefined, retryAfterMs?: number | undefined, options?: ErrorOptions);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/lens/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lens/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,eAAe,GAAG,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAClH,qBAAa,SAAU,SAAQ,KAAK;IACL,QAAQ,CAAC,IAAI,EAAE,aAAa;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM;IAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM;gBAAvG,OAAO,EAAE,MAAM,EAAW,IAAI,EAAE,aAAa,EAAW,MAAM,CAAC,EAAE,MAAM,YAAA,EAAW,YAAY,CAAC,EAAE,MAAM,YAAA,EAAE,OAAO,CAAC,EAAE,YAAY;CAI5I"}

package/dist/lens/errors.js

@@ -0,0 +1,13 @@
+export class LensError extends Error {
+    kind;
+    status;
+    retryAfterMs;
+    constructor(message, kind, status, retryAfterMs, options) {
+        super(message, options);
+        this.kind = kind;
+        this.status = status;
+        this.retryAfterMs = retryAfterMs;
+        this.name = 'LensError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/lens/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lens/errors.ts"],"names":[],"mappings":"AACA,MAAM,OAAO,SAAU,SAAQ,KAAK;IACI;IAA8B;IAA0B;IAA9F,YAAY,OAAe,EAAW,IAAmB,EAAW,MAAe,EAAW,YAAqB,EAAE,OAAsB;QACzI,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QADY,SAAI,GAAJ,IAAI,CAAe;QAAW,WAAM,GAAN,MAAM,CAAS;QAAW,iBAAY,GAAZ,YAAY,CAAS;QAEjH,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF"}

package/dist/lens/types.d.ts

@@ -0,0 +1,27 @@
+export interface LensConfig {
+    fetch?: typeof globalThis.fetch;
+    locale?: string;
+    timeoutMs?: number;
+}
+export interface LensRequestOptions {
+    signal?: AbortSignal;
+}
+export interface LensUploadOptions extends LensRequestOptions {
+    filename?: string;
+    mimeType?: 'image/png' | 'image/jpeg' | 'image/webp' | 'image/gif';
+    width?: number;
+    height?: number;
+}
+export interface LensSearchLinkOptions {
+    locale?: string;
+}
+export interface LensSearchSession {
+    /** Google-issued results URL; opening it may still require an access challenge. */
+    url: string;
+    raw: {
+        status: number;
+        location: string;
+        body: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lens/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AACD,MAAM,WAAW,kBAAkB;IAAG,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE;AAC5D,MAAM,WAAW,iBAAkB,SAAQ,kBAAkB;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,WAAW,GAAG,YAAY,GAAG,YAAY,GAAG,WAAW,CAAC;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AACD,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AACD,MAAM,WAAW,iBAAiB;IAChC,mFAAmF;IACnF,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACzD"}

package/dist/lens/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/lens/types.js.map

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

package/dist/lens.d.ts

@@ -0,0 +1,8 @@
+export { LensClient, buildLensSearchUrl } from './lens/client.js';
+export { LensError } from './lens/errors.js';
+export type { LensErrorKind } from './lens/errors.js';
+export type * from './lens/types.js';
+import { LensClient } from './lens/client.js';
+import type { LensConfig } from './lens/types.js';
+export declare function lens(config?: LensConfig): LensClient;
+//# sourceMappingURL=lens.d.ts.map

package/dist/lens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lens.d.ts","sourceRoot":"","sources":["../src/lens.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,mBAAmB,iBAAiB,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,wBAAgB,IAAI,CAAC,MAAM,GAAE,UAAe,GAAG,UAAU,CAAmC"}

package/dist/lens.js

@@ -0,0 +1,5 @@
+export { LensClient, buildLensSearchUrl } from './lens/client.js';
+export { LensError } from './lens/errors.js';
+import { LensClient } from './lens/client.js';
+export function lens(config = {}) { return new LensClient(config); }
+//# sourceMappingURL=lens.js.map

package/dist/lens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lens.js","sourceRoot":"","sources":["../src/lens.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAG7C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,UAAU,IAAI,CAAC,SAAqB,EAAE,IAAgB,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC"}

package/dist/news.d.ts

@@ -0,0 +1,46 @@
+import { type GoogleWebConfig, type GoogleWebRequestOptions } from './utils/google-web.js';
+export { GoogleWebError } from './utils/google-web.js';
+export interface GoogleNewsConfig extends GoogleWebConfig {
+    language?: string;
+    country?: string;
+    edition?: string;
+}
+export interface GoogleNewsOptions extends GoogleWebRequestOptions {
+    language?: string;
+    country?: string;
+    edition?: string;
+}
+export interface GoogleNewsArticle {
+    title: string;
+    url: string;
+    guid?: string;
+    publishedAt?: string;
+    source?: {
+        name: string;
+        url?: string;
+    };
+    descriptionHtml?: string;
+    rawXml: string;
+}
+export interface GoogleNewsFeed {
+    title: string;
+    url: string;
+    language?: string;
+    copyright?: string;
+    articles: GoogleNewsArticle[];
+    rawXml: string;
+}
+/** Parse Google News RSS metadata; article links remain Google's publisher redirects. */
+export declare function parseGoogleNewsRss(xml: string): GoogleNewsFeed;
+/** Public headline and query feeds, separate from paid third-party news APIs. */
+export declare class GoogleNewsClient {
+    private readonly fetcher;
+    private readonly timeoutMs;
+    private readonly defaults;
+    constructor(config?: GoogleNewsConfig);
+    headlines(options?: GoogleNewsOptions): Promise<GoogleNewsFeed>;
+    search(query: string, options?: GoogleNewsOptions): Promise<GoogleNewsFeed>;
+    private feed;
+}
+export declare function googleNews(config?: GoogleNewsConfig): GoogleNewsClient;
+//# sourceMappingURL=news.d.ts.map

package/dist/news.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"news.d.ts","sourceRoot":"","sources":["../src/news.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2D,KAAK,eAAe,EAAE,KAAK,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEpJ,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IAAG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE;AACnH,MAAM,WAAW,iBAAkB,SAAQ,uBAAuB;IAAG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE;AAC5H,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AACD,MAAM,WAAW,cAAc;IAAG,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AA+HpJ,yFAAyF;AACzF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAuB9D;AAED,iFAAiF;AACjF,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;gBAEhC,MAAM,GAAE,gBAAqB;IAMzC,SAAS,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,cAAc,CAAC;IAEnE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,cAAc,CAAC;YAKjE,IAAI;CAUnB;AAED,wBAAgB,UAAU,CAAC,MAAM,GAAE,gBAAqB,GAAG,gBAAgB,CAAyC"}

package/dist/news.js

@@ -0,0 +1,202 @@
+import { googleWebText, GoogleWebError, positiveTimeout, xmlText } from './utils/google-web.js';
+export { GoogleWebError } from './utils/google-web.js';
+function malformedXml(message = 'Malformed Google News RSS feed') {
+    throw new GoogleWebError(message, 'parse');
+}
+function xmlTagEnd(xml, start) {
+    let quote;
+    for (let i = start; i < xml.length; i++) {
+        const character = xml[i];
+        if (quote) {
+            if (character === quote)
+                quote = undefined;
+        }
+        else if (character === '"' || character === "'")
+            quote = character;
+        else if (character === '>')
+            return i;
+        else if (character === '<')
+            return malformedXml();
+    }
+    return malformedXml();
+}
+function xmlAttributes(value) {
+    const attributes = Object.create(null);
+    const pattern = /\s+([A-Za-z_][\w.:-]*)\s*=\s*(?:"([^"<]*)"|'([^'<]*)')/y;
+    let cursor = 0;
+    while (cursor < value.length) {
+        if (!value.slice(cursor).trim())
+            break;
+        pattern.lastIndex = cursor;
+        const match = pattern.exec(value);
+        if (!match || match[1] in attributes)
+            return malformedXml('Malformed Google News XML attributes');
+        attributes[match[1]] = xmlText(match[2] ?? match[3]);
+        cursor = pattern.lastIndex;
+    }
+    return attributes;
+}
+function xmlRoot(xml) {
+    if (typeof xml !== 'string' || xml.length > 10_000_000)
+        return malformedXml('RSS exceeds the supported input size');
+    const stack = [];
+    let root;
+    let cursor = 0, count = 0;
+    while (cursor < xml.length) {
+        if (xml[cursor] !== '<') {
+            const next = xml.indexOf('<', cursor);
+            const end = next === -1 ? xml.length : next;
+            const text = xml.slice(cursor, end);
+            const parent = stack[stack.length - 1];
+            if (parent)
+                parent.parts.push(text);
+            else if (text.trim())
+                return malformedXml();
+            cursor = end;
+            continue;
+        }
+        if (xml.startsWith('<!--', cursor)) {
+            const end = xml.indexOf('-->', cursor + 4);
+            if (end === -1 || xml.slice(cursor + 4, end).includes('--'))
+                return malformedXml('Malformed Google News XML comment');
+            cursor = end + 3;
+            continue;
+        }
+        if (xml.startsWith('<![CDATA[', cursor)) {
+            const parent = stack[stack.length - 1];
+            const end = xml.indexOf(']]>', cursor + 9);
+            if (!parent || end === -1)
+                return malformedXml('Malformed Google News CDATA');
+            parent.parts.push({ cdata: xml.slice(cursor + 9, end) });
+            cursor = end + 3;
+            continue;
+        }
+        if (xml.startsWith('<?', cursor)) {
+            const end = xml.indexOf('?>', cursor + 2);
+            if (end === -1)
+                return malformedXml('Malformed Google News XML processing instruction');
+            cursor = end + 2;
+            continue;
+        }
+        if (xml.startsWith('<!', cursor))
+            return malformedXml('RSS declarations and external entities are unsupported');
+        const end = xmlTagEnd(xml, cursor + 1);
+        const token = xml.slice(cursor + 1, end);
+        if (token.startsWith('/')) {
+            const match = /^\/([A-Za-z_][\w.:-]*)\s*$/.exec(token);
+            const node = stack.pop();
+            if (!match || !node || node.name !== match[1])
+                return malformedXml('Mismatched Google News XML element');
+            node.closing = xml.slice(cursor, end + 1);
+            node.end = end + 1;
+        }
+        else {
+            const match = /^([A-Za-z_][\w.:-]*)([\s\S]*)$/.exec(token);
+            if (!match)
+                return malformedXml();
+            const selfClosing = /\/\s*$/.test(match[2]);
+            const attributeText = selfClosing ? match[2].replace(/\/\s*$/, '') : match[2];
+            const node = {
+                name: match[1], attributes: xmlAttributes(attributeText), parts: [], children: [],
+                opening: xml.slice(cursor, end + 1), closing: '', start: cursor, end: end + 1,
+            };
+            const parent = stack[stack.length - 1];
+            if (parent) {
+                parent.children.push(node);
+                parent.parts.push(node);
+            }
+            else if (root)
+                return malformedXml('Google News RSS has multiple root elements');
+            else
+                root = node;
+            if (++count > 50_000 || stack.length >= 64)
+                return malformedXml('RSS exceeds supported XML complexity');
+            if (!selfClosing)
+                stack.push(node);
+        }
+        cursor = end + 1;
+    }
+    if (stack.length || !root)
+        return malformedXml('Truncated Google News RSS feed');
+    return root;
+}
+function elementContent(element) {
+    return element.parts.map(part => typeof part === 'string' ? xmlText(part) : 'cdata' in part ? part.cdata : xmlText(part.opening) + elementContent(part) + xmlText(part.closing)).join('');
+}
+function field(element, name) {
+    const child = element.children.find(item => item.name === name);
+    return child ? elementContent(child) : undefined;
+}
+function httpUrl(value, name) {
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        throw new GoogleWebError(`Google News has an invalid ${name}`, 'parse');
+    }
+    if ((url.protocol !== 'https:' && url.protocol !== 'http:') || url.username || url.password)
+        throw new GoogleWebError(`Google News has an invalid ${name}`, 'parse');
+    return url.toString();
+}
+/** Parse Google News RSS metadata; article links remain Google's publisher redirects. */
+export function parseGoogleNewsRss(xml) {
+    const root = xmlRoot(xml);
+    const channels = root.children.filter(child => child.name === 'channel');
+    if (root.name !== 'rss' || channels.length !== 1)
+        return malformedXml();
+    const channel = channels[0];
+    const title = field(channel, 'title'), link = field(channel, 'link');
+    if (!title || !link)
+        throw new GoogleWebError('Google News RSS has no channel title or URL', 'parse');
+    const articles = channel.children.filter(child => child.name === 'item').map(item => {
+        const rawXml = xml.slice(item.start, item.end);
+        const title = field(item, 'title'), link = field(item, 'link');
+        if (!title || !link)
+            throw new GoogleWebError('Google News article has no title or URL', 'parse');
+        const source = item.children.find(child => child.name === 'source');
+        const sourceUrl = source?.attributes.url;
+        const date = field(item, 'pubDate');
+        if (date && !Number.isFinite(Date.parse(date)))
+            throw new GoogleWebError('Google News article has an invalid publication date', 'parse');
+        return {
+            title, url: httpUrl(link, 'article URL'), guid: field(item, 'guid'),
+            publishedAt: date ? new Date(date).toISOString() : undefined,
+            source: source ? { name: elementContent(source), url: sourceUrl ? httpUrl(sourceUrl, 'source URL') : undefined } : undefined,
+            descriptionHtml: field(item, 'description'), rawXml,
+        };
+    });
+    return { title, url: httpUrl(link, 'channel URL'), language: field(channel, 'language'), copyright: field(channel, 'copyright'), articles, rawXml: xml };
+}
+/** Public headline and query feeds, separate from paid third-party news APIs. */
+export class GoogleNewsClient {
+    fetcher;
+    timeoutMs;
+    defaults;
+    constructor(config = {}) {
+        this.fetcher = config.fetch ?? globalThis.fetch;
+        this.timeoutMs = positiveTimeout(config.timeoutMs ?? 30_000);
+        this.defaults = config;
+    }
+    headlines(options = {}) { return this.feed('/rss', options); }
+    search(query, options = {}) {
+        if (typeof query !== 'string' || !query.trim())
+            throw new TypeError('Google News query must not be empty');
+        return this.feed('/rss/search', options, query);
+    }
+    async feed(path, options, query) {
+        const language = options.language ?? this.defaults.language ?? 'en-US';
+        const country = options.country ?? this.defaults.country ?? 'US';
+        const edition = options.edition ?? this.defaults.edition ?? `${country}:${language.split('-')[0]}`;
+        if (!/^[a-zA-Z]{2,8}(?:-[a-zA-Z0-9]{1,8})*$/.test(language) || !/^[A-Z]{2}$/.test(country) || !/^[A-Z]{2}:[a-zA-Z-]+$/.test(edition))
+            throw new TypeError('Invalid Google News locale or edition');
+        const url = new URL(path, 'https://news.google.com');
+        for (const [key, value] of Object.entries({ hl: language, gl: country, ceid: edition }))
+            url.searchParams.set(key, value);
+        if (query !== undefined)
+            url.searchParams.set('q', query);
+        return parseGoogleNewsRss(await googleWebText(this.fetcher, url, { method: 'GET' }, this.timeoutMs, options.signal));
+    }
+}
+export function googleNews(config = {}) { return new GoogleNewsClient(config); }
+//# sourceMappingURL=news.js.map

package/dist/news.js.map

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

package/dist/pagespeed/client.d.ts

@@ -0,0 +1,28 @@
+import type { AnalyzeOptions, CreateAnalysisOptions, PageSpeedAnalysis, PageSpeedConfig, PageSpeedRequestOptions, RunPagespeedOptions, RunPagespeedResponse, WaitForAnalysisOptions } from './types.js';
+/** A keyless PageSpeed web client with an explicit official API method. */
+export declare class PageSpeedClient {
+    private readonly fetcher;
+    private readonly locale;
+    private readonly requestTimeoutMs;
+    private readonly apiKey?;
+    private session?;
+    private requestId;
+    constructor(config?: PageSpeedConfig);
+    /** Starts the website's mobile and desktop Lighthouse, URL CrUX, and origin CrUX jobs. */
+    createAnalysis(url: string, options?: CreateAnalysisOptions): Promise<PageSpeedAnalysis>;
+    /** Retrieves an existing analysis by ID or a pagespeed.web.dev report URL. */
+    getAnalysis(idOrReportUrl: string, options?: PageSpeedRequestOptions): Promise<PageSpeedAnalysis>;
+    /** Refreshes pending jobs once and merges them by result ID. */
+    pollAnalysis(analysisOrId: PageSpeedAnalysis | string, options?: PageSpeedRequestOptions): Promise<PageSpeedAnalysis>;
+    /** Waits for jobs to finish; per-job errors remain available on the returned results. */
+    waitForAnalysis(analysisOrId: PageSpeedAnalysis | string, options?: WaitForAnalysisOptions): Promise<PageSpeedAnalysis>;
+    /** Creates an analysis and waits for both strategies and their field-data jobs. */
+    analyze(url: string, options?: AnalyzeOptions): Promise<PageSpeedAnalysis>;
+    /** Calls the documented v5 API; categories and API keys apply only to this method. */
+    runPagespeed(url: string, options?: RunPagespeedOptions): Promise<RunPagespeedResponse>;
+    private bootstrap;
+    private rpc;
+    private request;
+}
+export declare function pageSpeed(config?: PageSpeedConfig): PageSpeedClient;
+//# sourceMappingURL=client.d.ts.map