@explorins/pers-shared 2.1.35 → 2.1.37

package/dist/esm/shared-patterns/exceptions/base/error-classification-enums.js

@@ -0,0 +1,108 @@
+/**
+ * Error Classification Enums and Interfaces
+ *
+ * This file defines the error categorization system used throughout the application.
+ *
+ * 🎯 DEVELOPER GUIDANCE:
+ *
+ * When creating errors, choose the appropriate category:
+ *
+ * 1. DOMAIN_RULE: Business logic violations
+ *    → Use BusinessLogicError subclasses (e.g., TokenTypeNotFoundError)
+ *
+ * 2. TECHNICAL: Application/config issues
+ *    → Use TechnicalError.withMessage() for meaningful technical errors
+ *
+ * 3. VALIDATION: Input format/validation failures
+ *    → Let NestJS validation decorators handle these automatically
+ *
+ * 4. INFRASTRUCTURE: External system failures
+ *    → These are usually classified automatically from generic Error() instances
+ *
+ * 5. SECURITY: Auth/authorization issues
+ *    → Use NestJS guards and filters for consistent security errors
+ *
+ * 💡 TIP: Prefer structured errors (BusinessLogicError/TechnicalError) over generic Error()
+ *         for better user experience and debugging capability.
+ *
+ * 📊 QUICK REFERENCE TABLE:
+ * ┌─────────────────┬─────────────┬─────────────────────────────────────┬───────────┐
+ * │ Category        │ HTTP Status │ Example                             │ Retryable │
+ * ├─────────────────┼─────────────┼─────────────────────────────────────┼───────────┤
+ * │ VALIDATION      │ 400         │ "Email format invalid"              │ No        │
+ * │ DOMAIN_RULE     │ 422         │ "Insufficient balance"              │ No        │
+ * │ TECHNICAL       │ 422         │ "Invalid file format"               │ Maybe     │
+ * │ INFRASTRUCTURE  │ 503         │ "Database connection failed"        │ Yes       │
+ * │ SECURITY        │ 403         │ "Access denied"                     │ No        │
+ * │ RATE_LIMIT      │ 429         │ "API rate limit exceeded"           │ Yes       │
+ * │ TIMEOUT         │ 504         │ "Request timeout"                   │ Yes       │
+ * │ UNKNOWN         │ 500         │ Generic Error() instances           │ Yes       │
+ * └─────────────────┴─────────────┴─────────────────────────────────────┴───────────┘
+ */
+// Note: ErrorCategory is now imported from @explorins/pers-shared
+// This library contains only the detailed classification enums and interfaces
+/**
+ * Error severity levels for prioritization and alerting
+ *
+ * Determines the urgency of response and escalation procedures:
+ * - Monitoring alert thresholds
+ * - On-call escalation policies
+ * - SLA response times
+ * - Business impact assessment
+ */
+export var ErrorSeverity;
+(function (ErrorSeverity) {
+    /**
+     * Low severity - Minor issues, degraded experience but service functional
+     * Examples: Optional feature failures, cosmetic issues, non-critical warnings
+     * Response Time: 24-48 hours
+     * Escalation: Development team during business hours
+     * Business Impact: Minimal
+     */
+    ErrorSeverity["LOW"] = "LOW";
+    /**
+     * Medium severity - Noticeable issues, some functionality impaired
+     * Examples: Performance degradation, secondary feature failures, data sync delays
+     * Response Time: 4-8 hours
+     * Escalation: Development team within same day
+     * Business Impact: Moderate
+     */
+    ErrorSeverity["MEDIUM"] = "MEDIUM";
+    /**
+     * High severity - Significant issues, core functionality impaired
+     * Examples: Payment failures, authentication issues, critical feature outages
+     * Response Time: 1-2 hours
+     * Escalation: Immediate development team notification
+     * Business Impact: High
+     */
+    ErrorSeverity["HIGH"] = "HIGH";
+    /**
+     * Critical severity - System down, major business impact
+     * Examples: Complete service outage, data corruption, security breaches
+     * Response Time: Immediate (< 15 minutes)
+     * Escalation: Page on-call engineer, notify leadership
+     * Business Impact: Severe
+     */
+    ErrorSeverity["CRITICAL"] = "CRITICAL";
+})(ErrorSeverity || (ErrorSeverity = {}));
+// Note: All interfaces moved to @explorins/pers-shared for proper data contract separation
+/**
+ * HTTP Status codes used by our error classification system
+ *
+ * Centralized here to maintain consistency across error classification
+ * and avoid duplication with NestJS HttpStatus values.
+ */
+export var ErrorHttpStatus;
+(function (ErrorHttpStatus) {
+    ErrorHttpStatus[ErrorHttpStatus["BAD_REQUEST"] = 400] = "BAD_REQUEST";
+    ErrorHttpStatus[ErrorHttpStatus["UNAUTHORIZED"] = 401] = "UNAUTHORIZED";
+    ErrorHttpStatus[ErrorHttpStatus["FORBIDDEN"] = 403] = "FORBIDDEN";
+    ErrorHttpStatus[ErrorHttpStatus["NOT_FOUND"] = 404] = "NOT_FOUND";
+    ErrorHttpStatus[ErrorHttpStatus["CONFLICT"] = 409] = "CONFLICT";
+    ErrorHttpStatus[ErrorHttpStatus["UNPROCESSABLE_ENTITY"] = 422] = "UNPROCESSABLE_ENTITY";
+    ErrorHttpStatus[ErrorHttpStatus["TOO_MANY_REQUESTS"] = 429] = "TOO_MANY_REQUESTS";
+    ErrorHttpStatus[ErrorHttpStatus["INTERNAL_SERVER_ERROR"] = 500] = "INTERNAL_SERVER_ERROR";
+    ErrorHttpStatus[ErrorHttpStatus["SERVICE_UNAVAILABLE"] = 503] = "SERVICE_UNAVAILABLE";
+    ErrorHttpStatus[ErrorHttpStatus["GATEWAY_TIMEOUT"] = 504] = "GATEWAY_TIMEOUT";
+})(ErrorHttpStatus || (ErrorHttpStatus = {}));
+//# sourceMappingURL=error-classification-enums.js.map

