@astrale-os/kernel-client 0.5.1 → 0.6.0-beta.2

package/dist/errors/index.js

@@ -1,4 +1,7 @@
-export { AuthBatchError, AuthenticationError, ConnectionError, DisconnectedError, InternalKernelError, InvalidTransportError, InvalidRequestError, InvariantViolationError, KernelError, NodeUnavailableError, NotFoundError, ParseError, PermissionDeniedError, TimeoutError, UnsupportedTransportError, ValidationError, WebOSError, mapServerError, withDetails, } from './errors.js';
-export { classifyKernelError, isAuthBatchError, isAuthenticationError, isClientSessionError, isDelegationMintError, isDelegationPolicyError, isDelegationRefusedError, isHopLimitExceededError, isIdentityError, isInternalKernelError, isInvalidRequestError, isInvalidTransportError, isInvariantViolationError, isKernelError, isNodeUnavailableError, isNotFoundError, isParseError, isPermissionDeniedError, isPersistenceLoadFailedError, isPoolClosedError, isRedirectPolicyError, isRedirectRefusedError, isRegistryWriteFailedError, isSchemaOwnershipConflictError, isTransportError, isUnsupportedTransportError, isValidationError, isWebOSError, } from './guards.js';
-export { ClientSessionError } from './session-error.js';
+export { ClientError } from './client-error.js';
+export { MissError } from './miss-error.js';
+export { ProtocolError } from './protocol-error.js';
+export { ResponseError } from './response-error.js';
+export { StaleRouteError } from './stale-route-error.js';
+export { TransportError, } from './transport-error.js';
 //# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,WAAW,EACX,oBAAoB,EACpB,aAAa,EACb,UAAU,EACV,qBAAqB,EACrB,YAAY,EACZ,yBAAyB,EACzB,eAAe,EACf,UAAU,EACV,cAAc,EACd,WAAW,GACZ,MAAM,aAAa,CAAA;AAEpB,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,yBAAyB,EACzB,aAAa,EACb,sBAAsB,EACtB,eAAe,EACf,YAAY,EACZ,uBAAuB,EACvB,4BAA4B,EAC5B,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,8BAA8B,EAC9B,gBAAgB,EAChB,2BAA2B,EAC3B,iBAAiB,EACjB,YAAY,GACb,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EACL,cAAc,GAIf,MAAM,sBAAsB,CAAA"}

package/dist/errors/miss-error.d.ts

@@ -0,0 +1,7 @@
+import { ClientError } from './client-error.js';
+/** Client-visible indication that the current Path is no longer served at the learned destination. */
+export declare class MissError extends ClientError {
+    readonly name = "MissError";
+    constructor();
+}
+//# sourceMappingURL=miss-error.d.ts.map

package/dist/errors/miss-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"miss-error.d.ts","sourceRoot":"","sources":["../../errors/miss-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C,sGAAsG;AACtG,qBAAa,SAAU,SAAQ,WAAW;IACxC,SAAkB,IAAI,eAAc;IAEpC,cAEC;CACF"}

package/dist/errors/miss-error.js

@@ -0,0 +1,9 @@
+import { ClientError } from './client-error.js';
+/** Client-visible indication that the current Path is no longer served at the learned destination. */
+export class MissError extends ClientError {
+    name = 'MissError';
+    constructor() {
+        super('The destination no longer serves this Path.');
+    }
+}
+//# sourceMappingURL=miss-error.js.map

package/dist/errors/miss-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"miss-error.js","sourceRoot":"","sources":["../../errors/miss-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C,sGAAsG;AACtG,MAAM,OAAO,SAAU,SAAQ,WAAW;IACtB,IAAI,GAAG,WAAW,CAAA;IAEpC;QACE,KAAK,CAAC,6CAA6C,CAAC,CAAA;IACtD,CAAC;CACF"}

package/dist/errors/protocol-error.d.ts

@@ -0,0 +1,5 @@
+import { ClientError } from './client-error.js';
+export declare class ProtocolError extends ClientError {
+    constructor(message: string, options?: ErrorOptions);
+}
+//# sourceMappingURL=protocol-error.d.ts.map

package/dist/errors/protocol-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-error.d.ts","sourceRoot":"","sources":["../../errors/protocol-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C,qBAAa,aAAc,SAAQ,WAAW;IAC5C,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAGlD;CACF"}

package/dist/errors/protocol-error.js

@@ -0,0 +1,8 @@
+import { ClientError } from './client-error.js';
+export class ProtocolError extends ClientError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'ProtocolError';
+    }
+}
+//# sourceMappingURL=protocol-error.js.map

package/dist/errors/protocol-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-error.js","sourceRoot":"","sources":["../../errors/protocol-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C,MAAM,OAAO,aAAc,SAAQ,WAAW;IAC5C,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QACvB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAA;IAC7B,CAAC;CACF"}

package/dist/errors/response-error.d.ts

