@nehorai/payments 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Nehorai Hadad
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/config/index.cjs

@@ -0,0 +1,116 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/config/index.ts
+var config_exports = {};
+__export(config_exports, {
+  createConfig: () => createConfig,
+  createConfigFromEnv: () => createConfigFromEnv,
+  createPartialConfig: () => createPartialConfig,
+  getConfiguredProviderList: () => getConfiguredProviderList,
+  getConfiguredProviders: () => getConfiguredProviders,
+  isProductionReady: () => isProductionReady,
+  validateConfig: () => validateConfig
+});
+module.exports = __toCommonJS(config_exports);
+
+// src/config/payment-config.ts
+function createConfigFromEnv(mapping) {
+  if (!mapping) {
+    return createPartialConfig({});
+  }
+  const providers = {};
+  for (const providerMapping of mapping.providers) {
+    const config = {};
+    let hasValue = false;
+    for (const [configKey, envVarName] of Object.entries(providerMapping.keys)) {
+      const value = process.env[envVarName];
+      if (value?.trim()) {
+        config[configKey] = value;
+        hasValue = true;
+      }
+    }
+    if (providerMapping.requiredKeys) {
+      const allRequired = providerMapping.requiredKeys.every(
+        (key) => config[key] && typeof config[key] === "string" && config[key].trim()
+      );
+      if (allRequired) {
+        providers[providerMapping.providerName] = config;
+      }
+    } else if (hasValue) {
+      providers[providerMapping.providerName] = config;
+    }
+  }
+  const environment = process.env[mapping.environmentVar ?? "PAYMENT_ENVIRONMENT"] ?? "sandbox";
+  const defaultCurrency = process.env[mapping.defaultCurrencyVar ?? "DEFAULT_CURRENCY"] ?? "USD";
+  return {
+    providers,
+    environment,
+    defaultCurrency
+  };
+}
+function createConfig(config) {
+  validateConfig(config);
+  return {
+    providers: { ...config.providers },
+    environment: config.environment,
+    defaultCurrency: config.defaultCurrency
+  };
+}
+function createPartialConfig(partial) {
+  return {
+    providers: partial.providers ?? {},
+    environment: partial.environment ?? "sandbox",
+    defaultCurrency: partial.defaultCurrency ?? "USD"
+  };
+}
+function getConfiguredProviders(config) {
+  const availability = {};
+  for (const [name, providerConfig] of Object.entries(config.providers)) {
+    availability[name] = providerConfig !== void 0 && Object.keys(providerConfig).length > 0;
+  }
+  return availability;
+}
+function getConfiguredProviderList(config) {
+  const availability = getConfiguredProviders(config);
+  return Object.entries(availability).filter(([, isAvailable]) => isAvailable).map(([name]) => name);
+}
+function isProductionReady(config) {
+  const providers = getConfiguredProviderList(config);
+  return config.environment === "production" && providers.length > 0;
+}
+function validateConfig(config) {
+  const providers = getConfiguredProviderList(config);
+  if (providers.length === 0) {
+    throw new Error(
+      "Payment configuration error: At least one payment provider must be configured"
+    );
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createConfig,
+  createConfigFromEnv,
+  createPartialConfig,
+  getConfiguredProviderList,
+  getConfiguredProviders,
+  isProductionReady,
+  validateConfig
+});
+//# sourceMappingURL=index.cjs.map

