@tagadapay/plugin-sdk 3.1.12 → 3.1.24

package/build-cdn.js

@@ -4,8 +4,10 @@
  * Build script for creating standalone CDN bundles
  * 
  * This creates:
- * - dist/external-tracker.min.js - Minified UMD bundle for CDN
+ * - dist/external-tracker.min.js - Minified UMD bundle for CDN (tracking only)
  * - dist/external-tracker.js - Non-minified for debugging
+ * - dist/tagada-sdk.min.js - Full standalone SDK bundle for CDN
+ * - dist/tagada-sdk.js - Non-minified for debugging
  * 
  * Usage:
  *   node build-cdn.js
@@ -14,16 +16,25 @@
 
 const esbuild = require('esbuild');
 const path = require('path');
+const fs = require('fs');
 
-const ENTRY_POINT = path.join(__dirname, 'src/v2/standalone/external-tracker.ts');
+const TRACKER_ENTRY = path.join(__dirname, 'src/v2/standalone/external-tracker.ts');
+const SDK_ENTRY = path.join(__dirname, 'src/v2/standalone/index.ts');
+const REACT_SDK_ENTRY = path.join(__dirname, 'src/v2/react/index.ts');
+const REACT_SDK_MINIMAL_ENTRY = path.join(__dirname, 'src/v2/cdn-react-minimal.ts');
 const OUT_DIR = path.join(__dirname, 'dist');
 
 async function build() {
-  console.log('🔨 Building external-tracker CDN bundles...\n');
+  console.log('🔨 Building CDN bundles...\n');
 
+  // ==========================================================================
+  // EXTERNAL TRACKER (lightweight, tracking only)
+  // ==========================================================================
+  console.log('📦 Building external-tracker...');
+  
   // Build minified UMD bundle
   await esbuild.build({
-    entryPoints: [ENTRY_POINT],
+    entryPoints: [TRACKER_ENTRY],
     bundle: true,
     minify: true,
     sourcemap: true,
@@ -59,7 +70,7 @@ if (typeof window !== 'undefined' && TagadaTrackerBundle && TagadaTrackerBundle.
 
   // Build non-minified version for debugging
   await esbuild.build({
-    entryPoints: [ENTRY_POINT],
+    entryPoints: [TRACKER_ENTRY],
     bundle: true,
     minify: false,
     sourcemap: false,
@@ -90,19 +101,394 @@ if (typeof window !== 'undefined' && TagadaTrackerBundle && TagadaTrackerBundle.
 
   console.log('  ✅ dist/external-tracker.js (non-minified for debugging)');
 
+  // ==========================================================================
+  // FULL STANDALONE SDK (createTagadaClient, config loading, hot reload, etc.)
+  // ==========================================================================
+  console.log('\n📦 Building tagada-sdk (full standalone SDK)...');
+  
+  // Build minified SDK bundle
+  await esbuild.build({
+    entryPoints: [SDK_ENTRY],
+    bundle: true,
+    minify: true,
+    sourcemap: true,
+    target: ['es2018', 'chrome58', 'firefox57', 'safari11', 'edge79'],
+    format: 'iife',
+    globalName: 'TagadaSDKBundle',
+    outfile: path.join(OUT_DIR, 'tagada-sdk.min.js'),
+    external: [],
+    define: {
+      'process.env.NODE_ENV': '"production"',
+    },
+    footer: {
+      js: `
+// Expose SDK under window.tgd namespace (clean, single global)
+if (typeof window !== 'undefined' && TagadaSDKBundle) {
+  window.tgd = window.tgd || {};
+  // Core
+  window.tgd.createTagadaClient = TagadaSDKBundle.createTagadaClient;
+  // Config utilities
+  window.tgd.getPluginConfig = TagadaSDKBundle.getPluginConfig;
+  window.tgd.loadPluginConfig = TagadaSDKBundle.loadPluginConfig;
+  // Hot reload
+  window.tgd.onConfigUpdate = TagadaSDKBundle.onConfigUpdate;
+  window.tgd.sendConfigUpdate = TagadaSDKBundle.sendConfigUpdate;
+  window.tgd.broadcastConfigUpdate = TagadaSDKBundle.broadcastConfigUpdate;
+  // Currency
+  window.tgd.formatMoney = TagadaSDKBundle.formatMoney;
+  // Script injection (auto-runs on load, but can be manually called)
+  window.tgd.injectStepConfigScripts = TagadaSDKBundle.injectStepConfigScripts;
+  // Full bundle reference
+  window.tgd.sdk = TagadaSDKBundle;
+}
+      `.trim(),
+    },
+    banner: {
+      js: `/**
+ * TagadaPay SDK v${require('./package.json').version}
+ * CDN Bundle - Full standalone SDK for external/vanilla pages
+ * Usage: window.tgd.createTagadaClient(), window.tgd.formatMoney(), etc.
+ * @license MIT
+ */`,
+    },
+  });
+
+  console.log('  ✅ dist/tagada-sdk.min.js (minified + sourcemap)');
+
+  // Build non-minified SDK version for debugging
+  await esbuild.build({
+    entryPoints: [SDK_ENTRY],
+    bundle: true,
+    minify: false,
+    sourcemap: false,
+    target: ['es2018', 'chrome58', 'firefox57', 'safari11', 'edge79'],
+    format: 'iife',
+    globalName: 'TagadaSDKBundle',
+    outfile: path.join(OUT_DIR, 'tagada-sdk.js'),
+    external: [],
+    define: {
+      'process.env.NODE_ENV': '"development"',
+    },
+    footer: {
+      js: `
+// Expose SDK under window.tgd namespace (clean, single global)
+if (typeof window !== 'undefined' && TagadaSDKBundle) {
+  window.tgd = window.tgd || {};
+  window.tgd.createTagadaClient = TagadaSDKBundle.createTagadaClient;
+  window.tgd.getPluginConfig = TagadaSDKBundle.getPluginConfig;
+  window.tgd.loadPluginConfig = TagadaSDKBundle.loadPluginConfig;
+  window.tgd.onConfigUpdate = TagadaSDKBundle.onConfigUpdate;
+  window.tgd.sendConfigUpdate = TagadaSDKBundle.sendConfigUpdate;
+  window.tgd.broadcastConfigUpdate = TagadaSDKBundle.broadcastConfigUpdate;
+  window.tgd.formatMoney = TagadaSDKBundle.formatMoney;
+  window.tgd.injectStepConfigScripts = TagadaSDKBundle.injectStepConfigScripts;
+  window.tgd.sdk = TagadaSDKBundle;
+}
+      `.trim(),
+    },
+    banner: {
+      js: `/**
+ * TagadaPay SDK v${require('./package.json').version}
+ * CDN Bundle - Full standalone SDK (Debug Build)
+ * Usage: window.tgd.createTagadaClient(), window.tgd.formatMoney(), etc.
+ * @license MIT
+ */`,
+    },
+  });
+
+  console.log('  ✅ dist/tagada-sdk.js (non-minified for debugging)');
+
+  // ==========================================================================
+  // REACT SDK (TagadaProvider, hooks - for use with React apps via CDN)
+  // ==========================================================================
+  console.log('\n📦 Building tagada-react-sdk (React hooks & provider)...');
+  
+  // Build minified React SDK bundle
+  await esbuild.build({
+    entryPoints: [REACT_SDK_ENTRY],
+    bundle: true,
+    minify: true,
+    sourcemap: true,
+    target: ['es2018', 'chrome58', 'firefox57', 'safari11', 'edge79'],
+    format: 'iife',
+    globalName: 'TagadaReactSDKBundle',
+    outfile: path.join(OUT_DIR, 'tagada-react-sdk.min.js'),
+    // React is external - expects window.React
+    external: ['react', 'react-dom'],
+    define: {
+      'process.env.NODE_ENV': '"production"',
+    },
+    footer: {
+      js: `
+// Expose React SDK under window.tgd namespace
+if (typeof window !== 'undefined' && TagadaReactSDKBundle) {
+  window.tgd = window.tgd || {};
+  // Provider
+  window.tgd.TagadaProvider = TagadaReactSDKBundle.TagadaProvider;
+  window.tgd.useTagadaContext = TagadaReactSDKBundle.useTagadaContext;
+  // Core hooks
+  window.tgd.useCheckout = TagadaReactSDKBundle.useCheckout;
+  window.tgd.useCheckoutSession = TagadaReactSDKBundle.useCheckoutSession;
+  window.tgd.useSession = TagadaReactSDKBundle.useSession;
+  window.tgd.useCustomer = TagadaReactSDKBundle.useCustomer;
+  window.tgd.useCustomerInfos = TagadaReactSDKBundle.useCustomerInfos;
+  window.tgd.useEnvironment = TagadaReactSDKBundle.useEnvironment;
+  window.tgd.useCurrency = TagadaReactSDKBundle.useCurrency;
+  window.tgd.useLocale = TagadaReactSDKBundle.useLocale;
+  // Commerce hooks
+  window.tgd.useShippingRates = TagadaReactSDKBundle.useShippingRates;
+  window.tgd.useDiscounts = TagadaReactSDKBundle.useDiscounts;
+  window.tgd.useOrderBump = TagadaReactSDKBundle.useOrderBump;
+  window.tgd.useOrderBumpV2 = TagadaReactSDKBundle.useOrderBumpV2;
+  window.tgd.useOrderBumpV3 = TagadaReactSDKBundle.useOrderBumpV3;
+  window.tgd.useProducts = TagadaReactSDKBundle.useProducts;
+  window.tgd.useOffers = TagadaReactSDKBundle.useOffers;
+  window.tgd.usePostPurchases = TagadaReactSDKBundle.usePostPurchases;
+  // Payment hooks
+  window.tgd.usePayment = TagadaReactSDKBundle.usePayment;
+  window.tgd.useThreeds = TagadaReactSDKBundle.useThreeds;
+  window.tgd.useApplePay = TagadaReactSDKBundle.useApplePay;
+  window.tgd.useGooglePay = TagadaReactSDKBundle.useGooglePay;
+  window.tgd.useExpressPaymentMethods = TagadaReactSDKBundle.useExpressPaymentMethods;
+  window.tgd.ExpressPaymentMethodsProvider = TagadaReactSDKBundle.ExpressPaymentMethodsProvider;
+  // Utility hooks
+  window.tgd.useGeoLocation = TagadaReactSDKBundle.useGeoLocation;
+  window.tgd.useGoogleAutocomplete = TagadaReactSDKBundle.useGoogleAutocomplete;
+  window.tgd.useISOData = TagadaReactSDKBundle.useISOData;
+  window.tgd.usePluginConfig = TagadaReactSDKBundle.usePluginConfig;
+  window.tgd.useTranslations = TagadaReactSDKBundle.useTranslations;
+  // Funnel
+  window.tgd.useFunnel = TagadaReactSDKBundle.useFunnel;
+  // Components
+  window.tgd.Button = TagadaReactSDKBundle.Button;
+  window.tgd.ApplePayButton = TagadaReactSDKBundle.ApplePayButton;
+  window.tgd.GooglePayButton = TagadaReactSDKBundle.GooglePayButton;
+  // Utilities
+  window.tgd.formatMoney = TagadaReactSDKBundle.formatMoney;
+  // Full bundle reference
+  window.tgd.react = TagadaReactSDKBundle;
+}
+      `.trim(),
+    },
+    banner: {
+      js: `/**
+ * TagadaPay React SDK v${require('./package.json').version}
+ * CDN Bundle - React hooks and TagadaProvider for checkout integration
+ * Requires: React 18+ loaded before this script
+ * Usage: window.tgd.TagadaProvider, window.tgd.useCheckout, etc.
+ * @license MIT
+ */`,
+    },
+  });
+
+  console.log('  ✅ dist/tagada-react-sdk.min.js (minified + sourcemap)');
+
+  // Build non-minified React SDK version for debugging
+  await esbuild.build({
+    entryPoints: [REACT_SDK_ENTRY],
+    bundle: true,
+    minify: false,
+    sourcemap: false,
+    target: ['es2018', 'chrome58', 'firefox57', 'safari11', 'edge79'],
+    format: 'iife',
+    globalName: 'TagadaReactSDKBundle',
+    outfile: path.join(OUT_DIR, 'tagada-react-sdk.js'),
+    external: ['react', 'react-dom'],
+    define: {
+      'process.env.NODE_ENV': '"development"',
+    },
+    footer: {
+      js: `
+// Expose React SDK under window.tgd namespace
+if (typeof window !== 'undefined' && TagadaReactSDKBundle) {
+  window.tgd = window.tgd || {};
+  window.tgd.TagadaProvider = TagadaReactSDKBundle.TagadaProvider;
+  window.tgd.useTagadaContext = TagadaReactSDKBundle.useTagadaContext;
+  window.tgd.useCheckout = TagadaReactSDKBundle.useCheckout;
+  window.tgd.useCheckoutSession = TagadaReactSDKBundle.useCheckoutSession;
+  window.tgd.useSession = TagadaReactSDKBundle.useSession;
+  window.tgd.useCustomer = TagadaReactSDKBundle.useCustomer;
+  window.tgd.useCustomerInfos = TagadaReactSDKBundle.useCustomerInfos;
+  window.tgd.useEnvironment = TagadaReactSDKBundle.useEnvironment;
+  window.tgd.useCurrency = TagadaReactSDKBundle.useCurrency;
+  window.tgd.useLocale = TagadaReactSDKBundle.useLocale;
+  window.tgd.useShippingRates = TagadaReactSDKBundle.useShippingRates;
+  window.tgd.useDiscounts = TagadaReactSDKBundle.useDiscounts;
+  window.tgd.useOrderBump = TagadaReactSDKBundle.useOrderBump;
+  window.tgd.useOrderBumpV2 = TagadaReactSDKBundle.useOrderBumpV2;
+  window.tgd.useOrderBumpV3 = TagadaReactSDKBundle.useOrderBumpV3;
+  window.tgd.useProducts = TagadaReactSDKBundle.useProducts;
+  window.tgd.useOffers = TagadaReactSDKBundle.useOffers;
+  window.tgd.usePostPurchases = TagadaReactSDKBundle.usePostPurchases;
+  window.tgd.usePayment = TagadaReactSDKBundle.usePayment;
+  window.tgd.useThreeds = TagadaReactSDKBundle.useThreeds;
+  window.tgd.useApplePay = TagadaReactSDKBundle.useApplePay;
+  window.tgd.useGooglePay = TagadaReactSDKBundle.useGooglePay;
+  window.tgd.useExpressPaymentMethods = TagadaReactSDKBundle.useExpressPaymentMethods;
+  window.tgd.ExpressPaymentMethodsProvider = TagadaReactSDKBundle.ExpressPaymentMethodsProvider;
+  window.tgd.useGeoLocation = TagadaReactSDKBundle.useGeoLocation;
+  window.tgd.useGoogleAutocomplete = TagadaReactSDKBundle.useGoogleAutocomplete;
+  window.tgd.useISOData = TagadaReactSDKBundle.useISOData;
+  window.tgd.usePluginConfig = TagadaReactSDKBundle.usePluginConfig;
+  window.tgd.useTranslations = TagadaReactSDKBundle.useTranslations;
+  window.tgd.useFunnel = TagadaReactSDKBundle.useFunnel;
+  window.tgd.Button = TagadaReactSDKBundle.Button;
+  window.tgd.ApplePayButton = TagadaReactSDKBundle.ApplePayButton;
+  window.tgd.GooglePayButton = TagadaReactSDKBundle.GooglePayButton;
+  window.tgd.formatMoney = TagadaReactSDKBundle.formatMoney;
+  window.tgd.react = TagadaReactSDKBundle;
+}
+      `.trim(),
+    },
+    banner: {
+      js: `/**
+ * TagadaPay React SDK v${require('./package.json').version}
+ * CDN Bundle - React hooks and TagadaProvider (Debug Build)
+ * @license MIT
+ */`,
+    },
+  });
+
+  console.log('  ✅ dist/tagada-react-sdk.js (non-minified for debugging)');
+
+  // ==========================================================================
+  // MINIMAL REACT SDK (TagadaProvider + essential checkout hooks only)
+  // ==========================================================================
+  console.log('\n📦 Building tagada-react-sdk-minimal (slim checkout SDK)...');
+  
+  // Plugin to replace React imports with window globals
+  const reactGlobalsPlugin = {
+    name: 'react-globals',
+    setup(build) {
+      // Intercept react imports and return window globals
+      build.onResolve({ filter: /^react(-dom)?(\/.*)?$/ }, args => ({
+        path: args.path,
+        namespace: 'react-global',
+      }));
+      
+      build.onLoad({ filter: /.*/, namespace: 'react-global' }, args => {
+        if (args.path === 'react') {
+          return {
+            contents: 'module.exports = window.React;',
+            loader: 'js',
+          };
+        }
+        // Handle JSX runtime - map to React.createElement
+        if (args.path === 'react/jsx-runtime' || args.path === 'react/jsx-dev-runtime') {
+          return {
+            contents: `
+              var React = window.React;
+              module.exports = {
+                jsx: React.createElement,
+                jsxs: React.createElement,
+                jsxDEV: React.createElement,
+                Fragment: React.Fragment,
+              };
+            `,
+            loader: 'js',
+          };
+        }
+        if (args.path === 'react-dom' || args.path === 'react-dom/client') {
+          return {
+            contents: 'module.exports = window.ReactDOM;',
+            loader: 'js',
+          };
+        }
+        return { contents: 'module.exports = {};', loader: 'js' };
+      });
+    },
+  };
+  
+  // Build minified minimal React SDK bundle
+  await esbuild.build({
+    entryPoints: [REACT_SDK_MINIMAL_ENTRY],
+    bundle: true,
+    minify: true,
+    sourcemap: true,
+    target: ['es2018', 'chrome58', 'firefox57', 'safari11', 'edge79'],
+    format: 'iife',
+    globalName: 'TagadaReactMinimalBundle',
+    outfile: path.join(OUT_DIR, 'tagada-react-sdk-minimal.min.js'),
+    plugins: [reactGlobalsPlugin],
+    define: {
+      'process.env.NODE_ENV': '"production"',
+    },
+    footer: {
+      js: `
+// Expose minimal React SDK under window.tgd namespace
+if (typeof window !== 'undefined' && TagadaReactMinimalBundle) {
+  window.tgd = window.tgd || {};
+  // Provider
+  window.tgd.TagadaProvider = TagadaReactMinimalBundle.TagadaProvider;
+  window.tgd.useTagadaContext = TagadaReactMinimalBundle.useTagadaContext;
+  // Core checkout hooks
+  window.tgd.useCheckout = TagadaReactMinimalBundle.useCheckout;
+  window.tgd.useShippingRates = TagadaReactMinimalBundle.useShippingRates;
+  window.tgd.useDiscounts = TagadaReactMinimalBundle.useDiscounts;
+  window.tgd.useOrderBump = TagadaReactMinimalBundle.useOrderBump;
+  window.tgd.usePostPurchases = TagadaReactMinimalBundle.usePostPurchases;
+  window.tgd.usePayment = TagadaReactMinimalBundle.usePayment;
+  window.tgd.useThreeds = TagadaReactMinimalBundle.useThreeds;
+  // Utilities
+  window.tgd.useCurrency = TagadaReactMinimalBundle.useCurrency;
+  window.tgd.usePluginConfig = TagadaReactMinimalBundle.usePluginConfig;
+  window.tgd.useFunnel = TagadaReactMinimalBundle.useFunnel;
+  window.tgd.formatMoney = TagadaReactMinimalBundle.formatMoney;
+  // Mark as minimal
+  window.tgd._minimal = true;
+}
+      `.trim(),
+    },
+    banner: {
+      js: `/**
+ * TagadaPay React SDK MINIMAL v${require('./package.json').version}
+ * CDN Bundle - Slim checkout SDK (TagadaProvider + essential hooks only)
+ * Requires: React 18+ loaded before this script
+ * For full SDK with all hooks, use tagada-react-sdk.min.js instead
+ * @license MIT
+ */`,
+    },
+  });
+
+  console.log('  ✅ dist/tagada-react-sdk-minimal.min.js (minified + sourcemap)');
+
   // Get file sizes
-  const fs = require('fs');
-  const minSize = fs.statSync(path.join(OUT_DIR, 'external-tracker.min.js')).size;
-  const fullSize = fs.statSync(path.join(OUT_DIR, 'external-tracker.js')).size;
+  const trackerMinSize = fs.statSync(path.join(OUT_DIR, 'external-tracker.min.js')).size;
+  const trackerFullSize = fs.statSync(path.join(OUT_DIR, 'external-tracker.js')).size;
+  const sdkMinSize = fs.statSync(path.join(OUT_DIR, 'tagada-sdk.min.js')).size;
+  const sdkFullSize = fs.statSync(path.join(OUT_DIR, 'tagada-sdk.js')).size;
+  const reactSdkMinSize = fs.statSync(path.join(OUT_DIR, 'tagada-react-sdk.min.js')).size;
+  const reactSdkFullSize = fs.statSync(path.join(OUT_DIR, 'tagada-react-sdk.js')).size;
+  const reactSdkMinimalSize = fs.statSync(path.join(OUT_DIR, 'tagada-react-sdk-minimal.min.js')).size;
 
   console.log('\n📦 Bundle sizes:');
-  console.log(`   external-tracker.min.js: ${(minSize / 1024).toFixed(2)} KB`);
-  console.log(`   external-tracker.js:     ${(fullSize / 1024).toFixed(2)} KB`);
+  console.log(`   external-tracker.min.js:          ${(trackerMinSize / 1024).toFixed(2)} KB`);
+  console.log(`   external-tracker.js:              ${(trackerFullSize / 1024).toFixed(2)} KB`);
+  console.log(`   tagada-sdk.min.js:                ${(sdkMinSize / 1024).toFixed(2)} KB`);
+  console.log(`   tagada-sdk.js:                    ${(sdkFullSize / 1024).toFixed(2)} KB`);
+  console.log(`   tagada-react-sdk.min.js:          ${(reactSdkMinSize / 1024).toFixed(2)} KB (full)`);
+  console.log(`   tagada-react-sdk.js:              ${(reactSdkFullSize / 1024).toFixed(2)} KB`);
+  console.log(`   tagada-react-sdk-minimal.min.js:  ${(reactSdkMinimalSize / 1024).toFixed(2)} KB (slim) ⭐`);
 
   console.log('\n✨ CDN build complete!\n');
   console.log('Usage via CDN:');
+  console.log('');
+  console.log('  // External Tracker (lightweight, tracking only):');
   console.log('  <script src="https://cdn.jsdelivr.net/npm/@tagadapay/plugin-sdk/dist/external-tracker.min.js"></script>');
-  console.log('  <script>TagadaTracker.init({ storeId: "store_xxx", ... });</script>\n');
+  console.log('  <script>TagadaTracker.init({ storeId: "store_xxx", ... });</script>');
+  console.log('');
+  console.log('  // Full SDK (createTagadaClient, config, hot reload):');
+  console.log('  <script src="https://cdn.jsdelivr.net/npm/@tagadapay/plugin-sdk/dist/tagada-sdk.min.js"></script>');
+  console.log('  <script>');
+  console.log('    const client = window.tgd.createTagadaClient({ features: { funnel: true } });');
+  console.log('    client.subscribe((state) => console.log(state));');
+  console.log('  </script>');
+  console.log('');
+  console.log('  // React SDK (hooks & TagadaProvider - requires React 18+):');
+  console.log('  <script src="https://unpkg.com/react@18/umd/react.production.min.js"></script>');
+  console.log('  <script src="https://unpkg.com/react-dom@18/umd/react-dom.production.min.js"></script>');
+  console.log('  <script src="https://cdn.jsdelivr.net/npm/@tagadapay/plugin-sdk/dist/tagada-react-sdk.min.js"></script>');
+  console.log('  // Then use: window.tgd.TagadaProvider, window.tgd.useCheckout, etc.\n');
 }
 
 build().catch((err) => {

package/dist/data/iso3166.d.ts

@@ -1,33 +1,16 @@
-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');
+ * Geodata — CDN-backed country/region data.
+ *
+ * Instead of bundling the 775KB iso3166-2-db package, we fetch 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. The API surface is identical
+ * to the previous static-import version so all consumers work unchanged.
  */
-export declare function importLanguage(language: SupportedLanguage): Promise<void>;
+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;
@@ -41,20 +24,27 @@ export interface State {
     countryCode: string;
     uniqueKey?: string;
 }
+export declare function ensureCountriesLoaded(language?: SupportedLanguage): Promise<void>;
+export declare function ensureRegionsLoaded(language?: SupportedLanguage): Promise<void>;
+export declare function ensureGeoDataLoaded(language?: SupportedLanguage): Promise<void>;
 export declare const getCountries: (language?: SupportedLanguage) => Country[];
-export declare const getAllStates: (language?: SupportedLanguage) => State[];
 export declare const getStatesForCountry: (countryCode: string, language?: SupportedLanguage) => State[];
+export declare const getAllStates: (language?: SupportedLanguage) => State[];
 export declare const findCountryByName: (countryName: string, language?: SupportedLanguage) => Country | null;
 export declare const findRegionByCode: (regionCode: string, language?: SupportedLanguage) => State | null;
 export declare const isValidCountryCode: (countryCode: string, language?: SupportedLanguage) => boolean;
 export declare const isValidStateCode: (countryCode: string, stateCode: string, language?: SupportedLanguage) => boolean;
 export declare const getCountryWithRegions: (countryCode: string, language?: SupportedLanguage) => {
     country: {
-        code: any;
-        name: any;
-        iso3: any;
-        numeric: any;
+        code: string;
+        name: string;
+        iso3: string | undefined;
+        numeric: number | undefined;
         uniqueKey: string;
     };
     regions: State[];
 } | null;
+export declare function registerLanguage(_language: SupportedLanguage, _database: any): void;
+export declare function isLanguageRegistered(language: SupportedLanguage): boolean;
+export declare function getRegisteredLanguages(): SupportedLanguage[];
+export declare function importLanguage(language: SupportedLanguage): Promise<void>;