@entifix/testing-unit 0.8.0 → 0.10.0

package/README.md

@@ -52,6 +52,12 @@ describeEntityRepositoryContract('mongo adapter over a fake driver', { makeRepos
 A read-only adapter runs `describeEntityRepositoryReadContract` alone;
 `describeEntityRepositoryContract` is it and `describeEntityRepositoryWriteContract`.
 
+`describeEntityFacetCounterContract` holds a facet counter to Mongo's `$facet`
+semantics — each member under its own filtering, an array member counted per
+element, a missing value not counted — and `makeInMemoryFacetCounter` is the
+double that passes it. A counter reached through the query protocol passes
+`countsCollections: false`, since no collection member is ever `filterable`.
+
 `describeUnitOfWorkContract` holds a unit of work to the same rules whatever
 its store: writes, events and the claim commit or vanish together, a taken
 claim is a `duplicate` that never runs the body, and a business failure is an

package/dist/contracts/entity-facet-counter.contract.d.ts

@@ -0,0 +1,30 @@
+import type { EntityFacetCounter } from '@entifix/business';
+import { ContractWidget } from './entity-repository.contract.js';
+export interface EntityFacetCounterContractOptions {
+    /**
+     * Builds a counter over `seed`. Called fresh for each test, so no state
+     * leaks between them.
+     */
+    makeCounter(seed: ContractWidget[]): EntityFacetCounter | Promise<EntityFacetCounter>;
+    /**
+     * `false` for a counter reached through the query protocol. A collection
+     * member is never `filterable` — core refuses to declare one so — and the
+     * protocol counts only filterable members, so over the wire an array member
+     * is a `400` before any counter sees it. Defaults to `true`.
+     */
+    readonly countsCollections?: boolean;
+}
+/**
+ * What every {@link EntityFacetCounter} must answer alike: how many records
+ * hold each value of each member, each member under its own filtering — the
+ * semantics of a Mongo `$facet` of `$match`, `$unwind` and `$group`.
+ *
+ * Run it against the in-memory counter *and* against each real adapter, so the
+ * fake a consumer's specs use cannot drift into a more forgiving version of
+ * the engine.
+ *
+ * Which member a request may count is the protocol's rule, not the counter's
+ * (`parseFacetQueryParams`): a counter counts what it is handed.
+ */
+export declare const describeEntityFacetCounterContract: (name: string, { makeCounter, countsCollections }: EntityFacetCounterContractOptions) => void;
+//# sourceMappingURL=entity-facet-counter.contract.d.ts.map

package/dist/contracts/entity-facet-counter.contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-facet-counter.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/entity-facet-counter.contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAI5D,OAAO,EACL,cAAc,EAEf,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,iCAAiC;IAChD;;;OAGG;IACH,WAAW,CACT,IAAI,EAAE,cAAc,EAAE,GACrB,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACpD;;;;;OAKG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CACtC;AAQD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kCAAkC,GAC7C,MAAM,MAAM,EACZ,oCAA2C,iCAAiC,KAC3E,IAuHF,CAAC"}

package/dist/contracts/entity-facet-counter.contract.js

@@ -0,0 +1,194 @@
+import { describe, expect, it } from 'vitest';
+import { run } from '../effect/run.js';
+import { ContractWidget, makeContractWidget } from './entity-repository.contract.js';
+const seeded = ()=>[
+        makeContractWidget('w-1', 'Alpha', 10, [
+            'blue',
+            'green'
+        ]),
+        makeContractWidget('w-2', 'Beta', 10, [
+            'green'
+        ]),
+        makeContractWidget('w-3', 'Alpha', 30, [
+            'green',
+            'red'
+        ])
+    ];
+/**
+ * What every {@link EntityFacetCounter} must answer alike: how many records
+ * hold each value of each member, each member under its own filtering — the
+ * semantics of a Mongo `$facet` of `$match`, `$unwind` and `$group`.
+ *
+ * Run it against the in-memory counter *and* against each real adapter, so the
+ * fake a consumer's specs use cannot drift into a more forgiving version of
+ * the engine.
+ *
+ * Which member a request may count is the protocol's rule, not the counter's
+ * (`parseFacetQueryParams`): a counter counts what it is handed.
+ */ export const describeEntityFacetCounterContract = (name, { makeCounter, countsCollections = true })=>{
+    describe(`EntityFacetCounter contract: ${name}`, ()=>{
+        const withCounter = async (use, seed = seeded())=>{
+            await use(await makeCounter(seed));
+        };
+        it('counts every value of every member, highest count first', async ()=>{
+            await withCounter(async (counter)=>{
+                const counts = await run(counter.count([
+                    {
+                        member: 'name'
+                    },
+                    {
+                        member: 'size'
+                    }
+                ]));
+                expect(counts).toEqual({
+                    name: [
+                        {
+                            value: 'Alpha',
+                            count: 2
+                        },
+                        {
+                            value: 'Beta',
+                            count: 1
+                        }
+                    ],
+                    size: [
+                        {
+                            value: 10,
+                            count: 2
+                        },
+                        {
+                            value: 30,
+                            count: 1
+                        }
+                    ]
+                });
+            });
+        });
+        it('counts each member under its own filtering only', async ()=>{
+            await withCounter(async (counter)=>{
+                const counts = await run(counter.count([
+                    {
+                        member: 'name',
+                        filtering: [
+                            {
+                                property: 'size',
+                                operator: 'eq',
+                                value: 10
+                            }
+                        ]
+                    },
+                    {
+                        member: 'size',
+                        filtering: [
+                            {
+                                property: 'name',
+                                operator: 'eq',
+                                value: 'Alpha'
+                            }
+                        ]
+                    }
+                ]));
+                expect(counts).toEqual({
+                    name: [
+                        {
+                            value: 'Alpha',
+                            count: 1
+                        },
+                        {
+                            value: 'Beta',
+                            count: 1
+                        }
+                    ],
+                    size: [
+                        {
+                            value: 10,
+                            count: 1
+                        },
+                        {
+                            value: 30,
+                            count: 1
+                        }
+                    ]
+                });
+            });
+        });
+        it.runIf(countsCollections)('counts each element of an array member', async ()=>{
+            await withCounter(async (counter)=>{
+                const counts = await run(counter.count([
+                    {
+                        member: 'tags'
+                    }
+                ]));
+                expect(counts).toEqual({
+                    tags: [
+                        {
+                            value: 'green',
+                            count: 3
+                        },
+                        {
+                            value: 'blue',
+                            count: 1
+                        },
+                        {
+                            value: 'red',
+                            count: 1
+                        }
+                    ]
+                });
+            });
+        });
+        it('does not count a missing value', async ()=>{
+            const unnamed = new ContractWidget();
+            unnamed.id = 'w-9';
+            await withCounter(async (counter)=>{
+                const counts = await run(counter.count([
+                    {
+                        member: 'name'
+                    }
+                ]));
+                expect(counts).toEqual({
+                    name: [
+                        {
+                            value: 'Alpha',
+                            count: 1
+                        }
+                    ]
+                });
+            }, [
+                makeContractWidget('w-1', 'Alpha', 10),
+                unnamed
+            ]);
+        });
+        it.runIf(countsCollections)('does not count an empty array', async ()=>{
+            await withCounter(async (counter)=>{
+                const counts = await run(counter.count([
+                    {
+                        member: 'tags'
+                    }
+                ]));
+                expect(counts).toEqual({
+                    tags: []
+                });
+            }, [
+                makeContractWidget('w-1', 'Alpha', 10)
+            ]);
+        });
+        it('answers every queried member, empty, from an empty store', async ()=>{
+            await withCounter(async (counter)=>{
+                expect(await run(counter.count([
+                    {
+                        member: 'name'
+                    },
+                    {
+                        member: 'size'
+                    }
+                ]))).toEqual({
+                    name: [],
+                    size: []
+                });
+            }, []);
+        });
+    });
+};
+
+//# sourceMappingURL=entity-facet-counter.contract.js.map

package/dist/contracts/entity-facet-counter.contract.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/contracts/entity-facet-counter.contract.ts"],"sourcesContent":["import type { EntityFacetCounter } from '@entifix/business';\nimport { describe, expect, it } from 'vitest';\n\nimport { run } from '../effect/run.js';\nimport {\n  ContractWidget,\n  makeContractWidget,\n} from './entity-repository.contract.js';\n\nexport interface EntityFacetCounterContractOptions {\n  /**\n   * Builds a counter over `seed`. Called fresh for each test, so no state\n   * leaks between them.\n   */\n  makeCounter(\n    seed: ContractWidget[],\n  ): EntityFacetCounter | Promise<EntityFacetCounter>;\n  /**\n   * `false` for a counter reached through the query protocol. A collection\n   * member is never `filterable` — core refuses to declare one so — and the\n   * protocol counts only filterable members, so over the wire an array member\n   * is a `400` before any counter sees it. Defaults to `true`.\n   */\n  readonly countsCollections?: boolean;\n}\n\nconst seeded = () => [\n  makeContractWidget('w-1', 'Alpha', 10, ['blue', 'green']),\n  makeContractWidget('w-2', 'Beta', 10, ['green']),\n  makeContractWidget('w-3', 'Alpha', 30, ['green', 'red']),\n];\n\n/**\n * What every {@link EntityFacetCounter} must answer alike: how many records\n * hold each value of each member, each member under its own filtering — the\n * semantics of a Mongo `$facet` of `$match`, `$unwind` and `$group`.\n *\n * Run it against the in-memory counter *and* against each real adapter, so the\n * fake a consumer's specs use cannot drift into a more forgiving version of\n * the engine.\n *\n * Which member a request may count is the protocol's rule, not the counter's\n * (`parseFacetQueryParams`): a counter counts what it is handed.\n */\nexport const describeEntityFacetCounterContract = (\n  name: string,\n  { makeCounter, countsCollections = true }: EntityFacetCounterContractOptions,\n): void => {\n  describe(`EntityFacetCounter contract: ${name}`, () => {\n    const withCounter = async (\n      use: (counter: EntityFacetCounter) => Promise<void>,\n      seed: ContractWidget[] = seeded(),\n    ) => {\n      await use(await makeCounter(seed));\n    };\n\n    it('counts every value of every member, highest count first', async () => {\n      await withCounter(async counter => {\n        const counts = await run(\n          counter.count<ContractWidget>([\n            { member: 'name' },\n            { member: 'size' },\n          ]),\n        );\n\n        expect(counts).toEqual({\n          name: [\n            { value: 'Alpha', count: 2 },\n            { value: 'Beta', count: 1 },\n          ],\n          size: [\n            { value: 10, count: 2 },\n            { value: 30, count: 1 },\n          ],\n        });\n      });\n    });\n\n    it('counts each member under its own filtering only', async () => {\n      await withCounter(async counter => {\n        const counts = await run(\n          counter.count<ContractWidget>([\n            {\n              member: 'name',\n              filtering: [{ property: 'size', operator: 'eq', value: 10 }],\n            },\n            {\n              member: 'size',\n              filtering: [{ property: 'name', operator: 'eq', value: 'Alpha' }],\n            },\n          ]),\n        );\n\n        expect(counts).toEqual({\n          name: [\n            { value: 'Alpha', count: 1 },\n            { value: 'Beta', count: 1 },\n          ],\n          size: [\n            { value: 10, count: 1 },\n            { value: 30, count: 1 },\n          ],\n        });\n      });\n    });\n\n    it.runIf(countsCollections)(\n      'counts each element of an array member',\n      async () => {\n        await withCounter(async counter => {\n          const counts = await run(\n            counter.count<ContractWidget>([{ member: 'tags' }]),\n          );\n\n          expect(counts).toEqual({\n            tags: [\n              { value: 'green', count: 3 },\n              { value: 'blue', count: 1 },\n              { value: 'red', count: 1 },\n            ],\n          });\n        });\n      },\n    );\n\n    it('does not count a missing value', async () => {\n      const unnamed = new ContractWidget();\n      unnamed.id = 'w-9';\n      await withCounter(\n        async counter => {\n          const counts = await run(\n            counter.count<ContractWidget>([{ member: 'name' }]),\n          );\n\n          expect(counts).toEqual({ name: [{ value: 'Alpha', count: 1 }] });\n        },\n        [makeContractWidget('w-1', 'Alpha', 10), unnamed],\n      );\n    });\n\n    it.runIf(countsCollections)('does not count an empty array', async () => {\n      await withCounter(\n        async counter => {\n          const counts = await run(\n            counter.count<ContractWidget>([{ member: 'tags' }]),\n          );\n\n          expect(counts).toEqual({ tags: [] });\n        },\n        [makeContractWidget('w-1', 'Alpha', 10)],\n      );\n    });\n\n    it('answers every queried member, empty, from an empty store', async () => {\n      await withCounter(async counter => {\n        expect(\n          await run(\n            counter.count<ContractWidget>([\n              { member: 'name' },\n              { member: 'size' },\n            ]),\n          ),\n        ).toEqual({ name: [], size: [] });\n      }, []);\n    });\n  });\n};\n"],"names":["describe","expect","it","run","ContractWidget","makeContractWidget","seeded","describeEntityFacetCounterContract","name","makeCounter","countsCollections","withCounter","use","seed","counter","counts","count","member","toEqual","value","size","filtering","property","operator","runIf","tags","unnamed","id"],"mappings":"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"}

package/dist/contracts/entity-repository.contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entity-repository.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/entity-repository.contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAY,KAAK,MAAM,EAAU,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAM7E;;;;GAIG;AACH,qBACa,cAAe,YAAW,MAAM;;IAO3C,IACI,EAAE,IAAI,QAAQ,CAEjB;IACD,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,EAErB;IAED,IACI,IAAI,IAAI,MAAM,GAAG,SAAS,CAE7B;IACD,IAAI,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAEjC;IAED,IACI,IAAI,IAAI,MAAM,GAAG,SAAS,CAE7B;IACD,IAAI,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAEjC;IAED,IACI,IAAI,IAAI,SAAS,MAAM,EAAE,CAE5B;IACD,IAAI,IAAI,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAEhC;IAED,IACI,KAAK,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAExD;IACD,IAAI,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,EAE5D;CACF;AAED,eAAO,MAAM,kBAAkB,GAC7B,IAAI,QAAQ,EACZ,MAAM,MAAM,EACZ,MAAM,MAAM,EACZ,OAAM,SAAS,MAAM,EAAO,KAC3B,cAOF,CAAC;AAEF,MAAM,WAAW,+BAA+B;IAC9C;;;OAGG;IACH,cAAc,CACZ,IAAI,EAAE,cAAc,EAAE,GACrB,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACjD;AAED;;;;;GAKG;AACH,eAAO,MAAM,oCAAoC,GAC/C,MAAM,MAAM,EACZ,oBAAoB,+BAA+B,KAClD,IAmOF,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,qCAAqC,GAChD,MAAM,MAAM,EACZ,oBAAoB,+BAA+B,KAClD,IA0FF,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,gCAAgC,GAC3C,MAAM,MAAM,EACZ,SAAS,+BAA+B,KACvC,IAGF,CAAC"}
+{"version":3,"file":"entity-repository.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/entity-repository.contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAY,KAAK,MAAM,EAAU,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAM7E;;;;GAIG;AACH,qBACa,cAAe,YAAW,MAAM;;IAO3C,IACI,EAAE,IAAI,QAAQ,CAEjB;IACD,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,EAErB;IAED,IACI,IAAI,IAAI,MAAM,GAAG,SAAS,CAE7B;IACD,IAAI,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAEjC;IAED,IACI,IAAI,IAAI,MAAM,GAAG,SAAS,CAE7B;IACD,IAAI,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAEjC;IAED,IACI,IAAI,IAAI,SAAS,MAAM,EAAE,CAE5B;IACD,IAAI,IAAI,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAEhC;IAED,IACI,KAAK,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAExD;IACD,IAAI,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,EAE5D;CACF;AAED,eAAO,MAAM,kBAAkB,GAC7B,IAAI,QAAQ,EACZ,MAAM,MAAM,EACZ,MAAM,MAAM,EACZ,OAAM,SAAS,MAAM,EAAO,KAC3B,cAOF,CAAC;AAEF,MAAM,WAAW,+BAA+B;IAC9C;;;OAGG;IACH,cAAc,CACZ,IAAI,EAAE,cAAc,EAAE,GACrB,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACjD;AAED;;;;;GAKG;AACH,eAAO,MAAM,oCAAoC,GAC/C,MAAM,MAAM,EACZ,oBAAoB,+BAA+B,KAClD,IAuQF,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,qCAAqC,GAChD,MAAM,MAAM,EACZ,oBAAoB,+BAA+B,KAClD,IA0FF,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,gCAAgC,GAC3C,MAAM,MAAM,EACZ,SAAS,+BAA+B,KACvC,IAGF,CAAC"}

package/dist/contracts/entity-repository.contract.js

@@ -227,6 +227,49 @@ export const makeContractWidget = (id, name, size, tags = [])=>{
                 ]);
             });
         });
