@tagadapay/headless-sdk 1.8.0-rc.0 → 1.9.0

package/dist/react/hooks/useCheckout.d.ts

@@ -0,0 +1,58 @@
+import type { CheckoutSession, LineItem, ShippingRate, Address, CheckoutCustomer } from '../../core/types.js';
+export interface UseCheckoutReturn {
+    session: CheckoutSession | null;
+    isLoading: boolean;
+    error: Error | null;
+    /** Reload the session from the server. */
+    refresh: () => Promise<void>;
+    /** Create a new checkout session (auto-loads it after creation). */
+    createSession: (opts: {
+        items: LineItem[];
+        currency?: string;
+        returnUrl?: string;
+        customerEmail?: string;
+    }) => Promise<void>;
+    /** Replace cart items. */
+    updateCart: (items: LineItem[]) => Promise<void>;
+    /** Update customer info on the session. */
+    updateCustomer: (customer: Partial<CheckoutCustomer>) => Promise<void>;
+    /** Update address on the session. */
+    updateAddress: (addresses: {
+        shippingAddress?: Address;
+        billingAddress?: Address;
+    }) => Promise<void>;
+    /**
+     * Update customer info AND address in a single call. Prefer this over
+     * calling `updateCustomer` then `updateAddress` separately — the
+     * underlying server action is destructive on partial saves
+     * (`customers.firstName = shippingAddress.firstName ?? null`), so
+     * sending the address without the customer name will silently wipe
+     * `customer.firstName` / `customer.lastName` from the session.
+     */
+    updateCustomerAndAddress: (data: {
+        customer: Partial<CheckoutCustomer>;
+        shippingAddress?: Address;
+        billingAddress?: Address;
+    }) => Promise<void>;
+    /** Apply a promo code. */
+    applyPromo: (code: string) => Promise<void>;
+    /** Remove the applied promo code. */
+    removePromo: (promotionId?: string) => Promise<void>;
+    /** Fetch shipping rates. */
+    getShippingRates: () => Promise<ShippingRate[]>;
+    /** Select a shipping rate. */
+    selectShippingRate: (rateId: string) => Promise<void>;
+}
+/**
+ * React hook for checkout session management.
+ *
+ * @param checkoutToken - The checkout token from the URL (e.g. `?checkoutToken=xxx`).
+ * @param sessionToken - Optional JWT session token (from URL param `token`).
+ *
+ * @example
+ * ```tsx
+ * const { session, isLoading, applyPromo, createSession } = useCheckout(checkoutToken, sessionToken);
+ * ```
+ */
+export declare function useCheckout(checkoutToken: string | null | undefined, sessionToken?: string): UseCheckoutReturn;
+//# sourceMappingURL=useCheckout.d.ts.map

package/dist/react/hooks/useCheckout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCheckout.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useCheckout.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE9G,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,oEAAoE;IACpE,aAAa,EAAE,CAAC,IAAI,EAAE;QACpB,KAAK,EAAE,QAAQ,EAAE,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB,0BAA0B;IAC1B,UAAU,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,2CAA2C;IAC3C,cAAc,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,gBAAgB,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,qCAAqC;IACrC,aAAa,EAAE,CAAC,SAAS,EAAE;QAAE,eAAe,CAAC,EAAE,OAAO,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrG;;;;;;;OAOG;IACH,wBAAwB,EAAE,CAAC,IAAI,EAAE;QAC/B,QAAQ,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACpC,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB,0BAA0B;IAC1B,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,qCAAqC;IACrC,WAAW,EAAE,CAAC,WAAW,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,4BAA4B;IAC5B,gBAAgB,EAAE,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAChD,8BAA8B;IAC9B,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACzB,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACxC,YAAY,CAAC,EAAE,MAAM,GACpB,iBAAiB,CAgKnB"}

package/dist/react/hooks/useCheckout.js

