@explorins/pers-sdk 1.6.47 → 2.0.0

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,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,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;IAIpB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,MAAM,CAAC;IAJjB,OAAO,CAAC,WAAW,CAAc;gBAGvB,SAAS,EAAE,aAAa,EACxB,MAAM,CAAC,8BAAkB;IAMnC;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAIxC;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACG,iBAAiB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAazE;;;;;;;;;;;;;;;;;;;;;;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACG,kBAAkB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1E;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,mBAAmB,CAAC,KAAK,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAI5E;;;;;;;;;;;;;;;;;;;;;;;;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"}
+{"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,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,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;AACrG,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAErE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,qBAAa,WAAW;IAIpB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,MAAM,CAAC;IAJjB,OAAO,CAAC,WAAW,CAAc;gBAGvB,SAAS,EAAE,aAAa,EACxB,MAAM,CAAC,8BAAkB;IAMnC;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAIxC;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACG,iBAAiB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAazE;;;;;;;;;;;;;;;;;;;;;;;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,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,oBAAoB,CAAC,CAAC;IAIlJ;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,WAAW,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAItF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACG,kBAAkB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1E;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,mBAAmB,CAAC,KAAK,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAI5E;;;;;;;;;;;;;;;;;;;;;;;;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/user-status-manager.d.ts

@@ -1,5 +1,7 @@
+import { PaginatedResponseDTO } from '@explorins/pers-shared';
 import { PersApiClient } from '../core/pers-api-client';
 import { UserStatusSDK } from '../user-status';
+import { PaginationOptions } from '../shared/utils/pagination-utils';
 import type { UserStatusTypeDTO } from '../shared/interfaces/pers-shared-lib.interfaces';
 /**
  * User Status Manager - Clean, high-level interface for user status operations
@@ -14,15 +16,15 @@ export declare class UserStatusManager {
     /**
      * Get all user status types
      *
-     * @returns Promise resolving to array of user status types
+     * @returns Promise resolving to paginated user status types
      */
-    getUserStatusTypes(): Promise<UserStatusTypeDTO[]>;
+    getUserStatusTypes(options?: PaginationOptions): Promise<PaginatedResponseDTO<UserStatusTypeDTO>>;
     /**
      * Get earned user status for authenticated user
      *
-     * @returns Promise resolving to array of earned user status
+     * @returns Promise resolving to paginated earned user status
      */
-    getEarnedUserStatus(): Promise<UserStatusTypeDTO[]>;
+    getEarnedUserStatus(options?: PaginationOptions): Promise<PaginatedResponseDTO<UserStatusTypeDTO>>;
     /**
      * Admin: Create new user status type
      *

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

@@ -1 +1 @@
-{"version":3,"file":"user-status-manager.d.ts","sourceRoot":"","sources":["../../src/managers/user-status-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAuB,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAC;AAEzF;;;;;GAKG;AACH,qBAAa,iBAAiB;IAGhB,OAAO,CAAC,SAAS;IAF7B,OAAO,CAAC,aAAa,CAAgB;gBAEjB,SAAS,EAAE,aAAa;IAI5C;;;;OAIG;IACG,kBAAkB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIxD;;;;OAIG;IACG,mBAAmB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIzD;;;;;OAKG;IACG,oBAAoB,CAAC,cAAc,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIzF;;;;OAIG;IACH,gBAAgB,IAAI,aAAa;CAGlC"}
+{"version":3,"file":"user-status-manager.d.ts","sourceRoot":"","sources":["../../src/managers/user-status-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAuB,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAC;AAEzF;;;;;GAKG;AACH,qBAAa,iBAAiB;IAGhB,OAAO,CAAC,SAAS;IAF7B,OAAO,CAAC,aAAa,CAAgB;gBAEjB,SAAS,EAAE,aAAa;IAI5C;;;;OAIG;IACG,kBAAkB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;IAIvG;;;;OAIG;IACG,mBAAmB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;IAIxG;;;;;OAKG;IACG,oBAAoB,CAAC,cAAc,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIzF;;;;OAIG;IACH,gBAAgB,IAAI,aAAa;CAGlC"}

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@explorins/pers-sdk",
-  "version": "1.6.47",
+  "version": "2.0.0",
   "description": "Platform-agnostic SDK for PERS (Phygital Experience Rewards System) - Core business logic and API integration",
   "type": "module",
   "main": "./dist/index.cjs",

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

@@ -1,5 +1,7 @@
 import { PersApiClient } from '../../core/pers-api-client';
 import { PurchaseTokenDTO, PurchaseDTO, PurchaseCurrency, PaymentIntentDTO, PurchaseCreateResponseDTO, DonationTypeDTO } from '../models';
+import { PaginatedResponseDTO } from '@explorins/pers-shared';
+import { PaginationOptions } from '../../shared';
 /**
  * Platform-Agnostic Purchase API Client (RESTful Architecture)
  *
@@ -29,15 +31,22 @@ export declare class PurchaseApi {
      * 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
      */
-    getPurchaseTokens(active?: boolean): Promise<PurchaseTokenDTO[]>;
+    getPurchaseTokens(active?: boolean, options?: PaginationOptions): Promise<PaginatedResponseDTO<PurchaseTokenDTO>>;
     /**
      * 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
      */
-    getDonationTypes(): Promise<DonationTypeDTO[]>;
+    getDonationTypes(options?: PaginationOptions): Promise<PaginatedResponseDTO<DonationTypeDTO>>;
     /**
      * PUBLIC: Create payment intent (FINANCIAL OPERATION)
      *
@@ -83,23 +92,11 @@ export declare class PurchaseApi {
      *
      * 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
      */
-    getUserPurchaseHistory(): Promise<PurchaseDTO[]>;
-    /**
-     * @deprecated Use getPurchaseTokens() instead
-     * Backward compatibility alias for getActivePurchaseTokens
-     */
-    getActivePurchaseTokens(active?: boolean): Promise<PurchaseTokenDTO[]>;
-    /**
-     * @deprecated Use createUserPurchase() instead
-     * Backward compatibility alias for createPurchase
-     */
-    createPurchase(paymentIntentId: string, amount: number, purchaseTokenId?: string, donationTypeId?: number, donationAccountAddress?: string): Promise<PurchaseCreateResponseDTO>;
-    /**
-     * @deprecated Use getUserPurchaseHistory() instead
-     * Backward compatibility alias for getAllUserPurchases
-     */
-    getAllUserPurchases(): Promise<PurchaseDTO[]>;
+    getUserPurchaseHistory(options?: PaginationOptions): Promise<PaginatedResponseDTO<PurchaseDTO>>;
 }
 export { PurchaseApi as PaymentApi };
 //# sourceMappingURL=payment-api.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"payment-api.d.ts","sourceRoot":"","sources":["../../../src/payment/api/payment-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAEhB,gBAAgB,EAEhB,yBAAyB,EACzB,eAAe,EAChB,MAAM,WAAW,CAAC;AAEnB;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,WAAW;IACV,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,aAAa;IAE5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IAMzC;;;;;;;;;OASG;IACG,iBAAiB,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAQtE;;;;;OAKG;IACG,gBAAgB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAQpD;;;;;;;OAOG;IACG,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAU3I;;;;;;;OAOG;IACG,mBAAmB,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAUpK;;;;;;;OAOG;IACG,mBAAmB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAQ7E;;;;;;;;OAQG;IACG,kBAAkB,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,sBAAsB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAWzL;;;;;;;;OAQG;IACG,sBAAsB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAQtD;;;OAGG;IACG,uBAAuB,CAAC,MAAM,GAAE,OAAc,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAIlF;;;OAGG;IACG,cAAc,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,sBAAsB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAIrL;;;OAGG;IACG,mBAAmB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;CAGpD;AAGD,OAAO,EAAE,WAAW,IAAI,UAAU,EAAE,CAAC"}
