@explorins/pers-sdk 2.1.40 → 2.1.42

package/dist/core.js

@@ -1,4 +1,4 @@
-export { b as AUTH_STORAGE_KEYS, x as AnalyticsManager, w as ApiKeyManager, l as AuthApi, r as AuthManager, o as AuthService, a as AuthTokenManager, B as BusinessManager, C as CampaignManager, h as DEFAULT_PERS_CONFIG, d as DPOP_STORAGE_KEYS, p as DPoPManager, D as DefaultAuthProvider, y as DonationManager, F as FATAL_AUTH_CODES, v as FileManager, I as IndexedDBTokenStorage, L as LocalStorageTokenStorage, M as MemoryTokenStorage, g as PersApiClient, q as PersEventEmitter, P as PersSDK, u as PurchaseManager, R as RedemptionManager, S as SDK_NAME, f as SDK_USER_AGENT, e as SDK_VERSION, k as StaticJwtAuthProvider, T as TokenManager, t as TransactionManager, z as TriggerSourceManager, U as UserManager, s as UserStatusManager, G as WalletEventsManager, W as WebDPoPCryptoProvider, E as WebhookManager, i as buildApiRoot, j as buildWalletEventsWsUrl, c as createPersSDK, n as isFatalAuthErrorInMessage, m as mergeWithDefaults } from './chunks/pers-sdk-DuDWwRWC.js';
+export { a as AUTH_STORAGE_KEYS, w as AnalyticsManager, v as ApiKeyManager, k as AuthApi, q as AuthManager, n as AuthService, A as AuthTokenManager, B as BusinessManager, C as CampaignManager, g as DEFAULT_PERS_CONFIG, b as DPOP_STORAGE_KEYS, o as DPoPManager, D as DefaultAuthProvider, x as DonationManager, F as FATAL_AUTH_CODES, u as FileManager, I as IndexedDBTokenStorage, L as LocalStorageTokenStorage, M as MemoryTokenStorage, f as PersApiClient, p as PersEventEmitter, P as PersSDK, t as PurchaseManager, R as RedemptionManager, S as SDK_NAME, d as SDK_USER_AGENT, c as SDK_VERSION, j as StaticJwtAuthProvider, T as TokenManager, s as TransactionManager, y as TriggerSourceManager, U as UserManager, r as UserStatusManager, E as WalletEventsManager, W as WebDPoPCryptoProvider, z as WebhookManager, h as buildApiRoot, i as buildWalletEventsWsUrl, e as createPersSDK, l as isFatalAuthErrorInMessage, m as mergeWithDefaults } from './chunks/pers-sdk-DxYmXQcW.js';
 export { AccountOwnerType } from '@explorins/pers-shared';
 export { d as detectEnvironment, e as environment, w as warnIfProblematicEnvironment } from './chunks/environment-DEI_L882.js';
 export { c as ApiErrorDetector, A as AuthenticationError, a as CacheService, C as CacheTTL, E as ErrorUtils, L as LogoutRequired, N as NetworkError, b as PersApiError, P as ProviderTokenRefreshNeeded, S as SdkErrorCodes, T as TokenRefreshNeeded, g as globalCacheService } from './chunks/index--OssIds0.js';

package/dist/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var persSdk = require('./chunks/pers-sdk-CBvzmlL_.cjs');
+var persSdk = require('./chunks/pers-sdk-DeFxjuRB.cjs');
 var persShared = require('@explorins/pers-shared');
 var environment = require('./chunks/environment-C_hPDl8L.cjs');
 var index = require('./chunks/index-C4K-jkRO.cjs');
@@ -22,7 +22,82 @@ var triggerSource = require('./trigger-source.cjs');
 var platformAdapters = require('./platform-adapters.cjs');
 var nodeHttpClient = require('./chunks/node-http-client-D_avaa5F.cjs');
 
