@explorins/pers-shared 2.1.10 → 2.1.12

package/dist/cjs/internal/orchestrators/base-workflow.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseWorkflow = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * BaseWorkflow - Business Process Coordination Pattern
+ *
+ * @description Foundation for business workflow coordination in PERS domains.
+ * Distinct from BaseOrchestrator which handles technical CQRS coordination.
+ *
+ * ARCHITECTURAL DISTINCTION:
+ * - BaseOrchestrator: Technical coordination (CQRS, queries, commands)
+ * - BaseWorkflow: Business process coordination (orchestrator choreography)
+ *
+ * @usage Extend this class for domain-specific business workflows:
+ * ```typescript
+ * @Injectable()
+ * export class ServerTransactionWorkflow extends BaseWorkflow {
+ *   constructor(
+ *     private readonly walletOrchestrator: WalletResolutionOrchestrator,
+ *     private readonly tokenOrchestrator: TokenResolutionOrchestrator
+ *   ) {
+ *     super(ServerTransactionWorkflow.name);
+ *   }
+ *
+ *   async executeTransactionFlow(dto: TransactionRequestDTO): Promise<TransactionDTO> {
+ *     return this.executeWorkflowStep(async () => {
+ *       const token = await this.tokenOrchestrator.resolveToken(dto.token);
+ *       const addresses = await this.walletOrchestrator.resolveAddresses(dto, token.chainId);
+ *       return this.createTransaction(token, addresses, dto);
+ *     }, 'Transaction Creation Flow');
+ *   }
+ * }
+ * ```
+ *
+ * @library @explorins/pers-shared-patterns
+ * @version 1.0.0
+ * @since September 2025
+ */
+class BaseWorkflow {
+    logger;
+    constructor(loggerContext) {
+        this.logger = new common_1.Logger(loggerContext);
+    }
+    /**
+     * Execute a workflow step with standardized logging and error handling
+     *
+     * @param step - Function to execute as workflow step
+     * @param stepName - Human-readable name for the step
+     * @param context - Optional context for logging
+     * @returns Promise resolving to step result
+     */
+    async executeWorkflowStep(step, stepName, context) {
+        try {
+            this.logger.debug(`🎯 Starting workflow step: ${stepName}`, context);
+            const result = await step();
+            this.logger.debug(`✅ Completed workflow step: ${stepName}`, context);
+            return result;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger.error(`❌ Failed workflow step: ${stepName}: ${errorMessage}`, { ...context, error });
+            throw error; // Let business errors flow through unchanged
+        }
+    }
+}
+exports.BaseWorkflow = BaseWorkflow;
+//# sourceMappingURL=base-workflow.js.map

package/dist/cjs/internal/orchestrators/base-workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-workflow.js","sourceRoot":"","sources":["../../../../src/internal/orchestrators/base-workflow.ts"],"names":[],"mappings":";;;AAAA,2CAAwC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAsB,YAAY;IACb,MAAM,CAAS;IAElC,YAAsB,aAAqB;QACzC,IAAI,CAAC,MAAM,GAAG,IAAI,eAAM,CAAC,aAAa,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;;OAOG;IACO,KAAK,CAAC,mBAAmB,CACjC,IAAsB,EACtB,QAAgB,EAChB,OAA6B;QAE7B,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;YACrE,MAAM,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;YACrE,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5E,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,QAAQ,KAAK,YAAY,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YACjG,MAAM,KAAK,CAAC,CAAC,6CAA6C;QAC5D,CAAC;IACH,CAAC;CACF;AA/BD,oCA+BC"}

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

