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

package/README.md

@@ -50,9 +50,10 @@ const total = useGraphQuery(openTodos.count());
 const first = useGraphQuery(openTodos.first());
 ```
 
-`OntahiGraphProvider` installs a conventional same-origin Fetch client by default. It connects
-graph reads to `/graph/reads`, Operations to `/operations`, Durable Operation observation to the
-Runtime Protocol at `/runtime`, and reflected Explorer data to `/explorer/entities`. These
+`OntahiGraphProvider` installs a conventional same-origin Fetch client by default. Operation
+invocation and permission, Graph Read, Graph Command, and Durable Operation inspection all use one
+Runtime Transport at `POST /runtime`. Reflected Explorer data remains outside the registered
+Runtime Protocol families at `/explorer/entities` and `/explorer/related-entities`. These
 capabilities are lazy: declaring the provider does not issue a request until the application uses
 one of them.
 
@@ -61,6 +62,30 @@ configured client with `client={createFetchGraphClient(...)}`, or set `client={f
 explicit provider. Server routes, read policies, and authorization remain opt-in and authoritative;
 the default removes client wiring, not the server security boundary.
 
+Contextual Selection reads (for example `Book.by(...).parts.chapters.toQuery()`) negotiate Graph
+Read v2 through the same transport before execution, with the same request options/credentials.
+The server must use supporting storage and grant each outgoing `selectionRelations` hop. Discovery
+does not authorize the read or fetch source IDs; missing support fails explicitly without fallback.
+Plain reads remain v1 with no discovery round trip. Contextual observation is not supported yet.
+
+Classified reads lower to the canonical base Entity before reaching these providers. Use
+`useGraphQuery(Chapter.all().many())` (or a runtime-bound variant's `.many()`) and the usual scalar
+intents. Base and sibling variant reads have distinct membership keys under the same base-Entity
+prefix, so host-triggered `invalidateQueries({ queryKey: [ContentNode.name] })` refetches all of them.
+`useGraphQuery` does not automatically subscribe to `observe()`.
+
+With an observation-capable Runtime Transport, `client.graph.bindVariantSelection(Chapter.all())`
+supports `.exec().observe()`. Complete snapshots recalculate membership, ordering and limits;
+the Runtime Graph client reconciles them through base Entity identity. Leaving a variant is not
+deleting its base record. Removing an Entity from a snapshot does not globally evict it: the host
+still owns confirmed-delete invalidation, cache scoping and lifetime. A simultaneously observed
+base Query can update the shared cached record when its classification changes.
+
+Cancelling an observation now aborts its transport signal before waiting for the iterator to close,
+releasing idle subscriptions without affecting other readers. Transports must honor that signal.
+These contracts have an in-process receiver/in-memory provider/React integration proof; they do
+not yet establish a variant mutation lifecycle or live SQL change-feed support.
+
 The same client supports fluent execution outside React hooks:
 
 ```ts
@@ -87,6 +112,14 @@ logout, service identity, tenant, or workspace changes. An explicit `queryKey` r
 for lower-level reads that cannot be encoded by the graph-read protocol, and the legacy explicit
 `mode` API remains compatible.
 
+Successful `useGraphQuery` reads and refetches also populate the provider's `clientCache`.
+Selected entity identities, including nested relations described by the View, are reconciled into
+canonical records; the output is stored under the query key. Singular reads retain their singular
+shape, and count/exists outputs remain scalars. Failed reads do not write cache entries. The hook
+continues returning the executor's result through React Query; this does not turn direct executor
+calls or optimistic component state into cache writes. A row disappearing from a filtered result
+does not imply that its canonical entity was deleted.
+
 First-class Operation invocations bind render-owned input without losing the declaration form:
 
 ```ts
@@ -123,11 +156,56 @@ const client = createFetchGraphClient({
 });
 ```
 
-Hosts can replace `runtimeTransport` independently on `OntahiGraphProvider`; a future push-capable
-transport can yield the same snapshots without changing the hook.
+The endpoint, Fetch implementation, credentials, headers, per-call request initialization, abort
+signal, and request-id generator configured there serve every common request/response family.
+For a WebSocket host, compose the same graph client around the push-capable transport:
+
+```ts
+const runtimeTransport = createWebSocketRuntimeTransport({ url: 'wss://app.example/runtime' });
+const client = createRuntimeGraphClient({ runtimeTransport });
+```
+
+The transport opens one lazy session, correlates concurrent Runtime Protocol requests, and sends
+one Durable observation control frame per run. Sequenced snapshots are pushed over that socket;
+the browser does not issue repeated `inspect` requests. Aborting the hook sends an unsubscribe and
+releases both sides. A disconnected observation fails and is not silently resumed; a later request
+may open a new connection, but the application or a future resume contract must explicitly
+re-establish observation. `useDurableOperation` itself is unchanged.
+
+An application may compose Fetch and WebSocket behind its own `RuntimeTransport` and route each
+request from `request.family`; it can select the Durable observer independently. Operation bridge
+inputs backed by a Graph schema are converted to their portable Selection AST before strict
+Runtime Protocol validation, so the same `useOperation(Entity.domain.operation)` authoring works
+through either transport. The Todo example includes an interactive per-family routing lab.
+
+Legacy family routes are opt-in migration surfaces:
+
+```ts
+const client = createFetchGraphClient({
+  runtimeTransport: { endpoint: '/runtime' },
+  compatibility: {
+    operation: { endpoint: '/operations' },
+    graphRead: { endpoint: '/graph/reads' },
+    graphCommand: { endpoint: '/graph/commands' },
+  },
+});
+```
+
+An entry in `compatibility` selects that family’s legacy body and endpoint; every unlisted family
+stays on Runtime Transport. It takes precedence over the deprecated `operations.endpoint`,
+`operations.mountPath`, `graphRead.endpoint`, and `graphRead.commandEndpoint` aliases. Selection is
+deterministic before transmission. A common request is never retried against a legacy endpoint
+after a network or server failure, because replaying an Operation or Command could duplicate its
+effect.
 
 The Fetch executor sends only canonical graph-read and graph-Command requests. Credentials and
 other trusted request state remain in Fetch initialization and are never embedded in a Query AST or
 Command. The executor supports policy-bounded Relationship Commands and identity-scoped Entity
 Mutation Commands; `useGraphExecutorCapability()` lets optional reflective UI discover whether the
 host installed that execution surface without making it mandatory for read-only hosts.
+
+`useOrderedRelationshipCommand` executes `move`/`before`/`after`/`prepend`/`append` commands through
+the same Fetch or WebSocket Runtime Transport. Its result includes an exact `moved` delta, while a
+stale exact-neighborhood precondition follows the command's fail-or-skip policy. Optimistic UI may
+project the requested order temporarily, but the authoritative sequence should be refetched from
+the ordered Relation after completion.

package/dist/actions/fetch-operation-bridge-adapter.d.ts

@@ -1,9 +1,16 @@
 import type { ReflectedOperationInvoker } from '@ontahi/core/data-graph';
+import { type RuntimeTransport } from '@ontahi/core/runtime/protocol';
 import type * as OperationBridge from './operation-bridge.js';
-export type FetchOperationBridgeOptions = {
+export type FetchOperationBridgeOptions<TTransportOptions = undefined> = {
+    /** @deprecated Select the legacy Operation route through createFetchGraphClient compatibility. */
     mountPath?: string;
+    /** @deprecated Select the legacy Operation route through createFetchGraphClient compatibility. */
     endpoint?: string;
+    fetch?: typeof globalThis.fetch;
+    requestInit?: (options?: TTransportOptions) => Omit<RequestInit, 'body' | 'method'>;
+    runtimeTransport?: RuntimeTransport<TTransportOptions>;
+    requestId?: () => string;
 };
-export declare const createFetchReflectedOperationInvoker: (options?: FetchOperationBridgeOptions) => ReflectedOperationInvoker;
-export declare const createFetchOperationBridgeAdapter: (options?: FetchOperationBridgeOptions) => OperationBridge.AnyOperationBridgeAdapter;
+export declare const createFetchReflectedOperationInvoker: <TTransportOptions = undefined>(options?: FetchOperationBridgeOptions<TTransportOptions>) => ReflectedOperationInvoker;
+export declare const createFetchOperationBridgeAdapter: <TTransportOptions = undefined>(options?: FetchOperationBridgeOptions<TTransportOptions>) => OperationBridge.AnyOperationBridgeAdapter;
 //# sourceMappingURL=fetch-operation-bridge-adapter.d.ts.map

package/dist/actions/fetch-operation-bridge-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-operation-bridge-adapter.d.ts","sourceRoot":"","sources":["../../src/actions/fetch-operation-bridge-adapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,yBAAyB,EAC1B,MAAM,yBAAyB,CAAC;AAcjC,OAAO,KAAK,KAAK,eAAe,MAAM,uBAAuB,CAAC;AAI9D,MAAM,MAAM,2BAA2B,GAAG;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAwFF,eAAO,MAAM,oCAAoC,GAC/C,UAAS,2BAAgC,KACxC,yBAoCF,CAAC;AAEF,eAAO,MAAM,iCAAiC,GAC5C,UAAS,2BAAgC,KACxC,eAAe,CAAC,yBAyClB,CAAC"}
+{"version":3,"file":"fetch-operation-bridge-adapter.d.ts","sourceRoot":"","sources":["../../src/actions/fetch-operation-bridge-adapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,yBAAyB,EAC1B,MAAM,yBAAyB,CAAC;AAUjC,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,+BAA+B,CAAC;AAUvC,OAAO,KAAK,KAAK,eAAe,MAAM,uBAAuB,CAAC;AAI9D,MAAM,MAAM,2BAA2B,CAAC,iBAAiB,GAAG,SAAS,IAAI;IACvE,kGAAkG;IAClG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kGAAkG;IAClG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,WAAW,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,iBAAiB,KAAK,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC;IACpF,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,iBAAiB,CAAC,CAAC;IACvD,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;CAC1B,CAAC;AAsJF,eAAO,MAAM,oCAAoC,GAAI,iBAAiB,GAAG,SAAS,EAChF,UAAS,2BAA2B,CAAC,iBAAiB,CAAM,KAC3D,yBAoCF,CAAC;AAEF,eAAO,MAAM,iCAAiC,GAAI,iBAAiB,GAAG,SAAS,EAC7E,UAAS,2BAA2B,CAAC,iBAAiB,CAAM,KAC3D,eAAe,CAAC,yBAyClB,CAAC"}

package/dist/actions/fetch-operation-bridge-adapter.js

@@ -1,36 +1,71 @@
 'use client';
-import { resolveOperationExecutionAffordance } from '@ontahi/core/data-graph';
+import { normalizeGraphSchemaClientInput, resolveOperationExecutionAffordance, } from '@ontahi/core/data-graph';
 import { isOperationInvocationProtocolResponse, } from '@ontahi/core/runtime/operation-invocation';
+import { createRuntimeProtocolExchange, toOperationProtocolRequest, } from '@ontahi/core/runtime/protocol';
 import { useMemo } from 'react';
+import { createFetchRuntimeTransport } from '../graph/fetch-runtime-transport.js';
 import { attachOperationBridgeActionRuntime, toOperationInvocationResult, unwrapOperationInvocationValue, } from './operation-bridge.js';
 import { useServerMutation, useServerQuery } from './react-query.js';
-const DEFAULT_ENDPOINT = '/api/data-graph/domain-operations';
 const normalizeMountPath = (value) => {
     const path = value.startsWith('/') ? value : `/${value}`;
-    return path === '/' ? '' : path.replace(/\/+$/, '');
+    let end = path.length;
+    while (end > 0 && path.charCodeAt(end - 1) === 47)
+        end -= 1;
+    return path.slice(0, end);
 };
 const mountedEndpoint = (mountPath, endpoint) => `${normalizeMountPath(mountPath)}/${endpoint}`;
 const operationEndpoint = (options) => options.endpoint ??
-    (options.mountPath ? mountedEndpoint(options.mountPath, 'operations') : DEFAULT_ENDPOINT);
+    (options.mountPath ? mountedEndpoint(options.mountPath, 'operations') : undefined);
 const attachFetchBridgeRuntime = (operation, action) => attachOperationBridgeActionRuntime(operation, action, {
     requiresAuth: operation.authority !== 'server' ? false : operation.exposure !== 'bridge',
 });
-const postBridgeRequest = async (endpoint, request) => {
-    const response = await fetch(endpoint, {
+const postLegacyBridgeRequest = async (endpoint, request, fetchRequest, requestInit) => {
+    const init = requestInit?.() ?? {};
+    const headers = new Headers(init.headers);
+    if (!headers.has('content-type'))
+        headers.set('content-type', 'application/json');
+    const response = await fetchRequest(endpoint, {
+        ...init,
         method: 'POST',
-        headers: {
-            'content-type': 'application/json',
-        },
-        credentials: 'same-origin',
+        headers,
+        credentials: init.credentials ?? 'same-origin',
         body: JSON.stringify(request),
     });
     const payload = await response.json().catch(() => null);
+    if (!response.ok && !isOperationInvocationProtocolResponse(payload)) {
+        throw new Error(`Graph bridge request failed with status ${response.status}.`);
+    }
+    return payload;
+};
+const createOperationRequest = (options) => {
+    const endpoint = operationEndpoint(options);
+    if (endpoint) {
+        return request => postLegacyBridgeRequest(endpoint, request, options.fetch ?? globalThis.fetch, options.requestInit);
+    }
+    const exchange = createRuntimeProtocolExchange({
+        transport: options.runtimeTransport ??
+            createFetchRuntimeTransport({
+                ...(options.fetch ? { fetch: options.fetch } : {}),
+                ...(options.requestInit ? { requestInit: options.requestInit } : {}),
+            }),
+        requestId: options.requestId,
+    });
+    return request => exchange({
+        family: 'operation',
+        body: toOperationProtocolRequest(request),
+    });
+};
+const errorMessage = (error) => error instanceof Error ? error.message : 'Graph bridge request failed.';
+const postBridgeRequest = async (requestOperation, request) => {
+    let payload;
+    try {
+        payload = await requestOperation(request);
+    }
+    catch (error) {
+        return { serverError: errorMessage(error) };
+    }
     if (!isOperationInvocationProtocolResponse(payload)) {
-        return {
-            serverError: response.ok
-                ? 'Graph bridge returned an invalid response.'
-                : `Graph bridge request failed with status ${response.status}.`,
-        };
+        return { serverError: 'Graph bridge returned an invalid response.' };
     }
     if (payload.kind === 'protocol-error') {
         return { serverError: payload.error.message };
@@ -43,19 +78,30 @@ const postBridgeRequest = async (endpoint, request) => {
     }
     return { serverError: 'Graph bridge returned an invalid response.' };
 };
-const createFetchBridgeAction = (endpoint, operation) => attachFetchBridgeRuntime(operation, (input) => postBridgeRequest(endpoint, {
-    kind: 'invoke',
-    operationId: operation.id,
-    input,
-    ...(operation.view ? { view: operation.view } : {}),
-}));
-const createFetchPermissionAction = (endpoint, operation) => (input) => postBridgeRequest(endpoint, {
+const createFetchBridgeAction = (requestOperation, operation) => attachFetchBridgeRuntime(operation, (input) => {
+    const portableInput = operation.input
+        ? normalizeGraphSchemaClientInput(operation.input, input, {
+            bindSelection: selection => selection.toAst(),
+        })
+        : input;
+    return postBridgeRequest(requestOperation, {
+        kind: 'invoke',
+        operationId: operation.id,
+        input: portableInput,
+        ...(operation.view ? { view: operation.view } : {}),
+    });
+});
+const createFetchPermissionAction = (requestOperation, operation) => (input) => postBridgeRequest(requestOperation, {
     kind: 'check-permission',
     operationId: operation.id,
-    input,
+    input: operation.input
+        ? normalizeGraphSchemaClientInput(operation.input, input, {
+            bindSelection: selection => selection.toAst(),
+        })
+        : input,
 });
 export const createFetchReflectedOperationInvoker = (options = {}) => {
-    const endpoint = operationEndpoint(options);
+    const requestOperation = createOperationRequest(options);
     const canInvokeOperation = operation => operation.kind === undefined
         ? operation.exposure === undefined || operation.exposure === 'bridge'
         : operation.kind !== 'graph' && operation.exposure === 'bridge';
@@ -71,7 +117,7 @@ export const createFetchReflectedOperationInvoker = (options = {}) => {
                 }
                 : {}),
         }),
-        invokeOperation: async ({ input, operationId, view, }) => toOperationInvocationResult(await postBridgeRequest(endpoint, {
+        invokeOperation: async ({ input, operationId, view, }) => toOperationInvocationResult(await postBridgeRequest(requestOperation, {
             kind: 'invoke',
             operationId,
             input,
@@ -80,8 +126,8 @@ export const createFetchReflectedOperationInvoker = (options = {}) => {
     };
 };
 export const createFetchOperationBridgeAdapter = (options = {}) => {
-    const endpoint = operationEndpoint(options);
-    const buildRuntimeAction = (operation) => createFetchBridgeAction(endpoint, operation);
+    const requestOperation = createOperationRequest(options);
+    const buildRuntimeAction = (operation) => createFetchBridgeAction(requestOperation, operation);
     return {
         name: 'fetch',
         useBridgeAction: operation => useMemo(() => buildRuntimeAction(operation), [operation]),
@@ -100,7 +146,7 @@ export const createFetchOperationBridgeAdapter = (options = {}) => {
         },
         usePermission: (operation, input, args) => useServerQuery({
             enabled: args?.enabled,
-            action: createFetchPermissionAction(endpoint, operation),
+            action: createFetchPermissionAction(requestOperation, operation),
             input,
             key: args?.queryKey ?? ['graph-permission', operation.id, input],
         }),

package/dist/actions/fetch-operation-bridge-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-operation-bridge-adapter.js","sourceRoot":"","sources":["../../src/actions/fetch-operation-bridge-adapter.ts"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport type {\n  ReflectedOperationInvocation,\n  ReflectedOperationInvoker,\n} from '@ontahi/core/data-graph';\nimport { resolveOperationExecutionAffordance } from '@ontahi/core/data-graph';\nimport type { OperationInvocationResult } from '@ontahi/core/runtime/contracts';\nimport {\n  isOperationInvocationProtocolResponse,\n  type OperationInvocationRequest,\n} from '@ontahi/core/runtime/operation-invocation';\nimport { useMemo } from 'react';\n\nimport {\n  attachOperationBridgeActionRuntime,\n  toOperationInvocationResult,\n  unwrapOperationInvocationValue,\n} from './operation-bridge.js';\nimport type * as OperationBridge from './operation-bridge.js';\nimport { useServerMutation, useServerQuery } from './react-query.js';\nimport type { ActionResultLike } from './use-action.js';\n\nexport type FetchOperationBridgeOptions = {\n  mountPath?: string;\n  endpoint?: string;\n};\n\nconst DEFAULT_ENDPOINT = '/api/data-graph/domain-operations';\n\nconst normalizeMountPath = (value: string) => {\n  const path = value.startsWith('/') ? value : `/${value}`;\n  return path === '/' ? '' : path.replace(/\\/+$/, '');\n};\n\nconst mountedEndpoint = (mountPath: string, endpoint: string) =>\n  `${normalizeMountPath(mountPath)}/${endpoint}`;\n\nconst operationEndpoint = (options: FetchOperationBridgeOptions) =>\n  options.endpoint ??\n  (options.mountPath ? mountedEndpoint(options.mountPath, 'operations') : DEFAULT_ENDPOINT);\n\nconst attachFetchBridgeRuntime = <TInput, TData>(\n  operation: OperationBridge.BridgedOperationLike<TInput, TData>,\n  action: OperationBridge.OperationBridgeAction<TInput, TData>,\n) =>\n  attachOperationBridgeActionRuntime(operation, action, {\n    requiresAuth: operation.authority !== 'server' ? false : operation.exposure !== 'bridge',\n  });\n\nconst postBridgeRequest = async <TData>(\n  endpoint: string,\n  request: OperationInvocationRequest,\n): Promise<ActionResultLike & { data?: TData }> => {\n  const response = await fetch(endpoint, {\n    method: 'POST',\n    headers: {\n      'content-type': 'application/json',\n    },\n    credentials: 'same-origin',\n    body: JSON.stringify(request),\n  });\n  const payload: unknown = await response.json().catch(() => null);\n\n  if (!isOperationInvocationProtocolResponse(payload)) {\n    return {\n      serverError: response.ok\n        ? 'Graph bridge returned an invalid response.'\n        : `Graph bridge request failed with status ${response.status}.`,\n    };\n  }\n\n  if (payload.kind === 'protocol-error') {\n    return { serverError: payload.error.message };\n  }\n\n  if (request.kind === 'invoke' && payload.kind === 'invocation-result') {\n    return { data: payload.result as TData };\n  }\n\n  if (request.kind === 'check-permission' && payload.kind === 'permission-result') {\n    return { data: payload.result as TData };\n  }\n\n  return { serverError: 'Graph bridge returned an invalid response.' };\n};\n\nconst createFetchBridgeAction = <TInput, TData>(\n  endpoint: string,\n  operation: OperationBridge.BridgedOperationLike<TInput, TData>,\n): OperationBridge.OperationBridgeAction<TInput, TData> =>\n  attachFetchBridgeRuntime(operation, (input: TInput) =>\n    postBridgeRequest<OperationInvocationResult<TData>>(endpoint, {\n      kind: 'invoke',\n      operationId: operation.id,\n      input,\n      ...(operation.view ? { view: operation.view } : {}),\n    }),\n  ) as OperationBridge.OperationBridgeAction<TInput, TData>;\n\nconst createFetchPermissionAction =\n  <TInput, TData>(\n    endpoint: string,\n    operation: OperationBridge.BridgedOperationLike<TInput, TData>,\n  ): ((\n    input: TInput,\n  ) => Promise<OperationBridge.OperationBridgeActionResult<OperationBridge.GraphPermission>>) =>\n  (input: TInput) =>\n    postBridgeRequest<OperationBridge.GraphPermission>(endpoint, {\n      kind: 'check-permission',\n      operationId: operation.id,\n      input,\n    });\n\nexport const createFetchReflectedOperationInvoker = (\n  options: FetchOperationBridgeOptions = {},\n): ReflectedOperationInvoker => {\n  const endpoint = operationEndpoint(options);\n  const canInvokeOperation: NonNullable<\n    ReflectedOperationInvoker['canInvokeOperation']\n  > = operation =>\n    operation.kind === undefined\n      ? operation.exposure === undefined || operation.exposure === 'bridge'\n      : operation.kind !== 'graph' && operation.exposure === 'bridge';\n\n  return {\n    canInvokeOperation,\n    getOperationExecutionAffordance: operation =>\n      resolveOperationExecutionAffordance(operation, {\n        ...(canInvokeOperation(operation)\n          ? {\n              bridge: {\n                authority: operation.authority ?? 'server',\n                bridge: 'fetch',\n              },\n            }\n          : {}),\n      }),\n    invokeOperation: async <TInput = unknown, TData = unknown>({\n      input,\n      operationId,\n      view,\n    }: ReflectedOperationInvocation<TInput>) =>\n      toOperationInvocationResult<TData>(\n        await postBridgeRequest<OperationInvocationResult<TData>>(endpoint, {\n          kind: 'invoke',\n          operationId,\n          input,\n          ...(view ? { view } : {}),\n        }),\n      ),\n  };\n};\n\nexport const createFetchOperationBridgeAdapter = (\n  options: FetchOperationBridgeOptions = {},\n): OperationBridge.AnyOperationBridgeAdapter => {\n  const endpoint = operationEndpoint(options);\n  const buildRuntimeAction = <TInput, TData>(\n    operation: OperationBridge.BridgedOperationLike<TInput, TData>,\n  ) => createFetchBridgeAction(endpoint, operation);\n\n  return {\n    name: 'fetch',\n    useBridgeAction: operation =>\n      useMemo(\n        () => buildRuntimeAction(operation) as OperationBridge.OperationBridgeAction<any, any>,\n        [operation],\n      ) as OperationBridge.OperationBridgeAction<any, any>,\n    useBridgeMutation: (operation, options) => {\n      const action = useMemo(() => buildRuntimeAction(operation), [operation]);\n\n      return useServerMutation(\n        action as OperationBridge.OperationBridgeAction<unknown, unknown>,\n        options as Parameters<\n          typeof useServerMutation<OperationBridge.OperationBridgeAction<unknown, unknown>>\n        >[1],\n      ) as ReturnType<typeof useServerMutation<OperationBridge.OperationBridgeAction<any, any>>>;\n    },\n    useBridgeQuery: (operation, args) => {\n      const action = useMemo(() => buildRuntimeAction(operation), [operation]);\n\n      return useServerQuery({\n        action: action as OperationBridge.OperationBridgeAction<unknown, unknown>,\n        input: args.input as unknown,\n        key: args.key,\n        select: unwrapOperationInvocationValue,\n      }) as any;\n    },\n    usePermission: (operation, input, args) =>\n      useServerQuery({\n        enabled: args?.enabled,\n        action: createFetchPermissionAction(endpoint, operation),\n        input,\n        key: args?.queryKey ?? ['graph-permission', operation.id, input],\n      }),\n  };\n};\n"]}
+{"version":3,"file":"fetch-operation-bridge-adapter.js","sourceRoot":"","sources":["../../src/actions/fetch-operation-bridge-adapter.ts"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport type {\n  ReflectedOperationInvocation,\n  ReflectedOperationInvoker,\n} from '@ontahi/core/data-graph';\nimport {\n  normalizeGraphSchemaClientInput,\n  resolveOperationExecutionAffordance,\n} from '@ontahi/core/data-graph';\nimport type { OperationInvocationResult } from '@ontahi/core/runtime/contracts';\nimport {\n  isOperationInvocationProtocolResponse,\n  type OperationInvocationRequest,\n} from '@ontahi/core/runtime/operation-invocation';\nimport {\n  createRuntimeProtocolExchange,\n  toOperationProtocolRequest,\n  type RuntimeTransport,\n} from '@ontahi/core/runtime/protocol';\nimport { useMemo } from 'react';\n\nimport { createFetchRuntimeTransport } from '../graph/fetch-runtime-transport.js';\n\nimport {\n  attachOperationBridgeActionRuntime,\n  toOperationInvocationResult,\n  unwrapOperationInvocationValue,\n} from './operation-bridge.js';\nimport type * as OperationBridge from './operation-bridge.js';\nimport { useServerMutation, useServerQuery } from './react-query.js';\nimport type { ActionResultLike } from './use-action.js';\n\nexport type FetchOperationBridgeOptions<TTransportOptions = undefined> = {\n  /** @deprecated Select the legacy Operation route through createFetchGraphClient compatibility. */\n  mountPath?: string;\n  /** @deprecated Select the legacy Operation route through createFetchGraphClient compatibility. */\n  endpoint?: string;\n  fetch?: typeof globalThis.fetch;\n  requestInit?: (options?: TTransportOptions) => Omit<RequestInit, 'body' | 'method'>;\n  runtimeTransport?: RuntimeTransport<TTransportOptions>;\n  requestId?: () => string;\n};\n\nconst normalizeMountPath = (value: string) => {\n  const path = value.startsWith('/') ? value : `/${value}`;\n  let end = path.length;\n  while (end > 0 && path.charCodeAt(end - 1) === 47) end -= 1;\n  return path.slice(0, end);\n};\n\nconst mountedEndpoint = (mountPath: string, endpoint: string) =>\n  `${normalizeMountPath(mountPath)}/${endpoint}`;\n\nconst operationEndpoint = <TTransportOptions>(\n  options: FetchOperationBridgeOptions<TTransportOptions>,\n) =>\n  options.endpoint ??\n  (options.mountPath ? mountedEndpoint(options.mountPath, 'operations') : undefined);\n\nconst attachFetchBridgeRuntime = <TInput, TData>(\n  operation: OperationBridge.BridgedOperationLike<TInput, TData>,\n  action: OperationBridge.OperationBridgeAction<TInput, TData>,\n) =>\n  attachOperationBridgeActionRuntime(operation, action, {\n    requiresAuth: operation.authority !== 'server' ? false : operation.exposure !== 'bridge',\n  });\n\ntype OperationRequest = (request: OperationInvocationRequest) => Promise<unknown>;\n\nconst postLegacyBridgeRequest = async <TTransportOptions>(\n  endpoint: string,\n  request: OperationInvocationRequest,\n  fetchRequest: typeof globalThis.fetch,\n  requestInit: ((options?: TTransportOptions) => Omit<RequestInit, 'body' | 'method'>) | undefined,\n): Promise<unknown> => {\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(request),\n  });\n  const payload: unknown = await response.json().catch(() => null);\n  if (!response.ok && !isOperationInvocationProtocolResponse(payload)) {\n    throw new Error(`Graph bridge request failed with status ${response.status}.`);\n  }\n  return payload;\n};\n\nconst createOperationRequest = <TTransportOptions>(\n  options: FetchOperationBridgeOptions<TTransportOptions>,\n): OperationRequest => {\n  const endpoint = operationEndpoint(options);\n  if (endpoint) {\n    return request =>\n      postLegacyBridgeRequest(\n        endpoint,\n        request,\n        options.fetch ?? globalThis.fetch,\n        options.requestInit,\n      );\n  }\n\n  const exchange = createRuntimeProtocolExchange({\n    transport:\n      options.runtimeTransport ??\n      createFetchRuntimeTransport<TTransportOptions>({\n        ...(options.fetch ? { fetch: options.fetch } : {}),\n        ...(options.requestInit ? { requestInit: options.requestInit } : {}),\n      }),\n    requestId: options.requestId,\n  });\n  return request =>\n    exchange({\n      family: 'operation',\n      body: toOperationProtocolRequest(request),\n    });\n};\n\nconst errorMessage = (error: unknown) =>\n  error instanceof Error ? error.message : 'Graph bridge request failed.';\n\nconst postBridgeRequest = async <TData>(\n  requestOperation: OperationRequest,\n  request: OperationInvocationRequest,\n): Promise<ActionResultLike & { data?: TData }> => {\n  let payload: unknown;\n  try {\n    payload = await requestOperation(request);\n  } catch (error) {\n    return { serverError: errorMessage(error) };\n  }\n\n  if (!isOperationInvocationProtocolResponse(payload)) {\n    return { serverError: 'Graph bridge returned an invalid response.' };\n  }\n\n  if (payload.kind === 'protocol-error') {\n    return { serverError: payload.error.message };\n  }\n\n  if (request.kind === 'invoke' && payload.kind === 'invocation-result') {\n    return { data: payload.result as TData };\n  }\n\n  if (request.kind === 'check-permission' && payload.kind === 'permission-result') {\n    return { data: payload.result as TData };\n  }\n\n  return { serverError: 'Graph bridge returned an invalid response.' };\n};\n\nconst createFetchBridgeAction = <TInput, TData>(\n  requestOperation: OperationRequest,\n  operation: OperationBridge.BridgedOperationLike<TInput, TData>,\n): OperationBridge.OperationBridgeAction<TInput, TData> =>\n  attachFetchBridgeRuntime(operation, (input: TInput) => {\n    const portableInput = operation.input\n      ? normalizeGraphSchemaClientInput(operation.input, input, {\n          bindSelection: selection => selection.toAst(),\n        })\n      : input;\n    return postBridgeRequest<OperationInvocationResult<TData>>(requestOperation, {\n      kind: 'invoke',\n      operationId: operation.id,\n      input: portableInput,\n      ...(operation.view ? { view: operation.view } : {}),\n    });\n  }) as OperationBridge.OperationBridgeAction<TInput, TData>;\n\nconst createFetchPermissionAction =\n  <TInput, TData>(\n    requestOperation: OperationRequest,\n    operation: OperationBridge.BridgedOperationLike<TInput, TData>,\n  ): ((\n    input: TInput,\n  ) => Promise<OperationBridge.OperationBridgeActionResult<OperationBridge.GraphPermission>>) =>\n  (input: TInput) =>\n    postBridgeRequest<OperationBridge.GraphPermission>(requestOperation, {\n      kind: 'check-permission',\n      operationId: operation.id,\n      input: operation.input\n        ? normalizeGraphSchemaClientInput(operation.input, input, {\n            bindSelection: selection => selection.toAst(),\n          })\n        : input,\n    });\n\nexport const createFetchReflectedOperationInvoker = <TTransportOptions = undefined>(\n  options: FetchOperationBridgeOptions<TTransportOptions> = {},\n): ReflectedOperationInvoker => {\n  const requestOperation = createOperationRequest(options);\n  const canInvokeOperation: NonNullable<\n    ReflectedOperationInvoker['canInvokeOperation']\n  > = operation =>\n    operation.kind === undefined\n      ? operation.exposure === undefined || operation.exposure === 'bridge'\n      : operation.kind !== 'graph' && operation.exposure === 'bridge';\n\n  return {\n    canInvokeOperation,\n    getOperationExecutionAffordance: operation =>\n      resolveOperationExecutionAffordance(operation, {\n        ...(canInvokeOperation(operation)\n          ? {\n              bridge: {\n                authority: operation.authority ?? 'server',\n                bridge: 'fetch',\n              },\n            }\n          : {}),\n      }),\n    invokeOperation: async <TInput = unknown, TData = unknown>({\n      input,\n      operationId,\n      view,\n    }: ReflectedOperationInvocation<TInput>) =>\n      toOperationInvocationResult<TData>(\n        await postBridgeRequest<OperationInvocationResult<TData>>(requestOperation, {\n          kind: 'invoke',\n          operationId,\n          input,\n          ...(view ? { view } : {}),\n        }),\n      ),\n  };\n};\n\nexport const createFetchOperationBridgeAdapter = <TTransportOptions = undefined>(\n  options: FetchOperationBridgeOptions<TTransportOptions> = {},\n): OperationBridge.AnyOperationBridgeAdapter => {\n  const requestOperation = createOperationRequest(options);\n  const buildRuntimeAction = <TInput, TData>(\n    operation: OperationBridge.BridgedOperationLike<TInput, TData>,\n  ) => createFetchBridgeAction(requestOperation, operation);\n\n  return {\n    name: 'fetch',\n    useBridgeAction: operation =>\n      useMemo(\n        () => buildRuntimeAction(operation) as OperationBridge.OperationBridgeAction<any, any>,\n        [operation],\n      ) as OperationBridge.OperationBridgeAction<any, any>,\n    useBridgeMutation: (operation, options) => {\n      const action = useMemo(() => buildRuntimeAction(operation), [operation]);\n\n      return useServerMutation(\n        action as OperationBridge.OperationBridgeAction<unknown, unknown>,\n        options as Parameters<\n          typeof useServerMutation<OperationBridge.OperationBridgeAction<unknown, unknown>>\n        >[1],\n      ) as ReturnType<typeof useServerMutation<OperationBridge.OperationBridgeAction<any, any>>>;\n    },\n    useBridgeQuery: (operation, args) => {\n      const action = useMemo(() => buildRuntimeAction(operation), [operation]);\n\n      return useServerQuery({\n        action: action as OperationBridge.OperationBridgeAction<unknown, unknown>,\n        input: args.input as unknown,\n        key: args.key,\n        select: unwrapOperationInvocationValue,\n      }) as any;\n    },\n    usePermission: (operation, input, args) =>\n      useServerQuery({\n        enabled: args?.enabled,\n        action: createFetchPermissionAction(requestOperation, operation),\n        input,\n        key: args?.queryKey ?? ['graph-permission', operation.id, input],\n      }),\n  };\n};\n"]}

package/dist/graph/context.d.ts

@@ -40,7 +40,7 @@ export declare function useGraphClientCache(): {
     resolveEntityRef: <TRef extends import("@ontahi/core/data-graph").AnyEntityRef>(ref: TRef) => import("@ontahi/core/data-graph").AnyEntityRef | TRef;
     subscribe: (listener: import("@ontahi/core/data-graph").GraphClientCacheListener) => (() => void);
     writeEntity: <TEntity extends import("@ontahi/core/data-graph").AnyEntityDefinition, TSnapshot extends Record<string, unknown>>(entityDefinition: TEntity, snapshot: TSnapshot) => import("@ontahi/core/data-graph").GraphClientCacheWriteResult<TSnapshot> | undefined;
-    writeOutput: (key: readonly unknown[], descriptor: import("@ontahi/core/data-graph").GraphOutputDescriptor | undefined, value: unknown) => import("@ontahi/core/data-graph").GraphClientCacheOutputNormalizationResult;
+    writeOutput: (key: readonly unknown[], descriptor: import("@ontahi/core/data-graph").GraphOutputDescriptor | undefined, value: unknown, source?: import("@ontahi/core/data-graph").GraphClientCacheOutputSource) => import("@ontahi/core/data-graph").GraphClientCacheOutputNormalizationResult;
 };
 export declare function useGraphClientCacheSnapshot(): import("@ontahi/core/data-graph").GraphClientCacheSnapshot;
 export declare const useGraphClientCacheVersion: (clientCache: GraphClientCache) => number;

package/dist/graph/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/graph/context.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/graph/context.tsx"],"names":[],"mappings":"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"}

package/dist/graph/context.js

@@ -25,7 +25,7 @@ export function OntahiGraphProvider({ children, runtime, graphExecutor, runtimeT
     const resolvedReflectedEntityDataReader = reflectedEntityDataReader ?? graphClient?.reflectedEntityDataReader;
     const resolvedReflectedRelatedEntityDataReader = reflectedRelatedEntityDataReader ?? graphClient?.reflectedRelatedEntityDataReader;
     const configuredReflectedOperationInvoker = reflectedOperationInvoker ?? graphClient?.reflectedOperationInvoker;
-    const graphClientCache = clientCache ?? defaultClientCache;
+    const graphClientCache = clientCache ?? graphClient?.clientCache ?? defaultClientCache;
     const bridgeAdapterMap = useMemo(() => new Map(resolvedOperationBridgeAdapters.map(adapter => [adapter.name, adapter])), [resolvedOperationBridgeAdapters]);
     const resolvedReflectedOperationInvoker = useMemo(() => reflectedGraphOperations.length > 0
         ? createReflectedOperationInvoker({

package/dist/graph/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/graph/context.tsx"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport {\n  createGraphClientCache,\n  type GraphClientCache,\n  type OperationExecutionAffordance,\n  type ReflectedEntityDataReader,\n  type ReflectedRelatedEntityDataReader,\n  type ReflectedOperationDescriptor,\n  type ReflectedOperationInvoker,\n} from '@ontahi/core/data-graph';\nimport { anonymousExecutionIdentity, type ExecutionIdentity } from '@ontahi/core/runtime/identity';\nimport type { RuntimeTransport } from '@ontahi/core/runtime/protocol';\nimport {\n  createContext,\n  useCallback,\n  useContext,\n  useMemo,\n  useState,\n  useSyncExternalStore,\n  type ReactNode,\n} from 'react';\n\nimport type { AnyOperationBridgeAdapter } from '../actions/index.js';\n\nimport type { ReactGraphExecutor } from './executor.js';\nimport { createFetchGraphClient, type OntahiGraphClient } from './fetch-graph-client.js';\nimport {\n  createReflectedOperationInvoker,\n  type ReflectedGraphOperationLike,\n} from './reflected-operation-invoker.js';\n\nconst noReflectedGraphOperations: readonly ReflectedGraphOperationLike[] = [];\n\nconst GraphRuntimeContext = createContext<unknown | null>(null);\nconst ExecutionIdentityContext = createContext<ExecutionIdentity>(anonymousExecutionIdentity);\nconst GraphExecutorContext = createContext<ReactGraphExecutor<any, any> | null>(null);\nconst GraphClientCacheContext = createContext<GraphClientCache | null>(null);\nconst RuntimeTransportContext = createContext<RuntimeTransport | null>(null);\nconst OperationBridgeAdaptersContext = createContext<Map<string, AnyOperationBridgeAdapter> | null>(\n  null,\n);\nconst ReflectedEntityDataReaderContext = createContext<ReflectedEntityDataReader | null>(null);\nconst ReflectedRelatedEntityDataReaderContext =\n  createContext<ReflectedRelatedEntityDataReader | null>(null);\nconst ReflectedOperationInvokerContext = createContext<ReflectedOperationInvoker | null>(null);\n\nexport type OntahiGraphProviderProps<\n  TGraphRuntime = unknown,\n  TReadOptions = unknown,\n  TCommandOptions = TReadOptions,\n> = {\n  children: ReactNode;\n  runtime: TGraphRuntime;\n  graphExecutor?: ReactGraphExecutor<TReadOptions, TCommandOptions>;\n  runtimeTransport?: RuntimeTransport;\n  client?: OntahiGraphClient<TReadOptions, TCommandOptions> | false;\n  operationBridgeAdapters?: AnyOperationBridgeAdapter[];\n  reflectedEntityDataReader?: ReflectedEntityDataReader;\n  reflectedRelatedEntityDataReader?: ReflectedRelatedEntityDataReader;\n  reflectedOperationInvoker?: ReflectedOperationInvoker;\n  reflectedGraphOperations?: readonly ReflectedGraphOperationLike[];\n  clientCache?: GraphClientCache;\n  identity?: ExecutionIdentity;\n};\n\nexport function OntahiGraphProvider<\n  TGraphRuntime = unknown,\n  TReadOptions = unknown,\n  TCommandOptions = TReadOptions,\n>({\n  children,\n  runtime,\n  graphExecutor,\n  runtimeTransport,\n  client,\n  operationBridgeAdapters,\n  reflectedEntityDataReader,\n  reflectedRelatedEntityDataReader,\n  reflectedOperationInvoker,\n  reflectedGraphOperations = noReflectedGraphOperations,\n  clientCache,\n  identity = anonymousExecutionIdentity,\n}: OntahiGraphProviderProps<TGraphRuntime, TReadOptions, TCommandOptions>) {\n  const [defaultGraphClient] = useState(() => createFetchGraphClient());\n  const [defaultClientCache] = useState(() => createGraphClientCache());\n  const graphClient = client === false ? undefined : (client ?? defaultGraphClient);\n  const resolvedGraphExecutor = graphExecutor ?? graphClient?.graphExecutor;\n  const resolvedRuntimeTransport = runtimeTransport ?? graphClient?.runtimeTransport;\n  const resolvedOperationBridgeAdapters =\n    operationBridgeAdapters ?? graphClient?.operationBridgeAdapters ?? [];\n  const resolvedReflectedEntityDataReader =\n    reflectedEntityDataReader ?? graphClient?.reflectedEntityDataReader;\n  const resolvedReflectedRelatedEntityDataReader =\n    reflectedRelatedEntityDataReader ?? graphClient?.reflectedRelatedEntityDataReader;\n  const configuredReflectedOperationInvoker =\n    reflectedOperationInvoker ?? graphClient?.reflectedOperationInvoker;\n  const graphClientCache = clientCache ?? defaultClientCache;\n  const bridgeAdapterMap = useMemo(\n    () => new Map(resolvedOperationBridgeAdapters.map(adapter => [adapter.name, adapter])),\n    [resolvedOperationBridgeAdapters],\n  );\n  const resolvedReflectedOperationInvoker = useMemo(\n    () =>\n      reflectedGraphOperations.length > 0\n        ? createReflectedOperationInvoker({\n            fallback: configuredReflectedOperationInvoker,\n            graphExecutor: resolvedGraphExecutor,\n            graphOperations: reflectedGraphOperations,\n          })\n        : (configuredReflectedOperationInvoker ?? null),\n    [configuredReflectedOperationInvoker, reflectedGraphOperations, resolvedGraphExecutor],\n  );\n\n  return (\n    <ExecutionIdentityContext.Provider value={identity}>\n      <ReflectedOperationInvokerContext.Provider value={resolvedReflectedOperationInvoker}>\n        <ReflectedRelatedEntityDataReaderContext.Provider\n          value={resolvedReflectedRelatedEntityDataReader ?? null}\n        >\n          <ReflectedEntityDataReaderContext.Provider\n            value={resolvedReflectedEntityDataReader ?? null}\n          >\n            <OperationBridgeAdaptersContext.Provider value={bridgeAdapterMap}>\n              <RuntimeTransportContext.Provider value={resolvedRuntimeTransport ?? null}>\n                <GraphClientCacheContext.Provider value={graphClientCache}>\n                  <GraphExecutorContext.Provider value={resolvedGraphExecutor ?? null}>\n                    <GraphRuntimeContext.Provider value={runtime}>\n                      {children}\n                    </GraphRuntimeContext.Provider>\n                  </GraphExecutorContext.Provider>\n                </GraphClientCacheContext.Provider>\n              </RuntimeTransportContext.Provider>\n            </OperationBridgeAdaptersContext.Provider>\n          </ReflectedEntityDataReaderContext.Provider>\n        </ReflectedRelatedEntityDataReaderContext.Provider>\n      </ReflectedOperationInvokerContext.Provider>\n    </ExecutionIdentityContext.Provider>\n  );\n}\n\nexport const useExecutionIdentity = () => useContext(ExecutionIdentityContext);\n\nexport function useGraphRuntime<TGraphRuntime = unknown>() {\n  const runtime = useContext(GraphRuntimeContext);\n\n  if (runtime === null) {\n    throw new Error('useGraphRuntime must be used within an OntahiGraphProvider');\n  }\n\n  return runtime as TGraphRuntime;\n}\n\nexport function useGraphExecutor<TReadOptions = unknown, TCommandOptions = TReadOptions>() {\n  const graphExecutor = useContext(GraphExecutorContext);\n\n  if (graphExecutor === null) {\n    throw new Error(\n      'useGraphExecutor must be used within an OntahiGraphProvider with graphExecutor',\n    );\n  }\n\n  return graphExecutor as ReactGraphExecutor<TReadOptions, TCommandOptions>;\n}\n\nexport function useGraphExecutorCapability<\n  TReadOptions = unknown,\n  TCommandOptions = TReadOptions,\n>() {\n  return (useContext(GraphExecutorContext) ?? undefined) as\n    | ReactGraphExecutor<TReadOptions, TCommandOptions>\n    | undefined;\n}\n\nexport const useRuntimeTransportCapability = () => useContext(RuntimeTransportContext) ?? undefined;\n\nexport function useRuntimeTransport() {\n  const transport = useRuntimeTransportCapability();\n  if (!transport) {\n    throw new Error('useRuntimeTransport requires an OntahiGraphProvider with runtimeTransport');\n  }\n  return transport;\n}\n\nexport function useGraphClientCache() {\n  const clientCache = useContext(GraphClientCacheContext);\n\n  if (clientCache === null) {\n    throw new Error('useGraphClientCache must be used within an OntahiGraphProvider');\n  }\n\n  return clientCache;\n}\n\nexport function useGraphClientCacheSnapshot() {\n  const clientCache = useGraphClientCache();\n\n  useGraphClientCacheVersion(clientCache);\n\n  return clientCache.inspect();\n}\n\nexport const useGraphClientCacheVersion = (clientCache: GraphClientCache) =>\n  useSyncExternalStore(\n    clientCache.subscribe,\n    () => clientCache.inspect().version,\n    () => clientCache.inspect().version,\n  );\n\nexport function useOperationBridgeAdapter(adapterName: string) {\n  const adapters = useContext(OperationBridgeAdaptersContext);\n\n  if (adapters === null) {\n    throw new Error('useOperationBridgeAdapter must be used within an OntahiGraphProvider');\n  }\n\n  const adapter = adapters.get(adapterName);\n\n  if (!adapter) {\n    throw new Error(`No operation bridge adapter registered for \"${adapterName}\"`);\n  }\n\n  return adapter;\n}\n\nexport function useDefaultOperationBridgeAdapter() {\n  const adapters = useContext(OperationBridgeAdaptersContext);\n\n  if (adapters === null) {\n    throw new Error('useDefaultOperationBridgeAdapter must be used within an OntahiGraphProvider');\n  }\n\n  const [adapter] = adapters.values();\n\n  if (!adapter) {\n    throw new Error('No operation bridge adapter registered.');\n  }\n\n  return adapter;\n}\n\nexport function useHasOperationBridgeRuntime() {\n  const adapters = useContext(OperationBridgeAdaptersContext);\n  return adapters !== null && adapters.size > 0;\n}\n\nexport function useReflectedEntityDataReader() {\n  const reader = useContext(ReflectedEntityDataReaderContext);\n\n  if (reader === null) {\n    throw new Error(\n      'useReflectedEntityDataReader must be used within an OntahiGraphProvider with reflectedEntityDataReader',\n    );\n  }\n\n  return reader;\n}\n\nexport function useHasReflectedEntityDataReader() {\n  return useContext(ReflectedEntityDataReaderContext) !== null;\n}\n\nexport function useReflectedRelatedEntityDataReader() {\n  const reader = useContext(ReflectedRelatedEntityDataReaderContext);\n\n  if (reader === null) {\n    throw new Error(\n      'useReflectedRelatedEntityDataReader must be used within an OntahiGraphProvider with reflectedRelatedEntityDataReader',\n    );\n  }\n\n  return reader;\n}\n\nexport const useHasReflectedRelatedEntityDataReader = () =>\n  useContext(ReflectedRelatedEntityDataReaderContext) !== null;\n\nexport function useReflectedOperationInvoker() {\n  const invoker = useContext(ReflectedOperationInvokerContext);\n\n  if (invoker === null) {\n    throw new Error(\n      'useReflectedOperationInvoker must be used within an OntahiGraphProvider with reflectedOperationInvoker',\n    );\n  }\n\n  return invoker;\n}\n\nexport function useHasReflectedOperationInvoker() {\n  return useContext(ReflectedOperationInvokerContext) !== null;\n}\n\nexport function useReflectedOperationSupport() {\n  const invoker = useContext(ReflectedOperationInvokerContext);\n\n  return useCallback(\n    (operation: ReflectedOperationDescriptor) =>\n      Boolean(invoker && (invoker.canInvokeOperation?.(operation) ?? true)),\n    [invoker],\n  );\n}\n\nexport function useReflectedOperationExecutionAffordance(\n  operation: ReflectedOperationDescriptor,\n): OperationExecutionAffordance | undefined {\n  const invoker = useContext(ReflectedOperationInvokerContext);\n\n  return invoker?.getOperationExecutionAffordance?.(operation);\n}\n\nexport type { GraphClientCache };\n"]}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/graph/context.tsx"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport {\n  createGraphClientCache,\n  type GraphClientCache,\n  type OperationExecutionAffordance,\n  type ReflectedEntityDataReader,\n  type ReflectedRelatedEntityDataReader,\n  type ReflectedOperationDescriptor,\n  type ReflectedOperationInvoker,\n} from '@ontahi/core/data-graph';\nimport { anonymousExecutionIdentity, type ExecutionIdentity } from '@ontahi/core/runtime/identity';\nimport type { RuntimeTransport } from '@ontahi/core/runtime/protocol';\nimport {\n  createContext,\n  useCallback,\n  useContext,\n  useMemo,\n  useState,\n  useSyncExternalStore,\n  type ReactNode,\n} from 'react';\n\nimport type { AnyOperationBridgeAdapter } from '../actions/index.js';\n\nimport type { ReactGraphExecutor } from './executor.js';\nimport { createFetchGraphClient, type OntahiGraphClient } from './fetch-graph-client.js';\nimport {\n  createReflectedOperationInvoker,\n  type ReflectedGraphOperationLike,\n} from './reflected-operation-invoker.js';\n\nconst noReflectedGraphOperations: readonly ReflectedGraphOperationLike[] = [];\n\nconst GraphRuntimeContext = createContext<unknown | null>(null);\nconst ExecutionIdentityContext = createContext<ExecutionIdentity>(anonymousExecutionIdentity);\nconst GraphExecutorContext = createContext<ReactGraphExecutor<any, any> | null>(null);\nconst GraphClientCacheContext = createContext<GraphClientCache | null>(null);\nconst RuntimeTransportContext = createContext<RuntimeTransport | null>(null);\nconst OperationBridgeAdaptersContext = createContext<Map<string, AnyOperationBridgeAdapter> | null>(\n  null,\n);\nconst ReflectedEntityDataReaderContext = createContext<ReflectedEntityDataReader | null>(null);\nconst ReflectedRelatedEntityDataReaderContext =\n  createContext<ReflectedRelatedEntityDataReader | null>(null);\nconst ReflectedOperationInvokerContext = createContext<ReflectedOperationInvoker | null>(null);\n\nexport type OntahiGraphProviderProps<\n  TGraphRuntime = unknown,\n  TReadOptions = unknown,\n  TCommandOptions = TReadOptions,\n> = {\n  children: ReactNode;\n  runtime: TGraphRuntime;\n  graphExecutor?: ReactGraphExecutor<TReadOptions, TCommandOptions>;\n  runtimeTransport?: RuntimeTransport;\n  client?: OntahiGraphClient<TReadOptions, TCommandOptions> | false;\n  operationBridgeAdapters?: AnyOperationBridgeAdapter[];\n  reflectedEntityDataReader?: ReflectedEntityDataReader;\n  reflectedRelatedEntityDataReader?: ReflectedRelatedEntityDataReader;\n  reflectedOperationInvoker?: ReflectedOperationInvoker;\n  reflectedGraphOperations?: readonly ReflectedGraphOperationLike[];\n  clientCache?: GraphClientCache;\n  identity?: ExecutionIdentity;\n};\n\nexport function OntahiGraphProvider<\n  TGraphRuntime = unknown,\n  TReadOptions = unknown,\n  TCommandOptions = TReadOptions,\n>({\n  children,\n  runtime,\n  graphExecutor,\n  runtimeTransport,\n  client,\n  operationBridgeAdapters,\n  reflectedEntityDataReader,\n  reflectedRelatedEntityDataReader,\n  reflectedOperationInvoker,\n  reflectedGraphOperations = noReflectedGraphOperations,\n  clientCache,\n  identity = anonymousExecutionIdentity,\n}: OntahiGraphProviderProps<TGraphRuntime, TReadOptions, TCommandOptions>) {\n  const [defaultGraphClient] = useState(() => createFetchGraphClient());\n  const [defaultClientCache] = useState(() => createGraphClientCache());\n  const graphClient = client === false ? undefined : (client ?? defaultGraphClient);\n  const resolvedGraphExecutor = graphExecutor ?? graphClient?.graphExecutor;\n  const resolvedRuntimeTransport = runtimeTransport ?? graphClient?.runtimeTransport;\n  const resolvedOperationBridgeAdapters =\n    operationBridgeAdapters ?? graphClient?.operationBridgeAdapters ?? [];\n  const resolvedReflectedEntityDataReader =\n    reflectedEntityDataReader ?? graphClient?.reflectedEntityDataReader;\n  const resolvedReflectedRelatedEntityDataReader =\n    reflectedRelatedEntityDataReader ?? graphClient?.reflectedRelatedEntityDataReader;\n  const configuredReflectedOperationInvoker =\n    reflectedOperationInvoker ?? graphClient?.reflectedOperationInvoker;\n  const graphClientCache = clientCache ?? graphClient?.clientCache ?? defaultClientCache;\n  const bridgeAdapterMap = useMemo(\n    () => new Map(resolvedOperationBridgeAdapters.map(adapter => [adapter.name, adapter])),\n    [resolvedOperationBridgeAdapters],\n  );\n  const resolvedReflectedOperationInvoker = useMemo(\n    () =>\n      reflectedGraphOperations.length > 0\n        ? createReflectedOperationInvoker({\n            fallback: configuredReflectedOperationInvoker,\n            graphExecutor: resolvedGraphExecutor,\n            graphOperations: reflectedGraphOperations,\n          })\n        : (configuredReflectedOperationInvoker ?? null),\n    [configuredReflectedOperationInvoker, reflectedGraphOperations, resolvedGraphExecutor],\n  );\n\n  return (\n    <ExecutionIdentityContext.Provider value={identity}>\n      <ReflectedOperationInvokerContext.Provider value={resolvedReflectedOperationInvoker}>\n        <ReflectedRelatedEntityDataReaderContext.Provider\n          value={resolvedReflectedRelatedEntityDataReader ?? null}\n        >\n          <ReflectedEntityDataReaderContext.Provider\n            value={resolvedReflectedEntityDataReader ?? null}\n          >\n            <OperationBridgeAdaptersContext.Provider value={bridgeAdapterMap}>\n              <RuntimeTransportContext.Provider value={resolvedRuntimeTransport ?? null}>\n                <GraphClientCacheContext.Provider value={graphClientCache}>\n                  <GraphExecutorContext.Provider value={resolvedGraphExecutor ?? null}>\n                    <GraphRuntimeContext.Provider value={runtime}>\n                      {children}\n                    </GraphRuntimeContext.Provider>\n                  </GraphExecutorContext.Provider>\n                </GraphClientCacheContext.Provider>\n              </RuntimeTransportContext.Provider>\n            </OperationBridgeAdaptersContext.Provider>\n          </ReflectedEntityDataReaderContext.Provider>\n        </ReflectedRelatedEntityDataReaderContext.Provider>\n      </ReflectedOperationInvokerContext.Provider>\n    </ExecutionIdentityContext.Provider>\n  );\n}\n\nexport const useExecutionIdentity = () => useContext(ExecutionIdentityContext);\n\nexport function useGraphRuntime<TGraphRuntime = unknown>() {\n  const runtime = useContext(GraphRuntimeContext);\n\n  if (runtime === null) {\n    throw new Error('useGraphRuntime must be used within an OntahiGraphProvider');\n  }\n\n  return runtime as TGraphRuntime;\n}\n\nexport function useGraphExecutor<TReadOptions = unknown, TCommandOptions = TReadOptions>() {\n  const graphExecutor = useContext(GraphExecutorContext);\n\n  if (graphExecutor === null) {\n    throw new Error(\n      'useGraphExecutor must be used within an OntahiGraphProvider with graphExecutor',\n    );\n  }\n\n  return graphExecutor as ReactGraphExecutor<TReadOptions, TCommandOptions>;\n}\n\nexport function useGraphExecutorCapability<\n  TReadOptions = unknown,\n  TCommandOptions = TReadOptions,\n>() {\n  return (useContext(GraphExecutorContext) ?? undefined) as\n    | ReactGraphExecutor<TReadOptions, TCommandOptions>\n    | undefined;\n}\n\nexport const useRuntimeTransportCapability = () => useContext(RuntimeTransportContext) ?? undefined;\n\nexport function useRuntimeTransport() {\n  const transport = useRuntimeTransportCapability();\n  if (!transport) {\n    throw new Error('useRuntimeTransport requires an OntahiGraphProvider with runtimeTransport');\n  }\n  return transport;\n}\n\nexport function useGraphClientCache() {\n  const clientCache = useContext(GraphClientCacheContext);\n\n  if (clientCache === null) {\n    throw new Error('useGraphClientCache must be used within an OntahiGraphProvider');\n  }\n\n  return clientCache;\n}\n\nexport function useGraphClientCacheSnapshot() {\n  const clientCache = useGraphClientCache();\n\n  useGraphClientCacheVersion(clientCache);\n\n  return clientCache.inspect();\n}\n\nexport const useGraphClientCacheVersion = (clientCache: GraphClientCache) =>\n  useSyncExternalStore(\n    clientCache.subscribe,\n    () => clientCache.inspect().version,\n    () => clientCache.inspect().version,\n  );\n\nexport function useOperationBridgeAdapter(adapterName: string) {\n  const adapters = useContext(OperationBridgeAdaptersContext);\n\n  if (adapters === null) {\n    throw new Error('useOperationBridgeAdapter must be used within an OntahiGraphProvider');\n  }\n\n  const adapter = adapters.get(adapterName);\n\n  if (!adapter) {\n    throw new Error(`No operation bridge adapter registered for \"${adapterName}\"`);\n  }\n\n  return adapter;\n}\n\nexport function useDefaultOperationBridgeAdapter() {\n  const adapters = useContext(OperationBridgeAdaptersContext);\n\n  if (adapters === null) {\n    throw new Error('useDefaultOperationBridgeAdapter must be used within an OntahiGraphProvider');\n  }\n\n  const [adapter] = adapters.values();\n\n  if (!adapter) {\n    throw new Error('No operation bridge adapter registered.');\n  }\n\n  return adapter;\n}\n\nexport function useHasOperationBridgeRuntime() {\n  const adapters = useContext(OperationBridgeAdaptersContext);\n  return adapters !== null && adapters.size > 0;\n}\n\nexport function useReflectedEntityDataReader() {\n  const reader = useContext(ReflectedEntityDataReaderContext);\n\n  if (reader === null) {\n    throw new Error(\n      'useReflectedEntityDataReader must be used within an OntahiGraphProvider with reflectedEntityDataReader',\n    );\n  }\n\n  return reader;\n}\n\nexport function useHasReflectedEntityDataReader() {\n  return useContext(ReflectedEntityDataReaderContext) !== null;\n}\n\nexport function useReflectedRelatedEntityDataReader() {\n  const reader = useContext(ReflectedRelatedEntityDataReaderContext);\n\n  if (reader === null) {\n    throw new Error(\n      'useReflectedRelatedEntityDataReader must be used within an OntahiGraphProvider with reflectedRelatedEntityDataReader',\n    );\n  }\n\n  return reader;\n}\n\nexport const useHasReflectedRelatedEntityDataReader = () =>\n  useContext(ReflectedRelatedEntityDataReaderContext) !== null;\n\nexport function useReflectedOperationInvoker() {\n  const invoker = useContext(ReflectedOperationInvokerContext);\n\n  if (invoker === null) {\n    throw new Error(\n      'useReflectedOperationInvoker must be used within an OntahiGraphProvider with reflectedOperationInvoker',\n    );\n  }\n\n  return invoker;\n}\n\nexport function useHasReflectedOperationInvoker() {\n  return useContext(ReflectedOperationInvokerContext) !== null;\n}\n\nexport function useReflectedOperationSupport() {\n  const invoker = useContext(ReflectedOperationInvokerContext);\n\n  return useCallback(\n    (operation: ReflectedOperationDescriptor) =>\n      Boolean(invoker && (invoker.canInvokeOperation?.(operation) ?? true)),\n    [invoker],\n  );\n}\n\nexport function useReflectedOperationExecutionAffordance(\n  operation: ReflectedOperationDescriptor,\n): OperationExecutionAffordance | undefined {\n  const invoker = useContext(ReflectedOperationInvokerContext);\n\n  return invoker?.getOperationExecutionAffordance?.(operation);\n}\n\nexport type { GraphClientCache };\n"]}

