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

package/dist/graph/query/errors.js

@@ -1,28 +0,0 @@
-import { WebOSError } from '../../errors/errors.js';
-/**
- * A valid query `function.get` cannot yet execute. Thrown client-side before
- * any dispatch; `capability`/`phase` name the exact gap and what would light
- * it up.
- */
-export class UnsupportedQueryError extends WebOSError {
-    capability;
-    phase;
-    constructor(message, capability, phase) {
-        super(message);
-        this.capability = capability;
-        this.phase = phase;
-        this.name = 'UnsupportedQueryError';
-    }
-}
-/**
- * A structurally invalid query that no syscall, present or future, will run — an
- * empty seed, or two gathers sharing an `as` (which collides their cursor
- * keys). Must be fixed, not deferred. Thrown client-side before any dispatch.
- */
-export class InvalidQueryError extends WebOSError {
-    constructor(message) {
-        super(message);
-        this.name = 'InvalidQueryError';
-    }
-}
-//# sourceMappingURL=errors.js.map

package/dist/graph/query/errors.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/graph/query/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AA0BnD;;;;GAIG;AACH,MAAM,OAAO,qBAAsB,SAAQ,UAAU;IAGxC,UAAU;IACV,KAAK;IAHhB,YACE,OAAe,EACN,UAA8B,EAC9B,KAAoB;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAA;0BAHL,UAAU;qBACV,KAAK;QAGd,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAA;IACrC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,iBAAkB,SAAQ,UAAU;IAC/C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAA;IACjC,CAAC;CACF"}

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

@@ -1,50 +0,0 @@
-import type { PropertyValue, QueryDir } from '@astrale-os/kernel-core';
-/**
- * One edge class (`has_parent` sugar or a full edge-class path raw), or a
- * union of them.
- */
-export type EdgeInput = string | string[];
-/**
- * A restrict expression, string-first (class paths are raw strings) —
- * identical JSON to core's `Filter`. Produced by the {@link F} kit;
- * hand-written objects are interchangeable with it.
- */
-export type FilterInput = {
-    prop: string;
-    op: '=';
-    value: PropertyValue;
-} | {
-    class: string | readonly string[];
-} | {
-    hasEdge: {
-        edge: EdgeInput;
-        dir: QueryDir;
-        filter?: FilterInput;
-    };
-} | {
-    and: readonly FilterInput[];
-} | {
-    or: readonly FilterInput[];
-} | {
-    not: FilterInput;
-};
-/**
- * Filter factories, composable anywhere a filter is accepted:
- *
- *   F.and(F.cls(POST), F.eq(STATUS_KEY, 'published'))
- */
-export declare const F: {
-    /** A property equals a literal (`=` is the only v1 op). */
-    readonly eq: (prop: string, value: PropertyValue) => FilterInput;
-    /** Type membership — any of the given class paths. */
-    readonly cls: (...classes: string[]) => FilterInput;
-    /** An edge matching this sub-walk exists (the endpoint is not returned). */
-    readonly hasEdge: (edge: EdgeInput, dir: QueryDir, filter?: FilterInput) => FilterInput;
-    /** Conjunction — all operands match. */
-    readonly and: (...filters: FilterInput[]) => FilterInput;
-    /** Disjunction — at least one operand matches. */
-    readonly or: (...filters: FilterInput[]) => FilterInput;
-    /** Negation — the operand must not match. */
-    readonly not: (filter: FilterInput) => FilterInput;
-};
-//# sourceMappingURL=filter.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../../src/graph/query/filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAEtE;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,EAAE,CAAA;AAEzC;;;;GAIG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,GAAG,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,GAC/C;IAAE,KAAK,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAA;CAAE,GACrC;IAAE,OAAO,EAAE;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,GAAG,EAAE,QAAQ,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,CAAA;CAAE,GACrE;IAAE,GAAG,EAAE,SAAS,WAAW,EAAE,CAAA;CAAE,GAC/B;IAAE,EAAE,EAAE,SAAS,WAAW,EAAE,CAAA;CAAE,GAC9B;IAAE,GAAG,EAAE,WAAW,CAAA;CAAE,CAAA;AAExB;;;;GAIG;AACH,eAAO,MAAM,CAAC;IACZ,2DAA2D;aAC3D,EAAE,SAAO,MAAM,SAAS,aAAa,KAAG,WAAW;IAGnD,sDAAsD;aACtD,GAAG,eAAa,MAAM,EAAE,KAAG,WAAW;IAGtC,4EAA4E;aAC5E,OAAO,SAAO,SAAS,OAAO,QAAQ,WAAW,WAAW,KAAG,WAAW;IAG1E,wCAAwC;aACxC,GAAG,eAAa,WAAW,EAAE,KAAG,WAAW;IAG3C,kDAAkD;aAClD,EAAE,eAAa,WAAW,EAAE,KAAG,WAAW;IAG1C,6CAA6C;aAC7C,GAAG,WAAS,WAAW,KAAG,WAAW;CAG7B,CAAA"}

