zopassport 0.1.0

package/app/src/sdk/lib/types.ts

@@ -0,0 +1,205 @@
+// src/lib/types.ts
+// TypeScript types for Zo Passport SDK
+
+// =====================
+// User & Profile Types
+// =====================
+
+export interface ZoUser {
+  id: string;
+  first_name?: string;
+  last_name?: string;
+  bio?: string;
+  date_of_birth?: string;
+  place_name?: string;
+  body_type?: 'bro' | 'bae';
+  pfp_image?: string;
+  email_address?: string;
+  mobile_country_code?: string;
+  mobile_number?: string;
+  wallet_address?: string;
+  membership?: 'citizen' | 'founder';
+  cultures?: string[];
+  avatar?: {
+    status: 'pending' | 'processing' | 'completed' | 'failed';
+    image?: string;
+  };
+  role?: string;
+  created_at?: string;
+  updated_at?: string;
+}
+
+export interface ZoProfileResponse {
+  id: string;
+  first_name?: string;
+  last_name?: string;
+  bio?: string;
+  date_of_birth?: string;
+  location?: {
+    place_name?: string;
+    latitude?: number;
+    longitude?: number;
+  };
+  body_type?: 'bro' | 'bae';
+  pfp_image?: string;
+  email_address?: string;
+  mobile_country_code?: string;
+  mobile_number?: string;
+  wallet_address?: string;
+  zo_membership?: string;
+  cultures?: string[];
+  avatar?: {
+    status: 'pending' | 'processing' | 'completed' | 'failed';
+    image?: string;
+  };
+  founder_nfts?: any[];
+  founder_nfts_count?: number;
+  role?: string;
+}
+
+export interface ZoProfileUpdatePayload {
+  first_name?: string;
+  last_name?: string;
+  bio?: string;
+  date_of_birth?: string;
+  place_name?: string;
+  body_type?: 'bro' | 'bae';
+  pfp_image?: string;
+  cultures?: string[];
+}
+
+// =====================
+// Auth Types
+// =====================
+
+export interface ZoAuthOTPRequest {
+  mobile_country_code: string;
+  mobile_number: string;
+  message_channel: string;
+}
+
+export interface ZoAuthOTPVerifyRequest {
+  mobile_country_code: string;
+  mobile_number: string;
+  otp: string;
+}
+
+export interface ZoAuthResponse {
+  user: ZoUser;
+  access_token: string;
+  refresh_token: string;
+  access_token_expiry: string;
+  refresh_token_expiry: string;
+  device_id?: string;
+  device_secret?: string;
+}
+
+export interface ZoTokenRefreshResponse {
+  access: string;
+  refresh: string;
+  access_expiry: string;
+  refresh_expiry: string;
+}
+
+// =====================
+// Avatar Types
+// =====================
+
+export interface ZoAvatarGenerateRequest {
+  body_type: 'bro' | 'bae';
+}
+
+export interface ZoAvatarGenerateResponse {
+  task_id: string;
+  status: 'pending' | 'processing' | 'completed' | 'failed';
+}
+
+export interface ZoAvatarStatusResponse {
+  task_id: string;
+  status: 'pending' | 'processing' | 'completed' | 'failed';
+  result?: {
+    avatar_url?: string;
+  };
+}
+
+// =====================
+// Booking Types
+// =====================
+
+export interface ZoBooking {
+  id: string;
+  property_name?: string;
+  check_in_datetime?: string;
+  check_out_datetime?: string;
+  booking_status?: string;
+  created_at?: string;
+}
+
+export interface ZoTrip {
+  id: string;
+  title?: string;
+  start_date?: string;
+  end_date?: string;
+  status?: string;
+  created_at?: string;
+}
+
+// =====================
+// Error Types
+// =====================
+
+export interface ZoErrorResponse {
+  success?: boolean;
+  error?: string;
+  message?: string;
+  detail?: string;
+  errors?: string[];
+}
+
+// =====================
+// Component Props Types
+// =====================
+
+export interface ZoPassportProfile {
+  avatar?: string;
+  name?: string;
+  isFounder?: boolean;
+}
+
+export interface ZoPassportCompletion {
+  done: number;
+  total: number;
+}
+
+// =====================
+// Culture Types
+// =====================
+
+export const ZO_CULTURES = [
+  { id: 'travel', name: 'Travel & Adventure', icon: '/Cultural Stickers/Travel&Adventure.png' },
+  { id: 'design', name: 'Design', icon: '/Cultural Stickers/Design.png' },
+  { id: 'tech', name: 'Science & Technology', icon: '/Cultural Stickers/Science&Technology.png' },
+  { id: 'food', name: 'Food', icon: '/Cultural Stickers/Food.png' },
+  { id: 'music', name: 'Music & Entertainment', icon: '/Cultural Stickers/Music&Entertainment.png' },
+  { id: 'photography', name: 'Photography', icon: '/Cultural Stickers/Photography.png' },
+  { id: 'fitness', name: 'Health & Fitness', icon: '/Cultural Stickers/Health&Fitness.png' },
+  { id: 'sports', name: 'Sport', icon: '/Cultural Stickers/Sport.png' },
+  { id: 'literature', name: 'Literature & Stories', icon: '/Cultural Stickers/Literature&Stories.png' },
+  { id: 'cinema', name: 'Television & Cinema', icon: '/Cultural Stickers/Television&Cinema.png' },
+  { id: 'spiritual', name: 'Spiritual', icon: '/Cultural Stickers/Spiritual.png' },
+  { id: 'nature', name: 'Nature & Wildlife', icon: '/Cultural Stickers/Nature&Wildlife.png' },
+  { id: 'business', name: 'Business', icon: '/Cultural Stickers/Business.png' },
+  { id: 'law', name: 'Law', icon: '/Cultural Stickers/Law.png' },
+  { id: 'lifestyle', name: 'Home & Lifestyle', icon: '/Cultural Stickers/Home&Lifestyle.png' },
+  { id: 'gaming', name: 'Game', icon: '/Cultural Stickers/Game.png' },
+  { id: 'stories', name: 'Stories & Journal', icon: '/Cultural Stickers/Stories&Journal.png' },
+] as const;
+
+export type ZoCultureId = typeof ZO_CULTURES[number]['id'];
+
+// =====================
+// Wallet Types
+// =====================
+
+export * from './types/wallet';
+