package/dist/esm/shared-patterns/exceptions/base/error-classification-enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-classification-enums.js","sourceRoot":"","sources":["../../../../../src/shared-patterns/exceptions/base/error-classification-enums.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,kEAAkE;AAClE,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,CAAN,IAAY,aAoCX;AApCD,WAAY,aAAa;IACvB;;;;;;OAMG;IACH,4BAAW,CAAA;IAEX;;;;;;OAMG;IACH,kCAAiB,CAAA;IAEjB;;;;;;OAMG;IACH,8BAAa,CAAA;IAEb;;;;;;OAMG;IACH,sCAAqB,CAAA;AACvB,CAAC,EApCW,aAAa,KAAb,aAAa,QAoCxB;AAoBD,2FAA2F;AAE3F;;;;;GAKG;AACH,MAAM,CAAN,IAAY,eAWX;AAXD,WAAY,eAAe;IACzB,qEAAiB,CAAA;IACjB,uEAAkB,CAAA;IAClB,iEAAe,CAAA;IACf,iEAAe,CAAA;IACf,+DAAc,CAAA;IACd,uFAA0B,CAAA;IAC1B,iFAAuB,CAAA;IACvB,yFAA2B,CAAA;IAC3B,qFAAyB,CAAA;IACzB,6EAAqB,CAAA;AACvB,CAAC,EAXW,eAAe,KAAf,eAAe,QAW1B"}

package/dist/esm/shared-patterns/exceptions/base/error-classifier.d.ts

@@ -0,0 +1,23 @@
+import { StructuredError } from '../../../shared-lib/errors';
+/**
+ * Error classification utilities with 3-path decision logic
+ */
+export declare class ErrorClassifier {
+    /**
+     * Simplified error classification with 3-path logic
+     * 1. BusinessLogicError -> Preserve structure (fast path)
+     * 2. TechnicalError -> Preserve message (fast path)
+     * 3. Everything else -> Security-first fallback
+     */
+    static classify(error: any, domain: string): StructuredError;
+    /**
+     * Determine if an error message is safe to expose to users
+     * Uses a balanced approach: block sensitive system data while allowing business messages
+     */
+    private static isSafeForUsers;
+    /**
+     * Convert structured error to HTTP status code
+     */
+    static getHttpStatusCode(structuredError: StructuredError): number;
+}
+//# sourceMappingURL=error-classifier.d.ts.map

