@ontahi/react 0.1.0-alpha.3 → 0.1.0-alpha.5

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} 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\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,22 @@
+import type { ReflectedEntityDataReader, ReflectedOperationInvoker } 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> = {
+    graphExecutor?: ReactGraphExecutor<TReadOptions, TCommandOptions>;
+    operationBridgeAdapters?: AnyOperationBridgeAdapter[];
+    reflectedEntityDataReader?: ReflectedEntityDataReader;
+    reflectedOperationInvoker?: ReflectedOperationInvoker;
+};
+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 const createFetchGraphClient: <TOptions = undefined>({ graphRead, operations, reflectedEntityData, }?: FetchGraphClientOptions<TOptions>) => OntahiGraphClient<TOptions, 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,EAC1B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAGL,KAAK,yBAAyB,EAC9B,KAAK,2BAA2B,EACjC,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAEL,KAAK,6BAA6B,EACnC,MAAM,gCAAgC,CAAC;AAExC,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,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,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,eAAO,MAAM,sBAAsB,GAAI,QAAQ,GAAG,SAAS,EAAE,kDAI1D,uBAAuB,CAAC,QAAQ,CAAM,KAAG,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAgB/E,CAAC"}

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

@@ -0,0 +1,43 @@
+'use client';
+import { createFetchOperationBridgeAdapter, createFetchReflectedOperationInvoker, } from '../actions/index.js';
+import { createFetchGraphReadExecutor, } from './fetch-graph-read-executor.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 const createFetchGraphClient = ({ graphRead = {}, operations = {}, reflectedEntityData = {}, } = {}) => {
+    const operationOptions = operations === false ? undefined : conventionalOperationOptions(operations);
+    return {
+        ...(graphRead === false ? {} : { graphExecutor: createFetchGraphReadExecutor(graphRead) }),
+        ...(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;AAQb,OAAO,EACL,iCAAiC,EACjC,oCAAoC,GAGrC,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,4BAA4B,GAE7B,MAAM,gCAAgC,CAAC;AAoBxC,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;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAuB,EAC3D,SAAS,GAAG,EAAE,EACd,UAAU,GAAG,EAAE,EACf,mBAAmB,GAAG,EAAE,MACa,EAAE,EAAyC,EAAE;IAClF,MAAM,gBAAgB,GACpB,UAAU,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,4BAA4B,CAAC,UAAU,CAAC,CAAC;IAE9E,OAAO;QACL,GAAG,CAAC,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,4BAA4B,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1F,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,CAAC","sourcesContent":["'use client';\n\nimport type {\n  ReflectedEntityDataReader,\n  ReflectedEntityDataResult,\n  ReflectedOperationInvoker,\n} 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 {\n  createFetchGraphReadExecutor,\n  type FetchGraphReadExecutorOptions,\n} from './fetch-graph-read-executor.js';\n\nexport type FetchReflectedEntityDataReaderOptions = {\n  endpoint?: string;\n  fetch?: typeof globalThis.fetch;\n};\n\nexport type OntahiGraphClient<TReadOptions = unknown, TCommandOptions = TReadOptions> = {\n  graphExecutor?: ReactGraphExecutor<TReadOptions, TCommandOptions>;\n  operationBridgeAdapters?: AnyOperationBridgeAdapter[];\n  reflectedEntityDataReader?: ReflectedEntityDataReader;\n  reflectedOperationInvoker?: ReflectedOperationInvoker;\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 const 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\n  return {\n    ...(graphRead === false ? {} : { graphExecutor: createFetchGraphReadExecutor(graphRead) }),\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,8 @@
+import type { ReactGraphExecutor } from './executor.js';
+export type FetchGraphReadExecutorOptions<TOptions = undefined> = {
+    endpoint?: string;
+    fetch?: typeof globalThis.fetch;
+    requestInit?: (options?: TOptions) => Omit<RequestInit, 'body' | 'method'>;
+};
+export declare const createFetchGraphReadExecutor: <TOptions = undefined>({ endpoint, fetch: fetchRequest, requestInit, }?: 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":"AASA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExD,MAAM,MAAM,6BAA6B,CAAC,QAAQ,GAAG,SAAS,IAAI;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,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;AAIF,eAAO,MAAM,4BAA4B,GAAI,QAAQ,GAAG,SAAS,EAAE,kDAIhE,6BAA6B,CAAC,QAAQ,CAAM,KAAG,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAgCtF,CAAC"}

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

@@ -0,0 +1,37 @@
+'use client';
+import { createRemoteDataGraphRuntime, isGraphReadProtocolError, } from '@ontahi/core/data-graph';
+import { runBrowserEffect } from '@ontahi/core/runtime/browser';
+const DEFAULT_GRAPH_READ_ENDPOINT = '/graph/reads';
+export const createFetchGraphReadExecutor = ({ endpoint = DEFAULT_GRAPH_READ_ENDPOINT, fetch: fetchRequest = globalThis.fetch, requestInit, } = {}) => {
+    const transport = async (request, options) => {
+        const init = requestInit?.(options) ?? {};
+        const headers = new Headers(init.headers);
+        if (!headers.has('content-type'))
+            headers.set('content-type', 'application/json');
+        const response = await fetchRequest(endpoint, {
+            ...init,
+            method: 'POST',
+            headers,
+            credentials: init.credentials ?? 'same-origin',
+            body: JSON.stringify(request),
+        });
+        try {
+            const payload = await response.json();
+            if (!response.ok && !isGraphReadProtocolError(payload)) {
+                throw new Error(`Graph read request failed with status ${response.status}.`);
+            }
+            return payload;
+        }
+        catch {
+            throw new Error(`Graph read request failed with status ${response.status}.`);
+        }
+    };
+    const runtime = createRemoteDataGraphRuntime({ transport });
+    return {
+        get: (read, params, options) => runBrowserEffect(runtime.get(read, params, options)),
+        run: (read, params, options) => runBrowserEffect(runtime.run(read, params, options)),
+        count: (read, params, options) => runBrowserEffect(runtime.count(read, params, options)),
+        runCommand: (command, options) => runBrowserEffect(runtime.runCommand(command, options)),
+    };
+};
+//# 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;AAEb,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,GAEzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAUhE,MAAM,2BAA2B,GAAG,cAAc,CAAC;AAEnD,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAuB,EACjE,QAAQ,GAAG,2BAA2B,EACtC,KAAK,EAAE,YAAY,GAAG,UAAU,CAAC,KAAK,EACtC,WAAW,MACgC,EAAE,EAA0C,EAAE;IACzF,MAAM,SAAS,GAAuC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;QAC/E,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;QAElF,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,QAAQ,EAAE;YAC5C,GAAG,IAAI;YACP,MAAM,EAAE,MAAM;YACd,OAAO;YACP,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,aAAa;YAC9C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;SAC9B,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,OAAO,GAAY,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAC/C,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,wBAAwB,CAAC,OAAO,CAAC,EAAE,CAAC;gBACvD,MAAM,IAAI,KAAK,CAAC,yCAAyC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;YAC/E,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,yCAAyC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,4BAA4B,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IAE5D,OAAO;QACL,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACpF,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACpF,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACxF,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;KACzF,CAAC;AACJ,CAAC,CAAC","sourcesContent":["'use client';\n\nimport {\n  createRemoteDataGraphRuntime,\n  isGraphReadProtocolError,\n  type RemoteGraphReadTransport,\n} from '@ontahi/core/data-graph';\nimport { runBrowserEffect } from '@ontahi/core/runtime/browser';\n\nimport type { ReactGraphExecutor } from './executor.js';\n\nexport type FetchGraphReadExecutorOptions<TOptions = undefined> = {\n  endpoint?: string;\n  fetch?: typeof globalThis.fetch;\n  requestInit?: (options?: TOptions) => Omit<RequestInit, 'body' | 'method'>;\n};\n\nconst DEFAULT_GRAPH_READ_ENDPOINT = '/graph/reads';\n\nexport const createFetchGraphReadExecutor = <TOptions = undefined>({\n  endpoint = DEFAULT_GRAPH_READ_ENDPOINT,\n  fetch: fetchRequest = globalThis.fetch,\n  requestInit,\n}: FetchGraphReadExecutorOptions<TOptions> = {}): ReactGraphExecutor<TOptions, TOptions> => {\n  const transport: RemoteGraphReadTransport<TOptions> = async (request, options) => {\n    const init = requestInit?.(options) ?? {};\n    const headers = new Headers(init.headers);\n    if (!headers.has('content-type')) headers.set('content-type', 'application/json');\n\n    const response = await fetchRequest(endpoint, {\n      ...init,\n      method: 'POST',\n      headers,\n      credentials: init.credentials ?? 'same-origin',\n      body: JSON.stringify(request),\n    });\n\n    try {\n      const payload: unknown = await response.json();\n      if (!response.ok && !isGraphReadProtocolError(payload)) {\n        throw new Error(`Graph read request failed with status ${response.status}.`);\n      }\n      return payload;\n    } catch {\n      throw new Error(`Graph read request failed with status ${response.status}.`);\n    }\n  };\n  const runtime = createRemoteDataGraphRuntime({ transport });\n\n  return {\n    get: (read, params, options) => runBrowserEffect(runtime.get(read, params, options)),\n    run: (read, params, options) => runBrowserEffect(runtime.run(read, params, options)),\n    count: (read, params, options) => runBrowserEffect(runtime.count(read, params, options)),\n    runCommand: (command, options) => runBrowserEffect(runtime.runCommand(command, options)),\n  };\n};\n"]}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"graph-hooks.d.ts","sourceRoot":"","sources":["../../src/graph/graph-hooks.ts"],"names":[],"mappings":"AAQA,OAAO,EAKL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EAGV,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,yBAAyB,EACzB,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,eAAe,EAEf,UAAU,EACX,MAAM,eAAe,CAAC;AAqCvB,wBAAgB,aAAa,CAC3B,KAAK,EACL,KAAK,SAAS,cAAc,EAC5B,YAAY,GAAG,OAAO,EACtB,eAAe,GAAG,YAAY,EAE9B,IAAI,EAAE,eAAe,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EACxC,OAAO,EAAE,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,GACrD,cAAc,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,CAwBrD;AAED,wBAAgB,eAAe,CAC7B,UAAU,EACV,OAAO,GAAG,IAAI,EACd,QAAQ,GAAG,OAAO,EAClB,YAAY,GAAG,OAAO,EACtB,eAAe,GAAG,YAAY,EAE9B,YAAY,EAAE,mBAAmB,CAAC,UAAU,EAAE,OAAO,CAAC,EACtD,OAAO,CAAC,EAAE,uBAAuB,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,eAAe,CAAC,GAChF,iBAAiB,CAAC,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC,CAoBzD;AAED,wBAAgB,iBAAiB,CAC/B,UAAU,SAAS,kBAAkB,CAAC,GAAG,EAAE,GAAG,CAAC,EAC/C,QAAQ,GAAG,OAAO,EAClB,YAAY,GAAG,OAAO,EACtB,eAAe,GAAG,YAAY,EAE9B,SAAS,EAAE,UAAU,EACrB,OAAO,CAAC,EAAE,uBAAuB,CAC/B,oBAAoB,CAAC,UAAU,CAAC,EAChC,yBAAyB,CAAC,UAAU,CAAC,EACrC,QAAQ,EACR,eAAe,CAChB,GACA,iBAAiB,CAClB,oBAAoB,CAAC,UAAU,CAAC,EAChC,KAAK,EACL,yBAAyB,CAAC,UAAU,CAAC,EACrC,QAAQ,CACT,CAiBA"}
+{"version":3,"file":"graph-hooks.d.ts","sourceRoot":"","sources":["../../src/graph/graph-hooks.ts"],"names":[],"mappings":"AAaA,OAAO,EAKL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EAGV,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,yBAAyB,EACzB,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,eAAe,EAGhB,MAAM,eAAe,CAAC;AAgEvB,wBAAgB,aAAa,CAC3B,KAAK,SAAS,eAAe,CAAC,GAAG,CAAC,EAClC,KAAK,SAAS,cAAc,GAAG,KAAK,EACpC,YAAY,GAAG,OAAO,EACtB,eAAe,GAAG,YAAY,EAE9B,IAAI,EAAE,KAAK,EACX,OAAO,CAAC,EAAE,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,GACtD,cAAc,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,CA6BrD;AAED,wBAAgB,eAAe,CAC7B,UAAU,EACV,OAAO,GAAG,IAAI,EACd,QAAQ,GAAG,OAAO,EAClB,YAAY,GAAG,OAAO,EACtB,eAAe,GAAG,YAAY,EAE9B,YAAY,EAAE,mBAAmB,CAAC,UAAU,EAAE,OAAO,CAAC,EACtD,OAAO,CAAC,EAAE,uBAAuB,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,eAAe,CAAC,GAChF,iBAAiB,CAAC,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC,CAoBzD;AAED,wBAAgB,iBAAiB,CAC/B,UAAU,SAAS,kBAAkB,CAAC,GAAG,EAAE,GAAG,CAAC,EAC/C,QAAQ,GAAG,OAAO,EAClB,YAAY,GAAG,OAAO,EACtB,eAAe,GAAG,YAAY,EAE9B,SAAS,EAAE,UAAU,EACrB,OAAO,CAAC,EAAE,uBAAuB,CAC/B,oBAAoB,CAAC,UAAU,CAAC,EAChC,yBAAyB,CAAC,UAAU,CAAC,EACrC,QAAQ,EACR,eAAe,CAChB,GACA,iBAAiB,CAClB,oBAAoB,CAAC,UAAU,CAAC,EAChC,KAAK,EACL,yBAAyB,CAAC,UAAU,CAAC,EACrC,QAAQ,CACT,CAiBA"}

package/dist/graph/graph-hooks.js

@@ -1,35 +1,58 @@
 'use client';
-import { normalizeGraphSchemaClientInput, } from '@ontahi/core/data-graph';
+import { isGraphReadExpression, normalizeGraphSchemaClientInput, resolveQuerySpec, toGraphReadRequest, } from '@ontahi/core/data-graph';
+import { executionIdentityCacheKey } from '@ontahi/core/runtime/identity';
 import { useMutation, useQuery, useQueryClient, } from '@tanstack/react-query';
-import { useGraphExecutor } from './context.js';
+import { useExecutionIdentity, useGraphExecutor } from './context.js';
 const isQueryOrView = (read) => 'kind' in read;
 const isBuildableRead = (read) => typeof read.build === 'function';
 const isNamedView = (read) => 'kind' in read && read.kind === 'view';
 const resolveGraphRead = (read) => (isQueryOrView(read) ? read : isBuildableRead(read) ? read.build() : read);
 const resolveGraphCommand = (command) => ('build' in command ? command.build() : command);
-const deriveGraphQueryKey = (read, mode, params, runtimeOptions) => {
+const intentFromMode = (mode) => mode === 'get' ? 'first' : mode === 'run' ? 'many' : mode;
+const modeFromIntent = (intent) => intent === 'many' ? 'run' : intent === 'count' ? 'count' : 'get';
+const deriveGraphQueryKey = (read, intent, params, identityKey) => {
     const resolved = isQueryOrView(read) ? read : resolveGraphRead(read);
     if (isNamedView(resolved)) {
-        return ['graph', mode, resolved.name, params ?? null, runtimeOptions ?? null];
+        return [
+            resolved.root.name,
+            'graph-read',
+            identityKey,
+            intent,
+            'view',
+            resolved.name,
+            params ?? null,
+        ];
+    }
+    try {
+        const request = toGraphReadRequest(resolveQuerySpec(resolved, params), modeFromIntent(intent));
+        return [request.selection.entityName, 'graph-read', identityKey, intent, request];
+    }
+    catch (error) {
+        const message = 'useGraphQuery could not infer a transport-safe queryKey; provide queryKey explicitly';
+        throw new Error(`${message}: ${error instanceof Error ? error.message : String(error)}`);
     }
-    throw new Error('useGraphQuery requires queryKey for unnamed selections or query specs');
 };
 export function useGraphQuery(read, options) {
     const graphExecutor = useGraphExecutor();
+    const identity = useExecutionIdentity();
+    const expression = isGraphReadExpression(read) ? read : undefined;
+    const source = (expression?.read ?? read);
+    const mode = options?.mode ?? 'run';
+    const intent = expression?.intent ?? intentFromMode(mode);
     return useQuery({
         ...options,
-        queryKey: options.queryKey ??
-            deriveGraphQueryKey(read, options.mode, options.params, options.runtimeOptions),
+        queryKey: options?.queryKey ??
+            deriveGraphQueryKey(source, intent, options?.params, executionIdentityCacheKey(identity)),
         queryFn: async () => {
-            const resolved = resolveGraphRead(read);
-            const params = options.params;
-            const value = options.mode === 'get'
-                ? await graphExecutor.get(resolved, params, options.runtimeOptions)
-                : options.mode === 'run'
-                    ? await graphExecutor.run(resolved, params, options.runtimeOptions)
-                    : options.mode === 'count'
-                        ? await graphExecutor.count(resolved, params, options.runtimeOptions)
-                        : (await graphExecutor.get(resolved, params, options.runtimeOptions)) != null;
+            const resolved = resolveGraphRead(source);
+            const params = options?.params;
+            const value = intent === 'many'
+                ? await graphExecutor.run(resolved, params, options?.runtimeOptions)
+                : intent === 'count'
+                    ? await graphExecutor.count(resolved, params, options?.runtimeOptions)
+                    : intent === 'exists'
+                        ? (await graphExecutor.get(resolved, params, options?.runtimeOptions)) != null
+                        : await graphExecutor.get(resolved, params, options?.runtimeOptions);
             return value;
         },
     });

package/dist/graph/graph-hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"graph-hooks.js","sourceRoot":"","sources":["../../src/graph/graph-hooks.ts"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport {\n  normalizeGraphSchemaClientInput,\n  type GraphCommandSpec,\n  type QueryOrView,\n  type ViewDefinition,\n} from '@ontahi/core/data-graph';\nimport {\n  useMutation,\n  useQuery,\n  useQueryClient,\n  type QueryKey,\n  type UseMutationResult,\n  type UseQueryResult,\n} from '@tanstack/react-query';\n\nimport { useGraphExecutor } from './context.js';\nimport type {\n  BuildableRead,\n  CommandLike,\n  GraphCommandBuilder,\n  GraphCommandHookOptions,\n  GraphOperationLike,\n  GraphOperationClientInput,\n  GraphOperationResult,\n  GraphQueryData,\n  GraphQueryMode,\n  GraphQueryOptions,\n  GraphReadSource,\n  ReadParams,\n  ReadResult,\n} from './executor.js';\n\nconst isQueryOrView = <TResult>(\n  read: GraphReadSource<TResult>,\n): read is QueryOrView<any, TResult> => 'kind' in read;\n\nconst isBuildableRead = <TResult>(read: GraphReadSource<TResult>): read is BuildableRead<TResult> =>\n  typeof (read as BuildableRead<TResult>).build === 'function';\n\nconst isNamedView = <TResult>(\n  read: QueryOrView<any, TResult>,\n): read is ViewDefinition<any, any, TResult> => 'kind' in read && read.kind === 'view';\n\nconst resolveGraphRead = <TResult>(read: GraphReadSource<TResult>) =>\n  (isQueryOrView(read) ? read : isBuildableRead(read) ? read.build() : read) as QueryOrView<\n    any,\n    TResult\n  >;\n\nconst resolveGraphCommand = <TResult>(command: CommandLike<TResult>) =>\n  ('build' in command ? command.build() : command) as GraphCommandSpec<any, any, TResult>;\n\nconst deriveGraphQueryKey = <TRead, TMode extends GraphQueryMode, TReadOptions>(\n  read: GraphReadSource<ReadResult<TRead>>,\n  mode: TMode,\n  params: ReadParams<TRead> | undefined,\n  runtimeOptions: TReadOptions | undefined,\n): QueryKey => {\n  const resolved = isQueryOrView(read) ? read : resolveGraphRead(read);\n\n  if (isNamedView(resolved)) {\n    return ['graph', mode, resolved.name, params ?? null, runtimeOptions ?? null];\n  }\n\n  throw new Error('useGraphQuery requires queryKey for unnamed selections or query specs');\n};\n\nexport function useGraphQuery<\n  TRead,\n  TMode extends GraphQueryMode,\n  TReadOptions = unknown,\n  TCommandOptions = TReadOptions,\n>(\n  read: GraphReadSource<ReadResult<TRead>>,\n  options: GraphQueryOptions<TRead, TMode, TReadOptions>,\n): UseQueryResult<GraphQueryData<TRead, TMode>, Error> {\n  const graphExecutor = useGraphExecutor<TReadOptions, TCommandOptions>();\n\n  return useQuery({\n    ...options,\n    queryKey:\n      options.queryKey ??\n      deriveGraphQueryKey(read, options.mode, options.params, options.runtimeOptions),\n    queryFn: async () => {\n      const resolved = resolveGraphRead(read);\n      const params = options.params as any;\n\n      const value =\n        options.mode === 'get'\n          ? await graphExecutor.get(resolved, params, options.runtimeOptions)\n          : options.mode === 'run'\n            ? await graphExecutor.run(resolved, params, options.runtimeOptions)\n            : options.mode === 'count'\n              ? await graphExecutor.count(resolved, params, options.runtimeOptions)\n              : (await graphExecutor.get(resolved, params, options.runtimeOptions)) != null;\n\n      return value as GraphQueryData<TRead, TMode>;\n    },\n  });\n}\n\nexport function useGraphCommand<\n  TVariables,\n  TResult = void,\n  TContext = unknown,\n  TReadOptions = unknown,\n  TCommandOptions = TReadOptions,\n>(\n  buildCommand: GraphCommandBuilder<TVariables, TResult>,\n  options?: GraphCommandHookOptions<TResult, TVariables, TContext, TCommandOptions>,\n): UseMutationResult<TResult, Error, TVariables, TContext> {\n  const graphExecutor = useGraphExecutor<TReadOptions, TCommandOptions>();\n  const queryClient = useQueryClient();\n\n  return useMutation({\n    ...options,\n    mutationKey: options?.mutationKey,\n    mutationFn: variables =>\n      graphExecutor.runCommand(\n        resolveGraphCommand(buildCommand(variables)),\n        options?.runtimeOptions,\n      ),\n    onSuccess: async (data, variables, onMutateResult, context) => {\n      for (const queryKey of options?.invalidateQueryKeys ?? []) {\n        await queryClient.invalidateQueries({ queryKey });\n      }\n\n      await options?.onSuccess?.(data, variables, onMutateResult, context);\n    },\n  });\n}\n\nexport function useGraphOperation<\n  TOperation extends GraphOperationLike<any, any>,\n  TContext = unknown,\n  TReadOptions = unknown,\n  TCommandOptions = TReadOptions,\n>(\n  operation: TOperation,\n  options?: GraphCommandHookOptions<\n    GraphOperationResult<TOperation>,\n    GraphOperationClientInput<TOperation>,\n    TContext,\n    TCommandOptions\n  >,\n): UseMutationResult<\n  GraphOperationResult<TOperation>,\n  Error,\n  GraphOperationClientInput<TOperation>,\n  TContext\n> {\n  type TVariables = GraphOperationClientInput<TOperation>;\n  type TResult = GraphOperationResult<TOperation>;\n  const buildCommand = (variables: TVariables) =>\n    operation.run(\n      (operation.input\n        ? normalizeGraphSchemaClientInput(operation.input, variables)\n        : variables) as never,\n    );\n\n  return useGraphCommand<TVariables, TResult, TContext, TReadOptions, TCommandOptions>(\n    buildCommand,\n    {\n      mutationKey: options?.mutationKey ?? ['graph-operation', operation.id],\n      ...options,\n    },\n  );\n}\n"]}
+{"version":3,"file":"graph-hooks.js","sourceRoot":"","sources":["../../src/graph/graph-hooks.ts"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport {\n  isGraphReadExpression,\n  normalizeGraphSchemaClientInput,\n  resolveQuerySpec,\n  toGraphReadRequest,\n  type GraphCommandSpec,\n  type GraphReadIntent,\n  type QueryOrView,\n  type ViewDefinition,\n} from '@ontahi/core/data-graph';\nimport { executionIdentityCacheKey } from '@ontahi/core/runtime/identity';\nimport {\n  useMutation,\n  useQuery,\n  useQueryClient,\n  type QueryKey,\n  type UseMutationResult,\n  type UseQueryResult,\n} from '@tanstack/react-query';\n\nimport { useExecutionIdentity, useGraphExecutor } from './context.js';\nimport type {\n  BuildableRead,\n  CommandLike,\n  GraphCommandBuilder,\n  GraphCommandHookOptions,\n  GraphOperationLike,\n  GraphOperationClientInput,\n  GraphOperationResult,\n  GraphQueryData,\n  GraphQueryMode,\n  GraphQueryOptions,\n  GraphReadSource,\n  ReadParams,\n  ReadResult,\n} from './executor.js';\n\nconst isQueryOrView = <TResult>(\n  read: Exclude<GraphReadSource<TResult>, { kind: 'graph-read-expression' }>,\n): read is QueryOrView<any, TResult> => 'kind' in read;\n\nconst isBuildableRead = <TResult>(\n  read: Exclude<GraphReadSource<TResult>, { kind: 'graph-read-expression' }>,\n): read is BuildableRead<TResult> => typeof (read as BuildableRead<TResult>).build === 'function';\n\nconst isNamedView = <TResult>(\n  read: QueryOrView<any, TResult>,\n): read is ViewDefinition<any, any, TResult> => 'kind' in read && read.kind === 'view';\n\ntype PlainGraphReadSource<TResult> = Exclude<\n  GraphReadSource<TResult>,\n  { kind: 'graph-read-expression' }\n>;\n\nconst resolveGraphRead = <TResult>(read: PlainGraphReadSource<TResult>) =>\n  (isQueryOrView(read) ? read : isBuildableRead(read) ? read.build() : read) as QueryOrView<\n    any,\n    TResult\n  >;\n\nconst resolveGraphCommand = <TResult>(command: CommandLike<TResult>) =>\n  ('build' in command ? command.build() : command) as GraphCommandSpec<any, any, TResult>;\n\nconst intentFromMode = (mode: GraphQueryMode): GraphReadIntent | 'many' =>\n  mode === 'get' ? 'first' : mode === 'run' ? 'many' : mode;\n\nconst modeFromIntent = (intent: GraphReadIntent | 'many'): Exclude<GraphQueryMode, 'exists'> =>\n  intent === 'many' ? 'run' : intent === 'count' ? 'count' : 'get';\n\nconst deriveGraphQueryKey = <TRead>(\n  read: PlainGraphReadSource<ReadResult<TRead>>,\n  intent: GraphReadIntent | 'many',\n  params: ReadParams<TRead> | undefined,\n  identityKey: readonly unknown[],\n): QueryKey => {\n  const resolved = isQueryOrView(read) ? read : resolveGraphRead(read);\n\n  if (isNamedView(resolved)) {\n    return [\n      resolved.root.name,\n      'graph-read',\n      identityKey,\n      intent,\n      'view',\n      resolved.name,\n      params ?? null,\n    ];\n  }\n\n  try {\n    const request = toGraphReadRequest(resolveQuerySpec(resolved, params), modeFromIntent(intent));\n    return [request.selection.entityName, 'graph-read', identityKey, intent, request];\n  } catch (error) {\n    const message =\n      'useGraphQuery could not infer a transport-safe queryKey; provide queryKey explicitly';\n    throw new Error(`${message}: ${error instanceof Error ? error.message : String(error)}`);\n  }\n};\n\nexport function useGraphQuery<\n  TRead extends GraphReadSource<any>,\n  TMode extends GraphQueryMode = 'run',\n  TReadOptions = unknown,\n  TCommandOptions = TReadOptions,\n>(\n  read: TRead,\n  options?: GraphQueryOptions<TRead, TMode, TReadOptions>,\n): UseQueryResult<GraphQueryData<TRead, TMode>, Error> {\n  const graphExecutor = useGraphExecutor<TReadOptions, TCommandOptions>();\n  const identity = useExecutionIdentity();\n  const expression = isGraphReadExpression(read) ? read : undefined;\n  const source = (expression?.read ?? read) as PlainGraphReadSource<ReadResult<TRead>>;\n  const mode = options?.mode ?? 'run';\n  const intent = expression?.intent ?? intentFromMode(mode);\n\n  return useQuery({\n    ...options,\n    queryKey:\n      options?.queryKey ??\n      deriveGraphQueryKey(source, intent, options?.params, executionIdentityCacheKey(identity)),\n    queryFn: async () => {\n      const resolved = resolveGraphRead(source);\n      const params = options?.params as any;\n\n      const value =\n        intent === 'many'\n          ? await graphExecutor.run(resolved, params, options?.runtimeOptions)\n          : intent === 'count'\n            ? await graphExecutor.count(resolved, params, options?.runtimeOptions)\n            : intent === 'exists'\n              ? (await graphExecutor.get(resolved, params, options?.runtimeOptions)) != null\n              : await graphExecutor.get(resolved, params, options?.runtimeOptions);\n\n      return value as GraphQueryData<TRead, TMode>;\n    },\n  });\n}\n\nexport function useGraphCommand<\n  TVariables,\n  TResult = void,\n  TContext = unknown,\n  TReadOptions = unknown,\n  TCommandOptions = TReadOptions,\n>(\n  buildCommand: GraphCommandBuilder<TVariables, TResult>,\n  options?: GraphCommandHookOptions<TResult, TVariables, TContext, TCommandOptions>,\n): UseMutationResult<TResult, Error, TVariables, TContext> {\n  const graphExecutor = useGraphExecutor<TReadOptions, TCommandOptions>();\n  const queryClient = useQueryClient();\n\n  return useMutation({\n    ...options,\n    mutationKey: options?.mutationKey,\n    mutationFn: variables =>\n      graphExecutor.runCommand(\n        resolveGraphCommand(buildCommand(variables)),\n        options?.runtimeOptions,\n      ),\n    onSuccess: async (data, variables, onMutateResult, context) => {\n      for (const queryKey of options?.invalidateQueryKeys ?? []) {\n        await queryClient.invalidateQueries({ queryKey });\n      }\n\n      await options?.onSuccess?.(data, variables, onMutateResult, context);\n    },\n  });\n}\n\nexport function useGraphOperation<\n  TOperation extends GraphOperationLike<any, any>,\n  TContext = unknown,\n  TReadOptions = unknown,\n  TCommandOptions = TReadOptions,\n>(\n  operation: TOperation,\n  options?: GraphCommandHookOptions<\n    GraphOperationResult<TOperation>,\n    GraphOperationClientInput<TOperation>,\n    TContext,\n    TCommandOptions\n  >,\n): UseMutationResult<\n  GraphOperationResult<TOperation>,\n  Error,\n  GraphOperationClientInput<TOperation>,\n  TContext\n> {\n  type TVariables = GraphOperationClientInput<TOperation>;\n  type TResult = GraphOperationResult<TOperation>;\n  const buildCommand = (variables: TVariables) =>\n    operation.run(\n      (operation.input\n        ? normalizeGraphSchemaClientInput(operation.input, variables)\n        : variables) as never,\n    );\n\n  return useGraphCommand<TVariables, TResult, TContext, TReadOptions, TCommandOptions>(\n    buildCommand,\n    {\n      mutationKey: options?.mutationKey ?? ['graph-operation', operation.id],\n      ...options,\n    },\n  );\n}\n"]}

package/dist/graph/index.d.ts

@@ -1,5 +1,7 @@
 export * from './context.js';
 export * from './executor.js';
+export * from './fetch-graph-read-executor.js';
+export * from './fetch-graph-client.js';
 export * from './graph-hooks.js';
 export * from './operation-cache.js';
 export * from './operation-hooks.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/graph/index.tsx"],"names":[],"mappings":"AAEA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/graph/index.tsx"],"names":[],"mappings":"AAEA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC"}

package/dist/graph/index.js

@@ -1,6 +1,8 @@
 'use client';
 export * from './context.js';
 export * from './executor.js';
+export * from './fetch-graph-read-executor.js';
+export * from './fetch-graph-client.js';
 export * from './graph-hooks.js';
 export * from './operation-cache.js';
 export * from './operation-hooks.js';

package/dist/graph/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/graph/index.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC","sourcesContent":["'use client';\n\nexport * from './context.js';\nexport * from './executor.js';\nexport * from './graph-hooks.js';\nexport * from './operation-cache.js';\nexport * from './operation-hooks.js';\nexport * from './operation-types.js';\nexport * from './reflected-entity-data-hooks.js';\nexport * from './reflected-operation-invoker.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/graph/index.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC","sourcesContent":["'use client';\n\nexport * from './context.js';\nexport * from './executor.js';\nexport * from './fetch-graph-read-executor.js';\nexport * from './fetch-graph-client.js';\nexport * from './graph-hooks.js';\nexport * from './operation-cache.js';\nexport * from './operation-hooks.js';\nexport * from './operation-types.js';\nexport * from './reflected-entity-data-hooks.js';\nexport * from './reflected-operation-invoker.js';\n"]}

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

@@ -1,8 +1,9 @@
 import type { DomainOperationInvocation as OperationInvocation } from '@ontahi/core/data-graph';
 import { type InfiniteData, type QueryKey, type UseQueryResult } from '@tanstack/react-query';
 import type { GraphPermission } from '../actions/index.js';
-import type { ClientOperationLike, ClientSchemaOperationLike, DurableOperationHookOptions, DurableOperationHookResult, DurableOperationLike, OperationHookOptions, OperationHookResult, OperationInputHookResult, OperationInfiniteQueryOptions, OperationQueryOptions, OperationRunner, ReflectedOperationLike } from './operation-types.js';
+import type { ClientOperationLike, ClientOperationInvocation, ClientSchemaOperationLike, BoundOperationHookResult, DurableOperationHookOptions, DurableOperationHookResult, DurableOperationLike, OperationHookOptions, OperationHookResult, OperationInputHookResult, OperationInfiniteQueryOptions, OperationQueryOptions, OperationRunner, ReflectedOperationLike } from './operation-types.js';
 export declare const getOperationQueryKey: <TInput, TData>(operation: ClientOperationLike<TInput, TData>, input: TInput) => QueryKey;
+export declare function useOperation<TInput, TData>(invocation: ClientOperationInvocation<TInput, TData>, options?: OperationHookOptions<TInput, TData>): BoundOperationHookResult<TInput, TData>;
 export declare function useOperation<TInput, TData>(operation: ClientSchemaOperationLike<TInput, TData>, initialInput: TInput, options?: OperationHookOptions<TInput, TData>): OperationInputHookResult<TInput, TData>;
 export declare function useOperation<TInput, TData>(operation: ClientSchemaOperationLike<TInput, TData>, options?: OperationHookOptions<TInput, TData>): OperationHookResult<TInput, TData>;
 export declare function useOperation<TInput, TData>(operation: ClientOperationLike<TInput, TData>, options?: OperationHookOptions<TInput, TData>): OperationHookResult<TInput, TData>;

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

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

package/dist/graph/operation-hooks.js

@@ -1,6 +1,7 @@
 'use client';
 import { normalizeGraphSchemaClientInput } from '@ontahi/core/data-graph';
 import { operationInputInvalid } from '@ontahi/core/runtime/contracts';
+import { hasOwn, isRecord } from '@ontahi/core/value/object';
 import { useInfiniteQuery, useQuery, useQueryClient, } from '@tanstack/react-query';
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import { operationBridgeErrored, resolveOperationBridgeInvalidationQueryKeys, resolveOperationBridgeQueryKey, toOperationInvocationResult, unwrapOperationInvocationValue, useAction, } from '../actions/index.js';
@@ -13,7 +14,7 @@ const operationHookOptionKeys = new Set([
     'onSettled',
     'invalidateOnSuccess',
 ]);
-const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const isOperationInvocation = (value) => isRecord(value) && hasOwn(value, 'kind') && value.kind === 'domain-operation-invocation';
 const readOperationInputFields = (input) => {
     if (!isRecord(input))
         return undefined;
@@ -31,19 +32,26 @@ const looksLikeOperationOptions = (operation, value) => {
     if (keys.length === 0)
         return false;
     const inputFields = readOperationInputFields(operation.input);
-    if (inputFields && keys.some(key => key in inputFields))
+    if (inputFields && keys.some(key => hasOwn(inputFields, key)))
         return false;
     return keys.some(key => operationHookOptionKeys.has(key));
 };
 const issuePath = (path) => Array.isArray(path) ? path.map(String).join('.') : path;
 export const getOperationQueryKey = (operation, input) => resolveOperationBridgeQueryKey(operation, input);
 const getOperationCacheAwareQueryKey = (clientCache, operation, input) => getOperationClientCacheKey(clientCache, operation, input, getOperationQueryKey(operation, input));
-export function useOperation(operation, initialInputOrOptions, managedOptions) {
-    const managesInput = managedOptions !== undefined || !looksLikeOperationOptions(operation, initialInputOrOptions);
+export function useOperation(operationOrInvocation, initialInputOrOptions, managedOptions) {
+    const invocation = isOperationInvocation(operationOrInvocation)
+        ? operationOrInvocation
+        : undefined;
+    const operation = (invocation?.operation ?? operationOrInvocation);
+    const managesInput = !invocation &&
+        (managedOptions !== undefined || !looksLikeOperationOptions(operation, initialInputOrOptions));
     const initialInput = managesInput ? initialInputOrOptions : undefined;
-    const options = managesInput
-        ? managedOptions
-        : initialInputOrOptions;
+    const options = invocation
+        ? initialInputOrOptions
+        : managesInput
+            ? managedOptions
+            : initialInputOrOptions;
     const adapter = useDefaultOperationBridgeAdapter();
     const clientCache = useGraphClientCache();
     const queryClient = useQueryClient();
@@ -113,6 +121,10 @@ export function useOperation(operation, initialInputOrOptions, managedOptions) {
     const execute = useCallback((...args) => {
         void executeAsync(...args);
     }, [executeAsync]);
+    const executeBoundAsync = useCallback(() => executeInputAsync(invocation?.input), [executeInputAsync, invocation?.input]);
+    const executeBound = useCallback(() => {
+        void executeBoundAsync();
+    }, [executeBoundAsync]);
     const reset = useCallback(() => {
         resetTransport();
         setResult(undefined);
@@ -188,9 +200,13 @@ export function useOperation(operation, initialInputOrOptions, managedOptions) {
                 ? 'hasErrored'
                 : 'hasSucceeded';
     const baseResult = {
-        execute: managesInput ? executeManaged : execute,
-        executeAsync: managesInput ? executeManagedAsync : executeAsync,
-        input: managesInput ? inputController : lastInput,
+        execute: invocation ? executeBound : managesInput ? executeManaged : execute,
+        executeAsync: invocation
+            ? executeBoundAsync
+            : managesInput
+                ? executeManagedAsync
+                : executeAsync,
+        input: invocation ? invocation.input : managesInput ? inputController : lastInput,
         result,
         value: result?.ok ? result.value : undefined,
         reset,
@@ -202,9 +218,11 @@ export function useOperation(operation, initialInputOrOptions, managedOptions) {
         hasSucceeded,
         hasErrored,
     };
-    return (managesInput
-        ? { ...baseResult, input: inputController, lastInput }
-        : baseResult);
+    return (invocation
+        ? baseResult
+        : managesInput
+            ? { ...baseResult, input: inputController, lastInput }
+            : baseResult);
 }
 export function useDurableOperation(operation, options) {
     const adapter = useDefaultOperationBridgeAdapter();