@tagadapay/headless-sdk 1.2.0 → 1.3.1

package/README.md

@@ -1,6 +1,6 @@
 # @tagadapay/headless-sdk
 
-Use TagadaPay as a **headless checkout, analytics, and CRM backend** from any website — React, Vue, vanilla JS, or plain HTML. Zero runtime dependencies in core.
+Use TagadaPay as a **headless checkout and CRM backend** from any website — React, Vue, vanilla JS, or plain HTML. Zero runtime dependencies in core.
 
 ## Install
 
@@ -34,14 +34,6 @@ const result = await tagada.payment.pay({
   checkoutSessionId: session.id,
   tagadaToken,
 });
-
-if (result.payment.status === 'succeeded') {
-  tagada.analytics.trackPurchase({
-    orderId: result.payment.id,
-    amount: result.payment.amount,
-    currency: result.payment.currency,
-  });
-}
 ```
 
 ## Quick Start (React)
@@ -77,9 +69,9 @@ function CheckoutPage() {
 |--------|-------------|
 | `tagada.checkout` | Session management — load, update cart, promo codes, shipping |
 | `tagada.payment` | Full payment lifecycle — APMs, tokenize, 3DS, pay, poll, express checkout |
-| `tagada.analytics` | Pixel tracking — auto-loads Meta/TikTok/Snap/GTM from store config |
-| `tagada.offers` | Post-purchase — load, accept, decline upsells and order bumps |
+| `tagada.offers` | Upsells & order bumps — preview, pay, post-purchase accept/decline |
 | `tagada.customer` | CRM data — profile, orders, subscriptions |
+| `tagada.catalog` | Product browsing — list products, variants, prices |
 
 ## CDN Usage
 

package/dist/core/helpers/autocomplete.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Google Places Autocomplete — script injection + address extraction.
+ * Works standalone (no external dependencies beyond the Google Maps JS API).
+ */
+declare global {
+    interface Window {
+        google?: {
+            maps?: {
+                places?: {
+                    AutocompleteService: new () => any;
+                    PlacesService: new (el: any) => any;
+                    PlacesServiceStatus: {
+                        OK: string;
+                        ZERO_RESULTS: string;
+                    };
+                };
+                Map: new (el: HTMLElement) => any;
+            };
+        };
+    }
+}
+export interface GooglePrediction {
+    place_id: string;
+    description: string;
+    structured_formatting?: {
+        main_text: string;
+        secondary_text: string;
+    };
+}
+export interface GooglePlaceDetails {
+    place_id: string;
+    formatted_address: string;
+    address_components: Array<{
+        long_name: string;
+        short_name: string;
+        types: string[];
+    }>;
+    geometry?: {
+        location: {
+            lat: number;
+            lng: number;
+        };
+    };
+}
+export interface ExtractedAddress {
+    subpremise: string;
+    streetNumber: string;
+    route: string;
+    locality: string;
+    administrativeAreaLevel1: string;
+    administrativeAreaLevel1Long: string;
+    administrativeAreaLevel2: string;
+    administrativeAreaLevel2Long: string;
+    country: string;
+    postalCode: string;
+    fullStreetAddress: string;
+}
+export interface FormattedAddress {
+    address1: string;
+    city: string;
+    country: string;
+    state: string;
+    postal: string;
+}
+/**
+ * Inject the Google Maps JS SDK into the page (idempotent).
+ * Resolves once `window.google.maps.places` is available.
+ */
+export declare function loadGoogleMapsScript(apiKey: string, opts?: {
+    language?: string;
+    region?: string;
+    version?: string;
+}): Promise<void>;
+export declare class GoogleAutocompleteCore {
+    /** Search for address predictions. */
+    static searchPlaces(input: string, options?: {
+        types?: string[];
+        componentRestrictions?: {
+            country: string;
+        };
+    }): Promise<GooglePrediction[]>;
+    /** Get full place details by place_id. */
+    static getPlaceDetails(placeId: string): Promise<GooglePlaceDetails | null>;
+    /** Extract structured address fields from a Google PlaceDetails result. */
+    static extractAddressComponents(place: GooglePlaceDetails): ExtractedAddress;
+    /** Shorthand: extract into the flat shape used by address forms. */
+    static extractFormattedAddress(place: GooglePlaceDetails): FormattedAddress;
+}
+//# sourceMappingURL=autocomplete.d.ts.map

package/dist/core/helpers/autocomplete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autocomplete.d.ts","sourceRoot":"","sources":["../../../src/core/helpers/autocomplete.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,MAAM,CAAC,EAAE;YACP,IAAI,CAAC,EAAE;gBACL,MAAM,CAAC,EAAE;oBACP,mBAAmB,EAAE,UAAU,GAAG,CAAC;oBACnC,aAAa,EAAE,KAAK,EAAE,EAAE,GAAG,KAAK,GAAG,CAAC;oBACpC,mBAAmB,EAAE;wBAAE,EAAE,EAAE,MAAM,CAAC;wBAAC,YAAY,EAAE,MAAM,CAAA;qBAAE,CAAC;iBAC3D,CAAC;gBACF,GAAG,EAAE,KAAK,EAAE,EAAE,WAAW,KAAK,GAAG,CAAC;aACnC,CAAC;SACH,CAAC;KACH;CACF;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;CACvE;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACtF,QAAQ,CAAC,EAAE;QAAE,QAAQ,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;CACvD;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB,EAAE,MAAM,CAAC;IACjC,4BAA4B,EAAE,MAAM,CAAC;IACrC,wBAAwB,EAAE,MAAM,CAAC;IACjC,4BAA4B,EAAE,MAAM,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAgBD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAClE,OAAO,CAAC,IAAI,CAAC,CAyCf;AAMD,qBAAa,sBAAsB;IACjC,sCAAsC;WACzB,YAAY,CACvB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,qBAAqB,CAAC,EAAE;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,CAAA;KAAO,GAC9E,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAc9B,0CAA0C;WAC7B,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAcjF,2EAA2E;IAC3E,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,kBAAkB,GAAG,gBAAgB;IAwE5E,oEAAoE;IACpE,MAAM,CAAC,uBAAuB,CAAC,KAAK,EAAE,kBAAkB,GAAG,gBAAgB;CAU5E"}

package/dist/core/helpers/autocomplete.js

@@ -0,0 +1,186 @@
+/**
+ * Google Places Autocomplete — script injection + address extraction.
+ * Works standalone (no external dependencies beyond the Google Maps JS API).
+ */
+// ---------------------------------------------------------------------------
+// Script injection
+// ---------------------------------------------------------------------------
+let scriptInjected = false;
+let scriptReady = false;
+const readyCallbacks = [];
+function onScriptReady() {
+    scriptReady = true;
+    for (const cb of readyCallbacks)
+        cb();
+    readyCallbacks.length = 0;
+}
+/**
+ * Inject the Google Maps JS SDK into the page (idempotent).
+ * Resolves once `window.google.maps.places` is available.
+ */
+export function loadGoogleMapsScript(apiKey, opts = {}) {
+    if (scriptReady || window.google?.maps?.places) {
+        onScriptReady();
+        return Promise.resolve();
+    }
+    if (scriptInjected) {
+        return new Promise((resolve) => readyCallbacks.push(resolve));
+    }
+    scriptInjected = true;
+    return new Promise((resolve, reject) => {
+        readyCallbacks.push(resolve);
+        const existing = document.querySelector('script[src*="maps.googleapis.com"]');
+        if (existing) {
+            const poll = () => {
+                if (window.google?.maps?.places) {
+                    onScriptReady();
+                }
+                else {
+                    setTimeout(poll, 100);
+                }
+            };
+            poll();
+            return;
+        }
+        const params = new URLSearchParams({
+            key: apiKey,
+            libraries: 'places',
+            v: opts.version ?? 'weekly',
+        });
+        if (opts.language)
+            params.set('language', opts.language);
+        if (opts.region)
+            params.set('region', opts.region);
+        const script = document.createElement('script');
+        script.src = `https://maps.googleapis.com/maps/api/js?${params}`;
+        script.async = true;
+        script.defer = true;
+        script.onload = () => onScriptReady();
+        script.onerror = () => reject(new Error('Failed to load Google Maps script'));
+        document.head.appendChild(script);
+    });
+}
+// ---------------------------------------------------------------------------
+// Core class
+// ---------------------------------------------------------------------------
+export class GoogleAutocompleteCore {
+    /** Search for address predictions. */
+    static async searchPlaces(input, options = {}) {
+        if (!window.google?.maps?.places || !input.trim())
+            return [];
+        const service = new window.google.maps.places.AutocompleteService();
+        return new Promise((resolve) => {
+            service.getPlacePredictions({ input, types: options.types ?? ['address'], componentRestrictions: options.componentRestrictions }, (predictions, status) => {
+                resolve(status === window.google?.maps?.places?.PlacesServiceStatus.OK && predictions ? predictions : []);
+            });
+        });
+    }
+    /** Get full place details by place_id. */
+    static async getPlaceDetails(placeId) {
+        if (!window.google?.maps?.places)
+            return null;
+        const svc = new window.google.maps.places.PlacesService(document.createElement('div'));
+        return new Promise((resolve) => {
+            svc.getDetails({ placeId, fields: ['place_id', 'formatted_address', 'address_components', 'geometry'] }, (place, status) => {
+                resolve(status === window.google?.maps?.places?.PlacesServiceStatus.OK && place ? place : null);
+            });
+        });
+    }
+    /** Extract structured address fields from a Google PlaceDetails result. */
+    static extractAddressComponents(place) {
+        const out = {
+            subpremise: '', streetNumber: '', route: '', locality: '',
+            administrativeAreaLevel1: '', administrativeAreaLevel1Long: '',
+            administrativeAreaLevel2: '', administrativeAreaLevel2Long: '',
+            country: '', postalCode: '', fullStreetAddress: '',
+        };
+        let premise = '';
+        let neighborhood = '';
+        let sublocality5 = '', sublocality4 = '', sublocality3 = '', sublocality2 = '', sublocality1 = '';
+        let postalTown = '';
+        for (const c of place.address_components ?? []) {
+            const t = c.types;
+            if (t.includes('subpremise'))
+                out.subpremise = c.long_name;
+            if (t.includes('street_number'))
+                out.streetNumber = c.long_name;
+            if (t.includes('premise'))
+                premise = c.long_name;
+            if (t.includes('route'))
+                out.route = c.long_name;
+            if (t.includes('neighborhood'))
+                neighborhood = c.long_name;
+            if (t.includes('sublocality_level_5'))
+                sublocality5 = c.long_name;
+            if (t.includes('sublocality_level_4'))
+                sublocality4 = c.long_name;
+            if (t.includes('sublocality_level_3'))
+                sublocality3 = c.long_name;
+            if (t.includes('sublocality_level_2'))
+                sublocality2 = c.long_name;
+            if (t.includes('sublocality_level_1'))
+                sublocality1 = c.long_name;
+            if (t.includes('locality'))
+                out.locality = c.long_name;
+            if (t.includes('postal_town'))
+                postalTown = c.long_name;
+            if (t.includes('administrative_area_level_2')) {
+                out.administrativeAreaLevel2 = c.short_name;
+                out.administrativeAreaLevel2Long = c.long_name;
+            }
+            if (t.includes('administrative_area_level_1')) {
+                out.administrativeAreaLevel1 = c.short_name;
+                out.administrativeAreaLevel1Long = c.long_name;
+            }
+            if (t.includes('country'))
+                out.country = c.short_name;
+            if (t.includes('postal_code'))
+                out.postalCode = c.long_name;
+        }
+        // Locality fallbacks (UK postal_town, Asian sublocalities)
+        if (!out.locality)
+            out.locality = postalTown || sublocality2 || sublocality1 || '';
+        // French-style fallback: use département when région is missing
+        if (!out.administrativeAreaLevel1 && out.administrativeAreaLevel2) {
+            out.administrativeAreaLevel1 = out.administrativeAreaLevel2Long || out.administrativeAreaLevel2;
+            out.administrativeAreaLevel1Long = out.administrativeAreaLevel2Long;
+        }
+        // Build full street address
+        const buildingNumber = out.streetNumber || premise;
+        const streetName = out.route || sublocality5 || sublocality4 || sublocality3 || neighborhood;
+        if (out.subpremise && buildingNumber && streetName) {
+            out.fullStreetAddress = `${out.subpremise}/${buildingNumber} ${streetName}`;
+        }
+        else if (buildingNumber && streetName) {
+            if (premise && sublocality4 && sublocality3) {
+                let addr = `${sublocality3}-${sublocality4}-${premise}`;
+                if (sublocality2)
+                    addr = `${addr} ${sublocality2}`;
+                out.fullStreetAddress = addr;
+            }
+            else {
+                out.fullStreetAddress = `${buildingNumber} ${streetName}`;
+            }
+        }
+        else if (streetName) {
+            out.fullStreetAddress = streetName;
+        }
+        else if (buildingNumber) {
+            out.fullStreetAddress = buildingNumber;
+        }
+        out.fullStreetAddress = out.fullStreetAddress.trim();
+        return out;
+    }
+    /** Shorthand: extract into the flat shape used by address forms. */
+    static extractFormattedAddress(place) {
+        const a = GoogleAutocompleteCore.extractAddressComponents(place);
+        return {
+            address1: a.fullStreetAddress,
+            city: a.locality,
+            country: a.country,
+            state: a.administrativeAreaLevel1,
+            postal: a.postalCode,
+        };
+    }
+}
+//# sourceMappingURL=autocomplete.js.map

