@astrale-os/kernel-client 0.6.0-beta.47 → 0.6.0-beta.49

package/dist/graph/domain/domain.typecheck.js

@@ -78,6 +78,13 @@ void methodlessParentAcceptsChild;
 const documentRejectsResource = resourceProjection;
 void documentRejectsResource;
 async function typeProof() {
+    await graph.get(definitionRef);
+    await graph.getOrThrow(definitionRef);
+    await graph.get(Work.classes.Resource.ref);
+    await graph.neighbors(definitionRef, Work.classes.Related.ref, {
+        direction: 'outgoing',
+        page: { size: 1 },
+    });
     const page = await binding.query(query, { page: { size: 10 } });
     const resource = page.nodes[0];
     const title = resource.title;

package/dist/graph/errors.js

@@ -1,4 +1,3 @@
-import { isNodeId } from '@astrale-os/kernel-core/graph/node';
 import { Path } from '@astrale-os/kernel-core/path';
 import { ClientError } from '../errors/index.js';
 /** Required point read whose absence and authorization masking are intentionally indistinguishable. */
@@ -6,7 +5,7 @@ export class NodeUnavailableError extends ClientError {
     code = 'NODE_UNAVAILABLE';
     path;
     constructor(path) {
-        const admitted = isNodeId(path) ? Path.id(path).raw : Path.from(path).raw;
+        const admitted = Path.target(path).raw;
         super(`Node ${JSON.stringify(admitted)} is unavailable.`);
         this.name = 'NodeUnavailableError';
         this.path = admitted;

package/dist/graph/page/neighbors.js

@@ -1,4 +1,5 @@
 import { Query } from '@astrale-os/kernel-core/graph/query';
+import { queryNodePath } from '../query.js';
 import { createNodePage } from './page.js';
 export async function readNeighbors(query, source, via, options) {
     if (options === null || typeof options !== 'object') {
@@ -15,7 +16,7 @@ export async function readNeighbors(query, source, via, options) {
             : options.direction === 'incident'
                 ? options.direction
                 : invalidDirection(options.direction);
-    const ast = Query.from({ nodes: [source] })
+    const ast = Query.from({ nodes: [queryNodePath(source)] })
         .expand({ via: [classInput, ...additionalClasses], direction })
         .select({ kind: 'graph' });
     const { direction: _, page, ...request } = options;

package/dist/graph/query.d.ts

@@ -1,4 +1,7 @@
 import type { QueryAST as QueryASTValue, QueryResultFor } from '@astrale-os/kernel-core/graph/query';
+import { Path, type NodeTarget } from '@astrale-os/kernel-core/path';
 import type { GraphCall, GraphQueryOptions } from './graph.js';
 import type { QueryResponse } from './page-contract.js';
+/** Point/neighbor reads are exact targets, unlike Query's overloaded Class sources. */
+export declare function queryNodePath(target: NodeTarget): Path;
 export declare function queryGraph<Query extends QueryASTValue>(call: GraphCall, input: Query, options: GraphQueryOptions): Promise<QueryResponse<QueryResultFor<Query>>>;

package/dist/graph/query.js

@@ -1,10 +1,22 @@
-import { QueryAST, QueryResult } from '@astrale-os/kernel-core/graph/query';
-import { Path } from '@astrale-os/kernel-core/path';
+import { QueryAST, QueryASTDecodeError, QueryResult } from '@astrale-os/kernel-core/graph/query';
+import { Path, PathError } 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;
+/** Point/neighbor reads are exact targets, unlike Query's overloaded Class sources. */
+export function queryNodePath(target) {
+    try {
+        return Path.target(target);
+    }
+    catch (cause) {
+        // Preserve the graph-read Query error contract; do not relabel unexpected defects.
+        if (!(cause instanceof PathError))
+            throw cause;
+        throw new QueryASTDecodeError('/source/nodes/0', 'Invalid Node target', { cause });
+    }
+}
 export async function queryGraph(call, input, options) {
     const ast = QueryAST.decode(input);
     const { expected, page, ...request } = options;

package/dist/graph/read.js

@@ -1,8 +1,8 @@
 import { Query } from '@astrale-os/kernel-core/graph/query';
 import { NodeUnavailableError } from './errors.js';
-import { queryGraph } from './query.js';
+import { queryGraph, queryNodePath } from './query.js';
 export async function getNode(call, path, options) {
-    const ast = Query.from({ nodes: [path] }).select({ kind: 'graph' });
+    const ast = Query.from({ nodes: [queryNodePath(path)] }).select({ kind: 'graph' });
     const response = await queryGraph(call, ast, { ...options, page: { size: 1 } });
     const { result } = response;
     if (result.kind !== 'graph')
@@ -10,8 +10,10 @@ export async function getNode(call, path, options) {
     return result.graph.nodes[0] ?? null;
 }
 export async function requireNode(call, path, options) {
-    const node = await getNode(call, path, options);
+    // Retain one immutable target across I/O, including unavailable-error rendering.
+    const target = queryNodePath(path);
+    const node = await getNode(call, target, options);
     if (node === null)
-        throw new NodeUnavailableError(path);
+        throw new NodeUnavailableError(target);
     return node;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrale-os/kernel-client",
-  "version": "0.6.0-beta.47",
+  "version": "0.6.0-beta.49",
   "description": "Universal Client — protocol-first, transport-agnostic",
   "keywords": [
     "astrale",
@@ -65,14 +65,14 @@
     "access": "public"
   },
   "dependencies": {
-    "@astrale-os/kernel-core": "0.9.0-beta.35",
-    "@astrale-os/kernel-dsl": "0.2.0-beta.26",
-    "@astrale-os/kernel-protocol": "0.5.0-beta.38",
+    "@astrale-os/kernel-core": "0.9.0-beta.37",
+    "@astrale-os/kernel-dsl": "0.2.0-beta.28",
+    "@astrale-os/kernel-protocol": "0.5.0-beta.40",
     "@tanstack/pacer": "0.20.1",
     "msgpackr": "^2.0.5"
   },
   "devDependencies": {
-    "@astrale-os/kernel-server": "0.5.0-beta.40",
+    "@astrale-os/kernel-server": "0.5.0-beta.42",
     "@astrale/typescript-config": "npm:@jsr/astrale__typescript-config@~1.1.0",
     "@types/node": "^22.0.0",
     "typescript": "7.0.2",