package/dist/config/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/config/index.ts","../../src/config/payment-config.ts"],"sourcesContent":["/**\r\n * @nehorai/payments - Configuration Exports\r\n */\r\n\r\nexport {\r\n  createConfig,\r\n  createConfigFromEnv,\r\n  createPartialConfig,\r\n  getConfiguredProviders,\r\n  getConfiguredProviderList,\r\n  isProductionReady,\r\n  validateConfig,\r\n  type PaymentConfig,\r\n  type ProvidersConfig,\r\n  type ProviderConfig,\r\n  type ConfiguredProviderAvailability,\r\n  type EnvVarMapping,\r\n  type ProviderEnvMapping,\r\n  type EnvMappingConfig,\r\n} from './payment-config.js'\r\n","/**\r\n * @nehorai/payments - Injectable Configuration\r\n *\r\n * Provides a framework-agnostic configuration interface that can be\r\n * populated from any source (env vars, secrets manager, database, etc.).\r\n *\r\n * Usage:\r\n * ```typescript\r\n * // Option 1: Create from custom source\r\n * const config = createConfig({\r\n *   providers: {\r\n *     stripe: { secretKey: 'sk_test_...' },\r\n *   },\r\n *   environment: 'sandbox',\r\n *   defaultCurrency: 'USD',\r\n * });\r\n *\r\n * // Option 2: Create from environment variables\r\n * const config = createConfigFromEnv({\r\n *   stripeSecretKey: 'STRIPE_SECRET_KEY',\r\n *   stripePublishableKey: 'STRIPE_PUBLISHABLE_KEY',\r\n *   stripeWebhookSecret: 'STRIPE_WEBHOOK_SECRET',\r\n *   environment: 'PAYMENT_ENVIRONMENT',\r\n *   defaultCurrency: 'DEFAULT_CURRENCY',\r\n * });\r\n * ```\r\n */\r\n\r\n// ============================================================================\r\n// Provider Configuration Types\r\n// ============================================================================\r\n\r\n/**\r\n * Generic provider configuration - key-value pairs\r\n * Providers can have any config shape.\r\n */\r\nexport interface ProviderConfig {\r\n  /** Provider-specific configuration values */\r\n  [key: string]: unknown\r\n}\r\n\r\n/**\r\n * Provider configurations map.\r\n * Keys are provider names, values are provider-specific config.\r\n */\r\nexport interface ProvidersConfig {\r\n  [providerName: string]: ProviderConfig | undefined\r\n}\r\n\r\n/**\r\n * Main payment configuration interface\r\n *\r\n * This is the injectable configuration that can be provided from any source.\r\n */\r\nexport interface PaymentConfig {\r\n  /** Provider-specific configurations */\r\n  providers: ProvidersConfig\r\n  /** Environment mode */\r\n  environment: 'sandbox' | 'production'\r\n  /** Default currency for transactions */\r\n  defaultCurrency: string\r\n}\r\n\r\n/**\r\n * Provider availability derived from configuration\r\n */\r\nexport interface ConfiguredProviderAvailability {\r\n  [providerName: string]: boolean\r\n}\r\n\r\n// ============================================================================\r\n// Environment Variable Mapping\r\n// ============================================================================\r\n\r\n/**\r\n * Mapping of provider config keys to environment variable names.\r\n * Used by createConfigFromEnv().\r\n */\r\nexport interface EnvVarMapping {\r\n  [envVarKey: string]: string\r\n}\r\n\r\n/**\r\n * Provider env var mapping: maps config keys to env var names\r\n */\r\nexport interface ProviderEnvMapping {\r\n  providerName: string\r\n  /** Map of config key -> env var name. Provider is considered configured if any key has a value. */\r\n  keys: EnvVarMapping\r\n  /** Keys that are all required for the provider to be considered configured */\r\n  requiredKeys?: string[]\r\n}\r\n\r\n/**\r\n * Full env mapping configuration\r\n */\r\nexport interface EnvMappingConfig {\r\n  providers: ProviderEnvMapping[]\r\n  environmentVar?: string\r\n  defaultCurrencyVar?: string\r\n}\r\n\r\n// ============================================================================\r\n// Configuration Factory Functions\r\n// ============================================================================\r\n\r\n/**\r\n * Create payment configuration from environment variables\r\n *\r\n * @param mapping - Mapping of config keys to env var names\r\n * @returns PaymentConfig populated from process.env\r\n */\r\nexport function createConfigFromEnv(mapping?: EnvMappingConfig): PaymentConfig {\r\n  if (!mapping) {\r\n    return createPartialConfig({})\r\n  }\r\n\r\n  const providers: ProvidersConfig = {}\r\n\r\n  for (const providerMapping of mapping.providers) {\r\n    const config: ProviderConfig = {}\r\n    let hasValue = false\r\n\r\n    for (const [configKey, envVarName] of Object.entries(providerMapping.keys)) {\r\n      const value = process.env[envVarName]\r\n      if (value?.trim()) {\r\n        config[configKey] = value\r\n        hasValue = true\r\n      }\r\n    }\r\n\r\n    // Check if required keys are all present\r\n    if (providerMapping.requiredKeys) {\r\n      const allRequired = providerMapping.requiredKeys.every(\r\n        (key) => config[key] && typeof config[key] === 'string' && (config[key] as string).trim()\r\n      )\r\n      if (allRequired) {\r\n        providers[providerMapping.providerName] = config\r\n      }\r\n    } else if (hasValue) {\r\n      providers[providerMapping.providerName] = config\r\n    }\r\n  }\r\n\r\n  const environment = (process.env[mapping.environmentVar ?? 'PAYMENT_ENVIRONMENT'] as 'sandbox' | 'production') ?? 'sandbox'\r\n  const defaultCurrency = process.env[mapping.defaultCurrencyVar ?? 'DEFAULT_CURRENCY'] ?? 'USD'\r\n\r\n  return {\r\n    providers,\r\n    environment,\r\n    defaultCurrency,\r\n  }\r\n}\r\n\r\n/**\r\n * Create payment configuration from a custom source\r\n *\r\n * @param config - Custom configuration object\r\n * @returns Validated PaymentConfig\r\n */\r\nexport function createConfig(config: PaymentConfig): PaymentConfig {\r\n  validateConfig(config)\r\n  return {\r\n    providers: { ...config.providers },\r\n    environment: config.environment,\r\n    defaultCurrency: config.defaultCurrency,\r\n  }\r\n}\r\n\r\n/**\r\n * Create a partial configuration (useful for testing)\r\n *\r\n * @param partial - Partial configuration\r\n * @returns Full configuration with defaults\r\n */\r\nexport function createPartialConfig(partial: Partial<PaymentConfig>): PaymentConfig {\r\n  return {\r\n    providers: partial.providers ?? {},\r\n    environment: partial.environment ?? 'sandbox',\r\n    defaultCurrency: partial.defaultCurrency ?? 'USD',\r\n  }\r\n}\r\n\r\n// ============================================================================\r\n// Configuration Utilities\r\n// ============================================================================\r\n\r\n/**\r\n * Check which providers are configured\r\n */\r\nexport function getConfiguredProviders(config: PaymentConfig): ConfiguredProviderAvailability {\r\n  const availability: ConfiguredProviderAvailability = {}\r\n\r\n  for (const [name, providerConfig] of Object.entries(config.providers)) {\r\n    availability[name] = providerConfig !== undefined && Object.keys(providerConfig).length > 0\r\n  }\r\n\r\n  return availability\r\n}\r\n\r\n/**\r\n * Get list of configured provider names\r\n */\r\nexport function getConfiguredProviderList(config: PaymentConfig): string[] {\r\n  const availability = getConfiguredProviders(config)\r\n  return Object.entries(availability)\r\n    .filter(([, isAvailable]) => isAvailable)\r\n    .map(([name]) => name)\r\n}\r\n\r\n/**\r\n * Check if configuration is valid for production\r\n */\r\nexport function isProductionReady(config: PaymentConfig): boolean {\r\n  const providers = getConfiguredProviderList(config)\r\n  return config.environment === 'production' && providers.length > 0\r\n}\r\n\r\n/**\r\n * Validate configuration has at least one provider\r\n */\r\nexport function validateConfig(config: PaymentConfig): void {\r\n  const providers = getConfiguredProviderList(config)\r\n\r\n  if (providers.length === 0) {\r\n    throw new Error(\r\n      'Payment configuration error: At least one payment provider must be configured'\r\n    )\r\n  }\r\n}\r\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACgHO,SAAS,oBAAoB,SAA2C;AAC7E,MAAI,CAAC,SAAS;AACZ,WAAO,oBAAoB,CAAC,CAAC;AAAA,EAC/B;AAEA,QAAM,YAA6B,CAAC;AAEpC,aAAW,mBAAmB,QAAQ,WAAW;AAC/C,UAAM,SAAyB,CAAC;AAChC,QAAI,WAAW;AAEf,eAAW,CAAC,WAAW,UAAU,KAAK,OAAO,QAAQ,gBAAgB,IAAI,GAAG;AAC1E,YAAM,QAAQ,QAAQ,IAAI,UAAU;AACpC,UAAI,OAAO,KAAK,GAAG;AACjB,eAAO,SAAS,IAAI;AACpB,mBAAW;AAAA,MACb;AAAA,IACF;AAGA,QAAI,gBAAgB,cAAc;AAChC,YAAM,cAAc,gBAAgB,aAAa;AAAA,QAC/C,CAAC,QAAQ,OAAO,GAAG,KAAK,OAAO,OAAO,GAAG,MAAM,YAAa,OAAO,GAAG,EAAa,KAAK;AAAA,MAC1F;AACA,UAAI,aAAa;AACf,kBAAU,gBAAgB,YAAY,IAAI;AAAA,MAC5C;AAAA,IACF,WAAW,UAAU;AACnB,gBAAU,gBAAgB,YAAY,IAAI;AAAA,IAC5C;AAAA,EACF;AAEA,QAAM,cAAe,QAAQ,IAAI,QAAQ,kBAAkB,qBAAqB,KAAkC;AAClH,QAAM,kBAAkB,QAAQ,IAAI,QAAQ,sBAAsB,kBAAkB,KAAK;AAEzF,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAQO,SAAS,aAAa,QAAsC;AACjE,iBAAe,MAAM;AACrB,SAAO;AAAA,IACL,WAAW,EAAE,GAAG,OAAO,UAAU;AAAA,IACjC,aAAa,OAAO;AAAA,IACpB,iBAAiB,OAAO;AAAA,EAC1B;AACF;AAQO,SAAS,oBAAoB,SAAgD;AAClF,SAAO;AAAA,IACL,WAAW,QAAQ,aAAa,CAAC;AAAA,IACjC,aAAa,QAAQ,eAAe;AAAA,IACpC,iBAAiB,QAAQ,mBAAmB;AAAA,EAC9C;AACF;AASO,SAAS,uBAAuB,QAAuD;AAC5F,QAAM,eAA+C,CAAC;AAEtD,aAAW,CAAC,MAAM,cAAc,KAAK,OAAO,QAAQ,OAAO,SAAS,GAAG;AACrE,iBAAa,IAAI,IAAI,mBAAmB,UAAa,OAAO,KAAK,cAAc,EAAE,SAAS;AAAA,EAC5F;AAEA,SAAO;AACT;AAKO,SAAS,0BAA0B,QAAiC;AACzE,QAAM,eAAe,uBAAuB,MAAM;AAClD,SAAO,OAAO,QAAQ,YAAY,EAC/B,OAAO,CAAC,CAAC,EAAE,WAAW,MAAM,WAAW,EACvC,IAAI,CAAC,CAAC,IAAI,MAAM,IAAI;AACzB;AAKO,SAAS,kBAAkB,QAAgC;AAChE,QAAM,YAAY,0BAA0B,MAAM;AAClD,SAAO,OAAO,gBAAgB,gBAAgB,UAAU,SAAS;AACnE;AAKO,SAAS,eAAe,QAA6B;AAC1D,QAAM,YAAY,0BAA0B,MAAM;AAElD,MAAI,UAAU,WAAW,GAAG;AAC1B,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/config/index.d.cts

