@entifix/business 0.1.2 → 0.1.4

package/README.md

@@ -12,9 +12,9 @@ pnpm add @entifix/business effect
 
 ## Entry points
 
-| Import              | What it holds                                                                                                                    |
-| ------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
-| `@entifix/business` | Port tags, `getUCFactory` / `loadUCFactory` / `saveUCFactory` / `deleteUCFactory`, `HealthRegistryLayer`, `makeShutdownRegistry` |
+| Import              | What it holds                                                                                                                                                                                                                                             |
+| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `@entifix/business` | Port tags, `getUCFactory` / `loadUCFactory` / `saveUCFactory` / `deleteUCFactory`, `loadAllUCFactory` (every record a request keeps, page by page), `resolveLinksUCFactory` (chosen links of many records), `HealthRegistryLayer`, `makeShutdownRegistry` |
 
 ---
 

package/dist/use-case/load/index.d.ts

@@ -1,2 +1,4 @@
 export * from './load.uc.js';
+export * from './load-all.uc.js';
+export * from './resolve-links.uc.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/use-case/load/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/use-case/load/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/use-case/load/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC"}

package/dist/use-case/load/index.js

@@ -1,3 +1,5 @@
 export * from './load.uc.js';
+export * from './load-all.uc.js';
+export * from './resolve-links.uc.js';
 
 //# sourceMappingURL=index.js.map

package/dist/use-case/load/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/use-case/load/index.ts"],"sourcesContent":["export * from './load.uc.js';\n"],"names":[],"mappings":"AAAA,cAAc,eAAe"}
+{"version":3,"sources":["../../../src/use-case/load/index.ts"],"sourcesContent":["export * from './load.uc.js';\nexport * from './load-all.uc.js';\nexport * from './resolve-links.uc.js';\n"],"names":[],"mappings":"AAAA,cAAc,eAAe;AAC7B,cAAc,mBAAmB;AACjC,cAAc,wBAAwB"}

package/dist/use-case/load/load-all.uc.d.ts

@@ -0,0 +1,19 @@
+import { Entity, EntityLoadRequest } from '@entifix/core';
+import { Effect } from 'effect';
+import { EntityRepositoryTag } from '../../repository/entity.repository.js';
+import { EntityLoadRequestTag } from '../../repository/entity-mixins.repository.js';
+/** A request for every record it keeps: paging is the use case's to set. */
+export type UnpagedRequest<TEntity extends Entity> = Omit<EntityLoadRequest<TEntity>, 'page' | 'pageSize'>;
+/** How many records `loadAllUCFactory` asks the repository for at a time. */
+export declare const LOAD_ALL_PAGE_SIZE = 100;
+/**
+ * Every record the request in `EntityLoadRequestTag` keeps, filtered and
+ * sorted as it asks, read page by page until the repository's `total` is
+ * reached.
+ *
+ * The request's own `page` and `pageSize` are ignored: asking for one page
+ * as large as can be counted works against an in-memory source, but a real
+ * adapter would hand that size to its database.
+ */
+export declare function loadAllUCFactory<TEntity extends Entity>(pageSize?: number): Effect.Effect<TEntity[], import("@entifix/core").EntifixError, import("../../index.js").ConfigurationRepositoryTag | EntityRepositoryTag | EntityLoadRequestTag>;
+//# sourceMappingURL=load-all.uc.d.ts.map

package/dist/use-case/load/load-all.uc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-all.uc.d.ts","sourceRoot":"","sources":["../../../src/use-case/load/load-all.uc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AAEpF,4EAA4E;AAC5E,MAAM,MAAM,cAAc,CAAC,OAAO,SAAS,MAAM,IAAI,IAAI,CACvD,iBAAiB,CAAC,OAAO,CAAC,EAC1B,MAAM,GAAG,UAAU,CACpB,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,SAAS,MAAM,EACrD,QAAQ,GAAE,MAA2B,oKAuBtC"}

package/dist/use-case/load/load-all.uc.js

