@explorins/pers-sdk 1.6.4 → 1.6.9

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

@@ -1,41 +1,173 @@
 import { PersApiClient } from '../core/pers-api-client';
-import { UserPublicProfileDTO, UserSDK } from '../user';
+import { UserService } from '../user';
+import { UserPublicProfileDTO } from '../user/models';
 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.
+ * Provides a simplified API for common user management tasks including profile
+ * management, user lookup, and administrative operations. Maintains access to
+ * the full user SDK for advanced use cases.
+ *
+ * @group Managers
+ * @category User Management
+ *
+ * @example Basic User Operations
+ * ```typescript
+ * // Get current user
+ * const user = await sdk.users.getCurrentUser();
+ *
+ * // Update current user profile
+ * const updated = await sdk.users.updateCurrentUser({
+ *   name: 'New Name',
+ *   email: 'new@email.com'
+ * });
+ *
+ * // Get user by ID
+ * const specificUser = await sdk.users.getUserById('user-123');
+ * ```
+ *
+ * @example Public User Data
+ * ```typescript
+ * // Get all users' public profiles
+ * const publicProfiles = await sdk.users.getAllUsersPublic();
+ *
+ * // Get users with filter
+ * const filteredUsers = await sdk.users.getAllUsersPublic({
+ *   key: 'city',
+ *   value: 'New York'
+ * });
+ * ```
+ *
+ * @example Administrative Operations
+ * ```typescript
+ * // Admin: Get all users (full data)
+ * const allUsers = await sdk.users.getAllUsers();
+ *
+ * // Admin: Update any user
+ * const updated = await sdk.users.updateUser('user-123', {
+ *   name: 'Updated Name'
+ * });
+ *
+ * // Admin: Toggle user status
+ * await sdk.users.toggleUserStatus(user);
+ * ```
  */
 export declare class UserManager {
     private apiClient;
-    private userSDK;
+    private userService;
     constructor(apiClient: PersApiClient);
     /**
      * Get current user profile
      *
-     * @returns Promise resolving to current user data
+     * Retrieves the complete profile of the currently authenticated user.
+     * Requires valid authentication tokens.
+     *
+     * @returns Promise resolving to current user data with full profile information
+     * @throws {PersApiError} When user is not authenticated
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   const user = await sdk.users.getCurrentUser();
+     *   console.log('Current user:', user.name, user.email);
+     *   console.log('User ID:', user.id);
+     *   console.log('Registration date:', user.createdAt);
+     * } catch (error) {
+     *   console.log('User not authenticated');
+     * }
+     * ```
      */
     getCurrentUser(): Promise<UserDTO>;
     /**
      * Update current user profile
      *
-     * @param userData - User data to update
+     * Updates the profile information for the currently authenticated user.
+     * Only the provided fields will be updated; omitted fields remain unchanged.
+     *
+     * @param userData - User data to update (partial update supported)
      * @returns Promise resolving to updated user data
+     * @throws {PersApiError} When user is not authenticated or validation fails
+     *
+     * @example Basic Profile Update
+     * ```typescript
+     * const updated = await sdk.users.updateCurrentUser({
+     *   name: 'John Smith',
+     *   email: 'john.smith@example.com'
+     * });
+     * console.log('Profile updated:', updated.name);
+     * ```
+     *
+     * @example Partial Update
+     * ```typescript
+     * // Only update the name, keep other fields unchanged
+     * const updated = await sdk.users.updateCurrentUser({
+     *   name: 'New Display Name'
+     * });
+     * ```
      */
     updateCurrentUser(userData: UserCreateRequestDTO): Promise<UserDTO>;
     /**
      * Get user by unique identifier
      *
-     * @param identifier - Unique identifier for the user
+     * Retrieves a user's profile using their unique identifier. This method
+     * requires appropriate permissions (admin or specific access rights).
+     *
+     * @param identifier - Unique identifier for the user (user ID, email, etc.)
      * @returns Promise resolving to user data
+     * @throws {PersApiError} When user not found or insufficient permissions
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   const user = await sdk.users.getUserById('user-123');
+     *   console.log('Found user:', user.name);
+     * } catch (error) {
+     *   if (error.statusCode === 404) {
+     *     console.log('User not found');
+     *   } else if (error.statusCode === 403) {
+     *     console.log('Access denied');
+     *   }
+     * }
+     * ```
      */
     getUserById(identifier: string): Promise<UserDTO>;
     /**
      * Get all users public profiles with optional filtering
      *
-     * @param filter - Optional filter criteria
+     * Retrieves public profile information for all users. This data is limited
+     * to publicly viewable fields only (name, profile picture, etc.).
+     *
+     * @param filter - Optional filter criteria to narrow results
+     * @param filter.key - Field name to filter by
+     * @param filter.value - Value to match for the specified field
      * @returns Promise resolving to array of user public profiles
+     *
+     * @example Get All Public Profiles
+     * ```typescript
+     * const publicProfiles = await sdk.users.getAllUsersPublic();
+     * console.log(`Found ${publicProfiles.length} users`);
+     *
+     * publicProfiles.forEach(profile => {
+     *   console.log('User:', profile.name);
+     *   // Note: Only public fields are available
+     * });
+     * ```
+     *
+     * @example Filtered Search
+     * ```typescript
+     * // Get users from a specific city
+     * const cityUsers = await sdk.users.getAllUsersPublic({
+     *   key: 'city',
+     *   value: 'San Francisco'
+     * });
+     *
+     * // Get users with specific role
+     * const roleUsers = await sdk.users.getAllUsersPublic({
+     *   key: 'role',
+     *   value: 'premium'
+     * });
+     * ```
      */
     getAllUsersPublic(filter?: {
         key: string;
@@ -44,29 +176,99 @@ export declare class UserManager {
     /**
      * Admin: Get all users
      *
-     * @returns Promise resolving to array of all users
+     * Retrieves complete user data for all users in the system. This method
+     * requires administrator privileges and returns full user profiles including
+     * private information.
+     *
+     * @returns Promise resolving to array of all users with complete data
+     * @throws {PersApiError} When not authenticated as admin
+     *
+     * @example
+     * ```typescript
+     * // Admin operation - requires admin authentication
+     * try {
+     *   const allUsers = await sdk.users.getAllUsers();
+     *   console.log(`Total users: ${allUsers.length}`);
+     *
+     *   allUsers.forEach(user => {
+     *     console.log(`${user.name} - ${user.email} - Active: ${user.isActive}`);
+     *   });
+     * } catch (error) {
+     *   console.log('Admin access required');
+     * }
+     * ```
      */
     getAllUsers(): Promise<UserDTO[]>;
     /**
      * Admin: Update user data
      *
+     * Updates profile information for any user in the system. This method
+     * requires administrator privileges and can modify any user's profile.
+     *
      * @param userId - ID of user to update
-     * @param userData - User data to update
+     * @param userData - User data to update (partial update supported)
      * @returns Promise resolving to updated user data
+     * @throws {PersApiError} When not authenticated as admin or user not found
+     *
+     * @example
+     * ```typescript
+     * // Admin operation - update any user's profile
+     * try {
+     *   const updated = await sdk.users.updateUser('user-123', {
+     *     name: 'Updated Name',
+     *     isActive: true
+     *   });
+     *   console.log('User updated:', updated.name);
+     * } catch (error) {
+     *   console.log('Failed to update user:', error.message);
+     * }
+     * ```
      */
     updateUser(userId: string, userData: UserCreateRequestDTO): Promise<UserDTO>;
     /**
      * Admin: Toggle user active status
      *
-     * @param user - User to toggle status for
+     * Toggles the active/inactive status of a user account. This is typically
+     * used for account suspension or reactivation. Requires administrator privileges.
+     *
+     * @param user - User object to toggle status for
      * @returns Promise resolving to updated user data
+     * @throws {PersApiError} When not authenticated as admin
+     *
+     * @example Suspend User
+     * ```typescript
+     * // Admin operation - toggle user status
+     * try {
+     *   const user = await sdk.users.getUserById('problematic-user-123');
+     *   const updated = await sdk.users.toggleUserStatus(user);
+     *
+     *   if (updated.isActive) {
+     *     console.log('User account reactivated');
+     *   } else {
+     *     console.log('User account suspended');
+     *   }
+     * } catch (error) {
+     *   console.log('Failed to update user status');
+     * }
+     * ```
      */
     toggleUserStatus(user: UserDTO): Promise<UserDTO>;
     /**
-     * Get the full user SDK for advanced operations
+     * Get the user service for advanced operations
+     *
+     * Provides access to the complete UserService instance for advanced operations
+     * not covered by the high-level manager methods.
+     *
+     * @returns UserService instance with full API access
+     *
+     * @example Advanced Operations
+     * ```typescript
+     * const userService = sdk.users.getUserService();
      *
-     * @returns UserSDK instance
+     * // Access advanced user operations
+     * const advancedResult = await userService.someAdvancedMethod();
+     * ```
      */
-    getUserSDK(): UserSDK;
+    getUserService(): UserService;
 }
 //# sourceMappingURL=user-manager.d.ts.map

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

@@ -1 +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"}
+{"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,EAAW,WAAW,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AAErG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,qBAAa,WAAW;IAGV,OAAO,CAAC,SAAS;IAF7B,OAAO,CAAC,WAAW,CAAc;gBAEb,SAAS,EAAE,aAAa;IAK5C;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAIxC;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACG,iBAAiB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAIzE;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACG,iBAAiB,CAAC,MAAM,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAIjG;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAIvC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlF;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACG,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvD;;;;;;;;;;;;;;;OAeG;IACH,cAAc,IAAI,WAAW;CAI9B"}

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

@@ -1,5 +1,5 @@
 import { PersApiClient } from '../core/pers-api-client';
-import { Web3SDK } from '../web3';
+import { Web3ApplicationService } from '../web3';
 import type { TokenBalanceRequest, TokenCollectionRequest, TokenBalance, TokenCollection, TokenMetadata } from '../web3/application/web3-application.service';
 import type { ChainData } from '../web3-chain';
 /**
@@ -10,8 +10,8 @@ import type { ChainData } from '../web3-chain';
  */
 export declare class Web3Manager {
     private apiClient;
-    private web3SDK;
-    private web3ChainSDK;
+    private web3ApplicationService;
+    private web3ChainService;
     constructor(apiClient: PersApiClient);
     /**
      * Get token balance for a specific token
@@ -71,6 +71,6 @@ export declare class Web3Manager {
      *
      * @returns Web3SDK instance
      */
-    getWeb3SDK(): Web3SDK;
+    getWeb3ApplicationService(): Web3ApplicationService;
 }
 //# sourceMappingURL=web3-manager.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"web3-manager.d.ts","sourceRoot":"","sources":["../../src/managers/web3-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAiB,OAAO,EAA2B,MAAM,SAAS,CAAC;AAE1E,OAAO,KAAK,EACV,mBAAmB,EACnB,sBAAsB,EACtB,YAAY,EACZ,eAAe,EACf,aAAa,EACd,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;;GAKG;AACH,qBAAa,WAAW;IAIV,OAAO,CAAC,SAAS;IAH7B,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,YAAY,CAAwC;gBAExC,SAAS,EAAE,aAAa;IAK5C;;;;;OAKG;IACG,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC;IAI1E;;;;;OAKG;IACG,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAInF;;;;;OAKG;IACG,kBAAkB,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC;IAInF;;;;;;OAMG;IACG,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAInE;;;;;;OAMG;IACG,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAI/F;;;;;OAKG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAIlE;;;;;;;OAOG;IACG,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,GAAG,IAAI,GACrB,OAAO,CAAC,MAAM,CAAC;IASlB;;;;OAIG;IACH,UAAU,IAAI,OAAO;CAGtB"}
+{"version":3,"file":"web3-manager.d.ts","sourceRoot":"","sources":["../../src/managers/web3-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAyE,MAAM,SAAS,CAAC;AAExH,OAAO,KAAK,EACV,mBAAmB,EACnB,sBAAsB,EACtB,YAAY,EACZ,eAAe,EACf,aAAa,EACd,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;;GAKG;AACH,qBAAa,WAAW;IAIV,OAAO,CAAC,SAAS;IAH7B,OAAO,CAAC,sBAAsB,CAAyB;IACvD,OAAO,CAAC,gBAAgB,CAAmB;gBAEvB,SAAS,EAAE,aAAa;IAW5C;;;;;OAKG;IACG,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC;IAI1E;;;;;OAKG;IACG,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAInF;;;;;OAKG;IACG,kBAAkB,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC;IAInF;;;;;;OAMG;IACG,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAInE;;;;;;OAMG;IACG,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAI/F;;;;;OAKG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAIlE;;;;;;;OAOG;IACG,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,GAAG,IAAI,GACrB,OAAO,CAAC,MAAM,CAAC;IASlB;;;;OAIG;IACH,yBAAyB,IAAI,sBAAsB;CAGpD"}

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@explorins/pers-sdk",
-  "version": "1.6.4",
+  "version": "1.6.9",
   "description": "Platform-agnostic SDK for PERS (Phygital Experience Rewards System) - Core business logic and API integration",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -110,15 +110,19 @@
     "build": "rollup -c",
     "build:watch": "rollup -c --watch",
     "clean": "rimraf dist",
+    "docs": "typedoc",
+    "docs:dev": "typedoc --watch",
+    "docs:json": "typedoc --json docs/api.json",
+    "docs:serve": "npx http-server docs -p 8080",
     "test": "jest",
     "test:watch": "jest --watch",
     "lint": "eslint src/**/*.ts",
     "prepublishOnly": "npm run clean && npm run build",
-    "publish-version": "npm run clean && npm run build && npm version patch && npm publish"
+    "publish-version": "npm run clean && npm run build && npm version patch && npm publish",
+    "publish-with-docs": "npm run clean && npm run build && npm run docs && npm version patch && npm publish"
   },
   "dependencies": {
-    "@explorins/web3-ts": "^0.3.75",
-    "jwt-decode": "^4.0.0"
+    "@explorins/web3-ts": "^0.3.75"
   },
   "devDependencies": {
     "@explorins/pers-shared": "^2.1.40",
@@ -131,6 +135,8 @@
     "rimraf": "^5.0.5",
     "rollup": "^4.50.0",
     "rollup-plugin-copy": "^3.5.0",
+    "typedoc": "^0.25.13",
+    "typedoc-plugin-markdown": "^3.17.1",
     "typescript": "^5.4.5"
   },
   "peerDependencies": {

package/dist/payment/index.d.ts

@@ -12,25 +12,4 @@ export { PaymentService } from './services/payment-service';
 export * from './models';
 export * from '../shared/interfaces/pers-shared-lib.interfaces';
 export * from './models';
-import { PersApiClient } from '../core/pers-api-client';
-import { PaymentApi } from './api/payment-api';
-import { PurchaseCurrency } from './models';
-import { PaymentService } from './services/payment-service';
-/**
- * Create a complete Payment SDK instance
- *
- * @param apiClient - Configured PERS API client
- * @returns Payment SDK with flattened structure for better DX
- */
-export declare function createPaymentSDK(apiClient: PersApiClient): {
-    getActivePurchaseTokens: (active?: boolean) => Promise<import("@explorins/pers-shared").PurchaseTokenDTO[]>;
-    createPaymentIntent: (amount: number, currency: PurchaseCurrency, receiptEmail: string, description: string) => Promise<import("@explorins/pers-shared").PaymentIntentDTO>;
-    updatePaymentIntent: (paymentIntentId: string, amount: number, currency: PurchaseCurrency, receiptEmail: string, description: string) => Promise<import("@explorins/pers-shared").PaymentIntentDTO>;
-    cancelPaymentIntent: (paymentIntentId: string) => Promise<import("@explorins/pers-shared").PaymentIntentDTO>;
-    createPurchase: (paymentIntentId: string, amount: number, purchaseTokenId?: string, donationTypeId?: number, donationAccountAddress?: string) => Promise<import("@explorins/pers-shared").PurchaseDTO>;
-    getAllUserPurchases: () => Promise<import("@explorins/pers-shared").PurchaseDTO[]>;
-    api: PaymentApi;
-    service: PaymentService;
-};
-export type PaymentSDK = ReturnType<typeof createPaymentSDK>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/payment/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG5D,cAAc,UAAU,CAAC;AACzB,cAAc,iDAAiD,CAAC;AAGhE,cAAc,UAAU,CAAC;AAGzB,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,aAAa;uCAQlB,OAAO;kCAEZ,MAAM,YAAY,gBAAgB,gBAAgB,MAAM,eAAe,MAAM;2CAGpE,MAAM,UAAU,MAAM,YAAY,gBAAgB,gBAAgB,MAAM,eAAe,MAAM;2CAE7F,MAAM;sCAGX,MAAM,UAAU,MAAM,oBAAoB,MAAM,mBAAmB,MAAM,2BAA2B,MAAM;;;;EAQ/I;AAED,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/payment/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG5D,cAAc,UAAU,CAAC;AACzB,cAAc,iDAAiD,CAAC;AAGhE,cAAc,UAAU,CAAC"}

package/dist/payment.cjs

@@ -1,264 +1,14 @@
 'use strict';
 
+var paymentService = require('./chunks/payment-service-B4qx0qiE.cjs');
 var persShared = require('@explorins/pers-shared');
 
-/**
- * Platform-Agnostic Purchase API Client (RESTful Architecture)
- *
- * Handles purchase and payment operations using the PERS backend's new RESTful endpoints.
- * Uses @explorins/pers-shared DTOs for consistency with backend.
- *
- * Migration Status: Updated to match /purchases controller (replaces /purchase endpoints)
- *
- * Available Access Levels:
- * - PUBLIC: Project key authentication for catalog browsing and payment operations
- * - USER: Requires user authentication JWT (purchase creation, history access)
- * - ADMIN: Requires tenant admin privileges (not implemented in this client)
- *
- * Note: This SDK focuses on backend purchase operations only.
- * Payment provider integrations (Stripe, etc.) should remain in infrastructure layer.
- */
-class PurchaseApi {
-    constructor(apiClient) {
-        this.apiClient = apiClient;
-        this.basePath = '/purchases';
-    }
-    // ==========================================
-    // PUBLIC OPERATIONS (Project Key)
-    // ==========================================
-    /**
-     * PUBLIC: Get purchase tokens (Intelligent Access)
-     *
-     * RESTful endpoint: GET /purchases/tokens
-     * Replaces: GET /purchase/token
-     *
-     * INTELLIGENT ACCESS:
-     * - PUBLIC (Project Key): Returns active tokens only (active parameter ignored)
-     * - ADMIN (Tenant Admin JWT): Returns filtered results based on active parameter
-     */
-    async getPurchaseTokens(active) {
-        let url = `${this.basePath}/tokens`;
-        if (active !== undefined) {
-            url += `?active=${active}`;
-        }
-        return this.apiClient.get(url);
-    }
-    /**
-     * PUBLIC: Get donation types
-     *
-     * RESTful endpoint: GET /purchases/donation-types
-     * Replaces: GET /purchase/donation/type
-     */
-    async getDonationTypes() {
-        return this.apiClient.get(`${this.basePath}/donation-types`);
-    }
-    // ==========================================
-    // PAYMENT OPERATIONS (FINANCIAL - CRITICAL)
-    // ==========================================
-    /**
-     * PUBLIC: Create payment intent (FINANCIAL OPERATION)
-     *
-     * RESTful endpoint: POST /purchases/payment-intents
-     * Replaces: POST /purchase/payment-intent
-     *
-     * CRITICAL: Handles real money operations - tenant context required
-     */
-    async createPaymentIntent(amount, currency, receiptEmail, description) {
-        const body = {
-            amount,
-            currency,
-            receiptEmail,
-            description
-        };
-        return this.apiClient.post(`${this.basePath}/payment-intents`, body);
-    }
-    /**
-     * PUBLIC: Update payment intent (FINANCIAL OPERATION)
-     *
-     * RESTful endpoint: PUT /purchases/payment-intents/{paymentIntentId}
-     * Replaces: PUT /purchase/payment-intent/{paymentIntentId}
-     *
-     * CRITICAL: Handles real money operations - tenant context required
-     */
-    async updatePaymentIntent(paymentIntentId, amount, currency, receiptEmail, description) {
-        const body = {
-            amount,
-            currency,
-            receiptEmail,
-            description
-        };
-        return this.apiClient.put(`${this.basePath}/payment-intents/${paymentIntentId}`, body);
-    }
-    /**
-     * PUBLIC: Cancel payment intent (FINANCIAL OPERATION)
-     *
-     * RESTful endpoint: DELETE /purchases/payment-intents/{paymentIntentId}
-     * Replaces: DELETE /purchase/payment-intent/{paymentIntentId}
-     *
-     * CRITICAL: Handles real money operations - tenant context required
-     */
-    async cancelPaymentIntent(paymentIntentId) {
-        return this.apiClient.delete(`${this.basePath}/payment-intents/${paymentIntentId}`);
-    }
-    // ==========================================
-    // USER OPERATIONS (JWT + Project Key)
-    // ==========================================
-    /**
-     * USER: Create purchase (BUSINESS CRITICAL - FINANCIAL TRANSACTION)
-     *
-     * RESTful endpoint: POST /purchases
-     * Replaces: POST /purchase/auth
-     *
-     * USER-ONLY: Requires user authentication JWT for purchase creation
-     * CRITICAL: Real financial transaction with Stripe integration
-     */
-    async createUserPurchase(paymentIntentId, amount, purchaseTokenId, donationTypeId, donationAccountAddress) {
-        const body = {
-            quantity: amount,
-            purchaseTokenId: purchaseTokenId || '',
-            donationTypeId,
-            donationAccountAddress,
-            paymentIntentId
-        };
-        return this.apiClient.post(`${this.basePath}`, body);
-    }
-    /**
-     * USER: Get user purchase history
-     *
-     * RESTful endpoint: GET /purchases/me/history
-     * Replaces: GET /purchase/auth
-     *
-     * USER-ONLY: Get authenticated user's purchase history
-     * FINANCIAL RECORDS: User attribution critical for compliance
-     */
-    async getUserPurchaseHistory() {
-        return this.apiClient.get(`${this.basePath}/me/history`);
-    }
-    // ==========================================
-    // CONVENIENCE METHODS (Backward Compatibility)
-    // ==========================================
-    /**
-     * @deprecated Use getPurchaseTokens() instead
-     * Backward compatibility alias for getActivePurchaseTokens
-     */
-    async getActivePurchaseTokens(active = true) {
-        return this.getPurchaseTokens(active);
-    }
-    /**
-     * @deprecated Use createUserPurchase() instead
-     * Backward compatibility alias for createPurchase
-     */
-    async createPurchase(paymentIntentId, amount, purchaseTokenId, donationTypeId, donationAccountAddress) {
-        return this.createUserPurchase(paymentIntentId, amount, purchaseTokenId, donationTypeId, donationAccountAddress);
-    }
-    /**
-     * @deprecated Use getUserPurchaseHistory() instead
-     * Backward compatibility alias for getAllUserPurchases
-     */
-    async getAllUserPurchases() {
-        return this.getUserPurchaseHistory();
-    }
-}
 
-/**
- * Platform-Agnostic Payment Service
- *
- * Contains payment business logic and operations that work across platforms.
- * No framework dependencies - pure TypeScript business logic.
- *
- * Focuses only on actual backend capabilities.
- * Payment provider logic (Stripe, etc.) should remain in infrastructure layer.
- */
-class PaymentService {
-    constructor(paymentApi) {
-        this.paymentApi = paymentApi;
-    }
-    // ==========================================
-    // PUBLIC OPERATIONS
-    // ==========================================
-    /**
-     * PUBLIC: Get active purchase tokens
-     */
-    async getActivePurchaseTokens(active = true) {
-        return this.paymentApi.getActivePurchaseTokens(active);
-    }
-    /**
-     * PUBLIC: Create payment intent
-     */
-    async createPaymentIntent(amount, currency, receiptEmail, description) {
-        return this.paymentApi.createPaymentIntent(amount, currency, receiptEmail, description);
-    }
-    /**
-     * PUBLIC: Update payment intent
-     */
-    async updatePaymentIntent(paymentIntentId, amount, currency, receiptEmail, description) {
-        return this.paymentApi.updatePaymentIntent(paymentIntentId, amount, currency, receiptEmail, description);
-    }
-    /**
-     * PUBLIC: Cancel payment intent
-     */
-    async cancelPaymentIntent(paymentIntentId) {
-        return this.paymentApi.cancelPaymentIntent(paymentIntentId);
-    }
-    // ==========================================
-    // AUTHENTICATED OPERATIONS
-    // ==========================================
-    /**
-     * AUTH: Create purchase
-     */
-    async createPurchase(paymentIntentId, amount, purchaseTokenId, donationTypeId, donationAccountAddress) {
-        return this.paymentApi.createPurchase(paymentIntentId, amount, purchaseTokenId, donationTypeId, donationAccountAddress);
-    }
-    /**
-     * AUTH: Get all user purchases
-     */
-    async getAllUserPurchases() {
-        return this.paymentApi.getAllUserPurchases();
-    }
-}
-
-/**
- * @explorins/pers-sdk-payment
- *
- * Platform-agnostic Payment Domain SDK for PERS ecosystem
- * Handles payment intents, purchases, and purchase tokens
- *
- * Note: Payment provider integrations (Stripe, etc.) are kept separate
- * in the infrastructure layer to maintain platform-agnostic principles.
- */
-// API Layer
-/**
- * Create a complete Payment SDK instance
- *
- * @param apiClient - Configured PERS API client
- * @returns Payment SDK with flattened structure for better DX
- */
-function createPaymentSDK(apiClient) {
-    const paymentApi = new PurchaseApi(apiClient);
-    const paymentService = new PaymentService(paymentApi);
-    return {
-        // Direct access to service methods (primary interface)
-        // Public methods
-        getActivePurchaseTokens: (active) => paymentService.getActivePurchaseTokens(active),
-        // ✅ FIXED: Proper type instead of any
-        createPaymentIntent: (amount, currency, receiptEmail, description) => paymentService.createPaymentIntent(amount, currency, receiptEmail, description),
-        // ✅ FIXED: Proper type instead of any
-        updatePaymentIntent: (paymentIntentId, amount, currency, receiptEmail, description) => paymentService.updatePaymentIntent(paymentIntentId, amount, currency, receiptEmail, description),
-        cancelPaymentIntent: (paymentIntentId) => paymentService.cancelPaymentIntent(paymentIntentId),
-        // Auth methods
-        createPurchase: (paymentIntentId, amount, purchaseTokenId, donationTypeId, donationAccountAddress) => paymentService.createPurchase(paymentIntentId, amount, purchaseTokenId, donationTypeId, donationAccountAddress),
-        getAllUserPurchases: () => paymentService.getAllUserPurchases(),
-        // Advanced access for edge cases
-        api: paymentApi,
-        service: paymentService
-    };
-}
 
+exports.PaymentApi = paymentService.PurchaseApi;
+exports.PaymentService = paymentService.PaymentService;
 Object.defineProperty(exports, "AccountOwnerType", {
-    enumerable: true,
-    get: function () { return persShared.AccountOwnerType; }
+	enumerable: true,
+	get: function () { return persShared.AccountOwnerType; }
 });
-exports.PaymentApi = PurchaseApi;
-exports.PaymentService = PaymentService;
-exports.createPaymentSDK = createPaymentSDK;
 //# sourceMappingURL=payment.cjs.map