@explorins/pers-shared 2.1.2 → 2.1.8

package/CHANGELOG.md

@@ -1,69 +1,69 @@
-# PERS Shared Library Changelog
-
-## [2.0.17] - 2025-08-22
-
-### 🚨 **CRITICAL: Swagger Compatibility & Architecture Refinement**
-
-#### Fixed
-- **🔥 3-Day Debugging Resolution**: Documented critical `"moduleResolution": "node16"` requirement for NestJS Swagger
-- **Source Tree Cleanup**: Removed compiled JavaScript files from source directories
-- **Build Hygiene**: Enhanced .gitignore to prevent future source pollution
-
-#### Enhanced
-- **Library Focus**: Refined to pure public contracts (DTOs, interfaces, types, enums)
-- **Documentation**: Concise README highlighting critical Swagger compatibility requirements
-- **Architecture Clarity**: Clear separation from private patterns library (@explorins/pers-shared-patterns)
-
-#### Technical Details
-- **Module Resolution**: Requires `"moduleResolution": "node16"` for Swagger compatibility
-- **Build System**: Dual CJS/ESM builds maintained with proper TypeScript alignment
-- **Developer Experience**: Immediate visibility of critical configuration requirements
-
-### Migration Notes
-- **BREAKING**: Ensure main project uses `"moduleResolution": "node16"` in tsconfig.json
-- **Recommended**: Review README for critical Swagger compatibility configuration
-- **No API Changes**: All existing imports and usage patterns remain unchanged
-
----
-
-## [2.0.1] - 2025-08-09
-
-### 🚀 Browser Optimization Release
-
-#### Added
-- **Tree-shaking support**: Added `"sideEffects": false` for optimal bundle elimination
-- **Bundle size monitoring**: Custom Node.js script with gzip compression analysis
-- **Browser optimization scripts**: Added `size`, `size:analyze`, and `bundle:analyze` commands
-- **Bundle size limits**: Enforced limits for browser (20KB), ESM (50KB), and CJS (50KB) bundles
-- **Enhanced file distribution**: Added README.md and CHANGELOG.md to published files
-- **Browser optimization documentation**: Complete guide for frontend usage patterns
-
-#### Enhanced
-- **Build process**: Updated `prepublishOnly` to include bundle size validation
-- **Package metadata**: Improved package.json structure for better tooling support  
-- **Bundle size script**: Custom Node.js implementation for accurate size monitoring
-
-#### Browser Performance Improvements
-- **Optimized entry points**: Browser-specific builds exclude server dependencies
-- **Type-only exports**: Reduced runtime overhead for interface imports
-- **Gzip analysis**: Bundle size limits include gzip compression analysis
-- **CI/CD integration**: Automated size checking prevents bundle size regression
-
-### Technical Details
-- Bundle size monitoring with custom Node.js script and gzip analysis
-- Browser bundle optimized for <20KB raw size
-- Full backwards compatibility with existing ESM/CJS builds
-- Enhanced developer experience with detailed bundle size reporting
-
-### Migration Notes
-- No breaking changes - fully backwards compatible
-- Recommended: Use `/browser` entry point for frontend applications
-- Optional: Leverage new bundle analysis tools for optimization insights
-
----
-
-## [2.0.0] - Previous Release
-- Initial dual build system (ESM/CJS)
-- Browser-specific entry point
-- Comprehensive TypeScript support
-- NestJS integration patterns
+# PERS Shared Library Changelog
+
+## [2.0.17] - 2025-08-22
+
+### 🚨 **CRITICAL: Swagger Compatibility & Architecture Refinement**
+
+#### Fixed
+- **🔥 3-Day Debugging Resolution**: Documented critical `"moduleResolution": "node16"` requirement for NestJS Swagger
+- **Source Tree Cleanup**: Removed compiled JavaScript files from source directories
+- **Build Hygiene**: Enhanced .gitignore to prevent future source pollution
+
+#### Enhanced
+- **Library Focus**: Refined to pure public contracts (DTOs, interfaces, types, enums)
+- **Documentation**: Concise README highlighting critical Swagger compatibility requirements
+- **Architecture Clarity**: Clear separation from private patterns library (@explorins/pers-shared-patterns)
+
+#### Technical Details
+- **Module Resolution**: Requires `"moduleResolution": "node16"` for Swagger compatibility
+- **Build System**: Dual CJS/ESM builds maintained with proper TypeScript alignment
+- **Developer Experience**: Immediate visibility of critical configuration requirements
+
+### Migration Notes
+- **BREAKING**: Ensure main project uses `"moduleResolution": "node16"` in tsconfig.json
+- **Recommended**: Review README for critical Swagger compatibility configuration
+- **No API Changes**: All existing imports and usage patterns remain unchanged
+
+---
+
+## [2.0.1] - 2025-08-09
+
+### 🚀 Browser Optimization Release
+
+#### Added
+- **Tree-shaking support**: Added `"sideEffects": false` for optimal bundle elimination
+- **Bundle size monitoring**: Custom Node.js script with gzip compression analysis
+- **Browser optimization scripts**: Added `size`, `size:analyze`, and `bundle:analyze` commands
+- **Bundle size limits**: Enforced limits for browser (20KB), ESM (50KB), and CJS (50KB) bundles
+- **Enhanced file distribution**: Added README.md and CHANGELOG.md to published files
+- **Browser optimization documentation**: Complete guide for frontend usage patterns
+
+#### Enhanced
+- **Build process**: Updated `prepublishOnly` to include bundle size validation
+- **Package metadata**: Improved package.json structure for better tooling support  
+- **Bundle size script**: Custom Node.js implementation for accurate size monitoring
+
+#### Browser Performance Improvements
+- **Optimized entry points**: Browser-specific builds exclude server dependencies
+- **Type-only exports**: Reduced runtime overhead for interface imports
+- **Gzip analysis**: Bundle size limits include gzip compression analysis
+- **CI/CD integration**: Automated size checking prevents bundle size regression
+
+### Technical Details
+- Bundle size monitoring with custom Node.js script and gzip analysis
+- Browser bundle optimized for <20KB raw size
+- Full backwards compatibility with existing ESM/CJS builds
+- Enhanced developer experience with detailed bundle size reporting
+
+### Migration Notes
+- No breaking changes - fully backwards compatible
+- Recommended: Use `/browser` entry point for frontend applications
+- Optional: Leverage new bundle analysis tools for optimization insights
+
+---
+
+## [2.0.0] - Previous Release
+- Initial dual build system (ESM/CJS)
+- Browser-specific entry point
+- Comprehensive TypeScript support
+- NestJS integration patterns

