@explorins/pers-sdk 1.3.16 → 1.6.0

package/dist/managers/tenant-manager.d.ts

@@ -0,0 +1,60 @@
+import { PersApiClient } from '../core/pers-api-client';
+import { TenantSDK } from '../tenant';
+import type { TenantPublicDTO, TenantClientConfigDTO, AdminDTO } from '../shared/interfaces/pers-shared-lib.interfaces';
+import type { AdminCreateRequestDTO } from '../tenant/models';
+/**
+ * Tenant Manager - Clean, high-level interface for tenant operations
+ *
+ * Provides a simplified API for common tenant management tasks while maintaining
+ * access to the full tenant SDK for advanced use cases.
+ */
+export declare class TenantManager {
+    private apiClient;
+    private tenantSDK;
+    constructor(apiClient: PersApiClient);
+    /**
+     * Get current tenant information
+     *
+     * @returns Promise resolving to tenant data
+     */
+    getTenantInfo(): Promise<TenantPublicDTO>;
+    /**
+     * Get tenant login token
+     *
+     * @returns Promise resolving to login token
+     */
+    getLoginToken(): Promise<string>;
+    /**
+     * Get tenant client configuration
+     *
+     * @returns Promise resolving to client config
+     */
+    getClientConfig(): Promise<TenantClientConfigDTO>;
+    /**
+     * Admin: Update tenant data
+     *
+     * @param tenantData - Updated tenant data
+     * @returns Promise resolving to updated tenant
+     */
+    updateTenant(tenantData: TenantPublicDTO): Promise<TenantPublicDTO>;
+    /**
+     * Admin: Get all admins
+     *
+     * @returns Promise resolving to array of admins
+     */
+    getAdmins(): Promise<AdminDTO[]>;
+    /**
+     * Admin: Create new admin
+     *
+     * @param adminData - Admin data
+     * @returns Promise resolving to created admin
+     */
+    createAdmin(adminData: AdminCreateRequestDTO): Promise<AdminDTO>;
+    /**
+     * Get the full tenant SDK for advanced operations
+     *
+     * @returns TenantSDK instance
+     */
+    getTenantSDK(): TenantSDK;
+}
+//# sourceMappingURL=tenant-manager.d.ts.map

package/dist/managers/tenant-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-manager.d.ts","sourceRoot":"","sources":["../../src/managers/tenant-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAmB,SAAS,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,KAAK,EAEV,eAAe,EACf,qBAAqB,EACrB,QAAQ,EACT,MAAM,iDAAiD,CAAC;AACzD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE9D;;;;;GAKG;AACH,qBAAa,aAAa;IAGZ,OAAO,CAAC,SAAS;IAF7B,OAAO,CAAC,SAAS,CAAY;gBAET,SAAS,EAAE,aAAa;IAI5C;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,eAAe,CAAC;IAI/C;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAItC;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAIvD;;;;;OAKG;IACG,YAAY,CAAC,UAAU,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAIzE;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAItC;;;;;OAKG;IACG,WAAW,CAAC,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAItE;;;;OAIG;IACH,YAAY,IAAI,SAAS;CAG1B"}

package/dist/managers/token-manager.d.ts