-
+/**
+ * Build optimized image URL with automatic IPFS resolution and CDN options
+ *
+ * Single entry point for all image URL building:
+ * - IPFS URIs → resolved via gateway + CDN options applied
+ * - HTTP URLs → CDN options applied directly
+ *
+ * @param url - Image URL (ipfs://, https://, or any URL)
+ * @param options - CDN optimization options (preset, quality, format, fit)
+ * @param gateway - IPFS gateway domain (required for ipfs:// URLs)
+ * @returns Optimized URL with query parameters
+ *
+ * @example
+ * ```typescript
+ * // IPFS thumbnail
+ * buildImageUrl('ipfs://QmHash', { preset: 'thumb' }, 'cdn.example.com')
+ * // => 'https://cdn.example.com/ipfs/QmHash?preset=thumb'
+ *
+ * // IPFS hero with high quality
+ * buildImageUrl('ipfs://QmHash', { preset: 'hero', q: 95, fit: 'cover' }, 'cdn.example.com')
+ * // => 'https://cdn.example.com/ipfs/QmHash?preset=hero&q=95&fit=cover'
+ *
+ * // HTTP URL (gateway ignored)
+ * buildImageUrl('https://example.com/photo.jpg', { preset: 'card' })
+ * // => 'https://example.com/photo.jpg?preset=card'
+ *
+ * // No options - just IPFS resolution
+ * buildImageUrl('ipfs://QmHash', undefined, 'cdn.example.com')
+ * // => 'https://cdn.example.com/ipfs/QmHash'
+ * ```
+ */
+function buildImageUrl(url, options, gateway) {
+    if (!url)
+        return '';
+    let resolvedUrl = url;
+    // Resolve IPFS to HTTP via gateway
+    if (url.startsWith('ipfs://')) {
+        if (!gateway) {
+            console.warn('[buildImageUrl] IPFS URL requires gateway parameter');
+            return url;
+        }
+        const cid = url.replace('ipfs://', '');
+        resolvedUrl = `https://${gateway}/ipfs/${cid}`;
+    }
+    // Apply CDN options
+    return persShared.buildImageCdnUrl(resolvedUrl, options);
+}
+/**
+ * Check if a URL is an IPFS URI
+ *
+ * @param url - URL to check
+ * @returns True if URL starts with ipfs://
+ */
+function isIpfsUrl(url) {
+    return !!url && url.startsWith('ipfs://');
+}
+/**
+ * Extract CID from IPFS URI
+ *
+ * @param ipfsUri - IPFS URI (ipfs://Qm... or ipfs://baf...)
+ * @returns CID string, or null if not a valid IPFS URI
+ *
+ * @example
+ * ```typescript
+ * extractIpfsCid('ipfs://QmHash123')
+ * // => 'QmHash123'
+ *
+ * extractIpfsCid('https://example.com/image.jpg')
+ * // => null
+ * ```
+ */
+function extractIpfsCid(ipfsUri) {
+    if (!isIpfsUrl(ipfsUri))
+        return null;
+    return ipfsUri.replace('ipfs://', '');
+}
 
 exports.AUTH_STORAGE_KEYS = persSdk.AUTH_STORAGE_KEYS;
 exports.AnalyticsManager = persSdk.AnalyticsManager;
@@ -32,8 +107,8 @@ exports.AuthApi = persSdk.AuthApi;
 exports.AuthManager = persSdk.AuthManager;
 exports.AuthService = persSdk.AuthService;
 Object.defineProperty(exports, "AuthStatus", {
-	enumerable: true,
-	get: function () { return persSdk.AuthStatus; }
+    enumerable: true,
+    get: function () { return persSdk.AuthStatus; }
 });
 exports.AuthTokenManager = persSdk.AuthTokenManager;
 exports.BusinessManager = persSdk.BusinessManager;