@@ -0,0 +1,26 @@
+/**
+ * PERS Orchestrators - Application Layer Patterns
+ *
+ * @description Centralized orchestration utilities for DDD-compliant applications
+ * - BaseOrchestrator: Foundation for all domain orchestrators (technical coordination)
+ * - BaseWorkflow: Foundation for business process workflows (business coordination)
+ * - OrchestrationError: Standard error handling
+ * - OrchestrationResult: Type-safe result pattern
+ * - Utility functions for error handling and result processing
+ *
+ * @usage Import directly from shared library:
+ * ```typescript
+ * import { BaseOrchestrator, BaseWorkflow, OrchestrationError } from '@explorins/pers-shared-patterns';
+ * ```
+ *
+ * ARCHITECTURAL DISTINCTION:
+ * - BaseOrchestrator: Technical coordination (CQRS, queries, commands)
+ * - BaseWorkflow: Business process coordination (orchestrator choreography)
+ *
+ * @library @explorins/pers-shared-patterns
+ * @version 2.0.0
+ * @since August 2025
+ */
+export * from './base-orchestrator';
+export * from './base-workflow';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/internal/orchestrators/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC"}

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

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * PERS Orchestrators - Application Layer Patterns
+ *
+ * @description Centralized orchestration utilities for DDD-compliant applications
+ * - BaseOrchestrator: Foundation for all domain orchestrators (technical coordination)
+ * - BaseWorkflow: Foundation for business process workflows (business coordination)
+ * - OrchestrationError: Standard error handling
+ * - OrchestrationResult: Type-safe result pattern
+ * - Utility functions for error handling and result processing
+ *
+ * @usage Import directly from shared library:
+ * ```typescript
+ * import { BaseOrchestrator, BaseWorkflow, OrchestrationError } from '@explorins/pers-shared-patterns';
+ * ```
+ *
+ * ARCHITECTURAL DISTINCTION:
+ * - BaseOrchestrator: Technical coordination (CQRS, queries, commands)
+ * - BaseWorkflow: Business process coordination (orchestrator choreography)
+ *
+ * @library @explorins/pers-shared-patterns
+ * @version 2.0.0
+ * @since August 2025
+ */
+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("./base-orchestrator"), exports);
+__exportStar(require("./base-workflow"), exports);
+// Future orchestration utilities can be added here:
+// export * from './validation-orchestrator';
+// export * from './audit-orchestrator';
+// export * from './notification-orchestrator';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/internal/orchestrators/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;;;;;;;;;;;;;;;AAEH,sDAAoC;AACpC,kDAAgC;AAEhC,oDAAoD;AACpD,6CAA6C;AAC7C,wCAAwC;AACxC,+CAA+C"}

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