package/app/src/sdk/lib/utils/index.ts

@@ -0,0 +1,6 @@
+// src/lib/utils/index.ts
+// Re-export all utilities
+
+export * from './storage';
+export * from './phone';
+

package/app/src/sdk/lib/utils/phone.ts

@@ -0,0 +1,71 @@
+// src/lib/utils/phone.ts
+// Phone number formatting utilities
+
+export const COUNTRY_CODES = [
+  { code: '1', country: 'US', flag: '🇺🇸', name: 'United States' },
+  { code: '91', country: 'IN', flag: '🇮🇳', name: 'India' },
+  { code: '44', country: 'GB', flag: '🇬🇧', name: 'United Kingdom' },
+  { code: '86', country: 'CN', flag: '🇨🇳', name: 'China' },
+  { code: '81', country: 'JP', flag: '🇯🇵', name: 'Japan' },
+  { code: '82', country: 'KR', flag: '🇰🇷', name: 'South Korea' },
+  { code: '33', country: 'FR', flag: '🇫🇷', name: 'France' },
+  { code: '49', country: 'DE', flag: '🇩🇪', name: 'Germany' },
+  { code: '7', country: 'RU', flag: '🇷🇺', name: 'Russia' },
+  { code: '55', country: 'BR', flag: '🇧🇷', name: 'Brazil' },
+  { code: '61', country: 'AU', flag: '🇦🇺', name: 'Australia' },
+  { code: '65', country: 'SG', flag: '🇸🇬', name: 'Singapore' },
+  { code: '971', country: 'AE', flag: '🇦🇪', name: 'UAE' },
+  { code: '966', country: 'SA', flag: '🇸🇦', name: 'Saudi Arabia' },
+  { code: '62', country: 'ID', flag: '🇮🇩', name: 'Indonesia' },
+  { code: '60', country: 'MY', flag: '🇲🇾', name: 'Malaysia' },
+  { code: '66', country: 'TH', flag: '🇹🇭', name: 'Thailand' },
+  { code: '84', country: 'VN', flag: '🇻🇳', name: 'Vietnam' },
+  { code: '63', country: 'PH', flag: '🇵🇭', name: 'Philippines' },
+  { code: '31', country: 'NL', flag: '🇳🇱', name: 'Netherlands' },
+] as const;
+
+/**
+ * Format phone number for display
+ * e.g., "5551234567" → "555-123-4567"
+ */
+export function formatPhoneNumber(phone: string): string {
+  const cleaned = phone.replace(/\D/g, '');
+  
+  if (cleaned.length === 10) {
+    return `${cleaned.slice(0, 3)}-${cleaned.slice(3, 6)}-${cleaned.slice(6)}`;
+  }
+  
+  return cleaned;
+}
+
+/**
+ * Parse phone number to clean digits only
+ * Removes all non-digit characters
+ */
+export function parsePhoneNumber(phone: string): string {
+  return phone.replace(/\D/g, '');
+}
+
+/**
+ * Validate phone number length
+ */
+export function isValidPhoneNumber(phone: string, countryCode: string): boolean {
+  const cleaned = parsePhoneNumber(phone);
+  
+  // Most countries use 10-digit numbers
+  // Some exceptions: UK (10-11), India (10), US (10)
+  if (countryCode === '91' || countryCode === '1') {
+    return cleaned.length === 10;
+  }
+  
+  // General validation: 8-15 digits
+  return cleaned.length >= 8 && cleaned.length <= 15;
+}
+
+/**
+ * Get country by code
+ */
+export function getCountryByCode(code: string) {
+  return COUNTRY_CODES.find(c => c.code === code);
+}
+

