@explorins/pers-shared 2.1.9 → 2.1.11

package/dist/cjs/internal/functions/crypto.functions.js

@@ -0,0 +1,110 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decryptData = exports.encryptData = exports.generateDecryptedPrivateKey = exports.generatePseudoRandomData = exports.hashPassword = exports.checkMatching = exports.hashString = void 0;
+const crypto = __importStar(require("crypto"));
+const crypto_1 = require("crypto");
+const bcrypt = require('bcryptjs');
+const defaultSaltRounds = 10;
+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;
+};
+exports.hashString = hashString;
+const checkMatching = async (plainString, hashedString) => {
+    const match = await bcrypt.compare(plainString, hashedString);
+    return match;
+};
+exports.checkMatching = checkMatching;
+const hashPassword = async (password, saltRounds = defaultSaltRounds) => {
+    return await bcrypt.hash(password, saltRounds);
+};
+exports.hashPassword = hashPassword;
+const generatePseudoRandomData = (size = 32) => {
+    // Convert the byte array into a hexadecimal string
+    let salt = (0, crypto_1.randomBytes)(size).toString('hex');
+    return salt;
+};
+exports.generatePseudoRandomData = generatePseudoRandomData;
+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();
+};
+exports.generateDecryptedPrivateKey = generateDecryptedPrivateKey;
+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);
+    }
+};
+exports.encryptData = encryptData;
+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);
+    }
+};
+exports.decryptData = decryptData;
+//# sourceMappingURL=crypto.functions.js.map

package/dist/cjs/internal/functions/crypto.functions.js.map

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

package/dist/cjs/internal/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/cjs/internal/functions/helper.functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.functions.d.ts","sourceRoot":"","sources":["../../../../src/internal/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/cjs/internal/functions/helper.functions.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compareVersions = exports.checkIfTokenIdIsUri = exports.parseCommaSeparatedStringToStringArray = void 0;
+/**
+   * Parses a comma-separated string into an array of strings.
+   *
+   * @param commaSeparatedString - The string to parse.
+   * @returns An array of trimmed, non-empty strings.
+   */
+const parseCommaSeparatedStringToStringArray = (commaSeparatedString) => {
+    return commaSeparatedString
+        ? commaSeparatedString.split(',').map((s) => s.trim()).filter(Boolean)
+        : [];
+};
+exports.parseCommaSeparatedStringToStringArray = parseCommaSeparatedStringToStringArray;
+const checkIfTokenIdIsUri = (tokenId) => {
+    const uriRegex = /^(https?|ipfs):\/\/.*/;
+    if (!tokenId || !uriRegex.test(tokenId)) {
+        return false;
+    }
+    return true;
+};
+exports.checkIfTokenIdIsUri = checkIfTokenIdIsUri;
+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;
+};
+exports.compareVersions = compareVersions;
+//# sourceMappingURL=helper.functions.js.map

package/dist/cjs/internal/functions/helper.functions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.functions.js","sourceRoot":"","sources":["../../../../src/internal/functions/helper.functions.ts"],"names":[],"mappings":";;;AAEA;;;;;KAKK;AACE,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;AAJQ,QAAA,sCAAsC,0CAI9C;AAGE,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;AANY,QAAA,mBAAmB,uBAM/B;AAEM,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;AAXY,QAAA,eAAe,mBAW3B"}

package/dist/cjs/internal/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/cjs/internal/functions/index.d.ts.map

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

