@misterhomer1992/miit-bot-payment 1.1.7 → 2.0.4

package/dist/config/ConfigurationManager.d.ts

@@ -0,0 +1,64 @@
+import type { PackageConfig, PartialPackageConfig, WayForPayConfig, CacheConfig, GracePeriodConfig } from './types';
+/**
+ * ConfigurationManager provides centralized configuration management for the package.
+ * Supports environment-based configuration with programmatic overrides.
+ */
+export declare class ConfigurationManager {
+    private static instance;
+    private config;
+    private initialized;
+    private constructor();
+    /**
+     * Gets the singleton instance of ConfigurationManager.
+     */
+    static getInstance(): ConfigurationManager;
+    /**
+     * Resets the singleton instance (useful for testing).
+     */
+    static resetInstance(): void;
+    /**
+     * Initializes the configuration with optional overrides.
+     * Should be called once at application startup.
+     */
+    initialize(overrides?: PartialPackageConfig): void;
+    /**
+     * Checks if the configuration has been explicitly initialized.
+     */
+    isInitialized(): boolean;
+    /**
+     * Gets the complete configuration.
+     */
+    getConfig(): PackageConfig;
+    /**
+     * Gets WayForPay configuration.
+     */
+    getWayForPayConfig(): WayForPayConfig;
+    /**
+     * Gets cache configuration.
+     */
+    getCacheConfig(): CacheConfig;
+    /**
+     * Gets grace period configuration.
+     */
+    getGracePeriodConfig(): GracePeriodConfig;
+    /**
+     * Updates configuration at runtime.
+     */
+    updateConfig(overrides: PartialPackageConfig): void;
+    /**
+     * Validates that required WayForPay credentials are present.
+     */
+    validateWayForPayConfig(): {
+        valid: boolean;
+        missingFields: string[];
+    };
+    /**
+     * Loads default configuration from environment and defaults.
+     */
+    private loadDefaultConfig;
+    /**
+     * Merges configuration with overrides.
+     */
+    private mergeConfig;
+}
+//# sourceMappingURL=ConfigurationManager.d.ts.map

package/dist/config/ConfigurationManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigurationManager.d.ts","sourceRoot":"","sources":["../../src/config/ConfigurationManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,eAAe,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAIpH;;;GAGG;AACH,qBAAa,oBAAoB;IAC7B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAqC;IAC5D,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,WAAW,CAAkB;IAErC,OAAO;IAIP;;OAEG;WACW,WAAW,IAAI,oBAAoB;IAOjD;;OAEG;WACW,aAAa,IAAI,IAAI;IAInC;;;OAGG;IACI,UAAU,CAAC,SAAS,CAAC,EAAE,oBAAoB,GAAG,IAAI;IAKzD;;OAEG;IACI,aAAa,IAAI,OAAO;IAI/B;;OAEG;IACI,SAAS,IAAI,aAAa;IAIjC;;OAEG;IACI,kBAAkB,IAAI,eAAe;IAI5C;;OAEG;IACI,cAAc,IAAI,WAAW;IAIpC;;OAEG;IACI,oBAAoB,IAAI,iBAAiB;IAIhD;;OAEG;IACI,YAAY,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI;IAI1D;;OAEG;IACI,uBAAuB,IAAI;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,aAAa,EAAE,MAAM,EAAE,CAAA;KAAE;IAoB7E;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAwBzB;;OAEG;IACH,OAAO,CAAC,WAAW;CAoBtB"}