package/dist/esm/shared-patterns/exceptions/base/error-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-classifier.d.ts","sourceRoot":"","sources":["../../../../../src/shared-patterns/exceptions/base/error-classifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqC,eAAe,EAAkB,MAAM,4BAA4B,CAAC;AAGhH;;GAEG;AACH,qBAAa,eAAe;IAC1B;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe;IAyE5D;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAgE7B;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,eAAe,EAAE,eAAe,GAAG,MAAM;CAkBnE"}

package/dist/esm/shared-patterns/exceptions/base/error-classifier.js

@@ -0,0 +1,161 @@
+import { BusinessLogicError, ErrorCategory, TechnicalError } from '../../../shared-lib/errors';
+import { ErrorHttpStatus } from './error-classification-enums';
+/**
+ * Error classification utilities with 3-path decision logic
+ */
+export class ErrorClassifier {
+    /**
+     * Simplified error classification with 3-path logic
+     * 1. BusinessLogicError -> Preserve structure (fast path)
+     * 2. TechnicalError -> Preserve message (fast path)
+     * 3. Everything else -> Security-first fallback
+     */
+    static classify(error, domain) {
+        // Fast path 1: BusinessLogicError (already structured)
+        if (BusinessLogicError.isBusinessError(error)) {
+            const response = error.getResponse();
+            const responseObj = typeof response === 'object' ? response : {};
+            return {
+                status: 422,
+                title: 'Business Rule Violation',
+                detail: responseObj.message || error.message,
+                message: responseObj.message || error.message,
+                code: responseObj.code || 'BUSINESS_ERROR',
+                category: ErrorCategory.DOMAIN_RULE,
+                timestamp: new Date().toISOString(),
+                retryable: false,
+                userMessage: responseObj.message || error.message
+            };
+        }
+        // Fast path 2: TechnicalError (preserve meaningful messages)
+        if (error instanceof TechnicalError) {
+            const response = error.getResponse();
+            const responseObj = typeof response === 'object' ? response : {};
+            return {
+                status: 503,
+                title: 'Technical Error',
+                detail: responseObj.message || error.message,
+                message: responseObj.message || error.message,
+                code: 'TECHNICAL_ERROR',
+                category: ErrorCategory.INFRASTRUCTURE,
+                timestamp: new Date().toISOString(),
+                retryable: true,
+                userMessage: responseObj.message || error.message
+            };
+        }
+        // Fast path 3: HttpExceptions with BUSINESS_LOGIC category (for backward compatibility)
+        if (typeof error.getStatus === 'function') {
+            const response = error.getResponse ? error.getResponse() : null;
+            if (typeof response === 'object' && response?.category === 'BUSINESS_LOGIC') {
+                const responseObj = response;
+                return {
+                    status: 422,
+                    title: 'Business Rule Violation',
+                    detail: responseObj.message || error.message,
+                    message: responseObj.message || error.message,
+                    code: responseObj.code || 'BUSINESS_ERROR',
+                    category: ErrorCategory.DOMAIN_RULE,
+                    timestamp: new Date().toISOString(),
+                    retryable: false,
+                    userMessage: responseObj.message || error.message
+                };
+            }
+        }
+        // Security-first fallback for everything else
+        const message = error.message || 'Unknown error';
+        // Check if error message is safe to expose to users
+        const isSafe = this.isSafeForUsers(message);
+        return {
+            status: 500,
+            title: 'Internal Server Error',
+            detail: isSafe ? message : 'An unexpected error occurred',
+            message: isSafe ? message : 'Internal server error',
+            code: 'INTERNAL_ERROR',
+            category: ErrorCategory.UNKNOWN,
+            timestamp: new Date().toISOString(),
+            retryable: true,
+            userMessage: isSafe ? message : 'An unexpected error occurred. Please try again.'
+        };
+    }
+    /**
+     * Determine if an error message is safe to expose to users
+     * Uses a balanced approach: block sensitive system data while allowing business messages
+     */
+    static isSafeForUsers(message) {
+        if (!message || message.length < 3 || message.length > 300)
+            return false;
+        // Allow common business error phrases that are safe for users
+        const safeBusinessPatterns = [
+            /cannot process payment/i,
+            /unable to complete transaction/i,
+            /insufficient (balance|funds)/i,
+            /user not found/i,
+            /token not active/i,
+            /wallet not found/i,
+            /invalid (amount|address|format)/i,
+            /transaction (failed|rejected|expired)/i,
+            /account (locked|inactive|suspended)/i,
+            /permission denied/i,
+            /rate limit exceeded/i,
+            /service temporarily unavailable/i
+        ];
+        // If it matches safe business patterns, allow it
+        if (safeBusinessPatterns.some(pattern => pattern.test(message))) {
+            return true;
+        }
+        // Block definitely unsafe patterns (system internals and sensitive data)
+        const unsafePatterns = [
+            // System internals with technical context
+            /internal server error/i,
+            /database connection (failed|lost|timeout)/i,
+            /sql (error|exception|syntax)/i,
+            /stack trace|stacktrace/i,
+            /undefined (property|method|function)/i,
+            /null pointer|reference error/i,
+            // Sensitive data indicators  
+            /secret|password|private.?key|credential/i,
+            /jwt.?token|bearer.?token|api.?key/i,
+            /localhost|127\.0\.0\.1|192\.168\.|10\.\d+\./i,
+            /\.env|config\.json|\.xml|\.yml/i,
+            // Technical stack traces and system paths
+            /\/var\/|\/etc\/|\/home\/|\/usr\/bin|\/opt\//i,
+            /node_modules|package\.json|tsconfig/i,
+            /at Object\.|at Function\.|at async/i,
+            // Database and system queries
+            /SELECT.*FROM|INSERT.*INTO|UPDATE.*SET/i,
+            /mongodb|postgresql|redis|elasticsearch/i
+        ];
+        // Block if it matches unsafe patterns
+        if (unsafePatterns.some(pattern => pattern.test(message))) {
+            return false;
+        }
+        // For everything else, apply basic safety checks
+        // Allow if it looks like a user-friendly business message
+        const hasBusinessContext = /\b(user|account|transaction|payment|balance|wallet|token)\b/i.test(message);
+        const hasGenericWords = /\b(invalid|missing|required|expired|failed|rejected|denied)\b/i.test(message);
+        const noSystemJargon = !/\b(undefined|null|exception|stack|trace|object|function|method|class)\b/i.test(message);
+        return (hasBusinessContext || hasGenericWords) && noSystemJargon;
+    }
+    /**
+     * Convert structured error to HTTP status code
+     */
+    static getHttpStatusCode(structuredError) {
+        switch (structuredError.category) {
+            case ErrorCategory.VALIDATION:
+                return ErrorHttpStatus.BAD_REQUEST;
+            case ErrorCategory.DOMAIN_RULE:
+                return ErrorHttpStatus.UNPROCESSABLE_ENTITY;
+            case ErrorCategory.SECURITY:
+                return ErrorHttpStatus.FORBIDDEN;
+            case ErrorCategory.RATE_LIMIT:
+                return ErrorHttpStatus.TOO_MANY_REQUESTS;
+            case ErrorCategory.TIMEOUT:
+                return ErrorHttpStatus.GATEWAY_TIMEOUT;
+            case ErrorCategory.INFRASTRUCTURE:
+                return ErrorHttpStatus.SERVICE_UNAVAILABLE;
+            default:
+                return ErrorHttpStatus.INTERNAL_SERVER_ERROR;
+        }
+    }
+}
+//# sourceMappingURL=error-classifier.js.map