@@ -77,40 +152,76 @@ exports.createPersSDK = persSdk.createPersSDK;
 exports.isFatalAuthErrorInMessage = persSdk.isFatalAuthErrorInMessage;
 exports.mergeWithDefaults = persSdk.mergeWithDefaults;
 Object.defineProperty(exports, "AccountOwnerType", {
-	enumerable: true,
-	get: function () { return persShared.AccountOwnerType; }
+    enumerable: true,
+    get: function () { return persShared.AccountOwnerType; }
+});
+Object.defineProperty(exports, "IMAGE_CDN_DEFAULT_FIT", {
+    enumerable: true,
+    get: function () { return persShared.IMAGE_CDN_DEFAULT_FIT; }
+});
+Object.defineProperty(exports, "IMAGE_CDN_DEFAULT_FORMAT", {
+    enumerable: true,
+    get: function () { return persShared.IMAGE_CDN_DEFAULT_FORMAT; }
+});
+Object.defineProperty(exports, "IMAGE_CDN_DEFAULT_QUALITY", {
+    enumerable: true,
+    get: function () { return persShared.IMAGE_CDN_DEFAULT_QUALITY; }
+});
+Object.defineProperty(exports, "IMAGE_CDN_MAX_DIMENSION", {
+    enumerable: true,
+    get: function () { return persShared.IMAGE_CDN_MAX_DIMENSION; }
+});
+Object.defineProperty(exports, "IMAGE_CDN_PRESETS", {
+    enumerable: true,
+    get: function () { return persShared.IMAGE_CDN_PRESETS; }
 });
 Object.defineProperty(exports, "SortOrder", {
-	enumerable: true,
-	get: function () { return persShared.SortOrder; }
+    enumerable: true,
+    get: function () { return persShared.SortOrder; }
 });
 Object.defineProperty(exports, "VALID_USER_RELATIONS", {
-	enumerable: true,
-	get: function () { return persShared.VALID_USER_RELATIONS; }
+    enumerable: true,
+    get: function () { return persShared.VALID_USER_RELATIONS; }
+});
+Object.defineProperty(exports, "buildImageCdnUrl", {
+    enumerable: true,
+    get: function () { return persShared.buildImageCdnUrl; }
+});
+Object.defineProperty(exports, "getPresetDimensions", {
+    enumerable: true,
+    get: function () { return persShared.getPresetDimensions; }
 });
 Object.defineProperty(exports, "isConnectedMessage", {
-	enumerable: true,
-	get: function () { return persShared.isConnectedMessage; }
+    enumerable: true,
+    get: function () { return persShared.isConnectedMessage; }
 });
 Object.defineProperty(exports, "isErrorMessage", {
-	enumerable: true,
-	get: function () { return persShared.isErrorMessage; }
+    enumerable: true,
+    get: function () { return persShared.isErrorMessage; }
 });
 Object.defineProperty(exports, "isEventMessage", {
-	enumerable: true,
-	get: function () { return persShared.isEventMessage; }
+    enumerable: true,
+    get: function () { return persShared.isEventMessage; }
 });
 Object.defineProperty(exports, "isServerMessage", {
-	enumerable: true,
-	get: function () { return persShared.isServerMessage; }
+    enumerable: true,
+    get: function () { return persShared.isServerMessage; }
 });
 Object.defineProperty(exports, "isSubscribedMessage", {
-	enumerable: true,
-	get: function () { return persShared.isSubscribedMessage; }
+    enumerable: true,
+    get: function () { return persShared.isSubscribedMessage; }
+});
+Object.defineProperty(exports, "isSupportedImageFormat", {
+    enumerable: true,
+    get: function () { return persShared.isSupportedImageFormat; }
+});
+Object.defineProperty(exports, "isValidPreset", {
+    enumerable: true,
+    get: function () { return persShared.isValidPreset; }
 });
 Object.defineProperty(exports, "isValidUserRelation", {
-	enumerable: true,
-	get: function () { return persShared.isValidUserRelation; }
+    enumerable: true,
+    get: function () { return persShared.isValidUserRelation; }
 });
 exports.detectEnvironment = environment.detectEnvironment;
 exports.environment = environment.environment;
@@ -179,10 +290,13 @@ exports.TriggerSourceService = triggerSource.TriggerSourceService;
 exports.AngularHttpClientAdapter = platformAdapters.AngularHttpClientAdapter;
 exports.BrowserFetchClientAdapter = platformAdapters.BrowserFetchClientAdapter;
 exports.NodeHttpClientAdapter = nodeHttpClient.NodeHttpClientAdapter;