package/dist/config/ConfigurationManager.js

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigurationManager = void 0;
+const defaults_1 = require("./defaults");
+const environment_1 = require("./environment");
+/**
+ * ConfigurationManager provides centralized configuration management for the package.
+ * Supports environment-based configuration with programmatic overrides.
+ */
+class ConfigurationManager {
+    constructor() {
+        this.initialized = false;
+        this.config = this.loadDefaultConfig();
+    }
+    /**
+     * Gets the singleton instance of ConfigurationManager.
+     */
+    static getInstance() {
+        if (!ConfigurationManager.instance) {
+            ConfigurationManager.instance = new ConfigurationManager();
+        }
+        return ConfigurationManager.instance;
+    }
+    /**
+     * Resets the singleton instance (useful for testing).
+     */
+    static resetInstance() {
+        ConfigurationManager.instance = null;
+    }
+    /**
+     * Initializes the configuration with optional overrides.
+     * Should be called once at application startup.
+     */
+    initialize(overrides) {
+        this.config = this.mergeConfig(this.loadDefaultConfig(), overrides);
+        this.initialized = true;
+    }
+    /**
+     * Checks if the configuration has been explicitly initialized.
+     */
+    isInitialized() {
+        return this.initialized;
+    }
+    /**
+     * Gets the complete configuration.
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Gets WayForPay configuration.
+     */
+    getWayForPayConfig() {
+        return { ...this.config.wayforpay };
+    }
+    /**
+     * Gets cache configuration.
+     */
+    getCacheConfig() {
+        return { ...this.config.cache };
+    }
+    /**
+     * Gets grace period configuration.
+     */
+    getGracePeriodConfig() {
+        return { ...this.config.gracePeriod };
+    }
+    /**
+     * Updates configuration at runtime.
+     */
+    updateConfig(overrides) {
+        this.config = this.mergeConfig(this.config, overrides);
+    }
+    /**
+     * Validates that required WayForPay credentials are present.
+     */
+    validateWayForPayConfig() {
+        const missingFields = [];
+        const { wayforpay } = this.config;
+        if (!wayforpay.merchantAccount) {
+            missingFields.push('merchantAccount');
+        }
+        if (!wayforpay.merchantSecretKey) {
+            missingFields.push('merchantSecretKey');
+        }
+        if (!wayforpay.merchantDomainName) {
+            missingFields.push('merchantDomainName');
+        }
+        return {
+            valid: missingFields.length === 0,
+            missingFields,
+        };
+    }
+    /**
+     * Loads default configuration from environment and defaults.
+     */
+    loadDefaultConfig() {
+        const envWayForPay = (0, environment_1.loadWayForPayConfigFromEnv)();
+        const envCache = (0, environment_1.loadCacheConfigFromEnv)();
+        const envGracePeriod = (0, environment_1.loadGracePeriodConfigFromEnv)();
+        return {
+            wayforpay: {
+                merchantAccount: envWayForPay.merchantAccount ?? '',
+                merchantSecretKey: envWayForPay.merchantSecretKey ?? '',
+                merchantDomainName: envWayForPay.merchantDomainName ?? '',
+                serviceUrl: envWayForPay.serviceUrl,
+                merchantPassword: envWayForPay.merchantPassword,
+            },
+            cache: {
+                ttlMs: envCache.ttlMs ?? defaults_1.DEFAULT_CACHE_CONFIG.ttlMs,
+                maxSize: envCache.maxSize ?? defaults_1.DEFAULT_CACHE_CONFIG.maxSize,
+            },
+            gracePeriod: {
+                durationMs: envGracePeriod.durationMs ?? defaults_1.DEFAULT_GRACE_PERIOD_CONFIG.durationMs,
+                enabled: envGracePeriod.enabled ?? defaults_1.DEFAULT_GRACE_PERIOD_CONFIG.enabled,
+            },
+        };
+    }
+    /**
+     * Merges configuration with overrides.
+     */
+    mergeConfig(base, overrides) {
+        if (!overrides) {
+            return base;
+        }
+        return {
+            wayforpay: {
+                ...base.wayforpay,
+                ...overrides.wayforpay,
+            },
+            cache: {
+                ...base.cache,
+                ...overrides.cache,
+            },
+            gracePeriod: {
+                ...base.gracePeriod,
+                ...overrides.gracePeriod,
+            },
+        };
+    }
+}
+exports.ConfigurationManager = ConfigurationManager;
+ConfigurationManager.instance = null;
+//# sourceMappingURL=ConfigurationManager.js.map

