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

package/dist/store/types.js

@@ -1,7 +0,0 @@
-/**
- * Shared value shapes for the memory store — the read envelope, read/write
- * options, and the materialized-shape projection. The `GraphMemory` facade
- * itself lives in `memory.ts`.
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/store/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/store/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/transport/binary.d.ts

@@ -1,15 +0,0 @@
-/**
- * BinaryResponse — client-side result for methods with `output: 'binary'`.
- *
- * Distinct from the server-side `BinaryResult` (kernel-api): the client adds
- * a `status` field carrying the HTTP response status, and the body may be a
- * `Uint8Array` (single-shot) or a `ReadableStream<Uint8Array>` (streaming).
- *
- * Returned by `client.binary()` and the route transport's binary path.
- */
-export type BinaryResponse = {
-    readonly contentType: string;
-    readonly status: number;
-    readonly body: Uint8Array | ReadableStream<Uint8Array>;
-};
-//# sourceMappingURL=binary.d.ts.map

package/dist/transport/binary.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"binary.d.ts","sourceRoot":"","sources":["../../src/transport/binary.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,CAAC,UAAU,CAAC,CAAA;CACvD,CAAA"}

package/dist/transport/binary.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=binary.js.map

package/dist/transport/binary.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"binary.js","sourceRoot":"","sources":["../../src/transport/binary.ts"],"names":[],"mappings":""}

package/dist/transport/contract.d.ts

@@ -1,58 +0,0 @@
-/**
- * Transport contract — the narrow interface every transport class
- * implements. Each method returns a discriminated `Send*Result`
- * natively. Redirects are first-class results, not sentinels or throws.
- * Errors throw typed `WebOSError` subclasses.
- *
- * One instance = one target URL. The `KernelClient` owns composition
- * across transports; the transports own wire mechanics end-to-end.
- */
-import type { CredentialInput } from '@astrale-os/kernel-core';
-import type { SendBinaryResult, SendResult, SendStreamResult } from '../client/fn-map.js';
-/** A single call targeted at this transport. */
-export type TransportRequest = {
-    method: string;
-    params: unknown;
-    credential: CredentialInput;
-    signal?: AbortSignal;
-    /** Per-call timeout override (ms). */
-    timeout?: number;
-    /** Per-call correlation id — threaded into errors as `details.correlationId`. */
-    correlationId?: string;
-    /**
-     * Per-call URL override. When set, the transport dispatches to this
-     * URL instead of its default. The client drives this for redirect
-     * follow-ups and multi-kernel dispatch.
-     */
-    url?: string;
-    /** Target-of-call for instance methods. Forwarded as `KernelRequest.self`. */
-    self?: string;
-};
-/** A single batch entry. Only the `http-envelope` transport supports batches. */
-export type BatchEntry<T = unknown> = SendResult<T> | Error;
-/**
- * The common transport surface. Each capability that the transport does
- * NOT express (e.g. `batch` on routed) throws `UnsupportedTransportError`
- * synchronously.
- */
-export type Transport = {
-    /**
-     * Target URL this transport dispatches against. `undefined` for
-     * routed transports — each call brings its own `remoteUrl` via the
-     * schema's route binding, so there's no single base URL to report.
-     */
-    readonly url: string | undefined;
-    /** Transport identity, reported on every result's `meta.transport`. */
-    readonly name: 'http-envelope' | 'ws-envelope' | 'http-routed';
-    call(request: TransportRequest): Promise<SendResult<unknown>>;
-    stream(request: TransportRequest): Promise<SendStreamResult<unknown>>;
-    binary(request: TransportRequest): Promise<SendBinaryResult>;
-    signal(request: TransportRequest): void;
-    batch(requests: TransportRequest[]): Promise<BatchEntry[]>;
-    /**
-     * Release any held resources (e.g. an open WebSocket). Idempotent.
-     * Safe to call on a transport that was never used.
-     */
-    disconnect(): void;
-};
-//# sourceMappingURL=contract.d.ts.map