package/dist/core/helpers/autocomplete.js.map

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

package/dist/core/helpers/countries.d.ts

@@ -0,0 +1,45 @@
+/**
+ * ISO country/region helpers — countries list, regions by country,
+ * and Google Places state → ISO region mapping.
+ */
+import { AVAILABLE_LANGUAGES, type SupportedLanguage, type Country, type State } from './iso3166.js';
+export type { SupportedLanguage, Country, State };
+export { AVAILABLE_LANGUAGES };
+export interface ISOCountry {
+    iso: string;
+    iso3: string;
+    numeric: number;
+    name: string;
+}
+export interface ISORegion {
+    iso: string;
+    name: string;
+}
+export declare class ISODataCore {
+    /** Fetch countries + regions from CDN for a language. Call before sync getters. */
+    static ensureLoaded(language?: SupportedLanguage): Promise<void>;
+    /** Get all countries as a Record keyed by ISO code. */
+    static getCountries(language?: SupportedLanguage): Record<string, ISOCountry>;
+    /** Get all countries as a sorted array of { value, label } for select inputs. */
+    static getCountryOptions(language?: SupportedLanguage): Array<{
+        value: string;
+        label: string;
+    }>;
+    /** Get regions/states for a country. */
+    static getRegions(countryCode: string, language?: SupportedLanguage): ISORegion[];
+    /** Get regions as a sorted array of { value, label } for select inputs. */
+    static getRegionOptions(countryCode: string, language?: SupportedLanguage): Array<{
+        value: string;
+        label: string;
+    }>;
+    /** Find a specific region by ISO code. */
+    static findRegion(countryCode: string, regionCode: string, language?: SupportedLanguage): ISORegion | null;
+    /**
+     * Map a Google Places administrative_area to an ISO region.
+     * Tries exact ISO match, then name match, then partial match.
+     */
+    static mapGoogleToISO(googleState: string, googleStateLong: string, countryCode: string, language?: SupportedLanguage): ISORegion | null;
+    static isLanguageLoaded(language: SupportedLanguage): boolean;
+    static getAvailableLanguages(): readonly SupportedLanguage[];
+}
+//# sourceMappingURL=countries.d.ts.map

