@explorins/pers-sdk 2.1.33 → 2.1.39

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

@@ -1,7 +1,7 @@
 import { PaginatedResponseDTO } from '@explorins/pers-shared';
 import { PersApiClient } from '../core/pers-api-client';
-import { TokenService } from '../token';
-import type { TokenDTO } from '../token/models';
+import { TokenService, TokenMetadataQueryOptions, RewardsFilterOptions, StampsFilterOptions } from '../token';
+import type { TokenDTO, TokenMetadataDTO } from '../token/models';
 import { PaginationOptions } from '../shared/utils/pagination-utils';
 /**
  * Domain Token Manager - Clean, high-level interface for business token operations
@@ -193,6 +193,101 @@ export declare class TokenManager {
      * ```
      */
     getTokenByContract(contractAddress: string, contractTokenId?: string | null): Promise<TokenDTO>;
+    /**
+     * Get all token metadata with filtering, pagination, and include relations
+     *
+     * Retrieves token metadata (rewards/stamps) with server-side filtering, pagination,
+     * and optional include relations for additional data.
+     * Useful for displaying rewards (ERC1155) or stamps (ERC721) in admin tables.
+     * Non-admin users always get active metadata only.
+     *
+     * @param options - Filter, pagination, and include options
+     * @returns Promise resolving to paginated token metadata
+     *
+     * @example Get paginated rewards with counts
+     * ```typescript
+     * const rewards = await sdk.tokens.getTokenMetadata({
+     *   tokenType: 'ERC1155',
+     *   active: true,
+     *   page: 1,
+     *   limit: 10,
+     *   sortBy: 'name',
+     *   sortOrder: 'ASC',
+     *   include: ['mintCount', 'burnCount', 'token']
+     * });
+     *
+     * rewards.data.forEach(r => {
+     *   console.log(`${r.name}: ${r.mintCount} minted, ${r.burnCount} burned`);
+     *   console.log(`Contract: ${r.included?.token?.contractAddress}`);
+     * });
+     * ```
+     *
+     * @example Get stamps with owner business
+     * ```typescript
+     * const stamps = await sdk.tokens.getTokenMetadata({
+     *   tokenType: 'ERC721',
+     *   search: 'gold',
+     *   include: ['ownerBusiness', 'token']
+     * });
+     *
+     * stamps.data.forEach(s => {
+     *   console.log(`${s.name} owned by ${s.included?.ownerBusiness?.displayName}`);
+     * });
+     * ```
+     */
+    getTokenMetadata(options?: TokenMetadataQueryOptions): Promise<PaginatedResponseDTO<TokenMetadataDTO>>;
+    /**
+     * Get rewards (ERC1155 token metadata) with filtering, pagination, and include relations
+     *
+     * Convenience method for fetching reward metadata. Rewards are ERC1155 tokens
+     * that represent collectible items, vouchers, or other redeemable rewards.
+     *
+     * @param options - Filter, pagination, and include options (tokenType is set automatically)
+     * @returns Promise resolving to paginated reward metadata
+     *
+     * @example Get active rewards with mint counts
+     * ```typescript
+     * const rewards = await sdk.tokens.getRewards({
+     *   active: true,
+     *   limit: 10,
+     *   include: ['mintCount', 'burnCount', 'token', 'ownerBusiness']
+     * });
+     *
+     * rewards.data.forEach(r => {
+     *   console.log(`${r.name}: ${r.mintCount ?? 0} minted`);
+     *   if (r.included?.token) {
+     *     console.log(`  Chain: ${r.included.token.chainId}, Contract: ${r.included.token.contractAddress}`);
+     *   }
+     * });
+     * ```
+     */
+    getRewards(options?: RewardsFilterOptions): Promise<PaginatedResponseDTO<TokenMetadataDTO>>;
+    /**
+     * Get stamps (ERC721 token metadata) with filtering, pagination, and include relations
+     *
+     * Convenience method for fetching stamp metadata. Stamps are ERC721 tokens
+     * that represent achievements, badges, or collectible status markers.
+     *
+     * @param options - Filter, pagination, and include options (tokenType is set automatically)
+     * @returns Promise resolving to paginated stamp metadata
+     *
+     * @example Get active stamps with all includes
+     * ```typescript
+     * const stamps = await sdk.tokens.getStamps({
+     *   active: true,
+     *   limit: 10,
+     *   include: ['mintCount', 'burnCount', 'token', 'ownerBusiness']
+     * });
+     *
+     * stamps.data.forEach(s => {
+     *   console.log(`${s.name}: ${s.mintCount ?? 0} minted`);
+     *   if (s.included?.ownerBusiness) {
+     *     console.log(`  Owner: ${s.included.ownerBusiness.displayName}`);
+     *   }
+     * });
+     * ```
+     */
+    getStamps(options?: StampsFilterOptions): Promise<PaginatedResponseDTO<TokenMetadataDTO>>;
     /**
      * Admin: Create new token
      *
@@ -278,6 +373,30 @@ export declare class TokenManager {
      * ```
      */
     toggleTokenActive(tokenId: string): Promise<TokenDTO>;