@@ -0,0 +1,125 @@
+/**
+ * @nehorai/payments - Injectable Configuration
+ *
+ * Provides a framework-agnostic configuration interface that can be
+ * populated from any source (env vars, secrets manager, database, etc.).
+ *
+ * Usage:
+ * ```typescript
+ * // Option 1: Create from custom source
+ * const config = createConfig({
+ *   providers: {
+ *     stripe: { secretKey: 'sk_test_...' },
+ *   },
+ *   environment: 'sandbox',
+ *   defaultCurrency: 'USD',
+ * });
+ *
+ * // Option 2: Create from environment variables
+ * const config = createConfigFromEnv({
+ *   stripeSecretKey: 'STRIPE_SECRET_KEY',
+ *   stripePublishableKey: 'STRIPE_PUBLISHABLE_KEY',
+ *   stripeWebhookSecret: 'STRIPE_WEBHOOK_SECRET',
+ *   environment: 'PAYMENT_ENVIRONMENT',
+ *   defaultCurrency: 'DEFAULT_CURRENCY',
+ * });
+ * ```
+ */
+/**
+ * Generic provider configuration - key-value pairs
+ * Providers can have any config shape.
+ */
+interface ProviderConfig {
+    /** Provider-specific configuration values */
+    [key: string]: unknown;
+}
+/**
+ * Provider configurations map.
+ * Keys are provider names, values are provider-specific config.
+ */
+interface ProvidersConfig {
+    [providerName: string]: ProviderConfig | undefined;
+}
+/**
+ * Main payment configuration interface
+ *
+ * This is the injectable configuration that can be provided from any source.
+ */
+interface PaymentConfig {
+    /** Provider-specific configurations */
+    providers: ProvidersConfig;
+    /** Environment mode */
+    environment: 'sandbox' | 'production';
+    /** Default currency for transactions */
+    defaultCurrency: string;
+}
+/**
+ * Provider availability derived from configuration
+ */
+interface ConfiguredProviderAvailability {
+    [providerName: string]: boolean;
+}
+/**
+ * Mapping of provider config keys to environment variable names.
+ * Used by createConfigFromEnv().
+ */
+interface EnvVarMapping {
+    [envVarKey: string]: string;
+}
+/**
+ * Provider env var mapping: maps config keys to env var names
+ */
+interface ProviderEnvMapping {
+    providerName: string;
+    /** Map of config key -> env var name. Provider is considered configured if any key has a value. */
+    keys: EnvVarMapping;
+    /** Keys that are all required for the provider to be considered configured */
+    requiredKeys?: string[];
+}
+/**
+ * Full env mapping configuration
+ */
+interface EnvMappingConfig {
+    providers: ProviderEnvMapping[];
+    environmentVar?: string;
+    defaultCurrencyVar?: string;
+}
+/**
+ * Create payment configuration from environment variables
+ *
+ * @param mapping - Mapping of config keys to env var names
+ * @returns PaymentConfig populated from process.env
+ */
+declare function createConfigFromEnv(mapping?: EnvMappingConfig): PaymentConfig;
+/**
+ * Create payment configuration from a custom source
+ *
+ * @param config - Custom configuration object
+ * @returns Validated PaymentConfig
+ */
+declare function createConfig(config: PaymentConfig): PaymentConfig;
+/**
+ * Create a partial configuration (useful for testing)
+ *
+ * @param partial - Partial configuration
+ * @returns Full configuration with defaults
+ */
+declare function createPartialConfig(partial: Partial<PaymentConfig>): PaymentConfig;
+/**
+ * Check which providers are configured
+ */
+declare function getConfiguredProviders(config: PaymentConfig): ConfiguredProviderAvailability;
+/**
+ * Get list of configured provider names
+ */
+declare function getConfiguredProviderList(config: PaymentConfig): string[];
+/**
+ * Check if configuration is valid for production
+ */
+declare function isProductionReady(config: PaymentConfig): boolean;
+/**
+ * Validate configuration has at least one provider
+ */
+declare function validateConfig(config: PaymentConfig): void;
+
+export { type ConfiguredProviderAvailability, type EnvMappingConfig, type EnvVarMapping, type PaymentConfig, type ProviderConfig, type ProviderEnvMapping, type ProvidersConfig, createConfig, createConfigFromEnv, createPartialConfig, getConfiguredProviderList, getConfiguredProviders, isProductionReady, validateConfig };

