@explorins/pers-shared 2.1.35 → 2.1.37

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # PERS Shared Library Changelog
 
+## [2.0.18] - 2025-11-01
+
+### 🏭 **Error Handling Architecture Migration**
+
+#### Changed
+- **Error Classes**: Now exported for type checking only - instantiation via ErrorFactory required
+- **Domain Errors**: All error classes remain as canonical definitions but must use factory for creation
+- **Frontend Types**: Error classes continue to provide TypeScript types for frontend applications
+
+#### Fixed
+- **Architecture Compliance**: Error classes no longer directly instantiated in backend code
+- **Consistency**: All error creation flows through centralized ErrorFactory pattern
+- **Type Safety**: Maintained full TypeScript support while enforcing factory usage
+
+#### Migration Notes
+- **Backend**: Use `Errors.*` from `@explorins/pers-shared-patterns` instead of direct class instantiation
+- **Frontend**: Continue importing error classes as types - no changes required
+- **API Contracts**: No breaking changes to error response formats or structures
+
+---
+
 ## [2.0.17] - 2025-08-22
 
 ### 🚨 **CRITICAL: Swagger Compatibility & Architecture Refinement**

package/dist/cjs/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/cjs/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/cjs/index.js

@@ -18,6 +18,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 // Core domain contracts
 __exportStar(require("./shared-lib/enum"), exports);
-// Note: Architecture patterns (orchestrators, database schemas) moved to @explorins/pers-shared-patterns
-// This library now contains only pure data contracts safe for external consumption
+__exportStar(require("./shared-lib/errors"), exports); // Export actual error classes and functions
+// Shared patterns (architecture components)
+__exportStar(require("./shared-patterns"), exports);
+// 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/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,4EAA4E;AAC5E,8FAA8F;;;;;;;;;;;;;;;;AAE9F,wBAAwB;AACxB,oDAAkC;AAQlC,yGAAyG;AACzG,mFAAmF"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,4EAA4E;AAC5E,8FAA8F;;;;;;;;;;;;;;;;AAE9F,wBAAwB;AACxB,oDAAkC;AAOlC,sDAAoC,CAAC,4CAA4C;AAEjF,4CAA4C;AAC5C,oDAAkC;AAElC,0FAA0F;AAC1F,iFAAiF"}

package/dist/cjs/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/cjs/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/cjs/shared-lib/dto/auth.dto.js

