@explorins/pers-sdk 1.6.45 → 2.0.0

package/dist/payment.cjs

@@ -1,22 +1,238 @@
 'use strict';
 
-var paymentService = require('./chunks/payment-service-B4qx0qiE.cjs');
 var persShared = require('@explorins/pers-shared');
+var paginationUtils = require('./chunks/pagination-utils-B2jRHMSO.cjs');
 
+/**
+ * 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
+     *
+     * @param active Filter by active status
+     * @param options Pagination options (page, limit, sortBy, sortOrder)
+     * @returns Paginated response with purchase tokens
+     */
+    async getPurchaseTokens(active, options) {
+        const params = paginationUtils.buildPaginationParams(options);
+        if (active !== undefined) {
+            params.append('active', String(active));
+        }
+        const response = await this.apiClient.get(`${this.basePath}/tokens?${params.toString()}`);
+        return paginationUtils.normalizeToPaginated(response);
+    }
+    /**
+     * PUBLIC: Get donation types
+     *
+     * RESTful endpoint: GET /purchases/donation-types
+     * Replaces: GET /purchase/donation/type
+     *
+     * @param options Pagination options (page, limit, sortBy, sortOrder)
+     * @returns Paginated response with donation types
+     */
+    async getDonationTypes(options) {
+        const params = paginationUtils.buildPaginationParams(options);
+        const response = await this.apiClient.get(`${this.basePath}/donation-types?${params.toString()}`);
+        return paginationUtils.normalizeToPaginated(response);
+    }
+    // ==========================================
+    // 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
+     *
+     * @param options - Pagination options (page, limit, sortBy, sortOrder)
+     * @returns Paginated response with purchase history
+     */
+    async getUserPurchaseHistory(options) {
+        const params = paginationUtils.buildPaginationParams(options);
+        const response = await this.apiClient.get(`${this.basePath}/me/history?${params.toString()}`);
+        return paginationUtils.normalizeToPaginated(response);
+    }
+}
 
+/**
+ * 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, options) {
+        return this.paymentApi.getPurchaseTokens(active, options);
+    }
+    /**
+     * 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.createUserPurchase(paymentIntentId, amount, purchaseTokenId, donationTypeId, donationAccountAddress);
+    }
+    /**
+     * AUTH: Get all user purchases
+     */
+    async getAllUserPurchases(options) {
+        return this.paymentApi.getUserPurchaseHistory(options);
+    }
+}
 
-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; }
 });
 Object.defineProperty(exports, "ApiKeyType", {
-	enumerable: true,
-	get: function () { return persShared.ApiKeyType; }
+    enumerable: true,
+    get: function () { return persShared.ApiKeyType; }
+});
+Object.defineProperty(exports, "MEMBERSHIP_ROLE_HIERARCHY", {
+    enumerable: true,
+    get: function () { return persShared.MEMBERSHIP_ROLE_HIERARCHY; }
+});
+Object.defineProperty(exports, "MembershipRole", {
+    enumerable: true,
+    get: function () { return persShared.MembershipRole; }
 });
 Object.defineProperty(exports, "NativeTokenTypes", {
-	enumerable: true,
-	get: function () { return persShared.NativeTokenTypes; }
+    enumerable: true,
+    get: function () { return persShared.NativeTokenTypes; }
+});
+Object.defineProperty(exports, "hasMinimumRole", {
+    enumerable: true,
+    get: function () { return persShared.hasMinimumRole; }
 });
+exports.PaymentApi = PurchaseApi;
+exports.PaymentService = PaymentService;
 //# sourceMappingURL=payment.cjs.map

package/dist/payment.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"payment.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"payment.cjs","sources":["../src/payment/api/payment-api.ts","../src/payment/services/payment-service.ts"],"sourcesContent":[null,null],"names":["buildPaginationParams","normalizeToPaginated"],"mappings":"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"}

package/dist/payment.js