package/dist/esm/shared-patterns/exceptions/base/error-classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-classifier.js","sourceRoot":"","sources":["../../../../../src/shared-patterns/exceptions/base/error-classifier.ts"],"names":[],"mappings":"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"}

package/dist/esm/shared-patterns/exceptions/index.d.ts

@@ -0,0 +1,3 @@
+export * from './base/error-classification-enums';
+export { ErrorClassifier } from './base/error-classifier';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/shared-patterns/exceptions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared-patterns/exceptions/index.ts"],"names":[],"mappings":"AACA,cAAc,mCAAmC,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/esm/shared-patterns/exceptions/index.js

@@ -0,0 +1,6 @@
+// Error classification utilities (patterns-specific logic only)
+export * from './base/error-classification-enums';
+export { ErrorClassifier } from './base/error-classifier';
+// Note: All error classes (BusinessLogicError, TechnicalError, domain errors) are exported from @explorins/pers-shared
+// This library only contains error classification logic and patterns
+//# sourceMappingURL=index.js.map

package/dist/esm/shared-patterns/exceptions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared-patterns/exceptions/index.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,cAAc,mCAAmC,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,uHAAuH;AACvH,qEAAqE"}

package/dist/esm/shared-patterns/functions/crypto.functions.d.ts

@@ -0,0 +1,16 @@
+type KeyFormat = 'pem';
+type KeyType = 'pkcs1' | 'pkcs8';
+export interface EncryptedDataObject {
+    encryptedData: string;
+    iv: string;
+    authTag: string;
+}
+export declare const hashString: (input: string, maxLength?: number | null, algorithm?: "sha256" | "sha512" | "md5") => string;
+export declare const checkMatching: (plainString: string, hashedString: string) => Promise<any>;
+export declare const hashPassword: (password: string, saltRounds?: number) => Promise<string>;
+export declare const generatePseudoRandomData: (size?: number) => string;
+export declare const generateDecryptedPrivateKey: (privateKey: string, passphrase: string | undefined, keyType?: KeyType, keyFormat?: KeyFormat) => string;
+export declare const encryptData: (data: string, encryptionKey: string) => EncryptedDataObject;
+export declare const decryptData: (encryptedDataObject: EncryptedDataObject, encryptionKey: string) => string;
+export {};
+//# sourceMappingURL=crypto.functions.d.ts.map