@@ -0,0 +1,10 @@
+import type { Value } from '@astrale-os/kernel-dsl/value';
+import { errors } from '@astrale-os/kernel-protocol';
+import { ClientError } from './client-error.js';
+export declare class ResponseError extends ClientError {
+    readonly code: errors.ErrorCode;
+    readonly data?: Value | undefined;
+    readonly reason?: errors.ErrorReason;
+    constructor(code: errors.ErrorCode, message: string, data?: Value | undefined);
+}
+//# sourceMappingURL=response-error.d.ts.map

package/dist/errors/response-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-error.d.ts","sourceRoot":"","sources":["../../errors/response-error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAA;AAEzD,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAA;AAEpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C,qBAAa,aAAc,SAAQ,WAAW;IAI1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS;IAE/B,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK;IALvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAA;IAEpC,YACW,IAAI,EAAE,MAAM,CAAC,SAAS,EAC/B,OAAO,EAAE,MAAM,EACN,IAAI,CAAC,EAAE,KAAK,YAAA,EAKtB;CACF"}

package/dist/errors/response-error.js

@@ -0,0 +1,15 @@
+import { errors } from '@astrale-os/kernel-protocol';
+import { ClientError } from './client-error.js';
+export class ResponseError extends ClientError {
+    code;
+    data;
+    reason;
+    constructor(code, message, data) {
+        super(message);
+        this.code = code;
+        this.data = data;
+        this.name = 'ResponseError';
+        this.reason = errors.reasonOf(data);
+    }
+}
+//# sourceMappingURL=response-error.js.map

package/dist/errors/response-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-error.js","sourceRoot":"","sources":["../../errors/response-error.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAA;AAEpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C,MAAM,OAAO,aAAc,SAAQ,WAAW;IAIjC,IAAI;IAEJ,IAAI;IALN,MAAM,CAAqB;IAEpC,YACW,IAAsB,EAC/B,OAAe,EACN,IAAY;QAErB,KAAK,CAAC,OAAO,CAAC,CAAA;oBAJL,IAAI;oBAEJ,IAAI;QAGb,IAAI,CAAC,IAAI,GAAG,eAAe,CAAA;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IACrC,CAAC;CACF"}

package/dist/errors/stale-route-error.d.ts

@@ -0,0 +1,9 @@
+import type { publication } from '@astrale-os/kernel-protocol';
+import { ClientError } from './client-error.js';
+/** Client-visible stale-route error shape; public instances are not routing-control witnesses. */
+export declare class StaleRouteError extends ClientError {
+    readonly currentEtag: publication.Etag;
+    readonly name = "StaleRouteError";
+    constructor(currentEtag: publication.Etag);
+}
+//# sourceMappingURL=stale-route-error.d.ts.map

package/dist/errors/stale-route-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stale-route-error.d.ts","sourceRoot":"","sources":["../../errors/stale-route-error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAE9D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C,kGAAkG;AAClG,qBAAa,eAAgB,SAAQ,WAAW;IAGlC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,IAAI;IAFlD,SAAkB,IAAI,qBAAoB;IAE1C,YAAqB,WAAW,EAAE,WAAW,CAAC,IAAI,EAEjD;CACF"}

package/dist/errors/stale-route-error.js

@@ -0,0 +1,11 @@
+import { ClientError } from './client-error.js';
+/** Client-visible stale-route error shape; public instances are not routing-control witnesses. */
+export class StaleRouteError extends ClientError {
+    currentEtag;
+    name = 'StaleRouteError';
+    constructor(currentEtag) {
+        super('The destination Publication route is stale.');
+        this.currentEtag = currentEtag;
+    }
+}
+//# sourceMappingURL=stale-route-error.js.map

package/dist/errors/stale-route-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stale-route-error.js","sourceRoot":"","sources":["../../errors/stale-route-error.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C,kGAAkG;AAClG,MAAM,OAAO,eAAgB,SAAQ,WAAW;IAGzB,WAAW;IAFd,IAAI,GAAG,iBAAiB,CAAA;IAE1C,YAAqB,WAA6B;QAChD,KAAK,CAAC,6CAA6C,CAAC,CAAA;2BADjC,WAAW;IAEhC,CAAC;CACF"}

package/dist/errors/transport-error.d.ts

@@ -0,0 +1,15 @@
+import { ClientError } from './client-error.js';
+/** Whether an invocation is proven not to have crossed the transport boundary. */
+export type TransportDelivery = 'not-sent' | 'unknown';
+/** Observable transport phase in which communication stopped. */
+export type TransportPhase = 'connect' | 'send' | 'receive' | 'timeout' | 'closed';
+export interface TransportErrorOptions extends ErrorOptions {
+    readonly phase: TransportPhase;
+    readonly delivery: TransportDelivery;
+}
+export declare class TransportError extends ClientError {
+    readonly phase: TransportPhase;
+    readonly delivery: TransportDelivery;
+    constructor(message: string, options: TransportErrorOptions);
+}
+//# sourceMappingURL=transport-error.d.ts.map

