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

package/dist/client/config.d.ts

@@ -1,112 +0,0 @@
-/**
- * Client configuration and per-call options.
- *
- * Two orthogonal axes: `transport` (the pipe — http/ws/auto) × `protocol`
- * (the message shape — envelope/auto). `route` is HTTP-only, so
- * `protocol: 'auto'` degrades to envelope on WS. `binary` and `batch` are
- * HTTP-only regardless of `transport`. Defaults: `'http'` + `'envelope'`.
- */
-import type { KernelRetryOptions } from '../pacer/retry.js';
-import type { SchemaRegistry } from '../schema/registry.js';
-import type { FunctionSchema } from '../schema/types.js';
-import type { ClientHooks } from './hooks.js';
-/** Minimal logger shape — a subset of `Console`. Defaults to `console`. */
-export type ClientLogger = Pick<Console, 'error' | 'warn'>;
-export type ClientConfig = {
-    /** Kernel URL. One client = one kernel — no pool. */
-    url: string;
-    /** Wire codec preference. Default `'json'`. */
-    codec?: 'json' | 'msgpack';
-    /**
-     * Default request timeout in ms. `0` or omitted = **no timeout** — the
-     * client never imposes one by default, so a CLI command against a
-     * dead server doesn't sit spinning for seconds the caller didn't ask
-     * for. Opt in explicitly per-client or per-call (`CallOptions.timeout`).
-     */
-    requestTimeout?: number;
-    /**
-     * Retry policy for transient wire failures (5xx, 429). **Default: no
-     * retry** — a failed call returns the failure immediately. Callers
-     * that want retries configure `kernelRetry` themselves or pass a
-     * policy here.
-     */
-    retry?: KernelRetryOptions;
-    /**
-     * Preloaded schemas or an external `SchemaRegistry`. Passing a registry
-     * lets multiple clients share one (saves / loads are visible across all).
-     * Passing an array loads an internal registry at construction.
-     */
-    schema?: FunctionSchema[] | SchemaRegistry;
-    /** Custom `fetch` (testing, environment shims). Default: global fetch. */
-    fetch?: typeof fetch;
-    /** Lifecycle hooks — pure observation (see `client/hooks.ts`). */
-    hooks?: ClientHooks;
-    /** Default transport (see `CallTransport`). Default `'http'`. */
-    defaultTransport?: CallTransport;
-    /**
-     * Default protocol. `'envelope'` always speaks the kernel envelope;
-     * `'auto'` prefers route if the schema has a `RouteBinding` and the
-     * transport is HTTP, else falls through to envelope. Default `'envelope'`.
-     */
-    defaultProtocol?: Protocol;
-    /**
-     * Logger used for hook-failure diagnostics. Only the error's name +
-     * message are surfaced — see `KernelClient.logHookError`. Default: `console`.
-     */
-    logger?: ClientLogger;
-};
-/**
- * Transport the call rides over.
- *
- * - `'http'` — always HTTP.
- * - `'ws'`   — always WebSocket; connect failure throws `ConnectionError`.
- * - `'auto'` — WS-first with HTTP fallback on initial connect failure.
- *   Once a frame round-trips, commits to WS (mid-session closures throw —
- *   no silent downgrade for long-running consumers). Signal stays on HTTP
- *   until WS is proven: fire-and-forget can't communicate fallback.
- *
- * **Caveat:** the browser `WebSocket` API reports all handshake failures
- * (server doesn't speak WS, auth reject, WAF, origin mismatch) as the same
- * error. `'auto'` treats every connect failure as WS-unsupported and sticks
- * on HTTP for the client's lifetime — an auth-related failure gets masked.
- * Consumers needing WS-specific errors should use `transport: 'ws'`.
- */
-export type CallTransport = 'http' | 'ws' | 'auto';
-/**
- * Message-shape preference. `envelope` forces the kernel envelope;
- * `auto` uses the schema's `RouteBinding` when present and the
- * transport is HTTP, else envelope.
- */
-export type Protocol = 'envelope' | 'auto';
-export type CallOptions = {
-    /** Per-call timeout override (ms). */
-    timeout?: number;
-    /** Abort signal — propagates through the controller to the transport. */
-    signal?: AbortSignal;
-    /** Class context for instance-method schema resolution (e.g. `'Document'`). */
-    class?: string;
-    /**
-     * Override target URL. Used by an orchestrator (layer D) to retarget
-     * a call after a redirect. Supports `{placeholder}` substitution from
-     * params, same as `remoteUrl`.
-     */
-    url?: string;
-    /**
-     * Per-call transport override. Applies to hop-1 only — redirect follow-ups
-     * pick their transport from the schema of the new target.
-     */
-    transport?: CallTransport;
-    /**
-     * Per-call protocol override. `'auto'` resolves to route when the
-     * schema has a binding AND `transport === 'http'`; else envelope.
-     */
-    protocol?: Protocol;
-    /**
-     * Caller-provided correlation id — threaded into every `ClientHooks`
-     * context and onto any thrown error's `.details.correlationId`.
-     */
-    correlationId?: string;
-    /** Target-of-call for instance methods. Forwarded as `KernelRequest.self`. */
-    self?: string;
-};
-//# sourceMappingURL=config.d.ts.map