package/dist/esm/shared-patterns/functions/crypto.functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.functions.d.ts","sourceRoot":"","sources":["../../../../src/shared-patterns/functions/crypto.functions.ts"],"names":[],"mappings":"AAKA,KAAK,SAAS,GAAG,KAAK,CAAE;AACxB,KAAK,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAEjC,MAAM,WAAW,mBAAmB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;CACjB;AAEC,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,EAAE,YAAW,MAAM,GAAG,IAAW,EAAE,YAAW,QAAQ,GAAG,QAAQ,GAAG,KAAgB,KAAG,MAO9H,CAAA;AAED,eAAO,MAAM,aAAa,GAAU,aAAa,MAAM,EAAE,cAAc,MAAM,iBAG5E,CAAA;AAED,eAAO,MAAM,YAAY,GAAU,UAAU,MAAM,EAAE,aAAY,MAA0B,KAAG,OAAO,CAAC,MAAM,CAE3G,CAAA;AAED,eAAO,MAAM,wBAAwB,GAAI,OAAM,MAAW,WAKzD,CAAA;AAED,eAAO,MAAM,2BAA2B,GACpC,YAAY,MAAM,EAClB,YAAY,MAAM,GAAG,SAAS,EAC9B,UAAS,OAAiB,EAC1B,YAAW,SAAiB,KAC7B,MAWJ,CAAA;AAEH,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,EAAE,eAAe,MAAM,KAAG,mBAmBjE,CAAA;AAED,eAAO,MAAM,WAAW,GAAI,qBAAqB,mBAAmB,EAAE,eAAe,MAAM,KAAG,MAgB7F,CAAA"}

package/dist/esm/shared-patterns/functions/crypto.functions.js