package/README.md

@@ -1,51 +1,51 @@
-# @explorins/pers-shared
-
-## 🎯 **Public Contracts Library**
-
-Pure data contracts for frontends, third-party integrations, and API consumers.
-
-## � **Contents**
-- **DTOs** - API data transfer objects
-- **Interfaces** - TypeScript type contracts  
-- **Types & Enums** - Type definitions
-- **Value Objects** - Immutable data structures
-
-## 🚨 **Critical Build Configuration**
-
-**⚠️ SWAGGER COMPATIBILITY ISSUE**: This library requires `"moduleResolution": "node16"` in tsconfig.json to prevent circular dependency errors with NestJS Swagger. Using `"node"` caused 3 days of debugging for Swagger generation failures.
-
-```json
-{
-  "compilerOptions": {
-    "moduleResolution": "node16", // CRITICAL: Required for Swagger compatibility
-    "target": "ES2022",
-    "module": "CommonJS"
-  }
-}
-```
-
-## 🏗️ **Architecture**
-
-**Public Contracts** (this library) vs **Private Patterns** (pers-shared-patterns):
-- ✅ **Public**: Pure DTOs, interfaces, types safe for external consumption
-- ❌ **Private**: Business logic, database schemas, internal patterns
-
-## 📦 **Usage**
-
-```bash
-npm install @explorins/pers-shared
-```
-
-```typescript
-// Backend/Node.js
-import { UserDTO, TransactionStatus } from '@explorins/pers-shared';
-
-// Browser/Frontend (ESM optimized)
-import { UserDTO } from '@explorins/pers-shared/browser';
-```
-
-## 🔧 **Build System**
-
-- **CommonJS**: Backend compatibility & Swagger support
-- **ESM**: Browser optimization & tree-shaking
-- **Dual builds**: Automatic via `npm run build`
+# @explorins/pers-shared
+
+## 🎯 **Public Contracts Library**
+
+Pure data contracts for frontends, third-party integrations, and API consumers.
+
+## � **Contents**
+- **DTOs** - API data transfer objects
+- **Interfaces** - TypeScript type contracts  
+- **Types & Enums** - Type definitions
+- **Value Objects** - Immutable data structures
+
+## 🚨 **Critical Build Configuration**
+
+**⚠️ SWAGGER COMPATIBILITY ISSUE**: This library requires `"moduleResolution": "node16"` in tsconfig.json to prevent circular dependency errors with NestJS Swagger. Using `"node"` caused 3 days of debugging for Swagger generation failures.
+
+```json
+{
+  "compilerOptions": {
+    "moduleResolution": "node16", // CRITICAL: Required for Swagger compatibility
+    "target": "ES2022",
+    "module": "CommonJS"
+  }
+}
+```
+
+## 🏗️ **Architecture**
+
+**Public Contracts** (this library) vs **Private Patterns** (pers-shared-patterns):
+- ✅ **Public**: Pure DTOs, interfaces, types safe for external consumption
+- ❌ **Private**: Business logic, database schemas, internal patterns
+
+## 📦 **Usage**
+
+```bash
+npm install @explorins/pers-shared
+```
+
+```typescript
+// Backend/Node.js
+import { UserDTO, TransactionStatus } from '@explorins/pers-shared';
+
+// Browser/Frontend (ESM optimized)
+import { UserDTO } from '@explorins/pers-shared/browser';
+```
+
+## 🔧 **Build System**
+
+- **CommonJS**: Backend compatibility & Swagger support
+- **ESM**: Browser optimization & tree-shaking
+- **Dual builds**: Automatic via `npm run build`