package/dist/cjs/internal/functions/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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 });
+// Functions Barrel - Auto-exports all functions
+__exportStar(require("./helper.functions"), exports);
+__exportStar(require("./request.functions"), exports);
+__exportStar(require("./crypto.functions"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/internal/functions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/internal/functions/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAAgD;AAChD,qDAAmC;AACnC,sDAAoC;AACpC,qDAAmC"}

package/dist/cjs/internal/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/cjs/internal/functions/request.functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.functions.d.ts","sourceRoot":"","sources":["../../../../src/internal/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/cjs/internal/functions/request.functions.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setRequestValue = exports.getTenantFromStripeRequest = exports.anonymizeIp = exports.getIpFromRequest = exports.extractTokenFromHeader = void 0;
+const extractTokenFromHeader = (request, tokenName) => {
+    // get key from header
+    const token = request?.headers ? (request?.headers)[tokenName] || '' : '';
+    return token;
+};
+exports.extractTokenFromHeader = extractTokenFromHeader;
+// Enhanced IP extraction with better proxy support
+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;
+};
+exports.getIpFromRequest = getIpFromRequest;
+/**
+ * Anonymize IP address for privacy compliance (GDPR/CCPA)
+ * Removes last octet for IPv4, last 80 bits for IPv6
+ */
+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
+};
+exports.anonymizeIp = anonymizeIp;
+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,
+    };
+};
+exports.getTenantFromStripeRequest = getTenantFromStripeRequest;
+const setRequestValue = (request, key, value) => {
+    if (request)
+        request[key] = value;
+};
+exports.setRequestValue = setRequestValue;
+//# sourceMappingURL=request.functions.js.map

package/dist/cjs/internal/functions/request.functions.js.map

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

package/dist/cjs/internal/index.d.ts

@@ -0,0 +1,14 @@
+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 '../enum';
+export * from '../value-objects';
+export * from '../interfaces';
+export * from '../types';
+export * from '../dto';
+export * from '../errors';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/internal/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/internal/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,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AAGvB,cAAc,WAAW,CAAC"}

package/dist/cjs/internal/index.js

@@ -0,0 +1,42 @@
+"use strict";
+// PERS Shared Patterns Library - Internal Architecture Components
+// 🔒 PRIVATE: For internal PERS microservices only
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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 });
+// Orchestrators - Business coordination patterns
+__exportStar(require("./orchestrators"), exports);
+// Database - Shared entity models and schemas
+__exportStar(require("./database"), exports);
+// Utils - Validation and utility functions
+__exportStar(require("./utils"), exports);
+// Exceptions - Business and technical error classes
+__exportStar(require("./exceptions"), exports);
+// Enums - Internal business enums for microservice communication
+__exportStar(require("./enums/lambda.enum"), exports);
+__exportStar(require("./functions"), exports);
+__exportStar(require("./interfaces"), exports);
+// Shared Pattern
+// Core domain contracts
+__exportStar(require("../enum"), exports);
+__exportStar(require("../value-objects"), exports);
+__exportStar(require("../interfaces"), exports);
+__exportStar(require("../types"), exports);
+__exportStar(require("../dto"), exports);
+// Error handling system
+__exportStar(require("../errors"), exports);
+// Note: This library contains proprietary business logic and architecture patterns
+// It should only be used within PERS internal microservices
+//# sourceMappingURL=index.js.map

package/dist/cjs/internal/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/internal/index.ts"],"names":[],"mappings":";AAAA,kEAAkE;AAClE,mDAAmD;;;;;;;;;;;;;;;;AAEnD,iDAAiD;AACjD,kDAAgC;AAEhC,8CAA8C;AAC9C,6CAA2B;AAE3B,2CAA2C;AAC3C,0CAAwB;AAExB,oDAAoD;AACpD,+CAA6B;AAE7B,iEAAiE;AACjE,sDAAoC;AAEpC,8CAA4B;AAE5B,+CAA6B;AAG7B,iBAAiB;AACjB,wBAAwB;AACxB,0CAAwB;AACxB,mDAAiC;AACjC,gDAA8B;AAC9B,2CAAyB;AACzB,yCAAuB;AAEvB,wBAAwB;AACxB,4CAA0B;AAE1B,mFAAmF;AACnF,4DAA4D"}

package/dist/cjs/internal/interfaces/index.d.ts

