@explorins/pers-sdk 1.6.4 → 1.6.6

package/README.md

@@ -3,16 +3,16 @@
 [![npm version](https://badge.fury.io/js/%40explorins%2Fpers-sdk.svg)](https://badge.fury.io/js/%40explorins%2Fpers-sdk)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-**Platform-agnostic TypeScript SDK for PERS (Phygital Experience Rewards System)** - Core SDK providing domain-driven business logic and API integration for tourism loyalty applications.
+**Platform-agnostic TypeScript SDK for PERS (Phygital Experience Rewards System)** - Modern Manager-Service architecture providing clean, consistent APIs for tourism loyalty applications.
 
-## 🚀 What's New in v1.3+
+## 🚀 What's New in v1.6.6+
 
-**✨ Enhanced Manager Pattern Architecture**
-- **High-level domain managers** for intuitive API access
-- **Platform adapters** for seamless integration  
-- **Clean separation** between managers and underlying SDKs
-- **Improved TypeScript support** with better type inference
-- **Backward compatibility** maintained for existing integrations
+**🎯 Complete Architecture Refactoring**
+- **Clean Manager Pattern**: All 15 domain managers use consistent Service-based architecture
+- **Legacy Pattern Removal**: Eliminated all factory functions for cleaner, predictable patterns  
+- **Performance Optimized**: 29% faster builds, reduced bundle size, internal token refresh
+- **Zero Breaking Changes**: Manager interface remains identical for seamless upgrades
+- **Enhanced Documentation**: Comprehensive guides with practical examples
 
 ## PERS Ecosystem
 
@@ -27,36 +27,40 @@ npm install @explorins/pers-sdk
 ## Platform Integration
 
 - **[@explorins/pers-sdk-angular](https://www.npmjs.com/package/@explorins/pers-sdk-angular)** - Angular dependency injection wrapper
-- **[@explorins/pers-sdk-react-native](https://www.npmjs.com/package/@explorins/pers-sdk-react-native)** - React Native providers and hooks
-- **Direct Integration** - Node.js, Vanilla JS, or custom frameworks
+- **[@explorins/pers-sdk-react-native](https://www.npmjs.com/package/@explorins/pers-sdk-react-native)** - React Native providers and hooks  
+- **Direct Integration** - Node.js, Vanilla JS, React, Vue, or custom frameworks
 
 ## 🏗️ Architecture Overview
 
 ```typescript
-PersSDK
-├── Domain Managers (High-level)    // Recommended for common operations
-│   ├── auth: AuthManager
-│   ├── users: UserManager  
-│   ├── tokens: TokenManager
-│   ├── businesses: BusinessManager
-│   ├── campaigns: CampaignManager
-│   ├── redemptions: RedemptionManager
-│   ├── transactions: TransactionManager
-│   ├── payments: PaymentManager
-│   └── analytics: AnalyticsManager
-├── Domain SDKs (Advanced)          // Full feature access
-│   ├── createBusinessSDK()
-│   ├── createCampaignSDK() 
-│   └── TokenSDK, etc.
-└── Core API Client                 // Direct API access
-    └── api(): PersApiClient
+PERS SDK v1.6.6 - Clean Manager Pattern Architecture
+├── 🎯 Manager Layer (Primary Interface)
+│   ├── auth: AuthManager           // Authentication & sessions
+│   ├── users: UserManager          // User profiles & management
+│   ├── tokens: TokenManager        // Token operations & balances
+│   ├── businesses: BusinessManager // Business operations
+│   ├── campaigns: CampaignManager  // Marketing campaigns
+│   ├── redemptions: RedemptionManager // Reward redemptions
+│   ├── transactions: TransactionManager // Transaction history
+│   ├── purchases: PurchaseManager    // Payment processing  
+│   ├── analytics: AnalyticsManager // Reporting & insights
+│   ├── tenants: TenantManager      // Multi-tenant config
+│   ├── donations: DonationManager  // Charitable giving
+│   ├── files: FileManager         // File operations
+│   └── web3: Web3Manager          // Blockchain operations
+├── ⚙️ Service Layer (Advanced Access)
+│   ├── Business logic & operations
+│   └── Direct service method access via getXService()
+└── 🚀 Core Infrastructure
+    ├── PersApiClient (HTTP + auth)
+    └── Platform adapters
 ```
 
-## Quick Start
+## ⚡ Quick Start
 
 ### 1. Choose Your Integration Method
 
-#### 🎯 **Recommended: Manager Pattern (High-level)**
+#### 🎯 **Recommended: Manager Pattern**
 
 ```typescript
 import { PersSDK } from '@explorins/pers-sdk';
@@ -73,15 +77,16 @@ const campaigns = await sdk.campaigns.getActiveCampaigns();
 const tokens = await sdk.tokens.getTokens();
 ```
 
-#### ⚙️ **Advanced: Direct SDK Access**
+#### ⚙️ **Advanced: Service Layer Access**
 
 ```typescript
-import { createBusinessSDK, createCampaignSDK } from '@explorins/pers-sdk';
-import { PersApiClient } from '@explorins/pers-sdk/core';
+// Access services directly for advanced operations
+const userService = sdk.users.getUserService();
+const campaignService = sdk.campaigns.getCampaignService();
 
-const apiClient = new PersApiClient(httpClient, config);
-const businessSDK = createBusinessSDK(apiClient);
-const campaignSDK = createCampaignSDK(apiClient);
+// Use service methods directly
+const advancedUserData = await userService.getSomeAdvancedMethod();
+const campaignMetrics = await campaignService.getDetailedCampaignMetrics();
 ```
 
 ### 2. Platform-Specific Setup
@@ -153,7 +158,7 @@ const sdk = new PersSDK(new NodeHttpClientAdapter(), {
 ```typescript
 // Login with external JWT (Firebase, Auth0, etc.)
 const authResult = await sdk.auth.loginWithToken(jwtToken, 'user');
-const adminResult = await sdk.auth.loginAdmin(adminJWT);
+const adminResult = await sdk.auth.loginWithToken(adminJWT, 'admin');
 
 // Check authentication status
 const isAuthenticated = await sdk.auth.isAuthenticated();
@@ -337,6 +342,10 @@ const apiClient = sdk.api();
 const customData = await apiClient.get<CustomType>('/custom-endpoint');
 await apiClient.post('/custom-endpoint', customData);
 
+// Direct authentication methods (advanced usage)
+const userSession = await apiClient.loginUser(firebaseJWT);
+const adminSession = await apiClient.loginAdmin(adminJWT);
+
 // Advanced auth operations
 const isExpired = await apiClient.isTokenExpired(120);
 const allExpired = await apiClient.areAllTokensExpired();
@@ -407,12 +416,29 @@ const sdk = new PersSDK(httpClient, config);
 const businesses = await sdk.businesses.getActiveBusinesses();
 ```
 
+### Authentication API Changes (v1.6+)
+
+**Manager API (Recommended):**
+```typescript
+// Unified authentication method
+const authResult = await sdk.auth.loginWithToken(jwtToken, 'user');
+const adminResult = await sdk.auth.loginWithToken(jwtToken, 'admin');
+```
+
+**Core API (Advanced):**
+```typescript
+// Separate methods still available for direct API access
+const userResult = await sdk.api().loginUser(jwtToken);
+const adminResult = await sdk.api().loginAdmin(jwtToken);
+```
+
 **Benefits:**
-- ✅ Cleaner API surface
+- ✅ Cleaner API surface at manager level
 - ✅ Better TypeScript inference
 - ✅ Consistent error handling  
 - ✅ Easier testing and mocking
 - ✅ Future-proof architecture
+- ✅ Backward compatibility maintained in core API
 
 ## 📊 Bundle Size
 

package/dist/analytics/index.d.ts

@@ -9,20 +9,4 @@ export { AnalyticsService } from './services/analytics-service';
 export * from './models';
 export * from '../shared/interfaces/pers-shared-lib.interfaces';
 export * from './models';
-import { PersApiClient } from '../core/pers-api-client';
-import { AnalyticsApi } from './api/analytics-api';
-import { TransactionAnalyticsRequestDTO } from './models';
-import { AnalyticsService } from './services/analytics-service';
-/**
- * Create a complete Analytics SDK instance
- *
- * @param apiClient - Configured PERS API client
- * @returns Analytics SDK with flattened structure for better DX
- */
-export declare function createAnalyticsSDK(apiClient: PersApiClient): {
-    getTransactionAnalytics: (request: TransactionAnalyticsRequestDTO) => Promise<import("./models").TransactionAnalyticsResponseDTO>;
-    api: AnalyticsApi;
-    service: AnalyticsService;
-};
-export type AnalyticsSDK = ReturnType<typeof createAnalyticsSDK>;
 //# sourceMappingURL=index.d.ts.map

package/dist/analytics/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAGhE,cAAc,UAAU,CAAC;AACzB,cAAc,iDAAiD,CAAC;AAMhE,cAAc,UAAU,CAAC;AAGzB,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,8BAA8B,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,aAAa;uCAQpB,8BAA8B;;;EAMpE;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAGhE,cAAc,UAAU,CAAC;AACzB,cAAc,iDAAiD,CAAC;AAMhE,cAAc,UAAU,CAAC"}

package/dist/analytics.cjs

@@ -1,82 +1,14 @@
 'use strict';
 
+var analyticsService = require('./chunks/analytics-service-CitlimKJ.cjs');
 var persShared = require('@explorins/pers-shared');
 
-/**
- * Platform-Agnostic Analytics API Client
- *
- * Handles analytics operations using the PERS backend.
- * Uses @explorins/pers-shared DTOs for consistency with backend.
- */
-class AnalyticsApi {
-    constructor(apiClient) {
-        this.apiClient = apiClient;
-    }
-    // ==========================================
-    // ADMIN OPERATIONS
-    // ==========================================
-    /**
-     * ADMIN: Get transaction analytics with filtering and aggregation
-     */
-    async getTransactionAnalytics(request) {
-        return this.apiClient.post('/transactions/analytics', request);
-    }
-}
 
-/**
- * Platform-Agnostic Analytics Service
- *
- * Contains analytics business logic and operations that work across platforms.
- * No framework dependencies - pure TypeScript business logic.
- *
- * Focuses only on actual backend capabilities.
- */
-class AnalyticsService {
-    constructor(analyticsApi) {
-        this.analyticsApi = analyticsApi;
-    }
-    // ==========================================
-    // ADMIN OPERATIONS
-    // ==========================================
-    /**
-     * ADMIN: Get transaction analytics with filtering and aggregation
-     */
-    async getTransactionAnalytics(request) {
-        return this.analyticsApi.getTransactionAnalytics(request);
-    }
-}
-
-/**
- * @explorins/pers-sdk-analytics
- *
- * Platform-agnostic Analytics Domain SDK for PERS ecosystem
- * Handles analytics operations and data aggregation
- */
-// API Layer
-/**
- * Create a complete Analytics SDK instance
- *
- * @param apiClient - Configured PERS API client
- * @returns Analytics SDK with flattened structure for better DX
- */
-function createAnalyticsSDK(apiClient) {
-    const analyticsApi = new AnalyticsApi(apiClient);
-    const analyticsService = new AnalyticsService(analyticsApi);
-    return {
-        // Direct access to service methods (primary interface)
-        // Admin methods
-        getTransactionAnalytics: (request) => analyticsService.getTransactionAnalytics(request),
-        // Advanced access for edge cases
-        api: analyticsApi,
-        service: analyticsService
-    };
-}
 
+exports.AnalyticsApi = analyticsService.AnalyticsApi;
+exports.AnalyticsService = analyticsService.AnalyticsService;
 Object.defineProperty(exports, "AccountOwnerType", {
-    enumerable: true,
-    get: function () { return persShared.AccountOwnerType; }
+	enumerable: true,
+	get: function () { return persShared.AccountOwnerType; }
 });
-exports.AnalyticsApi = AnalyticsApi;
-exports.AnalyticsService = AnalyticsService;
-exports.createAnalyticsSDK = createAnalyticsSDK;
 //# sourceMappingURL=analytics.cjs.map

package/dist/analytics.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"analytics.cjs","sources":["../src/analytics/api/analytics-api.ts","../src/analytics/services/analytics-service.ts","../src/analytics/index.ts"],"sourcesContent":[null,null,null],"names":[],"mappings":";;;;AAIA;;;;;AAKG;MACU,YAAY,CAAA;AACvB,IAAA,WAAA,CAAoB,SAAwB,EAAA;QAAxB,IAAA,CAAA,SAAS,GAAT,SAAS;IAAkB;;;;AAM/C;;AAEG;IACH,MAAM,uBAAuB,CAAC,OAAuC,EAAA;QACnE,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAkC,yBAAyB,EAAE,OAAO,CAAC;IACjG;AACD;;ACjBD;;;;;;;AAOG;MACU,gBAAgB,CAAA;AAC3B,IAAA,WAAA,CAAoB,YAA0B,EAAA;QAA1B,IAAA,CAAA,YAAY,GAAZ,YAAY;IAAiB;;;;AAMjD;;AAEG;IACH,MAAM,uBAAuB,CAAC,OAAuC,EAAA;QACnE,OAAO,IAAI,CAAC,YAAY,CAAC,uBAAuB,CAAC,OAAO,CAAC;IAC3D;AACD;;AC3BD;;;;;AAKG;AAEH;AAsBA;;;;;AAKG;AACG,SAAU,kBAAkB,CAAC,SAAwB,EAAA;AACzD,IAAA,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,SAAS,CAAC;AAChD,IAAA,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,YAAY,CAAC;IAE3D,OAAO;;;QAIL,uBAAuB,EAAE,CAAC,OAAuC,KAAK,gBAAgB,CAAC,uBAAuB,CAAC,OAAO,CAAC;;AAGvH,QAAA,GAAG,EAAE,YAAY;AACjB,QAAA,OAAO,EAAE;KACV;AACH;;;;;;;;;;"}
+{"version":3,"file":"analytics.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;"}

package/dist/analytics.js

@@ -1,74 +1,3 @@
+export { A as AnalyticsApi, a as AnalyticsService } from './chunks/analytics-service-CxyrOwel.js';
 export { AccountOwnerType } from '@explorins/pers-shared';
-
-/**
- * Platform-Agnostic Analytics API Client
- *
- * Handles analytics operations using the PERS backend.
- * Uses @explorins/pers-shared DTOs for consistency with backend.
- */
-class AnalyticsApi {
-    constructor(apiClient) {
-        this.apiClient = apiClient;
-    }
-    // ==========================================
-    // ADMIN OPERATIONS
-    // ==========================================
-    /**
-     * ADMIN: Get transaction analytics with filtering and aggregation
-     */
-    async getTransactionAnalytics(request) {
-        return this.apiClient.post('/transactions/analytics', request);
-    }
-}
-
-/**
- * Platform-Agnostic Analytics Service
- *
- * Contains analytics business logic and operations that work across platforms.
- * No framework dependencies - pure TypeScript business logic.
- *
- * Focuses only on actual backend capabilities.
- */
-class AnalyticsService {
-    constructor(analyticsApi) {
-        this.analyticsApi = analyticsApi;
-    }
-    // ==========================================
-    // ADMIN OPERATIONS
-    // ==========================================
-    /**
-     * ADMIN: Get transaction analytics with filtering and aggregation
-     */
-    async getTransactionAnalytics(request) {
-        return this.analyticsApi.getTransactionAnalytics(request);
-    }
-}
-
-/**
- * @explorins/pers-sdk-analytics
- *
- * Platform-agnostic Analytics Domain SDK for PERS ecosystem
- * Handles analytics operations and data aggregation
- */
-// API Layer
-/**
- * Create a complete Analytics SDK instance
- *
- * @param apiClient - Configured PERS API client
- * @returns Analytics SDK with flattened structure for better DX
- */
-function createAnalyticsSDK(apiClient) {
-    const analyticsApi = new AnalyticsApi(apiClient);
-    const analyticsService = new AnalyticsService(analyticsApi);
-    return {
-        // Direct access to service methods (primary interface)
-        // Admin methods
-        getTransactionAnalytics: (request) => analyticsService.getTransactionAnalytics(request),
-        // Advanced access for edge cases
-        api: analyticsApi,
-        service: analyticsService
-    };
-}
-
-export { AnalyticsApi, AnalyticsService, createAnalyticsSDK };
 //# sourceMappingURL=analytics.js.map

package/dist/analytics.js.map

@@ -1 +1 @@
-{"version":3,"file":"analytics.js","sources":["../src/analytics/api/analytics-api.ts","../src/analytics/services/analytics-service.ts","../src/analytics/index.ts"],"sourcesContent":[null,null,null],"names":[],"mappings":";;AAIA;;;;;AAKG;MACU,YAAY,CAAA;AACvB,IAAA,WAAA,CAAoB,SAAwB,EAAA;QAAxB,IAAA,CAAA,SAAS,GAAT,SAAS;IAAkB;;;;AAM/C;;AAEG;IACH,MAAM,uBAAuB,CAAC,OAAuC,EAAA;QACnE,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAkC,yBAAyB,EAAE,OAAO,CAAC;IACjG;AACD;;ACjBD;;;;;;;AAOG;MACU,gBAAgB,CAAA;AAC3B,IAAA,WAAA,CAAoB,YAA0B,EAAA;QAA1B,IAAA,CAAA,YAAY,GAAZ,YAAY;IAAiB;;;;AAMjD;;AAEG;IACH,MAAM,uBAAuB,CAAC,OAAuC,EAAA;QACnE,OAAO,IAAI,CAAC,YAAY,CAAC,uBAAuB,CAAC,OAAO,CAAC;IAC3D;AACD;;AC3BD;;;;;AAKG;AAEH;AAsBA;;;;;AAKG;AACG,SAAU,kBAAkB,CAAC,SAAwB,EAAA;AACzD,IAAA,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,SAAS,CAAC;AAChD,IAAA,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,YAAY,CAAC;IAE3D,OAAO;;;QAIL,uBAAuB,EAAE,CAAC,OAAuC,KAAK,gBAAgB,CAAC,uBAAuB,CAAC,OAAO,CAAC;;AAGvH,QAAA,GAAG,EAAE,YAAY;AACjB,QAAA,OAAO,EAAE;KACV;AACH;;;;"}
+{"version":3,"file":"analytics.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/business/index.d.ts

@@ -7,28 +7,4 @@
 export { BusinessApi } from './api/business-api';
 export { BusinessService } from './services/business-service';
 export * from '../shared/interfaces/pers-shared-lib.interfaces';
-import { BusinessUpdateRequestDTO, BusinessToggleActiveRequestDTO } from '../shared/interfaces/pers-shared-lib.interfaces';
-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 declare function createBusinessSDK(apiClient: PersApiClient): {
-    getActiveBusinesses: () => Promise<import("@explorins/pers-shared").BusinessDTO[]>;
-    getBusinessTypes: () => Promise<import("@explorins/pers-shared").BusinessTypeDTO[]>;
-    getBusinessById: (businessId: string) => Promise<import("@explorins/pers-shared").BusinessDTO>;
-    getBusinessByAccount: (accountAddress: string) => Promise<import("@explorins/pers-shared").BusinessDTO>;
-    getBusinessesByType: (typeId: string) => Promise<import("@explorins/pers-shared").BusinessDTO[]>;
-    getBusinesses: () => Promise<import("@explorins/pers-shared").BusinessDTO[]>;
-    createBusinessByDisplayName: (displayName: string) => Promise<import("@explorins/pers-shared").BusinessTokenBalancesDTO | import("@explorins/pers-shared").BusinessApiKeyDTO>;
-    updateBusiness: (id: string, businessData: BusinessUpdateRequestDTO) => Promise<import("@explorins/pers-shared").BusinessDTO>;
-    toggleBusinessActive: (id: string, dto: BusinessToggleActiveRequestDTO) => Promise<import("@explorins/pers-shared").BusinessDTO>;
-    api: BusinessApi;
-    service: BusinessService;
-};
-export type BusinessSDK = ReturnType<typeof createBusinessSDK>;
 //# sourceMappingURL=index.d.ts.map

package/dist/business/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/business/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAG9D,cAAc,iDAAiD,CAAC;AAEhE,OAAO,EAAE,wBAAwB,EAAE,8BAA8B,EAAE,MAAM,iDAAiD,CAAC;AAE3H,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,aAAa;;;kCAQxB,MAAM;2CACG,MAAM;kCACf,MAAM;;+CAIO,MAAM;yBAC5B,MAAM,gBAAgB,wBAAwB;+BACxC,MAAM,OAAO,8BAA8B;;;EAMzE;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/business/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAG9D,cAAc,iDAAiD,CAAC"}