@schorts/shared-kernel 1.1.0 → 1.1.1

package/CHANGELOG

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.1] - 2025-09-30
+
+### Added
+
+- Added `RegisterEntity` decorator to only decorate the entity to add it to the `EntityRegistry`.
+
 ## [1.1.0] - 2025-09-30
 
 ### Changed

package/__tests__/entities/register-entity.decorator.test.ts

@@ -0,0 +1,54 @@
+import { RegisterEntity, EntityRegistry, Entity, EntityNotRegistered } from "../../src/entities";
+import { UUIDValue } from "../../src/value-objects";
+
+type MockModel = {
+  id: string;
+};
+
+class ID extends UUIDValue {
+  attributeName = "id";
+}
+
+class MockEntity extends Entity<ID, MockModel> {
+  constructor(id: ID) {
+    super(id);
+  }
+
+  toPrimitives(): MockModel {
+    return {
+      id: this.id.value,
+    };
+  }
+
+  static fromPrimitives<MockModel>(model: MockModel): MockEntity {
+    return new MockEntity(new ID(model["id"]));
+  }
+}
+
+RegisterEntity("mock")(MockEntity);
+
+describe("RegisterEntity", () => {
+  beforeEach(() => {
+    (EntityRegistry as any).registry.clear();
+    RegisterEntity("mock")(MockEntity);
+  });
+
+  it("registers the entity constructor under the given type", () => {
+    const resolved = EntityRegistry.resolve<MockModel>("mock");
+    expect(resolved).toBe(MockEntity);
+  });
+
+  it("creates an entity instance from registered type", () => {
+    const model = { id: 'abc-123' };
+    const entity = EntityRegistry.create("mock", model);
+
+    expect(entity).toBeInstanceOf(MockEntity);
+    expect(entity.id.value).toBe("abc-123");
+  });
+
+  it("throws if trying to create an unregistered entity", () => {
+    const model = { id: '123' };
+
+    expect(() => EntityRegistry.create("unknown", model)).toThrow(EntityNotRegistered);
+  });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@schorts/shared-kernel",
-  "version": "1.1.0",
+  "version": "1.1.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/index.js",
   "types": "./dist/index.d.ts",

package/src/entities/entity-registry.ts

@@ -16,7 +16,7 @@ export class EntityRegistry {
 
   static resolve<Model extends BaseModel>(type: string): EntityConstructor<Model> | null {
     return (this.registry.get(type) || null) as EntityConstructor<Model> | null;
-  }  
+  }
 
   static create<Model extends BaseModel>(type: string, model: Model): Entity<ValueObject, Model> {
     const entity = this.resolve<Model>(type);

package/src/entities/index.ts

@@ -1,3 +1,4 @@
 export { Entity } from "./entity";
 export { EntityRegistry } from "./entity-registry";
 export { EntityNotRegistered } from "./exceptions";
+export { RegisterEntity } from "./register-entity.decorator";

package/src/entities/register-entity.decorator.ts

@@ -0,0 +1,16 @@
+import { EntityRegistry } from "./entity-registry";
+import { BaseModel } from "../models";
+import { Entity as BaseEntity } from "./entity";
+import { ValueObject } from "../value-objects";
+
+type EntityConstructor<Model extends BaseModel = BaseModel> = {
+  fromPrimitives(model: Model): BaseEntity<ValueObject, Model>;
+};
+
+export function RegisterEntity<Model extends BaseModel = BaseModel>(type: string) {
+  return function <Entity extends EntityConstructor<Model>>(entity: Entity): Entity {
+    EntityRegistry.register(type, entity);
+
+    return entity;
+  };
+}