package/dist/core/helpers/countries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"countries.d.ts","sourceRoot":"","sources":["../../../src/core/helpers/countries.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAKL,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,OAAO,EACZ,KAAK,KAAK,EACX,MAAM,cAAc,CAAC;AAEtB,YAAY,EAAE,iBAAiB,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAE/B,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,WAAW;IACtB,mFAAmF;IACnF,MAAM,CAAC,YAAY,CAAC,QAAQ,GAAE,iBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAItE,uDAAuD;IACvD,MAAM,CAAC,YAAY,CAAC,QAAQ,GAAE,iBAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC;IASnF,iFAAiF;IACjF,MAAM,CAAC,iBAAiB,CAAC,QAAQ,GAAE,iBAAwB,GAAG,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAIrG,wCAAwC;IACxC,MAAM,CAAC,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,GAAE,iBAAwB,GAAG,SAAS,EAAE;IAIvF,2EAA2E;IAC3E,MAAM,CAAC,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,GAAE,iBAAwB,GAAG,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAIzH,0CAA0C;IAC1C,MAAM,CAAC,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,GAAE,iBAAwB,GAAG,SAAS,GAAG,IAAI;IAIhH;;;OAGG;IACH,MAAM,CAAC,cAAc,CACnB,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,MAAM,EACnB,QAAQ,GAAE,iBAAwB,GACjC,SAAS,GAAG,IAAI;IAsBnB,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO;IAI7D,MAAM,CAAC,qBAAqB,IAAI,SAAS,iBAAiB,EAAE;CAG7D"}