package/dist/config/ConfigurationManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigurationManager.js","sourceRoot":"","sources":["../../src/config/ConfigurationManager.ts"],"names":[],"mappings":";;;AACA,yCAA+E;AAC/E,+CAAiH;AAEjH;;;GAGG;AACH,MAAa,oBAAoB;IAK7B;QAFQ,gBAAW,GAAY,KAAK,CAAC;QAGjC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;IAC3C,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,WAAW;QACrB,IAAI,CAAC,oBAAoB,CAAC,QAAQ,EAAE,CAAC;YACjC,oBAAoB,CAAC,QAAQ,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC/D,CAAC;QACD,OAAO,oBAAoB,CAAC,QAAQ,CAAC;IACzC,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,aAAa;QACvB,oBAAoB,CAAC,QAAQ,GAAG,IAAI,CAAC;IACzC,CAAC;IAED;;;OAGG;IACI,UAAU,CAAC,SAAgC;QAC9C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,SAAS,CAAC,CAAC;QACpE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC5B,CAAC;IAED;;OAEG;IACI,aAAa;QAChB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;IAED;;OAEG;IACI,SAAS;QACZ,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC9B,CAAC;IAED;;OAEG;IACI,kBAAkB;QACrB,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;IACxC,CAAC;IAED;;OAEG;IACI,cAAc;QACjB,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACpC,CAAC;IAED;;OAEG;IACI,oBAAoB;QACvB,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;IAC1C,CAAC;IAED;;OAEG;IACI,YAAY,CAAC,SAA+B;QAC/C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACI,uBAAuB;QAC1B,MAAM,aAAa,GAAa,EAAE,CAAC;QACnC,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QAElC,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC;YAC7B,aAAa,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC1C,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,iBAAiB,EAAE,CAAC;YAC/B,aAAa,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,kBAAkB,EAAE,CAAC;YAChC,aAAa,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAC7C,CAAC;QAED,OAAO;YACH,KAAK,EAAE,aAAa,CAAC,MAAM,KAAK,CAAC;YACjC,aAAa;SAChB,CAAC;IACN,CAAC;IAED;;OAEG;IACK,iBAAiB;QACrB,MAAM,YAAY,GAAG,IAAA,wCAA0B,GAAE,CAAC;QAClD,MAAM,QAAQ,GAAG,IAAA,oCAAsB,GAAE,CAAC;QAC1C,MAAM,cAAc,GAAG,IAAA,0CAA4B,GAAE,CAAC;QAEtD,OAAO;YACH,SAAS,EAAE;gBACP,eAAe,EAAE,YAAY,CAAC,eAAe,IAAI,EAAE;gBACnD,iBAAiB,EAAE,YAAY,CAAC,iBAAiB,IAAI,EAAE;gBACvD,kBAAkB,EAAE,YAAY,CAAC,kBAAkB,IAAI,EAAE;gBACzD,UAAU,EAAE,YAAY,CAAC,UAAU;gBACnC,gBAAgB,EAAE,YAAY,CAAC,gBAAgB;aAClD;YACD,KAAK,EAAE;gBACH,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,+BAAoB,CAAC,KAAK;gBACnD,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,+BAAoB,CAAC,OAAO;aAC5D;YACD,WAAW,EAAE;gBACT,UAAU,EAAE,cAAc,CAAC,UAAU,IAAI,sCAA2B,CAAC,UAAU;gBAC/E,OAAO,EAAE,cAAc,CAAC,OAAO,IAAI,sCAA2B,CAAC,OAAO;aACzE;SACJ,CAAC;IACN,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,IAAmB,EAAE,SAAgC;QACrE,IAAI,CAAC,SAAS,EAAE,CAAC;YACb,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,OAAO;YACH,SAAS,EAAE;gBACP,GAAG,IAAI,CAAC,SAAS;gBACjB,GAAG,SAAS,CAAC,SAAS;aACzB;YACD,KAAK,EAAE;gBACH,GAAG,IAAI,CAAC,KAAK;gBACb,GAAG,SAAS,CAAC,KAAK;aACrB;YACD,WAAW,EAAE;gBACT,GAAG,IAAI,CAAC,WAAW;gBACnB,GAAG,SAAS,CAAC,WAAW;aAC3B;SACJ,CAAC;IACN,CAAC;;AArJL,oDAsJC;AArJkB,6BAAQ,GAAgC,IAAI,AAApC,CAAqC"}

package/dist/config/defaults.d.ts

@@ -0,0 +1,18 @@
+import type { CacheConfig, GracePeriodConfig } from './types';
+/**
+ * Default cache TTL: 20 hours in milliseconds.
+ */
+export declare const DEFAULT_CACHE_TTL_MS: number;
+/**
+ * Default cache configuration.
+ */
+export declare const DEFAULT_CACHE_CONFIG: CacheConfig;
+/**
+ * Default grace period: 3 days in milliseconds.
+ */
+export declare const DEFAULT_GRACE_PERIOD_MS: number;
+/**
+ * Default grace period configuration.
+ */
+export declare const DEFAULT_GRACE_PERIOD_CONFIG: GracePeriodConfig;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/config/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,oBAAoB,QAAsB,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAGlC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,QAA0B,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,iBAGzC,CAAC"}

