@entifix/react-integration 0.1.1 → 0.1.3

package/dist/url/use-entity-load.js

@@ -0,0 +1,67 @@
+import { ConfigurationRepositoryTag, EntityLoadRequestTag, EntityRepositoryTag, loadAllUCFactory } from '@entifix/business';
+import { ConfigurationClientInMemory } from '@entifix/core';
+import { Context, Effect } from 'effect';
+import { useEffect, useState } from 'react';
+const IDLE = {
+    status: 'idle'
+};
+/**
+ * Every record a request keeps, through the `loadAll` use case: a filter
+ * never pages. A source's repository reads no configuration here, but the
+ * port leaves `ConfigurationRepositoryTag` on every method's requirement
+ * channel, so an empty one discharges it.
+ */ async function loadEvery(repository, request) {
+    const context = Context.make(EntityRepositoryTag, repository).pipe(Context.add(ConfigurationRepositoryTag, new ConfigurationClientInMemory({})), Context.add(EntityLoadRequestTag, request));
+    const items = await Effect.runPromise(Effect.provide(loadAllUCFactory(), context));
+    return {
+        items,
+        total: items.length,
+        request
+    };
+}
+/**
+ * Every record a request selects, through the `loadAll` use case over a source.
+ *
+ * `null` asks for nothing and answers `idle`: before hydration, and while no
+ * filter is set, the page shows what the build rendered. An answer counts only
+ * for the request it was asked for, so a late answer to an older filter is
+ * never shown as the current one.
+ */ export function useEntityLoad(source, request) {
+    const [answer, setAnswer] = useState();
+    // Requests are rebuilt on every render; their content is what changes.
+    const key = request === null ? null : JSON.stringify(request);
+    useEffect(()=>{
+        if (request === null || key === null) return;
+        const settle = (load)=>setAnswer({
+                source,
+                key,
+                load
+            });
+        source().then((repository)=>loadEvery(repository, request)).then((page)=>settle({
+                status: 'done',
+                page
+            }), (error)=>settle({
+                status: 'failed',
+                error
+            }));
+    // `request` is read through `key`, its content: a new object with the
+    // same content is the same request.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [
+        source,
+        key
+    ]);
+    if (key === null) return IDLE;
+    if ((answer == null ? void 0 : answer.source) !== source) return {
+        status: 'pending'
+    };
+    if (answer.key === key) return answer.load;
+    return answer.load.status === 'done' ? {
+        status: 'pending',
+        previous: answer.load.page
+    } : {
+        status: 'pending'
+    };
+}
+
+//# sourceMappingURL=use-entity-load.js.map

