@schorts/shared-kernel 5.4.3 → 6.0.1

package/README.md

@@ -70,6 +70,7 @@ Translation keys are centralized in registries for discoverability and tooling,
 
 - **JSONAPIConnector:** Connector for interacting with JSON:API-compliant endpoints.
 - **URLCriteriaParser:** Utility for parsing JSON:API-style query parameters (`filter`, `sort`, `page[limit]`, `page[offset]`) into a type-safe `Criteria` object. Supports operators like `eq`, `ne`, `gt`, `lt`, `in`, `between`, and even geospatial filters (`geo_radius`). This enables seamless conversion from URL query strings into expressive domain queries.
+- **EntityJSONAPIMapper:** Static utility for converting domain `Entity` instances into JSON:API-compliant payloads. Provides `mapEntity` for single resources and `mapEntities` for collections, ensuring attributes are serialized consistently with the JSON:API specification.
 
 ### 📬 Mail
 

package/dist/cjs/json-api/entity-json-api-mapper.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntityJSONAPIMapper = void 0;
+class EntityJSONAPIMapper {
+    type;
+    constructor(type) {
+        this.type = type;
+    }
+    mapEntity(entity) {
+        const attributes = entity.toPrimitives();
+        delete attributes.id;
+        return {
+            data: {
+                type: this.type,
+                id: entity.id.value,
+                attributes: attributes,
+            },
+        };
+    }
+    mapEntities(entities) {
+        return { data: entities.map((e) => this.mapEntity(e).data) };
+    }
+}
+exports.EntityJSONAPIMapper = EntityJSONAPIMapper;
+//# sourceMappingURL=entity-json-api-mapper.js.map

package/dist/cjs/json-api/entity-json-api-mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-json-api-mapper.js","sourceRoot":"","sources":["../../../src/json-api/entity-json-api-mapper.ts"],"names":[],"mappings":";;;AAMA,MAAa,mBAAmB;IAEX;IADnB,YACmB,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;IAC3B,CAAC;IAEL,SAAS,CAAC,MAAc;QACtB,MAAM,UAAU,GAAwB,MAAM,CAAC,YAAY,EAAE,CAAC;QAE9D,OAAO,UAAU,CAAC,EAAE,CAAC;QAErB,OAAO;YACL,IAAI,EAAE;gBACJ,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,KAAe;gBAC7B,UAAU,EAAE,UAA+B;aAC5C;SACF,CAAC;IACJ,CAAC;IAED,WAAW,CAAC,QAAuB;QACjC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;IAC/D,CAAC;CACF;AAtBD,kDAsBC"}

package/dist/cjs/json-api/index.js

@@ -14,12 +14,14 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.URLCriteriaParser = exports.JSONAPIConnector = exports.URLCriteriaBuilder = void 0;
+exports.EntityJSONAPIMapper = exports.URLCriteriaParser = exports.JSONAPIConnector = exports.URLCriteriaBuilder = void 0;
 var url_criteria_builder_1 = require("./url-criteria-builder");
 Object.defineProperty(exports, "URLCriteriaBuilder", { enumerable: true, get: function () { return url_criteria_builder_1.URLCriteriaBuilder; } });
 var json_api_connector_1 = require("./json-api-connector");
 Object.defineProperty(exports, "JSONAPIConnector", { enumerable: true, get: function () { return json_api_connector_1.JSONAPIConnector; } });
 var url_criteria_parser_1 = require("./url-criteria-parser");
 Object.defineProperty(exports, "URLCriteriaParser", { enumerable: true, get: function () { return url_criteria_parser_1.URLCriteriaParser; } });
