@ontahi/react 0.1.0-alpha.4 → 0.1.0-alpha.6

package/README.md

@@ -5,8 +5,98 @@ Non-visual React integration for Ontahi applications.
 This package depends on `@ontahi/core`. It owns React hooks and bridge adapters that are generic to React clients:
 
 1. `@ontahi/react/actions`: action execution hooks, React Query integration, and operation bridge adapters.
-2. `@ontahi/react/graph`: graph runtime provider, client cache hooks, and operation bridge adapter lookup hooks.
+2. `@ontahi/react/graph`: graph runtime provider, Query and Command hooks, Fetch graph-read execution,
+   client cache hooks, and operation bridge adapter lookup hooks.
 
 The generic action metadata and result protocol comes from `@ontahi/core/runtime/actions`; Next.js-specific transport remains in `@ontahi/runtime-nextjs`.
 
-BookOps-specific graph declarations, domain entities, runtime assembly, and application policy stay in the host application. Reusable reflective UI lives in `@ontahi/explorer-react`; BookOps contributes only host routes, access control, theme/auth composition, and app-specific UI enrichments.
+Application-specific graph declarations, domain entities, runtime assembly, and policy stay in the
+host application. Reusable reflective UI lives in `@ontahi/explorer-react`; hosts contribute their
+own routes, access control, theme/auth composition, and application-specific UI enrichments.
+
+Start with the end-to-end [Application Data Access](../../docs/application-data-access.md) guide for
+the recommended server, codegen, and React composition. This README is the package-level reference.
+
+Projectable Operations keep population on the server and shape in the caller:
+
+```ts
+const TripList = Trip.view('TripList', { id: true, driver: { name: true } });
+const operation = Trip.domain.available.as(TripList);
+const result = useOperationQuery(operation, input);
+```
+
+React cache identity includes the transported View AST. The View remains client-owned and does not
+need a server registry entry.
+
+Caller-authored Queries can use the remote graph-read protocol directly:
+
+```tsx
+const TodoListItem = TodoItem.view('TodoListItem', { id: true, title: true });
+const openTodos = TodoItem.all()
+  .where(todo => todo.completed.eq(false))
+  .as(TodoListItem);
+
+<OntahiGraphProvider
+  runtime={{ name: 'browser' }}
+  identity={{ principal: session.principal ?? null, cacheScope: session.workspaceId }}
+>
+  <TodoApp />
+</OntahiGraphProvider>;
+
+const todos = useGraphQuery(openTodos);
+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 and task snapshots to `/operations`, and reflected
+Explorer data to `/explorer/entities`. These capabilities are lazy: declaring the provider does
+not issue a request until the application uses one of them.
+
+Hosts can replace any individual capability through the existing provider props, install a
+configured client with `client={createFetchGraphClient(...)}`, or set `client={false}` for a fully
+explicit provider. Server routes, read policies, and authorization remain opt-in and authoritative;
+the default removes client wiring, not the server security boundary.
+
+The same client supports fluent execution outside React hooks:
+
+```ts
+const client = createFetchGraphClient();
+const Todo = client.graph.bindClientEntity(GeneratedTodo);
+
+const rows = await runBrowserEffect(Todo.all().as(TodoListItem).run());
+```
+
+The bound facade is a new value and retains the generated Entity's Views, Refs, and Domain
+Operations. Its portable source facade and schema remain unchanged.
+
+Generated client Entities expose portable `all()` and `where(...)` Query entry points. A Query
+returns many rows by default; terminal `first()`, `one()`, `count()`, and `exists()` expressions
+make the result contract explicit and let `useGraphQuery` select the executor method. `one()` is
+strict cardinality, while `first()` may return `null`.
+
+For transport-safe Queries, React derives a canonical key from the Entity, Selection, View,
+ordering, limit, cardinality, and read intent. The key is also partitioned by the provider's
+`ExecutionIdentity`. `principal` and optional JSON-safe `cacheScope` describe distributed client
+state; they are not credentials and are never trusted for server authorization. The authoritative
+runtime still derives its Principal from the request. Hosts should change identity when login,
+logout, service identity, tenant, or workspace changes. An explicit `queryKey` remains available
+for lower-level reads that cannot be encoded by the graph-read protocol, and the legacy explicit
+`mode` API remains compatible.
+
+First-class Operation invocations bind render-owned input without losing the declaration form:
+
+```ts
+const createTodo = useOperation(TodoItem.domain.create);
+const completeVisible = useOperation(TodoItem.domain.complete({ todos: visibleTodos }));
+
+await createTodo.executeAsync(newTodo);
+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.
+
+The Fetch executor sends only the canonical graph-read request. Credentials and other trusted
+request state remain in Fetch initialization and are never embedded in the Query AST. Remote
+Commands remain unsupported until the graph Command protocol and its policy boundary are defined.

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;AAEjC,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EACV,yBAAyB,EACzB,eAAe,EACf,YAAY,EACb,MAAM,gCAAgC,CAAC;AACxC,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;AAKD,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,CAAC,EAAE,CAAC,OAAO,GAAG,OAAO,EAAE,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9F,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,cAWF,CAAC;AAEF,eAAO,MAAM,2CAA2C,GAAI,MAAM,EAAE,KAAK,EACvE,WAAW,oBAAoB,CAAC,MAAM,EAAE,KAAK,CAAC,EAC9C,OAAO,MAAM,KACZ,cAAc,EAUhB,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

@@ -1,6 +1,7 @@
 'use client';
 import { normalizeEntityRefQueryInput } from '@ontahi/core/data-graph';
 import { attachActionRuntime, getActionErrorMessage, hasActionError, } from '@ontahi/core/runtime/actions';
+import { isRecord } from '@ontahi/core/value/object';
 export class OperationInvocationResultError extends Error {
     constructor(result) {
         super(result.message);
@@ -22,7 +23,6 @@ export class OperationInvocationResultError extends Error {
         };
     }
 }