package/dist/graph/executor.d.ts

@@ -1,4 +1,4 @@
-import type { GraphCommandSpec, GraphOperationDeclaration, GraphReadExpression, GraphReadIntent, GraphSchemaLike, InferGraphSchemaClientInput, QueryOrView, QuerySpec, ManyToManyRelationshipCommand, RelationshipCommand, RelationshipCommandResult, EntityMutationCommand, EntityMutationDelta } from '@ontahi/core/data-graph';
+import type { GraphCommandSpec, GraphOperationDeclaration, GraphReadExpression, GraphReadIntent, GraphSchemaLike, InferGraphSchemaClientInput, QueryOrView, QuerySpec, ManyToManyRelationshipCommand, OrderedRelationshipCommand, RelationshipCommand, RelationshipCommandResult, EntityMutationCommand, EntityMutationDelta } from '@ontahi/core/data-graph';
 import type { QueryKey, UseMutationOptions, UseQueryOptions } from '@tanstack/react-query';
 export interface ReactGraphExecutor<TReadOptions = unknown, TCommandOptions = TReadOptions> {
     get<TParams, TResult>(read: QueryOrView<TParams, TResult>, params: TParams, options?: TReadOptions): Promise<TResult | null>;
@@ -7,6 +7,7 @@ export interface ReactGraphExecutor<TReadOptions = unknown, TCommandOptions = TR
     runCommand<TResult = void>(command: GraphCommandSpec<any, any, TResult>, options?: TCommandOptions): Promise<TResult>;
     runRelationshipCommand?(command: RelationshipCommand, options?: TCommandOptions): Promise<RelationshipCommandResult>;
     runManyToManyRelationshipCommand?(command: ManyToManyRelationshipCommand, options?: TCommandOptions): Promise<RelationshipCommandResult>;
+    runOrderedRelationshipCommand?(command: OrderedRelationshipCommand, options?: TCommandOptions): Promise<RelationshipCommandResult>;
     runEntityMutationCommand?(command: EntityMutationCommand, options?: TCommandOptions): Promise<EntityMutationDelta>;
 }
 export type BuildableRead<TResult> = {

package/dist/graph/executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/graph/executor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/graph/executor.ts"],"names":[],"mappings":"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"}

package/dist/graph/executor.js.map

@@ -1 +1 @@
-{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../src/graph/executor.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  GraphCommandSpec,\n  GraphOperationDeclaration,\n  GraphReadExpression,\n  GraphReadIntent,\n  GraphSchemaLike,\n  InferGraphSchemaClientInput,\n  QueryOrView,\n  QuerySpec,\n  ManyToManyRelationshipCommand,\n  RelationshipCommand,\n  RelationshipCommandResult,\n  EntityMutationCommand,\n  EntityMutationDelta,\n} from '@ontahi/core/data-graph';\nimport type { QueryKey, UseMutationOptions, UseQueryOptions } from '@tanstack/react-query';\n\nexport interface ReactGraphExecutor<TReadOptions = unknown, TCommandOptions = TReadOptions> {\n  get<TParams, TResult>(\n    read: QueryOrView<TParams, TResult>,\n    params: TParams,\n    options?: TReadOptions,\n  ): Promise<TResult | null>;\n  run<TParams, TResult>(\n    read: QueryOrView<TParams, TResult>,\n    params: TParams,\n    options?: TReadOptions,\n  ): Promise<TResult[]>;\n  count<TParams, TResult>(\n    read: QueryOrView<TParams, TResult>,\n    params: TParams,\n    options?: TReadOptions,\n  ): Promise<number>;\n  runCommand<TResult = void>(\n    command: GraphCommandSpec<any, any, TResult>,\n    options?: TCommandOptions,\n  ): Promise<TResult>;\n  runRelationshipCommand?(\n    command: RelationshipCommand,\n    options?: TCommandOptions,\n  ): Promise<RelationshipCommandResult>;\n  runManyToManyRelationshipCommand?(\n    command: ManyToManyRelationshipCommand,\n    options?: TCommandOptions,\n  ): Promise<RelationshipCommandResult>;\n  runEntityMutationCommand?(\n    command: EntityMutationCommand,\n    options?: TCommandOptions,\n  ): Promise<EntityMutationDelta>;\n}\n\nexport type BuildableRead<TResult> = {\n  build: () => QuerySpec<any, TResult>;\n};\n\ntype PlainGraphReadSource<TResult> = QueryOrView<any, TResult> | BuildableRead<TResult>;\n\nexport type GraphReadSource<TResult = unknown> =\n  | PlainGraphReadSource<TResult>\n  | GraphReadExpression<PlainGraphReadSource<TResult>, GraphReadIntent, TResult>;\n\nexport type ReadParams<TRead> =\n  TRead extends GraphReadExpression<infer TSource, any, any>\n    ? ReadParams<TSource>\n    : TRead extends QueryOrView<infer TParams, any>\n      ? TParams\n      : undefined;\n\nexport type ReadResult<TRead> =\n  TRead extends GraphReadExpression<any, any, infer TResult>\n    ? TResult\n    : TRead extends QueryOrView<any, infer TResult>\n      ? TResult\n      : TRead extends BuildableRead<infer TResult>\n        ? TResult\n        : never;\n\nexport type GraphQueryMode = 'get' | 'run' | 'count' | 'exists';\n\ntype GraphReadIntentData<TRead, TIntent extends GraphReadIntent> = TIntent extends 'count'\n  ? number\n  : TIntent extends 'exists'\n    ? boolean\n    : TIntent extends 'one'\n      ? ReadResult<TRead>\n      : ReadResult<TRead> | null;\n\nexport type GraphQueryData<TRead, TMode extends GraphQueryMode = 'run'> =\n  TRead extends GraphReadExpression<any, infer TIntent, any>\n    ? GraphReadIntentData<TRead, TIntent>\n    : TMode extends 'get'\n      ? ReadResult<TRead> | null\n      : TMode extends 'run'\n        ? ReadResult<TRead>[]\n        : TMode extends 'count'\n          ? number\n          : boolean;\n\nexport type GraphQueryOptions<\n  TRead,\n  TMode extends GraphQueryMode = 'run',\n  TReadOptions = unknown,\n> = Omit<\n  UseQueryOptions<GraphQueryData<TRead, TMode>, Error, GraphQueryData<TRead, TMode>, QueryKey>,\n  'queryKey' | 'queryFn'\n> & {\n  mode?: TRead extends GraphReadExpression<any, any, any> ? never : TMode;\n  params?: ReadParams<TRead>;\n  queryKey?: QueryKey;\n  runtimeOptions?: TReadOptions;\n};\n\nexport type CommandLike<TResult> =\n  | GraphCommandSpec<any, any, TResult>\n  | {\n      build: () => GraphCommandSpec<any, any, TResult>;\n    };\n\nexport type GraphCommandBuilder<TVariables, TResult> = (\n  variables: TVariables,\n) => CommandLike<TResult>;\n\nexport type GraphOperationLike<TVariables, TResult> = GraphOperationDeclaration<\n  TVariables,\n  CommandLike<TResult>\n> & {\n  id: string;\n};\n\nexport type GraphOperationClientInput<TOperation> = TOperation extends {\n  input: infer TSchema extends GraphSchemaLike;\n}\n  ? InferGraphSchemaClientInput<TSchema>\n  : TOperation extends GraphOperationDeclaration<infer TInput, any>\n    ? TInput\n    : never;\n\nexport type GraphOperationResult<TOperation> = TOperation extends {\n  run: (...args: any[]) => CommandLike<infer TResult>;\n}\n  ? TResult\n  : never;\n\nexport type GraphCommandHookOptions<\n  TResult,\n  TVariables,\n  TContext,\n  TCommandOptions = unknown,\n> = Omit<UseMutationOptions<TResult, Error, TVariables, TContext>, 'mutationFn'> & {\n  mutationKey?: QueryKey;\n  runtimeOptions?: TCommandOptions;\n  invalidateQueryKeys?: QueryKey[];\n};\n"]}
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../src/graph/executor.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  GraphCommandSpec,\n  GraphOperationDeclaration,\n  GraphReadExpression,\n  GraphReadIntent,\n  GraphSchemaLike,\n  InferGraphSchemaClientInput,\n  QueryOrView,\n  QuerySpec,\n  ManyToManyRelationshipCommand,\n  OrderedRelationshipCommand,\n  RelationshipCommand,\n  RelationshipCommandResult,\n  EntityMutationCommand,\n  EntityMutationDelta,\n} from '@ontahi/core/data-graph';\nimport type { QueryKey, UseMutationOptions, UseQueryOptions } from '@tanstack/react-query';\n\nexport interface ReactGraphExecutor<TReadOptions = unknown, TCommandOptions = TReadOptions> {\n  get<TParams, TResult>(\n    read: QueryOrView<TParams, TResult>,\n    params: TParams,\n    options?: TReadOptions,\n  ): Promise<TResult | null>;\n  run<TParams, TResult>(\n    read: QueryOrView<TParams, TResult>,\n    params: TParams,\n    options?: TReadOptions,\n  ): Promise<TResult[]>;\n  count<TParams, TResult>(\n    read: QueryOrView<TParams, TResult>,\n    params: TParams,\n    options?: TReadOptions,\n  ): Promise<number>;\n  runCommand<TResult = void>(\n    command: GraphCommandSpec<any, any, TResult>,\n    options?: TCommandOptions,\n  ): Promise<TResult>;\n  runRelationshipCommand?(\n    command: RelationshipCommand,\n    options?: TCommandOptions,\n  ): Promise<RelationshipCommandResult>;\n  runManyToManyRelationshipCommand?(\n    command: ManyToManyRelationshipCommand,\n    options?: TCommandOptions,\n  ): Promise<RelationshipCommandResult>;\n  runOrderedRelationshipCommand?(\n    command: OrderedRelationshipCommand,\n    options?: TCommandOptions,\n  ): Promise<RelationshipCommandResult>;\n  runEntityMutationCommand?(\n    command: EntityMutationCommand,\n    options?: TCommandOptions,\n  ): Promise<EntityMutationDelta>;\n}\n\nexport type BuildableRead<TResult> = {\n  build: () => QuerySpec<any, TResult>;\n};\n\ntype PlainGraphReadSource<TResult> = QueryOrView<any, TResult> | BuildableRead<TResult>;\n\nexport type GraphReadSource<TResult = unknown> =\n  | PlainGraphReadSource<TResult>\n  | GraphReadExpression<PlainGraphReadSource<TResult>, GraphReadIntent, TResult>;\n\nexport type ReadParams<TRead> =\n  TRead extends GraphReadExpression<infer TSource, any, any>\n    ? ReadParams<TSource>\n    : TRead extends QueryOrView<infer TParams, any>\n      ? TParams\n      : undefined;\n\nexport type ReadResult<TRead> =\n  TRead extends GraphReadExpression<any, any, infer TResult>\n    ? TResult\n    : TRead extends QueryOrView<any, infer TResult>\n      ? TResult\n      : TRead extends BuildableRead<infer TResult>\n        ? TResult\n        : never;\n\nexport type GraphQueryMode = 'get' | 'run' | 'count' | 'exists';\n\ntype GraphReadIntentData<TRead, TIntent extends GraphReadIntent> = TIntent extends 'count'\n  ? number\n  : TIntent extends 'exists'\n    ? boolean\n    : TIntent extends 'one'\n      ? ReadResult<TRead>\n      : ReadResult<TRead> | null;\n\nexport type GraphQueryData<TRead, TMode extends GraphQueryMode = 'run'> =\n  TRead extends GraphReadExpression<any, infer TIntent, any>\n    ? GraphReadIntentData<TRead, TIntent>\n    : TMode extends 'get'\n      ? ReadResult<TRead> | null\n      : TMode extends 'run'\n        ? ReadResult<TRead>[]\n        : TMode extends 'count'\n          ? number\n          : boolean;\n\nexport type GraphQueryOptions<\n  TRead,\n  TMode extends GraphQueryMode = 'run',\n  TReadOptions = unknown,\n> = Omit<\n  UseQueryOptions<GraphQueryData<TRead, TMode>, Error, GraphQueryData<TRead, TMode>, QueryKey>,\n  'queryKey' | 'queryFn'\n> & {\n  mode?: TRead extends GraphReadExpression<any, any, any> ? never : TMode;\n  params?: ReadParams<TRead>;\n  queryKey?: QueryKey;\n  runtimeOptions?: TReadOptions;\n};\n\nexport type CommandLike<TResult> =\n  | GraphCommandSpec<any, any, TResult>\n  | {\n      build: () => GraphCommandSpec<any, any, TResult>;\n    };\n\nexport type GraphCommandBuilder<TVariables, TResult> = (\n  variables: TVariables,\n) => CommandLike<TResult>;\n\nexport type GraphOperationLike<TVariables, TResult> = GraphOperationDeclaration<\n  TVariables,\n  CommandLike<TResult>\n> & {\n  id: string;\n};\n\nexport type GraphOperationClientInput<TOperation> = TOperation extends {\n  input: infer TSchema extends GraphSchemaLike;\n}\n  ? InferGraphSchemaClientInput<TSchema>\n  : TOperation extends GraphOperationDeclaration<infer TInput, any>\n    ? TInput\n    : never;\n\nexport type GraphOperationResult<TOperation> = TOperation extends {\n  run: (...args: any[]) => CommandLike<infer TResult>;\n}\n  ? TResult\n  : never;\n\nexport type GraphCommandHookOptions<\n  TResult,\n  TVariables,\n  TContext,\n  TCommandOptions = unknown,\n> = Omit<UseMutationOptions<TResult, Error, TVariables, TContext>, 'mutationFn'> & {\n  mutationKey?: QueryKey;\n  runtimeOptions?: TCommandOptions;\n  invalidateQueryKeys?: QueryKey[];\n};\n"]}

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