package/dist/errors/transport-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-error.d.ts","sourceRoot":"","sources":["../../errors/transport-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C,kFAAkF;AAClF,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,SAAS,CAAA;AAEtD,iEAAiE;AACjE,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAA;AAElF,MAAM,WAAW,qBAAsB,SAAQ,YAAY;IACzD,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;IAC9B,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAA;CACrC;AAED,qBAAa,cAAe,SAAQ,WAAW;IAC7C,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;IAC9B,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAA;IAEpC,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,EAK1D;CACF"}

package/dist/errors/transport-error.js

@@ -0,0 +1,12 @@
+import { ClientError } from './client-error.js';
+export class TransportError extends ClientError {
+    phase;
+    delivery;
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'TransportError';
+        this.phase = options.phase;
+        this.delivery = options.delivery;
+    }
+}
+//# sourceMappingURL=transport-error.js.map

package/dist/errors/transport-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-error.js","sourceRoot":"","sources":["../../errors/transport-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAa/C,MAAM,OAAO,cAAe,SAAQ,WAAW;IACpC,KAAK,CAAgB;IACrB,QAAQ,CAAmB;IAEpC,YAAY,OAAe,EAAE,OAA8B;QACzD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QACvB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;QAC5B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAA;QAC1B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAA;IAClC,CAAC;CACF"}

package/dist/graph/errors.d.ts

