@explorins/pers-sdk 1.6.4 → 1.6.9

package/dist/core/pers-api-client.d.ts

@@ -1,33 +1,22 @@
 /**
- * PERS API Client - Core platform-agnostic client for PERS backend
+ * PERS API Client - Platform-agnostic HTTP client with authentication
  *
- * Provides authenticated HTTP client with automatic token management,
- * proactive refresh, and comprehensive error handling.
- *
- * Features:
- * - Automatic token refresh before expiry
- * - Background refresh for optimal performance
- * - Provider token fallback for seamless authentication
- * - Configurable retry and timeout settings
- * - Platform-agnostic design
+ * Features: automatic token refresh, background validation, configurable settings
  *
  * @example
  * ```typescript
  * const client = new PersApiClient(httpClient, {
  *   environment: 'production',
  *   apiProjectKey: 'your-project-key',
- *   authProvider: createAuthProvider({
- *     tokenProvider: () => getFirebaseToken()
- *   })
+ *   authProvider: new DefaultAuthProvider()
  * });
  *
- * // Make authenticated requests
  * const data = await client.get('/users/me');
  * ```
  */
 import { HttpClient } from './abstractions/http-client';
 import { PersConfig, mergeWithDefaults } from './pers-config';
-import { SessionAuthResponseDTO, SessionAuthContextResponseDTO } from '../shared/interfaces/pers-shared-lib.interfaces';
+import { AuthService } from './auth/services/auth-service';
 export declare class PersApiClient {
     private httpClient;
     private config;
@@ -35,6 +24,7 @@ export declare class PersApiClient {
     private readonly mergedConfig;
     private readonly authApi;
     private readonly authService;
+    private readonly refreshManager;
     /**
      * Creates a new PERS API Client instance
      *
@@ -45,26 +35,19 @@ export declare class PersApiClient {
     /**
      * Ensures valid authentication token before making requests
      *
-     * Implements intelligent refresh strategy:
-     * - Tokens with sufficient time remaining: Background refresh (non-blocking)
-     * - Tokens expiring soon or expired: Immediate refresh (blocking)
+     * Delegates to TokenRefreshManager for centralized token logic.
+     * Called without await for optimal performance - requests proceed immediately
+     * while token validation/refresh happens in background.
      *
      * @private
      * @returns Promise that resolves when token validation is complete
      */
     private ensureValidToken;
-    /**
-     * Get request headers including auth token and project key
-     */
-    private getHeaders;
+    private attemptInternalRefresh;
     /**
      * Make a request with proper headers, auth, and error handling
      */
     private request;
-    /**
-     * Delegate token refresh to auth provider and handle the results
-     */
-    private handleTokenRefreshDelegation;
     /**
      * Performs an authenticated GET request
      *
@@ -82,18 +65,6 @@ export declare class PersApiClient {
     get<T>(endpoint: string, responseType?: 'json' | 'blob' | 'text' | 'arraybuffer'): Promise<T>;
     /**
      * Performs an authenticated POST request
-     *
-     * @template T - Expected response type
-     * @param endpoint - API endpoint path (without base URL)
-     * @param body - Request payload data
-     * @param options - Request options including auth bypass
-     * @returns Promise resolving to typed response data
-     *
-     * @example
-     * ```typescript
-     * const user = await client.post<User>('/users', userData);
-     * const publicData = await client.post('/public/contact', formData, { bypassAuth: true });
-     * ```
      */
     post<T>(endpoint: string, body?: unknown, options?: {
         bypassAuth?: boolean;
@@ -107,128 +78,15 @@ export declare class PersApiClient {
      */
     delete<T>(endpoint: string): Promise<T>;
     /**
-   * Get request headers WITHOUT auth token (for auth operations like refresh/login)
-   */
-    private getHeadersWithoutAuth;
-    /**
-     * Authenticates an admin user using external JWT token
-     *
-     * Exchanges external provider token (Firebase, Auth0, etc.) for PERS access tokens.
-     * Automatically stores received tokens for subsequent requests.
+     * Get request headers with optional auth token and project key
      *
-     * @param externalJwt - JWT token from external authentication provider
-     * @returns Promise resolving to session context with admin permissions
-     *
-     * @example
-     * ```typescript
-     * const firebaseToken = await getIdToken();
-     * const session = await client.loginAdmin(firebaseToken);
-     * console.log('Admin authenticated:', session.user.email);
-     * ```
+     * @param includeAuth - Whether to include the Authorization header (default: true)
      */
-    loginAdmin(externalJwt: string): Promise<SessionAuthContextResponseDTO>;
-    /**
-     * Authenticates a regular user using external JWT token
-     *
-     * Exchanges external provider token for PERS access tokens with user-level permissions.
-     * Automatically stores received tokens for subsequent requests.
-     *
-     * @param externalJwt - JWT token from external authentication provider
-     * @returns Promise resolving to session context with user permissions
-     *
-     * @example
-     * ```typescript
-     * const firebaseToken = await getIdToken();
-     * const session = await client.loginUser(firebaseToken);
-     * console.log('User authenticated:', session.user.email);
-     * ```
-     */
-    loginUser(externalJwt: string): Promise<SessionAuthContextResponseDTO>;
-    /**
-     * Authenticates a user using raw login data (no external JWT)
-     *
-     * Useful for custom authentication flows where user data is provided directly.
-     * Automatically stores received tokens for subsequent requests.
-     *
-     * @param rawLoginData - Object containing user login data (email, name, etc.)
-     * @return Promise resolving to session context with user permissions
-     */
-    loginUserWithRawData(rawLoginData: {
-        externalId?: string | undefined;
-        email?: string | undefined;
-        firstName?: string | undefined;
-        lastName?: string | undefined;
-        customData?: Record<string, any> | undefined;
-    }): Promise<SessionAuthContextResponseDTO>;
-    /**
-     * Checks if current user has a valid authentication token
-     *
-     * Performs basic token availability check without network requests.
-     * For comprehensive validation including expiry, use isTokenExpired().
-     *
-     * @returns True if valid token exists, false otherwise
-     *
-     * @example
-     * ```typescript
-     * if (client.hasValidAuth()) {
-     *   // User is authenticated, proceed with API calls
-     *   const data = await client.get('/protected-data');
-     * } else {
-     *   // Redirect to login
-     *   redirectToLogin();
-     * }
-     * ```
-     */
-    hasValidAuth(): boolean;
-    /**
-     * Checks if current access token is expired or expiring soon
-     *
-     * @param marginSeconds - Seconds before expiry to consider token as expired (default: 60)
-     * @returns Promise resolving to true if token is expired/expiring, false if valid
-     *
-     * @example
-     * ```typescript
-     * if (await client.isTokenExpired(120)) {
-     *   console.log('Token expires within 2 minutes');
-     *   // Optionally trigger manual refresh
-     * }
-     * ```
-     */
-    isTokenExpired(marginSeconds?: number): Promise<boolean>;
-    /**
-     * Checks if both access and refresh tokens are expired
-     *
-     * Useful for determining if full re-authentication is required.
-     *
-     * @param marginSeconds - Seconds before expiry to consider tokens as expired (default: 60)
-     * @returns Promise resolving to true if both tokens expired, false otherwise
-     *
-     * @example
-     * ```typescript
-     * if (await client.areAllTokensExpired()) {
-     *   // Full re-authentication required
-     *   await redirectToLogin();
-     * }
-     * ```
-     */
-    areAllTokensExpired(marginSeconds?: number): Promise<boolean>;
+    private getHeaders;
     /**
-     * Refresh access token using stored refresh token
-     *
-     * @param refreshToken - Optional refresh token, uses stored token if not provided
-     * @returns Promise resolving to new auth tokens
-     *
-     * @example
-     * ```typescript
-     * try {
-     *   const tokens = await client.refreshTokens();
-     *   console.log('Tokens refreshed successfully');
-     * } catch (error) {
-     *   console.error('Token refresh failed:', error);
-     * }
-     * ```
+     * @internal - For AuthManager use only
      */
-    refreshTokens(refreshToken?: string): Promise<SessionAuthResponseDTO>;
+    getAuthService(): AuthService;
     /**
      * Get current configuration (returns merged config)
      */

package/dist/core/pers-api-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pers-api-client.d.ts","sourceRoot":"","sources":["../../src/core/pers-api-client.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,UAAU,EAAkB,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,UAAU,EAAgB,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAG5E,OAAO,EAAE,sBAAsB,EAAE,6BAA6B,EAAoB,MAAM,iDAAiD,CAAC;AAW1I,qBAAa,aAAa;IAatB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,MAAM;IAbhB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuC;IACpE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAE1C;;;;;OAKG;gBAEO,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,UAAU;IAsB5B;;;;;;;;;OASG;YACW,gBAAgB;IAkB9B;;OAEG;YACW,UAAU;IA2BxB;;OAEG;YACW,OAAO;IAqFrB;;OAEG;YACW,4BAA4B;IA8B1C;;;;;;;;;;;;;OAaG;IACG,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC;IAInG;;;;;;;;;;;;;;OAcG;IACG,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC;IAI/F;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAI1D;;OAEG;IACG,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAI7C;;KAEC;YACW,qBAAqB;IAsBjC;;;;;;;;;;;;;;;OAeG;IACG,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAI7E;;;;;;;;;;;;;;;OAeG;IACG,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAI5E;;;;;;;;OAQG;IACG,oBAAoB,CAAC,YAAY,EAAE;QACvC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAChC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC3B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC9B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CAAC;KAC9C,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAK1C;;;;;;;;;;;;;;;;;;OAkBG;IACH,YAAY,IAAI,OAAO;IAIvB;;;;;;;;;;;;;OAaG;IACG,cAAc,CAAC,aAAa,GAAE,MAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAYlE;;;;;;;;;;;;;;;OAeG;IACG,mBAAmB,CAAC,aAAa,GAAE,MAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IASvE;;;;;;;;;;;;;;;OAeG;IACG,aAAa,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAI3E;;OAEG;IACH,SAAS,IAAI,UAAU,CAAC,OAAO,iBAAiB,CAAC;IAIjD;;OAEG;IACH,iBAAiB,IAAI,UAAU;CAGhC"}
+{"version":3,"file":"pers-api-client.d.ts","sourceRoot":"","sources":["../../src/core/pers-api-client.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,UAAU,EAAkB,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,UAAU,EAAgB,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE5E,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAY3D,qBAAa,aAAa;IActB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,MAAM;IAdhB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuC;IACpE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsB;IAErD;;;;;OAKG;gBAEO,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,UAAU;IA6B5B;;;;;;;;;OASG;YACW,gBAAgB;YAKhB,sBAAsB;IAIpC;;OAEG;YACW,OAAO;IA8FrB;;;;;;;;;;;;;OAaG;IACG,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC;IAInG;;OAEG;IACG,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC;IAI/F;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAI1D;;OAEG;IACG,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAI7C;;;;OAIG;YACW,UAAU;IAqCxB;;OAEG;IACH,cAAc,IAAI,WAAW;IAI7B;;OAEG;IACH,SAAS,IAAI,UAAU,CAAC,OAAO,iBAAiB,CAAC;IAIjD;;OAEG;IACH,iBAAiB,IAAI,UAAU;CAGhC"}

package/dist/core/pers-config.d.ts

@@ -4,11 +4,8 @@
  * Provides type-safe configuration options for the PERS SDK
  * with sensible defaults for production environments.
  */
-import { PersAuthProvider } from './auth/auth-provider.interface';
-/** PERS API environment targets */
-export type PersEnvironment = 'development' | 'staging' | 'production';
-/** Supported PERS API versions */
-export type PersApiVersion = 'v1' | 'v1.8' | 'v1.9' | 'v2';
+import { PersAuthProvider, AuthType } from './auth/auth-provider.interface';
+import type { TokenStorage } from './auth/token-storage';
 /**
  * PERS SDK Configuration
  *
@@ -18,7 +15,7 @@ export type PersApiVersion = 'v1' | 'v1.8' | 'v1.9' | 'v2';
  *   environment: 'production',
  *   apiProjectKey: 'your-project-key',
  *   apiVersion: 'v2',
- *   authProvider: createAuthProvider({
+ *   authProvider: new DefaultAuthProvider({
  *     tokenProvider: () => getFirebaseToken()
  *   }),
  *   tokenRefreshMargin: 120,
@@ -28,16 +25,20 @@ export type PersApiVersion = 'v1' | 'v1.8' | 'v1.9' | 'v2';
  */
 export interface PersConfig {
     /** Target environment (default: 'production') */
-    environment?: PersEnvironment;
+    environment?: 'development' | 'staging' | 'production';
     /** Project key for API authentication */
     apiProjectKey?: string;
     /** API version to use (default: 'v2') */
-    apiVersion?: PersApiVersion;
+    apiVersion?: 'v2';
     /** Request timeout in milliseconds (default: 30000) */
     timeout?: number;
     /** Number of retry attempts (default: 3) */
     retries?: number;
-    /** Authentication provider instance */
+    /** Authentication type for auto-created provider (default: 'user') */
+    authType?: AuthType;
+    /** Custom token storage for auto-created provider */
+    authStorage?: TokenStorage;
+    /** Authentication provider instance (overrides authType if provided) */
     authProvider?: PersAuthProvider;
     /** Seconds before expiry to refresh token proactively (default: 60) */
     tokenRefreshMargin?: number;
@@ -54,8 +55,8 @@ export interface PersAuthConfig {
  * Default configuration values
  */
 export declare const DEFAULT_PERS_CONFIG: {
-    readonly environment: PersEnvironment;
-    readonly apiVersion: PersApiVersion;
+    readonly environment: "production";
+    readonly apiVersion: "v2";
     readonly timeout: 30000;
     readonly retries: 3;
     readonly tokenRefreshMargin: 60;
@@ -65,7 +66,7 @@ export declare const DEFAULT_PERS_CONFIG: {
  * Internal function to construct API root from environment
  * Now defaults to production and v2
  */
-export declare function buildApiRoot(environment?: PersEnvironment, version?: PersApiVersion): string;
+export declare function buildApiRoot(environment?: 'development' | 'staging' | 'production', version?: 'v2'): string;
 /**
  * Merge user config with defaults
  */

package/dist/core/pers-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pers-config.d.ts","sourceRoot":"","sources":["../../src/core/pers-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE,mCAAmC;AACnC,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,SAAS,GAAG,YAAY,CAAC;AAEvE,kCAAkC;AAClC,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;AAE3D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,UAAU;IACzB,iDAAiD;IACjD,WAAW,CAAC,EAAE,eAAe,CAAC;IAE9B,yCAAyC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,yCAAyC;IACzC,UAAU,CAAC,EAAE,cAAc,CAAC;IAE5B,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,uCAAuC;IACvC,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAEhC,uEAAuE;IACvE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,yEAAyE;IACzE,0BAA0B,CAAC,EAAE,MAAM,CAAC;IAEpC,wDAAwD;IACxD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,GAAG,KAAK,GAAG,MAAM,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC9C;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB;0BACD,eAAe;yBACxB,cAAc;;;;;CAK1B,CAAC;AAEX;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,WAAW,GAAE,eAA8B,EAC3C,OAAO,GAAE,cAAqB,GAC7B,MAAM,CAQR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,GAAG,YAAY,GAAG,SAAS,GAAG,SAAS,CAAC,CAAC,CASnJ"}
+{"version":3,"file":"pers-config.d.ts","sourceRoot":"","sources":["../../src/core/pers-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAQzD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,UAAU;IACzB,iDAAiD;IACjD,WAAW,CAAC,EAAE,aAAa,GAAG,SAAS,GAAG,YAAY,CAAC;IAEvD,yCAAyC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,yCAAyC;IACzC,UAAU,CAAC,EAAE,IAAI,CAAC;IAElB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB,qDAAqD;IACrD,WAAW,CAAC,EAAE,YAAY,CAAC;IAE3B,wEAAwE;IACxE,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAEhC,uEAAuE;IACvE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,yEAAyE;IACzE,0BAA0B,CAAC,EAAE,MAAM,CAAC;IAEpC,wDAAwD;IACxD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,GAAG,KAAK,GAAG,MAAM,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC9C;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;CAOtB,CAAC;AAEX;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,WAAW,GAAE,aAAa,GAAG,SAAS,GAAG,YAA2B,EACpE,OAAO,GAAE,IAAW,GACnB,MAAM,CAQR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,GAAG,YAAY,GAAG,SAAS,GAAG,SAAS,CAAC,CAAC,CASnJ"}

package/dist/core/utils/jwt.function.d.ts

@@ -1,2 +1,11 @@
+/**
+ * JWT token expiration utilities
+ * Native implementation without external dependencies for optimal performance
+ */
+/**
+ * Check if JWT token is expired or expiring within margin
+ * @param token JWT token (with or without Bearer prefix)
+ * @param margin Safety margin in seconds before expiry (default: 60)
+ */
 export declare const isTokenExpired: (token: string, margin?: number) => boolean;
 //# sourceMappingURL=jwt.function.d.ts.map

package/dist/core/utils/jwt.function.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jwt.function.d.ts","sourceRoot":"","sources":["../../../src/core/utils/jwt.function.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,EAAE,SAAQ,MAAW,KAAG,OAmBnE,CAAC"}
+{"version":3,"file":"jwt.function.d.ts","sourceRoot":"","sources":["../../../src/core/utils/jwt.function.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AACH,eAAO,MAAM,cAAc,UAAW,MAAM,WAAU,MAAM,KAAQ,OAgBnE,CAAC"}

package/dist/core.cjs

@@ -1,32 +1,37 @@
 'use strict';
 
-var persSdk = require('./chunks/pers-sdk-DbPwFKrf.cjs');
-var web3 = require('./chunks/index-CzEluQmf.cjs');
+var persSdk = require('./chunks/pers-sdk-CmyPEhy7.cjs');
 require('@explorins/pers-shared');
-require('./user.cjs');
+require('./chunks/web3-chain-service-D75TcHkh.cjs');
+require('@explorins/web3-ts/ethers');
+require('./chunks/user-service-D1Rn4U8u.cjs');
 require('./user-status.cjs');
-require('./chunks/token-sdk-CiAbOb6c.cjs');
-require('./business.cjs');
-require('./campaign.cjs');
-require('./redemption.cjs');
+require('./chunks/token-service-BWScn8Qa.cjs');
+require('./chunks/business-service-Cq3-oksM.cjs');
+require('./chunks/campaign-service-CWK9I388.cjs');
+require('./chunks/redemption-service-7qbeQxEM.cjs');
 require('./transaction.cjs');
-require('./payment.cjs');
-require('./tenant.cjs');
-require('./analytics.cjs');
-require('./donation.cjs');
-require('./chunks/index-BfOoX87y.cjs');
-require('jwt-decode');
-require('@explorins/web3-ts/ethers');
+require('./chunks/payment-service-B4qx0qiE.cjs');
+require('./chunks/tenant-service-Ba7xrWED.cjs');
+require('./chunks/analytics-service-CitlimKJ.cjs');
+require('./chunks/donation-service-D-xFrONi.cjs');
+require('./chunks/explorer.utils-GpskbLl1.cjs');
 
 
 
 exports.AnalyticsManager = persSdk.AnalyticsManager;
+exports.AuthApi = persSdk.AuthApi;
 exports.AuthManager = persSdk.AuthManager;
+exports.AuthService = persSdk.AuthService;
+exports.AuthTokenManager = persSdk.AuthTokenManager;
 exports.BusinessManager = persSdk.BusinessManager;
 exports.CampaignManager = persSdk.CampaignManager;
 exports.DEFAULT_PERS_CONFIG = persSdk.DEFAULT_PERS_CONFIG;
+exports.DefaultAuthProvider = persSdk.DefaultAuthProvider;
 exports.DonationManager = persSdk.DonationManager;
 exports.FileManager = persSdk.FileManager;
+exports.LocalStorageTokenStorage = persSdk.LocalStorageTokenStorage;
+exports.MemoryTokenStorage = persSdk.MemoryTokenStorage;
 exports.PersApiClient = persSdk.PersApiClient;
 exports.PersSDK = persSdk.PersSDK;
 exports.PurchaseManager = persSdk.PurchaseManager;
@@ -38,10 +43,9 @@ exports.UserManager = persSdk.UserManager;
 exports.UserStatusManager = persSdk.UserStatusManager;
 exports.Web3Manager = persSdk.Web3Manager;
 exports.buildApiRoot = persSdk.buildApiRoot;
-exports.createAuthProvider = persSdk.createAuthProvider;
 exports.createPersSDK = persSdk.createPersSDK;
+exports.detectEnvironment = persSdk.detectEnvironment;
+exports.environment = persSdk.environment;
 exports.mergeWithDefaults = persSdk.mergeWithDefaults;
-exports.detectEnvironment = web3.detectEnvironment;
-exports.environment = web3.environment;
-exports.warnIfProblematicEnvironment = web3.warnIfProblematicEnvironment;
+exports.warnIfProblematicEnvironment = persSdk.warnIfProblematicEnvironment;
 //# sourceMappingURL=core.cjs.map

package/dist/core.cjs.map

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

package/dist/core.js

@@ -1,18 +1,17 @@
-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-Z6MKeFBX.js';
-export { d as detectEnvironment, e as environment, w as warnIfProblematicEnvironment } from './chunks/index-CJ9Jfa4A.js';
+export { o as AnalyticsManager, g as AuthApi, i as AuthManager, h as AuthService, A as AuthTokenManager, B as BusinessManager, C as CampaignManager, b as DEFAULT_PERS_CONFIG, D as DefaultAuthProvider, p as DonationManager, F as FileManager, L as LocalStorageTokenStorage, M as MemoryTokenStorage, a as PersApiClient, P as PersSDK, l as PurchaseManager, R as RedemptionManager, n as TenantManager, T as TokenManager, k as TransactionManager, U as UserManager, j as UserStatusManager, W as Web3Manager, d as buildApiRoot, c as createPersSDK, e as detectEnvironment, f as environment, m as mergeWithDefaults, w as warnIfProblematicEnvironment } from './chunks/pers-sdk-Bd6BZHgt.js';
 import '@explorins/pers-shared';
-import './user.js';
+import './chunks/web3-chain-service-Dp5Z8p9I.js';
+import '@explorins/web3-ts/ethers';
+import './chunks/user-service-D6mTa_WZ.js';
 import './user-status.js';
-import './chunks/token-sdk-BW4kkJb3.js';
-import './business.js';
-import './campaign.js';
-import './redemption.js';
+import './chunks/token-service-CpVwC5Eb.js';
+import './chunks/business-service-DrC-TNGa.js';
+import './chunks/campaign-service-Dd7gMjC9.js';
+import './chunks/redemption-service-BT0J5Iy7.js';
 import './transaction.js';
-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';
+import './chunks/payment-service-DfCBFosx.js';
+import './chunks/tenant-service-DELk412y.js';
+import './chunks/analytics-service-CxyrOwel.js';
+import './chunks/donation-service-CyJS4DIZ.js';
+import './chunks/explorer.utils-Ckll15ja.js';
 //# 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/donation/index.d.ts

@@ -7,19 +7,4 @@
 export { DonationApi } from './api/donation-api';
 export { DonationService } from './services/donation-service';
 export * from '../shared/interfaces/pers-shared-lib.interfaces';
-import { PersApiClient } from '../core/pers-api-client';
-import { DonationApi } from './api/donation-api';
-import { DonationService } from './services/donation-service';
-/**
- * Create a complete Donation SDK instance
- *
- * @param apiClient - Configured PERS API client
- * @returns Donation SDK with flattened structure for better DX
- */
-export declare function createDonationSDK(apiClient: PersApiClient): {
-    getAllDonationTypes: () => Promise<import("@explorins/pers-shared").DonationTypeDTO[]>;
-    api: DonationApi;
-    service: DonationService;
-};
-export type DonationSDK = ReturnType<typeof createDonationSDK>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/donation/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAG9D,cAAc,iDAAiD,CAAC;AAKhE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,aAAa;;;;EAezD;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/donation/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAG9D,cAAc,iDAAiD,CAAC"}

package/dist/donation.cjs

@@ -1,84 +1,14 @@
 'use strict';
 
+var donationService = require('./chunks/donation-service-D-xFrONi.cjs');
 var persShared = require('@explorins/pers-shared');
 
-/**
- * Platform-Agnostic Donation API Client
- *
- * Handles donation operations using the PERS backend.
- * Matches framework DonationApiService methods exactly.
- */
-class DonationApi {
-    constructor(apiClient) {
-        this.apiClient = apiClient;
-    }
-    // ==========================================
-    // PUBLIC OPERATIONS
-    // ==========================================
-    /**
-     * PUBLIC: Get all donation types
-     * ✅ ONLY method actually used by framework
-     */
-    async getAllDonationTypes() {
-        return this.apiClient.get('/purchases/donation-types');
-    }
-}
 
-/**
- * Platform-Agnostic Donation Service
- *
- * Contains donation business logic and operations that work across platforms.
- * No framework dependencies - pure TypeScript business logic.
- * Matches framework DonationApiService capabilities exactly.
- */
-class DonationService {
-    constructor(donationApi) {
-        this.donationApi = donationApi;
-    }
-    // ==========================================
-    // PUBLIC OPERATIONS
-    // ==========================================
-    /**
-     * PUBLIC: Get all donation types
-     * ✅ ONLY method actually used by framework
-     */
-    async getAllDonationTypes() {
-        return this.donationApi.getAllDonationTypes();
-    }
-}
-
-/**
- * @explorins/pers-sdk-donation
- *
- * Platform-agnostic Donation Domain SDK for PERS ecosystem
- * Handles donation type retrieval for purchase flow integration
- */
-// API Layer
-/**
- * Create a complete Donation SDK instance
- *
- * @param apiClient - Configured PERS API client
- * @returns Donation SDK with flattened structure for better DX
- */
-function createDonationSDK(apiClient) {
-    const donationApi = new DonationApi(apiClient);
-    const donationService = new DonationService(donationApi);
-    return {
-        // Direct access to service methods (primary interface)
-        // ✅ FRAMEWORK ALIGNED: Only method actually used by framework
-        // Public methods
-        getAllDonationTypes: () => donationService.getAllDonationTypes(),
-        // Advanced access for edge cases
-        api: donationApi,
-        service: donationService
-    };
-}
 
+exports.DonationApi = donationService.DonationApi;
+exports.DonationService = donationService.DonationService;
 Object.defineProperty(exports, "AccountOwnerType", {
-    enumerable: true,
-    get: function () { return persShared.AccountOwnerType; }
+	enumerable: true,
+	get: function () { return persShared.AccountOwnerType; }
 });
-exports.DonationApi = DonationApi;
-exports.DonationService = DonationService;
-exports.createDonationSDK = createDonationSDK;
 //# sourceMappingURL=donation.cjs.map

package/dist/donation.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"donation.cjs","sources":["../src/donation/api/donation-api.ts","../src/donation/services/donation-service.ts","../src/donation/index.ts"],"sourcesContent":[null,null,null],"names":[],"mappings":";;;;AAGA;;;;;AAKG;MACU,WAAW,CAAA;AACtB,IAAA,WAAA,CAAoB,SAAwB,EAAA;QAAxB,IAAA,CAAA,SAAS,GAAT,SAAS;IAAkB;;;;AAM/C;;;AAGG;AACH,IAAA,MAAM,mBAAmB,GAAA;QACvB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAoB,2BAA2B,CAAC;IAC3E;AACD;;ACpBD;;;;;;AAMG;MACU,eAAe,CAAA;AAC1B,IAAA,WAAA,CAAoB,WAAwB,EAAA;QAAxB,IAAA,CAAA,WAAW,GAAX,WAAW;IAAgB;;;;AAM/C;;;AAGG;AACH,IAAA,MAAM,mBAAmB,GAAA;AACvB,QAAA,OAAO,IAAI,CAAC,WAAW,CAAC,mBAAmB,EAAE;IAC/C;AACD;;ACxBD;;;;;AAKG;AAEH;AAgBA;;;;;AAKG;AACG,SAAU,iBAAiB,CAAC,SAAwB,EAAA;AACxD,IAAA,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,SAAS,CAAC;AAC9C,IAAA,MAAM,eAAe,GAAG,IAAI,eAAe,CAAC,WAAW,CAAC;IAExD,OAAO;;;;AAKL,QAAA,mBAAmB,EAAE,MAAM,eAAe,CAAC,mBAAmB,EAAE;;AAGhE,QAAA,GAAG,EAAE,WAAW;AAChB,QAAA,OAAO,EAAE;KACV;AACH;;;;;;;;;;"}
+{"version":3,"file":"donation.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;"}

package/dist/donation.js

@@ -1,76 +1,3 @@
+export { D as DonationApi, a as DonationService } from './chunks/donation-service-CyJS4DIZ.js';
 export { AccountOwnerType } from '@explorins/pers-shared';
-
-/**
- * Platform-Agnostic Donation API Client
- *
- * Handles donation operations using the PERS backend.
- * Matches framework DonationApiService methods exactly.
- */
-class DonationApi {
-    constructor(apiClient) {
-        this.apiClient = apiClient;
-    }
-    // ==========================================
-    // PUBLIC OPERATIONS
-    // ==========================================
-    /**
-     * PUBLIC: Get all donation types
-     * ✅ ONLY method actually used by framework
-     */
-    async getAllDonationTypes() {
-        return this.apiClient.get('/purchases/donation-types');
-    }
-}
-
-/**
- * Platform-Agnostic Donation Service
- *
- * Contains donation business logic and operations that work across platforms.
- * No framework dependencies - pure TypeScript business logic.
- * Matches framework DonationApiService capabilities exactly.
- */
-class DonationService {
-    constructor(donationApi) {
-        this.donationApi = donationApi;
-    }
-    // ==========================================
-    // PUBLIC OPERATIONS
-    // ==========================================
-    /**
-     * PUBLIC: Get all donation types
-     * ✅ ONLY method actually used by framework
-     */
-    async getAllDonationTypes() {
-        return this.donationApi.getAllDonationTypes();
-    }
-}
-
-/**
- * @explorins/pers-sdk-donation
- *
- * Platform-agnostic Donation Domain SDK for PERS ecosystem
- * Handles donation type retrieval for purchase flow integration
- */
-// API Layer
-/**
- * Create a complete Donation SDK instance
- *
- * @param apiClient - Configured PERS API client
- * @returns Donation SDK with flattened structure for better DX
- */
-function createDonationSDK(apiClient) {
-    const donationApi = new DonationApi(apiClient);
-    const donationService = new DonationService(donationApi);
-    return {
-        // Direct access to service methods (primary interface)
-        // ✅ FRAMEWORK ALIGNED: Only method actually used by framework
-        // Public methods
-        getAllDonationTypes: () => donationService.getAllDonationTypes(),
-        // Advanced access for edge cases
-        api: donationApi,
-        service: donationService
-    };
-}
-
-export { DonationApi, DonationService, createDonationSDK };
 //# sourceMappingURL=donation.js.map

package/dist/donation.js.map

@@ -1 +1 @@
-{"version":3,"file":"donation.js","sources":["../src/donation/api/donation-api.ts","../src/donation/services/donation-service.ts","../src/donation/index.ts"],"sourcesContent":[null,null,null],"names":[],"mappings":";;AAGA;;;;;AAKG;MACU,WAAW,CAAA;AACtB,IAAA,WAAA,CAAoB,SAAwB,EAAA;QAAxB,IAAA,CAAA,SAAS,GAAT,SAAS;IAAkB;;;;AAM/C;;;AAGG;AACH,IAAA,MAAM,mBAAmB,GAAA;QACvB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAoB,2BAA2B,CAAC;IAC3E;AACD;;ACpBD;;;;;;AAMG;MACU,eAAe,CAAA;AAC1B,IAAA,WAAA,CAAoB,WAAwB,EAAA;QAAxB,IAAA,CAAA,WAAW,GAAX,WAAW;IAAgB;;;;AAM/C;;;AAGG;AACH,IAAA,MAAM,mBAAmB,GAAA;AACvB,QAAA,OAAO,IAAI,CAAC,WAAW,CAAC,mBAAmB,EAAE;IAC/C;AACD;;ACxBD;;;;;AAKG;AAEH;AAgBA;;;;;AAKG;AACG,SAAU,iBAAiB,CAAC,SAAwB,EAAA;AACxD,IAAA,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,SAAS,CAAC;AAC9C,IAAA,MAAM,eAAe,GAAG,IAAI,eAAe,CAAC,WAAW,CAAC;IAExD,OAAO;;;;AAKL,QAAA,mBAAmB,EAAE,MAAM,eAAe,CAAC,mBAAmB,EAAE;;AAGhE,QAAA,GAAG,EAAE,WAAW;AAChB,QAAA,OAAO,EAAE;KACV;AACH;;;;"}
+{"version":3,"file":"donation.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}