+exports.buildImageUrl = buildImageUrl;
+exports.extractIpfsCid = extractIpfsCid;
+exports.isIpfsUrl = isIpfsUrl;
 Object.keys(persShared).forEach(function (k) {
-	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-		enumerable: true,
-		get: function () { return persShared[k]; }
-	});
+    if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+        enumerable: true,
+        get: function () { return persShared[k]; }
+    });
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.cjs","sources":["../src/shared/utils/image-url-utils.ts"],"sourcesContent":[null],"names":["buildImageCdnUrl"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAyCA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BG;SACa,aAAa,CAC3B,GAAW,EACX,OAAyB,EACzB,OAAgB,EAAA;AAEhB,IAAA,IAAI,CAAC,GAAG;AAAE,QAAA,OAAO,EAAE;IAEnB,IAAI,WAAW,GAAG,GAAG;;AAGrB,IAAA,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE;QAC7B,IAAI,CAAC,OAAO,EAAE;AACZ,YAAA,OAAO,CAAC,IAAI,CAAC,qDAAqD,CAAC;AACnE,YAAA,OAAO,GAAG;QACZ;QACA,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;AACtC,QAAA,WAAW,GAAG,CAAA,QAAA,EAAW,OAAO,CAAA,MAAA,EAAS,GAAG,EAAE;IAChD;;AAGA,IAAA,OAAOA,2BAAgB,CAAC,WAAW,EAAE,OAAO,CAAC;AAC/C;AAEA;;;;;AAKG;AACG,SAAU,SAAS,CAAC,GAAW,EAAA;IACnC,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC;AAC3C;AAEA;;;;;;;;;;;;;;AAcG;AACG,SAAU,cAAc,CAAC,OAAe,EAAA;AAC5C,IAAA,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;AAAE,QAAA,OAAO,IAAI;IACpC,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;AACvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/index.js

@@ -1,6 +1,7 @@
-export { b as AUTH_STORAGE_KEYS, x as AnalyticsManager, K as ApiKeyApi, w as ApiKeyManager, l as AuthApi, r as AuthManager, o as AuthService, A as AuthStatus, a as AuthTokenManager, B as BusinessManager, C as CampaignManager, h as DEFAULT_PERS_CONFIG, d as DPOP_STORAGE_KEYS, p as DPoPManager, D as DefaultAuthProvider, y as DonationManager, F as FATAL_AUTH_CODES, H as FileApi, v as FileManager, J as FileService, I as IndexedDBTokenStorage, L as LocalStorageTokenStorage, M as MemoryTokenStorage, g as PersApiClient, q as PersEventEmitter, Q as PersEventsClient, P as PersSDK, u as PurchaseManager, R as RedemptionManager, S as SDK_NAME, f as SDK_USER_AGENT, e as SDK_VERSION, k as StaticJwtAuthProvider, T as TokenManager, t as TransactionManager, z as TriggerSourceManager, U as UserManager, s as UserStatusManager, G as WalletEventsManager, W as WebDPoPCryptoProvider, N as WebhookApi, E as WebhookManager, O as WebhookService, i as buildApiRoot, j as buildWalletEventsWsUrl, V as createPersEventsClient, c as createPersSDK, n as isFatalAuthErrorInMessage, m as mergeWithDefaults } from './chunks/pers-sdk-DuDWwRWC.js';
+export { a as AUTH_STORAGE_KEYS, w as AnalyticsManager, K as ApiKeyApi, v as ApiKeyManager, k as AuthApi, q as AuthManager, n as AuthService, G as AuthStatus, A as AuthTokenManager, B as BusinessManager, C as CampaignManager, g as DEFAULT_PERS_CONFIG, b as DPOP_STORAGE_KEYS, o as DPoPManager, D as DefaultAuthProvider, x as DonationManager, F as FATAL_AUTH_CODES, H as FileApi, u as FileManager, J as FileService, I as IndexedDBTokenStorage, L as LocalStorageTokenStorage, M as MemoryTokenStorage, f as PersApiClient, p as PersEventEmitter, Q as PersEventsClient, P as PersSDK, t as PurchaseManager, R as RedemptionManager, S as SDK_NAME, d as SDK_USER_AGENT, c as SDK_VERSION, j as StaticJwtAuthProvider, T as TokenManager, s as TransactionManager, y as TriggerSourceManager, U as UserManager, r as UserStatusManager, E as WalletEventsManager, W as WebDPoPCryptoProvider, N as WebhookApi, z as WebhookManager, O as WebhookService, h as buildApiRoot, i as buildWalletEventsWsUrl, V as createPersEventsClient, e as createPersSDK, l as isFatalAuthErrorInMessage, m as mergeWithDefaults } from './chunks/pers-sdk-DxYmXQcW.js';
+import { buildImageCdnUrl } from '@explorins/pers-shared';
 export * from '@explorins/pers-shared';