@@ -0,0 +1,9 @@
+import type { NodePath, PathLike } from '@astrale-os/kernel-core/path';
+import { ClientError } from '../errors/index.js';
+/** Required point read whose absence and authorization masking are intentionally indistinguishable. */
+export declare class NodeUnavailableError extends ClientError {
+    readonly code: 'NODE_UNAVAILABLE';
+    readonly path: NodePath;
+    constructor(path: PathLike);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../graph/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAItE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEhD,uGAAuG;AACvG,qBAAa,oBAAqB,SAAQ,WAAW;IACnD,QAAQ,CAAC,IAAI,EAAG,kBAAkB,CAAS;IAC3C,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;IAEvB,YAAY,IAAI,EAAE,QAAQ,EAKzB;CACF"}

package/dist/graph/errors.js

@@ -0,0 +1,14 @@
+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. */
+export class NodeUnavailableError extends ClientError {
+    code = 'NODE_UNAVAILABLE';
+    path;
+    constructor(path) {
+        const admitted = Path.from(path).raw;
+        super(`Node ${JSON.stringify(admitted)} is unavailable.`);
+        this.name = 'NodeUnavailableError';
+        this.path = admitted;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/graph/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../graph/errors.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAA;AAEnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEhD,uGAAuG;AACvG,MAAM,OAAO,oBAAqB,SAAQ,WAAW;IAC1C,IAAI,GAAG,kBAA2B,CAAA;IAClC,IAAI,CAAU;IAEvB,YAAY,IAAc;QACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAA;QACpC,KAAK,CAAC,QAAQ,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAA;QACzD,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;QAClC,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAA;IACtB,CAAC;CACF"}

package/dist/graph/graph.d.ts

@@ -0,0 +1,26 @@
+import type { GraphSpec } from '@astrale-os/kernel-core/graph/graph';
+import type { MutationAST as MutationASTValue, MutationBuilder, MutationInput, MutationResult as MutationResultValue } from '@astrale-os/kernel-core/graph/mutate';
+import type { Node } from '@astrale-os/kernel-core/graph/node';
+import type { QueryAST as QueryASTValue, QueryDefinitionRef, QueryResultFor } from '@astrale-os/kernel-core/graph/query';
+import type { PathLike } from '@astrale-os/kernel-core/path';
+import type { Input } from '@astrale-os/kernel-ports/functions';
+import type { QueryPageRequest, QueryResponse } from '@astrale-os/kernel-ports/query';
+import type { Call } from '../client/index.js';
+import type { RequestOptions } from '../transport/index.js';
+import type { NeighborsOptions, NodePage } from './page/index.js';
+export type GraphCall = (call: Call, options?: RequestOptions) => Promise<Input>;
+export interface GraphQueryOptions extends RequestOptions {
+    readonly page: QueryPageRequest;
+}
+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>;
+    get(target: PathLike, options?: RequestOptions): Promise<Node | null>;
+    getOrThrow(target: PathLike, options?: RequestOptions): Promise<Node>;
+    neighbors(source: PathLike, via: QueryDefinitionRef | readonly [QueryDefinitionRef, ...QueryDefinitionRef[]], options: NeighborsOptions): Promise<NodePage>;
+}
+/** Bind Core's canonical graph documents to one caller-scoped value-call capability. */
+export declare function createGraph(call: GraphCall): GraphApi;
+//# sourceMappingURL=graph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../graph/graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAA;AACpE,OAAO,KAAK,EACV,WAAW,IAAI,gBAAgB,EAC/B,eAAe,EACf,aAAa,EACb,cAAc,IAAI,mBAAmB,EACtC,MAAM,sCAAsC,CAAA;AAC7C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAA;AAC9D,OAAO,KAAK,EACV,QAAQ,IAAI,aAAa,EACzB,kBAAkB,EAClB,cAAc,EACf,MAAM,qCAAqC,CAAA;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oCAAoC,CAAA;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAErF,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAOjE,MAAM,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,KAAK,CAAC,CAAA;AAEhF,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAA;CAChC;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,eAAe,KAAK,SAAS,CAAA;AAErE,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,KAAK,SAAS,aAAa,EAC/B,GAAG,EAAE,KAAK,EACV,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,aAAa,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAChD,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;IACtF,MAAM,CACJ,GAAG,EAAE,gBAAgB,GAAG,aAAa,GAAG,SAAS,EACjD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,mBAAmB,CAAC,CAAA;IAC/B,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAA;IACrE,UAAU,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrE,SAAS,CACP,MAAM,EAAE,QAAQ,EAChB,GAAG,EAAE,kBAAkB,GAAG,SAAS,CAAC,kBAAkB,EAAE,GAAG,kBAAkB,EAAE,CAAC,EAChF,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,QAAQ,CAAC,CAAA;CACrB;AAED,wFAAwF;AACxF,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,QAAQ,CAmBrD"}

package/dist/graph/graph.js

@@ -0,0 +1,19 @@
+import { mutateGraph } from './mutation.js';
+import { readNeighbors } from './page/index.js';
+import { queryGraph } from './query.js';
+import { getNode, requireNode } from './read.js';
+/** Bind Core's canonical graph documents to one caller-scoped value-call capability. */
+export function createGraph(call) {
+    if (typeof call !== 'function')
+        throw new TypeError('Graph call capability is invalid.');
+    const query = (ast, options) => queryGraph(call, ast, options);
+    const mutate = (input, options) => mutateGraph(call, input, options);
+    return Object.freeze({
+        query,
+        mutate,
+        get: (target, options) => getNode(call, target, options),
+        getOrThrow: (target, options) => requireNode(call, target, options),
+        neighbors: (source, via, options) => readNeighbors(query, source, via, options),
+    });
+}
+//# sourceMappingURL=graph.js.map

package/dist/graph/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../graph/graph.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AA6BhD,wFAAwF;AACxF,MAAM,UAAU,WAAW,CAAC,IAAe;IACzC,IAAI,OAAO,IAAI,KAAK,UAAU;QAAE,MAAM,IAAI,SAAS,CAAC,mCAAmC,CAAC,CAAA;IACxF,MAAM,KAAK,GAAG,CAA8B,GAAU,EAAE,OAA0B,EAAE,EAAE,CACpF,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,CAAA;IAChC,MAAM,MAAM,GAAG,CACb,KAAoE,EACpE,OAAwB,EACxB,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;IACtC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,KAAK;QACL,MAAM;QACN,GAAG,EAAE,CAAC,MAAgB,EAAE,OAAwB,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC;QACnF,UAAU,EAAE,CAAC,MAAgB,EAAE,OAAwB,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC;QAC9F,SAAS,EAAE,CACT,MAAgB,EAChB,GAAgF,EAChF,OAAyB,EACzB,EAAE,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC;KAChD,CAAC,CAAA;AACJ,CAAC"}

package/dist/graph/index.d.ts

@@ -1,26 +1,7 @@
-/**
- * Graph sugar over the two batch syscalls (`function.get`/`function.mutate`).
- *
- * One implementation, bound per context: the shell exposes it as
- * `shell.kernel.graph`, the SDK as the handler's `ctx.graph`, and a bound
- * client session flattens it directly onto the view (`session.as(cred).get`,
- * `.query`, `.mutate`, …). Pure over a `GraphCall`
- * capability — no client state, no transport opinion.
- *
- * Layout: `api.ts`, `query/`, `result/`, `mutate/`, `wire.ts`, and `named.ts`.
- */
-export { createGraph, KERNEL_GET_PATH, KERNEL_MUTATE_PATH } from './api.js';
-export type { CreateGraphOpts, GraphApi, GraphCall, MutateFn, QueryFn } from './api.js';
-export type { EdgeBuilderInput, NodeRef, PatchBuilder, PatchInput, Ref, WriteShorthands, } from './mutate/index.js';
-export { F, InvalidQueryError, lowerToGet, makeReadShorthands, Q, resolveNeighbors, UnsupportedQueryError, } from './query/index.js';
-export type { ChildrenOpts, EdgeInput, ExpandInput, FilterInput, GatherBuilder, HopOpts, LoweringCapability, LoweringPhase, NeighborsRead, OrderInput, QueryBuilder, QuerySource, ReadShorthands, TraverseCtx, TraverseNode, WalkOpts, } from './query/index.js';
-export { makeGraphResult, makePaged, nextQuery, NotImplementedError } from './result/index.js';
-export type { Content, GraphResult, Page, Paged } from './result/index.js';
-export { DESCRIPTION_KEY, NAME_KEY, STATUS_KEY, descriptionOf, nameOf, statusOf } from './named.js';
-export type { NamedNodeLike } from './named.js';
-export { edgeKey, prop, rawOf } from './wire.js';
-export type { EdgeIdentity, GetNextCursors, GetResultWire, GraphEdgeWire, GraphNodeWire, MutationResultWire, } from './wire.js';
-export { DEFAULT_CLIENT_RECONCILE_POLICY } from './reconcile/index.js';
-export type { ReconcileEdgeInput, ReconcileFn, ReconcileInput, ReconcileNodeInput, ReconcilePolicyInput, ReconcileResult, ReconcileScopeInput, ReconcileSpecInput, } from './reconcile/index.js';
-export type { ChildrenSelectorInput, EdgeKey, EdgeMatch, EdgeRef, EdgeSelectorInput, EdgeWire, Expand, Filter, GetInput, GetOutput, GetOutputWire, GraphData, GraphDataWire, MutationResult, NodeWire, PatchData, PatchDataInput, PathLike, PermName, Properties, PropertyValue, QueryAST, QueryASTInput, QueryDir, QueryOrder, QueryPage, QueryRoot, QueryStep, Wire, } from '@astrale-os/kernel-core';
+export { createGraph, type GraphApi, type GraphCall, type GraphQueryOptions, type MutationAuthor, } from './graph.js';
+export { NodeUnavailableError } from './errors.js';
+export type { NeighborsOptions, NodePage } from './page/index.js';
+export { LocalBinding, type GraphSpec } from '@astrale-os/kernel-core/graph/graph';
+export { MutationAST, MutationResult, type MutationBuilder, type MutationInput, } from '@astrale-os/kernel-core/graph/mutate';
+export { Query, QueryAST, QueryResult } from '@astrale-os/kernel-core/graph/query';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/graph/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAC3E,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AACvF,YAAY,EACV,gBAAgB,EAChB,OAAO,EACP,YAAY,EACZ,UAAU,EACV,GAAG,EACH,eAAe,GAChB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EACL,CAAC,EACD,iBAAiB,EACjB,UAAU,EACV,kBAAkB,EAClB,CAAC,EACD,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,kBAAkB,CAAA;AACzB,YAAY,EACV,YAAY,EACZ,SAAS,EACT,WAAW,EACX,WAAW,EACX,aAAa,EACb,OAAO,EACP,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,UAAU,EACV,YAAY,EACZ,WAAW,EACX,cAAc,EACd,WAAW,EACX,YAAY,EACZ,QAAQ,GACT,MAAM,kBAAkB,CAAA;AAGzB,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAC9F,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAG1E,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACnG,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,WAAW,CAAA;AAChD,YAAY,EACV,YAAY,EACZ,cAAc,EACd,aAAa,EACb,aAAa,EACb,aAAa,EACb,kBAAkB,GACnB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,+BAA+B,EAAE,MAAM,sBAAsB,CAAA;AACtE,YAAY,EACV,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,sBAAsB,CAAA;AAI7B,YAAY,EACV,qBAAqB,EACrB,OAAO,EACP,SAAS,EACT,OAAO,EACP,iBAAiB,EACjB,QAAQ,EACR,MAAM,EACN,MAAM,EACN,QAAQ,EACR,SAAS,EACT,aAAa,EACb,SAAS,EACT,aAAa,EACb,cAAc,EACd,QAAQ,EACR,SAAS,EACT,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,aAAa,EACb,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,UAAU,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,IAAI,GACL,MAAM,yBAAyB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../graph/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,cAAc,GACpB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAClD,YAAY,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAEjE,OAAO,EAAE,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,qCAAqC,CAAA;AAClF,OAAO,EACL,WAAW,EACX,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,aAAa,GACnB,MAAM,sCAAsC,CAAA;AAC7C,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAA"}

package/dist/graph/index.js

@@ -1,21 +1,6 @@
-/**
- * Graph sugar over the two batch syscalls (`function.get`/`function.mutate`).
- *
- * One implementation, bound per context: the shell exposes it as
- * `shell.kernel.graph`, the SDK as the handler's `ctx.graph`, and a bound
- * client session flattens it directly onto the view (`session.as(cred).get`,
- * `.query`, `.mutate`, …). Pure over a `GraphCall`
- * capability — no client state, no transport opinion.
- *
- * Layout: `api.ts`, `query/`, `result/`, `mutate/`, `wire.ts`, and `named.ts`.
- */
-export { createGraph, KERNEL_GET_PATH, KERNEL_MUTATE_PATH } from './api.js';
-// ─── Query tier — builder, filter kit, lowering ──────────────────────────────
-export { F, InvalidQueryError, lowerToGet, makeReadShorthands, Q, resolveNeighbors, UnsupportedQueryError, } from './query/index.js';
-// ─── Result tier — live reads, pagers, cursor folds ──────────────────────────
-export { makeGraphResult, makePaged, nextQuery, NotImplementedError } from './result/index.js';
-// ─── Universal-prop helpers (blessed; single-sourced from K) ─────────────────
-export { DESCRIPTION_KEY, NAME_KEY, STATUS_KEY, descriptionOf, nameOf, statusOf } from './named.js';
-export { edgeKey, prop, rawOf } from './wire.js';
-export { DEFAULT_CLIENT_RECONCILE_POLICY } from './reconcile/index.js';
+export { createGraph, } from './graph.js';
+export { NodeUnavailableError } from './errors.js';
+export { LocalBinding } from '@astrale-os/kernel-core/graph/graph';
+export { MutationAST, MutationResult, } from '@astrale-os/kernel-core/graph/mutate';
+export { Query, QueryAST, QueryResult } from '@astrale-os/kernel-core/graph/query';
 //# sourceMappingURL=index.js.map

package/dist/graph/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/graph/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAW3E,gFAAgF;AAChF,OAAO,EACL,CAAC,EACD,iBAAiB,EACjB,UAAU,EACV,kBAAkB,EAClB,CAAC,EACD,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,kBAAkB,CAAA;AAoBzB,gFAAgF;AAChF,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAG9F,gFAAgF;AAChF,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAGnG,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,WAAW,CAAA;AAShD,OAAO,EAAE,+BAA+B,EAAE,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../graph/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,GAKZ,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAGlD,OAAO,EAAE,YAAY,EAAkB,MAAM,qCAAqC,CAAA;AAClF,OAAO,EACL,WAAW,EACX,cAAc,GAGf,MAAM,sCAAsC,CAAA;AAC7C,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAA"}

package/dist/graph/mutation.d.ts

@@ -0,0 +1,6 @@
+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>;
+//# sourceMappingURL=mutation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mutation.d.ts","sourceRoot":"","sources":["../../graph/mutation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAA;AACpE,OAAO,KAAK,EACV,WAAW,IAAI,gBAAgB,EAC/B,aAAa,EACb,cAAc,IAAI,mBAAmB,EACtC,MAAM,sCAAsC,CAAA;AAO7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAM3D,wBAAsB,WAAW,CAC/B,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,cAAc,GAAG,gBAAgB,GAAG,aAAa,GAAG,SAAS,EACpE,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,mBAAmB,CAAC,CAI9B"}

package/dist/graph/mutation.js

@@ -0,0 +1,18 @@
+import { MutationAST, MutationResult } from '@astrale-os/kernel-core/graph/mutate';
+import { Path } from '@astrale-os/kernel-core/path';
+import { syscalls } from '@astrale-os/kernel-core/schema';
+import { call as invocation } from '../client/index.js';
+const KERNEL_MUTATE_PATH = Path.project(syscalls.mutate.ref).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);
+    return MutationResult.decode(output);
+}
+function admitMutation(input) {
+    return 'format' in input
+        ? MutationAST.decode(input)
+        : 'operations' in input
+            ? MutationAST.create(input)
+            : MutationAST.fromGraph(input);
+}
+//# sourceMappingURL=mutation.js.map

