@tagadapay/plugin-sdk 2.4.34 → 2.4.36

package/dist/data/iso3166.d.ts

@@ -1,5 +1,33 @@
 export declare const AVAILABLE_LANGUAGES: readonly ["en", "ru", "de", "fr", "es", "zh", "hi", "pt", "ja", "ar", "it", "he"];
 export type SupportedLanguage = typeof AVAILABLE_LANGUAGES[number];
+/**
+ * Register a language database for use
+ * @param language - Language code
+ * @param database - The language database from iso3166-2-db
+ * @example
+ * import ruDatabase from 'iso3166-2-db/i18n/dispute/UN/ru';
+ * registerLanguage('ru', ruDatabase);
+ */
+export declare function registerLanguage(language: SupportedLanguage, database: any): void;
+/**
+ * Check if a language is registered
+ * @param language - Language code to check
+ * @returns true if the language is registered
+ */
+export declare function isLanguageRegistered(language: SupportedLanguage): boolean;
+/**
+ * Get list of registered languages
+ * @returns Array of registered language codes
+ */
+export declare function getRegisteredLanguages(): SupportedLanguage[];
+/**
+ * Dynamically import and register a language
+ * @param language - Language code to import
+ * @returns Promise that resolves when language is registered
+ * @example
+ * await importLanguage('ru');
+ */
+export declare function importLanguage(language: SupportedLanguage): Promise<void>;
 export interface Country {
     code: string;
     name: string;

package/dist/data/iso3166.js

@@ -1,63 +1,128 @@
-// Import static language databases for better browser compatibility
-// All supported languages from iso3166-2-db package
+// Modular language database system - import only what you need
+// English is imported by default as fallback
 // eslint-disable-next-line @typescript-eslint/ban-ts-comment
 // @ts-ignore - iso3166-2-db doesn't have TypeScript definitions
 import enDatabase from 'iso3166-2-db/i18n/dispute/UN/en';
-// eslint-disable-next-line @typescript-eslint/ban-ts-comment
-// @ts-ignore - iso3166-2-db doesn't have TypeScript definitions
-import ruDatabase from 'iso3166-2-db/i18n/dispute/UN/ru';
-// eslint-disable-next-line @typescript-eslint/ban-ts-comment
-// @ts-ignore - iso3166-2-db doesn't have TypeScript definitions
-import deDatabase from 'iso3166-2-db/i18n/dispute/UN/de';
-// eslint-disable-next-line @typescript-eslint/ban-ts-comment
-// @ts-ignore - iso3166-2-db doesn't have TypeScript definitions
-import frDatabase from 'iso3166-2-db/i18n/dispute/UN/fr';
-// eslint-disable-next-line @typescript-eslint/ban-ts-comment
-// @ts-ignore - iso3166-2-db doesn't have TypeScript definitions
-import esDatabase from 'iso3166-2-db/i18n/dispute/UN/es';
-// eslint-disable-next-line @typescript-eslint/ban-ts-comment
-// @ts-ignore - iso3166-2-db doesn't have TypeScript definitions
-import zhDatabase from 'iso3166-2-db/i18n/dispute/UN/zh';
-// eslint-disable-next-line @typescript-eslint/ban-ts-comment
-// @ts-ignore - iso3166-2-db doesn't have TypeScript definitions
-import hiDatabase from 'iso3166-2-db/i18n/dispute/UN/hi';
-// eslint-disable-next-line @typescript-eslint/ban-ts-comment
-// @ts-ignore - iso3166-2-db doesn't have TypeScript definitions
-import ptDatabase from 'iso3166-2-db/i18n/dispute/UN/pt';
-// eslint-disable-next-line @typescript-eslint/ban-ts-comment
-// @ts-ignore - iso3166-2-db doesn't have TypeScript definitions
-import jaDatabase from 'iso3166-2-db/i18n/dispute/UN/ja';
-// eslint-disable-next-line @typescript-eslint/ban-ts-comment
-// @ts-ignore - iso3166-2-db doesn't have TypeScript definitions
-import arDatabase from 'iso3166-2-db/i18n/dispute/UN/ar';
-// eslint-disable-next-line @typescript-eslint/ban-ts-comment
-// @ts-ignore - iso3166-2-db doesn't have TypeScript definitions
-import itDatabase from 'iso3166-2-db/i18n/dispute/UN/it';
-// eslint-disable-next-line @typescript-eslint/ban-ts-comment
-// @ts-ignore - iso3166-2-db doesn't have TypeScript definitions
-import heDatabase from 'iso3166-2-db/i18n/dispute/UN/he';
 // All available languages from iso3166-2-db package
 export const AVAILABLE_LANGUAGES = ['en', 'ru', 'de', 'fr', 'es', 'zh', 'hi', 'pt', 'ja', 'ar', 'it', 'he'];
-// Static language database mapping for all supported languages
+// Dynamic language database registry - starts with English only
 const languageDatabases = {
-    en: enDatabase, // English
-    ru: ruDatabase, // Russian
-    de: deDatabase, // German
-    fr: frDatabase, // French
-    es: esDatabase, // Spanish
-    zh: zhDatabase, // Chinese
-    hi: hiDatabase, // Hindi
-    pt: ptDatabase, // Portuguese
-    ja: jaDatabase, // Japanese
-    ar: arDatabase, // Arabic
-    it: itDatabase, // Italian
-    he: heDatabase, // Hebrew
+    en: enDatabase, // English (always available)
 };
+/**
+ * Register a language database for use
+ * @param language - Language code
+ * @param database - The language database from iso3166-2-db
+ * @example
+ * import ruDatabase from 'iso3166-2-db/i18n/dispute/UN/ru';
+ * registerLanguage('ru', ruDatabase);
+ */
+export function registerLanguage(language, database) {
+    if (!AVAILABLE_LANGUAGES.includes(language)) {
+        console.warn(`Language ${language} is not supported. Available languages: ${AVAILABLE_LANGUAGES.join(', ')}`);
+        return;
+    }
+    languageDatabases[language] = database;
+}
+/**
+ * Check if a language is registered
+ * @param language - Language code to check
+ * @returns true if the language is registered
+ */
+export function isLanguageRegistered(language) {
+    return language in languageDatabases;
+}
+/**
+ * Get list of registered languages
+ * @returns Array of registered language codes
+ */
+export function getRegisteredLanguages() {
+    return Object.keys(languageDatabases);
+}
+/**
+ * Dynamically import and register a language
+ * @param language - Language code to import
+ * @returns Promise that resolves when language is registered
+ * @example
+ * await importLanguage('ru');
+ */
+export async function importLanguage(language) {
+    if (isLanguageRegistered(language)) {
+        return; // Already registered
+    }
+    try {
+        let database;
+        switch (language) {
+            case 'ru':
+                // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                // @ts-ignore - iso3166-2-db doesn't have TypeScript definitions
+                database = (await import('iso3166-2-db/i18n/dispute/UN/ru')).default;
+                break;
+            case 'de':
+                // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                // @ts-ignore - iso3166-2-db doesn't have TypeScript definitions
+                database = (await import('iso3166-2-db/i18n/dispute/UN/de')).default;
+                break;
+            case 'fr':
+                // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                // @ts-ignore - iso3166-2-db doesn't have TypeScript definitions
+                database = (await import('iso3166-2-db/i18n/dispute/UN/fr')).default;
+                break;
+            case 'es':
+                // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                // @ts-ignore - iso3166-2-db doesn't have TypeScript definitions
+                database = (await import('iso3166-2-db/i18n/dispute/UN/es')).default;
+                break;
+            case 'zh':
+                // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                // @ts-ignore - iso3166-2-db doesn't have TypeScript definitions
+                database = (await import('iso3166-2-db/i18n/dispute/UN/zh')).default;
+                break;
+            case 'hi':
+                // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                // @ts-ignore - iso3166-2-db doesn't have TypeScript definitions
+                database = (await import('iso3166-2-db/i18n/dispute/UN/hi')).default;
+                break;
+            case 'pt':
+                // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                // @ts-ignore - iso3166-2-db doesn't have TypeScript definitions
+                database = (await import('iso3166-2-db/i18n/dispute/UN/pt')).default;
+                break;
+            case 'ja':
+                // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                // @ts-ignore - iso3166-2-db doesn't have TypeScript definitions
+                database = (await import('iso3166-2-db/i18n/dispute/UN/ja')).default;
+                break;
+            case 'ar':
+                // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                // @ts-ignore - iso3166-2-db doesn't have TypeScript definitions
+                database = (await import('iso3166-2-db/i18n/dispute/UN/ar')).default;
+                break;
+            case 'it':
+                // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                // @ts-ignore - iso3166-2-db doesn't have TypeScript definitions
+                database = (await import('iso3166-2-db/i18n/dispute/UN/it')).default;
+                break;
+            case 'he':
+                // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                // @ts-ignore - iso3166-2-db doesn't have TypeScript definitions
+                database = (await import('iso3166-2-db/i18n/dispute/UN/he')).default;
+                break;
+            default:
+                throw new Error(`Language ${language} is not supported`);
+        }
+        registerLanguage(language, database);
+    }
+    catch (error) {
+        console.error(`Failed to import language ${language}:`, error);
+        throw new Error(`Failed to import language ${language}`);
+    }
+}
 // Function to get language-specific database
 function getWorldDatabase(language = 'en') {
     const database = languageDatabases[language];
     if (!database) {
-        console.warn(`Language ${language} not available, falling back to English`);
+        console.warn(`Language ${language} not available, falling back to English. Use importLanguage('${language}') to load it.`);
         return languageDatabases.en;
     }
     return database;

package/dist/data/languages.d.ts

@@ -0,0 +1,79 @@
+import type { SupportedLanguage } from './iso3166';
+/**
+ * Import and register Russian language data
+ * @example
+ * import { importRussian } from '@tagadapay/plugin-sdk/data/languages';
+ * await importRussian();
+ */
+export declare function importRussian(): Promise<void>;
+/**
+ * Import and register German language data
+ */
+export declare function importGerman(): Promise<void>;
+/**
+ * Import and register French language data
+ */
+export declare function importFrench(): Promise<void>;
+/**
+ * Import and register Spanish language data
+ */
+export declare function importSpanish(): Promise<void>;
+/**
+ * Import and register Chinese language data
+ */
+export declare function importChinese(): Promise<void>;
+/**
+ * Import and register Hindi language data
+ */
+export declare function importHindi(): Promise<void>;
+/**
+ * Import and register Portuguese language data
+ */
+export declare function importPortuguese(): Promise<void>;
+/**
+ * Import and register Japanese language data
+ */
+export declare function importJapanese(): Promise<void>;
+/**
+ * Import and register Arabic language data
+ */
+export declare function importArabic(): Promise<void>;
+/**
+ * Import and register Italian language data
+ */
+export declare function importItalian(): Promise<void>;
+/**
+ * Import and register Hebrew language data
+ */
+export declare function importHebrew(): Promise<void>;
+/**
+ * Language import functions mapping
+ */
+export declare const languageImports: {
+    readonly ru: typeof importRussian;
+    readonly de: typeof importGerman;
+    readonly fr: typeof importFrench;
+    readonly es: typeof importSpanish;
+    readonly zh: typeof importChinese;
+    readonly hi: typeof importHindi;
+    readonly pt: typeof importPortuguese;
+    readonly ja: typeof importJapanese;
+    readonly ar: typeof importArabic;
+    readonly it: typeof importItalian;
+    readonly he: typeof importHebrew;
+};
+/**
+ * Import multiple languages at once
+ * @param languages - Array of language codes to import
+ * @example
+ * import { importLanguages } from '@tagadapay/plugin-sdk/data/languages';
+ * await importLanguages(['ru', 'de', 'fr']);
+ */
+export declare function importLanguages(languages: SupportedLanguage[]): Promise<void>;
+/**
+ * Import all available languages (except English which is already imported)
+ * @example
+ * import { importAllLanguages } from '@tagadapay/plugin-sdk/data/languages';
+ * await importAllLanguages();
+ */
+export declare function importAllLanguages(): Promise<void>;

package/dist/data/languages.js

@@ -0,0 +1,151 @@
+// Language import utilities for modular ISO data loading
+// This file provides convenient functions to import specific languages
+import { registerLanguage } from './iso3166';
+/**
+ * Import and register Russian language data
+ * @example
+ * import { importRussian } from '@tagadapay/plugin-sdk/data/languages';
+ * await importRussian();
+ */
+export async function importRussian() {
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore - iso3166-2-db doesn't have TypeScript definitions
+    const ruDatabase = (await import('iso3166-2-db/i18n/dispute/UN/ru')).default;
+    registerLanguage('ru', ruDatabase);
+}
+/**
+ * Import and register German language data
+ */
+export async function importGerman() {
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore - iso3166-2-db doesn't have TypeScript definitions
+    const deDatabase = (await import('iso3166-2-db/i18n/dispute/UN/de')).default;
+    registerLanguage('de', deDatabase);
+}
+/**
+ * Import and register French language data
+ */
+export async function importFrench() {
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore - iso3166-2-db doesn't have TypeScript definitions
+    const frDatabase = (await import('iso3166-2-db/i18n/dispute/UN/fr')).default;
+    registerLanguage('fr', frDatabase);
+}
+/**
+ * Import and register Spanish language data
+ */
+export async function importSpanish() {
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore - iso3166-2-db doesn't have TypeScript definitions
+    const esDatabase = (await import('iso3166-2-db/i18n/dispute/UN/es')).default;
+    registerLanguage('es', esDatabase);
+}
+/**
+ * Import and register Chinese language data
+ */
+export async function importChinese() {
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore - iso3166-2-db doesn't have TypeScript definitions
+    const zhDatabase = (await import('iso3166-2-db/i18n/dispute/UN/zh')).default;
+    registerLanguage('zh', zhDatabase);
+}
+/**
+ * Import and register Hindi language data
+ */
+export async function importHindi() {
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore - iso3166-2-db doesn't have TypeScript definitions
+    const hiDatabase = (await import('iso3166-2-db/i18n/dispute/UN/hi')).default;
+    registerLanguage('hi', hiDatabase);
+}
+/**
+ * Import and register Portuguese language data
+ */
+export async function importPortuguese() {
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore - iso3166-2-db doesn't have TypeScript definitions
+    const ptDatabase = (await import('iso3166-2-db/i18n/dispute/UN/pt')).default;
+    registerLanguage('pt', ptDatabase);
+}
+/**
+ * Import and register Japanese language data
+ */
+export async function importJapanese() {
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore - iso3166-2-db doesn't have TypeScript definitions
+    const jaDatabase = (await import('iso3166-2-db/i18n/dispute/UN/ja')).default;
+    registerLanguage('ja', jaDatabase);
+}
+/**
+ * Import and register Arabic language data
+ */
+export async function importArabic() {
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore - iso3166-2-db doesn't have TypeScript definitions
+    const arDatabase = (await import('iso3166-2-db/i18n/dispute/UN/ar')).default;
+    registerLanguage('ar', arDatabase);
+}
+/**
+ * Import and register Italian language data
+ */
+export async function importItalian() {
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore - iso3166-2-db doesn't have TypeScript definitions
+    const itDatabase = (await import('iso3166-2-db/i18n/dispute/UN/it')).default;
+    registerLanguage('it', itDatabase);
+}
+/**
+ * Import and register Hebrew language data
+ */
+export async function importHebrew() {
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore - iso3166-2-db doesn't have TypeScript definitions
+    const heDatabase = (await import('iso3166-2-db/i18n/dispute/UN/he')).default;
+    registerLanguage('he', heDatabase);
+}
+/**
+ * Language import functions mapping
+ */
+export const languageImports = {
+    ru: importRussian,
+    de: importGerman,
+    fr: importFrench,
+    es: importSpanish,
+    zh: importChinese,
+    hi: importHindi,
+    pt: importPortuguese,
+    ja: importJapanese,
+    ar: importArabic,
+    it: importItalian,
+    he: importHebrew,
+};
+/**
+ * Import multiple languages at once
+ * @param languages - Array of language codes to import
+ * @example
+ * import { importLanguages } from '@tagadapay/plugin-sdk/data/languages';
+ * await importLanguages(['ru', 'de', 'fr']);
+ */
+export async function importLanguages(languages) {
+    const importPromises = languages
+        .filter(lang => lang !== 'en') // English is already imported
+        .map(lang => {
+        const importFn = languageImports[lang];
+        if (!importFn) {
+            console.warn(`No import function found for language: ${lang}`);
+            return Promise.resolve();
+        }
+        return importFn();
+    });
+    await Promise.all(importPromises);
+}
+/**
+ * Import all available languages (except English which is already imported)
+ * @example
+ * import { importAllLanguages } from '@tagadapay/plugin-sdk/data/languages';
+ * await importAllLanguages();
+ */
+export async function importAllLanguages() {
+    const allLanguages = ['ru', 'de', 'fr', 'es', 'zh', 'hi', 'pt', 'ja', 'ar', 'it', 'he'];
+    await importLanguages(allLanguages);
+}

package/dist/index.d.ts

@@ -12,5 +12,5 @@
  */
 export type { Currency, Customer, Environment, EnvironmentConfig, Locale, Order, OrderAddress, OrderItem, OrderSummary, PickupPoint, Session, Store, } from './react/types';
 export { convertCurrency, formatMoney, formatMoneyWithoutSymbol, formatSimpleMoney, getCurrencyInfo, minorUnitsToMajorUnits, moneyStringOrNumberToMinorUnits, } from './react/utils/money';
-export * from './data/countries';
 export * from './data/iso3166';
+export * from './data/languages';

package/dist/index.js

@@ -13,5 +13,5 @@
 // Export utility functions that don't depend on React
 export { convertCurrency, formatMoney, formatMoneyWithoutSymbol, formatSimpleMoney, getCurrencyInfo, minorUnitsToMajorUnits, moneyStringOrNumberToMinorUnits, } from './react/utils/money';
 // Export data utilities
-export * from './data/countries';
 export * from './data/iso3166';
+export * from './data/languages';

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

@@ -0,0 +1,70 @@
+export interface FunnelEvent {
+    type: string;
+    data?: any;
+    timestamp?: Date;
+}
+export interface FunnelNavigationAction {
+    type: 'redirect' | 'replace' | 'push' | 'external' | 'none';
+    url?: string;
+    data?: any;
+}
+export interface FunnelNavigationResult {
+    stepId: string;
+    action: FunnelNavigationAction;
+    context: SimpleFunnelContext;
+    tracking?: {
+        from: string;
+        to: string;
+        event: string;
+        timestamp: string;
+    };
+}
+export interface SimpleFunnelContext {
+    customerId: string;
+    storeId: string;
+    sessionId: string;
+    funnelId: string;
+    currentStepId: string;
+    previousStepId?: string;
+    startedAt: number;
+    lastActivityAt: number;
+    metadata?: Record<string, any>;
+}
+export interface UseFunnelOptions {
+    funnelId?: string;
+    currentStepId?: string;
+    onNavigate?: (result: FunnelNavigationResult) => void | boolean;
+    onError?: (error: Error) => void;
+    autoInitialize?: boolean;
+}
+export interface UseFunnelResult {
+    next: (event: FunnelEvent) => Promise<any>;
+    goToStep: (stepId: string) => Promise<any>;
+    updateContext: (updates: Partial<SimpleFunnelContext>) => Promise<void>;
+    currentStep: {
+        id: string;
+    };
+    context: SimpleFunnelContext | null;
+    isLoading: boolean;
+    isInitialized: boolean;
+    initializeSession: (entryStepId?: string) => Promise<void>;
+    endSession: () => Promise<void>;
+    retryInitialization: () => Promise<void>;
+    initializationError: Error | null;
+}
+/**
+ * React Hook for Funnel Navigation (Plugin SDK Version)
+ *
+ * Simplified funnel navigation using KV storage for funnel sessions.
+ * Integrates with TagadaPay authentication and plugin routing.
+ */
+export declare function useFunnel(options: UseFunnelOptions): UseFunnelResult;
+/**
+ * Simplified funnel hook for basic step tracking
+ */
+export declare function useSimpleFunnel(funnelId: string, initialStepId?: string): {
+    currentStepId: string;
+    next: (event: FunnelEvent) => Promise<any>;
+    goToStep: (stepId: string) => Promise<any>;
+    isLoading: boolean;
+};