@@ -0,0 +1,3 @@
+export * from './stripe-payment-intent-metadata.interface';
+export * from './request.interface';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/internal/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/internal/interfaces/index.ts"],"names":[],"mappings":"AAEA,cAAc,4CAA4C,CAAC;AAC3D,cAAc,qBAAqB,CAAC"}

package/dist/cjs/internal/interfaces/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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 });
+__exportStar(require("./stripe-payment-intent-metadata.interface"), exports);
+__exportStar(require("./request.interface"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/internal/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/internal/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAEA,6EAA2D;AAC3D,sDAAoC"}

package/dist/cjs/internal/interfaces/request.interface.d.ts

@@ -0,0 +1,21 @@
+import { UserDTO, TenantDTO, BusinessDTO, AdminDTO } from '@explorins/pers-shared';
+export interface ExtendedAppRequest extends Request {
+    tenant?: TenantDTO;
+    business?: BusinessDTO;
+    user?: UserDTO;
+    admin?: AdminDTO;
+    isVerifiedTenantAdmin?: boolean;
+    originalIp?: string;
+    anonymizedIp?: string;
+}
+export declare class AllowedAppRequestHeaders {
+    'x-project-key': string;
+    'x-api-key': string;
+    'Authorization': string;
+    'Origin': string;
+    'X-Requested-With': string;
+    'Content-Type': string;
+    'Accept': string;
+    'stripe-signature': string;
+}
+//# sourceMappingURL=request.interface.d.ts.map

package/dist/cjs/internal/interfaces/request.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.interface.d.ts","sourceRoot":"","sources":["../../../../src/internal/interfaces/request.interface.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAEjF,MAAM,WAAW,kBAAmB,SAAQ,OAAO;IAC/C,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAE/B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;CACxB;AACD,qBAAa,wBAAwB;IACjC,eAAe,EAAE,MAAM,CAAkB;IACzC,WAAW,EAAE,MAAM,CAAc;IACjC,eAAe,EAAE,MAAM,CAAkB;IACzC,QAAQ,EAAE,MAAM,CAAW;IAC3B,kBAAkB,EAAE,MAAM,CAAqB;IAC/C,cAAc,EAAE,MAAM,CAAiB;IACvC,QAAQ,EAAE,MAAM,CAAW;IAC3B,kBAAkB,EAAE,MAAM,CAAqB;CAClD"}

package/dist/cjs/internal/interfaces/request.interface.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AllowedAppRequestHeaders = void 0;
+class AllowedAppRequestHeaders {
+    'x-project-key' = 'x-project-key';
+    'x-api-key' = 'x-api-key';
+    'Authorization' = 'Authorization';
+    'Origin' = 'Origin';
+    'X-Requested-With' = 'X-Requested-With';
+    'Content-Type' = 'Content-Type';
+    'Accept' = 'Accept';
+    'stripe-signature' = 'stripe-signature';
+}
+exports.AllowedAppRequestHeaders = AllowedAppRequestHeaders;
+//# sourceMappingURL=request.interface.js.map

package/dist/cjs/internal/interfaces/request.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.interface.js","sourceRoot":"","sources":["../../../../src/internal/interfaces/request.interface.ts"],"names":[],"mappings":";;;AAaA,MAAa,wBAAwB;IACjC,eAAe,GAAW,eAAe,CAAA;IACzC,WAAW,GAAW,WAAW,CAAA;IACjC,eAAe,GAAW,eAAe,CAAA;IACzC,QAAQ,GAAW,QAAQ,CAAA;IAC3B,kBAAkB,GAAW,kBAAkB,CAAA;IAC/C,cAAc,GAAW,cAAc,CAAA;IACvC,QAAQ,GAAW,QAAQ,CAAA;IAC3B,kBAAkB,GAAW,kBAAkB,CAAA;CAClD;AATD,4DASC"}

package/dist/cjs/internal/interfaces/stripe-payment-intent-metadata.interface.d.ts

@@ -0,0 +1,9 @@
+export interface StripePaymentIntentMetadata {
+    accountAddress: string;
+    tokenAddress: string;
+    tokenId: string | null;
+    minterAddress: string;
+    tenantId: string;
+    isTestnet: boolean;
+}
+//# sourceMappingURL=stripe-payment-intent-metadata.interface.d.ts.map

package/dist/cjs/internal/interfaces/stripe-payment-intent-metadata.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe-payment-intent-metadata.interface.d.ts","sourceRoot":"","sources":["../../../../src/internal/interfaces/stripe-payment-intent-metadata.interface.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,2BAA2B;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACtB"}

package/dist/cjs/internal/interfaces/stripe-payment-intent-metadata.interface.js

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

package/dist/cjs/internal/interfaces/stripe-payment-intent-metadata.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe-payment-intent-metadata.interface.js","sourceRoot":"","sources":["../../../../src/internal/interfaces/stripe-payment-intent-metadata.interface.ts"],"names":[],"mappings":""}

package/dist/cjs/internal/internal-index.d.ts

@@ -0,0 +1,8 @@
+export * from './orchestrators';
+export * from './database';
+export * from './utils';
+export * from './exceptions';
+export * from './enums/lambda.enum';
+export * from './functions';
+export * from './interfaces';
+//# sourceMappingURL=internal-index.d.ts.map

package/dist/cjs/internal/internal-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-index.d.ts","sourceRoot":"","sources":["../../../src/internal/internal-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"}

package/dist/cjs/internal/internal-index.js

@@ -0,0 +1,33 @@
+"use strict";
+// PERS Shared Patterns Library - Internal Architecture Components
+// 🔒 PRIVATE: For internal PERS microservices only
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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 });
+// Orchestrators - Business coordination patterns
+__exportStar(require("./orchestrators"), exports);
+// Database - Shared entity models and schemas
+__exportStar(require("./database"), exports);
+// Utils - Validation and utility functions
+__exportStar(require("./utils"), exports);
+// Exceptions - Business and technical error classes
+__exportStar(require("./exceptions"), exports);
+// Enums - Internal business enums for microservice communication
+__exportStar(require("./enums/lambda.enum"), exports);
+__exportStar(require("./functions"), exports);
+__exportStar(require("./interfaces"), exports);
+// Note: This library contains proprietary business logic and architecture patterns
+// It should only be used within PERS internal microservices
+//# sourceMappingURL=internal-index.js.map

