@explorins/pers-sdk-react-native 2.2.1 → 2.2.2

package/dist/index.js

@@ -3152,6 +3152,8 @@ exports.WebhookSource = void 0;
     WebhookSource["USER"] = "USER";
     WebhookSource["BUSINESS"] = "BUSINESS";
     WebhookSource["TENANT"] = "TENANT";
+    // System-level internal invocation (e.g., token metadata webhook fetch)
+    WebhookSource["INTERNAL"] = "INTERNAL";
     // External verified sources
     WebhookSource["STRIPE"] = "STRIPE";
     // Allow any external traffic (no verification)
@@ -3557,7 +3559,8 @@ function isValidTransactionRelation(value) {
 const VALID_CAMPAIGN_RELATIONS = [
     'triggerSources',
     'businesses',
-    'claimCount'
+    'claimCount',
+    'ownerBusiness'
 ];
 /**
  * Type guard to validate campaign include relation at runtime
@@ -3595,7 +3598,8 @@ function isValidCampaignClaimRelation(value) {
  * Used for runtime validation
  */
 const VALID_REDEMPTION_RELATIONS = [
-    'redeemCount'
+    'redeemCount',
+    'ownerBusiness'
 ];
 /**
  * Type guard to validate redemption include relation at runtime
@@ -3653,6 +3657,26 @@ function isValidUserRelation(value) {
     return VALID_USER_RELATIONS.includes(value);
 }
 
+/**
+ * Array of all valid token metadata include relations
+ * Used for runtime validation
+ */
+const VALID_TOKEN_METADATA_RELATIONS = [
+    'ownerBusiness',
+    'mintCount',
+    'burnCount',
+    'token'
+];
+/**
+ * Type guard to validate token metadata include relation at runtime
+ *
+ * @param value - String to validate
+ * @returns True if value is a valid TokenMetadataIncludeRelation
+ */
+function isValidTokenMetadataRelation(value) {
+    return VALID_TOKEN_METADATA_RELATIONS.includes(value);
+}
+
 /**
  * Normalizes filter options to use new field names while accepting deprecated ones.
  * Use at controller level to support both old and new API contracts.
@@ -5166,30 +5190,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']
      * });
      * ```
      */
@@ -5214,6 +5238,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 normalizeToPaginated(response);
     }