package/dist/graph/query/filter.js

@@ -1,32 +0,0 @@
-/**
- * Filter factories, composable anywhere a filter is accepted:
- *
- *   F.and(F.cls(POST), F.eq(STATUS_KEY, 'published'))
- */
-export const F = {
-    /** A property equals a literal (`=` is the only v1 op). */
-    eq(prop, value) {
-        return { prop, op: '=', value };
-    },
-    /** Type membership — any of the given class paths. */
-    cls(...classes) {
-        return { class: classes };
-    },
-    /** An edge matching this sub-walk exists (the endpoint is not returned). */
-    hasEdge(edge, dir, filter) {
-        return { hasEdge: { edge, dir, ...(filter !== undefined ? { filter } : {}) } };
-    },
-    /** Conjunction — all operands match. */
-    and(...filters) {
-        return { and: filters };
-    },
-    /** Disjunction — at least one operand matches. */
-    or(...filters) {
-        return { or: filters };
-    },
-    /** Negation — the operand must not match. */
-    not(filter) {
-        return { not: filter };
-    },
-};
-//# sourceMappingURL=filter.js.map

package/dist/graph/query/filter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../../src/graph/query/filter.ts"],"names":[],"mappings":"AAqBA;;;;GAIG;AACH,MAAM,CAAC,MAAM,CAAC,GAAG;IACf,2DAA2D;IAC3D,EAAE,CAAC,IAAY,EAAE,KAAoB;QACnC,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAA;IACjC,CAAC;IACD,sDAAsD;IACtD,GAAG,CAAC,GAAG,OAAiB;QACtB,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAA;IAC3B,CAAC;IACD,4EAA4E;IAC5E,OAAO,CAAC,IAAe,EAAE,GAAa,EAAE,MAAoB;QAC1D,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAA;IAChF,CAAC;IACD,wCAAwC;IACxC,GAAG,CAAC,GAAG,OAAsB;QAC3B,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,CAAA;IACzB,CAAC;IACD,kDAAkD;IAClD,EAAE,CAAC,GAAG,OAAsB;QAC1B,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,CAAA;IACxB,CAAC;IACD,6CAA6C;IAC7C,GAAG,CAAC,MAAmB;QACrB,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAA;IACxB,CAAC;CACO,CAAA"}

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

@@ -1,12 +0,0 @@
-export { Q } from './builder.js';
-export type { ExpandInput, GatherBuilder, HopOpts, OrderInput, QueryBuilder, QuerySource, WalkOpts, } from './builder.js';
-export { F } from './filter.js';
-export type { EdgeInput, FilterInput } from './filter.js';
-export { InvalidQueryError, UnsupportedQueryError } from './errors.js';
-export type { LoweringCapability, LoweringPhase } from './errors.js';
-export { lowerToGet } from './lower.js';
-export { makeReadShorthands } from './shorthands.js';
-export type { ChildrenOpts, ReadShorthands } from './shorthands.js';
-export { resolveNeighbors, resolveNeighborsPage } from './traverse.js';
-export type { NeighborsRead, TraverseCtx, TraverseNode } from './traverse.js';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/graph/query/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,cAAc,CAAA;AAChC,YAAY,EACV,WAAW,EACX,aAAa,EACb,OAAO,EACP,UAAU,EACV,YAAY,EACZ,WAAW,EACX,QAAQ,GACT,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,CAAC,EAAE,MAAM,aAAa,CAAA;AAC/B,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzD,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACtE,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACpD,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACnE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACtE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA"}

package/dist/graph/query/index.js

