@tagadapay/plugin-sdk 1.0.2

package/dist/react/utils/money.js

@@ -0,0 +1,104 @@
+import currencyData from '../../data/currencies.json';
+// Universal Currency Formatter with Locale Support Patch
+function formatCurrency(amount, locale, currency) {
+    const currencySymbols = {
+        AUD: 'A$',
+        CAD: 'CA$',
+        USD: '$',
+    };
+    try {
+        const formatter = new Intl.NumberFormat(locale, {
+            style: 'currency',
+            currency,
+        });
+        let formatted = formatter.format(amount);
+        // Force the correct currency symbol based on currency code
+        if (currency in currencySymbols) {
+            // Get the correct currency symbol
+            const correctSymbol = currencySymbols[currency];
+            // Replace the currency symbol part while preserving the locale-specific number formatting
+            // This regular expression matches any non-digit, non-comma, non-dot, non-space at the beginning
+            formatted = formatted.replace(/^[^\d\s.,]+/, correctSymbol);
+        }
+        return formatted;
+    }
+    catch (error) {
+        console.error('Intl.NumberFormat Error:', error);
+        // Fallback if Intl.NumberFormat completely fails
+        return `${currency in currencySymbols ? currencySymbols[currency] : ''}${amount.toFixed(2)}`;
+    }
+}
+/**
+ * Formats the amount in minor units (cents, pence, etc.) to a string based on the provided currency code and locale.
+ * @param {number} amountMinorUnits - The amount in minor units (e.g., 12345 for $123.45).
+ * @param {string} currencyCode - The ISO 4217 currency code (e.g., "USD", "JPY").
+ * @param {string} locale - The locale to format the output (default is "en-US").
+ * @returns {string} - The formatted money string (e.g., "$123.45").
+ */
+export function formatMoney(amountMinorUnits, currencyCode = 'USD', locale) {
+    const safeLocale = locale || 'en-US';
+    const currencyInfo = currencyData[currencyCode];
+    if (!currencyInfo) {
+        throw new Error(`Currency ${currencyCode} not found in currency data.`);
+    }
+    // Convert minor units to major units
+    const value = amountMinorUnits / Math.pow(10, currencyInfo.ISOdigits);
+    return formatCurrency(value, safeLocale, currencyCode);
+}
+/**
+ * Utility function to get currency information based on the ISO 4217 currency code.
+ * Uses the preloaded currency data from the JSON file.
+ */
+export function getCurrencyInfo(currencyCode) {
+    return currencyData[currencyCode] || null;
+}
+/**
+ * Convert a money string or number to minor units
+ */
+export function moneyStringOrNumberToMinorUnits(moneyStringOrNumber, currencyCode) {
+    const currencyInfo = currencyData[currencyCode];
+    if (!currencyInfo) {
+        throw new Error(`Currency ${currencyCode} not found in currency data.`);
+    }
+    const value = typeof moneyStringOrNumber === 'string' ? parseFloat(moneyStringOrNumber) : moneyStringOrNumber;
+    return Math.round(value * Math.pow(10, currencyInfo.ISOdigits));
+}
+/**
+ * Convert minor units to major units (decimal value)
+ */
+export function minorUnitsToMajorUnits(amountMinorUnits, currencyCode) {
+    const currencyInfo = currencyData[currencyCode];
+    if (!currencyInfo) {
+        throw new Error(`Currency ${currencyCode} not found in currency data.`);
+    }
+    return amountMinorUnits / Math.pow(10, currencyInfo.ISOdigits);
+}
+/**
+ * Format money without currency symbol, just the numeric value
+ */
+export const formatMoneyWithoutSymbol = ({ amount, currencyCode, fromCents = true, }) => {
+    const currencyInfo = currencyData[currencyCode];
+    const digits = currencyInfo?.ISOdigits || 2;
+    const value = fromCents ? amount / Math.pow(10, digits) : amount;
+    return new Intl.NumberFormat('en-US', {
+        minimumFractionDigits: digits,
+        maximumFractionDigits: digits,
+    }).format(value);
+};
+/**
+ * Convert currency amounts with exchange rates
+ */
+export const convertCurrency = (amount, fromCurrency, toCurrency, rate) => {
+    if (fromCurrency === toCurrency)
+        return amount;
+    return Math.round(amount * rate);
+};
+/**
+ * Simple money formatter for quick use (similar to the existing useCurrency format function)
+ */
+export function formatSimpleMoney(amount, currencyCode) {
+    const currencyInfo = currencyData[currencyCode];
+    const symbol = currencyInfo?.symbol || currencyCode;
+    const digits = currencyInfo?.ISOdigits || 2;
+    return `${symbol}${(amount / Math.pow(10, digits)).toFixed(digits)}`;
+}