-export { AccountOwnerType, SortOrder, VALID_USER_RELATIONS, isConnectedMessage, isErrorMessage, isEventMessage, isServerMessage, isSubscribedMessage, isValidUserRelation } from '@explorins/pers-shared';
+export { AccountOwnerType, IMAGE_CDN_DEFAULT_FIT, IMAGE_CDN_DEFAULT_FORMAT, IMAGE_CDN_DEFAULT_QUALITY, IMAGE_CDN_MAX_DIMENSION, IMAGE_CDN_PRESETS, SortOrder, VALID_USER_RELATIONS, buildImageCdnUrl, getPresetDimensions, isConnectedMessage, isErrorMessage, isEventMessage, isServerMessage, isSubscribedMessage, isSupportedImageFormat, isValidPreset, isValidUserRelation } from '@explorins/pers-shared';
 export { d as detectEnvironment, e as environment, w as warnIfProblematicEnvironment } from './chunks/environment-DEI_L882.js';
 export { c as ApiErrorDetector, A as AuthenticationError, a as CacheService, C as CacheTTL, E as ErrorUtils, L as LogoutRequired, N as NetworkError, b as PersApiError, P as ProviderTokenRefreshNeeded, S as SdkErrorCodes, T as TokenRefreshNeeded, g as globalCacheService } from './chunks/index--OssIds0.js';
 export { T as TenantManager } from './chunks/tenant-manager-xmYKBFGu.js';
@@ -20,4 +21,83 @@ export { UserStatusApi, UserStatusService, createUserStatusSDK } from './user-st
 export { TriggerSourceApi, TriggerSourceService } from './trigger-source.js';
 export { AngularHttpClientAdapter, BrowserFetchClientAdapter } from './platform-adapters.js';
 export { N as NodeHttpClientAdapter } from './chunks/node-http-client-DloDLfm9.js';