package/dist/client/config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/client/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,2EAA2E;AAC3E,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,CAAA;AAE1D,MAAM,MAAM,YAAY,GAAG;IACzB,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAA;IAEX,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAE1B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,kBAAkB,CAAA;IAE1B;;;;OAIG;IACH,MAAM,CAAC,EAAE,cAAc,EAAE,GAAG,cAAc,CAAA;IAE1C,0EAA0E;IAC1E,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;IAEpB,kEAAkE;IAClE,KAAK,CAAC,EAAE,WAAW,CAAA;IAEnB,iEAAiE;IACjE,gBAAgB,CAAC,EAAE,aAAa,CAAA;IAEhC;;;;OAIG;IACH,eAAe,CAAC,EAAE,QAAQ,CAAA;IAE1B;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,CAAA;CACtB,CAAA;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,IAAI,GAAG,MAAM,CAAA;AAElD;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAA;AAE1C,MAAM,MAAM,WAAW,GAAG;IACxB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB,yEAAyE;IACzE,MAAM,CAAC,EAAE,WAAW,CAAA;IAEpB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IAEZ;;;OAGG;IACH,SAAS,CAAC,EAAE,aAAa,CAAA;IAEzB;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAA;IAEnB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA"}

package/dist/client/config.js

@@ -1,10 +0,0 @@
-/**
- * Client configuration and per-call options.
- *
- * Two orthogonal axes: `transport` (the pipe — http/ws/auto) × `protocol`
- * (the message shape — envelope/auto). `route` is HTTP-only, so
- * `protocol: 'auto'` degrades to envelope on WS. `binary` and `batch` are
- * HTTP-only regardless of `transport`. Defaults: `'http'` + `'envelope'`.
- */
-export {};
-//# sourceMappingURL=config.js.map

package/dist/client/config.js.map

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

package/dist/client/fn-map.d.ts

@@ -1,61 +0,0 @@
-import type { CallRedirection } from '@astrale-os/kernel-api';
-import type { BinaryResponse } from '../transport/binary.js';
-import type { WireMeta } from '../wire/meta.js';
-/**
- * A single function entry in the type map. `TKind` is required — codegen
- * always writes it; defaulting here would only obscure intent.
- */
-export type FnEntry<TParams, TResult, TKind extends 'call' | 'stream' | 'signal' | 'binary'> = {
-    params: TParams;
-    result: TResult;
-    kind: TKind;
-};
-/** Function map: method ref → FnEntry. Type parameter for `KernelClient<M>`. */
-export type FnMap = Record<string, FnEntry<unknown, unknown, 'call' | 'stream' | 'signal' | 'binary'>>;
-type FnsOfKind<M extends FnMap, K extends 'call' | 'stream' | 'signal' | 'binary'> = {
-    [Path in keyof M]: M[Path]['kind'] extends K ? Path : never;
-}[keyof M] & string;
-/**
- * Wildcard-map detector. When `M` is the bare `FnMap` (no literal keys),
- * `keyof M` is `string`, so `string extends keyof M` is `true` and the
- * `*Fns<M>` aliases collapse to `string` — letting untyped consumers pass
- * any method ref. For typed maps with literal keys, the conditional is
- * `false` and the kind discrimination kicks in as before.
- */
-type IsWildcardMap<M extends FnMap> = string extends keyof M ? true : false;
-export type CallFns<M extends FnMap> = IsWildcardMap<M> extends true ? string : FnsOfKind<M, 'call'>;
-export type StreamFns<M extends FnMap> = IsWildcardMap<M> extends true ? string : FnsOfKind<M, 'stream'>;
-export type SignalFns<M extends FnMap> = IsWildcardMap<M> extends true ? string : FnsOfKind<M, 'signal'>;
-export type BinaryFns<M extends FnMap> = IsWildcardMap<M> extends true ? string : FnsOfKind<M, 'binary'>;
-/** `client.send(...)` return — value or redirect. */
-export type SendResult<T> = {
-    kind: 'value';
-    value: T;
-    meta: WireMeta;
-} | {
-    kind: 'redirect';
-    redirection: CallRedirection;
-    meta: WireMeta;
-};
-/** `client.sendStream(...)` return — stream of chunks or on-open redirect. */
-export type SendStreamResult<T> = {
-    kind: 'stream';
-    chunks: AsyncIterable<T>;
-    meta: WireMeta;
-} | {
-    kind: 'redirect';
-    redirection: CallRedirection;
-    meta: WireMeta;
-};
-/** `client.sendBinary(...)` return — binary response or redirect. */
-export type SendBinaryResult = {
-    kind: 'binary';
-    response: BinaryResponse;
-    meta: WireMeta;
-} | {
-    kind: 'redirect';
-    redirection: CallRedirection;
-    meta: WireMeta;
-};
-export {};
-//# sourceMappingURL=fn-map.d.ts.map

