@explorins/pers-sdk 1.1.2 → 1.2.0

package/dist/core.js

@@ -0,0 +1,497 @@
+/**
+ * PERS SDK Configuration interfaces
+ */
+/**
+ * Default configuration values
+ */
+const DEFAULT_PERS_CONFIG = {
+    environment: 'production',
+    apiVersion: 'v2',
+    timeout: 30000,
+    retries: 3
+};
+/**
+ * Internal function to construct API root from environment
+ * Now defaults to production and v2
+ */
+function buildApiRoot(environment = 'production', version = 'v2') {
+    const baseUrls = {
+        development: 'https://explorins-loyalty.ngrok.io',
+        staging: `https://dev.api.pers.ninja/${version}`,
+        production: `https://api.pers.ninja/${version}`
+    };
+    return `${baseUrls[environment]}`;
+}
+/**
+ * Merge user config with defaults
+ */
+function mergeWithDefaults(config) {
+    return {
+        ...DEFAULT_PERS_CONFIG,
+        ...config,
+        environment: config.environment ?? DEFAULT_PERS_CONFIG.environment,
+        apiVersion: config.apiVersion ?? DEFAULT_PERS_CONFIG.apiVersion,
+        timeout: config.timeout ?? DEFAULT_PERS_CONFIG.timeout,
+        retries: config.retries ?? DEFAULT_PERS_CONFIG.retries
+    };
+}
+
+// packages/pers-sdk/src/core/pers-api-client.ts
+/**
+ * PERS API Client - Core platform-agnostic client for PERS backend
+ */
+class PersApiClient {
+    constructor(httpClient, config) {
+        this.httpClient = httpClient;
+        this.config = config;
+        // Merge user config with defaults (production + v2)
+        this.mergedConfig = mergeWithDefaults(config);
+        // Build API root from merged environment and version
+        this.apiRoot = buildApiRoot(this.mergedConfig.environment, this.mergedConfig.apiVersion);
+    }
+    /**
+     * Get request headers including auth token and project key
+     */
+    async getHeaders() {
+        const headers = {
+            'Content-Type': 'application/json',
+        };
+        // Add authentication token
+        if (this.mergedConfig.authProvider) {
+            const token = await this.mergedConfig.authProvider.getToken();
+            if (token) {
+                headers['Authorization'] = `Bearer ${token}`;
+            }
+        }
+        // Add project key
+        if (this.mergedConfig.authProvider) {
+            const projectKey = await this.mergedConfig.authProvider.getProjectKey();
+            if (projectKey) {
+                headers['x-project-key'] = projectKey;
+            }
+        }
+        else if (this.mergedConfig.apiProjectKey) {
+            // Fallback to config project key if no auth provider
+            headers['x-project-key'] = this.mergedConfig.apiProjectKey;
+        }
+        return headers;
+    }
+    /**
+     * Make a request with proper headers, auth, and error handling
+     */
+    async request(method, endpoint, body, options) {
+        const { retryCount = 0, responseType = 'json' } = options || {};
+        const url = `${this.apiRoot}${endpoint}`;
+        // ✅ DEBUGGING: Add extensive logging for CSV endpoint
+        const isCSVEndpoint = endpoint.includes('/export/csv');
+        const requestOptions = {
+            headers: await this.getHeaders(),
+            timeout: this.mergedConfig.timeout,
+            responseType
+        };
+        try {
+            let result;
+            switch (method) {
+                case 'GET':
+                    result = await this.httpClient.get(url, requestOptions);
+                    break;
+                case 'POST':
+                    result = await this.httpClient.post(url, body, requestOptions);
+                    break;
+                case 'PUT':
+                    result = await this.httpClient.put(url, body, requestOptions);
+                    break;
+                case 'DELETE':
+                    result = await this.httpClient.delete(url, requestOptions);
+                    break;
+                default:
+                    throw new Error(`Unsupported HTTP method: ${method}`);
+            }
+            return result;
+        }
+        catch (error) {
+            if (isCSVEndpoint) {
+                console.error('❌ [PERS API CLIENT] CSV Request failed:', error);
+            }
+            // Handle 401 errors with automatic token refresh
+            const apiError = error;
+            if (apiError.status === 401 && retryCount === 0 && this.mergedConfig.authProvider?.onTokenExpired) {
+                try {
+                    await this.mergedConfig.authProvider.onTokenExpired();
+                    // Retry once with refreshed token
+                    return this.request(method, endpoint, body, { ...options, retryCount: 1 });
+                }
+                catch (refreshError) {
+                    throw new PersApiError(`Authentication refresh failed: ${refreshError}`, endpoint, method, 401);
+                }
+            }
+            throw new PersApiError(`PERS API request failed: ${apiError.message || error}`, endpoint, method, apiError.status);
+        }
+    }
+    /**
+     * Generic GET request
+     */
+    async get(endpoint, responseType) {
+        return this.request('GET', endpoint, undefined, { responseType });
+    }
+    /**
+     * Generic POST request
+     */
+    async post(endpoint, body) {
+        return this.request('POST', endpoint, body);
+    }
+    /**
+     * Generic PUT request
+     */
+    async put(endpoint, body) {
+        return this.request('PUT', endpoint, body);
+    }
+    /**
+     * Generic DELETE request
+     */
+    async delete(endpoint) {
+        return this.request('DELETE', endpoint);
+    }
+    /**
+     * Get current configuration (returns merged config)
+     */
+    getConfig() {
+        return this.mergedConfig;
+    }
+    /**
+     * Get original user configuration
+     */
+    getOriginalConfig() {
+        return this.config;
+    }
+}
+class PersApiError extends Error {
+    constructor(message, endpoint, method, statusCode) {
+        super(message);
+        this.endpoint = endpoint;
+        this.method = method;
+        this.statusCode = statusCode;
+        this.name = 'PersApiError';
+    }
+}
+/**
+ * PERS API Client - Core platform-agnostic client for PERS backend
+ */
+/*import { HttpClient, RequestOptions } from './abstractions/http-client';
+import { PersConfig, buildApiRoot, mergeWithDefaults } from './pers-config';
+
+export class PersApiClient {
+  private readonly apiRoot: string;
+  private readonly mergedConfig: ReturnType<typeof mergeWithDefaults>;
+
+  constructor(
+    private httpClient: HttpClient,
+    private config: PersConfig
+  ) {
+    // Merge user config with defaults (production + v2)
+    this.mergedConfig = mergeWithDefaults(config);
+    
+    // Build API root from merged environment and version
+    this.apiRoot = buildApiRoot(this.mergedConfig.environment, this.mergedConfig.apiVersion);
+  }
+
+  /**
+   * Get request headers including auth token and project key
+   */
+/*private async getHeaders(): Promise<Record<string, string>> {
+  const headers: Record<string, string> = {
+    'Content-Type': 'application/json',
+  };
+
+  // Add authentication token
+  if (this.mergedConfig.authProvider) {
+    const token = await this.mergedConfig.authProvider.getToken();
+    if (token) {
+      headers['Authorization'] = `Bearer ${token}`;
+    }
+  }
+
+  // Add project key
+  if (this.mergedConfig.authProvider) {
+    const projectKey = await this.mergedConfig.authProvider.getProjectKey();
+    if (projectKey) {
+      headers['x-project-key'] = projectKey;
+    }
+  } else if(this.mergedConfig.apiProjectKey) {
+    // Fallback to config project key if no auth provider
+    headers['x-project-key'] = this.mergedConfig.apiProjectKey;
+  }
+
+  return headers;
+}
+
+/**
+ * Make a request with proper headers, auth, and error handling
+ */
+/*private async request<T>(
+  method: 'GET' | 'POST' | 'PUT' | 'DELETE',
+  endpoint: string,
+  body?: any,
+  options?: { retryCount?: number }
+): Promise<T> {
+  const { retryCount = 0 } = options || {};
+  const url = `${this.apiRoot}${endpoint}`;
+  
+  const requestOptions: RequestOptions = {
+    headers: await this.getHeaders(),
+    timeout: this.mergedConfig.timeout,
+  };
+
+  try {
+    switch (method) {
+      case 'GET':
+        return await this.httpClient.get<T>(url, requestOptions);
+      case 'POST':
+        return await this.httpClient.post<T>(url, body, requestOptions);
+      case 'PUT':
+        return await this.httpClient.put<T>(url, body, requestOptions);
+      case 'DELETE':
+        return await this.httpClient.delete<T>(url, requestOptions);
+      default:
+        throw new Error(`Unsupported HTTP method: ${method}`);
+    }
+  } catch (error: any) {
+    // Handle 401 errors with automatic token refresh
+    if (error.status === 401 && retryCount === 0 && this.mergedConfig.authProvider?.onTokenExpired) {
+      try {
+        await this.mergedConfig.authProvider.onTokenExpired();
+        // Retry once with refreshed token
+        return this.request<T>(method, endpoint, body, { ...options, retryCount: 1 });
+      } catch (refreshError) {
+        throw new PersApiError(
+          `Authentication refresh failed: ${refreshError}`,
+          endpoint,
+          method,
+          401
+        );
+      }
+    }
+
+    throw new PersApiError(
+      `PERS API request failed: ${error.message || error}`,
+      endpoint,
+      method,
+      error.status
+    );
+  }
+}
+
+/**
+ * Generic GET request
+ */
+/*async get<T>(endpoint: string): Promise<T> {
+  return this.request<T>('GET', endpoint);
+}
+
+/**
+ * Generic POST request
+ */
+/*async post<T>(endpoint: string, body?: any): Promise<T> {
+  return this.request<T>('POST', endpoint, body);
+}
+
+/**
+ * Generic PUT request
+ */
+/*async put<T>(endpoint: string, body?: any): Promise<T> {
+  return this.request<T>('PUT', endpoint, body);
+}
+
+/**
+ * Generic DELETE request
+ */
+/*async delete<T>(endpoint: string): Promise<T> {
+  return this.request<T>('DELETE', endpoint);
+}
+
+/**
+ * Get current configuration (returns merged config)
+ */
+/*getConfig(): ReturnType<typeof mergeWithDefaults> {
+  return this.mergedConfig;
+}
+
+/**
+ * Get original user configuration
+ */
+/*getOriginalConfig(): PersConfig {
+  return this.config;
+}
+}
+
+export class PersApiError extends Error {
+constructor(
+  message: string,
+  public endpoint: string,
+  public method: string,
+  public statusCode?: number
+) {
+  super(message);
+  this.name = 'PersApiError';
+}
+}*/
+
+/**
+ * Creates a platform-agnostic AuthProvider from simple configuration
+ *
+ * This factory function is completely platform-agnostic and can be used
+ * across Angular, React, Vue, Node.js, or any other JavaScript environment.
+ *
+ * Features:
+ * - Token caching with refresh support
+ * - Automatic token refresh on expiration
+ * - Configurable token providers
+ * - Platform-independent (no localStorage assumptions)
+ *
+ * @param config - Simple auth configuration
+ * @returns AuthProvider implementation
+ */
+function createAuthProvider(config) {
+    // Store current token for refresh scenarios and caching
+    let currentToken = config.token || null;
+    let isRefreshing = false; // Prevent concurrent refresh attempts
+    let refreshPromise = null;
+    return {
+        authType: config.authType || 'user',
+        async getToken() {
+            // If currently refreshing, wait for it to complete
+            if (isRefreshing && refreshPromise) {
+                await refreshPromise;
+                return currentToken;
+            }
+            // Use cached current token (updated after refresh)
+            if (currentToken) {
+                return currentToken;
+            }
+            // Custom token provider function (always fresh)
+            if (config.tokenProvider) {
+                const token = await config.tokenProvider();
+                currentToken = token; // Cache for future calls
+                return token;
+            }
+            // No token available
+            return null;
+        },
+        async getProjectKey() {
+            return config.projectKey || null;
+        },
+        async onTokenExpired() {
+            // Prevent concurrent refresh attempts
+            if (isRefreshing) {
+                if (refreshPromise) {
+                    await refreshPromise;
+                }
+                return;
+            }
+            // No refresh logic provided
+            if (!config.onTokenExpired) {
+                console.warn('Token expired but no refresh logic provided');
+                currentToken = null; // Clear expired token
+                return;
+            }
+            // Start refresh process
+            isRefreshing = true;
+            refreshPromise = (async () => {
+                try {
+                    // Execute refresh logic (should update token source)
+                    await config.onTokenExpired();
+                    // After refresh, get the new token
+                    if (config.tokenProvider) {
+                        const newToken = await config.tokenProvider();
+                        if (newToken && newToken !== currentToken) {
+                            currentToken = newToken;
+                            // Notify about successful token refresh
+                            if (config.onTokenRefreshed) {
+                                config.onTokenRefreshed(newToken);
+                            }
+                        }
+                        else {
+                            console.warn('Token refresh completed but no new token received');
+                            currentToken = null;
+                        }
+                    }
+                    else {
+                        // For static token configs, clear the token since we can't refresh
+                        console.warn('Token expired for static token config - clearing token');
+                        currentToken = null;
+                    }
+                }
+                catch (error) {
+                    console.error('Token refresh failed:', error);
+                    currentToken = null; // Clear token on refresh failure
+                    throw error; // Re-throw to let SDK handle the error
+                }
+                finally {
+                    isRefreshing = false;
+                    refreshPromise = null;
+                }
+            })();
+            await refreshPromise;
+        }
+    };
+}
+/**
+ * Platform-specific localStorage token provider for browsers
+ * This is a convenience function for browser environments
+ */
+/* export function createBrowserTokenProvider(tokenKey: string = 'userJwt'): () => Promise<string | null> {
+  return async () => {
+    if (typeof localStorage !== 'undefined') {
+      return localStorage.getItem(tokenKey);
+    }
+    return null;
+  };
+} */
+/**
+ * Platform-specific environment variable token provider for Node.js
+ * This is a convenience function for Node.js environments
+ */
+/* export function createNodeTokenProvider(envVar: string = 'JWT_TOKEN'): () => Promise<string | null> {
+  return async () => {
+    if (typeof process !== 'undefined' && process.env) {
+      return process.env[envVar] || null;
+    }
+    return null;
+  };
+} */
+
+/**
+ * PERS SDK - Minimal platform-agnostic client with built-in authentication
+ * Authentication is now handled at the SDK core level for better scalability
+ */
+/**
+ * Minimal PERS SDK - API client with authentication built-in
+ * Platform adapters provide auth providers and HTTP clients
+ */
+class PersSDK {
+    constructor(httpClient, config) {
+        this.apiClient = new PersApiClient(httpClient, config);
+    }
+    /**
+     * Get the API client for direct PERS API calls
+     * This is the main interface - keep it simple!
+     */
+    api() {
+        return this.apiClient;
+    }
+    /**
+     * Quick config check
+     */
+    isProduction() {
+        return this.apiClient.getConfig().environment === 'production';
+    }
+}
+/**
+ * Simple factory function
+ */
+function createPersSDK(httpClient, config) {
+    return new PersSDK(httpClient, config);
+}
+
+export { DEFAULT_PERS_CONFIG, PersApiClient, PersApiError, PersSDK, buildApiRoot, createAuthProvider, createPersSDK, mergeWithDefaults };
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sources":["../src/core/pers-config.ts","../src/core/pers-api-client.ts","../src/core/auth/create-auth-provider.ts","../src/pers-sdk.ts"],"sourcesContent":[null,null,null,null],"names":[],"mappings":"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"}

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