@@ -0,0 +1,67 @@
+import * as crypto from 'crypto';
+import { randomBytes } from 'crypto';
+const bcrypt = require('bcryptjs');
+const defaultSaltRounds = 10;
+export const hashString = (input, maxLength = null, algorithm = 'sha256') => {
+    // Generate a hash of the input string
+    let hash = crypto.createHash(algorithm).update(input).digest('hex');
+    if (typeof maxLength === 'number' && hash.length > maxLength) {
+        hash = hash.substring(0, maxLength);
+    }
+    return hash;
+};
+export const checkMatching = async (plainString, hashedString) => {
+    const match = await bcrypt.compare(plainString, hashedString);
+    return match;
+};
+export const hashPassword = async (password, saltRounds = defaultSaltRounds) => {
+    return await bcrypt.hash(password, saltRounds);
+};
+export const generatePseudoRandomData = (size = 32) => {
+    // Convert the byte array into a hexadecimal string
+    let salt = randomBytes(size).toString('hex');
+    return salt;
+};
+export const generateDecryptedPrivateKey = (privateKey, passphrase, keyType = 'pkcs8', keyFormat = 'pem') => {
+    const decryptedPrivateKey = crypto.createPrivateKey({
+        key: privateKey,
+        format: keyFormat,
+        type: keyType,
+        passphrase: passphrase,
+    });
+    return decryptedPrivateKey.export({ format: keyFormat, type: keyType }).toString();
+};
+export const encryptData = (data, encryptionKey) => {
+    try {
+        const key = Buffer.from(encryptionKey, 'hex');
+        const iv = crypto.randomBytes(16);
+        const cipher = crypto.createCipheriv('aes-256-gcm', key, iv);
+        let encryptedData = cipher.update(data, 'utf8', 'hex');
+        encryptedData += cipher.final('hex');
+        const authTag = cipher.getAuthTag().toString('hex');
+        return {
+            encryptedData,
+            iv: iv.toString('hex'),
+            authTag
+        };
+    }
+    catch (error) {
+        throw new Error('Error encrypting data: ' + error.message);
+    }
+};
+export const decryptData = (encryptedDataObject, encryptionKey) => {
+    try {
+        const key = Buffer.from(encryptionKey, 'hex');
+        const ivBuffer = Buffer.from(encryptedDataObject.iv, 'hex');
+        const authTagBuffer = Buffer.from(encryptedDataObject.authTag, 'hex');
+        const decipher = crypto.createDecipheriv('aes-256-gcm', key, ivBuffer);
+        decipher.setAuthTag(authTagBuffer);
+        let decryptedData = decipher.update(encryptedDataObject.encryptedData, 'hex', 'utf8');
+        decryptedData += decipher.final('utf8');
+        return decryptedData;
+    }
+    catch (error) {
+        throw new Error('Error decrypting data: ' + error.message);
+    }
+};
+//# sourceMappingURL=crypto.functions.js.map

package/dist/esm/shared-patterns/functions/crypto.functions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.functions.js","sourceRoot":"","sources":["../../../../src/shared-patterns/functions/crypto.functions.ts"],"names":[],"mappings":"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"}

package/dist/esm/shared-patterns/functions/helper.functions.d.ts

@@ -0,0 +1,10 @@
+/**
+   * Parses a comma-separated string into an array of strings.
+   *
+   * @param commaSeparatedString - The string to parse.
+   * @returns An array of trimmed, non-empty strings.
+   */
+export declare const parseCommaSeparatedStringToStringArray: (commaSeparatedString: string | null) => string[];
+export declare const checkIfTokenIdIsUri: (tokenId: string | null) => boolean;
+export declare const compareVersions: (version1: string, version2: string) => number;
+//# sourceMappingURL=helper.functions.d.ts.map

package/dist/esm/shared-patterns/functions/helper.functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.functions.d.ts","sourceRoot":"","sources":["../../../../src/shared-patterns/functions/helper.functions.ts"],"names":[],"mappings":"AAEA;;;;;KAKK;AACL,eAAO,MAAM,sCAAsC,GAAI,sBAAsB,MAAM,GAAG,IAAI,KAAG,MAAM,EAI9F,CAAA;AAGL,eAAO,MAAM,mBAAmB,GAAI,SAAS,MAAM,GAAG,IAAI,KAAG,OAM5D,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,UAAU,MAAM,EAAE,UAAU,MAAM,KAAG,MAWpE,CAAA"}

package/dist/esm/shared-patterns/functions/helper.functions.js