@@ -0,0 +1,81 @@
+import { PersApiClient } from '../core/pers-api-client';
+import { TokenSDK } from '../token';
+import type { TokenDTO } from '../shared/interfaces/pers-shared-lib.interfaces';
+/**
+ * Token Manager - Clean, high-level interface for token operations
+ *
+ * Provides a simplified API for common token management tasks while maintaining
+ * access to the full token SDK for advanced use cases.
+ */
+export declare class TokenManager {
+    private apiClient;
+    private tokenSDK;
+    constructor(apiClient: PersApiClient);
+    /**
+     * Get all available tokens
+     *
+     * @returns Promise resolving to array of tokens
+     */
+    getTokens(): Promise<TokenDTO[]>;
+    /**
+     * Get all token types
+     *
+     * @returns Promise resolving to token types
+     */
+    getTokenTypes(): Promise<import("@explorins/pers-shared").TokenTypeDTO[]>;
+    /**
+     * Get active credit token
+     *
+     * @returns Promise resolving to active credit token
+     */
+    getActiveCreditToken(): Promise<TokenDTO>;
+    /**
+     * Get reward tokens
+     *
+     * @returns Promise resolving to reward tokens
+     */
+    getRewardTokens(): Promise<TokenDTO[]>;
+    /**
+     * Get status tokens
+     *
+     * @returns Promise resolving to status tokens
+     */
+    getStatusTokens(): Promise<TokenDTO[]>;
+    /**
+     * Get token by contract address
+     *
+     * @param contractAddress - Contract address to search for
+     * @param contractTokenId - Optional contract token ID
+     * @returns Promise resolving to token
+     */
+    getTokenByContract(contractAddress: string, contractTokenId?: string | null): Promise<TokenDTO>;
+    /**
+     * Admin: Create new token
+     *
+     * @param tokenData - Token creation data
+     * @returns Promise resolving to created token
+     */
+    createToken(tokenData: any): Promise<TokenDTO>;
+    /**
+     * Admin: Update token
+     *
+     * @param tokenId - Token ID to update
+     * @param tokenData - Token update data
+     * @returns Promise resolving to updated token
+     */
+    updateToken(tokenId: string, tokenData: any): Promise<TokenDTO>;
+    /**
+     * Admin: Toggle token active status
+     *
+     * @param tokenId - Token ID to toggle
+     * @returns Promise resolving to updated token
+     */
+    toggleTokenActive(tokenId: string): Promise<TokenDTO>;
+    /**
+     * Get the full token SDK for advanced operations
+     *
+     * @returns TokenSDK instance
+     */
+    getTokenSDK(): TokenSDK;
+}
+//# sourceMappingURL=token-manager.d.ts.map

package/dist/managers/token-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-manager.d.ts","sourceRoot":"","sources":["../../src/managers/token-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iDAAiD,CAAC;AAEhF;;;;;GAKG;AACH,qBAAa,YAAY;IAGX,OAAO,CAAC,SAAS;IAF7B,OAAO,CAAC,QAAQ,CAAW;gBAEP,SAAS,EAAE,aAAa;IAI5C;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAItC;;;;OAIG;IACG,aAAa;IAInB;;;;OAIG;IACG,oBAAoB,IAAI,OAAO,CAAC,QAAQ,CAAC;IAI/C;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAI5C;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAI5C;;;;;;OAMG;IACG,kBAAkB,CAAC,eAAe,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIrG;;;;;OAKG;IACG,WAAW,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIpD;;;;;;OAMG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIrE;;;;;OAKG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI3D;;;;OAIG;IACH,WAAW,IAAI,QAAQ;CAKxB"}

package/dist/managers/transaction-manager.d.ts

@@ -0,0 +1,62 @@
+import { PersApiClient } from '../core/pers-api-client';
+import { TransactionSDK } from '../transaction';
+import type { TransactionDTO, TransactionRequestDTO } from '../shared/interfaces/pers-shared-lib.interfaces';
+import type { TransactionPaginationParams } from '../transaction/models';
+/**
+ * Transaction Manager - Clean, high-level interface for transaction operations
+ *
+ * Provides a simplified API for common transaction management tasks while maintaining
+ * access to the full transaction SDK for advanced use cases.
+ */
+export declare class TransactionManager {
+    private apiClient;
+    private transactionSDK;
+    constructor(apiClient: PersApiClient);
+    /**
+     * Get transaction by ID
+     *
+     * @param transactionId - ID of the transaction
+     * @returns Promise resolving to transaction data
+     */
+    getTransactionById(transactionId: string): Promise<TransactionDTO>;
+    /**
+     * Create a new transaction
+     *
+     * @param transactionData - Transaction data
+     * @returns Promise resolving to transaction response
+     */
+    createTransaction(transactionData: TransactionRequestDTO): Promise<import("@explorins/pers-shared").TransactionRequestResponseDTO>;
+    /**
+     * Get user's transaction history
+     *
+     * @param type - Transaction type filter
+     * @returns Promise resolving to array of user's transactions
+     */
+    getUserTransactionHistory(type: string): Promise<TransactionDTO[]>;
+    /**
+     * Admin: Get all tenant transactions
+     *
+     * @returns Promise resolving to array of tenant transactions
+     */
+    getTenantTransactions(): Promise<TransactionDTO[]>;
+    /**
+     * Admin: Get paginated transactions
+     *
+     * @param params - Pagination parameters
+     * @returns Promise resolving to paginated transaction results
+     */
+    getPaginatedTransactions(params: TransactionPaginationParams): Promise<import("..").TransactionPaginationResponse>;
+    /**
+     * Admin: Export transactions as CSV
+     *
+     * @returns Promise resolving to CSV blob
+     */
+    exportTransactionsCSV(): Promise<Blob>;
+    /**
+     * Get the full transaction SDK for advanced operations
+     *
+     * @returns TransactionSDK instance
+     */
+    getTransactionSDK(): TransactionSDK;
+}
+//# sourceMappingURL=transaction-manager.d.ts.map

