@dromney/mapthis 0.1.0

package/dist/geocoding/index.cjs

@@ -0,0 +1,90 @@
+'use strict';
+
+var googleMapsServicesJs = require('@googlemaps/google-maps-services-js');
+
+// src/types/errors.ts
+var MapthisError = class extends Error {
+  constructor(message, options) {
+    super(message, options);
+    this.name = "MapthisError";
+  }
+};
+
+// src/geocoding/errors.ts
+var GeocodingError = class extends MapthisError {
+  constructor(message, options) {
+    super(message, options);
+    this.name = "GeocodingError";
+  }
+};
+function createGoogleGeocoder(config) {
+  const client = new googleMapsServicesJs.Client({});
+  const apiKey = config.apiKey;
+  const geocode = (input) => new Promise((resolve) => {
+    client.findPlaceFromText({
+      params: {
+        key: apiKey,
+        input: input.address,
+        inputtype: googleMapsServicesJs.PlaceInputType.textQuery,
+        fields: ["name", "geometry", "formatted_address", "place_id"],
+        locationbias: "circle:20000000@0,0"
+      }
+    }).then((res) => {
+      if (res.status !== 200) {
+        return resolve({
+          input,
+          data: null,
+          error: `${res.data.error_message ?? res.statusText}`
+        });
+      }
+      const place = res.data.candidates[0];
+      if (!place) {
+        return resolve({ input, data: null, error: "no_results" });
+      }
+      if (!place.formatted_address || !place.geometry?.location?.lat || !place.geometry?.location?.lng || !place.name || !place.place_id) {
+        return resolve({
+          input,
+          data: null,
+          error: "invalid_place_data"
+        });
+      }
+      return resolve({
+        input,
+        error: null,
+        data: {
+          provider: "google",
+          name: place.name,
+          address: place.formatted_address,
+          lat: place.geometry.location.lat,
+          lng: place.geometry.location.lng,
+          providerId: place.place_id
+        }
+      });
+    }).catch(() => {
+      resolve({ input, data: null, error: "unknown" });
+    });
+  });
+  return {
+    name: "google",
+    geocode,
+    geocodeMany: (inputs) => Promise.all(inputs.map(geocode))
+  };
+}
+
+// src/geocoding/factory.ts
+function createGeocoder(config) {
+  switch (config.provider) {
+    case "google":
+      return createGoogleGeocoder(config);
+    default: {
+      const _exhaustive = config.provider;
+      throw new Error(`Unsupported geocoding provider: ${_exhaustive}`);
+    }
+  }
+}
+
+exports.GeocodingError = GeocodingError;
+exports.createGeocoder = createGeocoder;
+exports.createGoogleGeocoder = createGoogleGeocoder;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/geocoding/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/errors.ts","../../src/geocoding/errors.ts","../../src/geocoding/google.ts","../../src/geocoding/factory.ts"],"names":["Client","PlaceInputType"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Base error class for every error thrown by the mapthis package.\n *\n * All feature-specific error classes (scrape, search, ai, geocoding) extend\n * this, so consumers can do `catch (e) { if (e instanceof MapthisError) ... }`\n * to distinguish library errors from other exceptions.\n */\nexport class MapthisError extends Error {\n    constructor(message?: string, options?: ErrorOptions) {\n        super(message, options)\n        this.name = \"MapthisError\"\n    }\n}\n","import { MapthisError } from \"../types/errors\"\n\nexport class GeocodingError extends MapthisError {\n    constructor(message?: string, options?: ErrorOptions) {\n        super(message, options)\n        this.name = \"GeocodingError\"\n    }\n}\n","import { Client, PlaceInputType } from \"@googlemaps/google-maps-services-js\"\nimport type { ParsedLocation, PlaceQueryResult } from \"../types/domain\"\nimport type { GeocodingProvider, GoogleGeocoderConfig } from \"./types\"\n\n/**\n * Create a Google Maps-backed {@link GeocodingProvider}.\n *\n * Under the hood this uses `findPlaceFromText` with a global location bias,\n * which is a low-cost single-candidate lookup. For multi-candidate ranked\n * searches, consumers should reach for the Places library directly.\n */\nexport function createGoogleGeocoder(config: GoogleGeocoderConfig): GeocodingProvider {\n    const client = new Client({})\n    const apiKey = config.apiKey\n\n    const geocode = (input: ParsedLocation): Promise<PlaceQueryResult> =>\n        new Promise((resolve) => {\n            client\n                .findPlaceFromText({\n                    params: {\n                        key: apiKey,\n                        input: input.address,\n                        inputtype: PlaceInputType.textQuery,\n                        fields: [\"name\", \"geometry\", \"formatted_address\", \"place_id\"],\n                        locationbias: \"circle:20000000@0,0\",\n                    },\n                })\n                .then((res) => {\n                    if (res.status !== 200) {\n                        return resolve({\n                            input,\n                            data: null,\n                            error: `${res.data.error_message ?? res.statusText}`,\n                        })\n                    }\n                    const place = res.data.candidates[0]\n                    if (!place) {\n                        return resolve({ input, data: null, error: \"no_results\" })\n                    }\n                    if (\n                        !place.formatted_address ||\n                        !place.geometry?.location?.lat ||\n                        !place.geometry?.location?.lng ||\n                        !place.name ||\n                        !place.place_id\n                    ) {\n                        return resolve({\n                            input,\n                            data: null,\n                            error: \"invalid_place_data\",\n                        })\n                    }\n                    return resolve({\n                        input,\n                        error: null,\n                        data: {\n                            provider: \"google\",\n                            name: place.name,\n                            address: place.formatted_address,\n                            lat: place.geometry.location.lat,\n                            lng: place.geometry.location.lng,\n                            providerId: place.place_id,\n                        },\n                    })\n                })\n                .catch(() => {\n                    resolve({ input, data: null, error: \"unknown\" })\n                })\n        })\n\n    return {\n        name: \"google\",\n        geocode,\n        geocodeMany: (inputs) => Promise.all(inputs.map(geocode)),\n    }\n}\n","import { createGoogleGeocoder } from \"./google\"\nimport type { GeocoderConfig, GeocodingProvider } from \"./types\"\n\n/**\n * Create a {@link GeocodingProvider} from a config object. The provider field\n * on the config discriminates which implementation is returned.\n *\n * @example\n * ```ts\n * const geocoder = createGeocoder({\n *   provider: \"google\",\n *   apiKey: process.env.GOOGLE_MAPS_KEY!,\n * })\n * const result = await geocoder.geocode({ address: \"Acropolis, Athens, Greece\" })\n * if (result.data) console.log(result.data.lat, result.data.lng)\n * ```\n */\nexport function createGeocoder(config: GeocoderConfig): GeocodingProvider {\n    switch (config.provider) {\n        case \"google\":\n            return createGoogleGeocoder(config)\n        default: {\n            const _exhaustive: never = config.provider\n            throw new Error(`Unsupported geocoding provider: ${_exhaustive as string}`)\n        }\n    }\n}\n"]}