package/app/src/sdk/lib/utils/storage.ts

@@ -0,0 +1,116 @@
+// src/lib/utils/storage.ts
+// Storage adapters for token persistence
+
+/**
+ * Storage adapter interface
+ * Implement this to provide custom storage (e.g., AsyncStorage for React Native)
+ */
+export interface StorageAdapter {
+  getItem(key: string): Promise<string | null>;
+  setItem(key: string, value: string): Promise<void>;
+  removeItem(key: string): Promise<void>;
+}
+
+/**
+ * Storage keys used by the SDK
+ */
+export const STORAGE_KEYS = {
+  ACCESS_TOKEN: 'zo_access_token',
+  REFRESH_TOKEN: 'zo_refresh_token',
+  TOKEN_EXPIRY: 'zo_token_expiry',
+  REFRESH_EXPIRY: 'zo_refresh_expiry',
+  USER: 'zo_user',
+  CLIENT_DEVICE_ID: 'zo_device_id',
+  CLIENT_DEVICE_SECRET: 'zo_device_secret',
+  AVATAR_URL: 'zo_avatar_url',
+  NICKNAME: 'zo_nickname',
+  CITY: 'zo_city',
+  BODY_TYPE: 'zo_body_type',
+} as const;
+
+/**
+ * LocalStorage adapter for web browsers
+ */
+export class LocalStorageAdapter implements StorageAdapter {
+  async getItem(key: string): Promise<string | null> {
+    if (typeof window === 'undefined') return null;
+    try {
+      return localStorage.getItem(key);
+    } catch {
+      return null;
+    }
+  }
+
+  async setItem(key: string, value: string): Promise<void> {
+    if (typeof window === 'undefined') return;
+    try {
+      localStorage.setItem(key, value);
+    } catch {
+      // Silently fail (storage full, private mode, etc.)
+    }
+  }
+
+  async removeItem(key: string): Promise<void> {
+    if (typeof window === 'undefined') return;
+    try {
+      localStorage.removeItem(key);
+    } catch {
+      // Silently fail
+    }
+  }
+}
+
+/**
+ * AsyncStorage adapter for React Native
+ * Provide AsyncStorage from @react-native-async-storage/async-storage
+ */
+export class AsyncStorageAdapter implements StorageAdapter {
+  private storage: any;
+
+  constructor(asyncStorage: any) {
+    this.storage = asyncStorage;
+  }
+
+  async getItem(key: string): Promise<string | null> {
+    try {
+      return await this.storage.getItem(key);
+    } catch {
+      return null;
+    }
+  }
+
+  async setItem(key: string, value: string): Promise<void> {
+    try {
+      await this.storage.setItem(key, value);
+    } catch {
+      // Silently fail
+    }
+  }
+
+  async removeItem(key: string): Promise<void> {
+    try {
+      await this.storage.removeItem(key);
+    } catch {
+      // Silently fail
+    }
+  }
+}
+
+/**
+ * In-memory storage adapter (for SSR or testing)
+ */
+export class MemoryStorageAdapter implements StorageAdapter {
+  private store: Map<string, string> = new Map();
+
+  async getItem(key: string): Promise<string | null> {
+    return this.store.get(key) || null;
+  }
+
+  async setItem(key: string, value: string): Promise<void> {
+    this.store.set(key, value);
+  }
+
+  async removeItem(key: string): Promise<void> {
+    this.store.delete(key);
+  }
+}