@@ -0,0 +1,18 @@
+import { PersApiClient } from '../../core/pers-api-client';
+import { DonationTypeDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
+/**
+ * Platform-Agnostic Donation API Client
+ *
+ * Handles donation operations using the PERS backend.
+ * Matches framework DonationApiService methods exactly.
+ */
+export declare class DonationApi {
+    private apiClient;
+    constructor(apiClient: PersApiClient);
+    /**
+     * PUBLIC: Get all donation types
+     * ✅ ONLY method actually used by framework
+     */
+    getAllDonationTypes(): Promise<DonationTypeDTO[]>;
+}
+//# sourceMappingURL=donation-api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"donation-api.d.ts","sourceRoot":"","sources":["../../../src/donation/api/donation-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,oDAAoD,CAAC;AAErF;;;;;GAKG;AACH,qBAAa,WAAW;IACV,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,aAAa;IAM5C;;;OAGG;IACG,mBAAmB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;CAGxD"}

package/dist/donation/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @explorins/pers-sdk-donation
+ *
+ * Platform-agnostic Donation Domain SDK for PERS ecosystem
+ * Handles donation type retrieval for purchase flow integration
+ */
+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/dist/cjs/dto/purchase/donationType.dto").DonationTypeDTO[]>;
+    api: DonationApi;
+    service: DonationService;
+};
+export type DonationSDK = ReturnType<typeof createDonationSDK>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/{src/donation/models/index.ts → dist/donation/models/index.d.ts}