+
+/**
+ * Build optimized image URL with automatic IPFS resolution and CDN options
+ *
+ * Single entry point for all image URL building:
+ * - IPFS URIs → resolved via gateway + CDN options applied
+ * - HTTP URLs → CDN options applied directly
+ *
+ * @param url - Image URL (ipfs://, https://, or any URL)
+ * @param options - CDN optimization options (preset, quality, format, fit)
+ * @param gateway - IPFS gateway domain (required for ipfs:// URLs)
+ * @returns Optimized URL with query parameters
+ *
+ * @example
+ * ```typescript
+ * // IPFS thumbnail
+ * buildImageUrl('ipfs://QmHash', { preset: 'thumb' }, 'cdn.example.com')
+ * // => 'https://cdn.example.com/ipfs/QmHash?preset=thumb'
+ *
+ * // IPFS hero with high quality
+ * buildImageUrl('ipfs://QmHash', { preset: 'hero', q: 95, fit: 'cover' }, 'cdn.example.com')
+ * // => 'https://cdn.example.com/ipfs/QmHash?preset=hero&q=95&fit=cover'
+ *
+ * // HTTP URL (gateway ignored)
+ * buildImageUrl('https://example.com/photo.jpg', { preset: 'card' })
+ * // => 'https://example.com/photo.jpg?preset=card'
+ *
+ * // No options - just IPFS resolution
+ * buildImageUrl('ipfs://QmHash', undefined, 'cdn.example.com')
+ * // => 'https://cdn.example.com/ipfs/QmHash'
+ * ```
+ */
+function buildImageUrl(url, options, gateway) {
+    if (!url)
+        return '';
+    let resolvedUrl = url;
+    // Resolve IPFS to HTTP via gateway
+    if (url.startsWith('ipfs://')) {
+        if (!gateway) {
+            console.warn('[buildImageUrl] IPFS URL requires gateway parameter');
+            return url;
+        }
+        const cid = url.replace('ipfs://', '');
+        resolvedUrl = `https://${gateway}/ipfs/${cid}`;
+    }
+    // Apply CDN options
+    return buildImageCdnUrl(resolvedUrl, options);
+}
+/**
+ * Check if a URL is an IPFS URI
+ *
+ * @param url - URL to check
+ * @returns True if URL starts with ipfs://
+ */
+function isIpfsUrl(url) {
+    return !!url && url.startsWith('ipfs://');
+}
+/**
+ * Extract CID from IPFS URI
+ *
+ * @param ipfsUri - IPFS URI (ipfs://Qm... or ipfs://baf...)
+ * @returns CID string, or null if not a valid IPFS URI
+ *
+ * @example
+ * ```typescript
+ * extractIpfsCid('ipfs://QmHash123')
+ * // => 'QmHash123'
+ *
+ * extractIpfsCid('https://example.com/image.jpg')
+ * // => null
+ * ```
+ */
+function extractIpfsCid(ipfsUri) {
+    if (!isIpfsUrl(ipfsUri))
+        return null;
+    return ipfsUri.replace('ipfs://', '');
+}
+
+export { buildImageUrl, extractIpfsCid, isIpfsUrl };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":["../src/shared/utils/image-url-utils.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAyCA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BG;SACa,aAAa,CAC3B,GAAW,EACX,OAAyB,EACzB,OAAgB,EAAA;AAEhB,IAAA,IAAI,CAAC,GAAG;AAAE,QAAA,OAAO,EAAE;IAEnB,IAAI,WAAW,GAAG,GAAG;;AAGrB,IAAA,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE;QAC7B,IAAI,CAAC,OAAO,EAAE;AACZ,YAAA,OAAO,CAAC,IAAI,CAAC,qDAAqD,CAAC;AACnE,YAAA,OAAO,GAAG;QACZ;QACA,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;AACtC,QAAA,WAAW,GAAG,CAAA,QAAA,EAAW,OAAO,CAAA,MAAA,EAAS,GAAG,EAAE;IAChD;;AAGA,IAAA,OAAO,gBAAgB,CAAC,WAAW,EAAE,OAAO,CAAC;AAC/C;AAEA;;;;;AAKG;AACG,SAAU,SAAS,CAAC,GAAW,EAAA;IACnC,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC;AAC3C;AAEA;;;;;;;;;;;;;;AAcG;AACG,SAAU,cAAc,CAAC,OAAe,EAAA;AAC5C,IAAA,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;AAAE,QAAA,OAAO,IAAI;IACpC,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;AACvC;;;;"}

package/dist/node.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var persSdk = require('./chunks/pers-sdk-CBvzmlL_.cjs');
+var persSdk = require('./chunks/pers-sdk-DeFxjuRB.cjs');
 var persShared = require('@explorins/pers-shared');
 var nodeHttpClient = require('./chunks/node-http-client-D_avaa5F.cjs');
 require('./chunks/index-C4K-jkRO.cjs');

package/dist/node.js

@@ -1,4 +1,4 @@
-import { k as StaticJwtAuthProvider, P as PersSDK } from './chunks/pers-sdk-DuDWwRWC.js';
+import { j as StaticJwtAuthProvider, P as PersSDK } from './chunks/pers-sdk-DxYmXQcW.js';
 import { AccountOwnerType } from '@explorins/pers-shared';
 export { AccountOwnerType } from '@explorins/pers-shared';
 import { N as NodeHttpClientAdapter } from './chunks/node-http-client-DloDLfm9.js';

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@explorins/pers-sdk",
-  "version": "2.1.40",
+  "version": "2.1.42",
   "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.147",
+    "@explorins/pers-shared": "^2.1.154",
     "@explorins/web3-ts": "^0.3.88",
     "@explorins/web3-types": "^1.2.0",
     "ethers": "^6.15.0"

package/dist/shared/index.d.ts

@@ -4,4 +4,5 @@
  */
 export * from './interfaces/pers-shared-lib.interfaces';
 export * from './utils/pagination-utils';
+export * from './utils/image-url-utils';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,yCAAyC,CAAC;AAGxD,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,yCAAyC,CAAC;AAGxD,cAAc,0BAA0B,CAAC;AAGzC,cAAc,yBAAyB,CAAC"}

package/dist/shared/utils/image-url-utils.d.ts