@@ -0,0 +1,2 @@
+export * from './validation.utils';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/cjs/internal/utils/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 });
+// Internal utilities for PERS architecture patterns
+__exportStar(require("./validation.utils"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/internal/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAoD;AACpD,qDAAmC"}

package/dist/cjs/internal/utils/validation.utils.d.ts

@@ -0,0 +1,49 @@
+/**
+ * PERS Validation Utilities
+ *
+ * Centralized validation functions for consistent data validation
+ * across all PERS backend modules and domains.
+ */
+/**
+ * Validates email format according to RFC standards
+ *
+ * Features:
+ * - RFC-compliant email regex pattern
+ * - RFC 5321 length limit enforcement (254 characters)
+ * - Performance optimized with length check first
+ * - DoS protection against extremely long strings
+ *
+ * @param email - Email address to validate
+ * @returns true if email is valid, false otherwise
+ *
+ * @example
+ * ```typescript
+ * isValidEmail('user@example.com'); // true
+ * isValidEmail('invalid-email'); // false
+ * isValidEmail('a'.repeat(300) + '@example.com'); // false (too long)
+ * ```
+ */
+export declare function isValidEmail(email: string): boolean;
+/**
+ * Validates wallet address format
+ *
+ * @param address - Wallet address to validate
+ * @returns true if address format is valid
+ */
+export declare function isValidWalletAddress(address: string): boolean;
+/**
+ * Validates that a string is not empty and meets minimum length requirements
+ *
+ * @param value - String to validate
+ * @param minLength - Minimum required length (default: 1)
+ * @returns true if string meets requirements
+ */
+export declare function isValidNonEmptyString(value: string, minLength?: number): boolean;
+/**
+ * Validates UUID format (v4)
+ *
+ * @param uuid - UUID string to validate
+ * @returns true if UUID format is valid
+ */
+export declare function isValidUuid(uuid: string): boolean;
+//# sourceMappingURL=validation.utils.d.ts.map

package/dist/cjs/internal/utils/validation.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.utils.d.ts","sourceRoot":"","sources":["../../../../src/internal/utils/validation.utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CASnD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAM7D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,GAAE,MAAU,GAAG,OAAO,CAEnF;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKjD"}

package/dist/cjs/internal/utils/validation.utils.js

@@ -0,0 +1,76 @@
+"use strict";
+/**
+ * PERS Validation Utilities
+ *
+ * Centralized validation functions for consistent data validation
+ * across all PERS backend modules and domains.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidEmail = isValidEmail;
+exports.isValidWalletAddress = isValidWalletAddress;
+exports.isValidNonEmptyString = isValidNonEmptyString;
+exports.isValidUuid = isValidUuid;
+/**
+ * Validates email format according to RFC standards
+ *
+ * Features:
+ * - RFC-compliant email regex pattern
+ * - RFC 5321 length limit enforcement (254 characters)
+ * - Performance optimized with length check first
+ * - DoS protection against extremely long strings
+ *
+ * @param email - Email address to validate
+ * @returns true if email is valid, false otherwise
+ *
+ * @example
+ * ```typescript
+ * isValidEmail('user@example.com'); // true
+ * isValidEmail('invalid-email'); // false
+ * isValidEmail('a'.repeat(300) + '@example.com'); // false (too long)
+ * ```
+ */
+function isValidEmail(email) {
+    // Quick length check first for performance and RFC 5321 compliance
+    if (!email || email.length > 254) {
+        return false;
+    }
+    // RFC-compliant email regex pattern
+    const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+    return emailRegex.test(email);
+}
+/**
+ * Validates wallet address format
+ *
+ * @param address - Wallet address to validate
+ * @returns true if address format is valid
+ */
+function isValidWalletAddress(address) {
+    if (!address)
+        return false;
+    // Ethereum address format: 0x followed by 40 hexadecimal characters
+    const ethereumAddressRegex = /^0x[a-fA-F0-9]{40}$/;
+    return ethereumAddressRegex.test(address);
+}
+/**
+ * Validates that a string is not empty and meets minimum length requirements
+ *
+ * @param value - String to validate
+ * @param minLength - Minimum required length (default: 1)
+ * @returns true if string meets requirements
+ */
+function isValidNonEmptyString(value, minLength = 1) {
+    return typeof value === 'string' && value.trim().length >= minLength;
+}
+/**
+ * Validates UUID format (v4)
+ *
+ * @param uuid - UUID string to validate
+ * @returns true if UUID format is valid
+ */
+function isValidUuid(uuid) {
+    if (!uuid)
+        return false;
+    const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+    return uuidRegex.test(uuid);
+}
+//# sourceMappingURL=validation.utils.js.map

package/dist/cjs/internal/utils/validation.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.utils.js","sourceRoot":"","sources":["../../../../src/internal/utils/validation.utils.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAqBH,oCASC;AAQD,oDAMC;AASD,sDAEC;AAQD,kCAKC;AAlED;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,YAAY,CAAC,KAAa;IACxC,mEAAmE;IACnE,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,oCAAoC;IACpC,MAAM,UAAU,GAAG,4BAA4B,CAAC;IAChD,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,oBAAoB,CAAC,OAAe;IAClD,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAE3B,oEAAoE;IACpE,MAAM,oBAAoB,GAAG,qBAAqB,CAAC;IACnD,OAAO,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,qBAAqB,CAAC,KAAa,EAAE,YAAoB,CAAC;IACxE,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,IAAI,SAAS,CAAC;AACvE,CAAC;AAED;;;;;GAKG;AACH,SAAgB,WAAW,CAAC,IAAY;IACtC,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IAExB,MAAM,SAAS,GAAG,wEAAwE,CAAC;IAC3F,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC"}

package/dist/esm/index.d.ts

@@ -1,8 +1,6 @@
 export * from './enum';
-export * from './value-objects';
 export * from './interfaces';
 export * from './types';
-export * from './dto';
+export type * from './dto';
 export * from './errors';
-export * from './types/backend';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,QAAQ,CAAC;AACvB,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AAGtB,cAAc,UAAU,CAAC;AAGzB,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,mBAAmB,OAAO,CAAC;AAG3B,cAAc,UAAU,CAAC"}

package/dist/esm/index.js

@@ -2,14 +2,10 @@
 // 🌐 PUBLIC: Safe for external consumption - contains only DTOs, interfaces, types, and enums
 // Core domain contracts
 export * from './enum';
-export * from './value-objects';
 export * from './interfaces';
 export * from './types';
-export * from './dto';
 // Error handling system
 export * from './errors';
-// Backend-only exports (Node.js environment)
-export * from './types/backend';
 // Note: Architecture patterns (orchestrators, database schemas) moved to @explorins/pers-shared-patterns
 // This library now contains only pure data contracts safe for external consumption
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,8FAA8F;AAE9F,wBAAwB;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AAEtB,wBAAwB;AACxB,cAAc,UAAU,CAAC;AAEzB,6CAA6C;AAC7C,cAAc,iBAAiB,CAAC;AAEhC,yGAAyG;AACzG,mFAAmF"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,8FAA8F;AAE9F,wBAAwB;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AAGxB,wBAAwB;AACxB,cAAc,UAAU,CAAC;AAEzB,yGAAyG;AACzG,mFAAmF"}

package/dist/esm/interfaces/token-transaction-input-data.interface.d.ts

@@ -1,6 +1,7 @@
 import type { ContractAbi } from "web3";
 import { Web3TransactionType } from "../enum/transaction-type.enum";
-import { Address, NativeTokenType } from "..";
+import { Address } from "../value-objects";
+import { NativeTokenType } from "..";
 import { AccountOwnerType } from "../enum/owner-type.enum";
 export interface TxParticipants {
     senderAddress: Address;

package/dist/esm/interfaces/token-transaction-input-data.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"token-transaction-input-data.interface.d.ts","sourceRoot":"","sources":["../../../src/interfaces/token-transaction-input-data.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG3D,MAAM,WAAW,cAAc;IAC3B,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACzC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,gBAAgB,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,kBAAkB,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC5C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,0BAA0B;IACvC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,WAAW,EAAE,WAAW,CAAC;IACzB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,cAAc,EAAE,cAAc,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,mBAAmB,CAAC;IAC1B,SAAS,EAAE,eAAe,CAAC;IAG3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC1C"}
+{"version":3,"file":"token-transaction-input-data.interface.d.ts","sourceRoot":"","sources":["../../../src/interfaces/token-transaction-input-data.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,IAAI,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG3D,MAAM,WAAW,cAAc;IAC3B,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACzC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,gBAAgB,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,kBAAkB,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC5C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,0BAA0B;IACvC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,WAAW,EAAE,WAAW,CAAC;IACzB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,cAAc,EAAE,cAAc,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,mBAAmB,CAAC;IAC1B,SAAS,EAAE,eAAe,CAAC;IAG3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC1C"}

package/dist/esm/internal/database/index.d.ts

@@ -0,0 +1,6 @@
+export * from './models/base.model';
+export * from './models/fixture.model';
+export * from './schemas/fixture-fields.schema';
+export * from './schemas/tenant-fields.schema';
+export * from './schemas/shared-fields.schema';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/internal/database/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/internal/database/index.ts"],"names":[],"mappings":"AAEA,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AAIvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC"}

package/dist/esm/internal/database/index.js

@@ -0,0 +1,8 @@
+// Exporting models
+export * from './models/base.model';
+export * from './models/fixture.model';
+// Exporting schemas for shared fields
+export * from './schemas/fixture-fields.schema';
+export * from './schemas/tenant-fields.schema';
+export * from './schemas/shared-fields.schema';
+//# sourceMappingURL=index.js.map

package/dist/esm/internal/database/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/internal/database/index.ts"],"names":[],"mappings":"AACA,mBAAmB;AACnB,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AAGvC,sCAAsC;AACtC,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC"}

package/dist/esm/internal/database/models/base.model.d.ts

@@ -0,0 +1,7 @@
+export declare abstract class BaseModel {
+    id?: string;
+    createdAt?: Date;
+    updatedAt?: Date;
+    deletedAt?: Date;
+}
+//# sourceMappingURL=base.model.d.ts.map

package/dist/esm/internal/database/models/base.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.model.d.ts","sourceRoot":"","sources":["../../../../../src/internal/database/models/base.model.ts"],"names":[],"mappings":"AAAA,8BAAsB,SAAS;IAC7B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB"}

package/dist/esm/internal/database/models/base.model.js

@@ -0,0 +1,7 @@
+export class BaseModel {
+    id;
+    createdAt;
+    updatedAt;
+    deletedAt;
+}
+//# sourceMappingURL=base.model.js.map

package/dist/esm/internal/database/models/base.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.model.js","sourceRoot":"","sources":["../../../../../src/internal/database/models/base.model.ts"],"names":[],"mappings":"AAAA,MAAM,OAAgB,SAAS;IAC7B,EAAE,CAAU;IACZ,SAAS,CAAQ;IACjB,SAAS,CAAQ;IACjB,SAAS,CAAQ;CAClB"}

package/dist/esm/internal/database/models/fixture.model.d.ts

@@ -0,0 +1,4 @@
+export declare abstract class FixtureModel {
+    id?: number;
+}
+//# sourceMappingURL=fixture.model.d.ts.map

package/dist/esm/internal/database/models/fixture.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture.model.d.ts","sourceRoot":"","sources":["../../../../../src/internal/database/models/fixture.model.ts"],"names":[],"mappings":"AAAA,8BAAsB,YAAY;IAChC,EAAE,CAAC,EAAE,MAAM,CAAC;CACb"}

package/dist/esm/internal/database/models/fixture.model.js

@@ -0,0 +1,4 @@
+export class FixtureModel {
+    id;
+}
+//# sourceMappingURL=fixture.model.js.map

package/dist/esm/internal/database/models/fixture.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture.model.js","sourceRoot":"","sources":["../../../../../src/internal/database/models/fixture.model.ts"],"names":[],"mappings":"AAAA,MAAM,OAAgB,YAAY;IAChC,EAAE,CAAU;CACb"}

package/dist/esm/internal/database/schemas/fixture-fields.schema.d.ts

@@ -0,0 +1,5 @@
+import { EntitySchemaColumnOptions } from "typeorm";
+export declare const fixtureFields: {
+    [key: string]: EntitySchemaColumnOptions;
+};
+//# sourceMappingURL=fixture-fields.schema.d.ts.map

package/dist/esm/internal/database/schemas/fixture-fields.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture-fields.schema.d.ts","sourceRoot":"","sources":["../../../../../src/internal/database/schemas/fixture-fields.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAA;AAEnD,eAAO,MAAM,aAAa,EAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAI,yBAAyB,CAAA;CAMvE,CAAC"}

package/dist/esm/internal/database/schemas/fixture-fields.schema.js

@@ -0,0 +1,8 @@
+export const fixtureFields = {
+    id: {
+        type: Number,
+        primary: true,
+        generated: 'increment',
+    },
+};
+//# sourceMappingURL=fixture-fields.schema.js.map

package/dist/esm/internal/database/schemas/fixture-fields.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture-fields.schema.js","sourceRoot":"","sources":["../../../../../src/internal/database/schemas/fixture-fields.schema.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAmD;IAC3E,EAAE,EAAE;QACF,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,WAAW;KACvB;CACF,CAAC"}

package/dist/esm/internal/database/schemas/shared-fields.schema.d.ts

@@ -0,0 +1,44 @@
+import { EntitySchemaColumnOptions } from "typeorm";
+/**
+ * Shared TypeORM Entity Fields
+ *
+ * MANDATORY for ALL TypeORM schemas in PERS Loyalty Backend
+ *
+ * Usage Pattern:
+ * ```typescript
+ * import { sharedFields } from '../../../base/infrastructure/typeorm/shared-fields.schema';
+ *
+ * // For non-tenant entities (system-wide data)
+ * export const SystemSchema = new EntitySchema<SystemModel>({
+ *     columns: {
+ *         ...sharedFields,     // ALWAYS include first
+ *         // entity-specific fields below
+ *     }
+ * });
+ *
+ * // For tenant-specific entities (most common case)
+ * import { tenantFields } from '../../../base/infrastructure/typeorm/multi-tenant-fields.schema';
+ *
+ * export const TenantSchema = new EntitySchema<TenantModel>({
+ *     columns: {
+ *         ...sharedFields,     // ALWAYS include first
+ *         ...tenantFields,     // Include for tenant isolation
+ *         // entity-specific fields below
+ *     },
+ *     indices: [
+ *         {
+ *             name: 'IDX_tenant_entities_tenant_id',
+ *             columns: ['tenantId'],  // REQUIRED for tenant schemas
+ *         },
+ *     ],
+ * });
+ * ```
+ *
+ * Provides: id (UUID), createdAt, updatedAt, deletedAt (soft delete)
+ * Combines with: tenantFields for multi-tenant support
+ * See: /documentation/domain-model-best-practices.md
+ */
+export declare const sharedFields: {
+    [key: string]: EntitySchemaColumnOptions;
+};
+//# sourceMappingURL=shared-fields.schema.d.ts.map

package/dist/esm/internal/database/schemas/shared-fields.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-fields.schema.d.ts","sourceRoot":"","sources":["../../../../../src/internal/database/schemas/shared-fields.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAA;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,eAAO,MAAM,YAAY,EAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAI,yBAAyB,CAAA;CAoBtE,CAAC"}

package/dist/esm/internal/database/schemas/shared-fields.schema.js

@@ -0,0 +1,61 @@
+/**
+ * Shared TypeORM Entity Fields
+ *
+ * MANDATORY for ALL TypeORM schemas in PERS Loyalty Backend
+ *
+ * Usage Pattern:
+ * ```typescript
+ * import { sharedFields } from '../../../base/infrastructure/typeorm/shared-fields.schema';
+ *
+ * // For non-tenant entities (system-wide data)
+ * export const SystemSchema = new EntitySchema<SystemModel>({
+ *     columns: {
+ *         ...sharedFields,     // ALWAYS include first
+ *         // entity-specific fields below
+ *     }
+ * });
+ *
+ * // For tenant-specific entities (most common case)
+ * import { tenantFields } from '../../../base/infrastructure/typeorm/multi-tenant-fields.schema';
+ *
+ * export const TenantSchema = new EntitySchema<TenantModel>({
+ *     columns: {
+ *         ...sharedFields,     // ALWAYS include first
+ *         ...tenantFields,     // Include for tenant isolation
+ *         // entity-specific fields below
+ *     },
+ *     indices: [
+ *         {
+ *             name: 'IDX_tenant_entities_tenant_id',
+ *             columns: ['tenantId'],  // REQUIRED for tenant schemas
+ *         },
+ *     ],
+ * });
+ * ```
+ *
+ * Provides: id (UUID), createdAt, updatedAt, deletedAt (soft delete)
+ * Combines with: tenantFields for multi-tenant support
+ * See: /documentation/domain-model-best-practices.md
+ */
+export const sharedFields = {
+    id: {
+        type: 'uuid',
+        primary: true,
+        generated: 'uuid',
+    },
+    createdAt: {
+        type: Date,
+        createDate: true,
+    },
+    updatedAt: {
+        type: Date,
+        nullable: true,
+        updateDate: true,
+    },
+    deletedAt: {
+        type: Date,
+        nullable: true,
+        deleteDate: true,
+    },
+};
+//# sourceMappingURL=shared-fields.schema.js.map

package/dist/esm/internal/database/schemas/shared-fields.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-fields.schema.js","sourceRoot":"","sources":["../../../../../src/internal/database/schemas/shared-fields.schema.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,CAAC,MAAM,YAAY,GAAmD;IAC1E,EAAE,EAAE;QACF,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,MAAM;KAClB;IACD,SAAS,EAAE;QACT,IAAI,EAAE,IAAI;QACV,UAAU,EAAE,IAAI;KACjB;IACD,SAAS,EAAE;QACT,IAAI,EAAE,IAAI;QACV,QAAQ,EAAE,IAAI;QACd,UAAU,EAAE,IAAI;KACjB;IACD,SAAS,EAAE;QACT,IAAI,EAAE,IAAI;QACV,QAAQ,EAAE,IAAI;QACd,UAAU,EAAE,IAAI;KACjB;CACF,CAAC"}

package/dist/esm/internal/database/schemas/tenant-fields.schema.d.ts

@@ -0,0 +1,51 @@
+import { EntitySchemaColumnOptions } from "typeorm";
+/**
+ * Multi-Tenant TypeORM Entity Fields
+ *
+ * MANDATORY for tenant-specific data in PERS Loyalty Backend
+ *
+ * ✅ ALWAYS INCLUDE tenantFields for:
+ * - User-specific data: SigningAccount, UserWallet, UserProfile, UserPreferences
+ * - Business domain data: Campaign, Redemption, Transaction, TokenBalance
+ * - API keys and authentication: ApiKey, RefreshToken, UserSession
+ * - Tenant-specific configuration: BusinessSettings, CampaignTemplates
+ * - Any data that varies by tenant/client
+ *
+ * ❌ EXCLUDE tenantFields for:
+ * - System-wide shared data: TokenContract, GeolocationData, SystemSettings
+ * - Static reference data: Country codes, currency rates, blockchain configs
+ * - Cross-tenant shared resources (explicitly designed to be shared)
+ *
+ * Usage Pattern:
+ * ```typescript
+ * export const MySchema = new EntitySchema<MyModel>({
+ *     columns: {
+ *         ...sharedFields,     // Base fields (id, timestamps, soft delete)
+ *         ...tenantFields,     // Multi-tenant support (tenantId with RLS)
+ *         // entity-specific fields below
+ *     }
+ * });
+ * ```
+ *
+ * CRITICAL: When using tenantFields, MUST include RLS module:
+ * ```typescript
+ * @Module({
+ *   imports: [
+ *     TypeOrmModule.forFeature([MySchema]),
+ *     RLSModule.forFeature([MySchema]),    // REQUIRED for Row Level Security
+ *   ],
+ * })
+ * ```
+ *
+ * Technical Details:
+ * - Provides: tenantId with RLS (Row Level Security) automatic population
+ * - RLS Function: Uses current_setting('rls.tenant_id') for automatic tenant isolation
+ * - Database-level security: Prevents cross-tenant data leaks automatically
+ * - Transparent filtering: All queries automatically filter by current tenant
+ *
+ * See: /documentation/domain-model-best-practices.md for complete patterns
+ */
+export declare const tenantFields: {
+    [key: string]: EntitySchemaColumnOptions;
+};
+//# sourceMappingURL=tenant-fields.schema.d.ts.map

package/dist/esm/internal/database/schemas/tenant-fields.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-fields.schema.d.ts","sourceRoot":"","sources":["../../../../../src/internal/database/schemas/tenant-fields.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAA;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,eAAO,MAAM,YAAY,EAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAI,yBAAyB,CAAA;CAMtE,CAAC"}