package/dist/react/utils/tokenStorage.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Set the CMS token in localStorage
+ */
+export declare function setClientToken(token: string): void;
+/**
+ * Get the CMS token from localStorage
+ */
+export declare function getClientToken(): string | null;
+/**
+ * Clear the CMS token from localStorage
+ */
+export declare function clearClientToken(): void;
+/**
+ * Check if a token exists in localStorage
+ */
+export declare function hasClientToken(): boolean;

package/dist/react/utils/tokenStorage.js

@@ -0,0 +1,52 @@
+'use client';
+/**
+ * Client-side token storage utilities
+ */
+const TOKEN_KEY = 'tagada_cms_token';
+/**
+ * Set the CMS token in localStorage
+ */
+export function setClientToken(token) {
+    if (typeof window !== 'undefined') {
+        try {
+            localStorage.setItem(TOKEN_KEY, token);
+        }
+        catch (error) {
+            console.error('Failed to save token to localStorage:', error);
+        }
+    }
+}
+/**
+ * Get the CMS token from localStorage
+ */
+export function getClientToken() {
+    if (typeof window !== 'undefined') {
+        try {
+            return localStorage.getItem(TOKEN_KEY);
+        }
+        catch (error) {
+            console.error('Failed to get token from localStorage:', error);
+            return null;
+        }
+    }
+    return null;
+}
+/**
+ * Clear the CMS token from localStorage
+ */
+export function clearClientToken() {
+    if (typeof window !== 'undefined') {
+        try {
+            localStorage.removeItem(TOKEN_KEY);
+        }
+        catch (error) {
+            console.error('Failed to clear token from localStorage:', error);
+        }
+    }
+}
+/**
+ * Check if a token exists in localStorage
+ */
+export function hasClientToken() {
+    return !!getClientToken();
+}

package/dist/react/utils/urlUtils.d.ts