@@ -1,11 +1,8 @@
-/**
- * Donation Domain Models
- * 
- * Re-exports from centralized pers-shared interfaces for consistency with backend
- * and to provide a single import source for donation-related types.
- */
-
-// Core donation entities from centralized pers-shared interfaces
-export type {
-  DonationTypeDTO
-} from '../../shared/interfaces/pers-shared-lib.interfaces';
+/**
+ * Donation Domain Models
+ *
+ * Re-exports from centralized pers-shared interfaces for consistency with backend
+ * and to provide a single import source for donation-related types.
+ */
+export type { DonationTypeDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/donation/models/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,eAAe,EAChB,MAAM,oDAAoD,CAAC"}

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

@@ -0,0 +1,19 @@
+import { DonationApi } from '../api/donation-api';
+import { DonationTypeDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
+/**
+ * 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.
+ */
+export declare class DonationService {
+    private donationApi;
+    constructor(donationApi: DonationApi);
+    /**
+     * PUBLIC: Get all donation types
+     * ✅ ONLY method actually used by framework
+     */
+    getAllDonationTypes(): Promise<DonationTypeDTO[]>;
+}
+//# sourceMappingURL=donation-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"donation-service.d.ts","sourceRoot":"","sources":["../../../src/donation/services/donation-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,oDAAoD,CAAC;AAErF;;;;;;GAMG;AACH,qBAAa,eAAe;IACd,OAAO,CAAC,WAAW;gBAAX,WAAW,EAAE,WAAW;IAM5C;;;OAGG;IACG,mBAAmB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;CAGxD"}

package/dist/donation.cjs

@@ -0,0 +1,78 @@
+'use strict';
+
+/**
+ * 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('/purchase/donation/type');
+    }
+}
+
+/**
+ * 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 = DonationApi;
+exports.DonationService = DonationService;
+exports.createDonationSDK = createDonationSDK;
+//# sourceMappingURL=donation.cjs.map