package/dist/client/fn-map.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fn-map.d.ts","sourceRoot":"","sources":["../../src/client/fn-map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAE7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAI/C;;;GAGG;AACH,MAAM,MAAM,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,SAAS,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,IAAI;IAC7F,MAAM,EAAE,OAAO,CAAA;IACf,MAAM,EAAE,OAAO,CAAA;IACf,IAAI,EAAE,KAAK,CAAA;CACZ,CAAA;AAED,gFAAgF;AAChF,MAAM,MAAM,KAAK,GAAG,MAAM,CACxB,MAAM,EACN,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC,CACnE,CAAA;AAID,KAAK,SAAS,CAAC,CAAC,SAAS,KAAK,EAAE,CAAC,SAAS,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,IAAI;KAClF,IAAI,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI,GAAG,KAAK;CAC5D,CAAC,MAAM,CAAC,CAAC,GACR,MAAM,CAAA;AAER;;;;;;GAMG;AACH,KAAK,aAAa,CAAC,CAAC,SAAS,KAAK,IAAI,MAAM,SAAS,MAAM,CAAC,GAAG,IAAI,GAAG,KAAK,CAAA;AAE3E,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,KAAK,IAAI,aAAa,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,CAAA;AACpG,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,KAAK,IACnC,aAAa,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;AACjE,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,KAAK,IACnC,aAAa,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;AACjE,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,KAAK,IACnC,aAAa,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;AAUjE,qDAAqD;AACrD,MAAM,MAAM,UAAU,CAAC,CAAC,IACpB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,CAAC,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,WAAW,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAA;AAEtE,8EAA8E;AAC9E,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAC1B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,WAAW,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAA;AAEtE,qEAAqE;AACrE,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,WAAW,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAA"}

package/dist/client/fn-map.js

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

package/dist/client/fn-map.js.map

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

package/dist/client/freeze.d.ts

@@ -1,32 +0,0 @@
-import type { SendBinaryResult, SendResult, SendStreamResult } from './fn-map.js';
-/**
- * Freeze the envelope of a `Send*Result` so observers can't
- * structurally rewrite it. Frozen:
- *
- *   - the outer result (so `result.kind = 'redirect'` throws)
- *   - `result.meta` (so `meta.durationMs = 0` throws)
- *   - `result.meta.wire` and its `wire.headers` Record (HTTP variant)
- *
- * NOT frozen (by design — these are consumable / caller-owned):
- *
- *   - `result.value` for `kind: 'value'` — payload data; caller may
- *     mutate it without affecting the client. Hooks that mutate this
- *     still see their changes in their own scope but do not retarget
- *     the client.
- *   - `result.redirection` for `kind: 'redirect'` — kept mutable for
- *     the same reason; an orchestrator may normalise the URL before
- *     retrying.
- *   - `result.chunks` for `kind: 'stream'` — the async iterable must
- *     stay live so the caller can consume it.
- *   - `result.response` for `kind: 'binary'` — body is a
- *     `ReadableStream` or `Uint8Array`; freezing the wrapper would not
- *     add safety and could surprise bindings that attach properties.
- *
- * The structural freeze closes spec §10's "observation, not
- * transformation" guarantee: a hook that tries
- * `ctx.result.kind = 'x'` or `ctx.result.meta.transport = 'y'` throws
- * `TypeError` in strict mode instead of silently mutating the shape a
- * subsequent hook or the caller depends on.
- */
-export declare function freezeResult<R extends SendResult<unknown> | SendStreamResult<unknown> | SendBinaryResult>(result: R): R;
-//# sourceMappingURL=freeze.d.ts.map