@@ -1,4 +1,4 @@
-import type { ReflectedEntityDataReader, ReflectedRelatedEntityDataReader, ReflectedOperationInvoker, RemoteDataGraphError, RuntimeBoundDataGraphApi } from '@ontahi/core/data-graph';
+import type { GraphClientCache, ReflectedEntityDataReader, ReflectedRelatedEntityDataReader, ReflectedOperationInvoker, RemoteDataGraphError, RuntimeBoundDataGraphApi } from '@ontahi/core/data-graph';
 import type { RuntimeTransport } from '@ontahi/core/runtime/protocol';
 import { type AnyOperationBridgeAdapter, type FetchOperationBridgeOptions } from '../actions/index.js';
 import type { ReactGraphExecutor } from './executor.js';
@@ -12,7 +12,8 @@ export type FetchReflectedRelatedEntityDataReaderOptions = FetchReflectedEntityD
 export type OntahiGraphClient<TReadOptions = unknown, TCommandOptions = TReadOptions> = {
     graph?: RuntimeBoundDataGraphApi<RemoteDataGraphError, TReadOptions, TCommandOptions, RemoteDataGraphError>;
     graphExecutor?: ReactGraphExecutor<TReadOptions, TCommandOptions>;
-    runtimeTransport?: RuntimeTransport;
+    clientCache?: GraphClientCache;
+    runtimeTransport?: RuntimeTransport<TReadOptions | TCommandOptions>;
     operationBridgeAdapters?: AnyOperationBridgeAdapter[];
     reflectedEntityDataReader?: ReflectedEntityDataReader;
     reflectedRelatedEntityDataReader?: ReflectedRelatedEntityDataReader;
@@ -21,11 +22,25 @@ export type OntahiGraphClient<TReadOptions = unknown, TCommandOptions = TReadOpt
 export type FetchGraphClient<TOptions = undefined> = OntahiGraphClient<TOptions, TOptions> & {
     graph: RuntimeBoundDataGraphApi<RemoteDataGraphError, TOptions, TOptions, RemoteDataGraphError>;
     graphExecutor: ReactGraphExecutor<TOptions, TOptions>;
+    clientCache: GraphClientCache;
+};
+export type FetchGraphClientCompatibilityOptions = {
+    operation?: {
+        endpoint?: string;
+        mountPath?: string;
+    };
+    graphRead?: {
+        endpoint?: string;
+    };
+    graphCommand?: {
+        endpoint?: string;
+    };
 };
 export type FetchGraphClientOptions<TOptions = undefined> = {
+    compatibility?: FetchGraphClientCompatibilityOptions;
     graphRead?: false | FetchGraphReadExecutorOptions<TOptions>;
-    operations?: false | FetchOperationBridgeOptions;
-    runtimeTransport?: false | FetchRuntimeTransportOptions;
+    operations?: false | FetchOperationBridgeOptions<TOptions>;
+    runtimeTransport?: false | FetchRuntimeTransportOptions<TOptions>;
     reflectedEntityData?: false | FetchReflectedEntityDataReaderOptions;
     reflectedRelatedEntityData?: false | FetchReflectedRelatedEntityDataReaderOptions;
 };