hexok 1.0.0

package/dist/testing/in-memory-repository.d.ts

@@ -0,0 +1,44 @@
+import type { CrudRepository, Entity, PortToken } from '../domain/index.js';
+type CrudKeys = 'get' | 'save' | 'list' | 'delete';
+type ExtraKeys<I> = Exclude<keyof I, CrudKeys | 'bindTo' | 'fork'>;
+type ExtraOption<I> = [ExtraKeys<I>] extends [never] ? unknown : {
+    extra: Pick<I, ExtraKeys<I>>;
+};
+type RepoEntity<I> = I extends {
+    get: (id: string) => Promise<infer E>;
+} ? NonNullable<E> : Entity<Record<string, unknown>>;
+type EntityKey<E> = E extends {
+    toProps(): infer P;
+} ? P extends object ? keyof P & string : string : string;
+type AssertCrud<I> = 'get' | 'save' extends keyof I ? I : `hexok: InMemoryRepository.of expects a CRUD repository port`;
+/**
+ * In-memory fake for the standard CRUD port `{ get, save, list, delete }`.
+ * Clones on get/save so tests do not mutate the store by accident.
+ *
+ * ```ts
+ * .provide(IncidentRepository, InMemoryRepository.of(IncidentRepository, {
+ *   keyBy: 'id',
+ *   seed: [Incident.open('1')],
+ * }))
+ * ```
+ */
+export declare class InMemoryRepository<E extends Entity<Record<string, unknown>>> implements CrudRepository<E> {
+    #private;
+    private constructor();
+    /** Fake a CRUD port. Extra methods beyond get/save/list/delete go in `extra`. */
+    static of<I>(_token: [AssertCrud<I>] extends [I] ? PortToken<I> : AssertCrud<I>, options: {
+        keyBy: EntityKey<RepoEntity<I>>;
+        seed?: RepoEntity<I>[];
+    } & ExtraOption<I>): I;
+    /** Clone of the stored entity, or `null`. */
+    get(id: string): Promise<E | null>;
+    /** Clone into the store and `commit()` the working entity. */
+    save(entity: E): Promise<void>;
+    /** Clones of every stored entity. */
+    list(): Promise<E[]>;
+    /** Remove by id. No-op if missing. */
+    delete(id: string): Promise<void>;
+    private keyOf;
+}
+export {};
+//# sourceMappingURL=in-memory-repository.d.ts.map

package/dist/testing/in-memory-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-repository.d.ts","sourceRoot":"","sources":["../../src/testing/in-memory-repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,MAAM,EAEN,SAAS,EACV,MAAM,oBAAoB,CAAC;AAE5B,KAAK,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEnD,KAAK,SAAS,CAAC,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAC;AAEnE,KAAK,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAChD,OAAO,GACP;IAAE,KAAK,EAAE,IAAI,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;CAAE,CAAC;AAErC,KAAK,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS;IAC7B,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;CACvC,GACG,WAAW,CAAC,CAAC,CAAC,GACd,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEpC,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,OAAO,IAAI,MAAM,CAAC,CAAA;CAAE,GAChD,CAAC,SAAS,MAAM,GACd,MAAM,CAAC,GAAG,MAAM,GAChB,MAAM,GACR,MAAM,CAAC;AAEX,KAAK,UAAU,CAAC,CAAC,IAAI,KAAK,GAAG,MAAM,SAAS,MAAM,CAAC,GAC/C,CAAC,GACD,6DAA6D,CAAC;AAElE;;;;;;;;;;GAUG;AACH,qBAAa,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CACvE,YAAW,cAAc,CAAC,CAAC,CAAC;;IAK5B,OAAO;IAOP,iFAAiF;IACjF,MAAM,CAAC,EAAE,CAAC,CAAC,EACT,MAAM,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,EAClE,OAAO,EAAE;QACP,KAAK,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;KACxB,GAAG,WAAW,CAAC,CAAC,CAAC,GACjB,CAAC;IAWJ,6CAA6C;IACvC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAKxC,8DAA8D;IACxD,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpC,qCAAqC;IAC/B,IAAI,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC;IAI1B,sCAAsC;IAChC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC,OAAO,CAAC,KAAK;CAUd"}

package/dist/testing/in-memory-repository.js

