@explorins/pers-sdk 1.6.47 → 2.0.0

package/dist/redemption.js

@@ -1,3 +1,339 @@
-export { R as RedemptionApi, a as RedemptionService } from './chunks/redemption-service-BT0J5Iy7.js';
 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 Redemption API Client (UPDATED - RESTful Design)
+ *
+ * Updated to work with the new RESTful controller structure:
+ * - /redemptions (main redemption management)
+ * - /redemption-types (redemption type management)
+ * - /redemption-tokens (token unit management)
+ * - /redemption-redeems (redemption execution and history)
+ *
+ * Handles redemption operations using the PERS backend with intelligent access detection.
+ * Uses @explorins/pers-shared DTOs for consistency with backend.
+ */
+class RedemptionApi {
+    constructor(apiClient) {
+        this.apiClient = apiClient;
+        this.basePath = '/redemptions';
+        this.typesPath = '/redemptions/types';
+    }
+    // ==========================================
+    // PUBLIC OPERATIONS (Project Key)
+    // ==========================================
+    /**
+     * UNIFIED: Get redemptions with intelligent access control
+     *
+     * Intelligent endpoint that adapts based on authentication:
+     * - Public users: Get active redemptions only
+     * - Admin users: Get all redemptions with optional filtering
+     *
+     * @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
+     */
+    async getRedemptions(options) {
+        const params = buildPaginationParams(options);
+        if (options?.active !== undefined) {
+            params.append('active', String(options.active));
+        }
+        const response = await this.apiClient.get(`${this.basePath}?${params.toString()}`);
+        return normalizeToPaginated(response);
+    }
+    /**
+     * PUBLIC: Get redemption types
+     *
+     * Updated: /redemption/type → /redemption-types
+     * @param options Pagination options (page, limit, sortBy, sortOrder)
+     * @returns Paginated response with redemption types
+     */
+    async getRedemptionTypes(options) {
+        const params = buildPaginationParams(options);
+        const response = await this.apiClient.get(`${this.typesPath}?${params.toString()}`);
+        return normalizeToPaginated(response);
+    }
+    /**
+     * PUBLIC: Get redemption by ID
+     *
+     * Updated: /redemption/:id → /redemptions/:id
+     */
+    async getRedemptionById(id) {
+        return this.apiClient.get(`${this.basePath}/${id}`);
+    }
+    /**
+     * PUBLIC: Get available supply for redemption
+     *
+     * Updated: /redemption/:id/available-supply → /redemptions/:id/supply
+     */
+    async getRedemptionAvailableSupply(id) {
+        const result = await this.apiClient.get(`${this.basePath}/${id}/supply`);
+        return result.available;
+    }
+    // ==========================================
+    // REDEMPTION EXECUTION (UNIFIED ENDPOINT)
+    // ==========================================
+    /**
+     * Execute redemption (unified endpoint)
+     *
+     * NEW: POST /redemption-redeems - Role-based processing
+     * - USER: Direct user redemption processing
+     * - ADMIN: Can process redemptions for any account type
+     * - BUSINESS: Process redemptions for customers
+     */
+    async redeemRedemption(redemptionId) {
+        const body = {
+            redemptionId: redemptionId,
+        };
+        return this.apiClient.post(this.basePath + '/redeems', body);
+    }
+    // ==========================================
+    // REDEMPTION REDEEMS QUERIES (NEW ENDPOINTS)
+    // ==========================================
+    /**
+     * UNIFIED: Get redemption redeems with filtering and intelligent access
+     *
+     * Role-based access with unified filtering:
+     * - Users: See only their own redeems (userId/businessId filters ignored)
+     * - Admins: Can filter by userId, businessId, or redemptionId
+     *
+     * @param filters.redemptionId - Filter by specific redemption
+     * @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
+     */
+    async getRedemptionRedeems(filters) {
+        let url = `${this.basePath}/redeems`;
+        const params = buildPaginationParams(filters);
+        // Use convenience endpoint for user's own redeems
+        if (filters?.myRedeems) {
+            url = `${this.basePath}/redeems/me`;
+            if (filters?.redemptionId) {
+                params.append('redemptionId', filters.redemptionId);
+            }
+            const response = await this.apiClient.get(`${url}?${params.toString()}`);
+            return normalizeToPaginated(response);
+        }
+        // Use admin endpoint with filtering
+        if (filters?.redemptionId)
+            params.append('redemptionId', filters.redemptionId);
+        if (filters?.userId)
+            params.append('userId', filters.userId);
+        if (filters?.businessId)
+            params.append('businessId', filters.businessId);
+        const response = await this.apiClient.get(`${url}?${params.toString()}`);
+        return normalizeToPaginated(response);
+    }
+    /**
+     * UNIFIED: Get specific redemption redeem by ID
+     */
+    async getRedemptionRedeemById(id) {
+        return this.apiClient.get(`${this.basePath}/redeems/${id}`);
+    }
+    // ==========================================
+    // USER OPERATIONS (JWT + Project Key)
+    // ==========================================
+    /**
+     * UNIFIED: Get user redemption history
+     *
+     * 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
+     */
+    async getUserRedeems(redemptionId, options) {
+        return this.getRedemptionRedeems({ myRedeems: true, redemptionId, ...options });
+    }
+    // ==========================================
+    // ADMIN OPERATIONS (Tenant Admin JWT)
+    // ==========================================
+    /**
+     * ADMIN: Create redemption
+     *
+     * Updated: /redemption/admin → /redemptions
+     */
+    async createRedemption(redemption) {
+        return this.apiClient.post(`${this.basePath}`, redemption);
+    }
+    /**
+     * ADMIN: Update redemption
+     *
+     * Updated: /redemption/admin/:id → /redemptions/:id
+     */
+    async updateRedemption(id, redemptionCreateRequest) {
+        return this.apiClient.put(`${this.basePath}/${id}`, redemptionCreateRequest);
+    }
+    /**
+     * UNIFIED: Toggle redemption active status
+     *
+     * Updated: /redemption/admin/:id/toggle-active → /redemptions/:id/status
+     * Following standard /status pattern used across domains
+     */
+    async toggleRedemptionActive(redemptionId) {
+        return this.apiClient.put(`${this.basePath}/${redemptionId}/status`, {});
+    }
+    /**
+     * ADMIN: Delete redemption
+     *
+     * Updated: /redemption/admin/:id → /redemptions/:id
+     */
+    async deleteRedemption(id) {
+        return this.apiClient.delete(`${this.basePath}/${id}`);
+    }
+    /**
+     * ADMIN: Create redemption type
+     *
+     * Updated: /redemption/admin/type → /redemption-types
+     */
+    async createRedemptionType(redemptionType) {
+        return this.apiClient.post(this.typesPath, redemptionType);
+    }
+    // ==========================================
+    // TOKEN UNIT MANAGEMENT (Admin)
+    // ==========================================
+    /**
+     * ADMIN: Create redemption token unit
+     *
+     * Updated: /redemption/admin/:id/token-units → /redemption-tokens/:id/
+     */
+    async createRedemptionTokenUnit(redemptionId, redemptionTokenUnit) {
+        return this.apiClient.post(`${this.basePath}/${redemptionId}/tokens`, redemptionTokenUnit);
+    }
+    /**
+     * ADMIN: Update redemption token unit
+     *
+     * Updated: /redemption/admin/:id/token-units/:tokenUnitId → /redemption-tokens/:id/:tokenUnitId
+     */
+    async updateRedemptionTokenUnit(redemptionId, tokenUnitId, redemptionTokenUnit) {
+        return this.apiClient.put(`${this.basePath}/${redemptionId}/tokens/${tokenUnitId}`, redemptionTokenUnit);
+    }
+    /**
+     * ADMIN: Delete redemption token unit
+     *
+     * Updated: /redemption/admin/:id/token-units/:tokenUnitId → /redemption-tokens/:id/:tokenUnitId
+     */
+    async deleteRedemptionTokenUnit(redemptionId, redemptionTokenUnitId) {
+        return this.apiClient.delete(`${this.basePath}/${redemptionId}/tokens/${redemptionTokenUnitId}`);
+    }
+    // ==========================================
+    // CONVENIENCE METHODS (Legacy Support)
+    // ==========================================
+    /**
+     * Convenience: Get active redemptions (public access)
+     *
+     * @deprecated Use getRedemptions({ active: true }) instead for paginated results
+     */
+    async getActiveRedemptions() {
+        const result = await this.getRedemptions({ active: true });
+        return [...result.data];
+    }
+}
+
+/**
+ * Platform-Agnostic Redemption Service
+ *
+ * Contains redemption business logic and operations that work across platforms.
+ * No framework dependencies - pure TypeScript business logic.
+ *
+ * Focuses only on actual backend capabilities.
+ */
+class RedemptionService {
+    constructor(redemptionApi) {
+        this.redemptionApi = redemptionApi;
+    }
+    // ==========================================
+    // PUBLIC OPERATIONS
+    // ==========================================
+    /**
+     * UNIFIED: Get redemptions with intelligent access control and pagination
+     * @param options.active - Filter by active status
+     * @param options.adminAccess - Force admin access
+     */
+    async getRedemptions(options) {
+        return this.redemptionApi.getRedemptions(options);
+    }
+    /**
+     * Convenience: Get active redemptions (public)
+     */
+    async getActiveRedemptions() {
+        return this.redemptionApi.getActiveRedemptions();
+    }
+    /**
+     * Get all redemption types with pagination
+     */
+    async getRedemptionTypes(options) {
+        return this.redemptionApi.getRedemptionTypes(options);
+    }
+    // ==========================================
+    // AUTHENTICATED OPERATIONS
+    // ==========================================
+    /**
+     * AUTH: Redeem a redemption
+     */
+    async redeemRedemption(redemptionId) {
+        return this.redemptionApi.redeemRedemption(redemptionId);
+    }
+    /**
+     * UNIFIED: Get redemption redeems with filtering and pagination
+     */
+    async getRedemptionRedeems(filters) {
+        return this.redemptionApi.getRedemptionRedeems(filters);
+    }
+    /**
+     * Convenience: Get user redemptions with pagination
+     */
+    async getUserRedeems(options) {
+        return this.redemptionApi.getUserRedeems(undefined, options);
+    }
+    // ==========================================
+    // ADMIN OPERATIONS
+    // ==========================================
+    /**
+     * Convenience: Get redemptions as admin
+     */
+    async getRedemptionsAsAdmin(active, options) {
+        return this.redemptionApi.getRedemptions({ active, adminAccess: true, ...options });
+    }
+    /**
+     * ADMIN: Create redemption
+     */
+    async createRedemption(redemption) {
+        return this.redemptionApi.createRedemption(redemption);
+    }
+    /**
+     * ADMIN: Update redemption
+     */
+    async updateRedemption(id, redemptionCreateRequest) {
+        return this.redemptionApi.updateRedemption(id, redemptionCreateRequest); // ✅ CORRECTED: Fixed parameter
+    }
+    /**
+     * ADMIN: Toggle redemption active status
+     */
+    async toggleRedemptionActive(redemptionId) {
+        return this.redemptionApi.toggleRedemptionActive(redemptionId);
+    }
+    /**
+     * ADMIN: Create redemption token unit
+     */
+    async createRedemptionTokenUnit(redemptionId, redemptionTokenUnit) {
+        return this.redemptionApi.createRedemptionTokenUnit(redemptionId, redemptionTokenUnit);
+    }
+    /**
+     * ADMIN: Delete redemption token unit
+     */
+    async deleteRedemptionTokenUnit(redemptionId, redemptionTokenUnitId) {
+        return this.redemptionApi.deleteRedemptionTokenUnit(redemptionId, redemptionTokenUnitId);
+    }
+}
+
+export { RedemptionApi, RedemptionService };
 //# sourceMappingURL=redemption.js.map

