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

package/README.md

@@ -46,6 +46,7 @@ const openTodos = TodoItem.all()
 </OntahiGraphProvider>;
 
 const todos = useGraphQuery(openTodos);
+const liveTodos = useGraphQuery(openTodos, { observation: 'live' });
 const total = useGraphQuery(openTodos.count());
 const first = useGraphQuery(openTodos.first());
 ```
@@ -72,7 +73,18 @@ Classified reads lower to the canonical base Entity before reaching these provid
 `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()`.
+`useGraphQuery(query, { observation: 'live' })` explicitly selects the same complete-snapshot
+observation lifecycle as the bound Query's `observe()`. The first snapshot is the initial React
+Query value; the hook does not issue a duplicate one-shot read. Later snapshots replace that value
+and pass through the same Graph Client Cache reconciliation as ordinary reads. Unmounting or
+changing the query identity aborts the observation. Scalar terminal intents remain one-shot.
+
+Live observation is opt-in. Ordinary `useGraphQuery(query)` retains one-shot execution plus
+semantic mutation invalidation. An active live Query is not redundantly invalidated after a
+mutation because its runtime observation already receives the committed revision. Contextual
+Selection observation is not supported yet. Live and one-shot evaluations use distinct internal
+React Query keys, including when the application supplies the same custom key, so both lifecycles
+may consume one authored Query simultaneously.
 
 With an observation-capable Runtime Transport, `client.graph.bindVariantSelection(Chapter.all())`
 supports `.exec().observe()`. Complete snapshots recalculate membership, ordering and limits;
@@ -133,6 +145,65 @@ await completeVisible.executeAsync();
 The bound invocation always uses the latest render input. Passing the Operation declaration itself
 keeps the lower-level reusable mutation form, where each execution supplies its input.
 
+`onSuccess` runs as soon as the invocation succeeds, before semantic query invalidation finishes.
+Use it for UI reactions that should follow the committed result immediately, such as closing a
+confirmation dialog or navigating away:
+
+```tsx
+const removeTodo = useOperation(TodoItem.domain.remove, {
+  onSuccess: () => navigate('/todos'),
+});
+```
+
+By contrast, `executeAsync()` settles after affected reads have been invalidated. Await it when the
+next statement requires refreshed query state. An invalidation delay therefore does not postpone
+`onSuccess`, but it can keep the returned Promise pending.
+
+`OntahiGraphProvider` consumes committed semantic metadata from every execution exchange on its
+Runtime Transport. Every cached `useGraphQuery` retains its canonical `GraphReadRequest` in React
+Query metadata; after commit, Ontahí compares those Reads with the bounded
+`CommittedMutationSet` and refetches every possible overlap. A provably disjoint Read remains
+current, while an unsupported shape refreshes conservatively. This applies equally to hooks,
+Devtools Console executions, and other clients using the provider's transport.
+
+Entity create, update, and delete use the same path as Relationship and ordered Commands:
+
+```ts
+const updateTodo = useEntityMutationCommand(
+  ({ todo, completed }: { todo: EntityRef; completed: boolean }) =>
+    mutateEntity(TodoItemSchema).update(todo, { completed }),
+);
+
+await updateTodo.mutateAsync({ todo, completed: true });
+```
+
+Applications do not name query keys, forward mutation callbacks, or call `refetch()` after a
+successful semantic mutation.
+`useGraphCommand`, `useEntityMutationCommand`, `useManyToManyRelationshipCommand`,
+`useOrderedRelationshipCommand`, Operation hooks, and terminal durable Operation hooks all consume
+the same metadata. Existing `invalidateQueryKeys`, `bridge.invalidate`, and
+`useCanonicalRequestInvalidation` remain compatibility escape hatches for older receivers that do
+not return committed mutations; they are not required by the normal Runtime Protocol path.
+
+Model Commands use the same transport and invalidation path without application wiring:
+
+```tsx
+const modelCommand = useModelCommand();
+
+const outcome = await modelCommand.submit({ text: 'Complete every item in Inbox' });
+if (outcome.ok && outcome.value.status === 'pending') {
+  await modelCommand.respond(outcome.value.run, {
+    interactionId: outcome.value.interaction.id,
+    optionId: selectedOption,
+  });
+}
+```
+
+`useModelCommand()` observes started Operations and resumes durable interactions. Terminal
+inspection uses the same execution exchange, so its committed effects refresh active reads through
+the provider. The UI owns conversation presentation and input state, not transport orchestration or
+cache invalidation.
+
 Durable Operations use the same invocation bridge to start a run, then observe its lifecycle
 through Runtime Transport:
 
@@ -143,6 +214,10 @@ await completeAll.executeAsync();
 // completeAll.status/progress/finalValue follow the accepted run.
 ```
 
+A pending typed Interaction is a distinct `waiting` lifecycle state. The hook exposes
+`isWaiting` separately from `isRunning`, keeps the run observation active, and continues to report
+`isExecuting` until the run completes, fails, or is cancelled.
+
 The hook consumes an asynchronous snapshot sequence and does not choose polling or push. The
 conventional Fetch Runtime Transport implements that sequence with versioned
 `durable.operation.inspect` requests and owns the polling cadence:
@@ -162,9 +237,17 @@ For a WebSocket host, compose the same graph client around the push-capable tran
 
 ```ts
 const runtimeTransport = createWebSocketRuntimeTransport({ url: 'wss://app.example/runtime' });
-const client = createRuntimeGraphClient({ runtimeTransport });
+const client = createRuntimeGraphClient({
+  application: clientApplication,
+  runtimeTransport,
+});
 ```
 
+`clientApplication` is emitted by `@ontahi/codegen`. Retaining it on the client lets integrations
+inside `OntahiGraphProvider`, including Devtools, discover the same browser-safe Entity and
+Operation catalog without repeating it in component props. The provider likewise exposes its
+resolved identity, cache, and transport as one client-session context.
+
 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
@@ -204,8 +287,10 @@ Command. The executor supports policy-bounded Relationship Commands and identity
 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