@@ -0,0 +1,239 @@
+/**
+ * Extract checkout token from a URL path
+ *
+ * @param url - The URL to extract the token from
+ * @returns The checkout token if found, null otherwise
+ *
+ * @example
+ * ```typescript
+ * // These will all return "0cb592d75aae75e337b7b784f6624dbf"
+ * extractCheckoutToken("https://example.com/checkout/0cb592d75aae75e337b7b784f6624dbf")
+ * extractCheckoutToken("/checkout/0cb592d75aae75e337b7b784f6624dbf")
+ * extractCheckoutToken("/some/path/0cb592d75aae75e337b7b784f6624dbf/other/path")
+ * extractCheckoutToken("0cb592d75aae75e337b7b784f6624dbf")
+ *
+ * // These will return null
+ * extractCheckoutToken("https://example.com/checkout")
+ * extractCheckoutToken("invalid-token")
+ * ```
+ */
+export declare function extractCheckoutToken(url: string): string | null;
+/**
+ * Extract checkout token from current browser URL
+ *
+ * @returns The checkout token if found in current URL, null otherwise
+ *
+ * @example
+ * ```typescript
+ * // If current URL is "https://example.com/checkout/0cb592d75aae75e337b7b784f6624dbf"
+ * const token = extractCheckoutTokenFromCurrentUrl();
+ * // Returns: "0cb592d75aae75e337b7b784f6624dbf"
+ * ```
+ */
+export declare function extractCheckoutTokenFromCurrentUrl(): string | null;
+/**
+ * Extract checkout token from URL pathname only
+ *
+ * @param pathname - The pathname to extract the token from
+ * @returns The checkout token if found, null otherwise
+ *
+ * @example
+ * ```typescript
+ * // These will all return "0cb592d75aae75e337b7b784f6624dbf"
+ * extractCheckoutTokenFromPath("/checkout/0cb592d75aae75e337b7b784f6624dbf")
+ * extractCheckoutTokenFromPath("/some/path/0cb592d75aae75e337b7b784f6624dbf/other/path")
+ * extractCheckoutTokenFromPath("0cb592d75aae75e337b7b784f6624dbf")
+ * ```
+ */
+export declare function extractCheckoutTokenFromPath(pathname: string): string | null;
+/**
+ * Validate if a string is a valid checkout token format
+ *
+ * @param token - The token to validate
+ * @returns True if the token is valid, false otherwise
+ *
+ * @example
+ * ```typescript
+ * isValidCheckoutToken("0cb592d75aae75e337b7b784f6624dbf") // true
+ * isValidCheckoutToken("invalid-token") // false
+ * isValidCheckoutToken("1234567890abcdef1234567890abcdef") // true
+ * isValidCheckoutToken("") // false
+ * ```
+ */
+export declare function isValidCheckoutToken(token: string): boolean;
+/**
+ * Extract checkout token from various URL formats and validate it
+ *
+ * @param url - The URL to extract and validate the token from
+ * @returns The validated checkout token if found and valid, null otherwise
+ *
+ * @example
+ * ```typescript
+ * // These will all return "0cb592d75aae75e337b7b784f6624dbf"
+ * extractAndValidateCheckoutToken("https://example.com/checkout/0cb592d75aae75e337b7b784f6624dbf")
+ * extractAndValidateCheckoutToken("/checkout/0cb592d75aae75e337b7b784f6624dbf")
+ *
+ * // These will return null
+ * extractAndValidateCheckoutToken("https://example.com/checkout/invalid-token")
+ * extractAndValidateCheckoutToken("https://example.com/checkout")
+ * ```
+ */
+export declare function extractAndValidateCheckoutToken(url: string): string | null;
+/**
+ * Extract checkout token from URL query parameters
+ *
+ * @param searchParams - URLSearchParams object or search string
+ * @returns The checkout token if found in query params, null otherwise
+ *
+ * @example
+ * ```typescript
+ * // From URLSearchParams
+ * const params = new URLSearchParams('?token=0cb592d75aae75e337b7b784f6624dbf');
+ * const token = extractCheckoutTokenFromQuery(params);
+ *
+ * // From search string
+ * const token = extractCheckoutTokenFromQuery('?checkoutToken=0cb592d75aae75e337b7b784f6624dbf');
+ * ```
+ */
+export declare function extractCheckoutTokenFromQuery(searchParams: URLSearchParams | string): string | null;
+/**
+ * Extract checkout token from current browser URL query parameters
+ *
+ * @returns The checkout token if found in current URL query params, null otherwise
+ *
+ * @example
+ * ```typescript
+ * // If current URL is "https://example.com/checkout?token=0cb592d75aae75e337b7b784f6624dbf"
+ * const token = extractCheckoutTokenFromCurrentUrlQuery();
+ * // Returns: "0cb592d75aae75e337b7b784f6624dbf"
+ * ```
+ */
+export declare function extractCheckoutTokenFromCurrentUrlQuery(): string | null;
+/**
+ * Get checkout token from multiple possible sources
+ *
+ * @param options - Options for token extraction
+ * @returns The checkout token if found, null otherwise
+ *
+ * @example
+ * ```typescript
+ * // Try to get token from current URL (both query params and path), then from a specific URL, then from a fallback
+ * const token = getCheckoutToken({
+ *   currentUrl: true,
+ *   specificUrl: "https://example.com/checkout/0cb592d75aae75e337b7b784f6624dbf",
+ *   fallbackToken: "0cb592d75aae75e337b7b784f6624dbf"
+ * });
+ *
+ * // Works with both query parameters and path parameters:
+ * // /checkout?token=0cb592d75aae75e337b7b784f6624dbf
+ * // /checkout?checkoutToken=0cb592d75aae75e337b7b784f6624dbf
+ * // /checkout/0cb592d75aae75e337b7b784f6624dbf
+ * ```
+ */
+export declare function getCheckoutToken(options?: {
+    currentUrl?: boolean;
+    specificUrl?: string;
+    fallbackToken?: string;
+}): string | null;
+/**
+ * Build a checkout URL with a token
+ *
+ * @param baseUrl - The base URL for the checkout
+ * @param token - The checkout token
+ * @returns The complete checkout URL
+ *
+ * @example
+ * ```typescript
+ * buildCheckoutUrl("https://example.com/checkout", "0cb592d75aae75e337b7b784f6624dbf")
+ * // Returns: "https://example.com/checkout/0cb592d75aae75e337b7b784f6624dbf"
+ * ```
+ */
+export declare function buildCheckoutUrl(baseUrl: string, token: string): string;
+/**
+ * Check if a URL contains a checkout token (in path or query parameters)
+ *
+ * @param url - The URL to check
+ * @returns True if the URL contains a valid checkout token, false otherwise
+ *
+ * @example
+ * ```typescript
+ * hasCheckoutToken("https://example.com/checkout/0cb592d75aae75e337b7b784f6624dbf") // true
+ * hasCheckoutToken("https://example.com/checkout?token=0cb592d75aae75e337b7b784f6624dbf") // true
+ * hasCheckoutToken("https://example.com/checkout?checkoutToken=0cb592d75aae75e337b7b784f6624dbf") // true
+ * hasCheckoutToken("https://example.com/checkout") // false
+ * hasCheckoutToken("https://example.com/checkout/invalid-token") // false
+ * ```
+ */
+export declare function hasCheckoutToken(url: string): boolean;
+/**
+ * Extract checkout initialization data from URL search parameters
+ *
+ * @param searchParams - URLSearchParams object or search string
+ * @returns Checkout initialization data if found, null otherwise
+ *
+ * @example
+ * ```typescript
+ * // From URLSearchParams
+ * const params = new URLSearchParams('?items=[{"id":"1","quantity":2}]&cartToken=abc&storeId=123');
+ * const data = extractCheckoutInitData(params);
+ *
+ * // From search string
+ * const data = extractCheckoutInitData('?items=[{"id":"1","quantity":2}]&cartToken=abc&storeId=123');
+ *
+ * // From base64 encoded data
+ * const data = extractCheckoutInitData('?data=eyJpdGVtcyI6W3siaWQiOiIxIiwicXVhbnRpdHkiOjJ9XX0=');
+ * ```
+ */
+export declare function extractCheckoutInitData(searchParams: URLSearchParams | string): {
+    cartToken?: string;
+    lineItems: {
+        id: string;
+        quantity: number;
+        price?: number;
+    }[];
+    customer?: {
+        currency?: string;
+        locale?: string;
+    };
+    returnUrl?: string;
+    storeId?: string;
+} | null;
+/**
+ * Extract checkout initialization data from current browser URL
+ *
+ * @returns Checkout initialization data if found, null otherwise
+ *
+ * @example
+ * ```typescript
+ * // If current URL is "https://example.com/checkout?items=[...]&cartToken=abc"
+ * const data = extractCheckoutInitDataFromCurrentUrl();
+ * ```
+ */
+export declare function extractCheckoutInitDataFromCurrentUrl(): ReturnType<typeof extractCheckoutInitData>;
+/**
+ * Check if URL contains checkout initialization data
+ *
+ * @param searchParams - URLSearchParams object or search string
+ * @returns True if URL contains checkout init data, false otherwise
+ *
+ * @example
+ * ```typescript
+ * hasCheckoutInitData('?items=[{"id":"1","quantity":2}]') // true
+ * hasCheckoutInitData('?other=param') // false
+ * ```
+ */
+export declare function hasCheckoutInitData(searchParams: URLSearchParams | string): boolean;
+/**
+ * Check if current URL contains checkout initialization data
+ *
+ * @returns True if current URL contains checkout init data, false otherwise
+ *
+ * @example
+ * ```typescript
+ * // If current URL has checkout data
+ * if (hasCheckoutInitDataInCurrentUrl()) {
+ *   // Auto-initialize checkout
+ * }
+ * ```
+ */
+export declare function hasCheckoutInitDataInCurrentUrl(): boolean;