@@ -0,0 +1,76 @@
+import { ImageCdnOptions } from '@explorins/pers-shared';
+/**
+ * Image URL Utilities
+ *
+ * Centralized helper for building optimized image URLs.
+ * Handles IPFS resolution and CDN optimization in one call.
+ *
+ * @example
+ * ```typescript
+ * import { buildImageUrl } from '@explorins/pers-sdk';
+ *
+ * // IPFS with CDN preset
+ * const thumbUrl = buildImageUrl('ipfs://Qm...', { preset: 'thumb' }, 'cdn.example.com');
+ *
+ * // HTTP URL with CDN preset (no gateway needed)
+ * const cardUrl = buildImageUrl('https://example.com/photo.jpg', { preset: 'card' });
+ * ```
+ */
+export { buildImageCdnUrl, isValidPreset, getPresetDimensions, isSupportedImageFormat, IMAGE_CDN_PRESETS, IMAGE_CDN_DEFAULT_QUALITY, IMAGE_CDN_DEFAULT_FIT, IMAGE_CDN_DEFAULT_FORMAT, IMAGE_CDN_MAX_DIMENSION, } from '@explorins/pers-shared';
+export type { ImageCdnOptions, ImagePreset, ImageFit, ImageFormat, ImagePresetConfig, } from '@explorins/pers-shared';
+/**
+ * Build optimized image URL with automatic IPFS resolution and CDN options
+ *
+ * Single entry point for all image URL building:
+ * - IPFS URIs → resolved via gateway + CDN options applied
+ * - HTTP URLs → CDN options applied directly
+ *
+ * @param url - Image URL (ipfs://, https://, or any URL)
+ * @param options - CDN optimization options (preset, quality, format, fit)
+ * @param gateway - IPFS gateway domain (required for ipfs:// URLs)
+ * @returns Optimized URL with query parameters
+ *
+ * @example
+ * ```typescript
+ * // IPFS thumbnail
+ * buildImageUrl('ipfs://QmHash', { preset: 'thumb' }, 'cdn.example.com')
+ * // => 'https://cdn.example.com/ipfs/QmHash?preset=thumb'
+ *
+ * // IPFS hero with high quality
+ * buildImageUrl('ipfs://QmHash', { preset: 'hero', q: 95, fit: 'cover' }, 'cdn.example.com')
+ * // => 'https://cdn.example.com/ipfs/QmHash?preset=hero&q=95&fit=cover'
+ *
+ * // HTTP URL (gateway ignored)
+ * buildImageUrl('https://example.com/photo.jpg', { preset: 'card' })
+ * // => 'https://example.com/photo.jpg?preset=card'
+ *
+ * // No options - just IPFS resolution
+ * buildImageUrl('ipfs://QmHash', undefined, 'cdn.example.com')
+ * // => 'https://cdn.example.com/ipfs/QmHash'
+ * ```
+ */
+export declare function buildImageUrl(url: string, options?: ImageCdnOptions, gateway?: string): string;
+/**
+ * Check if a URL is an IPFS URI
+ *
+ * @param url - URL to check
+ * @returns True if URL starts with ipfs://
+ */
+export declare function isIpfsUrl(url: string): boolean;
+/**
+ * Extract CID from IPFS URI
+ *
+ * @param ipfsUri - IPFS URI (ipfs://Qm... or ipfs://baf...)
+ * @returns CID string, or null if not a valid IPFS URI
+ *
+ * @example
+ * ```typescript
+ * extractIpfsCid('ipfs://QmHash123')
+ * // => 'QmHash123'
+ *
+ * extractIpfsCid('https://example.com/image.jpg')
+ * // => null
+ * ```
+ */
+export declare function extractIpfsCid(ipfsUri: string): string | null;
+//# sourceMappingURL=image-url-utils.d.ts.map

package/dist/shared/utils/image-url-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-url-utils.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/image-url-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE3E;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,EACjB,yBAAyB,EACzB,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EACV,eAAe,EACf,WAAW,EACX,QAAQ,EACR,WAAW,EACX,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,eAAe,EACzB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAiBR;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG7D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@explorins/pers-sdk",
-  "version": "2.1.40",
+  "version": "2.1.42",
   "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.147",
+    "@explorins/pers-shared": "^2.1.154",
     "@explorins/web3-ts": "^0.3.88",
     "@explorins/web3-types": "^1.2.0",
     "ethers": "^6.15.0"