package/dist/config/defaults.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_GRACE_PERIOD_CONFIG = exports.DEFAULT_GRACE_PERIOD_MS = exports.DEFAULT_CACHE_CONFIG = exports.DEFAULT_CACHE_TTL_MS = void 0;
+/**
+ * Default cache TTL: 20 hours in milliseconds.
+ */
+exports.DEFAULT_CACHE_TTL_MS = 20 * 60 * 60 * 1000;
+/**
+ * Default cache configuration.
+ */
+exports.DEFAULT_CACHE_CONFIG = {
+    ttlMs: exports.DEFAULT_CACHE_TTL_MS,
+    maxSize: undefined,
+};
+/**
+ * Default grace period: 3 days in milliseconds.
+ */
+exports.DEFAULT_GRACE_PERIOD_MS = 3 * 24 * 60 * 60 * 1000;
+/**
+ * Default grace period configuration.
+ */
+exports.DEFAULT_GRACE_PERIOD_CONFIG = {
+    durationMs: exports.DEFAULT_GRACE_PERIOD_MS,
+    enabled: true,
+};
+//# sourceMappingURL=defaults.js.map

package/dist/config/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":";;;AAEA;;GAEG;AACU,QAAA,oBAAoB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAExD;;GAEG;AACU,QAAA,oBAAoB,GAAgB;IAC7C,KAAK,EAAE,4BAAoB;IAC3B,OAAO,EAAE,SAAS;CACrB,CAAC;AAEF;;GAEG;AACU,QAAA,uBAAuB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAE/D;;GAEG;AACU,QAAA,2BAA2B,GAAsB;IAC1D,UAAU,EAAE,+BAAuB;IACnC,OAAO,EAAE,IAAI;CAChB,CAAC"}

package/dist/config/environment.d.ts

@@ -0,0 +1,38 @@
+import type { WayForPayConfig, CacheConfig, GracePeriodConfig } from './types';
+/**
+ * Environment variable names for WayForPay configuration.
+ */
+export declare const WAYFORPAY_ENV_VARS: {
+    readonly MERCHANT_ACCOUNT: "WAYFORPAY_MERCHANT_ACCOUNT";
+    readonly MERCHANT_SECRET_KEY: "WAYFORPAY_MERCHANT_SECRET_KEY";
+    readonly MERCHANT_DOMAIN: "WAYFORPAY_MERCHANT_DOMAIN";
+    readonly SERVICE_URL: "WAYFORPAY_SERVICE_URL";
+    readonly MERCHANT_PASSWORD: "WAYFORPAY_MERCHANT_PASSWORD";
+};
+/**
+ * Environment variable names for cache configuration.
+ */
+export declare const CACHE_ENV_VARS: {
+    readonly TTL_MS: "CACHE_TTL_MS";
+    readonly MAX_SIZE: "CACHE_MAX_SIZE";
+};
+/**
+ * Environment variable names for grace period configuration.
+ */
+export declare const GRACE_PERIOD_ENV_VARS: {
+    readonly DURATION_MS: "GRACE_PERIOD_DURATION_MS";
+    readonly ENABLED: "GRACE_PERIOD_ENABLED";
+};
+/**
+ * Loads WayForPay configuration from environment variables.
+ */
+export declare function loadWayForPayConfigFromEnv(): Partial<WayForPayConfig>;
+/**
+ * Loads cache configuration from environment variables.
+ */
+export declare function loadCacheConfigFromEnv(): Partial<CacheConfig>;
+/**
+ * Loads grace period configuration from environment variables.
+ */
+export declare function loadGracePeriodConfigFromEnv(): Partial<GracePeriodConfig>;
+//# sourceMappingURL=environment.d.ts.map

package/dist/config/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../src/config/environment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAG/E;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;CAMrB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc;;;CAGjB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;CAGxB,CAAC;AAiCX;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,OAAO,CAAC,eAAe,CAAC,CAQrE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAAC,WAAW,CAAC,CAK7D;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAMzE"}