@@ -1,7 +0,0 @@
-export { Q } from './builder.js';
-export { F } from './filter.js';
-export { InvalidQueryError, UnsupportedQueryError } from './errors.js';
-export { lowerToGet } from './lower.js';
-export { makeReadShorthands } from './shorthands.js';
-export { resolveNeighbors, resolveNeighborsPage } from './traverse.js';
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/graph/query/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,cAAc,CAAA;AAUhC,OAAO,EAAE,CAAC,EAAE,MAAM,aAAa,CAAA;AAE/B,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAEtE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAEpD,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA"}

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

@@ -1,30 +0,0 @@
-/**
- * `lowerToGet` — compile a `QueryASTInput` down to a `function.get` input, or
- * throw naming the exact capability function.get is missing. The seam that
- * lets the permissive builder run against the narrow function.get.
- *
- * THROW, NEVER DEGRADE: function.get paginates *before* any client post-filter
- * would run, so a filtered page under-fills and its cursor lies — a degraded
- * result is wrong, not merely slow. The same chain that throws today starts
- * working with zero client change the day the structured `function.query`
- * syscall lands.
- *
- * The get-normal-form (§5.6):
- *   from:   Root[1..100]
- *   steps:  [0..1] MOVE   { edge: has_parent, dir 'in', depth ≤ 5,
- *                           filter? = pure {class} arm, page?, order? }
- *           [0..N] GATHER { edge?, dir, depth 1|undefined, as, page?, order?,
- *                           NO filter } → one edges[] selector each
- *   with:   absent | 'READ'
- * The MOVE, if present, must be the FIRST step: get anchors every gather on
- * the one walked subtree. Caps mirror function.get's zod (100/5/500) so a
- * violation reports identically on either side of the wire.
- */
-import type { GetInput, QueryASTInput } from '@astrale-os/kernel-core';
-/**
- * Lower a v1 AST to a `function.get` input. Pure and synchronous — exported so
- * callers can pre-flight an AST (does a saved view still lower?) without a
- * transport.
- */
-export declare function lowerToGet(ast: QueryASTInput): GetInput;
-//# sourceMappingURL=lower.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"lower.d.ts","sourceRoot":"","sources":["../../../src/graph/query/lower.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAqB,QAAQ,EAAY,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAoBnG;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,aAAa,GAAG,QAAQ,CAsEvD"}

package/dist/graph/query/lower.js