+`useEntityMutationCommand` executes create, update, and delete Commands and invalidates overlapping
+Graph Reads from their committed semantic metadata. `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.
+project the requested order temporarily; the hook refreshes possibly affected Reads after the
+authority commits the command.

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;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"}
+{"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,EAKL,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;AAyKF,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,7 +1,7 @@
 'use client';
 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 { createRuntimeProtocolExchange, createRuntimeProtocolExecutionExchange, 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';
@@ -35,35 +35,49 @@ const postLegacyBridgeRequest = async (endpoint, request, fetchRequest, requestI
     if (!response.ok && !isOperationInvocationProtocolResponse(payload)) {
         throw new Error(`Graph bridge request failed with status ${response.status}.`);
     }
-    return payload;
+    return { body: payload };
 };
 const createOperationRequest = (options) => {
     const endpoint = operationEndpoint(options);
     if (endpoint) {
         return request => postLegacyBridgeRequest(endpoint, request, options.fetch ?? globalThis.fetch, options.requestInit);
     }
+    const transport = options.runtimeTransport ??
+        createFetchRuntimeTransport({
+            ...(options.fetch ? { fetch: options.fetch } : {}),
+            ...(options.requestInit ? { requestInit: options.requestInit } : {}),
+        });
     const exchange = createRuntimeProtocolExchange({
-        transport: options.runtimeTransport ??
-            createFetchRuntimeTransport({
-                ...(options.fetch ? { fetch: options.fetch } : {}),
-                ...(options.requestInit ? { requestInit: options.requestInit } : {}),
-            }),
+        transport,
         requestId: options.requestId,
     });
-    return request => exchange({
-        family: 'operation',
-        body: toOperationProtocolRequest(request),
+    const executionExchange = createRuntimeProtocolExecutionExchange({
+        transport,
+        requestId: options.requestId,
     });
+    return async (request) => request.kind === 'invoke'
+        ? executionExchange({
+            family: 'operation',
+            body: toOperationProtocolRequest(request),
+        })
+        : {
+            body: await 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;
+    let execution;
     try {
-        payload = await requestOperation(request);
+        execution = await requestOperation(request);
     }
     catch (error) {
         return { serverError: errorMessage(error) };
     }
+    const payload = execution.body;
+    const executionMetadata = execution.metadata;
     if (!isOperationInvocationProtocolResponse(payload)) {
         return { serverError: 'Graph bridge returned an invalid response.' };
     }
@@ -71,7 +85,10 @@ const postBridgeRequest = async (requestOperation, request) => {
         return { serverError: payload.error.message };
     }
     if (request.kind === 'invoke' && payload.kind === 'invocation-result') {
-        return { data: payload.result };
+        return {
+            data: payload.result,
+            ...(executionMetadata ? { executionMetadata } : {}),
+        };
     }
     if (request.kind === 'check-permission' && payload.kind === 'permission-result') {
         return { data: payload.result };

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 {\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"]}
+{"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  createRuntimeProtocolExecutionExchange,\n  toOperationProtocolRequest,\n  type RuntimeProtocolExecutionExchangeResult,\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 = (\n  request: OperationInvocationRequest,\n) => Promise<RuntimeProtocolExecutionExchangeResult>;\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<RuntimeProtocolExecutionExchangeResult> => {\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 { body: 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 transport =\n    options.runtimeTransport ??\n    createFetchRuntimeTransport<TTransportOptions>({\n      ...(options.fetch ? { fetch: options.fetch } : {}),\n      ...(options.requestInit ? { requestInit: options.requestInit } : {}),\n    });\n  const exchange = createRuntimeProtocolExchange({\n    transport,\n    requestId: options.requestId,\n  });\n  const executionExchange = createRuntimeProtocolExecutionExchange({\n    transport,\n    requestId: options.requestId,\n  });\n  return async request =>\n    request.kind === 'invoke'\n      ? executionExchange({\n          family: 'operation',\n          body: toOperationProtocolRequest(request),\n        })\n      : {\n          body: await exchange({\n            family: 'operation',\n            body: toOperationProtocolRequest(request),\n          }),\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 execution: RuntimeProtocolExecutionExchangeResult;\n  try {\n    execution = await requestOperation(request);\n  } catch (error) {\n    return { serverError: errorMessage(error) };\n  }\n  const payload = execution.body;\n  const executionMetadata = execution.metadata;\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 {\n      data: payload.result as TData,\n      ...(executionMetadata ? { executionMetadata } : {}),\n    };\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/actions/operation-bridge.d.ts

@@ -1,11 +1,13 @@
 import type { ClientDomainOperationDeclaration, EntityViewAst } from '@ontahi/core/data-graph';
 import { type ActionQueryKey } from '@ontahi/core/runtime/actions';
 import type { OperationInvocationResult } from '@ontahi/core/runtime/contracts';
+import type { RuntimeProtocolExecutionMetadata } from '@ontahi/core/runtime/protocol';
 import type { QueryKey, UseQueryResult } from '@tanstack/react-query';
 import type { ActionResultLike, UseActionOptions, UseActionResult } from './use-action.js';
 export type { OperationInvocationResult };
 export type OperationBridgeActionResult<TData> = Omit<ActionResultLike, 'data'> & {
     data?: TData;
+    executionMetadata?: RuntimeProtocolExecutionMetadata;
 };
 export type OperationBridgeAction<TInput, TData> = (input: TInput) => Promise<OperationBridgeActionResult<OperationInvocationResult<TData>>>;
 export type OperationInvocationFailure<TFailure = unknown> = Exclude<OperationInvocationResult<unknown, TFailure>, {

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

@@ -1 +1 @@
-{"version":3,"file":"operation-bridge.d.ts","sourceRoot":"","sources":["../../src/actions/operation-bridge.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gCAAgC,EAChC,aAAa,EAEd,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAEhF,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE3F,YAAY,EAAE,yBAAyB,EAAE,CAAC;AAE1C,MAAM,MAAM,2BAA2B,CAAC,KAAK,IAAI,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,GAAG;IAChF,IAAI,CAAC,EAAE,KAAK,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,qBAAqB,CAAC,MAAM,EAAE,KAAK,IAAI,CACjD,KAAK,EAAE,MAAM,KACV,OAAO,CAAC,2BAA2B,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAE5E,MAAM,MAAM,0BAA0B,CAAC,QAAQ,GAAG,OAAO,IAAI,OAAO,CAClE,yBAAyB,CAAC,OAAO,EAAE,QAAQ,CAAC,EAC5C;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,CACb,CAAC;AAEF,qBAAa,8BAA8B,CAAC,QAAQ,GAAG,OAAO,CAAE,SAAQ,KAAK;IAI/D,QAAQ,CAAC,MAAM,EAAE,0BAA0B,CAAC,QAAQ,CAAC;IAHjE,QAAQ,CAAC,IAAI,oCAAoC;IACjD,SAAiB,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEZ,MAAM,EAAE,0BAA0B,CAAC,QAAQ,CAAC;IAUjE,MAAM;;;;;;CAQP;AAED,eAAO,MAAM,2BAA2B,GAAI,KAAK,GAAG,OAAO,EAAE,QAAQ,GAAG,OAAO,EAC7E,OAAO,OAAO,KACb,KAAK,IAAI,yBAAyB,CAAC,KAAK,EAAE,QAAQ,CAC+B,CAAC;AAErF,eAAO,MAAM,sBAAsB,GAAI,SAAS,MAAM,KAAG,yBAKvD,CAAC;AAEH,eAAO,MAAM,2BAA2B,GAAI,KAAK,EAC/C,QAAQ,2BAA2B,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC,KACpE,yBAAyB,CAAC,KAAK,CAsBjC,CAAC;AAEF,eAAO,MAAM,8BAA8B,GAAI,KAAK,EAClD,QAAQ,yBAAyB,CAAC,KAAK,CAAC,KACvC,KAMF,CAAC;AAEF,MAAM,MAAM,oBAAoB,CAAC,MAAM,EAAE,KAAK,IAAI,gCAAgC,CAChF,MAAM,EACN,KAAK,CACN,GAAG;IACF,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG,CAAC,KAAK,EAAE;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAEhC,MAAM,MAAM,eAAe,GACvB;IACE,OAAO,EAAE,IAAI,CAAC;CACf,GACD;IACE,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN,MAAM,MAAM,0CAA0C,GAAG,CAAC,KAAK,EAAE;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;CAChB,KAAK,OAAO,CAAC,2BAA2B,CAAC,eAAe,CAAC,CAAC,CAAC;AAE5D,MAAM,MAAM,sBAAsB,CAAC,YAAY,SAAS,MAAM,GAAG,MAAM,IAAI;IACzE,IAAI,EAAE,YAAY,CAAC;IACnB,eAAe,EAAE,CAAC,MAAM,EAAE,KAAK,EAC7B,SAAS,EAAE,oBAAoB,CAAC,MAAM,EAAE,KAAK,CAAC,KAC3C,qBAAqB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC1C,iBAAiB,EAAE,CAAC,MAAM,EAAE,KAAK,EAC/B,SAAS,EAAE,oBAAoB,CAAC,MAAM,EAAE,KAAK,CAAC,EAC9C,OAAO,CAAC,EAAE,gBAAgB,CAAC,qBAAqB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,GAAG;QACjE,mBAAmB,CAAC,EAAE,OAAO,CAAC;KAC/B,KACE,eAAe,CAAC,qBAAqB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IAC3D,cAAc,EAAE,CAAC,MAAM,EAAE,KAAK,EAC5B,SAAS,EAAE,oBAAoB,CAAC,MAAM,EAAE,KAAK,CAAC,EAC9C,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,QAAQ,CAAC;KACf,KACE,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAClC,aAAa,EAAE,CAAC,MAAM,EAAE,KAAK,EAC3B,SAAS,EAAE,oBAAoB,CAAC,MAAM,EAAE,KAAK,CAAC,EAC9C,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,QAAQ,CAAC,EAAE,QAAQ,CAAC;KACrB,KACE,cAAc,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAEvE,eAAO,MAAM,+BAA+B,GAAI,MAAM,EAAE,KAAK,EAC3D,WAAW,oBAAoB,CAAC,MAAM,EAAE,KAAK,CAAC,4CACwC,CAAC;AAczF,eAAO,MAAM,8BAA8B,GAAI,MAAM,EAAE,KAAK,EAC1D,WAAW,oBAAoB,CAAC,MAAM,EAAE,KAAK,CAAC,EAC9C,OAAO,MAAM,KACZ,cASF,CAAC;AAEF,eAAO,MAAM,2CAA2C,GAAI,MAAM,EAAE,KAAK,EACvE,WAAW,oBAAoB,CAAC,MAAM,EAAE,KAAK,CAAC,EAC9C,OAAO,MAAM,KACZ,cAAc,EAMhB,CAAC;AAEF,eAAO,MAAM,iCAAiC,GAC3C,MAAM,EAAE,KAAK,EACZ,cAAc,8BAA8B,EAC5C,WAAW,oBAAoB,CAAC,MAAM,EAAE,KAAK,CAAC,KAC7C,qBAAqB,CAAC,MAAM,EAAE,KAAK,CAMwC,CAAC;AAEjF,eAAO,MAAM,kCAAkC,GAAI,MAAM,EAAE,KAAK,EAC9D,WAAW,oBAAoB,CAAC,MAAM,EAAE,KAAK,CAAC,EAC9C,QAAQ,qBAAqB,CAAC,MAAM,EAAE,KAAK,CAAC,EAC5C,SAAS;IACP,YAAY,EAAE,OAAO,CAAC;CACvB;;CAUC,CAAC"}
+{"version":3,"file":"operation-bridge.d.ts","sourceRoot":"","sources":["../../src/actions/operation-bridge.ts"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"operation-bridge.js","sourceRoot":"","sources":["../../src/actions/operation-bridge.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAOb,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,GAEf,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAoBrD,MAAM,OAAO,8BAAmD,SAAQ,KAAK;IAI3E,YAAqB,MAA4C;QAC/D,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QADH,WAAM,GAAN,MAAM,CAAsC;QAHxD,SAAI,GAAG,gCAAgC,CAAC;QAK/C,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE;gBACnC,YAAY,EAAE,IAAI;gBAClB,KAAK,EAAE,MAAM,CAAC,OAAO;aACtB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;YAC1D,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC;IACJ,CAAC;CACF;AAED,MAAM,CAAC,MAAM,2BAA2B,GAAG,CACzC,KAAc,EACuC,EAAE,CACvD,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;AAErF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,OAAe,EAA6B,EAAE,CAAC,CAAC;IACrF,EAAE,EAAE,KAAK;IACT,IAAI,EAAE,SAAS;IACf,QAAQ,EAAE,SAAS;IACnB,OAAO;CACR,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CACzC,MAAqE,EACnC,EAAE;IACpC,IAAI,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO,sBAAsB,CAC3B,qBAAqB,CAAC,MAAM,CAAC,CACM,CAAC;IACxC,CAAC;IAED,IAAI,2BAA2B,CAAQ,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACpD,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;QACrB,OAAO;YACL,EAAE,EAAE,IAAI;YACR,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,MAAM,CAAC,IAAa;SAC5B,CAAC;IACJ,CAAC;IAED,OAAO,sBAAsB,CAC3B,sDAAsD,CACnB,CAAC;AACxC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAC5C,MAAwC,EACjC,EAAE;IACT,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACd,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,MAAM,IAAI,8BAA8B,CAAC,MAAM,CAAC,CAAC;AACnD,CAAC,CAAC;AA+DF,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAC7C,SAA8C,EAC9C,EAAE,CAAC,CAAC,SAAS,CAAC,UAAU,EAAE,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAU,CAAC;AAEzF,MAAM,qCAAqC,GAAG,CAC5C,OAAgC,EAChC,SAA8C,EAC9C,KAAa,EACb,EAAE,CACF,OAAO,OAAO,KAAK,UAAU;IAC3B,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE;QACb,KAAK;QACL,SAAS;KACV,CAAC;IACJ,CAAC,CAAC,OAAO,CAAC;AAEd,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAC5C,SAA8C,EAC9C,KAAa,EACG,EAAE;IAClB,OAAO;QACL,SAAS,CAAC,UAAU;QACpB,SAAS,CAAC,IAAI;QACd,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3C,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE,CACzC,qCAAqC,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CACjE,IAAI,EAAE,CAAC;KACT,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,2CAA2C,GAAG,CACzD,SAA8C,EAC9C,KAAa,EACK,EAAE;IACpB,OAAO,CACL,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,CAAC,SAAS,CAAC,EAAE,CAC5C,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,qCAAqC,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAC3F,IAAI,EAAE,CACR,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iCAAiC,GAC5C,CACE,YAA4C,EAC5C,SAA8C,EACR,EAAE,CAC1C,CAAC,KAAa,EAAE,EAAE,CAChB,YAAY,CAAC;IACX,WAAW,EAAE,SAAS,CAAC,EAAE;IACzB,KAAK;IACL,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;CACpD,CAA2E,CAAC;AAEjF,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAChD,SAA8C,EAC9C,MAA4C,EAC5C,OAEC,EACD,EAAE,CACF,mBAAmB,CAAC,MAAM,EAAE;IAC1B,OAAO,EAAE,SAAS,CAAC,UAAU;IAC7B,UAAU,EAAE,SAAS,CAAC,IAAI;IAC1B,YAAY,EAAE,OAAO,CAAC,YAAY;IAClC,cAAc,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,SAAS,CAAC,IAAI,CAAU;IAC/D,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,8BAA8B,CAAC,SAAS,EAAE,KAAe,CAAC;IAChF,oBAAoB,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAClC,2CAA2C,CAAC,SAAS,EAAE,KAAe,CAAC;CAC1E,CAAC,CAAC","sourcesContent":["'use client';\n\nimport type {\n  ClientDomainOperationDeclaration,\n  EntityViewAst,\n  QueryKeySegment,\n} from '@ontahi/core/data-graph';\nimport {\n  attachActionRuntime,\n  getActionErrorMessage,\n  hasActionError,\n  type ActionQueryKey,\n} from '@ontahi/core/runtime/actions';\nimport type { OperationInvocationResult } from '@ontahi/core/runtime/contracts';\nimport { isRecord } from '@ontahi/core/value/object';\nimport type { QueryKey, UseQueryResult } from '@tanstack/react-query';\n\nimport type { ActionResultLike, UseActionOptions, UseActionResult } from './use-action.js';\n\nexport type { OperationInvocationResult };\n\nexport type OperationBridgeActionResult<TData> = Omit<ActionResultLike, 'data'> & {\n  data?: TData;\n};\n\nexport type OperationBridgeAction<TInput, TData> = (\n  input: TInput,\n) => Promise<OperationBridgeActionResult<OperationInvocationResult<TData>>>;\n\nexport type OperationInvocationFailure<TFailure = unknown> = Exclude<\n  OperationInvocationResult<unknown, TFailure>,\n  { ok: true }\n>;\n\nexport class OperationInvocationResultError<TFailure = unknown> extends Error {\n  readonly name = 'OperationInvocationResultError';\n  declare readonly cause?: unknown;\n\n  constructor(readonly result: OperationInvocationFailure<TFailure>) {\n    super(result.message);\n    if (result.kind === 'failed') {\n      Object.defineProperty(this, 'cause', {\n        configurable: true,\n        value: result.failure,\n      });\n    }\n  }\n\n  toJSON() {\n    return {\n      name: this.name,\n      message: this.message,\n      ...(this.cause === undefined ? {} : { cause: this.cause }),\n      result: this.result,\n    };\n  }\n}\n\nexport const isOperationInvocationResult = <TData = unknown, TFailure = unknown>(\n  value: unknown,\n): value is OperationInvocationResult<TData, TFailure> =>\n  isRecord(value) && typeof value.ok === 'boolean' && typeof value.kind === 'string';\n\nexport const operationBridgeErrored = (message: string): OperationInvocationResult => ({\n  ok: false,\n  kind: 'errored',\n  executed: 'unknown',\n  message,\n});\n\nexport const toOperationInvocationResult = <TData>(\n  result: OperationBridgeActionResult<OperationInvocationResult<TData>>,\n): OperationInvocationResult<TData> => {\n  if (hasActionError(result)) {\n    return operationBridgeErrored(\n      getActionErrorMessage(result),\n    ) as OperationInvocationResult<TData>;\n  }\n\n  if (isOperationInvocationResult<TData>(result.data)) {\n    return result.data;\n  }\n\n  if ('data' in result) {\n    return {\n      ok: true,\n      kind: 'success',\n      value: result.data as TData,\n    };\n  }\n\n  return operationBridgeErrored(\n    'Graph operation bridge returned an invalid response.',\n  ) as OperationInvocationResult<TData>;\n};\n\nexport const unwrapOperationInvocationValue = <TData>(\n  result: OperationInvocationResult<TData>,\n): TData => {\n  if (result.ok) {\n    return result.value;\n  }\n\n  throw new OperationInvocationResultError(result);\n};\n\nexport type BridgedOperationLike<TInput, TData> = ClientDomainOperationDeclaration<\n  TInput,\n  TData\n> & {\n  id: string;\n  entityName: string;\n  name: string;\n  view?: EntityViewAst;\n};\n\nexport type RunDomainOperationBridgeAction = (input: {\n  operationId: string;\n  input: unknown;\n  view?: EntityViewAst;\n}) => Promise<ActionResultLike>;\n\nexport type GraphPermission =\n  | {\n      allowed: true;\n    }\n  | {\n      allowed: false;\n      reason: string;\n      message: string;\n    };\n\nexport type CheckDomainOperationPermissionBridgeAction = (input: {\n  operationId: string;\n  input: unknown;\n}) => Promise<OperationBridgeActionResult<GraphPermission>>;\n\nexport type OperationBridgeAdapter<TAdapterName extends string = string> = {\n  name: TAdapterName;\n  useBridgeAction: <TInput, TData>(\n    operation: BridgedOperationLike<TInput, TData>,\n  ) => OperationBridgeAction<TInput, TData>;\n  useBridgeMutation: <TInput, TData>(\n    operation: BridgedOperationLike<TInput, TData>,\n    options?: UseActionOptions<OperationBridgeAction<TInput, TData>> & {\n      invalidateOnSuccess?: boolean;\n    },\n  ) => UseActionResult<OperationBridgeAction<TInput, TData>>;\n  useBridgeQuery: <TInput, TData>(\n    operation: BridgedOperationLike<TInput, TData>,\n    args: {\n      input: TInput;\n      key: QueryKey;\n    },\n  ) => UseQueryResult<TData, Error>;\n  usePermission: <TInput, TData>(\n    operation: BridgedOperationLike<TInput, TData>,\n    input: TInput,\n    options?: {\n      enabled?: boolean;\n      queryKey?: QueryKey;\n    },\n  ) => UseQueryResult<GraphPermission, Error>;\n};\n\nexport type AnyOperationBridgeAdapter = OperationBridgeAdapter<string>;\n\nexport const resolveOperationBridgeQuerySpec = <TInput, TData>(\n  operation: BridgedOperationLike<TInput, TData>,\n) => [operation.entityName, operation.name, ...(operation.bridge?.query ?? [])] as const;\n\nconst resolveOperationBridgeQueryKeySegment = <TInput, TData>(\n  segment: QueryKeySegment<TInput>,\n  operation: BridgedOperationLike<TInput, TData>,\n  input: TInput,\n) =>\n  typeof segment === 'function'\n    ? segment(input, {\n        input,\n        operation,\n      })\n    : segment;\n\nexport const resolveOperationBridgeQueryKey = <TInput, TData>(\n  operation: BridgedOperationLike<TInput, TData>,\n  input: TInput,\n): ActionQueryKey => {\n  return [\n    operation.entityName,\n    operation.name,\n    ...(operation.view ? [operation.view] : []),\n    ...(operation.bridge?.query?.map(segment =>\n      resolveOperationBridgeQueryKeySegment(segment, operation, input),\n    ) ?? []),\n  ];\n};\n\nexport const resolveOperationBridgeInvalidationQueryKeys = <TInput, TData>(\n  operation: BridgedOperationLike<TInput, TData>,\n  input: TInput,\n): ActionQueryKey[] => {\n  return (\n    operation.bridge?.invalidate?.map(querySpec =>\n      querySpec.map(segment => resolveOperationBridgeQueryKeySegment(segment, operation, input)),\n    ) ?? []\n  );\n};\n\nexport const createDomainOperationBridgeAction =\n  <TInput, TData>(\n    bridgeAction: RunDomainOperationBridgeAction,\n    operation: BridgedOperationLike<TInput, TData>,\n  ): OperationBridgeAction<TInput, TData> =>\n  (input: TInput) =>\n    bridgeAction({\n      operationId: operation.id,\n      input,\n      ...(operation.view ? { view: operation.view } : {}),\n    }) as Promise<OperationBridgeActionResult<OperationInvocationResult<TData>>>;\n\nexport const attachOperationBridgeActionRuntime = <TInput, TData>(\n  operation: BridgedOperationLike<TInput, TData>,\n  action: OperationBridgeAction<TInput, TData>,\n  options: {\n    requiresAuth: boolean;\n  },\n) =>\n  attachActionRuntime(action, {\n    feature: operation.entityName,\n    actionName: operation.name,\n    requiresAuth: options.requiresAuth,\n    queryKeyPrefix: [operation.entityName, operation.name] as const,\n    getQueryKey: input => resolveOperationBridgeQueryKey(operation, input as TInput),\n    getAffectedQueryKeys: ({ input }) =>\n      resolveOperationBridgeInvalidationQueryKeys(operation, input as TInput),\n  });\n"]}
+{"version":3,"file":"operation-bridge.js","sourceRoot":"","sources":["../../src/actions/operation-bridge.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAOb,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,GAEf,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAqBrD,MAAM,OAAO,8BAAmD,SAAQ,KAAK;IAI3E,YAAqB,MAA4C;QAC/D,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QADH,WAAM,GAAN,MAAM,CAAsC;QAHxD,SAAI,GAAG,gCAAgC,CAAC;QAK/C,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE;gBACnC,YAAY,EAAE,IAAI;gBAClB,KAAK,EAAE,MAAM,CAAC,OAAO;aACtB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;YAC1D,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC;IACJ,CAAC;CACF;AAED,MAAM,CAAC,MAAM,2BAA2B,GAAG,CACzC,KAAc,EACuC,EAAE,CACvD,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;AAErF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,OAAe,EAA6B,EAAE,CAAC,CAAC;IACrF,EAAE,EAAE,KAAK;IACT,IAAI,EAAE,SAAS;IACf,QAAQ,EAAE,SAAS;IACnB,OAAO;CACR,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CACzC,MAAqE,EACnC,EAAE;IACpC,IAAI,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO,sBAAsB,CAC3B,qBAAqB,CAAC,MAAM,CAAC,CACM,CAAC;IACxC,CAAC;IAED,IAAI,2BAA2B,CAAQ,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACpD,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;QACrB,OAAO;YACL,EAAE,EAAE,IAAI;YACR,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,MAAM,CAAC,IAAa;SAC5B,CAAC;IACJ,CAAC;IAED,OAAO,sBAAsB,CAC3B,sDAAsD,CACnB,CAAC;AACxC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAC5C,MAAwC,EACjC,EAAE;IACT,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACd,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,MAAM,IAAI,8BAA8B,CAAC,MAAM,CAAC,CAAC;AACnD,CAAC,CAAC;AA+DF,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAC7C,SAA8C,EAC9C,EAAE,CAAC,CAAC,SAAS,CAAC,UAAU,EAAE,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAU,CAAC;AAEzF,MAAM,qCAAqC,GAAG,CAC5C,OAAgC,EAChC,SAA8C,EAC9C,KAAa,EACb,EAAE,CACF,OAAO,OAAO,KAAK,UAAU;IAC3B,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE;QACb,KAAK;QACL,SAAS;KACV,CAAC;IACJ,CAAC,CAAC,OAAO,CAAC;AAEd,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAC5C,SAA8C,EAC9C,KAAa,EACG,EAAE;IAClB,OAAO;QACL,SAAS,CAAC,UAAU;QACpB,SAAS,CAAC,IAAI;QACd,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3C,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE,CACzC,qCAAqC,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CACjE,IAAI,EAAE,CAAC;KACT,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,2CAA2C,GAAG,CACzD,SAA8C,EAC9C,KAAa,EACK,EAAE;IACpB,OAAO,CACL,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,CAAC,SAAS,CAAC,EAAE,CAC5C,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,qCAAqC,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAC3F,IAAI,EAAE,CACR,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iCAAiC,GAC5C,CACE,YAA4C,EAC5C,SAA8C,EACR,EAAE,CAC1C,CAAC,KAAa,EAAE,EAAE,CAChB,YAAY,CAAC;IACX,WAAW,EAAE,SAAS,CAAC,EAAE;IACzB,KAAK;IACL,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;CACpD,CAA2E,CAAC;AAEjF,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAChD,SAA8C,EAC9C,MAA4C,EAC5C,OAEC,EACD,EAAE,CACF,mBAAmB,CAAC,MAAM,EAAE;IAC1B,OAAO,EAAE,SAAS,CAAC,UAAU;IAC7B,UAAU,EAAE,SAAS,CAAC,IAAI;IAC1B,YAAY,EAAE,OAAO,CAAC,YAAY;IAClC,cAAc,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,SAAS,CAAC,IAAI,CAAU;IAC/D,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,8BAA8B,CAAC,SAAS,EAAE,KAAe,CAAC;IAChF,oBAAoB,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAClC,2CAA2C,CAAC,SAAS,EAAE,KAAe,CAAC;CAC1E,CAAC,CAAC","sourcesContent":["'use client';\n\nimport type {\n  ClientDomainOperationDeclaration,\n  EntityViewAst,\n  QueryKeySegment,\n} from '@ontahi/core/data-graph';\nimport {\n  attachActionRuntime,\n  getActionErrorMessage,\n  hasActionError,\n  type ActionQueryKey,\n} from '@ontahi/core/runtime/actions';\nimport type { OperationInvocationResult } from '@ontahi/core/runtime/contracts';\nimport type { RuntimeProtocolExecutionMetadata } from '@ontahi/core/runtime/protocol';\nimport { isRecord } from '@ontahi/core/value/object';\nimport type { QueryKey, UseQueryResult } from '@tanstack/react-query';\n\nimport type { ActionResultLike, UseActionOptions, UseActionResult } from './use-action.js';\n\nexport type { OperationInvocationResult };\n\nexport type OperationBridgeActionResult<TData> = Omit<ActionResultLike, 'data'> & {\n  data?: TData;\n  executionMetadata?: RuntimeProtocolExecutionMetadata;\n};\n\nexport type OperationBridgeAction<TInput, TData> = (\n  input: TInput,\n) => Promise<OperationBridgeActionResult<OperationInvocationResult<TData>>>;\n\nexport type OperationInvocationFailure<TFailure = unknown> = Exclude<\n  OperationInvocationResult<unknown, TFailure>,\n  { ok: true }\n>;\n\nexport class OperationInvocationResultError<TFailure = unknown> extends Error {\n  readonly name = 'OperationInvocationResultError';\n  declare readonly cause?: unknown;\n\n  constructor(readonly result: OperationInvocationFailure<TFailure>) {\n    super(result.message);\n    if (result.kind === 'failed') {\n      Object.defineProperty(this, 'cause', {\n        configurable: true,\n        value: result.failure,\n      });\n    }\n  }\n\n  toJSON() {\n    return {\n      name: this.name,\n      message: this.message,\n      ...(this.cause === undefined ? {} : { cause: this.cause }),\n      result: this.result,\n    };\n  }\n}\n\nexport const isOperationInvocationResult = <TData = unknown, TFailure = unknown>(\n  value: unknown,\n): value is OperationInvocationResult<TData, TFailure> =>\n  isRecord(value) && typeof value.ok === 'boolean' && typeof value.kind === 'string';\n\nexport const operationBridgeErrored = (message: string): OperationInvocationResult => ({\n  ok: false,\n  kind: 'errored',\n  executed: 'unknown',\n  message,\n});\n\nexport const toOperationInvocationResult = <TData>(\n  result: OperationBridgeActionResult<OperationInvocationResult<TData>>,\n): OperationInvocationResult<TData> => {\n  if (hasActionError(result)) {\n    return operationBridgeErrored(\n      getActionErrorMessage(result),\n    ) as OperationInvocationResult<TData>;\n  }\n\n  if (isOperationInvocationResult<TData>(result.data)) {\n    return result.data;\n  }\n\n  if ('data' in result) {\n    return {\n      ok: true,\n      kind: 'success',\n      value: result.data as TData,\n    };\n  }\n\n  return operationBridgeErrored(\n    'Graph operation bridge returned an invalid response.',\n  ) as OperationInvocationResult<TData>;\n};\n\nexport const unwrapOperationInvocationValue = <TData>(\n  result: OperationInvocationResult<TData>,\n): TData => {\n  if (result.ok) {\n    return result.value;\n  }\n\n  throw new OperationInvocationResultError(result);\n};\n\nexport type BridgedOperationLike<TInput, TData> = ClientDomainOperationDeclaration<\n  TInput,\n  TData\n> & {\n  id: string;\n  entityName: string;\n  name: string;\n  view?: EntityViewAst;\n};\n\nexport type RunDomainOperationBridgeAction = (input: {\n  operationId: string;\n  input: unknown;\n  view?: EntityViewAst;\n}) => Promise<ActionResultLike>;\n\nexport type GraphPermission =\n  | {\n      allowed: true;\n    }\n  | {\n      allowed: false;\n      reason: string;\n      message: string;\n    };\n\nexport type CheckDomainOperationPermissionBridgeAction = (input: {\n  operationId: string;\n  input: unknown;\n}) => Promise<OperationBridgeActionResult<GraphPermission>>;\n\nexport type OperationBridgeAdapter<TAdapterName extends string = string> = {\n  name: TAdapterName;\n  useBridgeAction: <TInput, TData>(\n    operation: BridgedOperationLike<TInput, TData>,\n  ) => OperationBridgeAction<TInput, TData>;\n  useBridgeMutation: <TInput, TData>(\n    operation: BridgedOperationLike<TInput, TData>,\n    options?: UseActionOptions<OperationBridgeAction<TInput, TData>> & {\n      invalidateOnSuccess?: boolean;\n    },\n  ) => UseActionResult<OperationBridgeAction<TInput, TData>>;\n  useBridgeQuery: <TInput, TData>(\n    operation: BridgedOperationLike<TInput, TData>,\n    args: {\n      input: TInput;\n      key: QueryKey;\n    },\n  ) => UseQueryResult<TData, Error>;\n  usePermission: <TInput, TData>(\n    operation: BridgedOperationLike<TInput, TData>,\n    input: TInput,\n    options?: {\n      enabled?: boolean;\n      queryKey?: QueryKey;\n    },\n  ) => UseQueryResult<GraphPermission, Error>;\n};\n\nexport type AnyOperationBridgeAdapter = OperationBridgeAdapter<string>;\n\nexport const resolveOperationBridgeQuerySpec = <TInput, TData>(\n  operation: BridgedOperationLike<TInput, TData>,\n) => [operation.entityName, operation.name, ...(operation.bridge?.query ?? [])] as const;\n\nconst resolveOperationBridgeQueryKeySegment = <TInput, TData>(\n  segment: QueryKeySegment<TInput>,\n  operation: BridgedOperationLike<TInput, TData>,\n  input: TInput,\n) =>\n  typeof segment === 'function'\n    ? segment(input, {\n        input,\n        operation,\n      })\n    : segment;\n\nexport const resolveOperationBridgeQueryKey = <TInput, TData>(\n  operation: BridgedOperationLike<TInput, TData>,\n  input: TInput,\n): ActionQueryKey => {\n  return [\n    operation.entityName,\n    operation.name,\n    ...(operation.view ? [operation.view] : []),\n    ...(operation.bridge?.query?.map(segment =>\n      resolveOperationBridgeQueryKeySegment(segment, operation, input),\n    ) ?? []),\n  ];\n};\n\nexport const resolveOperationBridgeInvalidationQueryKeys = <TInput, TData>(\n  operation: BridgedOperationLike<TInput, TData>,\n  input: TInput,\n): ActionQueryKey[] => {\n  return (\n    operation.bridge?.invalidate?.map(querySpec =>\n      querySpec.map(segment => resolveOperationBridgeQueryKeySegment(segment, operation, input)),\n    ) ?? []\n  );\n};\n\nexport const createDomainOperationBridgeAction =\n  <TInput, TData>(\n    bridgeAction: RunDomainOperationBridgeAction,\n    operation: BridgedOperationLike<TInput, TData>,\n  ): OperationBridgeAction<TInput, TData> =>\n  (input: TInput) =>\n    bridgeAction({\n      operationId: operation.id,\n      input,\n      ...(operation.view ? { view: operation.view } : {}),\n    }) as Promise<OperationBridgeActionResult<OperationInvocationResult<TData>>>;\n\nexport const attachOperationBridgeActionRuntime = <TInput, TData>(\n  operation: BridgedOperationLike<TInput, TData>,\n  action: OperationBridgeAction<TInput, TData>,\n  options: {\n    requiresAuth: boolean;\n  },\n) =>\n  attachActionRuntime(action, {\n    feature: operation.entityName,\n    actionName: operation.name,\n    requiresAuth: options.requiresAuth,\n    queryKeyPrefix: [operation.entityName, operation.name] as const,\n    getQueryKey: input => resolveOperationBridgeQueryKey(operation, input as TInput),\n    getAffectedQueryKeys: ({ input }) =>\n      resolveOperationBridgeInvalidationQueryKeys(operation, input as TInput),\n  });\n"]}

package/dist/graph/canonical-request-invalidation.d.ts

@@ -0,0 +1,14 @@
+import type { ModelCommandCanonicalRequest } from '@ontahi/core/runtime/protocol';
+import { type QueryClient, type QueryKey } from '@tanstack/react-query';
+import { type BridgedOperationLike } from '../actions/index.js';
+export type CanonicalRequestInvalidation = {
+    readonly kind: 'read' | 'graph-command' | 'operation';
+    readonly queryKeys: readonly QueryKey[];
+};
+export declare const invalidateCanonicalRequest: (queryClient: QueryClient, request: ModelCommandCanonicalRequest, operations: ReadonlyMap<string, BridgedOperationLike<any, any>>) => Promise<CanonicalRequestInvalidation>;
+/**
+ * @deprecated Compatibility fallback for receivers without committed mutation metadata. Prefer
+ * semantic mutation hooks or `invalidateSemanticGraphReads` with Runtime Protocol metadata.
+ */
+export declare const useCanonicalRequestInvalidation: (operations: readonly BridgedOperationLike<any, any>[]) => (request: ModelCommandCanonicalRequest) => Promise<CanonicalRequestInvalidation>;
+//# sourceMappingURL=canonical-request-invalidation.d.ts.map

package/dist/graph/canonical-request-invalidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-request-invalidation.d.ts","sourceRoot":"","sources":["../../src/graph/canonical-request-invalidation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAClF,OAAO,EAAkB,KAAK,WAAW,EAAE,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGxF,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,MAAM,4BAA4B,GAAG;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,WAAW,CAAC;IACtD,QAAQ,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAC;CACzC,CAAC;AAYF,eAAO,MAAM,0BAA0B,GACrC,aAAa,WAAW,EACxB,SAAS,4BAA4B,EACrC,YAAY,WAAW,CAAC,MAAM,EAAE,oBAAoB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,KAC9D,OAAO,CAAC,4BAA4B,CAmBtC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,+BAA+B,GAC1C,YAAY,SAAS,oBAAoB,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,eASzC,4BAA4B,0CAIzC,CAAC"}

package/dist/graph/canonical-request-invalidation.js

@@ -0,0 +1,42 @@
+'use client';
+import { normalizeGraphSchemaClientInput } from '@ontahi/core/data-graph';
+import { useQueryClient } from '@tanstack/react-query';
+import { useCallback, useMemo } from 'react';
+import { resolveOperationBridgeInvalidationQueryKeys, } from '../actions/index.js';
+const graphCommandEntityNames = (request) => {
+    const command = request.command;
+    if (command.kind === 'entity-mutation-command')
+        return [command.entityName];
+    return [...new Set([command.relation.sourceEntityName, command.relation.targetEntityName])];
+};
+const invalidateQueryKeys = async (queryClient, queryKeys) => {
+    await Promise.all(queryKeys.map(queryKey => queryClient.invalidateQueries({ queryKey })));
+};
+export const invalidateCanonicalRequest = async (queryClient, request, operations) => {
+    if (request.kind === 'graph-read')
+        return { kind: 'read', queryKeys: [] };
+    if (request.kind === 'graph-command') {
+        const queryKeys = graphCommandEntityNames(request).map(entityName => [entityName]);
+        await invalidateQueryKeys(queryClient, queryKeys);
+        return { kind: 'graph-command', queryKeys };
+    }
+    const operation = operations.get(request.operationId);
+    if (!operation)
+        throw new Error(`No client Operation is registered for "${request.operationId}".`);
+    const input = operation.input
+        ? normalizeGraphSchemaClientInput(operation.input, request.input)
+        : request.input;
+    const queryKeys = resolveOperationBridgeInvalidationQueryKeys(operation, input);
+    await invalidateQueryKeys(queryClient, queryKeys);
+    return { kind: 'operation', queryKeys };
+};
+/**
+ * @deprecated Compatibility fallback for receivers without committed mutation metadata. Prefer
+ * semantic mutation hooks or `invalidateSemanticGraphReads` with Runtime Protocol metadata.
+ */
+export const useCanonicalRequestInvalidation = (operations) => {
+    const queryClient = useQueryClient();
+    const operationMap = useMemo(() => new Map(operations.map(operation => [operation.id, operation])), [operations]);
+    return useCallback((request) => invalidateCanonicalRequest(queryClient, request, operationMap), [operationMap, queryClient]);
+};
+//# sourceMappingURL=canonical-request-invalidation.js.map

package/dist/graph/canonical-request-invalidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-request-invalidation.js","sourceRoot":"","sources":["../../src/graph/canonical-request-invalidation.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,+BAA+B,EAA4B,MAAM,yBAAyB,CAAC;AAEpG,OAAO,EAAE,cAAc,EAAmC,MAAM,uBAAuB,CAAC;AACxF,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAE7C,OAAO,EACL,2CAA2C,GAE5C,MAAM,qBAAqB,CAAC;AAO7B,MAAM,uBAAuB,GAAG,CAAC,OAA4B,EAAqB,EAAE;IAClF,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAChC,IAAI,OAAO,CAAC,IAAI,KAAK,yBAAyB;QAAE,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5E,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;AAC9F,CAAC,CAAC;AAEF,MAAM,mBAAmB,GAAG,KAAK,EAAE,WAAwB,EAAE,SAA8B,EAAE,EAAE;IAC7F,MAAM,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;AAC5F,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAG,KAAK,EAC7C,WAAwB,EACxB,OAAqC,EACrC,UAA+D,EACxB,EAAE;IACzC,IAAI,OAAO,CAAC,IAAI,KAAK,YAAY;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAE1E,IAAI,OAAO,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;QACrC,MAAM,SAAS,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;QACnF,MAAM,mBAAmB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QAClD,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC;IAC9C,CAAC;IAED,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACtD,IAAI,CAAC,SAAS;QACZ,MAAM,IAAI,KAAK,CAAC,0CAA0C,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC;IAErF,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK;QAC3B,CAAC,CAAC,+BAA+B,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC;QACjE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAClB,MAAM,SAAS,GAAG,2CAA2C,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAChF,MAAM,mBAAmB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAClD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;AAC1C,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAC7C,UAAqD,EACrD,EAAE;IACF,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IACrC,MAAM,YAAY,GAAG,OAAO,CAC1B,GAAG,EAAE,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,EACrE,CAAC,UAAU,CAAC,CACb,CAAC;IAEF,OAAO,WAAW,CAChB,CAAC,OAAqC,EAAE,EAAE,CACxC,0BAA0B,CAAC,WAAW,EAAE,OAAO,EAAE,YAAY,CAAC,EAChE,CAAC,YAAY,EAAE,WAAW,CAAC,CAC5B,CAAC;AACJ,CAAC,CAAC","sourcesContent":["'use client';\n\nimport { normalizeGraphSchemaClientInput, type GraphCommandRequest } from '@ontahi/core/data-graph';\nimport type { ModelCommandCanonicalRequest } from '@ontahi/core/runtime/protocol';\nimport { useQueryClient, type QueryClient, type QueryKey } from '@tanstack/react-query';\nimport { useCallback, useMemo } from 'react';\n\nimport {\n  resolveOperationBridgeInvalidationQueryKeys,\n  type BridgedOperationLike,\n} from '../actions/index.js';\n\nexport type CanonicalRequestInvalidation = {\n  readonly kind: 'read' | 'graph-command' | 'operation';\n  readonly queryKeys: readonly QueryKey[];\n};\n\nconst graphCommandEntityNames = (request: GraphCommandRequest): readonly string[] => {\n  const command = request.command;\n  if (command.kind === 'entity-mutation-command') return [command.entityName];\n  return [...new Set([command.relation.sourceEntityName, command.relation.targetEntityName])];\n};\n\nconst invalidateQueryKeys = async (queryClient: QueryClient, queryKeys: readonly QueryKey[]) => {\n  await Promise.all(queryKeys.map(queryKey => queryClient.invalidateQueries({ queryKey })));\n};\n\nexport const invalidateCanonicalRequest = async (\n  queryClient: QueryClient,\n  request: ModelCommandCanonicalRequest,\n  operations: ReadonlyMap<string, BridgedOperationLike<any, any>>,\n): Promise<CanonicalRequestInvalidation> => {\n  if (request.kind === 'graph-read') return { kind: 'read', queryKeys: [] };\n\n  if (request.kind === 'graph-command') {\n    const queryKeys = graphCommandEntityNames(request).map(entityName => [entityName]);\n    await invalidateQueryKeys(queryClient, queryKeys);\n    return { kind: 'graph-command', queryKeys };\n  }\n\n  const operation = operations.get(request.operationId);\n  if (!operation)\n    throw new Error(`No client Operation is registered for \"${request.operationId}\".`);\n\n  const input = operation.input\n    ? normalizeGraphSchemaClientInput(operation.input, request.input)\n    : request.input;\n  const queryKeys = resolveOperationBridgeInvalidationQueryKeys(operation, input);\n  await invalidateQueryKeys(queryClient, queryKeys);\n  return { kind: 'operation', queryKeys };\n};\n\n/**\n * @deprecated Compatibility fallback for receivers without committed mutation metadata. Prefer\n * semantic mutation hooks or `invalidateSemanticGraphReads` with Runtime Protocol metadata.\n */\nexport const useCanonicalRequestInvalidation = (\n  operations: readonly BridgedOperationLike<any, any>[],\n) => {\n  const queryClient = useQueryClient();\n  const operationMap = useMemo(\n    () => new Map(operations.map(operation => [operation.id, operation])),\n    [operations],\n  );\n\n  return useCallback(\n    (request: ModelCommandCanonicalRequest) =>\n      invalidateCanonicalRequest(queryClient, request, operationMap),\n    [operationMap, queryClient],\n  );\n};\n"]}