+        it('matches `like` and `nlike` with accents ignored on both sides', async ()=>{
+            await withRepository(async (repository)=>{
+                const like = await run(repository.load({
+                    filtering: [
+                        {
+                            property: 'name',
+                            operator: 'like',
+                            value: 'cafe'
+                        }
+                    ]
+                }));
+                const accented = await run(repository.load({
+                    filtering: [
+                        {
+                            property: 'name',
+                            operator: 'like',
+                            value: 'NIÑO'
+                        }
+                    ]
+                }));
+                const nlike = await run(repository.load({
+                    filtering: [
+                        {
+                            property: 'name',
+                            operator: 'nlike',
+                            value: 'café'
+                        }
+                    ]
+                }));
+                expect(like.items.map((item)=>item.id)).toEqual([
+                    'w-1'
+                ]);
+                expect(accented.items.map((item)=>item.id)).toEqual([
+                    'w-2'
+                ]);
+                expect(nlike.items.map((item)=>item.id)).toEqual([
+                    'w-2'
+                ]);
+            }, [
+                makeContractWidget('w-1', 'Café de Olla', 10),
+                makeContractWidget('w-2', 'nino', 20)
+            ]);
+        });
         it('matches `in` and `nin` against any element of an array member', async ()=>{
             await withRepository(async (repository)=>{
                 const tagged = await run(repository.load({

package/dist/contracts/entity-repository.contract.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/contracts/entity-repository.contract.ts"],"sourcesContent":["import type { EntityRepository } from '@entifix/business';\nimport { accessor, type Entity, entity, type EntityId } from '@entifix/core';\nimport { Exit } from 'effect';\nimport { describe, expect, it } from 'vitest';\n\nimport { run, runExit } from '../effect/run.js';\n\n/**\n * The entity every implementation of the contract is exercised against. It is\n * declared here rather than by each caller so the suite controls exactly which\n * fields exist.\n */\n@entity({ key: 'contract-widget' })\nexport class ContractWidget implements Entity {\n  #id?: EntityId;\n  #name?: string;\n  #size?: number;\n  #tags: readonly string[] = [];\n  #title?: Readonly<Record<string, string>>;\n\n  @accessor({ type: 'id' })\n  get id(): EntityId {\n    return this.#id;\n  }\n  set id(value: EntityId) {\n    this.#id = value;\n  }\n\n  @accessor({ type: 'string' })\n  get name(): string | undefined {\n    return this.#name;\n  }\n  set name(value: string | undefined) {\n    this.#name = value;\n  }\n\n  @accessor({ type: 'number' })\n  get size(): number | undefined {\n    return this.#size;\n  }\n  set size(value: number | undefined) {\n    this.#size = value;\n  }\n\n  @accessor({ type: 'scalarCollection' })\n  get tags(): readonly string[] {\n    return this.#tags;\n  }\n  set tags(value: readonly string[]) {\n    this.#tags = value;\n  }\n\n  @accessor({ type: 'localized' })\n  get title(): Readonly<Record<string, string>> | undefined {\n    return this.#title;\n  }\n  set title(value: Readonly<Record<string, string>> | undefined) {\n    this.#title = value;\n  }\n}\n\nexport const makeContractWidget = (\n  id: EntityId,\n  name: string,\n  size: number,\n  tags: readonly string[] = [],\n): ContractWidget => {\n  const widget = new ContractWidget();\n  widget.id = id;\n  widget.name = name;\n  widget.size = size;\n  widget.tags = tags;\n  return widget;\n};\n\nexport interface EntityRepositoryContractOptions {\n  /**\n   * Builds a repository over `seed`. Called fresh for each test, so no state\n   * leaks between them.\n   */\n  makeRepository(\n    seed: ContractWidget[],\n  ): EntityRepository | Promise<EntityRepository>;\n}\n\n/**\n * The reads every {@link EntityRepository} must answer alike: `load` with its\n * paging, filtering and sorting, and `get`. A read-only adapter — one over\n * static files, say — runs this half alone, since it refuses `save` and\n * `delete` by design.\n */\nexport const describeEntityRepositoryReadContract = (\n  name: string,\n  { makeRepository }: EntityRepositoryContractOptions,\n): void => {\n  describe(`EntityRepository read contract: ${name}`, () => {\n    const seeded = () => [\n      makeContractWidget('w-1', 'Alpha', 10),\n      makeContractWidget('w-2', 'Beta', 20),\n      makeContractWidget('w-3', 'Gamma', 30),\n    ];\n\n    const withRepository = async (\n      use: (repository: EntityRepository) => Promise<void>,\n      seed: ContractWidget[] = seeded(),\n    ) => {\n      await use(await makeRepository(seed));\n    };\n\n    it('keeps a record unchanged when a read instance is mutated without a save', async () => {\n      await withRepository(async repository => {\n        const read = await run(repository.get<ContractWidget>('w-1'));\n        read.name = 'Mutated';\n\n        const again = await run(repository.get<ContractWidget>('w-1'));\n        expect(again.name).toBe('Alpha');\n\n        const page = await run(repository.load<ContractWidget>({}));\n        page.items[0]!.name = 'Mutated';\n        const reloaded = await run(repository.load<ContractWidget>({}));\n        expect(reloaded.items[0]!.name).toBe('Alpha');\n      });\n    });\n\n    it('loads every stored entity with its total', async () => {\n      await withRepository(async repository => {\n        const page = await run(repository.load<ContractWidget>({}));\n\n        expect(page.total).toBe(3);\n        expect(page.items.map(item => item.name)).toEqual([\n          'Alpha',\n          'Beta',\n          'Gamma',\n        ]);\n      });\n    });\n\n    it('echoes the request it served on the page', async () => {\n      await withRepository(async repository => {\n        const request = { page: 1, pageSize: 2 };\n        const page = await run(repository.load<ContractWidget>(request));\n\n        expect(page.request).toEqual(request);\n      });\n    });\n\n    it('pages with a 1-based page number', async () => {\n      await withRepository(async repository => {\n        const page = await run(\n          repository.load<ContractWidget>({ page: 2, pageSize: 2 }),\n        );\n\n        expect(page.items).toHaveLength(1);\n        expect(page.items[0]?.name).toBe('Gamma');\n        // The total counts matches, not the page.\n        expect(page.total).toBe(3);\n      });\n    });\n\n    it('filters by an equality operator', async () => {\n      await withRepository(async repository => {\n        const page = await run(\n          repository.load<ContractWidget>({\n            filtering: [{ property: 'name', operator: 'eq', value: 'Beta' }],\n          }),\n        );\n\n        expect(page.items).toHaveLength(1);\n        expect(page.items[0]?.id).toBe('w-2');\n        expect(page.total).toBe(1);\n      });\n    });\n\n    it('filters by a range operator', async () => {\n      await withRepository(async repository => {\n        const page = await run(\n          repository.load<ContractWidget>({\n            filtering: [\n              { property: 'size', operator: 'between', start: 15, end: 35 },\n            ],\n          }),\n        );\n\n        expect(page.items.map(item => item.id)).toEqual(['w-2', 'w-3']);\n      });\n    });\n\n    it('matches `like` case-insensitively on a substring', async () => {\n      await withRepository(async repository => {\n        const page = await run(\n          repository.load<ContractWidget>({\n            filtering: [{ property: 'name', operator: 'like', value: 'et' }],\n          }),\n        );\n\n        expect(page.items.map(item => item.id)).toEqual(['w-2']);\n      });\n    });\n\n    it('matches `in` and `nin` against any element of an array member', async () => {\n      await withRepository(\n        async repository => {\n          const tagged = await run(\n            repository.load<ContractWidget>({\n              filtering: [\n                { property: 'tags', operator: 'in', values: ['blue', 'red'] },\n              ],\n            }),\n          );\n          expect(tagged.items.map(item => item.id)).toEqual(['w-1', 'w-3']);\n\n          const untagged = await run(\n            repository.load<ContractWidget>({\n              filtering: [\n                { property: 'tags', operator: 'nin', values: ['blue', 'red'] },\n              ],\n            }),\n          );\n          expect(untagged.items.map(item => item.id)).toEqual(['w-2']);\n        },\n        [\n          makeContractWidget('w-1', 'Alpha', 10, ['blue', 'green']),\n          makeContractWidget('w-2', 'Beta', 20, ['green']),\n          makeContractWidget('w-3', 'Gamma', 30, ['red']),\n        ],\n      );\n    });\n\n    it('filters and sorts a localized member one locale at a time', async () => {\n      const titled = (\n        id: string,\n        name: string,\n        title: Record<string, string>,\n      ) => {\n        const widget = makeContractWidget(id, name, 0);\n        widget.title = title;\n        return widget;\n      };\n      await withRepository(\n        async repository => {\n          const found = await run(\n            repository.load<ContractWidget>({\n              filtering: [\n                {\n                  property: 'title.es' as keyof ContractWidget,\n                  operator: 'like',\n                  value: 'SOPA',\n                },\n              ],\n            }),\n          );\n          expect(found.items.map(item => item.id)).toEqual(['w-2']);\n\n          const sorted = await run(\n            repository.load<ContractWidget>({\n              sorting: [\n                {\n                  0: {\n                    property: 'title.en' as keyof ContractWidget,\n                    type: 'asc',\n                  },\n                },\n              ],\n            }),\n          );\n          expect(sorted.items.map(item => item.id)).toEqual([\n            'w-3',\n            'w-1',\n            'w-2',\n          ]);\n          expect(sorted.items[0]?.title).toEqual({\n            en: 'Apple',\n            es: 'Manzana',\n          });\n        },\n        [\n          titled('w-1', 'Alpha', { en: 'Bread', es: 'Pan' }),\n          titled('w-2', 'Beta', { en: 'Soup', es: 'Sopa' }),\n          titled('w-3', 'Gamma', { en: 'Apple', es: 'Manzana' }),\n        ],\n      );\n    });\n\n    it('sorts descending when asked to', async () => {\n      await withRepository(async repository => {\n        const page = await run(\n          repository.load<ContractWidget>({\n            sorting: [{ 0: { property: 'size', type: 'desc' } }],\n          }),\n        );\n\n        expect(page.items.map(item => item.size)).toEqual([30, 20, 10]);\n      });\n    });\n\n    it('reads a single entity by id', async () => {\n      await withRepository(async repository => {\n        const found = await run(repository.get<ContractWidget>('w-2'));\n\n        expect(found.id).toBe('w-2');\n        expect(found.name).toBe('Beta');\n      });\n    });\n\n    it('fails rather than resolving undefined for an unknown id', async () => {\n      await withRepository(async repository => {\n        const exit = await runExit(repository.get<ContractWidget>('missing'));\n\n        expect(Exit.isFailure(exit)).toBe(true);\n      });\n    });\n\n    it('loads an empty page from an empty store', async () => {\n      await withRepository(async repository => {\n        const page = await run(repository.load<ContractWidget>({}));\n\n        expect(page.items).toEqual([]);\n        expect(page.total).toBe(0);\n      }, []);\n    });\n  });\n};\n\n/** The writes every {@link EntityRepository} that accepts them must honour. */\nexport const describeEntityRepositoryWriteContract = (\n  name: string,\n  { makeRepository }: EntityRepositoryContractOptions,\n): void => {\n  describe(`EntityRepository write contract: ${name}`, () => {\n    const seeded = () => [\n      makeContractWidget('w-1', 'Alpha', 10),\n      makeContractWidget('w-2', 'Beta', 20),\n      makeContractWidget('w-3', 'Gamma', 30),\n    ];\n\n    const withRepository = async (\n      use: (repository: EntityRepository) => Promise<void>,\n      seed: ContractWidget[] = seeded(),\n    ) => {\n      await use(await makeRepository(seed));\n    };\n\n    it('keeps a saved record unchanged when the saved instance is mutated afterwards', async () => {\n      await withRepository(async repository => {\n        const widget = makeContractWidget('w-9', 'Delta', 40);\n        const returned = await run(repository.save(widget));\n\n        widget.name = 'Mutated';\n        returned.name = 'Mutated too';\n\n        const stored = await run(repository.get<ContractWidget>('w-9'));\n        expect(stored.name).toBe('Delta');\n      });\n    });\n\n    it('mints an id when saving an entity that has none', async () => {\n      await withRepository(async repository => {\n        const created = await run(\n          repository.save<ContractWidget>(\n            makeContractWidget(undefined, 'Delta', 40),\n          ),\n        );\n\n        expect(created.id).toBeDefined();\n\n        const page = await run(repository.load<ContractWidget>({}));\n        expect(page.total).toBe(4);\n      });\n    });\n\n    it('overwrites in place when saving an entity that already has an id', async () => {\n      await withRepository(async repository => {\n        await run(\n          repository.save<ContractWidget>(\n            makeContractWidget('w-2', 'Renamed', 25),\n          ),\n        );\n\n        const found = await run(repository.get<ContractWidget>('w-2'));\n        expect(found.name).toBe('Renamed');\n\n        const page = await run(repository.load<ContractWidget>({}));\n        expect(page.total).toBe(3);\n      });\n    });\n\n    it('deletes by id', async () => {\n      await withRepository(async repository => {\n        await run(repository.delete<ContractWidget>('w-1'));\n\n        const page = await run(repository.load<ContractWidget>({}));\n        expect(page.items.map(item => item.id)).toEqual(['w-2', 'w-3']);\n      });\n    });\n\n    it('deletes by entity', async () => {\n      await withRepository(async repository => {\n        await run(\n          repository.delete<ContractWidget>(\n            makeContractWidget('w-3', 'Gamma', 30),\n          ),\n        );\n\n        const page = await run(repository.load<ContractWidget>({}));\n        expect(page.items.map(item => item.id)).toEqual(['w-1', 'w-2']);\n      });\n    });\n\n    it('treats deleting an unknown id as a no-op', async () => {\n      await withRepository(async repository => {\n        await run(repository.delete<ContractWidget>('missing'));\n\n        const page = await run(repository.load<ContractWidget>({}));\n        expect(page.total).toBe(3);\n      });\n    });\n  });\n};\n\n/**\n * The behaviour every {@link EntityRepository} must exhibit, regardless of what\n * backs it: both halves.\n *\n * Run it against the in-memory fake *and* against each real adapter. That is\n * what stops a fake from drifting into a more forgiving version of the thing it\n * stands in for — the failure mode where a suite is green and production is\n * not. `entifix-ts-testing-integration` will run this same suite against real\n * infrastructure later.\n */\nexport const describeEntityRepositoryContract = (\n  name: string,\n  options: EntityRepositoryContractOptions,\n): void => {\n  describeEntityRepositoryReadContract(name, options);\n  describeEntityRepositoryWriteContract(name, options);\n};\n"],"names":["accessor","entity","Exit","describe","expect","it","run","runExit","key","type","ContractWidget","id","value","name","size","tags","title","makeContractWidget","widget","describeEntityRepositoryReadContract","makeRepository","seeded","withRepository","use","seed","repository","read","get","again","toBe","page","load","items","reloaded","total","map","item","toEqual","request","pageSize","toHaveLength","filtering","property","operator","start","end","tagged","values","untagged","titled","sorted","found","sorting","en","es","exit","isFailure","describeEntityRepositoryWriteContract","returned","save","stored","created","undefined","toBeDefined","delete","describeEntityRepositoryContract","options"],"mappings":"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"}
+{"version":3,"sources":["../../src/contracts/entity-repository.contract.ts"],"sourcesContent":["import type { EntityRepository } from '@entifix/business';\nimport { accessor, type Entity, entity, type EntityId } from '@entifix/core';\nimport { Exit } from 'effect';\nimport { describe, expect, it } from 'vitest';\n\nimport { run, runExit } from '../effect/run.js';\n\n/**\n * The entity every implementation of the contract is exercised against. It is\n * declared here rather than by each caller so the suite controls exactly which\n * fields exist.\n */\n@entity({ key: 'contract-widget' })\nexport class ContractWidget implements Entity {\n  #id?: EntityId;\n  #name?: string;\n  #size?: number;\n  #tags: readonly string[] = [];\n  #title?: Readonly<Record<string, string>>;\n\n  @accessor({ type: 'id' })\n  get id(): EntityId {\n    return this.#id;\n  }\n  set id(value: EntityId) {\n    this.#id = value;\n  }\n\n  @accessor({ type: 'string' })\n  get name(): string | undefined {\n    return this.#name;\n  }\n  set name(value: string | undefined) {\n    this.#name = value;\n  }\n\n  @accessor({ type: 'number' })\n  get size(): number | undefined {\n    return this.#size;\n  }\n  set size(value: number | undefined) {\n    this.#size = value;\n  }\n\n  @accessor({ type: 'scalarCollection' })\n  get tags(): readonly string[] {\n    return this.#tags;\n  }\n  set tags(value: readonly string[]) {\n    this.#tags = value;\n  }\n\n  @accessor({ type: 'localized' })\n  get title(): Readonly<Record<string, string>> | undefined {\n    return this.#title;\n  }\n  set title(value: Readonly<Record<string, string>> | undefined) {\n    this.#title = value;\n  }\n}\n\nexport const makeContractWidget = (\n  id: EntityId,\n  name: string,\n  size: number,\n  tags: readonly string[] = [],\n): ContractWidget => {\n  const widget = new ContractWidget();\n  widget.id = id;\n  widget.name = name;\n  widget.size = size;\n  widget.tags = tags;\n  return widget;\n};\n\nexport interface EntityRepositoryContractOptions {\n  /**\n   * Builds a repository over `seed`. Called fresh for each test, so no state\n   * leaks between them.\n   */\n  makeRepository(\n    seed: ContractWidget[],\n  ): EntityRepository | Promise<EntityRepository>;\n}\n\n/**\n * The reads every {@link EntityRepository} must answer alike: `load` with its\n * paging, filtering and sorting, and `get`. A read-only adapter — one over\n * static files, say — runs this half alone, since it refuses `save` and\n * `delete` by design.\n */\nexport const describeEntityRepositoryReadContract = (\n  name: string,\n  { makeRepository }: EntityRepositoryContractOptions,\n): void => {\n  describe(`EntityRepository read contract: ${name}`, () => {\n    const seeded = () => [\n      makeContractWidget('w-1', 'Alpha', 10),\n      makeContractWidget('w-2', 'Beta', 20),\n      makeContractWidget('w-3', 'Gamma', 30),\n    ];\n\n    const withRepository = async (\n      use: (repository: EntityRepository) => Promise<void>,\n      seed: ContractWidget[] = seeded(),\n    ) => {\n      await use(await makeRepository(seed));\n    };\n\n    it('keeps a record unchanged when a read instance is mutated without a save', async () => {\n      await withRepository(async repository => {\n        const read = await run(repository.get<ContractWidget>('w-1'));\n        read.name = 'Mutated';\n\n        const again = await run(repository.get<ContractWidget>('w-1'));\n        expect(again.name).toBe('Alpha');\n\n        const page = await run(repository.load<ContractWidget>({}));\n        page.items[0]!.name = 'Mutated';\n        const reloaded = await run(repository.load<ContractWidget>({}));\n        expect(reloaded.items[0]!.name).toBe('Alpha');\n      });\n    });\n\n    it('loads every stored entity with its total', async () => {\n      await withRepository(async repository => {\n        const page = await run(repository.load<ContractWidget>({}));\n\n        expect(page.total).toBe(3);\n        expect(page.items.map(item => item.name)).toEqual([\n          'Alpha',\n          'Beta',\n          'Gamma',\n        ]);\n      });\n    });\n\n    it('echoes the request it served on the page', async () => {\n      await withRepository(async repository => {\n        const request = { page: 1, pageSize: 2 };\n        const page = await run(repository.load<ContractWidget>(request));\n\n        expect(page.request).toEqual(request);\n      });\n    });\n\n    it('pages with a 1-based page number', async () => {\n      await withRepository(async repository => {\n        const page = await run(\n          repository.load<ContractWidget>({ page: 2, pageSize: 2 }),\n        );\n\n        expect(page.items).toHaveLength(1);\n        expect(page.items[0]?.name).toBe('Gamma');\n        // The total counts matches, not the page.\n        expect(page.total).toBe(3);\n      });\n    });\n\n    it('filters by an equality operator', async () => {\n      await withRepository(async repository => {\n        const page = await run(\n          repository.load<ContractWidget>({\n            filtering: [{ property: 'name', operator: 'eq', value: 'Beta' }],\n          }),\n        );\n\n        expect(page.items).toHaveLength(1);\n        expect(page.items[0]?.id).toBe('w-2');\n        expect(page.total).toBe(1);\n      });\n    });\n\n    it('filters by a range operator', async () => {\n      await withRepository(async repository => {\n        const page = await run(\n          repository.load<ContractWidget>({\n            filtering: [\n              { property: 'size', operator: 'between', start: 15, end: 35 },\n            ],\n          }),\n        );\n\n        expect(page.items.map(item => item.id)).toEqual(['w-2', 'w-3']);\n      });\n    });\n\n    it('matches `like` case-insensitively on a substring', async () => {\n      await withRepository(async repository => {\n        const page = await run(\n          repository.load<ContractWidget>({\n            filtering: [{ property: 'name', operator: 'like', value: 'et' }],\n          }),\n        );\n\n        expect(page.items.map(item => item.id)).toEqual(['w-2']);\n      });\n    });\n\n    it('matches `like` and `nlike` with accents ignored on both sides', async () => {\n      await withRepository(\n        async repository => {\n          const like = await run(\n            repository.load<ContractWidget>({\n              filtering: [\n                { property: 'name', operator: 'like', value: 'cafe' },\n              ],\n            }),\n          );\n          const accented = await run(\n            repository.load<ContractWidget>({\n              filtering: [\n                { property: 'name', operator: 'like', value: 'NIÑO' },\n              ],\n            }),\n          );\n          const nlike = await run(\n            repository.load<ContractWidget>({\n              filtering: [\n                { property: 'name', operator: 'nlike', value: 'café' },\n              ],\n            }),\n          );\n\n          expect(like.items.map(item => item.id)).toEqual(['w-1']);\n          expect(accented.items.map(item => item.id)).toEqual(['w-2']);\n          expect(nlike.items.map(item => item.id)).toEqual(['w-2']);\n        },\n        [\n          makeContractWidget('w-1', 'Café de Olla', 10),\n          makeContractWidget('w-2', 'nino', 20),\n        ],\n      );\n    });\n\n    it('matches `in` and `nin` against any element of an array member', async () => {\n      await withRepository(\n        async repository => {\n          const tagged = await run(\n            repository.load<ContractWidget>({\n              filtering: [\n                { property: 'tags', operator: 'in', values: ['blue', 'red'] },\n              ],\n            }),\n          );\n          expect(tagged.items.map(item => item.id)).toEqual(['w-1', 'w-3']);\n\n          const untagged = await run(\n            repository.load<ContractWidget>({\n              filtering: [\n                { property: 'tags', operator: 'nin', values: ['blue', 'red'] },\n              ],\n            }),\n          );\n          expect(untagged.items.map(item => item.id)).toEqual(['w-2']);\n        },\n        [\n          makeContractWidget('w-1', 'Alpha', 10, ['blue', 'green']),\n          makeContractWidget('w-2', 'Beta', 20, ['green']),\n          makeContractWidget('w-3', 'Gamma', 30, ['red']),\n        ],\n      );\n    });\n\n    it('filters and sorts a localized member one locale at a time', async () => {\n      const titled = (\n        id: string,\n        name: string,\n        title: Record<string, string>,\n      ) => {\n        const widget = makeContractWidget(id, name, 0);\n        widget.title = title;\n        return widget;\n      };\n      await withRepository(\n        async repository => {\n          const found = await run(\n            repository.load<ContractWidget>({\n              filtering: [\n                {\n                  property: 'title.es' as keyof ContractWidget,\n                  operator: 'like',\n                  value: 'SOPA',\n                },\n              ],\n            }),\n          );\n          expect(found.items.map(item => item.id)).toEqual(['w-2']);\n\n          const sorted = await run(\n            repository.load<ContractWidget>({\n              sorting: [\n                {\n                  0: {\n                    property: 'title.en' as keyof ContractWidget,\n                    type: 'asc',\n                  },\n                },\n              ],\n            }),\n          );\n          expect(sorted.items.map(item => item.id)).toEqual([\n            'w-3',\n            'w-1',\n            'w-2',\n          ]);\n          expect(sorted.items[0]?.title).toEqual({\n            en: 'Apple',\n            es: 'Manzana',\n          });\n        },\n        [\n          titled('w-1', 'Alpha', { en: 'Bread', es: 'Pan' }),\n          titled('w-2', 'Beta', { en: 'Soup', es: 'Sopa' }),\n          titled('w-3', 'Gamma', { en: 'Apple', es: 'Manzana' }),\n        ],\n      );\n    });\n\n    it('sorts descending when asked to', async () => {\n      await withRepository(async repository => {\n        const page = await run(\n          repository.load<ContractWidget>({\n            sorting: [{ 0: { property: 'size', type: 'desc' } }],\n          }),\n        );\n\n        expect(page.items.map(item => item.size)).toEqual([30, 20, 10]);\n      });\n    });\n\n    it('reads a single entity by id', async () => {\n      await withRepository(async repository => {\n        const found = await run(repository.get<ContractWidget>('w-2'));\n\n        expect(found.id).toBe('w-2');\n        expect(found.name).toBe('Beta');\n      });\n    });\n\n    it('fails rather than resolving undefined for an unknown id', async () => {\n      await withRepository(async repository => {\n        const exit = await runExit(repository.get<ContractWidget>('missing'));\n\n        expect(Exit.isFailure(exit)).toBe(true);\n      });\n    });\n\n    it('loads an empty page from an empty store', async () => {\n      await withRepository(async repository => {\n        const page = await run(repository.load<ContractWidget>({}));\n\n        expect(page.items).toEqual([]);\n        expect(page.total).toBe(0);\n      }, []);\n    });\n  });\n};\n\n/** The writes every {@link EntityRepository} that accepts them must honour. */\nexport const describeEntityRepositoryWriteContract = (\n  name: string,\n  { makeRepository }: EntityRepositoryContractOptions,\n): void => {\n  describe(`EntityRepository write contract: ${name}`, () => {\n    const seeded = () => [\n      makeContractWidget('w-1', 'Alpha', 10),\n      makeContractWidget('w-2', 'Beta', 20),\n      makeContractWidget('w-3', 'Gamma', 30),\n    ];\n\n    const withRepository = async (\n      use: (repository: EntityRepository) => Promise<void>,\n      seed: ContractWidget[] = seeded(),\n    ) => {\n      await use(await makeRepository(seed));\n    };\n\n    it('keeps a saved record unchanged when the saved instance is mutated afterwards', async () => {\n      await withRepository(async repository => {\n        const widget = makeContractWidget('w-9', 'Delta', 40);\n        const returned = await run(repository.save(widget));\n\n        widget.name = 'Mutated';\n        returned.name = 'Mutated too';\n\n        const stored = await run(repository.get<ContractWidget>('w-9'));\n        expect(stored.name).toBe('Delta');\n      });\n    });\n\n    it('mints an id when saving an entity that has none', async () => {\n      await withRepository(async repository => {\n        const created = await run(\n          repository.save<ContractWidget>(\n            makeContractWidget(undefined, 'Delta', 40),\n          ),\n        );\n\n        expect(created.id).toBeDefined();\n\n        const page = await run(repository.load<ContractWidget>({}));\n        expect(page.total).toBe(4);\n      });\n    });\n\n    it('overwrites in place when saving an entity that already has an id', async () => {\n      await withRepository(async repository => {\n        await run(\n          repository.save<ContractWidget>(\n            makeContractWidget('w-2', 'Renamed', 25),\n          ),\n        );\n\n        const found = await run(repository.get<ContractWidget>('w-2'));\n        expect(found.name).toBe('Renamed');\n\n        const page = await run(repository.load<ContractWidget>({}));\n        expect(page.total).toBe(3);\n      });\n    });\n\n    it('deletes by id', async () => {\n      await withRepository(async repository => {\n        await run(repository.delete<ContractWidget>('w-1'));\n\n        const page = await run(repository.load<ContractWidget>({}));\n        expect(page.items.map(item => item.id)).toEqual(['w-2', 'w-3']);\n      });\n    });\n\n    it('deletes by entity', async () => {\n      await withRepository(async repository => {\n        await run(\n          repository.delete<ContractWidget>(\n            makeContractWidget('w-3', 'Gamma', 30),\n          ),\n        );\n\n        const page = await run(repository.load<ContractWidget>({}));\n        expect(page.items.map(item => item.id)).toEqual(['w-1', 'w-2']);\n      });\n    });\n\n    it('treats deleting an unknown id as a no-op', async () => {\n      await withRepository(async repository => {\n        await run(repository.delete<ContractWidget>('missing'));\n\n        const page = await run(repository.load<ContractWidget>({}));\n        expect(page.total).toBe(3);\n      });\n    });\n  });\n};\n\n/**\n * The behaviour every {@link EntityRepository} must exhibit, regardless of what\n * backs it: both halves.\n *\n * Run it against the in-memory fake *and* against each real adapter. That is\n * what stops a fake from drifting into a more forgiving version of the thing it\n * stands in for — the failure mode where a suite is green and production is\n * not. `entifix-ts-testing-integration` will run this same suite against real\n * infrastructure later.\n */\nexport const describeEntityRepositoryContract = (\n  name: string,\n  options: EntityRepositoryContractOptions,\n): void => {\n  describeEntityRepositoryReadContract(name, options);\n  describeEntityRepositoryWriteContract(name, options);\n};\n"],"names":["accessor","entity","Exit","describe","expect","it","run","runExit","key","type","ContractWidget","id","value","name","size","tags","title","makeContractWidget","widget","describeEntityRepositoryReadContract","makeRepository","seeded","withRepository","use","seed","repository","read","get","again","toBe","page","load","items","reloaded","total","map","item","toEqual","request","pageSize","toHaveLength","filtering","property","operator","start","end","like","accented","nlike","tagged","values","untagged","titled","sorted","found","sorting","en","es","exit","isFailure","describeEntityRepositoryWriteContract","returned","save","stored","created","undefined","toBeDefined","delete","describeEntityRepositoryContract","options"],"mappings":"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"}

package/dist/contracts/failure.contract.d.ts

@@ -0,0 +1,13 @@
+import { type EntifixFailure } from '@entifix/core';
+/**
+ * What every failure must be, wherever it is defined
+ * ([ADR 0013](../../../../../docs/adr/0013-failures-are-typed-values-decided-at-the-shell.md)):
+ * registered under its code, categorised, and able to cross a wire and come
+ * back as itself — without carrying a stack or a stringified error with it.
+ *
+ * Run it once per failure a package defines, with a sample built the way the
+ * package builds it. A failure that cannot round-trip decodes in a client as a
+ * `ProtocolFailure`, which is a refusal the user is never told the reason for.
+ */
+export declare const describeFailureContract: (name: string, sample: EntifixFailure) => void;
+//# sourceMappingURL=failure.contract.d.ts.map

package/dist/contracts/failure.contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/failure.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EAKpB,MAAM,eAAe,CAAC;AAGvB;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,GAClC,MAAM,MAAM,EACZ,QAAQ,cAAc,KACrB,IA4BF,CAAC"}

package/dist/contracts/failure.contract.js

@@ -0,0 +1,38 @@
+import { decodeProblem, FAILURE_CATEGORIES, familyOf, lookupFailure, problemOf } from '@entifix/core';
+import { describe, expect, it } from 'vitest';
+/**
+ * What every failure must be, wherever it is defined
+ * ([ADR 0013](../../../../../docs/adr/0013-failures-are-typed-values-decided-at-the-shell.md)):
+ * registered under its code, categorised, and able to cross a wire and come
+ * back as itself — without carrying a stack or a stringified error with it.
+ *
+ * Run it once per failure a package defines, with a sample built the way the
+ * package builds it. A failure that cannot round-trip decodes in a client as a
+ * `ProtocolFailure`, which is a refusal the user is never told the reason for.
+ */ export const describeFailureContract = (name, sample)=>{
+    describe(`failure contract: ${name}`, ()=>{
+        it('is registered under its code, by its own tag', ()=>{
+            var _lookupFailure;
+            expect((_lookupFailure = lookupFailure(sample.code)) == null ? void 0 : _lookupFailure.tag).toBe(sample._tag);
+        });
+        it('belongs to one of the closed categories, and its family follows', ()=>{
+            expect(FAILURE_CATEGORIES).toContain(sample.category);
+            expect(sample.family).toBe(familyOf(sample.category));
+        });
+        it('decodes from its problem body back to itself, fields and all', ()=>{
+            const body = problemOf(sample);
+            const decoded = decodeProblem(JSON.parse(JSON.stringify(body)));
+            expect(decoded._tag).toBe(sample._tag);
+            expect(problemOf(decoded)).toEqual(body);
+        });
+        it('carries no stack and no stringified error onto the wire', ()=>{
+            const body = problemOf(sample);
+            const text = JSON.stringify(body);
+            expect(body).not.toHaveProperty('stack');
+            expect(text).not.toContain('[object');
+            expect(text).not.toMatch(/\n\s+at /);
+        });
+    });
+};
+
+//# sourceMappingURL=failure.contract.js.map

package/dist/contracts/failure.contract.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/contracts/failure.contract.ts"],"sourcesContent":["import {\n  decodeProblem,\n  type EntifixFailure,\n  FAILURE_CATEGORIES,\n  familyOf,\n  lookupFailure,\n  problemOf,\n} from '@entifix/core';\nimport { describe, expect, it } from 'vitest';\n\n/**\n * What every failure must be, wherever it is defined\n * ([ADR 0013](../../../../../docs/adr/0013-failures-are-typed-values-decided-at-the-shell.md)):\n * registered under its code, categorised, and able to cross a wire and come\n * back as itself — without carrying a stack or a stringified error with it.\n *\n * Run it once per failure a package defines, with a sample built the way the\n * package builds it. A failure that cannot round-trip decodes in a client as a\n * `ProtocolFailure`, which is a refusal the user is never told the reason for.\n */\nexport const describeFailureContract = (\n  name: string,\n  sample: EntifixFailure,\n): void => {\n  describe(`failure contract: ${name}`, () => {\n    it('is registered under its code, by its own tag', () => {\n      expect(lookupFailure(sample.code)?.tag).toBe(sample._tag);\n    });\n\n    it('belongs to one of the closed categories, and its family follows', () => {\n      expect(FAILURE_CATEGORIES).toContain(sample.category);\n      expect(sample.family).toBe(familyOf(sample.category));\n    });\n\n    it('decodes from its problem body back to itself, fields and all', () => {\n      const body = problemOf(sample);\n      const decoded = decodeProblem(JSON.parse(JSON.stringify(body)));\n\n      expect(decoded._tag).toBe(sample._tag);\n      expect(problemOf(decoded)).toEqual(body);\n    });\n\n    it('carries no stack and no stringified error onto the wire', () => {\n      const body = problemOf(sample);\n      const text = JSON.stringify(body);\n\n      expect(body).not.toHaveProperty('stack');\n      expect(text).not.toContain('[object');\n      expect(text).not.toMatch(/\\n\\s+at /);\n    });\n  });\n};\n"],"names":["decodeProblem","FAILURE_CATEGORIES","familyOf","lookupFailure","problemOf","describe","expect","it","describeFailureContract","name","sample","code","tag","toBe","_tag","toContain","category","family","body","decoded","JSON","parse","stringify","toEqual","text","not","toHaveProperty","toMatch"],"mappings":"AAAA,SACEA,aAAa,EAEbC,kBAAkB,EAClBC,QAAQ,EACRC,aAAa,EACbC,SAAS,QACJ,gBAAgB;AACvB,SAASC,QAAQ,EAAEC,MAAM,EAAEC,EAAE,QAAQ,SAAS;AAE9C;;;;;;;;;CASC,GACD,OAAO,MAAMC,0BAA0B,CACrCC,MACAC;IAEAL,SAAS,CAAC,kBAAkB,EAAEI,MAAM,EAAE;QACpCF,GAAG,gDAAgD;gBAC1CJ;YAAPG,QAAOH,iBAAAA,cAAcO,OAAOC,IAAI,sBAAzBR,eAA4BS,GAAG,EAAEC,IAAI,CAACH,OAAOI,IAAI;QAC1D;QAEAP,GAAG,mEAAmE;YACpED,OAAOL,oBAAoBc,SAAS,CAACL,OAAOM,QAAQ;YACpDV,OAAOI,OAAOO,MAAM,EAAEJ,IAAI,CAACX,SAASQ,OAAOM,QAAQ;QACrD;QAEAT,GAAG,gEAAgE;YACjE,MAAMW,OAAOd,UAAUM;YACvB,MAAMS,UAAUnB,cAAcoB,KAAKC,KAAK,CAACD,KAAKE,SAAS,CAACJ;YAExDZ,OAAOa,QAAQL,IAAI,EAAED,IAAI,CAACH,OAAOI,IAAI;YACrCR,OAAOF,UAAUe,UAAUI,OAAO,CAACL;QACrC;QAEAX,GAAG,2DAA2D;YAC5D,MAAMW,OAAOd,UAAUM;YACvB,MAAMc,OAAOJ,KAAKE,SAAS,CAACJ;YAE5BZ,OAAOY,MAAMO,GAAG,CAACC,cAAc,CAAC;YAChCpB,OAAOkB,MAAMC,GAAG,CAACV,SAAS,CAAC;YAC3BT,OAAOkB,MAAMC,GAAG,CAACE,OAAO,CAAC;QAC3B;IACF;AACF,EAAE"}

package/dist/contracts/index.d.ts

@@ -1,4 +1,6 @@
+export * from './entity-facet-counter.contract.js';
 export * from './entity-repository.contract.js';
+export * from './failure.contract.js';
 export * from './saga-store.contract.js';
 export * from './transaction-ports.contract.js';
 export * from './unit-of-work.contract.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC;AAChD,cAAc,0BAA0B,CAAC;AACzC,cAAc,iCAAiC,CAAC;AAChD,cAAc,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAAA,cAAc,oCAAoC,CAAC;AACnD,cAAc,iCAAiC,CAAC;AAChD,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iCAAiC,CAAC;AAChD,cAAc,4BAA4B,CAAC"}

package/dist/contracts/index.js

@@ -1,4 +1,6 @@
+export * from './entity-facet-counter.contract.js';
 export * from './entity-repository.contract.js';
+export * from './failure.contract.js';
 export * from './saga-store.contract.js';
 export * from './transaction-ports.contract.js';
 export * from './unit-of-work.contract.js';

package/dist/contracts/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/contracts/index.ts"],"sourcesContent":["export * from './entity-repository.contract.js';\nexport * from './saga-store.contract.js';\nexport * from './transaction-ports.contract.js';\nexport * from './unit-of-work.contract.js';\n"],"names":[],"mappings":"AAAA,cAAc,kCAAkC;AAChD,cAAc,2BAA2B;AACzC,cAAc,kCAAkC;AAChD,cAAc,6BAA6B"}
+{"version":3,"sources":["../../src/contracts/index.ts"],"sourcesContent":["export * from './entity-facet-counter.contract.js';\nexport * from './entity-repository.contract.js';\nexport * from './failure.contract.js';\nexport * from './saga-store.contract.js';\nexport * from './transaction-ports.contract.js';\nexport * from './unit-of-work.contract.js';\n"],"names":[],"mappings":"AAAA,cAAc,qCAAqC;AACnD,cAAc,kCAAkC;AAChD,cAAc,wBAAwB;AACtC,cAAc,2BAA2B;AACzC,cAAc,kCAAkC;AAChD,cAAc,6BAA6B"}

package/dist/contracts/unit-of-work.contract.d.ts

@@ -1,13 +1,13 @@
-import { EntifixConnError } from '@entifix/core';
+import { type StoreFault } from '@entifix/core';
 import type { UnitOfWork } from '@entifix/transactions';
 import { Effect } from 'effect';
 /** What {@link describeUnitOfWorkContract} needs to observe a store. */
 export interface UnitOfWorkContractHarness<H> {
     readonly unitOfWork: UnitOfWork<H>;
     /** Writes one record through the unit's handle. */
-    write(handle: H, id: string): Effect.Effect<void, EntifixConnError>;
+    write(handle: H, id: string): Effect.Effect<void, StoreFault>;
     /** Whether a record exists, read through the unit's handle. */
-    readIn(handle: H, id: string): Effect.Effect<boolean, EntifixConnError>;
+    readIn(handle: H, id: string): Effect.Effect<boolean, StoreFault>;
     /** Whether a record is durable, read outside any unit. */
     stored(id: string): Promise<boolean>;
     /** The ids of every event the outbox holds. */

package/dist/contracts/unit-of-work.contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unit-of-work.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/unit-of-work.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAU,MAAM,QAAQ,CAAC;AAGxC,wEAAwE;AACxE,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC1C,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACnC,mDAAmD;IACnD,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;IACpE,+DAA+D;IAC/D,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;IACxE,0DAA0D;IAC1D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,+CAA+C;IAC/C,QAAQ,IAAI,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;CACxC;AAaD;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,GAAI,CAAC,EAC1C,MAAM,MAAM,EACZ,aAAa,MACX,yBAAyB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC,KACrE,IA6MF,CAAC"}
+{"version":3,"file":"unit-of-work.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/unit-of-work.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,UAAU,EAAe,MAAM,eAAe,CAAC;AAC/E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAU,MAAM,QAAQ,CAAC;AAGxC,wEAAwE;AACxE,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC1C,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACnC,mDAAmD;IACnD,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC9D,+DAA+D;IAC/D,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAClE,0DAA0D;IAC1D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,+CAA+C;IAC/C,QAAQ,IAAI,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;CACxC;AAaD;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,GAAI,CAAC,EAC1C,MAAM,MAAM,EACZ,aAAa,MACX,yBAAyB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC,KACrE,IA6MF,CAAC"}

package/dist/contracts/unit-of-work.contract.js

@@ -1,4 +1,4 @@
-import { EntifixConnError } from '@entifix/core';
+import { Unavailable } from '@entifix/core';
 import { Effect, Option } from 'effect';
 import { describe, expect, it } from 'vitest';
 const anEvent = (id)=>({
@@ -40,8 +40,12 @@ const run = (effect)=>Effect.runPromise(effect);
         });
         it('surfaces a store failure as an error, and writes nothing', async ()=>{
             const harness = await makeHarness();
-            const error = await run(harness.unitOfWork.run((unit)=>harness.write(unit.handle, 'w-3').pipe(Effect.andThen(Effect.fail(new EntifixConnError('store went away'))))).pipe(Effect.flip));
-            expect(error).toBeInstanceOf(EntifixConnError);
+            const error = await run(harness.unitOfWork.run((unit)=>harness.write(unit.handle, 'w-3').pipe(Effect.andThen(Effect.fail(new Unavailable({
+                    dependency: 'store'
+                }))))).pipe(Effect.flip));
+            expect(error).toMatchObject({
+                _tag: 'Unavailable'
+            });
             expect(await harness.stored('w-3')).toBe(false);
         });
         it('lets a unit read its own uncommitted writes', async ()=>{