@@ -0,0 +1,177 @@
+import { useState, useEffect, useCallback } from 'react';
+import { useHeadlessClient } from '../provider.js';
+/**
+ * React hook for checkout session management.
+ *
+ * @param checkoutToken - The checkout token from the URL (e.g. `?checkoutToken=xxx`).
+ * @param sessionToken - Optional JWT session token (from URL param `token`).
+ *
+ * @example
+ * ```tsx
+ * const { session, isLoading, applyPromo, createSession } = useCheckout(checkoutToken, sessionToken);
+ * ```
+ */
+export function useCheckout(checkoutToken, sessionToken) {
+    const client = useHeadlessClient();
+    const [session, setSession] = useState(null);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const loadSession = useCallback(async () => {
+        if (!checkoutToken)
+            return;
+        setIsLoading(true);
+        setError(null);
+        try {
+            const s = await client.checkout.loadSession(checkoutToken, sessionToken);
+            setSession(s);
+        }
+        catch (err) {
+            setError(err instanceof Error ? err : new Error(String(err)));
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [client, checkoutToken, sessionToken]);
+    useEffect(() => {
+        loadSession();
+    }, [loadSession]);
+    const createSession = useCallback(async (opts) => {
+        setIsLoading(true);
+        setError(null);
+        try {
+            const result = await client.checkout.createSession(opts);
+            const newUrl = new URL(window.location.href);
+            newUrl.searchParams.set('checkoutToken', result.checkoutToken);
+            newUrl.searchParams.set('token', result.sessionToken);
+            window.history.replaceState({}, '', newUrl.toString());
+            const s = await client.checkout.loadSession(result.checkoutToken, result.sessionToken);
+            setSession(s);
+        }
+        catch (err) {
+            setError(err instanceof Error ? err : new Error(String(err)));
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [client]);
+    const updateCart = useCallback(async (items) => {
+        if (!session)
+            return;
+        // `updateCart` returns mutation stats (counts), not a CheckoutSession.
+        // We previously assigned that result into `setSession`, which silently
+        // replaced the session with `{ success, updated, created, total }`.
+        // Mirror the same pattern as `updateAddress`: mutate, then reload.
+        setIsLoading(true);
+        try {
+            await client.checkout.updateCart(session.id, items);
+            await loadSession();
+        }
+        catch (err) {
+            setError(err instanceof Error ? err : new Error(String(err)));
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [client, session, loadSession]);
+    const updateCustomer = useCallback(async (customer) => {
+        if (!session)
+            return;
+        await client.checkout.updateCustomer(session.id, customer);
+    }, [client, session]);
+    const updateAddress = useCallback(async (addresses) => {
+        if (!session)
+            return;
+        setIsLoading(true);
+        try {
+            await client.checkout.updateAddress(session.id, addresses);
+            await loadSession();
+        }
+        catch (err) {
+            setError(err instanceof Error ? err : new Error(String(err)));
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [client, session, loadSession]);
+    const updateCustomerAndAddress = useCallback(async (data) => {
+        if (!session)
+            return;
+        setIsLoading(true);
+        try {
+            await client.checkout.updateCustomerAndAddress(session.id, data);
+            await loadSession();
+        }
+        catch (err) {
+            setError(err instanceof Error ? err : new Error(String(err)));
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [client, session, loadSession]);
+    const applyPromo = useCallback(async (code) => {
+        if (!session)
+            return;
+        setIsLoading(true);
+        try {
+            await client.checkout.applyPromoCode(session.id, code);
+            await loadSession();
+        }
+        catch (err) {
+            setError(err instanceof Error ? err : new Error(String(err)));
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [client, session, loadSession]);
+    const removePromo = useCallback(async (promotionId) => {
+        if (!session)
+            return;
+        setIsLoading(true);
+        try {
+            await client.checkout.removePromoCode(session.id, promotionId);
+            await loadSession();
+        }
+        catch (err) {
+            setError(err instanceof Error ? err : new Error(String(err)));
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [client, session, loadSession]);
+    const getShippingRates = useCallback(async () => {
+        if (!session)
+            return [];
+        return client.checkout.getShippingRates(session.id);
+    }, [client, session]);
+    const selectShippingRate = useCallback(async (rateId) => {
+        if (!session)
+            return;
+        setIsLoading(true);
+        try {
+            await client.checkout.selectShippingRate(session.id, rateId);
+            await loadSession();
+        }
+        catch (err) {
+            setError(err instanceof Error ? err : new Error(String(err)));
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [client, session, loadSession]);
+    return {
+        session,
+        isLoading,
+        error,
+        refresh: loadSession,
+        createSession,
+        updateCart,
+        updateCustomer,
+        updateAddress,
+        updateCustomerAndAddress,
+        applyPromo,
+        removePromo,
+        getShippingRates,
+        selectShippingRate,
+    };
+}
+//# sourceMappingURL=useCheckout.js.map

package/dist/react/hooks/useCheckout.js.map

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

package/dist/react/hooks/useCustomer.d.ts

@@ -0,0 +1,28 @@
+import type { Customer, Order, Subscription } from '../../core/types.js';
+export interface UseCustomerReturn {
+    customer: Customer | null;
+    orders: Order[];
+    subscriptions: Subscription[];
+    isLoading: boolean;
+    error: Error | null;
+    /** Load customer profile by ID. */
+    loadCustomer: (customerId: string) => Promise<void>;
+    /** Load customer orders. */
+    loadOrders: (customerId: string) => Promise<void>;
+    /** Load customer subscriptions. */
+    loadSubscriptions: (customerId: string) => Promise<void>;
+    /** Update customer profile. */
+    updateProfile: (customerId: string, data: Partial<Pick<Customer, 'email' | 'firstName' | 'lastName' | 'phone'>>) => Promise<void>;
+}
+/**
+ * React hook for customer data -- profile, orders, subscriptions.
+ *
+ * @param customerId - Auto-loads the customer profile when provided.
+ *
+ * @example
+ * ```tsx
+ * const { customer, orders, loadOrders } = useCustomer(session?.customer?.id);
+ * ```
+ */
+export declare function useCustomer(customerId?: string | null): UseCustomerReturn;
+//# sourceMappingURL=useCustomer.d.ts.map

package/dist/react/hooks/useCustomer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCustomer.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useCustomer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEzE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,mCAAmC;IACnC,YAAY,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,4BAA4B;IAC5B,UAAU,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,mCAAmC;IACnC,iBAAiB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,+BAA+B;IAC/B,aAAa,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACnI;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,iBAAiB,CAkEzE"}

package/dist/react/hooks/useCustomer.js

@@ -0,0 +1,77 @@
+import { useState, useEffect, useCallback } from 'react';
+import { useHeadlessClient } from '../provider.js';
+/**
+ * React hook for customer data -- profile, orders, subscriptions.
+ *
+ * @param customerId - Auto-loads the customer profile when provided.
+ *
+ * @example
+ * ```tsx
+ * const { customer, orders, loadOrders } = useCustomer(session?.customer?.id);
+ * ```
+ */
+export function useCustomer(customerId) {
+    const client = useHeadlessClient();
+    const [customer, setCustomer] = useState(null);
+    const [orders, setOrders] = useState([]);
+    const [subscriptions, setSubscriptions] = useState([]);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const loadCustomer = useCallback(async (id) => {
+        setIsLoading(true);
+        setError(null);
+        try {
+            const c = await client.customer.getProfile(id);
+            setCustomer(c);
+        }
+        catch (err) {
+            setError(err instanceof Error ? err : new Error(String(err)));
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [client]);
+    const loadOrders = useCallback(async (id) => {
+        try {
+            const res = await client.customer.getOrders(id);
+            setOrders(res.orders);
+        }
+        catch (err) {
+            setError(err instanceof Error ? err : new Error(String(err)));
+        }
+    }, [client]);
+    const loadSubscriptions = useCallback(async (id) => {
+        try {
+            const subs = await client.customer.getSubscriptions(id);
+            setSubscriptions(subs);
+        }
+        catch (err) {
+            setError(err instanceof Error ? err : new Error(String(err)));
+        }
+    }, [client]);
+    const updateProfile = useCallback(async (id, data) => {
+        try {
+            const updated = await client.customer.updateProfile(id, data);
+            setCustomer(updated);
+        }
+        catch (err) {
+            setError(err instanceof Error ? err : new Error(String(err)));
+        }
+    }, [client]);
+    useEffect(() => {
+        if (customerId)
+            loadCustomer(customerId);
+    }, [customerId, loadCustomer]);
+    return {
+        customer,
+        orders,
+        subscriptions,
+        isLoading,
+        error,
+        loadCustomer,
+        loadOrders,
+        loadSubscriptions,
+        updateProfile,
+    };
+}
+//# sourceMappingURL=useCustomer.js.map

package/dist/react/hooks/useCustomer.js.map

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

package/dist/react/hooks/useGoogleAutocomplete.d.ts

@@ -0,0 +1,26 @@
+/**
+ * React hook for Google Places Autocomplete — handles script injection,
+ * debounced prediction search, place detail fetching, and address extraction.
+ */
+import { type GooglePrediction, type GooglePlaceDetails, type ExtractedAddress, type FormattedAddress } from '../../core/helpers/autocomplete.js';
+export type { GooglePrediction, GooglePlaceDetails, ExtractedAddress, FormattedAddress };
+export interface UseGoogleAutocompleteOptions {
+    apiKey: string;
+    language?: string;
+    region?: string;
+    version?: string;
+    /** Defer script loading until searchPlaces() is first called. Default: false. */
+    defer?: boolean;
+}
+export interface UseGoogleAutocompleteReturn {
+    predictions: GooglePrediction[];
+    isLoading: boolean;
+    isScriptLoaded: boolean;
+    searchPlaces: (input: string, countryRestriction?: string) => void;
+    getPlaceDetails: (placeId: string) => Promise<GooglePlaceDetails | null>;
+    extractAddressComponents: (place: GooglePlaceDetails) => ExtractedAddress;
+    extractFormattedAddress: (place: GooglePlaceDetails) => FormattedAddress;
+    clearPredictions: () => void;
+}
+export declare function useGoogleAutocomplete(options: UseGoogleAutocompleteOptions): UseGoogleAutocompleteReturn;
+//# sourceMappingURL=useGoogleAutocomplete.d.ts.map

package/dist/react/hooks/useGoogleAutocomplete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGoogleAutocomplete.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useGoogleAutocomplete.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACtB,MAAM,oCAAoC,CAAC;AAE5C,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;AAEzF,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACnE,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IACzE,wBAAwB,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,gBAAgB,CAAC;IAC1E,uBAAuB,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,gBAAgB,CAAC;IACzE,gBAAgB,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,4BAA4B,GAAG,2BAA2B,CA8ExG"}

package/dist/react/hooks/useGoogleAutocomplete.js

@@ -0,0 +1,70 @@
+/**
+ * React hook for Google Places Autocomplete — handles script injection,
+ * debounced prediction search, place detail fetching, and address extraction.
+ */
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { GoogleAutocompleteCore, loadGoogleMapsScript, } from '../../core/helpers/autocomplete.js';
+export function useGoogleAutocomplete(options) {
+    const { apiKey, language, region, version, defer = false } = options;
+    const [predictions, setPredictions] = useState([]);
+    const [isLoading, setIsLoading] = useState(false);
+    const [isScriptLoaded, setIsScriptLoaded] = useState(false);
+    const debounceRef = useRef(null);
+    const pendingRef = useRef(null);
+    const inject = useCallback(() => {
+        loadGoogleMapsScript(apiKey, { language, region, version }).then(() => setIsScriptLoaded(true));
+    }, [apiKey, language, region, version]);
+    // Eager load unless defer
+    useEffect(() => {
+        if (!apiKey || defer)
+            return;
+        inject();
+    }, [apiKey, defer, inject]);
+    // Replay pending search after deferred load
+    useEffect(() => {
+        if (isScriptLoaded && pendingRef.current) {
+            const { input, country } = pendingRef.current;
+            pendingRef.current = null;
+            doSearch(input, country);
+        }
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [isScriptLoaded]);
+    const doSearch = useCallback((input, countryRestriction) => {
+        if (!isScriptLoaded) {
+            if (defer) {
+                pendingRef.current = { input, country: countryRestriction };
+                inject();
+            }
+            return;
+        }
+        if (input.length < 3) {
+            setPredictions([]);
+            return;
+        }
+        if (debounceRef.current)
+            clearTimeout(debounceRef.current);
+        debounceRef.current = setTimeout(async () => {
+            setIsLoading(true);
+            const results = await GoogleAutocompleteCore.searchPlaces(input, {
+                componentRestrictions: countryRestriction ? { country: countryRestriction.toLowerCase() } : undefined,
+            });
+            setPredictions(results);
+            setIsLoading(false);
+        }, 300);
+    }, [isScriptLoaded, defer, inject]);
+    const getPlaceDetails = useCallback((placeId) => GoogleAutocompleteCore.getPlaceDetails(placeId), []);
+    const extractAddressComponents = useCallback((place) => GoogleAutocompleteCore.extractAddressComponents(place), []);
+    const extractFormattedAddress = useCallback((place) => GoogleAutocompleteCore.extractFormattedAddress(place), []);
+    const clearPredictions = useCallback(() => setPredictions([]), []);
+    return {
+        predictions,
+        isLoading,
+        isScriptLoaded,
+        searchPlaces: doSearch,
+        getPlaceDetails,
+        extractAddressComponents,
+        extractFormattedAddress,
+        clearPredictions,
+    };
+}
+//# sourceMappingURL=useGoogleAutocomplete.js.map

package/dist/react/hooks/useGoogleAutocomplete.js.map

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

package/dist/react/hooks/useISOData.d.ts

@@ -0,0 +1,23 @@
+/**
+ * React hooks for ISO country/region data — CDN-backed,
+ * with Google Places → ISO region mapping.
+ */
+import { type ISOCountry, type ISORegion, type SupportedLanguage } from '../../core/helpers/countries.js';
+export type { ISOCountry, ISORegion, SupportedLanguage };
+export interface UseISODataReturn {
+    countries: Record<string, ISOCountry>;
+    getRegions: (countryCode: string) => ISORegion[];
+    findRegion: (countryCode: string, regionCode: string) => ISORegion | null;
+    mapGoogleToISO: (googleState: string, googleStateLong: string, countryCode: string) => ISORegion | null;
+    isLoaded: boolean;
+}
+export declare function useISOData(language?: SupportedLanguage): UseISODataReturn;
+export declare function useCountryOptions(language?: SupportedLanguage): Array<{
+    value: string;
+    label: string;
+}>;
+export declare function useRegionOptions(countryCode: string, language?: SupportedLanguage): Array<{
+    value: string;
+    label: string;
+}>;
+//# sourceMappingURL=useISOData.d.ts.map

package/dist/react/hooks/useISOData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useISOData.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useISOData.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,iBAAiB,EACvB,MAAM,iCAAiC,CAAC;AAGzC,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,iBAAiB,EAAE,CAAC;AAMzD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACtC,UAAU,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,SAAS,EAAE,CAAC;IACjD,UAAU,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,SAAS,GAAG,IAAI,CAAC;IAC1E,cAAc,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,SAAS,GAAG,IAAI,CAAC;IACxG,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,UAAU,CAAC,QAAQ,GAAE,iBAAwB,GAAG,gBAAgB,CA8B/E;AAMD,wBAAgB,iBAAiB,CAAC,QAAQ,GAAE,iBAAwB,GAAG,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAQ7G;AAMD,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,QAAQ,GAAE,iBAAwB,GACjC,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAQzC"}

package/dist/react/hooks/useISOData.js

@@ -0,0 +1,63 @@
+/**
+ * React hooks for ISO country/region data — CDN-backed,
+ * with Google Places → ISO region mapping.
+ */
+import { useEffect, useMemo, useState } from 'react';
+import { ISODataCore, } from '../../core/helpers/countries.js';
+import { ensureGeoDataLoaded, isLanguageLoaded } from '../../core/helpers/iso3166.js';
+export function useISOData(language = 'en') {
+    const [isLoaded, setIsLoaded] = useState(isLanguageLoaded(language));
+    useEffect(() => {
+        let cancelled = false;
+        ensureGeoDataLoaded(language)
+            .then(() => { if (!cancelled)
+            setIsLoaded(true); })
+            .catch((err) => console.error('[headless-sdk] Failed to load geodata:', err));
+        return () => { cancelled = true; };
+    }, [language]);
+    return useMemo(() => {
+        if (!isLoaded) {
+            return {
+                countries: {},
+                getRegions: () => [],
+                findRegion: () => null,
+                mapGoogleToISO: () => null,
+                isLoaded: false,
+            };
+        }
+        return {
+            countries: ISODataCore.getCountries(language),
+            getRegions: (cc) => ISODataCore.getRegions(cc, language),
+            findRegion: (cc, rc) => ISODataCore.findRegion(cc, rc, language),
+            mapGoogleToISO: (gs, gsl, cc) => ISODataCore.mapGoogleToISO(gs, gsl, cc, language),
+            isLoaded: true,
+        };
+    }, [language, isLoaded]);
+}
+// ---------------------------------------------------------------------------
+// useCountryOptions — countries as select options
+// ---------------------------------------------------------------------------
+export function useCountryOptions(language = 'en') {
+    const { countries, isLoaded } = useISOData(language);
+    return useMemo(() => {
+        if (!isLoaded)
+            return [];
+        return Object.values(countries)
+            .map((c) => ({ value: c.iso, label: c.name }))
+            .sort((a, b) => a.label.localeCompare(b.label));
+    }, [countries, isLoaded]);
+}
+// ---------------------------------------------------------------------------
+// useRegionOptions — regions/states for a country as select options
+// ---------------------------------------------------------------------------
+export function useRegionOptions(countryCode, language = 'en') {
+    const { getRegions, isLoaded } = useISOData(language);
+    return useMemo(() => {
+        if (!isLoaded || !countryCode)
+            return [];
+        return getRegions(countryCode)
+            .map((r) => ({ value: r.iso, label: r.name }))
+            .sort((a, b) => a.label.localeCompare(b.label));
+    }, [countryCode, getRegions, isLoaded]);
+}
+//# sourceMappingURL=useISOData.js.map

package/dist/react/hooks/useISOData.js.map

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