package/dist/cjs/internal/internal-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-index.js","sourceRoot":"","sources":["../../../src/internal/internal-index.ts"],"names":[],"mappings":";AAAA,kEAAkE;AAClE,mDAAmD;;;;;;;;;;;;;;;;AAEnD,iDAAiD;AACjD,kDAAgC;AAEhC,8CAA8C;AAC9C,6CAA2B;AAE3B,2CAA2C;AAC3C,0CAAwB;AAExB,oDAAoD;AACpD,+CAA6B;AAE7B,iEAAiE;AACjE,sDAAoC;AAEpC,8CAA4B;AAE5B,+CAA6B;AAE7B,mFAAmF;AACnF,4DAA4D"}

package/dist/cjs/internal/orchestrators/base-orchestrator.d.ts

@@ -0,0 +1,90 @@
+import { Logger } from '@nestjs/common';
+import { CommandBus, QueryBus } from '@nestjs/cqrs';
+import { OrchestrationError } from '@explorins/pers-shared';
+/**
+ * BaseOrchestrator - Centralized Application Layer Orchestration Pattern
+ *
+ * @description Foundation for all domain orchestrators following PERS DDD principles:
+ * - Application layer orchestrates cross-domain operations via CQRS
+ * - Domain services contain pure business logic only
+ * - Microservice boundary preparation through clean abstractions
+ * - Consistent patterns across all domains (transaction, user, wallet, token, etc.)
+ * - Smart error handling that preserves business context
+ *
+ * @usage Extend this class in domain-specific orchestrators:
+ * ```typescript
+ * @Injectable()
+ * export class UserOrchestrator extends BaseOrchestrator {
+ *   constructor(commandBus: CommandBus, queryBus: QueryBus) {
+ *     super(commandBus, queryBus, UserOrchestrator.name);
+ *   }
+ * }
+ * ```
+ *
+ * @library @explorins/pers-shared
+ * @version 2.0.0
+ * @since August 2025
+ */
+export declare abstract class BaseOrchestrator {
+    protected readonly commandBus: CommandBus;
+    protected readonly queryBus: QueryBus;
+    protected readonly logger: Logger;
+    protected constructor(commandBus: CommandBus, queryBus: QueryBus, loggerContext: string);
+    /**
+     * Enhanced error handling that preserves business errors while wrapping technical errors
+     * Business errors (with category: DOMAIN_RULE) are passed through unchanged
+     * Technical errors are wrapped in OrchestrationError for consistent handling
+     */
+    protected executeWithErrorHandling<T>(operation: () => Promise<T>, operationName: string, context?: Record<string, any>): Promise<T>;
+    /**
+     * Execute CQRS command with consistent error handling and logging
+     * Standardizes command execution across all orchestrators
+     */
+    protected executeCommand<T>(command: any, operationName?: string): Promise<T>;
+    /**
+     * Execute CQRS query with consistent error handling and logging
+     * Standardizes query execution across all orchestrators
+     */
+    protected executeQuery<T>(query: any, operationName?: string): Promise<T>;
+    /**
+     * Execute multiple operations in parallel with error handling
+     * Useful for batch operations across domains
+     */
+    protected executeParallel<T>(operations: (() => Promise<T>)[], operationName: string): Promise<T[]>;
+}
+/**
+ * Result pattern for orchestrator operations (optional - for complex flows)
+ * Provides type-safe error handling without exceptions
+ */
+export type OrchestrationResult<T> = {
+    success: true;
+    data: T;
+    operation?: string;
+} | {
+    success: false;
+    error: OrchestrationError;
+    operation?: string;
+};
+/**
+ * Helper function to create success result
+ */
+export declare function createSuccessResult<T>(data: T, operation?: string): OrchestrationResult<T>;
+/**
+ * Helper function to create error result
+ */
+export declare function createErrorResult<T>(error: OrchestrationError, operation?: string): OrchestrationResult<T>;
+/**
+ * Utility function to check if result is successful
+ * Provides type guard for TypeScript
+ */
+export declare function isSuccessResult<T>(result: OrchestrationResult<T>): result is {
+    success: true;
+    data: T;
+    operation?: string;
+};
+/**
+ * Utility function to extract data from result or throw error
+ * Useful for converting result pattern back to exception-based flow
+ */
+export declare function unwrapResult<T>(result: OrchestrationResult<T>): T;
+//# sourceMappingURL=base-orchestrator.d.ts.map

package/dist/cjs/internal/orchestrators/base-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-orchestrator.d.ts","sourceRoot":"","sources":["../../../../src/internal/orchestrators/base-orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAiB,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAiB,MAAM,wBAAwB,CAAC;AAE3E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,8BAAsB,gBAAgB;IAIlC,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU;IACzC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ;IAJvC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAElC,SAAS,aACY,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,QAAQ,EACrC,aAAa,EAAE,MAAM;IAKvB;;;;OAIG;cACa,wBAAwB,CAAC,CAAC,EACxC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC5B,OAAO,CAAC,CAAC,CAAC;IAwBb;;;OAGG;cACa,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IASnF;;;OAGG;cACa,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAS/E;;;OAGG;cACa,eAAe,CAAC,CAAC,EAC/B,UAAU,EAAE,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAChC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,CAAC,EAAE,CAAC;CAOhB;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI;IACnC,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,CAAC,CAAC;IACR,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG;IACF,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,kBAAkB,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAE1F;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAE1G;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAE3H;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,CAAC,CAKjE"}