package/dist/transport/contract.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/transport/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAE9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAEzF,gDAAgD;AAChD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,OAAO,CAAA;IACf,UAAU,EAAE,eAAe,CAAA;IAC3B,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,iFAAiF;AACjF,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,GAAG,KAAK,CAAA;AAE3D;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,uEAAuE;IACvE,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,aAAa,GAAG,aAAa,CAAA;IAE9D,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAA;IAC7D,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAA;IACrE,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAC5D,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAA;IACvC,KAAK,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAA;IAE1D;;;OAGG;IACH,UAAU,IAAI,IAAI,CAAA;CACnB,CAAA"}

package/dist/transport/contract.js

@@ -1,11 +0,0 @@
-/**
- * Transport contract — the narrow interface every transport class
- * implements. Each method returns a discriminated `Send*Result`
- * natively. Redirects are first-class results, not sentinels or throws.
- * Errors throw typed `WebOSError` subclasses.
- *
- * One instance = one target URL. The `KernelClient` owns composition
- * across transports; the transports own wire mechanics end-to-end.
- */
-export {};
-//# sourceMappingURL=contract.js.map

package/dist/transport/contract.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../src/transport/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/transport/fetch.d.ts

@@ -1,31 +0,0 @@
-/**
- * Shared `fetch` wrapper for kernel HTTP transports.
- *
- * Wraps transport-layer failures into `ConnectionError` so clients see a
- * consistent, identifiable error class instead of raw `TypeError`s. Abort
- * errors pass through unchanged so per-request cancellation still surfaces
- * as `AbortError`.
- *
- * Accepts an optional custom `fetch` implementation for testing or
- * environment shims (default: `globalThis.fetch`).
- */
-/**
- * Rewrite local-development aliases to the loopback name reachable from the
- * current runtime — preserving port + path + query.
- *
- * macOS (and Node's libuv-backed `dns.lookup`) only resolve the literal
- * `localhost`; subdomains like `mails.localhost` NXDOMAIN unless added
- * to `/etc/hosts`. Dev presets stamp `mails.localhost` (or
- * `example.localhost`, …) into `Function.binding.remoteUrl` so domains stay
- * isolated by hostname rather than by port — every redirect-following
- * `astrale call` to a dev worker would NXDOMAIN without this rewrite.
- *
- * A domain installed from a manager container uses `host.docker.internal`,
- * while the host-side CLI and browser must dial that same worker through
- * `127.0.0.1`. Real deployments use neither local alias, so the rewrite is a
- * no-op in production traffic. (Friction: META_FEEDBACKS M-13 in
- * `domains/mails/`.)
- */
-export declare function rewriteLocalhostForLoopback(url: string, host?: string): string;
-export declare function safeFetch(url: string, init: RequestInit, fetchImpl?: typeof fetch): Promise<Response>;
-//# sourceMappingURL=fetch.d.ts.map

package/dist/transport/fetch.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/transport/fetch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAuBH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAuB,GAAG,MAAM,CAkB9F;AAED,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,EACjB,SAAS,GAAE,OAAO,KAAyC,GAC1D,OAAO,CAAC,QAAQ,CAAC,CASnB"}

package/dist/transport/fetch.js