package/dist/geocoding/index.d.cts

@@ -0,0 +1,36 @@
+import { M as MapthisError } from '../errors-Bw97z_4m.cjs';
+import { a as GeocoderConfig, G as GeocodingProvider, b as GoogleGeocoderConfig } from '../types-rFjK5YcJ.cjs';
+import '../domain-Dc1wSTkf.cjs';
+import '../schemas-Dy5coqXo.cjs';
+import 'zod';
+
+declare class GeocodingError extends MapthisError {
+    constructor(message?: string, options?: ErrorOptions);
+}
+
+/**
+ * Create a {@link GeocodingProvider} from a config object. The provider field
+ * on the config discriminates which implementation is returned.
+ *
+ * @example
+ * ```ts
+ * const geocoder = createGeocoder({
+ *   provider: "google",
+ *   apiKey: process.env.GOOGLE_MAPS_KEY!,
+ * })
+ * const result = await geocoder.geocode({ address: "Acropolis, Athens, Greece" })
+ * if (result.data) console.log(result.data.lat, result.data.lng)
+ * ```
+ */
+declare function createGeocoder(config: GeocoderConfig): GeocodingProvider;
+
+/**
+ * Create a Google Maps-backed {@link GeocodingProvider}.
+ *
+ * Under the hood this uses `findPlaceFromText` with a global location bias,
+ * which is a low-cost single-candidate lookup. For multi-candidate ranked
+ * searches, consumers should reach for the Places library directly.
+ */
+declare function createGoogleGeocoder(config: GoogleGeocoderConfig): GeocodingProvider;
+
+export { GeocoderConfig, GeocodingError, GeocodingProvider, GoogleGeocoderConfig, createGeocoder, createGoogleGeocoder };

package/dist/geocoding/index.d.ts