+    /**
+     * Admin: Delete token metadata (soft delete)
+     *
+     * Soft deletes token metadata by setting deletedAt timestamp.
+     * Requires administrator privileges. Will fail with 409 Conflict
+     * if metadata is currently in use by active campaigns or redemptions.
+     *
+     * @param metadataId - ID of the token metadata to delete
+     * @throws {PersApiError} When not authenticated as admin
+     * @throws {PersApiError} 409 Conflict if metadata is in use
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   await sdk.tokens.deleteTokenMetadata('metadata-123');
+     *   console.log('Token metadata deleted');
+     * } catch (error) {
+     *   if (error.statusCode === 409) {
+     *     console.log('Cannot delete: metadata is used by campaigns/redemptions');
+     *   }
+     * }
+     * ```
+     */
+    deleteTokenMetadata(metadataId: string): Promise<void>;
     /**
      * Get the full token SDK for advanced operations
      *

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

@@ -1 +1 @@
-{"version":3,"file":"token-manager.d.ts","sourceRoot":"","sources":["../../src/managers/token-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAY,YAAY,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAErE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,qBAAa,YAAY;IAGX,OAAO,CAAC,SAAS;IAF7B,OAAO,CAAC,YAAY,CAAe;gBAEf,SAAS,EAAE,aAAa;IAK5C;;;;;;;;;;;;;;;;;;;OAmBG;IACG,SAAS,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAIrF;;;;;;;;;;;;;;;;OAgBG;IACG,aAAa,CAAC,OAAO,CAAC,EAAE,iBAAiB;IAI/C;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,oBAAoB,IAAI,OAAO,CAAC,QAAQ,CAAC;IAI/C;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,eAAe,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAI3F;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,eAAe,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAI3F;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACG,kBAAkB,CAAC,eAAe,EAAE,MAAM,EAAE,eAAe,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI3G;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACG,WAAW,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIpD;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIrE;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI3D;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,eAAe,IAAI,YAAY;CAIhC"}
+{"version":3,"file":"token-manager.d.ts","sourceRoot":"","sources":["../../src/managers/token-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAY,YAAY,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AACxH,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAErE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,qBAAa,YAAY;IAGX,OAAO,CAAC,SAAS;IAF7B,OAAO,CAAC,YAAY,CAAe;gBAEf,SAAS,EAAE,aAAa;IAK5C;;;;;;;;;;;;;;;;;;;OAmBG;IACG,SAAS,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAIrF;;;;;;;;;;;;;;;;OAgBG;IACG,aAAa,CAAC,OAAO,CAAC,EAAE,iBAAiB;IAI/C;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,oBAAoB,IAAI,OAAO,CAAC,QAAQ,CAAC;IAI/C;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,eAAe,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAI3F;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,eAAe,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAI3F;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACG,kBAAkB,CAAC,eAAe,EAAE,MAAM,EAAE,eAAe,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI3G;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyCG;IACG,gBAAgB,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,oBAAoB,CAAC,gBAAgB,CAAC,CAAC;IAI5G;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,UAAU,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,gBAAgB,CAAC,CAAC;IAIjG;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,SAAS,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,gBAAgB,CAAC,CAAC;IAI/F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACG,WAAW,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIpD;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIrE;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI3D;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5D;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,eAAe,IAAI,YAAY;CAIhC"}

package/dist/node.cjs

@@ -1,19 +1,19 @@
 'use strict';
 
-var persSdk = require('./chunks/pers-sdk-DgsYyo1X.cjs');
+var persSdk = require('./chunks/pers-sdk-Cwlrl8jb.cjs');
 var persShared = require('@explorins/pers-shared');
 var nodeHttpClient = require('./chunks/node-http-client-D_avaa5F.cjs');
-require('./chunks/index-B_n8XiMt.cjs');
+require('./chunks/index-C4K-jkRO.cjs');
 require('./user.cjs');
 require('./chunks/pagination-utils-B2jRHMSO.cjs');
 require('./user-status.cjs');
-require('./chunks/token-service-C1xe11OX.cjs');
-require('./chunks/business-membership-service-DXLG5fP9.cjs');
+require('./chunks/token-service-CnnrCOsg.cjs');
+require('./chunks/business-membership-service-Dkb780NX.cjs');
 require('./campaign.cjs');
-require('./chunks/redemption-service-CVD2PzBO.cjs');
+require('./chunks/redemption-service-KamEndzB.cjs');
 require('./chunks/transaction-request.builder-D8pIzjYD.cjs');
 require('./chunks/payment-service-Bkw7ZXev.cjs');
-require('./chunks/tenant-manager-DeEuSlk7.cjs');
+require('./chunks/tenant-manager-DR5eSEJw.cjs');
 require('./chunks/tenant-service-8vZWmTLV.cjs');
 require('./chunks/analytics-service-CRs9cpkg.cjs');
 require('./donation.cjs');

package/dist/node.js

@@ -1,18 +1,18 @@
-import { k as StaticJwtAuthProvider, P as PersSDK } from './chunks/pers-sdk-CySmOdzr.js';
+import { k as StaticJwtAuthProvider, P as PersSDK } from './chunks/pers-sdk-CNIfzWYX.js';
 import { AccountOwnerType } from '@explorins/pers-shared';
 export { AccountOwnerType } from '@explorins/pers-shared';
 import { N as NodeHttpClientAdapter } from './chunks/node-http-client-DloDLfm9.js';
-import './chunks/index-CgbzGLYT.js';
+import './chunks/index--OssIds0.js';
 import './user.js';
 import './chunks/pagination-utils-9vQ-Npkr.js';
 import './user-status.js';
-import './chunks/token-service-BxEO5YVN.js';
-import './chunks/business-membership-service-IyY5CkL0.js';
+import './chunks/token-service-BcuDj292.js';
+import './chunks/business-membership-service-NLoqoFpG.js';
 import './campaign.js';
-import './chunks/redemption-service-czBfCP-3.js';
+import './chunks/redemption-service-w0GMdF0m.js';
 import './chunks/transaction-request.builder-BZ6Uq6Qe.js';
 import './chunks/payment-service-IvM6rryM.js';
-import './chunks/tenant-manager-BQP25Alv.js';
+import './chunks/tenant-manager-xmYKBFGu.js';
 import './chunks/tenant-service-DlhdZAs9.js';
 import './chunks/analytics-service-CF7hSwhy.js';
 import './donation.js';

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@explorins/pers-sdk",
-  "version": "2.1.33",
+  "version": "2.1.39",
   "description": "Platform-agnostic SDK for PERS (Phygital Experience Rewards System) - Core business logic and API integration",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -133,7 +133,7 @@
   },
   "dependencies": {
     "@explorins/pers-sdk": "^2.1.32",
-    "@explorins/pers-shared": "^2.1.137",
+    "@explorins/pers-shared": "^2.1.146",
     "@explorins/web3-ts": "^0.3.77",
     "@explorins/web3-types": "^1.2.0",
     "ethers": "^6.15.0"

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

@@ -38,6 +38,12 @@ export declare class RedemptionService {
      * @param options.sortOrder - Sort direction ('ASC' | 'DESC')
      */
     getRedemptions(options?: RedemptionFilterOptionsWithInclude): Promise<PaginatedResponseDTO<RedemptionDTO>>;