@@ -0,0 +1,60 @@
+/**
+ * In-memory fake for the standard CRUD port `{ get, save, list, delete }`.
+ * Clones on get/save so tests do not mutate the store by accident.
+ *
+ * ```ts
+ * .provide(IncidentRepository, InMemoryRepository.of(IncidentRepository, {
+ *   keyBy: 'id',
+ *   seed: [Incident.open('1')],
+ * }))
+ * ```
+ */
+export class InMemoryRepository {
+    #keyBy;
+    #store = new Map();
+    constructor(keyBy, seed) {
+        this.#keyBy = keyBy;
+        for (const entity of seed) {
+            this.#store.set(this.keyOf(entity), cloneEntity(entity));
+        }
+    }
+    /** Fake a CRUD port. Extra methods beyond get/save/list/delete go in `extra`. */
+    static of(_token, options) {
+        const repo = new InMemoryRepository(options.keyBy, (options.seed ?? []));
+        if ('extra' in options && options.extra !== undefined) {
+            return Object.assign(repo, options.extra);
+        }
+        return repo;
+    }
+    /** Clone of the stored entity, or `null`. */
+    async get(id) {
+        const found = this.#store.get(id);
+        return found ? cloneEntity(found) : null;
+    }
+    /** Clone into the store and `commit()` the working entity. */
+    async save(entity) {
+        this.#store.set(this.keyOf(entity), cloneEntity(entity));
+        entity.commit();
+    }
+    /** Clones of every stored entity. */
+    async list() {
+        return [...this.#store.values()].map((entity) => cloneEntity(entity));
+    }
+    /** Remove by id. No-op if missing. */
+    async delete(id) {
+        this.#store.delete(id);
+    }
+    keyOf(entity) {
+        const props = entity.toProps();
+        const key = props[this.#keyBy];
+        if (typeof key !== 'string') {
+            throw new Error(`hexok: InMemoryRepository keyBy "${this.#keyBy}" is not a string`);
+        }
+        return key;
+    }
+}
+function cloneEntity(entity) {
+    const Ctor = entity.constructor;
+    return Ctor.restore(entity.toProps());
+}
+//# sourceMappingURL=in-memory-repository.js.map

package/dist/testing/in-memory-repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-repository.js","sourceRoot":"","sources":["../../src/testing/in-memory-repository.ts"],"names":[],"mappings":"AA+BA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,kBAAkB;IAGpB,MAAM,CAAS;IACf,MAAM,GAAG,IAAI,GAAG,EAAa,CAAC;IAEvC,YAAoB,KAAa,EAAE,IAAS;QAC1C,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,KAAK,MAAM,MAAM,IAAI,IAAI,EAAE,CAAC;YAC1B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,iFAAiF;IACjF,MAAM,CAAC,EAAE,CACP,MAAkE,EAClE,OAGkB;QAElB,MAAM,IAAI,GAAG,IAAI,kBAAkB,CACjC,OAAO,CAAC,KAAK,EACb,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAsC,CAC1D,CAAC;QACF,IAAI,OAAO,IAAI,OAAO,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACtD,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAiB,CAAC;QAC5D,CAAC;QACD,OAAO,IAAoB,CAAC;IAC9B,CAAC;IAED,6CAA6C;IAC7C,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClC,OAAO,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3C,CAAC;IAED,8DAA8D;IAC9D,KAAK,CAAC,IAAI,CAAC,MAAS;QAClB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;QACzD,MAAM,CAAC,MAAM,EAAE,CAAC;IAClB,CAAC;IAED,qCAAqC;IACrC,KAAK,CAAC,IAAI;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,sCAAsC;IACtC,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACzB,CAAC;IAEO,KAAK,CAAC,MAAS;QACrB,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,EAA6B,CAAC;QAC1D,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/B,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CACb,oCAAoC,IAAI,CAAC,MAAM,mBAAmB,CACnE,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AAED,SAAS,WAAW,CAA4C,MAAS;IACvE,MAAM,IAAI,GAAG,MAAM,CAAC,WAEnB,CAAC;IACF,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;AACxC,CAAC"}

package/dist/testing/index.d.ts

@@ -0,0 +1,6 @@
+export { App, TestAppBuilder, type TestAppInstance } from './app-test.js';
+export { InMemoryBus } from './in-memory-bus.js';
+export { InMemoryChannel } from './in-memory-channel.js';
+export { InMemoryQueue } from './in-memory-queue.js';
+export { InMemoryRepository } from './in-memory-repository.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/testing/index.js

@@ -0,0 +1,6 @@
+export { App, TestAppBuilder } from './app-test.js';
+export { InMemoryBus } from './in-memory-bus.js';
+export { InMemoryChannel } from './in-memory-channel.js';
+export { InMemoryQueue } from './in-memory-queue.js';
+export { InMemoryRepository } from './in-memory-repository.js';
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,cAAc,EAAwB,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "hexok",
+  "version": "1.0.0",
+  "description": "A TypeScript kit for writing a clean-architecture backend as ordinary classes.",
+  "type": "module",
+  "license": "MIT",
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/crobinson42/hexok.git",
+    "directory": "packages/hexok"
+  },
+  "homepage": "https://github.com/crobinson42/hexok#readme",
+  "bugs": {
+    "url": "https://github.com/crobinson42/hexok/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.js"
+    },
+    "./domain": {
+      "types": "./dist/domain/index.d.ts",
+      "import": "./dist/domain/index.js"
+    },
+    "./app": {
+      "types": "./dist/app/index.d.ts",
+      "import": "./dist/app/index.js"
+    },
+    "./infra": {
+      "types": "./dist/infra/index.d.ts",
+      "import": "./dist/infra/index.js"
+    },
+    "./runtime": {
+      "types": "./dist/runtime/index.d.ts",
+      "import": "./dist/runtime/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "import": "./dist/testing/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "test": "vitest run",
+    "type-check": "tsc --noEmit -p tsconfig.check.json",
+    "lint": "biome check .",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  },
+  "devDependencies": {
+    "zod": "^4.1.5"
+  }
+}