package/app/src/sdk/lib/utils/wallet.ts

@@ -0,0 +1,73 @@
+// Wallet Formatting Utilities
+// Framework-agnostic pure functions for wallet data formatting
+
+/**
+ * Format balance number with commas
+ * @param balance - Raw balance number
+ * @returns Formatted string (e.g., "1,234.56")
+ */
+export const formatBalance = (balance: number): string => {
+    if (balance === 0) return '0';
+
+    const formatted = balance.toLocaleString('en-US', {
+        minimumFractionDigits: 0,
+        maximumFractionDigits: 2,
+    });
+
+    return formatted;
+};
+
+/**
+ * Format balance for short display
+ * @param balance - Raw balance number
+ * @returns Shortened string (e.g., "1.2K", "1.5M")
+ */
+export const formatBalanceShort = (balance: number): string => {
+    if (balance === 0) return '0';
+    if (balance < 1000) return formatBalance(balance);
+    if (balance < 1000000) return `${(balance / 1000).toFixed(1)}K`;
+    return `${(balance / 1000000).toFixed(1)}M`;
+};
+
+/**
+ * Format wallet address to short form
+ * @param address - Full wallet address
+ * @returns Shortened address (e.g., "0x12...34ab")
+ */
+export const formatWalletAddress = (address: string): string => {
+    if (!address || address.length < 8) return address;
+    return `${address.slice(0, 4)}...${address.slice(-4)}`;
+};
+
+/**
+ * Format nickname with @ prefix
+ * @param nickname - User nickname
+ * @returns Formatted nickname (e.g., "@john")
+ */
+export const formatNickname = (nickname: string): string => {
+    if (!nickname) return '';
+    return nickname.startsWith('@') ? nickname : `@${nickname}`;
+};
+
+/**
+ * Format transaction amount
+ * @param amount - Transaction amount
+ * @param action - deposit or spend
+ * @returns Formatted amount with +/- prefix
+ */
+export const formatTransactionAmount = (
+    amount: number,
+    action: 'deposit' | 'spend'
+): string => {
+    const formatted = formatBalance(amount);
+    return action === 'spend' ? `- ${formatted}` : `+ ${formatted}`;
+};
+
+/**
+ * Get transaction color
+ * @param action - deposit or spend
+ * @returns Color hex code
+ */
+export const getTransactionColor = (action: 'deposit' | 'spend'): string => {
+    return action === 'spend' ? '#FF4444' : '#00C853';
+};

package/app/src/sdk/types.ts