+var entity_json_api_mapper_1 = require("./entity-json-api-mapper");
+Object.defineProperty(exports, "EntityJSONAPIMapper", { enumerable: true, get: function () { return entity_json_api_mapper_1.EntityJSONAPIMapper; } });
 __exportStar(require("./exceptions"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/json-api/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/json-api/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAEA,+DAA4D;AAAnD,0HAAA,kBAAkB,OAAA;AAC3B,2DAAwD;AAA/C,sHAAA,gBAAgB,OAAA;AACzB,6DAAyD;AAAhD,wHAAA,iBAAiB,OAAA;AAC1B,+CAA6B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/json-api/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAEA,+DAA4D;AAAnD,0HAAA,kBAAkB,OAAA;AAC3B,2DAAwD;AAA/C,sHAAA,gBAAgB,OAAA;AACzB,6DAA0D;AAAjD,wHAAA,iBAAiB,OAAA;AAC1B,mEAA+D;AAAtD,6HAAA,mBAAmB,OAAA;AAC5B,+CAA6B"}

package/dist/esm/json-api/entity-json-api-mapper.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntityJSONAPIMapper = void 0;
+class EntityJSONAPIMapper {
+    type;
+    constructor(type) {
+        this.type = type;
+    }
+    mapEntity(entity) {
+        const attributes = entity.toPrimitives();
+        delete attributes.id;
+        return {
+            data: {
+                type: this.type,
+                id: entity.id.value,
+                attributes: attributes,
+            },
+        };
+    }
+    mapEntities(entities) {
+        return { data: entities.map((e) => this.mapEntity(e).data) };
+    }
+}
+exports.EntityJSONAPIMapper = EntityJSONAPIMapper;
+//# sourceMappingURL=entity-json-api-mapper.js.map

package/dist/esm/json-api/entity-json-api-mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-json-api-mapper.js","sourceRoot":"","sources":["../../../src/json-api/entity-json-api-mapper.ts"],"names":[],"mappings":";;;AAMA,MAAa,mBAAmB;IAEX;IADnB,YACmB,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;IAC3B,CAAC;IAEL,SAAS,CAAC,MAAc;QACtB,MAAM,UAAU,GAAwB,MAAM,CAAC,YAAY,EAAE,CAAC;QAE9D,OAAO,UAAU,CAAC,EAAE,CAAC;QAErB,OAAO;YACL,IAAI,EAAE;gBACJ,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,KAAe;gBAC7B,UAAU,EAAE,UAA+B;aAC5C;SACF,CAAC;IACJ,CAAC;IAED,WAAW,CAAC,QAAuB;QACjC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;IAC/D,CAAC;CACF;AAtBD,kDAsBC"}

package/dist/esm/json-api/index.js

@@ -14,12 +14,14 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.URLCriteriaParser = exports.JSONAPIConnector = exports.URLCriteriaBuilder = void 0;
+exports.EntityJSONAPIMapper = exports.URLCriteriaParser = exports.JSONAPIConnector = exports.URLCriteriaBuilder = void 0;
 var url_criteria_builder_1 = require("./url-criteria-builder");
 Object.defineProperty(exports, "URLCriteriaBuilder", { enumerable: true, get: function () { return url_criteria_builder_1.URLCriteriaBuilder; } });
 var json_api_connector_1 = require("./json-api-connector");
 Object.defineProperty(exports, "JSONAPIConnector", { enumerable: true, get: function () { return json_api_connector_1.JSONAPIConnector; } });
 var url_criteria_parser_1 = require("./url-criteria-parser");
 Object.defineProperty(exports, "URLCriteriaParser", { enumerable: true, get: function () { return url_criteria_parser_1.URLCriteriaParser; } });
+var entity_json_api_mapper_1 = require("./entity-json-api-mapper");
+Object.defineProperty(exports, "EntityJSONAPIMapper", { enumerable: true, get: function () { return entity_json_api_mapper_1.EntityJSONAPIMapper; } });
 __exportStar(require("./exceptions"), exports);
 //# sourceMappingURL=index.js.map

package/dist/esm/json-api/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/json-api/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAEA,+DAA4D;AAAnD,0HAAA,kBAAkB,OAAA;AAC3B,2DAAwD;AAA/C,sHAAA,gBAAgB,OAAA;AACzB,6DAAyD;AAAhD,wHAAA,iBAAiB,OAAA;AAC1B,+CAA6B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/json-api/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAEA,+DAA4D;AAAnD,0HAAA,kBAAkB,OAAA;AAC3B,2DAAwD;AAA/C,sHAAA,gBAAgB,OAAA;AACzB,6DAA0D;AAAjD,wHAAA,iBAAiB,OAAA;AAC1B,mEAA+D;AAAtD,6HAAA,mBAAmB,OAAA;AAC5B,+CAA6B"}

package/dist/types/json-api/entity-json-api-mapper.d.ts

@@ -0,0 +1,12 @@
+import { Entity as BaseEntity } from "../entities";
+import { ValueObject } from "../value-objects";
+import { Model as BaseModel } from "../models";
+import { JSONAPIList } from "./json-api-list";
+import { JSONAPISingle } from "./json-api-single";
+export declare class EntityJSONAPIMapper<Model extends BaseModel, Entity extends BaseEntity<ValueObject, Model>> {
+    private readonly type;
+    constructor(type: string);
+    mapEntity(entity: Entity): JSONAPISingle<Model>;
+    mapEntities(entities: Array<Entity>): JSONAPIList<Model>;
+}
+//# sourceMappingURL=entity-json-api-mapper.d.ts.map

package/dist/types/json-api/entity-json-api-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-json-api-mapper.d.ts","sourceRoot":"","sources":["../../../src/json-api/entity-json-api-mapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,qBAAa,mBAAmB,CAAC,KAAK,SAAS,SAAS,EAAE,MAAM,SAAS,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC;IAEnG,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,MAAM;IAG/B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC;IAc/C,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC;CAGzD"}

package/dist/types/json-api/index.d.ts

@@ -3,5 +3,6 @@ export type { JSONAPIList } from "./json-api-list";
 export { URLCriteriaBuilder } from "./url-criteria-builder";
 export { JSONAPIConnector } from "./json-api-connector";
 export { URLCriteriaParser } from "./url-criteria-parser";
+export { EntityJSONAPIMapper } from "./entity-json-api-mapper";
 export * from "./exceptions";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/json-api/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/json-api/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/json-api/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,cAAc,cAAc,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@schorts/shared-kernel",
-  "version": "5.4.3",
+  "version": "6.0.1",
   "description": "A modular, type-safe foundation for building expressive, maintainable applications. This package provides core abstractions for domain modeling, HTTP integration, authentication, state management, and more — designed to be framework-agnostic and highly extensible.",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",