@explorins/pers-sdk 2.1.18 → 2.1.21

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

@@ -1,7 +1,7 @@
 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, RedemptionRedeemIncludeRelation } from '@explorins/pers-shared';
+import { RedemptionDTO, RedemptionCreateRequestDTO, RedemptionRedeemRequestDTO, RedemptionTypeDTO, RedemptionRedeemDTO, RedemptionRedeemRequestResponseDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
+import { PaginatedResponseDTO, RedemptionRedeemIncludeRelation, ProcessRecordStatus, SortOrder } from '@explorins/pers-shared';
 import { PaginationOptions } from '../../shared';
 /**
  * Platform-Agnostic Redemption API Client (UPDATED - RESTful Design)
@@ -27,13 +27,18 @@ export declare class RedemptionApi {
      * - Public users: Get active redemptions only
      * - Admin users: Get all redemptions with optional filtering
      *
-     * @param options - Filter and pagination options (active, adminAccess, page, limit, sortBy, sortOrder)
+     * @param options - Filter and pagination options (active, search, adminAccess, page, limit, sortBy, sortOrder)
      * @returns Paginated response with redemptions
      */
     getRedemptions(options?: {
         active?: boolean;
+        search?: string;
         adminAccess?: boolean;
-    } & PaginationOptions): Promise<PaginatedResponseDTO<RedemptionDTO>>;
+        page?: number;
+        limit?: number;
+        sortBy?: 'name' | 'createdAt';
+        sortOrder?: SortOrder;
+    }): Promise<PaginatedResponseDTO<RedemptionDTO>>;
     /**
      * PUBLIC: Get redemption types
      *
@@ -61,23 +66,26 @@ export declare class RedemptionApi {
      * - USER: Direct user redemption processing
      * - ADMIN: Can process redemptions for any account type
      * - BUSINESS: Process redemptions for customers
+     *
+     * @param request - Redemption request with optional context for dynamic NFT generation
      */
-    redeemRedemption(redemptionId: string): Promise<RedemptionRedeemRequestResponseDTO>;
+    redeemRedemption(request: RedemptionRedeemRequestDTO): Promise<RedemptionRedeemRequestResponseDTO>;
     /**
      * 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
+     * - Admins: Can filter by userId, businessId, redemptionId, or status
      *
-     * @param filters - Filter and pagination options (redemptionId, userId, businessId, myRedeems, page, limit, sortBy, sortOrder)
-     * @param include - Optional relations to include (redemption, user, business)
+     * @param filters - Filter and pagination options (redemptionId, userId, businessId, status, myRedeems, page, limit, sortBy, sortOrder)
+     * @param include - Optional relations to include (redemption, user, business, transactions)
      * @returns Paginated response with redemption redeems
      */
     getRedemptionRedeems(filters?: {
         redemptionId?: string;
         userId?: string;
         businessId?: string;
+        status?: ProcessRecordStatus;
         myRedeems?: boolean;
     } & PaginationOptions, include?: RedemptionRedeemIncludeRelation[]): Promise<PaginatedResponseDTO<RedemptionRedeemDTO>>;
     /**
@@ -90,12 +98,15 @@ export declare class RedemptionApi {
      * UNIFIED: Get user redemption history
      *
      * Uses convenience endpoint /redemption-redeems/me with optional filtering
-     * @param redemptionId - Optional filter by specific redemption
+     * @param filters - Optional filters (redemptionId, status)
      * @param options - Pagination options (page, limit, sortBy, sortOrder)
-     * @param include - Optional relations to include (redemption, user, business)
+     * @param include - Optional relations to include (redemption, user, business, transactions)
      * @returns Paginated response with user's redemption redeems
      */
-    getUserRedeems(redemptionId?: string, options?: PaginationOptions, include?: RedemptionRedeemIncludeRelation[]): Promise<PaginatedResponseDTO<RedemptionRedeemDTO>>;
+    getUserRedeems(filters?: {
+        redemptionId?: string;
+        status?: ProcessRecordStatus;
+    }, options?: PaginationOptions, include?: RedemptionRedeemIncludeRelation[]): Promise<PaginatedResponseDTO<RedemptionRedeemDTO>>;
     /**
      * ADMIN: Create redemption
      *

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":"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"}
+{"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,EAC1B,0BAA0B,EAC1B,iBAAiB,EACjB,mBAAmB,EACnB,kCAAkC,EACnC,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,+BAA+B,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC/H,OAAO,EAAE,iBAAiB,EAA6D,MAAM,cAAc,CAAC;AAE5G;;;;;;;;;;;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;QAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;QAC9B,SAAS,CAAC,EAAE,SAAS,CAAC;KACvB,GAAG,OAAO,CAAC,oBAAoB,CAAC,aAAa,CAAC,CAAC;IAgBhD;;;;;;OAMG;IACG,kBAAkB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;IAMvG;;;;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;;;;;;;;;OASG;IACG,gBAAgB,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,kCAAkC,CAAC;IAQxG;;;;;;;;;;OAUG;IACG,oBAAoB,CACxB,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,mBAAmB,CAAC;QAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,GAAG,iBAAiB,EACrB,OAAO,CAAC,EAAE,+BAA+B,EAAE,GAC1C,OAAO,CAAC,oBAAoB,CAAC,mBAAmB,CAAC,CAAC;IAqCrD;;;;OAIG;IACG,uBAAuB,CAC3B,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,+BAA+B,EAAE,GAC1C,OAAO,CAAC,mBAAmB,CAAC;IAgB/B;;;;;;;;OAQG;IACG,cAAc,CAClB,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,mBAAmB,CAAA;KAAE,EACjE,OAAO,CAAC,EAAE,iBAAiB,EAC3B,OAAO,CAAC,EAAE,+BAA+B,EAAE,GAC1C,OAAO,CAAC,oBAAoB,CAAC,mBAAmB,CAAC,CAAC;IAQrD;;;;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;;;;OAIG;IACG,oBAAoB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;CAIvD"}

package/dist/redemption/index.d.ts

@@ -5,6 +5,6 @@
  * Handles redemption operations across different authorization levels
  */
 export { RedemptionApi } from './api/redemption-api';