package/dist/cjs/dto/account-selector.dto.d.ts

@@ -5,7 +5,7 @@ import { AccountOwnerType } from "../enum";
  */
 export declare class AccountSelectorDTO {
     accountId?: string;
-    accountType?: AccountOwnerType;
+    accountType: AccountOwnerType;
     accountAddress?: string;
 }
 //# sourceMappingURL=account-selector.dto.d.ts.map

package/dist/cjs/dto/account-selector.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"account-selector.dto.d.ts","sourceRoot":"","sources":["../../../src/dto/account-selector.dto.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAG3C;;;GAGG;AACH,qBAAa,kBAAkB;IAQ3B,SAAS,CAAC,EAAE,MAAM,CAAC;IASnB,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAS/B,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B"}
+{"version":3,"file":"account-selector.dto.d.ts","sourceRoot":"","sources":["../../../src/dto/account-selector.dto.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C;;;GAGG;AACH,qBAAa,kBAAkB;IAQ3B,SAAS,CAAC,EAAE,MAAM,CAAC;IAQnB,WAAW,EAAE,gBAAgB,CAAyB;IAStD,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B"}

package/dist/cjs/dto/account-selector.dto.js

@@ -19,7 +19,7 @@ const enum_1 = require("../enum");
  */
 class AccountSelectorDTO {
     accountId;
-    accountType;
+    accountType = enum_1.AccountOwnerType.USER;
     accountAddress;
 }
 exports.AccountSelectorDTO = AccountSelectorDTO;
@@ -34,12 +34,11 @@ __decorate([
     __metadata("design:type", String)
 ], AccountSelectorDTO.prototype, "accountId", void 0);
 __decorate([
-    (0, swagger_1.ApiPropertyOptional)({
-        description: 'Account type (optional - auto-detected from accountId if not provided)',
+    (0, swagger_1.ApiProperty)({
+        description: 'Account type ',
         enum: enum_1.AccountOwnerType,
         example: enum_1.AccountOwnerType.USER
     }),
-    (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsEnum)(enum_1.AccountOwnerType),
     __metadata("design:type", String)
 ], AccountSelectorDTO.prototype, "accountType", void 0);

package/dist/cjs/dto/account-selector.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"account-selector.dto.js","sourceRoot":"","sources":["../../../src/dto/account-selector.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,6CAAsD;AACtD,qDAA+D;AAC/D,kCAA2C;AAG3C;;;GAGG;AACH,MAAa,kBAAkB;IAQ3B,SAAS,CAAU;IASnB,WAAW,CAAoB;IAS/B,cAAc,CAAU;CAC3B;AA3BD,gDA2BC;AAnBG;IAPC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,0EAA0E;QACvF,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,MAAM;KACf,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;qDACQ;AASnB;IAPC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,wEAAwE;QACrF,IAAI,EAAE,uBAAgB;QACtB,OAAO,EAAE,uBAAgB,CAAC,IAAI;KACjC,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,wBAAM,EAAC,uBAAgB,CAAC;;uDACM;AAS/B;IAPC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,2DAA2D;QACxE,OAAO,EAAE,4CAA4C;QACrD,IAAI,EAAE,MAAM;KACf,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;0DACa"}
+{"version":3,"file":"account-selector.dto.js","sourceRoot":"","sources":["../../../src/dto/account-selector.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,6CAAmE;AACnE,qDAA+D;AAC/D,kCAA2C;AAE3C;;;GAGG;AACH,MAAa,kBAAkB;IAQ3B,SAAS,CAAU;IAQnB,WAAW,GAAqB,uBAAgB,CAAC,IAAI,CAAC;IAStD,cAAc,CAAU;CAC3B;AA1BD,gDA0BC;AAlBG;IAPC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,0EAA0E;QACvF,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,MAAM;KACf,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;qDACQ;AAQnB;IANC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,eAAe;QAC5B,IAAI,EAAE,uBAAgB;QACtB,OAAO,EAAE,uBAAgB,CAAC,IAAI;KACjC,CAAC;IACD,IAAA,wBAAM,EAAC,uBAAgB,CAAC;;uDAC6B;AAStD;IAPC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,2DAA2D;QACxE,OAAO,EAAE,4CAA4C;QACrD,IAAI,EAAE,MAAM;KACf,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;0DACa"}

package/dist/cjs/dto/campaign/campaign-business-engagement.request.dto.d.ts

@@ -1,7 +1,7 @@
 export declare class CampaignBusinessEngagementCreateRequestDTO {
     businessIds: string[];
     shortDescription?: string;
-    maxPerBussiness?: number;
+    maxPerBusiness?: number;
     maxPerDay?: number;
     externalUrl?: string;
 }

package/dist/cjs/dto/campaign/campaign-business-engagement.request.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"campaign-business-engagement.request.dto.d.ts","sourceRoot":"","sources":["../../../../src/dto/campaign/campaign-business-engagement.request.dto.ts"],"names":[],"mappings":"AAGA,qBAAa,0CAA0C;IAKnD,WAAW,EAAE,MAAM,EAAE,CAAM;IAK3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAK1B,eAAe,CAAC,EAAE,MAAM,CAAA;IAKxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAKlB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB"}
+{"version":3,"file":"campaign-business-engagement.request.dto.d.ts","sourceRoot":"","sources":["../../../../src/dto/campaign/campaign-business-engagement.request.dto.ts"],"names":[],"mappings":"AAGA,qBAAa,0CAA0C;IAKnD,WAAW,EAAE,MAAM,EAAE,CAAM;IAK3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAK1B,cAAc,CAAC,EAAE,MAAM,CAAA;IAKvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAKlB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/cjs/dto/campaign/campaign-business-engagement.request.dto.js

@@ -14,7 +14,7 @@ const swagger_1 = require("@nestjs/swagger");
 class CampaignBusinessEngagementCreateRequestDTO {
     businessIds = [];
     shortDescription;
-    maxPerBussiness;
+    maxPerBusiness;
     maxPerDay;
     externalUrl;
 }
@@ -36,7 +36,7 @@ __decorate([
         description: 'max per user at the business',
     }),
     __metadata("design:type", Number)
-], CampaignBusinessEngagementCreateRequestDTO.prototype, "maxPerBussiness", void 0);
+], CampaignBusinessEngagementCreateRequestDTO.prototype, "maxPerBusiness", void 0);
 __decorate([
     (0, swagger_1.ApiPropertyOptional)({
         description: 'max per day, the maximum number of times a user can engage with the buisness in the campaign per day',

package/dist/cjs/dto/campaign/campaign-business-engagement.request.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"campaign-business-engagement.request.dto.js","sourceRoot":"","sources":["../../../../src/dto/campaign/campaign-business-engagement.request.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6CAAmE;AAGnE,MAAa,0CAA0C;IAKnD,WAAW,GAAa,EAAE,CAAC;IAK3B,gBAAgB,CAAU;IAK1B,eAAe,CAAS;IAKxB,SAAS,CAAS;IAKlB,WAAW,CAAU;CACxB;AA1BD,gGA0BC;AArBG;IAHC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,iCAAiC;KACjD,CAAC;;+EACyB;AAK3B;IAHC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,iFAAiF;KACjG,CAAC;;oFACwB;AAK1B;IAHC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,8BAA8B;KAC9C,CAAC;;mFACsB;AAKxB;IAHC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,sGAAsG;KACtH,CAAC;;6EACgB;AAKlB;IAHC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,+EAA+E;KAC/F,CAAC;;+EACmB"}
+{"version":3,"file":"campaign-business-engagement.request.dto.js","sourceRoot":"","sources":["../../../../src/dto/campaign/campaign-business-engagement.request.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6CAAmE;AAGnE,MAAa,0CAA0C;IAKnD,WAAW,GAAa,EAAE,CAAC;IAK3B,gBAAgB,CAAU;IAK1B,cAAc,CAAS;IAKvB,SAAS,CAAS;IAKlB,WAAW,CAAU;CACxB;AA1BD,gGA0BC;AArBG;IAHC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,iCAAiC;KACjD,CAAC;;+EACyB;AAK3B;IAHC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,iFAAiF;KACjG,CAAC;;oFACwB;AAK1B;IAHC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,8BAA8B;KAC9C,CAAC;;kFACqB;AAKvB;IAHC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,sGAAsG;KACtH,CAAC;;6EACgB;AAKlB;IAHC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,+EAA+E;KAC/F,CAAC;;+EACmB"}

package/dist/cjs/dto/error-response.dto.d.ts

@@ -0,0 +1,54 @@
+import { ErrorCategory } from "../errors/base/error-classification-enums";
+import { CommonErrorCode } from "../errors/error-codes";
+/**
+ * Error details object for API responses
+ *
+ * This DTO defines the structure of error responses for automatic Swagger documentation.
+ * All API endpoints should use this format for consistent error handling.
+ *
+ * Type-safe with actual enums from the error system.
+ */
+export declare class ErrorDetailsDTO {
+    code: CommonErrorCode;
+    message: string;
+    category: ErrorCategory;
+    correlationId: string;
+    timestamp: string;
+    domain?: string;
+    developerMessage?: string;
+    action?: string;
+    retryable?: boolean;
+}
+/**
+ * Standard error response wrapper for all API error responses
+ *
+ * This is the top-level response structure used by the enhanced error interceptor.
+ * Use this DTO in OpenAPI decorators for consistent API documentation.
+ *
+ * @example
+ * ```typescript
+ * @ApiResponse({
+ *   status: 404,
+ *   description: 'User not found',
+ *   type: ErrorResponseDTO
+ * })
+ * async getUser(@Param('id') id: string) {
+ *   // Implementation here
+ * }
+ * ```
+ */
+export declare class ErrorResponseDTO {
+    error: ErrorDetailsDTO;
+}
+/**
+ * Simplified error response for basic HTTP errors
+ *
+ * Use this for simpler error scenarios where only basic information is needed.
+ * Primarily for backward compatibility with existing API documentation.
+ */
+export declare class SimpleErrorResponseDTO {
+    message: string;
+    statusCode: number;
+    timestamp: string;
+}
+//# sourceMappingURL=error-response.dto.d.ts.map

package/dist/cjs/dto/error-response.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-response.dto.d.ts","sourceRoot":"","sources":["../../../src/dto/error-response.dto.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAC1E,OAAO,EAAoB,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE1E;;;;;;;GAOG;AACH,qBAAa,eAAe;IAMxB,IAAI,EAAE,eAAe,CAAmC;IAOxD,OAAO,EAAE,MAAM,CAAM;IAQrB,QAAQ,EAAE,aAAa,CAAyB;IAOhD,aAAa,EAAE,MAAM,CAAM;IAQ3B,SAAS,EAAE,MAAM,CAAM;IAQvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAQhB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAQ1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAQhB,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,gBAAgB;IAKzB,KAAK,EAAE,eAAe,CAAyB;CAClD;AAED;;;;;GAKG;AACH,qBAAa,sBAAsB;IAM/B,OAAO,EAAE,MAAM,CAAM;IAQrB,UAAU,EAAE,MAAM,CAAO;IAQzB,SAAS,EAAE,MAAM,CAAM;CAC1B"}

package/dist/cjs/dto/error-response.dto.js

@@ -0,0 +1,181 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SimpleErrorResponseDTO = exports.ErrorResponseDTO = exports.ErrorDetailsDTO = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const error_classification_enums_1 = require("../errors/base/error-classification-enums");
+const error_codes_1 = require("../errors/error-codes");
+/**
+ * Error details object for API responses
+ *
+ * This DTO defines the structure of error responses for automatic Swagger documentation.
+ * All API endpoints should use this format for consistent error handling.
+ *
+ * Type-safe with actual enums from the error system.
+ */
+class ErrorDetailsDTO {
+    code = error_codes_1.CommonErrorCodes.INTERNAL_ERROR;
+    message = '';
+    category = error_classification_enums_1.ErrorCategory.UNKNOWN;
+    correlationId = '';
+    timestamp = '';
+    domain;
+    developerMessage;
+    action;
+    retryable;
+}
+exports.ErrorDetailsDTO = ErrorDetailsDTO;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Error code identifying the specific type of error',
+        example: error_codes_1.CommonErrorCodes.USER_NOT_FOUND,
+        type: String
+    }),
+    __metadata("design:type", String)
+], ErrorDetailsDTO.prototype, "code", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Human-readable error message for end users',
+        example: 'User not found with the specified identifier',
+        type: String
+    }),
+    __metadata("design:type", String)
+], ErrorDetailsDTO.prototype, "message", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Error category for classification and handling',
+        enum: error_classification_enums_1.ErrorCategory,
+        example: error_classification_enums_1.ErrorCategory.DOMAIN_RULE,
+        type: String
+    }),
+    __metadata("design:type", String)
+], ErrorDetailsDTO.prototype, "category", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Unique correlation ID for request tracing and debugging',
+        example: 'pers-1234567890-abc123',
+        type: String
+    }),
+    __metadata("design:type", String)
+], ErrorDetailsDTO.prototype, "correlationId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Timestamp when the error occurred',
+        example: '2024-01-01T00:00:00.000Z',
+        type: String,
+        format: 'date-time'
+    }),
+    __metadata("design:type", String)
+], ErrorDetailsDTO.prototype, "timestamp", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Domain context where the error occurred',
+        example: 'user',
+        type: String,
+        required: false
+    }),
+    __metadata("design:type", String)
+], ErrorDetailsDTO.prototype, "domain", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Additional developer information (not always present)',
+        example: 'Database query failed: connection timeout',
+        type: String,
+        required: false
+    }),
+    __metadata("design:type", String)
+], ErrorDetailsDTO.prototype, "developerMessage", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Suggested action for the user (not always present)',
+        example: 'Please verify the user identifier and try again',
+        type: String,
+        required: false
+    }),
+    __metadata("design:type", String)
+], ErrorDetailsDTO.prototype, "action", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Whether the operation can be safely retried',
+        example: false,
+        type: Boolean,
+        required: false
+    }),
+    __metadata("design:type", Boolean)
+], ErrorDetailsDTO.prototype, "retryable", void 0);
+/**
+ * Standard error response wrapper for all API error responses
+ *
+ * This is the top-level response structure used by the enhanced error interceptor.
+ * Use this DTO in OpenAPI decorators for consistent API documentation.
+ *
+ * @example
+ * ```typescript
+ * @ApiResponse({
+ *   status: 404,
+ *   description: 'User not found',
+ *   type: ErrorResponseDTO
+ * })
+ * async getUser(@Param('id') id: string) {
+ *   // Implementation here
+ * }
+ * ```
+ */
+class ErrorResponseDTO {
+    error = new ErrorDetailsDTO();
+}
+exports.ErrorResponseDTO = ErrorResponseDTO;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Error details object containing all error information',
+        type: ErrorDetailsDTO
+    }),
+    __metadata("design:type", ErrorDetailsDTO)
+], ErrorResponseDTO.prototype, "error", void 0);
+/**
+ * Simplified error response for basic HTTP errors
+ *
+ * Use this for simpler error scenarios where only basic information is needed.
+ * Primarily for backward compatibility with existing API documentation.
+ */
+class SimpleErrorResponseDTO {
+    message = '';
+    statusCode = 500;
+    timestamp = '';
+}
+exports.SimpleErrorResponseDTO = SimpleErrorResponseDTO;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Error message',
+        example: 'User not found',
+        type: String
+    }),
+    __metadata("design:type", String)
+], SimpleErrorResponseDTO.prototype, "message", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'HTTP status code',
+        enum: [400, 401, 403, 404, 409, 422, 429, 500, 503, 504],
+        example: 404,
+        type: Number
+    }),
+    __metadata("design:type", Number)
+], SimpleErrorResponseDTO.prototype, "statusCode", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Timestamp of the error',
+        example: '2024-01-01T00:00:00.000Z',
+        type: String,
+        format: 'date-time'
+    }),
+    __metadata("design:type", String)
+], SimpleErrorResponseDTO.prototype, "timestamp", void 0);
+//# sourceMappingURL=error-response.dto.js.map