package/dist/config/environment.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GRACE_PERIOD_ENV_VARS = exports.CACHE_ENV_VARS = exports.WAYFORPAY_ENV_VARS = void 0;
+exports.loadWayForPayConfigFromEnv = loadWayForPayConfigFromEnv;
+exports.loadCacheConfigFromEnv = loadCacheConfigFromEnv;
+exports.loadGracePeriodConfigFromEnv = loadGracePeriodConfigFromEnv;
+const defaults_1 = require("./defaults");
+/**
+ * Environment variable names for WayForPay configuration.
+ */
+exports.WAYFORPAY_ENV_VARS = {
+    MERCHANT_ACCOUNT: 'WAYFORPAY_MERCHANT_ACCOUNT',
+    MERCHANT_SECRET_KEY: 'WAYFORPAY_MERCHANT_SECRET_KEY',
+    MERCHANT_DOMAIN: 'WAYFORPAY_MERCHANT_DOMAIN',
+    SERVICE_URL: 'WAYFORPAY_SERVICE_URL',
+    MERCHANT_PASSWORD: 'WAYFORPAY_MERCHANT_PASSWORD',
+};
+/**
+ * Environment variable names for cache configuration.
+ */
+exports.CACHE_ENV_VARS = {
+    TTL_MS: 'CACHE_TTL_MS',
+    MAX_SIZE: 'CACHE_MAX_SIZE',
+};
+/**
+ * Environment variable names for grace period configuration.
+ */
+exports.GRACE_PERIOD_ENV_VARS = {
+    DURATION_MS: 'GRACE_PERIOD_DURATION_MS',
+    ENABLED: 'GRACE_PERIOD_ENABLED',
+};
+/**
+ * Gets a string environment variable value.
+ */
+function getEnvString(name) {
+    return process.env[name];
+}
+/**
+ * Gets a numeric environment variable value.
+ */
+function getEnvNumber(name) {
+    const value = process.env[name];
+    if (value === undefined || value === '') {
+        return undefined;
+    }
+    const parsed = parseInt(value, 10);
+    return isNaN(parsed) ? undefined : parsed;
+}
+/**
+ * Gets a boolean environment variable value.
+ * Accepts 'true', '1', 'yes' as truthy values.
+ */
+function getEnvBoolean(name) {
+    const value = process.env[name];
+    if (value === undefined || value === '') {
+        return undefined;
+    }
+    return ['true', '1', 'yes'].includes(value.toLowerCase());
+}
+/**
+ * Loads WayForPay configuration from environment variables.
+ */
+function loadWayForPayConfigFromEnv() {
+    return {
+        merchantAccount: getEnvString(exports.WAYFORPAY_ENV_VARS.MERCHANT_ACCOUNT),
+        merchantSecretKey: getEnvString(exports.WAYFORPAY_ENV_VARS.MERCHANT_SECRET_KEY),
+        merchantDomainName: getEnvString(exports.WAYFORPAY_ENV_VARS.MERCHANT_DOMAIN),
+        serviceUrl: getEnvString(exports.WAYFORPAY_ENV_VARS.SERVICE_URL),
+        merchantPassword: getEnvString(exports.WAYFORPAY_ENV_VARS.MERCHANT_PASSWORD),
+    };
+}
+/**
+ * Loads cache configuration from environment variables.
+ */
+function loadCacheConfigFromEnv() {
+    return {
+        ttlMs: getEnvNumber(exports.CACHE_ENV_VARS.TTL_MS) ?? defaults_1.DEFAULT_CACHE_TTL_MS,
+        maxSize: getEnvNumber(exports.CACHE_ENV_VARS.MAX_SIZE),
+    };
+}
+/**
+ * Loads grace period configuration from environment variables.
+ */
+function loadGracePeriodConfigFromEnv() {
+    const enabled = getEnvBoolean(exports.GRACE_PERIOD_ENV_VARS.ENABLED);
+    return {
+        durationMs: getEnvNumber(exports.GRACE_PERIOD_ENV_VARS.DURATION_MS) ?? defaults_1.DEFAULT_GRACE_PERIOD_MS,
+        enabled: enabled ?? true,
+    };
+}
+//# sourceMappingURL=environment.js.map