package/dist/graph/context.d.ts

@@ -1,11 +1,17 @@
-import { type GraphClientCache, type OperationExecutionAffordance, type ReflectedEntityDataReader, type ReflectedRelatedEntityDataReader, type ReflectedOperationDescriptor, type ReflectedOperationInvoker } from '@ontahi/core/data-graph';
+import { type ClientApplication, type GraphClientCache, type OperationExecutionAffordance, type ReflectedEntityDataReader, type ReflectedRelatedEntityDataReader, type ReflectedOperationDescriptor, type ReflectedOperationInvoker } from '@ontahi/core/data-graph';
 import { type ExecutionIdentity } from '@ontahi/core/runtime/identity';
-import type { RuntimeTransport } from '@ontahi/core/runtime/protocol';
+import { type RuntimeTransport } from '@ontahi/core/runtime/protocol';
 import { type ReactNode } from 'react';
 import type { AnyOperationBridgeAdapter } from '../actions/index.js';
 import type { ReactGraphExecutor } from './executor.js';
 import { type OntahiGraphClient } from './fetch-graph-client.js';
 import { type ReflectedGraphOperationLike } from './reflected-operation-invoker.js';
+export type OntahiClientContextValue = {
+    readonly application?: ClientApplication;
+    readonly clientCache: GraphClientCache;
+    readonly identity: ExecutionIdentity;
+    readonly runtimeTransport?: RuntimeTransport;
+};
 export type OntahiGraphProviderProps<TGraphRuntime = unknown, TReadOptions = unknown, TCommandOptions = TReadOptions> = {
     children: ReactNode;
     runtime: TGraphRuntime;
@@ -21,6 +27,7 @@ export type OntahiGraphProviderProps<TGraphRuntime = unknown, TReadOptions = unk
     identity?: ExecutionIdentity;
 };
 export declare function OntahiGraphProvider<TGraphRuntime = unknown, TReadOptions = unknown, TCommandOptions = TReadOptions>({ children, runtime, graphExecutor, runtimeTransport, client, operationBridgeAdapters, reflectedEntityDataReader, reflectedRelatedEntityDataReader, reflectedOperationInvoker, reflectedGraphOperations, clientCache, identity, }: OntahiGraphProviderProps<TGraphRuntime, TReadOptions, TCommandOptions>): import("react/jsx-runtime").JSX.Element;