-export { RedemptionService } from './services/redemption-service';
+export { RedemptionService, type RedemptionFilterOptions } from './services/redemption-service';
 export type { RedemptionRedeemFilters, RedemptionRedeemQueryOptions } from './models';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/redemption/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAGlE,YAAY,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/redemption/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,OAAO,EAAE,iBAAiB,EAAE,KAAK,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAGhG,YAAY,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,MAAM,UAAU,CAAC"}

package/dist/redemption/models/index.d.ts

@@ -4,7 +4,7 @@
  * Re-exports from centralized pers-shared interfaces for consistency with backend
  * and to provide a single import source for redemption-related types.
  */
-import { RedemptionRedeemIncludeRelation } from '@explorins/pers-shared';
+import { RedemptionRedeemIncludeRelation, ProcessRecordStatus } from '@explorins/pers-shared';
 import { PaginationOptions } from '../../shared/utils/pagination-utils';
 export type { RedemptionDTO, RedemptionCreateRequestDTO, RedemptionRedeemRequestDTO, RedemptionTypeDTO, RedemptionTypeCreateRequestDTO, RedemptionRedeemDTO, RedemptionRedeemRequestResponseDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
 /**
@@ -16,6 +16,10 @@ export interface RedemptionRedeemFilters extends PaginationOptions {
     userId?: string;
     /** Filter by redemption offer ID */
     redemptionId?: string;
+    /** Filter by business ID (admin only) */
+    businessId?: string;
+    /** Filter by processing status (PENDING, PROCESSING, COMPLETED, FAILED) */
+    status?: ProcessRecordStatus;
 }
 /**
  * Query options for redemption redeems with include relations

package/dist/redemption/models/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/redemption/models/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAGxE,YAAY,EACV,aAAa,EACb,0BAA0B,EAC1B,0BAA0B,EAC1B,iBAAiB,EACjB,8BAA8B,EAC9B,mBAAmB,EACnB,kCAAkC,EACnC,MAAM,oDAAoD,CAAC;AAE5D;;;GAGG;AACH,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA6B,SAAQ,uBAAuB;IAC3E,iDAAiD;IACjD,OAAO,CAAC,EAAE,+BAA+B,EAAE,CAAC;CAC7C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/redemption/models/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,+BAA+B,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC9F,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAGxE,YAAY,EACV,aAAa,EACb,0BAA0B,EAC1B,0BAA0B,EAC1B,iBAAiB,EACjB,8BAA8B,EAC9B,mBAAmB,EACnB,kCAAkC,EACnC,MAAM,oDAAoD,CAAC;AAE5D;;;GAGG;AACH,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,4BAA6B,SAAQ,uBAAuB;IAC3E,iDAAiD;IACjD,OAAO,CAAC,EAAE,+BAA+B,EAAE,CAAC;CAC7C"}

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

@@ -1,7 +1,19 @@
-import { PaginatedResponseDTO, RedemptionRedeemIncludeRelation } from '@explorins/pers-shared';
+import { PaginatedResponseDTO, RedemptionRedeemIncludeRelation, ProcessRecordStatus, SortOrder } from '@explorins/pers-shared';
 import { RedemptionApi } from '../api/redemption-api';
-import { TokenUnitCreateRequestDTO, RedemptionDTO, RedemptionCreateRequestDTO, RedemptionTypeDTO, RedemptionRedeemDTO, RedemptionRedeemRequestResponseDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
+import { TokenUnitCreateRequestDTO, RedemptionDTO, RedemptionCreateRequestDTO, RedemptionTypeDTO, RedemptionRedeemDTO, RedemptionRedeemRequestDTO, RedemptionRedeemRequestResponseDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
 import { PaginationOptions } from '../../shared/utils/pagination-utils';
+/**
+ * Redemption filter options for getRedemptions
+ */
+export interface RedemptionFilterOptions {
+    active?: boolean;
+    search?: string;
+    adminAccess?: boolean;
+    page?: number;
+    limit?: number;
+    sortBy?: 'name' | 'createdAt';
+    sortOrder?: SortOrder;
+}
 /**
  * Platform-Agnostic Redemption Service
  *
@@ -16,12 +28,14 @@ export declare class RedemptionService {
     /**
      * UNIFIED: Get redemptions with intelligent access control and pagination
      * @param options.active - Filter by active status
+     * @param options.search - Free text search across name, description, tags (case-insensitive)
      * @param options.adminAccess - Force admin access
+     * @param options.page - Page number (1-indexed)
+     * @param options.limit - Results per page
+     * @param options.sortBy - Field to sort by ('name' | 'createdAt')
+     * @param options.sortOrder - Sort direction ('ASC' | 'DESC')
      */