-const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
 export const isOperationInvocationResult = (value) => isRecord(value) && typeof value.ok === 'boolean' && typeof value.kind === 'string';
 export const operationBridgeErrored = (message) => ({
     ok: false,

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

@@ -1 +1 @@
-{"version":3,"file":"operation-bridge.js","sourceRoot":"","sources":["../../src/actions/operation-bridge.ts"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport type {\n  ClientDomainOperationDeclaration,\n  EntityViewAst,\n  QueryKeySegment,\n} from '@ontahi/core/data-graph';\nimport { normalizeEntityRefQueryInput } from '@ontahi/core/data-graph';\nimport {\n  attachActionRuntime,\n  getActionErrorMessage,\n  hasActionError,\n  type ActionQueryKey,\n} from '@ontahi/core/runtime/actions';\nimport type {\n  OperationInvocationResult,\n  TaskRunIdentity,\n  TaskSnapshot,\n} from '@ontahi/core/runtime/contracts';\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\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\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  getTaskSnapshot?: <TResult = unknown>(ref: TaskRunIdentity) => Promise<TaskSnapshot<TResult>>;\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  const queryInput = normalizeEntityRefQueryInput(input, operation.inputRefs);\n\n  return [\n    operation.entityName,\n    operation.name,\n    ...(operation.view ? [operation.view] : []),\n    ...(operation.bridge?.query?.map(segment =>\n      resolveOperationBridgeQueryKeySegment(segment, operation, queryInput),\n    ) ?? []),\n  ];\n};\n\nexport const resolveOperationBridgeInvalidationQueryKeys = <TInput, TData>(\n  operation: BridgedOperationLike<TInput, TData>,\n  input: TInput,\n): ActionQueryKey[] => {\n  const queryInput = normalizeEntityRefQueryInput(input, operation.inputRefs);\n\n  return (\n    operation.bridge?.invalidate?.map(querySpec =>\n      querySpec.map(segment =>\n        resolveOperationBridgeQueryKeySegment(segment, operation, queryInput),\n      ),\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":"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","sourcesContent":["'use client';\n\nimport type {\n  ClientDomainOperationDeclaration,\n  EntityViewAst,\n  QueryKeySegment,\n} from '@ontahi/core/data-graph';\nimport { normalizeEntityRefQueryInput } from '@ontahi/core/data-graph';\nimport {\n  attachActionRuntime,\n  getActionErrorMessage,\n  hasActionError,\n  type ActionQueryKey,\n} from '@ontahi/core/runtime/actions';\nimport type {\n  OperationInvocationResult,\n  TaskRunIdentity,\n  TaskSnapshot,\n} 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  getTaskSnapshot?: <TResult = unknown>(ref: TaskRunIdentity) => Promise<TaskSnapshot<TResult>>;\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  const queryInput = normalizeEntityRefQueryInput(input, operation.inputRefs);\n\n  return [\n    operation.entityName,\n    operation.name,\n    ...(operation.view ? [operation.view] : []),\n    ...(operation.bridge?.query?.map(segment =>\n      resolveOperationBridgeQueryKeySegment(segment, operation, queryInput),\n    ) ?? []),\n  ];\n};\n\nexport const resolveOperationBridgeInvalidationQueryKeys = <TInput, TData>(\n  operation: BridgedOperationLike<TInput, TData>,\n  input: TInput,\n): ActionQueryKey[] => {\n  const queryInput = normalizeEntityRefQueryInput(input, operation.inputRefs);\n\n  return (\n    operation.bridge?.invalidate?.map(querySpec =>\n      querySpec.map(segment =>\n        resolveOperationBridgeQueryKeySegment(segment, operation, queryInput),\n      ),\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/context.d.ts

@@ -1,19 +1,24 @@
 import { type GraphClientCache, type ReflectedEntityDataReader, type ReflectedOperationDescriptor, type ReflectedOperationInvoker } from '@ontahi/core/data-graph';
+import { type ExecutionIdentity } from '@ontahi/core/runtime/identity';
 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 OntahiGraphProviderProps<TGraphRuntime = unknown, TReadOptions = unknown, TCommandOptions = TReadOptions> = {
     children: ReactNode;
     runtime: TGraphRuntime;
     graphExecutor?: ReactGraphExecutor<TReadOptions, TCommandOptions>;
+    client?: OntahiGraphClient<TReadOptions, TCommandOptions> | false;
     operationBridgeAdapters?: AnyOperationBridgeAdapter[];
     reflectedEntityDataReader?: ReflectedEntityDataReader;
     reflectedOperationInvoker?: ReflectedOperationInvoker;
     reflectedGraphOperations?: readonly ReflectedGraphOperationLike[];
     clientCache?: GraphClientCache;
+    identity?: ExecutionIdentity;
 };
-export declare function OntahiGraphProvider<TGraphRuntime = unknown, TReadOptions = unknown, TCommandOptions = TReadOptions>({ children, runtime, graphExecutor, operationBridgeAdapters, reflectedEntityDataReader, reflectedOperationInvoker, reflectedGraphOperations, clientCache, }: OntahiGraphProviderProps<TGraphRuntime, TReadOptions, TCommandOptions>): import("react/jsx-runtime").JSX.Element;
+export declare function OntahiGraphProvider<TGraphRuntime = unknown, TReadOptions = unknown, TCommandOptions = TReadOptions>({ children, runtime, graphExecutor, client, operationBridgeAdapters, reflectedEntityDataReader, reflectedOperationInvoker, reflectedGraphOperations, clientCache, identity, }: OntahiGraphProviderProps<TGraphRuntime, TReadOptions, TCommandOptions>): import("react/jsx-runtime").JSX.Element;
+export declare const useExecutionIdentity: () => ExecutionIdentity;
 export declare function useGraphRuntime<TGraphRuntime = unknown>(): TGraphRuntime;
 export declare function useGraphExecutor<TReadOptions = unknown, TCommandOptions = TReadOptions>(): ReactGraphExecutor<TReadOptions, TCommandOptions>;
 export declare function useGraphClientCache(): {

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,yBAAyB,EAC9B,KAAK,4BAA4B,EACjC,KAAK,yBAAyB,EAC/B,MAAM,yBAAyB,CAAC;AACjC,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,EAEL,KAAK,2BAA2B,EACjC,MAAM,kCAAkC,CAAC;AAa1C,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,uBAAuB,CAAC,EAAE,yBAAyB,EAAE,CAAC;IACtD,yBAAyB,CAAC,EAAE,yBAAyB,CAAC;IACtD,yBAAyB,CAAC,EAAE,yBAAyB,CAAC;IACtD,wBAAwB,CAAC,EAAE,SAAS,2BAA2B,EAAE,CAAC;IAClE,WAAW,CAAC,EAAE,gBAAgB,CAAC;CAChC,CAAC;AAEF,wBAAgB,mBAAmB,CACjC,aAAa,GAAG,OAAO,EACvB,YAAY,GAAG,OAAO,EACtB,eAAe,GAAG,YAAY,EAC9B,EACA,QAAQ,EACR,OAAO,EACP,aAAa,EACb,uBAA4B,EAC5B,yBAAyB,EACzB,yBAAyB,EACzB,wBAAqD,EACrD,WAAW,GACZ,EAAE,wBAAwB,CAAC,aAAa,EAAE,YAAY,EAAE,eAAe,CAAC,2CAkCxE;AAED,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,mBAAmB;;;;;;;;;;;;;;EAQlC;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,4BAA4B,8BAU3C;AAED,wBAAgB,+BAA+B,YAE9C;AAED,wBAAgB,4BAA4B,gBAI5B,4BAA4B,aAI3C;AAED,YAAY,EAAE,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/graph/context.tsx"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,yBAAyB,EAC9B,KAAK,4BAA4B,EACjC,KAAK,yBAAyB,EAC/B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAA8B,KAAK,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACnG,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;AAc1C,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,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,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,MAAM,EACN,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,wBAAqD,EACrD,WAAW,EACX,QAAqC,GACtC,EAAE,wBAAwB,CAAC,aAAa,EAAE,YAAY,EAAE,eAAe,CAAC,2CA+CxE;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,mBAAmB;;;;;;;;;;;;;;EAQlC;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,4BAA4B,8BAU3C;AAED,wBAAgB,+BAA+B,YAE9C;AAED,wBAAgB,4BAA4B,gBAI5B,4BAA4B,aAI3C;AAED,YAAY,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/graph/context.js

@@ -1,28 +1,38 @@
 'use client';
 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 { createFetchGraphClient } from './fetch-graph-client.js';
 import { createReflectedOperationInvoker, } from './reflected-operation-invoker.js';
 const noReflectedGraphOperations = [];
 const GraphRuntimeContext = createContext(null);
+const ExecutionIdentityContext = createContext(anonymousExecutionIdentity);
 const GraphExecutorContext = createContext(null);
 const GraphClientCacheContext = createContext(null);
 const OperationBridgeAdaptersContext = createContext(null);
 const ReflectedEntityDataReaderContext = createContext(null);
 const ReflectedOperationInvokerContext = createContext(null);
-export function OntahiGraphProvider({ children, runtime, graphExecutor, operationBridgeAdapters = [], reflectedEntityDataReader, reflectedOperationInvoker, reflectedGraphOperations = noReflectedGraphOperations, clientCache, }) {
+export function OntahiGraphProvider({ children, runtime, graphExecutor, client, operationBridgeAdapters, reflectedEntityDataReader, reflectedOperationInvoker, reflectedGraphOperations = noReflectedGraphOperations, clientCache, identity = anonymousExecutionIdentity, }) {
+    const [defaultGraphClient] = useState(() => createFetchGraphClient());
     const [defaultClientCache] = useState(() => createGraphClientCache());
+    const graphClient = client === false ? undefined : (client ?? defaultGraphClient);
+    const resolvedGraphExecutor = graphExecutor ?? graphClient?.graphExecutor;
+    const resolvedOperationBridgeAdapters = operationBridgeAdapters ?? graphClient?.operationBridgeAdapters ?? [];
+    const resolvedReflectedEntityDataReader = reflectedEntityDataReader ?? graphClient?.reflectedEntityDataReader;
+    const configuredReflectedOperationInvoker = reflectedOperationInvoker ?? graphClient?.reflectedOperationInvoker;
     const graphClientCache = clientCache ?? defaultClientCache;
-    const bridgeAdapterMap = useMemo(() => new Map(operationBridgeAdapters.map(adapter => [adapter.name, adapter])), [operationBridgeAdapters]);
+    const bridgeAdapterMap = useMemo(() => new Map(resolvedOperationBridgeAdapters.map(adapter => [adapter.name, adapter])), [resolvedOperationBridgeAdapters]);
     const resolvedReflectedOperationInvoker = useMemo(() => reflectedGraphOperations.length > 0
         ? createReflectedOperationInvoker({
-            fallback: reflectedOperationInvoker,
-            graphExecutor,
+            fallback: configuredReflectedOperationInvoker,
+            graphExecutor: resolvedGraphExecutor,
             graphOperations: reflectedGraphOperations,
         })
-        : (reflectedOperationInvoker ?? null), [graphExecutor, reflectedGraphOperations, reflectedOperationInvoker]);
-    return (_jsx(ReflectedOperationInvokerContext.Provider, { value: resolvedReflectedOperationInvoker, children: _jsx(ReflectedEntityDataReaderContext.Provider, { value: reflectedEntityDataReader ?? null, children: _jsx(OperationBridgeAdaptersContext.Provider, { value: bridgeAdapterMap, children: _jsx(GraphClientCacheContext.Provider, { value: graphClientCache, children: _jsx(GraphExecutorContext.Provider, { value: graphExecutor ?? null, children: _jsx(GraphRuntimeContext.Provider, { value: runtime, children: children }) }) }) }) }) }));
+        : (configuredReflectedOperationInvoker ?? null), [configuredReflectedOperationInvoker, reflectedGraphOperations, resolvedGraphExecutor]);
+    return (_jsx(ExecutionIdentityContext.Provider, { value: identity, children: _jsx(ReflectedOperationInvokerContext.Provider, { value: resolvedReflectedOperationInvoker, children: _jsx(ReflectedEntityDataReaderContext.Provider, { value: resolvedReflectedEntityDataReader ?? null, children: _jsx(OperationBridgeAdaptersContext.Provider, { value: bridgeAdapterMap, children: _jsx(GraphClientCacheContext.Provider, { value: graphClientCache, children: _jsx(GraphExecutorContext.Provider, { value: resolvedGraphExecutor ?? null, children: _jsx(GraphRuntimeContext.Provider, { value: runtime, children: children }) }) }) }) }) }) }));
 }
+export const useExecutionIdentity = () => useContext(ExecutionIdentityContext);
 export function useGraphRuntime() {
     const runtime = useContext(GraphRuntimeContext);
     if (runtime === null) {

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 ReflectedEntityDataReader,\n  type ReflectedOperationDescriptor,\n  type ReflectedOperationInvoker,\n} from '@ontahi/core/data-graph';\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 {\n  createReflectedOperationInvoker,\n  type ReflectedGraphOperationLike,\n} from './reflected-operation-invoker.js';\n\nconst noReflectedGraphOperations: readonly ReflectedGraphOperationLike[] = [];\n\nconst GraphRuntimeContext = createContext<unknown | null>(null);\nconst GraphExecutorContext = createContext<ReactGraphExecutor<any, any> | null>(null);\nconst GraphClientCacheContext = createContext<GraphClientCache | null>(null);\nconst OperationBridgeAdaptersContext = createContext<Map<string, AnyOperationBridgeAdapter> | null>(\n  null,\n);\nconst ReflectedEntityDataReaderContext = createContext<ReflectedEntityDataReader | 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  operationBridgeAdapters?: AnyOperationBridgeAdapter[];\n  reflectedEntityDataReader?: ReflectedEntityDataReader;\n  reflectedOperationInvoker?: ReflectedOperationInvoker;\n  reflectedGraphOperations?: readonly ReflectedGraphOperationLike[];\n  clientCache?: GraphClientCache;\n};\n\nexport function OntahiGraphProvider<\n  TGraphRuntime = unknown,\n  TReadOptions = unknown,\n  TCommandOptions = TReadOptions,\n>({\n  children,\n  runtime,\n  graphExecutor,\n  operationBridgeAdapters = [],\n  reflectedEntityDataReader,\n  reflectedOperationInvoker,\n  reflectedGraphOperations = noReflectedGraphOperations,\n  clientCache,\n}: OntahiGraphProviderProps<TGraphRuntime, TReadOptions, TCommandOptions>) {\n  const [defaultClientCache] = useState(() => createGraphClientCache());\n  const graphClientCache = clientCache ?? defaultClientCache;\n  const bridgeAdapterMap = useMemo(\n    () => new Map(operationBridgeAdapters.map(adapter => [adapter.name, adapter])),\n    [operationBridgeAdapters],\n  );\n  const resolvedReflectedOperationInvoker = useMemo(\n    () =>\n      reflectedGraphOperations.length > 0\n        ? createReflectedOperationInvoker({\n            fallback: reflectedOperationInvoker,\n            graphExecutor,\n            graphOperations: reflectedGraphOperations,\n          })\n        : (reflectedOperationInvoker ?? null),\n    [graphExecutor, reflectedGraphOperations, reflectedOperationInvoker],\n  );\n\n  return (\n    <ReflectedOperationInvokerContext.Provider value={resolvedReflectedOperationInvoker}>\n      <ReflectedEntityDataReaderContext.Provider value={reflectedEntityDataReader ?? null}>\n        <OperationBridgeAdaptersContext.Provider value={bridgeAdapterMap}>\n          <GraphClientCacheContext.Provider value={graphClientCache}>\n            <GraphExecutorContext.Provider value={graphExecutor ?? null}>\n              <GraphRuntimeContext.Provider value={runtime}>\n                {children}\n              </GraphRuntimeContext.Provider>\n            </GraphExecutorContext.Provider>\n          </GraphClientCacheContext.Provider>\n        </OperationBridgeAdaptersContext.Provider>\n      </ReflectedEntityDataReaderContext.Provider>\n    </ReflectedOperationInvokerContext.Provider>\n  );\n}\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 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 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 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 ReflectedEntityDataReader,\n  type ReflectedOperationDescriptor,\n  type ReflectedOperationInvoker,\n} from '@ontahi/core/data-graph';\nimport { anonymousExecutionIdentity, type ExecutionIdentity } from '@ontahi/core/runtime/identity';\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 OperationBridgeAdaptersContext = createContext<Map<string, AnyOperationBridgeAdapter> | null>(\n  null,\n);\nconst ReflectedEntityDataReaderContext = createContext<ReflectedEntityDataReader | 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  client?: OntahiGraphClient<TReadOptions, TCommandOptions> | false;\n  operationBridgeAdapters?: AnyOperationBridgeAdapter[];\n  reflectedEntityDataReader?: ReflectedEntityDataReader;\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  client,\n  operationBridgeAdapters,\n  reflectedEntityDataReader,\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 resolvedOperationBridgeAdapters =\n    operationBridgeAdapters ?? graphClient?.operationBridgeAdapters ?? [];\n  const resolvedReflectedEntityDataReader =\n    reflectedEntityDataReader ?? graphClient?.reflectedEntityDataReader;\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        <ReflectedEntityDataReaderContext.Provider\n          value={resolvedReflectedEntityDataReader ?? null}\n        >\n          <OperationBridgeAdaptersContext.Provider value={bridgeAdapterMap}>\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          </OperationBridgeAdaptersContext.Provider>\n        </ReflectedEntityDataReaderContext.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 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 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 type { GraphClientCache };\n"]}

package/dist/graph/executor.d.ts

@@ -1,21 +1,25 @@
-import type { GraphCommandSpec, GraphOperationDeclaration, GraphSchemaLike, InferGraphSchemaClientInput, QueryOrView, QuerySpec } from '@ontahi/core/data-graph';
+import type { GraphCommandSpec, GraphOperationDeclaration, GraphReadExpression, GraphReadIntent, GraphSchemaLike, InferGraphSchemaClientInput, QueryOrView, QuerySpec, ManyToManyRelationshipCommand, RelationshipCommand, RelationshipDelta } 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>;
     run<TParams, TResult>(read: QueryOrView<TParams, TResult>, params: TParams, options?: TReadOptions): Promise<TResult[]>;
     count<TParams, TResult>(read: QueryOrView<TParams, TResult>, params: TParams, options?: TReadOptions): Promise<number>;
     runCommand<TResult = void>(command: GraphCommandSpec<any, any, TResult>, options?: TCommandOptions): Promise<TResult>;
+    runRelationshipCommand?(command: RelationshipCommand, options?: TCommandOptions): Promise<RelationshipDelta>;
+    runManyToManyRelationshipCommand?(command: ManyToManyRelationshipCommand, options?: TCommandOptions): Promise<RelationshipDelta>;
 }
 export type BuildableRead<TResult> = {
     build: () => QuerySpec<any, TResult>;
 };
-export type GraphReadSource<TResult = unknown> = QueryOrView<any, TResult> | BuildableRead<TResult>;
-export type ReadParams<TRead> = TRead extends QueryOrView<infer TParams, any> ? TParams : undefined;
-export type ReadResult<TRead> = TRead extends QueryOrView<any, infer TResult> ? TResult : TRead extends BuildableRead<infer TResult> ? TResult : never;
+type PlainGraphReadSource<TResult> = QueryOrView<any, TResult> | BuildableRead<TResult>;
+export type GraphReadSource<TResult = unknown> = PlainGraphReadSource<TResult> | GraphReadExpression<PlainGraphReadSource<TResult>, GraphReadIntent, TResult>;
+export type ReadParams<TRead> = TRead extends GraphReadExpression<infer TSource, any, any> ? ReadParams<TSource> : TRead extends QueryOrView<infer TParams, any> ? TParams : undefined;
+export type ReadResult<TRead> = TRead extends GraphReadExpression<any, any, infer TResult> ? TResult : TRead extends QueryOrView<any, infer TResult> ? TResult : TRead extends BuildableRead<infer TResult> ? TResult : never;
 export type GraphQueryMode = 'get' | 'run' | 'count' | 'exists';
-export type GraphQueryData<TRead, TMode extends GraphQueryMode> = TMode extends 'get' ? ReadResult<TRead> | null : TMode extends 'run' ? ReadResult<TRead>[] : TMode extends 'count' ? number : boolean;
-export type GraphQueryOptions<TRead, TMode extends GraphQueryMode, TReadOptions = unknown> = Omit<UseQueryOptions<GraphQueryData<TRead, TMode>, Error, GraphQueryData<TRead, TMode>, QueryKey>, 'queryKey' | 'queryFn'> & {
-    mode: TMode;
+type GraphReadIntentData<TRead, TIntent extends GraphReadIntent> = TIntent extends 'count' ? number : TIntent extends 'exists' ? boolean : TIntent extends 'one' ? ReadResult<TRead> : ReadResult<TRead> | null;
+export type GraphQueryData<TRead, TMode extends GraphQueryMode = 'run'> = TRead extends GraphReadExpression<any, infer TIntent, any> ? GraphReadIntentData<TRead, TIntent> : TMode extends 'get' ? ReadResult<TRead> | null : TMode extends 'run' ? ReadResult<TRead>[] : TMode extends 'count' ? number : boolean;
+export type GraphQueryOptions<TRead, TMode extends GraphQueryMode = 'run', TReadOptions = unknown> = Omit<UseQueryOptions<GraphQueryData<TRead, TMode>, Error, GraphQueryData<TRead, TMode>, QueryKey>, 'queryKey' | 'queryFn'> & {
+    mode?: TRead extends GraphReadExpression<any, any, any> ? never : TMode;
     params?: ReadParams<TRead>;
     queryKey?: QueryKey;
     runtimeOptions?: TReadOptions;
@@ -38,4 +42,5 @@ export type GraphCommandHookOptions<TResult, TVariables, TContext, TCommandOptio
     runtimeOptions?: TCommandOptions;
     invalidateQueryKeys?: QueryKey[];
 };
+export {};
 //# sourceMappingURL=executor.d.ts.map

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  GraphSchemaLike,\n  InferGraphSchemaClientInput,\n  QueryOrView,\n  QuerySpec,\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}\n\nexport type BuildableRead<TResult> = {\n  build: () => QuerySpec<any, TResult>;\n};\n\nexport type GraphReadSource<TResult = unknown> = QueryOrView<any, TResult> | BuildableRead<TResult>;\n\nexport type ReadParams<TRead> = TRead extends QueryOrView<infer TParams, any> ? TParams : undefined;\n\nexport type ReadResult<TRead> =\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\nexport type GraphQueryData<TRead, TMode extends GraphQueryMode> = 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<TRead, TMode extends GraphQueryMode, TReadOptions = unknown> = Omit<\n  UseQueryOptions<GraphQueryData<TRead, TMode>, Error, GraphQueryData<TRead, TMode>, QueryKey>,\n  'queryKey' | 'queryFn'\n> & {\n  mode: 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  RelationshipCommand,\n  RelationshipDelta,\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<RelationshipDelta>;\n  runManyToManyRelationshipCommand?(\n    command: ManyToManyRelationshipCommand,\n    options?: TCommandOptions,\n  ): Promise<RelationshipDelta>;\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

@@ -0,0 +1,33 @@
+import type { ReflectedEntityDataReader, ReflectedOperationInvoker, RemoteDataGraphError, RuntimeBoundDataGraphApi } from '@ontahi/core/data-graph';
+import { type AnyOperationBridgeAdapter, type FetchOperationBridgeOptions } from '../actions/index.js';
+import type { ReactGraphExecutor } from './executor.js';
+import type { FetchGraphReadExecutorOptions } from './fetch-graph-read-executor.js';
+export type FetchReflectedEntityDataReaderOptions = {
+    endpoint?: string;
+    fetch?: typeof globalThis.fetch;
+};
+export type OntahiGraphClient<TReadOptions = unknown, TCommandOptions = TReadOptions> = {
+    graph?: RuntimeBoundDataGraphApi<RemoteDataGraphError, TReadOptions, TCommandOptions, RemoteDataGraphError>;
+    graphExecutor?: ReactGraphExecutor<TReadOptions, TCommandOptions>;
+    operationBridgeAdapters?: AnyOperationBridgeAdapter[];
+    reflectedEntityDataReader?: ReflectedEntityDataReader;
+    reflectedOperationInvoker?: ReflectedOperationInvoker;
+};
+export type FetchGraphClient<TOptions = undefined> = OntahiGraphClient<TOptions, TOptions> & {
+    graph: RuntimeBoundDataGraphApi<RemoteDataGraphError, TOptions, TOptions, RemoteDataGraphError>;
+    graphExecutor: ReactGraphExecutor<TOptions, TOptions>;
+};
+export type FetchGraphClientOptions<TOptions = undefined> = {
+    graphRead?: false | FetchGraphReadExecutorOptions<TOptions>;
+    operations?: false | FetchOperationBridgeOptions;
+    reflectedEntityData?: false | FetchReflectedEntityDataReaderOptions;
+};
+export declare const createFetchReflectedEntityDataReader: ({ endpoint, fetch: fetchRequest, }?: FetchReflectedEntityDataReaderOptions) => ReflectedEntityDataReader;
+export declare function createFetchGraphClient<TOptions = undefined>(): FetchGraphClient<TOptions>;
+export declare function createFetchGraphClient<TOptions = undefined>(options: FetchGraphClientOptions<TOptions> & {
+    graphRead: false;
+}): OntahiGraphClient<TOptions, TOptions>;
+export declare function createFetchGraphClient<TOptions = undefined>(options: FetchGraphClientOptions<TOptions> & {
+    graphRead?: FetchGraphReadExecutorOptions<TOptions>;
+}): FetchGraphClient<TOptions>;
+//# sourceMappingURL=fetch-graph-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-graph-client.d.ts","sourceRoot":"","sources":["../../src/graph/fetch-graph-client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,yBAAyB,EAEzB,yBAAyB,EACzB,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAGL,KAAK,yBAAyB,EAC9B,KAAK,2BAA2B,EACjC,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAGpF,MAAM,MAAM,qCAAqC,GAAG;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAAC,YAAY,GAAG,OAAO,EAAE,eAAe,GAAG,YAAY,IAAI;IACtF,KAAK,CAAC,EAAE,wBAAwB,CAC9B,oBAAoB,EACpB,YAAY,EACZ,eAAe,EACf,oBAAoB,CACrB,CAAC;IACF,aAAa,CAAC,EAAE,kBAAkB,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;IAClE,uBAAuB,CAAC,EAAE,yBAAyB,EAAE,CAAC;IACtD,yBAAyB,CAAC,EAAE,yBAAyB,CAAC;IACtD,yBAAyB,CAAC,EAAE,yBAAyB,CAAC;CACvD,CAAC;AAEF,MAAM,MAAM,gBAAgB,CAAC,QAAQ,GAAG,SAAS,IAAI,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG;IAC3F,KAAK,EAAE,wBAAwB,CAAC,oBAAoB,EAAE,QAAQ,EAAE,QAAQ,EAAE,oBAAoB,CAAC,CAAC;IAChG,aAAa,EAAE,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;CACvD,CAAC;AAEF,MAAM,MAAM,uBAAuB,CAAC,QAAQ,GAAG,SAAS,IAAI;IAC1D,SAAS,CAAC,EAAE,KAAK,GAAG,6BAA6B,CAAC,QAAQ,CAAC,CAAC;IAC5D,UAAU,CAAC,EAAE,KAAK,GAAG,2BAA2B,CAAC;IACjD,mBAAmB,CAAC,EAAE,KAAK,GAAG,qCAAqC,CAAC;CACrE,CAAC;AAiBF,eAAO,MAAM,oCAAoC,GAAI,qCAGlD,qCAA0C,KAAG,yBAe9C,CAAC;AAEH,wBAAgB,sBAAsB,CAAC,QAAQ,GAAG,SAAS,KAAK,gBAAgB,CAAC,QAAQ,CAAC,CAAC;AAC3F,wBAAgB,sBAAsB,CAAC,QAAQ,GAAG,SAAS,EACzD,OAAO,EAAE,uBAAuB,CAAC,QAAQ,CAAC,GAAG;IAAE,SAAS,EAAE,KAAK,CAAA;CAAE,GAChE,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACzC,wBAAgB,sBAAsB,CAAC,QAAQ,GAAG,SAAS,EACzD,OAAO,EAAE,uBAAuB,CAAC,QAAQ,CAAC,GAAG;IAC3C,SAAS,CAAC,EAAE,6BAA6B,CAAC,QAAQ,CAAC,CAAC;CACrD,GACA,gBAAgB,CAAC,QAAQ,CAAC,CAAC"}

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

@@ -0,0 +1,50 @@
+'use client';
+import { createRuntimeBoundDataGraphApi } from '@ontahi/core/data-graph';
+import { createFetchOperationBridgeAdapter, createFetchReflectedOperationInvoker, } from '../actions/index.js';
+import { createFetchGraphReadCapability } from './fetch-graph-runtime.js';
+const DEFAULT_OPERATIONS_ENDPOINT = '/operations';
+const DEFAULT_TASKS_ENDPOINT = '/operations/tasks';
+const DEFAULT_REFLECTED_ENTITY_DATA_ENDPOINT = '/explorer/entities';
+const conventionalOperationOptions = (options) => options.mountPath === undefined
+    ? {
+        endpoint: DEFAULT_OPERATIONS_ENDPOINT,
+        taskEndpoint: DEFAULT_TASKS_ENDPOINT,
+        ...options,
+    }
+    : options;
+export const createFetchReflectedEntityDataReader = ({ endpoint = DEFAULT_REFLECTED_ENTITY_DATA_ENDPOINT, fetch: fetchRequest = globalThis.fetch, } = {}) => ({
+    readEntityData: async (query) => {
+        const response = await fetchRequest(endpoint, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            credentials: 'same-origin',
+            body: JSON.stringify(query),
+        });
+        if (!response.ok) {
+            throw new Error(`Reflected entity data request failed with status ${response.status}.`);
+        }
+        return response.json();
+    },
+});
+export function createFetchGraphClient({ graphRead = {}, operations = {}, reflectedEntityData = {}, } = {}) {
+    const operationOptions = operations === false ? undefined : conventionalOperationOptions(operations);
+    const graphReadCapability = graphRead === false ? undefined : createFetchGraphReadCapability(graphRead);
+    return {
+        ...(graphReadCapability
+            ? {
+                graph: createRuntimeBoundDataGraphApi(() => graphReadCapability.runtime),
+                graphExecutor: graphReadCapability.graphExecutor,
+            }
+            : {}),
+        ...(operationOptions
+            ? {
+                operationBridgeAdapters: [createFetchOperationBridgeAdapter(operationOptions)],
+                reflectedOperationInvoker: createFetchReflectedOperationInvoker(operationOptions),
+            }
+            : {}),
+        ...(reflectedEntityData === false
+            ? {}
+            : { reflectedEntityDataReader: createFetchReflectedEntityDataReader(reflectedEntityData) }),
+    };
+}
+//# sourceMappingURL=fetch-graph-client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-graph-client.js","sourceRoot":"","sources":["../../src/graph/fetch-graph-client.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AASb,OAAO,EAAE,8BAA8B,EAAE,MAAM,yBAAyB,CAAC;AAEzE,OAAO,EACL,iCAAiC,EACjC,oCAAoC,GAGrC,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAC;AA+B1E,MAAM,2BAA2B,GAAG,aAAa,CAAC;AAClD,MAAM,sBAAsB,GAAG,mBAAmB,CAAC;AACnD,MAAM,sCAAsC,GAAG,oBAAoB,CAAC;AAEpE,MAAM,4BAA4B,GAAG,CACnC,OAAoC,EACP,EAAE,CAC/B,OAAO,CAAC,SAAS,KAAK,SAAS;IAC7B,CAAC,CAAC;QACE,QAAQ,EAAE,2BAA2B;QACrC,YAAY,EAAE,sBAAsB;QACpC,GAAG,OAAO;KACX;IACH,CAAC,CAAC,OAAO,CAAC;AAEd,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC,EACnD,QAAQ,GAAG,sCAAsC,EACjD,KAAK,EAAE,YAAY,GAAG,UAAU,CAAC,KAAK,MACG,EAAE,EAA6B,EAAE,CAAC,CAAC;IAC5E,cAAc,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;QAC5B,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,QAAQ,EAAE;YAC5C,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,WAAW,EAAE,aAAa;YAC1B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;SAC5B,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,oDAAoD,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QAC1F,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,EAAwC,CAAC;IAC/D,CAAC;CACF,CAAC,CAAC;AAWH,MAAM,UAAU,sBAAsB,CAAuB,EAC3D,SAAS,GAAG,EAAE,EACd,UAAU,GAAG,EAAE,EACf,mBAAmB,GAAG,EAAE,MACa,EAAE;IACvC,MAAM,gBAAgB,GACpB,UAAU,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,4BAA4B,CAAC,UAAU,CAAC,CAAC;IAC9E,MAAM,mBAAmB,GACvB,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,8BAA8B,CAAC,SAAS,CAAC,CAAC;IAE9E,OAAO;QACL,GAAG,CAAC,mBAAmB;YACrB,CAAC,CAAC;gBACE,KAAK,EAAE,8BAA8B,CAAC,GAAG,EAAE,CAAC,mBAAmB,CAAC,OAAO,CAAC;gBACxE,aAAa,EAAE,mBAAmB,CAAC,aAAa;aACjD;YACH,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,gBAAgB;YAClB,CAAC,CAAC;gBACE,uBAAuB,EAAE,CAAC,iCAAiC,CAAC,gBAAgB,CAAC,CAAC;gBAC9E,yBAAyB,EAAE,oCAAoC,CAAC,gBAAgB,CAAC;aAClF;YACH,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,mBAAmB,KAAK,KAAK;YAC/B,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,yBAAyB,EAAE,oCAAoC,CAAC,mBAAmB,CAAC,EAAE,CAAC;KAC9F,CAAC;AACJ,CAAC","sourcesContent":["'use client';\n\nimport type {\n  ReflectedEntityDataReader,\n  ReflectedEntityDataResult,\n  ReflectedOperationInvoker,\n  RemoteDataGraphError,\n  RuntimeBoundDataGraphApi,\n} from '@ontahi/core/data-graph';\nimport { createRuntimeBoundDataGraphApi } from '@ontahi/core/data-graph';\n\nimport {\n  createFetchOperationBridgeAdapter,\n  createFetchReflectedOperationInvoker,\n  type AnyOperationBridgeAdapter,\n  type FetchOperationBridgeOptions,\n} from '../actions/index.js';\n\nimport type { ReactGraphExecutor } from './executor.js';\nimport type { FetchGraphReadExecutorOptions } from './fetch-graph-read-executor.js';\nimport { createFetchGraphReadCapability } from './fetch-graph-runtime.js';\n\nexport type FetchReflectedEntityDataReaderOptions = {\n  endpoint?: string;\n  fetch?: typeof globalThis.fetch;\n};\n\nexport type OntahiGraphClient<TReadOptions = unknown, TCommandOptions = TReadOptions> = {\n  graph?: RuntimeBoundDataGraphApi<\n    RemoteDataGraphError,\n    TReadOptions,\n    TCommandOptions,\n    RemoteDataGraphError\n  >;\n  graphExecutor?: ReactGraphExecutor<TReadOptions, TCommandOptions>;\n  operationBridgeAdapters?: AnyOperationBridgeAdapter[];\n  reflectedEntityDataReader?: ReflectedEntityDataReader;\n  reflectedOperationInvoker?: ReflectedOperationInvoker;\n};\n\nexport type FetchGraphClient<TOptions = undefined> = OntahiGraphClient<TOptions, TOptions> & {\n  graph: RuntimeBoundDataGraphApi<RemoteDataGraphError, TOptions, TOptions, RemoteDataGraphError>;\n  graphExecutor: ReactGraphExecutor<TOptions, TOptions>;\n};\n\nexport type FetchGraphClientOptions<TOptions = undefined> = {\n  graphRead?: false | FetchGraphReadExecutorOptions<TOptions>;\n  operations?: false | FetchOperationBridgeOptions;\n  reflectedEntityData?: false | FetchReflectedEntityDataReaderOptions;\n};\n\nconst DEFAULT_OPERATIONS_ENDPOINT = '/operations';\nconst DEFAULT_TASKS_ENDPOINT = '/operations/tasks';\nconst DEFAULT_REFLECTED_ENTITY_DATA_ENDPOINT = '/explorer/entities';\n\nconst conventionalOperationOptions = (\n  options: FetchOperationBridgeOptions,\n): FetchOperationBridgeOptions =>\n  options.mountPath === undefined\n    ? {\n        endpoint: DEFAULT_OPERATIONS_ENDPOINT,\n        taskEndpoint: DEFAULT_TASKS_ENDPOINT,\n        ...options,\n      }\n    : options;\n\nexport const createFetchReflectedEntityDataReader = ({\n  endpoint = DEFAULT_REFLECTED_ENTITY_DATA_ENDPOINT,\n  fetch: fetchRequest = globalThis.fetch,\n}: FetchReflectedEntityDataReaderOptions = {}): ReflectedEntityDataReader => ({\n  readEntityData: async query => {\n    const response = await fetchRequest(endpoint, {\n      method: 'POST',\n      headers: { 'content-type': 'application/json' },\n      credentials: 'same-origin',\n      body: JSON.stringify(query),\n    });\n\n    if (!response.ok) {\n      throw new Error(`Reflected entity data request failed with status ${response.status}.`);\n    }\n\n    return response.json() as Promise<ReflectedEntityDataResult>;\n  },\n});\n\nexport function createFetchGraphClient<TOptions = undefined>(): FetchGraphClient<TOptions>;\nexport function createFetchGraphClient<TOptions = undefined>(\n  options: FetchGraphClientOptions<TOptions> & { graphRead: false },\n): OntahiGraphClient<TOptions, TOptions>;\nexport function createFetchGraphClient<TOptions = undefined>(\n  options: FetchGraphClientOptions<TOptions> & {\n    graphRead?: FetchGraphReadExecutorOptions<TOptions>;\n  },\n): FetchGraphClient<TOptions>;\nexport function createFetchGraphClient<TOptions = undefined>({\n  graphRead = {},\n  operations = {},\n  reflectedEntityData = {},\n}: FetchGraphClientOptions<TOptions> = {}): OntahiGraphClient<TOptions, TOptions> {\n  const operationOptions =\n    operations === false ? undefined : conventionalOperationOptions(operations);\n  const graphReadCapability =\n    graphRead === false ? undefined : createFetchGraphReadCapability(graphRead);\n\n  return {\n    ...(graphReadCapability\n      ? {\n          graph: createRuntimeBoundDataGraphApi(() => graphReadCapability.runtime),\n          graphExecutor: graphReadCapability.graphExecutor,\n        }\n      : {}),\n    ...(operationOptions\n      ? {\n          operationBridgeAdapters: [createFetchOperationBridgeAdapter(operationOptions)],\n          reflectedOperationInvoker: createFetchReflectedOperationInvoker(operationOptions),\n        }\n      : {}),\n    ...(reflectedEntityData === false\n      ? {}\n      : { reflectedEntityDataReader: createFetchReflectedEntityDataReader(reflectedEntityData) }),\n  };\n}\n"]}

package/dist/graph/fetch-graph-read-executor.d.ts

@@ -0,0 +1,5 @@
+import type { ReactGraphExecutor } from './executor.js';
+import { type FetchGraphReadExecutorOptions } from './fetch-graph-runtime.js';
+export type { FetchGraphReadExecutorOptions } from './fetch-graph-runtime.js';
+export declare const createFetchGraphReadExecutor: <TOptions = undefined>(options?: FetchGraphReadExecutorOptions<TOptions>) => ReactGraphExecutor<TOptions, TOptions>;
+//# sourceMappingURL=fetch-graph-read-executor.d.ts.map

package/dist/graph/fetch-graph-read-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-graph-read-executor.d.ts","sourceRoot":"","sources":["../../src/graph/fetch-graph-read-executor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAEL,KAAK,6BAA6B,EACnC,MAAM,0BAA0B,CAAC;AAElC,YAAY,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAE9E,eAAO,MAAM,4BAA4B,GAAI,QAAQ,GAAG,SAAS,EAC/D,UAAS,6BAA6B,CAAC,QAAQ,CAAM,KACpD,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAA0D,CAAC"}

package/dist/graph/fetch-graph-read-executor.js

@@ -0,0 +1,4 @@
+'use client';
+import { createFetchGraphReadCapability, } from './fetch-graph-runtime.js';
+export const createFetchGraphReadExecutor = (options = {}) => createFetchGraphReadCapability(options).graphExecutor;
+//# sourceMappingURL=fetch-graph-read-executor.js.map

package/dist/graph/fetch-graph-read-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-graph-read-executor.js","sourceRoot":"","sources":["../../src/graph/fetch-graph-read-executor.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAGb,OAAO,EACL,8BAA8B,GAE/B,MAAM,0BAA0B,CAAC;AAIlC,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAC1C,UAAmD,EAAE,EACb,EAAE,CAAC,8BAA8B,CAAC,OAAO,CAAC,CAAC,aAAa,CAAC","sourcesContent":["'use client';\n\nimport type { ReactGraphExecutor } from './executor.js';\nimport {\n  createFetchGraphReadCapability,\n  type FetchGraphReadExecutorOptions,\n} from './fetch-graph-runtime.js';\n\nexport type { FetchGraphReadExecutorOptions } from './fetch-graph-runtime.js';\n\nexport const createFetchGraphReadExecutor = <TOptions = undefined>(\n  options: FetchGraphReadExecutorOptions<TOptions> = {},\n): ReactGraphExecutor<TOptions, TOptions> => createFetchGraphReadCapability(options).graphExecutor;\n"]}

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

@@ -0,0 +1,16 @@
+import { type DataGraphExecutionRuntime, type RemoteDataGraphError, type ManyToManyRelationshipCommandExecutionRuntime, type RelationshipCommandExecutionRuntime } from '@ontahi/core/data-graph';
+import type { ReactGraphExecutor } from './executor.js';
+export type FetchGraphReadExecutorOptions<TOptions = undefined> = {
+    endpoint?: string;
+    commandEndpoint?: string;
+    fetch?: typeof globalThis.fetch;
+    requestInit?: (options?: TOptions) => Omit<RequestInit, 'body' | 'method'>;
+};
+export type FetchGraphRuntime<TOptions = undefined> = DataGraphExecutionRuntime<RemoteDataGraphError, TOptions, TOptions, RemoteDataGraphError>;
+export type FetchRelationshipRuntime<TOptions = undefined> = RelationshipCommandExecutionRuntime<RemoteDataGraphError, TOptions> & ManyToManyRelationshipCommandExecutionRuntime<RemoteDataGraphError, TOptions>;
+export type FetchGraphReadCapability<TOptions = undefined> = {
+    runtime: FetchGraphRuntime<TOptions> & FetchRelationshipRuntime<TOptions>;
+    graphExecutor: ReactGraphExecutor<TOptions, TOptions>;
+};
+export declare const createFetchGraphReadCapability: <TOptions = undefined>({ endpoint, commandEndpoint, fetch: fetchRequest, requestInit, }?: FetchGraphReadExecutorOptions<TOptions>) => FetchGraphReadCapability<TOptions>;
+//# sourceMappingURL=fetch-graph-runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-graph-runtime.d.ts","sourceRoot":"","sources":["../../src/graph/fetch-graph-runtime.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EAGzB,KAAK,6CAA6C,EAClD,KAAK,mCAAmC,EACzC,MAAM,yBAAyB,CAAC;AAGjC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExD,MAAM,MAAM,6BAA6B,CAAC,QAAQ,GAAG,SAAS,IAAI;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,WAAW,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,QAAQ,KAAK,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC;CAC5E,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAAC,QAAQ,GAAG,SAAS,IAAI,yBAAyB,CAC7E,oBAAoB,EACpB,QAAQ,EACR,QAAQ,EACR,oBAAoB,CACrB,CAAC;AACF,MAAM,MAAM,wBAAwB,CAAC,QAAQ,GAAG,SAAS,IAAI,mCAAmC,CAC9F,oBAAoB,EACpB,QAAQ,CACT,GACC,6CAA6C,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;AAEhF,MAAM,MAAM,wBAAwB,CAAC,QAAQ,GAAG,SAAS,IAAI;IAC3D,OAAO,EAAE,iBAAiB,CAAC,QAAQ,CAAC,GAAG,wBAAwB,CAAC,QAAQ,CAAC,CAAC;IAC1E,aAAa,EAAE,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;CACvD,CAAC;AAKF,eAAO,MAAM,8BAA8B,GAAI,QAAQ,GAAG,SAAS,EAAE,mEAKlE,6BAA6B,CAAC,QAAQ,CAAM,KAAG,wBAAwB,CAAC,QAAQ,CAwDlF,CAAC"}