@@ -55,9 +55,8 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], RefreshTokenRequestDTO.prototype, "refreshToken", void 0);
-class SessionAuthResponseDTO {
+class SessionAuthResponseDTO extends RefreshTokenRequestDTO {
     accessToken = '';
-    refreshToken = '';
 }
 exports.SessionAuthResponseDTO = SessionAuthResponseDTO;
 __decorate([
@@ -68,14 +67,6 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], SessionAuthResponseDTO.prototype, "accessToken", void 0);
-__decorate([
-    (0, swagger_1.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.',
-    }),
-    (0, class_validator_1.IsNotEmpty)(),
-    (0, class_validator_1.IsString)(),
-    __metadata("design:type", String)
-], SessionAuthResponseDTO.prototype, "refreshToken", void 0);
 class SessionAuthContextResponseDTO extends SessionAuthResponseDTO {
     admin;
     user;

package/dist/cjs/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,6CAAmE;AACnE,qDAAuD;AACvD,yCAAqC;AACrC,yCAA0C;AAC1C,kCAA2C;AAC3C,mCAAmC;AAEnC,MAAa,qBAAqB;IAQ9B,SAAS,GAAW,EAAE,CAAC;IAQvB,AADA,4BAA4B;IAC5B,QAAQ,GAAsB,uBAAgB,CAAC,IAAI,CAAC;CACvD;AAjBD,sDAiBC;AATG;IAPC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,qEAAqE;QAClF,OAAO,EAAE,yCAAyC;QAClD,IAAI,EAAE,MAAM;KACf,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;wDACY;AAQvB;IANC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,iFAAiF;QAC9F,0BAA0B;QAC1B,IAAI,EAAE,uBAAgB;KACzB,CAAC;IACF,4BAA4B;;;uDACwB;AAIxD,MAAa,sBAAsB;IAO/B,YAAY,GAAW,EAAE,CAAC;CAC7B;AARD,wDAQC;AADG;IANC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,eAAe;QAC5B,OAAO,EAAE,sJAAsJ;KAClK,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;4DACe;AAI9B,MAAa,sBAAsB;IAQ/B,WAAW,GAAW,EAAE,CAAC;IAQzB,YAAY,GAAW,EAAE,CAAC;CAEzB;AAlBL,wDAkBK;AAVD;IAPC,IAAA,qBAAW,EACR;QACI,WAAW,EAAE,uKAAuK;KACvL,CACJ;IACA,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;2DACc;AAQzB;IANC,IAAA,qBAAW,EACR;QACI,WAAW,EAAE,qHAAqH;KACrI,CAAC;IACD,IAAA,4BAAU,GAAE;IAChB,IAAA,0BAAQ,GAAE;;4DACe;AAI9B,MAAa,6BAA8B,SAAQ,sBAAsB;IAKrE,KAAK,CAAY;IAMjB,IAAI,CAAW;IAMf,QAAQ,CAAe;IAQvB,AADA,4BAA4B;IAC5B,QAAQ,GAAqB,uBAAgB,CAAC,IAAI,CAAC;CACtD;AA1BD,sEA0BC;AArBG;IAJC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,yCAAyC;QACtD,IAAI,EAAE,GAAG,EAAE,CAAC,gBAAQ;KACvB,CAAC;8BACM,gBAAQ;4DAAC;AAMjB;IAJC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,uCAAuC;QACpD,IAAI,EAAE,GAAG,EAAE,CAAC,kBAAO;KACtB,CAAC;8BACK,kBAAO;2DAAC;AAMf;IAJC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,+CAA+C;QAC5D,IAAI,EAAE,GAAG,EAAE,CAAC,sBAAW;KAC1B,CAAC;8BACS,sBAAW;+DAAC;AAQvB;IANC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,iFAAiF;QAC9F,0BAA0B;QAC1B,IAAI,EAAE,uBAAgB;KACzB,CAAC;IACF,4BAA4B;;;+DACuB"}
+{"version":3,"file":"auth.dto.js","sourceRoot":"","sources":["../../../../src/shared-lib/dto/auth.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6CAAmE;AACnE,qDAAuD;AACvD,yCAAqC;AACrC,yCAA0C;AAC1C,kCAA2C;AAC3C,mCAAmC;AAEnC,MAAa,qBAAqB;IAQ9B,SAAS,GAAW,EAAE,CAAC;IAQvB,AADA,4BAA4B;IAC5B,QAAQ,GAAsB,uBAAgB,CAAC,IAAI,CAAC;CACvD;AAjBD,sDAiBC;AATG;IAPC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,qEAAqE;QAClF,OAAO,EAAE,yCAAyC;QAClD,IAAI,EAAE,MAAM;KACf,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;wDACY;AAQvB;IANC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,iFAAiF;QAC9F,0BAA0B;QAC1B,IAAI,EAAE,uBAAgB;KACzB,CAAC;IACF,4BAA4B;;;uDACwB;AAIxD,MAAa,sBAAsB;IAO/B,YAAY,GAAW,EAAE,CAAC;CAC7B;AARD,wDAQC;AADG;IANC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,eAAe;QAC5B,OAAO,EAAE,sJAAsJ;KAClK,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;4DACe;AAI9B,MAAa,sBAAuB,SAAQ,sBAAsB;IAQ9D,WAAW,GAAW,EAAE,CAAC;CAUxB;AAlBL,wDAkBK;AAVD;IAPC,IAAA,qBAAW,EACR;QACI,WAAW,EAAE,uKAAuK;KACvL,CACJ;IACA,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;2DACc;AAY7B,MAAa,6BAA8B,SAAQ,sBAAsB;IAKrE,KAAK,CAAY;IAMjB,IAAI,CAAW;IAMf,QAAQ,CAAe;IAQvB,AADA,4BAA4B;IAC5B,QAAQ,GAAqB,uBAAgB,CAAC,IAAI,CAAC;CACtD;AA1BD,sEA0BC;AArBG;IAJC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,yCAAyC;QACtD,IAAI,EAAE,GAAG,EAAE,CAAC,gBAAQ;KACvB,CAAC;8BACM,gBAAQ;4DAAC;AAMjB;IAJC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,uCAAuC;QACpD,IAAI,EAAE,GAAG,EAAE,CAAC,kBAAO;KACtB,CAAC;8BACK,kBAAO;2DAAC;AAMf;IAJC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,+CAA+C;QAC5D,IAAI,EAAE,GAAG,EAAE,CAAC,sBAAW;KAC1B,CAAC;8BACS,sBAAW;+DAAC;AAQvB;IANC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,iFAAiF;QAC9F,0BAA0B;QAC1B,IAAI,EAAE,uBAAgB;KACzB,CAAC;IACF,4BAA4B;;;+DACuB"}

package/dist/cjs/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/cjs/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/cjs/shared-lib/errors/base/error-classification-enums.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ErrorCategory = void 0;
+exports.isUnknownError = exports.isTimeoutError = exports.isRateLimitError = exports.isSecurityError = exports.isInfrastructureError = exports.isTechnicalError = exports.isDomainRuleError = exports.isValidationError = exports.ErrorCategory = void 0;
 /**
  * Error categories for classification and handling
  *
@@ -42,4 +42,23 @@ var ErrorCategory;
      */
     ErrorCategory["UNKNOWN"] = "UNKNOWN";
 })(ErrorCategory || (exports.ErrorCategory = ErrorCategory = {}));