@@ -1,78 +0,0 @@
-/**
- * Shared `fetch` wrapper for kernel HTTP transports.
- *
- * Wraps transport-layer failures into `ConnectionError` so clients see a
- * consistent, identifiable error class instead of raw `TypeError`s. Abort
- * errors pass through unchanged so per-request cancellation still surfaces
- * as `AbortError`.
- *
- * Accepts an optional custom `fetch` implementation for testing or
- * environment shims (default: `globalThis.fetch`).
- */
-import { ConnectionError } from '../errors/errors.js';
-/**
- * Loopback target host. From a host-side process (CLI, dev), `127.0.0.1`
- * reaches any locally-bound listener. From inside the manager container,
- * `127.0.0.1` is the container's own loopback — local listeners on the
- * host are reachable via `host.docker.internal` (Docker Desktop /
- * Linux 20.10+). `ASTRALE_IN_CONTAINER=1` is set in the manager image's
- * compose env (`cli/src/lib/docker.ts`).
- *
- * Mirrors `kernel/adapters/authentication/in-memory/discovery.ts` which
- * needs the same policy on the JWKS-fetch path.
- */
-function loopbackHost() {
-    // `process` is the Node global; narrow via globalThis so workerd /
-    // browser bundles still typecheck (they don't ship `process`).
-    const proc = globalThis.process;
-    const inContainer = proc?.env?.ASTRALE_IN_CONTAINER === '1';
-    return inContainer ? 'host.docker.internal' : '127.0.0.1';
-}
-/**
- * Rewrite local-development aliases to the loopback name reachable from the
- * current runtime — preserving port + path + query.
- *
- * macOS (and Node's libuv-backed `dns.lookup`) only resolve the literal
- * `localhost`; subdomains like `mails.localhost` NXDOMAIN unless added
- * to `/etc/hosts`. Dev presets stamp `mails.localhost` (or
- * `example.localhost`, …) into `Function.binding.remoteUrl` so domains stay
- * isolated by hostname rather than by port — every redirect-following
- * `astrale call` to a dev worker would NXDOMAIN without this rewrite.
- *
- * A domain installed from a manager container uses `host.docker.internal`,
- * while the host-side CLI and browser must dial that same worker through
- * `127.0.0.1`. Real deployments use neither local alias, so the rewrite is a
- * no-op in production traffic. (Friction: META_FEEDBACKS M-13 in
- * `domains/mails/`.)
- */
-export function rewriteLocalhostForLoopback(url, host = loopbackHost()) {
-    let parsed;
-    try {
-        parsed = new URL(url);
-    }
-    catch {
-        return url;
-    }
-    // Only `*.localhost` subdomains need help — the literal `localhost`
-    // resolves natively (libc, macOS) and rewriting it breaks tests that
-    // mock `http://localhost` and clients that intentionally point at it.
-    if (parsed.hostname.endsWith('.localhost') ||
-        (parsed.hostname === 'host.docker.internal' && host !== 'host.docker.internal')) {
-        parsed.hostname = host;
-        return parsed.toString();
-    }
-    return url;
-}
-export async function safeFetch(url, init, fetchImpl = globalThis.fetch.bind(globalThis)) {
-    const transportUrl = rewriteLocalhostForLoopback(url);
-    try {
-        return await fetchImpl(transportUrl, init);
-    }
-    catch (error) {
-        const cause = error instanceof Error ? error : new Error(String(error));
-        if (cause.name === 'AbortError')
-            throw cause;
-        throw new ConnectionError(`Failed to connect to ${url}: ${cause.message}`, { cause });
-    }
-}
-//# sourceMappingURL=fetch.js.map

package/dist/transport/fetch.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../src/transport/fetch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAErD;;;;;;;;;;GAUG;AACH,SAAS,YAAY;IACnB,mEAAmE;IACnE,+DAA+D;IAC/D,MAAM,IAAI,GAAI,UAAyE,CAAC,OAAO,CAAA;IAC/F,MAAM,WAAW,GAAG,IAAI,EAAE,GAAG,EAAE,oBAAoB,KAAK,GAAG,CAAA;IAC3D,OAAO,WAAW,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,WAAW,CAAA;AAC3D,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,2BAA2B,CAAC,GAAW,EAAE,IAAI,GAAW,YAAY,EAAE;IACpF,IAAI,MAAW,CAAA;IACf,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAA;IACZ,CAAC;IACD,oEAAoE;IACpE,qEAAqE;IACrE,sEAAsE;IACtE,IACE,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC;QACtC,CAAC,MAAM,CAAC,QAAQ,KAAK,sBAAsB,IAAI,IAAI,KAAK,sBAAsB,CAAC,EAC/E,CAAC;QACD,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAA;QACtB,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAA;IAC1B,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,GAAW,EACX,IAAiB,EACjB,SAAS,GAAiB,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;IAE3D,MAAM,YAAY,GAAG,2BAA2B,CAAC,GAAG,CAAC,CAAA;IACrD,IAAI,CAAC;QACH,OAAO,MAAM,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,CAAA;IAC5C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,KAAK,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;QACvE,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;YAAE,MAAM,KAAK,CAAA;QAC5C,MAAM,IAAI,eAAe,CAAC,wBAAwB,GAAG,KAAK,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;IACvF,CAAC;AACH,CAAC"}

