@entifix/business 0.7.2 → 0.9.0

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`, `loadAllUCFactory` (every record a request keeps, page by page), `resolveLinksUCFactory` (chosen links of many records), `HealthRegistryLayer`, `makeShutdownRegistry` |
+| Import              | What it holds                                                                                                                                                                                                                                                                                                                                                         |
+| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `@entifix/business` | Port tags (the facet counter, `EntityFacetCounterTag` and its factory, beside the repository), `getUCFactory` / `loadUCFactory` / `saveUCFactory` / `deleteUCFactory`, `facetCountsUCFactory`, `loadAllUCFactory` (every record a request keeps, page by page), `resolveLinksUCFactory` (chosen links of many records), `HealthRegistryLayer`, `makeShutdownRegistry` |
 
 ---
 

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export * from './health/health-registry.js';
 export * from './repository/config.repository.js';
 export * from './repository/entity.repository.js';
+export * from './repository/entity-facet-counter.js';
 export * from './repository/entity-link-resolver.repository.js';
 export * from './repository/entity-mixins.repository.js';
 export * from './repository/entity-repository-factory.js';
@@ -10,6 +11,7 @@ export * from './shutdown/shutdown-registry.js';
 export * from './tenancy/index.js';
 export * from './tokens/token-service.js';
 export * from './use-case/delete/index.js';
+export * from './use-case/facets/index.js';
 export * from './use-case/get/index.js';
 export * from './use-case/load/index.js';
 export * from './use-case/save/index.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,iDAAiD,CAAC;AAChE,cAAc,0CAA0C,CAAC;AACzD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,oCAAoC,CAAC;AACnD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,sCAAsC,CAAC;AACrD,cAAc,iDAAiD,CAAC;AAChE,cAAc,0CAA0C,CAAC;AACzD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,oCAAoC,CAAC;AACnD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC"}

package/dist/index.js

@@ -1,6 +1,7 @@
 export * from './health/health-registry.js';
 export * from './repository/config.repository.js';
 export * from './repository/entity.repository.js';
+export * from './repository/entity-facet-counter.js';
 export * from './repository/entity-link-resolver.repository.js';
 export * from './repository/entity-mixins.repository.js';
 export * from './repository/entity-repository-factory.js';
@@ -10,6 +11,7 @@ export * from './shutdown/shutdown-registry.js';
 export * from './tenancy/index.js';
 export * from './tokens/token-service.js';
 export * from './use-case/delete/index.js';
+export * from './use-case/facets/index.js';
 export * from './use-case/get/index.js';
 export * from './use-case/load/index.js';
 export * from './use-case/save/index.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from './health/health-registry.js';\nexport * from './repository/config.repository.js';\nexport * from './repository/entity.repository.js';\nexport * from './repository/entity-link-resolver.repository.js';\nexport * from './repository/entity-mixins.repository.js';\nexport * from './repository/entity-repository-factory.js';\nexport * from './sessions/one-time-token-store.js';\nexport * from './sessions/session-store.js';\nexport * from './shutdown/shutdown-registry.js';\nexport * from './tenancy/index.js';\nexport * from './tokens/token-service.js';\nexport * from './use-case/delete/index.js';\nexport * from './use-case/get/index.js';\nexport * from './use-case/load/index.js';\nexport * from './use-case/save/index.js';\nexport * from './wiring/wiring-registry.js';\n"],"names":[],"mappings":"AAAA,cAAc,8BAA8B;AAC5C,cAAc,oCAAoC;AAClD,cAAc,oCAAoC;AAClD,cAAc,kDAAkD;AAChE,cAAc,2CAA2C;AACzD,cAAc,4CAA4C;AAC1D,cAAc,qCAAqC;AACnD,cAAc,8BAA8B;AAC5C,cAAc,kCAAkC;AAChD,cAAc,qBAAqB;AACnC,cAAc,4BAA4B;AAC1C,cAAc,6BAA6B;AAC3C,cAAc,0BAA0B;AACxC,cAAc,2BAA2B;AACzC,cAAc,2BAA2B;AACzC,cAAc,8BAA8B"}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from './health/health-registry.js';\nexport * from './repository/config.repository.js';\nexport * from './repository/entity.repository.js';\nexport * from './repository/entity-facet-counter.js';\nexport * from './repository/entity-link-resolver.repository.js';\nexport * from './repository/entity-mixins.repository.js';\nexport * from './repository/entity-repository-factory.js';\nexport * from './sessions/one-time-token-store.js';\nexport * from './sessions/session-store.js';\nexport * from './shutdown/shutdown-registry.js';\nexport * from './tenancy/index.js';\nexport * from './tokens/token-service.js';\nexport * from './use-case/delete/index.js';\nexport * from './use-case/facets/index.js';\nexport * from './use-case/get/index.js';\nexport * from './use-case/load/index.js';\nexport * from './use-case/save/index.js';\nexport * from './wiring/wiring-registry.js';\n"],"names":[],"mappings":"AAAA,cAAc,8BAA8B;AAC5C,cAAc,oCAAoC;AAClD,cAAc,oCAAoC;AAClD,cAAc,uCAAuC;AACrD,cAAc,kDAAkD;AAChE,cAAc,2CAA2C;AACzD,cAAc,4CAA4C;AAC1D,cAAc,qCAAqC;AACnD,cAAc,8BAA8B;AAC5C,cAAc,kCAAkC;AAChD,cAAc,qBAAqB;AACnC,cAAc,4BAA4B;AAC1C,cAAc,6BAA6B;AAC3C,cAAc,6BAA6B;AAC3C,cAAc,0BAA0B;AACxC,cAAc,2BAA2B;AACzC,cAAc,2BAA2B;AACzC,cAAc,8BAA8B"}

package/dist/repository/entity-facet-counter.d.ts

@@ -0,0 +1,35 @@
+import type { EntifixConnError, EntifixError, Entity, EntityConstructor, EntityFacetCounts, EntityFacetQuery } from '@entifix/core';
+import { Context, type Effect } from 'effect';
+import type { RepositoryScope } from './entity-repository-factory.js';
+/**
+ * Counts how many of one entity's records hold each value of a member — what a
+ * facet shows beside each choice ("Aurora (12)").
+ *
+ * A port of its own rather than a fifth method on `EntityRepository`, so a
+ * store that cannot count is simply not bound to it: a route or a read that
+ * needs counts then fails to compile for want of the tag, instead of an
+ * adapter answering an empty list nobody notices.
+ *
+ * ⚠️ Like the repository, every method requires nothing from its environment;
+ * an adapter binds what it needs when it is built.
+ */
+export interface EntityFacetCounter {
+    count<TEntity extends Entity>(queries: readonly EntityFacetQuery<TEntity>[]): Effect.Effect<EntityFacetCounts, EntifixError>;
+}
+declare const EntityFacetCounterTag_base: Context.ServiceClass<EntityFacetCounterTag, "EntityFacetCounterTag", EntityFacetCounter>;
+export declare class EntityFacetCounterTag extends EntityFacetCounterTag_base {
+}
+/**
+ * Opens the {@link EntityFacetCounter} for one entity, for one request — the
+ * counter's `EntityRepositoryFactory`, with the same rule: an implementation
+ * over a per-organization store **must refuse** a scope with no
+ * `organizationId`.
+ */
+export interface EntityFacetCounterFactory {
+    readonly for: <T extends Entity>(entityConstructor: EntityConstructor<T>, scope: RepositoryScope) => Effect.Effect<EntityFacetCounter, EntifixConnError>;
+}
+declare const EntityFacetCounterFactoryTag_base: Context.ServiceClass<EntityFacetCounterFactoryTag, "EntityFacetCounterFactoryTag", EntityFacetCounterFactory>;
+export declare class EntityFacetCounterFactoryTag extends EntityFacetCounterFactoryTag_base {
+}
+export {};
+//# sourceMappingURL=entity-facet-counter.d.ts.map

package/dist/repository/entity-facet-counter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-facet-counter.d.ts","sourceRoot":"","sources":["../../src/repository/entity-facet-counter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EACZ,MAAM,EACN,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEtE;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,OAAO,SAAS,MAAM,EAC1B,OAAO,EAAE,SAAS,gBAAgB,CAAC,OAAO,CAAC,EAAE,GAC5C,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC;CACnD;;AAED,qBAAa,qBAAsB,SAAQ,0BAGf;CAAG;AAE/B;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,SAAS,MAAM,EAC7B,iBAAiB,EAAE,iBAAiB,CAAC,CAAC,CAAC,EACvC,KAAK,EAAE,eAAe,KACnB,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,CAAC;CAC1D;;AAED,qBAAa,4BAA6B,SAAQ,iCAGf;CAAG"}

package/dist/repository/entity-facet-counter.js

@@ -0,0 +1,7 @@
+import { Context } from 'effect';
+export class EntityFacetCounterTag extends Context.Service()('EntityFacetCounterTag') {
+}
+export class EntityFacetCounterFactoryTag extends Context.Service()('EntityFacetCounterFactoryTag') {
+}
+
+//# sourceMappingURL=entity-facet-counter.js.map

package/dist/repository/entity-facet-counter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/repository/entity-facet-counter.ts"],"sourcesContent":["import type {\n  EntifixConnError,\n  EntifixError,\n  Entity,\n  EntityConstructor,\n  EntityFacetCounts,\n  EntityFacetQuery,\n} from '@entifix/core';\nimport { Context, type Effect } from 'effect';\n\nimport type { RepositoryScope } from './entity-repository-factory.js';\n\n/**\n * Counts how many of one entity's records hold each value of a member — what a\n * facet shows beside each choice (\"Aurora (12)\").\n *\n * A port of its own rather than a fifth method on `EntityRepository`, so a\n * store that cannot count is simply not bound to it: a route or a read that\n * needs counts then fails to compile for want of the tag, instead of an\n * adapter answering an empty list nobody notices.\n *\n * ⚠️ Like the repository, every method requires nothing from its environment;\n * an adapter binds what it needs when it is built.\n */\nexport interface EntityFacetCounter {\n  count<TEntity extends Entity>(\n    queries: readonly EntityFacetQuery<TEntity>[],\n  ): Effect.Effect<EntityFacetCounts, EntifixError>;\n}\n\nexport class EntityFacetCounterTag extends Context.Service<\n  EntityFacetCounterTag,\n  EntityFacetCounter\n>()('EntityFacetCounterTag') {}\n\n/**\n * Opens the {@link EntityFacetCounter} for one entity, for one request — the\n * counter's `EntityRepositoryFactory`, with the same rule: an implementation\n * over a per-organization store **must refuse** a scope with no\n * `organizationId`.\n */\nexport interface EntityFacetCounterFactory {\n  readonly for: <T extends Entity>(\n    entityConstructor: EntityConstructor<T>,\n    scope: RepositoryScope,\n  ) => Effect.Effect<EntityFacetCounter, EntifixConnError>;\n}\n\nexport class EntityFacetCounterFactoryTag extends Context.Service<\n  EntityFacetCounterFactoryTag,\n  EntityFacetCounterFactory\n>()('EntityFacetCounterFactoryTag') {}\n"],"names":["Context","EntityFacetCounterTag","Service","EntityFacetCounterFactoryTag"],"mappings":"AAQA,SAASA,OAAO,QAAqB,SAAS;AAsB9C,OAAO,MAAMC,8BAA8BD,QAAQE,OAAO,GAGtD;AAA0B;AAe9B,OAAO,MAAMC,qCAAqCH,QAAQE,OAAO,GAG7D;AAAiC"}

package/dist/use-case/facets/facet-counts.uc.d.ts

@@ -0,0 +1,12 @@
+import type { Entity, EntityFacetQuery } from '@entifix/core';
+import { Effect } from 'effect';
+import { EntityFacetCounterTag } from '../../repository/entity-facet-counter.js';
+/**
+ * The counts for `queries`, from whichever counter the caller provides.
+ *
+ * The queries are an argument rather than a tag: a tag cannot carry the
+ * entity's type, and the cast a load request needs to cross one is exactly
+ * what this use case has no reason to inherit.
+ */
+export declare const facetCountsUCFactory: <TEntity extends Entity>(queries: readonly EntityFacetQuery<TEntity>[]) => Effect.Effect<Readonly<Record<string, readonly import("@entifix/core").EntityFacetValue[]>>, import("@entifix/core").EntifixError, EntityFacetCounterTag>;
+//# sourceMappingURL=facet-counts.uc.d.ts.map

package/dist/use-case/facets/facet-counts.uc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facet-counts.uc.d.ts","sourceRoot":"","sources":["../../../src/use-case/facets/facet-counts.uc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AAEjF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,OAAO,SAAS,MAAM,EACzD,SAAS,SAAS,gBAAgB,CAAC,OAAO,CAAC,EAAE,8JAK3C,CAAC"}

package/dist/use-case/facets/facet-counts.uc.js

@@ -0,0 +1,14 @@
+import { Effect } from 'effect';
+import { EntityFacetCounterTag } from '../../repository/entity-facet-counter.js';
+/**
+ * The counts for `queries`, from whichever counter the caller provides.
+ *
+ * The queries are an argument rather than a tag: a tag cannot carry the
+ * entity's type, and the cast a load request needs to cross one is exactly
+ * what this use case has no reason to inherit.
+ */ export const facetCountsUCFactory = (queries)=>Effect.gen(function*() {
+        const counter = yield* EntityFacetCounterTag;
+        return yield* counter.count(queries);
+    });
+
+//# sourceMappingURL=facet-counts.uc.js.map

package/dist/use-case/facets/facet-counts.uc.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/use-case/facets/facet-counts.uc.ts"],"sourcesContent":["import type { Entity, EntityFacetQuery } from '@entifix/core';\nimport { Effect } from 'effect';\n\nimport { EntityFacetCounterTag } from '../../repository/entity-facet-counter.js';\n\n/**\n * The counts for `queries`, from whichever counter the caller provides.\n *\n * The queries are an argument rather than a tag: a tag cannot carry the\n * entity's type, and the cast a load request needs to cross one is exactly\n * what this use case has no reason to inherit.\n */\nexport const facetCountsUCFactory = <TEntity extends Entity>(\n  queries: readonly EntityFacetQuery<TEntity>[],\n) =>\n  Effect.gen(function* () {\n    const counter = yield* EntityFacetCounterTag;\n    return yield* counter.count<TEntity>(queries);\n  });\n"],"names":["Effect","EntityFacetCounterTag","facetCountsUCFactory","queries","gen","counter","count"],"mappings":"AACA,SAASA,MAAM,QAAQ,SAAS;AAEhC,SAASC,qBAAqB,QAAQ,2CAA2C;AAEjF;;;;;;CAMC,GACD,OAAO,MAAMC,uBAAuB,CAClCC,UAEAH,OAAOI,GAAG,CAAC;QACT,MAAMC,UAAU,OAAOJ;QACvB,OAAO,OAAOI,QAAQC,KAAK,CAAUH;IACvC,GAAG"}

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

@@ -0,0 +1,2 @@
+export * from './facet-counts.uc.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/use-case/facets/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC"}

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

@@ -0,0 +1,3 @@
+export * from './facet-counts.uc.js';
+
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/use-case/facets/index.ts"],"sourcesContent":["export * from './facet-counts.uc.js';\n"],"names":[],"mappings":"AAAA,cAAc,uBAAuB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@entifix/business",
-  "version": "0.7.2",
+  "version": "0.9.0",
   "description": "The ports every adapter implements — repository, session, token, health — and the generic get, load, save and delete use-cases.",
   "license": "MIT",
   "repository": {
@@ -51,7 +51,7 @@
   },
   "dependencies": {
     "@swc/helpers": "0.5.23",
-    "@entifix/core": "0.7.2"
+    "@entifix/core": "0.9.0"
   },
   "peerDependencies": {
     "effect": "^4.0.5"