+/**
+ * Type guard functions for category-specific error handling
+ */
+const isValidationError = (error) => error.category === ErrorCategory.VALIDATION;
+exports.isValidationError = isValidationError;
+const isDomainRuleError = (error) => error.category === ErrorCategory.DOMAIN_RULE;
+exports.isDomainRuleError = isDomainRuleError;
+const isTechnicalError = (error) => error.category === ErrorCategory.TECHNICAL;
+exports.isTechnicalError = isTechnicalError;
+const isInfrastructureError = (error) => error.category === ErrorCategory.INFRASTRUCTURE;
+exports.isInfrastructureError = isInfrastructureError;
+const isSecurityError = (error) => error.category === ErrorCategory.SECURITY;
+exports.isSecurityError = isSecurityError;
+const isRateLimitError = (error) => error.category === ErrorCategory.RATE_LIMIT;
+exports.isRateLimitError = isRateLimitError;
+const isTimeoutError = (error) => error.category === ErrorCategory.TIMEOUT;
+exports.isTimeoutError = isTimeoutError;
+const isUnknownError = (error) => error.category === ErrorCategory.UNKNOWN;
+exports.isUnknownError = isUnknownError;
 //# sourceMappingURL=error-classification-enums.js.map

package/dist/cjs/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,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,6BAAb,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,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,6BAAb,aAAa,QAwCxB;AAoMD;;GAEG;AACI,MAAM,iBAAiB,GAAG,CAAC,KAAsB,EAAsC,EAAE,CAC9F,KAAK,CAAC,QAAQ,KAAK,aAAa,CAAC,UAAU,CAAC;AADjC,QAAA,iBAAiB,qBACgB;AAEvC,MAAM,iBAAiB,GAAG,CAAC,KAAsB,EAAsC,EAAE,CAC9F,KAAK,CAAC,QAAQ,KAAK,aAAa,CAAC,WAAW,CAAC;AADlC,QAAA,iBAAiB,qBACiB;AAExC,MAAM,gBAAgB,GAAG,CAAC,KAAsB,EAAqC,EAAE,CAC5F,KAAK,CAAC,QAAQ,KAAK,aAAa,CAAC,SAAS,CAAC;AADhC,QAAA,gBAAgB,oBACgB;AAEtC,MAAM,qBAAqB,GAAG,CAAC,KAAsB,EAA0C,EAAE,CACtG,KAAK,CAAC,QAAQ,KAAK,aAAa,CAAC,cAAc,CAAC;AADrC,QAAA,qBAAqB,yBACgB;AAE3C,MAAM,eAAe,GAAG,CAAC,KAAsB,EAAoC,EAAE,CAC1F,KAAK,CAAC,QAAQ,KAAK,aAAa,CAAC,QAAQ,CAAC;AAD/B,QAAA,eAAe,mBACgB;AAErC,MAAM,gBAAgB,GAAG,CAAC,KAAsB,EAAqC,EAAE,CAC5F,KAAK,CAAC,QAAQ,KAAK,aAAa,CAAC,UAAU,CAAC;AADjC,QAAA,gBAAgB,oBACiB;AAEvC,MAAM,cAAc,GAAG,CAAC,KAAsB,EAAmC,EAAE,CACxF,KAAK,CAAC,QAAQ,KAAK,aAAa,CAAC,OAAO,CAAC;AAD9B,QAAA,cAAc,kBACgB;AAEpC,MAAM,cAAc,GAAG,CAAC,KAAsB,EAAmC,EAAE,CACxF,KAAK,CAAC,QAAQ,KAAK,aAAa,CAAC,OAAO,CAAC;AAD9B,QAAA,cAAc,kBACgB"}

