@explorins/pers-sdk 2.1.37 → 2.1.40

package/dist/chunks/{token-service-BJqu5Xap.cjs → token-service-CnnrCOsg.cjs}

@@ -87,30 +87,30 @@ class TokenApi {
         return this.apiClient.get(url);
     }
     /**
-     * Get all token metadata with filtering and pagination
+     * 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 and pagination options
+     * @param options - Filter, pagination, and include options
      * @returns Paginated response with token metadata
      *
-     * @example Get all active rewards
+     * @example Get all active rewards with mint/burn counts
      * ```typescript
      * const rewards = await tokenApi.getTokenMetadata({
      *   tokenType: 'ERC1155',
      *   active: true,
-     *   limit: 10
+     *   limit: 10,
+     *   include: ['mintCount', 'burnCount', 'token']
      * });
      * ```
      *
-     * @example Get stamps with search
+     * @example Get stamps with owner business included
      * ```typescript
      * const stamps = await tokenApi.getTokenMetadata({
      *   tokenType: 'ERC721',
      *   search: 'gold',
-     *   sortBy: 'name',
-     *   sortOrder: 'ASC'
+     *   include: ['ownerBusiness', 'token']
      * });
      * ```
      */
@@ -135,6 +135,14 @@ class TokenApi {
                 params.set('tags', tagsArray.join(','));
             }
         }
+        // Filter by owner business
+        if (options?.ownerBusinessId) {
+            params.set('ownerBusinessId', options.ownerBusinessId);
+        }
+        // Include relations (ownerBusiness, mintCount, burnCount, token)
+        if (options?.include && options.include.length > 0) {
+            params.set('include', options.include.join(','));
+        }
         const response = await this.apiClient.get(`${this.basePath}/metadata?${params.toString()}`);
         return paginationUtils.normalizeToPaginated(response);
     }
@@ -194,6 +202,30 @@ class TokenApi {
     async createTokenType(tokenType) {
         return this.apiClient.post(`${this.basePath}/types`, tokenType);
     }
+    /**
+     * 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');
+     *   }
+     * }
+     * ```
+     */
+    async deleteTokenMetadata(metadataId) {
+        return this.apiClient.delete(`${this.basePath}/metadata/${metadataId}`);
+    }
 }
 
 /**
@@ -248,35 +280,57 @@ class TokenService {
         return this.tokenApi.getTokenByContractAddress(contractAddress, contractTokenId);
     }
     /**
-     * Get all token metadata with filtering and pagination
+     * 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 and pagination options
+     * @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']
+     * });
+     * ```
      */
     async getTokenMetadata(options) {
         return this.tokenApi.getTokenMetadata(options);
     }
     /**
-     * Get rewards (ERC1155 token metadata) with filtering and pagination
+     * Get rewards (ERC1155 token metadata) with filtering, pagination, and include relations
      *
      * Convenience method for fetching reward metadata.
      *
-     * @param options - Filter and pagination options (tokenType is set automatically)
+     * @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']
+     * });
+     * ```
      */
     async getRewards(options) {
         return this.tokenApi.getTokenMetadata({ ...options, tokenType: persShared.NativeTokenTypes.ERC1155 });
     }
     /**
-     * Get stamps (ERC721 token metadata) with filtering and pagination
+     * Get stamps (ERC721 token metadata) with filtering, pagination, and include relations
      *
      * Convenience method for fetching stamp metadata.
      *
-     * @param options - Filter and pagination options (tokenType is set automatically)
+     * @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']
+     * });
+     * ```
      */
     async getStamps(options) {
         return this.tokenApi.getTokenMetadata({ ...options, tokenType: persShared.NativeTokenTypes.ERC721 });
@@ -333,8 +387,19 @@ class TokenService {
     async createTokenType(tokenType) {
         return this.tokenApi.createTokenType(tokenType);
     }
+    /**
+     * 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
+     */
+    async deleteTokenMetadata(metadataId) {
+        return this.tokenApi.deleteTokenMetadata(metadataId);
+    }
 }
 
 exports.TokenApi = TokenApi;
 exports.TokenService = TokenService;
-//# sourceMappingURL=token-service-BJqu5Xap.cjs.map
+//# sourceMappingURL=token-service-CnnrCOsg.cjs.map

package/dist/chunks/token-service-CnnrCOsg.cjs.map

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