@explorins/pers-shared 2.1.36 → 2.1.38

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/browser.d.ts

@@ -5,5 +5,6 @@
 export * from './shared-lib/enum';
 export type * from './shared-lib/interfaces';
 export type * from './shared-lib/dto';
-export * from './shared-lib/types';
+export type * from './shared-lib/types';
+export type * from './shared-lib/errors';
 //# sourceMappingURL=browser.d.ts.map

package/dist/cjs/browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/browser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,mBAAmB,CAAC;AAGlC,mBAAmB,yBAAyB,CAAC;AAG7C,mBAAmB,kBAAkB,CAAC;AAGtC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/browser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,mBAAmB,CAAC;AAGlC,mBAAmB,yBAAyB,CAAC;AAG7C,mBAAmB,kBAAkB,CAAC;AAGtC,mBAAmB,oBAAoB,CAAC;AAExC,mBAAmB,qBAAqB,CAAC"}

package/dist/cjs/browser.js

@@ -20,7 +20,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 // Export enums - these are safe for browser use (barrel export)
 __exportStar(require("./shared-lib/enum"), exports);
-// Export types and constants (runtime exports) - browser-safe only
-__exportStar(require("./shared-lib/types"), exports);
 // Note: Backend-specific types (like TRANSACTION_FORMATS) are excluded from browser build
 //# sourceMappingURL=browser.js.map

package/dist/cjs/browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/browser.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;AAEH,gEAAgE;AAChE,oDAAkC;AAQlC,mEAAmE;AACnE,qDAAmC;AAEnC,0FAA0F"}
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/browser.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;AAEH,gEAAgE;AAChE,oDAAkC;AAalC,0FAA0F"}

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
+// 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/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,oFAAoF;AAEpF,4CAA4C;AAC5C,qCAAqC;AAErC,0FAA0F;AAC1F,iFAAiF"}

package/dist/cjs/shared-lib/errors/domains/wallet-errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"wallet-errors.js","sourceRoot":"","sources":["../../../../../src/shared-lib/errors/domains/wallet-errors.ts"],"names":[],"mappings":";;;AAqBA,kEAGG;AAxBH,2CAA4C;AAC5C,gEAA6F;AAC7F,gDAAgE;AAEhE;;GAEG;AAEH,MAAa,yBAA0B,SAAQ,qCAAe;IAC5D,YAAY,aAAqB,EAAE,MAAc;QAC/C,KAAK,CACH,8BAAgB,CAAC,sBAAsB,EACvC,0BAAY,CAAC,MAAM,EACnB,uCAAuC,EACvC,UAAU,aAAa,qBAAqB,MAAM,EAAE,EACpD,mBAAU,CAAC,oBAAoB,EAC/B,+CAA+C,CAChD,CAAC;IACJ,CAAC;CACF;AAXD,8DAWC;AAED,SAAgB,2BAA2B,CAAC,KAAU;IAClD,OAAO,KAAK,EAAE,SAAS,KAAK,wBAAwB;QAC9C,KAAK,EAAE,QAAQ,EAAE,IAAI,KAAK,wBAAwB,CAAC;AAC3D,CAAC;AAEH,MAAa,mBAAoB,SAAQ,qCAAe;IACtD,YAAY,YAAoB;QAC9B,KAAK,CACH,8BAAgB,CAAC,gBAAgB,EACjC,0BAAY,CAAC,MAAM,EACnB,kCAAkC,EAClC,sCAAsC,YAAY,EAAE,EACpD,mBAAU,CAAC,SAAS,EACpB,8BAA8B,CAC/B,CAAC;IACJ,CAAC;CACF;AAXD,kDAWC;AAED,MAAa,0BAA2B,SAAQ,oCAAc;IAC5D,YAAY,MAAc;QACxB,KAAK,CACH,8BAAgB,CAAC,8BAA8B,EAC/C,0BAAY,CAAC,MAAM,EACnB,4CAA4C,EAC5C,mCAAmC,MAAM,EAAE,EAC3C,mBAAU,CAAC,oBAAoB,EAC/B,+CAA+C,EAC/C,IAAI,CAAC,YAAY;SAClB,CAAC;IACJ,CAAC;CACF;AAZD,gEAYC"}
+{"version":3,"file":"wallet-errors.js","sourceRoot":"","sources":["../../../../../src/shared-lib/errors/domains/wallet-errors.ts"],"names":[],"mappings":";;;AAqBA,kEAGG;AAxBH,2CAA4C;AAC5C,gEAA6F;AAC7F,gDAAgE;AAEhE;;GAEG;AAEH,MAAa,yBAA0B,SAAQ,qCAAe;IAC5D,YAAY,aAAqB,EAAE,MAAc;QAC/C,KAAK,CACH,8BAAgB,CAAC,sBAAsB,EACvC,0BAAY,CAAC,MAAM,EACnB,uCAAuC,EACvC,UAAU,aAAa,qBAAqB,MAAM,EAAE,EACpD,mBAAU,CAAC,oBAAoB,EAC/B,+CAA+C,CAChD,CAAC;IACJ,CAAC;CACF;AAXD,8DAWC;AAED,SAAgB,2BAA2B,CAAC,KAAU;IACpD,OAAO,KAAK,EAAE,SAAS,KAAK,wBAAwB;QAC5C,KAAK,EAAE,QAAQ,EAAE,IAAI,KAAK,wBAAwB,CAAC;AAC3D,CAAC;AAEH,MAAa,mBAAoB,SAAQ,qCAAe;IACtD,YAAY,YAAoB;QAC9B,KAAK,CACH,8BAAgB,CAAC,gBAAgB,EACjC,0BAAY,CAAC,MAAM,EACnB,kCAAkC,EAClC,sCAAsC,YAAY,EAAE,EACpD,mBAAU,CAAC,SAAS,EACpB,8BAA8B,CAC/B,CAAC;IACJ,CAAC;CACF;AAXD,kDAWC;AAED,MAAa,0BAA2B,SAAQ,oCAAc;IAC5D,YAAY,MAAc;QACxB,KAAK,CACH,8BAAgB,CAAC,8BAA8B,EAC/C,0BAAY,CAAC,MAAM,EACnB,4CAA4C,EAC5C,mCAAmC,MAAM,EAAE,EAC3C,mBAAU,CAAC,oBAAoB,EAC/B,+CAA+C,EAC/C,IAAI,CAAC,YAAY;SAClB,CAAC;IACJ,CAAC;CACF;AAZD,gEAYC"}