package/dist/url/use-entity-load.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/url/use-entity-load.ts"],"sourcesContent":["import {\n  ConfigurationRepositoryTag,\n  EntityLoadRequestTag,\n  type EntityRepository,\n  EntityRepositoryTag,\n  loadAllUCFactory,\n} from '@entifix/business';\nimport {\n  ConfigurationClientInMemory,\n  type Entity,\n  type EntityLoadRequest,\n  type EntityPage,\n} from '@entifix/core';\nimport { Context, Effect } from 'effect';\nimport { useEffect, useState } from 'react';\n\nimport type { EntitySource } from './entity-source.js';\n\nexport type EntityLoad<TEntity extends Entity> =\n  | { readonly status: 'idle' }\n  /**\n   * Waiting for an answer. `previous` is the last answer from the same\n   * source, so a filter being changed keeps showing what it showed.\n   */\n  | { readonly status: 'pending'; readonly previous?: EntityPage<TEntity> }\n  | { readonly status: 'done'; readonly page: EntityPage<TEntity> }\n  | { readonly status: 'failed'; readonly error: unknown };\n\nconst IDLE = { status: 'idle' } as const;\n\n/**\n * Every record a request keeps, through the `loadAll` use case: a filter\n * never pages. A source's repository reads no configuration here, but the\n * port leaves `ConfigurationRepositoryTag` on every method's requirement\n * channel, so an empty one discharges it.\n */\nasync function loadEvery<TEntity extends Entity>(\n  repository: EntityRepository,\n  request: EntityLoadRequest<TEntity>,\n): Promise<EntityPage<TEntity>> {\n  const context = Context.make(EntityRepositoryTag, repository).pipe(\n    Context.add(\n      ConfigurationRepositoryTag,\n      new ConfigurationClientInMemory({}),\n    ),\n    Context.add(EntityLoadRequestTag, request as unknown as EntityLoadRequest),\n  );\n  const items = await Effect.runPromise(\n    Effect.provide(loadAllUCFactory<TEntity>(), context),\n  );\n  return { items, total: items.length, request };\n}\n\ninterface Answer<TEntity extends Entity> {\n  readonly source: EntitySource;\n  readonly key: string;\n  readonly load: EntityLoad<TEntity>;\n}\n\n/**\n * Every record a request selects, through the `loadAll` use case over a source.\n *\n * `null` asks for nothing and answers `idle`: before hydration, and while no\n * filter is set, the page shows what the build rendered. An answer counts only\n * for the request it was asked for, so a late answer to an older filter is\n * never shown as the current one.\n */\nexport function useEntityLoad<TEntity extends Entity>(\n  source: EntitySource,\n  request: EntityLoadRequest<TEntity> | null,\n): EntityLoad<TEntity> {\n  const [answer, setAnswer] = useState<Answer<TEntity>>();\n  // Requests are rebuilt on every render; their content is what changes.\n  const key = request === null ? null : JSON.stringify(request);\n\n  useEffect(() => {\n    if (request === null || key === null) return;\n    const settle = (load: EntityLoad<TEntity>) =>\n      setAnswer({ source, key, load });\n    source()\n      .then(repository => loadEvery<TEntity>(repository, request))\n      .then(\n        page => settle({ status: 'done', page }),\n        (error: unknown) => settle({ status: 'failed', error }),\n      );\n    // `request` is read through `key`, its content: a new object with the\n    // same content is the same request.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [source, key]);\n\n  if (key === null) return IDLE;\n  if (answer?.source !== source) return { status: 'pending' };\n  if (answer.key === key) return answer.load;\n  return answer.load.status === 'done'\n    ? { status: 'pending', previous: answer.load.page }\n    : { status: 'pending' };\n}\n"],"names":["ConfigurationRepositoryTag","EntityLoadRequestTag","EntityRepositoryTag","loadAllUCFactory","ConfigurationClientInMemory","Context","Effect","useEffect","useState","IDLE","status","loadEvery","repository","request","context","make","pipe","add","items","runPromise","provide","total","length","useEntityLoad","source","answer","setAnswer","key","JSON","stringify","settle","load","then","page","error","previous"],"mappings":"AAAA,SACEA,0BAA0B,EAC1BC,oBAAoB,EAEpBC,mBAAmB,EACnBC,gBAAgB,QACX,oBAAoB;AAC3B,SACEC,2BAA2B,QAItB,gBAAgB;AACvB,SAASC,OAAO,EAAEC,MAAM,QAAQ,SAAS;AACzC,SAASC,SAAS,EAAEC,QAAQ,QAAQ,QAAQ;AAc5C,MAAMC,OAAO;IAAEC,QAAQ;AAAO;AAE9B;;;;;CAKC,GACD,eAAeC,UACbC,UAA4B,EAC5BC,OAAmC;IAEnC,MAAMC,UAAUT,QAAQU,IAAI,CAACb,qBAAqBU,YAAYI,IAAI,CAChEX,QAAQY,GAAG,CACTjB,4BACA,IAAII,4BAA4B,CAAC,KAEnCC,QAAQY,GAAG,CAAChB,sBAAsBY;IAEpC,MAAMK,QAAQ,MAAMZ,OAAOa,UAAU,CACnCb,OAAOc,OAAO,CAACjB,oBAA6BW;IAE9C,OAAO;QAAEI;QAAOG,OAAOH,MAAMI,MAAM;QAAET;IAAQ;AAC/C;AAQA;;;;;;;CAOC,GACD,OAAO,SAASU,cACdC,MAAoB,EACpBX,OAA0C;IAE1C,MAAM,CAACY,QAAQC,UAAU,GAAGlB;IAC5B,uEAAuE;IACvE,MAAMmB,MAAMd,YAAY,OAAO,OAAOe,KAAKC,SAAS,CAAChB;IAErDN,UAAU;QACR,IAAIM,YAAY,QAAQc,QAAQ,MAAM;QACtC,MAAMG,SAAS,CAACC,OACdL,UAAU;gBAAEF;gBAAQG;gBAAKI;YAAK;QAChCP,SACGQ,IAAI,CAACpB,CAAAA,aAAcD,UAAmBC,YAAYC,UAClDmB,IAAI,CACHC,CAAAA,OAAQH,OAAO;gBAAEpB,QAAQ;gBAAQuB;YAAK,IACtC,CAACC,QAAmBJ,OAAO;gBAAEpB,QAAQ;gBAAUwB;YAAM;IAEzD,sEAAsE;IACtE,oCAAoC;IACpC,uDAAuD;IACzD,GAAG;QAACV;QAAQG;KAAI;IAEhB,IAAIA,QAAQ,MAAM,OAAOlB;IACzB,IAAIgB,CAAAA,0BAAAA,OAAQD,MAAM,MAAKA,QAAQ,OAAO;QAAEd,QAAQ;IAAU;IAC1D,IAAIe,OAAOE,GAAG,KAAKA,KAAK,OAAOF,OAAOM,IAAI;IAC1C,OAAON,OAAOM,IAAI,CAACrB,MAAM,KAAK,SAC1B;QAAEA,QAAQ;QAAWyB,UAAUV,OAAOM,IAAI,CAACE,IAAI;IAAC,IAChD;QAAEvB,QAAQ;IAAU;AAC1B"}

package/dist/url.d.ts

@@ -0,0 +1,11 @@
+/**
+ * A filter kept in the URL and answered by the `loadAll` use case, apart from
+ * the main entry: a page that only filters a list must not pull TanStack
+ * Query and Form, which every hook behind `.` builds on.
+ */
+export * from './url/entity-source.js';
+export * from './url/url-filter.js';
+export * from './url/url-query.js';
+export * from './url/url-state.js';
+export * from './url/use-entity-load.js';
+//# sourceMappingURL=url.d.ts.map

package/dist/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../src/url.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC"}

package/dist/url.js

@@ -0,0 +1,11 @@
+/**
+ * A filter kept in the URL and answered by the `loadAll` use case, apart from
+ * the main entry: a page that only filters a list must not pull TanStack
+ * Query and Form, which every hook behind `.` builds on.
+ */ export * from './url/entity-source.js';
+export * from './url/url-filter.js';
+export * from './url/url-query.js';
+export * from './url/url-state.js';
+export * from './url/use-entity-load.js';
+
+//# sourceMappingURL=url.js.map

package/dist/url.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/url.ts"],"sourcesContent":["/**\n * A filter kept in the URL and answered by the `loadAll` use case, apart from\n * the main entry: a page that only filters a list must not pull TanStack\n * Query and Form, which every hook behind `.` builds on.\n */\nexport * from './url/entity-source.js';\nexport * from './url/url-filter.js';\nexport * from './url/url-query.js';\nexport * from './url/url-state.js';\nexport * from './url/use-entity-load.js';\n"],"names":[],"mappings":"AAAA;;;;CAIC,GACD,cAAc,yBAAyB;AACvC,cAAc,sBAAsB;AACpC,cAAc,qBAAqB;AACnC,cAAc,qBAAqB;AACnC,cAAc,2BAA2B"}

package/package.json

@@ -2,9 +2,6 @@
   "name": "@entifix/react-integration",
   "nx": {
     "tags": [
-      "layer:entifix",
-      "scope:shared",
-      "entifix:react",
       "tier:3"
     ],
     "sourceRoot": "packages/react/integration/src",
@@ -24,7 +21,7 @@
       }
     }
   },
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "React hooks that bind entities to data: TanStack Query and Form over the entity adapters, drafts, mutations and live invalidation.",
   "license": "MIT",
   "repository": {
@@ -46,6 +43,12 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
+    },
+    "./url": {
+      "@entifix/source": "./src/url.ts",
+      "types": "./dist/url.d.ts",
+      "import": "./dist/url.js",
+      "default": "./dist/url.js"
     }
   },
   "files": [
@@ -54,16 +57,16 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@entifix/transactions": "0.1.1",
-    "@entifix/business": "0.1.1",
-    "@entifix/core": "0.1.1"
+    "@entifix/transactions": "0.1.3",
+    "@entifix/business": "0.1.3",
+    "@entifix/core": "0.1.3"
   },
   "devDependencies": {
     "@tanstack/react-form": "1.33.5",
     "@tanstack/react-query": "^5.101.4",
     "effect": "3.22.1",
     "react": "19.2.8",
-    "@entifix/testing-unit": "0.1.1"
+    "@entifix/testing-unit": "0.1.3"
   },
   "peerDependencies": {
     "@tanstack/react-form": ">=1.33 <2",