@explorins/pers-sdk 1.6.0 → 1.6.2

package/dist/core.js

@@ -1,7 +1,8 @@
-export { h as AnalyticsManager, A as AuthManager, B as BusinessManager, C as CampaignManager, D as DEFAULT_PERS_CONFIG, i as DonationManager, b as PersApiClient, P as PersSDK, f as PurchaseManager, R as RedemptionManager, g as TenantManager, T as TokenManager, e as TransactionManager, U as UserManager, d as buildApiRoot, a as createAuthProvider, c as createPersSDK, m as mergeWithDefaults } from './chunks/pers-sdk-gnQ_VcEq.js';
-export { d as detectEnvironment, e as environment, w as warnIfProblematicEnvironment } from './chunks/environment-C2AkkLPd.js';
+export { i as AnalyticsManager, A as AuthManager, B as BusinessManager, C as CampaignManager, D as DEFAULT_PERS_CONFIG, j as DonationManager, F as FileManager, b as PersApiClient, P as PersSDK, g as PurchaseManager, R as RedemptionManager, h as TenantManager, T as TokenManager, f as TransactionManager, U as UserManager, e as UserStatusManager, W as Web3Manager, d as buildApiRoot, a as createAuthProvider, c as createPersSDK, m as mergeWithDefaults } from './chunks/pers-sdk-CoKZ7rHG.js';
+export { d as detectEnvironment, e as environment, w as warnIfProblematicEnvironment } from './chunks/index-CJ9Jfa4A.js';
 import '@explorins/pers-shared';
 import './user.js';
+import './user-status.js';
 import './chunks/token-sdk-BW4kkJb3.js';
 import './business.js';
 import './campaign.js';
@@ -11,4 +12,7 @@ import './payment.js';
 import './tenant.js';
 import './analytics.js';
 import './donation.js';
+import './chunks/index-CM21r58m.js';
+import 'jwt-decode';
+import '@explorins/web3-ts/ethers';
 //# sourceMappingURL=core.js.map

package/dist/core.js.map

@@ -1 +1 @@
-{"version":3,"file":"core.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;"}
+{"version":3,"file":"core.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;"}

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

@@ -0,0 +1,35 @@
+import { PersApiClient } from '../../core/pers-api-client';
+import type { SignedUrlRequest, SignedUrlResponse, FileOptimizeRequest, FileOptimizeResponse } from '../models';
+/**
+ * Platform-Agnostic File API Client
+ *
+ * Handles file operations using the PERS backend's RESTful endpoints.
+ */
+export declare class FileApi {
+    private apiClient;
+    constructor(apiClient: PersApiClient);
+    private readonly basePath;
+    /**
+     * PUBLIC: Get signed URL for file operations
+     *
+     * @param request - Signed URL request parameters
+     * @returns Promise resolving to signed URL response
+     */
+    getSignedUrl(request: SignedUrlRequest): Promise<SignedUrlResponse>;
+    /**
+     * PUBLIC: Get signed GET URL for file access
+     *
+     * @param url - File URL
+     * @param expireSeconds - Optional expiration time in seconds
+     * @returns Promise resolving to signed URL response
+     */
+    getSignedGetUrl(url: string, expireSeconds?: number): Promise<SignedUrlResponse>;
+    /**
+     * PUBLIC: Optimize media from URL
+     *
+     * @param request - File optimization request
+     * @returns Promise resolving to optimized file URL
+     */
+    optimizeMediaFromUrl(request: FileOptimizeRequest): Promise<FileOptimizeResponse>;
+}
+//# sourceMappingURL=file-api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-api.d.ts","sourceRoot":"","sources":["../../../src/file/api/file-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,WAAW,CAAC;AAEnB;;;;GAIG;AACH,qBAAa,OAAO;IACN,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,aAAa;IAE5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAY;IAMrC;;;;;OAKG;IACG,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIzE;;;;;;OAMG;IACG,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAStF;;;;;OAKG;IACG,oBAAoB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAOxF"}

package/dist/file/api/index.d.ts

@@ -0,0 +1,2 @@
+export * from './file-api';
+//# sourceMappingURL=index.d.ts.map

package/dist/file/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/file/api/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC"}