package/dist/esm/browser.d.ts

@@ -5,5 +5,6 @@
 export * from './shared-lib/enum';
 export type * from './shared-lib/interfaces';
 export type * from './shared-lib/dto';
-export * from './shared-lib/types';
+export type * from './shared-lib/types';
+export type * from './shared-lib/errors';
 //# sourceMappingURL=browser.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/browser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,mBAAmB,CAAC;AAGlC,mBAAmB,yBAAyB,CAAC;AAG7C,mBAAmB,kBAAkB,CAAC;AAGtC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/browser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,mBAAmB,CAAC;AAGlC,mBAAmB,yBAAyB,CAAC;AAG7C,mBAAmB,kBAAkB,CAAC;AAGtC,mBAAmB,oBAAoB,CAAC;AAExC,mBAAmB,qBAAqB,CAAC"}

package/dist/esm/browser.js

@@ -4,7 +4,5 @@
  */
 // Export enums - these are safe for browser use (barrel export)
 export * from './shared-lib/enum';
-// Export types and constants (runtime exports) - browser-safe only
-export * from './shared-lib/types';
 // Note: Backend-specific types (like TRANSACTION_FORMATS) are excluded from browser build
 //# sourceMappingURL=browser.js.map

package/dist/esm/browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/browser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,gEAAgE;AAChE,cAAc,mBAAmB,CAAC;AAQlC,mEAAmE;AACnE,cAAc,oBAAoB,CAAC;AAEnC,0FAA0F"}
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/browser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,gEAAgE;AAChE,cAAc,mBAAmB,CAAC;AAalC,0FAA0F"}

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,oFAAoF;AAEpF,4CAA4C;AAC5C,qCAAqC;AAErC,0FAA0F;AAC1F,iFAAiF"}