package/dist/graph/mutation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation.js","sourceRoot":"","sources":["../../graph/mutation.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAA;AAClF,OAAO,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAA;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAA;AAKzD,OAAO,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAEvD,MAAM,kBAAkB,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAA;AAEhE,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAe,EACf,KAAoE,EACpE,OAAwB;IAExB,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;IACzF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,kBAAkB,EAAE,GAAuB,CAAC,EAAE,OAAO,CAAC,CAAA;IAC3F,OAAO,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;AACtC,CAAC;AAED,SAAS,aAAa,CAAC,KAAmD;IACxE,OAAO,QAAQ,IAAI,KAAK;QACtB,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC;QAC3B,CAAC,CAAC,YAAY,IAAI,KAAK;YACrB,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC;YAC3B,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;AACpC,CAAC"}

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

@@ -0,0 +1,3 @@
+export { type NeighborsOptions, type NeighborSource, type NeighborVia, readNeighbors, } from './neighbors.js';
+export type { NodePage, PageQuery, PageQueryOptions } from './page.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../graph/page/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,aAAa,GACd,MAAM,gBAAgB,CAAA;AACvB,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA"}

package/dist/graph/page/index.js

@@ -0,0 +1,2 @@
+export { readNeighbors, } from './neighbors.js';
+//# sourceMappingURL=index.js.map