package/dist/cjs/dto/error-response.dto.js.map

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

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

@@ -7,22 +7,17 @@ export * from './user.dto';
 export * from './user.request.dto';
 export * from './user-status-type.dto';
 export * from './userUploadData.dto';
+export * from './error-response.dto';
 export * from './account-token-balances.dto';
 export * from './admin.dto';
 export * from './web3-contract.dto';
 export * from './url.request.dto';
 export * from './tag.dto';
 export * from './wallet.dto';
-export * from './token/token-balance.dto';
-export * from './token/token.dto';
-export * from './token/token-metadata.dto';
-export * from './token/token-unit.dto';
+export * from './token';
 export * from './transaction';
-export * from './redemption/redemption.dto';
-export * from './redemption/redemptionCreate.request.dto';
-export * from './redemption/redemptionRedeem.request.dto';
-export * from './redemption/redemptionType.dto';
-export * from './redemption/redemptionUserRedeem.dto';
+export * from './purchase';
+export * from './redemption';
 export * from './campaign/campaign.dto';
 export * from './campaign/campaignCreate.request.dto';
 export * from './campaign/campaignClaim.request.dto';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/dto/index.ts"],"names":[],"mappings":"AAKA,cAAc,qCAAqC,CAAC;AAGpD,cAAc,YAAY,CAAC;AAG3B,cAAc,YAAY,CAAA;AAG1B,cAAc,cAAc,CAAC;AAC7B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAG7B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AAGvC,cAAc,eAAe,CAAC;AAI9B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2CAA2C,CAAC;AAC1D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AAGtD,cAAc,yBAAyB,CAAC;AACxC,cAAc,uCAAuC,CAAC;AACtD,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yCAAyC,CAAC;AACxD,cAAc,kCAAkC,CAAC;AACjD,cAAc,qDAAqD,CAAC;AACpE,cAAc,6CAA6C,CAAC;AAI5D,cAAc,mBAAmB,CAAA;AAGjC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/dto/index.ts"],"names":[],"mappings":"AAKA,cAAc,qCAAqC,CAAC;AAGpD,cAAc,YAAY,CAAC;AAG3B,cAAc,YAAY,CAAA;AAG1B,cAAc,cAAc,CAAC;AAC7B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAG7B,cAAc,SAAS,CAAC;AAGxB,cAAc,eAAe,CAAC;AAG9B,cAAc,YAAY,CAAC;AAI3B,cAAc,cAAc,CAAC;AAG7B,cAAc,yBAAyB,CAAC;AACxC,cAAc,uCAAuC,CAAC;AACtD,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yCAAyC,CAAC;AACxD,cAAc,kCAAkC,CAAC;AACjD,cAAc,qDAAqD,CAAC;AACpE,cAAc,6CAA6C,CAAC;AAI5D,cAAc,mBAAmB,CAAA;AAGjC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,cAAc,CAAC"}