package/dist/core/helpers/countries.js

@@ -0,0 +1,65 @@
+/**
+ * ISO country/region helpers — countries list, regions by country,
+ * and Google Places state → ISO region mapping.
+ */
+import { getCountries, getStatesForCountry, ensureGeoDataLoaded, isLanguageLoaded, AVAILABLE_LANGUAGES, } from './iso3166.js';
+export { AVAILABLE_LANGUAGES };
+export class ISODataCore {
+    /** Fetch countries + regions from CDN for a language. Call before sync getters. */
+    static ensureLoaded(language = 'en') {
+        return ensureGeoDataLoaded(language);
+    }
+    /** Get all countries as a Record keyed by ISO code. */
+    static getCountries(language = 'en') {
+        const arr = getCountries(language);
+        const result = {};
+        for (const c of arr) {
+            result[c.code] = { iso: c.code, iso3: c.iso3 ?? '', numeric: c.numeric ?? 0, name: c.name };
+        }
+        return result;
+    }
+    /** Get all countries as a sorted array of { value, label } for select inputs. */
+    static getCountryOptions(language = 'en') {
+        return getCountries(language).map((c) => ({ value: c.code, label: c.name }));
+    }
+    /** Get regions/states for a country. */
+    static getRegions(countryCode, language = 'en') {
+        return getStatesForCountry(countryCode, language).map((s) => ({ iso: s.code, name: s.name }));
+    }
+    /** Get regions as a sorted array of { value, label } for select inputs. */
+    static getRegionOptions(countryCode, language = 'en') {
+        return ISODataCore.getRegions(countryCode, language).map((r) => ({ value: r.iso, label: r.name }));
+    }
+    /** Find a specific region by ISO code. */
+    static findRegion(countryCode, regionCode, language = 'en') {
+        return ISODataCore.getRegions(countryCode, language).find((r) => r.iso === regionCode) ?? null;
+    }
+    /**
+     * Map a Google Places administrative_area to an ISO region.
+     * Tries exact ISO match, then name match, then partial match.
+     */
+    static mapGoogleToISO(googleState, googleStateLong, countryCode, language = 'en') {
+        const regions = ISODataCore.getRegions(countryCode, language);
+        if (regions.length === 0)
+            return null;
+        let match = regions.find((r) => r.iso === googleState);
+        if (match)
+            return match;
+        match = regions.find((r) => r.name.toLowerCase() === googleState.toLowerCase());
+        if (match)
+            return match;
+        match = regions.find((r) => r.name.toLowerCase() === googleStateLong.toLowerCase());
+        if (match)
+            return match;
+        match = regions.find((r) => r.name.toLowerCase().includes(googleStateLong.toLowerCase()) ||
+            googleStateLong.toLowerCase().includes(r.name.toLowerCase()));
+        return match ?? null;
+    }
+    static isLanguageLoaded(language) {
+        return isLanguageLoaded(language);
+    }
+    static getAvailableLanguages() {
+        return AVAILABLE_LANGUAGES;
+    }
+}
+//# sourceMappingURL=countries.js.map