@@ -5273,6 +5305,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}`);
+    }
 }
 
 /**
@@ -5327,35 +5383,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: 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: NativeTokenTypes.ERC721 });
@@ -5412,6 +5490,17 @@ 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);
+    }
 }
 
 /**
@@ -5514,6 +5603,10 @@ class BusinessApi {
      *
      * // Filter by business type
      * const hotels = await businessApi.getBusinesses({ businessTypeId: 1 });
+     *
+     * // Filter by location (geocoding)
+     * const dohaBusinesses = await businessApi.getBusinesses({ city: 'Doha', countryCode: 'QA' });
+     * const westBay = await businessApi.getBusinesses({ neighborhood: 'West Bay' });
      * ```
      */
     async getBusinesses(options) {
@@ -5536,6 +5629,22 @@ class BusinessApi {
         if (options?.businessTypeId !== undefined) {
             params.set('businessTypeId', String(options.businessTypeId));
         }
+        // Location filter options (geocoding)
+        if (options?.city) {
+            params.set('city', options.city);
+        }
+        if (options?.countryCode) {
+            params.set('countryCode', options.countryCode);
+        }
+        if (options?.country) {
+            params.set('country', options.country);
+        }
+        if (options?.neighborhood) {
+            params.set('neighborhood', options.neighborhood);
+        }
+        if (options?.district) {
+            params.set('district', options.district);
+        }
         const response = await this.apiClient.get(`${this.basePath}?${params.toString()}`);
         return normalizeToPaginated(response);
     }
@@ -7237,6 +7346,12 @@ class RedemptionService {
     async updateRedemptionType(data) {
         return this.redemptionApi.updateRedemptionType(data);
     }
+    /**
+     * ADMIN: Delete redemption
+     */
+    async deleteRedemption(id) {
+        return this.redemptionApi.deleteRedemption(id);
+    }
     /**
      * ADMIN: Delete redemption type
      */
@@ -9172,7 +9287,7 @@ 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
@@ -9186,6 +9301,12 @@ class TriggerSourceApi {
      *   page: 1,
      *   limit: 20
      * });
+     *
+     * // Filter by location (geocoding)
+     * const dubaiSources = await triggerSourceApi.getTriggerSources({
+     *   city: 'Dubai',
+     *   countryCode: 'AE'
+     * });
      * ```
      */
     async getTriggerSources(options) {
@@ -9198,6 +9319,19 @@ class TriggerSourceApi {
             params.set('campaignId', options.campaignId);
         if (options?.active !== undefined)
             params.set('active', String(options.active));
+        if (options?.includeDeleted)
+            params.set('includeDeleted', String(options.includeDeleted));
+        // Location filter options (geocoding)
+        if (options?.city)
+            params.set('city', options.city);
+        if (options?.countryCode)
+            params.set('countryCode', options.countryCode);
+        if (options?.country)
+            params.set('country', options.country);
+        if (options?.neighborhood)
+            params.set('neighborhood', options.neighborhood);
+        if (options?.district)
+            params.set('district', options.district);
         const response = await this.apiClient.get(`/trigger-sources?${params.toString()}`);
         return normalizeToPaginated(response);
     }
@@ -9782,6 +9916,9 @@ class AuthService {
      * Extracts context (tenantId/businessId) from the current refresh token to ensure
      * the recovered session maintains the same context.
      *
+     * This is a PUBLIC method that can be called by TokenRefreshManager when internal
+     * refresh fails, to try external (provider token) recovery before giving up.
+     *
      * @returns true if session was successfully recovered
      */
     async attemptProviderTokenRecovery() {
@@ -9934,6 +10071,8 @@ class TokenRefreshManager {
         // Retry configuration for transient failures
         this.MAX_RETRY_ATTEMPTS = 3;
         this.RETRY_DELAY_MS = 1000;
+        // Active refresh promise for deduplication
+        this.activeRefreshPromise = null;
     }
     /**
      * Ensures the access token is valid, refreshing if needed.
@@ -10034,11 +10173,27 @@ class TokenRefreshManager {
         return new Promise(resolve => setTimeout(resolve, ms));
     }
     /**
-     * @deprecated Use ensureValidToken() instead
+     * Attempt token refresh: internal first, then provider token fallback.
+     * DEDUPLICATES concurrent calls - all callers share the same promise.
      */
     async attemptInternalRefresh() {
-        const result = await this.attemptRefreshWithRetry();
-        return result.success;
+        if (this.activeRefreshPromise) {
+            return this.activeRefreshPromise;
+        }
+        this.activeRefreshPromise = (async () => {
+            const result = await this.attemptRefreshWithRetry();
+            if (result.success)
+                return result;
+            // Internal failed - try provider token recovery
+            const recovered = await this.authService.attemptProviderTokenRecovery();
+            return recovered ? { success: true, retryable: false } : result;
+        })();
+        try {
+            return await this.activeRefreshPromise;
+        }
+        finally {
+            this.activeRefreshPromise = null;
+        }
     }
 }
 
@@ -10844,7 +10999,7 @@ class DefaultAuthProvider {
 /** SDK package name */
 const SDK_NAME = "@explorins/pers-sdk";
 /** SDK version - injected from package.json at build time */
-const SDK_VERSION = "2.1.37";
+const SDK_VERSION = "2.1.39";
 /** Full SDK identifier for headers */
 const SDK_USER_AGENT = `${SDK_NAME}/${SDK_VERSION}`;
 
@@ -10954,12 +11109,16 @@ class PersApiClient {
         }
         const { retryCount = 0, responseType = 'json', bypassAuth = false } = options || {};
         const url = `${this.apiRoot}${endpoint}`;
-        // SMART TOKEN VALIDATION: Only check if we suspect the token might be expired
+        // TOKEN VALIDATION: Ensure token is valid before request
+        // This blocks the request until token validation completes - prevents 401s from expired tokens
         if (!bypassAuth && this.mergedConfig.authProvider && retryCount === 0) {
-            // Fire-and-forget validation - don't block the request unless we know there's an issue
-            this.ensureValidToken().catch(error => {
-                console.debug('[PersApiClient] Background token validation failed:', error);
-            });
+            try {
+                await this.ensureValidToken();
+            }
+            catch (error) {
+                console.debug('[PersApiClient] Token validation failed:', error);
+                // Continue with request - it will fail with 401 and trigger retry logic
+            }
         }
         const requestOptions = {
             headers: await this.getHeaders(!bypassAuth, method, url),
@@ -10987,49 +11146,63 @@ class PersApiClient {
             return result;
         }
         catch (error) {
-            // Error handling - proactive token refresh should prevent most 401s
             const status = ErrorUtils.getStatus(error);
             const errorMessage = ErrorUtils.getMessage(error);
-            // Handle 401 errors centrally through AuthService
+            // Handle 401 Unauthorized errors
             if (status === 401) {
                 const backendError = ErrorUtils.extractBackendErrorDetails(error);
-                // Check for FATAL auth error CODES (not just 401 status)
-                // Fatal codes: REFRESH_TOKEN_EXPIRED, TOKEN_REVOKED, etc. → immediate logout
-                // Non-fatal codes: TOKEN_EXPIRED → try refresh first
+                // ===========================================
+                // FATAL AUTH ERRORS → Immediate logout
+                // ===========================================
+                // Fatal codes: REFRESH_TOKEN_EXPIRED, TOKEN_REVOKED, INVALID_REFRESH_TOKEN, etc.
                 if (this.authService.isFatalAuthError(backendError.code)) {
-                    // Definitive auth failure - no retry, session is invalid
+                    console.warn(`[PersApiClient] Fatal auth error: ${backendError.code}`);
                     await this.authService.handleAuthFailure();
                     this.emitErrorEvent(backendError, errorMessage, endpoint, method, status, error);
                     throw new AuthenticationError(errorMessage, endpoint, method, backendError);
                 }
-                // If this IS a refresh request that failed with 401, don't retry to avoid infinite loop
+                // ===========================================
+                // REFRESH REQUEST FAILED → Logout (prevents infinite loop)
+                // ===========================================
                 if (options?.isRefreshRequest) {
-                    // Refresh failed - this is a real auth failure
+                    console.warn('[PersApiClient] Refresh request itself failed with 401');
                     await this.authService.handleAuthFailure();
                     this.emitErrorEvent(backendError, errorMessage, endpoint, method, status, error);
                     throw new AuthenticationError(errorMessage, endpoint, method, backendError);
                 }
-                // TOKEN_EXPIRED or unknown 401: try refresh once, then retry
+                // ===========================================
+                // RETRYABLE 401 (TOKEN_EXPIRED) → Try refresh, then retry
+                // ===========================================
                 if (retryCount === 0 && this.mergedConfig.authProvider) {
-                    try {
-                        const refreshSuccessful = await this.refreshManager.attemptInternalRefresh();
-                        if (refreshSuccessful) {
-                            // Emit TOKEN_REFRESHED event so WS clients can retry if they gave up
-                            this._events?.emitSuccess({
-                                type: 'token_refreshed',
-                                domain: 'authentication',
-                                userMessage: 'Authentication token refreshed',
-                            });
-                            // Retry with new token
-                            return await this.request(method, endpoint, body, { ...options, retryCount: 1 });
-                        }
+                    const refreshResult = await this.refreshManager.attemptInternalRefresh();
+                    if (refreshResult.success) {
+                        // Refresh succeeded → retry request with new token
+                        this._events?.emitSuccess({
+                            type: 'token_refreshed',
+                            domain: 'authentication',
+                            userMessage: 'Authentication token refreshed',
+                        });
+                        return await this.request(method, endpoint, body, { ...options, retryCount: 1 });
+                    }
+                    // Refresh failed - check if it's a definitive failure
+                    if (!refreshResult.retryable) {
+                        // Non-retryable failure (e.g., refresh token expired) → logout
+                        console.warn('[PersApiClient] Refresh failed with non-retryable error, logging out');
+                        await this.authService.handleAuthFailure();
                     }
-                    catch (refreshError) {
-                        // Refresh failed - fall through to handleAuthFailure
+                    else {
+                        // Retryable failure (network error, etc.) → DON'T logout, let app retry later
+                        console.warn('[PersApiClient] Refresh failed with retryable error, NOT logging out');
                     }
+                    this.emitErrorEvent(backendError, errorMessage, endpoint, method, status, error);
+                    throw new AuthenticationError(errorMessage, endpoint, method, backendError);
                 }
-                // All recovery attempts failed
-                await this.authService.handleAuthFailure();
+                // ===========================================
+                // RETRY FAILED (retryCount > 0) → Something wrong, but DON'T logout
+                // ===========================================
+                // We already refreshed successfully, but retry still got 401
+                // This is unexpected - don't logout, let app investigate
+                console.warn('[PersApiClient] Retry with new token still got 401 - not logging out');
                 this.emitErrorEvent(backendError, errorMessage, endpoint, method, status, error);
                 throw new AuthenticationError(errorMessage, endpoint, method, backendError);
             }
@@ -12694,16 +12867,17 @@ class TokenManager {
         return this.tokenService.getTokenByContractAddress(contractAddress, contractTokenId);
     }
     /**
-     * Get all token metadata with filtering and pagination
+     * Get all token metadata with filtering, pagination, and include relations
      *
-     * Retrieves token metadata (rewards/stamps) with server-side filtering and pagination.
+     * 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 and pagination options
+     * @param options - Filter, pagination, and include options
      * @returns Promise resolving to paginated token metadata
      *
-     * @example Get paginated rewards
+     * @example Get paginated rewards with counts
      * ```typescript
      * const rewards = await sdk.tokens.getTokenMetadata({
      *   tokenType: 'ERC1155',
@@ -12711,19 +12885,26 @@ class TokenManager {
      *   page: 1,
      *   limit: 10,
      *   sortBy: 'name',
-     *   sortOrder: 'ASC'
+     *   sortOrder: 'ASC',
+     *   include: ['mintCount', 'burnCount', 'token']
      * });
      *
-     * console.log(`Page 1 of ${rewards.pagination.pages}`);
-     * rewards.data.forEach(r => console.log(r.name));
+     * 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 search
+     * @example Get stamps with owner business
      * ```typescript
      * const stamps = await sdk.tokens.getTokenMetadata({
      *   tokenType: 'ERC721',
      *   search: 'gold',
-     *   limit: 25
+     *   include: ['ownerBusiness', 'token']
+     * });
+     *
+     * stamps.data.forEach(s => {
+     *   console.log(`${s.name} owned by ${s.included?.ownerBusiness?.displayName}`);
      * });
      * ```
      */
@@ -12731,31 +12912,27 @@ class TokenManager {
         return this.tokenService.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. Rewards are ERC1155 tokens
      * that represent collectible items, vouchers, or other redeemable rewards.
      *
-     * @param options - Filter and pagination options (tokenType is set automatically)
+     * @param options - Filter, pagination, and include options (tokenType is set automatically)
      * @returns Promise resolving to paginated reward metadata
      *
-     * @example Get active rewards
+     * @example Get active rewards with mint counts
      * ```typescript
      * const rewards = await sdk.tokens.getRewards({
      *   active: true,
-     *   limit: 10
+     *   limit: 10,
+     *   include: ['mintCount', 'burnCount', 'token', 'ownerBusiness']
      * });
      *
-     * console.log(`Found ${rewards.pagination.total} rewards`);
-     * rewards.data.forEach(r => console.log(`${r.name}: ${r.description}`));
-     * ```
-     *
-     * @example Search rewards
-     * ```typescript
-     * const discountRewards = await sdk.tokens.getRewards({
-     *   search: 'discount',
-     *   sortBy: 'name',
-     *   sortOrder: 'ASC'
+     * 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}`);
+     *   }
      * });
      * ```
      */
@@ -12763,31 +12940,27 @@ class TokenManager {
         return this.tokenService.getRewards(options);
     }
     /**
-     * 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. Stamps are ERC721 tokens
      * that represent achievements, badges, or collectible status markers.
      *
-     * @param options - Filter and pagination options (tokenType is set automatically)
+     * @param options - Filter, pagination, and include options (tokenType is set automatically)
      * @returns Promise resolving to paginated stamp metadata
      *
-     * @example Get active stamps
+     * @example Get active stamps with all includes
      * ```typescript
      * const stamps = await sdk.tokens.getStamps({
      *   active: true,
-     *   limit: 10
+     *   limit: 10,
+     *   include: ['mintCount', 'burnCount', 'token', 'ownerBusiness']
      * });
      *