package/dist/client/freeze.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"freeze.d.ts","sourceRoot":"","sources":["../../src/client/freeze.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEjF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,YAAY,CAC1B,CAAC,SAAS,UAAU,CAAC,OAAO,CAAC,GAAG,gBAAgB,CAAC,OAAO,CAAC,GAAG,gBAAgB,EAC5E,MAAM,EAAE,CAAC,GAAG,CAAC,CASd"}

package/dist/client/freeze.js

@@ -1,42 +0,0 @@
-/**
- * Freeze the envelope of a `Send*Result` so observers can't
- * structurally rewrite it. Frozen:
- *
- *   - the outer result (so `result.kind = 'redirect'` throws)
- *   - `result.meta` (so `meta.durationMs = 0` throws)
- *   - `result.meta.wire` and its `wire.headers` Record (HTTP variant)
- *
- * NOT frozen (by design — these are consumable / caller-owned):
- *
- *   - `result.value` for `kind: 'value'` — payload data; caller may
- *     mutate it without affecting the client. Hooks that mutate this
- *     still see their changes in their own scope but do not retarget
- *     the client.
- *   - `result.redirection` for `kind: 'redirect'` — kept mutable for
- *     the same reason; an orchestrator may normalise the URL before
- *     retrying.
- *   - `result.chunks` for `kind: 'stream'` — the async iterable must
- *     stay live so the caller can consume it.
- *   - `result.response` for `kind: 'binary'` — body is a
- *     `ReadableStream` or `Uint8Array`; freezing the wrapper would not
- *     add safety and could surprise bindings that attach properties.
- *
- * The structural freeze closes spec §10's "observation, not
- * transformation" guarantee: a hook that tries
- * `ctx.result.kind = 'x'` or `ctx.result.meta.transport = 'y'` throws
- * `TypeError` in strict mode instead of silently mutating the shape a
- * subsequent hook or the caller depends on.
- */
-export function freezeResult(result) {
-    // Freeze the meta first so nested wire field is also frozen.
-    Object.freeze(result.meta);
-    if (result.meta.wire)
-        Object.freeze(result.meta.wire);
-    // Headers are already frozen by `headersToRecord`, but re-freezing a
-    // frozen object is a no-op and keeps the guarantee local.
-    const wire = result.meta.wire;
-    if (wire.kind === 'http')
-        Object.freeze(wire.headers);
-    return Object.freeze(result);
-}
-//# sourceMappingURL=freeze.js.map

package/dist/client/freeze.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"freeze.js","sourceRoot":"","sources":["../../src/client/freeze.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,YAAY,CAE1B,MAAS;IACT,6DAA6D;IAC7D,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAC1B,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI;QAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACrD,qEAAqE;IACrE,0DAA0D;IAC1D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAA;IAC7B,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;QAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACrD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;AAC9B,CAAC"}

package/dist/client/hooks.d.ts