@@ -0,0 +1,35 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { Effect } from 'effect';
+import { EntityRepositoryTag } from '../../repository/entity.repository.js';
+import { EntityLoadRequestTag } from '../../repository/entity-mixins.repository.js';
+/** How many records `loadAllUCFactory` asks the repository for at a time. */ export const LOAD_ALL_PAGE_SIZE = 100;
+/**
+ * Every record the request in `EntityLoadRequestTag` keeps, filtered and
+ * sorted as it asks, read page by page until the repository's `total` is
+ * reached.
+ *
+ * The request's own `page` and `pageSize` are ignored: asking for one page
+ * as large as can be counted works against an in-memory source, but a real
+ * adapter would hand that size to its database.
+ */ export function loadAllUCFactory(pageSize = LOAD_ALL_PAGE_SIZE) {
+    return Effect.gen(function*() {
+        const entityRepository = yield* EntityRepositoryTag;
+        const entityLoadRequest = yield* EntityLoadRequestTag;
+        // EntityLoadRequestTag carries no generic type, as in `loadUCFactory`.
+        const request = entityLoadRequest;
+        const items = [];
+        for(let page = 1;; page += 1){
+            const result = yield* entityRepository.load(_extends({}, request, {
+                page,
+                pageSize
+            }));
+            items.push(...result.items);
+            // An empty page ends the read too, should `total` overstate it.
+            if (result.items.length === 0 || items.length >= result.total) {
+                return items;
+            }
+        }
+    });
+}
+
+//# sourceMappingURL=load-all.uc.js.map

