@explorins/pers-shared 2.1.35 → 2.1.37

package/dist/cjs/shared-patterns/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/shared-patterns/utils/validation.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.utils.d.ts","sourceRoot":"","sources":["../../../../src/shared-patterns/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/shared-patterns/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/shared-patterns/utils/validation.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.utils.js","sourceRoot":"","sources":["../../../../src/shared-patterns/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

@@ -3,4 +3,6 @@ export type * from './shared-lib/interfaces';
 export type * from './shared-lib/types';
 export type * from './shared-lib/dto';
 export type * from './shared-lib/errors';
+export * from './shared-lib/errors';
+export * from './shared-patterns';
 //# 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,mBAAmB,CAAC;AAClC,mBAAmB,yBAAyB,CAAC;AAC7C,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,kBAAkB,CAAC;AAGtC,mBAAmB,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,mBAAmB,CAAC;AAClC,mBAAmB,yBAAyB,CAAC;AAC7C,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,kBAAkB,CAAC;AAGtC,mBAAmB,qBAAqB,CAAC;AACzC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,mBAAmB,CAAC"}

package/dist/esm/index.js

@@ -2,6 +2,9 @@
 // 🌐 PUBLIC: Safe for external consumption - contains only DTOs, interfaces, types, and enums
 // Core domain contracts
 export * from './shared-lib/enum';
-// Note: Architecture patterns (orchestrators, database schemas) moved to @explorins/pers-shared-patterns
-// This library now contains only pure data contracts safe for external consumption
+export * from './shared-lib/errors'; // Export actual error classes and functions
+// Shared patterns (architecture components)
+export * from './shared-patterns';
+// Note: This library contains both pure data contracts and internal architecture patterns
+// External consumers should only use the type exports and documented public APIs
 //# 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,mBAAmB,CAAC;AAQlC,yGAAyG;AACzG,mFAAmF"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,8FAA8F;AAE9F,wBAAwB;AACxB,cAAc,mBAAmB,CAAC;AAOlC,cAAc,qBAAqB,CAAC,CAAC,4CAA4C;AAEjF,4CAA4C;AAC5C,cAAc,mBAAmB,CAAC;AAElC,0FAA0F;AAC1F,iFAAiF"}

package/dist/esm/shared-lib/dto/auth.dto.d.ts

