@ontahi/react 1.0.0-alpha.8 → 1.0.0-alpha.9

package/dist/graph/executor.js.map

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

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

@@ -1,16 +1,21 @@
-import type { ReflectedEntityDataReader, ReflectedOperationInvoker, RemoteDataGraphError, RuntimeBoundDataGraphApi } from '@ontahi/core/data-graph';
+import type { ReflectedEntityDataReader, ReflectedRelatedEntityDataReader, ReflectedOperationInvoker, RemoteDataGraphError, RuntimeBoundDataGraphApi } from '@ontahi/core/data-graph';
+import type { RuntimeTransport } from '@ontahi/core/runtime/protocol';
 import { type AnyOperationBridgeAdapter, type FetchOperationBridgeOptions } from '../actions/index.js';
 import type { ReactGraphExecutor } from './executor.js';
 import type { FetchGraphReadExecutorOptions } from './fetch-graph-read-executor.js';
+import { type FetchRuntimeTransportOptions } from './fetch-runtime-transport.js';
 export type FetchReflectedEntityDataReaderOptions = {
     endpoint?: string;
     fetch?: typeof globalThis.fetch;
 };
+export type FetchReflectedRelatedEntityDataReaderOptions = FetchReflectedEntityDataReaderOptions;
 export type OntahiGraphClient<TReadOptions = unknown, TCommandOptions = TReadOptions> = {
     graph?: RuntimeBoundDataGraphApi<RemoteDataGraphError, TReadOptions, TCommandOptions, RemoteDataGraphError>;
     graphExecutor?: ReactGraphExecutor<TReadOptions, TCommandOptions>;
+    runtimeTransport?: RuntimeTransport;
     operationBridgeAdapters?: AnyOperationBridgeAdapter[];
     reflectedEntityDataReader?: ReflectedEntityDataReader;
+    reflectedRelatedEntityDataReader?: ReflectedRelatedEntityDataReader;
     reflectedOperationInvoker?: ReflectedOperationInvoker;
 };
 export type FetchGraphClient<TOptions = undefined> = OntahiGraphClient<TOptions, TOptions> & {
@@ -20,9 +25,12 @@ export type FetchGraphClient<TOptions = undefined> = OntahiGraphClient<TOptions,
 export type FetchGraphClientOptions<TOptions = undefined> = {
     graphRead?: false | FetchGraphReadExecutorOptions<TOptions>;
     operations?: false | FetchOperationBridgeOptions;
+    runtimeTransport?: false | FetchRuntimeTransportOptions;
     reflectedEntityData?: false | FetchReflectedEntityDataReaderOptions;
+    reflectedRelatedEntityData?: false | FetchReflectedRelatedEntityDataReaderOptions;
 };
 export declare const createFetchReflectedEntityDataReader: ({ endpoint, fetch: fetchRequest, }?: FetchReflectedEntityDataReaderOptions) => ReflectedEntityDataReader;
+export declare const createFetchReflectedRelatedEntityDataReader: ({ endpoint, fetch: fetchRequest, }?: FetchReflectedRelatedEntityDataReaderOptions) => ReflectedRelatedEntityDataReader;
 export declare function createFetchGraphClient<TOptions = undefined>(): FetchGraphClient<TOptions>;
 export declare function createFetchGraphClient<TOptions = undefined>(options: FetchGraphClientOptions<TOptions> & {
     graphRead: false;

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

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

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

@@ -2,31 +2,35 @@
 import { createRuntimeBoundDataGraphApi } from '@ontahi/core/data-graph';
 import { createFetchOperationBridgeAdapter, createFetchReflectedOperationInvoker, } from '../actions/index.js';
 import { createFetchGraphReadCapability } from './fetch-graph-runtime.js';
+import { createFetchRuntimeTransport, } from './fetch-runtime-transport.js';
 const DEFAULT_OPERATIONS_ENDPOINT = '/operations';
-const DEFAULT_TASKS_ENDPOINT = '/operations/tasks';
 const DEFAULT_REFLECTED_ENTITY_DATA_ENDPOINT = '/explorer/entities';
+const DEFAULT_REFLECTED_RELATED_ENTITY_DATA_ENDPOINT = '/explorer/related-entities';
+const postReflectedEntityDataQuery = async (endpoint, query, fetchRequest) => {
+    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();
+};
 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();
-    },
+    readEntityData: query => postReflectedEntityDataQuery(endpoint, query, fetchRequest),
+});
+export const createFetchReflectedRelatedEntityDataReader = ({ endpoint = DEFAULT_REFLECTED_RELATED_ENTITY_DATA_ENDPOINT, fetch: fetchRequest = globalThis.fetch, } = {}) => ({
+    readRelatedEntityData: query => postReflectedEntityDataQuery(endpoint, query, fetchRequest),
 });