package/dist/use-case/load/load-all.uc.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/use-case/load/load-all.uc.ts"],"sourcesContent":["import { Entity, EntityLoadRequest } from '@entifix/core';\nimport { Effect } from 'effect';\n\nimport { EntityRepositoryTag } from '../../repository/entity.repository.js';\nimport { EntityLoadRequestTag } from '../../repository/entity-mixins.repository.js';\n\n/** A request for every record it keeps: paging is the use case's to set. */\nexport type UnpagedRequest<TEntity extends Entity> = Omit<\n  EntityLoadRequest<TEntity>,\n  'page' | 'pageSize'\n>;\n\n/** How many records `loadAllUCFactory` asks the repository for at a time. */\nexport const LOAD_ALL_PAGE_SIZE = 100;\n\n/**\n * Every record the request in `EntityLoadRequestTag` keeps, filtered and\n * sorted as it asks, read page by page until the repository's `total` is\n * reached.\n *\n * The request's own `page` and `pageSize` are ignored: asking for one page\n * as large as can be counted works against an in-memory source, but a real\n * adapter would hand that size to its database.\n */\nexport function loadAllUCFactory<TEntity extends Entity>(\n  pageSize: number = LOAD_ALL_PAGE_SIZE,\n) {\n  return Effect.gen(function* () {\n    const entityRepository = yield* EntityRepositoryTag;\n    const entityLoadRequest = yield* EntityLoadRequestTag;\n\n    // EntityLoadRequestTag carries no generic type, as in `loadUCFactory`.\n    const request = entityLoadRequest as unknown as EntityLoadRequest<TEntity>;\n\n    const items: TEntity[] = [];\n    for (let page = 1; ; page += 1) {\n      const result = yield* entityRepository.load<TEntity>({\n        ...request,\n        page,\n        pageSize,\n      });\n      items.push(...result.items);\n      // An empty page ends the read too, should `total` overstate it.\n      if (result.items.length === 0 || items.length >= result.total) {\n        return items;\n      }\n    }\n  });\n}\n"],"names":["Effect","EntityRepositoryTag","EntityLoadRequestTag","LOAD_ALL_PAGE_SIZE","loadAllUCFactory","pageSize","gen","entityRepository","entityLoadRequest","request","items","page","result","load","push","length","total"],"mappings":";AACA,SAASA,MAAM,QAAQ,SAAS;AAEhC,SAASC,mBAAmB,QAAQ,wCAAwC;AAC5E,SAASC,oBAAoB,QAAQ,+CAA+C;AAQpF,2EAA2E,GAC3E,OAAO,MAAMC,qBAAqB,IAAI;AAEtC;;;;;;;;CAQC,GACD,OAAO,SAASC,iBACdC,WAAmBF,kBAAkB;IAErC,OAAOH,OAAOM,GAAG,CAAC;QAChB,MAAMC,mBAAmB,OAAON;QAChC,MAAMO,oBAAoB,OAAON;QAEjC,uEAAuE;QACvE,MAAMO,UAAUD;QAEhB,MAAME,QAAmB,EAAE;QAC3B,IAAK,IAAIC,OAAO,IAAKA,QAAQ,EAAG;YAC9B,MAAMC,SAAS,OAAOL,iBAAiBM,IAAI,CAAU,aAChDJ;gBACHE;gBACAN;;YAEFK,MAAMI,IAAI,IAAIF,OAAOF,KAAK;YAC1B,gEAAgE;YAChE,IAAIE,OAAOF,KAAK,CAACK,MAAM,KAAK,KAAKL,MAAMK,MAAM,IAAIH,OAAOI,KAAK,EAAE;gBAC7D,OAAON;YACT;QACF;IACF;AACF"}

package/dist/use-case/load/resolve-links.uc.d.ts

@@ -0,0 +1,20 @@
+import { type EntifixError, type Entity } from '@entifix/core';
+import { Effect } from 'effect';
+import { EntityLinkResolverTag } from '../../repository/entity-link-resolver.repository.js';
+/** The members of an entity that link to other records. */
+export type LinkMember<TEntity> = {
+    [TKey in keyof TEntity & string]: TEntity[TKey] extends {
+        readonly entityConstructor: unknown;
+        readonly isLoaded: boolean;
+    } ? TKey : never;
+}[keyof TEntity & string];
+/**
+ * Resolves `members` of every record, in place, through the
+ * `EntityLinkResolverTag` in context, and hands the records back.
+ *
+ * A record read with its linked records (a post with its tags) then reads
+ * each through `targetOf`/`targetsOf`, with no `id → record` map built by
+ * hand. Every link resolves concurrently; one that fails fails the whole.
+ */
+export declare function resolveLinksUCFactory<TEntity extends Entity>(records: readonly TEntity[], members: readonly LinkMember<TEntity>[]): Effect.Effect<TEntity[], EntifixError, EntityLinkResolverTag>;
+//# sourceMappingURL=resolve-links.uc.d.ts.map

package/dist/use-case/load/resolve-links.uc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-links.uc.d.ts","sourceRoot":"","sources":["../../../src/use-case/load/resolve-links.uc.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,MAAM,EAEZ,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,qBAAqB,EAAE,MAAM,qDAAqD,CAAC;AAE5F,2DAA2D;AAC3D,MAAM,MAAM,UAAU,CAAC,OAAO,IAAI;KAC/B,IAAI,IAAI,MAAM,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS;QACtD,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;QACpC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;KAC5B,GACG,IAAI,GACJ,KAAK;CACV,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC;AAM1B;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,SAAS,MAAM,EAC1D,OAAO,EAAE,SAAS,OAAO,EAAE,EAC3B,OAAO,EAAE,SAAS,UAAU,CAAC,OAAO,CAAC,EAAE,iEAexC"}

package/dist/use-case/load/resolve-links.uc.js

@@ -0,0 +1,23 @@
+import { Effect } from 'effect';
+import { EntityLinkResolverTag } from '../../repository/entity-link-resolver.repository.js';
+/**
+ * Resolves `members` of every record, in place, through the
+ * `EntityLinkResolverTag` in context, and hands the records back.
+ *
+ * A record read with its linked records (a post with its tags) then reads
+ * each through `targetOf`/`targetsOf`, with no `id → record` map built by
+ * hand. Every link resolves concurrently; one that fails fails the whole.
+ */ export function resolveLinksUCFactory(records, members) {
+    return Effect.gen(function*() {
+        const resolver = yield* EntityLinkResolverTag;
+        yield* Effect.forEach(records.flatMap((record)=>members.map((member)=>record[member].resolve(resolver))), (resolved)=>resolved, {
+            concurrency: 'unbounded',
+            discard: true
+        });
+        return [
+            ...records
+        ];
+    });
+}
+
+//# sourceMappingURL=resolve-links.uc.js.map

package/dist/use-case/load/resolve-links.uc.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/use-case/load/resolve-links.uc.ts"],"sourcesContent":["import {\n  type EntifixError,\n  type Entity,\n  type EntityLinkResolver,\n} from '@entifix/core';\nimport { Effect } from 'effect';\n\nimport { EntityLinkResolverTag } from '../../repository/entity-link-resolver.repository.js';\n\n/** The members of an entity that link to other records. */\nexport type LinkMember<TEntity> = {\n  [TKey in keyof TEntity & string]: TEntity[TKey] extends {\n    readonly entityConstructor: unknown;\n    readonly isLoaded: boolean;\n  }\n    ? TKey\n    : never;\n}[keyof TEntity & string];\n\ntype ResolvableLink = {\n  resolve(resolver: EntityLinkResolver): Effect.Effect<unknown, EntifixError>;\n};\n\n/**\n * Resolves `members` of every record, in place, through the\n * `EntityLinkResolverTag` in context, and hands the records back.\n *\n * A record read with its linked records (a post with its tags) then reads\n * each through `targetOf`/`targetsOf`, with no `id → record` map built by\n * hand. Every link resolves concurrently; one that fails fails the whole.\n */\nexport function resolveLinksUCFactory<TEntity extends Entity>(\n  records: readonly TEntity[],\n  members: readonly LinkMember<TEntity>[],\n) {\n  return Effect.gen(function* () {\n    const resolver = yield* EntityLinkResolverTag;\n    yield* Effect.forEach(\n      records.flatMap(record =>\n        members.map(member =>\n          (record[member] as ResolvableLink).resolve(resolver),\n        ),\n      ),\n      resolved => resolved,\n      { concurrency: 'unbounded', discard: true },\n    );\n    return [...records];\n  });\n}\n"],"names":["Effect","EntityLinkResolverTag","resolveLinksUCFactory","records","members","gen","resolver","forEach","flatMap","record","map","member","resolve","resolved","concurrency","discard"],"mappings":"AAKA,SAASA,MAAM,QAAQ,SAAS;AAEhC,SAASC,qBAAqB,QAAQ,sDAAsD;AAgB5F;;;;;;;CAOC,GACD,OAAO,SAASC,sBACdC,OAA2B,EAC3BC,OAAuC;IAEvC,OAAOJ,OAAOK,GAAG,CAAC;QAChB,MAAMC,WAAW,OAAOL;QACxB,OAAOD,OAAOO,OAAO,CACnBJ,QAAQK,OAAO,CAACC,CAAAA,SACdL,QAAQM,GAAG,CAACC,CAAAA,SACV,AAACF,MAAM,CAACE,OAAO,CAAoBC,OAAO,CAACN,aAG/CO,CAAAA,WAAYA,UACZ;YAAEC,aAAa;YAAaC,SAAS;QAAK;QAE5C,OAAO;eAAIZ;SAAQ;IACrB;AACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@entifix/business",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "The ports every adapter implements — repository, session, token, health — and the generic get, load, save and delete use-cases.",
   "license": "MIT",
   "repository": {
@@ -52,12 +52,12 @@
   },
   "dependencies": {
     "@swc/helpers": "0.5.23",
-    "@entifix/core": "0.1.2"
+    "@entifix/core": "0.1.4"
   },
   "peerDependencies": {
-    "effect": ">=3.22 <4"
+    "effect": ">=3.22.2 <4"
   },
   "devDependencies": {
-    "effect": "3.22.1"
+    "effect": "3.22.2"
   }
 }