@@ -0,0 +1,32 @@
+/**
+   * Parses a comma-separated string into an array of strings.
+   *
+   * @param commaSeparatedString - The string to parse.
+   * @returns An array of trimmed, non-empty strings.
+   */
+export const parseCommaSeparatedStringToStringArray = (commaSeparatedString) => {
+    return commaSeparatedString
+        ? commaSeparatedString.split(',').map((s) => s.trim()).filter(Boolean)
+        : [];
+};
+export const checkIfTokenIdIsUri = (tokenId) => {
+    const uriRegex = /^(https?|ipfs):\/\/.*/;
+    if (!tokenId || !uriRegex.test(tokenId)) {
+        return false;
+    }
+    return true;
+};
+export const compareVersions = (version1, version2) => {
+    const v1 = version1.split('.').map(Number);
+    const v2 = version2.split('.').map(Number);
+    for (let i = 0; i < Math.max(v1.length, v2.length); i++) {
+        const num1 = v1[i] || 0;
+        const num2 = v2[i] || 0;
+        if (num1 > num2)
+            return 1;
+        if (num1 < num2)
+            return -1;
+    }
+    return 0;
+};
+//# sourceMappingURL=helper.functions.js.map

package/dist/esm/shared-patterns/functions/helper.functions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.functions.js","sourceRoot":"","sources":["../../../../src/shared-patterns/functions/helper.functions.ts"],"names":[],"mappings":"AAEA;;;;;KAKK;AACL,MAAM,CAAC,MAAM,sCAAsC,GAAG,CAAC,oBAAmC,EAAY,EAAE;IACpG,OAAO,oBAAoB;QACzB,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;QACtE,CAAC,CAAC,EAAE,CAAC;AACP,CAAC,CAAA;AAGL,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,OAAsB,EAAW,EAAE;IACnE,MAAM,QAAQ,GAAG,uBAAuB,CAAC;IAC3C,IAAI,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACxC,OAAO,KAAK,CAAA;IACd,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,QAAgB,EAAE,QAAgB,EAAU,EAAE;IAC5E,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAE3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACtD,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACxB,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,IAAI,GAAG,IAAI;YAAE,OAAO,CAAC,CAAC;QAC1B,IAAI,IAAI,GAAG,IAAI;YAAE,OAAO,CAAC,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC,CAAA"}

package/dist/esm/shared-patterns/functions/index.d.ts

@@ -0,0 +1,4 @@
+export * from './helper.functions';
+export * from './request.functions';
+export * from './crypto.functions';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/shared-patterns/functions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared-patterns/functions/index.ts"],"names":[],"mappings":"AACA,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC"}

package/dist/esm/shared-patterns/functions/index.js

@@ -0,0 +1,5 @@
+// Functions Barrel - Auto-exports all functions
+export * from './helper.functions';
+export * from './request.functions';
+export * from './crypto.functions';
+//# sourceMappingURL=index.js.map

package/dist/esm/shared-patterns/functions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared-patterns/functions/index.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC"}

package/dist/esm/shared-patterns/functions/request.functions.d.ts

@@ -0,0 +1,14 @@
+import { AllowedAppRequestHeaders, ExtendedAppRequest } from "../interfaces/request.interface";
+export declare const extractTokenFromHeader: (request: Request, tokenName: keyof AllowedAppRequestHeaders) => string | undefined;
+export declare const getIpFromRequest: (request: Request | ExtendedAppRequest) => string | null;
+/**
+ * Anonymize IP address for privacy compliance (GDPR/CCPA)
+ * Removes last octet for IPv4, last 80 bits for IPv6
+ */
+export declare const anonymizeIp: (ip: string | null) => string | null;
+export declare const getTenantFromStripeRequest: (req: Request) => {
+    tenantId: string;
+    isTestnet: boolean;
+} | undefined;
+export declare const setRequestValue: (request: Request, key: keyof ExtendedAppRequest, value: any) => void;
+//# sourceMappingURL=request.functions.d.ts.map