-export function createFetchGraphClient({ graphRead = {}, operations = {}, reflectedEntityData = {}, } = {}) {
+export function createFetchGraphClient({ graphRead = {}, operations = {}, runtimeTransport = {}, reflectedEntityData = {}, reflectedRelatedEntityData = {}, } = {}) {
     const operationOptions = operations === false ? undefined : conventionalOperationOptions(operations);
     const graphReadCapability = graphRead === false ? undefined : createFetchGraphReadCapability(graphRead);
     return {
@@ -36,6 +40,9 @@ export function createFetchGraphClient({ graphRead = {}, operations = {}, reflec
                 graphExecutor: graphReadCapability.graphExecutor,
             }
             : {}),
+        ...(runtimeTransport === false
+            ? {}
+            : { runtimeTransport: createFetchRuntimeTransport(runtimeTransport) }),
         ...(operationOptions
             ? {
                 operationBridgeAdapters: [createFetchOperationBridgeAdapter(operationOptions)],
@@ -45,6 +52,11 @@ export function createFetchGraphClient({ graphRead = {}, operations = {}, reflec
         ...(reflectedEntityData === false
             ? {}
             : { reflectedEntityDataReader: createFetchReflectedEntityDataReader(reflectedEntityData) }),
+        ...(reflectedRelatedEntityData === false
+            ? {}
+            : {
+                reflectedRelatedEntityDataReader: createFetchReflectedRelatedEntityDataReader(reflectedRelatedEntityData),
+            }),
     };
 }
 //# sourceMappingURL=fetch-graph-client.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"fetch-graph-client.js","sourceRoot":"","sources":["../../src/graph/fetch-graph-client.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;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"]}
+{"version":3,"file":"fetch-graph-client.js","sourceRoot":"","sources":["../../src/graph/fetch-graph-client.ts"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport type {\n  ReflectedEntityDataReader,\n  ReflectedEntityDataResult,\n  ReflectedRelatedEntityDataReader,\n  ReflectedRelatedEntityDataQuery,\n  ReflectedOperationInvoker,\n  RemoteDataGraphError,\n  RuntimeBoundDataGraphApi,\n} from '@ontahi/core/data-graph';\nimport { createRuntimeBoundDataGraphApi } from '@ontahi/core/data-graph';\nimport type { RuntimeTransport } from '@ontahi/core/runtime/protocol';\n\nimport {\n  createFetchOperationBridgeAdapter,\n  createFetchReflectedOperationInvoker,\n  type AnyOperationBridgeAdapter,\n  type FetchOperationBridgeOptions,\n} from '../actions/index.js';\n\nimport type { ReactGraphExecutor } from './executor.js';\nimport type { FetchGraphReadExecutorOptions } from './fetch-graph-read-executor.js';\nimport { createFetchGraphReadCapability } from './fetch-graph-runtime.js';\nimport {\n  createFetchRuntimeTransport,\n  type FetchRuntimeTransportOptions,\n} from './fetch-runtime-transport.js';\n\nexport type FetchReflectedEntityDataReaderOptions = {\n  endpoint?: string;\n  fetch?: typeof globalThis.fetch;\n};\n\nexport type FetchReflectedRelatedEntityDataReaderOptions = FetchReflectedEntityDataReaderOptions;\n\nexport type OntahiGraphClient<TReadOptions = unknown, TCommandOptions = TReadOptions> = {\n  graph?: RuntimeBoundDataGraphApi<\n    RemoteDataGraphError,\n    TReadOptions,\n    TCommandOptions,\n    RemoteDataGraphError\n  >;\n  graphExecutor?: ReactGraphExecutor<TReadOptions, TCommandOptions>;\n  runtimeTransport?: RuntimeTransport;\n  operationBridgeAdapters?: AnyOperationBridgeAdapter[];\n  reflectedEntityDataReader?: ReflectedEntityDataReader;\n  reflectedRelatedEntityDataReader?: ReflectedRelatedEntityDataReader;\n  reflectedOperationInvoker?: ReflectedOperationInvoker;\n};\n\nexport type FetchGraphClient<TOptions = undefined> = OntahiGraphClient<TOptions, TOptions> & {\n  graph: RuntimeBoundDataGraphApi<RemoteDataGraphError, TOptions, TOptions, RemoteDataGraphError>;\n  graphExecutor: ReactGraphExecutor<TOptions, TOptions>;\n};\n\nexport type FetchGraphClientOptions<TOptions = undefined> = {\n  graphRead?: false | FetchGraphReadExecutorOptions<TOptions>;\n  operations?: false | FetchOperationBridgeOptions;\n  runtimeTransport?: false | FetchRuntimeTransportOptions;\n  reflectedEntityData?: false | FetchReflectedEntityDataReaderOptions;\n  reflectedRelatedEntityData?: false | FetchReflectedRelatedEntityDataReaderOptions;\n};\n\nconst DEFAULT_OPERATIONS_ENDPOINT = '/operations';\nconst DEFAULT_REFLECTED_ENTITY_DATA_ENDPOINT = '/explorer/entities';\nconst DEFAULT_REFLECTED_RELATED_ENTITY_DATA_ENDPOINT = '/explorer/related-entities';\n\nconst postReflectedEntityDataQuery = async (\n  endpoint: string,\n  query:\n    | ReflectedRelatedEntityDataQuery\n    | Parameters<ReflectedEntityDataReader['readEntityData']>[0],\n  fetchRequest: typeof globalThis.fetch,\n) => {\n  const response = await fetchRequest(endpoint, {\n    method: 'POST',\n    headers: { 'content-type': 'application/json' },\n    credentials: 'same-origin',\n    body: JSON.stringify(query),\n  });\n\n  if (!response.ok) {\n    throw new Error(`Reflected entity data request failed with status ${response.status}.`);\n  }\n\n  return response.json() as Promise<ReflectedEntityDataResult>;\n};\n\nconst conventionalOperationOptions = (\n  options: FetchOperationBridgeOptions,\n): FetchOperationBridgeOptions =>\n  options.mountPath === undefined\n    ? {\n        endpoint: DEFAULT_OPERATIONS_ENDPOINT,\n        ...options,\n      }\n    : options;\n\nexport const createFetchReflectedEntityDataReader = ({\n  endpoint = DEFAULT_REFLECTED_ENTITY_DATA_ENDPOINT,\n  fetch: fetchRequest = globalThis.fetch,\n}: FetchReflectedEntityDataReaderOptions = {}): ReflectedEntityDataReader => ({\n  readEntityData: query => postReflectedEntityDataQuery(endpoint, query, fetchRequest),\n});\n\nexport const createFetchReflectedRelatedEntityDataReader = ({\n  endpoint = DEFAULT_REFLECTED_RELATED_ENTITY_DATA_ENDPOINT,\n  fetch: fetchRequest = globalThis.fetch,\n}: FetchReflectedRelatedEntityDataReaderOptions = {}): ReflectedRelatedEntityDataReader => ({\n  readRelatedEntityData: query => postReflectedEntityDataQuery(endpoint, query, fetchRequest),\n});\n\nexport function createFetchGraphClient<TOptions = undefined>(): FetchGraphClient<TOptions>;\nexport function createFetchGraphClient<TOptions = undefined>(\n  options: FetchGraphClientOptions<TOptions> & { graphRead: false },\n): OntahiGraphClient<TOptions, TOptions>;\nexport function createFetchGraphClient<TOptions = undefined>(\n  options: FetchGraphClientOptions<TOptions> & {\n    graphRead?: FetchGraphReadExecutorOptions<TOptions>;\n  },\n): FetchGraphClient<TOptions>;\nexport function createFetchGraphClient<TOptions = undefined>({\n  graphRead = {},\n  operations = {},\n  runtimeTransport = {},\n  reflectedEntityData = {},\n  reflectedRelatedEntityData = {},\n}: FetchGraphClientOptions<TOptions> = {}): OntahiGraphClient<TOptions, TOptions> {\n  const operationOptions =\n    operations === false ? undefined : conventionalOperationOptions(operations);\n  const graphReadCapability =\n    graphRead === false ? undefined : createFetchGraphReadCapability(graphRead);\n\n  return {\n    ...(graphReadCapability\n      ? {\n          graph: createRuntimeBoundDataGraphApi(() => graphReadCapability.runtime),\n          graphExecutor: graphReadCapability.graphExecutor,\n        }\n      : {}),\n    ...(runtimeTransport === false\n      ? {}\n      : { runtimeTransport: createFetchRuntimeTransport(runtimeTransport) }),\n    ...(operationOptions\n      ? {\n          operationBridgeAdapters: [createFetchOperationBridgeAdapter(operationOptions)],\n          reflectedOperationInvoker: createFetchReflectedOperationInvoker(operationOptions),\n        }\n      : {}),\n    ...(reflectedEntityData === false\n      ? {}\n      : { reflectedEntityDataReader: createFetchReflectedEntityDataReader(reflectedEntityData) }),\n    ...(reflectedRelatedEntityData === false\n      ? {}\n      : {\n          reflectedRelatedEntityDataReader: createFetchReflectedRelatedEntityDataReader(\n            reflectedRelatedEntityData,\n          ),\n        }),\n  };\n}\n"]}

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

@@ -1,4 +1,4 @@
-import { type DataGraphExecutionRuntime, type RemoteDataGraphError, type ManyToManyRelationshipCommandExecutionRuntime, type RelationshipCommandExecutionRuntime } from '@ontahi/core/data-graph';
+import { type DataGraphExecutionRuntime, type EntityMutationCommandExecutionRuntime, type RemoteDataGraphError, type ManyToManyRelationshipCommandExecutionRuntime, type RelationshipCommandExecutionRuntime } from '@ontahi/core/data-graph';
 import type { ReactGraphExecutor } from './executor.js';
 export type FetchGraphReadExecutorOptions<TOptions = undefined> = {
     endpoint?: string;
@@ -8,8 +8,9 @@ export type FetchGraphReadExecutorOptions<TOptions = undefined> = {
 };
 export type FetchGraphRuntime<TOptions = undefined> = DataGraphExecutionRuntime<RemoteDataGraphError, TOptions, TOptions, RemoteDataGraphError>;
 export type FetchRelationshipRuntime<TOptions = undefined> = RelationshipCommandExecutionRuntime<RemoteDataGraphError, TOptions> & ManyToManyRelationshipCommandExecutionRuntime<RemoteDataGraphError, TOptions>;
+export type FetchEntityMutationRuntime<TOptions = undefined> = EntityMutationCommandExecutionRuntime<RemoteDataGraphError, TOptions>;
 export type FetchGraphReadCapability<TOptions = undefined> = {
-    runtime: FetchGraphRuntime<TOptions> & FetchRelationshipRuntime<TOptions>;
+    runtime: FetchGraphRuntime<TOptions> & FetchRelationshipRuntime<TOptions> & FetchEntityMutationRuntime<TOptions>;
     graphExecutor: ReactGraphExecutor<TOptions, TOptions>;
 };
 export declare const createFetchGraphReadCapability: <TOptions = undefined>({ endpoint, commandEndpoint, fetch: fetchRequest, requestInit, }?: FetchGraphReadExecutorOptions<TOptions>) => FetchGraphReadCapability<TOptions>;

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

@@ -1 +1 @@
-{"version":3,"file":"fetch-graph-runtime.d.ts","sourceRoot":"","sources":["../../src/graph/fetch-graph-runtime.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,yBAAyB,EAC9B,KAAK,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,CA4DlF,CAAC"}
+{"version":3,"file":"fetch-graph-runtime.d.ts","sourceRoot":"","sources":["../../src/graph/fetch-graph-runtime.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,yBAAyB,EAC9B,KAAK,qCAAqC,EAC1C,KAAK,oBAAoB,EAGzB,KAAK,6CAA6C,EAClD,KAAK,mCAAmC,EACzC,MAAM,yBAAyB,CAAC;AAGjC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExD,MAAM,MAAM,6BAA6B,CAAC,QAAQ,GAAG,SAAS,IAAI;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,WAAW,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,QAAQ,KAAK,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC;CAC5E,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAAC,QAAQ,GAAG,SAAS,IAAI,yBAAyB,CAC7E,oBAAoB,EACpB,QAAQ,EACR,QAAQ,EACR,oBAAoB,CACrB,CAAC;AACF,MAAM,MAAM,wBAAwB,CAAC,QAAQ,GAAG,SAAS,IAAI,mCAAmC,CAC9F,oBAAoB,EACpB,QAAQ,CACT,GACC,6CAA6C,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;AAChF,MAAM,MAAM,0BAA0B,CAAC,QAAQ,GAAG,SAAS,IACzD,qCAAqC,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;AAExE,MAAM,MAAM,wBAAwB,CAAC,QAAQ,GAAG,SAAS,IAAI;IAC3D,OAAO,EAAE,iBAAiB,CAAC,QAAQ,CAAC,GAClC,wBAAwB,CAAC,QAAQ,CAAC,GAClC,0BAA0B,CAAC,QAAQ,CAAC,CAAC;IACvC,aAAa,EAAE,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;CACvD,CAAC;AAKF,eAAO,MAAM,8BAA8B,GAAI,QAAQ,GAAG,SAAS,EAAE,mEAKlE,6BAA6B,CAAC,QAAQ,CAAM,KAAG,wBAAwB,CAAC,QAAQ,CA8DlF,CAAC"}

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

@@ -57,6 +57,7 @@ export const createFetchGraphReadCapability = ({ endpoint = DEFAULT_GRAPH_READ_E
             runCommand: (command, options) => runBrowserEffect(runtime.runCommand(command, options)),
             runRelationshipCommand: (command, options) => runBrowserEffect(runtime.runRelationshipCommand(command, options)),
             runManyToManyRelationshipCommand: (command, options) => runBrowserEffect(runtime.runManyToManyRelationshipCommand(command, options)),
+            runEntityMutationCommand: (command, options) => runBrowserEffect(runtime.runEntityMutationCommand(command, options)),
         },
     };
 };

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

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

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

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

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

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

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

@@ -0,0 +1,89 @@
+'use client';
+import { createRuntimeProtocolRequest, isRuntimeProtocolError, parseDurableOperationProtocolResponse, parseRuntimeProtocolResponse, toDurableOperationProtocolRequest, } from '@ontahi/core/runtime/protocol';
+const DEFAULT_RUNTIME_ENDPOINT = '/runtime';
+const DEFAULT_POLL_INTERVAL_MS = 500;
+const terminalTaskStatuses = new Set(['completed', 'failed', 'cancelled']);
+let fallbackRequestSequence = 0;
+const defaultRequestId = () => globalThis.crypto?.randomUUID?.() ??
+    `ontahi-runtime-${Date.now()}-${(fallbackRequestSequence += 1)}`;
+const waitForNextInspection = (intervalMs, signal) => {
+    if (signal?.aborted)
+        return Promise.resolve(false);
+    if (intervalMs === 0)
+        return Promise.resolve(true);
+    return new Promise(resolve => {
+        let settled = false;
+        const finish = (shouldContinue) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timeout);
+            signal?.removeEventListener('abort', abort);
+            resolve(shouldContinue);
+        };
+        const abort = () => finish(false);
+        const timeout = setTimeout(() => finish(true), intervalMs);
+        signal?.addEventListener('abort', abort, { once: true });
+    });
+};
+export const createFetchRuntimeTransport = ({ endpoint = DEFAULT_RUNTIME_ENDPOINT, fetch: fetchRequest = globalThis.fetch, requestId = defaultRequestId, requestInit, durableOperation = {}, } = {}) => {
+    const pollIntervalMs = durableOperation.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+    if (!Number.isFinite(pollIntervalMs) || pollIntervalMs < 0) {
+        throw new TypeError('Durable Operation poll interval must be a non-negative finite number.');
+    }
+    const request = async (runtimeRequest, options) => {
+        const init = requestInit?.() ?? {};
+        const 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(runtimeRequest),
+            ...(options?.signal ? { signal: options.signal } : {}),
+        });
+        const payload = await response.json().catch(() => null);
+        const parsed = parseRuntimeProtocolResponse(payload, runtimeRequest);
+        if (!parsed.success)
+            throw new Error(parsed.error.error.message);
+        if (!response.ok && !isRuntimeProtocolError(parsed.response)) {
+            throw new Error(`Runtime Protocol request failed with status ${response.status}.`);
+        }
+        return parsed.response;
+    };
+    const observe = async function* (run, options) {
+        while (!options?.signal?.aborted) {
+            const runtimeRequest = createRuntimeProtocolRequest({
+                id: requestId(),
+                family: 'durable.operation',
+                body: toDurableOperationProtocolRequest(run),
+            });
+            const runtimeResponse = await request(runtimeRequest, options);
+            if (isRuntimeProtocolError(runtimeResponse)) {
+                throw new Error(runtimeResponse.error.message);
+            }
+            const parsed = parseDurableOperationProtocolResponse(runtimeResponse.body);
+            if (!parsed.success)
+                throw new Error(parsed.error.error.message);
+            if (parsed.response.kind === 'protocol-error') {
+                throw new Error(parsed.response.error.message);
+            }
+            const snapshot = parsed.response.snapshot;
+            if (snapshot.taskId !== run.taskId || snapshot.runId !== run.runId) {
+                throw new Error('Durable Operation snapshot identity does not match the observed run.');
+            }
+            yield snapshot;
+            if (terminalTaskStatuses.has(snapshot.status))
+                return;
+            if (!(await waitForNextInspection(pollIntervalMs, options?.signal)))
+                return;
+        }
+    };
+    return {
+        request,
+        durableOperation: { observe },
+    };
+};
+//# sourceMappingURL=fetch-runtime-transport.js.map

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

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

package/dist/graph/index.d.ts

@@ -1,6 +1,7 @@
 export * from './context.js';
 export * from './executor.js';
 export * from './fetch-graph-read-executor.js';
+export * from './fetch-runtime-transport.js';
 export * from './fetch-graph-client.js';
 export * from './graph-hooks.js';
 export * from './operation-cache.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,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"}
+{"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,8BAA8B,CAAC;AAC7C,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

@@ -2,6 +2,7 @@
 export * from './context.js';
 export * from './executor.js';
 export * from './fetch-graph-read-executor.js';
+export * from './fetch-runtime-transport.js';
 export * from './fetch-graph-client.js';
 export * from './graph-hooks.js';
 export * from './operation-cache.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,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"]}
+{"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,8BAA8B,CAAC;AAC7C,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-runtime-transport.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.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

@@ -5,7 +5,7 @@ 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';
-import { useDefaultOperationBridgeAdapter, useGraphClientCache, useGraphClientCacheVersion, useReflectedOperationInvoker, } from './context.js';
+import { useDefaultOperationBridgeAdapter, useGraphClientCache, useGraphClientCacheVersion, useReflectedOperationInvoker, useRuntimeTransportCapability, } from './context.js';
 import { getOperationClientCacheKey, invalidateOperationCacheRefs, invalidateReactQueryCachesContainingRefs, readInitialOperationCacheValueFromCache, reconcileOperationOutput, } from './operation-cache.js';
 const operationHookOptionKeys = new Set([
     'onExecute',
@@ -225,28 +225,45 @@ export function useOperation(operationOrInvocation, initialInputOrOptions, manag
             : baseResult);
 }
 export function useDurableOperation(operation, options) {
-    const adapter = useDefaultOperationBridgeAdapter();
+    const runtimeTransport = useRuntimeTransportCapability();
+    const observer = runtimeTransport?.durableOperation;
     const queryClient = useQueryClient();
     const mutation = useOperation(operation, { ...options, invalidateOnSuccess: false });
     const runRef = mutation.value;
-    const snapshotQuery = useQuery({
-        queryKey: ['ontahi-task-run', runRef?.taskId, runRef?.runId],
-        enabled: Boolean(runRef && adapter.getTaskSnapshot),
-        queryFn: () => {
-            if (!runRef || !adapter.getTaskSnapshot) {
-                throw new Error('The operation bridge does not provide task snapshot transport.');
-            }
-            return adapter.getTaskSnapshot({ taskId: runRef.taskId, runId: runRef.runId });
-        },
-        refetchInterval: query => {
-            const status = query.state.data?.status;
-            return status === 'completed' || status === 'failed' || status === 'cancelled'
-                ? false
-                : (options?.pollIntervalMs ?? 500);
-        },
-    });
-    const snapshot = snapshotQuery.data;
+    const runKey = runRef ? `${runRef.taskId}:${runRef.runId}` : undefined;
+    const [observation, setObservation] = useState({ runKey: undefined, snapshot: undefined, active: false });
+    const currentObservation = observation.runKey === runKey ? observation : undefined;
+    const snapshot = currentObservation?.snapshot;
     const invalidatedRunRef = useRef(undefined);
+    useEffect(() => {
+        if (!runRef || !runKey || !observer)
+            return;
+        const controller = new AbortController();
+        let active = true;
+        setObservation({ runKey, snapshot: undefined, active: true });
+        void (async () => {
+            try {
+                for await (const nextSnapshot of observer.observe({ taskId: runRef.taskId, runId: runRef.runId }, { signal: controller.signal })) {
+                    if (!active)
+                        return;
+                    setObservation({ runKey, snapshot: nextSnapshot, active: true });
+                }
+            }
+            catch {
+                if (!controller.signal.aborted && active) {
+                    setObservation(current => current.runKey === runKey ? { ...current, active: false } : current);
+                }
+                return;
+            }
+            if (active) {
+                setObservation(current => current.runKey === runKey ? { ...current, active: false } : current);
+            }
+        })();
+        return () => {
+            active = false;
+            controller.abort();
+        };
+    }, [observer, runKey, runRef]);
     useEffect(() => {
         if (!snapshot ||
             (snapshot.status !== 'completed' &&
@@ -267,6 +284,7 @@ export function useDurableOperation(operation, options) {
     }, [mutation.input, operation, options?.invalidateOnSuccess, queryClient, snapshot]);
     const reset = useCallback(() => {
         mutation.reset();
+        setObservation({ runKey: undefined, snapshot: undefined, active: false });
         invalidatedRunRef.current = undefined;
     }, [mutation]);
     const runStatus = snapshot?.status ?? runRef?.status;
@@ -283,9 +301,11 @@ export function useDurableOperation(operation, options) {
         isCompleted: runStatus === 'completed',
         isFailed: runStatus === 'failed',
         isCancelled: runStatus === 'cancelled',
-        isRefreshingRun: snapshotQuery.isFetching,
+        isRefreshingRun: currentObservation?.active ?? false,
         isExecuting: mutation.isExecuting ||
-            (Boolean(adapter.getTaskSnapshot) && (runStatus === 'queued' || runStatus === 'running')),
+            (Boolean(observer) &&
+                currentObservation?.active !== false &&
+                (runStatus === 'queued' || runStatus === 'running')),
     };
 }
 export function useOperationQuery(operation, inputOrOptions, providedOptions) {