@@ -0,0 +1,36 @@
+import { M as MapthisError } from '../errors-Bw97z_4m.js';
+import { a as GeocoderConfig, G as GeocodingProvider, b as GoogleGeocoderConfig } from '../types-BhqKlq0k.js';
+import '../domain-CZ-L-ntu.js';
+import '../schemas-Dy5coqXo.js';
+import 'zod';
+
+declare class GeocodingError extends MapthisError {
+    constructor(message?: string, options?: ErrorOptions);
+}
+
+/**
+ * Create a {@link GeocodingProvider} from a config object. The provider field
+ * on the config discriminates which implementation is returned.
+ *
+ * @example
+ * ```ts
+ * const geocoder = createGeocoder({
+ *   provider: "google",
+ *   apiKey: process.env.GOOGLE_MAPS_KEY!,
+ * })
+ * const result = await geocoder.geocode({ address: "Acropolis, Athens, Greece" })
+ * if (result.data) console.log(result.data.lat, result.data.lng)
+ * ```
+ */
+declare function createGeocoder(config: GeocoderConfig): GeocodingProvider;
+
+/**
+ * Create a Google Maps-backed {@link GeocodingProvider}.
+ *
+ * Under the hood this uses `findPlaceFromText` with a global location bias,
+ * which is a low-cost single-candidate lookup. For multi-candidate ranked
+ * searches, consumers should reach for the Places library directly.
+ */
+declare function createGoogleGeocoder(config: GoogleGeocoderConfig): GeocodingProvider;
+
+export { GeocoderConfig, GeocodingError, GeocodingProvider, GoogleGeocoderConfig, createGeocoder, createGoogleGeocoder };

package/dist/geocoding/index.js

