zopassport 0.1.0

package/package.json

@@ -0,0 +1,112 @@
+{
+  "name": "zopassport",
+  "version": "0.1.0",
+  "description": "Zo Passport SDK - Phone to Avatar to Passport. Complete authentication and onboarding flow for Zo World.",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.mjs",
+      "require": "./dist/react.js"
+    },
+    "./react-native": {
+      "types": "./dist/react-native.d.ts",
+      "import": "./dist/react-native.mjs",
+      "require": "./dist/react-native.js"
+    },
+    "./assets": {
+      "types": "./dist/assets/index.d.ts",
+      "import": "./dist/assets/index.mjs",
+      "require": "./dist/assets/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "assets",
+    "app/src",
+    "app/public",
+    "app/package.json",
+    "app/README.md",
+    "app/vite.config.ts",
+    "app/tsconfig.json",
+    "app/.env.example",
+    "app/reanimated-mock.js",
+    "app/reanimated-mock.jsx",
+    "app/svg-mock.js",
+    "app/svg-mock.jsx",
+    "scripts",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zo-world/zopassport.git"
+  },
+  "homepage": "https://zo.xyz",
+  "bugs": {
+    "url": "https://github.com/zo-world/zopassport/issues"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "bin": {
+    "create-zopassport": "./scripts/init.js"
+  },
+  "dependencies": {
+    "axios": "^1.6.0",
+    "moment": "^2.30.1"
+  },
+  "peerDependencies": {
+    "react": ">=17.0.0",
+    "react-dom": ">=17.0.0",
+    "react-native": ">=0.70.0",
+    "react-native-reanimated": ">=3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    },
+    "react-native": {
+      "optional": true
+    },
+    "react-native-reanimated": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.27",
+    "@types/react-dom": "^18.3.7",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "react-native": "^0.74.0",
+    "react-native-reanimated": "^4.2.0",
+    "react-native-svg": "^15.15.1",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  },
+  "keywords": [
+    "zo",
+    "zo-world",
+    "passport",
+    "authentication",
+    "avatar",
+    "phone-auth",
+    "otp",
+    "sdk"
+  ],
+  "author": "Zo World Team",
+  "license": "MIT"
+}

package/scripts/init.js