package/dist/transport/http-envelope.d.ts

@@ -1,49 +0,0 @@
-/**
- * Kernel-envelope HTTP transport.
- *
- * Speaks the kernel envelope (POST /) with JSON or MsgPack codec. Returns
- * discriminated `Send*Result`s natively — redirects are `kind: 'redirect'`
- * results, errors throw typed `WebOSError` subclasses, values carry
- * `meta: WireMeta` populated at receive time.
- *
- * Note: SSE frames are always JSON-text on the wire, even when the
- * transport is configured for `msgpack` — msgpack bytes don't fit SSE's
- * text framing, so the server emits JSON on the SSE channel regardless.
- */
-import type { SendBinaryResult, SendResult, SendStreamResult } from '../client/fn-map.js';
-import type { BatchEntry, Transport, TransportRequest } from './contract.js';
-import { type KernelRetryOptions } from '../pacer/retry.js';
-export type HttpEnvelopeTransportConfig = {
-    url: string;
-    codec?: 'json' | 'msgpack';
-    requestTimeout?: number;
-    headers?: Record<string, string>;
-    retry?: KernelRetryOptions;
-    /** Custom fetch (testing, environment shims). Default: global fetch. */
-    fetch?: typeof fetch;
-};
-export declare class HttpEnvelopeTransport implements Transport {
-    readonly name: 'http-envelope';
-    readonly url: string;
-    private readonly codec;
-    private readonly codecName;
-    private readonly kernelContentType;
-    private readonly defaultTimeout;
-    private readonly extraHeaders;
-    private readonly retryOpts;
-    private readonly fetchImpl;
-    constructor(config: HttpEnvelopeTransportConfig);
-    disconnect(): void;
-    call(request: TransportRequest): Promise<SendResult<unknown>>;
-    signal(request: TransportRequest): void;
-    batch(requests: TransportRequest[]): Promise<BatchEntry[]>;
-    binary(request: TransportRequest): Promise<SendBinaryResult>;
-    stream(request: TransportRequest): Promise<SendStreamResult<unknown>>;
-    private encodeEnvelope;
-    private buildHeaders;
-    private targetFor;
-    private metaFromResponse;
-    private decorate;
-    private retryingFetch;
-}
-//# sourceMappingURL=http-envelope.d.ts.map

package/dist/transport/http-envelope.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"http-envelope.d.ts","sourceRoot":"","sources":["../../src/transport/http-envelope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAkBH,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAEzF,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAW5E,OAAO,EAAe,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAOxE,MAAM,MAAM,2BAA2B,GAAG;IACxC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,KAAK,CAAC,EAAE,kBAAkB,CAAA;IAC1B,wEAAwE;IACxE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;CACrB,CAAA;AAED,qBAAa,qBAAsB,YAAW,SAAS;IACrD,QAAQ,CAAC,IAAI,EAAG,eAAe,CAAS;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAO;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAQ;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwB;IACrD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgC;IAC1D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IAExC,YAAY,MAAM,EAAE,2BAA2B,EAU9C;IAED,UAAU,IAAI,IAAI,CAEjB;IAIK,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CA+ElE;IAID,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAyBtC;IAIK,KAAK,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CA0D/D;IAIK,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA0FjE;IAIK,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CA2E1E;IAID,OAAO,CAAC,cAAc;IAiBtB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,QAAQ;YAmBF,aAAa;CAyB5B"}