@@ -0,0 +1,205 @@
+// src/lib/types.ts
+// TypeScript types for Zo Passport SDK
+
+// =====================
+// User & Profile Types
+// =====================
+
+export interface ZoUser {
+  id: string;
+  first_name?: string;
+  last_name?: string;
+  bio?: string;
+  date_of_birth?: string;
+  place_name?: string;
+  body_type?: 'bro' | 'bae';
+  pfp_image?: string;
+  email_address?: string;
+  mobile_country_code?: string;
+  mobile_number?: string;
+  wallet_address?: string;
+  membership?: 'citizen' | 'founder';
+  cultures?: string[];
+  avatar?: {
+    status: 'pending' | 'processing' | 'completed' | 'failed';
+    image?: string;
+  };
+  role?: string;
+  created_at?: string;
+  updated_at?: string;
+}
+
+export interface ZoProfileResponse {
+  id: string;
+  first_name?: string;
+  last_name?: string;
+  bio?: string;
+  date_of_birth?: string;
+  location?: {
+    place_name?: string;
+    latitude?: number;
+    longitude?: number;
+  };
+  body_type?: 'bro' | 'bae';
+  pfp_image?: string;
+  email_address?: string;
+  mobile_country_code?: string;
+  mobile_number?: string;
+  wallet_address?: string;
+  zo_membership?: string;
+  cultures?: string[];
+  avatar?: {
+    status: 'pending' | 'processing' | 'completed' | 'failed';
+    image?: string;
+  };
+  founder_nfts?: any[];
+  founder_nfts_count?: number;
+  role?: string;
+}
+
+export interface ZoProfileUpdatePayload {
+  first_name?: string;
+  last_name?: string;
+  bio?: string;
+  date_of_birth?: string;
+  place_name?: string;
+  body_type?: 'bro' | 'bae';
+  pfp_image?: string;
+  cultures?: string[];
+}
+
+// =====================
+// Auth Types
+// =====================
+
+export interface ZoAuthOTPRequest {
+  mobile_country_code: string;
+  mobile_number: string;
+  message_channel: string;
+}
+
+export interface ZoAuthOTPVerifyRequest {
+  mobile_country_code: string;
+  mobile_number: string;
+  otp: string;
+}
+
+export interface ZoAuthResponse {
+  user: ZoUser;
+  access_token: string;
+  refresh_token: string;
+  access_token_expiry: string;
+  refresh_token_expiry: string;
+  device_id?: string;
+  device_secret?: string;
+}
+
+export interface ZoTokenRefreshResponse {
+  access: string;
+  refresh: string;
+  access_expiry: string;
+  refresh_expiry: string;
+}
+
+// =====================
+// Avatar Types
+// =====================
+
+export interface ZoAvatarGenerateRequest {
+  body_type: 'bro' | 'bae';
+}
+
+export interface ZoAvatarGenerateResponse {
+  task_id: string;
+  status: 'pending' | 'processing' | 'completed' | 'failed';
+}
+
+export interface ZoAvatarStatusResponse {
+  task_id: string;
+  status: 'pending' | 'processing' | 'completed' | 'failed';
+  result?: {
+    avatar_url?: string;
+  };
+}
+
+// =====================
+// Booking Types
+// =====================
+
+export interface ZoBooking {
+  id: string;
+  property_name?: string;
+  check_in_datetime?: string;
+  check_out_datetime?: string;
+  booking_status?: string;
+  created_at?: string;
+}
+
+export interface ZoTrip {
+  id: string;
+  title?: string;
+  start_date?: string;
+  end_date?: string;
+  status?: string;
+  created_at?: string;
+}
+
+// =====================
+// Error Types
+// =====================
+
+export interface ZoErrorResponse {
+  success?: boolean;
+  error?: string;
+  message?: string;
+  detail?: string;
+  errors?: string[];
+}
+
+// =====================
+// Component Props Types
+// =====================
+
+export interface ZoPassportProfile {
+  avatar?: string;
+  name?: string;
+  isFounder?: boolean;
+}
+
+export interface ZoPassportCompletion {
+  done: number;
+  total: number;
+}
+
+// =====================
+// Culture Types
+// =====================
+
+export const ZO_CULTURES = [
+  { id: 'travel', name: 'Travel & Adventure', icon: '/Cultural Stickers/Travel&Adventure.png' },
+  { id: 'design', name: 'Design', icon: '/Cultural Stickers/Design.png' },
+  { id: 'tech', name: 'Science & Technology', icon: '/Cultural Stickers/Science&Technology.png' },
+  { id: 'food', name: 'Food', icon: '/Cultural Stickers/Food.png' },
+  { id: 'music', name: 'Music & Entertainment', icon: '/Cultural Stickers/Music&Entertainment.png' },
+  { id: 'photography', name: 'Photography', icon: '/Cultural Stickers/Photography.png' },
+  { id: 'fitness', name: 'Health & Fitness', icon: '/Cultural Stickers/Health&Fitness.png' },
+  { id: 'sports', name: 'Sport', icon: '/Cultural Stickers/Sport.png' },
+  { id: 'literature', name: 'Literature & Stories', icon: '/Cultural Stickers/Literature&Stories.png' },
+  { id: 'cinema', name: 'Television & Cinema', icon: '/Cultural Stickers/Television&Cinema.png' },
+  { id: 'spiritual', name: 'Spiritual', icon: '/Cultural Stickers/Spiritual.png' },
+  { id: 'nature', name: 'Nature & Wildlife', icon: '/Cultural Stickers/Nature&Wildlife.png' },
+  { id: 'business', name: 'Business', icon: '/Cultural Stickers/Business.png' },
+  { id: 'law', name: 'Law', icon: '/Cultural Stickers/Law.png' },
+  { id: 'lifestyle', name: 'Home & Lifestyle', icon: '/Cultural Stickers/Home&Lifestyle.png' },
+  { id: 'gaming', name: 'Game', icon: '/Cultural Stickers/Game.png' },
+  { id: 'stories', name: 'Stories & Journal', icon: '/Cultural Stickers/Stories&Journal.png' },
+] as const;
+
+export type ZoCultureId = typeof ZO_CULTURES[number]['id'];
+
+// =====================
+// Wallet Types
+// =====================
+
+export * from './types/wallet';
+