@@ -1,49 +0,0 @@
-import type { CredentialInput } from '@astrale-os/kernel-core';
-import type { TransportName, WireMeta } from '../wire/meta.js';
-import type { SendBinaryResult, SendResult, SendStreamResult } from './fn-map.js';
-/**
- * Lifecycle hooks — pure observation. Return values are ignored; throws
- * are caught, logged, and the call proceeds unchanged. The result object
- * handed to `onAfterReceive` is `Object.freeze`d, so hooks cannot mutate
- * what the caller sees.
- *
- * Signals (fire-and-forget) flow through `onAfterSignal`, not
- * `onAfterReceive` — signals have no response meta and a string-in-a-union
- * would force every consumer to narrow away the non-object case.
- */
-export type ClientHooks = {
-    onBeforeSend?: (ctx: BeforeSendCtx) => void | Promise<void>;
-    onAfterReceive?: (ctx: AfterReceiveCtx) => void | Promise<void>;
-    onAfterSignal?: (ctx: AfterSignalCtx) => void | Promise<void>;
-    onError?: (ctx: ErrorCtx) => void | Promise<void>;
-    onStreamFrame?: (ctx: StreamFrameCtx) => void | Promise<void>;
-};
-export type BeforeSendCtx = {
-    method: string;
-    params: unknown;
-    credential: CredentialInput;
-    transport: TransportName;
-    url: string;
-    correlationId?: string;
-};
-export type AfterReceiveCtx = BeforeSendCtx & {
-    result: SendResult<unknown> | SendStreamResult<unknown> | SendBinaryResult;
-    meta: WireMeta;
-};
-export type AfterSignalCtx = BeforeSendCtx & {
-    /** Client-side timestamp when the signal was dispatched onto the wire. */
-    dispatchedAt: number;
-};
-export type ErrorCtx = BeforeSendCtx & {
-    error: Error;
-    /** Present when the error arose post-decode; absent on connect/timeout. */
-    meta?: WireMeta;
-};
-export type StreamFrameCtx = BeforeSendCtx & {
-    /** Zero-based index of the chunk in the stream. */
-    index: number;
-    data: unknown;
-    /** Stream-open meta — frozen from the opening `SendStreamResult.meta`. */
-    meta: WireMeta;
-};
-//# sourceMappingURL=hooks.d.ts.map

package/dist/client/hooks.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/client/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAE9D,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEjF;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3D,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/D,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7D,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjD,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC9D,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,OAAO,CAAA;IACf,UAAU,EAAE,eAAe,CAAA;IAC3B,SAAS,EAAE,aAAa,CAAA;IACxB,GAAG,EAAE,MAAM,CAAA;IACX,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG;IAC5C,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,gBAAgB,CAAC,OAAO,CAAC,GAAG,gBAAgB,CAAA;IAC1E,IAAI,EAAE,QAAQ,CAAA;CACf,CAAA;AAED,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG;IAC3C,0EAA0E;IAC1E,YAAY,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG,aAAa,GAAG;IACrC,KAAK,EAAE,KAAK,CAAA;IACZ,2EAA2E;IAC3E,IAAI,CAAC,EAAE,QAAQ,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG;IAC3C,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,OAAO,CAAA;IACb,0EAA0E;IAC1E,IAAI,EAAE,QAAQ,CAAA;CACf,CAAA"}

package/dist/client/hooks.js

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

package/dist/client/hooks.js.map

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

package/dist/errors/errors.d.ts