package/dist/core/helpers/countries.js.map

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

package/dist/core/helpers/currency.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Currency formatting utilities — symbol lookup, decimal handling,
+ * and Intl.NumberFormat-based money formatting from minor units (cents).
+ */
+export interface Currency {
+    code: string;
+    symbol: string;
+    name: string;
+    decimalPlaces: number;
+}
+export declare class CurrencyUtils {
+    static getSymbol(code: string): string;
+    static getName(code: string): string;
+    static getDecimalPlaces(code: string): number;
+    static getCurrency(code: string): Currency;
+}
+/**
+ * Format an amount expressed in minor units (cents) into a locale-aware string.
+ *
+ * @example
+ * formatMoney(12345, 'USD')           // "$123.45"
+ * formatMoney(10000, 'EUR', 'de-DE')  // "100,00 €"
+ * formatMoney(1000, 'JPY')            // "¥1,000"
+ */
+export declare function formatMoney(amountMinorUnits: number, currencyCode?: string, locale?: string): string;
+//# sourceMappingURL=currency.d.ts.map

package/dist/core/helpers/currency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency.d.ts","sourceRoot":"","sources":["../../../src/core/helpers/currency.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;CACvB;AA8BD,qBAAa,aAAa;IACxB,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAItC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIpC,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI7C,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;CAQ3C;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,gBAAgB,EAAE,MAAM,EAAE,YAAY,SAAQ,EAAE,MAAM,SAAU,GAAG,MAAM,CAcpG"}