@@ -1,171 +0,0 @@
-/**
- * `lowerToGet` — compile a `QueryASTInput` down to a `function.get` input, or
- * throw naming the exact capability function.get is missing. The seam that
- * lets the permissive builder run against the narrow function.get.
- *
- * THROW, NEVER DEGRADE: function.get paginates *before* any client post-filter
- * would run, so a filtered page under-fills and its cursor lies — a degraded
- * result is wrong, not merely slow. The same chain that throws today starts
- * working with zero client change the day the structured `function.query`
- * syscall lands.
- *
- * The get-normal-form (§5.6):
- *   from:   Root[1..100]
- *   steps:  [0..1] MOVE   { edge: has_parent, dir 'in', depth ≤ 5,
- *                           filter? = pure {class} arm, page?, order? }
- *           [0..N] GATHER { edge?, dir, depth 1|undefined, as, page?, order?,
- *                           NO filter } → one edges[] selector each
- *   with:   absent | 'READ'
- * The MOVE, if present, must be the FIRST step: get anchors every gather on
- * the one walked subtree. Caps mirror function.get's zod (100/5/500) so a
- * violation reports identically on either side of the wire.
- */
-import { rawOf } from '@astrale-os/kernel-core';
-import { describeEdge, resolveEdgeMatch } from './edge-ref.js';
-import { HAS_PARENT_CLASS } from './edges.js';
-import { InvalidQueryError, UnsupportedQueryError } from './errors.js';
-// Same numbers as function.get's zod (`schema/functions/get.ts`) — independent
-// literals so the client rejects with the verdict the syscall boundary would.
-const MAX_ROOTS = 100;
-const MAX_DEPTH = 5;
-const MAX_LIMIT = 500;
-/**
- * Lower a v1 AST to a `function.get` input. Pure and synchronous — exported so
- * callers can pre-flight an AST (does a saved view still lower?) without a
- * transport.
- */
-export function lowerToGet(ast) {
-    const from = ast.from;
-    if (from.length === 0) {
-        // Structural, not a function.get gap: core's zod pins `from.min(1)`.
-        throw new InvalidQueryError('a query must seed at least one root');
-    }
-    if (from.length > MAX_ROOTS) {
-        throw new UnsupportedQueryError(`root count ${from.length} exceeds the get cap of ${MAX_ROOTS}`, 'roots-cap', 'query-fn');
-    }
-    if (ast.with !== undefined && ast.with !== 'READ') {
-        throw new UnsupportedQueryError(`visibility permission '${ast.with}' is not yet lit up — function.get threads READ only; ` +
-            `'USE' is the cheapest kernel unlock (un-hardcode get's visibility perm)`, 'visibility-perm', 'get-perm');
-    }
-    const roots = from.map(rawOf);
-    let depth = 0;
-    let children;
-    const edges = [];
-    // Each `as` keys a `(root × as)` cursor, so two gathers sharing one alias
-    // would fold a single cursor onto both steps.
-    const seenAliases = new Set();
-    const steps = ast.steps ?? [];
-    for (let i = 0; i < steps.length; i++) {
-        const step = steps[i];
-        if (!('expand' in step)) {
-            throw new UnsupportedQueryError('a standalone filter step needs the structured query syscall — function.get returns every visible root unconditionally', 'filter-step', 'query-fn');
-        }
-        const expand = step.expand;
-        if (expand.as === undefined) {
-            if (i !== 0) {
-                throw new UnsupportedQueryError('a move (unnamed expand) must be the first step — function.get anchors every gather ' +
-                    'on the single walked subtree, so it cannot chain past the seed frontier', 'move-chaining', 'query-fn');
-            }
-            ;
-            ({ depth, children } = lowerMove(expand));
-        }
-        else {
-            if (seenAliases.has(expand.as)) {
-                throw new InvalidQueryError(`duplicate gather alias '${expand.as}' — two gathers share the same \`as\`, which ` +
-                    'collides their (root × as) cursor keys; every gather needs a distinct alias');
-            }
-            seenAliases.add(expand.as);
-            edges.push(lowerGather(expand));
-        }
-    }
-    const input = { roots, depth };
-    if (children !== undefined)
-        input.children = children;
-    if (edges.length === 1)
-        input.edges = edges[0];
-    else if (edges.length > 1)
-        input.edges = edges;
-    return input;
-}
-/** The MOVE → `depth` + `children`. Throws on any non-has_parent-descent shape. */
-function lowerMove(expand) {
-    const resolved = resolveEdgeMatch(expand.edge);
-    const isHasParent = resolved !== undefined && resolved.length === 1 && resolved[0] === HAS_PARENT_CLASS;
-    if (!isHasParent) {
-        throw new UnsupportedQueryError(`the only move function.get expresses is the has_parent subtree descent; got ${describeEdge(expand.edge)}`, 'move-chaining', 'query-fn');
-    }
-    if (expand.dir !== 'in') {
-        throw new UnsupportedQueryError(`function.get descends only (has_parent inbound); dir '${expand.dir}' walks upward`, 'upward-walk', 'query-fn');
-    }
-    const depth = expand.depth ?? 1;
-    if (depth > MAX_DEPTH) {
-        throw new UnsupportedQueryError(`descent depth ${depth} exceeds the get cap of ${MAX_DEPTH}`, 'depth-cap', 'query-fn');
-    }
-    const classes = expand.filter !== undefined ? moveClassArm(expand.filter) : undefined;
-    const limit = expand.page?.limit;
-    if (limit !== undefined && limit > MAX_LIMIT) {
-        throw new UnsupportedQueryError(`children limit ${limit} exceeds the get cap of ${MAX_LIMIT}`, 'limit-cap', 'query-fn');
-    }
-    const cursor = expand.page?.cursor;
-    const order = expand.order;
-    const children = classes === undefined && limit === undefined && cursor === undefined && order === undefined
-        ? undefined
-        : {
-            ...(classes !== undefined ? { classes } : {}),
-            ...(limit !== undefined ? { limit } : {}),
-            ...(cursor !== undefined ? { cursor } : {}),
-            ...(order !== undefined ? { order } : {}),
-        };
-    return { depth, children };
-}
-/** A GATHER → one edges[] selector. Throws on a filter or a multi-hop depth. */
-function lowerGather(expand) {
-    if (expand.filter !== undefined)
-        throwGatherFilter(expand.filter);
-    if (expand.depth !== undefined && expand.depth !== 1) {
-        throw new UnsupportedQueryError(`function.get gathers a single hop; depth ${expand.depth} needs the structured query syscall`, 'gather-depth', 'query-fn');
-    }
-    const classes = resolveEdgeMatch(expand.edge);
-    const limit = expand.page?.limit;
-    if (limit !== undefined && limit > MAX_LIMIT) {
-        throw new UnsupportedQueryError(`gather limit ${limit} exceeds the get cap of ${MAX_LIMIT}`, 'limit-cap', 'query-fn');
-    }
-    const cursor = expand.page?.cursor;
-    const order = expand.order;
-    return {
-        as: expand.as,
-        ...(classes !== undefined ? { classes } : {}),
-        direction: expand.dir,
-        ...(limit !== undefined ? { limit } : {}),
-        ...(cursor !== undefined ? { cursor } : {}),
-        ...(order !== undefined ? { order } : {}),
-    };
-}
-// ─── Filter handling ─────────────────────────────────────────────────────────
-/**
- * The move's filter is admissible only as a pure `{ class }` arm →
- * `children.classes`; every other arm throws, named by what it is.
- */
-function moveClassArm(filter) {
-    const f = filter;
-    if ('class' in f)
-        return normalizeClasses(f.class);
-    if ('hasEdge' in f) {
-        throw new UnsupportedQueryError('a reachability (hasEdge) filter on a descent needs the structured query syscall', 'has-edge', 'query-fn');
-    }
-    throw new UnsupportedQueryError('function.get restricts a descent by class only — a property or boolean filter needs the structured query syscall', 'expand-filter', 'query-fn');
-}
-/** A gather carries no filter under get; classify the offending arm and throw. */
-function throwGatherFilter(filter) {
-    const f = filter;
-    if ('hasEdge' in f) {
-        throw new UnsupportedQueryError('a reachability (hasEdge) filter on a gather needs the structured query syscall', 'has-edge', 'query-fn');
-    }
-    throw new UnsupportedQueryError('function.get cannot filter gathered endpoints — a gather takes no filter', 'expand-filter', 'query-fn');
-}
-/** Normalize a class filter's value (one path or a union) to raw strings. */
-function normalizeClasses(cls) {
-    const list = Array.isArray(cls) ? cls : [cls];
-    return list.map((c) => rawOf(c));
-}
-//# sourceMappingURL=lower.js.map

