@explorins/pers-sdk 1.1.0-beta.0 → 1.1.3

package/package.json

@@ -1,27 +1,117 @@
 {
   "name": "@explorins/pers-sdk",
-  "version": "1.1.0-beta.0",
-  "description": "Platform-agnostic SDK for PERS (Phygital Experience Rewards System)",
+  "version": "1.1.3",
+  "description": "Platform-agnostic SDK for PERS (Phygital Experience Rewards System) - Production Defaults",
   "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist/**/*"
+  ],
   "exports": {
     ".": {
-      "types": "./index.d.ts",
-      "import": "./index.esm.js",
-      "require": "./index.js"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
     },
-    "./core": {
-      "types": "./core.d.ts",
-      "import": "./core.esm.js",
-      "require": "./core.js"
+    "./analytics": {
+      "types": "./dist/analytics.d.ts",
+      "import": "./dist/analytics.js",
+      "require": "./dist/analytics.cjs"
+    },
+    "./auth-admin": {
+      "types": "./dist/auth-admin.d.ts",
+      "import": "./dist/auth-admin.js",
+      "require": "./dist/auth-admin.cjs"
     },
     "./business": {
-      "types": "./business/index.d.ts",
-      "import": "./business.esm.js",
-      "require": "./business.js"
+      "types": "./dist/business.d.ts",
+      "import": "./dist/business.js",
+      "require": "./dist/business.cjs"
+    },
+    "./campaign": {
+      "types": "./dist/campaign.d.ts",
+      "import": "./dist/campaign.js",
+      "require": "./dist/campaign.cjs"
+    },
+    "./core": {
+      "types": "./dist/core.d.ts",
+      "import": "./dist/core.js",
+      "require": "./dist/core.cjs"
+    },
+    "./donation": {
+      "types": "./dist/donation.d.ts",
+      "import": "./dist/donation.js",
+      "require": "./dist/donation.cjs"
+    },
+    "./payment": {
+      "types": "./dist/payment.d.ts",
+      "import": "./dist/payment.js",
+      "require": "./dist/payment.cjs"
+    },
+    "./redemption": {
+      "types": "./dist/redemption.d.ts",
+      "import": "./dist/redemption.js",
+      "require": "./dist/redemption.cjs"
+    },
+    "./tenant": {
+      "types": "./dist/tenant.d.ts",
+      "import": "./dist/tenant.js",
+      "require": "./dist/tenant.cjs"
+    },
+    "./token": {
+      "types": "./dist/token.d.ts",
+      "import": "./dist/token.js",
+      "require": "./dist/token.cjs"
+    },
+    "./transaction": {
+      "types": "./dist/transaction.d.ts",
+      "import": "./dist/transaction.js",
+      "require": "./dist/transaction.cjs"
+    },
+    "./user": {
+      "types": "./dist/user.d.ts",
+      "import": "./dist/user.js",
+      "require": "./dist/user.cjs"
+    },
+    "./user-status": {
+      "types": "./dist/user-status.d.ts",
+      "import": "./dist/user-status.js",
+      "require": "./dist/user-status.cjs"
+    },
+    "./web3-chain": {
+      "types": "./dist/web3-chain.d.ts",
+      "import": "./dist/web3-chain.js",
+      "require": "./dist/web3-chain.cjs"
+    },
+    "./web3": {
+      "types": "./dist/web3.d.ts",
+      "import": "./dist/web3.js",
+      "require": "./dist/web3.cjs"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "analytics": ["./dist/analytics.d.ts"],
+      "auth-admin": ["./dist/auth-admin.d.ts"],
+      "business": ["./dist/business.d.ts"],
+      "campaign": ["./dist/campaign.d.ts"],
+      "core": ["./dist/core.d.ts"],
+      "donation": ["./dist/donation.d.ts"],
+      "payment": ["./dist/payment.d.ts"],
+      "redemption": ["./dist/redemption.d.ts"],
+      "tenant": ["./dist/tenant.d.ts"],
+      "token": ["./dist/token.d.ts"],
+      "transaction": ["./dist/transaction.d.ts"],
+      "user": ["./dist/user.d.ts"],
+      "user-status": ["./dist/user-status.d.ts"],
+      "web3-chain": ["./dist/web3-chain.d.ts"],
+      "web3": ["./dist/web3.d.ts"]
     }
   },
   "scripts": {
-    "build": "rollup -c",
+    "build": "rollup -c && node scripts/copy-declarations.js",
     "build:watch": "rollup -c --watch",
     "clean": "rimraf dist",
     "test": "jest",
@@ -30,9 +120,6 @@
     "prepublishOnly": "npm run clean && npm run build",
     "publish": "npm publish"
   },
-  "dependencies": {
-    "@explorins/pers-shared": "*"
-  },
   "devDependencies": {
     "@rollup/plugin-typescript": "^11.1.6",
     "@types/jest": "^29.5.12",
@@ -43,7 +130,8 @@
     "typescript": "^5.4.5"
   },
   "peerDependencies": {
-    "@explorins/pers-shared": "*"
+    "@explorins/pers-shared": "*",
+    "jwt-decode": "^3.0.0 || ^4.0.0"
   },
   "publishConfig": {
     "access": "public",

package/rollup.config.js

@@ -1,84 +0,0 @@
-import typescript from '@rollup/plugin-typescript';
-import copy from 'rollup-plugin-copy';
-
-export default [
-  // Core entry point
-  {
-    input: 'src/core/core.ts',
-    output: [
-      {
-        file: 'dist/core.js',
-        format: 'cjs',
-        sourcemap: true
-      },
-      {
-        file: 'dist/core.esm.js',
-        format: 'esm',
-        sourcemap: true
-      }
-    ],
-    plugins: [
-      typescript({
-        tsconfig: './tsconfig.json',
-        declaration: true,
-        declarationDir: './dist'
-      })
-    ],
-    external: ['rxjs', 'rxjs/operators']
-  },
-  
-  // Business domain entry point
-  {
-    input: 'src/business/index.ts',
-    output: [
-      {
-        file: 'dist/business.js',
-        format: 'cjs',
-        sourcemap: true
-      },
-      {
-        file: 'dist/business.esm.js',
-        format: 'esm',
-        sourcemap: true
-      }
-    ],
-    plugins: [
-      typescript({
-        tsconfig: './tsconfig.json',
-        declaration: true,
-        declarationDir: './dist'
-      })
-    ],
-    external: ['@explorins/pers-shared', 'rxjs', 'rxjs/operators']
-  },
-  
-  // Main entry point (everything)
-  {
-    input: 'src/index.ts',
-    output: [
-      {
-        file: 'dist/index.js',
-        format: 'cjs',
-        sourcemap: true
-      },
-      {
-        file: 'dist/index.esm.js',
-        format: 'esm',
-        sourcemap: true
-      }
-    ],
-    plugins: [
-      typescript({
-        tsconfig: './tsconfig.json',
-        declaration: true,
-        declarationDir: './dist'
-      }),
-      copy({
-        targets: [
-          { src: 'package.json', dest: 'dist' }
-        ]
-      })
-    ],
-    external: ['@explorins/pers-shared', 'rxjs', 'rxjs/operators']
-  }
-];

package/src/business/api/business-api.ts

@@ -1,72 +0,0 @@
-import { PersApiClient } from '../../core/pers-api-client';
-import { BusinessDTO, BusinessTypeDTO, BusinessUpdateRequestDTO } from '@explorins/pers-shared';
-
-/**
- * Platform-Agnostic Business API Client
- * 
- * Focuses on non-admin business operations using the PERS backend.
- * Uses @explorins/pers-shared DTOs for consistency with backend.
- */
-export class BusinessApi {
-  constructor(private apiClient: PersApiClient) {}
-
-  /**
-   * Get all active businesses (public endpoint)
-   */
-  async getActiveBusinesses(): Promise<BusinessDTO[]> {
-    return this.apiClient.get<BusinessDTO[]>('/business');
-  }
-
-  /**
-   * Get all business types (public endpoint)
-   */
-  async getAllBusinessTypes(): Promise<BusinessTypeDTO[]> {
-    return this.apiClient.get<BusinessTypeDTO[]>('/business/type');
-  }
-
-  /**
-   * Get business by ID
-   */
-  async getBusinessById(businessId: string): Promise<BusinessDTO> {
-    return this.apiClient.get<BusinessDTO>(`/business/${businessId}`);
-  }
-
-  /**
-   * Get business by account address
-   */
-  async getBusinessByAccount(accountAddress: string): Promise<BusinessDTO> {
-    return this.apiClient.get<BusinessDTO>(`/business/account/${accountAddress}`);
-  }
-
-  // ==========================================
-  // ADMIN OPERATIONS
-  // ==========================================
-
-  /**
-   * ADMIN: Get all businesses (active and inactive)
-   */
-  async getAllBusinesses(): Promise<BusinessDTO[]> {
-    return this.apiClient.get<BusinessDTO[]>('/business/admin');
-  }
-
-  /**
-   * ADMIN: Create business by display name
-   */
-  async createBusinessByDisplayName(displayName: string): Promise<BusinessDTO> {
-    return this.apiClient.post<BusinessDTO>('/business/admin/', { displayName });
-  }
-
-  /**
-   * ADMIN: Update business
-   */
-  async updateBusiness(id: string, businessData: BusinessUpdateRequestDTO): Promise<BusinessDTO> {
-    return this.apiClient.put<BusinessDTO>(`/business/admin/${id}`, businessData);
-  }
-
-  /**
-   * ADMIN: Toggle business active status
-   */
-  async toggleBusinessActive(id: string, isActive: boolean): Promise<BusinessDTO> {
-    return this.apiClient.put<BusinessDTO>(`/business/admin/activate/${id}`, { isActive });
-  }
-}

package/src/business/business/tsconfig.json

@@ -1,18 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ESNext",
-    "moduleResolution": "node",
-    "esModuleInterop": true,
-    "allowSyntheticDefaultImports": true,
-    "strict": true,
-    "declaration": true,
-    "outDir": "dist",
-    "rootDir": "src",
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "lib": ["ES2022", "DOM"]
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist", "**/*.spec.ts", "**/*.test.ts"]
-}

package/src/business/index.ts

@@ -1,52 +0,0 @@
-/**
- * @explorins/pers-sdk-business
- * 
- * Platform-agnostic Business Domain SDK for PERS ecosystem
- * Focuses on non-admin business operations
- */
-
-// API Layer
-export { BusinessApi } from './api/business-api';
-
-// Service Layer  
-export { BusinessService } from './services/business-service';
-
-// Models & Types
-export * from './models';
-
-// Factory function for creating business SDK instance
-import { PersApiClient } from '../core/pers-api-client';
-import { BusinessApi } from './api/business-api';
-import { BusinessService } from './services/business-service';
-
-/**
- * Create a complete Business SDK instance
- * 
- * @param apiClient - Configured PERS API client
- * @returns Business SDK with flattened structure for better DX
- */
-export function createBusinessSDK(apiClient: PersApiClient) {
-  const businessApi = new BusinessApi(apiClient);
-  const businessService = new BusinessService(businessApi);
-  
-  return {
-    // Direct access to service methods (primary interface)
-    getActiveBusinesses: () => businessService.getActiveBusinesses(),
-    getAllBusinessTypes: () => businessService.getAllBusinessTypes(),
-    getBusinessById: (businessId: string) => businessService.getBusinessById(businessId),
-    getBusinessByAccount: (accountAddress: string) => businessService.getBusinessByAccount(accountAddress),
-    getBusinessesByType: (typeId: string) => businessService.getBusinessesByType(typeId),
-    
-    // Admin methods
-    getAllBusinesses: () => businessService.getAllBusinesses(),
-    createBusinessByDisplayName: (displayName: string) => businessService.createBusinessByDisplayName(displayName),
-    updateBusiness: (id: string, businessData: any) => businessService.updateBusiness(id, businessData),
-    toggleBusinessActive: (id: string, isActive: boolean) => businessService.toggleBusinessActive(id, isActive),
-    
-    // Advanced access for edge cases
-    api: businessApi,
-    service: businessService
-  };
-}
-
-export type BusinessSDK = ReturnType<typeof createBusinessSDK>;

package/src/business/services/business-service.ts

@@ -1,88 +0,0 @@
-import { BusinessApi } from '../api/business-api';
-import { 
-  BusinessDTO, 
-  BusinessTypeDTO,
-  BusinessUpdateRequestDTO
-} from '../models';
-
-/**
- * Platform-Agnostic Business Service
- * 
- * Contains business logic and operations that work across platforms.
- * No framework dependencies - pure TypeScript business logic.
- * 
- * Focuses only on actual backend capabilities.
- */
-export class BusinessService {
-  constructor(private businessApi: BusinessApi) {}
-
-  /**
-   * Get all active businesses
-   */
-  async getActiveBusinesses(): Promise<BusinessDTO[]> {
-    return this.businessApi.getActiveBusinesses();
-  }
-
-  /**
-   * Get all business types
-   */
-  async getAllBusinessTypes(): Promise<BusinessTypeDTO[]> {
-    return this.businessApi.getAllBusinessTypes();
-  }
-
-  /**
-   * Get business by ID
-   */
-  async getBusinessById(businessId: string): Promise<BusinessDTO> {
-    return this.businessApi.getBusinessById(businessId);
-  }
-
-  /**
-   * Get business by account address
-   */
-  async getBusinessByAccount(accountAddress: string): Promise<BusinessDTO> {
-    return this.businessApi.getBusinessByAccount(accountAddress);
-  }
-
-  /**
-   * Get businesses by type (client-side filtering)
-   */
-  async getBusinessesByType(typeId: string): Promise<BusinessDTO[]> {
-    const businesses = await this.getActiveBusinesses();
-    return businesses.filter(business => 
-      business.businessType && business.businessType.id === parseInt(typeId)
-    );
-  }
-
-  // ==========================================
-  // ADMIN OPERATIONS
-  // ==========================================
-
-  /**
-   * ADMIN: Get all businesses (active and inactive)
-   */
-  async getAllBusinesses(): Promise<BusinessDTO[]> {
-    return this.businessApi.getAllBusinesses();
-  }
-
-  /**
-   * ADMIN: Create business by display name
-   */
-  async createBusinessByDisplayName(displayName: string): Promise<BusinessDTO> {
-    return this.businessApi.createBusinessByDisplayName(displayName);
-  }
-
-  /**
-   * ADMIN: Update business
-   */
-  async updateBusiness(id: string, businessData: BusinessUpdateRequestDTO): Promise<BusinessDTO> {
-    return this.businessApi.updateBusiness(id, businessData);
-  }
-
-  /**
-   * ADMIN: Toggle business active status
-   */
-  async toggleBusinessActive(id: string, isActive: boolean): Promise<BusinessDTO> {
-    return this.businessApi.toggleBusinessActive(id, isActive);
-  }
-}

package/src/core/abstractions/core-interfaces.ts

@@ -1,56 +0,0 @@
-/**
- * Core SDK interfaces based on actual PERS Tourism Loyalty App patterns
- * These interfaces reflect the real DDD architecture with Lazy Facade pattern
- */
-
-// Core HTTP abstractions matching the app's ApiService patterns
-export interface CoreHttpClient {
-  get<T>(url: string, options?: any): Observable<T>;
-  post<T>(url: string, body: any, options?: any): Observable<T>;
-  put<T>(url: string, body: any, options?: any): Observable<T>;
-  delete<T>(url: string, options?: any): Observable<T>;
-}
-
-// Base facade interface reflecting the app's LazyClass pattern
-export interface CoreFacade {
-  [key: string]: any;
-}
-
-// Environment configuration interface based on LoyaltyEnvironment
-export interface CoreEnvironment {
-  production: boolean;
-  version: string;
-  apiVersion: string
-  apiRoot: string;
-  apiProjectKey?: string;
-}
-
-// State management interface reflecting the app's Signal-based patterns
-export interface CoreStateManager<T> {
-  state$: Observable<T>;
-  updateState(partialState: Partial<T>): void;
-  resetState(): void;
-}
-
-// Event system interface for cross-platform communication
-export interface CoreEventEmitter<T = any> {
-  emit(eventName: string, data?: T): void;
-  on(eventName: string, callback: (data?: T) => void): void;
-  off(eventName: string, callback?: (data?: T) => void): void;
-}
-
-// Service factory interface for platform-specific implementations
-export interface CoreServiceFactory {
-  createHttpClient(): CoreHttpClient;
-  createStateManager<T>(initialState: T): CoreStateManager<T>;
-  createEventEmitter<T>(): CoreEventEmitter<T>;
-}
-
-// Observable type for platform-agnostic reactive programming
-export interface Observable<T> {
-  subscribe(observer: {
-    next?: (value: T) => void;
-    error?: (error: any) => void;
-    complete?: () => void;
-  }): { unsubscribe(): void };
-}

package/src/core/abstractions/http-client.ts

@@ -1,23 +0,0 @@
-/**
- * Platform-agnostic HTTP client interface
- * To be implemented by platform-specific adapters (Angular, React Native, etc.)
- */
-
-export interface HttpClient {
-  get<T>(url: string, options?: RequestOptions): Promise<T>;
-  post<T>(url: string, body: any, options?: RequestOptions): Promise<T>;
-  put<T>(url: string, body: any, options?: RequestOptions): Promise<T>;
-  delete<T>(url: string, options?: RequestOptions): Promise<T>;
-}
-
-export interface RequestOptions {
-  headers?: Record<string, string>;
-  params?: Record<string, string>;
-  timeout?: number;
-}
-
-export interface HttpResponse<T> {
-  data: T;
-  status: number;
-  headers: Record<string, string>;
-}

package/src/core/auth/auth-provider.interface.ts

@@ -1,16 +0,0 @@
-export interface AuthProvider {
-  getToken(): Promise<string | null>;
-  getProjectKey(): Promise<string | null>;
-  authType: 'admin' | 'user' | 'firebase';
-  onTokenExpired?: () => Promise<void>;
-}
-
-export interface RequestOptions {
-  headers?: Record<string, string>;
-}
-
-// Export simple auth config for dev-friendly usage
-export * from './simple-auth-config.interface';
-
-// Export auth provider factory and helpers
-export * from './create-auth-provider';