package/dist/managers/transaction-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-manager.d.ts","sourceRoot":"","sources":["../../src/managers/transaction-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAwB,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACtB,MAAM,iDAAiD,CAAC;AACzD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAEzE;;;;;GAKG;AACH,qBAAa,kBAAkB;IAGjB,OAAO,CAAC,SAAS;IAF7B,OAAO,CAAC,cAAc,CAAiB;gBAEnB,SAAS,EAAE,aAAa;IAI5C;;;;;OAKG;IACG,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAIxE;;;;;OAKG;IACG,iBAAiB,CAAC,eAAe,EAAE,qBAAqB;IAI9D;;;;;OAKG;IACG,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAIxE;;;;OAIG;IACG,qBAAqB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAIxD;;;;;OAKG;IACG,wBAAwB,CAAC,MAAM,EAAE,2BAA2B;IAIlE;;;;OAIG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;;;OAIG;IACH,iBAAiB,IAAI,cAAc;CAGpC"}

package/dist/managers/user-manager.d.ts

@@ -0,0 +1,72 @@
+import { PersApiClient } from '../core/pers-api-client';
+import { UserPublicProfileDTO, UserSDK } from '../user';
+import type { UserDTO, UserCreateRequestDTO } from '../shared/interfaces/pers-shared-lib.interfaces';
+/**
+ * User Manager - Clean, high-level interface for user operations
+ *
+ * Provides a simplified API for common user management tasks while maintaining
+ * access to the full user SDK for advanced use cases.
+ */
+export declare class UserManager {
+    private apiClient;
+    private userSDK;
+    constructor(apiClient: PersApiClient);
+    /**
+     * Get current user profile
+     *
+     * @returns Promise resolving to current user data
+     */
+    getCurrentUser(): Promise<UserDTO>;
+    /**
+     * Update current user profile
+     *
+     * @param userData - User data to update
+     * @returns Promise resolving to updated user data
+     */
+    updateCurrentUser(userData: UserCreateRequestDTO): Promise<UserDTO>;
+    /**
+     * Get user by unique identifier
+     *
+     * @param identifier - Unique identifier for the user
+     * @returns Promise resolving to user data
+     */
+    getUserById(identifier: string): Promise<UserDTO>;
+    /**
+     * Get all users public profiles with optional filtering
+     *
+     * @param filter - Optional filter criteria
+     * @returns Promise resolving to array of user public profiles
+     */
+    getAllUsersPublic(filter?: {
+        key: string;
+        value: string;
+    }): Promise<UserPublicProfileDTO[]>;
+    /**
+     * Admin: Get all users
+     *
+     * @returns Promise resolving to array of all users
+     */
+    getAllUsers(): Promise<UserDTO[]>;
+    /**
+     * Admin: Update user data
+     *
+     * @param userId - ID of user to update
+     * @param userData - User data to update
+     * @returns Promise resolving to updated user data
+     */
+    updateUser(userId: string, userData: UserCreateRequestDTO): Promise<UserDTO>;
+    /**
+     * Admin: Toggle user active status
+     *
+     * @param user - User to toggle status for
+     * @returns Promise resolving to updated user data
+     */
+    toggleUserStatus(user: UserDTO): Promise<UserDTO>;
+    /**
+     * Get the full user SDK for advanced operations
+     *
+     * @returns UserSDK instance
+     */
+    getUserSDK(): UserSDK;
+}
+//# sourceMappingURL=user-manager.d.ts.map

