@ontahi/react 1.0.0-alpha.10 → 1.0.0-alpha.12

package/dist/graph/fetch-graph-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-graph-client.d.ts","sourceRoot":"","sources":["../../src/graph/fetch-graph-client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,yBAAyB,EAEzB,gCAAgC,EAEhC,yBAAyB,EACzB,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,OAAO,EAGL,KAAK,yBAAyB,EAC9B,KAAK,2BAA2B,EACjC,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAEpF,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,8BAA8B,CAAC;AAEtC,MAAM,MAAM,qCAAqC,GAAG;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,4CAA4C,GAAG,qCAAqC,CAAC;AAEjG,MAAM,MAAM,iBAAiB,CAAC,YAAY,GAAG,OAAO,EAAE,eAAe,GAAG,YAAY,IAAI;IACtF,KAAK,CAAC,EAAE,wBAAwB,CAC9B,oBAAoB,EACpB,YAAY,EACZ,eAAe,EACf,oBAAoB,CACrB,CAAC;IACF,aAAa,CAAC,EAAE,kBAAkB,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;IAClE,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,uBAAuB,CAAC,EAAE,yBAAyB,EAAE,CAAC;IACtD,yBAAyB,CAAC,EAAE,yBAAyB,CAAC;IACtD,gCAAgC,CAAC,EAAE,gCAAgC,CAAC;IACpE,yBAAyB,CAAC,EAAE,yBAAyB,CAAC;CACvD,CAAC;AAEF,MAAM,MAAM,gBAAgB,CAAC,QAAQ,GAAG,SAAS,IAAI,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG;IAC3F,KAAK,EAAE,wBAAwB,CAAC,oBAAoB,EAAE,QAAQ,EAAE,QAAQ,EAAE,oBAAoB,CAAC,CAAC;IAChG,aAAa,EAAE,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;CACvD,CAAC;AAEF,MAAM,MAAM,uBAAuB,CAAC,QAAQ,GAAG,SAAS,IAAI;IAC1D,SAAS,CAAC,EAAE,KAAK,GAAG,6BAA6B,CAAC,QAAQ,CAAC,CAAC;IAC5D,UAAU,CAAC,EAAE,KAAK,GAAG,2BAA2B,CAAC;IACjD,gBAAgB,CAAC,EAAE,KAAK,GAAG,4BAA4B,CAAC;IACxD,mBAAmB,CAAC,EAAE,KAAK,GAAG,qCAAqC,CAAC;IACpE,0BAA0B,CAAC,EAAE,KAAK,GAAG,4CAA4C,CAAC;CACnF,CAAC;AAqCF,eAAO,MAAM,oCAAoC,GAAI,qCAGlD,qCAA0C,KAAG,yBAE9C,CAAC;AAEH,eAAO,MAAM,2CAA2C,GAAI,qCAGzD,4CAAiD,KAAG,gCAErD,CAAC;AAEH,wBAAgB,sBAAsB,CAAC,QAAQ,GAAG,SAAS,KAAK,gBAAgB,CAAC,QAAQ,CAAC,CAAC;AAC3F,wBAAgB,sBAAsB,CAAC,QAAQ,GAAG,SAAS,EACzD,OAAO,EAAE,uBAAuB,CAAC,QAAQ,CAAC,GAAG;IAAE,SAAS,EAAE,KAAK,CAAA;CAAE,GAChE,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACzC,wBAAgB,sBAAsB,CAAC,QAAQ,GAAG,SAAS,EACzD,OAAO,EAAE,uBAAuB,CAAC,QAAQ,CAAC,GAAG;IAC3C,SAAS,CAAC,EAAE,6BAA6B,CAAC,QAAQ,CAAC,CAAC;CACrD,GACA,gBAAgB,CAAC,QAAQ,CAAC,CAAC"}
+{"version":3,"file":"fetch-graph-client.d.ts","sourceRoot":"","sources":["../../src/graph/fetch-graph-client.ts"],"names":[],"mappings":"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"}

package/dist/graph/fetch-graph-client.js

@@ -1,9 +1,11 @@
 'use client';
-import { createRuntimeBoundDataGraphApi } from '@ontahi/core/data-graph';
+import { createGraphClientCache, createRuntimeBoundDataGraphApi } from '@ontahi/core/data-graph';
 import { createFetchOperationBridgeAdapter, createFetchReflectedOperationInvoker, } from '../actions/index.js';
 import { createFetchGraphReadCapability } from './fetch-graph-runtime.js';
 import { createFetchRuntimeTransport, } from './fetch-runtime-transport.js';
-const DEFAULT_OPERATIONS_ENDPOINT = '/operations';
+const DEFAULT_LEGACY_OPERATION_ENDPOINT = '/operations';
+const DEFAULT_LEGACY_GRAPH_READ_ENDPOINT = '/graph/reads';
+const DEFAULT_LEGACY_GRAPH_COMMAND_ENDPOINT = '/graph/commands';
 const DEFAULT_REFLECTED_ENTITY_DATA_ENDPOINT = '/explorer/entities';
 const DEFAULT_REFLECTED_RELATED_ENTITY_DATA_ENDPOINT = '/explorer/related-entities';
 const postReflectedEntityDataQuery = async (endpoint, query, fetchRequest) => {
@@ -18,35 +20,103 @@ const postReflectedEntityDataQuery = async (endpoint, query, fetchRequest) => {
     }
     return response.json();
 };
-const conventionalOperationOptions = (options) => options.mountPath === undefined
-    ? {
-        endpoint: DEFAULT_OPERATIONS_ENDPOINT,
-        ...options,
-    }
-    : options;
 export const createFetchReflectedEntityDataReader = ({ endpoint = DEFAULT_REFLECTED_ENTITY_DATA_ENDPOINT, fetch: fetchRequest = globalThis.fetch, } = {}) => ({
     readEntityData: query => postReflectedEntityDataQuery(endpoint, query, fetchRequest),
 });
 export const createFetchReflectedRelatedEntityDataReader = ({ endpoint = DEFAULT_REFLECTED_RELATED_ENTITY_DATA_ENDPOINT, fetch: fetchRequest = globalThis.fetch, } = {}) => ({
     readRelatedEntityData: query => postReflectedEntityDataQuery(endpoint, query, fetchRequest),
 });