+{"version":3,"file":"payment-api.d.ts","sourceRoot":"","sources":["../../../src/payment/api/payment-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAEhB,gBAAgB,EAEhB,yBAAyB,EACzB,eAAe,EAChB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAA6D,MAAM,cAAc,CAAC;AAE5G;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,WAAW;IACV,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,aAAa;IAE5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IAMzC;;;;;;;;;;;;;OAaG;IACG,iBAAiB,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,gBAAgB,CAAC,CAAC;IASvH;;;;;;;;OAQG;IACG,gBAAgB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,eAAe,CAAC,CAAC;IAUnG;;;;;;;OAOG;IACG,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAU3I;;;;;;;OAOG;IACG,mBAAmB,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAUpK;;;;;;;OAOG;IACG,mBAAmB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAQ7E;;;;;;;;OAQG;IACG,kBAAkB,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,sBAAsB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAWzL;;;;;;;;;;;OAWG;IACG,sBAAsB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;CAMtG;AAGD,OAAO,EAAE,WAAW,IAAI,UAAU,EAAE,CAAC"}

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

@@ -1,5 +1,7 @@
+import { PaginatedResponseDTO } from '@explorins/pers-shared';
 import { PaymentApi } from '../api/payment-api';
-import { PurchaseTokenDTO, PurchaseDTO, PurchaseCurrency, PaymentIntentDTO } from '../models';
+import { PurchaseTokenDTO, PurchaseDTO, PurchaseCurrency, PaymentIntentDTO, PurchaseCreateResponseDTO } from '../models';
+import { PaginationOptions } from '../../shared/utils/pagination-utils';
 /**
  * Platform-Agnostic Payment Service
  *
@@ -15,7 +17,7 @@ export declare class PaymentService {
     /**
      * PUBLIC: Get active purchase tokens
      */
-    getActivePurchaseTokens(active?: boolean): Promise<PurchaseTokenDTO[]>;
+    getActivePurchaseTokens(active?: boolean, options?: PaginationOptions): Promise<PaginatedResponseDTO<PurchaseTokenDTO>>;
     /**
      * PUBLIC: Create payment intent
      */
@@ -31,10 +33,10 @@ export declare class PaymentService {
     /**
      * AUTH: Create purchase
      */
-    createPurchase(paymentIntentId: string, amount: number, purchaseTokenId?: string, donationTypeId?: number, donationAccountAddress?: string): Promise<PurchaseDTO>;
+    createPurchase(paymentIntentId: string, amount: number, purchaseTokenId?: string, donationTypeId?: number, donationAccountAddress?: string): Promise<PurchaseCreateResponseDTO>;
     /**
      * AUTH: Get all user purchases
      */
-    getAllUserPurchases(): Promise<PurchaseDTO[]>;
+    getAllUserPurchases(options?: PaginationOptions): Promise<PaginatedResponseDTO<PurchaseDTO>>;
 }
 //# sourceMappingURL=payment-service.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"payment-service.d.ts","sourceRoot":"","sources":["../../../src/payment/services/payment-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,WAAW,CAAC;AAEnB;;;;;;;;GAQG;AACH,qBAAa,cAAc;IACb,OAAO,CAAC,UAAU;gBAAV,UAAU,EAAE,UAAU;IAM1C;;OAEG;IACG,uBAAuB,CAAC,MAAM,GAAE,OAAc,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAIlF;;OAEG;IACG,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI3I;;OAEG;IACG,mBAAmB,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIpK;;OAEG;IACG,mBAAmB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAQ7E;;OAEG;IACG,cAAc,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,sBAAsB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAIvK;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;CAGpD"}
+{"version":3,"file":"payment-service.d.ts","sourceRoot":"","sources":["../../../src/payment/services/payment-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,yBAAyB,EAC1B,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAExE;;;;;;;;GAQG;AACH,qBAAa,cAAc;IACb,OAAO,CAAC,UAAU;gBAAV,UAAU,EAAE,UAAU;IAM1C;;OAEG;IACG,uBAAuB,CAAC,MAAM,GAAE,OAAc,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,gBAAgB,CAAC,CAAC;IAInI;;OAEG;IACG,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI3I;;OAEG;IACG,mBAAmB,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIpK;;OAEG;IACG,mBAAmB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAQ7E;;OAEG;IACG,cAAc,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,sBAAsB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAIrL;;OAEG;IACG,mBAAmB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;CAGnG"}

package/dist/payment.cjs

@@ -1,34 +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; }
+    enumerable: true,
+    get: function () { return persShared.MEMBERSHIP_ROLE_HIERARCHY; }
 });
 Object.defineProperty(exports, "MembershipRole", {
-	enumerable: true,
-	get: function () { return persShared.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; }
+    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, 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":";;;AAcA;;;;;;;;;;;;;;;AAeG;MACU,WAAW,CAAA;AACtB,IAAA,WAAA,CAAoB,SAAwB,EAAA;QAAxB,IAAA,CAAA,SAAS,GAAT,SAAS;QAEZ,IAAA,CAAA,QAAQ,GAAG,YAAY;IAFO;;;;AAQ/C;;;;;;;;;;;;;AAaG;AACH,IAAA,MAAM,iBAAiB,CAAC,MAAgB,EAAE,OAA2B,EAAA;AACnE,QAAA,MAAM,MAAM,GAAG,qBAAqB,CAAC,OAAO,CAAC;AAC7C,QAAA,IAAI,MAAM,KAAK,SAAS,EAAE;YACxB,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QACzC;QACA,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,CAAiC,CAAA,EAAG,IAAI,CAAC,QAAQ,WAAW,MAAM,CAAC,QAAQ,EAAE,CAAA,CAAE,CAAC;AACzH,QAAA,OAAO,oBAAoB,CAAC,QAAQ,CAAC;IACvC;AAEA;;;;;;;;AAQG;IACH,MAAM,gBAAgB,CAAC,OAA2B,EAAA;AAChD,QAAA,MAAM,MAAM,GAAG,qBAAqB,CAAC,OAAO,CAAC;QAC7C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,CAAgC,CAAA,EAAG,IAAI,CAAC,QAAQ,mBAAmB,MAAM,CAAC,QAAQ,EAAE,CAAA,CAAE,CAAC;AAChI,QAAA,OAAO,oBAAoB,CAAC,QAAQ,CAAC;IACvC;;;;AAMA;;;;;;;AAOG;IACH,MAAM,mBAAmB,CAAC,MAAc,EAAE,QAA0B,EAAE,YAAoB,EAAE,WAAmB,EAAA;AAC7G,QAAA,MAAM,IAAI,GAA2B;YACnC,MAAM;YACN,QAAQ;YACR,YAAY;YACZ;SACD;AACD,QAAA,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAmB,CAAA,EAAG,IAAI,CAAC,QAAQ,CAAA,gBAAA,CAAkB,EAAE,IAAI,CAAC;IACxF;AAEA;;;;;;;AAOG;IACH,MAAM,mBAAmB,CAAC,eAAuB,EAAE,MAAc,EAAE,QAA0B,EAAE,YAAoB,EAAE,WAAmB,EAAA;AACtI,QAAA,MAAM,IAAI,GAA2B;YACnC,MAAM;YACN,QAAQ;YACR,YAAY;YACZ;SACD;AACD,QAAA,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAmB,CAAA,EAAG,IAAI,CAAC,QAAQ,oBAAoB,eAAe,CAAA,CAAE,EAAE,IAAI,CAAC;IAC1G;AAEA;;;;;;;AAOG;IACH,MAAM,mBAAmB,CAAC,eAAuB,EAAA;AAC/C,QAAA,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAmB,CAAA,EAAG,IAAI,CAAC,QAAQ,CAAA,iBAAA,EAAoB,eAAe,CAAA,CAAE,CAAC;IACvG;;;;AAMA;;;;;;;;AAQG;IACH,MAAM,kBAAkB,CAAC,eAAuB,EAAE,MAAc,EAAE,eAAwB,EAAE,cAAuB,EAAE,sBAA+B,EAAA;AAClJ,QAAA,MAAM,IAAI,GAA6B;AACrC,YAAA,QAAQ,EAAE,MAAM;YAChB,eAAe,EAAE,eAAe,IAAI,EAAE;YACtC,cAAc;YACd,sBAAsB;YACtB;SACD;AACD,QAAA,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAA4B,CAAA,EAAG,IAAI,CAAC,QAAQ,CAAA,CAAE,EAAE,IAAI,CAAC;IACjF;AAEA;;;;;;;;;;;AAWG;IACH,MAAM,sBAAsB,CAAC,OAA2B,EAAA;AACtD,QAAA,MAAM,MAAM,GAAG,qBAAqB,CAAC,OAAO,CAAC;QAC7C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,CAA4B,CAAA,EAAG,IAAI,CAAC,QAAQ,eAAe,MAAM,CAAC,QAAQ,EAAE,CAAA,CAAE,CAAC;AACxH,QAAA,OAAO,oBAAoB,CAAC,QAAQ,CAAC;IACvC;AAED;;AChKD;;;;;;;;AAQG;MACU,cAAc,CAAA;AACzB,IAAA,WAAA,CAAoB,UAAsB,EAAA;QAAtB,IAAA,CAAA,UAAU,GAAV,UAAU;IAAe;;;;AAM7C;;AAEG;AACH,IAAA,MAAM,uBAAuB,CAAC,MAAA,GAAkB,IAAI,EAAE,OAA2B,EAAA;QAC/E,OAAO,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3D;AAEA;;AAEG;IACH,MAAM,mBAAmB,CAAC,MAAc,EAAE,QAA0B,EAAE,YAAoB,EAAE,WAAmB,EAAA;AAC7G,QAAA,OAAO,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,CAAC;IACzF;AAEA;;AAEG;IACH,MAAM,mBAAmB,CAAC,eAAuB,EAAE,MAAc,EAAE,QAA0B,EAAE,YAAoB,EAAE,WAAmB,EAAA;AACtI,QAAA,OAAO,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,CAAC;IAC1G;AAEA;;AAEG;IACH,MAAM,mBAAmB,CAAC,eAAuB,EAAA;QAC/C,OAAO,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,eAAe,CAAC;IAC7D;;;;AAMA;;AAEG;IACH,MAAM,cAAc,CAAC,eAAuB,EAAE,MAAc,EAAE,eAAwB,EAAE,cAAuB,EAAE,sBAA+B,EAAA;AAC9I,QAAA,OAAO,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,eAAe,EAAE,MAAM,EAAE,eAAe,EAAE,cAAc,EAAE,sBAAsB,CAAC;IAC7H;AAEA;;AAEG;IACH,MAAM,mBAAmB,CAAC,OAA2B,EAAA;QACnD,OAAO,IAAI,CAAC,UAAU,CAAC,sBAAsB,CAAC,OAAO,CAAC;IACxD;AACD;;;;"}