@@ -1,3 +1,211 @@
-export { P as PaymentApi, a as PaymentService } from './chunks/payment-service-DfCBFosx.js';
-export { AccountOwnerType, ApiKeyType, NativeTokenTypes } from '@explorins/pers-shared';
+export { AccountOwnerType, ApiKeyType, MEMBERSHIP_ROLE_HIERARCHY, MembershipRole, NativeTokenTypes, hasMinimumRole } from '@explorins/pers-shared';
+import { b as buildPaginationParams, n as normalizeToPaginated } from './chunks/pagination-utils-9vQ-Npkr.js';
+
+/**
+ * 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
+     *
+     * @param active Filter by active status
+     * @param options Pagination options (page, limit, sortBy, sortOrder)
+     * @returns Paginated response with purchase tokens
+     */
+    async getPurchaseTokens(active, options) {
+        const params = buildPaginationParams(options);
+        if (active !== undefined) {
+            params.append('active', String(active));
+        }
+        const response = await this.apiClient.get(`${this.basePath}/tokens?${params.toString()}`);
+        return normalizeToPaginated(response);
+    }
+    /**
+     * PUBLIC: Get donation types
+     *
+     * RESTful endpoint: GET /purchases/donation-types
+     * Replaces: GET /purchase/donation/type
+     *
+     * @param options Pagination options (page, limit, sortBy, sortOrder)
+     * @returns Paginated response with donation types
+     */
+    async getDonationTypes(options) {
+        const params = buildPaginationParams(options);
+        const response = await this.apiClient.get(`${this.basePath}/donation-types?${params.toString()}`);
+        return normalizeToPaginated(response);
+    }
+    // ==========================================
+    // 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
+     *
+     * @param options - Pagination options (page, limit, sortBy, sortOrder)
+     * @returns Paginated response with purchase history
+     */
+    async getUserPurchaseHistory(options) {
+        const params = buildPaginationParams(options);
+        const response = await this.apiClient.get(`${this.basePath}/me/history?${params.toString()}`);
+        return normalizeToPaginated(response);
+    }
+}
+
+/**
+ * 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, options) {
+        return this.paymentApi.getPurchaseTokens(active, options);
+    }
+    /**
+     * 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.createUserPurchase(paymentIntentId, amount, purchaseTokenId, donationTypeId, donationAccountAddress);
+    }
+    /**
+     * AUTH: Get all user purchases
+     */
+    async getAllUserPurchases(options) {
+        return this.paymentApi.getUserPurchaseHistory(options);
+    }
+}
+
+export { PurchaseApi as PaymentApi, PaymentService };
 //# sourceMappingURL=payment.js.map

package/dist/payment.js.map