@@ -0,0 +1,196 @@
+#!/usr/bin/env node
+
+/**
+ * Zo Passport Initializer
+ * Sets up a new Zo Passport app
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+const GREEN = '\x1b[32m';
+const BLUE = '\x1b[34m';
+const YELLOW = '\x1b[33m';
+const RED = '\x1b[31m';
+const RESET = '\x1b[0m';
+const BOLD = '\x1b[1m';
+
+function log(message, color = RESET) {
+  console.log(`${color}${message}${RESET}`);
+}
+
+function copyRecursive(src, dest) {
+  const stats = fs.statSync(src);
+
+  if (stats.isDirectory()) {
+    if (!fs.existsSync(dest)) {
+      fs.mkdirSync(dest, { recursive: true });
+    }
+    const entries = fs.readdirSync(src);
+    for (const entry of entries) {
+      if (entry === 'node_modules' || entry === 'dist') continue;
+      copyRecursive(path.join(src, entry), path.join(dest, entry));
+    }
+  } else {
+    fs.copyFileSync(src, dest);
+  }
+}
+
+async function init() {
+  log('\n╔════════════════════════════════════════════════════════════╗', BLUE);
+  log('║         🌍  ZO PASSPORT - Project Initialization  🌍      ║', BLUE);
+  log('╚════════════════════════════════════════════════════════════╝\n', BLUE);
+
+  try {
+    const cwd = process.cwd();
+
+    // Check if directory is empty (except for package.json, node_modules)
+    const files = fs.readdirSync(cwd).filter(f =>
+      !f.startsWith('.') && f !== 'node_modules' && f !== 'package.json' && f !== 'package-lock.json'
+    );
+
+    if (files.length > 0) {
+      log('⚠️  Warning: Current directory is not empty', YELLOW);
+      log('Files will be copied without overwriting existing files\n', YELLOW);
+    }
+
+    // Find zopassport in node_modules
+    const sdkPath = path.join(cwd, 'node_modules', 'zopassport');
+
+    if (!fs.existsSync(sdkPath)) {
+      log('❌ Error: zopassport not found in node_modules', RED);
+      log('\nPlease run: npm install zopassport\n', YELLOW);
+      process.exit(1);
+    }
+
+    const appTemplateDir = path.join(sdkPath, 'app');
+    const assetsDir = path.join(sdkPath, 'assets');
+
+    if (!fs.existsSync(appTemplateDir)) {
+      log('❌ Error: App template not found in zopassport', RED);
+      process.exit(1);
+    }
+
+    log('📋 Copying app files...', BLUE);
+
+    // Copy app structure
+    const appFiles = [
+      'src',
+      'public',
+      'index.html',
+      'vite.config.ts',
+      'tsconfig.json',
+      '.env.example'
+    ];
+
+    for (const file of appFiles) {
+      const srcPath = path.join(appTemplateDir, file);
+      const destPath = path.join(cwd, file);
+
+      if (fs.existsSync(srcPath)) {
+        if (!fs.existsSync(destPath)) {
+          log(`  ✓ ${file}`, GREEN);
+          copyRecursive(srcPath, destPath);
+        } else {
+          log(`  ⊗ ${file} (already exists, skipping)`, YELLOW);
+        }
+      }
+    }
+
+    // Copy assets to public
+    if (fs.existsSync(assetsDir)) {
+      const assetsTarget = path.join(cwd, 'public', 'assets');
+      if (!fs.existsSync(assetsTarget)) {
+        log('  ✓ public/assets/', GREEN);
+        copyRecursive(assetsDir, assetsTarget);
+      } else {
+        log('  ⊗ public/assets/ (already exists, skipping)', YELLOW);
+      }
+    }
+
+    // Update or create package.json
+    const packageJsonPath = path.join(cwd, 'package.json');
+    let packageJson = {};
+
+    if (fs.existsSync(packageJsonPath)) {
+      packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+      log('  ✓ Updating package.json', GREEN);
+    } else {
+      log('  ✓ Creating package.json', GREEN);
+    }
+
+    // Merge with required fields
+    const sdkVersion = JSON.parse(
+      fs.readFileSync(path.join(sdkPath, 'package.json'), 'utf-8')
+    ).version;
+
+    packageJson = {
+      ...packageJson,
+      name: packageJson.name || 'my-zopassport-app',
+      version: packageJson.version || '1.0.0',
+      description: packageJson.description || 'Zo Passport - One line reputation to rule the world',
+      type: 'module',
+      scripts: {
+        ...packageJson.scripts,
+        dev: 'vite',
+        build: 'tsc -b && vite build',
+        preview: 'vite preview'
+      },
+      dependencies: {
+        ...packageJson.dependencies,
+        'zopassport': `^${sdkVersion}`,
+        'react': '^18.3.1',
+        'react-dom': '^18.3.1',
+        'react-native-web': '^0.19.12',
+        'axios': '^1.6.0',
+        'moment': '^2.30.1'
+      },
+      devDependencies: {
+        ...packageJson.devDependencies,
+        '@types/react': '^18.3.27',
+        '@types/react-dom': '^18.3.7',
+        '@vitejs/plugin-react': '^4.3.4',
+        'typescript': '^5.6.3',
+        'vite': '^6.0.3'
+      }
+    };
+
+    fs.writeFileSync(
+      packageJsonPath,
+      JSON.stringify(packageJson, null, 2)
+    );
+
+    log('\n✨ Project initialized successfully!\n', GREEN);
+
+    // Next steps
+    log('╔════════════════════════════════════════════════════════════╗', GREEN);
+    log('║                   🎉  READY TO GO!  🎉                     ║', GREEN);
+    log('╠════════════════════════════════════════════════════════════╣', GREEN);
+    log('║  Next steps:                                               ║', GREEN);
+    log('║                                                            ║', GREEN);
+    log('║  1. Copy the environment template:                        ║', GREEN);
+    log('║     ' + BOLD + 'cp .env.example .env' + RESET + GREEN + '                                    ║', GREEN);
+    log('║                                                            ║', GREEN);
+    log('║  2. Edit .env with your Zo client key:                    ║', GREEN);
+    log('║     ' + BOLD + 'VITE_ZO_CLIENT_KEY=your-key-here' + RESET + GREEN + '                    ║', GREEN);
+    log('║     Get your key: https://zo.xyz/developers               ║', GREEN);
+    log('║                                                            ║', GREEN);
+    log('║  3. Install dependencies:                                 ║', GREEN);
+    log('║     ' + BOLD + 'npm install' + RESET + GREEN + '                                          ║', GREEN);
+    log('║                                                            ║', GREEN);
+    log('║  4. Start the dev server:                                 ║', GREEN);
+    log('║     ' + BOLD + 'npm run dev' + RESET + GREEN + '                                           ║', GREEN);
+    log('║                                                            ║', GREEN);
+    log('║  🌍 One line reputation to rule the world                 ║', GREEN);
+    log('╚════════════════════════════════════════════════════════════╝\n', GREEN);
+
+  } catch (error) {
+    log('\n❌ Initialization failed:', RED);
+    console.error(error);
+    log('\nReport issues: https://github.com/zo-world/zopassport/issues\n', YELLOW);
+    process.exit(1);
+  }
+}
+
+init().catch(console.error);

package/scripts/postinstall.js

@@ -0,0 +1,174 @@
+#!/usr/bin/env node
+
+/**
+ * Post-install script for zopassport
+ * Sets up the demo app with all dependencies and assets
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+const GREEN = '\x1b[32m';
+const BLUE = '\x1b[34m';
+const YELLOW = '\x1b[33m';
+const RESET = '\x1b[0m';
+const BOLD = '\x1b[1m';
+
+function log(message, color = RESET) {
+  console.log(`${color}${message}${RESET}`);
+}
+
+function copyRecursive(src, dest) {
+  const stats = fs.statSync(src);
+
+  if (stats.isDirectory()) {
+    if (!fs.existsSync(dest)) {
+      fs.mkdirSync(dest, { recursive: true });
+    }
+    const entries = fs.readdirSync(src);
+    for (const entry of entries) {
+      copyRecursive(path.join(src, entry), path.join(dest, entry));
+    }
+  } else {
+    fs.copyFileSync(src, dest);
+  }
+}
+
+async function setup() {
+  log('\n╔════════════════════════════════════════════════════════════╗', BLUE);
+  log('║         🌍  ZO PASSPORT - Installation Setup  🌍          ║', BLUE);
+  log('╚════════════════════════════════════════════════════════════╝\n', BLUE);
+
+  // Check if we're in a fresh install (not in the SDK repo itself)
+  const cwd = process.cwd();
+  const isDevMode = fs.existsSync(path.join(cwd, 'tsup.config.ts'));
+
+  if (isDevMode) {
+    log('📦 Development mode detected - skipping setup\n', YELLOW);
+    return;
+  }
+
+  try {
+    // Find the package installation directory
+    const packageDir = path.join(__dirname, '..');
+    const appTemplateDir = path.join(packageDir, 'app');
+    const assetsDir = path.join(packageDir, 'assets');
+
+    // Target directory for the demo app
+    const targetDir = cwd;
+
+    log('📋 Copying demo application files...', BLUE);
+
+    // Copy app files
+    if (fs.existsSync(appTemplateDir)) {
+      const appFiles = [
+        'src',
+        'public',
+        'index.html',
+        'vite.config.ts',
+        'tsconfig.json',
+        '.env.example'
+      ];
+
+      for (const file of appFiles) {
+        const srcPath = path.join(appTemplateDir, file);
+        const destPath = path.join(targetDir, file);
+
+        if (fs.existsSync(srcPath)) {
+          if (!fs.existsSync(destPath)) {
+            log(`  ✓ ${file}`, GREEN);
+            copyRecursive(srcPath, destPath);
+          } else {
+            log(`  ⊗ ${file} (already exists, skipping)`, YELLOW);
+          }
+        }
+      }
+
+      // Copy assets
+      if (fs.existsSync(assetsDir)) {
+        const assetsTarget = path.join(targetDir, 'public', 'assets');
+        if (!fs.existsSync(assetsTarget)) {
+          log('  ✓ assets/', GREEN);
+          copyRecursive(assetsDir, assetsTarget);
+        } else {
+          log('  ⊗ assets/ (already exists, skipping)', YELLOW);
+        }
+      }
+
+      // Create package.json if it doesn't exist
+      const packageJsonPath = path.join(targetDir, 'package.json');
+      if (!fs.existsSync(packageJsonPath)) {
+        const demoPackageJson = {
+          name: 'my-zopassport-app',
+          version: '1.0.0',
+          description: 'Zo Passport - One line reputation to rule the world',
+          type: 'module',
+          scripts: {
+            dev: 'vite',
+            build: 'tsc -b && vite build',
+            preview: 'vite preview'
+          },
+          dependencies: {
+            'zopassport-sdk': require(path.join(packageDir, 'package.json')).version,
+            'react': '^18.3.1',
+            'react-dom': '^18.3.1',
+            'react-native-web': '^0.19.12',
+            'axios': '^1.6.0',
+            'moment': '^2.30.1'
+          },
+          devDependencies: {
+            '@types/react': '^18.3.27',
+            '@types/react-dom': '^18.3.7',
+            '@vitejs/plugin-react': '^4.3.4',
+            'typescript': '^5.6.3',
+            'vite': '^6.0.3'
+          }
+        };
+
+        fs.writeFileSync(
+          packageJsonPath,
+          JSON.stringify(demoPackageJson, null, 2)
+        );
+        log('  ✓ package.json', GREEN);
+      }
+
+      log('\n✨ Demo app files copied successfully!\n', GREEN);
+    }
+
+    // Installation instructions
+    log('╔════════════════════════════════════════════════════════════╗', GREEN);
+    log('║                   🎉  SETUP COMPLETE!  🎉                  ║', GREEN);
+    log('╠════════════════════════════════════════════════════════════╣', GREEN);
+    log('║  Next steps:                                               ║', GREEN);
+    log('║                                                            ║', GREEN);
+    log('║  1. Copy the example environment file:                    ║', GREEN);
+    log('║     ' + BOLD + 'cp .env.example .env' + RESET + GREEN + '                                    ║', GREEN);
+    log('║                                                            ║', GREEN);
+    log('║  2. Edit .env and add your Zo client key:                 ║', GREEN);
+    log('║     ' + BOLD + 'VITE_ZO_CLIENT_KEY=your-key-here' + RESET + GREEN + '                    ║', GREEN);
+    log('║     Get your key at: https://zo.xyz/developers            ║', GREEN);
+    log('║                                                            ║', GREEN);
+    log('║  3. Install dependencies:                                 ║', GREEN);
+    log('║     ' + BOLD + 'npm install' + RESET + GREEN + '                                          ║', GREEN);
+    log('║                                                            ║', GREEN);
+    log('║  4. Start the development server:                         ║', GREEN);
+    log('║     ' + BOLD + 'npm run dev' + RESET + GREEN + '                                           ║', GREEN);
+    log('║                                                            ║', GREEN);
+    log('║  🌍 One line reputation to rule the world                 ║', GREEN);
+    log('╚════════════════════════════════════════════════════════════╝\n', GREEN);
+
+  } catch (error) {
+    log('\n❌ Setup failed:', 'red');
+    console.error(error);
+    log('\nPlease report this issue at: https://github.com/zo-world/zopassport/issues\n', YELLOW);
+    process.exit(1);
+  }
+}
+
+// Only run if called directly (not required as module)
+if (require.main === module) {
+  setup().catch(console.error);
+}
+
+module.exports = { setup };

package/scripts/verify-build.js

@@ -0,0 +1,121 @@
+const Module = require('module');
+const originalRequire = Module.prototype.require;
+
+// Mock React Native and other UI dependencies
+const mockComponent = () => 'MockComponent';
+const mockRN = {
+    View: mockComponent,
+    Text: mockComponent,
+    Image: mockComponent,
+    ScrollView: mockComponent,
+    Pressable: mockComponent,
+    ActivityIndicator: mockComponent,
+    StyleSheet: { create: (obj) => obj },
+    Platform: { OS: 'ios' },
+    SafeAreaView: mockComponent,
+};
+
+const mockReanimated = {
+    default: {
+        View: mockComponent,
+        createAnimatedComponent: (c) => c,
+    },
+    FadeIn: {},
+    FadeOut: {},
+    FadeInUp: {},
+    FadeOutUp: {},
+    FadeInDown: {},
+};
+
+const mockSvg = {
+    Svg: mockComponent,
+    Path: mockComponent,
+    Circle: mockComponent,
+};
+
+// Patch require to return mocks
+Module.prototype.require = function (path) {
+    if (path === 'react-native') return mockRN;
+    if (path === 'react-native-reanimated') return mockReanimated;
+    if (path === 'react-native-svg') return mockSvg;
+    if (path === 'moment') return () => ({ format: () => 'date' });
+    return originalRequire.apply(this, arguments);
+};
+
+const { ZoPassportSDK, ZoWallet } = require('../dist/index.js');
+
+console.log('--- Verifying Core SDK Exports ---');
+
+if (typeof ZoPassportSDK !== 'function') {
+    console.error('FAIL: ZoPassportSDK is not exported as a constructor');
+    process.exit(1);
+} else {
+    console.log('PASS: ZoPassportSDK is exported');
+}
+
+if (typeof ZoWallet !== 'function') {
+    console.error('FAIL: ZoWallet is not exported');
+    process.exit(1);
+} else {
+    console.log('PASS: ZoWallet is exported');
+}
+
+try {
+    const sdk = new ZoPassportSDK({ clientKey: 'test-key' });
+    console.log('PASS: ZoPassportSDK instantiated');
+
+    if (sdk.wallet && typeof sdk.wallet.getBalance === 'function') {
+        console.log('PASS: sdk.wallet.getBalance is available');
+    } else {
+        console.error('FAIL: sdk.wallet is missing or malformed');
+        process.exit(1);
+    }
+} catch (e) {
+    console.error('FAIL: Error instantiating SDK:', e);
+    process.exit(1);
+}
+
+console.log('\n--- Verifying React Exports ---');
+
+// Now require React exports with mocks in place
+const ReactExports = require('../dist/react.js');
+
+const expectedComponents = [
+    'WalletScreen',
+    'WalletCard',
+    'TransactionList',
+    'TransactionItem',
+    'ZoToken'
+];
+
+let missingComponents = [];
+expectedComponents.forEach(comp => {
+    if (ReactExports[comp]) {
+        console.log(`PASS: ${comp} is exported`);
+    } else {
+        console.error(`FAIL: ${comp} is missing`);
+        missingComponents.push(comp);
+    }
+});
+
+const expectedHooks = [
+    'useWallet',
+    'useWalletBalance',
+    'useTransactions'
+];
+
+expectedHooks.forEach(hook => {
+    if (ReactExports[hook]) {
+        console.log(`PASS: ${hook} is exported`);
+    } else {
+        console.error(`FAIL: ${hook} is missing`);
+        missingComponents.push(hook);
+    }
+});
+
+if (missingComponents.length > 0) {
+    console.error('Some React exports are missing!');
+    process.exit(1);
+}
+
+console.log('\nSUCCESS: All verification checks passed!');