package/dist/managers/user-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-manager.d.ts","sourceRoot":"","sources":["../../src/managers/user-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAiB,oBAAoB,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvE,OAAO,KAAK,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AAErG;;;;;GAKG;AACH,qBAAa,WAAW;IAGV,OAAO,CAAC,SAAS;IAF7B,OAAO,CAAC,OAAO,CAAU;gBAEL,SAAS,EAAE,aAAa;IAI5C;;;;OAIG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAIxC;;;;;OAKG;IACG,iBAAiB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAIzE;;;;;OAKG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvD;;;;;OAKG;IACG,iBAAiB,CAAC,MAAM,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAIjG;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAIvC;;;;;;OAMG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlF;;;;;OAKG;IACG,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvD;;;;OAIG;IACH,UAAU,IAAI,OAAO;CAKtB"}

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@explorins/pers-sdk",
-  "version": "1.3.16",
+  "version": "1.6.0",
   "description": "Platform-agnostic SDK for PERS (Phygital Experience Rewards System) - Core business logic and API integration",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -99,6 +99,11 @@
       "types": "./dist/web3/index.d.ts",
       "import": "./dist/web3.js",
       "require": "./dist/web3.cjs"
+    },
+    "./platform-adapters": {
+      "types": "./dist/platform-adapters/index.d.ts",
+      "import": "./dist/platform-adapters.js",
+      "require": "./dist/platform-adapters.cjs"
     }
   },
   "scripts": {

package/dist/pers-sdk.d.ts

@@ -1,21 +1,172 @@
 /**
- * PERS SDK - Platform-agnostic TypeScript SDK for PERS API
+ * PERS SDK - Platform-agnostic TypeScript SDK with High-Level Managers
  *
- * Provides a simple wrapper around the core API client with
- * intelligent authentication and token management.
+ * ## Overview
+ *
+ * The PERS SDK provides a comprehensive interface for integrating with the PERS
+ * (Phygital Experience Rewards System) platform. It features a clean manager-based
+ * architecture that abstracts complex domain operations into intuitive high-level APIs.
+ *
+ * ## Architecture
+ *
+ * ```
+ * PersSDK
+ * ├── Domain Managers (Recommended)    // High-level, intuitive APIs
+ * │   ├── auth: AuthManager           // Authentication & user sessions
+ * │   ├── users: UserManager          // User profile management
+ * │   ├── tokens: TokenManager        // Token balances & transfers
+ * │   ├── businesses: BusinessManager // Business operations
+ * │   ├── campaigns: CampaignManager  // Marketing campaigns
+ * │   ├── redemptions: RedemptionManager // Reward redemptions
+ * │   ├── transactions: TransactionManager // Transaction history
+ * │   ├── purchases: PurchaseManager    // Purchase processing
+ * │   └── analytics: AnalyticsManager // Reporting & analytics
+ * ├── Domain SDKs (Advanced)          // Full-featured domain access
+ * │   ├── createBusinessSDK()
+ * │   ├── createCampaignSDK()
+ * │   └── TokenSDK, etc.
+ * └── Core API Client (Expert)        // Direct REST API access
+ *     └── api(): PersApiClient
+ * ```
+ *
+ * ## Usage Patterns
+ *
+ * ### 1. High-Level Manager Pattern (Recommended)
+ *
+ * ```typescript
+ * import { PersSDK } from '@explorins/pers-sdk';
+ * import { BrowserFetchClientAdapter } from '@explorins/pers-sdk/platform-adapters';
+ *
+ * const sdk = new PersSDK(new BrowserFetchClientAdapter(), {
+ *   environment: 'production',
+ *   apiProjectKey: 'your-project-key'
+ * });
+ *
+ * // Clean, intuitive manager interface
+ * const user = await sdk.auth.getCurrentUser();
+ * const campaigns = await sdk.campaigns.getActiveCampaigns();
+ * const balances = await sdk.tokens.getTokens();
+ * ```
+ *
+ * ### 2. Advanced Domain SDK Access
+ *
+ * ```typescript
+ * // Access full SDK capabilities when needed
+ * const campaignSDK = sdk.campaigns.getCampaignSDK();
+ * const advancedCampaignOps = await campaignSDK.api.createComplexCampaign(data);
+ * ```
+ *
+ * ### 3. Direct API Client Access
+ *
+ * ```typescript
+ * // For custom endpoints or advanced operations
+ * const apiClient = sdk.api();
+ * const customData = await apiClient.get('/custom-endpoint');
+ * ```
+ *
+ * ## Platform Integration
+ *
+ * The SDK provides pre-built adapters for common platforms:
+ *
+ * - **Angular**: `AngularHttpClientAdapter`
+ * - **Browser/React/Vue**: `BrowserFetchClientAdapter`
+ * - **Node.js**: `NodeHttpClientAdapter`
+ * - **Custom**: Implement `HttpClient` interface
+ *
+ * ## Features
+ *
+ * - ✅ **Type-safe**: Full TypeScript support with comprehensive type definitions
+ * - ✅ **Platform-agnostic**: Works in browsers, Node.js, React Native, and more
+ * - ✅ **Authentication**: Automatic token management and refresh
+ * - ✅ **Error handling**: Comprehensive error handling with typed exceptions
+ * - ✅ **Modular**: Import only the domains you need
+ * - ✅ **Manager pattern**: Clean, high-level APIs for common operations
+ * - ✅ **Backward compatible**: Maintains compatibility with existing integrations
+ * - ✅ **Tree-shakable**: Optimized for minimal bundle size
+ *
+ * @example Basic Setup
+ * ```typescript
+ * import { PersSDK } from '@explorins/pers-sdk';
+ * import { BrowserFetchClientAdapter } from '@explorins/pers-sdk/platform-adapters';
+ *
+ * const sdk = new PersSDK(new BrowserFetchClientAdapter(), {
+ *   environment: 'production',
+ *   apiProjectKey: 'your-project-key'
+ * });
+ * ```
+ *
+ * @example Authentication Flow
+ * ```typescript
+ * // Login with external JWT (Firebase, Auth0, etc.)
+ * await sdk.auth.loginWithToken(firebaseJWT, 'user');
+ *
+ * // Check authentication status
+ * if (await sdk.auth.isAuthenticated()) {
+ *   const user = await sdk.auth.getCurrentUser();
+ *   console.log('Welcome,', user.name);
+ * }
+ * ```
+ *
+ * @example Business Operations
+ * ```typescript
+ * // Get active businesses
+ * const businesses = await sdk.businesses.getActiveBusinesses();
+ *
+ * // Get business details
+ * const business = await sdk.businesses.getBusinessById(businessId);
+ *
+ * // Admin: Create new business
+ * const newBusiness = await sdk.businesses.createBusiness({
+ *   name: 'New Business',
+ *   location: 'City Center',
+ *   type: 'restaurant'
+ * });
+ * ```
+ *
+ * @example Campaign Management
+ * ```typescript
+ * // Get active campaigns
+ * const campaigns = await sdk.campaigns.getActiveCampaigns();
+ *
+ * // Claim a campaign
+ * await sdk.campaigns.claimCampaign({
+ *   campaignId: 'campaign-123',
+ *   metadata: { source: 'mobile-app' }
+ * });
+ *
+ * // Get user's claims
+ * const claims = await sdk.campaigns.getUserClaims();
+ * ```
+ *
+ * @example Token Operations
+ * ```typescript
+ * // Get user's token balances
+ * const tokens = await sdk.tokens.getTokens();
+ *
+ * // Transfer tokens between users
+ * await sdk.tokens.transferTokens({
+ *   fromUserId: 'user-1',
+ *   toUserId: 'user-2',
+ *   tokenType: 'CREDIT',
+ *   amount: 100
+ * });
+ * ```
+ *
+ * @since 1.3.0 - Manager pattern architecture
  */
 import { HttpClient } from './core/abstractions/http-client';
 import { PersConfig } from './core/pers-config';
 import { PersApiClient } from './core/pers-api-client';
+import { AuthManager, UserManager, TokenManager, BusinessManager, CampaignManager, RedemptionManager, TransactionManager, PurchaseManager, TenantManager, AnalyticsManager, DonationManager } from './managers';
 /**
- * Main PERS SDK class
+ * PERS SDK class with domain managers
  *
- * Minimal wrapper around PersApiClient providing a clean interface
- * for platform-specific implementations.
+ * Main SDK interface providing clean, high-level managers for common operations
+ * while maintaining full access to the underlying API client and domain SDKs.
  *
  * @example
  * ```typescript
- * import { createPersSDK, createAuthProvider } from '@explorins/pers-sdk/core';
+ * import { PersSDK, createAuthProvider } from '@explorins/pers-sdk/core';
  * import { BrowserHttpClient } from '@explorins/pers-sdk/browser';
  *
  * const authProvider = createAuthProvider({
@@ -28,12 +179,29 @@ import { PersApiClient } from './core/pers-api-client';
  *   authProvider
  * });
  *
+ * // High-level manager interface
+ * const user = await sdk.auth.getCurrentUser();
+ * const tokens = await sdk.tokens.getTokens();
+ * const businesses = await sdk.business.getActiveBusinesses();
+ *
+ * // Direct API access for advanced operations
  * const apiClient = sdk.api();
- * const user = await apiClient.get('/users/me');
+ * const customData = await apiClient.get('/custom-endpoint');
  * ```
  */
 export declare class PersSDK {
     private apiClient;
+    private _auth;
+    private _users;
+    private _tokens;
+    private _businesses;
+    private _campaigns;
+    private _redemptions;
+    private _transactions;
+    private _purchases;
+    private _tenants;
+    private _analytics;
+    private _donations;
     /**
      * Creates a new PERS SDK instance
      *
@@ -42,9 +210,126 @@ export declare class PersSDK {
      */
     constructor(httpClient: HttpClient, config: PersConfig);
     /**
-     * Gets the API client for making PERS API requests
+     * Authentication manager - High-level auth operations
+     *
+     * @example
+     * ```typescript
+     * await sdk.auth.loginWithToken(jwtToken);
+     * const user = await sdk.auth.getCurrentUser();
+     * const isAuth = await sdk.auth.isAuthenticated();
+     * ```
+     */
+    get auth(): AuthManager;
+    /**
+     * User manager - High-level user operations
+     *
+     * @example
+     * ```typescript
+     * const user = await sdk.user.getCurrentUser();
+     * await sdk.user.updateCurrentUser(userData);
+     * const users = await sdk.user.getAllUsersPublic();
+     * ```
+     */
+    get users(): UserManager;
+    /**
+     * Token manager - High-level token operations
+     *
+     * @example
+     * ```typescript
+     * const tokens = await sdk.tokens.getTokens();
+     * const creditToken = await sdk.tokens.getActiveCreditToken();
+     * const rewards = await sdk.tokens.getRewardTokens();
+     * ```
+     */
+    get tokens(): TokenManager;
+    /**
+     * Business manager - High-level business operations
+     *
+     * @example
+     * ```typescript
+     * const businesses = await sdk.business.getActiveBusinesses();
+     * const business = await sdk.business.getBusinessById(id);
+     * const types = await sdk.business.getBusinessTypes();
+     * ```
+     */
+    get businesses(): BusinessManager;
+    /**
+     * Campaign manager - High-level campaign operations
+     *
+     * @example
+     * ```typescript
+     * const campaigns = await sdk.campaigns.getActiveCampaigns();
+     * await sdk.campaigns.claimCampaign(claimData);
+     * const claims = await sdk.campaigns.getUserClaims();
+     * ```
+     */
+    get campaigns(): CampaignManager;
+    /**
+     * Redemption manager - High-level redemption operations
+     *
+     * @example
+     * ```typescript
+     * const redemptions = await sdk.redemptions.getActiveRedemptions();
+     * await sdk.redemptions.redeemOffer(redemptionId);
+     * const history = await sdk.redemptions.getUserRedemptions();
+     * ```
+     */
+    get redemptions(): RedemptionManager;
+    /**
+     * Transaction manager - High-level transaction operations
      *
-     * This is the main interface for interacting with the PERS backend.
+     * @example
+     * ```typescript
+     * const transaction = await sdk.transactions.getTransactionById(id);
+     * await sdk.transactions.createTransaction(txData);
+     * const history = await sdk.transactions.getUserTransactionHistory('all');
+     * ```
+     */
+    get transactions(): TransactionManager;
+    /**
+     * Purchase manager - High-level purchase operations
+     *
+     * @example
+     * ```typescript
+     * const intent = await sdk.purchases.createPaymentIntent(100, 'usd', 'email@example.com', 'Purchase');
+     * const tokens = await sdk.purchases.getActivePurchaseTokens();
+     * const purchases = await sdk.purchases.getAllUserPurchases();
+     * ```
+     */
+    get purchases(): PurchaseManager;
+    /**
+     * Tenant manager - High-level tenant operations
+     *
+     * @example
+     * ```typescript
+     * const tenant = await sdk.tenant.getTenantInfo();
+     * const config = await sdk.tenant.getClientConfig();
+     * const admins = await sdk.tenant.getAdmins();
+     * ```
+     */
+    get tenants(): TenantManager;
+    /**
+     * Analytics manager - High-level analytics operations
+     *
+     * @example
+     * ```typescript
+     * const analytics = await sdk.analytics.getTransactionAnalytics(request);
+     * ```
+     */
+    get analytics(): AnalyticsManager;
+    /**
+     * Donation manager - High-level donation operations
+     *
+     * @example
+     * ```typescript
+     * const types = await sdk.donations.getDonationTypes();
+     * ```
+     */
+    get donations(): DonationManager;
+    /**
+     * Gets the API client for direct PERS API requests
+     *
+     * Use this for advanced operations not covered by the managers.
      * The returned client handles authentication, token refresh, and error handling automatically.
      *
      * @returns Configured PersApiClient instance
@@ -52,8 +337,8 @@ export declare class PersSDK {
      * @example
      * ```typescript
      * const apiClient = sdk.api();
-     * const user = await apiClient.get<User>('/users/me');
-     * await apiClient.post('/users', userData);
+     * const customData = await apiClient.get<CustomType>('/custom-endpoint');
+     * await apiClient.post('/custom-endpoint', customData);
      * ```
      */
     api(): PersApiClient;
@@ -65,7 +350,11 @@ export declare class PersSDK {
     isProduction(): boolean;
 }
 /**
- * Simple factory function
+ * Factory function for creating PERS SDK
+ *
+ * @param httpClient Platform-specific HTTP client implementation
+ * @param config SDK configuration options
+ * @returns PERS SDK instance
  */
 export declare function createPersSDK(httpClient: HttpClient, config: PersConfig): PersSDK;
 //# sourceMappingURL=pers-sdk.d.ts.map

package/dist/pers-sdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pers-sdk.d.ts","sourceRoot":"","sources":["../src/pers-sdk.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,SAAS,CAAgB;IAEjC;;;;;OAKG;gBACS,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU;IAItD;;;;;;;;;;;;;;OAcG;IACH,GAAG,IAAI,aAAa;IAIpB;;;;OAIG;IACH,YAAY,IAAI,OAAO;CAGxB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,UAAU,GACjB,OAAO,CAET"}
+{"version":3,"file":"pers-sdk.d.ts","sourceRoot":"","sources":["../src/pers-sdk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2JG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EACL,WAAW,EACX,WAAW,EACX,YAAY,EACZ,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,UAAU,CAAkB;IAEpC;;;;;OAKG;gBACS,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU;IAiBtD;;;;;;;;;OASG;IACH,IAAI,IAAI,IAAI,WAAW,CAEtB;IAED;;;;;;;;;OASG;IACH,IAAI,KAAK,IAAI,WAAW,CAEvB;IAED;;;;;;;;;OASG;IACH,IAAI,MAAM,IAAI,YAAY,CAEzB;IAED;;;;;;;;;OASG;IACH,IAAI,UAAU,IAAI,eAAe,CAEhC;IAED;;;;;;;;;OASG;IACH,IAAI,SAAS,IAAI,eAAe,CAE/B;IAED;;;;;;;;;OASG;IACH,IAAI,WAAW,IAAI,iBAAiB,CAEnC;IAED;;;;;;;;;OASG;IACH,IAAI,YAAY,IAAI,kBAAkB,CAErC;IAED;;;;;;;;;OASG;IACH,IAAI,SAAS,IAAI,eAAe,CAE/B;IAED;;;;;;;;;OASG;IACH,IAAI,OAAO,IAAI,aAAa,CAE3B;IAED;;;;;;;OAOG;IACH,IAAI,SAAS,IAAI,gBAAgB,CAEhC;IAED;;;;;;;OAOG;IACH,IAAI,SAAS,IAAI,eAAe,CAE/B;IAED;;;;;;;;;;;;;;OAcG;IACH,GAAG,IAAI,aAAa;IAIpB;;;;OAIG;IACH,YAAY,IAAI,OAAO;CAGxB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,UAAU,GACjB,OAAO,CAET"}