package/dist/config/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../src/config/environment.ts"],"names":[],"mappings":";;;AAgEA,gEAQC;AAKD,wDAKC;AAKD,oEAMC;AA5FD,yCAA2E;AAE3E;;GAEG;AACU,QAAA,kBAAkB,GAAG;IAC9B,gBAAgB,EAAE,4BAA4B;IAC9C,mBAAmB,EAAE,+BAA+B;IACpD,eAAe,EAAE,2BAA2B;IAC5C,WAAW,EAAE,uBAAuB;IACpC,iBAAiB,EAAE,6BAA6B;CAC1C,CAAC;AAEX;;GAEG;AACU,QAAA,cAAc,GAAG;IAC1B,MAAM,EAAE,cAAc;IACtB,QAAQ,EAAE,gBAAgB;CACpB,CAAC;AAEX;;GAEG;AACU,QAAA,qBAAqB,GAAG;IACjC,WAAW,EAAE,0BAA0B;IACvC,OAAO,EAAE,sBAAsB;CACzB,CAAC;AAEX;;GAEG;AACH,SAAS,YAAY,CAAC,IAAY;IAC9B,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,IAAY;IAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QACtC,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACnC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,SAAS,aAAa,CAAC,IAAY;IAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QACtC,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,SAAgB,0BAA0B;IACtC,OAAO;QACH,eAAe,EAAE,YAAY,CAAC,0BAAkB,CAAC,gBAAgB,CAAC;QAClE,iBAAiB,EAAE,YAAY,CAAC,0BAAkB,CAAC,mBAAmB,CAAC;QACvE,kBAAkB,EAAE,YAAY,CAAC,0BAAkB,CAAC,eAAe,CAAC;QACpE,UAAU,EAAE,YAAY,CAAC,0BAAkB,CAAC,WAAW,CAAC;QACxD,gBAAgB,EAAE,YAAY,CAAC,0BAAkB,CAAC,iBAAiB,CAAC;KACvE,CAAC;AACN,CAAC;AAED;;GAEG;AACH,SAAgB,sBAAsB;IAClC,OAAO;QACH,KAAK,EAAE,YAAY,CAAC,sBAAc,CAAC,MAAM,CAAC,IAAI,+BAAoB;QAClE,OAAO,EAAE,YAAY,CAAC,sBAAc,CAAC,QAAQ,CAAC;KACjD,CAAC;AACN,CAAC;AAED;;GAEG;AACH,SAAgB,4BAA4B;IACxC,MAAM,OAAO,GAAG,aAAa,CAAC,6BAAqB,CAAC,OAAO,CAAC,CAAC;IAC7D,OAAO;QACH,UAAU,EAAE,YAAY,CAAC,6BAAqB,CAAC,WAAW,CAAC,IAAI,kCAAuB;QACtF,OAAO,EAAE,OAAO,IAAI,IAAI;KAC3B,CAAC;AACN,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,5 @@
+export { ConfigurationManager } from './ConfigurationManager';
+export type { PackageConfig, PartialPackageConfig, WayForPayConfig, CacheConfig, GracePeriodConfig, } from './types';
+export { DEFAULT_CACHE_TTL_MS, DEFAULT_CACHE_CONFIG, DEFAULT_GRACE_PERIOD_MS, DEFAULT_GRACE_PERIOD_CONFIG, } from './defaults';
+export { WAYFORPAY_ENV_VARS, CACHE_ENV_VARS, GRACE_PERIOD_ENV_VARS, loadWayForPayConfigFromEnv, loadCacheConfigFromEnv, loadGracePeriodConfigFromEnv, } from './environment';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EACR,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,WAAW,EACX,iBAAiB,GACpB,MAAM,SAAS,CAAC;AACjB,OAAO,EACH,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,2BAA2B,GAC9B,MAAM,YAAY,CAAC;AACpB,OAAO,EACH,kBAAkB,EAClB,cAAc,EACd,qBAAqB,EACrB,0BAA0B,EAC1B,sBAAsB,EACtB,4BAA4B,GAC/B,MAAM,eAAe,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadGracePeriodConfigFromEnv = exports.loadCacheConfigFromEnv = exports.loadWayForPayConfigFromEnv = exports.GRACE_PERIOD_ENV_VARS = exports.CACHE_ENV_VARS = exports.WAYFORPAY_ENV_VARS = exports.DEFAULT_GRACE_PERIOD_CONFIG = exports.DEFAULT_GRACE_PERIOD_MS = exports.DEFAULT_CACHE_CONFIG = exports.DEFAULT_CACHE_TTL_MS = exports.ConfigurationManager = void 0;
+var ConfigurationManager_1 = require("./ConfigurationManager");
+Object.defineProperty(exports, "ConfigurationManager", { enumerable: true, get: function () { return ConfigurationManager_1.ConfigurationManager; } });
+var defaults_1 = require("./defaults");
+Object.defineProperty(exports, "DEFAULT_CACHE_TTL_MS", { enumerable: true, get: function () { return defaults_1.DEFAULT_CACHE_TTL_MS; } });
+Object.defineProperty(exports, "DEFAULT_CACHE_CONFIG", { enumerable: true, get: function () { return defaults_1.DEFAULT_CACHE_CONFIG; } });
+Object.defineProperty(exports, "DEFAULT_GRACE_PERIOD_MS", { enumerable: true, get: function () { return defaults_1.DEFAULT_GRACE_PERIOD_MS; } });
+Object.defineProperty(exports, "DEFAULT_GRACE_PERIOD_CONFIG", { enumerable: true, get: function () { return defaults_1.DEFAULT_GRACE_PERIOD_CONFIG; } });
+var environment_1 = require("./environment");
+Object.defineProperty(exports, "WAYFORPAY_ENV_VARS", { enumerable: true, get: function () { return environment_1.WAYFORPAY_ENV_VARS; } });
+Object.defineProperty(exports, "CACHE_ENV_VARS", { enumerable: true, get: function () { return environment_1.CACHE_ENV_VARS; } });
+Object.defineProperty(exports, "GRACE_PERIOD_ENV_VARS", { enumerable: true, get: function () { return environment_1.GRACE_PERIOD_ENV_VARS; } });
+Object.defineProperty(exports, "loadWayForPayConfigFromEnv", { enumerable: true, get: function () { return environment_1.loadWayForPayConfigFromEnv; } });
+Object.defineProperty(exports, "loadCacheConfigFromEnv", { enumerable: true, get: function () { return environment_1.loadCacheConfigFromEnv; } });
+Object.defineProperty(exports, "loadGracePeriodConfigFromEnv", { enumerable: true, get: function () { return environment_1.loadGracePeriodConfigFromEnv; } });
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":";;;AAAA,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA;AAQ7B,uCAKoB;AAJhB,gHAAA,oBAAoB,OAAA;AACpB,gHAAA,oBAAoB,OAAA;AACpB,mHAAA,uBAAuB,OAAA;AACvB,uHAAA,2BAA2B,OAAA;AAE/B,6CAOuB;AANnB,iHAAA,kBAAkB,OAAA;AAClB,6GAAA,cAAc,OAAA;AACd,oHAAA,qBAAqB,OAAA;AACrB,yHAAA,0BAA0B,OAAA;AAC1B,qHAAA,sBAAsB,OAAA;AACtB,2HAAA,4BAA4B,OAAA"}