package/dist/cjs/dto/index.js

@@ -29,6 +29,8 @@ __exportStar(require("./user.dto"), exports);
 __exportStar(require("./user.request.dto"), exports);
 __exportStar(require("./user-status-type.dto"), exports);
 __exportStar(require("./userUploadData.dto"), exports);
+// Error Response DTOs
+__exportStar(require("./error-response.dto"), exports);
 __exportStar(require("./account-token-balances.dto"), exports);
 __exportStar(require("./admin.dto"), exports);
 __exportStar(require("./web3-contract.dto"), exports);
@@ -36,18 +38,13 @@ __exportStar(require("./url.request.dto"), exports);
 __exportStar(require("./tag.dto"), exports);
 __exportStar(require("./wallet.dto"), exports);
 // Token DTOs
-__exportStar(require("./token/token-balance.dto"), exports);
-__exportStar(require("./token/token.dto"), exports);
-__exportStar(require("./token/token-metadata.dto"), exports);
-__exportStar(require("./token/token-unit.dto"), exports);
+__exportStar(require("./token"), exports);
 // Transaction DTOs
 __exportStar(require("./transaction"), exports);
+// Purchase DTOs
+__exportStar(require("./purchase"), exports);
 // Redemption DTOs
-__exportStar(require("./redemption/redemption.dto"), exports);
-__exportStar(require("./redemption/redemptionCreate.request.dto"), exports);
-__exportStar(require("./redemption/redemptionRedeem.request.dto"), exports);
-__exportStar(require("./redemption/redemptionType.dto"), exports);
-__exportStar(require("./redemption/redemptionUserRedeem.dto"), exports);
+__exportStar(require("./redemption"), exports);
 // Campaign DTOs
 __exportStar(require("./campaign/campaign.dto"), exports);
 __exportStar(require("./campaign/campaignCreate.request.dto"), exports);