package/dist/redemption.js.map

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

package/dist/shared/index.d.ts

@@ -2,4 +2,5 @@
  * @explorins/pers-sdk/shared - Shared utilities and interfaces
  */
 export * from './interfaces/pers-shared-lib.interfaces';
+export * from './utils/pagination-utils';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,yCAAyC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,yCAAyC,CAAC;AAGxD,cAAc,0BAA0B,CAAC"}

package/dist/shared/utils/pagination-utils.d.ts

@@ -0,0 +1,184 @@
+import { PaginatedResponseDTO, SortOrder } from '@explorins/pers-shared';
+/**
+ * Standard pagination options for all list methods
+ * Use this interface consistently across all API, service, and manager layers
+ *
+ * @example
+ * ```typescript
+ * async getCampaigns(options?: PaginationOptions): Promise<PaginatedResponseDTO<CampaignDTO>> {
+ *   const params = buildPaginationParams(options);
+ *   return this.apiClient.get(`/campaigns?${params.toString()}`);
+ * }
+ * ```
+ */
+export interface PaginationOptions {
+    /**
+     * Page number (1-indexed)
+     * @default 1
+     */
+    page?: number;
+    /**
+     * Items per page
+     * @default 50
+     */
+    limit?: number;
+    /**
+     * Field to sort by (e.g., 'createdAt', 'name')
+     */
+    sortBy?: string;
+    /**
+     * Sort direction
+     */
+    sortOrder?: SortOrder;
+}
+/**
+ * Extended pagination with common filters
+ * Use for endpoints that support search and date filtering
+ *
+ * @example
+ * ```typescript
+ * async searchTransactions(options?: PaginationWithFilters): Promise<PaginatedResponseDTO<TransactionDTO>> {
+ *   const params = buildPaginationParams(options);
+ *   if (options?.search) params.set('search', options.search);
+ *   // ...
+ * }
+ * ```
+ */
+export interface PaginationWithFilters extends PaginationOptions {
+    /**
+     * Search query string
+     */
+    search?: string;
+    /**
+     * Filter by start date
+     */
+    startDate?: Date;
+    /**
+     * Filter by end date
+     */
+    endDate?: Date;
+}
+/**
+ * Type alias for hybrid period (backend can return either shape)
+ * Use this in API method return types during backend hybrid phase
+ *
+ * @example
+ * ```typescript
+ * // During hybrid backend phase
+ * async getItems(): Promise<ListResponse<ItemDTO>> {
+ *   return this.apiClient.get<ListResponse<ItemDTO>>('/items');
+ * }
+ * ```
+ */
+export type ListResponse<T> = T[] | PaginatedResponseDTO<T>;
+/**
+ * Helper to build pagination query params with defaults
+ * Ensures pagination params are always included in API requests
+ *
+ * @param options - Pagination options (optional)
+ * @returns URLSearchParams with page and limit always set
+ *
+ * @example
+ * ```typescript
+ * async getItems(options?: PaginationOptions): Promise<PaginatedResponseDTO<ItemDTO>> {
+ *   const params = buildPaginationParams(options);
+ *   // params always includes: page=1&limit=50 (or custom values)
+ *
+ *   if (options?.sortBy) params.set('sortBy', options.sortBy);
+ *   if (options?.sortOrder) params.set('sortOrder', options.sortOrder);
+ *
+ *   return this.apiClient.get(`/items?${params.toString()}`);
+ * }
+ * ```
+ */
+export declare function buildPaginationParams(options?: PaginationOptions): URLSearchParams;
+/**
+ * Type guard to check if response is paginated
+ *
+ * @param response - Either an array or paginated response
+ * @returns True if response is PaginatedResponseDTO
+ *
+ * @example
+ * ```typescript
+ * const response = await api.getItems();
+ * if (isPaginatedResponse(response)) {
+ *   console.log(response.pagination.total);
+ * }
+ * ```
+ */
+export declare function isPaginatedResponse<T>(response: T[] | PaginatedResponseDTO<T>): response is PaginatedResponseDTO<T>;
+/**
+ * Extract data array from either array or paginated response
+ * Use during hybrid backend phase to safely handle both response shapes
+ *
+ * @param response - Either an array or paginated response
+ * @returns Data array
+ *
+ * @example
+ * ```typescript
+ * const response = await api.getItems(); // Could be T[] or PaginatedResponseDTO<T>
+ * const items = extractData(response);   // Always T[]
+ * ```
+ */
+export declare function extractData<T>(response: T[] | PaginatedResponseDTO<T>): T[];
+/**
+ * Extract pagination metadata (returns null for array responses)
+ *
+ * @param response - Either an array or paginated response
+ * @returns Pagination metadata or null
+ *
+ * @example
+ * ```typescript
+ * const response = await api.getItems();
+ * const pagination = extractPagination(response);
+ * if (pagination) {
+ *   console.log(`Total: ${pagination.total}`);
+ * }
+ * ```
+ */
+export declare function extractPagination<T>(response: T[] | PaginatedResponseDTO<T>): PaginatedResponseDTO<T>['pagination'] | null;
+/**
+ * Normalize any list response to PaginatedResponseDTO format
+ * Converts array responses to paginated format during hybrid backend phase
+ *
+ * @param response - Either an array or paginated response
+ * @returns Paginated response (normalized if input was array)
+ *
+ * @example
+ * ```typescript
+ * // Backend returns array (no pagination params)
+ * const arrayResponse = await api.getItems();
+ * const normalized = normalizeToPaginated(arrayResponse);
+ * console.log(normalized.data);       // Original array
+ * console.log(normalized.pagination); // Generated metadata
+ *
+ * // Backend returns paginated (with pagination params)
+ * const paginatedResponse = await api.getItems({ page: 1, limit: 50 });
+ * const normalized2 = normalizeToPaginated(paginatedResponse);
+ * console.log(normalized2); // Same as input (no conversion needed)
+ * ```
+ */
+export declare function normalizeToPaginated<T>(response: T[] | PaginatedResponseDTO<T>): PaginatedResponseDTO<T>;
+/**
+ * Fetch all pages automatically (useful for infinite scroll or complete datasets)
+ *
+ * ⚠️ WARNING: Use with caution on large datasets. This will make multiple API calls
+ * and load all items into memory. Consider using pagination UI instead.
+ *
+ * @param fetchFn - Function that fetches a page (must return PaginatedResponseDTO)
+ * @param limit - Items per page (default: 50)
+ * @param maxPages - Safety limit to prevent infinite loops (default: 100)
+ * @returns All items from all pages
+ *
+ * @example
+ * ```typescript
+ * // Fetch all campaigns (use with caution!)
+ * const allCampaigns = await fetchAllPages(
+ *   (page, limit) => sdk.campaigns.getCampaigns({ page, limit }),
+ *   50,  // items per page
+ *   100  // max 100 pages (5000 items)
+ * );
+ * ```
+ */
+export declare function fetchAllPages<T>(fetchFn: (page: number, limit: number) => Promise<PaginatedResponseDTO<T>>, limit?: number, maxPages?: number): Promise<T[]>;
+//# sourceMappingURL=pagination-utils.d.ts.map