package/dist/graph/query/lower.js.map

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

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

@@ -1,34 +0,0 @@
-import type { Node, PathLike, QueryASTInput } from '@astrale-os/kernel-core';
-import type { Paged } from '../result/index.js';
-import type { GetResultWire } from '../wire.js';
-import type { OrderInput } from './builder.js';
-/** Options for {@link ReadShorthands.children}. */
-export interface ChildrenOpts {
-    /** Restrict children to these classes. */
-    classes?: PathLike[];
-    /** Page size — continue via `result.next()` or `opts.cursor`. */
-    limit?: number;
-    /** Opaque children cursor returned by `result.cursor()`. */
-    cursor?: string;
-    /** Children ordering, matching the query builder's move ordering. */
-    order?: OrderInput;
-}
-/** The read half of {@link GraphApi} — kept as its own contract so `GraphApi` can extend it. */
-export interface ReadShorthands {
-    /** One node by path, or `null` when missing or masked. */
-    get(path: PathLike): Promise<Node | null>;
-    /** One node by path; throws `NodeUnavailableError` when missing or masked. */
-    getOrThrow(path: PathLike, context?: string): Promise<Node>;
-    /** A node's direct children; `result.nodes` excludes the parent. */
-    children(path: PathLike, opts?: ChildrenOpts): Promise<Paged>;
-    /** Far endpoints across one edge class, lazily paged — `result.nodes` is the first page; `.all()` drains, `.next()` steps. */
-    neighbors(path: PathLike, edge: PathLike, direction: 'out' | 'in', opts?: {
-        cursor?: string;
-    }): Promise<Paged>;
-}
-/** A NOT_FOUND-folding AST runner (`read ∘ lowerToGet`) — the one capability the shorthands need. */
-type Run = (ast: QueryASTInput) => Promise<GetResultWire>;
-/** Build the read shorthands over a shared AST runner. */
-export declare function makeReadShorthands(run: Run): ReadShorthands;
-export {};
-//# sourceMappingURL=shorthands.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"shorthands.d.ts","sourceRoot":"","sources":["../../../src/graph/query/shorthands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAS,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAInF,OAAO,KAAK,EAAQ,KAAK,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAY,MAAM,cAAc,CAAA;AAQxD,mDAAmD;AACnD,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAA;IACpB,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qEAAqE;IACrE,KAAK,CAAC,EAAE,UAAU,CAAA;CACnB;AAED,gGAAgG;AAChG,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAA;IACzC,8EAA8E;IAC9E,UAAU,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3D,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IAC7D,8HAA8H;IAC9H,SAAS,CACP,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,QAAQ,EACd,SAAS,EAAE,KAAK,GAAG,IAAI,EACvB,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GACzB,OAAO,CAAC,KAAK,CAAC,CAAA;CAClB;AAED,qGAAqG;AACrG,KAAK,GAAG,GAAG,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,aAAa,CAAC,CAAA;AAEzD,0DAA0D;AAC1D,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,GAAG,cAAc,CA6C3D"}