package/dist/config/index.d.ts

@@ -0,0 +1,125 @@
+/**
+ * @nehorai/payments - Injectable Configuration
+ *
+ * Provides a framework-agnostic configuration interface that can be
+ * populated from any source (env vars, secrets manager, database, etc.).
+ *
+ * Usage:
+ * ```typescript
+ * // Option 1: Create from custom source
+ * const config = createConfig({
+ *   providers: {
+ *     stripe: { secretKey: 'sk_test_...' },
+ *   },
+ *   environment: 'sandbox',
+ *   defaultCurrency: 'USD',
+ * });
+ *
+ * // Option 2: Create from environment variables
+ * const config = createConfigFromEnv({
+ *   stripeSecretKey: 'STRIPE_SECRET_KEY',
+ *   stripePublishableKey: 'STRIPE_PUBLISHABLE_KEY',
+ *   stripeWebhookSecret: 'STRIPE_WEBHOOK_SECRET',
+ *   environment: 'PAYMENT_ENVIRONMENT',
+ *   defaultCurrency: 'DEFAULT_CURRENCY',
+ * });
+ * ```
+ */
+/**
+ * Generic provider configuration - key-value pairs
+ * Providers can have any config shape.
+ */
+interface ProviderConfig {
+    /** Provider-specific configuration values */
+    [key: string]: unknown;
+}
+/**
+ * Provider configurations map.
+ * Keys are provider names, values are provider-specific config.
+ */
+interface ProvidersConfig {
+    [providerName: string]: ProviderConfig | undefined;
+}
+/**
+ * Main payment configuration interface
+ *
+ * This is the injectable configuration that can be provided from any source.
+ */
+interface PaymentConfig {
+    /** Provider-specific configurations */
+    providers: ProvidersConfig;
+    /** Environment mode */
+    environment: 'sandbox' | 'production';
+    /** Default currency for transactions */
+    defaultCurrency: string;
+}
+/**
+ * Provider availability derived from configuration
+ */
+interface ConfiguredProviderAvailability {
+    [providerName: string]: boolean;
+}
+/**
+ * Mapping of provider config keys to environment variable names.
+ * Used by createConfigFromEnv().
+ */
+interface EnvVarMapping {
+    [envVarKey: string]: string;
+}
+/**
+ * Provider env var mapping: maps config keys to env var names
+ */
+interface ProviderEnvMapping {
+    providerName: string;
+    /** Map of config key -> env var name. Provider is considered configured if any key has a value. */
+    keys: EnvVarMapping;
+    /** Keys that are all required for the provider to be considered configured */
+    requiredKeys?: string[];
+}
+/**
+ * Full env mapping configuration
+ */
+interface EnvMappingConfig {
+    providers: ProviderEnvMapping[];
+    environmentVar?: string;
+    defaultCurrencyVar?: string;
+}
+/**
+ * Create payment configuration from environment variables
+ *
+ * @param mapping - Mapping of config keys to env var names
+ * @returns PaymentConfig populated from process.env
+ */
+declare function createConfigFromEnv(mapping?: EnvMappingConfig): PaymentConfig;
+/**
+ * Create payment configuration from a custom source
+ *
+ * @param config - Custom configuration object
+ * @returns Validated PaymentConfig
+ */
+declare function createConfig(config: PaymentConfig): PaymentConfig;
+/**
+ * Create a partial configuration (useful for testing)
+ *
+ * @param partial - Partial configuration
+ * @returns Full configuration with defaults
+ */
+declare function createPartialConfig(partial: Partial<PaymentConfig>): PaymentConfig;
+/**
+ * Check which providers are configured
+ */
+declare function getConfiguredProviders(config: PaymentConfig): ConfiguredProviderAvailability;
+/**
+ * Get list of configured provider names
+ */
+declare function getConfiguredProviderList(config: PaymentConfig): string[];
+/**
+ * Check if configuration is valid for production
+ */
+declare function isProductionReady(config: PaymentConfig): boolean;
+/**
+ * Validate configuration has at least one provider
+ */
+declare function validateConfig(config: PaymentConfig): void;
+
+export { type ConfiguredProviderAvailability, type EnvMappingConfig, type EnvVarMapping, type PaymentConfig, type ProviderConfig, type ProviderEnvMapping, type ProvidersConfig, createConfig, createConfigFromEnv, createPartialConfig, getConfiguredProviderList, getConfiguredProviders, isProductionReady, validateConfig };