package/dist/esm/shared-lib/errors/domains/wallet-errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"wallet-errors.js","sourceRoot":"","sources":["../../../../../src/shared-lib/errors/domains/wallet-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAsB,eAAe,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7F,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEhE;;GAEG;AAEH,MAAM,OAAO,yBAA0B,SAAQ,eAAe;IAC5D,YAAY,aAAqB,EAAE,MAAc;QAC/C,KAAK,CACH,gBAAgB,CAAC,sBAAsB,EACvC,YAAY,CAAC,MAAM,EACnB,uCAAuC,EACvC,UAAU,aAAa,qBAAqB,MAAM,EAAE,EACpD,UAAU,CAAC,oBAAoB,EAC/B,+CAA+C,CAChD,CAAC;IACJ,CAAC;CACF;AAED,MAAM,UAAU,2BAA2B,CAAC,KAAU;IAClD,OAAO,KAAK,EAAE,SAAS,KAAK,wBAAwB;QAC9C,KAAK,EAAE,QAAQ,EAAE,IAAI,KAAK,wBAAwB,CAAC;AAC3D,CAAC;AAEH,MAAM,OAAO,mBAAoB,SAAQ,eAAe;IACtD,YAAY,YAAoB;QAC9B,KAAK,CACH,gBAAgB,CAAC,gBAAgB,EACjC,YAAY,CAAC,MAAM,EACnB,kCAAkC,EAClC,sCAAsC,YAAY,EAAE,EACpD,UAAU,CAAC,SAAS,EACpB,8BAA8B,CAC/B,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,0BAA2B,SAAQ,cAAc;IAC5D,YAAY,MAAc;QACxB,KAAK,CACH,gBAAgB,CAAC,8BAA8B,EAC/C,YAAY,CAAC,MAAM,EACnB,4CAA4C,EAC5C,mCAAmC,MAAM,EAAE,EAC3C,UAAU,CAAC,oBAAoB,EAC/B,+CAA+C,EAC/C,IAAI,CAAC,YAAY;SAClB,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"wallet-errors.js","sourceRoot":"","sources":["../../../../../src/shared-lib/errors/domains/wallet-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAsB,eAAe,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7F,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEhE;;GAEG;AAEH,MAAM,OAAO,yBAA0B,SAAQ,eAAe;IAC5D,YAAY,aAAqB,EAAE,MAAc;QAC/C,KAAK,CACH,gBAAgB,CAAC,sBAAsB,EACvC,YAAY,CAAC,MAAM,EACnB,uCAAuC,EACvC,UAAU,aAAa,qBAAqB,MAAM,EAAE,EACpD,UAAU,CAAC,oBAAoB,EAC/B,+CAA+C,CAChD,CAAC;IACJ,CAAC;CACF;AAED,MAAM,UAAU,2BAA2B,CAAC,KAAU;IACpD,OAAO,KAAK,EAAE,SAAS,KAAK,wBAAwB;QAC5C,KAAK,EAAE,QAAQ,EAAE,IAAI,KAAK,wBAAwB,CAAC;AAC3D,CAAC;AAEH,MAAM,OAAO,mBAAoB,SAAQ,eAAe;IACtD,YAAY,YAAoB;QAC9B,KAAK,CACH,gBAAgB,CAAC,gBAAgB,EACjC,YAAY,CAAC,MAAM,EACnB,kCAAkC,EAClC,sCAAsC,YAAY,EAAE,EACpD,UAAU,CAAC,SAAS,EACpB,8BAA8B,CAC/B,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,0BAA2B,SAAQ,cAAc;IAC5D,YAAY,MAAc;QACxB,KAAK,CACH,gBAAgB,CAAC,8BAA8B,EAC/C,YAAY,CAAC,MAAM,EACnB,4CAA4C,EAC5C,mCAAmC,MAAM,EAAE,EAC3C,UAAU,CAAC,oBAAoB,EAC/B,+CAA+C,EAC/C,IAAI,CAAC,YAAY;SAClB,CAAC;IACJ,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@explorins/pers-shared",
-  "version": "2.1.36",
+  "version": "2.1.38",
   "scripts": {
     "clean": "find dist -type f -delete 2>/dev/null || true",
     "build:esm": "tsc -p tsconfig.esm.json",
@@ -42,30 +42,7 @@
     "README.md",
     "CHANGELOG.md"
   ],
-  "peerDependencies": {
-    "@nestjs/common": "^10.0.0",
-    "@nestjs/swagger": "^7.0.0",
-    "class-transformer": "^0.5.0",
-    "class-validator": "^0.14.0",
-    "reflect-metadata": "^0.1.13"
-  },
-  "peerDependenciesMeta": {
-    "@nestjs/common": {
-      "optional": true
-    },
-    "@nestjs/swagger": {
-      "optional": true
-    },
-    "class-validator": {
-      "optional": true
-    },
-    "class-transformer": {
-      "optional": true
-    },
-    "reflect-metadata": {
-      "optional": true
-    }
-  },
+  "peerDependencies": {},
   "devDependencies": {
     "concurrently": "^9.2.0"
   }