package/dist/file/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * File Domain - File and media management operations
+ *
+ * Handles file uploads, signed URLs, and media optimization for the PERS platform.
+ */
+export * from './api';
+export * from './models';
+export * from './services';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/file/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC"}

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

@@ -0,0 +1,26 @@
+/**
+ * File Domain Models
+ */
+export type FileUploadEntityType = 'token' | 'campaign' | 'redemption' | 'business' | 'tenant' | 'user';
+export interface SignedUrlRequest {
+    entityId: string;
+    entityType: FileUploadEntityType;
+    signedUrlType: 'GET' | 'PUT';
+    fileExtension?: string;
+}
+export interface SignedPutUrlRequest extends SignedUrlRequest {
+    signedUrlType: 'PUT';
+    fileExtension: string;
+}
+export interface SignedUrlResponse {
+    signedUrl: string;
+}
+export interface FileOptimizeRequest {
+    url: string;
+    width?: number;
+    height?: number;
+}
+export interface FileOptimizeResponse {
+    optimizedUrl: string;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/file/models/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,UAAU,GAAG,YAAY,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAC;AAExG,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,oBAAoB,CAAC;IACjC,aAAa,EAAE,KAAK,GAAG,KAAK,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D,aAAa,EAAE,KAAK,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;CACtB"}

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

@@ -0,0 +1,57 @@
+import { PersApiClient } from '../../core/pers-api-client';
+import { FileApi } from '../api/file-api';
+import type { SignedUrlRequest, FileUploadEntityType } from '../models';
+/**
+ * File Service - High-level file operations
+ *
+ * Provides convenient methods for file upload, signed URLs, and media optimization.
+ */
+export declare class FileService {
+    private fileApi;
+    constructor(apiClient: PersApiClient);
+    /**
+     * Get signed PUT URL for file upload
+     *
+     * @param entityId - Entity ID to associate the file with
+     * @param entityType - Type of entity (token, campaign, etc.)
+     * @param fileExtension - File extension (e.g., 'jpg', 'png')
+     * @returns Promise resolving to signed upload URL
+     */
+    getSignedPutUrl(entityId: string, entityType: FileUploadEntityType, fileExtension: string): Promise<string>;
+    /**
+     * Get signed GET URL for file access
+     *
+     * @param entityId - Entity ID
+     * @param entityType - Type of entity
+     * @param expireSeconds - Optional expiration time in seconds
+     * @returns Promise resolving to signed access URL
+     */
+    getSignedGetUrl(entityId: string, entityType: FileUploadEntityType, expireSeconds?: number): Promise<string>;
+    /**
+     * Get signed URL for any file operation
+     *
+     * @param request - Signed URL request
+     * @returns Promise resolving to signed URL
+     */
+    getSignedUrl(request: SignedUrlRequest): Promise<string>;
+    /**
+     * Optimize media from URL
+     *
+     * @param url - Original file URL
+     * @param width - Optional target width
+     * @param height - Optional target height
+     * @returns Promise resolving to optimized file URL
+     */
+    optimizeMedia(url: string, width?: number, height?: number): Promise<string>;
+    /**
+     * Get the file API instance for advanced operations
+     *
+     * @returns FileApi instance
+     */
+    getFileApi(): FileApi;
+}
+/**
+ * Factory function for creating file service
+ */
+export declare function createFileSDK(apiClient: PersApiClient): FileService;
+//# sourceMappingURL=file-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-service.d.ts","sourceRoot":"","sources":["../../../src/file/services/file-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,KAAK,EACV,gBAAgB,EAGhB,oBAAoB,EACrB,MAAM,WAAW,CAAC;AAEnB;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAU;gBAEb,SAAS,EAAE,aAAa;IAIpC;;;;;;;OAOG;IACG,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,oBAAoB,EAChC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC;IAYlB;;;;;;;OAOG;IACG,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,oBAAoB,EAChC,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,CAAC;IAWlB;;;;;OAKG;IACG,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAK9D;;;;;;;OAOG;IACG,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMlF;;;;OAIG;IACH,UAAU,IAAI,OAAO;CAGtB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,aAAa,GAAG,WAAW,CAEnE"}

package/dist/file/services/index.d.ts

@@ -0,0 +1,2 @@
+export * from './file-service';
+//# sourceMappingURL=index.d.ts.map

package/dist/file/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/file/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var persSdk = require('./chunks/pers-sdk-UNKbbSC_.cjs');
-var environment = require('./chunks/environment-CRROnwAY.cjs');
+var persSdk = require('./chunks/pers-sdk-C3Sc2hyn.cjs');
+var web3 = require('./chunks/index-CzEluQmf.cjs');
 var persShared = require('@explorins/pers-shared');
 var business = require('./business.cjs');
 var transaction = require('./transaction.cjs');
@@ -15,12 +15,10 @@ var tokenSdk = require('./chunks/token-sdk-CiAbOb6c.cjs');
 var baseTokenService = require('./chunks/base-token-service-zNfPjHRx.cjs');
 var user = require('./user.cjs');
 var userStatus = require('./user-status.cjs');
-var web3Chain = require('./web3-chain.cjs');
-var web3 = require('./web3.cjs');
+var web3Chain = require('./chunks/index-BfOoX87y.cjs');
 var platformAdapters = require('./platform-adapters.cjs');
-require('./chunks/jwt.function-BYiyl-z_.cjs');
-require('jwt-decode');
 require('@explorins/web3-ts/ethers');
+require('jwt-decode');
 
 
 
@@ -30,6 +28,9 @@ exports.BusinessManager = persSdk.BusinessManager;
 exports.CampaignManager = persSdk.CampaignManager;
 exports.DEFAULT_PERS_CONFIG = persSdk.DEFAULT_PERS_CONFIG;
 exports.DonationManager = persSdk.DonationManager;
+exports.FileApi = persSdk.FileApi;
+exports.FileManager = persSdk.FileManager;
+exports.FileService = persSdk.FileService;
 exports.PersApiClient = persSdk.PersApiClient;
 exports.PersSDK = persSdk.PersSDK;
 exports.PurchaseManager = persSdk.PurchaseManager;
@@ -38,13 +39,22 @@ exports.TenantManager = persSdk.TenantManager;
 exports.TokenManager = persSdk.TokenManager;
 exports.TransactionManager = persSdk.TransactionManager;
 exports.UserManager = persSdk.UserManager;
+exports.UserStatusManager = persSdk.UserStatusManager;
+exports.Web3Manager = persSdk.Web3Manager;
 exports.buildApiRoot = persSdk.buildApiRoot;
 exports.createAuthProvider = persSdk.createAuthProvider;
+exports.createFileSDK = persSdk.createFileSDK;
 exports.createPersSDK = persSdk.createPersSDK;
 exports.mergeWithDefaults = persSdk.mergeWithDefaults;
-exports.detectEnvironment = environment.detectEnvironment;
-exports.environment = environment.environment;
-exports.warnIfProblematicEnvironment = environment.warnIfProblematicEnvironment;
+exports.IPFSInfrastructureApi = web3.IPFSInfrastructureApi;
+exports.Web3ApplicationService = web3.Web3ApplicationService;
+exports.Web3InfrastructureApi = web3.Web3InfrastructureApi;
+exports.createWeb3SDK = web3.createWeb3SDK;
+exports.detectEnvironment = web3.detectEnvironment;
+exports.environment = web3.environment;
+exports.getExplorerUrl = web3.getExplorerUrl;
+exports.getExplorerUrlByChainId = web3.getExplorerUrlByChainId;
+exports.warnIfProblematicEnvironment = web3.warnIfProblematicEnvironment;
 Object.defineProperty(exports, "AccountOwnerType", {
 	enumerable: true,
 	get: function () { return persShared.AccountOwnerType; }
@@ -91,10 +101,6 @@ exports.ChainTypes = web3Chain.ChainTypes;
 exports.Web3ChainApi = web3Chain.Web3ChainApi;
 exports.Web3ChainService = web3Chain.Web3ChainService;
 exports.createWeb3ChainSDK = web3Chain.createWeb3ChainSDK;
-exports.IPFSInfrastructureApi = web3.IPFSInfrastructureApi;
-exports.Web3ApplicationService = web3.Web3ApplicationService;
-exports.Web3InfrastructureApi = web3.Web3InfrastructureApi;
-exports.createWeb3SDK = web3.createWeb3SDK;
 exports.AngularHttpClientAdapter = platformAdapters.AngularHttpClientAdapter;
 exports.BrowserFetchClientAdapter = platformAdapters.BrowserFetchClientAdapter;
 exports.NodeHttpClientAdapter = platformAdapters.NodeHttpClientAdapter;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/index.d.ts

@@ -11,6 +11,7 @@ export * from './analytics';
 export * from './campaign';
 export * from './donation';
 export * from './payment';
+export * from './file';
 export * from './redemption';
 export * from './tenant';
 export * from './token';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,QAAQ,CAAA;AAGtB,cAAc,UAAU,CAAC;AAGzB,cAAc,YAAY,CAAC;AAG3B,cAAc,eAAe,CAAC;AAG9B,cAAc,aAAa,CAAC;AAG5B,cAAc,YAAY,CAAC;AAG3B,cAAc,YAAY,CAAC;AAG3B,cAAc,WAAW,CAAC;AAG1B,cAAc,cAAc,CAAC;AAG7B,cAAc,UAAU,CAAC;AAGzB,cAAc,SAAS,CAAC;AAGxB,cAAc,QAAQ,CAAC;AAGvB,cAAc,eAAe,CAAC;AAG9B,cAAc,cAAc,CAAC;AAG7B,cAAc,QAAQ,CAAC;AAGvB,cAAc,YAAY,CAAC;AAG3B,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAOpD,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,QAAQ,CAAA;AAGtB,cAAc,UAAU,CAAC;AAGzB,cAAc,YAAY,CAAC;AAG3B,cAAc,eAAe,CAAC;AAG9B,cAAc,aAAa,CAAC;AAG5B,cAAc,YAAY,CAAC;AAG3B,cAAc,YAAY,CAAC;AAG3B,cAAc,WAAW,CAAC;AAG1B,cAAc,QAAQ,CAAC;AAGvB,cAAc,cAAc,CAAC;AAG7B,cAAc,UAAU,CAAC;AAGzB,cAAc,SAAS,CAAC;AAGxB,cAAc,QAAQ,CAAC;AAGvB,cAAc,eAAe,CAAC;AAG9B,cAAc,cAAc,CAAC;AAG7B,cAAc,QAAQ,CAAC;AAGvB,cAAc,YAAY,CAAC;AAG3B,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAOpD,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -1,5 +1,5 @@
-export { h as AnalyticsManager, A as AuthManager, B as BusinessManager, C as CampaignManager, D as DEFAULT_PERS_CONFIG, i as DonationManager, b as PersApiClient, P as PersSDK, f as PurchaseManager, R as RedemptionManager, g as TenantManager, T as TokenManager, e as TransactionManager, U as UserManager, d as buildApiRoot, a as createAuthProvider, c as createPersSDK, m as mergeWithDefaults } from './chunks/pers-sdk-gnQ_VcEq.js';
-export { d as detectEnvironment, e as environment, w as warnIfProblematicEnvironment } from './chunks/environment-C2AkkLPd.js';
+export { i as AnalyticsManager, A as AuthManager, B as BusinessManager, C as CampaignManager, D as DEFAULT_PERS_CONFIG, j as DonationManager, k as FileApi, F as FileManager, l as FileService, b as PersApiClient, P as PersSDK, g as PurchaseManager, R as RedemptionManager, h as TenantManager, T as TokenManager, f as TransactionManager, U as UserManager, e as UserStatusManager, W as Web3Manager, d as buildApiRoot, a as createAuthProvider, n as createFileSDK, c as createPersSDK, m as mergeWithDefaults } from './chunks/pers-sdk-CoKZ7rHG.js';
+export { I as IPFSInfrastructureApi, W as Web3ApplicationService, a as Web3InfrastructureApi, c as createWeb3SDK, d as detectEnvironment, e as environment, g as getExplorerUrl, b as getExplorerUrlByChainId, w as warnIfProblematicEnvironment } from './chunks/index-CJ9Jfa4A.js';
 export { AccountOwnerType } from '@explorins/pers-shared';
 export { BusinessApi, BusinessService, createBusinessSDK } from './business.js';
 export { TransactionAccountType, TransactionApi, TransactionService, createTransactionSDK } from './transaction.js';
@@ -13,10 +13,8 @@ export { a as TokenApi, T as TokenSDK, b as TokenService } from './chunks/token-
 export { B as BaseTokenService } from './chunks/base-token-service-D0KANDgM.js';
 export { UserApi, UserService, createUserSDK } from './user.js';
 export { UserStatusApi, UserStatusService, createUserStatusSDK } from './user-status.js';
-export { ChainTypes, Web3ChainApi, Web3ChainService, createWeb3ChainSDK } from './web3-chain.js';
-export { IPFSInfrastructureApi, Web3ApplicationService, Web3InfrastructureApi, createWeb3SDK } from './web3.js';
+export { C as ChainTypes, W as Web3ChainApi, a as Web3ChainService, c as createWeb3ChainSDK } from './chunks/index-CM21r58m.js';
 export { AngularHttpClientAdapter, BrowserFetchClientAdapter, NodeHttpClientAdapter } from './platform-adapters.js';
-import './chunks/jwt.function-d6jPtBqI.js';
-import 'jwt-decode';
 import '@explorins/web3-ts/ethers';
+import 'jwt-decode';
 //# 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":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;"}

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

@@ -0,0 +1,55 @@
+import { PersApiClient } from '../core/pers-api-client';
+import { FileService } from '../file';
+import type { SignedUrlRequest, FileUploadEntityType } from '../file/models';
+/**
+ * File Manager - Clean, high-level interface for file operations
+ *
+ * Provides a simplified API for common file management tasks while maintaining
+ * access to the full file SDK for advanced use cases.
+ */
+export declare class FileManager {
+    private apiClient;
+    private fileSDK;
+    constructor(apiClient: PersApiClient);
+    /**
+     * Get signed URL for file upload
+     *
+     * @param entityId - Entity ID to associate the file with
+     * @param entityType - Type of entity (token, campaign, etc.)
+     * @param fileExtension - File extension (e.g., 'jpg', 'png')
+     * @returns Promise resolving to signed upload URL
+     */
+    getSignedPutUrl(entityId: string, entityType: FileUploadEntityType, fileExtension: string): Promise<string>;
+    /**
+     * Get signed URL for file access
+     *
+     * @param entityId - Entity ID
+     * @param entityType - Type of entity
+     * @param expireSeconds - Optional expiration time in seconds
+     * @returns Promise resolving to signed access URL
+     */
+    getSignedGetUrl(entityId: string, entityType: FileUploadEntityType, expireSeconds?: number): Promise<string>;
+    /**
+     * Get signed URL for any file operation
+     *
+     * @param request - Signed URL request
+     * @returns Promise resolving to signed URL
+     */
+    getSignedUrl(request: SignedUrlRequest): Promise<string>;
+    /**
+     * Optimize media file
+     *
+     * @param url - Original file URL
+     * @param width - Optional target width
+     * @param height - Optional target height
+     * @returns Promise resolving to optimized file URL
+     */
+    optimizeMedia(url: string, width?: number, height?: number): Promise<string>;
+    /**
+     * Get the full file SDK for advanced operations
+     *
+     * @returns FileService instance
+     */
+    getFileSDK(): FileService;
+}
+//# sourceMappingURL=file-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-manager.d.ts","sourceRoot":"","sources":["../../src/managers/file-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAiB,WAAW,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,KAAK,EACV,gBAAgB,EAEhB,oBAAoB,EACrB,MAAM,gBAAgB,CAAC;AAExB;;;;;GAKG;AACH,qBAAa,WAAW;IAGV,OAAO,CAAC,SAAS;IAF7B,OAAO,CAAC,OAAO,CAAc;gBAET,SAAS,EAAE,aAAa;IAI5C;;;;;;;OAOG;IACG,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,oBAAoB,EAChC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC;IAIlB;;;;;;;OAOG;IACG,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,oBAAoB,EAChC,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,CAAC;IAIlB;;;;;OAKG;IACG,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAI9D;;;;;;;OAOG;IACG,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIlF;;;;OAIG;IACH,UAAU,IAAI,WAAW;CAG1B"}

package/dist/managers/index.d.ts

@@ -6,13 +6,16 @@
  */
 export { AuthManager } from './auth-manager';
 export { UserManager } from './user-manager';
+export { UserStatusManager } from './user-status-manager';
 export { TokenManager } from './token-manager';
 export { BusinessManager } from './business-manager';
 export { CampaignManager } from './campaign-manager';
 export { RedemptionManager } from './redemption-manager';
 export { TransactionManager } from './transaction-manager';
 export { PurchaseManager } from './purchase-manager';
+export { FileManager } from './file-manager';
 export { TenantManager } from './tenant-manager';
 export { AnalyticsManager } from './analytics-manager';
 export { DonationManager } from './donation-manager';
+export { Web3Manager } from './web3-manager';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/managers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/managers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

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

@@ -50,6 +50,14 @@ export declare class TenantManager {
      * @returns Promise resolving to created admin
      */
     createAdmin(adminData: AdminCreateRequestDTO): Promise<AdminDTO>;
+    /**
+     * Admin: Update existing admin
+     *
+     * @param adminId - ID of the admin to update
+     * @param adminData - Updated admin data
+     * @returns Promise resolving to updated admin
+     */
+    updateAdmin(adminId: string, adminData: AdminCreateRequestDTO): Promise<AdminDTO>;
     /**
      * Get the full tenant SDK for advanced operations
      *

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

@@ -1 +1 @@
-{"version":3,"file":"tenant-manager.d.ts","sourceRoot":"","sources":["../../src/managers/tenant-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAmB,SAAS,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,KAAK,EAEV,eAAe,EACf,qBAAqB,EACrB,QAAQ,EACT,MAAM,iDAAiD,CAAC;AACzD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE9D;;;;;GAKG;AACH,qBAAa,aAAa;IAGZ,OAAO,CAAC,SAAS;IAF7B,OAAO,CAAC,SAAS,CAAY;gBAET,SAAS,EAAE,aAAa;IAI5C;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,eAAe,CAAC;IAI/C;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAItC;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAIvD;;;;;OAKG;IACG,YAAY,CAAC,UAAU,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAIzE;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAItC;;;;;OAKG;IACG,WAAW,CAAC,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAItE;;;;OAIG;IACH,YAAY,IAAI,SAAS;CAG1B"}
+{"version":3,"file":"tenant-manager.d.ts","sourceRoot":"","sources":["../../src/managers/tenant-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAmB,SAAS,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,KAAK,EAEV,eAAe,EACf,qBAAqB,EACrB,QAAQ,EACT,MAAM,iDAAiD,CAAC;AACzD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE9D;;;;;GAKG;AACH,qBAAa,aAAa;IAGZ,OAAO,CAAC,SAAS;IAF7B,OAAO,CAAC,SAAS,CAAY;gBAET,SAAS,EAAE,aAAa;IAI5C;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,eAAe,CAAC;IAI/C;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAItC;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAIvD;;;;;OAKG;IACG,YAAY,CAAC,UAAU,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAIzE;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAItC;;;;;OAKG;IACG,WAAW,CAAC,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAItE;;;;;;OAMG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIvF;;;;OAIG;IACH,YAAY,IAAI,SAAS;CAG1B"}

package/dist/managers/user-status-manager.d.ts

@@ -0,0 +1,40 @@
+import { PersApiClient } from '../core/pers-api-client';
+import { UserStatusSDK } from '../user-status';
+import type { UserStatusTypeDTO } from '../shared/interfaces/pers-shared-lib.interfaces';
+/**
+ * User Status Manager - Clean, high-level interface for user status operations
+ *
+ * Provides a simplified API for common user status management tasks while maintaining
+ * access to the full user status SDK for advanced use cases.
+ */
+export declare class UserStatusManager {
+    private apiClient;
+    private userStatusSDK;
+    constructor(apiClient: PersApiClient);
+    /**
+     * Get all user status types
+     *
+     * @returns Promise resolving to array of user status types
+     */
+    getUserStatusTypes(): Promise<UserStatusTypeDTO[]>;
+    /**
+     * Get earned user status for authenticated user
+     *
+     * @returns Promise resolving to array of earned user status
+     */
+    getEarnedUserStatus(): Promise<UserStatusTypeDTO[]>;
+    /**
+     * Admin: Create new user status type
+     *
+     * @param userStatusType - User status type data
+     * @returns Promise resolving to created user status type
+     */
+    createUserStatusType(userStatusType: UserStatusTypeDTO): Promise<UserStatusTypeDTO>;
+    /**
+     * Get the full user status SDK for advanced operations
+     *
+     * @returns UserStatusSDK instance
+     */
+    getUserStatusSDK(): UserStatusSDK;
+}
+//# sourceMappingURL=user-status-manager.d.ts.map

package/dist/managers/user-status-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-status-manager.d.ts","sourceRoot":"","sources":["../../src/managers/user-status-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAuB,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAC;AAEzF;;;;;GAKG;AACH,qBAAa,iBAAiB;IAGhB,OAAO,CAAC,SAAS;IAF7B,OAAO,CAAC,aAAa,CAAgB;gBAEjB,SAAS,EAAE,aAAa;IAI5C;;;;OAIG;IACG,kBAAkB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIxD;;;;OAIG;IACG,mBAAmB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIzD;;;;;OAKG;IACG,oBAAoB,CAAC,cAAc,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIzF;;;;OAIG;IACH,gBAAgB,IAAI,aAAa;CAGlC"}

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

@@ -0,0 +1,76 @@
+import { PersApiClient } from '../core/pers-api-client';
+import { Web3SDK } from '../web3';
+import type { TokenBalanceRequest, TokenCollectionRequest, TokenBalance, TokenCollection, TokenMetadata } from '../web3/application/web3-application.service';
+import type { ChainData } from '../web3-chain';
+/**
+ * Web3 Manager - Clean, high-level interface for Web3 operations
+ *
+ * Provides a simplified API for common Web3 blockchain tasks while maintaining
+ * access to the full Web3 SDK for advanced use cases.
+ */
+export declare class Web3Manager {
+    private apiClient;
+    private web3SDK;
+    private web3ChainSDK;
+    constructor(apiClient: PersApiClient);
+    /**
+     * Get token balance for a specific token
+     *
+     * @param request - Token balance request parameters
+     * @returns Promise resolving to token balance
+     */
+    getTokenBalance(request: TokenBalanceRequest): Promise<TokenBalance>;
+    /**
+     * Get token metadata
+     *
+     * @param request - Token metadata request parameters
+     * @returns Promise resolving to token metadata or null if not found
+     */
+    getTokenMetadata(request: TokenBalanceRequest): Promise<TokenMetadata | null>;
+    /**
+     * Get token collection
+     *
+     * @param request - Token collection request parameters
+     * @returns Promise resolving to token collection
+     */
+    getTokenCollection(request: TokenCollectionRequest): Promise<TokenCollection>;
+    /**
+     * Resolve IPFS URL to accessible URL
+     *
+     * @param url - IPFS URL to resolve
+     * @param chainId - Chain ID for context
+     * @returns Promise resolving to accessible URL
+     */
+    resolveIPFSUrl(url: string, chainId: number): Promise<string>;
+    /**
+     * Fetch and process token metadata
+     *
+     * @param tokenUri - Token URI to fetch metadata from
+     * @param chainId - Chain ID for context
+     * @returns Promise resolving to processed metadata or null if not found
+     */
+    fetchAndProcessMetadata(tokenUri: string, chainId: number): Promise<TokenMetadata | null>;
+    /**
+     * Get blockchain chain data by chain ID
+     *
+     * @param chainId - Chain ID to get data for
+     * @returns Promise resolving to chain data or null if not found
+     */
+    getChainDataById(chainId: number): Promise<ChainData | null>;
+    /**
+     * Get explorer URL for a given address or transaction
+     *
+     * @param chainId - Chain ID to get explorer URL for
+     * @param address - Address or transaction hash
+     * @param type - Type of explorer URL ('address' or 'tx')
+     * @returns Promise resolving to explorer URL
+     */
+    getExplorerUrl(chainId: number, address: string, type: 'address' | 'tx'): Promise<string>;
+    /**
+     * Get the full Web3 SDK for advanced operations
+     *
+     * @returns Web3SDK instance
+     */
+    getWeb3SDK(): Web3SDK;
+}
+//# sourceMappingURL=web3-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"web3-manager.d.ts","sourceRoot":"","sources":["../../src/managers/web3-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAiB,OAAO,EAA2B,MAAM,SAAS,CAAC;AAE1E,OAAO,KAAK,EACV,mBAAmB,EACnB,sBAAsB,EACtB,YAAY,EACZ,eAAe,EACf,aAAa,EACd,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;;GAKG;AACH,qBAAa,WAAW;IAIV,OAAO,CAAC,SAAS;IAH7B,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,YAAY,CAAwC;gBAExC,SAAS,EAAE,aAAa;IAK5C;;;;;OAKG;IACG,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC;IAI1E;;;;;OAKG;IACG,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAInF;;;;;OAKG;IACG,kBAAkB,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC;IAInF;;;;;;OAMG;IACG,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAInE;;;;;;OAMG;IACG,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAI/F;;;;;OAKG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAIlE;;;;;;;OAOG;IACG,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,GAAG,IAAI,GACrB,OAAO,CAAC,MAAM,CAAC;IASlB;;;;OAIG;IACH,UAAU,IAAI,OAAO;CAGtB"}

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@explorins/pers-sdk",
-  "version": "1.6.0",
+  "version": "1.6.2",
   "description": "Platform-agnostic SDK for PERS (Phygital Experience Rewards System) - Core business logic and API integration",
   "type": "module",
   "main": "./dist/index.cjs",

package/dist/pers-sdk.d.ts

@@ -157,7 +157,7 @@
 import { HttpClient } from './core/abstractions/http-client';
 import { PersConfig } from './core/pers-config';
 import { PersApiClient } from './core/pers-api-client';
-import { AuthManager, UserManager, TokenManager, BusinessManager, CampaignManager, RedemptionManager, TransactionManager, PurchaseManager, TenantManager, AnalyticsManager, DonationManager } from './managers';
+import { AuthManager, UserManager, UserStatusManager, TokenManager, BusinessManager, CampaignManager, RedemptionManager, TransactionManager, PurchaseManager, FileManager, TenantManager, AnalyticsManager, DonationManager, Web3Manager } from './managers';
 /**
  * PERS SDK class with domain managers
  *
@@ -193,15 +193,18 @@ export declare class PersSDK {
     private apiClient;
     private _auth;
     private _users;
+    private _userStatus;
     private _tokens;
     private _businesses;
     private _campaigns;
     private _redemptions;
     private _transactions;
     private _purchases;
+    private _files;
     private _tenants;
     private _analytics;
     private _donations;
+    private _web3;
     /**
      * Creates a new PERS SDK instance
      *
@@ -231,6 +234,17 @@ export declare class PersSDK {
      * ```
      */
     get users(): UserManager;
+    /**
+     * User Status manager - High-level user status operations
+     *
+     * @example
+     * ```typescript
+     * const statusTypes = await sdk.userStatus.getUserStatusTypes();
+     * const earnedStatus = await sdk.userStatus.getEarnedUserStatus();
+     * await sdk.userStatus.createUserStatusType(statusData);
+     * ```
+     */
+    get userStatus(): UserStatusManager;
     /**
      * Token manager - High-level token operations
      *
@@ -297,6 +311,17 @@ export declare class PersSDK {
      * ```
      */
     get purchases(): PurchaseManager;
+    /**
+     * File manager - High-level file operations
+     *
+     * @example
+     * ```typescript
+     * const uploadUrl = await sdk.files.getSignedPutUrl('entity-123', 'token', 'jpg');
+     * const accessUrl = await sdk.files.getSignedGetUrl('entity-123', 'token');
+     * const optimizedUrl = await sdk.files.optimizeMedia(originalUrl, 800, 600);
+     * ```
+     */
+    get files(): FileManager;
     /**
      * Tenant manager - High-level tenant operations
      *
@@ -326,6 +351,17 @@ export declare class PersSDK {
      * ```
      */
     get donations(): DonationManager;
+    /**
+     * Web3 manager - High-level blockchain operations
+     *
+     * @example
+     * ```typescript
+     * const balance = await sdk.web3.getTokenBalance(request);
+     * const metadata = await sdk.web3.getTokenMetadata(request);
+     * const collection = await sdk.web3.getTokenCollection(request);
+     * ```
+     */
+    get web3(): Web3Manager;
     /**
      * Gets the API client for direct PERS API requests
      *