+export declare const useOntahiClientContext: () => OntahiClientContextValue | undefined;
 export declare const useExecutionIdentity: () => ExecutionIdentity;
 export declare function useGraphRuntime<TGraphRuntime = unknown>(): TGraphRuntime;
 export declare function useGraphExecutor<TReadOptions = unknown, TCommandOptions = TReadOptions>(): ReactGraphExecutor<TReadOptions, TCommandOptions>;

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

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/graph/context.tsx"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,4BAA4B,EACjC,KAAK,yBAAyB,EAC9B,KAAK,gCAAgC,EACrC,KAAK,4BAA4B,EACjC,KAAK,yBAAyB,EAC/B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAA8B,KAAK,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACnG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAErE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAA0B,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACzF,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,kCAAkC,CAAC;AAiB1C,MAAM,MAAM,wBAAwB,CAClC,aAAa,GAAG,OAAO,EACvB,YAAY,GAAG,OAAO,EACtB,eAAe,GAAG,YAAY,IAC5B;IACF,QAAQ,EAAE,SAAS,CAAC;IACpB,OAAO,EAAE,aAAa,CAAC;IACvB,aAAa,CAAC,EAAE,kBAAkB,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;IAClE,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,MAAM,CAAC,EAAE,iBAAiB,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,KAAK,CAAC;IAClE,uBAAuB,CAAC,EAAE,yBAAyB,EAAE,CAAC;IACtD,yBAAyB,CAAC,EAAE,yBAAyB,CAAC;IACtD,gCAAgC,CAAC,EAAE,gCAAgC,CAAC;IACpE,yBAAyB,CAAC,EAAE,yBAAyB,CAAC;IACtD,wBAAwB,CAAC,EAAE,SAAS,2BAA2B,EAAE,CAAC;IAClE,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B,CAAC;AAEF,wBAAgB,mBAAmB,CACjC,aAAa,GAAG,OAAO,EACvB,YAAY,GAAG,OAAO,EACtB,eAAe,GAAG,YAAY,EAC9B,EACA,QAAQ,EACR,OAAO,EACP,aAAa,EACb,gBAAgB,EAChB,MAAM,EACN,uBAAuB,EACvB,yBAAyB,EACzB,gCAAgC,EAChC,yBAAyB,EACzB,wBAAqD,EACrD,WAAW,EACX,QAAqC,GACtC,EAAE,wBAAwB,CAAC,aAAa,EAAE,YAAY,EAAE,eAAe,CAAC,2CAwDxE;AAED,eAAO,MAAM,oBAAoB,yBAA6C,CAAC;AAE/E,wBAAgB,eAAe,CAAC,aAAa,GAAG,OAAO,KAOnC,aAAa,CAChC;AAED,wBAAgB,gBAAgB,CAAC,YAAY,GAAG,OAAO,EAAE,eAAe,GAAG,YAAY,KAS7D,kBAAkB,CAAC,YAAY,EAAE,eAAe,CAAC,CAC1E;AAED,wBAAgB,0BAA0B,CACxC,YAAY,GAAG,OAAO,EACtB,eAAe,GAAG,YAAY,KAG1B,kBAAkB,CAAC,YAAY,EAAE,eAAe,CAAC,GACjD,SAAS,CACd;AAED,eAAO,MAAM,6BAA6B,oCAAyD,CAAC;AAEpG,wBAAgB,mBAAmB,qBAMlC;AAED,wBAAgB,mBAAmB;;;;;;;;;;;;;kJApFJ,CAAC;EA4F/B;AAED,wBAAgB,2BAA2B,+DAM1C;AAED,eAAO,MAAM,0BAA0B,GAAI,aAAa,gBAAgB,WAKrE,CAAC;AAEJ,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,6BAc5D;AAED,wBAAgB,gCAAgC,8BAc/C;AAED,wBAAgB,4BAA4B,YAG3C;AAED,wBAAgB,4BAA4B,8BAU3C;AAED,wBAAgB,+BAA+B,YAE9C;AAED,wBAAgB,mCAAmC,qCAUlD;AAED,eAAO,MAAM,sCAAsC,eACW,CAAC;AAE/D,wBAAgB,4BAA4B,8BAU3C;AAED,wBAAgB,+BAA+B,YAE9C;AAED,wBAAgB,4BAA4B,gBAI5B,4BAA4B,aAI3C;AAED,wBAAgB,wCAAwC,CACtD,SAAS,EAAE,4BAA4B,GACtC,4BAA4B,GAAG,SAAS,CAI1C;AAED,YAAY,EAAE,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/graph/context.tsx"],"names":[],"mappings":"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"}