package/dist/core/helpers/currency.js

@@ -0,0 +1,72 @@
+/**
+ * Currency formatting utilities — symbol lookup, decimal handling,
+ * and Intl.NumberFormat-based money formatting from minor units (cents).
+ */
+const SYMBOLS = {
+    USD: '$', EUR: '€', GBP: '£', JPY: '¥', CAD: 'C$', AUD: 'A$', CHF: 'CHF',
+    CNY: '¥', SEK: 'kr', NOK: 'kr', DKK: 'kr', PLN: 'zł', CZK: 'Kč', HUF: 'Ft',
+    RON: 'lei', BGN: 'лв', HRK: 'kn', RUB: '₽', UAH: '₴', TRY: '₺', BRL: 'R$',
+    MXN: '$', ZAR: 'R', INR: '₹', KRW: '₩', THB: '฿', VND: '₫', IDR: 'Rp',
+    MYR: 'RM', SGD: 'S$', PHP: '₱', TWD: 'NT$', HKD: 'HK$', ILS: '₪', AED: 'د.إ',
+    SAR: 'ر.س', QAR: 'ر.ق', KWD: 'د.ك', BHD: 'د.ب', OMR: 'ر.ع.', EGP: '£',
+    NGN: '₦', KES: 'KSh', GHS: '₵', COP: '$', ARS: '$', CLP: '$', PEN: 'S/',
+    CRC: '₡', DOP: 'RD$', JMD: 'J$', BOB: 'Bs', PYG: '₲', GTQ: 'Q',
+    NIO: 'C$', PAB: 'B/.', PKR: '₨', BDT: '৳', LKR: '₨', NPR: '₨',
+    GEL: '₾', AMD: '֏', AZN: '₼', KZT: '₸',
+};
+const NAMES = {
+    USD: 'US Dollar', EUR: 'Euro', GBP: 'British Pound', JPY: 'Japanese Yen',
+    CAD: 'Canadian Dollar', AUD: 'Australian Dollar', CHF: 'Swiss Franc',
+    CNY: 'Chinese Yuan', SEK: 'Swedish Krona', NOK: 'Norwegian Krone',
+    DKK: 'Danish Krone', PLN: 'Polish Zloty', CZK: 'Czech Koruna', HUF: 'Hungarian Forint',
+    BRL: 'Brazilian Real', MXN: 'Mexican Peso', INR: 'Indian Rupee', KRW: 'South Korean Won',
+    THB: 'Thai Baht', SGD: 'Singapore Dollar', HKD: 'Hong Kong Dollar', TWD: 'Taiwan Dollar',
+    ILS: 'Israeli Shekel', AED: 'UAE Dirham', SAR: 'Saudi Riyal', ZAR: 'South African Rand',
+    TRY: 'Turkish Lira', RUB: 'Russian Ruble', NGN: 'Nigerian Naira',
+};
+const ZERO_DECIMAL = new Set([
+    'JPY', 'KRW', 'VND', 'IDR', 'LAK', 'KHR', 'MMK', 'PYG',
+]);
+export class CurrencyUtils {
+    static getSymbol(code) {
+        return SYMBOLS[code] ?? code;
+    }
+    static getName(code) {
+        return NAMES[code] ?? code;
+    }
+    static getDecimalPlaces(code) {
+        return ZERO_DECIMAL.has(code) ? 0 : 2;
+    }
+    static getCurrency(code) {
+        return {
+            code,
+            symbol: CurrencyUtils.getSymbol(code),
+            name: CurrencyUtils.getName(code),
+            decimalPlaces: CurrencyUtils.getDecimalPlaces(code),
+        };
+    }
+}
+/**
+ * Format an amount expressed in minor units (cents) into a locale-aware string.
+ *
+ * @example
+ * formatMoney(12345, 'USD')           // "$123.45"
+ * formatMoney(10000, 'EUR', 'de-DE')  // "100,00 €"
+ * formatMoney(1000, 'JPY')            // "¥1,000"
+ */
+export function formatMoney(amountMinorUnits, currencyCode = 'USD', locale = 'en-US') {
+    const decimals = CurrencyUtils.getDecimalPlaces(currencyCode);
+    const value = amountMinorUnits / (decimals === 0 ? 100 : Math.pow(10, decimals));
+    try {
+        return new Intl.NumberFormat(locale, {
+            style: 'currency',
+            currency: currencyCode,
+            minimumFractionDigits: decimals,
+            maximumFractionDigits: decimals,
+        }).format(value);
+    }
+    catch {
+        return `${CurrencyUtils.getSymbol(currencyCode)}${value.toFixed(decimals)}`;
+    }
+}
+//# sourceMappingURL=currency.js.map