@@ -1,156 +0,0 @@
-import type { CallRedirection, FieldError, InvariantError } from '@astrale-os/kernel-api';
-import type { TransportName, WireMeta } from '../wire/meta.js';
-/**
- * Context attached to every `WebOSError` thrown by the client. An
- * orchestrator reads this to retry on a different client, inspect a
- * redirection, read a step-up challenge, or correlate logs. The typed
- * fields `redirection` and `challenge` carry the same payloads the
- * corresponding thrown-error subclasses expose as structured properties;
- * the client never dumps raw server `data` here.
- *
- * Populated once at the transport → error boundary. `url` is the URL
- * *actually dispatched to* — when the orchestrator (future layer D)
- * follows a redirect, each hop's error carries that hop's `url`.
- */
-export type ClientErrorDetails = {
-    method: string;
-    params: unknown;
-    url: string;
-    transport: TransportName;
-    correlationId?: string;
-    meta?: WireMeta;
-    redirection?: CallRedirection;
-};
-export declare class WebOSError extends Error {
-    details?: ClientErrorDetails;
-    constructor(message: string, options?: ErrorOptions);
-}
-export declare class ConnectionError extends WebOSError {
-    constructor(message: string, options?: ErrorOptions);
-}
-export declare class DisconnectedError extends WebOSError {
-    constructor(message?: string);
-}
-export declare class TimeoutError extends WebOSError {
-    readonly requestId: string;
-    readonly timeoutMs: number;
-    constructor(requestId: string, timeoutMs: number);
-}
-/**
- * Caller forced a transport that the resolved method cannot use (e.g.
- * an envelope transport on a routed-only method, or `routed` on a
- * method without `binding.route`). Thrown synchronously before wire
- * dispatch.
- */
-export declare class InvalidTransportError extends WebOSError {
-    constructor(message: string);
-}
-/**
- * A transport was asked to serve an operation it does not express —
- * `batch` on a routed transport, duplex binary stream on envelope, etc.
- */
-export declare class UnsupportedTransportError extends WebOSError {
-    constructor(message: string);
-}
-export type AuthReason = 'missing' | 'invalid' | 'expired';
-export declare class AuthenticationError extends WebOSError {
-    readonly reason: AuthReason;
-    constructor(message: string, reason: AuthReason);
-}
-export declare class PermissionDeniedError extends WebOSError {
-    constructor(message?: string);
-}
-export declare class KernelError extends WebOSError {
-    readonly code: number;
-    readonly type: string;
-    readonly data?: unknown;
-    constructor(message: string, code: number, type?: string, data?: unknown);
-}
-/** The wire payload could not be decoded into a request envelope. */
-export declare class ParseError extends KernelError {
-    constructor(message?: string, data?: unknown);
-}
-/** The decoded request envelope failed protocol validation. */
-export declare class InvalidRequestError extends KernelError {
-    constructor(message?: string, data?: unknown);
-}
-/** The kernel returned an internal failure payload. */
-export declare class InternalKernelError extends KernelError {
-    constructor(message?: string, data?: unknown);
-}
-/**
- * Validation error. `errors` holds the server-reported `FieldError[]`,
- * orthogonal to the inherited `WebOSError.details` (which carries
- * invocation context — method/url/transport/correlationId). Two axes,
- * two fields; neither overwrites the other.
- */
-export declare class ValidationError extends KernelError {
-    readonly errors: FieldError[];
-    constructor(message: string, errors: FieldError[]);
-    getFieldError(field: string): FieldError | undefined;
-    hasFieldError(field: string): boolean;
-}
-export declare class InvariantViolationError extends KernelError {
-    readonly errors: InvariantError[];
-    constructor(message: string, errors: InvariantError[]);
-    getError(code: string): InvariantError | undefined;
-    hasError(code: string): boolean;
-}
-export declare class NotFoundError extends WebOSError {
-    constructor(message?: string);
-}
-/**
- * A `get()` / `getOrThrow()` read resolved to no visible node at the address.
- * DELIBERATELY opaque: it does NOT distinguish "does not exist" from "exists but
- * not READable by the caller" — the kernel folds both to an empty read so
- * neither can be probed. `context` prefixes the message with the caller's intent.
- */
-export declare class NodeUnavailableError extends WebOSError {
-    readonly path: string;
-    constructor(path: string, context?: string);
-}
-/**
- * One entry's fate in a batched auth operation. `input` summarizes the entry so
- * a caller can tell WHICH one it is. `value` is present only when fulfilled (so
- * a partial-failure catcher can recover successes); `error` only when rejected.
- */
-export type AuthBatchOutcome = {
-    index: number;
-    /** Perm verbs: the caller's entry; bind/unbind: a `{ who, edge, counterparty }` dispatch summary. */
-    input: unknown;
-    status: 'fulfilled' | 'rejected';
-    value?: unknown;
-    error?: unknown;
-};
-/**
- * A batched auth call had at least one entry fail. Set semantics, not a
- * transaction: partial application is possible, so this carries EVERY entry's
- * outcome — inspect {@link outcomes} (or {@link failures}) to see which landed.
- */
-export declare class AuthBatchError extends WebOSError {
-    /** The verb that fanned out — `'check' | 'grant' | 'revoke' | 'bind' | 'unbind'`. */
-    readonly operation: string;
-    /** Positionally-aligned outcome per dispatched entry. */
-    readonly outcomes: readonly AuthBatchOutcome[];
-    constructor(
-    /** The verb that fanned out — `'check' | 'grant' | 'revoke' | 'bind' | 'unbind'`. */
-    operation: string, 
-    /** Positionally-aligned outcome per dispatched entry. */
-    outcomes: readonly AuthBatchOutcome[]);
-    /** The rejected entries only — the subset a caller must react to. */
-    get failures(): readonly AuthBatchOutcome[];
-}
-/**
- * Map a `{ code, message, data }` envelope error to a typed `WebOSError`.
- * The caller is responsible for attaching `ClientErrorDetails` via
- * `withDetails` after mapping.
- */
-export declare function mapServerError(code: number, message: string, data?: unknown): WebOSError;
-/**
- * Attach a full `ClientErrorDetails` record to an error. Typed to require
- * completeness — partial calls fail at compile time — so every thrown
- * error surfaces the invariant set from spec §9.5. Call exactly once per
- * error at the transport → client boundary.
- */
-export declare function withDetails<E extends WebOSError>(error: E, details: ClientErrorDetails): E;
-//# sourceMappingURL=errors.d.ts.map

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

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