package/dist/graph/context.js

@@ -2,9 +2,12 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { createGraphClientCache, } from '@ontahi/core/data-graph';
 import { anonymousExecutionIdentity } from '@ontahi/core/runtime/identity';
-import { createContext, useCallback, useContext, useMemo, useState, useSyncExternalStore, } from 'react';
+import { subscribeRuntimeProtocolExecutions, } from '@ontahi/core/runtime/protocol';
+import { QueryClientContext } from '@tanstack/react-query';
+import { createContext, useCallback, useContext, useEffect, useMemo, useState, useSyncExternalStore, } from 'react';
 import { createFetchGraphClient } from './fetch-graph-client.js';
 import { createReflectedOperationInvoker, } from './reflected-operation-invoker.js';
+import { invalidateSemanticGraphReads } from './semantic-invalidation.js';
 const noReflectedGraphOperations = [];
 const GraphRuntimeContext = createContext(null);
 const ExecutionIdentityContext = createContext(anonymousExecutionIdentity);
@@ -15,6 +18,7 @@ const OperationBridgeAdaptersContext = createContext(null);
 const ReflectedEntityDataReaderContext = createContext(null);
 const ReflectedRelatedEntityDataReaderContext = createContext(null);
 const ReflectedOperationInvokerContext = createContext(null);