package/dist/shared/utils/pagination-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination-utils.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/pagination-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAMzE;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAC9D;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,CAAC,EAAE,IAAI,CAAC;IAEjB;;OAEG;IACH,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAAC;AAM5D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,eAAe,CAWlF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,QAAQ,EAAE,CAAC,EAAE,GAAG,oBAAoB,CAAC,CAAC,CAAC,GACtC,QAAQ,IAAI,oBAAoB,CAAC,CAAC,CAAC,CAQrC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,oBAAoB,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAK3E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,QAAQ,EAAE,CAAC,EAAE,GAAG,oBAAoB,CAAC,CAAC,CAAC,GACtC,oBAAoB,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,IAAI,CAE9C;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,QAAQ,EAAE,CAAC,EAAE,GAAG,oBAAoB,CAAC,CAAC,CAAC,GACtC,oBAAoB,CAAC,CAAC,CAAC,CAiBzB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,aAAa,CAAC,CAAC,EACnC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,EAC1E,KAAK,GAAE,MAAW,EAClB,QAAQ,GAAE,MAAY,GACrB,OAAO,CAAC,CAAC,EAAE,CAAC,CAad"}

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

@@ -1,5 +1,7 @@
 import { AdminDTO, TenantPublicDTO, TenantClientConfigDTO, AdminCreateRequestDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
 import { PersApiClient } from '../../core/pers-api-client';
+import { PaginatedResponseDTO } from '@explorins/pers-shared';
+import { PaginationOptions } from '../../shared';
 /**
  * Platform-Agnostic Tenant API Client
  *
@@ -46,8 +48,11 @@ export declare class TenantApi {
     updateRemoteTenant(tenantData: TenantPublicDTO): Promise<TenantPublicDTO>;
     /**
      * ADMIN: Get all tenant admins
+     *
+     * @param options Pagination options (page, limit, sortBy, sortOrder)
+     * @returns Paginated response with tenant admins
      */
-    getAdmins(): Promise<AdminDTO[]>;
+    getAdmins(options?: PaginationOptions): Promise<PaginatedResponseDTO<AdminDTO>>;
     /**
      * ADMIN: Create new admin
      */

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

@@ -1 +1 @@
-{"version":3,"file":"tenant-api.d.ts","sourceRoot":"","sources":["../../../src/tenant/api/tenant-api.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D;;;;;;;;GAQG;AACH,qBAAa,SAAS;IACR,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,aAAa;IAE5C,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,SAAS,CAAa;IAM9B;;;;;;OAMG;IACG,eAAe,IAAI,OAAO,CAAC,eAAe,CAAC;IAOjD;;;OAGG;IACG,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC;IAI5C;;;OAGG;IACG,qBAAqB,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAQ7D;;;;;OAKG;IACG,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IASrE;;;OAGG;IACG,kBAAkB,CAAC,UAAU,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAI/E;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAItC;;OAEG;IACG,SAAS,CAAC,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIpE;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;CAGrF"}
+{"version":3,"file":"tenant-api.d.ts","sourceRoot":"","sources":["../../../src/tenant/api/tenant-api.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAA6D,MAAM,cAAc,CAAC;AAE5G;;;;;;;;GAQG;AACH,qBAAa,SAAS;IACR,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,aAAa;IAE5C,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,SAAS,CAAa;IAM9B;;;;;;OAMG;IACG,eAAe,IAAI,OAAO,CAAC,eAAe,CAAC;IAOjD;;;OAGG;IACG,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC;IAI5C;;;OAGG;IACG,qBAAqB,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAQ7D;;;;;OAKG;IACG,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IASrE;;;OAGG;IACG,kBAAkB,CAAC,UAAU,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAI/E;;;;;OAKG;IACG,SAAS,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAMrF;;OAEG;IACG,SAAS,CAAC,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIpE;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;CAGrF"}

package/dist/tenant/services/tenant-service.d.ts

@@ -1,5 +1,7 @@
+import { PaginatedResponseDTO } from '@explorins/pers-shared';
 import { AdminDTO, TenantPublicDTO, TenantClientConfigDTO, AdminCreateRequestDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
 import { TenantApi } from '../api/tenant-api';
+import { PaginationOptions } from '../../shared/utils/pagination-utils';
 /**
  * Platform-Agnostic Tenant Service
  *
@@ -28,9 +30,10 @@ export declare class TenantService {
      */
     updateRemoteTenant(tenantData: TenantPublicDTO): Promise<TenantPublicDTO>;
     /**
-     * ADMIN: Get all tenant admins
+     * ADMIN: Get all tenant admins with pagination
+     * @param options - Pagination options
      */
-    getAdmins(): Promise<AdminDTO[]>;
+    getAdmins(options?: PaginationOptions): Promise<PaginatedResponseDTO<AdminDTO>>;
     /**
      * ADMIN: Create new admin
      * ✅ FIXED: Renamed to match framework postAdmin method

package/dist/tenant/services/tenant-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tenant-service.d.ts","sourceRoot":"","sources":["../../../src/tenant/services/tenant-service.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EAAE,MAAM,oDAAoD,CAAC;AACpF,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C;;;;;;GAMG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,SAAS;IAMxC;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,eAAe,CAAC;IAIjD;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC;IAI5C;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAQ7D;;;OAGG;IACG,kBAAkB,CAAC,UAAU,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAI/E;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAItC;;;OAGG;IACG,SAAS,CAAC,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIpE;;;OAGG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;CAGrF"}
+{"version":3,"file":"tenant-service.d.ts","sourceRoot":"","sources":["../../../src/tenant/services/tenant-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EACL,QAAQ,EACR,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EAAE,MAAM,oDAAoD,CAAC;AACpF,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAExE;;;;;;GAMG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,SAAS;IAMxC;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,eAAe,CAAC;IAIjD;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC;IAI5C;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAQ7D;;;OAGG;IACG,kBAAkB,CAAC,UAAU,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAI/E;;;OAGG;IACG,SAAS,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAIrF;;;OAGG;IACG,SAAS,CAAC,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIpE;;;OAGG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;CAGrF"}