package/dist/cjs/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/cjs/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/cjs/shared-lib/errors/base-business-error.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BusinessLogicError = void 0;
+exports.UnknownError = exports.TimeoutError = exports.RateLimitError = exports.SecurityError = exports.InfrastructureError = exports.TechnicalError = exports.DomainRuleError = exports.ValidationError = exports.BusinessLogicError = void 0;
 const common_1 = require("@nestjs/common");
 const error_classification_enums_1 = require("./base/error-classification-enums");
 /**
@@ -15,16 +15,26 @@ class BusinessLogicError extends common_1.HttpException {
     userMessage;
     developerMessage;
     action;
-    constructor(errorCode, domain, userMessage, developerMessage, httpStatus = common_1.HttpStatus.BAD_REQUEST, action) {
-        // Create structured response for NestJS
+    category;
+    retryable;
+    constructor(errorCode, domain, userMessage, developerMessage, httpStatus = common_1.HttpStatus.BAD_REQUEST, action, category = error_classification_enums_1.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: error_classification_enums_1.ErrorCategory.DOMAIN_RULE
+            userMessage: userMessage
         };
         super(response, httpStatus);
         this.errorCode = errorCode;
@@ -32,6 +42,8 @@ class BusinessLogicError extends common_1.HttpException {
         this.userMessage = userMessage;
         this.developerMessage = developerMessage;
         this.action = action;
+        this.category = category;
+        this.retryable = retryable;
         this.name = this.constructor.name;
     }
     /**
@@ -46,15 +58,102 @@ class BusinessLogicError extends common_1.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: error_classification_enums_1.ErrorCategory.DOMAIN_RULE
+            retryable: this.retryable,
+            userMessage: this.userMessage,
+            details: {
+                domain: this.domain,
+                action: this.action
+            }
         };
     }
 }
 exports.BusinessLogicError = BusinessLogicError;
+/**
+ * Category-specific base error classes for type safety and proper defaults
+ */
+/**
+ * Base class for validation errors - input validation failures
+ */
+class ValidationError extends BusinessLogicError {
+    constructor(errorCode, domain, userMessage, developerMessage, target, action) {
+        super(errorCode, domain, userMessage, developerMessage, common_1.HttpStatus.BAD_REQUEST, action, error_classification_enums_1.ErrorCategory.VALIDATION, false // Validation errors are never retryable
+        );
+    }
+}
+exports.ValidationError = ValidationError;
+/**
+ * Base class for domain rule errors - business logic violations
+ */
+class DomainRuleError extends BusinessLogicError {
+    constructor(errorCode, domain, userMessage, developerMessage, httpStatus = common_1.HttpStatus.BAD_REQUEST, action) {
+        super(errorCode, domain, userMessage, developerMessage, httpStatus, action, error_classification_enums_1.ErrorCategory.DOMAIN_RULE, false // Domain rules don't change on retry
+        );
+    }
+}
+exports.DomainRuleError = DomainRuleError;
+/**
+ * Base class for technical errors - application/configuration issues
+ */
+class TechnicalError extends BusinessLogicError {
+    constructor(errorCode, domain, userMessage, developerMessage, httpStatus = common_1.HttpStatus.INTERNAL_SERVER_ERROR, action, retryable = true) {
+        super(errorCode, domain, userMessage, developerMessage, httpStatus, action, error_classification_enums_1.ErrorCategory.TECHNICAL, retryable);
+    }
+}
+exports.TechnicalError = TechnicalError;
+/**
+ * Base class for infrastructure errors - system/external service failures
+ */
+class InfrastructureError extends BusinessLogicError {
+    constructor(errorCode, domain, userMessage, developerMessage, httpStatus = common_1.HttpStatus.SERVICE_UNAVAILABLE, action) {
+        super(errorCode, domain, userMessage, developerMessage, httpStatus, action, error_classification_enums_1.ErrorCategory.INFRASTRUCTURE, true // Infrastructure issues are typically retryable
+        );
+    }
+}
+exports.InfrastructureError = InfrastructureError;
+/**
+ * Base class for security errors - authentication/authorization failures
+ */
+class SecurityError extends BusinessLogicError {
+    constructor(errorCode, domain, userMessage, developerMessage, httpStatus = common_1.HttpStatus.UNAUTHORIZED, action) {
+        super(errorCode, domain, userMessage, developerMessage, httpStatus, action, error_classification_enums_1.ErrorCategory.SECURITY, false // Security violations are never retryable
+        );
+    }
+}
+exports.SecurityError = SecurityError;
+/**
+ * Base class for rate limit errors - usage limit violations
+ */
+class RateLimitError extends BusinessLogicError {
+    constructor(errorCode, domain, userMessage, developerMessage, action) {
+        super(errorCode, domain, userMessage, developerMessage, common_1.HttpStatus.TOO_MANY_REQUESTS, action, error_classification_enums_1.ErrorCategory.RATE_LIMIT, true // Can retry after rate limit window
+        );
+    }
+}
+exports.RateLimitError = RateLimitError;
+/**
+ * Base class for timeout errors - operations that exceed time limits
+ */
+class TimeoutError extends BusinessLogicError {
+    constructor(errorCode, domain, userMessage, developerMessage, httpStatus = common_1.HttpStatus.REQUEST_TIMEOUT, action) {
+        super(errorCode, domain, userMessage, developerMessage, httpStatus, action, error_classification_enums_1.ErrorCategory.TIMEOUT, true // Timeouts can often be retried
+        );
+    }
+}
+exports.TimeoutError = TimeoutError;
+/**
+ * Base class for unknown errors - unclassified failures
+ */
+class UnknownError extends BusinessLogicError {
+    constructor(errorCode, domain, userMessage, developerMessage, httpStatus = common_1.HttpStatus.INTERNAL_SERVER_ERROR, action, retryable = false) {
+        super(errorCode, domain, userMessage, developerMessage, httpStatus, action, error_classification_enums_1.ErrorCategory.UNKNOWN, retryable);
+    }
+}
+exports.UnknownError = UnknownError;
 //# sourceMappingURL=base-business-error.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"base-business-error.js","sourceRoot":"","sources":["../../../../src/shared-lib/errors/base-business-error.ts"],"names":[],"mappings":";;;AAAA,2CAA2D;AAC3D,kFAAkE;AAElE;;;;;GAKG;AACH,MAAsB,kBAAmB,SAAQ,sBAAa;IAC5C,SAAS,CAAS;IAClB,MAAM,CAAS;IACf,WAAW,CAAS;IACpB,gBAAgB,CAAS;IACzB,MAAM,CAAU;IAEhC,YACE,SAAiB,EACjB,MAAc,EACd,WAAmB,EACnB,gBAAwB,EACxB,aAAyB,mBAAU,CAAC,WAAW,EAC/C,MAAe;QAEf,wCAAwC;QACxC,MAAM,QAAQ,GAAG;YACf,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,WAAW;YACpB,gBAAgB,EAAE,gBAAgB;YAClC,MAAM,EAAE,MAAM;YACd,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,QAAQ,EAAE,0CAAa,CAAC,WAAW;SACpC,CAAC;QAEF,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAE5B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;QACzC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,KAAU;QAC/B,OAAO,KAAK,YAAY,kBAAkB,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,qBAAqB;QACnB,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACpC,OAAO,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS;YACpB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,WAAW;YACzB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,QAAQ,EAAE,0CAAa,CAAC,WAAW;SACpC,CAAC;IACJ,CAAC;CACF;AA1DD,gDA0DC"}