package/dist/graph/page/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../graph/page/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,aAAa,GACd,MAAM,gBAAgB,CAAA"}

package/dist/graph/page/neighbors.d.ts

@@ -0,0 +1,10 @@
+import type { QueryDefinitionRef, QueryDirection } from '@astrale-os/kernel-core/graph/query';
+import type { PathLike } from '@astrale-os/kernel-core/path';
+import type { NodePage, PageQuery, PageQueryOptions } from './page.js';
+export interface NeighborsOptions extends PageQueryOptions {
+    readonly direction: QueryDirection;
+}
+export type NeighborSource = PathLike;
+export type NeighborVia = QueryDefinitionRef | readonly [QueryDefinitionRef, ...QueryDefinitionRef[]];
+export declare function readNeighbors(query: PageQuery, source: NeighborSource, via: NeighborVia, options: NeighborsOptions): Promise<NodePage>;
+//# sourceMappingURL=neighbors.d.ts.map

package/dist/graph/page/neighbors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"neighbors.d.ts","sourceRoot":"","sources":["../../../graph/page/neighbors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAA;AAC7F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAI5D,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAItE,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAA;CACnC;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAA;AACrC,MAAM,MAAM,WAAW,GACnB,kBAAkB,GAClB,SAAS,CAAC,kBAAkB,EAAE,GAAG,kBAAkB,EAAE,CAAC,CAAA;AAE1D,wBAAsB,aAAa,CACjC,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,QAAQ,CAAC,CA8BnB"}

