{"version":3,"sources":["/Users/JOHNSON028877/Documents/new-juf.js/dist/chunk-W5WEVJMX.cjs","../src/core/logger.js","../src/core/constants.js","../src/core/cache.js","../config/index.js","../config/src/apigee.js","../config/src/apm.js","../config/src/environment.js","../src/core/apiUrl.js","../src/core/requester.js","../src/core/errors.js"],"names":[],"mappings":"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","file":"/Users/JOHNSON028877/Documents/new-juf.js/dist/chunk-W5WEVJMX.cjs","sourcesContent":[null,"/**\n * @namespace Logger\n * @description Lightweight internal logger for JUF library.\n * Provides structured, level-aware logging without Express/HTTP dependencies.\n * Uses JSON format in production and readable format in development.\n */\n\nconst LOG_LEVELS = {\n error: 0,\n warn: 1,\n info: 2,\n debug: 3,\n};\n\n/**\n * @class Logger\n * @classdesc Minimal structured logger for library-internal use.\n * Not intended for application-level logging — consumers should use their own logger.\n *\n * @example\n * import { logger } from './utils/logger.js';\n *\n * logger.info('Payment checkout prepared', { reference: 'INV001' });\n * logger.error('QR code generation failed', { reference: 'INV001', status: 500 });\n */\nclass Logger {\n /** @type {string} */\n #prefix;\n\n /** @type {number} */\n #level;\n\n /**\n * @param {object} options - Logger configuration.\n * @param {string} [options.prefix='juf'] - Log line prefix / service identifier.\n * @param {string} [options.level='info'] - Minimum log level to output.\n */\n constructor({ prefix = 'juf', level = 'info' } = {}) {\n this.#prefix = prefix;\n this.#level = LOG_LEVELS[level] ?? LOG_LEVELS.info;\n }\n\n /**\n * Creates a child logger with a scoped prefix.\n * @param {string} scope - The scope name (e.g. 'payment', 'auth').\n * @returns {Logger} A new Logger instance with the scoped prefix.\n */\n child(scope) {\n return new Logger({\n prefix: `${this.#prefix}:${scope}`,\n level: Object.keys(LOG_LEVELS).find((k) => LOG_LEVELS[k] === this.#level),\n });\n }\n\n /**\n * @param {string} message - Log message.\n * @param {object} [context] - Structured context metadata.\n */\n error(message, context) {\n this.#log('error', message, context);\n }\n\n /**\n * @param {string} message - Log message.\n * @param {object} [context] - Structured context metadata.\n */\n warn(message, context) {\n this.#log('warn', message, context);\n }\n\n /**\n * @param {string} message - Log message.\n * @param {object} [context] - Structured context metadata.\n */\n info(message, context) {\n this.#log('info', message, context);\n }\n\n /**\n * @param {string} message - Log message.\n * @param {object} [context] - Structured context metadata.\n */\n debug(message, context) {\n this.#log('debug', message, context);\n }\n\n /**\n * @private\n * @param {string} level - Log level.\n * @param {string} message - Log message.\n * @param {object} [context] - Structured context metadata.\n */\n #log(level, message, context) {\n if (LOG_LEVELS[level] > this.#level) return;\n\n const entry = {\n timestamp: new Date().toISOString(),\n level,\n prefix: this.#prefix,\n message,\n ...(context && { context: this.#sanitize(context) }),\n };\n\n const output = level === 'error' || level === 'warn' ? console.error : console.log;\n output(JSON.stringify(entry));\n }\n\n /**\n * Strips sensitive fields from context before logging.\n * @private\n * @param {object} context - The context object to sanitize.\n * @returns {object} Sanitized copy of the context.\n */\n #sanitize(context) {\n const SENSITIVE_KEYS = new Set([\n 'authorization',\n 'password',\n 'client_secret',\n 'access_token',\n 'token',\n 'secret',\n 'cookie',\n ]);\n\n const sanitized = {};\n\n for (const [key, value] of Object.entries(context)) {\n if (SENSITIVE_KEYS.has(key.toLowerCase())) {\n sanitized[key] = '[REDACTED]';\n } else if (typeof value === 'object' && value !== null && !Array.isArray(value)) {\n sanitized[key] = this.#sanitize(value);\n } else {\n sanitized[key] = value;\n }\n }\n\n return sanitized;\n }\n}\n\n/** @type {Logger} Singleton logger instance for internal JUF use. */\nexport const logger = new Logger({\n level: process.env.JUF_LOG_LEVEL || 'info',\n});\n\nexport default Logger;\n","/**\n * @namespace Constants\n * @description Centralized constants for the JUF library.\n * No magic values — every threshold, timeout, and config lives here.\n */\n\n/** @type {number} Cache time-to-live for auth tokens in seconds. */\nexport const AUTH_CACHE_TTL_SECONDS = 240;\n\n/** @type {number} Maximum number of retry attempts for failed HTTP requests. */\nexport const MAX_RETRY_ATTEMPTS = 2;\n\n/** @type {number} Base delay between retries in milliseconds. */\nexport const RETRY_BASE_DELAY_MS = 2000;\n\n/** @type {number} HTTP status code that triggers automatic retry. */\nexport const RETRYABLE_STATUS_CODE = 503;\n\n/** @type {number} Default QR code validity in seconds (1 day). */\nexport const DEFAULT_QR_VALIDITY_SECONDS = 86400;\n\n/** @type {string} Currency unit for payment amounts. */\nexport const CURRENCY_UNIT = 'XOF';\n\n/** @type {string} Default channel for SMS delivery. */\nexport const SMS_CHANNEL = 'SMS';\n\n/** @type {string} Content type for OAuth token requests. */\nexport const OAUTH_CONTENT_TYPE = 'application/x-www-form-urlencoded';\n\n/** @type {string} OAuth grant type used for machine-to-machine auth. */\nexport const OAUTH_GRANT_TYPE = 'client_credentials';\n\n/** @type {string} OAuth token endpoint path. */\nexport const OAUTH_TOKEN_PATH = '/oauth/v1/token';\n\n/** @type {number} HTTP status for bad request / validation errors. */\nexport const HTTP_BAD_REQUEST = 400;\n\n/** @type {number} HTTP status for authentication failures. */\nexport const HTTP_UNAUTHORIZED = 401;\n\n/** @type {number} HTTP status for internal server errors. */\nexport const HTTP_INTERNAL_SERVER_ERROR = 500;\n\n/** @type {number} HTTP status for bad gateway / upstream failures. */\nexport const HTTP_BAD_GATEWAY = 502;\n","/**\n * @namespace CacheUtil\n */\n\nimport NodeCache from 'node-cache';\nimport { logger as rootLogger } from './logger.js';\nimport { AUTH_CACHE_TTL_SECONDS } from './constants.js';\n\nconst logger = rootLogger.child('cache');\n\n/**\n * @class Cache\n * @classdesc Handles caching of data with expiration using NodeCache.\n * Provides methods to store and retrieve cached data, with error handling for reliable cache management.\n *\n * @example\n * const myCache = new Cache(300);\n * myCache.store('myKey', { data: 'value' });\n * const cachedData = myCache.retrieve('myKey');\n */\nclass Cache {\n /** @private @type {NodeCache} */\n #cache;\n\n /**\n * Creates an instance of Cache.\n * @param {number} ttlSeconds - Time-to-live (TTL) in seconds for cached items.\n */\n constructor(ttlSeconds) {\n this.#cache = new NodeCache({ stdTTL: ttlSeconds });\n }\n\n /**\n * Stores a value in the cache with a specified key.\n *\n * @param {string} key - The key under which the value is stored.\n * @param {*} value - The value to be stored. Must be serializable to JSON.\n * @returns {boolean} Returns true if stored successfully, otherwise false.\n */\n store(key, value) {\n try {\n return this.#cache.set(key, JSON.stringify(value));\n } catch (error) {\n logger.error('Failed to store cache entry', { key, error: error.message });\n return false;\n }\n }\n\n /**\n * Retrieves a value from the cache by its key.\n *\n * @param {string} key - The key to retrieve the value.\n * @returns {object|null} Returns the parsed cached value if found, otherwise null.\n */\n retrieve(key) {\n try {\n if (this.#cache.has(key)) {\n return JSON.parse(this.#cache.get(key));\n }\n } catch (error) {\n logger.error('Failed to retrieve cache entry', { key, error: error.message });\n }\n return null;\n }\n}\n\n/**\n * Singleton instance of Cache with the standard auth token TTL.\n * @type {Cache}\n */\nexport const CachingSystem = new Cache(AUTH_CACHE_TTL_SECONDS);\nexport default Cache;\n","import dotenv from 'dotenv';\nimport { apigeeConfig } from './src/apigee.js';\nimport { apmConfig } from './src/apm.js';\nimport { environmentConfig } from './src/environment.js';\n\n/** Placeholder values that indicate credentials were never set. */\nconst PLACEHOLDER_PATTERN = /^<.+>$/;\n\n/**\n * @constant configSchema\n * @description Consolidated configuration schema combining all atomic configurations.\n */\nconst configSchema = {\n ...environmentConfig,\n apigee: apigeeConfig,\n apm: apmConfig,\n};\n\n/** @type {boolean} Tracks whether dotenv has been loaded. */\nlet envLoaded = false;\n\n/**\n * Ensures dotenv is loaded exactly once, on first config access.\n * This avoids side-effects at import time, making the library\n * compatible with serverless/edge environments.\n */\nconst ensureEnvLoaded = () => {\n if (!envLoaded) {\n dotenv.config();\n envLoaded = true;\n }\n};\n\n/**\n * @function loadConfigFromEnv\n * @description Recursively loads configuration values from environment variables based on a given schema.\n * If the environment variable is not set, it falls back to the default value in the schema.\n * @param {Object} schema - The configuration schema object.\n * @returns {Object} - An object with the loaded configuration values.\n */\nconst loadConfigFromEnv = (schema) => {\n const config = {};\n\n Object.entries(schema).forEach(([key, value]) => {\n if (typeof value === 'object' && value !== null && !Array.isArray(value)) {\n // If the value is an object, check if it's a nested schema or a schema property\n if ('env' in value && 'default' in value) {\n const envValue = process.env[value.env];\n\n // Load value from environment variable or use default if not set\n let finalValue = envValue !== undefined ? envValue : value.default;\n\n // Apply the format function if it exists and is a function\n if (typeof value.format === 'function') {\n finalValue = value.format(finalValue);\n }\n\n config[key] = finalValue;\n } else {\n // Recursively process nested objects\n config[key] = loadConfigFromEnv(value);\n }\n } else {\n // Handle unexpected schema structures\n config[key] = value;\n }\n });\n\n return config;\n};\n\n/**\n * Validates that required Apigee credentials are set and not placeholders.\n * Throws immediately with an actionable message if credentials are missing.\n *\n * @param {object} config - The loaded apigee configuration.\n * @throws {Error} When required credentials are missing or still placeholder values.\n */\nconst validateApigeeConfig = (config) => {\n const required = [\n { key: 'client_id', env: 'JUF_APIGEE_CLIENT_ID' },\n { key: 'client_secret', env: 'JUF_APIGEE_CLIENT_SECRET' },\n ];\n\n for (const { key, env } of required) {\n const value = config[key];\n if (!value || PLACEHOLDER_PATTERN.test(value)) {\n throw new Error(\n `Missing ${env} — set it in your .env file or environment variables. ` +\n 'Get your credentials at https://developer.orange-sonatel.com',\n );\n }\n }\n};\n\n/**\n * @object envConfig\n * @description Provides methods to retrieve configuration based on the environment schema.\n * Dotenv is loaded lazily on first access — no side-effects at import time.\n */\nconst envConfig = {\n /**\n * @function get\n * @description Retrieves the configuration for a given schema name.\n * @param {string} name - The name of the schema to retrieve.\n * @returns {Object} - The configuration object for the specified schema.\n */\n get: (name) => {\n ensureEnvLoaded();\n const config = loadConfigFromEnv(configSchema[name]);\n\n if (name === 'apigee') {\n validateApigeeConfig(config);\n }\n\n return config;\n },\n};\n\nexport { envConfig };\n","/**\n * @constant apigeeConfig\n * @description Configuration schema for Apigee settings including URLs, client credentials, and environment flags.\n */\nexport const apigeeConfig = {\n onProd: {\n doc: 'Flag to indicate production environment for Apigee',\n format: 'Boolean',\n default: false,\n env: 'JUF_APIGEE_ON_PROD',\n },\n onPProd: {\n doc: 'Flag to indicate pre-production environment for Apigee',\n format: 'Boolean',\n default: false,\n env: 'JUF_APIGEE_SP_PPROD',\n },\n url: {\n production: {\n doc: 'Production URL for Apigee',\n format: String,\n default: 'https://api.orange-sonatel.com',\n env: 'JUF_APIGEE_PROD_URL',\n },\n sandbox: {\n doc: 'Sandbox URL for Apigee',\n format: String,\n default: 'https://api.sandbox.orange-sonatel.com',\n env: 'JUF_APIGEE_SANDBOX_URL',\n },\n preprod: {\n doc: 'Pre-production URL for Apigee',\n format: String,\n default: 'https://api.preprod.orange-sonatel.com',\n env: 'JUF_APIGEE_PREPROD_URL',\n },\n },\n client_id: {\n doc: 'The Apigee client ID',\n format: String,\n default: '',\n env: 'JUF_APIGEE_CLIENT_ID',\n },\n client_secret: {\n doc: 'The Apigee client secret',\n format: String,\n default: '',\n env: 'JUF_APIGEE_CLIENT_SECRET',\n },\n decode_qr_sp_authorization: {\n doc: 'The Apigee SP authorization',\n format: String,\n default: '',\n env: 'JUF_APIGEE_DECODE_QR_SP_AUTHORIZATION',\n },\n};\n","/**\n * @constant apmConfig\n * @description Configuration schema for APM (Application Performance Monitoring) settings.\n */\nexport const apmConfig = {\n verifyServerCert: {\n doc: 'Verify APM server certificate',\n format: 'Boolean',\n default: false,\n env: 'JUF_ELK_APM_VERIF_CERT',\n },\n logLevel: {\n doc: 'Log level for APM',\n format: String,\n default: 'info',\n env: 'JUF_ELK_APM_LOG_LEVEL',\n },\n environment: {\n doc: 'Environment name for APM',\n format: String,\n default: '',\n env: 'JUF_ELK_APM_ENV_NAME',\n },\n serviceName: {\n doc: 'Service name for APM',\n format: String,\n default: '',\n env: 'JUF_ELK_APM_SERVICE_NAME',\n },\n secretToken: {\n doc: 'Secret token for APM',\n format: String,\n default: '',\n env: 'JUF_ELK_APM_SECRET_TOKEN',\n },\n serverUrl: {\n doc: 'Server URL for APM',\n format: String,\n default: 'http://127.0.0.1:8200',\n env: 'JUF_ELK_APM_SERVER',\n },\n};","/**\n * @constant environmentConfig\n * @description Configuration schema for general environment and app settings.\n */\nexport const environmentConfig = {\n env: {\n doc: 'The application environment',\n format: ['test', 'dev', 'development', 'pprod', 'prod', 'production'],\n default: 'dev',\n env: 'NODE_ENV',\n },\n port: {\n doc: 'The port to bind',\n format: 'port',\n default: 3000,\n env: 'PORT',\n },\n};","import { envConfig } from '../../config/index.js';\n\n/**\n * @function getApiUrl\n * @description Determines the correct API URL based on the environment configuration.\n * @returns {string} The API URL to be used.\n */\nexport const getApiUrl = () => {\n const {\n url: { production, sandbox, preprod },\n onProd,\n onPProd,\n } = envConfig.get('apigee');\n if (onProd) return production;\n if (onPProd) return preprod;\n return sandbox;\n};\n\nexport const getApiEnv = () => {\n const { onProd, onPProd } = envConfig.get('apigee');\n return {\n onProd: Boolean(onProd),\n onPProd: Boolean(onPProd),\n };\n};\n","/**\n * @namespace Shared\n */\n\nimport axios from 'axios';\nimport axiosRetry from 'axios-retry';\nimport https from 'https';\nimport { MAX_RETRY_ATTEMPTS, RETRY_BASE_DELAY_MS, RETRYABLE_STATUS_CODE } from './constants.js';\n\n/**\n * @class Requester\n * @classdesc Utility class to create and configure Axios instances dynamically.\n * Each instance gets its own retry configuration instead of polluting the global axios.\n */\nclass Requester {\n /**\n * Creates a new Axios instance with custom configuration and per-instance retry.\n *\n * @static\n * @method bootstrap\n * @memberof Shared\n * @param {object} config - Custom configuration for Axios.\n * @param {string} config.baseURL - Base URL for requests.\n * @param {object} [config.agentParams] - HTTPS agent parameters.\n * @param {object|false} [config.retry] - Retry configuration, or false to disable.\n * @param {number} [config.retry.retries] - Number of retries (default: 2).\n * @param {number} [config.retry.baseDelay] - Base delay in ms for exponential backoff (default: 2000).\n * @returns {import('axios').AxiosInstance} A configured Axios instance.\n */\n static bootstrap(config) {\n const { agentParams, retry, ...axiosConfig } = config;\n\n const instance = axios.create({\n httpsAgent: new https.Agent(agentParams || {}),\n ...axiosConfig,\n });\n\n if (retry !== false) {\n axiosRetry(instance, {\n retries: retry?.retries ?? MAX_RETRY_ATTEMPTS,\n retryDelay: (retryCount) => retryCount * (retry?.baseDelay ?? RETRY_BASE_DELAY_MS),\n retryCondition: (error) => error.response?.status === RETRYABLE_STATUS_CODE,\n });\n }\n\n return instance;\n }\n}\n\nexport default Requester;\n","/**\n * @namespace Errors\n * @description Custom error hierarchy for JUF library.\n * All errors follow a consistent shape: { success, error: { code, message, details } }\n */\n\nimport { HTTP_BAD_REQUEST, HTTP_UNAUTHORIZED, HTTP_INTERNAL_SERVER_ERROR, HTTP_BAD_GATEWAY } from './constants.js';\n\n/**\n * @class JufError\n * @extends Error\n * @classdesc Base error class for all JUF errors.\n * Provides a consistent error response shape across the library.\n *\n * @example\n * throw new JufError('Something went wrong', 500, 'JUF_INTERNAL_ERROR');\n */\nexport class JufError extends Error {\n /** @type {number} */\n status;\n\n /** @type {string} */\n code;\n\n /** @type {*} */\n details;\n\n /**\n * @param {string} message - Human-readable error message.\n * @param {number} [status=500] - HTTP-equivalent status code.\n * @param {string} [code='JUF_ERROR'] - Machine-readable error code.\n * @param {*} [details=null] - Additional error context.\n */\n constructor(message, status = HTTP_INTERNAL_SERVER_ERROR, code = 'JUF_ERROR', details = null) {\n super(message);\n this.name = this.constructor.name;\n this.status = status;\n this.code = code;\n this.details = details;\n }\n\n /**\n * Returns a consistent JSON-serializable error response.\n * @returns {{ success: false, error: { code: string, message: string, details: * } }}\n */\n toJSON() {\n return {\n success: false,\n error: {\n code: this.code,\n message: this.message,\n ...(this.details && { details: this.details }),\n },\n };\n }\n}\n\n/**\n * @class ValidationError\n * @extends JufError\n * @classdesc Thrown when input validation fails (Superstruct assertions, URL checks, etc.).\n */\nexport class ValidationError extends JufError {\n /**\n * @param {string} message - Description of the validation failure.\n * @param {*} [details=null] - Field-level details about what failed.\n */\n constructor(message, details = null) {\n super(message, HTTP_BAD_REQUEST, 'JUF_VALIDATION_ERROR', details);\n }\n}\n\n/**\n * @class AuthenticationError\n * @extends JufError\n * @classdesc Thrown when authentication with the Apigee platform fails.\n */\nexport class AuthenticationError extends JufError {\n /**\n * @param {string} [message='Authentication failed. Check your credentials and try again.'] - Error message.\n * @param {*} [details=null] - API response details.\n */\n constructor(message = 'Authentication failed. Check your credentials and try again.', details = null) {\n super(message, HTTP_UNAUTHORIZED, 'JUF_AUTH_ERROR', details);\n }\n}\n\n/**\n * @class ExternalServiceError\n * @extends JufError\n * @classdesc Thrown when an external API call (Apigee, payment gateway, etc.) fails.\n */\nexport class ExternalServiceError extends JufError {\n /**\n * @param {string} message - Description of the service failure.\n * @param {number} [status=502] - HTTP status from the upstream service.\n * @param {*} [details=null] - Upstream response body or error details.\n */\n constructor(message, status = HTTP_BAD_GATEWAY, details = null) {\n super(message, status, 'JUF_EXTERNAL_SERVICE_ERROR', details);\n }\n}\n\n/**\n * Extracts a structured JufError from an Axios error response.\n * @param {object} error - Axios error object.\n * @param {string} fallbackMessage - Default message when the upstream provides none.\n * @returns {ExternalServiceError} A structured error ready to throw.\n */\nexport const fromAxiosError = (error, fallbackMessage) => {\n const status = error.response?.status || HTTP_INTERNAL_SERVER_ERROR;\n const upstream = error.response?.data;\n\n const message = upstream?.message || upstream?.error_description || fallbackMessage;\n const details = upstream?.detail || upstream?.error || null;\n\n return new ExternalServiceError(message, status, details);\n};\n"]}