@@ -1 +1 @@
-{"version":3,"file":"payment.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}
+{"version":3,"file":"payment.js","sources":["../src/payment/api/payment-api.ts","../src/payment/services/payment-service.ts"],"sourcesContent":[null,null],"names":[],"mappings":"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"}

package/dist/pers-sdk.d.ts

@@ -167,6 +167,7 @@
 import { HttpClient } from './core/abstractions/http-client';
 import { PersConfig } from './core/pers-config';
 import { PersApiClient } from './core/pers-api-client';
+import { PersEventEmitter } from './core/events';
 import { AuthManager, UserManager, UserStatusManager, TokenManager, BusinessManager, CampaignManager, RedemptionManager, TransactionManager, PurchaseManager, FileManager, TenantManager, ApiKeyManager, AnalyticsManager, DonationManager, Web3Manager } from './managers';
 /**
  * PERS SDK - Main SDK class with domain managers
@@ -227,6 +228,7 @@ import { AuthManager, UserManager, UserStatusManager, TokenManager, BusinessMana
  */
 export declare class PersSDK {
     private apiClient;
+    private _events;
     private _auth;
     private _users;
     private _userStatus;
@@ -285,6 +287,53 @@ export declare class PersSDK {
      * ```
      */
     constructor(httpClient: HttpClient, config: PersConfig);
+    /**
+     * Event emitter - Subscribe to SDK-wide events
+     *
+     * Provides a platform-agnostic event system for subscribing to transaction,
+     * authentication, campaign, and system events. Use this to display
+     * notifications, update UI, or trigger side effects in your application.
+     *
+     * All events have a `userMessage` field ready for display.
+     *
+     * @returns PersEventEmitter instance
+     *
+     * @example Basic Usage - Show All Notifications
+     * ```typescript
+     * const unsubscribe = sdk.events.subscribe((event) => {
+     *   // userMessage is always present and UI-ready
+     *   showNotification(event.userMessage, event.level);
+     * });
+     *
+     * // Later: cleanup
+     * unsubscribe();
+     * ```
+     *
+     * @example Filter by Domain and Level
+     * ```typescript
+     * sdk.events.subscribe((event) => {
+     *   if (event.level === 'success' && event.domain === 'transaction') {
+     *     playSuccessSound();
+     *     confetti();
+     *   }
+     *
+     *   if (event.level === 'error') {
+     *     logToSentry(event);
+     *   }
+     * });
+     * ```
+     *
+     * @example One-time Event
+     * ```typescript
+     * // Auto-unsubscribe after first event
+     * sdk.events.once((event) => {
+     *   console.log('First event received:', event.type);
+     * });
+     * ```
+     *
+     * @see {@link PersEventEmitter} for detailed documentation
+     */
+    get events(): PersEventEmitter;
     /**
      * Authentication manager - High-level authentication operations
      *

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

@@ -1 +1 @@
-{"version":3,"file":"pers-sdk.d.ts","sourceRoot":"","sources":["../src/pers-sdk.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pers-sdk.d.ts","sourceRoot":"","sources":["../src/pers-sdk.ts"],"names":[],"mappings":"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"}

package/dist/redemption/api/redemption-api.d.ts

@@ -1,6 +1,8 @@
 import { TokenUnitCreateRequestDTO, RedemptionTypeCreateRequestDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
 import { PersApiClient } from '../../core/pers-api-client';
 import { RedemptionDTO, RedemptionCreateRequestDTO, RedemptionTypeDTO, RedemptionRedeemDTO, RedemptionRedeemRequestResponseDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
+import { PaginatedResponseDTO } from '@explorins/pers-shared';
+import { PaginationOptions } from '../../shared';
 /**
  * Platform-Agnostic Redemption API Client (UPDATED - RESTful Design)
  *
@@ -27,17 +29,24 @@ export declare class RedemptionApi {
      *
      * @param options.active - Filter by active status (undefined = all for admins/active for public)
      * @param options.adminAccess - Force admin access (requires admin auth)
+     * @param options.page - Page number (default: 1)
+     * @param options.limit - Items per page (default: 50)
+     * @param options.sortBy - Sort field
+     * @param options.sortOrder - Sort order (asc/desc)
+     * @returns Paginated response with redemptions
      */
     getRedemptions(options?: {
         active?: boolean;
         adminAccess?: boolean;
-    }): Promise<RedemptionDTO[]>;
+    } & PaginationOptions): Promise<PaginatedResponseDTO<RedemptionDTO>>;
     /**
      * PUBLIC: Get redemption types
      *
      * Updated: /redemption/type → /redemption-types
+     * @param options Pagination options (page, limit, sortBy, sortOrder)
+     * @returns Paginated response with redemption types
      */
-    getRedemptionTypes(): Promise<RedemptionTypeDTO[]>;
+    getRedemptionTypes(options?: PaginationOptions): Promise<PaginatedResponseDTO<RedemptionTypeDTO>>;
     /**
      * PUBLIC: Get redemption by ID
      *
@@ -70,13 +79,18 @@ export declare class RedemptionApi {
      * @param filters.userId - Admin only: Filter by user ID
      * @param filters.businessId - Admin only: Filter by business ID
      * @param filters.myRedeems - Force user's own redeems (uses /me endpoint)
+     * @param filters.page - Page number (default: 1)
+     * @param filters.limit - Items per page (default: 50)
+     * @param filters.sortBy - Sort field
+     * @param filters.sortOrder - Sort order (asc/desc)
+     * @returns Paginated response with redemption redeems
      */
     getRedemptionRedeems(filters?: {
         redemptionId?: string;
         userId?: string;
         businessId?: string;
         myRedeems?: boolean;
-    }): Promise<RedemptionRedeemDTO[]>;
+    } & PaginationOptions): Promise<PaginatedResponseDTO<RedemptionRedeemDTO>>;
     /**
      * UNIFIED: Get specific redemption redeem by ID
      */
@@ -86,15 +100,10 @@ export declare class RedemptionApi {
      *
      * Uses convenience endpoint /redemption-redeems/me with optional filtering
      * @param redemptionId - Optional filter by specific redemption
+     * @param options - Pagination options (page, limit, sortBy, sortOrder)
+     * @returns Paginated response with user's redemption redeems
      */
-    getUserRedeems(redemptionId?: string): Promise<RedemptionRedeemDTO[]>;
-    /**
-     * ADMIN: Get redemptions with filtering (using intelligent endpoint)
-     *
-     * Updated: /redemption/admin → /redemptions (intelligent access detection)
-     * The unified endpoint will detect admin privileges and allow filtering
-     */
-    getRedemptionsAsAdmin(active?: boolean): Promise<RedemptionDTO[]>;
+    getUserRedeems(redemptionId?: string, options?: PaginationOptions): Promise<PaginatedResponseDTO<RedemptionRedeemDTO>>;
     /**
      * ADMIN: Create redemption
      *
@@ -146,6 +155,8 @@ export declare class RedemptionApi {
     deleteRedemptionTokenUnit(redemptionId: string, redemptionTokenUnitId: string): Promise<RedemptionDTO>;
     /**
      * Convenience: Get active redemptions (public access)
+     *
+     * @deprecated Use getRedemptions({ active: true }) instead for paginated results
      */
     getActiveRedemptions(): Promise<RedemptionDTO[]>;
 }

package/dist/redemption/api/redemption-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redemption-api.d.ts","sourceRoot":"","sources":["../../../src/redemption/api/redemption-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,8BAA8B,EAAE,MAAM,oDAAoD,CAAC;AAC/H,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EACL,aAAa,EACb,0BAA0B,EAE1B,iBAAiB,EACjB,mBAAmB,EACnB,kCAAkC,EACnC,MAAM,oDAAoD,CAAC;AAE5D;;;;;;;;;;;GAWG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,aAAa;IAE5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAMlD;;;;;;;;;OASG;IACG,cAAc,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAUrG;;;;OAIG;IACG,kBAAkB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIxD;;;;OAIG;IACG,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAI3D;;;;OAIG;IACG,4BAA4B,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAS/D;;;;;;;OAOG;IACG,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,kCAAkC,CAAC;IAWzF;;;;;;;;;;;OAWG;IACG,oBAAoB,CAAC,OAAO,CAAC,EAAE;QACnC,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IA2BlC;;OAEG;IACG,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAQvE;;;;;OAKG;IACG,cAAc,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAQ3E;;;;;OAKG;IACG,qBAAqB,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAIvE;;;;OAIG;IACG,gBAAgB,CAAC,UAAU,EAAE,0BAA0B,GAAG,OAAO,CAAC,aAAa,CAAC;IAItF;;;;OAIG;IACG,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,uBAAuB,EAAE,0BAA0B,GAAG,OAAO,CAAC,aAAa,CAAC;IAI/G;;;;;OAKG;IACG,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAI1E;;;;OAIG;IACG,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpD;;;;OAIG;IACG,oBAAoB,CAAC,cAAc,EAAE,8BAA8B,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAQtG;;;;OAIG;IACG,yBAAyB,CAAC,YAAY,EAAE,MAAM,EAAE,mBAAmB,EAAE,yBAAyB,GAAG,OAAO,CAAC,aAAa,CAAC;IAI7H;;;;OAIG;IACG,yBAAyB,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,mBAAmB,EAAE,yBAAyB,GAAG,OAAO,CAAC,aAAa,CAAC;IAIlJ;;;;OAIG;IACG,yBAAyB,CAAC,YAAY,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAQ5G;;OAEG;IACG,oBAAoB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;CAGvD"}
+{"version":3,"file":"redemption-api.d.ts","sourceRoot":"","sources":["../../../src/redemption/api/redemption-api.ts"],"names":[],"mappings":"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"}