package/dist/graph/page/neighbors.js

@@ -0,0 +1,35 @@
+import { Query } from '@astrale-os/kernel-core/graph/query';
+import { createNodePage } from './page.js';
+export async function readNeighbors(query, source, via, options) {
+    if (options === null || typeof options !== 'object') {
+        throw new TypeError('Neighbor read options are invalid.');
+    }
+    const definitions = Array.isArray(via) ? via : [via];
+    const [definition, ...additionalDefinitions] = definitions;
+    if (definition === undefined)
+        throw new TypeError('Neighbor read requires at least one Definition.');
+    const direction = options.direction === 'outgoing'
+        ? options.direction
+        : options.direction === 'incoming'
+            ? options.direction
+            : options.direction === 'incident'
+                ? options.direction
+                : invalidDirection(options.direction);
+    const ast = Query.from({ kind: 'node', paths: [source] })
+        .expand({ via: [definition, ...additionalDefinitions], direction })
+        .select({ kind: 'graph' });
+    const { direction: _, page, ...request } = options;
+    const { idempotencyKey: ___, ...basis } = request;
+    const response = await query(ast, {
+        ...request,
+        page,
+    });
+    if (response.result.kind !== 'graph' || response.result.selection.kind !== 'node') {
+        throw new TypeError('Neighbor query returned a non-Node graph result.');
+    }
+    return createNodePage(query, ast, response, basis, page.size);
+}
+function invalidDirection(input) {
+    throw new TypeError(`Unsupported neighbor direction ${JSON.stringify(input)}.`);
+}
+//# sourceMappingURL=neighbors.js.map

package/dist/graph/page/neighbors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"neighbors.js","sourceRoot":"","sources":["../../../graph/page/neighbors.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,MAAM,qCAAqC,CAAA;AAI3D,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAW1C,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAgB,EAChB,MAAsB,EACtB,GAAgB,EAChB,OAAyB;IAEzB,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QACpD,MAAM,IAAI,SAAS,CAAC,oCAAoC,CAAC,CAAA;IAC3D,CAAC;IACD,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;IACpD,MAAM,CAAC,UAAU,EAAE,GAAG,qBAAqB,CAAC,GAAG,WAAW,CAAA;IAC1D,IAAI,UAAU,KAAK,SAAS;QAC1B,MAAM,IAAI,SAAS,CAAC,iDAAiD,CAAC,CAAA;IAExE,MAAM,SAAS,GACb,OAAO,CAAC,SAAS,KAAK,UAAU;QAC9B,CAAC,CAAC,OAAO,CAAC,SAAS;QACnB,CAAC,CAAC,OAAO,CAAC,SAAS,KAAK,UAAU;YAChC,CAAC,CAAC,OAAO,CAAC,SAAS;YACnB,CAAC,CAAC,OAAO,CAAC,SAAS,KAAK,UAAU;gBAChC,CAAC,CAAC,OAAO,CAAC,SAAS;gBACnB,CAAC,CAAC,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IAC7C,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;SACtD,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE,GAAG,qBAAqB,CAAC,EAAE,SAAS,EAAE,CAAC;SAClE,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAA;IAC5B,MAAM,EAAE,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO,CAAA;IAClD,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,GAAG,KAAK,EAAE,GAAG,OAAO,CAAA;IACjD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAChC,GAAG,OAAO;QACV,IAAI;KACL,CAAC,CAAA;IACF,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,IAAI,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAClF,MAAM,IAAI,SAAS,CAAC,kDAAkD,CAAC,CAAA;IACzE,CAAC;IACD,OAAO,cAAc,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;AAC/D,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAY;IACpC,MAAM,IAAI,SAAS,CAAC,kCAAkC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;AACjF,CAAC"}

package/dist/graph/page/page.d.ts