package/dist/graph/query/shorthands.js

@@ -1,71 +0,0 @@
-import { rawOf } from '@astrale-os/kernel-core';
-import { NodeUnavailableError } from '../../errors/errors.js';
-import { makeGraphResult, makePaged } from '../result/index.js';
-import { Q } from './builder.js';
-import { resolveNeighborsPage } from './traverse.js';
-/** Build the read shorthands over a shared AST runner. */
-export function makeReadShorthands(run) {
-    async function read(path) {
-        const ast = Q.from(path).toAST();
-        return makeGraphResult(run, ast, await run(ast)).first;
-    }
-    return {
-        get: read,
-        async getOrThrow(path, context) {
-            const node = await read(path);
-            if (node === null)
-                throw new NodeUnavailableError(rawOf(path), context);
-            return node;
-        },
-        async children(path, opts) {
-            const first = await resolveChildrenPage(path, opts, run);
-            return makePaged(first, (cursor) => resolveChildrenPage(path, { ...opts, cursor }, run));
-        },
-        async neighbors(path, edge, direction, opts) {
-            const query = {
-                query: async (build) => {
-                    const ast = build(Q).toAST();
-                    return makeGraphResult(run, ast, await run(ast));
-                },
-            };
-            const first = await resolveNeighborsPage({ path: { raw: rawOf(path) } }, rawOf(edge), direction, { read: query }, opts?.cursor);
-            return makePaged(first, (cursor) => resolveNeighborsPage({ path: { raw: rawOf(path) } }, rawOf(edge), direction, { read: query }, cursor));
-        },
-    };
-}
-// ─── Internals ───────────────────────────────────────────────────────────────
-async function resolveChildrenPage(path, opts, run) {
-    const ast = Q.from(path).children(walkOpts(opts)).toAST();
-    const result = makeGraphResult(run, ast, await run(ast));
-    return {
-        nodes: childrenOf(result),
-        cursor: childrenCursor(result.wire.next, rawOf(path)),
-    };
-}
-function childrenOf(result) {
-    const roots = new Set(result.roots.map((n) => n.id));
-    return result.graph.nodes.filter((n) => !roots.has(n.id));
-}
-function childrenCursor(next, root) {
-    if (next === undefined)
-        return null;
-    if (root !== undefined)
-        return next[root]?.children ?? null;
-    return Object.values(next)[0]?.children ?? null;
-}
-/** {@link ChildrenOpts} → the builder's {@link WalkOpts}; `undefined` when empty. */
-function walkOpts(opts) {
-    if (opts?.classes === undefined &&
-        opts?.limit === undefined &&
-        opts?.cursor === undefined &&
-        opts?.order === undefined) {
-        return undefined;
-    }
-    return {
-        ...(opts.classes !== undefined ? { classes: opts.classes.map(rawOf) } : {}),
-        ...(opts.limit !== undefined ? { limit: opts.limit } : {}),
-        ...(opts.cursor !== undefined ? { cursor: opts.cursor } : {}),
-        ...(opts.order !== undefined ? { order: opts.order } : {}),
-    };
-}
-//# sourceMappingURL=shorthands.js.map

