@tagadapay/plugin-sdk 3.1.11 → 3.1.22

package/build-cdn.js

@@ -1,228 +1,231 @@
-#!/usr/bin/env node
-
-/**
- * Build script for creating standalone CDN bundles
- * 
- * This creates:
- * - 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
- *   npm run build:cdn
- */
-
-const esbuild = require('esbuild');
-const path = require('path');
-const fs = require('fs');
-
-const TRACKER_ENTRY = path.join(__dirname, 'src/v2/standalone/external-tracker.ts');
-const SDK_ENTRY = path.join(__dirname, 'src/v2/standalone/index.ts');
-const OUT_DIR = path.join(__dirname, 'dist');
-
-async function build() {
-  console.log('🔨 Building CDN bundles...\n');
-
-  // ==========================================================================
-  // EXTERNAL TRACKER (lightweight, tracking only)
-  // ==========================================================================
-  console.log('📦 Building external-tracker...');
-  
-  // Build minified UMD bundle
-  await esbuild.build({
-    entryPoints: [TRACKER_ENTRY],
-    bundle: true,
-    minify: true,
-    sourcemap: true,
-    target: ['es2018', 'chrome58', 'firefox57', 'safari11', 'edge79'],
-    format: 'iife',
-    globalName: 'TagadaTrackerBundle',
-    outfile: path.join(OUT_DIR, 'external-tracker.min.js'),
-    // Don't include React - this is a standalone script
-    external: [],
-    // Define globals for browser environment
-    define: {
-      'process.env.NODE_ENV': '"production"',
-    },
-    // Footer to expose TagadaTracker on window
-    footer: {
-      js: `
-// Expose TagadaTracker globally (if not already done in bundle)
-if (typeof window !== 'undefined' && TagadaTrackerBundle && TagadaTrackerBundle.TagadaTracker) {
-  window.TagadaTracker = TagadaTrackerBundle.TagadaTracker;
-}
-      `.trim(),
-    },
-    banner: {
-      js: `/**
- * TagadaPay External Tracker v${require('./package.json').version}
- * CDN Bundle - Standalone tracking for external pages
- * @license MIT
- */`,
-    },
-  });
-
-  console.log('  ✅ dist/external-tracker.min.js (minified + sourcemap)');
-
-  // Build non-minified version for debugging
-  await esbuild.build({
-    entryPoints: [TRACKER_ENTRY],
-    bundle: true,
-    minify: false,
-    sourcemap: false,
-    target: ['es2018', 'chrome58', 'firefox57', 'safari11', 'edge79'],
-    format: 'iife',
-    globalName: 'TagadaTrackerBundle',
-    outfile: path.join(OUT_DIR, 'external-tracker.js'),
-    external: [],
-    define: {
-      'process.env.NODE_ENV': '"development"',
-    },
-    footer: {
-      js: `
-// Expose TagadaTracker globally
-if (typeof window !== 'undefined' && TagadaTrackerBundle && TagadaTrackerBundle.TagadaTracker) {
-  window.TagadaTracker = TagadaTrackerBundle.TagadaTracker;
-}
-      `.trim(),
-    },
-    banner: {
-      js: `/**
- * TagadaPay External Tracker v${require('./package.json').version}
- * CDN Bundle - Standalone tracking for external pages (Debug Build)
- * @license MIT
- */`,
-    },
-  });
-
-  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;
-  // 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.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)');
-
-  // Get file sizes
-  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;
-
-  console.log('\n📦 Bundle sizes:');
-  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('\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>');
-  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 = createTagadaClient({ features: { funnel: true } });');
-  console.log('    client.subscribe((state) => console.log(state));');
-  console.log('  </script>\n');
-}
-
-build().catch((err) => {
-  console.error('Build failed:', err);
-  process.exit(1);
-});
-
-
+#!/usr/bin/env node
+
+/**
+ * Build script for creating standalone CDN bundles
+ * 
+ * This creates:
+ * - 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
+ *   npm run build:cdn
+ */
+
+const esbuild = require('esbuild');
+const path = require('path');
+const fs = require('fs');
+
+const TRACKER_ENTRY = path.join(__dirname, 'src/v2/standalone/external-tracker.ts');
+const SDK_ENTRY = path.join(__dirname, 'src/v2/standalone/index.ts');
+const OUT_DIR = path.join(__dirname, 'dist');
+
+async function build() {
+  console.log('🔨 Building CDN bundles...\n');
+
+  // ==========================================================================
+  // EXTERNAL TRACKER (lightweight, tracking only)
+  // ==========================================================================
+  console.log('📦 Building external-tracker...');
+  
+  // Build minified UMD bundle
+  await esbuild.build({
+    entryPoints: [TRACKER_ENTRY],
+    bundle: true,
+    minify: true,
+    sourcemap: true,
+    target: ['es2018', 'chrome58', 'firefox57', 'safari11', 'edge79'],
+    format: 'iife',
+    globalName: 'TagadaTrackerBundle',
+    outfile: path.join(OUT_DIR, 'external-tracker.min.js'),
+    // Don't include React - this is a standalone script
+    external: [],
+    // Define globals for browser environment
+    define: {
+      'process.env.NODE_ENV': '"production"',
+    },
+    // Footer to expose TagadaTracker on window
+    footer: {
+      js: `
+// Expose TagadaTracker globally (if not already done in bundle)
+if (typeof window !== 'undefined' && TagadaTrackerBundle && TagadaTrackerBundle.TagadaTracker) {
+  window.TagadaTracker = TagadaTrackerBundle.TagadaTracker;
+}
+      `.trim(),
+    },
+    banner: {
+      js: `/**
+ * TagadaPay External Tracker v${require('./package.json').version}
+ * CDN Bundle - Standalone tracking for external pages
+ * @license MIT
+ */`,
+    },
+  });
+
+  console.log('  ✅ dist/external-tracker.min.js (minified + sourcemap)');
+
+  // Build non-minified version for debugging
+  await esbuild.build({
+    entryPoints: [TRACKER_ENTRY],
+    bundle: true,
+    minify: false,
+    sourcemap: false,
+    target: ['es2018', 'chrome58', 'firefox57', 'safari11', 'edge79'],
+    format: 'iife',
+    globalName: 'TagadaTrackerBundle',
+    outfile: path.join(OUT_DIR, 'external-tracker.js'),
+    external: [],
+    define: {
+      'process.env.NODE_ENV': '"development"',
+    },
+    footer: {
+      js: `
+// Expose TagadaTracker globally
+if (typeof window !== 'undefined' && TagadaTrackerBundle && TagadaTrackerBundle.TagadaTracker) {
+  window.TagadaTracker = TagadaTrackerBundle.TagadaTracker;
+}
+      `.trim(),
+    },
+    banner: {
+      js: `/**
+ * TagadaPay External Tracker v${require('./package.json').version}
+ * CDN Bundle - Standalone tracking for external pages (Debug Build)
+ * @license MIT
+ */`,
+    },
+  });
+
+  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)');
+
+  // Get file sizes
+  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;
+
+  console.log('\n📦 Bundle sizes:');
+  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('\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>');
+  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 = createTagadaClient({ features: { funnel: true } });');
+  console.log('    client.subscribe((state) => console.log(state));');
+  console.log('  </script>\n');
+}
+
+build().catch((err) => {
+  console.error('Build failed:', err);
+  process.exit(1);
+});
+
+

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>;