-    getRedemptions(options?: {
-        active?: boolean;
-        adminAccess?: boolean;
-    }): Promise<PaginatedResponseDTO<RedemptionDTO>>;
+    getRedemptions(options?: RedemptionFilterOptions): Promise<PaginatedResponseDTO<RedemptionDTO>>;
     /**
      * Convenience: Get active redemptions (public)
      */
@@ -31,30 +45,38 @@ export declare class RedemptionService {
      */
     getRedemptionTypes(options?: PaginationOptions): Promise<PaginatedResponseDTO<RedemptionTypeDTO>>;
     /**
-     * AUTH: Redeem a redemption
+     * AUTH: Redeem a redemption with optional dynamic context
+     *
+     * @param request - Redemption request (can be just redemptionId string or full request with context)
      */
-    redeemRedemption(redemptionId: string): Promise<RedemptionRedeemRequestResponseDTO>;
+    redeemRedemption(request: string | RedemptionRedeemRequestDTO): Promise<RedemptionRedeemRequestResponseDTO>;
     /**
      * UNIFIED: Get redemption redeems with filtering and pagination
-     * @param filters - Filter options
-     * @param include - Optional relations to include (redemption, user, business)
+     * @param filters - Filter options (redemptionId, userId, businessId, status, myRedeems)
+     * @param include - Optional relations to include (redemption, user, business, transactions)
      */
     getRedemptionRedeems(filters?: {
         redemptionId?: string;
         userId?: string;
         businessId?: string;
+        status?: ProcessRecordStatus;
         myRedeems?: boolean;
     }, include?: RedemptionRedeemIncludeRelation[]): Promise<PaginatedResponseDTO<RedemptionRedeemDTO>>;
     /**
-     * Convenience: Get user redemptions with pagination
+     * Convenience: Get user redemptions with pagination and filtering
+     * @param filters - Optional filters (redemptionId, status)
      * @param options - Pagination options
-     * @param include - Optional relations to include (redemption, user, business)
+     * @param include - Optional relations to include (redemption, user, business, transactions)
      */
-    getUserRedeems(options?: PaginationOptions, include?: RedemptionRedeemIncludeRelation[]): Promise<PaginatedResponseDTO<RedemptionRedeemDTO>>;
+    getUserRedeems(filters?: {
+        redemptionId?: string;
+        status?: ProcessRecordStatus;
+    }, options?: PaginationOptions, include?: RedemptionRedeemIncludeRelation[]): Promise<PaginatedResponseDTO<RedemptionRedeemDTO>>;
     /**
-     * Convenience: Get redemptions as admin
+     * Convenience: Get redemptions as admin with filtering and search
+     * @param options - Filter options (active, search, pagination)
      */
-    getRedemptionsAsAdmin(active?: boolean, options?: PaginationOptions): Promise<PaginatedResponseDTO<RedemptionDTO>>;
+    getRedemptionsAsAdmin(options?: RedemptionFilterOptions): Promise<PaginatedResponseDTO<RedemptionDTO>>;
     /**
      * ADMIN: Create redemption
      */

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

@@ -1 +1 @@
-{"version":3,"file":"redemption-service.d.ts","sourceRoot":"","sources":["../../../src/redemption/services/redemption-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AAC/F,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGtD,OAAO,EACL,yBAAyB,EACzB,aAAa,EACb,0BAA0B,EAC1B,iBAAiB,EACjB,mBAAmB,EACnB,kCAAkC,EACnC,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE;;;;;;;GAOG;AACH,qBAAa,iBAAiB;IAChB,OAAO,CAAC,aAAa;gBAAb,aAAa,EAAE,aAAa;IAMhD;;;;OAIG;IACG,cAAc,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC,aAAa,CAAC,CAAC;IAIzH;;OAEG;IACG,oBAAoB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAItD;;OAEG;IACG,kBAAkB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;IAQvG;;OAEG;IACG,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,kCAAkC,CAAC;IAIzF;;;;OAIG;IACG,oBAAoB,CACxB,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,EACD,OAAO,CAAC,EAAE,+BAA+B,EAAE,GAC1C,OAAO,CAAC,oBAAoB,CAAC,mBAAmB,CAAC,CAAC;IAIrD;;;;OAIG;IACG,cAAc,CAClB,OAAO,CAAC,EAAE,iBAAiB,EAC3B,OAAO,CAAC,EAAE,+BAA+B,EAAE,GAC1C,OAAO,CAAC,oBAAoB,CAAC,mBAAmB,CAAC,CAAC;IAQrD;;OAEG;IACG,qBAAqB,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,aAAa,CAAC,CAAC;IAIxH;;OAEG;IACG,gBAAgB,CAAC,UAAU,EAAE,0BAA0B,GAAG,OAAO,CAAC,aAAa,CAAC;IAItF;;OAEG;IACG,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,uBAAuB,EAAE,0BAA0B,GAAG,OAAO,CAAC,aAAa,CAAC;IAI/G;;OAEG;IACG,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAI1E;;OAEG;IACG,yBAAyB,CAAC,YAAY,EAAE,MAAM,EAAE,mBAAmB,EAAE,yBAAyB,GAAG,OAAO,CAAC,aAAa,CAAC;IAI7H;;OAEG;IACG,yBAAyB,CAAC,YAAY,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAG7G"}
+{"version":3,"file":"redemption-service.d.ts","sourceRoot":"","sources":["../../../src/redemption/services/redemption-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,+BAA+B,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC/H,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGtD,OAAO,EACL,yBAAyB,EACzB,aAAa,EACb,0BAA0B,EAC1B,iBAAiB,EACjB,mBAAmB,EACnB,0BAA0B,EAC1B,kCAAkC,EACnC,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC9B,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,qBAAa,iBAAiB;IAChB,OAAO,CAAC,aAAa;gBAAb,aAAa,EAAE,aAAa;IAMhD;;;;;;;;;OASG;IACG,cAAc,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,oBAAoB,CAAC,aAAa,CAAC,CAAC;IAIrG;;OAEG;IACG,oBAAoB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAItD;;OAEG;IACG,kBAAkB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;IAQvG;;;;OAIG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,0BAA0B,GAAG,OAAO,CAAC,kCAAkC,CAAC;IAQjH;;;;OAIG;IACG,oBAAoB,CACxB,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,mBAAmB,CAAC;QAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,EACD,OAAO,CAAC,EAAE,+BAA+B,EAAE,GAC1C,OAAO,CAAC,oBAAoB,CAAC,mBAAmB,CAAC,CAAC;IAIrD;;;;;OAKG;IACG,cAAc,CAClB,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,mBAAmB,CAAA;KAAE,EACjE,OAAO,CAAC,EAAE,iBAAiB,EAC3B,OAAO,CAAC,EAAE,+BAA+B,EAAE,GAC1C,OAAO,CAAC,oBAAoB,CAAC,mBAAmB,CAAC,CAAC;IAQrD;;;OAGG;IACG,qBAAqB,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,oBAAoB,CAAC,aAAa,CAAC,CAAC;IAI5G;;OAEG;IACG,gBAAgB,CAAC,UAAU,EAAE,0BAA0B,GAAG,OAAO,CAAC,aAAa,CAAC;IAItF;;OAEG;IACG,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,uBAAuB,EAAE,0BAA0B,GAAG,OAAO,CAAC,aAAa,CAAC;IAI/G;;OAEG;IACG,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAI1E;;OAEG;IACG,yBAAyB,CAAC,YAAY,EAAE,MAAM,EAAE,mBAAmB,EAAE,yBAAyB,GAAG,OAAO,CAAC,aAAa,CAAC;IAI7H;;OAEG;IACG,yBAAyB,CAAC,YAAY,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAG7G"}

package/dist/redemption.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var redemptionService = require('./chunks/redemption-service-C61Qr2vI.cjs');
+var redemptionService = require('./chunks/redemption-service-OY_JjwCL.cjs');
 require('@explorins/pers-shared');
 require('./chunks/pagination-utils-B2jRHMSO.cjs');
 

package/dist/redemption.js

@@ -1,4 +1,4 @@
-export { R as RedemptionApi, a as RedemptionService } from './chunks/redemption-service-C_UTTDag.js';
+export { R as RedemptionApi, a as RedemptionService } from './chunks/redemption-service-CoyjUi8C.js';
 import '@explorins/pers-shared';
 import './chunks/pagination-utils-9vQ-Npkr.js';
 //# sourceMappingURL=redemption.js.map

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

@@ -1,5 +1,5 @@
 import { PersApiClient } from '../../core/pers-api-client';
-import { TokenDTO, TokenTypeDTO, TokenCreateRequestDTO, TokenStorageData, TokenUpdateRequestDTO, TokenMetadataDTO } from '../models';
+import { TokenDTO, TokenTypeDTO, TokenCreateRequestDTO, TokenMetadataCreateRequestDTO, TokenUpdateRequestDTO, TokenMetadataDTO } from '../models';
 import { PaginatedResponseDTO } from '@explorins/pers-shared';
 import { PaginationOptions } from '../../shared';
 export declare class TokenApi {
@@ -68,12 +68,12 @@ export declare class TokenApi {
     /**
      * ADMIN: Create token metadata
      */
-    createTokenMetadata(tokenId: string, tokenData: TokenStorageData): Promise<TokenDTO>;
+    createTokenMetadata(tokenId: string, tokenData: TokenMetadataCreateRequestDTO): Promise<TokenDTO>;
     /**
      * ADMIN: Update token metadata (ERC721 only)
      * Note: Existing minted NFTs retain their original metadata - this only affects future mints
      */
-    updateTokenMetadata(metadataId: string, tokenData: TokenStorageData): Promise<TokenMetadataDTO>;
+    updateTokenMetadata(metadataId: string, tokenData: TokenMetadataCreateRequestDTO): Promise<TokenMetadataDTO>;
     /**
      * ADMIN: Toggle token metadata status (separate from token status)
      */

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

@@ -1 +1 @@
-{"version":3,"file":"token-api.d.ts","sourceRoot":"","sources":["../../../src/token/api/token-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,qBAAqB,EACrB,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAA6D,MAAM,cAAc,CAAC;AAG5G,qBAAa,QAAQ;IACP,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,aAAa;IAE5C,OAAO,CAAC,QAAQ,CAAa;IAM7B;;;;;;;OAOG;IACG,eAAe,CAAC,eAAe,GAAE,OAAe,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAS7H;;;;;OAKG;IACG,mBAAmB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC;IAMnG;;OAEG;IACG,0BAA0B,IAAI,OAAO,CAAC,QAAQ,CAAC;IAIrD;;;;;;;OAOG;IACG,qBAAqB,CAAC,eAAe,GAAE,OAAe,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IASnI;;;;;;;OAOG;IACG,qBAAqB,CAAC,eAAe,GAAE,OAAe,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IASnI;;OAEG;IACG,yBAAyB,CAAC,eAAe,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC;IAY3G;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAItE;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIvF;;;OAGG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI3D;;OAEG;IACG,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAOtG;;OAEG;IACG,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI1F;;;OAGG;IACG,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIrG;;OAEG;IACG,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI9E;;OAEG;IACG,eAAe,CAAC,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;CAGtE"}
+{"version":3,"file":"token-api.d.ts","sourceRoot":"","sources":["../../../src/token/api/token-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,qBAAqB,EACrB,6BAA6B,EAC7B,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAA6D,MAAM,cAAc,CAAC;AAG5G,qBAAa,QAAQ;IACP,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,aAAa;IAE5C,OAAO,CAAC,QAAQ,CAAa;IAM7B;;;;;;;OAOG;IACG,eAAe,CAAC,eAAe,GAAE,OAAe,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAS7H;;;;;OAKG;IACG,mBAAmB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC;IAMnG;;OAEG;IACG,0BAA0B,IAAI,OAAO,CAAC,QAAQ,CAAC;IAIrD;;;;;;;OAOG;IACG,qBAAqB,CAAC,eAAe,GAAE,OAAe,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IASnI;;;;;;;OAOG;IACG,qBAAqB,CAAC,eAAe,GAAE,OAAe,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IASnI;;OAEG;IACG,yBAAyB,CAAC,eAAe,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC;IAY3G;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAItE;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIvF;;;OAGG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI3D;;OAEG;IACG,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAOtG;;OAEG;IACG,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,6BAA6B,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIvG;;;OAGG;IACG,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,6BAA6B,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIlH;;OAEG;IACG,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI9E;;OAEG;IACG,eAAe,CAAC,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;CAGtE"}

package/dist/token/base/base-token-service.d.ts

@@ -1,6 +1,6 @@
 import { PaginatedResponseDTO } from '@explorins/pers-shared';
 import { PersApiClient } from '../../core/pers-api-client';
-import { TokenDTO, TokenStorageData, TokenCreateRequestDTO, TokenUpdateRequestDTO, TokenMetadataDTO } from '../models';
+import { TokenDTO, TokenMetadataCreateRequestDTO, TokenCreateRequestDTO, TokenUpdateRequestDTO, TokenMetadataDTO } from '../models';
 import { TokenTypeDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
 /**
  * Abstract Base Token Service - Explicit Initialization Pattern
@@ -59,7 +59,7 @@ export declare abstract class BaseTokenService {
     /**
      * ADMIN: Create token metadata
      */
-    createTokenMetadata(tokenId: string, tokenData: TokenStorageData): Promise<TokenDTO>;
+    createTokenMetadata(tokenId: string, tokenData: TokenMetadataCreateRequestDTO): Promise<TokenDTO>;
     /**
      * ADMIN: Toggle token active status
      */

package/dist/token/base/base-token-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-token-service.d.ts","sourceRoot":"","sources":["../../../src/token/base/base-token-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAG3D,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,YAAY,EAAE,MAAM,oDAAoD,CAAC;AAElF;;;;;;;;;;;;GAYG;AACH,8BAAsB,gBAAgB;IAEpC,OAAO,CAAC,SAAS,CAAC,CAAW;IAC7B,OAAO,CAAC,qBAAqB,CAAC,CAAuB;IACrD,OAAO,CAAC,cAAc,CAAS;IAM/B;;;OAGG;IACH,SAAS,CAAC,sBAAsB,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI;IAYhE;;OAEG;IACH,SAAS,KAAK,yBAAyB,IAAI,OAAO,CAEjD;IAED;;OAEG;IACH,OAAO,KAAK,oBAAoB,GAK/B;IAMD;;OAEG;IACI,eAAe,IAAI,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAIjE;;OAEG;IACI,mBAAmB,IAAI,OAAO,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC;IAIzE;;OAEG;IACI,0BAA0B,IAAI,OAAO,CAAC,QAAQ,CAAC;IAItD;;OAEG;IACI,qBAAqB,IAAI,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAIvE;;OAEG;IACI,qBAAqB,IAAI,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAIvE;;OAEG;IACI,yBAAyB,CAAC,eAAe,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQ5G;;OAEG;IACI,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI3F;;OAEG;IACI,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI5D;;OAEG;IACI,WAAW,CAAC,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIvE;;OAEG;IACI,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIxF;;OAEG;IACI,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIvG;;OAEG;IACI,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI/E;;OAEG;IACI,eAAe,CAAC,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;CAGvE"}
+{"version":3,"file":"base-token-service.d.ts","sourceRoot":"","sources":["../../../src/token/base/base-token-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAG3D,OAAO,EACL,QAAQ,EACR,6BAA6B,EAC7B,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,YAAY,EAAE,MAAM,oDAAoD,CAAC;AAElF;;;;;;;;;;;;GAYG;AACH,8BAAsB,gBAAgB;IAEpC,OAAO,CAAC,SAAS,CAAC,CAAW;IAC7B,OAAO,CAAC,qBAAqB,CAAC,CAAuB;IACrD,OAAO,CAAC,cAAc,CAAS;IAM/B;;;OAGG;IACH,SAAS,CAAC,sBAAsB,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI;IAYhE;;OAEG;IACH,SAAS,KAAK,yBAAyB,IAAI,OAAO,CAEjD;IAED;;OAEG;IACH,OAAO,KAAK,oBAAoB,GAK/B;IAMD;;OAEG;IACI,eAAe,IAAI,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAIjE;;OAEG;IACI,mBAAmB,IAAI,OAAO,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC;IAIzE;;OAEG;IACI,0BAA0B,IAAI,OAAO,CAAC,QAAQ,CAAC;IAItD;;OAEG;IACI,qBAAqB,IAAI,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAIvE;;OAEG;IACI,qBAAqB,IAAI,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAIvE;;OAEG;IACI,yBAAyB,CAAC,eAAe,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQ5G;;OAEG;IACI,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,6BAA6B,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIxG;;OAEG;IACI,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI5D;;OAEG;IACI,WAAW,CAAC,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIvE;;OAEG;IACI,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIxF;;OAEG;IACI,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIvG;;OAEG;IACI,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI/E;;OAEG;IACI,eAAe,CAAC,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;CAGvE"}

package/dist/token/models/index.d.ts

@@ -4,7 +4,7 @@
  * Re-exports from @explorins/pers-shared for consistency with backend
  * and to provide a single import source for token-related types.
  */
-export type { TokenDTO, TokenTypeDTO, TokenCreateRequestDTO, TokenUpdateRequestDTO, TokenMetadataDTO, TokenStorageData, NativeTokenType } from '../../shared/interfaces/pers-shared-lib.interfaces';
+export type { TokenDTO, TokenTypeDTO, TokenCreateRequestDTO, TokenUpdateRequestDTO, TokenMetadataDTO, TokenMetadataCreateRequestDTO, TokenStorageData, NativeTokenType } from '../../shared/interfaces/pers-shared-lib.interfaces';
 export interface TokenMetadataAttribute {
     trait_type: TokenMetadataAttributeType;
     value: string;

package/dist/token/models/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/token/models/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EAChB,MAAM,oDAAoD,CAAC;AAG5D,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,0BAA0B,CAAC;IACvC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,0BAA0B,GAAG,aAAa,GAAG,yBAAyB,GAAG,aAAa,GAAG,uBAAuB,CAAA;AAE5H,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/token/models/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,6BAA6B,EAC7B,gBAAgB,EAChB,eAAe,EAChB,MAAM,oDAAoD,CAAC;AAG5D,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,0BAA0B,CAAC;IACvC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,0BAA0B,GAAG,aAAa,GAAG,yBAAyB,GAAG,aAAa,GAAG,uBAAuB,CAAA;AAE5H,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

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

@@ -1,6 +1,6 @@
 import { PaginatedResponseDTO } from '@explorins/pers-shared';
 import { TokenApi } from '../api/token-api';
-import { TokenDTO, TokenStorageData, TokenCreateRequestDTO, TokenUpdateRequestDTO, TokenMetadataDTO } from '../models';
+import { TokenDTO, TokenMetadataCreateRequestDTO, TokenCreateRequestDTO, TokenUpdateRequestDTO, TokenMetadataDTO } from '../models';
 import { TokenTypeDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
 import { PaginationOptions } from '../../shared/utils/pagination-utils';
 /**
@@ -41,12 +41,12 @@ export declare class TokenService {
     /**
      * ADMIN: Create token metadata
      */
-    createTokenMetadata(tokenId: string, tokenData: TokenStorageData): Promise<TokenDTO>;
+    createTokenMetadata(tokenId: string, tokenData: TokenMetadataCreateRequestDTO): Promise<TokenDTO>;
     /**
      * ADMIN: Update token metadata (ERC721 only)
      * Note: Existing minted NFTs retain their original metadata - this only affects future mints
      */
-    updateTokenMetadata(metadataId: string, tokenData: TokenStorageData): Promise<TokenMetadataDTO>;
+    updateTokenMetadata(metadataId: string, tokenData: TokenMetadataCreateRequestDTO): Promise<TokenMetadataDTO>;
     /**
      * ADMIN: Toggle token active status
      */

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

@@ -1 +1 @@
-{"version":3,"file":"token-service.d.ts","sourceRoot":"","sources":["../../../src/token/services/token-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,YAAY,EAAE,MAAM,oDAAoD,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAExE;;;;;;GAMG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,QAAQ;IAMtC;;OAEG;IACG,eAAe,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAI3F;;OAEG;IACG,mBAAmB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC;IAInG;;OAEG;IACG,0BAA0B,IAAI,OAAO,CAAC,QAAQ,CAAC;IAIrD;;OAEG;IACG,qBAAqB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAIjG;;OAEG;IACG,qBAAqB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAIjG;;;OAGG;IACG,yBAAyB,CAAC,eAAe,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQ3G;;OAEG;IACG,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI1F;;;OAGG;IACG,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIrG;;OAEG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI3D;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAItE;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIvF;;OAEG;IACG,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAItG;;OAEG;IACG,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI9E;;OAEG;IACG,eAAe,CAAC,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;CAQtE"}
+{"version":3,"file":"token-service.d.ts","sourceRoot":"","sources":["../../../src/token/services/token-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EACL,QAAQ,EACR,6BAA6B,EAC7B,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,YAAY,EAAE,MAAM,oDAAoD,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAExE;;;;;;GAMG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,QAAQ;IAMtC;;OAEG;IACG,eAAe,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAI3F;;OAEG;IACG,mBAAmB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC;IAInG;;OAEG;IACG,0BAA0B,IAAI,OAAO,CAAC,QAAQ,CAAC;IAIrD;;OAEG;IACG,qBAAqB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAIjG;;OAEG;IACG,qBAAqB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAIjG;;;OAGG;IACG,yBAAyB,CAAC,eAAe,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQ3G;;OAEG;IACG,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,6BAA6B,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIvG;;;OAGG;IACG,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,6BAA6B,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIlH;;OAEG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI3D;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAItE;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIvF;;OAEG;IACG,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAItG;;OAEG;IACG,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI9E;;OAEG;IACG,eAAe,CAAC,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;CAQtE"}

package/dist/token/token-sdk.d.ts

@@ -2,7 +2,7 @@ import { PaginatedResponseDTO } from '@explorins/pers-shared';
 import { TokenApi } from './api/token-api';
 import { TokenService } from './services/token-service';
 import { PersApiClient } from '../core/pers-api-client';
-import { TokenDTO, TokenStorageData, TokenCreateRequestDTO, TokenUpdateRequestDTO, TokenMetadataDTO } from './models';
+import { TokenDTO, TokenMetadataCreateRequestDTO, TokenCreateRequestDTO, TokenUpdateRequestDTO, TokenMetadataDTO } from './models';
 import { TokenTypeDTO } from '../shared/interfaces/pers-shared-lib.interfaces';
 /**
  * Token SDK - Class-based Promise SDK for Token Operations
@@ -54,18 +54,18 @@ export declare class TokenSDK {
     /**
      * Create token metadata
      * @param tokenId - The token ID
-     * @param tokenData - The token storage data
+     * @param tokenData - The token metadata request data
      * @returns Promise with the updated token
      */
-    createTokenMetadata(tokenId: string, tokenData: TokenStorageData): Promise<TokenDTO>;
+    createTokenMetadata(tokenId: string, tokenData: TokenMetadataCreateRequestDTO): Promise<TokenDTO>;
     /**
      * Update token metadata (ERC721 only)
      * Note: Existing minted NFTs retain their original metadata - this only affects future mints
      * @param metadataId - The metadata ID to update
-     * @param tokenData - The token storage data
+     * @param tokenData - The token metadata request data
      * @returns Promise with the updated metadata
      */
-    updateTokenMetadata(metadataId: string, tokenData: TokenStorageData): Promise<TokenMetadataDTO>;
+    updateTokenMetadata(metadataId: string, tokenData: TokenMetadataCreateRequestDTO): Promise<TokenMetadataDTO>;
     /**
      * Toggle token active status
      * @param tokenId - The token ID to toggle

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

@@ -1 +1 @@
-{"version":3,"file":"token-sdk.d.ts","sourceRoot":"","sources":["../../src/token/token-sdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,YAAY,EAAE,MAAM,iDAAiD,CAAC;AAE/E;;;;;;;;;;GAUG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;gBAEhC,SAAS,EAAE,aAAa;IAUpC;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAI1D;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC;IAIlE;;;OAGG;IACG,oBAAoB,IAAI,OAAO,CAAC,QAAQ,CAAC;IAI/C;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAIhE;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAIhE;;;;;OAKG;IACG,kBAAkB,CAAC,eAAe,EAAE,MAAM,EAAE,eAAe,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQ3G;;;;;OAKG;IACG,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI1F;;;;;;OAMG;IACG,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIrG;;;;OAIG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI3D;;;;OAIG;IACG,WAAW,CAAC,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAItE;;;;;OAKG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIvF;;;;;;OAMG;IACG,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAItG;;;;OAIG;IACG,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI9E;;;;OAIG;IACG,eAAe,CAAC,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAQrE;;;OAGG;IACH,eAAe,IAAI,YAAY;IAI/B;;;OAGG;IACH,WAAW,IAAI,QAAQ;CAGxB"}
+{"version":3,"file":"token-sdk.d.ts","sourceRoot":"","sources":["../../src/token/token-sdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EACL,QAAQ,EACR,6BAA6B,EAC7B,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,YAAY,EAAE,MAAM,iDAAiD,CAAC;AAE/E;;;;;;;;;;GAUG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;gBAEhC,SAAS,EAAE,aAAa;IAUpC;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAI1D;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC;IAIlE;;;OAGG;IACG,oBAAoB,IAAI,OAAO,CAAC,QAAQ,CAAC;IAI/C;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAIhE;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAIhE;;;;;OAKG;IACG,kBAAkB,CAAC,eAAe,EAAE,MAAM,EAAE,eAAe,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQ3G;;;;;OAKG;IACG,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,6BAA6B,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIvG;;;;;;OAMG;IACG,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,6BAA6B,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIlH;;;;OAIG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI3D;;;;OAIG;IACG,WAAW,CAAC,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAItE;;;;;OAKG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIvF;;;;;;OAMG;IACG,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAItG;;;;OAIG;IACG,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI9E;;;;OAIG;IACG,eAAe,CAAC,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAQrE;;;OAGG;IACH,eAAe,IAAI,YAAY;IAI/B;;;OAGG;IACH,WAAW,IAAI,QAAQ;CAGxB"}

package/dist/token.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var baseTokenService = require('./chunks/base-token-service-Bu7ufXtf.cjs');
+var baseTokenService = require('./chunks/base-token-service-CReAW_nz.cjs');
 var tokenService = require('./chunks/token-service-C1xe11OX.cjs');
 require('@explorins/pers-shared');
 require('./chunks/pagination-utils-B2jRHMSO.cjs');

package/dist/token.js

@@ -1,4 +1,4 @@
-export { B as BaseTokenService, T as TokenSDK, g as getMetadataFromTokenUnitResponse } from './chunks/base-token-service-C838kf06.js';
+export { B as BaseTokenService, T as TokenSDK, g as getMetadataFromTokenUnitResponse } from './chunks/base-token-service-BiSXWqOy.js';
 export { T as TokenApi, a as TokenService } from './chunks/token-service-BxEO5YVN.js';
 import '@explorins/pers-shared';
 import './chunks/pagination-utils-9vQ-Npkr.js';

package/dist/transaction/models/transaction-request.builder.d.ts

@@ -1,4 +1,4 @@
-import { TransactionRequestDTO, Web3TransactionType, AccountOwnerType, TransactionSubmissionRequestDTO, TransactionRequestResponseDTO } from '@explorins/pers-shared';
+import { TransactionRequestDTO, Web3TransactionType, AccountOwnerType, TransactionSubmissionRequestDTO, TransactionRequestResponseDTO, DynamicContext } from '@explorins/pers-shared';
 /**
  * 🔍 Check if a transaction response requires external wallet signing
  *
@@ -138,7 +138,7 @@ export interface POSAuthorizationOptions {
  * 🎯 Build a MINT transaction request (admin/business endpoint)
  * Creates tokens and assigns them to a recipient account
  *
- * @example
+ * @example Basic Mint
  * ```typescript
  * const request = buildMintRequest({
  *   amount: 100,
@@ -149,6 +149,27 @@ export interface POSAuthorizationOptions {
  *   engagedBusinessId: 'business-456' // optional: for tracking which business triggered the mint
  * });
  * ```
+ *
+ * @example ERC721 Mint with Dynamic Context
+ * ```typescript
+ * const request = buildMintRequest({
+ *   amount: 1,
+ *   contractAddress: '0x...',
+ *   contractTokenId: '123', // TokenMetadata ID
+ *   chainId: 137,
+ *   recipientAccountId: 'user-123',
+ *   recipientAccountType: AccountOwnerType.USER,
+ *   context: {
+ *     // Validity control
+ *     validityDate: '2026-04-15T14:00:00Z',
+ *     validityEndDate: '2026-04-20T11:00:00Z',
+ *     // AI prompt placeholders (available as {{context.xxx}})
+ *     guestName: 'John Doe',
+ *     roomNumber: '305',
+ *     awardReason: 'Employee of the Month'
+ *   }
+ * });
+ * ```
  */
 export declare function buildMintRequest(data: {
     amount: number;
@@ -160,6 +181,12 @@ export declare function buildMintRequest(data: {
     recipientAccountAddress?: string;
     /** Business commercially involved in this transaction (for stats/reporting) */
     engagedBusinessId?: string;
+    /**
+     * Dynamic context for ERC721 template interpolation and AI prompts.
+     * Values become available as {{context.keyName}} placeholders.
+     * Special keys: validityDate, validityEndDate, validityDuration
+     */
+    context?: DynamicContext;
 }): TransactionRequestDTO;
 /**
  * 🎯 Build a BURN transaction request

package/dist/transaction/models/transaction-request.builder.d.ts.map

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

package/dist/transaction.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var transactionRequest_builder = require('./chunks/transaction-request.builder-CW3Wwdi3.cjs');
+var transactionRequest_builder = require('./chunks/transaction-request.builder-D8pIzjYD.cjs');
 require('@explorins/pers-shared');
 require('./chunks/pagination-utils-B2jRHMSO.cjs');
 

package/dist/transaction.js

@@ -1,4 +1,4 @@
-export { C as ClientTransactionType, T as TransactionApi, a as TransactionService, c as buildBurnRequest, b as buildMintRequest, f as buildPOSBurnRequest, e as buildPOSTransferRequest, i as buildPendingTransactionData, g as buildSubmissionRequest, d as buildTransferRequest, h as extractDeadlineFromSigningData, k as getSigningUrl, n as needsExternalSigning, j as needsSubmission } from './chunks/transaction-request.builder-C3C19kCx.js';
+export { C as ClientTransactionType, T as TransactionApi, a as TransactionService, c as buildBurnRequest, b as buildMintRequest, f as buildPOSBurnRequest, e as buildPOSTransferRequest, i as buildPendingTransactionData, g as buildSubmissionRequest, d as buildTransferRequest, h as extractDeadlineFromSigningData, k as getSigningUrl, n as needsExternalSigning, j as needsSubmission } from './chunks/transaction-request.builder-BZ6Uq6Qe.js';
 import '@explorins/pers-shared';
 import './chunks/pagination-utils-9vQ-Npkr.js';
 //# sourceMappingURL=transaction.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@explorins/pers-sdk",
-  "version": "2.1.18",
+  "version": "2.1.21",
   "description": "Platform-agnostic SDK for PERS (Phygital Experience Rewards System) - Core business logic and API integration",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -132,7 +132,7 @@
     "publish-with-docs": "npm run clean && npm run build && npm run docs && npm version patch && npm publish"
   },
   "dependencies": {
-    "@explorins/pers-shared": "^2.1.122",
+    "@explorins/pers-shared": "^2.1.124",
     "@explorins/web3-ts": "^0.3.77",
     "@explorins/web3-types": "^1.2.0",
     "ethers": "^6.15.0"