@@ -9,9 +9,8 @@ export declare class SessionAuthRequestDTO {
 export declare class RefreshTokenRequestDTO {
     refreshToken: string;
 }
-export declare class SessionAuthResponseDTO {
+export declare class SessionAuthResponseDTO extends RefreshTokenRequestDTO {
     accessToken: string;
-    refreshToken: string;
 }
 export declare class SessionAuthContextResponseDTO extends SessionAuthResponseDTO {
     admin?: AdminDTO;

package/dist/esm/shared-lib/dto/auth.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.dto.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/dto/auth.dto.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAG,WAAW,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,qBAAa,qBAAqB;IAQ9B,SAAS,EAAE,MAAM,CAAM;IAQvB,QAAQ,CAAC,EAAE,gBAAgB,CAAyB;CACvD;AAGD,qBAAa,sBAAsB;IAO/B,YAAY,EAAE,MAAM,CAAM;CAC7B;AAGD,qBAAa,sBAAsB;IAQ/B,WAAW,EAAE,MAAM,CAAM;IAQzB,YAAY,EAAE,MAAM,CAAM;CAEzB;AAEL,qBAAa,6BAA8B,SAAQ,sBAAsB;IAKrE,KAAK,CAAC,EAAE,QAAQ,CAAC;IAMjB,IAAI,CAAC,EAAE,OAAO,CAAC;IAMf,QAAQ,CAAC,EAAE,WAAW,CAAC;IAQvB,QAAQ,EAAE,gBAAgB,CAAyB;CACtD"}
+{"version":3,"file":"auth.dto.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/dto/auth.dto.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAG,WAAW,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,qBAAa,qBAAqB;IAQ9B,SAAS,EAAE,MAAM,CAAM;IAQvB,QAAQ,CAAC,EAAE,gBAAgB,CAAyB;CACvD;AAGD,qBAAa,sBAAsB;IAO/B,YAAY,EAAE,MAAM,CAAM;CAC7B;AAGD,qBAAa,sBAAuB,SAAQ,sBAAsB;IAQ9D,WAAW,EAAE,MAAM,CAAM;CAUxB;AAEL,qBAAa,6BAA8B,SAAQ,sBAAsB;IAKrE,KAAK,CAAC,EAAE,QAAQ,CAAC;IAMjB,IAAI,CAAC,EAAE,OAAO,CAAC;IAMf,QAAQ,CAAC,EAAE,WAAW,CAAC;IAQvB,QAAQ,EAAE,gBAAgB,CAAyB;CACtD"}

package/dist/esm/shared-lib/dto/auth.dto.js

@@ -43,9 +43,8 @@ __decorate([
     IsNotEmpty(),
     IsString()
 ], RefreshTokenRequestDTO.prototype, "refreshToken", void 0);
-export class SessionAuthResponseDTO {
+export class SessionAuthResponseDTO extends RefreshTokenRequestDTO {
     accessToken = '';
-    refreshToken = '';
 }
 __decorate([
     ApiProperty({
@@ -54,13 +53,6 @@ __decorate([
     IsNotEmpty(),
     IsString()
 ], SessionAuthResponseDTO.prototype, "accessToken", void 0);
-__decorate([
-    ApiProperty({
-        description: 'JWT refresh token this token is used to get a new access token when the current one expires. It is valid for 1 day.',
-    }),
-    IsNotEmpty(),
-    IsString()
-], SessionAuthResponseDTO.prototype, "refreshToken", void 0);
 export class SessionAuthContextResponseDTO extends SessionAuthResponseDTO {
     admin;
     user;

package/dist/esm/shared-lib/dto/auth.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"auth.dto.js","sourceRoot":"","sources":["../../../../src/shared-lib/dto/auth.dto.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAG,WAAW,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,MAAM,OAAO,qBAAqB;IAQ9B,SAAS,GAAW,EAAE,CAAC;IAQvB,AADA,4BAA4B;IAC5B,QAAQ,GAAsB,gBAAgB,CAAC,IAAI,CAAC;CACvD;AATG;IAPC,WAAW,CAAC;QACT,WAAW,EAAE,qEAAqE;QAClF,OAAO,EAAE,yCAAyC;QAClD,IAAI,EAAE,MAAM;KACf,CAAC;IACD,UAAU,EAAE;IACZ,QAAQ,EAAE;wDACY;AAQvB;IANC,mBAAmB,CAAC;QACjB,WAAW,EAAE,iFAAiF;QAC9F,0BAA0B;QAC1B,IAAI,EAAE,gBAAgB;KACzB,CAAC;IACF,4BAA4B;uDACwB;AAIxD,MAAM,OAAO,sBAAsB;IAO/B,YAAY,GAAW,EAAE,CAAC;CAC7B;AADG;IANC,WAAW,CAAC;QACT,WAAW,EAAE,eAAe;QAC5B,OAAO,EAAE,sJAAsJ;KAClK,CAAC;IACD,UAAU,EAAE;IACZ,QAAQ,EAAE;4DACe;AAI9B,MAAM,OAAO,sBAAsB;IAQ/B,WAAW,GAAW,EAAE,CAAC;IAQzB,YAAY,GAAW,EAAE,CAAC;CAEzB;AAVD;IAPC,WAAW,CACR;QACI,WAAW,EAAE,uKAAuK;KACvL,CACJ;IACA,UAAU,EAAE;IACZ,QAAQ,EAAE;2DACc;AAQzB;IANC,WAAW,CACR;QACI,WAAW,EAAE,qHAAqH;KACrI,CAAC;IACD,UAAU,EAAE;IAChB,QAAQ,EAAE;4DACe;AAI9B,MAAM,OAAO,6BAA8B,SAAQ,sBAAsB;IAKrE,KAAK,CAAY;IAMjB,IAAI,CAAW;IAMf,QAAQ,CAAe;IAQvB,AADA,4BAA4B;IAC5B,QAAQ,GAAqB,gBAAgB,CAAC,IAAI,CAAC;CACtD;AArBG;IAJC,mBAAmB,CAAC;QACjB,WAAW,EAAE,yCAAyC;QACtD,IAAI,EAAE,GAAG,EAAE,CAAC,QAAQ;KACvB,CAAC;4DACe;AAMjB;IAJC,mBAAmB,CAAC;QACjB,WAAW,EAAE,uCAAuC;QACpD,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO;KACtB,CAAC;2DACa;AAMf;IAJC,mBAAmB,CAAC;QACjB,WAAW,EAAE,+CAA+C;QAC5D,IAAI,EAAE,GAAG,EAAE,CAAC,WAAW;KAC1B,CAAC;+DACqB;AAQvB;IANC,WAAW,CAAC;QACT,WAAW,EAAE,iFAAiF;QAC9F,0BAA0B;QAC1B,IAAI,EAAE,gBAAgB;KACzB,CAAC;IACF,4BAA4B;+DACuB"}
+{"version":3,"file":"auth.dto.js","sourceRoot":"","sources":["../../../../src/shared-lib/dto/auth.dto.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAG,WAAW,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,MAAM,OAAO,qBAAqB;IAQ9B,SAAS,GAAW,EAAE,CAAC;IAQvB,AADA,4BAA4B;IAC5B,QAAQ,GAAsB,gBAAgB,CAAC,IAAI,CAAC;CACvD;AATG;IAPC,WAAW,CAAC;QACT,WAAW,EAAE,qEAAqE;QAClF,OAAO,EAAE,yCAAyC;QAClD,IAAI,EAAE,MAAM;KACf,CAAC;IACD,UAAU,EAAE;IACZ,QAAQ,EAAE;wDACY;AAQvB;IANC,mBAAmB,CAAC;QACjB,WAAW,EAAE,iFAAiF;QAC9F,0BAA0B;QAC1B,IAAI,EAAE,gBAAgB;KACzB,CAAC;IACF,4BAA4B;uDACwB;AAIxD,MAAM,OAAO,sBAAsB;IAO/B,YAAY,GAAW,EAAE,CAAC;CAC7B;AADG;IANC,WAAW,CAAC;QACT,WAAW,EAAE,eAAe;QAC5B,OAAO,EAAE,sJAAsJ;KAClK,CAAC;IACD,UAAU,EAAE;IACZ,QAAQ,EAAE;4DACe;AAI9B,MAAM,OAAO,sBAAuB,SAAQ,sBAAsB;IAQ9D,WAAW,GAAW,EAAE,CAAC;CAUxB;AAVD;IAPC,WAAW,CACR;QACI,WAAW,EAAE,uKAAuK;KACvL,CACJ;IACA,UAAU,EAAE;IACZ,QAAQ,EAAE;2DACc;AAY7B,MAAM,OAAO,6BAA8B,SAAQ,sBAAsB;IAKrE,KAAK,CAAY;IAMjB,IAAI,CAAW;IAMf,QAAQ,CAAe;IAQvB,AADA,4BAA4B;IAC5B,QAAQ,GAAqB,gBAAgB,CAAC,IAAI,CAAC;CACtD;AArBG;IAJC,mBAAmB,CAAC;QACjB,WAAW,EAAE,yCAAyC;QACtD,IAAI,EAAE,GAAG,EAAE,CAAC,QAAQ;KACvB,CAAC;4DACe;AAMjB;IAJC,mBAAmB,CAAC;QACjB,WAAW,EAAE,uCAAuC;QACpD,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO;KACtB,CAAC;2DACa;AAMf;IAJC,mBAAmB,CAAC;QACjB,WAAW,EAAE,+CAA+C;QAC5D,IAAI,EAAE,GAAG,EAAE,CAAC,WAAW;KAC1B,CAAC;+DACqB;AAQvB;IANC,WAAW,CAAC;QACT,WAAW,EAAE,iFAAiF;QAC9F,0BAA0B;QAC1B,IAAI,EAAE,gBAAgB;KACzB,CAAC;IACF,4BAA4B;+DACuB"}

package/dist/esm/shared-lib/errors/base/error-classification-enums.d.ts

@@ -40,15 +40,171 @@ export declare enum ErrorCategory {
 }
 /**
  * Structured error object for classification
+ * Follows RFC 7807 (Problem Details for HTTP APIs) with extensions
  */
 export interface StructuredError {
+    /** HTTP status code as number (industry standard) */
+    status: number;
+    /** Human-readable summary of the error type */
+    title: string;
+    /** Human-readable explanation specific to this occurrence */
+    detail: string;
+    /** Common error message field (industry standard) - usually same as detail */
     message: string;
+    /** URI reference identifying the problem type (optional) */
+    type?: string;
+    /** URI reference to this specific error occurrence (optional) */
+    instance?: string;
+    /** Service-defined error code for programmatic handling */
     code: string;
-    timestamp?: string;
+    /** Error category for classification and routing */
     category: ErrorCategory;
+    /** ISO 8601 timestamp when error occurred */
+    timestamp?: string;
+    /** Correlation ID for request tracing */
     correlationId?: string;
+    /** Additional structured error details */
     details?: Record<string, any>;
+    /** User-friendly message safe for end-user display */
     userMessage?: string;
+    /** Whether the operation can be safely retried */
+    retryable: boolean;
+    /** Target property/parameter that caused the error (for validation errors) */
+    target?: string;
+}
+/**
+ * Backward compatibility alias
+ * @deprecated Use StructuredError instead
+ */
+export type ErrorResponse = StructuredError;
+/**
+ * Validation error detail for field-specific errors
+ */
+export interface ValidationErrorDetail {
+    field: string;
+    code: string;
+    message: string;
+    rejectedValue?: any;
+    constraints?: Record<string, string>;
+}
+/**
+ * Category-specific structured error interfaces for type safety
+ */
+/**
+ * Validation error for input validation failures
+ */
+export interface ValidationStructuredError extends StructuredError {
+    category: ErrorCategory.VALIDATION;
+    details: {
+        violations: ValidationErrorDetail[];
+        [key: string]: any;
+    };
+    target: string;
+    retryable: false;
+}
+/**
+ * Domain rule error for business logic violations
+ */
+export interface DomainRuleStructuredError extends StructuredError {
+    category: ErrorCategory.DOMAIN_RULE;
+    details?: {
+        businessRule: string;
+        violatedConstraints?: string[];
+        [key: string]: any;
+    };
+    retryable: false;
+}
+/**
+ * Technical error for application/configuration issues
+ */
+export interface TechnicalStructuredError extends StructuredError {
+    category: ErrorCategory.TECHNICAL;
+    details?: {
+        component?: string;
+        operation?: string;
+        technicalDetails?: string;
+        [key: string]: any;
+    };
     retryable: boolean;
 }
+/**
+ * Infrastructure error for system/external service failures
+ */
+export interface InfrastructureStructuredError extends StructuredError {
+    category: ErrorCategory.INFRASTRUCTURE;
+    details?: {
+        service?: string;
+        endpoint?: string;
+        connectionDetails?: string;
+        [key: string]: any;
+    };
+    retryable: true;
+}
+/**
+ * Security error for authentication/authorization failures
+ */
+export interface SecurityStructuredError extends StructuredError {
+    category: ErrorCategory.SECURITY;
+    details?: {
+        securityViolationType?: 'authentication' | 'authorization' | 'suspicious_activity';
+        requiredPermissions?: string[];
+        attemptedAction?: string;
+        [key: string]: any;
+    };
+    retryable: false;
+}
+/**
+ * Rate limit error for usage limit violations
+ */
+export interface RateLimitStructuredError extends StructuredError {
+    category: ErrorCategory.RATE_LIMIT;
+    details: {
+        limit: number;
+        remaining: number;
+        resetTime: string;
+        window: string;
+        [key: string]: any;
+    };
+    retryable: true;
+}
+/**
+ * Timeout error for operations that exceed time limits
+ */
+export interface TimeoutStructuredError extends StructuredError {
+    category: ErrorCategory.TIMEOUT;
+    details?: {
+        timeoutMs: number;
+        operation?: string;
+        elapsedMs?: number;
+        [key: string]: any;
+    };
+    retryable: true;
+}
+/**
+ * Unknown error for unclassified failures
+ */
+export interface UnknownStructuredError extends StructuredError {
+    category: ErrorCategory.UNKNOWN;
+    details?: {
+        originalError?: string;
+        context?: string;
+        [key: string]: any;
+    };
+    retryable: boolean;
+}
+/**
+ * Union type of all category-specific structured errors for type safety
+ */
+export type CategorizedStructuredError = ValidationStructuredError | DomainRuleStructuredError | TechnicalStructuredError | InfrastructureStructuredError | SecurityStructuredError | RateLimitStructuredError | TimeoutStructuredError | UnknownStructuredError;
+/**
+ * Type guard functions for category-specific error handling
+ */
+export declare const isValidationError: (error: StructuredError) => error is ValidationStructuredError;
+export declare const isDomainRuleError: (error: StructuredError) => error is DomainRuleStructuredError;
+export declare const isTechnicalError: (error: StructuredError) => error is TechnicalStructuredError;
+export declare const isInfrastructureError: (error: StructuredError) => error is InfrastructureStructuredError;
+export declare const isSecurityError: (error: StructuredError) => error is SecurityStructuredError;
+export declare const isRateLimitError: (error: StructuredError) => error is RateLimitStructuredError;
+export declare const isTimeoutError: (error: StructuredError) => error is TimeoutStructuredError;
+export declare const isUnknownError: (error: StructuredError) => error is UnknownStructuredError;
 //# sourceMappingURL=error-classification-enums.d.ts.map

package/dist/esm/shared-lib/errors/base/error-classification-enums.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-classification-enums.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/errors/base/error-classification-enums.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,oBAAY,aAAa;IACvB;;OAEG;IACH,UAAU,eAAe;IAEzB;;OAEG;IACH,WAAW,gBAAgB;IAE3B;;OAEG;IACH,SAAS,cAAc;IAEvB;;OAEG;IACH,cAAc,mBAAmB;IAEjC;;OAEG;IACH,QAAQ,aAAa;IAErB;;OAEG;IACH,UAAU,eAAe;IAEzB;;OAEG;IACH,OAAO,YAAY;IAEnB;;OAEG;IACH,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,aAAa,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;CACpB"}
+{"version":3,"file":"error-classification-enums.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/errors/base/error-classification-enums.ts"],"names":[],"mappings":"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"}

package/dist/esm/shared-lib/errors/base/error-classification-enums.js

@@ -39,4 +39,15 @@ export var ErrorCategory;
      */
     ErrorCategory["UNKNOWN"] = "UNKNOWN";
 })(ErrorCategory || (ErrorCategory = {}));
+/**
+ * Type guard functions for category-specific error handling
+ */
+export const isValidationError = (error) => error.category === ErrorCategory.VALIDATION;
+export const isDomainRuleError = (error) => error.category === ErrorCategory.DOMAIN_RULE;
+export const isTechnicalError = (error) => error.category === ErrorCategory.TECHNICAL;
+export const isInfrastructureError = (error) => error.category === ErrorCategory.INFRASTRUCTURE;
+export const isSecurityError = (error) => error.category === ErrorCategory.SECURITY;
+export const isRateLimitError = (error) => error.category === ErrorCategory.RATE_LIMIT;
+export const isTimeoutError = (error) => error.category === ErrorCategory.TIMEOUT;
+export const isUnknownError = (error) => error.category === ErrorCategory.UNKNOWN;
 //# sourceMappingURL=error-classification-enums.js.map

package/dist/esm/shared-lib/errors/base/error-classification-enums.js.map

@@ -1 +1 @@
-{"version":3,"file":"error-classification-enums.js","sourceRoot":"","sources":["../../../../../src/shared-lib/errors/base/error-classification-enums.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAN,IAAY,aAwCX;AAxCD,WAAY,aAAa;IACvB;;OAEG;IACH,0CAAyB,CAAA;IAEzB;;OAEG;IACH,4CAA2B,CAAA;IAE3B;;OAEG;IACH,wCAAuB,CAAA;IAEvB;;OAEG;IACH,kDAAiC,CAAA;IAEjC;;OAEG;IACH,sCAAqB,CAAA;IAErB;;OAEG;IACH,0CAAyB,CAAA;IAEzB;;OAEG;IACH,oCAAmB,CAAA;IAEnB;;OAEG;IACH,oCAAmB,CAAA;AACrB,CAAC,EAxCW,aAAa,KAAb,aAAa,QAwCxB"}
+{"version":3,"file":"error-classification-enums.js","sourceRoot":"","sources":["../../../../../src/shared-lib/errors/base/error-classification-enums.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAN,IAAY,aAwCX;AAxCD,WAAY,aAAa;IACvB;;OAEG;IACH,0CAAyB,CAAA;IAEzB;;OAEG;IACH,4CAA2B,CAAA;IAE3B;;OAEG;IACH,wCAAuB,CAAA;IAEvB;;OAEG;IACH,kDAAiC,CAAA;IAEjC;;OAEG;IACH,sCAAqB,CAAA;IAErB;;OAEG;IACH,0CAAyB,CAAA;IAEzB;;OAEG;IACH,oCAAmB,CAAA;IAEnB;;OAEG;IACH,oCAAmB,CAAA;AACrB,CAAC,EAxCW,aAAa,KAAb,aAAa,QAwCxB;AAoMD;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAsB,EAAsC,EAAE,CAC9F,KAAK,CAAC,QAAQ,KAAK,aAAa,CAAC,UAAU,CAAC;AAE9C,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAsB,EAAsC,EAAE,CAC9F,KAAK,CAAC,QAAQ,KAAK,aAAa,CAAC,WAAW,CAAC;AAE/C,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAsB,EAAqC,EAAE,CAC5F,KAAK,CAAC,QAAQ,KAAK,aAAa,CAAC,SAAS,CAAC;AAE7C,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,KAAsB,EAA0C,EAAE,CACtG,KAAK,CAAC,QAAQ,KAAK,aAAa,CAAC,cAAc,CAAC;AAElD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAsB,EAAoC,EAAE,CAC1F,KAAK,CAAC,QAAQ,KAAK,aAAa,CAAC,QAAQ,CAAC;AAE5C,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAsB,EAAqC,EAAE,CAC5F,KAAK,CAAC,QAAQ,KAAK,aAAa,CAAC,UAAU,CAAC;AAE9C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAsB,EAAmC,EAAE,CACxF,KAAK,CAAC,QAAQ,KAAK,aAAa,CAAC,OAAO,CAAC;AAE3C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAsB,EAAmC,EAAE,CACxF,KAAK,CAAC,QAAQ,KAAK,aAAa,CAAC,OAAO,CAAC"}

package/dist/esm/shared-lib/errors/base-business-error.d.ts

@@ -1,4 +1,5 @@
 import { HttpException, HttpStatus } from '@nestjs/common';
+import { ErrorCategory, StructuredError } from './base/error-classification-enums';
 /**
  * Base class for business logic errors that should be surfaced to clients
  * with meaningful error messages and appropriate HTTP status codes.
@@ -11,7 +12,9 @@ export declare abstract class BusinessLogicError extends HttpException {
     readonly userMessage: string;
     readonly developerMessage: string;
     readonly action?: string;
-    constructor(errorCode: string, domain: string, userMessage: string, developerMessage: string, httpStatus?: HttpStatus, action?: string);
+    readonly category: ErrorCategory;
+    readonly retryable: boolean;
+    constructor(errorCode: string, domain: string, userMessage: string, developerMessage: string, httpStatus?: HttpStatus, action?: string, category?: ErrorCategory, retryable?: boolean);
     /**
      * Type guard to check if an error is a business logic error
      */
@@ -19,6 +22,57 @@ export declare abstract class BusinessLogicError extends HttpException {
     /**
      * Get structured error response for API consumers
      */
-    getStructuredResponse(): object;
+    getStructuredResponse(): StructuredError;
+}
+/**
+ * Category-specific base error classes for type safety and proper defaults
+ */
+/**
+ * Base class for validation errors - input validation failures
+ */
+export declare class ValidationError extends BusinessLogicError {
+    constructor(errorCode: string, domain: string, userMessage: string, developerMessage: string, target: string, action?: string);
+}
+/**
+ * Base class for domain rule errors - business logic violations
+ */
+export declare class DomainRuleError extends BusinessLogicError {
+    constructor(errorCode: string, domain: string, userMessage: string, developerMessage: string, httpStatus?: HttpStatus, action?: string);
+}
+/**
+ * Base class for technical errors - application/configuration issues
+ */
+export declare class TechnicalError extends BusinessLogicError {
+    constructor(errorCode: string, domain: string, userMessage: string, developerMessage: string, httpStatus?: HttpStatus, action?: string, retryable?: boolean);
+}
+/**
+ * Base class for infrastructure errors - system/external service failures
+ */
+export declare class InfrastructureError extends BusinessLogicError {
+    constructor(errorCode: string, domain: string, userMessage: string, developerMessage: string, httpStatus?: HttpStatus, action?: string);
+}
+/**
+ * Base class for security errors - authentication/authorization failures
+ */
+export declare class SecurityError extends BusinessLogicError {
+    constructor(errorCode: string, domain: string, userMessage: string, developerMessage: string, httpStatus?: HttpStatus, action?: string);
+}
+/**
+ * Base class for rate limit errors - usage limit violations
+ */
+export declare class RateLimitError extends BusinessLogicError {
+    constructor(errorCode: string, domain: string, userMessage: string, developerMessage: string, action?: string);
+}
+/**
+ * Base class for timeout errors - operations that exceed time limits
+ */
+export declare class TimeoutError extends BusinessLogicError {
+    constructor(errorCode: string, domain: string, userMessage: string, developerMessage: string, httpStatus?: HttpStatus, action?: string);
+}
+/**
+ * Base class for unknown errors - unclassified failures
+ */
+export declare class UnknownError extends BusinessLogicError {
+    constructor(errorCode: string, domain: string, userMessage: string, developerMessage: string, httpStatus?: HttpStatus, action?: string, retryable?: boolean);
 }
 //# sourceMappingURL=base-business-error.d.ts.map

package/dist/esm/shared-lib/errors/base-business-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-business-error.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/errors/base-business-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG3D;;;;;GAKG;AACH,8BAAsB,kBAAmB,SAAQ,aAAa;IAC5D,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,SAAgB,gBAAgB,EAAE,MAAM,CAAC;IACzC,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;gBAG9B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,MAAM,EACxB,UAAU,GAAE,UAAmC,EAC/C,MAAM,CAAC,EAAE,MAAM;IAuBjB;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,kBAAkB;IAI/D;;OAEG;IACH,qBAAqB;CAYtB"}
+{"version":3,"file":"base-business-error.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/errors/base-business-error.ts"],"names":[],"mappings":"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"}

package/dist/esm/shared-lib/errors/base-business-error.js

@@ -12,16 +12,26 @@ export class BusinessLogicError extends HttpException {
     userMessage;
     developerMessage;
     action;
-    constructor(errorCode, domain, userMessage, developerMessage, httpStatus = HttpStatus.BAD_REQUEST, action) {
-        // Create structured response for NestJS
+    category;
+    retryable;
+    constructor(errorCode, domain, userMessage, developerMessage, httpStatus = HttpStatus.BAD_REQUEST, action, category = ErrorCategory.DOMAIN_RULE, retryable = false) {
+        // Create structured response following RFC 7807 with extensions
         const response = {
+            // RFC 7807 core fields
+            status: httpStatus,
+            title: userMessage,
+            detail: developerMessage,
+            message: userMessage, // Industry standard field
+            // Custom extensions
             code: errorCode,
+            category: category,
+            timestamp: new Date().toISOString(),
+            retryable: retryable,
+            // Legacy fields for backward compatibility
             domain: domain,
-            message: userMessage,
             developerMessage: developerMessage,
             action: action,
-            timestamp: new Date().toISOString(),
-            category: ErrorCategory.DOMAIN_RULE
+            userMessage: userMessage
         };
         super(response, httpStatus);
         this.errorCode = errorCode;
@@ -29,6 +39,8 @@ export class BusinessLogicError extends HttpException {
         this.userMessage = userMessage;
         this.developerMessage = developerMessage;
         this.action = action;
+        this.category = category;
+        this.retryable = retryable;
         this.name = this.constructor.name;
     }
     /**
@@ -43,14 +55,93 @@ export class BusinessLogicError extends HttpException {
     getStructuredResponse() {
         const response = this.getResponse();
         return typeof response === 'object' ? response : {
-            code: this.errorCode,
-            domain: this.domain,
+            status: this.getStatus(),
+            title: this.userMessage,
+            detail: this.developerMessage,
             message: this.userMessage,
-            developerMessage: this.developerMessage,
-            action: this.action,
+            code: this.errorCode,
+            category: this.category,
             timestamp: new Date().toISOString(),
-            category: ErrorCategory.DOMAIN_RULE
+            retryable: this.retryable,
+            userMessage: this.userMessage,
+            details: {
+                domain: this.domain,
+                action: this.action
+            }
         };
     }
 }
+/**
+ * Category-specific base error classes for type safety and proper defaults
+ */
+/**
+ * Base class for validation errors - input validation failures
+ */
+export class ValidationError extends BusinessLogicError {
+    constructor(errorCode, domain, userMessage, developerMessage, target, action) {
+        super(errorCode, domain, userMessage, developerMessage, HttpStatus.BAD_REQUEST, action, ErrorCategory.VALIDATION, false // Validation errors are never retryable
+        );
+    }
+}
+/**
+ * Base class for domain rule errors - business logic violations
+ */
+export class DomainRuleError extends BusinessLogicError {
+    constructor(errorCode, domain, userMessage, developerMessage, httpStatus = HttpStatus.BAD_REQUEST, action) {
+        super(errorCode, domain, userMessage, developerMessage, httpStatus, action, ErrorCategory.DOMAIN_RULE, false // Domain rules don't change on retry
+        );
+    }
+}
+/**
+ * Base class for technical errors - application/configuration issues
+ */
+export class TechnicalError extends BusinessLogicError {
+    constructor(errorCode, domain, userMessage, developerMessage, httpStatus = HttpStatus.INTERNAL_SERVER_ERROR, action, retryable = true) {
+        super(errorCode, domain, userMessage, developerMessage, httpStatus, action, ErrorCategory.TECHNICAL, retryable);
+    }
+}
+/**
+ * Base class for infrastructure errors - system/external service failures
+ */
+export class InfrastructureError extends BusinessLogicError {
+    constructor(errorCode, domain, userMessage, developerMessage, httpStatus = HttpStatus.SERVICE_UNAVAILABLE, action) {
+        super(errorCode, domain, userMessage, developerMessage, httpStatus, action, ErrorCategory.INFRASTRUCTURE, true // Infrastructure issues are typically retryable
+        );
+    }
+}
+/**
+ * Base class for security errors - authentication/authorization failures
+ */
+export class SecurityError extends BusinessLogicError {
+    constructor(errorCode, domain, userMessage, developerMessage, httpStatus = HttpStatus.UNAUTHORIZED, action) {
+        super(errorCode, domain, userMessage, developerMessage, httpStatus, action, ErrorCategory.SECURITY, false // Security violations are never retryable
+        );
+    }
+}
+/**
+ * Base class for rate limit errors - usage limit violations
+ */
+export class RateLimitError extends BusinessLogicError {
+    constructor(errorCode, domain, userMessage, developerMessage, action) {
+        super(errorCode, domain, userMessage, developerMessage, HttpStatus.TOO_MANY_REQUESTS, action, ErrorCategory.RATE_LIMIT, true // Can retry after rate limit window
+        );
+    }
+}
+/**
+ * Base class for timeout errors - operations that exceed time limits
+ */
+export class TimeoutError extends BusinessLogicError {
+    constructor(errorCode, domain, userMessage, developerMessage, httpStatus = HttpStatus.REQUEST_TIMEOUT, action) {
+        super(errorCode, domain, userMessage, developerMessage, httpStatus, action, ErrorCategory.TIMEOUT, true // Timeouts can often be retried
+        );
+    }
+}
+/**
+ * Base class for unknown errors - unclassified failures
+ */
+export class UnknownError extends BusinessLogicError {
+    constructor(errorCode, domain, userMessage, developerMessage, httpStatus = HttpStatus.INTERNAL_SERVER_ERROR, action, retryable = false) {
+        super(errorCode, domain, userMessage, developerMessage, httpStatus, action, ErrorCategory.UNKNOWN, retryable);
+    }
+}
 //# sourceMappingURL=base-business-error.js.map