package/dist/config/types.d.ts

@@ -0,0 +1,53 @@
+/**
+ * WayForPay payment provider credentials configuration.
+ */
+export interface WayForPayConfig {
+    /** Merchant account identifier from WayForPay dashboard */
+    merchantAccount: string;
+    /** Secret key for signing requests */
+    merchantSecretKey: string;
+    /** Merchant domain name registered with WayForPay */
+    merchantDomainName: string;
+    /** Optional service URL for webhook callbacks */
+    serviceUrl?: string;
+    /** Optional merchant password for edit operations */
+    merchantPassword?: string;
+}
+/**
+ * Cache configuration settings.
+ */
+export interface CacheConfig {
+    /** Default cache TTL in milliseconds */
+    ttlMs: number;
+    /** Optional maximum cache size (number of entries) */
+    maxSize?: number;
+}
+/**
+ * Subscription grace period configuration.
+ */
+export interface GracePeriodConfig {
+    /** Grace period duration in milliseconds after subscription expires */
+    durationMs: number;
+    /** Whether grace period is enabled */
+    enabled: boolean;
+}
+/**
+ * Complete package configuration.
+ */
+export interface PackageConfig {
+    /** WayForPay payment provider configuration */
+    wayforpay: WayForPayConfig;
+    /** Cache settings */
+    cache: CacheConfig;
+    /** Grace period settings for subscriptions */
+    gracePeriod: GracePeriodConfig;
+}
+/**
+ * Partial configuration for overriding defaults.
+ */
+export type PartialPackageConfig = {
+    wayforpay?: Partial<WayForPayConfig>;
+    cache?: Partial<CacheConfig>;
+    gracePeriod?: Partial<GracePeriodConfig>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/config/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,2DAA2D;IAC3D,eAAe,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qDAAqD;IACrD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,+CAA+C;IAC/C,SAAS,EAAE,eAAe,CAAC;IAC3B,qBAAqB;IACrB,KAAK,EAAE,WAAW,CAAC;IACnB,8CAA8C;IAC9C,WAAW,EAAE,iBAAiB,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAC/B,SAAS,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACrC,KAAK,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC5C,CAAC"}

package/dist/config/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -1,5 +1,26 @@
 export * from './modules/payments';
 export * from './modules/invoice';
 export * from './modules/subscription';
+export * from './modules/subscriptionPlan';
 export * from './modules/user';
+export * from './modules/tokenPack';
+export * from './modules/token';
+export * from './modules/cache';
+export * from './modules/errors';
+export * from './config';
+export declare const SUBSCRIPTION_STATUS: {
+    readonly ACTIVE: "active";
+    readonly EXPIRED: "expired";
+    readonly CANCELLED: "cancelled";
+};
+export declare const PAYMENT_STATUS: {
+    readonly PENDING: "pending";
+    readonly COMPLETED: "completed";
+    readonly FAILED: "failed";
+    readonly EXPIRED: "expired";
+};
+export declare const PAYMENT_TYPE: {
+    readonly SUBSCRIPTION: "subscription";
+    readonly TOKEN_PACK: "token_pack";
+};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AAGzB,eAAO,MAAM,mBAAmB;;;;CAItB,CAAC;AAEX,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC;AAEX,eAAO,MAAM,YAAY;;;CAGf,CAAC"}

package/dist/index.js

@@ -14,8 +14,31 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.PAYMENT_TYPE = exports.PAYMENT_STATUS = exports.SUBSCRIPTION_STATUS = void 0;
 __exportStar(require("./modules/payments"), exports);
 __exportStar(require("./modules/invoice"), exports);
 __exportStar(require("./modules/subscription"), exports);
+__exportStar(require("./modules/subscriptionPlan"), exports);
 __exportStar(require("./modules/user"), exports);
+__exportStar(require("./modules/tokenPack"), exports);
+__exportStar(require("./modules/token"), exports);
+__exportStar(require("./modules/cache"), exports);
+__exportStar(require("./modules/errors"), exports);
+__exportStar(require("./config"), exports);
+// Status constants for common use cases
+exports.SUBSCRIPTION_STATUS = {
+    ACTIVE: 'active',
+    EXPIRED: 'expired',
+    CANCELLED: 'cancelled',
+};
+exports.PAYMENT_STATUS = {
+    PENDING: 'pending',
+    COMPLETED: 'completed',
+    FAILED: 'failed',
+    EXPIRED: 'expired',
+};
+exports.PAYMENT_TYPE = {
+    SUBSCRIPTION: 'subscription',
+    TOKEN_PACK: 'token_pack',
+};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,oDAAkC;AAClC,yDAAuC;AACvC,iDAA+B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,oDAAkC;AAClC,yDAAuC;AACvC,6DAA2C;AAC3C,iDAA+B;AAC/B,sDAAoC;AACpC,kDAAgC;AAChC,kDAAgC;AAChC,mDAAiC;AACjC,2CAAyB;AAEzB,wCAAwC;AAC3B,QAAA,mBAAmB,GAAG;IAC/B,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;CAChB,CAAC;AAEE,QAAA,cAAc,GAAG;IAC1B,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;CACZ,CAAC;AAEE,QAAA,YAAY,GAAG;IACxB,YAAY,EAAE,cAAc;IAC5B,UAAU,EAAE,YAAY;CAClB,CAAC"}

package/dist/modules/cache/InMemoryCache.d.ts

@@ -0,0 +1,17 @@
+import { ICacheOptions, ICache } from './types';
+export declare class InMemoryCache<T> implements ICache<T> {
+    private readonly cache;
+    private readonly defaultTtl;
+    private readonly maxSize;
+    constructor(options: ICacheOptions);
+    get(key: string): T | undefined;
+    set(key: string, value: T, ttl?: number): void;
+    has(key: string): boolean;
+    delete(key: string): boolean;
+    clear(): void;
+    size(): number;
+    cleanup(): void;
+    private isExpired;
+    private evictOldest;
+}
+//# sourceMappingURL=InMemoryCache.d.ts.map

package/dist/modules/cache/InMemoryCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryCache.d.ts","sourceRoot":"","sources":["../../../src/modules/cache/InMemoryCache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,aAAa,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAE5D,qBAAa,aAAa,CAAC,CAAC,CAAE,YAAW,MAAM,CAAC,CAAC,CAAC;IAC9C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6B;IACnD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,aAAa;IAM3B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAe/B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAa9C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAezB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,MAAM;IAId,OAAO,IAAI,IAAI;IAUtB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,WAAW;CAetB"}