package/dist/config/index.js

@@ -0,0 +1,83 @@
+// src/config/payment-config.ts
+function createConfigFromEnv(mapping) {
+  if (!mapping) {
+    return createPartialConfig({});
+  }
+  const providers = {};
+  for (const providerMapping of mapping.providers) {
+    const config = {};
+    let hasValue = false;
+    for (const [configKey, envVarName] of Object.entries(providerMapping.keys)) {
+      const value = process.env[envVarName];
+      if (value?.trim()) {
+        config[configKey] = value;
+        hasValue = true;
+      }
+    }
+    if (providerMapping.requiredKeys) {
+      const allRequired = providerMapping.requiredKeys.every(
+        (key) => config[key] && typeof config[key] === "string" && config[key].trim()
+      );
+      if (allRequired) {
+        providers[providerMapping.providerName] = config;
+      }
+    } else if (hasValue) {
+      providers[providerMapping.providerName] = config;
+    }
+  }
+  const environment = process.env[mapping.environmentVar ?? "PAYMENT_ENVIRONMENT"] ?? "sandbox";
+  const defaultCurrency = process.env[mapping.defaultCurrencyVar ?? "DEFAULT_CURRENCY"] ?? "USD";
+  return {
+    providers,
+    environment,
+    defaultCurrency
+  };
+}
+function createConfig(config) {
+  validateConfig(config);
+  return {
+    providers: { ...config.providers },
+    environment: config.environment,
+    defaultCurrency: config.defaultCurrency
+  };
+}
+function createPartialConfig(partial) {
+  return {
+    providers: partial.providers ?? {},
+    environment: partial.environment ?? "sandbox",
+    defaultCurrency: partial.defaultCurrency ?? "USD"
+  };
+}
+function getConfiguredProviders(config) {
+  const availability = {};
+  for (const [name, providerConfig] of Object.entries(config.providers)) {
+    availability[name] = providerConfig !== void 0 && Object.keys(providerConfig).length > 0;
+  }
+  return availability;
+}
+function getConfiguredProviderList(config) {
+  const availability = getConfiguredProviders(config);
+  return Object.entries(availability).filter(([, isAvailable]) => isAvailable).map(([name]) => name);
+}
+function isProductionReady(config) {
+  const providers = getConfiguredProviderList(config);
+  return config.environment === "production" && providers.length > 0;
+}
+function validateConfig(config) {
+  const providers = getConfiguredProviderList(config);
+  if (providers.length === 0) {
+    throw new Error(
+      "Payment configuration error: At least one payment provider must be configured"
+    );
+  }
+}
+export {
+  createConfig,
+  createConfigFromEnv,
+  createPartialConfig,
+  getConfiguredProviderList,
+  getConfiguredProviders,
+  isProductionReady,
+  validateConfig
+};
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/config/payment-config.ts"],"sourcesContent":["/**\r\n * @nehorai/payments - Injectable Configuration\r\n *\r\n * Provides a framework-agnostic configuration interface that can be\r\n * populated from any source (env vars, secrets manager, database, etc.).\r\n *\r\n * Usage:\r\n * ```typescript\r\n * // Option 1: Create from custom source\r\n * const config = createConfig({\r\n *   providers: {\r\n *     stripe: { secretKey: 'sk_test_...' },\r\n *   },\r\n *   environment: 'sandbox',\r\n *   defaultCurrency: 'USD',\r\n * });\r\n *\r\n * // Option 2: Create from environment variables\r\n * const config = createConfigFromEnv({\r\n *   stripeSecretKey: 'STRIPE_SECRET_KEY',\r\n *   stripePublishableKey: 'STRIPE_PUBLISHABLE_KEY',\r\n *   stripeWebhookSecret: 'STRIPE_WEBHOOK_SECRET',\r\n *   environment: 'PAYMENT_ENVIRONMENT',\r\n *   defaultCurrency: 'DEFAULT_CURRENCY',\r\n * });\r\n * ```\r\n */\r\n\r\n// ============================================================================\r\n// Provider Configuration Types\r\n// ============================================================================\r\n\r\n/**\r\n * Generic provider configuration - key-value pairs\r\n * Providers can have any config shape.\r\n */\r\nexport interface ProviderConfig {\r\n  /** Provider-specific configuration values */\r\n  [key: string]: unknown\r\n}\r\n\r\n/**\r\n * Provider configurations map.\r\n * Keys are provider names, values are provider-specific config.\r\n */\r\nexport interface ProvidersConfig {\r\n  [providerName: string]: ProviderConfig | undefined\r\n}\r\n\r\n/**\r\n * Main payment configuration interface\r\n *\r\n * This is the injectable configuration that can be provided from any source.\r\n */\r\nexport interface PaymentConfig {\r\n  /** Provider-specific configurations */\r\n  providers: ProvidersConfig\r\n  /** Environment mode */\r\n  environment: 'sandbox' | 'production'\r\n  /** Default currency for transactions */\r\n  defaultCurrency: string\r\n}\r\n\r\n/**\r\n * Provider availability derived from configuration\r\n */\r\nexport interface ConfiguredProviderAvailability {\r\n  [providerName: string]: boolean\r\n}\r\n\r\n// ============================================================================\r\n// Environment Variable Mapping\r\n// ============================================================================\r\n\r\n/**\r\n * Mapping of provider config keys to environment variable names.\r\n * Used by createConfigFromEnv().\r\n */\r\nexport interface EnvVarMapping {\r\n  [envVarKey: string]: string\r\n}\r\n\r\n/**\r\n * Provider env var mapping: maps config keys to env var names\r\n */\r\nexport interface ProviderEnvMapping {\r\n  providerName: string\r\n  /** Map of config key -> env var name. Provider is considered configured if any key has a value. */\r\n  keys: EnvVarMapping\r\n  /** Keys that are all required for the provider to be considered configured */\r\n  requiredKeys?: string[]\r\n}\r\n\r\n/**\r\n * Full env mapping configuration\r\n */\r\nexport interface EnvMappingConfig {\r\n  providers: ProviderEnvMapping[]\r\n  environmentVar?: string\r\n  defaultCurrencyVar?: string\r\n}\r\n\r\n// ============================================================================\r\n// Configuration Factory Functions\r\n// ============================================================================\r\n\r\n/**\r\n * Create payment configuration from environment variables\r\n *\r\n * @param mapping - Mapping of config keys to env var names\r\n * @returns PaymentConfig populated from process.env\r\n */\r\nexport function createConfigFromEnv(mapping?: EnvMappingConfig): PaymentConfig {\r\n  if (!mapping) {\r\n    return createPartialConfig({})\r\n  }\r\n\r\n  const providers: ProvidersConfig = {}\r\n\r\n  for (const providerMapping of mapping.providers) {\r\n    const config: ProviderConfig = {}\r\n    let hasValue = false\r\n\r\n    for (const [configKey, envVarName] of Object.entries(providerMapping.keys)) {\r\n      const value = process.env[envVarName]\r\n      if (value?.trim()) {\r\n        config[configKey] = value\r\n        hasValue = true\r\n      }\r\n    }\r\n\r\n    // Check if required keys are all present\r\n    if (providerMapping.requiredKeys) {\r\n      const allRequired = providerMapping.requiredKeys.every(\r\n        (key) => config[key] && typeof config[key] === 'string' && (config[key] as string).trim()\r\n      )\r\n      if (allRequired) {\r\n        providers[providerMapping.providerName] = config\r\n      }\r\n    } else if (hasValue) {\r\n      providers[providerMapping.providerName] = config\r\n    }\r\n  }\r\n\r\n  const environment = (process.env[mapping.environmentVar ?? 'PAYMENT_ENVIRONMENT'] as 'sandbox' | 'production') ?? 'sandbox'\r\n  const defaultCurrency = process.env[mapping.defaultCurrencyVar ?? 'DEFAULT_CURRENCY'] ?? 'USD'\r\n\r\n  return {\r\n    providers,\r\n    environment,\r\n    defaultCurrency,\r\n  }\r\n}\r\n\r\n/**\r\n * Create payment configuration from a custom source\r\n *\r\n * @param config - Custom configuration object\r\n * @returns Validated PaymentConfig\r\n */\r\nexport function createConfig(config: PaymentConfig): PaymentConfig {\r\n  validateConfig(config)\r\n  return {\r\n    providers: { ...config.providers },\r\n    environment: config.environment,\r\n    defaultCurrency: config.defaultCurrency,\r\n  }\r\n}\r\n\r\n/**\r\n * Create a partial configuration (useful for testing)\r\n *\r\n * @param partial - Partial configuration\r\n * @returns Full configuration with defaults\r\n */\r\nexport function createPartialConfig(partial: Partial<PaymentConfig>): PaymentConfig {\r\n  return {\r\n    providers: partial.providers ?? {},\r\n    environment: partial.environment ?? 'sandbox',\r\n    defaultCurrency: partial.defaultCurrency ?? 'USD',\r\n  }\r\n}\r\n\r\n// ============================================================================\r\n// Configuration Utilities\r\n// ============================================================================\r\n\r\n/**\r\n * Check which providers are configured\r\n */\r\nexport function getConfiguredProviders(config: PaymentConfig): ConfiguredProviderAvailability {\r\n  const availability: ConfiguredProviderAvailability = {}\r\n\r\n  for (const [name, providerConfig] of Object.entries(config.providers)) {\r\n    availability[name] = providerConfig !== undefined && Object.keys(providerConfig).length > 0\r\n  }\r\n\r\n  return availability\r\n}\r\n\r\n/**\r\n * Get list of configured provider names\r\n */\r\nexport function getConfiguredProviderList(config: PaymentConfig): string[] {\r\n  const availability = getConfiguredProviders(config)\r\n  return Object.entries(availability)\r\n    .filter(([, isAvailable]) => isAvailable)\r\n    .map(([name]) => name)\r\n}\r\n\r\n/**\r\n * Check if configuration is valid for production\r\n */\r\nexport function isProductionReady(config: PaymentConfig): boolean {\r\n  const providers = getConfiguredProviderList(config)\r\n  return config.environment === 'production' && providers.length > 0\r\n}\r\n\r\n/**\r\n * Validate configuration has at least one provider\r\n */\r\nexport function validateConfig(config: PaymentConfig): void {\r\n  const providers = getConfiguredProviderList(config)\r\n\r\n  if (providers.length === 0) {\r\n    throw new Error(\r\n      'Payment configuration error: At least one payment provider must be configured'\r\n    )\r\n  }\r\n}\r\n"],"mappings":";AAgHO,SAAS,oBAAoB,SAA2C;AAC7E,MAAI,CAAC,SAAS;AACZ,WAAO,oBAAoB,CAAC,CAAC;AAAA,EAC/B;AAEA,QAAM,YAA6B,CAAC;AAEpC,aAAW,mBAAmB,QAAQ,WAAW;AAC/C,UAAM,SAAyB,CAAC;AAChC,QAAI,WAAW;AAEf,eAAW,CAAC,WAAW,UAAU,KAAK,OAAO,QAAQ,gBAAgB,IAAI,GAAG;AAC1E,YAAM,QAAQ,QAAQ,IAAI,UAAU;AACpC,UAAI,OAAO,KAAK,GAAG;AACjB,eAAO,SAAS,IAAI;AACpB,mBAAW;AAAA,MACb;AAAA,IACF;AAGA,QAAI,gBAAgB,cAAc;AAChC,YAAM,cAAc,gBAAgB,aAAa;AAAA,QAC/C,CAAC,QAAQ,OAAO,GAAG,KAAK,OAAO,OAAO,GAAG,MAAM,YAAa,OAAO,GAAG,EAAa,KAAK;AAAA,MAC1F;AACA,UAAI,aAAa;AACf,kBAAU,gBAAgB,YAAY,IAAI;AAAA,MAC5C;AAAA,IACF,WAAW,UAAU;AACnB,gBAAU,gBAAgB,YAAY,IAAI;AAAA,IAC5C;AAAA,EACF;AAEA,QAAM,cAAe,QAAQ,IAAI,QAAQ,kBAAkB,qBAAqB,KAAkC;AAClH,QAAM,kBAAkB,QAAQ,IAAI,QAAQ,sBAAsB,kBAAkB,KAAK;AAEzF,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAQO,SAAS,aAAa,QAAsC;AACjE,iBAAe,MAAM;AACrB,SAAO;AAAA,IACL,WAAW,EAAE,GAAG,OAAO,UAAU;AAAA,IACjC,aAAa,OAAO;AAAA,IACpB,iBAAiB,OAAO;AAAA,EAC1B;AACF;AAQO,SAAS,oBAAoB,SAAgD;AAClF,SAAO;AAAA,IACL,WAAW,QAAQ,aAAa,CAAC;AAAA,IACjC,aAAa,QAAQ,eAAe;AAAA,IACpC,iBAAiB,QAAQ,mBAAmB;AAAA,EAC9C;AACF;AASO,SAAS,uBAAuB,QAAuD;AAC5F,QAAM,eAA+C,CAAC;AAEtD,aAAW,CAAC,MAAM,cAAc,KAAK,OAAO,QAAQ,OAAO,SAAS,GAAG;AACrE,iBAAa,IAAI,IAAI,mBAAmB,UAAa,OAAO,KAAK,cAAc,EAAE,SAAS;AAAA,EAC5F;AAEA,SAAO;AACT;AAKO,SAAS,0BAA0B,QAAiC;AACzE,QAAM,eAAe,uBAAuB,MAAM;AAClD,SAAO,OAAO,QAAQ,YAAY,EAC/B,OAAO,CAAC,CAAC,EAAE,WAAW,MAAM,WAAW,EACvC,IAAI,CAAC,CAAC,IAAI,MAAM,IAAI;AACzB;AAKO,SAAS,kBAAkB,QAAgC;AAChE,QAAM,YAAY,0BAA0B,MAAM;AAClD,SAAO,OAAO,gBAAgB,gBAAgB,UAAU,SAAS;AACnE;AAKO,SAAS,eAAe,QAA6B;AAC1D,QAAM,YAAY,0BAA0B,MAAM;AAElD,MAAI,UAAU,WAAW,GAAG;AAC1B,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACF;","names":[]}