+{"version":3,"file":"base-business-error.js","sourceRoot":"","sources":["../../../../src/shared-lib/errors/base-business-error.ts"],"names":[],"mappings":"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"}

package/dist/cjs/shared-lib/errors/domains/authentication-errors.d.ts

@@ -1,26 +1,26 @@
-import { BusinessLogicError } from '../base-business-error';
+import { SecurityError } from '../base-business-error';
 /**
  * Authentication domain business errors
  */
-export declare class AuthenticationRequiredError extends BusinessLogicError {
+export declare class AuthenticationRequiredError extends SecurityError {
     constructor(resource: string);
 }
-export declare class AuthorizationFailedError extends BusinessLogicError {
+export declare class AuthorizationFailedError extends SecurityError {
     constructor(action: string, resource: string);
 }
 /**
  * Firebase authentication specific errors
  */
-export declare class InvalidTokenError extends BusinessLogicError {
+export declare class InvalidTokenError extends SecurityError {
     constructor(reason?: string);
 }
-export declare class TokenExpiredError extends BusinessLogicError {
+export declare class TokenExpiredError extends SecurityError {
     constructor();
 }
-export declare class TokenRevokedException extends BusinessLogicError {
+export declare class TokenRevokedException extends SecurityError {
     constructor();
 }
-export declare class FirebaseAuthenticationError extends BusinessLogicError {
+export declare class FirebaseAuthenticationError extends SecurityError {
     constructor(firebaseErrorCode: string, message?: string);
 }
 //# sourceMappingURL=authentication-errors.d.ts.map

package/dist/cjs/shared-lib/errors/domains/authentication-errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"authentication-errors.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/errors/domains/authentication-errors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAG5D;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,kBAAkB;gBACrD,QAAQ,EAAE,MAAM;CAU7B;AAED,qBAAa,wBAAyB,SAAQ,kBAAkB;gBAClD,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAU7C;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,kBAAkB;gBAC3C,MAAM,CAAC,EAAE,MAAM;CAW5B;AAED,qBAAa,iBAAkB,SAAQ,kBAAkB;;CAWxD;AAED,qBAAa,qBAAsB,SAAQ,kBAAkB;;CAW5D;AAED,qBAAa,2BAA4B,SAAQ,kBAAkB;gBACrD,iBAAiB,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAUxD"}
+{"version":3,"file":"authentication-errors.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/errors/domains/authentication-errors.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAI3E;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,aAAa;gBAChD,QAAQ,EAAE,MAAM;CAU7B;AAED,qBAAa,wBAAyB,SAAQ,aAAa;gBAC7C,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAU7C;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,aAAa;gBACtC,MAAM,CAAC,EAAE,MAAM;CAW5B;AAED,qBAAa,iBAAkB,SAAQ,aAAa;;CAWnD;AAED,qBAAa,qBAAsB,SAAQ,aAAa;;CAWvD;AAED,qBAAa,2BAA4B,SAAQ,aAAa;gBAChD,iBAAiB,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAUxD"}