@@ -0,0 +1,34 @@
+import type { GraphData } from '@astrale-os/kernel-core/graph/graph';
+import type { Node, NodeCollection } from '@astrale-os/kernel-core/graph/node';
+import type { NodeBinding, QueryAST, QueryGraphSelect, QueryNodeGraphResult, QueryResultFor } from '@astrale-os/kernel-core/graph/query';
+import type { QueryPageRequest, QueryResponse } from '@astrale-os/kernel-ports/query';
+import type { RequestOptions } from '../../transport/index.js';
+export interface NodePage {
+    readonly nodes: NodeCollection;
+    readonly first: Node | null;
+    readonly graph: GraphData;
+    readonly cursor: string | null;
+    next(options?: {
+        readonly size?: number;
+        readonly signal?: AbortSignal;
+        readonly timeoutMs?: number;
+    }): Promise<NodePage | null>;
+    collect(options: {
+        readonly maximumPages: number;
+        readonly size?: number;
+        readonly signal?: AbortSignal;
+        readonly timeoutMs?: number;
+    }): Promise<{
+        readonly nodes: NodeCollection;
+        readonly cursor: string | null;
+    }>;
+}
+type PageBasis = Pick<RequestOptions, 'signal' | 'timeoutMs'>;
+export interface PageQueryOptions extends RequestOptions {
+    readonly page: QueryPageRequest;
+}
+export type PageQuery = <Query extends QueryAST>(ast: Query, options: PageQueryOptions) => Promise<QueryResponse<QueryResultFor<Query>>>;
+type NodeGraphQueryAST = QueryAST<QueryGraphSelect<NodeBinding>>;
+export declare function createNodePage(query: PageQuery, ast: NodeGraphQueryAST, response: QueryResponse<QueryNodeGraphResult>, basis: PageBasis, size: number): NodePage;
+export {};
+//# sourceMappingURL=page.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../../graph/page/page.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAA;AACpE,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAA;AAC9E,OAAO,KAAK,EACV,WAAW,EACX,QAAQ,EACR,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACf,MAAM,qCAAqC,CAAA;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAErF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAE9D,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;IAC9B,QAAQ,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAE9B,IAAI,CAAC,OAAO,CAAC,EAAE;QACb,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;QACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;QAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAC5B,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAA;IAE5B,OAAO,CAAC,OAAO,EAAE;QACf,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;QAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;QACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;QAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAC5B,GAAG,OAAO,CAAC;QAAE,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAA;CAChF;AAED,KAAK,SAAS,GAAG,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,WAAW,CAAC,CAAA;AAE7D,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACtD,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAA;CAChC;AACD,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,SAAS,QAAQ,EAC7C,GAAG,EAAE,KAAK,EACV,OAAO,EAAE,gBAAgB,KACtB,OAAO,CAAC,aAAa,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AAElD,KAAK,iBAAiB,GAAG,QAAQ,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAA;AAEhE,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,iBAAiB,EACtB,QAAQ,EAAE,aAAa,CAAC,oBAAoB,CAAC,EAC7C,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,MAAM,GACX,QAAQ,CAiDV"}

package/dist/graph/page/page.js

@@ -0,0 +1,56 @@
+export function createNodePage(query, ast, response, basis, size) {
+    const { result } = response;
+    const nodes = result.graph.nodes;
+    const cursor = response.page.next ?? null;
+    const next = async (controls) => {
+        if (cursor === null)
+            return null;
+        const options = {
+            ...basis,
+            ...(controls?.signal === undefined ? {} : { signal: controls.signal }),
+            ...(controls?.timeoutMs === undefined ? {} : { timeoutMs: controls.timeoutMs }),
+            page: { size: controls?.size ?? size, after: cursor },
+        };
+        const continuation = await query(ast, options);
+        if (continuation.result.kind !== 'graph' || continuation.result.selection.kind !== 'node') {
+            throw new TypeError('Node page continuation returned a non-Node graph result.');
+        }
+        return createNodePage(query, ast, continuation, basis, controls?.size ?? size);
+    };
+    const page = {
+        nodes,
+        first: nodes[0] ?? null,
+        graph: result.graph,
+        cursor,
+        next,
+        async collect(options) {
+            requireMaximumPages(options.maximumPages);
+            const collected = [...nodes];
+            let current = page;
+            let pages = 1;
+            while (current.cursor !== null && pages < options.maximumPages) {
+                const continuation = await current.next({
+                    ...(options.size === undefined ? {} : { size: options.size }),
+                    ...(options.signal === undefined ? {} : { signal: options.signal }),
+                    ...(options.timeoutMs === undefined ? {} : { timeoutMs: options.timeoutMs }),
+                });
+                if (continuation === null)
+                    break;
+                collected.push(...continuation.nodes);
+                current = continuation;
+                pages += 1;
+            }
+            return Object.freeze({
+                nodes: Object.freeze(collected),
+                cursor: current.cursor,
+            });
+        },
+    };
+    return Object.freeze(page);
+}
+function requireMaximumPages(value) {
+    if (!Number.isSafeInteger(value) || value < 1) {
+        throw new TypeError('NodePage maximumPages must be a positive safe integer.');
+    }
+}
+//# sourceMappingURL=page.js.map

package/dist/graph/page/page.js.map

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

package/dist/graph/query.d.ts

@@ -0,0 +1,5 @@
+import type { QueryAST as QueryASTValue, QueryResultFor } from '@astrale-os/kernel-core/graph/query';
+import type { QueryResponse } from '@astrale-os/kernel-ports/query';
+import type { GraphCall, GraphQueryOptions } from './graph.js';
+export declare function queryGraph<Query extends QueryASTValue>(call: GraphCall, input: Query, options: GraphQueryOptions): Promise<QueryResponse<QueryResultFor<Query>>>;
+//# sourceMappingURL=query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../graph/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,IAAI,aAAa,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAA;AAEpG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAMnE,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAM9D,wBAAsB,UAAU,CAAC,KAAK,SAAS,aAAa,EAC1D,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,aAAa,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAS/C"}