@astrale-os/kernel-client 0.6.0-beta.10 → 0.6.0-beta.12

package/dist/graph/expectation.d.ts

@@ -0,0 +1,3 @@
+import type { DomainDependency } from '@astrale-os/kernel-dsl/v1/schema';
+/** Detach one caller-owned expected closure before crossing the Client boundary. */
+export declare function captureExpected(input: readonly DomainDependency[] | undefined): readonly DomainDependency[] | undefined;

package/dist/graph/expectation.js

@@ -0,0 +1,6 @@
+/** Detach one caller-owned expected closure before crossing the Client boundary. */
+export function captureExpected(input) {
+    if (input === undefined)
+        return undefined;
+    return Object.freeze(input.map(({ origin, revision }) => Object.freeze({ origin, revision })));
+}

package/dist/graph/graph.d.ts

@@ -13,11 +13,14 @@ export interface GraphQueryOptions extends RequestOptions {
     readonly expected?: readonly DomainDependency[];
     readonly page: QueryPageRequest;
 }
+export interface GraphMutationOptions extends RequestOptions {
+    readonly expected?: readonly DomainDependency[];
+}
 export type MutationAuthor = (mutation: MutationBuilder) => undefined;
 export interface GraphApi {
     query<Query extends QueryASTValue>(ast: Query, options: GraphQueryOptions): Promise<QueryResponse<QueryResultFor<Query>>>;
-    mutate(author: MutationAuthor, options?: RequestOptions): Promise<MutationResultValue>;
-    mutate(ast: MutationASTValue | MutationInput | GraphSpec, options?: RequestOptions): Promise<MutationResultValue>;
+    mutate(author: MutationAuthor, options?: GraphMutationOptions): Promise<MutationResultValue>;
+    mutate(ast: MutationASTValue | MutationInput | GraphSpec, options?: GraphMutationOptions): Promise<MutationResultValue>;
     get(target: NodeTarget, options?: RequestOptions): Promise<Node | null>;
     getOrThrow(target: NodeTarget, options?: RequestOptions): Promise<Node>;
     neighbors(source: NodeTarget, via: QueryEdgeClassInput | readonly [QueryEdgeClassInput, ...QueryEdgeClassInput[]], options: NeighborsOptions): Promise<NodePage>;

package/dist/graph/index.d.ts

@@ -1,4 +1,4 @@
-export { createGraph, type GraphApi, type GraphCall, type GraphQueryOptions, type MutationAuthor, } from './graph.js';
+export { createGraph, type GraphApi, type GraphCall, type GraphMutationOptions, type GraphQueryOptions, type MutationAuthor, } from './graph.js';
 export type { QueryPageRequest, QueryResponse } from './page-contract.js';
 export { type BoundEdge, type BoundEdgePage, type BoundGraphValue, type BoundNode, type BoundNodeFor, type BoundNodePage, type BoundQueryPage, type DomainBinding, type DomainQueryOptions, } from './domain/index.js';
 export { NodeUnavailableError } from './errors.js';

package/dist/graph/mutation.d.ts

@@ -1,5 +1,4 @@
 import type { GraphSpec } from '@astrale-os/kernel-core/graph/graph';
 import type { MutationAST as MutationASTValue, MutationInput, MutationResult as MutationResultValue } from '@astrale-os/kernel-core/graph/mutate';
-import type { RequestOptions } from '../transport/index.js';
-import type { GraphCall, MutationAuthor } from './graph.js';
-export declare function mutateGraph(call: GraphCall, input: MutationAuthor | MutationASTValue | MutationInput | GraphSpec, options?: RequestOptions): Promise<MutationResultValue>;
+import type { GraphCall, GraphMutationOptions, MutationAuthor } from './graph.js';
+export declare function mutateGraph(call: GraphCall, input: MutationAuthor | MutationASTValue | MutationInput | GraphSpec, options?: GraphMutationOptions): Promise<MutationResultValue>;

package/dist/graph/mutation.js

@@ -2,10 +2,19 @@ import { MutationAST, MutationResult } from '@astrale-os/kernel-core/graph/mutat
 import { Path } from '@astrale-os/kernel-core/path';
 import { mutate } from '@astrale-os/kernel-core/schema/kernel/syscalls/references';
 import { call as invocation } from '../client/index.js';
+import { captureExpected } from './expectation.js';
 const KERNEL_MUTATE_PATH = Path.project(mutate).raw;
 export async function mutateGraph(call, input, options) {
     const ast = typeof input === 'function' ? MutationAST.build(input) : admitMutation(input);
-    const output = await call(invocation(KERNEL_MUTATE_PATH, ast), options);
+    const expected = options?.expected;
+    const request = options === undefined
+        ? undefined
+        : (({ expected: _expected, ...rest }) => rest)(options);
+    const capturedExpected = captureExpected(expected);
+    const output = await call(invocation(KERNEL_MUTATE_PATH, Object.freeze({
+        ast,
+        ...(capturedExpected === undefined ? {} : { expected: capturedExpected }),
+    })), request);
     return MutationResult.decode(output);
 }
 function admitMutation(input) {

package/dist/graph/query.js

@@ -2,6 +2,7 @@ import { QueryAST, QueryResult } from '@astrale-os/kernel-core/graph/query';
 import { Path } from '@astrale-os/kernel-core/path';
 import { query } from '@astrale-os/kernel-core/schema/kernel/syscalls/references';
 import { call as invocation } from '../client/index.js';
+import { captureExpected } from './expectation.js';
 import { retainQueryProvenance } from './provenance.js';
 const KERNEL_QUERY_PATH = Path.project(query).raw;
 export async function queryGraph(call, input, options) {
@@ -19,11 +20,6 @@ export async function queryGraph(call, input, options) {
         ? response
         : retainQueryProvenance(response, capturedExpected);
 }
-function captureExpected(input) {
-    if (input === undefined)
-        return undefined;
-    return Object.freeze(input.map(({ origin, revision }) => Object.freeze({ origin, revision })));
-}
 function admitPage(input) {
     if (input === null || typeof input !== 'object' || Array.isArray(input)) {
         throw new TypeError('Graph query page is invalid.');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrale-os/kernel-client",
-  "version": "0.6.0-beta.10",
+  "version": "0.6.0-beta.12",
   "description": "Universal Client — protocol-first, transport-agnostic",
   "keywords": [
     "astrale",
@@ -65,14 +65,14 @@
     "access": "public"
   },
   "dependencies": {
-    "@astrale-os/kernel-core": ">=0.9.0-beta.9 <1.0.0",
-    "@astrale-os/kernel-dsl": ">=0.2.0-beta.7 <1.0.0",
-    "@astrale-os/kernel-protocol": ">=0.5.0-beta.9 <1.0.0",
+    "@astrale-os/kernel-core": ">=0.9.0-beta.10 <1.0.0",
+    "@astrale-os/kernel-dsl": ">=0.2.0-beta.8 <1.0.0",
+    "@astrale-os/kernel-protocol": ">=0.5.0-beta.10 <1.0.0",
     "@tanstack/pacer": "0.20.1",
     "msgpackr": "^2.0.5"
   },
   "devDependencies": {
-    "@astrale-os/kernel-server": ">=0.5.0-beta.10 <1.0.0",
+    "@astrale-os/kernel-server": ">=0.5.0-beta.11 <1.0.0",
     "@astrale/typescript-config": "npm:@jsr/astrale__typescript-config@~1.1.0",
     "@types/node": "^22.0.0",
     "typescript": "7.0.2",