package/dist/core/helpers/currency.js.map

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

package/dist/core/helpers/index.d.ts

@@ -0,0 +1,5 @@
+export { GoogleAutocompleteCore, loadGoogleMapsScript, type GooglePrediction, type GooglePlaceDetails, type ExtractedAddress, type FormattedAddress, } from './autocomplete.js';
+export { ISODataCore, AVAILABLE_LANGUAGES, type SupportedLanguage, type ISOCountry, type ISORegion, type Country, type State, } from './countries.js';
+export { CurrencyUtils, formatMoney, type Currency, } from './currency.js';
+export { ensureGeoDataLoaded, getCountries, getStatesForCountry, isLanguageLoaded, } from './iso3166.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACtB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,OAAO,EACZ,KAAK,KAAK,GACX,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,aAAa,EACb,WAAW,EACX,KAAK,QAAQ,GACd,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,cAAc,CAAC"}

package/dist/core/helpers/index.js

@@ -0,0 +1,5 @@
+export { GoogleAutocompleteCore, loadGoogleMapsScript, } from './autocomplete.js';
+export { ISODataCore, AVAILABLE_LANGUAGES, } from './countries.js';
+export { CurrencyUtils, formatMoney, } from './currency.js';
+export { ensureGeoDataLoaded, getCountries, getStatesForCountry, isLanguageLoaded, } from './iso3166.js';
+//# sourceMappingURL=index.js.map

package/dist/core/helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,oBAAoB,GAKrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,WAAW,EACX,mBAAmB,GAMpB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,aAAa,EACb,WAAW,GAEZ,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,cAAc,CAAC"}

package/dist/core/helpers/iso3166.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Geodata — CDN-backed country/region data.
+ *
+ * Fetches slim JSON from Vercel Blob CDN on demand:
+ *   - countries.json (~10KB) — fetched once on first getCountries() call
+ *   - regions.json   (~95KB) — fetched lazily on first getStatesForCountry() call
+ *
+ * Both are cached in memory after first fetch.
+ */
+export declare const AVAILABLE_LANGUAGES: readonly ["en", "ru", "de", "da", "fr", "es", "zh", "hi", "pt", "ja", "ar", "it", "he"];
+export type SupportedLanguage = (typeof AVAILABLE_LANGUAGES)[number];
+export interface Country {
+    code: string;
+    name: string;
+    iso3?: string;
+    numeric?: number;
+}
+export interface State {
+    code: string;
+    name: string;
+    countryCode: string;
+}
+/** Fetch countries + regions from CDN for a language. Call before sync getters. */
+export declare function ensureGeoDataLoaded(language?: SupportedLanguage): Promise<void>;
+export declare const getCountries: (language?: SupportedLanguage) => Country[];
+export declare const getStatesForCountry: (countryCode: string, language?: SupportedLanguage) => State[];
+export declare function isLanguageLoaded(language: SupportedLanguage): boolean;
+//# sourceMappingURL=iso3166.d.ts.map

package/dist/core/helpers/iso3166.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iso3166.d.ts","sourceRoot":"","sources":["../../../src/core/helpers/iso3166.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,eAAO,MAAM,mBAAmB,yFAA0F,CAAC;AAC3H,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAErE,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AA4DD,mFAAmF;AACnF,wBAAsB,mBAAmB,CAAC,QAAQ,GAAE,iBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3F;AAED,eAAO,MAAM,YAAY,GAAI,WAAU,iBAAwB,KAAG,OAAO,EAKxE,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,aAAa,MAAM,EAAE,WAAU,iBAAwB,KAAG,KAAK,EAOlG,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAErE"}