package/dist/esm/shared-patterns/functions/request.functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.functions.d.ts","sourceRoot":"","sources":["../../../../src/shared-patterns/functions/request.functions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAI/F,eAAO,MAAM,sBAAsB,GAAI,SAAS,OAAO,EAAE,WAAW,MAAM,wBAAwB,KAAG,MAAM,GAAG,SAI3G,CAAA;AAGH,eAAO,MAAM,gBAAgB,GAAI,SAAS,OAAO,GAAG,kBAAkB,KAAG,MAAM,GAAG,IAejF,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,IAAI,MAAM,GAAG,IAAI,KAAG,MAAM,GAAG,IAoBxD,CAAA;AAED,eAAO,MAAM,0BAA0B,GAAI,KAAK,OAAO;cASnB,MAAM;eACJ,OAAO;aAE5C,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,SAAS,OAAO,EAAE,KAAK,MAAM,kBAAkB,EAAE,OAAO,GAAG,SAE1F,CAAA"}

package/dist/esm/shared-patterns/functions/request.functions.js

@@ -0,0 +1,61 @@
+export const extractTokenFromHeader = (request, tokenName) => {
+    // get key from header
+    const token = request?.headers ? (request?.headers)[tokenName] || '' : '';
+    return token;
+};
+// Enhanced IP extraction with better proxy support
+export const getIpFromRequest = (request) => {
+    // Try multiple IP sources in order of preference
+    const ip = request.ip ||
+        request.headers['x-forwarded-for']?.split(',')[0]?.trim() ||
+        request.headers['x-real-ip']?.trim() ||
+        request.connection?.remoteAddress?.trim() ||
+        request.socket?.remoteAddress?.trim() ||
+        null;
+    // Clean IPv6 mapped IPv4 addresses
+    if (ip?.startsWith('::ffff:')) {
+        return ip.substring(7);
+    }
+    return ip;
+};
+/**
+ * Anonymize IP address for privacy compliance (GDPR/CCPA)
+ * Removes last octet for IPv4, last 80 bits for IPv6
+ */
+export const anonymizeIp = (ip) => {
+    if (!ip)
+        return null;
+    // IPv4 anonymization - remove last octet
+    if (ip.includes('.') && !ip.includes(':')) {
+        const parts = ip.split('.');
+        if (parts.length === 4) {
+            return `${parts[0]}.${parts[1]}.${parts[2]}.0`;
+        }
+    }
+    // IPv6 anonymization - remove last 80 bits (keep first 48 bits)
+    if (ip.includes(':')) {
+        const parts = ip.split(':');
+        if (parts.length >= 3) {
+            return `${parts[0]}:${parts[1]}:${parts[2]}::`;
+        }
+    }
+    return ip; // Return as-is if format not recognized
+};
+export const getTenantFromStripeRequest = (req) => {
+    const sig = req?.headers ? (req?.headers)['stripe-signature'] || '' : '';
+    if (!sig)
+        return;
+    const body = req?.body;
+    const data = body?.data;
+    const object = data?.object;
+    const metadata = object?.metadata;
+    return {
+        tenantId: metadata?.tenantId,
+        isTestnet: metadata?.isTestnet,
+    };
+};
+export const setRequestValue = (request, key, value) => {
+    if (request)
+        request[key] = value;
+};
+//# sourceMappingURL=request.functions.js.map

package/dist/esm/shared-patterns/functions/request.functions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.functions.js","sourceRoot":"","sources":["../../../../src/shared-patterns/functions/request.functions.ts"],"names":[],"mappings":"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"}

package/dist/esm/shared-patterns/index.d.ts

@@ -0,0 +1,15 @@
+export * from './orchestrators';
+export * from './database';
+export * from './utils';
+export * from './exceptions';
+export * from './enums/lambda.enum';
+export * from './functions';
+export * from './interfaces';
+export * from '../shared-lib/enum';
+export * from '../shared-lib/value-objects';
+export * from '../shared-lib/interfaces';
+export * from '../shared-lib/types';
+export * from '../shared-lib/dto';
+export * from '../shared-lib/errors';
+export * from './errors/error-factory';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/shared-patterns/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared-patterns/index.ts"],"names":[],"mappings":"AAIA,cAAc,iBAAiB,CAAC;AAGhC,cAAc,YAAY,CAAC;AAG3B,cAAc,SAAS,CAAC;AAGxB,cAAc,cAAc,CAAC;AAG7B,cAAc,qBAAqB,CAAC;AAEpC,cAAc,aAAa,CAAC;AAE5B,cAAc,cAAc,CAAC;AAK7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,wBAAwB,CAAC"}