@entifix/rest 0.1.0-0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 r10c Technologies
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,11 @@
+# @entifix/rest
+
+This library was generated with [Nx](https://nx.dev).
+
+## Building
+
+Run `nx build @entifix/rest` to build the library.
+
+## Running unit tests
+
+Run `nx test @entifix/rest` to execute the unit tests via [Jest](https://jestjs.io).

package/dist/adapters/entity-metadata/make-entity-metadata-source/index.d.ts

@@ -0,0 +1,2 @@
+export * from './make-entity-metadata-source.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/entity-metadata/make-entity-metadata-source/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/adapters/entity-metadata/make-entity-metadata-source/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC"}

package/dist/adapters/entity-metadata/make-entity-metadata-source/index.js

@@ -0,0 +1,3 @@
+export * from './make-entity-metadata-source.js';
+
+//# sourceMappingURL=index.js.map

package/dist/adapters/entity-metadata/make-entity-metadata-source/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/adapters/entity-metadata/make-entity-metadata-source/index.ts"],"sourcesContent":["export * from './make-entity-metadata-source.js';\n"],"names":[],"mappings":"AAAA,cAAc,mCAAmC"}

package/dist/adapters/entity-metadata/make-entity-metadata-source/make-entity-metadata-source.d.ts

@@ -0,0 +1,23 @@
+import { type EntityMetadataSource } from '@entifix/core';
+export interface EntityMetadataSourceOptions {
+    /**
+     * Where this entity's document lives, given its envelope name.
+     *
+     * A builder rather than the adapters' `BuildEntityRestOptions`, because the
+     * two consumers resolve their base differently: the catalog goes through
+     * `buildEntityBaseUrl`'s config-driven `compose` mode, while a Next shell with
+     * hand-written same-origin routes has no adapters context at all. Both can
+     * write one arrow function.
+     */
+    url: (entityName: string) => string;
+}
+/**
+ * Fetches an entity's {@link EntityMetadataDocument} over HTTP.
+ *
+ * The response is permission-filtered by the service against the *verified*
+ * principal, so nothing here re-checks anything: this reads what the caller was
+ * told they may do. Cookies ride along by `fetch`'s same-origin default, which
+ * is what carries the session on a Next shell's own `/api` route.
+ */
+export declare const makeEntityMetadataSource: ({ url, }: EntityMetadataSourceOptions) => EntityMetadataSource;
+//# sourceMappingURL=make-entity-metadata-source.d.ts.map

package/dist/adapters/entity-metadata/make-entity-metadata-source/make-entity-metadata-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-entity-metadata-source.d.ts","sourceRoot":"","sources":["../../../../src/adapters/entity-metadata/make-entity-metadata-source/make-entity-metadata-source.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,oBAAoB,EAG1B,MAAM,eAAe,CAAC;AAGvB,MAAM,WAAW,2BAA2B;IAC1C;;;;;;;;OAQG;IACH,GAAG,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC;CACrC;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,GAAI,UAEtC,2BAA2B,KAAG,oBAgD/B,CAAC"}

package/dist/adapters/entity-metadata/make-entity-metadata-source/make-entity-metadata-source.js

@@ -0,0 +1,45 @@
+import { EntifixConnError, envelopeEntityName, readEntityMetadataEnvelope } from '@entifix/core';
+import { Effect } from 'effect';
+/**
+ * Fetches an entity's {@link EntityMetadataDocument} over HTTP.
+ *
+ * The response is permission-filtered by the service against the *verified*
+ * principal, so nothing here re-checks anything: this reads what the caller was
+ * told they may do. Cookies ride along by `fetch`'s same-origin default, which
+ * is what carries the session on a Next shell's own `/api` route.
+ */ export const makeEntityMetadataSource = ({ url })=>({
+        fetchMetadata: (entityConstructor)=>{
+            const name = envelopeEntityName(entityConstructor);
+            return Effect.runPromise(Effect.gen(function*() {
+                const response = yield* Effect.tryPromise({
+                    try: ()=>fetch(url(name), {
+                            headers: {
+                                Accept: 'application/json'
+                            }
+                        }),
+                    catch: (error)=>new EntifixConnError(`Metadata request for "${name}" failed`, error, {
+                            entity: name
+                        })
+                });
+                if (!response.ok) {
+                    // A `404` here is deliberate on the service side and means "not
+                    // readable, or not hosted" — the endpoint refuses to distinguish the
+                    // two so it cannot be walked to enumerate the model. Either way the
+                    // caller has no affordances, so it is an error, not an empty document.
+                    return yield* Effect.fail(new EntifixConnError(`Metadata request for "${name}" failed with status ${response.status}`, undefined, {
+                        entity: name,
+                        status: response.status
+                    }));
+                }
+                const body = yield* Effect.tryPromise({
+                    try: ()=>response.json(),
+                    catch: (error)=>new EntifixConnError(`Metadata response for "${name}" was not JSON`, error, {
+                            entity: name
+                        })
+                });
+                return yield* readEntityMetadataEnvelope(entityConstructor, body);
+            }));
+        }
+    });
+
+//# sourceMappingURL=make-entity-metadata-source.js.map

package/dist/adapters/entity-metadata/make-entity-metadata-source/make-entity-metadata-source.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/adapters/entity-metadata/make-entity-metadata-source/make-entity-metadata-source.ts"],"sourcesContent":["import {\n  EntifixConnError,\n  type Entity,\n  type EntityConstructor,\n  type EntityMetadataDocument,\n  type EntityMetadataSource,\n  envelopeEntityName,\n  readEntityMetadataEnvelope,\n} from '@entifix/core';\nimport { Effect } from 'effect';\n\nexport interface EntityMetadataSourceOptions {\n  /**\n   * Where this entity's document lives, given its envelope name.\n   *\n   * A builder rather than the adapters' `BuildEntityRestOptions`, because the\n   * two consumers resolve their base differently: the catalog goes through\n   * `buildEntityBaseUrl`'s config-driven `compose` mode, while a Next shell with\n   * hand-written same-origin routes has no adapters context at all. Both can\n   * write one arrow function.\n   */\n  url: (entityName: string) => string;\n}\n\n/**\n * Fetches an entity's {@link EntityMetadataDocument} over HTTP.\n *\n * The response is permission-filtered by the service against the *verified*\n * principal, so nothing here re-checks anything: this reads what the caller was\n * told they may do. Cookies ride along by `fetch`'s same-origin default, which\n * is what carries the session on a Next shell's own `/api` route.\n */\nexport const makeEntityMetadataSource = ({\n  url,\n}: EntityMetadataSourceOptions): EntityMetadataSource => ({\n  fetchMetadata: <TEntity extends Entity>(\n    entityConstructor: EntityConstructor<TEntity>,\n  ): Promise<EntityMetadataDocument> => {\n    const name = envelopeEntityName(entityConstructor);\n    return Effect.runPromise(\n      Effect.gen(function* () {\n        const response = yield* Effect.tryPromise({\n          try: () =>\n            fetch(url(name), { headers: { Accept: 'application/json' } }),\n          catch: error =>\n            new EntifixConnError(\n              `Metadata request for \"${name}\" failed`,\n              error,\n              {\n                entity: name,\n              },\n            ),\n        });\n\n        if (!response.ok) {\n          // A `404` here is deliberate on the service side and means \"not\n          // readable, or not hosted\" — the endpoint refuses to distinguish the\n          // two so it cannot be walked to enumerate the model. Either way the\n          // caller has no affordances, so it is an error, not an empty document.\n          return yield* Effect.fail(\n            new EntifixConnError(\n              `Metadata request for \"${name}\" failed with status ${response.status}`,\n              undefined,\n              { entity: name, status: response.status },\n            ),\n          );\n        }\n\n        const body = yield* Effect.tryPromise({\n          try: () => response.json() as Promise<unknown>,\n          catch: error =>\n            new EntifixConnError(\n              `Metadata response for \"${name}\" was not JSON`,\n              error,\n              { entity: name },\n            ),\n        });\n\n        return yield* readEntityMetadataEnvelope(entityConstructor, body);\n      }),\n    );\n  },\n});\n"],"names":["EntifixConnError","envelopeEntityName","readEntityMetadataEnvelope","Effect","makeEntityMetadataSource","url","fetchMetadata","entityConstructor","name","runPromise","gen","response","tryPromise","try","fetch","headers","Accept","catch","error","entity","ok","fail","status","undefined","body","json"],"mappings":"AAAA,SACEA,gBAAgB,EAKhBC,kBAAkB,EAClBC,0BAA0B,QACrB,gBAAgB;AACvB,SAASC,MAAM,QAAQ,SAAS;AAehC;;;;;;;CAOC,GACD,OAAO,MAAMC,2BAA2B,CAAC,EACvCC,GAAG,EACyB,GAA4B,CAAA;QACxDC,eAAe,CACbC;YAEA,MAAMC,OAAOP,mBAAmBM;YAChC,OAAOJ,OAAOM,UAAU,CACtBN,OAAOO,GAAG,CAAC;gBACT,MAAMC,WAAW,OAAOR,OAAOS,UAAU,CAAC;oBACxCC,KAAK,IACHC,MAAMT,IAAIG,OAAO;4BAAEO,SAAS;gCAAEC,QAAQ;4BAAmB;wBAAE;oBAC7DC,OAAOC,CAAAA,QACL,IAAIlB,iBACF,CAAC,sBAAsB,EAAEQ,KAAK,QAAQ,CAAC,EACvCU,OACA;4BACEC,QAAQX;wBACV;gBAEN;gBAEA,IAAI,CAACG,SAASS,EAAE,EAAE;oBAChB,gEAAgE;oBAChE,qEAAqE;oBACrE,oEAAoE;oBACpE,uEAAuE;oBACvE,OAAO,OAAOjB,OAAOkB,IAAI,CACvB,IAAIrB,iBACF,CAAC,sBAAsB,EAAEQ,KAAK,qBAAqB,EAAEG,SAASW,MAAM,EAAE,EACtEC,WACA;wBAAEJ,QAAQX;wBAAMc,QAAQX,SAASW,MAAM;oBAAC;gBAG9C;gBAEA,MAAME,OAAO,OAAOrB,OAAOS,UAAU,CAAC;oBACpCC,KAAK,IAAMF,SAASc,IAAI;oBACxBR,OAAOC,CAAAA,QACL,IAAIlB,iBACF,CAAC,uBAAuB,EAAEQ,KAAK,cAAc,CAAC,EAC9CU,OACA;4BAAEC,QAAQX;wBAAK;gBAErB;gBAEA,OAAO,OAAON,2BAA2BK,mBAAmBiB;YAC9D;QAEJ;IACF,CAAA,EAAG"}

package/dist/adapters/entity-rest/build-entity-rest-adapter-delete/build-entity-rest-adapter-delete.d.ts

@@ -0,0 +1,13 @@
+import { ConfigurationRepositoryTag } from '@entifix/business';
+import { Entity, EntityConstructor, EntityId } from '@entifix/core';
+import { Effect } from 'effect';
+import { BuildEntityRestOptions } from '../types.js';
+/**
+ * Deletes an entity over HTTP.
+ *
+ * The response body is discarded, but the service still answers with an
+ * envelope rather than a bare `204`: the shared fetch client always parses the
+ * response as JSON, and an empty body would fail that parse.
+ */
+export declare const buildEntityRestAdapterDelete: <TEntity extends Entity>(entityConstructor: EntityConstructor<TEntity>, { uriConfig }: BuildEntityRestOptions) => <TEntity_1 extends Entity>(entityOrId: EntityId | TEntity_1) => Effect.Effect<undefined, import("@entifix/core").EntifixBuildError | import("@entifix/core").EntifixConnError, ConfigurationRepositoryTag>;
+//# sourceMappingURL=build-entity-rest-adapter-delete.d.ts.map

package/dist/adapters/entity-rest/build-entity-rest-adapter-delete/build-entity-rest-adapter-delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-entity-rest-adapter-delete.d.ts","sourceRoot":"","sources":["../../../../src/adapters/entity-rest/build-entity-rest-adapter-delete/build-entity-rest-adapter-delete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAEL,MAAM,EACN,iBAAiB,EACjB,QAAQ,EAET,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AASrD;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,GACtC,OAAO,SAAS,MAAM,EACrB,mBAAmB,iBAAiB,CAAC,OAAO,CAAC,EAC7C,eAAe,sBAAsB,MAEtC,SAAO,SAAS,MAAM,EAAE,YAAY,QAAQ,GAAG,SAAO,+IA0BnD,CAAC"}

package/dist/adapters/entity-rest/build-entity-rest-adapter-delete/build-entity-rest-adapter-delete.js

@@ -0,0 +1,34 @@
+import { ConfigurationRepositoryTag } from '@entifix/business';
+import { EntifixLogicError, extractMetaEntity } from '@entifix/core';
+import { Effect } from 'effect';
+import { performHttpRequestThroughFetch } from '../../../clients/fetch/index.js';
+import { buildEntityRestAdapterMixins as adapterMixins } from '../build-entity-rest-adapter-mixins/index.js';
+/** Accepts either an id or a whole entity, mirroring the repository contract. */ function toEntityId(entityOrId) {
+    return entityOrId != null && typeof entityOrId === 'object' ? entityOrId.id : entityOrId;
+}
+/**
+ * Deletes an entity over HTTP.
+ *
+ * The response body is discarded, but the service still answers with an
+ * envelope rather than a bare `204`: the shared fetch client always parses the
+ * response as JSON, and an empty body would fail that parse.
+ */ export const buildEntityRestAdapterDelete = (entityConstructor, { uriConfig })=>(entityOrId)=>Effect.gen(function*() {
+            var _metaEntity_key;
+            const configurationStore = yield* ConfigurationRepositoryTag;
+            const metaEntity = extractMetaEntity(entityConstructor);
+            const id = toEntityId(entityOrId);
+            if (id == null) {
+                return yield* Effect.fail(new EntifixLogicError(`Cannot delete a ${entityConstructor.name} without an id`, undefined, {
+                    entity: entityConstructor.name
+                }));
+            }
+            const url = yield* adapterMixins.buildEntityBaseUrl(configurationStore, {
+                uriConfig
+            }, (_metaEntity_key = metaEntity.key) != null ? _metaEntity_key : metaEntity.name, String(id));
+            yield* performHttpRequestThroughFetch(adapterMixins.buildEntityRequest({
+                method: 'DELETE',
+                url
+            }));
+        });
+
+//# sourceMappingURL=build-entity-rest-adapter-delete.js.map

package/dist/adapters/entity-rest/build-entity-rest-adapter-delete/build-entity-rest-adapter-delete.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/adapters/entity-rest/build-entity-rest-adapter-delete/build-entity-rest-adapter-delete.ts"],"sourcesContent":["import { ConfigurationRepositoryTag } from '@entifix/business';\nimport {\n  EntifixLogicError,\n  Entity,\n  EntityConstructor,\n  EntityId,\n  extractMetaEntity,\n} from '@entifix/core';\nimport { Effect } from 'effect';\n\nimport { performHttpRequestThroughFetch } from '../../../clients/fetch/index.js';\nimport { buildEntityRestAdapterMixins as adapterMixins } from '../build-entity-rest-adapter-mixins/index.js';\nimport { BuildEntityRestOptions } from '../types.js';\n\n/** Accepts either an id or a whole entity, mirroring the repository contract. */\nfunction toEntityId(entityOrId: EntityId | Entity): EntityId {\n  return entityOrId != null && typeof entityOrId === 'object'\n    ? (entityOrId as Entity).id\n    : (entityOrId as EntityId);\n}\n\n/**\n * Deletes an entity over HTTP.\n *\n * The response body is discarded, but the service still answers with an\n * envelope rather than a bare `204`: the shared fetch client always parses the\n * response as JSON, and an empty body would fail that parse.\n */\nexport const buildEntityRestAdapterDelete =\n  <TEntity extends Entity>(\n    entityConstructor: EntityConstructor<TEntity>,\n    { uriConfig }: BuildEntityRestOptions,\n  ) =>\n  <TEntity extends Entity>(entityOrId: EntityId | TEntity) =>\n    Effect.gen(function* () {\n      const configurationStore = yield* ConfigurationRepositoryTag;\n      const metaEntity = extractMetaEntity(entityConstructor);\n      const id = toEntityId(entityOrId);\n\n      if (id == null) {\n        return yield* Effect.fail(\n          new EntifixLogicError(\n            `Cannot delete a ${entityConstructor.name} without an id`,\n            undefined,\n            { entity: entityConstructor.name },\n          ),\n        );\n      }\n\n      const url = yield* adapterMixins.buildEntityBaseUrl(\n        configurationStore,\n        { uriConfig },\n        metaEntity.key ?? metaEntity.name,\n        String(id),\n      );\n\n      yield* performHttpRequestThroughFetch(\n        adapterMixins.buildEntityRequest({ method: 'DELETE', url }),\n      );\n    });\n"],"names":["ConfigurationRepositoryTag","EntifixLogicError","extractMetaEntity","Effect","performHttpRequestThroughFetch","buildEntityRestAdapterMixins","adapterMixins","toEntityId","entityOrId","id","buildEntityRestAdapterDelete","entityConstructor","uriConfig","gen","metaEntity","configurationStore","fail","name","undefined","entity","url","buildEntityBaseUrl","key","String","buildEntityRequest","method"],"mappings":"AAAA,SAASA,0BAA0B,QAAQ,oBAAoB;AAC/D,SACEC,iBAAiB,EAIjBC,iBAAiB,QACZ,gBAAgB;AACvB,SAASC,MAAM,QAAQ,SAAS;AAEhC,SAASC,8BAA8B,QAAQ,kCAAkC;AACjF,SAASC,gCAAgCC,aAAa,QAAQ,+CAA+C;AAG7G,+EAA+E,GAC/E,SAASC,WAAWC,UAA6B;IAC/C,OAAOA,cAAc,QAAQ,OAAOA,eAAe,WAC/C,AAACA,WAAsBC,EAAE,GACxBD;AACP;AAEA;;;;;;CAMC,GACD,OAAO,MAAME,+BACX,CACEC,mBACA,EAAEC,SAAS,EAA0B,GAEvC,CAAyBJ,aACvBL,OAAOU,GAAG,CAAC;gBAkBPC;YAjBF,MAAMC,qBAAqB,OAAOf;YAClC,MAAMc,aAAaZ,kBAAkBS;YACrC,MAAMF,KAAKF,WAAWC;YAEtB,IAAIC,MAAM,MAAM;gBACd,OAAO,OAAON,OAAOa,IAAI,CACvB,IAAIf,kBACF,CAAC,gBAAgB,EAAEU,kBAAkBM,IAAI,CAAC,cAAc,CAAC,EACzDC,WACA;oBAAEC,QAAQR,kBAAkBM,IAAI;gBAAC;YAGvC;YAEA,MAAMG,MAAM,OAAOd,cAAce,kBAAkB,CACjDN,oBACA;gBAAEH;YAAU,IACZE,kBAAAA,WAAWQ,GAAG,YAAdR,kBAAkBA,WAAWG,IAAI,EACjCM,OAAOd;YAGT,OAAOL,+BACLE,cAAckB,kBAAkB,CAAC;gBAAEC,QAAQ;gBAAUL;YAAI;QAE7D,GAAG"}

package/dist/adapters/entity-rest/build-entity-rest-adapter-delete/index.d.ts

@@ -0,0 +1,2 @@
+export * from './build-entity-rest-adapter-delete.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/entity-rest/build-entity-rest-adapter-delete/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/adapters/entity-rest/build-entity-rest-adapter-delete/index.ts"],"names":[],"mappings":"AAAA,cAAc,uCAAuC,CAAC"}

package/dist/adapters/entity-rest/build-entity-rest-adapter-delete/index.js

@@ -0,0 +1,3 @@
+export * from './build-entity-rest-adapter-delete.js';
+
+//# sourceMappingURL=index.js.map

package/dist/adapters/entity-rest/build-entity-rest-adapter-delete/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/adapters/entity-rest/build-entity-rest-adapter-delete/index.ts"],"sourcesContent":["export * from './build-entity-rest-adapter-delete.js';\n"],"names":[],"mappings":"AAAA,cAAc,wCAAwC"}

package/dist/adapters/entity-rest/build-entity-rest-adapter-get/build-entity-rest-adapter-get.d.ts

@@ -0,0 +1,6 @@
+import { ConfigurationRepositoryTag } from '@entifix/business';
+import { Entity, EntityConstructor } from '@entifix/core';
+import { Effect } from 'effect';
+import { BuildEntityRestOptions } from '../types.js';
+export declare const buildEntityRestAdapterGet: <TEntity extends Entity>(entityConstructor: EntityConstructor<TEntity>, { uriConfig }: BuildEntityRestOptions) => <TEntity_1 extends Entity>(entityId: string) => Effect.Effect<TEntity_1, import("@entifix/core").EntifixBuildError | import("@entifix/core").EntifixConnError, ConfigurationRepositoryTag>;
+//# sourceMappingURL=build-entity-rest-adapter-get.d.ts.map

package/dist/adapters/entity-rest/build-entity-rest-adapter-get/build-entity-rest-adapter-get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-entity-rest-adapter-get.d.ts","sourceRoot":"","sources":["../../../../src/adapters/entity-rest/build-entity-rest-adapter-get/build-entity-rest-adapter-get.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EACL,MAAM,EACN,iBAAiB,EAGlB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD,eAAO,MAAM,yBAAyB,GACnC,OAAO,SAAS,MAAM,EACrB,mBAAmB,iBAAiB,CAAC,OAAO,CAAC,EAC7C,eAAe,sBAAsB,MAEtC,SAAO,SAAS,MAAM,EAAE,UAAU,MAAM,+IAqBrC,CAAC"}

package/dist/adapters/entity-rest/build-entity-rest-adapter-get/build-entity-rest-adapter-get.js

@@ -0,0 +1,21 @@
+import { ConfigurationRepositoryTag } from '@entifix/business';
+import { extractMetaEntity, readEntityEnvelope } from '@entifix/core';
+import { Effect } from 'effect';
+import { performHttpRequestThroughFetch } from '../../../clients/fetch/index.js';
+import { buildEntityRestAdapterMixins as adapterMixins } from '../build-entity-rest-adapter-mixins/index.js';
+export const buildEntityRestAdapterGet = (entityConstructor, { uriConfig })=>(entityId)=>Effect.gen(function*() {
+            var _metaEntity_key;
+            const configurationStore = yield* ConfigurationRepositoryTag;
+            const metaEntity = extractMetaEntity(entityConstructor);
+            const entityUrl = yield* adapterMixins.buildEntityBaseUrl(configurationStore, {
+                uriConfig
+            }, (_metaEntity_key = metaEntity.key) != null ? _metaEntity_key : metaEntity.name, entityId);
+            const response = yield* performHttpRequestThroughFetch(adapterMixins.buildEntityRequest({
+                method: 'GET',
+                url: entityUrl
+            }));
+            const entity = yield* readEntityEnvelope(entityConstructor, response.body);
+            return entity;
+        });
+
+//# sourceMappingURL=build-entity-rest-adapter-get.js.map

package/dist/adapters/entity-rest/build-entity-rest-adapter-get/build-entity-rest-adapter-get.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/adapters/entity-rest/build-entity-rest-adapter-get/build-entity-rest-adapter-get.ts"],"sourcesContent":["import { ConfigurationRepositoryTag } from '@entifix/business';\nimport {\n  Entity,\n  EntityConstructor,\n  extractMetaEntity,\n  readEntityEnvelope,\n} from '@entifix/core';\nimport { Effect } from 'effect';\n\nimport { performHttpRequestThroughFetch } from '../../../clients/fetch/index.js';\nimport { buildEntityRestAdapterMixins as adapterMixins } from '../build-entity-rest-adapter-mixins/index.js';\nimport { BuildEntityRestOptions } from '../types.js';\n\nexport const buildEntityRestAdapterGet =\n  <TEntity extends Entity>(\n    entityConstructor: EntityConstructor<TEntity>,\n    { uriConfig }: BuildEntityRestOptions,\n  ) =>\n  <TEntity extends Entity>(entityId: string) =>\n    Effect.gen(function* () {\n      const configurationStore = yield* ConfigurationRepositoryTag;\n      const metaEntity = extractMetaEntity(entityConstructor);\n\n      const entityUrl = yield* adapterMixins.buildEntityBaseUrl(\n        configurationStore,\n        { uriConfig },\n        metaEntity.key ?? metaEntity.name,\n        entityId,\n      );\n\n      const response = yield* performHttpRequestThroughFetch(\n        adapterMixins.buildEntityRequest({ method: 'GET', url: entityUrl }),\n      );\n      const entity = yield* readEntityEnvelope(\n        entityConstructor,\n        response.body,\n      );\n\n      return entity as unknown as TEntity;\n    });\n"],"names":["ConfigurationRepositoryTag","extractMetaEntity","readEntityEnvelope","Effect","performHttpRequestThroughFetch","buildEntityRestAdapterMixins","adapterMixins","buildEntityRestAdapterGet","entityConstructor","uriConfig","entityId","gen","metaEntity","configurationStore","entityUrl","buildEntityBaseUrl","key","name","response","buildEntityRequest","method","url","entity","body"],"mappings":"AAAA,SAASA,0BAA0B,QAAQ,oBAAoB;AAC/D,SAGEC,iBAAiB,EACjBC,kBAAkB,QACb,gBAAgB;AACvB,SAASC,MAAM,QAAQ,SAAS;AAEhC,SAASC,8BAA8B,QAAQ,kCAAkC;AACjF,SAASC,gCAAgCC,aAAa,QAAQ,+CAA+C;AAG7G,OAAO,MAAMC,4BACX,CACEC,mBACA,EAAEC,SAAS,EAA0B,GAEvC,CAAyBC,WACvBP,OAAOQ,GAAG,CAAC;gBAOPC;YANF,MAAMC,qBAAqB,OAAOb;YAClC,MAAMY,aAAaX,kBAAkBO;YAErC,MAAMM,YAAY,OAAOR,cAAcS,kBAAkB,CACvDF,oBACA;gBAAEJ;YAAU,IACZG,kBAAAA,WAAWI,GAAG,YAAdJ,kBAAkBA,WAAWK,IAAI,EACjCP;YAGF,MAAMQ,WAAW,OAAOd,+BACtBE,cAAca,kBAAkB,CAAC;gBAAEC,QAAQ;gBAAOC,KAAKP;YAAU;YAEnE,MAAMQ,SAAS,OAAOpB,mBACpBM,mBACAU,SAASK,IAAI;YAGf,OAAOD;QACT,GAAG"}

package/dist/adapters/entity-rest/build-entity-rest-adapter-get/index.d.ts

@@ -0,0 +1,2 @@
+export * from './build-entity-rest-adapter-get.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/entity-rest/build-entity-rest-adapter-get/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/adapters/entity-rest/build-entity-rest-adapter-get/index.ts"],"names":[],"mappings":"AAAA,cAAc,oCAAoC,CAAC"}

package/dist/adapters/entity-rest/build-entity-rest-adapter-get/index.js

@@ -0,0 +1,3 @@
+export * from './build-entity-rest-adapter-get.js';
+
+//# sourceMappingURL=index.js.map

package/dist/adapters/entity-rest/build-entity-rest-adapter-get/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/adapters/entity-rest/build-entity-rest-adapter-get/index.ts"],"sourcesContent":["export * from './build-entity-rest-adapter-get.js';\n"],"names":[],"mappings":"AAAA,cAAc,qCAAqC"}

package/dist/adapters/entity-rest/build-entity-rest-adapter-load/build-entity-rest-adapter-load.d.ts

@@ -0,0 +1,6 @@
+import { ConfigurationRepositoryTag } from '@entifix/business';
+import { Entity, EntityConstructor, EntityLoadRequest, EntityPage } from '@entifix/core';
+import { Effect } from 'effect';
+import { BuildEntityRestOptions } from '../types.js';
+export declare const buildEntityRestAdapterLoad: <TEntity extends Entity>(entityConstructor: EntityConstructor<TEntity>, { uriConfig }: BuildEntityRestOptions) => <TEntity_1 extends Entity>(request: EntityLoadRequest<TEntity_1>) => Effect.Effect<EntityPage<TEntity_1>, import("@entifix/core").EntifixBuildError | import("@entifix/core").EntifixConnError, ConfigurationRepositoryTag>;
+//# sourceMappingURL=build-entity-rest-adapter-load.d.ts.map

package/dist/adapters/entity-rest/build-entity-rest-adapter-load/build-entity-rest-adapter-load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-entity-rest-adapter-load.d.ts","sourceRoot":"","sources":["../../../../src/adapters/entity-rest/build-entity-rest-adapter-load/build-entity-rest-adapter-load.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EACL,MAAM,EACN,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EAIX,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD,eAAO,MAAM,0BAA0B,GACpC,OAAO,SAAS,MAAM,EACrB,mBAAmB,iBAAiB,CAAC,OAAO,CAAC,EAC7C,eAAe,sBAAsB,MAEtC,SAAO,SAAS,MAAM,EAAE,SAAS,iBAAiB,CAAC,SAAO,CAAC,2JA+BxD,CAAC"}

package/dist/adapters/entity-rest/build-entity-rest-adapter-load/build-entity-rest-adapter-load.js

@@ -0,0 +1,31 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { ConfigurationRepositoryTag } from '@entifix/business';
+import { extractMetaEntity, readEntityPageEnvelope, serializeLoadRequestParams } from '@entifix/core';
+import { Effect } from 'effect';
+import { performHttpRequestThroughFetch } from '../../../clients/fetch/index.js';
+import { buildEntityRestAdapterMixins as adapterMixins } from '../build-entity-rest-adapter-mixins/index.js';
+export const buildEntityRestAdapterLoad = (entityConstructor, { uriConfig })=>(request)=>Effect.gen(function*() {
+            var _metaEntity_key;
+            const configurationStore = yield* ConfigurationRepositoryTag;
+            const metaEntity = extractMetaEntity(entityConstructor);
+            const baseUrl = yield* adapterMixins.buildEntityBaseUrl(configurationStore, {
+                uriConfig
+            }, (_metaEntity_key = metaEntity.key) != null ? _metaEntity_key : metaEntity.name);
+            // Filtering goes out as RSQL and sorting as `sort` — the shared query
+            // protocol in core, so what this composes is exactly what the service
+            // parses back.
+            const query = serializeLoadRequestParams(request).toString();
+            const url = query ? `${baseUrl}?${query}` : baseUrl;
+            const response = yield* performHttpRequestThroughFetch(adapterMixins.buildEntityRequest({
+                method: 'GET',
+                url
+            }));
+            const page = yield* readEntityPageEnvelope(entityConstructor, response.body);
+            // The envelope echoes the request the service actually served; prefer the
+            // one this call made, which carries the caller's filtering/sorting types.
+            return _extends({}, page, {
+                request
+            });
+        });
+
+//# sourceMappingURL=build-entity-rest-adapter-load.js.map

package/dist/adapters/entity-rest/build-entity-rest-adapter-load/build-entity-rest-adapter-load.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/adapters/entity-rest/build-entity-rest-adapter-load/build-entity-rest-adapter-load.ts"],"sourcesContent":["import { ConfigurationRepositoryTag } from '@entifix/business';\nimport {\n  Entity,\n  EntityConstructor,\n  EntityLoadRequest,\n  EntityPage,\n  extractMetaEntity,\n  readEntityPageEnvelope,\n  serializeLoadRequestParams,\n} from '@entifix/core';\nimport { Effect } from 'effect';\n\nimport { performHttpRequestThroughFetch } from '../../../clients/fetch/index.js';\nimport { buildEntityRestAdapterMixins as adapterMixins } from '../build-entity-rest-adapter-mixins/index.js';\nimport { BuildEntityRestOptions } from '../types.js';\n\nexport const buildEntityRestAdapterLoad =\n  <TEntity extends Entity>(\n    entityConstructor: EntityConstructor<TEntity>,\n    { uriConfig }: BuildEntityRestOptions,\n  ) =>\n  <TEntity extends Entity>(request: EntityLoadRequest<TEntity>) =>\n    Effect.gen(function* () {\n      const configurationStore = yield* ConfigurationRepositoryTag;\n      const metaEntity = extractMetaEntity(entityConstructor);\n\n      const baseUrl = yield* adapterMixins.buildEntityBaseUrl(\n        configurationStore,\n        { uriConfig },\n        metaEntity.key ?? metaEntity.name,\n      );\n\n      // Filtering goes out as RSQL and sorting as `sort` — the shared query\n      // protocol in core, so what this composes is exactly what the service\n      // parses back.\n      const query = serializeLoadRequestParams(request).toString();\n      const url = query ? `${baseUrl}?${query}` : baseUrl;\n\n      const response = yield* performHttpRequestThroughFetch(\n        adapterMixins.buildEntityRequest({ method: 'GET', url }),\n      );\n      const page = yield* readEntityPageEnvelope(\n        entityConstructor,\n        response.body,\n      );\n\n      // The envelope echoes the request the service actually served; prefer the\n      // one this call made, which carries the caller's filtering/sorting types.\n      return {\n        ...page,\n        request,\n      } as unknown as EntityPage<TEntity>;\n    });\n"],"names":["ConfigurationRepositoryTag","extractMetaEntity","readEntityPageEnvelope","serializeLoadRequestParams","Effect","performHttpRequestThroughFetch","buildEntityRestAdapterMixins","adapterMixins","buildEntityRestAdapterLoad","entityConstructor","uriConfig","request","gen","metaEntity","configurationStore","baseUrl","buildEntityBaseUrl","key","name","query","toString","url","response","buildEntityRequest","method","page","body"],"mappings":";AAAA,SAASA,0BAA0B,QAAQ,oBAAoB;AAC/D,SAKEC,iBAAiB,EACjBC,sBAAsB,EACtBC,0BAA0B,QACrB,gBAAgB;AACvB,SAASC,MAAM,QAAQ,SAAS;AAEhC,SAASC,8BAA8B,QAAQ,kCAAkC;AACjF,SAASC,gCAAgCC,aAAa,QAAQ,+CAA+C;AAG7G,OAAO,MAAMC,6BACX,CACEC,mBACA,EAAEC,SAAS,EAA0B,GAEvC,CAAyBC,UACvBP,OAAOQ,GAAG,CAAC;gBAOPC;YANF,MAAMC,qBAAqB,OAAOd;YAClC,MAAMa,aAAaZ,kBAAkBQ;YAErC,MAAMM,UAAU,OAAOR,cAAcS,kBAAkB,CACrDF,oBACA;gBAAEJ;YAAU,IACZG,kBAAAA,WAAWI,GAAG,YAAdJ,kBAAkBA,WAAWK,IAAI;YAGnC,sEAAsE;YACtE,sEAAsE;YACtE,eAAe;YACf,MAAMC,QAAQhB,2BAA2BQ,SAASS,QAAQ;YAC1D,MAAMC,MAAMF,QAAQ,GAAGJ,QAAQ,CAAC,EAAEI,OAAO,GAAGJ;YAE5C,MAAMO,WAAW,OAAOjB,+BACtBE,cAAcgB,kBAAkB,CAAC;gBAAEC,QAAQ;gBAAOH;YAAI;YAExD,MAAMI,OAAO,OAAOvB,uBAClBO,mBACAa,SAASI,IAAI;YAGf,0EAA0E;YAC1E,0EAA0E;YAC1E,OAAO,aACFD;gBACHd;;QAEJ,GAAG"}

package/dist/adapters/entity-rest/build-entity-rest-adapter-load/index.d.ts

@@ -0,0 +1,2 @@
+export * from './build-entity-rest-adapter-load.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/entity-rest/build-entity-rest-adapter-load/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/adapters/entity-rest/build-entity-rest-adapter-load/index.ts"],"names":[],"mappings":"AAAA,cAAc,qCAAqC,CAAC"}

package/dist/adapters/entity-rest/build-entity-rest-adapter-load/index.js

@@ -0,0 +1,3 @@
+export * from './build-entity-rest-adapter-load.js';
+
+//# sourceMappingURL=index.js.map

package/dist/adapters/entity-rest/build-entity-rest-adapter-load/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/adapters/entity-rest/build-entity-rest-adapter-load/index.ts"],"sourcesContent":["export * from './build-entity-rest-adapter-load.js';\n"],"names":[],"mappings":"AAAA,cAAc,sCAAsC"}

package/dist/adapters/entity-rest/build-entity-rest-adapter-mixins/build-entity-base-url.d.ts

@@ -0,0 +1,5 @@
+import { ConfigurationClient } from '@entifix/core';
+import { Effect } from 'effect';
+import { BuildEntityRestOptions } from '../types.js';
+export declare const buildEntityBaseUrl: (configurationStore: ConfigurationClient, options: BuildEntityRestOptions, entityName: string, entityId?: string) => Effect.Effect<string, import("@entifix/core").EntifixBuildError, never>;
+//# sourceMappingURL=build-entity-base-url.d.ts.map

package/dist/adapters/entity-rest/build-entity-rest-adapter-mixins/build-entity-base-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-entity-base-url.d.ts","sourceRoot":"","sources":["../../../../src/adapters/entity-rest/build-entity-rest-adapter-mixins/build-entity-base-url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAIrD,eAAO,MAAM,kBAAkB,GAC7B,oBAAoB,mBAAmB,EACvC,SAAS,sBAAsB,EAC/B,YAAY,MAAM,EAClB,WAAW,MAAM,4EAYf,CAAC"}

package/dist/adapters/entity-rest/build-entity-rest-adapter-mixins/build-entity-base-url.js

@@ -0,0 +1,10 @@
+import { Effect } from 'effect';
+const DEFAULT_URI_GROUP = 'restUri';
+export const buildEntityBaseUrl = (configurationStore, options, entityName, entityId)=>Effect.gen(function*() {
+        var _uriConfig_group;
+        const { uriConfig } = options;
+        const entityUri = yield* configurationStore.in((_uriConfig_group = uriConfig.group) != null ? _uriConfig_group : DEFAULT_URI_GROUP).getString(uriConfig.key.replace('[entity]', entityName), uriConfig.extractionMode);
+        return entityId ? `${entityUri}/${entityId}` : entityUri;
+    });
+
+//# sourceMappingURL=build-entity-base-url.js.map

package/dist/adapters/entity-rest/build-entity-rest-adapter-mixins/build-entity-base-url.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/adapters/entity-rest/build-entity-rest-adapter-mixins/build-entity-base-url.ts"],"sourcesContent":["import { ConfigurationClient } from '@entifix/core';\nimport { Effect } from 'effect';\n\nimport { BuildEntityRestOptions } from '../types.js';\n\nconst DEFAULT_URI_GROUP = 'restUri';\n\nexport const buildEntityBaseUrl = (\n  configurationStore: ConfigurationClient,\n  options: BuildEntityRestOptions,\n  entityName: string,\n  entityId?: string,\n) =>\n  Effect.gen(function* () {\n    const { uriConfig } = options;\n    const entityUri = yield* configurationStore\n      .in(uriConfig.group ?? DEFAULT_URI_GROUP)\n      .getString(\n        uriConfig.key.replace('[entity]', entityName),\n        uriConfig.extractionMode,\n      );\n\n    return entityId ? `${entityUri}/${entityId}` : entityUri;\n  });\n"],"names":["Effect","DEFAULT_URI_GROUP","buildEntityBaseUrl","configurationStore","options","entityName","entityId","gen","uriConfig","entityUri","in","group","getString","key","replace","extractionMode"],"mappings":"AACA,SAASA,MAAM,QAAQ,SAAS;AAIhC,MAAMC,oBAAoB;AAE1B,OAAO,MAAMC,qBAAqB,CAChCC,oBACAC,SACAC,YACAC,WAEAN,OAAOO,GAAG,CAAC;YAGHC;QAFN,MAAM,EAAEA,SAAS,EAAE,GAAGJ;QACtB,MAAMK,YAAY,OAAON,mBACtBO,EAAE,EAACF,mBAAAA,UAAUG,KAAK,YAAfH,mBAAmBP,mBACtBW,SAAS,CACRJ,UAAUK,GAAG,CAACC,OAAO,CAAC,YAAYT,aAClCG,UAAUO,cAAc;QAG5B,OAAOT,WAAW,GAAGG,UAAU,CAAC,EAAEH,UAAU,GAAGG;IACjD,GAAG"}

package/dist/adapters/entity-rest/build-entity-rest-adapter-mixins/build-entity-request.d.ts

@@ -0,0 +1,19 @@
+import type { EntifixEnvelope } from '@entifix/core';
+import { HttpMethod, HttpRequest } from '../../../clients/types.js';
+export interface BuildEntityRequestOptions {
+    method: HttpMethod;
+    url: string;
+    /**
+     * The body, already wrapped as an envelope — every entifix message is one.
+     * Omitted for reads and deletes, which carry no payload.
+     */
+    envelope?: EntifixEnvelope<unknown>;
+}
+/**
+ * Assembles the {@link HttpRequest} the fetch client executes. Centralized so
+ * the read and write adapters agree on how a message is framed — notably that a
+ * body is always an {@link EntifixEnvelope}, and that the JSON content type is
+ * declared only when there is one to declare.
+ */
+export declare const buildEntityRequest: ({ method, url, envelope, }: BuildEntityRequestOptions) => HttpRequest<EntifixEnvelope<unknown>>;
+//# sourceMappingURL=build-entity-request.d.ts.map

package/dist/adapters/entity-rest/build-entity-rest-adapter-mixins/build-entity-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-entity-request.d.ts","sourceRoot":"","sources":["../../../../src/adapters/entity-rest/build-entity-rest-adapter-mixins/build-entity-request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAEpE,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,UAAU,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;CACrC;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,4BAIhC,yBAAyB,KAAG,WAAW,CAAC,eAAe,CAAC,OAAO,CAAC,CAMjE,CAAC"}

package/dist/adapters/entity-rest/build-entity-rest-adapter-mixins/build-entity-request.js

@@ -0,0 +1,17 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * Assembles the {@link HttpRequest} the fetch client executes. Centralized so
+ * the read and write adapters agree on how a message is framed — notably that a
+ * body is always an {@link EntifixEnvelope}, and that the JSON content type is
+ * declared only when there is one to declare.
+ */ export const buildEntityRequest = ({ method, url, envelope })=>_extends({
+        method,
+        url
+    }, envelope ? {
+        headers: {
+            'Content-Type': 'application/json'
+        },
+        body: envelope
+    } : {});
+
+//# sourceMappingURL=build-entity-request.js.map

package/dist/adapters/entity-rest/build-entity-rest-adapter-mixins/build-entity-request.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/adapters/entity-rest/build-entity-rest-adapter-mixins/build-entity-request.ts"],"sourcesContent":["import type { EntifixEnvelope } from '@entifix/core';\n\nimport { HttpMethod, HttpRequest } from '../../../clients/types.js';\n\nexport interface BuildEntityRequestOptions {\n  method: HttpMethod;\n  url: string;\n  /**\n   * The body, already wrapped as an envelope — every entifix message is one.\n   * Omitted for reads and deletes, which carry no payload.\n   */\n  envelope?: EntifixEnvelope<unknown>;\n}\n\n/**\n * Assembles the {@link HttpRequest} the fetch client executes. Centralized so\n * the read and write adapters agree on how a message is framed — notably that a\n * body is always an {@link EntifixEnvelope}, and that the JSON content type is\n * declared only when there is one to declare.\n */\nexport const buildEntityRequest = ({\n  method,\n  url,\n  envelope,\n}: BuildEntityRequestOptions): HttpRequest<EntifixEnvelope<unknown>> => ({\n  method,\n  url,\n  ...(envelope\n    ? { headers: { 'Content-Type': 'application/json' }, body: envelope }\n    : {}),\n});\n"],"names":["buildEntityRequest","method","url","envelope","headers","body"],"mappings":";AAcA;;;;;CAKC,GACD,OAAO,MAAMA,qBAAqB,CAAC,EACjCC,MAAM,EACNC,GAAG,EACHC,QAAQ,EACkB,GAA6C;QACvEF;QACAC;OACIC,WACA;QAAEC,SAAS;YAAE,gBAAgB;QAAmB;QAAGC,MAAMF;IAAS,IAClE,CAAC,GACJ"}

package/dist/adapters/entity-rest/build-entity-rest-adapter-mixins/index.d.ts

@@ -0,0 +1,5 @@
+export declare const buildEntityRestAdapterMixins: {
+    buildEntityBaseUrl: (configurationStore: import("@entifix/core").ConfigurationClient, options: import("../types.js").BuildEntityRestOptions, entityName: string, entityId?: string) => import("effect/Effect").Effect<string, import("@entifix/core").EntifixBuildError, never>;
+    buildEntityRequest: ({ method, url, envelope, }: import("./build-entity-request.js").BuildEntityRequestOptions) => import("../../../index.js").HttpRequest<import("@entifix/core").EntifixEnvelope<unknown>>;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/entity-rest/build-entity-rest-adapter-mixins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/adapters/entity-rest/build-entity-rest-adapter-mixins/index.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,4BAA4B;;;CAGxC,CAAC"}

package/dist/adapters/entity-rest/build-entity-rest-adapter-mixins/index.js

@@ -0,0 +1,8 @@
+import { buildEntityBaseUrl } from './build-entity-base-url.js';
+import { buildEntityRequest } from './build-entity-request.js';
+export const buildEntityRestAdapterMixins = {
+    buildEntityBaseUrl,
+    buildEntityRequest
+};
+
+//# sourceMappingURL=index.js.map

package/dist/adapters/entity-rest/build-entity-rest-adapter-mixins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/adapters/entity-rest/build-entity-rest-adapter-mixins/index.ts"],"sourcesContent":["import { buildEntityBaseUrl } from './build-entity-base-url.js';\nimport { buildEntityRequest } from './build-entity-request.js';\n\nexport const buildEntityRestAdapterMixins = {\n  buildEntityBaseUrl,\n  buildEntityRequest,\n};\n"],"names":["buildEntityBaseUrl","buildEntityRequest","buildEntityRestAdapterMixins"],"mappings":"AAAA,SAASA,kBAAkB,QAAQ,6BAA6B;AAChE,SAASC,kBAAkB,QAAQ,4BAA4B;AAE/D,OAAO,MAAMC,+BAA+B;IAC1CF;IACAC;AACF,EAAE"}

package/dist/adapters/entity-rest/build-entity-rest-adapter-save/build-entity-rest-adapter-save.d.ts

@@ -0,0 +1,25 @@
+import { ConfigurationRepositoryTag } from '@entifix/business';
+import { Entity, EntityConstructor } from '@entifix/core';
+import { Effect } from 'effect';
+import { BuildEntityRestOptions } from '../types.js';
+/**
+ * Persists an entity over HTTP.
+ *
+ * An entity without an id has never been stored, so it is created with `POST`
+ * against the collection; one with an id is replaced with `PUT` against its own
+ * URL.
+ *
+ * For a plain create the response envelope — not the request — is what gets
+ * deserialized and returned, because the service is the authority on the stored
+ * entity (it assigns ids and may normalize fields).
+ *
+ * A **transactional** create inverts that, and deliberately. The service answers
+ * `202` describing a transaction rather than an entity, so there is no stored
+ * entity to read back yet: the client mints the transaction id, which *is* the
+ * id the entity will be stored under, and returns the entity it already holds.
+ * That is the point of the client owning the id (ADR 0028) — before it, this
+ * adapter parsed the `202` as an entity envelope, failed, and reported an error
+ * for a create that was in fact about to succeed.
+ */
+export declare const buildEntityRestAdapterSave: <TEntity extends Entity>(entityConstructor: EntityConstructor<TEntity>, { uriConfig, create }: BuildEntityRestOptions) => <TInput extends Entity>(entity: TInput) => Effect.Effect<TInput, import("@entifix/core").EntifixError, ConfigurationRepositoryTag>;
+//# sourceMappingURL=build-entity-rest-adapter-save.d.ts.map

package/dist/adapters/entity-rest/build-entity-rest-adapter-save/build-entity-rest-adapter-save.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-entity-rest-adapter-save.d.ts","sourceRoot":"","sources":["../../../../src/adapters/entity-rest/build-entity-rest-adapter-save/build-entity-rest-adapter-save.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EACL,MAAM,EACN,iBAAiB,EAKlB,MAAM,eAAe,CAAC;AAOvB,OAAO,EAAE,MAAM,EAAU,MAAM,QAAQ,CAAC;AAIxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,0BAA0B,GACpC,OAAO,SAAS,MAAM,EACrB,mBAAmB,iBAAiB,CAAC,OAAO,CAAC,EAC7C,uBAAkC,sBAAsB,MAKzD,MAAM,SAAS,MAAM,EAAE,QAAQ,MAAM,4FAkFlC,CAAC"}

package/dist/adapters/entity-rest/build-entity-rest-adapter-save/build-entity-rest-adapter-save.js

@@ -0,0 +1,92 @@
+import { ConfigurationRepositoryTag } from '@entifix/business';
+import { extractMetaEntity, makeEntityEnvelope, readEntityEnvelope, serializeEntity } from '@entifix/core';
+import { makeCommandEnvelope, readTransactionAcceptedEnvelope, TransactionSinkTag } from '@entifix/transactions';
+import { Effect, Option } from 'effect';
+import { performHttpRequestThroughFetch } from '../../../clients/fetch/index.js';
+import { buildEntityRestAdapterMixins as adapterMixins } from '../build-entity-rest-adapter-mixins/index.js';
+/**
+ * Persists an entity over HTTP.
+ *
+ * An entity without an id has never been stored, so it is created with `POST`
+ * against the collection; one with an id is replaced with `PUT` against its own
+ * URL.
+ *
+ * For a plain create the response envelope — not the request — is what gets
+ * deserialized and returned, because the service is the authority on the stored
+ * entity (it assigns ids and may normalize fields).
+ *
+ * A **transactional** create inverts that, and deliberately. The service answers
+ * `202` describing a transaction rather than an entity, so there is no stored
+ * entity to read back yet: the client mints the transaction id, which *is* the
+ * id the entity will be stored under, and returns the entity it already holds.
+ * That is the point of the client owning the id (ADR 0028) — before it, this
+ * adapter parsed the `202` as an entity envelope, failed, and reported an error
+ * for a create that was in fact about to succeed.
+ */ export const buildEntityRestAdapterSave = (entityConstructor, { uriConfig, create = 'entity' })=>// Deliberately not shadowing `TEntity` here (as the read builders do): the
+    // envelope has to be built against the *constructor's* entity type, which a
+    // shadowed parameter would make unreachable.
+    (entity)=>Effect.gen(function*() {
+            var _metaEntity_key;
+            const configurationStore = yield* ConfigurationRepositoryTag;
+            const metaEntity = extractMetaEntity(entityConstructor);
+            const key = (_metaEntity_key = metaEntity.key) != null ? _metaEntity_key : metaEntity.name;
+            const isCreate = entity.id == null;
+            const url = yield* adapterMixins.buildEntityBaseUrl(configurationStore, {
+                uriConfig
+            }, key, isCreate ? undefined : String(entity.id));
+            if (isCreate && create === 'command') {
+                // `crypto.randomUUID` is available in every browser this ships to and in
+                // Node — and the id must be a UUID, because the service constrains the
+                // key space a caller may address.
+                const transactionId = crypto.randomUUID();
+                entity.id = transactionId;
+                const command = {
+                    transactionId,
+                    type: 'create',
+                    entity: key,
+                    payload: serializeEntity(entityConstructor, entity)
+                };
+                const accepted = yield* performHttpRequestThroughFetch(adapterMixins.buildEntityRequest({
+                    method: 'POST',
+                    url,
+                    envelope: makeCommandEnvelope(command)
+                }));
+                // Read for its shape, not its contents: this asserts the service really
+                // accepted a transaction rather than answering something else with a
+                // 2xx, which is the failure the old code path could not distinguish.
+                yield* readTransactionAcceptedEnvelope(accepted.body);
+                // Tell whoever is watching that a write is in flight. This is the only
+                // point in the system that knows it — the entity returned below is
+                // indistinguishable from a plain REST create, so without this the
+                // browser navigates away at the `202` and a later failure leaves no row,
+                // no message and nothing to retry from (ADR 0043).
+                //
+                // `serviceOption`, deliberately: reading the tag this way keeps it out
+                // of this function's `R`, so the storefront, the plain REST adapters and
+                // every existing spec compile and run with no layer to provide. The cost
+                // is that nothing *forces* a composition root to provide it, which is
+                // why `mergeContext` has a spec pinning that it does.
+                const sink = yield* Effect.serviceOption(TransactionSinkTag);
+                if (Option.isSome(sink)) {
+                    // After the assertion above, never before: a `2xx` that is not a
+                    // transaction envelope must not register a pending id, because nothing
+                    // would ever settle it and the entry becomes a permanent phantom.
+                    sink.value.began({
+                        transactionId,
+                        entity: key,
+                        at: new Date().toISOString()
+                    });
+                }
+                return entity;
+            }
+            const httpRequest = adapterMixins.buildEntityRequest({
+                method: isCreate ? 'POST' : 'PUT',
+                url,
+                envelope: makeEntityEnvelope(entityConstructor, entity)
+            });
+            const response = yield* performHttpRequestThroughFetch(httpRequest);
+            const saved = yield* readEntityEnvelope(entityConstructor, response.body);
+            return saved;
+        });
+
+//# sourceMappingURL=build-entity-rest-adapter-save.js.map