-export function createFetchGraphClient({ graphRead = {}, operations = {}, runtimeTransport = {}, reflectedEntityData = {}, reflectedRelatedEntityData = {}, } = {}) {
-    const operationOptions = operations === false ? undefined : conventionalOperationOptions(operations);
-    const graphReadCapability = graphRead === false ? undefined : createFetchGraphReadCapability(graphRead);
+export function createFetchGraphClient({ compatibility = {}, graphRead = {}, operations = {}, runtimeTransport = {}, reflectedEntityData = {}, reflectedRelatedEntityData = {}, } = {}) {
+    const graphReadOptions = graphRead === false
+        ? undefined
+        : {
+            ...graphRead,
+            ...(compatibility.graphRead === undefined
+                ? {}
+                : {
+                    endpoint: compatibility.graphRead.endpoint ?? DEFAULT_LEGACY_GRAPH_READ_ENDPOINT,
+                }),
+            ...(compatibility.graphCommand === undefined
+                ? {}
+                : {
+                    commandEndpoint: compatibility.graphCommand.endpoint ?? DEFAULT_LEGACY_GRAPH_COMMAND_ENDPOINT,
+                }),
+        };
+    const clientCache = graphReadOptions ? createGraphClientCache() : undefined;
+    const operationOptions = (() => {
+        if (operations === false)
+            return undefined;
+        if (compatibility.operation === undefined)
+            return operations;
+        const { endpoint: _endpoint, mountPath: _mountPath, ...sharedOptions } = operations;
+        if (compatibility.operation.endpoint !== undefined) {
+            return { ...sharedOptions, endpoint: compatibility.operation.endpoint };
+        }
+        if (compatibility.operation.mountPath !== undefined) {
+            return { ...sharedOptions, mountPath: compatibility.operation.mountPath };
+        }
+        return { ...sharedOptions, endpoint: DEFAULT_LEGACY_OPERATION_ENDPOINT };
+    })();
+    const commonTransportRequired = (graphReadOptions !== undefined &&
+        (graphReadOptions.endpoint === undefined ||
+            graphReadOptions.commandEndpoint === undefined)) ||
+        (operationOptions !== undefined &&
+            operationOptions.endpoint === undefined &&
+            operationOptions.mountPath === undefined);
+    if (runtimeTransport === false && commonTransportRequired) {
+        throw new TypeError('runtimeTransport cannot be disabled while a common Runtime Protocol family is enabled.');
+    }
+    const requestId = runtimeTransport === false
+        ? undefined
+        : (runtimeTransport.requestId ?? graphReadOptions?.requestId ?? operationOptions?.requestId);
+    const runtimeTransportOptions = runtimeTransport === false
+        ? undefined
+        : {
+            ...(graphReadOptions?.fetch ? { fetch: graphReadOptions.fetch } : {}),
+            ...(graphReadOptions?.requestInit ? { requestInit: graphReadOptions.requestInit } : {}),
+            ...runtimeTransport,
+            requestId,
+        };
+    const resolvedRuntimeTransport = runtimeTransportOptions === undefined
+        ? undefined
+        : createFetchRuntimeTransport(runtimeTransportOptions);
+    const graphReadCapability = graphReadOptions === undefined
+        ? undefined
+        : createFetchGraphReadCapability({
+            ...graphReadOptions,
+            ...(runtimeTransportOptions?.fetch ? { fetch: runtimeTransportOptions.fetch } : {}),
+            ...(runtimeTransportOptions?.requestInit
+                ? { requestInit: runtimeTransportOptions.requestInit }
+                : {}),
+            ...(resolvedRuntimeTransport
+                ? { runtimeTransport: resolvedRuntimeTransport, requestId }
+                : {}),
+        });
+    const resolvedOperationOptions = operationOptions === undefined
+        ? undefined
+        : {
+            ...operationOptions,
+            ...(runtimeTransportOptions?.fetch ? { fetch: runtimeTransportOptions.fetch } : {}),
+            ...(runtimeTransportOptions?.requestInit
+                ? { requestInit: runtimeTransportOptions.requestInit }
+                : {}),
+            ...(resolvedRuntimeTransport
+                ? { runtimeTransport: resolvedRuntimeTransport, requestId }
+                : {}),
+        };
     return {
         ...(graphReadCapability
             ? {
                 graph: createRuntimeBoundDataGraphApi(() => graphReadCapability.runtime),
                 graphExecutor: graphReadCapability.graphExecutor,
+                clientCache: clientCache,
             }
             : {}),
-        ...(runtimeTransport === false
-            ? {}
-            : { runtimeTransport: createFetchRuntimeTransport(runtimeTransport) }),
-        ...(operationOptions
+        ...(resolvedRuntimeTransport ? { runtimeTransport: resolvedRuntimeTransport } : {}),
+        ...(resolvedOperationOptions
             ? {
-                operationBridgeAdapters: [createFetchOperationBridgeAdapter(operationOptions)],
-                reflectedOperationInvoker: createFetchReflectedOperationInvoker(operationOptions),
+                operationBridgeAdapters: [createFetchOperationBridgeAdapter(resolvedOperationOptions)],
+                reflectedOperationInvoker: createFetchReflectedOperationInvoker(resolvedOperationOptions),
             }
             : {}),
         ...(reflectedEntityData === false

package/dist/graph/fetch-graph-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-graph-client.js","sourceRoot":"","sources":["../../src/graph/fetch-graph-client.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAWb,OAAO,EAAE,8BAA8B,EAAE,MAAM,yBAAyB,CAAC;AAGzE,OAAO,EACL,iCAAiC,EACjC,oCAAoC,GAGrC,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,EACL,2BAA2B,GAE5B,MAAM,8BAA8B,CAAC;AAqCtC,MAAM,2BAA2B,GAAG,aAAa,CAAC;AAClD,MAAM,sCAAsC,GAAG,oBAAoB,CAAC;AACpE,MAAM,8CAA8C,GAAG,4BAA4B,CAAC;AAEpF,MAAM,4BAA4B,GAAG,KAAK,EACxC,QAAgB,EAChB,KAE8D,EAC9D,YAAqC,EACrC,EAAE;IACF,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,QAAQ,EAAE;QAC5C,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,WAAW,EAAE,aAAa;QAC1B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;KAC5B,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,oDAAoD,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1F,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,EAAwC,CAAC;AAC/D,CAAC,CAAC;AAEF,MAAM,4BAA4B,GAAG,CACnC,OAAoC,EACP,EAAE,CAC/B,OAAO,CAAC,SAAS,KAAK,SAAS;IAC7B,CAAC,CAAC;QACE,QAAQ,EAAE,2BAA2B;QACrC,GAAG,OAAO;KACX;IACH,CAAC,CAAC,OAAO,CAAC;AAEd,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC,EACnD,QAAQ,GAAG,sCAAsC,EACjD,KAAK,EAAE,YAAY,GAAG,UAAU,CAAC,KAAK,MACG,EAAE,EAA6B,EAAE,CAAC,CAAC;IAC5E,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,4BAA4B,CAAC,QAAQ,EAAE,KAAK,EAAE,YAAY,CAAC;CACrF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,2CAA2C,GAAG,CAAC,EAC1D,QAAQ,GAAG,8CAA8C,EACzD,KAAK,EAAE,YAAY,GAAG,UAAU,CAAC,KAAK,MACU,EAAE,EAAoC,EAAE,CAAC,CAAC;IAC1F,qBAAqB,EAAE,KAAK,CAAC,EAAE,CAAC,4BAA4B,CAAC,QAAQ,EAAE,KAAK,EAAE,YAAY,CAAC;CAC5F,CAAC,CAAC;AAWH,MAAM,UAAU,sBAAsB,CAAuB,EAC3D,SAAS,GAAG,EAAE,EACd,UAAU,GAAG,EAAE,EACf,gBAAgB,GAAG,EAAE,EACrB,mBAAmB,GAAG,EAAE,EACxB,0BAA0B,GAAG,EAAE,MACM,EAAE;IACvC,MAAM,gBAAgB,GACpB,UAAU,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,4BAA4B,CAAC,UAAU,CAAC,CAAC;IAC9E,MAAM,mBAAmB,GACvB,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,8BAA8B,CAAC,SAAS,CAAC,CAAC;IAE9E,OAAO;QACL,GAAG,CAAC,mBAAmB;YACrB,CAAC,CAAC;gBACE,KAAK,EAAE,8BAA8B,CAAC,GAAG,EAAE,CAAC,mBAAmB,CAAC,OAAO,CAAC;gBACxE,aAAa,EAAE,mBAAmB,CAAC,aAAa;aACjD;YACH,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,gBAAgB,KAAK,KAAK;YAC5B,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,gBAAgB,EAAE,2BAA2B,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACxE,GAAG,CAAC,gBAAgB;YAClB,CAAC,CAAC;gBACE,uBAAuB,EAAE,CAAC,iCAAiC,CAAC,gBAAgB,CAAC,CAAC;gBAC9E,yBAAyB,EAAE,oCAAoC,CAAC,gBAAgB,CAAC;aAClF;YACH,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,mBAAmB,KAAK,KAAK;YAC/B,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,yBAAyB,EAAE,oCAAoC,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAC7F,GAAG,CAAC,0BAA0B,KAAK,KAAK;YACtC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACE,gCAAgC,EAAE,2CAA2C,CAC3E,0BAA0B,CAC3B;aACF,CAAC;KACP,CAAC;AACJ,CAAC","sourcesContent":["'use client';\n\nimport type {\n  ReflectedEntityDataReader,\n  ReflectedEntityDataResult,\n  ReflectedRelatedEntityDataReader,\n  ReflectedRelatedEntityDataQuery,\n  ReflectedOperationInvoker,\n  RemoteDataGraphError,\n  RuntimeBoundDataGraphApi,\n} from '@ontahi/core/data-graph';\nimport { createRuntimeBoundDataGraphApi } from '@ontahi/core/data-graph';\nimport type { RuntimeTransport } from '@ontahi/core/runtime/protocol';\n\nimport {\n  createFetchOperationBridgeAdapter,\n  createFetchReflectedOperationInvoker,\n  type AnyOperationBridgeAdapter,\n  type FetchOperationBridgeOptions,\n} from '../actions/index.js';\n\nimport type { ReactGraphExecutor } from './executor.js';\nimport type { FetchGraphReadExecutorOptions } from './fetch-graph-read-executor.js';\nimport { createFetchGraphReadCapability } from './fetch-graph-runtime.js';\nimport {\n  createFetchRuntimeTransport,\n  type FetchRuntimeTransportOptions,\n} from './fetch-runtime-transport.js';\n\nexport type FetchReflectedEntityDataReaderOptions = {\n  endpoint?: string;\n  fetch?: typeof globalThis.fetch;\n};\n\nexport type FetchReflectedRelatedEntityDataReaderOptions = FetchReflectedEntityDataReaderOptions;\n\nexport type OntahiGraphClient<TReadOptions = unknown, TCommandOptions = TReadOptions> = {\n  graph?: RuntimeBoundDataGraphApi<\n    RemoteDataGraphError,\n    TReadOptions,\n    TCommandOptions,\n    RemoteDataGraphError\n  >;\n  graphExecutor?: ReactGraphExecutor<TReadOptions, TCommandOptions>;\n  runtimeTransport?: RuntimeTransport;\n  operationBridgeAdapters?: AnyOperationBridgeAdapter[];\n  reflectedEntityDataReader?: ReflectedEntityDataReader;\n  reflectedRelatedEntityDataReader?: ReflectedRelatedEntityDataReader;\n  reflectedOperationInvoker?: ReflectedOperationInvoker;\n};\n\nexport type FetchGraphClient<TOptions = undefined> = OntahiGraphClient<TOptions, TOptions> & {\n  graph: RuntimeBoundDataGraphApi<RemoteDataGraphError, TOptions, TOptions, RemoteDataGraphError>;\n  graphExecutor: ReactGraphExecutor<TOptions, TOptions>;\n};\n\nexport type FetchGraphClientOptions<TOptions = undefined> = {\n  graphRead?: false | FetchGraphReadExecutorOptions<TOptions>;\n  operations?: false | FetchOperationBridgeOptions;\n  runtimeTransport?: false | FetchRuntimeTransportOptions;\n  reflectedEntityData?: false | FetchReflectedEntityDataReaderOptions;\n  reflectedRelatedEntityData?: false | FetchReflectedRelatedEntityDataReaderOptions;\n};\n\nconst DEFAULT_OPERATIONS_ENDPOINT = '/operations';\nconst DEFAULT_REFLECTED_ENTITY_DATA_ENDPOINT = '/explorer/entities';\nconst DEFAULT_REFLECTED_RELATED_ENTITY_DATA_ENDPOINT = '/explorer/related-entities';\n\nconst postReflectedEntityDataQuery = async (\n  endpoint: string,\n  query:\n    | ReflectedRelatedEntityDataQuery\n    | Parameters<ReflectedEntityDataReader['readEntityData']>[0],\n  fetchRequest: typeof globalThis.fetch,\n) => {\n  const response = await fetchRequest(endpoint, {\n    method: 'POST',\n    headers: { 'content-type': 'application/json' },\n    credentials: 'same-origin',\n    body: JSON.stringify(query),\n  });\n\n  if (!response.ok) {\n    throw new Error(`Reflected entity data request failed with status ${response.status}.`);\n  }\n\n  return response.json() as Promise<ReflectedEntityDataResult>;\n};\n\nconst conventionalOperationOptions = (\n  options: FetchOperationBridgeOptions,\n): FetchOperationBridgeOptions =>\n  options.mountPath === undefined\n    ? {\n        endpoint: DEFAULT_OPERATIONS_ENDPOINT,\n        ...options,\n      }\n    : options;\n\nexport const createFetchReflectedEntityDataReader = ({\n  endpoint = DEFAULT_REFLECTED_ENTITY_DATA_ENDPOINT,\n  fetch: fetchRequest = globalThis.fetch,\n}: FetchReflectedEntityDataReaderOptions = {}): ReflectedEntityDataReader => ({\n  readEntityData: query => postReflectedEntityDataQuery(endpoint, query, fetchRequest),\n});\n\nexport const createFetchReflectedRelatedEntityDataReader = ({\n  endpoint = DEFAULT_REFLECTED_RELATED_ENTITY_DATA_ENDPOINT,\n  fetch: fetchRequest = globalThis.fetch,\n}: FetchReflectedRelatedEntityDataReaderOptions = {}): ReflectedRelatedEntityDataReader => ({\n  readRelatedEntityData: query => postReflectedEntityDataQuery(endpoint, query, fetchRequest),\n});\n\nexport function createFetchGraphClient<TOptions = undefined>(): FetchGraphClient<TOptions>;\nexport function createFetchGraphClient<TOptions = undefined>(\n  options: FetchGraphClientOptions<TOptions> & { graphRead: false },\n): OntahiGraphClient<TOptions, TOptions>;\nexport function createFetchGraphClient<TOptions = undefined>(\n  options: FetchGraphClientOptions<TOptions> & {\n    graphRead?: FetchGraphReadExecutorOptions<TOptions>;\n  },\n): FetchGraphClient<TOptions>;\nexport function createFetchGraphClient<TOptions = undefined>({\n  graphRead = {},\n  operations = {},\n  runtimeTransport = {},\n  reflectedEntityData = {},\n  reflectedRelatedEntityData = {},\n}: FetchGraphClientOptions<TOptions> = {}): OntahiGraphClient<TOptions, TOptions> {\n  const operationOptions =\n    operations === false ? undefined : conventionalOperationOptions(operations);\n  const graphReadCapability =\n    graphRead === false ? undefined : createFetchGraphReadCapability(graphRead);\n\n  return {\n    ...(graphReadCapability\n      ? {\n          graph: createRuntimeBoundDataGraphApi(() => graphReadCapability.runtime),\n          graphExecutor: graphReadCapability.graphExecutor,\n        }\n      : {}),\n    ...(runtimeTransport === false\n      ? {}\n      : { runtimeTransport: createFetchRuntimeTransport(runtimeTransport) }),\n    ...(operationOptions\n      ? {\n          operationBridgeAdapters: [createFetchOperationBridgeAdapter(operationOptions)],\n          reflectedOperationInvoker: createFetchReflectedOperationInvoker(operationOptions),\n        }\n      : {}),\n    ...(reflectedEntityData === false\n      ? {}\n      : { reflectedEntityDataReader: createFetchReflectedEntityDataReader(reflectedEntityData) }),\n    ...(reflectedRelatedEntityData === false\n      ? {}\n      : {\n          reflectedRelatedEntityDataReader: createFetchReflectedRelatedEntityDataReader(\n            reflectedRelatedEntityData,\n          ),\n        }),\n  };\n}\n"]}
+{"version":3,"file":"fetch-graph-client.js","sourceRoot":"","sources":["../../src/graph/fetch-graph-client.ts"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport type {\n  GraphClientCache,\n  ReflectedEntityDataReader,\n  ReflectedEntityDataResult,\n  ReflectedRelatedEntityDataReader,\n  ReflectedRelatedEntityDataQuery,\n  ReflectedOperationInvoker,\n  RemoteDataGraphError,\n  RuntimeBoundDataGraphApi,\n} from '@ontahi/core/data-graph';\nimport { createGraphClientCache, createRuntimeBoundDataGraphApi } from '@ontahi/core/data-graph';\nimport type { RuntimeTransport } from '@ontahi/core/runtime/protocol';\n\nimport {\n  createFetchOperationBridgeAdapter,\n  createFetchReflectedOperationInvoker,\n  type AnyOperationBridgeAdapter,\n  type FetchOperationBridgeOptions,\n} from '../actions/index.js';\n\nimport type { ReactGraphExecutor } from './executor.js';\nimport type { FetchGraphReadExecutorOptions } from './fetch-graph-read-executor.js';\nimport { createFetchGraphReadCapability } from './fetch-graph-runtime.js';\nimport {\n  createFetchRuntimeTransport,\n  type FetchRuntimeTransportOptions,\n} from './fetch-runtime-transport.js';\n\nexport type FetchReflectedEntityDataReaderOptions = {\n  endpoint?: string;\n  fetch?: typeof globalThis.fetch;\n};\n\nexport type FetchReflectedRelatedEntityDataReaderOptions = FetchReflectedEntityDataReaderOptions;\n\nexport type OntahiGraphClient<TReadOptions = unknown, TCommandOptions = TReadOptions> = {\n  graph?: RuntimeBoundDataGraphApi<\n    RemoteDataGraphError,\n    TReadOptions,\n    TCommandOptions,\n    RemoteDataGraphError\n  >;\n  graphExecutor?: ReactGraphExecutor<TReadOptions, TCommandOptions>;\n  clientCache?: GraphClientCache;\n  runtimeTransport?: RuntimeTransport<TReadOptions | TCommandOptions>;\n  operationBridgeAdapters?: AnyOperationBridgeAdapter[];\n  reflectedEntityDataReader?: ReflectedEntityDataReader;\n  reflectedRelatedEntityDataReader?: ReflectedRelatedEntityDataReader;\n  reflectedOperationInvoker?: ReflectedOperationInvoker;\n};\n\nexport type FetchGraphClient<TOptions = undefined> = OntahiGraphClient<TOptions, TOptions> & {\n  graph: RuntimeBoundDataGraphApi<RemoteDataGraphError, TOptions, TOptions, RemoteDataGraphError>;\n  graphExecutor: ReactGraphExecutor<TOptions, TOptions>;\n  clientCache: GraphClientCache;\n};\n\nexport type FetchGraphClientCompatibilityOptions = {\n  operation?: {\n    endpoint?: string;\n    mountPath?: string;\n  };\n  graphRead?: {\n    endpoint?: string;\n  };\n  graphCommand?: {\n    endpoint?: string;\n  };\n};\n\nexport type FetchGraphClientOptions<TOptions = undefined> = {\n  compatibility?: FetchGraphClientCompatibilityOptions;\n  graphRead?: false | FetchGraphReadExecutorOptions<TOptions>;\n  operations?: false | FetchOperationBridgeOptions<TOptions>;\n  runtimeTransport?: false | FetchRuntimeTransportOptions<TOptions>;\n  reflectedEntityData?: false | FetchReflectedEntityDataReaderOptions;\n  reflectedRelatedEntityData?: false | FetchReflectedRelatedEntityDataReaderOptions;\n};\n\nconst DEFAULT_LEGACY_OPERATION_ENDPOINT = '/operations';\nconst DEFAULT_LEGACY_GRAPH_READ_ENDPOINT = '/graph/reads';\nconst DEFAULT_LEGACY_GRAPH_COMMAND_ENDPOINT = '/graph/commands';\nconst DEFAULT_REFLECTED_ENTITY_DATA_ENDPOINT = '/explorer/entities';\nconst DEFAULT_REFLECTED_RELATED_ENTITY_DATA_ENDPOINT = '/explorer/related-entities';\n\nconst postReflectedEntityDataQuery = async (\n  endpoint: string,\n  query:\n    | ReflectedRelatedEntityDataQuery\n    | Parameters<ReflectedEntityDataReader['readEntityData']>[0],\n  fetchRequest: typeof globalThis.fetch,\n) => {\n  const response = await fetchRequest(endpoint, {\n    method: 'POST',\n    headers: { 'content-type': 'application/json' },\n    credentials: 'same-origin',\n    body: JSON.stringify(query),\n  });\n\n  if (!response.ok) {\n    throw new Error(`Reflected entity data request failed with status ${response.status}.`);\n  }\n\n  return response.json() as Promise<ReflectedEntityDataResult>;\n};\n\nexport const createFetchReflectedEntityDataReader = ({\n  endpoint = DEFAULT_REFLECTED_ENTITY_DATA_ENDPOINT,\n  fetch: fetchRequest = globalThis.fetch,\n}: FetchReflectedEntityDataReaderOptions = {}): ReflectedEntityDataReader => ({\n  readEntityData: query => postReflectedEntityDataQuery(endpoint, query, fetchRequest),\n});\n\nexport const createFetchReflectedRelatedEntityDataReader = ({\n  endpoint = DEFAULT_REFLECTED_RELATED_ENTITY_DATA_ENDPOINT,\n  fetch: fetchRequest = globalThis.fetch,\n}: FetchReflectedRelatedEntityDataReaderOptions = {}): ReflectedRelatedEntityDataReader => ({\n  readRelatedEntityData: query => postReflectedEntityDataQuery(endpoint, query, fetchRequest),\n});\n\nexport function createFetchGraphClient<TOptions = undefined>(): FetchGraphClient<TOptions>;\nexport function createFetchGraphClient<TOptions = undefined>(\n  options: FetchGraphClientOptions<TOptions> & { graphRead: false },\n): OntahiGraphClient<TOptions, TOptions>;\nexport function createFetchGraphClient<TOptions = undefined>(\n  options: FetchGraphClientOptions<TOptions> & {\n    graphRead?: FetchGraphReadExecutorOptions<TOptions>;\n  },\n): FetchGraphClient<TOptions>;\nexport function createFetchGraphClient<TOptions = undefined>({\n  compatibility = {},\n  graphRead = {},\n  operations = {},\n  runtimeTransport = {},\n  reflectedEntityData = {},\n  reflectedRelatedEntityData = {},\n}: FetchGraphClientOptions<TOptions> = {}): OntahiGraphClient<TOptions, TOptions> {\n  const graphReadOptions =\n    graphRead === false\n      ? undefined\n      : {\n          ...graphRead,\n          ...(compatibility.graphRead === undefined\n            ? {}\n            : {\n                endpoint: compatibility.graphRead.endpoint ?? DEFAULT_LEGACY_GRAPH_READ_ENDPOINT,\n              }),\n          ...(compatibility.graphCommand === undefined\n            ? {}\n            : {\n                commandEndpoint:\n                  compatibility.graphCommand.endpoint ?? DEFAULT_LEGACY_GRAPH_COMMAND_ENDPOINT,\n              }),\n        };\n  const clientCache = graphReadOptions ? createGraphClientCache() : undefined;\n  const operationOptions = (() => {\n    if (operations === false) return undefined;\n    if (compatibility.operation === undefined) return operations;\n    const { endpoint: _endpoint, mountPath: _mountPath, ...sharedOptions } = operations;\n    if (compatibility.operation.endpoint !== undefined) {\n      return { ...sharedOptions, endpoint: compatibility.operation.endpoint };\n    }\n    if (compatibility.operation.mountPath !== undefined) {\n      return { ...sharedOptions, mountPath: compatibility.operation.mountPath };\n    }\n    return { ...sharedOptions, endpoint: DEFAULT_LEGACY_OPERATION_ENDPOINT };\n  })();\n  const commonTransportRequired =\n    (graphReadOptions !== undefined &&\n      (graphReadOptions.endpoint === undefined ||\n        graphReadOptions.commandEndpoint === undefined)) ||\n    (operationOptions !== undefined &&\n      operationOptions.endpoint === undefined &&\n      operationOptions.mountPath === undefined);\n  if (runtimeTransport === false && commonTransportRequired) {\n    throw new TypeError(\n      'runtimeTransport cannot be disabled while a common Runtime Protocol family is enabled.',\n    );\n  }\n  const requestId =\n    runtimeTransport === false\n      ? undefined\n      : (runtimeTransport.requestId ?? graphReadOptions?.requestId ?? operationOptions?.requestId);\n  const runtimeTransportOptions =\n    runtimeTransport === false\n      ? undefined\n      : {\n          ...(graphReadOptions?.fetch ? { fetch: graphReadOptions.fetch } : {}),\n          ...(graphReadOptions?.requestInit ? { requestInit: graphReadOptions.requestInit } : {}),\n          ...runtimeTransport,\n          requestId,\n        };\n  const resolvedRuntimeTransport =\n    runtimeTransportOptions === undefined\n      ? undefined\n      : createFetchRuntimeTransport<TOptions>(runtimeTransportOptions);\n  const graphReadCapability =\n    graphReadOptions === undefined\n      ? undefined\n      : createFetchGraphReadCapability({\n          ...graphReadOptions,\n          ...(runtimeTransportOptions?.fetch ? { fetch: runtimeTransportOptions.fetch } : {}),\n          ...(runtimeTransportOptions?.requestInit\n            ? { requestInit: runtimeTransportOptions.requestInit }\n            : {}),\n          ...(resolvedRuntimeTransport\n            ? { runtimeTransport: resolvedRuntimeTransport, requestId }\n            : {}),\n        });\n  const resolvedOperationOptions =\n    operationOptions === undefined\n      ? undefined\n      : {\n          ...operationOptions,\n          ...(runtimeTransportOptions?.fetch ? { fetch: runtimeTransportOptions.fetch } : {}),\n          ...(runtimeTransportOptions?.requestInit\n            ? { requestInit: runtimeTransportOptions.requestInit }\n            : {}),\n          ...(resolvedRuntimeTransport\n            ? { runtimeTransport: resolvedRuntimeTransport, requestId }\n            : {}),\n        };\n\n  return {\n    ...(graphReadCapability\n      ? {\n          graph: createRuntimeBoundDataGraphApi(() => graphReadCapability.runtime),\n          graphExecutor: graphReadCapability.graphExecutor,\n          clientCache: clientCache!,\n        }\n      : {}),\n    ...(resolvedRuntimeTransport ? { runtimeTransport: resolvedRuntimeTransport } : {}),\n    ...(resolvedOperationOptions\n      ? {\n          operationBridgeAdapters: [createFetchOperationBridgeAdapter(resolvedOperationOptions)],\n          reflectedOperationInvoker: createFetchReflectedOperationInvoker(resolvedOperationOptions),\n        }\n      : {}),\n    ...(reflectedEntityData === false\n      ? {}\n      : { reflectedEntityDataReader: createFetchReflectedEntityDataReader(reflectedEntityData) }),\n    ...(reflectedRelatedEntityData === false\n      ? {}\n      : {\n          reflectedRelatedEntityDataReader: createFetchReflectedRelatedEntityDataReader(\n            reflectedRelatedEntityData,\n          ),\n        }),\n  };\n}\n"]}

package/dist/graph/fetch-graph-runtime.d.ts

@@ -1,17 +1,22 @@
-import { type DataGraphExecutionRuntime, type EntityMutationCommandExecutionRuntime, type RemoteDataGraphError, type ManyToManyRelationshipCommandExecutionRuntime, type RelationshipCommandExecutionRuntime } from '@ontahi/core/data-graph';
+import { type DataGraphExecutionRuntime, type DataGraphObservationRuntime, type EntityMutationCommandExecutionRuntime, type RemoteDataGraphError, type ManyToManyRelationshipCommandExecutionRuntime, type OrderedRelationshipCommandExecutionRuntime, type RelationshipCommandExecutionRuntime } from '@ontahi/core/data-graph';
+import { type RuntimeTransport } from '@ontahi/core/runtime/protocol';
 import type { ReactGraphExecutor } from './executor.js';
 export type FetchGraphReadExecutorOptions<TOptions = undefined> = {
+    /** @deprecated Select the legacy Graph Read route through createFetchGraphClient compatibility. */
     endpoint?: string;
+    /** @deprecated Select the legacy Graph Command route through createFetchGraphClient compatibility. */
     commandEndpoint?: string;
     fetch?: typeof globalThis.fetch;
+    requestId?: () => string;
     requestInit?: (options?: TOptions) => Omit<RequestInit, 'body' | 'method'>;
+    runtimeTransport?: RuntimeTransport<TOptions>;
 };
-export type FetchGraphRuntime<TOptions = undefined> = DataGraphExecutionRuntime<RemoteDataGraphError, TOptions, TOptions, RemoteDataGraphError>;
-export type FetchRelationshipRuntime<TOptions = undefined> = RelationshipCommandExecutionRuntime<RemoteDataGraphError, TOptions> & ManyToManyRelationshipCommandExecutionRuntime<RemoteDataGraphError, TOptions>;
+export type FetchGraphRuntime<TOptions = undefined> = DataGraphExecutionRuntime<RemoteDataGraphError, TOptions, TOptions, RemoteDataGraphError> & DataGraphObservationRuntime<RemoteDataGraphError, TOptions>;
+export type FetchRelationshipRuntime<TOptions = undefined> = RelationshipCommandExecutionRuntime<RemoteDataGraphError, TOptions> & ManyToManyRelationshipCommandExecutionRuntime<RemoteDataGraphError, TOptions> & OrderedRelationshipCommandExecutionRuntime<RemoteDataGraphError, TOptions>;
 export type FetchEntityMutationRuntime<TOptions = undefined> = EntityMutationCommandExecutionRuntime<RemoteDataGraphError, TOptions>;
 export type FetchGraphReadCapability<TOptions = undefined> = {
     runtime: FetchGraphRuntime<TOptions> & FetchRelationshipRuntime<TOptions> & FetchEntityMutationRuntime<TOptions>;
     graphExecutor: ReactGraphExecutor<TOptions, TOptions>;
 };
-export declare const createFetchGraphReadCapability: <TOptions = undefined>({ endpoint, commandEndpoint, fetch: fetchRequest, requestInit, }?: FetchGraphReadExecutorOptions<TOptions>) => FetchGraphReadCapability<TOptions>;
+export declare const createFetchGraphReadCapability: <TOptions = undefined>({ endpoint, commandEndpoint, fetch: fetchRequest, requestId, requestInit, runtimeTransport, }?: FetchGraphReadExecutorOptions<TOptions>) => FetchGraphReadCapability<TOptions>;
 //# sourceMappingURL=fetch-graph-runtime.d.ts.map

package/dist/graph/fetch-graph-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-graph-runtime.d.ts","sourceRoot":"","sources":["../../src/graph/fetch-graph-runtime.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,yBAAyB,EAC9B,KAAK,qCAAqC,EAC1C,KAAK,oBAAoB,EAGzB,KAAK,6CAA6C,EAClD,KAAK,mCAAmC,EACzC,MAAM,yBAAyB,CAAC;AAGjC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExD,MAAM,MAAM,6BAA6B,CAAC,QAAQ,GAAG,SAAS,IAAI;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,WAAW,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,QAAQ,KAAK,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC;CAC5E,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAAC,QAAQ,GAAG,SAAS,IAAI,yBAAyB,CAC7E,oBAAoB,EACpB,QAAQ,EACR,QAAQ,EACR,oBAAoB,CACrB,CAAC;AACF,MAAM,MAAM,wBAAwB,CAAC,QAAQ,GAAG,SAAS,IAAI,mCAAmC,CAC9F,oBAAoB,EACpB,QAAQ,CACT,GACC,6CAA6C,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;AAChF,MAAM,MAAM,0BAA0B,CAAC,QAAQ,GAAG,SAAS,IACzD,qCAAqC,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;AAExE,MAAM,MAAM,wBAAwB,CAAC,QAAQ,GAAG,SAAS,IAAI;IAC3D,OAAO,EAAE,iBAAiB,CAAC,QAAQ,CAAC,GAClC,wBAAwB,CAAC,QAAQ,CAAC,GAClC,0BAA0B,CAAC,QAAQ,CAAC,CAAC;IACvC,aAAa,EAAE,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;CACvD,CAAC;AAKF,eAAO,MAAM,8BAA8B,GAAI,QAAQ,GAAG,SAAS,EAAE,mEAKlE,6BAA6B,CAAC,QAAQ,CAAM,KAAG,wBAAwB,CAAC,QAAQ,CA8DlF,CAAC"}
+{"version":3,"file":"fetch-graph-runtime.d.ts","sourceRoot":"","sources":["../../src/graph/fetch-graph-runtime.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,yBAAyB,EAC9B,KAAK,2BAA2B,EAChC,KAAK,qCAAqC,EAC1C,KAAK,oBAAoB,EAIzB,KAAK,6CAA6C,EAClD,KAAK,0CAA0C,EAC/C,KAAK,mCAAmC,EACzC,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAEL,KAAK,gBAAgB,EAEtB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGxD,MAAM,MAAM,6BAA6B,CAAC,QAAQ,GAAG,SAAS,IAAI;IAChE,mGAAmG;IACnG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sGAAsG;IACtG,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,QAAQ,KAAK,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC;IAC3E,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAAC,QAAQ,GAAG,SAAS,IAAI,yBAAyB,CAC7E,oBAAoB,EACpB,QAAQ,EACR,QAAQ,EACR,oBAAoB,CACrB,GACC,2BAA2B,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;AAC9D,MAAM,MAAM,wBAAwB,CAAC,QAAQ,GAAG,SAAS,IAAI,mCAAmC,CAC9F,oBAAoB,EACpB,QAAQ,CACT,GACC,6CAA6C,CAAC,oBAAoB,EAAE,QAAQ,CAAC,GAC7E,0CAA0C,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;AAC7E,MAAM,MAAM,0BAA0B,CAAC,QAAQ,GAAG,SAAS,IACzD,qCAAqC,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;AAExE,MAAM,MAAM,wBAAwB,CAAC,QAAQ,GAAG,SAAS,IAAI;IAC3D,OAAO,EAAE,iBAAiB,CAAC,QAAQ,CAAC,GAClC,wBAAwB,CAAC,QAAQ,CAAC,GAClC,0BAA0B,CAAC,QAAQ,CAAC,CAAC;IACvC,aAAa,EAAE,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;CACvD,CAAC;AAEF,eAAO,MAAM,8BAA8B,GAAI,QAAQ,GAAG,SAAS,EAAE,gGAOlE,6BAA6B,CAAC,QAAQ,CAAM,KAAG,wBAAwB,CAAC,QAAQ,CAoGlF,CAAC"}

package/dist/graph/fetch-graph-runtime.js

@@ -1,10 +1,10 @@
 'use client';
 import { createRemoteDataGraphRuntime, isGraphCommandRejection, isGraphCommandProtocolError, isGraphReadProtocolError, } from '@ontahi/core/data-graph';
 import { runBrowserEffect } from '@ontahi/core/runtime/browser';
-const DEFAULT_GRAPH_READ_ENDPOINT = '/graph/reads';
-const DEFAULT_GRAPH_COMMAND_ENDPOINT = '/graph/commands';
-export const createFetchGraphReadCapability = ({ endpoint = DEFAULT_GRAPH_READ_ENDPOINT, commandEndpoint = DEFAULT_GRAPH_COMMAND_ENDPOINT, fetch: fetchRequest = globalThis.fetch, requestInit, } = {}) => {
-    const transport = async (request, options) => {
+import { createRuntimeProtocolExchange, } from '@ontahi/core/runtime/protocol';
+import { createFetchRuntimeTransport } from './fetch-runtime-transport.js';
+export const createFetchGraphReadCapability = ({ endpoint, commandEndpoint, fetch: fetchRequest = globalThis.fetch, requestId, requestInit, runtimeTransport, } = {}) => {
+    const legacyReadTransport = async (request, options) => {
         const init = requestInit?.(options) ?? {};
         const headers = new Headers(init.headers);
         if (!headers.has('content-type'))
@@ -27,7 +27,7 @@ export const createFetchGraphReadCapability = ({ endpoint = DEFAULT_GRAPH_READ_E
             throw new Error(`Graph read request failed with status ${response.status}.`);
         }
     };
-    const commandTransport = async (request, options) => {
+    const legacyCommandTransport = async (request, options) => {
         const init = requestInit?.(options) ?? {};
         const headers = new Headers(init.headers);
         if (!headers.has('content-type'))
@@ -47,7 +47,31 @@ export const createFetchGraphReadCapability = ({ endpoint = DEFAULT_GRAPH_READ_E
         }
         return payload;
     };
-    const runtime = createRemoteDataGraphRuntime({ transport, commandTransport });
+    const exchange = endpoint && commandEndpoint
+        ? undefined
+        : createRuntimeProtocolExchange({
+            transport: runtimeTransport ??
+                createFetchRuntimeTransport({ fetch: fetchRequest, requestInit }),
+            requestId,
+        });
+    const exchangeOptions = (options) => options === undefined ? undefined : { transportOptions: options };
+    const transport = endpoint
+        ? legacyReadTransport
+        : (request, options) => exchange({ family: 'graph.read', body: request }, exchangeOptions(options));
+    const commandTransport = commandEndpoint
+        ? legacyCommandTransport
+        : (request, options) => exchange({ family: 'graph.command', body: request }, exchangeOptions(options));
+    const observeTransport = runtimeTransport?.graph
+        ? (request, options, lifecycle) => runtimeTransport.graph.observe(request, {
+            ...exchangeOptions(options),
+            signal: lifecycle?.signal,
+        })
+        : undefined;
+    const runtime = createRemoteDataGraphRuntime({
+        transport,
+        commandTransport,
+        ...(observeTransport ? { observeTransport } : {}),
+    });
     return {
         runtime,
         graphExecutor: {
@@ -57,6 +81,7 @@ export const createFetchGraphReadCapability = ({ endpoint = DEFAULT_GRAPH_READ_E
             runCommand: (command, options) => runBrowserEffect(runtime.runCommand(command, options)),
             runRelationshipCommand: (command, options) => runBrowserEffect(runtime.runRelationshipCommand(command, options)),
             runManyToManyRelationshipCommand: (command, options) => runBrowserEffect(runtime.runManyToManyRelationshipCommand(command, options)),
+            runOrderedRelationshipCommand: (command, options) => runBrowserEffect(runtime.runOrderedRelationshipCommand(command, options)),
             runEntityMutationCommand: (command, options) => runBrowserEffect(runtime.runEntityMutationCommand(command, options)),
         },
     };

package/dist/graph/fetch-graph-runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-graph-runtime.js","sourceRoot":"","sources":["../../src/graph/fetch-graph-runtime.ts"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport {\n  createRemoteDataGraphRuntime,\n  isGraphCommandRejection,\n  isGraphCommandProtocolError,\n  isGraphReadProtocolError,\n  type DataGraphExecutionRuntime,\n  type EntityMutationCommandExecutionRuntime,\n  type RemoteDataGraphError,\n  type RemoteGraphCommandTransport,\n  type RemoteGraphReadTransport,\n  type ManyToManyRelationshipCommandExecutionRuntime,\n  type RelationshipCommandExecutionRuntime,\n} from '@ontahi/core/data-graph';\nimport { runBrowserEffect } from '@ontahi/core/runtime/browser';\n\nimport type { ReactGraphExecutor } from './executor.js';\n\nexport type FetchGraphReadExecutorOptions<TOptions = undefined> = {\n  endpoint?: string;\n  commandEndpoint?: string;\n  fetch?: typeof globalThis.fetch;\n  requestInit?: (options?: TOptions) => Omit<RequestInit, 'body' | 'method'>;\n};\n\nexport type FetchGraphRuntime<TOptions = undefined> = DataGraphExecutionRuntime<\n  RemoteDataGraphError,\n  TOptions,\n  TOptions,\n  RemoteDataGraphError\n>;\nexport type FetchRelationshipRuntime<TOptions = undefined> = RelationshipCommandExecutionRuntime<\n  RemoteDataGraphError,\n  TOptions\n> &\n  ManyToManyRelationshipCommandExecutionRuntime<RemoteDataGraphError, TOptions>;\nexport type FetchEntityMutationRuntime<TOptions = undefined> =\n  EntityMutationCommandExecutionRuntime<RemoteDataGraphError, TOptions>;\n\nexport type FetchGraphReadCapability<TOptions = undefined> = {\n  runtime: FetchGraphRuntime<TOptions> &\n    FetchRelationshipRuntime<TOptions> &\n    FetchEntityMutationRuntime<TOptions>;\n  graphExecutor: ReactGraphExecutor<TOptions, TOptions>;\n};\n\nconst DEFAULT_GRAPH_READ_ENDPOINT = '/graph/reads';\nconst DEFAULT_GRAPH_COMMAND_ENDPOINT = '/graph/commands';\n\nexport const createFetchGraphReadCapability = <TOptions = undefined>({\n  endpoint = DEFAULT_GRAPH_READ_ENDPOINT,\n  commandEndpoint = DEFAULT_GRAPH_COMMAND_ENDPOINT,\n  fetch: fetchRequest = globalThis.fetch,\n  requestInit,\n}: FetchGraphReadExecutorOptions<TOptions> = {}): FetchGraphReadCapability<TOptions> => {\n  const transport: RemoteGraphReadTransport<TOptions> = async (request, options) => {\n    const init = requestInit?.(options) ?? {};\n    const headers = new Headers(init.headers);\n    if (!headers.has('content-type')) headers.set('content-type', 'application/json');\n\n    const response = await fetchRequest(endpoint, {\n      ...init,\n      method: 'POST',\n      headers,\n      credentials: init.credentials ?? 'same-origin',\n      body: JSON.stringify(request),\n    });\n\n    try {\n      const payload: unknown = await response.json();\n      if (!response.ok && !isGraphReadProtocolError(payload)) {\n        throw new Error(`Graph read request failed with status ${response.status}.`);\n      }\n      return payload;\n    } catch {\n      throw new Error(`Graph read request failed with status ${response.status}.`);\n    }\n  };\n  const commandTransport: RemoteGraphCommandTransport<TOptions> = async (request, options) => {\n    const init = requestInit?.(options) ?? {};\n    const headers = new Headers(init.headers);\n    if (!headers.has('content-type')) headers.set('content-type', 'application/json');\n    const response = await fetchRequest(commandEndpoint, {\n      ...init,\n      method: 'POST',\n      headers,\n      credentials: init.credentials ?? 'same-origin',\n      body: JSON.stringify(request),\n    });\n    const payload: unknown = await response.json();\n    if (\n      !response.ok &&\n      !isGraphCommandProtocolError(payload) &&\n      !isGraphCommandRejection(payload)\n    ) {\n      throw new Error(`Graph Command request failed with status ${response.status}.`);\n    }\n    return payload;\n  };\n  const runtime = createRemoteDataGraphRuntime({ transport, commandTransport });\n\n  return {\n    runtime,\n    graphExecutor: {\n      get: (read, params, options) => runBrowserEffect(runtime.get(read, params, options)),\n      run: (read, params, options) => runBrowserEffect(runtime.run(read, params, options)),\n      count: (read, params, options) => runBrowserEffect(runtime.count(read, params, options)),\n      runCommand: (command, options) => runBrowserEffect(runtime.runCommand(command, options)),\n      runRelationshipCommand: (command, options) =>\n        runBrowserEffect(runtime.runRelationshipCommand(command, options)),\n      runManyToManyRelationshipCommand: (command, options) =>\n        runBrowserEffect(runtime.runManyToManyRelationshipCommand(command, options)),\n      runEntityMutationCommand: (command, options) =>\n        runBrowserEffect(runtime.runEntityMutationCommand(command, options)),\n    },\n  };\n};\n"]}
+{"version":3,"file":"fetch-graph-runtime.js","sourceRoot":"","sources":["../../src/graph/fetch-graph-runtime.ts"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport {\n  createRemoteDataGraphRuntime,\n  isGraphCommandRejection,\n  isGraphCommandProtocolError,\n  isGraphReadProtocolError,\n  type DataGraphExecutionRuntime,\n  type DataGraphObservationRuntime,\n  type EntityMutationCommandExecutionRuntime,\n  type RemoteDataGraphError,\n  type RemoteGraphCommandTransport,\n  type RemoteGraphObservationTransport,\n  type RemoteGraphReadTransport,\n  type ManyToManyRelationshipCommandExecutionRuntime,\n  type OrderedRelationshipCommandExecutionRuntime,\n  type RelationshipCommandExecutionRuntime,\n} from '@ontahi/core/data-graph';\nimport { runBrowserEffect } from '@ontahi/core/runtime/browser';\nimport {\n  createRuntimeProtocolExchange,\n  type RuntimeTransport,\n  type RuntimeTransportRequestOptions,\n} from '@ontahi/core/runtime/protocol';\n\nimport type { ReactGraphExecutor } from './executor.js';\nimport { createFetchRuntimeTransport } from './fetch-runtime-transport.js';\n\nexport type FetchGraphReadExecutorOptions<TOptions = undefined> = {\n  /** @deprecated Select the legacy Graph Read route through createFetchGraphClient compatibility. */\n  endpoint?: string;\n  /** @deprecated Select the legacy Graph Command route through createFetchGraphClient compatibility. */\n  commandEndpoint?: string;\n  fetch?: typeof globalThis.fetch;\n  requestId?: () => string;\n  requestInit?: (options?: TOptions) => Omit<RequestInit, 'body' | 'method'>;\n  runtimeTransport?: RuntimeTransport<TOptions>;\n};\n\nexport type FetchGraphRuntime<TOptions = undefined> = DataGraphExecutionRuntime<\n  RemoteDataGraphError,\n  TOptions,\n  TOptions,\n  RemoteDataGraphError\n> &\n  DataGraphObservationRuntime<RemoteDataGraphError, TOptions>;\nexport type FetchRelationshipRuntime<TOptions = undefined> = RelationshipCommandExecutionRuntime<\n  RemoteDataGraphError,\n  TOptions\n> &\n  ManyToManyRelationshipCommandExecutionRuntime<RemoteDataGraphError, TOptions> &\n  OrderedRelationshipCommandExecutionRuntime<RemoteDataGraphError, TOptions>;\nexport type FetchEntityMutationRuntime<TOptions = undefined> =\n  EntityMutationCommandExecutionRuntime<RemoteDataGraphError, TOptions>;\n\nexport type FetchGraphReadCapability<TOptions = undefined> = {\n  runtime: FetchGraphRuntime<TOptions> &\n    FetchRelationshipRuntime<TOptions> &\n    FetchEntityMutationRuntime<TOptions>;\n  graphExecutor: ReactGraphExecutor<TOptions, TOptions>;\n};\n\nexport const createFetchGraphReadCapability = <TOptions = undefined>({\n  endpoint,\n  commandEndpoint,\n  fetch: fetchRequest = globalThis.fetch,\n  requestId,\n  requestInit,\n  runtimeTransport,\n}: FetchGraphReadExecutorOptions<TOptions> = {}): FetchGraphReadCapability<TOptions> => {\n  const legacyReadTransport: RemoteGraphReadTransport<TOptions> = async (request, options) => {\n    const init = requestInit?.(options) ?? {};\n    const headers = new Headers(init.headers);\n    if (!headers.has('content-type')) headers.set('content-type', 'application/json');\n\n    const response = await fetchRequest(endpoint!, {\n      ...init,\n      method: 'POST',\n      headers,\n      credentials: init.credentials ?? 'same-origin',\n      body: JSON.stringify(request),\n    });\n\n    try {\n      const payload: unknown = await response.json();\n      if (!response.ok && !isGraphReadProtocolError(payload)) {\n        throw new Error(`Graph read request failed with status ${response.status}.`);\n      }\n      return payload;\n    } catch {\n      throw new Error(`Graph read request failed with status ${response.status}.`);\n    }\n  };\n  const legacyCommandTransport: RemoteGraphCommandTransport<TOptions> = async (\n    request,\n    options,\n  ) => {\n    const init = requestInit?.(options) ?? {};\n    const headers = new Headers(init.headers);\n    if (!headers.has('content-type')) headers.set('content-type', 'application/json');\n    const response = await fetchRequest(commandEndpoint!, {\n      ...init,\n      method: 'POST',\n      headers,\n      credentials: init.credentials ?? 'same-origin',\n      body: JSON.stringify(request),\n    });\n    const payload: unknown = await response.json();\n    if (\n      !response.ok &&\n      !isGraphCommandProtocolError(payload) &&\n      !isGraphCommandRejection(payload)\n    ) {\n      throw new Error(`Graph Command request failed with status ${response.status}.`);\n    }\n    return payload;\n  };\n  const exchange =\n    endpoint && commandEndpoint\n      ? undefined\n      : createRuntimeProtocolExchange({\n          transport:\n            runtimeTransport ??\n            createFetchRuntimeTransport<TOptions>({ fetch: fetchRequest, requestInit }),\n          requestId,\n        });\n  const exchangeOptions = (\n    options: TOptions | undefined,\n  ): RuntimeTransportRequestOptions<TOptions> | undefined =>\n    options === undefined ? undefined : { transportOptions: options };\n  const transport: RemoteGraphReadTransport<TOptions> = endpoint\n    ? legacyReadTransport\n    : (request, options) =>\n        exchange!({ family: 'graph.read', body: request }, exchangeOptions(options));\n  const commandTransport: RemoteGraphCommandTransport<TOptions> = commandEndpoint\n    ? legacyCommandTransport\n    : (request, options) =>\n        exchange!({ family: 'graph.command', body: request }, exchangeOptions(options));\n  const observeTransport: RemoteGraphObservationTransport<TOptions> | undefined =\n    runtimeTransport?.graph\n      ? (request, options, lifecycle) =>\n          runtimeTransport.graph!.observe(request, {\n            ...exchangeOptions(options),\n            signal: lifecycle?.signal,\n          })\n      : undefined;\n  const runtime = createRemoteDataGraphRuntime({\n    transport,\n    commandTransport,\n    ...(observeTransport ? { observeTransport } : {}),\n  });\n\n  return {\n    runtime,\n    graphExecutor: {\n      get: (read, params, options) => runBrowserEffect(runtime.get(read, params, options)),\n      run: (read, params, options) => runBrowserEffect(runtime.run(read, params, options)),\n      count: (read, params, options) => runBrowserEffect(runtime.count(read, params, options)),\n      runCommand: (command, options) => runBrowserEffect(runtime.runCommand(command, options)),\n      runRelationshipCommand: (command, options) =>\n        runBrowserEffect(runtime.runRelationshipCommand(command, options)),\n      runManyToManyRelationshipCommand: (command, options) =>\n        runBrowserEffect(runtime.runManyToManyRelationshipCommand(command, options)),\n      runOrderedRelationshipCommand: (command, options) =>\n        runBrowserEffect(runtime.runOrderedRelationshipCommand(command, options)),\n      runEntityMutationCommand: (command, options) =>\n        runBrowserEffect(runtime.runEntityMutationCommand(command, options)),\n    },\n  };\n};\n"]}

package/dist/graph/fetch-runtime-transport.d.ts

@@ -1,15 +1,15 @@
 import { type DurableOperationObservationCapability, type RuntimeTransport } from '@ontahi/core/runtime/protocol';
-export type FetchRuntimeTransportOptions = {
+export type FetchRuntimeTransportOptions<TTransportOptions = undefined> = {
     endpoint?: string;
     fetch?: typeof globalThis.fetch;
     requestId?: () => string;
-    requestInit?: () => Omit<RequestInit, 'body' | 'method' | 'signal'>;
+    requestInit?: (options?: TTransportOptions) => Omit<RequestInit, 'body' | 'method'>;
     durableOperation?: {
         pollIntervalMs?: number;
     };
 };
-export type FetchRuntimeTransport = RuntimeTransport & {
+export type FetchRuntimeTransport<TTransportOptions = undefined> = RuntimeTransport<TTransportOptions> & {
     readonly durableOperation: DurableOperationObservationCapability;
 };
-export declare const createFetchRuntimeTransport: ({ endpoint, fetch: fetchRequest, requestId, requestInit, durableOperation, }?: FetchRuntimeTransportOptions) => FetchRuntimeTransport;
+export declare const createFetchRuntimeTransport: <TTransportOptions = undefined>({ endpoint, fetch: fetchRequest, requestId, requestInit, durableOperation, }?: FetchRuntimeTransportOptions<TTransportOptions>) => FetchRuntimeTransport<TTransportOptions>;
 //# sourceMappingURL=fetch-runtime-transport.d.ts.map

package/dist/graph/fetch-runtime-transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-runtime-transport.d.ts","sourceRoot":"","sources":["../../src/graph/fetch-runtime-transport.ts"],"names":[],"mappings":"AAGA,OAAO,EAML,KAAK,qCAAqC,EAE1C,KAAK,gBAAgB,EAEtB,MAAM,+BAA+B,CAAC;AAEvC,MAAM,MAAM,4BAA4B,GAAG;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAAC;IACpE,gBAAgB,CAAC,EAAE;QACjB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,gBAAgB,GAAG;IACrD,QAAQ,CAAC,gBAAgB,EAAE,qCAAqC,CAAC;CAClE,CAAC;AAiCF,eAAO,MAAM,2BAA2B,GAAI,+EAMzC,4BAAiC,KAAG,qBAiEtC,CAAC"}
+{"version":3,"file":"fetch-runtime-transport.d.ts","sourceRoot":"","sources":["../../src/graph/fetch-runtime-transport.ts"],"names":[],"mappings":"AAGA,OAAO,EAML,KAAK,qCAAqC,EAE1C,KAAK,gBAAgB,EAEtB,MAAM,+BAA+B,CAAC;AAEvC,MAAM,MAAM,4BAA4B,CAAC,iBAAiB,GAAG,SAAS,IAAI;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,iBAAiB,KAAK,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC;IACpF,gBAAgB,CAAC,EAAE;QACjB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,qBAAqB,CAAC,iBAAiB,GAAG,SAAS,IAC7D,gBAAgB,CAAC,iBAAiB,CAAC,GAAG;IACpC,QAAQ,CAAC,gBAAgB,EAAE,qCAAqC,CAAC;CAClE,CAAC;AA4BJ,eAAO,MAAM,2BAA2B,GAAI,iBAAiB,GAAG,SAAS,EAAE,+EAMxE,4BAA4B,CAAC,iBAAiB,CAAM,KAAG,qBAAqB,CAAC,iBAAiB,CAmEhG,CAAC"}

package/dist/graph/fetch-runtime-transport.js

@@ -1,11 +1,8 @@
 'use client';
-import { createRuntimeProtocolRequest, isRuntimeProtocolError, parseDurableOperationProtocolResponse, parseRuntimeProtocolResponse, toDurableOperationProtocolRequest, } from '@ontahi/core/runtime/protocol';
+import { createRuntimeProtocolExchange, isRuntimeProtocolError, parseDurableOperationProtocolResponse, parseRuntimeProtocolResponse, toDurableOperationProtocolRequest, } from '@ontahi/core/runtime/protocol';
 const DEFAULT_RUNTIME_ENDPOINT = '/runtime';
 const DEFAULT_POLL_INTERVAL_MS = 500;
 const terminalTaskStatuses = new Set(['completed', 'failed', 'cancelled']);
-let fallbackRequestSequence = 0;
-const defaultRequestId = () => globalThis.crypto?.randomUUID?.() ??
-    `ontahi-runtime-${Date.now()}-${(fallbackRequestSequence += 1)}`;
 const waitForNextInspection = (intervalMs, signal) => {
     if (signal?.aborted)
         return Promise.resolve(false);
@@ -26,13 +23,13 @@ const waitForNextInspection = (intervalMs, signal) => {
         signal?.addEventListener('abort', abort, { once: true });
     });
 };
-export const createFetchRuntimeTransport = ({ endpoint = DEFAULT_RUNTIME_ENDPOINT, fetch: fetchRequest = globalThis.fetch, requestId = defaultRequestId, requestInit, durableOperation = {}, } = {}) => {
+export const createFetchRuntimeTransport = ({ endpoint = DEFAULT_RUNTIME_ENDPOINT, fetch: fetchRequest = globalThis.fetch, requestId, requestInit, durableOperation = {}, } = {}) => {
     const pollIntervalMs = durableOperation.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
     if (!Number.isFinite(pollIntervalMs) || pollIntervalMs < 0) {
         throw new TypeError('Durable Operation poll interval must be a non-negative finite number.');
     }
     const request = async (runtimeRequest, options) => {
-        const init = requestInit?.() ?? {};
+        const init = requestInit?.(options?.transportOptions) ?? {};
         const headers = new Headers(init.headers);
         if (!headers.has('content-type'))
             headers.set('content-type', 'application/json');
@@ -53,18 +50,17 @@ export const createFetchRuntimeTransport = ({ endpoint = DEFAULT_RUNTIME_ENDPOIN
         }
         return parsed.response;
     };
+    const exchange = createRuntimeProtocolExchange({
+        transport: { request },
+        requestId,
+    });
     const observe = async function* (run, options) {
         while (!options?.signal?.aborted) {
-            const runtimeRequest = createRuntimeProtocolRequest({
-                id: requestId(),
+            const responseBody = await exchange({
                 family: 'durable.operation',
                 body: toDurableOperationProtocolRequest(run),
-            });
-            const runtimeResponse = await request(runtimeRequest, options);
-            if (isRuntimeProtocolError(runtimeResponse)) {
-                throw new Error(runtimeResponse.error.message);
-            }
-            const parsed = parseDurableOperationProtocolResponse(runtimeResponse.body);
+            }, options?.signal ? { signal: options.signal } : undefined);
+            const parsed = parseDurableOperationProtocolResponse(responseBody);
             if (!parsed.success)
                 throw new Error(parsed.error.error.message);
             if (parsed.response.kind === 'protocol-error') {

package/dist/graph/fetch-runtime-transport.js.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-runtime-transport.js","sourceRoot":"","sources":["../../src/graph/fetch-runtime-transport.ts"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport type { TaskRunIdentity, TaskSnapshot } from '@ontahi/core/runtime/contracts';\nimport {\n  createRuntimeProtocolRequest,\n  isRuntimeProtocolError,\n  parseDurableOperationProtocolResponse,\n  parseRuntimeProtocolResponse,\n  toDurableOperationProtocolRequest,\n  type DurableOperationObservationCapability,\n  type RuntimeProtocolRequestEnvelope,\n  type RuntimeTransport,\n  type RuntimeTransportRequestOptions,\n} from '@ontahi/core/runtime/protocol';\n\nexport type FetchRuntimeTransportOptions = {\n  endpoint?: string;\n  fetch?: typeof globalThis.fetch;\n  requestId?: () => string;\n  requestInit?: () => Omit<RequestInit, 'body' | 'method' | 'signal'>;\n  durableOperation?: {\n    pollIntervalMs?: number;\n  };\n};\n\nexport type FetchRuntimeTransport = RuntimeTransport & {\n  readonly durableOperation: DurableOperationObservationCapability;\n};\n\nconst DEFAULT_RUNTIME_ENDPOINT = '/runtime';\nconst DEFAULT_POLL_INTERVAL_MS = 500;\nconst terminalTaskStatuses = new Set(['completed', 'failed', 'cancelled']);\nlet fallbackRequestSequence = 0;\n\nconst defaultRequestId = () =>\n  globalThis.crypto?.randomUUID?.() ??\n  `ontahi-runtime-${Date.now()}-${(fallbackRequestSequence += 1)}`;\n\nconst waitForNextInspection = (\n  intervalMs: number,\n  signal: AbortSignal | undefined,\n): Promise<boolean> => {\n  if (signal?.aborted) return Promise.resolve(false);\n  if (intervalMs === 0) return Promise.resolve(true);\n\n  return new Promise(resolve => {\n    let settled = false;\n    const finish = (shouldContinue: boolean) => {\n      if (settled) return;\n      settled = true;\n      clearTimeout(timeout);\n      signal?.removeEventListener('abort', abort);\n      resolve(shouldContinue);\n    };\n    const abort = () => finish(false);\n    const timeout = setTimeout(() => finish(true), intervalMs);\n    signal?.addEventListener('abort', abort, { once: true });\n  });\n};\n\nexport const createFetchRuntimeTransport = ({\n  endpoint = DEFAULT_RUNTIME_ENDPOINT,\n  fetch: fetchRequest = globalThis.fetch,\n  requestId = defaultRequestId,\n  requestInit,\n  durableOperation = {},\n}: FetchRuntimeTransportOptions = {}): FetchRuntimeTransport => {\n  const pollIntervalMs = durableOperation.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;\n  if (!Number.isFinite(pollIntervalMs) || pollIntervalMs < 0) {\n    throw new TypeError('Durable Operation poll interval must be a non-negative finite number.');\n  }\n\n  const request = async (\n    runtimeRequest: RuntimeProtocolRequestEnvelope,\n    options?: RuntimeTransportRequestOptions,\n  ) => {\n    const init = requestInit?.() ?? {};\n    const headers = new Headers(init.headers);\n    if (!headers.has('content-type')) headers.set('content-type', 'application/json');\n    const response = await fetchRequest(endpoint, {\n      ...init,\n      method: 'POST',\n      headers,\n      credentials: init.credentials ?? 'same-origin',\n      body: JSON.stringify(runtimeRequest),\n      ...(options?.signal ? { signal: options.signal } : {}),\n    });\n    const payload: unknown = await response.json().catch(() => null);\n    const parsed = parseRuntimeProtocolResponse(payload, runtimeRequest);\n    if (!parsed.success) throw new Error(parsed.error.error.message);\n    if (!response.ok && !isRuntimeProtocolError(parsed.response)) {\n      throw new Error(`Runtime Protocol request failed with status ${response.status}.`);\n    }\n    return parsed.response;\n  };\n\n  const observe: DurableOperationObservationCapability['observe'] = async function* <TResult>(\n    run: TaskRunIdentity,\n    options?: RuntimeTransportRequestOptions,\n  ): AsyncIterable<TaskSnapshot<TResult>> {\n    while (!options?.signal?.aborted) {\n      const runtimeRequest = createRuntimeProtocolRequest({\n        id: requestId(),\n        family: 'durable.operation',\n        body: toDurableOperationProtocolRequest(run),\n      });\n      const runtimeResponse = await request(runtimeRequest, options);\n      if (isRuntimeProtocolError(runtimeResponse)) {\n        throw new Error(runtimeResponse.error.message);\n      }\n\n      const parsed = parseDurableOperationProtocolResponse(runtimeResponse.body);\n      if (!parsed.success) throw new Error(parsed.error.error.message);\n      if (parsed.response.kind === 'protocol-error') {\n        throw new Error(parsed.response.error.message);\n      }\n\n      const snapshot = parsed.response.snapshot as TaskSnapshot<TResult>;\n      if (snapshot.taskId !== run.taskId || snapshot.runId !== run.runId) {\n        throw new Error('Durable Operation snapshot identity does not match the observed run.');\n      }\n      yield snapshot;\n      if (terminalTaskStatuses.has(snapshot.status)) return;\n      if (!(await waitForNextInspection(pollIntervalMs, options?.signal))) return;\n    }\n  };\n\n  return {\n    request,\n    durableOperation: { observe },\n  };\n};\n"]}
+{"version":3,"file":"fetch-runtime-transport.js","sourceRoot":"","sources":["../../src/graph/fetch-runtime-transport.ts"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport type { TaskRunIdentity, TaskSnapshot } from '@ontahi/core/runtime/contracts';\nimport {\n  createRuntimeProtocolExchange,\n  isRuntimeProtocolError,\n  parseDurableOperationProtocolResponse,\n  parseRuntimeProtocolResponse,\n  toDurableOperationProtocolRequest,\n  type DurableOperationObservationCapability,\n  type RuntimeProtocolRequestEnvelope,\n  type RuntimeTransport,\n  type RuntimeTransportRequestOptions,\n} from '@ontahi/core/runtime/protocol';\n\nexport type FetchRuntimeTransportOptions<TTransportOptions = undefined> = {\n  endpoint?: string;\n  fetch?: typeof globalThis.fetch;\n  requestId?: () => string;\n  requestInit?: (options?: TTransportOptions) => Omit<RequestInit, 'body' | 'method'>;\n  durableOperation?: {\n    pollIntervalMs?: number;\n  };\n};\n\nexport type FetchRuntimeTransport<TTransportOptions = undefined> =\n  RuntimeTransport<TTransportOptions> & {\n    readonly durableOperation: DurableOperationObservationCapability;\n  };\n\nconst DEFAULT_RUNTIME_ENDPOINT = '/runtime';\nconst DEFAULT_POLL_INTERVAL_MS = 500;\nconst terminalTaskStatuses = new Set(['completed', 'failed', 'cancelled']);\n\nconst waitForNextInspection = (\n  intervalMs: number,\n  signal: AbortSignal | undefined,\n): Promise<boolean> => {\n  if (signal?.aborted) return Promise.resolve(false);\n  if (intervalMs === 0) return Promise.resolve(true);\n\n  return new Promise(resolve => {\n    let settled = false;\n    const finish = (shouldContinue: boolean) => {\n      if (settled) return;\n      settled = true;\n      clearTimeout(timeout);\n      signal?.removeEventListener('abort', abort);\n      resolve(shouldContinue);\n    };\n    const abort = () => finish(false);\n    const timeout = setTimeout(() => finish(true), intervalMs);\n    signal?.addEventListener('abort', abort, { once: true });\n  });\n};\n\nexport const createFetchRuntimeTransport = <TTransportOptions = undefined>({\n  endpoint = DEFAULT_RUNTIME_ENDPOINT,\n  fetch: fetchRequest = globalThis.fetch,\n  requestId,\n  requestInit,\n  durableOperation = {},\n}: FetchRuntimeTransportOptions<TTransportOptions> = {}): FetchRuntimeTransport<TTransportOptions> => {\n  const pollIntervalMs = durableOperation.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;\n  if (!Number.isFinite(pollIntervalMs) || pollIntervalMs < 0) {\n    throw new TypeError('Durable Operation poll interval must be a non-negative finite number.');\n  }\n\n  const request = async (\n    runtimeRequest: RuntimeProtocolRequestEnvelope,\n    options?: RuntimeTransportRequestOptions<TTransportOptions>,\n  ) => {\n    const init = requestInit?.(options?.transportOptions) ?? {};\n    const headers = new Headers(init.headers);\n    if (!headers.has('content-type')) headers.set('content-type', 'application/json');\n    const response = await fetchRequest(endpoint, {\n      ...init,\n      method: 'POST',\n      headers,\n      credentials: init.credentials ?? 'same-origin',\n      body: JSON.stringify(runtimeRequest),\n      ...(options?.signal ? { signal: options.signal } : {}),\n    });\n    const payload: unknown = await response.json().catch(() => null);\n    const parsed = parseRuntimeProtocolResponse(payload, runtimeRequest);\n    if (!parsed.success) throw new Error(parsed.error.error.message);\n    if (!response.ok && !isRuntimeProtocolError(parsed.response)) {\n      throw new Error(`Runtime Protocol request failed with status ${response.status}.`);\n    }\n    return parsed.response;\n  };\n  const exchange = createRuntimeProtocolExchange({\n    transport: { request },\n    requestId,\n  });\n\n  const observe: DurableOperationObservationCapability['observe'] = async function* <TResult>(\n    run: TaskRunIdentity,\n    options?: RuntimeTransportRequestOptions,\n  ): AsyncIterable<TaskSnapshot<TResult>> {\n    while (!options?.signal?.aborted) {\n      const responseBody = await exchange(\n        {\n          family: 'durable.operation',\n          body: toDurableOperationProtocolRequest(run),\n        },\n        options?.signal ? { signal: options.signal } : undefined,\n      );\n\n      const parsed = parseDurableOperationProtocolResponse(responseBody);\n      if (!parsed.success) throw new Error(parsed.error.error.message);\n      if (parsed.response.kind === 'protocol-error') {\n        throw new Error(parsed.response.error.message);\n      }\n\n      const snapshot = parsed.response.snapshot as TaskSnapshot<TResult>;\n      if (snapshot.taskId !== run.taskId || snapshot.runId !== run.runId) {\n        throw new Error('Durable Operation snapshot identity does not match the observed run.');\n      }\n      yield snapshot;\n      if (terminalTaskStatuses.has(snapshot.status)) return;\n      if (!(await waitForNextInspection(pollIntervalMs, options?.signal))) return;\n    }\n  };\n\n  return {\n    request,\n    durableOperation: { observe },\n  };\n};\n"]}

package/dist/graph/graph-hooks.d.ts

@@ -1,8 +1,9 @@
-import { type ManyToManyRelationshipCommand, type RelationshipCommandResult } from '@ontahi/core/data-graph';
+import { type ManyToManyRelationshipCommand, type OrderedRelationshipCommand, type RelationshipCommandResult } from '@ontahi/core/data-graph';
 import { type UseMutationResult, type UseQueryResult } from '@tanstack/react-query';
 import type { GraphCommandBuilder, GraphCommandHookOptions, GraphOperationLike, GraphOperationClientInput, GraphOperationResult, GraphQueryData, GraphQueryMode, GraphQueryOptions, GraphReadSource } from './executor.js';
 export declare function useGraphQuery<TRead extends GraphReadSource<any>, TMode extends GraphQueryMode = 'run', TReadOptions = unknown, TCommandOptions = TReadOptions>(read: TRead, options?: GraphQueryOptions<TRead, TMode, TReadOptions>): UseQueryResult<GraphQueryData<TRead, TMode>, Error>;
 export declare function useGraphCommand<TVariables, TResult = void, TContext = unknown, TReadOptions = unknown, TCommandOptions = TReadOptions>(buildCommand: GraphCommandBuilder<TVariables, TResult>, options?: GraphCommandHookOptions<TResult, TVariables, TContext, TCommandOptions>): UseMutationResult<TResult, Error, TVariables, TContext>;
 export declare function useManyToManyRelationshipCommand<TVariables, TContext = unknown, TReadOptions = unknown, TCommandOptions = TReadOptions>(buildCommand: (variables: TVariables) => ManyToManyRelationshipCommand, options?: GraphCommandHookOptions<RelationshipCommandResult, TVariables, TContext, TCommandOptions>): UseMutationResult<RelationshipCommandResult, Error, TVariables, TContext>;
+export declare function useOrderedRelationshipCommand<TVariables, TContext = unknown, TReadOptions = unknown, TCommandOptions = TReadOptions>(buildCommand: (variables: TVariables) => OrderedRelationshipCommand, options?: GraphCommandHookOptions<RelationshipCommandResult, TVariables, TContext, TCommandOptions>): UseMutationResult<RelationshipCommandResult, Error, TVariables, TContext>;
 export declare function useGraphOperation<TOperation extends GraphOperationLike<any, any>, TContext = unknown, TReadOptions = unknown, TCommandOptions = TReadOptions>(operation: TOperation, options?: GraphCommandHookOptions<GraphOperationResult<TOperation>, GraphOperationClientInput<TOperation>, TContext, TCommandOptions>): UseMutationResult<GraphOperationResult<TOperation>, Error, GraphOperationClientInput<TOperation>, TContext>;
 //# sourceMappingURL=graph-hooks.d.ts.map

package/dist/graph/graph-hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph-hooks.d.ts","sourceRoot":"","sources":["../../src/graph/graph-hooks.ts"],"names":[],"mappings":"AAEA,OAAO,EAOL,KAAK,6BAA6B,EAClC,KAAK,yBAAyB,EAG/B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAKL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EAGV,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,yBAAyB,EACzB,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,eAAe,EAGhB,MAAM,eAAe,CAAC;AAgEvB,wBAAgB,aAAa,CAC3B,KAAK,SAAS,eAAe,CAAC,GAAG,CAAC,EAClC,KAAK,SAAS,cAAc,GAAG,KAAK,EACpC,YAAY,GAAG,OAAO,EACtB,eAAe,GAAG,YAAY,EAE9B,IAAI,EAAE,KAAK,EACX,OAAO,CAAC,EAAE,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,GACtD,cAAc,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,CA6BrD;AAED,wBAAgB,eAAe,CAC7B,UAAU,EACV,OAAO,GAAG,IAAI,EACd,QAAQ,GAAG,OAAO,EAClB,YAAY,GAAG,OAAO,EACtB,eAAe,GAAG,YAAY,EAE9B,YAAY,EAAE,mBAAmB,CAAC,UAAU,EAAE,OAAO,CAAC,EACtD,OAAO,CAAC,EAAE,uBAAuB,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,eAAe,CAAC,GAChF,iBAAiB,CAAC,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC,CAoBzD;AAED,wBAAgB,gCAAgC,CAC9C,UAAU,EACV,QAAQ,GAAG,OAAO,EAClB,YAAY,GAAG,OAAO,EACtB,eAAe,GAAG,YAAY,EAE9B,YAAY,EAAE,CAAC,SAAS,EAAE,UAAU,KAAK,6BAA6B,EACtE,OAAO,CAAC,EAAE,uBAAuB,CAC/B,yBAAyB,EACzB,UAAU,EACV,QAAQ,EACR,eAAe,CAChB,GACA,iBAAiB,CAAC,yBAAyB,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC,CAuB3E;AAED,wBAAgB,iBAAiB,CAC/B,UAAU,SAAS,kBAAkB,CAAC,GAAG,EAAE,GAAG,CAAC,EAC/C,QAAQ,GAAG,OAAO,EAClB,YAAY,GAAG,OAAO,EACtB,eAAe,GAAG,YAAY,EAE9B,SAAS,EAAE,UAAU,EACrB,OAAO,CAAC,EAAE,uBAAuB,CAC/B,oBAAoB,CAAC,UAAU,CAAC,EAChC,yBAAyB,CAAC,UAAU,CAAC,EACrC,QAAQ,EACR,eAAe,CAChB,GACA,iBAAiB,CAClB,oBAAoB,CAAC,UAAU,CAAC,EAChC,KAAK,EACL,yBAAyB,CAAC,UAAU,CAAC,EACrC,QAAQ,CACT,CAiBA"}
+{"version":3,"file":"graph-hooks.d.ts","sourceRoot":"","sources":["../../src/graph/graph-hooks.ts"],"names":[],"mappings":"AAEA,OAAO,EASL,KAAK,6BAA6B,EAClC,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAG/B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAKL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EAGV,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,yBAAyB,EACzB,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,eAAe,EAGhB,MAAM,eAAe,CAAC;AAgEvB,wBAAgB,aAAa,CAC3B,KAAK,SAAS,eAAe,CAAC,GAAG,CAAC,EAClC,KAAK,SAAS,cAAc,GAAG,KAAK,EACpC,YAAY,GAAG,OAAO,EACtB,eAAe,GAAG,YAAY,EAE9B,IAAI,EAAE,KAAK,EACX,OAAO,CAAC,EAAE,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,GACtD,cAAc,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,CA4CrD;AAED,wBAAgB,eAAe,CAC7B,UAAU,EACV,OAAO,GAAG,IAAI,EACd,QAAQ,GAAG,OAAO,EAClB,YAAY,GAAG,OAAO,EACtB,eAAe,GAAG,YAAY,EAE9B,YAAY,EAAE,mBAAmB,CAAC,UAAU,EAAE,OAAO,CAAC,EACtD,OAAO,CAAC,EAAE,uBAAuB,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,eAAe,CAAC,GAChF,iBAAiB,CAAC,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC,CAoBzD;AAED,wBAAgB,gCAAgC,CAC9C,UAAU,EACV,QAAQ,GAAG,OAAO,EAClB,YAAY,GAAG,OAAO,EACtB,eAAe,GAAG,YAAY,EAE9B,YAAY,EAAE,CAAC,SAAS,EAAE,UAAU,KAAK,6BAA6B,EACtE,OAAO,CAAC,EAAE,uBAAuB,CAC/B,yBAAyB,EACzB,UAAU,EACV,QAAQ,EACR,eAAe,CAChB,GACA,iBAAiB,CAAC,yBAAyB,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC,CAuB3E;AAED,wBAAgB,6BAA6B,CAC3C,UAAU,EACV,QAAQ,GAAG,OAAO,EAClB,YAAY,GAAG,OAAO,EACtB,eAAe,GAAG,YAAY,EAE9B,YAAY,EAAE,CAAC,SAAS,EAAE,UAAU,KAAK,0BAA0B,EACnE,OAAO,CAAC,EAAE,uBAAuB,CAC/B,yBAAyB,EACzB,UAAU,EACV,QAAQ,EACR,eAAe,CAChB,GACA,iBAAiB,CAAC,yBAAyB,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC,CAuB3E;AAED,wBAAgB,iBAAiB,CAC/B,UAAU,SAAS,kBAAkB,CAAC,GAAG,EAAE,GAAG,CAAC,EAC/C,QAAQ,GAAG,OAAO,EAClB,YAAY,GAAG,OAAO,EACtB,eAAe,GAAG,YAAY,EAE9B,SAAS,EAAE,UAAU,EACrB,OAAO,CAAC,EAAE,uBAAuB,CAC/B,oBAAoB,CAAC,UAAU,CAAC,EAChC,yBAAyB,CAAC,UAAU,CAAC,EACrC,QAAQ,EACR,eAAe,CAChB,GACA,iBAAiB,CAClB,oBAAoB,CAAC,UAAU,CAAC,EAChC,KAAK,EACL,yBAAyB,CAAC,UAAU,CAAC,EACrC,QAAQ,CACT,CAiBA"}

package/dist/graph/graph-hooks.js

@@ -1,8 +1,8 @@
 'use client';
-import { isGraphReadExpression, normalizeGraphSchemaClientInput, resolveQuerySpec, toGraphReadRequest, } from '@ontahi/core/data-graph';
+import { getGraphReadOutputDescriptor, graphOutput, isGraphReadExpression, normalizeGraphSchemaClientInput, resolveQuerySpec, toGraphReadRequest, } from '@ontahi/core/data-graph';
 import { executionIdentityCacheKey } from '@ontahi/core/runtime/identity';
 import { useMutation, useQuery, useQueryClient, } from '@tanstack/react-query';
-import { useExecutionIdentity, useGraphExecutor } from './context.js';
+import { useExecutionIdentity, useGraphClientCache, useGraphExecutor } from './context.js';
 const isQueryOrView = (read) => 'kind' in read;
 const isBuildableRead = (read) => typeof read.build === 'function';
 const isNamedView = (read) => 'kind' in read && read.kind === 'view';
@@ -35,14 +35,16 @@ const deriveGraphQueryKey = (read, intent, params, identityKey) => {
 export function useGraphQuery(read, options) {
     const graphExecutor = useGraphExecutor();
     const identity = useExecutionIdentity();
+    const clientCache = useGraphClientCache();
     const expression = isGraphReadExpression(read) ? read : undefined;
     const source = (expression?.read ?? read);
     const mode = options?.mode ?? 'run';
     const intent = expression?.intent ?? intentFromMode(mode);
+    const queryKey = options?.queryKey ??
+        deriveGraphQueryKey(source, intent, options?.params, executionIdentityCacheKey(identity));
     return useQuery({
         ...options,
-        queryKey: options?.queryKey ??
-            deriveGraphQueryKey(source, intent, options?.params, executionIdentityCacheKey(identity)),
+        queryKey,
         queryFn: async () => {
             const resolved = resolveGraphRead(source);
             const params = options?.params;
@@ -53,6 +55,12 @@ export function useGraphQuery(read, options) {
                     : intent === 'exists'
                         ? (await graphExecutor.get(resolved, params, options?.runtimeOptions)) != null
                         : await graphExecutor.get(resolved, params, options?.runtimeOptions);
+            const descriptor = intent === 'count' || intent === 'exists'
+                ? graphOutput.opaque()
+                : getGraphReadOutputDescriptor(resolved, params);
+            clientCache.writeOutput(queryKey, descriptor.kind === 'graph-output.array' && intent !== 'many'
+                ? graphOutput.nullable(descriptor.item)
+                : descriptor, value, { kind: 'graph-read', name: resolveQuerySpec(resolved, params).root.name });
             return value;
         },
     });
@@ -92,6 +100,26 @@ export function useManyToManyRelationshipCommand(buildCommand, options) {
         },
     });
 }
+export function useOrderedRelationshipCommand(buildCommand, options) {
+    const graphExecutor = useGraphExecutor();
+    const queryClient = useQueryClient();
+    return useMutation({
+        ...options,
+        mutationKey: options?.mutationKey,
+        mutationFn: variables => {
+            if (!graphExecutor.runOrderedRelationshipCommand) {
+                throw new Error('Graph executor does not support ordered Relationship Commands.');
+            }
+            return graphExecutor.runOrderedRelationshipCommand(buildCommand(variables), options?.runtimeOptions);
+        },
+        onSuccess: async (data, variables, onMutateResult, context) => {
+            for (const queryKey of options?.invalidateQueryKeys ?? []) {
+                await queryClient.invalidateQueries({ queryKey });
+            }
+            await options?.onSuccess?.(data, variables, onMutateResult, context);
+        },
+    });
+}
 export function useGraphOperation(operation, options) {
     const buildCommand = (variables) => operation.run((operation.input
         ? normalizeGraphSchemaClientInput(operation.input, variables)