@@ -0,0 +1,86 @@
+import { Client, PlaceInputType } from '@googlemaps/google-maps-services-js';
+
+// src/types/errors.ts
+var MapthisError = class extends Error {
+  constructor(message, options) {
+    super(message, options);
+    this.name = "MapthisError";
+  }
+};
+
+// src/geocoding/errors.ts
+var GeocodingError = class extends MapthisError {
+  constructor(message, options) {
+    super(message, options);
+    this.name = "GeocodingError";
+  }
+};
+function createGoogleGeocoder(config) {
+  const client = new Client({});
+  const apiKey = config.apiKey;
+  const geocode = (input) => new Promise((resolve) => {
+    client.findPlaceFromText({
+      params: {
+        key: apiKey,
+        input: input.address,
+        inputtype: PlaceInputType.textQuery,
+        fields: ["name", "geometry", "formatted_address", "place_id"],
+        locationbias: "circle:20000000@0,0"
+      }
+    }).then((res) => {
+      if (res.status !== 200) {
+        return resolve({
+          input,
+          data: null,
+          error: `${res.data.error_message ?? res.statusText}`
+        });
+      }
+      const place = res.data.candidates[0];
+      if (!place) {
+        return resolve({ input, data: null, error: "no_results" });
+      }
+      if (!place.formatted_address || !place.geometry?.location?.lat || !place.geometry?.location?.lng || !place.name || !place.place_id) {
+        return resolve({
+          input,
+          data: null,
+          error: "invalid_place_data"
+        });
+      }
+      return resolve({
+        input,
+        error: null,
+        data: {
+          provider: "google",
+          name: place.name,
+          address: place.formatted_address,
+          lat: place.geometry.location.lat,
+          lng: place.geometry.location.lng,
+          providerId: place.place_id
+        }
+      });
+    }).catch(() => {
+      resolve({ input, data: null, error: "unknown" });
+    });
+  });
+  return {
+    name: "google",
+    geocode,
+    geocodeMany: (inputs) => Promise.all(inputs.map(geocode))
+  };
+}
+
+// src/geocoding/factory.ts
+function createGeocoder(config) {
+  switch (config.provider) {
+    case "google":
+      return createGoogleGeocoder(config);
+    default: {
+      const _exhaustive = config.provider;
+      throw new Error(`Unsupported geocoding provider: ${_exhaustive}`);
+    }
+  }
+}
+
+export { GeocodingError, createGeocoder, createGoogleGeocoder };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/geocoding/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/errors.ts","../../src/geocoding/errors.ts","../../src/geocoding/google.ts","../../src/geocoding/factory.ts"],"names":[],"mappings":";;;AAOO,IAAM,YAAA,GAAN,cAA2B,KAAA,CAAM;AAAA,EACpC,WAAA,CAAY,SAAkB,OAAA,EAAwB;AAClD,IAAA,KAAA,CAAM,SAAS,OAAO,CAAA;AACtB,IAAA,IAAA,CAAK,IAAA,GAAO,cAAA;AAAA,EAChB;AACJ,CAAA;;;ACVO,IAAM,cAAA,GAAN,cAA6B,YAAA,CAAa;AAAA,EAC7C,WAAA,CAAY,SAAkB,OAAA,EAAwB;AAClD,IAAA,KAAA,CAAM,SAAS,OAAO,CAAA;AACtB,IAAA,IAAA,CAAK,IAAA,GAAO,gBAAA;AAAA,EAChB;AACJ;ACIO,SAAS,qBAAqB,MAAA,EAAiD;AAClF,EAAA,MAAM,MAAA,GAAS,IAAI,MAAA,CAAO,EAAE,CAAA;AAC5B,EAAA,MAAM,SAAS,MAAA,CAAO,MAAA;AAEtB,EAAA,MAAM,UAAU,CAAC,KAAA,KACb,IAAI,OAAA,CAAQ,CAAC,OAAA,KAAY;AACrB,IAAA,MAAA,CACK,iBAAA,CAAkB;AAAA,MACf,MAAA,EAAQ;AAAA,QACJ,GAAA,EAAK,MAAA;AAAA,QACL,OAAO,KAAA,CAAM,OAAA;AAAA,QACb,WAAW,cAAA,CAAe,SAAA;AAAA,QAC1B,MAAA,EAAQ,CAAC,MAAA,EAAQ,UAAA,EAAY,qBAAqB,UAAU,CAAA;AAAA,QAC5D,YAAA,EAAc;AAAA;AAClB,KACH,CAAA,CACA,IAAA,CAAK,CAAC,GAAA,KAAQ;AACX,MAAA,IAAI,GAAA,CAAI,WAAW,GAAA,EAAK;AACpB,QAAA,OAAO,OAAA,CAAQ;AAAA,UACX,KAAA;AAAA,UACA,IAAA,EAAM,IAAA;AAAA,UACN,OAAO,CAAA,EAAG,GAAA,CAAI,IAAA,CAAK,aAAA,IAAiB,IAAI,UAAU,CAAA;AAAA,SACrD,CAAA;AAAA,MACL;AACA,MAAA,MAAM,KAAA,GAAQ,GAAA,CAAI,IAAA,CAAK,UAAA,CAAW,CAAC,CAAA;AACnC,MAAA,IAAI,CAAC,KAAA,EAAO;AACR,QAAA,OAAO,QAAQ,EAAE,KAAA,EAAO,MAAM,IAAA,EAAM,KAAA,EAAO,cAAc,CAAA;AAAA,MAC7D;AACA,MAAA,IACI,CAAC,KAAA,CAAM,iBAAA,IACP,CAAC,KAAA,CAAM,QAAA,EAAU,UAAU,GAAA,IAC3B,CAAC,KAAA,CAAM,QAAA,EAAU,UAAU,GAAA,IAC3B,CAAC,MAAM,IAAA,IACP,CAAC,MAAM,QAAA,EACT;AACE,QAAA,OAAO,OAAA,CAAQ;AAAA,UACX,KAAA;AAAA,UACA,IAAA,EAAM,IAAA;AAAA,UACN,KAAA,EAAO;AAAA,SACV,CAAA;AAAA,MACL;AACA,MAAA,OAAO,OAAA,CAAQ;AAAA,QACX,KAAA;AAAA,QACA,KAAA,EAAO,IAAA;AAAA,QACP,IAAA,EAAM;AAAA,UACF,QAAA,EAAU,QAAA;AAAA,UACV,MAAM,KAAA,CAAM,IAAA;AAAA,UACZ,SAAS,KAAA,CAAM,iBAAA;AAAA,UACf,GAAA,EAAK,KAAA,CAAM,QAAA,CAAS,QAAA,CAAS,GAAA;AAAA,UAC7B,GAAA,EAAK,KAAA,CAAM,QAAA,CAAS,QAAA,CAAS,GAAA;AAAA,UAC7B,YAAY,KAAA,CAAM;AAAA;AACtB,OACH,CAAA;AAAA,IACL,CAAC,CAAA,CACA,KAAA,CAAM,MAAM;AACT,MAAA,OAAA,CAAQ,EAAE,KAAA,EAAO,IAAA,EAAM,IAAA,EAAM,KAAA,EAAO,WAAW,CAAA;AAAA,IACnD,CAAC,CAAA;AAAA,EACT,CAAC,CAAA;AAEL,EAAA,OAAO;AAAA,IACH,IAAA,EAAM,QAAA;AAAA,IACN,OAAA;AAAA,IACA,WAAA,EAAa,CAAC,MAAA,KAAW,OAAA,CAAQ,IAAI,MAAA,CAAO,GAAA,CAAI,OAAO,CAAC;AAAA,GAC5D;AACJ;;;AC1DO,SAAS,eAAe,MAAA,EAA2C;AACtE,EAAA,QAAQ,OAAO,QAAA;AAAU,IACrB,KAAK,QAAA;AACD,MAAA,OAAO,qBAAqB,MAAM,CAAA;AAAA,IACtC,SAAS;AACL,MAAA,MAAM,cAAqB,MAAA,CAAO,QAAA;AAClC,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,gCAAA,EAAmC,WAAqB,CAAA,CAAE,CAAA;AAAA,IAC9E;AAAA;AAER","file":"index.js","sourcesContent":["/**\n * Base error class for every error thrown by the mapthis package.\n *\n * All feature-specific error classes (scrape, search, ai, geocoding) extend\n * this, so consumers can do `catch (e) { if (e instanceof MapthisError) ... }`\n * to distinguish library errors from other exceptions.\n */\nexport class MapthisError extends Error {\n    constructor(message?: string, options?: ErrorOptions) {\n        super(message, options)\n        this.name = \"MapthisError\"\n    }\n}\n","import { MapthisError } from \"../types/errors\"\n\nexport class GeocodingError extends MapthisError {\n    constructor(message?: string, options?: ErrorOptions) {\n        super(message, options)\n        this.name = \"GeocodingError\"\n    }\n}\n","import { Client, PlaceInputType } from \"@googlemaps/google-maps-services-js\"\nimport type { ParsedLocation, PlaceQueryResult } from \"../types/domain\"\nimport type { GeocodingProvider, GoogleGeocoderConfig } from \"./types\"\n\n/**\n * Create a Google Maps-backed {@link GeocodingProvider}.\n *\n * Under the hood this uses `findPlaceFromText` with a global location bias,\n * which is a low-cost single-candidate lookup. For multi-candidate ranked\n * searches, consumers should reach for the Places library directly.\n */\nexport function createGoogleGeocoder(config: GoogleGeocoderConfig): GeocodingProvider {\n    const client = new Client({})\n    const apiKey = config.apiKey\n\n    const geocode = (input: ParsedLocation): Promise<PlaceQueryResult> =>\n        new Promise((resolve) => {\n            client\n                .findPlaceFromText({\n                    params: {\n                        key: apiKey,\n                        input: input.address,\n                        inputtype: PlaceInputType.textQuery,\n                        fields: [\"name\", \"geometry\", \"formatted_address\", \"place_id\"],\n                        locationbias: \"circle:20000000@0,0\",\n                    },\n                })\n                .then((res) => {\n                    if (res.status !== 200) {\n                        return resolve({\n                            input,\n                            data: null,\n                            error: `${res.data.error_message ?? res.statusText}`,\n                        })\n                    }\n                    const place = res.data.candidates[0]\n                    if (!place) {\n                        return resolve({ input, data: null, error: \"no_results\" })\n                    }\n                    if (\n                        !place.formatted_address ||\n                        !place.geometry?.location?.lat ||\n                        !place.geometry?.location?.lng ||\n                        !place.name ||\n                        !place.place_id\n                    ) {\n                        return resolve({\n                            input,\n                            data: null,\n                            error: \"invalid_place_data\",\n                        })\n                    }\n                    return resolve({\n                        input,\n                        error: null,\n                        data: {\n                            provider: \"google\",\n                            name: place.name,\n                            address: place.formatted_address,\n                            lat: place.geometry.location.lat,\n                            lng: place.geometry.location.lng,\n                            providerId: place.place_id,\n                        },\n                    })\n                })\n                .catch(() => {\n                    resolve({ input, data: null, error: \"unknown\" })\n                })\n        })\n\n    return {\n        name: \"google\",\n        geocode,\n        geocodeMany: (inputs) => Promise.all(inputs.map(geocode)),\n    }\n}\n","import { createGoogleGeocoder } from \"./google\"\nimport type { GeocoderConfig, GeocodingProvider } from \"./types\"\n\n/**\n * Create a {@link GeocodingProvider} from a config object. The provider field\n * on the config discriminates which implementation is returned.\n *\n * @example\n * ```ts\n * const geocoder = createGeocoder({\n *   provider: \"google\",\n *   apiKey: process.env.GOOGLE_MAPS_KEY!,\n * })\n * const result = await geocoder.geocode({ address: \"Acropolis, Athens, Greece\" })\n * if (result.data) console.log(result.data.lat, result.data.lng)\n * ```\n */\nexport function createGeocoder(config: GeocoderConfig): GeocodingProvider {\n    switch (config.provider) {\n        case \"google\":\n            return createGoogleGeocoder(config)\n        default: {\n            const _exhaustive: never = config.provider\n            throw new Error(`Unsupported geocoding provider: ${_exhaustive as string}`)\n        }\n    }\n}\n"]}