+    /**
+     * Get a specific redemption by ID
+     * @param id - Redemption UUID
+     * @param include - Optional relations to include: 'redeemCount'
+     */
+    getRedemptionById(id: string, include?: RedemptionIncludeRelation[]): Promise<RedemptionDTO>;
     /**
      * Convenience: Get active redemptions (public)
      */
@@ -109,6 +115,10 @@ export declare class RedemptionService {
      * ADMIN: Update redemption type
      */
     updateRedemptionType(data: RedemptionTypeDTO): Promise<RedemptionTypeDTO>;
+    /**
+     * ADMIN: Delete redemption
+     */
+    deleteRedemption(id: string): Promise<boolean>;
     /**
      * ADMIN: Delete redemption type
      */

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,yBAAyB,EAAE,mBAAmB,EAAa,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACnL,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGtD,OAAO,EACL,yBAAyB,EACzB,aAAa,EACb,0BAA0B,EAC1B,iBAAiB,EACjB,8BAA8B,EAC9B,mBAAmB,EACnB,0BAA0B,EAC1B,kCAAkC,EACnC,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAGxE,YAAY,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEtE;;;GAGG;AACH,MAAM,WAAW,kCAAmC,SAAQ,uBAAuB;IACjF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uCAAuC;IACvC,OAAO,CAAC,EAAE,yBAAyB,EAAE,CAAC;CACvC;AAED;;;;;;;GAOG;AACH,qBAAa,iBAAiB;IAChB,OAAO,CAAC,aAAa;gBAAb,aAAa,EAAE,aAAa;IAMhD;;;;;;;;;;;;;OAaG;IACG,cAAc,CAAC,OAAO,CAAC,EAAE,kCAAkC,GAAG,OAAO,CAAC,oBAAoB,CAAC,aAAa,CAAC,CAAC;IAIhH;;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,QAAQ,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;QACzB,MAAM,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;QACvB,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,kCAAkC,GAAG,OAAO,CAAC,oBAAoB,CAAC,aAAa,CAAC,CAAC;IAIvH;;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;IAQ5G;;OAEG;IACG,oBAAoB,CAAC,IAAI,EAAE,8BAA8B,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAI5F;;OAEG;IACG,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAI/E;;OAEG;IACG,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGzD"}
+{"version":3,"file":"redemption-service.d.ts","sourceRoot":"","sources":["../../../src/redemption/services/redemption-service.ts"],"names":[],"mappings":"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"}

package/dist/redemption.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var redemptionService = require('./chunks/redemption-service-CVD2PzBO.cjs');
+var redemptionService = require('./chunks/redemption-service-KamEndzB.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-czBfCP-3.js';
+export { R as RedemptionApi, a as RedemptionService } from './chunks/redemption-service-w0GMdF0m.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,7 +1,34 @@
 import { PersApiClient } from '../../core/pers-api-client';
 import { TokenDTO, TokenTypeDTO, TokenCreateRequestDTO, TokenMetadataCreateRequestDTO, TokenUpdateRequestDTO, TokenMetadataDTO } from '../models';
-import { PaginatedResponseDTO } from '@explorins/pers-shared';
+import { PaginatedResponseDTO, TokenMetadataFilterOptions, TokenMetadataIncludeRelation } from '@explorins/pers-shared';
 import { PaginationOptions } from '../../shared';
+export type { TokenMetadataFilterOptions, TokenMetadataIncludeRelation } from '@explorins/pers-shared';
+/**
+ * Extended filter options with include relations support
+ */
+export interface TokenMetadataQueryOptions extends TokenMetadataFilterOptions {
+    /**
+     * Include related entities or computed fields.
+     *
+     * - `ownerBusiness`: Include owner business entity (when ownerBusinessId is set)
+     * - `mintCount`: Include total completed MINT transactions count
+     * - `burnCount`: Include total completed BURN transactions count
+     * - `token`: Include parent token info (chainId, contractAddress, type)
+     *
+     * @example ['ownerBusiness', 'mintCount', 'burnCount', 'token']
+     */
+    include?: TokenMetadataIncludeRelation[];
+}
+/**
+ * Filter options for rewards (ERC1155 token metadata)
+ * Omits tokenType since it's always ERC1155
+ */
+export type RewardsFilterOptions = Omit<TokenMetadataQueryOptions, 'tokenType'>;
+/**
+ * Filter options for stamps (ERC721 token metadata)
+ * Omits tokenType since it's always ERC721
+ */
+export type StampsFilterOptions = Omit<TokenMetadataQueryOptions, 'tokenType'>;
 export declare class TokenApi {
     private apiClient;
     constructor(apiClient: PersApiClient);
@@ -48,6 +75,35 @@ export declare class TokenApi {
      * PUBLIC: Get token by contract address
      */
     getTokenByContractAddress(contractAddress: string, contractTokenId: string | null): Promise<TokenDTO>;
+    /**
+     * Get all token metadata with filtering, pagination, and include relations
+     *
+     * Useful for displaying rewards (ERC1155) or stamps (ERC721) in tables.
+     * Non-admin users always get active metadata only.
+     *
+     * @param options - Filter, pagination, and include options
+     * @returns Paginated response with token metadata
+     *
+     * @example Get all active rewards with mint/burn counts
+     * ```typescript
+     * const rewards = await tokenApi.getTokenMetadata({
+     *   tokenType: 'ERC1155',
+     *   active: true,
+     *   limit: 10,
+     *   include: ['mintCount', 'burnCount', 'token']
+     * });
+     * ```
+     *
+     * @example Get stamps with owner business included
+     * ```typescript
+     * const stamps = await tokenApi.getTokenMetadata({
+     *   tokenType: 'ERC721',
+     *   search: 'gold',
+     *   include: ['ownerBusiness', 'token']
+     * });
+     * ```
+     */
+    getTokenMetadata(options?: TokenMetadataQueryOptions): Promise<PaginatedResponseDTO<TokenMetadataDTO>>;
     /**
      * ADMIN: Create new token
      */
@@ -82,5 +138,27 @@ export declare class TokenApi {
      * ADMIN: Create token type
      */
     createTokenType(tokenType: TokenTypeDTO): Promise<TokenTypeDTO>;
+    /**
+     * ADMIN: Delete token metadata (soft delete)
+     *
+     * Soft deletes token metadata by setting deletedAt timestamp.
+     * Will fail with 409 Conflict if metadata is in use by active campaigns or redemptions.
+     *
+     * @param metadataId - ID of the token metadata to delete
+     * @throws {PersApiError} 409 Conflict if metadata is in use
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   await tokenApi.deleteTokenMetadata('metadata-123');
+     *   console.log('Metadata deleted');
+     * } catch (error) {
+     *   if (error.statusCode === 409) {
+     *     console.log('Cannot delete: metadata is in use');
+     *   }
+     * }
+     * ```
+     */
+    deleteTokenMetadata(metadataId: string): Promise<void>;
 }
 //# sourceMappingURL=token-api.d.ts.map

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

package/dist/token/index.d.ts

@@ -5,7 +5,7 @@
  * Modern class-based approach for optimal performance and developer experience
  */
 export { TokenSDK } from './token-sdk';
-export { TokenApi } from './api/token-api';
+export { TokenApi, type TokenMetadataFilterOptions, type TokenMetadataQueryOptions, type TokenMetadataIncludeRelation, type RewardsFilterOptions, type StampsFilterOptions } from './api/token-api';
 export { TokenService } from './services/token-service';
 export * from './models';
 export * from './utils';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/token/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD,cAAc,UAAU,CAAC;AAIzB,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/token/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,OAAO,EACL,QAAQ,EACR,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,KAAK,4BAA4B,EACjC,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD,cAAc,UAAU,CAAC;AAIzB,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC"}

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

@@ -1,8 +1,9 @@
 import { PaginatedResponseDTO } from '@explorins/pers-shared';
-import { TokenApi } from '../api/token-api';
+import { TokenApi, TokenMetadataQueryOptions, RewardsFilterOptions, StampsFilterOptions } from '../api/token-api';
 import { TokenDTO, TokenMetadataCreateRequestDTO, TokenCreateRequestDTO, TokenUpdateRequestDTO, TokenMetadataDTO } from '../models';
 import { TokenTypeDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
 import { PaginationOptions } from '../../shared/utils/pagination-utils';
+export type { TokenMetadataQueryOptions, RewardsFilterOptions, StampsFilterOptions, TokenMetadataIncludeRelation } from '../api/token-api';
 /**
  * Platform-Agnostic Token Service
  *
@@ -38,6 +39,56 @@ export declare class TokenService {
      * ✅ FIXED: Matches framework parameter types exactly
      */
     getTokenByContractAddress(contractAddress: string, contractTokenId: string | null): Promise<TokenDTO>;
+    /**
+     * Get all token metadata with filtering, pagination, and include relations
+     *
+     * Useful for displaying rewards (ERC1155) or stamps (ERC721) in tables.
+     * Non-admin users always get active metadata only.
+     *
+     * @param options - Filter, pagination, and include options
+     * @returns Paginated response with token metadata
+     *
+     * @example Get rewards with counts
+     * ```typescript
+     * const rewards = await tokenService.getTokenMetadata({
+     *   tokenType: 'ERC1155',
+     *   include: ['mintCount', 'burnCount', 'token']
+     * });
+     * ```
+     */
+    getTokenMetadata(options?: TokenMetadataQueryOptions): Promise<PaginatedResponseDTO<TokenMetadataDTO>>;
+    /**
+     * Get rewards (ERC1155 token metadata) with filtering, pagination, and include relations
+     *
+     * Convenience method for fetching reward metadata.
+     *
+     * @param options - Filter, pagination, and include options (tokenType is set automatically)
+     * @returns Paginated response with reward metadata
+     *
+     * @example Get rewards with mint/burn counts and token info
+     * ```typescript
+     * const rewards = await tokenService.getRewards({
+     *   include: ['mintCount', 'burnCount', 'token', 'ownerBusiness']
+     * });
+     * ```
+     */
+    getRewards(options?: RewardsFilterOptions): Promise<PaginatedResponseDTO<TokenMetadataDTO>>;
+    /**
+     * Get stamps (ERC721 token metadata) with filtering, pagination, and include relations
+     *
+     * Convenience method for fetching stamp metadata.
+     *
+     * @param options - Filter, pagination, and include options (tokenType is set automatically)
+     * @returns Paginated response with stamp metadata
+     *
+     * @example Get stamps with mint/burn counts and token info
+     * ```typescript
+     * const stamps = await tokenService.getStamps({
+     *   include: ['mintCount', 'burnCount', 'token', 'ownerBusiness']
+     * });
+     * ```
+     */
+    getStamps(options?: StampsFilterOptions): Promise<PaginatedResponseDTO<TokenMetadataDTO>>;
     /**
      * ADMIN: Create token metadata
      */
@@ -71,5 +122,14 @@ export declare class TokenService {
      * ADMIN: Create token type
      */
     createTokenType(tokenType: TokenTypeDTO): Promise<TokenTypeDTO>;
+    /**
+     * ADMIN: Delete token metadata (soft delete)
+     *
+     * Soft deletes token metadata. Will fail if metadata is in use.
+     *
+     * @param metadataId - ID of the token metadata to delete
+     * @throws {PersApiError} 409 Conflict if metadata is in use by campaigns/redemptions
+     */
+    deleteTokenMetadata(metadataId: string): Promise<void>;
 }
 //# sourceMappingURL=token-service.d.ts.map

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

package/dist/token.cjs

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

package/dist/token.js

@@ -1,5 +1,5 @@
-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';
+export { B as BaseTokenService, T as TokenSDK, g as getMetadataFromTokenUnitResponse } from './chunks/base-token-service-N1gwRD8N.js';
+export { T as TokenApi, a as TokenService } from './chunks/token-service-BcuDj292.js';
 import '@explorins/pers-shared';
 import './chunks/pagination-utils-9vQ-Npkr.js';
 //# sourceMappingURL=token.js.map

package/dist/trigger-source/api/trigger-source-api.d.ts

@@ -1,4 +1,4 @@
-import { PaginatedResponseDTO, SortOrder, TriggerSourceDTO, TriggerSourceCreateRequestDTO, TriggerSourceType } from '@explorins/pers-shared';
+import { PaginatedResponseDTO, TriggerSourceDTO, TriggerSourceCreateRequestDTO, TriggerSourceFilterOptions } from '@explorins/pers-shared';
 import { PersApiClient } from '../../core/pers-api-client';
 /**
  * Platform-Agnostic TriggerSource API Client
@@ -15,7 +15,7 @@ export declare class TriggerSourceApi {
     /**
      * PUBLIC: Get trigger sources with optional filters and pagination
      *
-     * @param options - Filter and pagination options
+     * @param options - Filter and pagination options (includes location filters)
      * @returns Paginated list of trigger sources
      *
      * @example
@@ -29,17 +29,16 @@ export declare class TriggerSourceApi {
      *   page: 1,
      *   limit: 20
      * });
+     *
+     * // Filter by location (geocoding)
+     * const dubaiSources = await triggerSourceApi.getTriggerSources({
+     *   city: 'Dubai',
+     *   countryCode: 'AE'
+     * });
      * ```
      */
-    getTriggerSources(options?: {
-        type?: TriggerSourceType;
-        businessId?: string;
+    getTriggerSources(options?: TriggerSourceFilterOptions & {
         campaignId?: string;
-        active?: boolean;
-        page?: number;
-        limit?: number;
-        sortBy?: 'name' | 'createdAt' | 'type';
-        sortOrder?: SortOrder;
     }): Promise<PaginatedResponseDTO<TriggerSourceDTO>>;
     /**
      * PUBLIC: Get trigger source by ID

package/dist/trigger-source/api/trigger-source-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trigger-source-api.d.ts","sourceRoot":"","sources":["../../../src/trigger-source/api/trigger-source-api.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,SAAS,EACT,gBAAgB,EAChB,6BAA6B,EAC7B,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAG3D;;;;;;;;GAQG;AACH,qBAAa,gBAAgB;IACf,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,aAAa;IAE5C;;;;;;;;;;;;;;;;;;OAkBG;IACG,iBAAiB,CAAC,OAAO,CAAC,EAAE;QAChC,IAAI,CAAC,EAAE,iBAAiB,CAAC;QACzB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;QACvC,SAAS,CAAC,EAAE,SAAS,CAAC;KACvB,GAAG,OAAO,CAAC,oBAAoB,CAAC,gBAAgB,CAAC,CAAC;IAcnD;;;;;OAKG;IACG,oBAAoB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI9E;;;;;;;;;;;;;;;;;OAiBG;IACG,mBAAmB,CAAC,aAAa,EAAE,6BAA6B,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIlG;;;;;;OAMG;IACG,mBAAmB,CACvB,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,OAAO,CAAC,6BAA6B,CAAC,GACpD,OAAO,CAAC,gBAAgB,CAAC;IAI5B;;;;;OAKG;IACG,mBAAmB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGrE"}
+{"version":3,"file":"trigger-source-api.d.ts","sourceRoot":"","sources":["../../../src/trigger-source/api/trigger-source-api.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EAEpB,gBAAgB,EAChB,6BAA6B,EAE7B,0BAA0B,EAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAG3D;;;;;;;;GAQG;AACH,qBAAa,gBAAgB;IACf,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,aAAa;IAE5C;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,iBAAiB,CAAC,OAAO,CAAC,EAAE,0BAA0B,GAAG;QAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,oBAAoB,CAAC,gBAAgB,CAAC,CAAC;IAsBnD;;;;;OAKG;IACG,oBAAoB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI9E;;;;;;;;;;;;;;;;;OAiBG;IACG,mBAAmB,CAAC,aAAa,EAAE,6BAA6B,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIlG;;;;;;OAMG;IACG,mBAAmB,CACvB,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,OAAO,CAAC,6BAA6B,CAAC,GACpD,OAAO,CAAC,gBAAgB,CAAC;IAI5B;;;;;OAKG;IACG,mBAAmB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGrE"}

package/dist/trigger-source/index.d.ts

@@ -7,4 +7,5 @@
 export { TriggerSourceApi } from './api/trigger-source-api';
 export { TriggerSourceService } from './services/trigger-source-service';
 export type { TriggerSourceQueryOptions } from './models';
+export type { TriggerSourceFilterOptions } from '@explorins/pers-shared';
 //# sourceMappingURL=index.d.ts.map

package/dist/trigger-source/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/trigger-source/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAG5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAGzE,YAAY,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/trigger-source/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAG5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAGzE,YAAY,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAG1D,YAAY,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/trigger-source/models/index.d.ts

@@ -3,24 +3,16 @@
  *
  * SDK-specific interfaces for trigger source operations
  */
-import { TriggerSourceType, SortOrder } from '@explorins/pers-shared';
-import { PaginationOptions } from '../../shared/utils/pagination-utils';
+import { TriggerSourceFilterOptions } from '@explorins/pers-shared';
 /**
  * Query options for listing trigger sources
  * Used with getAll() method in TriggerSourceManager
+ *
+ * Extends TriggerSourceFilterOptions with additional SDK-specific options.
+ * Includes location filtering (city, countryCode, country, neighborhood, district).
  */
-export interface TriggerSourceQueryOptions extends PaginationOptions {
-    /** Filter by trigger source type (QR_CODE, NFC_TAG, GPS_GEOFENCE, API_WEBHOOK, TRANSACTION) */
-    type?: TriggerSourceType;
-    /** Filter by business ID */
-    businessId?: string;
+export interface TriggerSourceQueryOptions extends TriggerSourceFilterOptions {
     /** Filter by campaign ID (get sources assigned to a campaign) */
     campaignId?: string;
-    /** Filter by active status */
-    active?: boolean;
-    /** Field to sort by */
-    sortBy?: 'name' | 'createdAt' | 'type';
-    /** Sort direction */
-    sortOrder?: SortOrder;
 }
 //# sourceMappingURL=index.d.ts.map

package/dist/trigger-source/models/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/trigger-source/models/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAExE;;;GAGG;AACH,MAAM,WAAW,yBAA0B,SAAQ,iBAAiB;IAClE,+FAA+F;IAC/F,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IACvC,qBAAqB;IACrB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/trigger-source/models/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAgC,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAGlG;;;;;;GAMG;AACH,MAAM,WAAW,yBAA0B,SAAQ,0BAA0B;IAC3E,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}