+const OntahiClientContext = createContext(undefined);
 export function OntahiGraphProvider({ children, runtime, graphExecutor, runtimeTransport, client, operationBridgeAdapters, reflectedEntityDataReader, reflectedRelatedEntityDataReader, reflectedOperationInvoker, reflectedGraphOperations = noReflectedGraphOperations, clientCache, identity = anonymousExecutionIdentity, }) {
     const [defaultGraphClient] = useState(() => createFetchGraphClient());
     const [defaultClientCache] = useState(() => createGraphClientCache());
@@ -26,6 +30,13 @@ export function OntahiGraphProvider({ children, runtime, graphExecutor, runtimeT
     const resolvedReflectedRelatedEntityDataReader = reflectedRelatedEntityDataReader ?? graphClient?.reflectedRelatedEntityDataReader;
     const configuredReflectedOperationInvoker = reflectedOperationInvoker ?? graphClient?.reflectedOperationInvoker;
     const graphClientCache = clientCache ?? graphClient?.clientCache ?? defaultClientCache;
+    const clientContext = useMemo(() => ({
+        ...(graphClient?.application ? { application: graphClient.application } : {}),
+        clientCache: graphClientCache,
+        identity,
+        ...(resolvedRuntimeTransport ? { runtimeTransport: resolvedRuntimeTransport } : {}),
+    }), [graphClient?.application, graphClientCache, identity, resolvedRuntimeTransport]);
+    const queryClient = useContext(QueryClientContext);
     const bridgeAdapterMap = useMemo(() => new Map(resolvedOperationBridgeAdapters.map(adapter => [adapter.name, adapter])), [resolvedOperationBridgeAdapters]);
     const resolvedReflectedOperationInvoker = useMemo(() => reflectedGraphOperations.length > 0
         ? createReflectedOperationInvoker({
@@ -34,8 +45,32 @@ export function OntahiGraphProvider({ children, runtime, graphExecutor, runtimeT
             graphOperations: reflectedGraphOperations,
         })
         : (configuredReflectedOperationInvoker ?? null), [configuredReflectedOperationInvoker, reflectedGraphOperations, resolvedGraphExecutor]);
-    return (_jsx(ExecutionIdentityContext.Provider, { value: identity, children: _jsx(ReflectedOperationInvokerContext.Provider, { value: resolvedReflectedOperationInvoker, children: _jsx(ReflectedRelatedEntityDataReaderContext.Provider, { value: resolvedReflectedRelatedEntityDataReader ?? null, children: _jsx(ReflectedEntityDataReaderContext.Provider, { value: resolvedReflectedEntityDataReader ?? null, children: _jsx(OperationBridgeAdaptersContext.Provider, { value: bridgeAdapterMap, children: _jsx(RuntimeTransportContext.Provider, { value: resolvedRuntimeTransport ?? null, children: _jsx(GraphClientCacheContext.Provider, { value: graphClientCache, children: _jsx(GraphExecutorContext.Provider, { value: resolvedGraphExecutor ?? null, children: _jsx(GraphRuntimeContext.Provider, { value: runtime, children: children }) }) }) }) }) }) }) }) }));
-}
+    useEffect(() => {
+        if (!resolvedRuntimeTransport || !queryClient)
+            return;
+        return subscribeRuntimeProtocolExecutions(resolvedRuntimeTransport, async ({ metadata }) => {
+            await invalidateSemanticGraphReads(queryClient, metadata.committedMutations, {
+                ...(metadata.mutationCommitId
+                    ? {
+                        causedBy: {
+                            kind: 'committed-mutations',
+                            commitIds: [metadata.mutationCommitId],
+                            overflow: false,
+                        },
+                    }
+                    : {}),
+                ...(resolvedRuntimeTransport.causality
+                    ? {
+                        associateRefreshes: resolvedRuntimeTransport.causality.associateGraphReadRefreshes,
+                    }
+                    : {}),
+            });
+            return true;
+        });
+    }, [queryClient, resolvedRuntimeTransport]);
+    return (_jsx(OntahiClientContext.Provider, { value: clientContext, children: _jsx(ExecutionIdentityContext.Provider, { value: identity, children: _jsx(ReflectedOperationInvokerContext.Provider, { value: resolvedReflectedOperationInvoker, children: _jsx(ReflectedRelatedEntityDataReaderContext.Provider, { value: resolvedReflectedRelatedEntityDataReader ?? null, children: _jsx(ReflectedEntityDataReaderContext.Provider, { value: resolvedReflectedEntityDataReader ?? null, children: _jsx(OperationBridgeAdaptersContext.Provider, { value: bridgeAdapterMap, children: _jsx(RuntimeTransportContext.Provider, { value: resolvedRuntimeTransport ?? null, children: _jsx(GraphClientCacheContext.Provider, { value: graphClientCache, children: _jsx(GraphExecutorContext.Provider, { value: resolvedGraphExecutor ?? null, children: _jsx(GraphRuntimeContext.Provider, { value: runtime, children: children }) }) }) }) }) }) }) }) }) }));
+}
+export const useOntahiClientContext = () => useContext(OntahiClientContext);
 export const useExecutionIdentity = () => useContext(ExecutionIdentityContext);
 export function useGraphRuntime() {
     const runtime = useContext(GraphRuntimeContext);