package/dist/graph/query/shorthands.js.map

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

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

@@ -1,59 +0,0 @@
-/**
- * The ONE edge-gather algorithm shared by the schema-free `neighbors`
- * read-shorthand and the schema-bound `.out(Edge)`/`.in(Edge)` traversal.
- *
- * An edge gather is one builder-form `query` (lowering to `function.get`); the
- * far endpoints of the gathered edges are then hydrated by ONE batched
- * multi-root `query`. `function.get` PAGES the gather (server default page,
- * hard max 500), so a high-degree node spans several pages. The core resolves
- * ONE page at a time (`resolveNeighborsPage` → far endpoints + a continuation
- * cursor); the two public surfaces consume that differently:
- *   - `neighbors` returns a generic `Paged` result — the caller decides how far to walk and truncation
- *     is never silent;
- *   - the bound `.out`/`.in` DRAIN every page into one typed array.
- *
- * Per-page round-trip contract:
- *   - 0 RT when the minting envelope already gathered the edge class AND all
- *     endpoints are present in-envelope — a gathered envelope holds the WHOLE
- *     class for the node, so it is always a single, complete page;
- *   - else ≤2 RT flat per page — ONE edges get + ONE batched multi-root get for
- *     the page's endpoints — NEVER per-node N+1. Endpoint hydration chunks at
- *     {@link MAX_HYDRATION_ROOTS} so it never trips `function.get`'s root cap.
- *
- * `edgeClass` is a full edge-class `ClassPath.raw`. `direction` picks the
- * near/far endpoints: `out` walks source→target, `in` walks target→source.
- */
-import type { Graph, Node } from '@astrale-os/kernel-core';
-import type { GraphResult, Page } from '../result/index.js';
-import type { GatherBuilder, QuerySource } from './builder.js';
-/**
- * The minimal read capability a gather needs — the builder-form `query`.
- * Kept local so this core never imports the shorthands/bound surface it serves.
- */
-export interface NeighborsRead {
-    query(build: (q: QuerySource) => GatherBuilder): Promise<GraphResult>;
-}
-/** The node whose neighbors we resolve — only its `@id`/path ref is needed. */
-export interface TraverseNode {
-    id?: string;
-    path: {
-        raw: string;
-    };
-}
-/** Ambient resolution context: the read plus an optional minting envelope. */
-export interface TraverseCtx {
-    read: NeighborsRead;
-    /** Minting envelope for in-envelope (0-RT) traversal. */
-    envelope?: Graph;
-    /** Edge `ClassPath.raw`s the mint's `GetInput` gathered — the exact 0-RT signal. */
-    gathered?: ReadonlySet<string>;
-}
-/** Resolve ONE page of far endpoints. `cursor` continues a prior page's gather. */
-export declare function resolveNeighborsPage(node: TraverseNode, edgeClass: string, direction: 'out' | 'in', ctx: TraverseCtx, cursor?: string): Promise<Page>;
-/**
- * Drain every page of a neighbor gather into one deduped, order-preserving
- * array — the schema-bound `.out`/`.in` surface, which keeps its typed
- * cardinality shape and so must be complete, not a page.
- */
-export declare function resolveNeighbors(node: TraverseNode, edgeClass: string, direction: 'out' | 'in', ctx: TraverseCtx): Promise<Node[]>;
-//# sourceMappingURL=traverse.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"traverse.d.ts","sourceRoot":"","sources":["../../../src/graph/query/traverse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAQ,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAA;AAIhE,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AAE3D,OAAO,KAAK,EAAE,aAAa,EAAW,WAAW,EAAE,MAAM,cAAc,CAAA;AASvE;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;CACtE;AAED,+EAA+E;AAC/E,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;CACtB;AAED,8EAA8E;AAC9E,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,aAAa,CAAA;IACnB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,KAAK,CAAA;IAChB,oFAAoF;IACpF,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAC/B;AAED,mFAAmF;AACnF,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,YAAY,EAClB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,KAAK,GAAG,IAAI,EACvB,GAAG,EAAE,WAAW,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAcf;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,YAAY,EAClB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,KAAK,GAAG,IAAI,EACvB,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,IAAI,EAAE,CAAC,CAejB"}