-     * console.log(`Found ${stamps.pagination.total} stamps`);
-     * stamps.data.forEach(s => console.log(`${s.name}: ${s.description}`));
-     * ```
-     *
-     * @example Filter stamps by tags
-     * ```typescript
-     * const goldStamps = await sdk.tokens.getStamps({
-     *   tags: ['gold', 'premium'],
-     *   sortBy: 'createdAt',
-     *   sortOrder: 'DESC'
+     * stamps.data.forEach(s => {
+     *   console.log(`${s.name}: ${s.mintCount ?? 0} minted`);
+     *   if (s.included?.ownerBusiness) {
+     *     console.log(`  Owner: ${s.included.ownerBusiness.displayName}`);
+     *   }
      * });
      * ```
      */
@@ -12885,6 +13058,32 @@ class TokenManager {
     async toggleTokenActive(tokenId) {
         return this.tokenService.toggleTokenActive(tokenId);
     }
+    /**
+     * 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');
+     *   }
+     * }
+     * ```
+     */
+    async deleteTokenMetadata(metadataId) {
+        return this.tokenService.deleteTokenMetadata(metadataId);
+    }
     /**
      * Get the full token SDK for advanced operations
      *
@@ -15278,6 +15477,21 @@ class RedemptionManager {
     async deleteRedemptionType(id) {
         return this.redemptionService.deleteRedemptionType(id);
     }
+    /**
+     * Delete a redemption (soft delete)
+     *
+     * @param id - Redemption ID to delete
+     * @returns Promise resolving to true if deleted successfully
+     *
+     * @example
+     * ```typescript
+     * const success = await sdk.redemptions.deleteRedemption('redemption-123');
+     * console.log('Deleted:', success);
+     * ```
+     */
+    async deleteRedemption(id) {
+        return this.redemptionService.deleteRedemption(id);
+    }
     /**
      * Get the full redemption service for advanced operations
      *
@@ -46730,6 +46944,7 @@ exports.VALID_CAMPAIGN_RELATIONS = VALID_CAMPAIGN_RELATIONS;
 exports.VALID_REDEMPTION_REDEEM_RELATIONS = VALID_REDEMPTION_REDEEM_RELATIONS;
 exports.VALID_REDEMPTION_RELATIONS = VALID_REDEMPTION_RELATIONS;
 exports.VALID_RELATIONS = VALID_RELATIONS;
+exports.VALID_TOKEN_METADATA_RELATIONS = VALID_TOKEN_METADATA_RELATIONS;
 exports.VALID_TRANSACTION_RELATIONS = VALID_TRANSACTION_RELATIONS;
 exports.VALID_USER_RELATIONS = VALID_USER_RELATIONS;
 exports.WalletEventsManager = WalletEventsManager;
@@ -46781,6 +46996,7 @@ exports.isValidCampaignRelation = isValidCampaignRelation;
 exports.isValidRedemptionRedeemRelation = isValidRedemptionRedeemRelation;
 exports.isValidRedemptionRelation = isValidRedemptionRelation;
 exports.isValidRelation = isValidRelation;
+exports.isValidTokenMetadataRelation = isValidTokenMetadataRelation;
 exports.isValidTransactionRelation = isValidTransactionRelation;
 exports.isValidUserRelation = isValidUserRelation;
 exports.mergeWithDefaults = mergeWithDefaults;