@astrale-os/kernel-client 0.2.0

package/dist/client/batch.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Type-level helpers for the kernel envelope HTTP batch endpoint.
+ *
+ * Batches are envelope-only — the routed transport has no batching and
+ * throws `UnsupportedTransportError`.
+ */
+import type { CallFns, FnMap, SendResult } from './fn-map';
+/** A batch request entry constrained to known call functions in M. */
+export type TypedBatchRequest<M extends FnMap, K extends CallFns<M> = CallFns<M>> = {
+    [Path in K]: {
+        method: Path;
+        params: M[Path]['params'];
+    };
+}[K];
+/**
+ * Map a tuple of batch requests to a tuple of per-item results. Each
+ * entry is either a discriminated `SendResult<M[K]['result']>` (which
+ * may be a value or a redirect) or a thrown `Error` — never a mix
+ * inside a single position.
+ */
+export type BatchResults<M extends FnMap, Reqs extends readonly TypedBatchRequest<M>[]> = {
+    [I in keyof Reqs]: Reqs[I] extends {
+        method: infer K extends string;
+    } ? K extends keyof M ? SendResult<M[K]['result']> | Error : SendResult<unknown> | Error : SendResult<unknown> | Error;
+};
+//# sourceMappingURL=batch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../../src/client/batch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAE1D,sEAAsE;AACtE,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,KAAK,EAAE,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI;KACjF,IAAI,IAAI,CAAC,GAAG;QAAE,MAAM,EAAE,IAAI,CAAC;QAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAA;KAAE;CACzD,CAAC,CAAC,CAAC,CAAA;AAEJ;;;;;GAKG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,KAAK,EAAE,IAAI,SAAS,SAAS,iBAAiB,CAAC,CAAC,CAAC,EAAE,IAAI;KACvF,CAAC,IAAI,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,SAAS;QAAE,MAAM,EAAE,MAAM,CAAC,SAAS,MAAM,CAAA;KAAE,GACjE,CAAC,SAAS,MAAM,CAAC,GACf,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,KAAK,GAClC,UAAU,CAAC,OAAO,CAAC,GAAG,KAAK,GAC7B,UAAU,CAAC,OAAO,CAAC,GAAG,KAAK;CAChC,CAAA"}

package/dist/client/batch.js

@@ -0,0 +1,8 @@
+/**
+ * Type-level helpers for the kernel envelope HTTP batch endpoint.
+ *
+ * Batches are envelope-only — the routed transport has no batching and
+ * throws `UnsupportedTransportError`.
+ */
+export {};
+//# sourceMappingURL=batch.js.map

package/dist/client/batch.js.map

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

package/dist/client/bound.d.ts

@@ -0,0 +1,27 @@
+import type { CredentialInput } from '@astrale-os/kernel-core';
+import type { Schema } from '@astrale-os/kernel-dsl';
+import type { SchemaTypedClient } from '../schema/proxy-types';
+import type { BatchResults, TypedBatchRequest } from './batch';
+import type { KernelClient } from './client';
+import type { CallOptions } from './config';
+import type { BinaryFns, CallFns, FnMap, SendBinaryResult, SendResult, SendStreamResult, SignalFns, StreamFns } from './fn-map';
+/**
+ * Credential-bound view over a `KernelClient`. Plain value — not a class.
+ * Created by `client.as(credential)`. Each method delegates to the
+ * underlying client, currying the credential in.
+ *
+ * A credential supplier function is also accepted; it's invoked once per
+ * call, so rotated credentials flow through without recreating the view.
+ */
+export type BoundClientView<M extends FnMap> = {
+    readonly url: string;
+    send<K extends CallFns<M>>(method: K, params: M[K]['params'], opts?: CallOptions): Promise<SendResult<M[K]['result']>>;
+    sendStream<K extends StreamFns<M>>(method: K, params: M[K]['params'], opts?: CallOptions): Promise<SendStreamResult<M[K]['result']>>;
+    sendBinary<K extends BinaryFns<M>>(method: K, params: M[K]['params'], opts?: CallOptions): Promise<SendBinaryResult>;
+    signal<K extends SignalFns<M>>(method: K, params: M[K]['params'], opts?: CallOptions): void;
+    batch<const Reqs extends readonly TypedBatchRequest<M>[]>(requests: [...Reqs], opts?: CallOptions): Promise<BatchResults<M, Reqs>>;
+    withSchema<S extends Schema>(schema: S): SchemaTypedClient<S>;
+    as(credential: CredentialInput | (() => CredentialInput)): BoundClientView<M>;
+};
+export declare function createBoundClientView<M extends FnMap>(client: KernelClient<M>, credential: CredentialInput | (() => CredentialInput)): BoundClientView<M>;
+//# sourceMappingURL=bound.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bound.d.ts","sourceRoot":"","sources":["../../src/client/bound.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAEpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAC3C,OAAO,KAAK,EACV,SAAS,EACT,OAAO,EACP,KAAK,EACL,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,SAAS,EACV,MAAM,UAAU,CAAA;AAEjB;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,KAAK,IAAI;IAC7C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,EACvB,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EACtB,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;IACtC,UAAU,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EAC/B,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EACtB,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;IAC5C,UAAU,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EAC/B,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EACtB,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAC5B,MAAM,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,IAAI,CAAA;IAC3F,KAAK,CAAC,KAAK,CAAC,IAAI,SAAS,SAAS,iBAAiB,CAAC,CAAC,CAAC,EAAE,EACtD,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC,EACnB,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;IACjC,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAA;IAC7D,EAAE,CAAC,UAAU,EAAE,eAAe,GAAG,CAAC,MAAM,eAAe,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAA;CAC9E,CAAA;AAED,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,KAAK,EACnD,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EACvB,UAAU,EAAE,eAAe,GAAG,CAAC,MAAM,eAAe,CAAC,GACpD,eAAe,CAAC,CAAC,CAAC,CAYpB"}

package/dist/client/bound.js

@@ -0,0 +1,14 @@
+export function createBoundClientView(client, credential) {
+    const cred = () => (typeof credential === 'function' ? credential() : credential);
+    return {
+        url: client.url,
+        send: (method, params, opts) => client.send(method, params, cred(), opts),
+        sendStream: (method, params, opts) => client.sendStream(method, params, cred(), opts),
+        sendBinary: (method, params, opts) => client.sendBinary(method, params, cred(), opts),
+        signal: (method, params, opts) => client.signal(method, params, cred(), opts),
+        batch: (requests, opts) => client.batch(requests, cred(), opts),
+        withSchema: (schema) => client.withSchema(schema, cred),
+        as: (next) => createBoundClientView(client, next),
+    };
+}
+//# sourceMappingURL=bound.js.map

package/dist/client/bound.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bound.js","sourceRoot":"","sources":["../../src/client/bound.ts"],"names":[],"mappings":"AAoDA,MAAM,UAAU,qBAAqB,CACnC,MAAuB,EACvB,UAAqD;IAErD,MAAM,IAAI,GAAG,GAAoB,EAAE,CAAC,CAAC,OAAO,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAA;IAClG,OAAO;QACL,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,IAAI,CAAC;QACzE,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,IAAI,CAAC;QACrF,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,IAAI,CAAC;QACrF,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,IAAI,CAAC;QAC7E,KAAK,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,IAAI,CAAC;QAC/D,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC;QACvD,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,qBAAqB,CAAC,MAAM,EAAE,IAAI,CAAC;KAClD,CAAA;AACH,CAAC"}

package/dist/client/client.d.ts

@@ -0,0 +1,93 @@
+import type { CredentialInput } from '@astrale-os/kernel-core';
+import type { Schema } from '@astrale-os/kernel-dsl';
+import type { SchemaTypedClient } from '../schema/proxy-types';
+import type { FunctionSchema } from '../schema/types';
+import type { BatchResults, TypedBatchRequest } from './batch';
+import type { BoundClientView } from './bound';
+import type { CallOptions, ClientConfig } from './config';
+import type { BinaryFns, CallFns, FnMap, SendBinaryResult, SendResult, SendStreamResult, SignalFns, StreamFns } from './fn-map';
+/**
+ * KernelClient — one URL, one kernel. Discriminated `Send*Result`s,
+ * no auto-follow, no cross-host pool, no transport fallback. Identity
+ * is opaque — the client forwards credentials onto the wire and never
+ * inspects, compares, or rotates them.
+ *
+ * Four facets:
+ *  - Lean primitives: `send` / `sendStream` / `sendBinary` / `signal` /
+ *    `batch` — surface transport outcomes as-is, no orchestration.
+ *  - Identity views: `as(credential)` returns a `BoundClientView` that
+ *    curries the credential into every call. A value, not a class.
+ *  - Schema proxy: `withSchema(schema)` returns a schema-typed proxy
+ *    that throws `UNHANDLED_REDIRECT` on redirect (use `send` for
+ *    redirect-aware calls).
+ *  - Lifecycle: `disconnect()` releases held resources (open WS).
+ */
+export declare class KernelClient<M extends FnMap = FnMap> {
+    readonly url: string;
+    private readonly defaultTimeout;
+    private readonly defaultTransport;
+    private readonly defaultProtocol;
+    private readonly hooks;
+    private readonly codec;
+    private readonly schema;
+    private readonly httpEnvelope;
+    private readonly httpRouted;
+    private readonly wsFactory;
+    private readonly logger;
+    private ws;
+    private wsState;
+    constructor(config: ClientConfig);
+    send<K extends CallFns<M>>(method: K, params: M[K]['params'], credential: CredentialInput, opts?: CallOptions): Promise<SendResult<M[K]['result']>>;
+    sendStream<K extends StreamFns<M>>(method: K, params: M[K]['params'], credential: CredentialInput, opts?: CallOptions): Promise<SendStreamResult<M[K]['result']>>;
+    sendBinary<K extends BinaryFns<M>>(method: K, params: M[K]['params'], credential: CredentialInput, opts?: CallOptions): Promise<SendBinaryResult>;
+    signal<K extends SignalFns<M>>(method: K, params: M[K]['params'], credential: CredentialInput, opts?: CallOptions): void;
+    batch<const Reqs extends readonly TypedBatchRequest<M>[]>(requests: [...Reqs], credential: CredentialInput, opts?: CallOptions): Promise<BatchResults<M, Reqs>>;
+    as(credential: CredentialInput | (() => CredentialInput)): BoundClientView<M>;
+    /**
+     * Return a schema-typed proxy. `defaultCredential` — used by
+     * `BoundClientView.withSchema` — supplies a credential when the
+     * per-call `ProxyCallOptions.credential` is absent. Unbound callers
+     * that provide neither send a no-auth request; the server decides
+     * whether that's valid (per §9.0.1 the client treats credentials as
+     * opaque and never pre-judges them).
+     */
+    withSchema<S extends Schema>(schema: S, defaultCredential?: () => CredentialInput): SchemaTypedClient<S>;
+    describe(method: string): FunctionSchema | undefined;
+    /**
+     * Release any held resources (open WebSocket). Idempotent. The client
+     * stays reusable — a subsequent `send(...)` lazily re-opens a fresh
+     * WebSocket if the default or per-call transport selects `'ws'`. Resets
+     * the `'auto'` probe state so the next call re-probes.
+     */
+    disconnect(): void;
+    private lookupSchema;
+    /**
+     * Resolve the transport instance + request shape for this call.
+     * `canFallback` signals to `dispatchUnary` that a WS `ConnectionError`
+     * on this attempt should retry on HTTP (auto-mode probe only).
+     */
+    private selectTransport;
+    /**
+     * Resolve `CallTransport` to a concrete envelope pipe. Binary is always
+     * HTTP (server-side WS binary unimplemented). In `'auto'+unknown`, signal
+     * stays on HTTP — fire-and-forget can't communicate fallback.
+     */
+    private resolveEnvelopePipe;
+    private envelopeWs;
+    private buildEnvelopeRequest;
+    private buildRoutedRequest;
+    private dispatchUnary;
+    private dispatchOnce;
+    private beforeCtx;
+    private instrumentStream;
+    private runHooks;
+    /**
+     * Log a hook-layer failure. Only the error's name + message are
+     * surfaced — the error may chain a `cause` that captured a credential
+     * or other sensitive ref by closure, and the client never leaks those
+     * per §9.0.1. Consumers who need full diagnostics provide a
+     * `logger` with their own redaction policy.
+     */
+    private logHookError;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAIpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAErD,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAyC,MAAM,UAAU,CAAA;AAChG,OAAO,KAAK,EACV,SAAS,EACT,OAAO,EACP,KAAK,EACL,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,SAAS,EACV,MAAM,UAAU,CAAA;AAwBjB;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,YAAY,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK;IAC/C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAe;IAChD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuB;IACpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2B;IACrD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,EAAE,CAAmC;IAC7C,OAAO,CAAC,OAAO,CAAkD;IAEjE,YAAY,MAAM,EAAE,YAAY,EAsC/B;IAIK,IAAI,CAAC,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,EAC7B,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EACtB,UAAU,EAAE,eAAe,EAC3B,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAIrC;IAEK,UAAU,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EACrC,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EACtB,UAAU,EAAE,eAAe,EAC3B,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAI3C;IAEK,UAAU,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EACrC,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EACtB,UAAU,EAAE,eAAe,EAC3B,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,gBAAgB,CAAC,CAQ3B;IAED,MAAM,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EAC3B,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EACtB,UAAU,EAAE,eAAe,EAC3B,IAAI,CAAC,EAAE,WAAW,GACjB,IAAI,CAcN;IAEK,KAAK,CAAC,KAAK,CAAC,IAAI,SAAS,SAAS,iBAAiB,CAAC,CAAC,CAAC,EAAE,EAC5D,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC,EACnB,UAAU,EAAE,eAAe,EAC3B,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CA0BhC;IAID,EAAE,CAAC,UAAU,EAAE,eAAe,GAAG,CAAC,MAAM,eAAe,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAE5E;IAED;;;;;;;OAOG;IACH,UAAU,CAAC,CAAC,SAAS,MAAM,EACzB,MAAM,EAAE,CAAC,EACT,iBAAiB,CAAC,EAAE,MAAM,eAAe,GACxC,iBAAiB,CAAC,CAAC,CAAC,CA+BtB;IAED,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEnD;IAID;;;;;OAKG;IACH,UAAU,IAAI,IAAI,CAMjB;IAID,OAAO,CAAC,YAAY;IAIpB;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAuCvB;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,oBAAoB;IA0B5B,OAAO,CAAC,kBAAkB;YA2BZ,aAAa;YAkCb,YAAY;IAiE1B,OAAO,CAAC,SAAS;YAuBF,gBAAgB;YAmBjB,QAAQ;IAatB;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;CAIrB"}

package/dist/client/client.js

@@ -0,0 +1,393 @@
+import { KERNEL_ERROR_CODES, substituteTemplate } from '@astrale-os/kernel-api';
+import { ConnectionError, InvalidTransportError, KernelError, WebOSError, withDetails, } from '../errors/errors';
+import { SchemaRegistry } from '../schema/registry';
+import { createSchemaClient } from '../schema/typed-client';
+import { HttpEnvelopeTransport, HttpRoutedTransport, WsEnvelopeTransport, } from '../transport';
+import { DEFAULT_REQUEST_TIMEOUT_MS } from '../wire/meta';
+import { createBoundClientView } from './bound';
+import { freezeResult } from './freeze';
+/**
+ * KernelClient — one URL, one kernel. Discriminated `Send*Result`s,
+ * no auto-follow, no cross-host pool, no transport fallback. Identity
+ * is opaque — the client forwards credentials onto the wire and never
+ * inspects, compares, or rotates them.
+ *
+ * Four facets:
+ *  - Lean primitives: `send` / `sendStream` / `sendBinary` / `signal` /
+ *    `batch` — surface transport outcomes as-is, no orchestration.
+ *  - Identity views: `as(credential)` returns a `BoundClientView` that
+ *    curries the credential into every call. A value, not a class.
+ *  - Schema proxy: `withSchema(schema)` returns a schema-typed proxy
+ *    that throws `UNHANDLED_REDIRECT` on redirect (use `send` for
+ *    redirect-aware calls).
+ *  - Lifecycle: `disconnect()` releases held resources (open WS).
+ */
+export class KernelClient {
+    url;
+    defaultTimeout;
+    defaultTransport;
+    defaultProtocol;
+    hooks;
+    codec;
+    schema;
+    httpEnvelope;
+    httpRouted;
+    wsFactory;
+    logger;
+    ws = null;
+    wsState = 'unknown';
+    constructor(config) {
+        this.url = config.url.replace(/\/$/, '');
+        this.defaultTimeout = config.requestTimeout ?? DEFAULT_REQUEST_TIMEOUT_MS;
+        this.defaultTransport = config.defaultTransport ?? 'http';
+        this.defaultProtocol = config.defaultProtocol ?? 'envelope';
+        this.hooks = config.hooks ?? {};
+        this.codec = config.codec ?? 'json';
+        this.logger = config.logger ?? console;
+        // Schema: either an existing registry (shared across clients) or an
+        // array we load into a fresh registry. `SchemaRegistry.is` is a duck
+        // check — `instanceof` fails across package duplicates / realms.
+        if (SchemaRegistry.is(config.schema)) {
+            this.schema = config.schema;
+        }
+        else {
+            this.schema = new SchemaRegistry();
+            if (Array.isArray(config.schema) && config.schema.length > 0) {
+                this.schema.load(config.schema);
+            }
+        }
+        this.httpEnvelope = new HttpEnvelopeTransport({
+            url: this.url,
+            codec: this.codec,
+            requestTimeout: this.defaultTimeout,
+            retry: config.retry,
+            fetch: config.fetch,
+        });
+        this.httpRouted = new HttpRoutedTransport({
+            requestTimeout: this.defaultTimeout,
+            fetch: config.fetch,
+        });
+        this.wsFactory = () => new WsEnvelopeTransport({
+            url: this.url,
+            codec: this.codec,
+            requestTimeout: this.defaultTimeout,
+        });
+    }
+    // ─── Transport primitives ─────────────────────────────────────────────────
+    async send(method, params, credential, opts) {
+        return this.dispatchUnary('call', method, params, credential, opts);
+    }
+    async sendStream(method, params, credential, opts) {
+        return this.dispatchUnary('stream', method, params, credential, opts);
+    }
+    async sendBinary(method, params, credential, opts) {
+        return this.dispatchUnary('binary', method, params, credential, opts);
+    }
+    signal(method, params, credential, opts) {
+        const schemaEntry = this.lookupSchema(method, opts);
+        const { transport, transportReq } = this.selectTransport('signal', method, params, credential, opts, schemaEntry);
+        const beforeCtx = this.beforeCtx(method, params, credential, transport.name, transportReq, opts);
+        void this.runHooks('onBeforeSend', beforeCtx);
+        transport.signal(transportReq);
+        void this.runHooks('onAfterSignal', { ...beforeCtx, dispatchedAt: Date.now() });
+    }
+    async batch(requests, credential, opts) {
+        if (requests.length === 0)
+            return [];
+        // Batch uses the envelope transport — the only path with a
+        // multi-request wire shape. Snapshot each entry's schema once so an
+        // external registry mutating mid-dispatch doesn't retarget half the
+        // batch. Mixing routed-only methods in is a policy error — flag it
+        // before any wire work starts.
+        const snapshot = requests.map((r) => ({
+            method: r.method,
+            params: r.params,
+            schema: this.lookupSchema(r.method, opts),
+        }));
+        for (const entry of snapshot) {
+            if (isRoutedOnly(entry.schema)) {
+                throw new InvalidTransportError(`Method "${entry.method}" has a route binding; batch only supports envelope calls`);
+            }
+        }
+        const transportRequests = snapshot.map((entry) => this.buildEnvelopeRequest(entry.method, entry.params, credential, opts, entry.schema));
+        const entries = await this.httpEnvelope.batch(transportRequests);
+        return entries;
+    }
+    // ─── Identity & schema views ──────────────────────────────────────────────
+    as(credential) {
+        return createBoundClientView(this, credential);
+    }
+    /**
+     * Return a schema-typed proxy. `defaultCredential` — used by
+     * `BoundClientView.withSchema` — supplies a credential when the
+     * per-call `ProxyCallOptions.credential` is absent. Unbound callers
+     * that provide neither send a no-auth request; the server decides
+     * whether that's valid (per §9.0.1 the client treats credentials as
+     * opaque and never pre-judges them).
+     */
+    withSchema(schema, defaultCredential) {
+        return createSchemaClient(async (method, params, credential, opts) => {
+            const effective = (credential ?? defaultCredential?.() ?? '');
+            const result = await this.send(method, params, effective, opts);
+            if (result.kind === 'redirect') {
+                // Proxy is value-path only by contract (§9.4). Callers wanting
+                // redirect awareness use `client.send` directly.
+                const err = new KernelError(`Unhandled redirect: "${method}" resolved to ${result.redirection.url}. ` +
+                    `Use client.send() to handle redirects explicitly.`, KERNEL_ERROR_CODES.INTERNAL_ERROR, 'UNHANDLED_REDIRECT');
+                withDetails(err, {
+                    method: String(method),
+                    params,
+                    url: this.url,
+                    transport: result.meta.transport,
+                    correlationId: opts?.correlationId,
+                    meta: result.meta,
+                    redirection: result.redirection,
+                });
+                throw err;
+            }
+            return result.value;
+        }, schema);
+    }
+    describe(method) {
+        return this.schema.get(method);
+    }
+    // ─── Connection lifecycle ─────────────────────────────────────────────────
+    /**
+     * Release any held resources (open WebSocket). Idempotent. The client
+     * stays reusable — a subsequent `send(...)` lazily re-opens a fresh
+     * WebSocket if the default or per-call transport selects `'ws'`. Resets
+     * the `'auto'` probe state so the next call re-probes.
+     */
+    disconnect() {
+        this.ws?.disconnect();
+        this.ws = null;
+        this.httpEnvelope.disconnect();
+        this.httpRouted.disconnect();
+        this.wsState = 'unknown';
+    }
+    // ─── Internals ────────────────────────────────────────────────────────────
+    lookupSchema(method, opts) {
+        return this.schema.resolve(method, opts?.class) ?? this.schema.get(method);
+    }
+    /**
+     * Resolve the transport instance + request shape for this call.
+     * `canFallback` signals to `dispatchUnary` that a WS `ConnectionError`
+     * on this attempt should retry on HTTP (auto-mode probe only).
+     */
+    selectTransport(kind, method, params, credential, opts, schemaEntry) {
+        const requested = opts?.transport ?? this.defaultTransport;
+        const protocol = opts?.protocol ?? this.defaultProtocol;
+        const binding = schemaEntry?.binding;
+        const route = binding?.route;
+        const remoteUrl = opts?.url ?? binding?.remoteUrl;
+        const preferRoute = protocol === 'auto' && !!route;
+        if (preferRoute) {
+            if (!remoteUrl) {
+                // Binding without remoteUrl is a schema misconfig — caller can
+                // still rescue by passing opts.url, but both missing is broken.
+                throw new InvalidTransportError(`Method "${method}" declares a route binding but has no remoteUrl; ` +
+                    `register a schema with binding.remoteUrl or pass opts.url`);
+            }
+            return {
+                transport: this.httpRouted,
+                transportReq: this.buildRoutedRequest(method, params, credential, opts, route, remoteUrl),
+                canFallback: false,
+            };
+        }
+        const resolved = this.resolveEnvelopePipe(requested, kind);
+        return {
+            transport: resolved === 'ws' ? this.envelopeWs() : this.httpEnvelope,
+            transportReq: this.buildEnvelopeRequest(method, params, credential, opts, schemaEntry),
+            canFallback: requested === 'auto' && resolved === 'ws' && this.wsState === 'unknown',
+        };
+    }
+    /**
+     * Resolve `CallTransport` to a concrete envelope pipe. Binary is always
+     * HTTP (server-side WS binary unimplemented). In `'auto'+unknown`, signal
+     * stays on HTTP — fire-and-forget can't communicate fallback.
+     */
+    resolveEnvelopePipe(requested, kind) {
+        if (kind === 'binary')
+            return 'http';
+        if (requested === 'http')
+            return 'http';
+        if (requested === 'ws')
+            return 'ws';
+        if (this.wsState === 'unavailable')
+            return 'http';
+        if (this.wsState === 'proven')
+            return 'ws';
+        return kind === 'signal' ? 'http' : 'ws';
+    }
+    envelopeWs() {
+        if (!this.ws)
+            this.ws = this.wsFactory();
+        return this.ws;
+    }
+    buildEnvelopeRequest(method, params, credential, opts, schemaEntry) {
+        const binding = schemaEntry?.binding;
+        const remoteUrl = opts?.url ?? binding?.remoteUrl;
+        const url = remoteUrl && params && typeof params === 'object'
+            ? substituteTemplate(remoteUrl, params)
+            : remoteUrl;
+        return {
+            method,
+            params,
+            credential,
+            timeout: opts?.timeout ?? this.defaultTimeout,
+            signal: opts?.signal,
+            correlationId: opts?.correlationId,
+            url,
+            ...(opts?.self !== undefined && { self: opts.self }),
+        };
+    }
+    buildRoutedRequest(method, params, credential, opts, route, remoteUrl) {
+        return {
+            method,
+            params: params ?? {},
+            credential,
+            timeout: opts?.timeout ?? this.defaultTimeout,
+            signal: opts?.signal,
+            correlationId: opts?.correlationId,
+            route,
+            remoteUrl,
+        };
+    }
+    /**
+     * Unary dispatch (call / stream / binary). Selects transport, fires
+     * `onBeforeSend`, awaits the transport, freezes the result (deeply,
+     * including `meta.wire`), wraps streams in the observability
+     * iterator, fires `onAfterReceive`, and decorates errors with
+     * `ClientErrorDetails` if the transport didn't already.
+     */
+    async dispatchUnary(kind, method, params, credential, opts) {
+        const schemaEntry = this.lookupSchema(method, opts);
+        const selection = this.selectTransport(kind, method, params, credential, opts, schemaEntry);
+        try {
+            return await this.dispatchOnce(kind, method, params, credential, opts, selection, !selection.canFallback);
+        }
+        catch (err) {
+            if (selection.canFallback && err instanceof ConnectionError) {
+                this.wsState = 'unavailable';
+                const httpSel = this.selectTransport(kind, method, params, credential, opts, schemaEntry);
+                return this.dispatchOnce(kind, method, params, credential, opts, httpSel, true);
+            }
+            throw err;
+        }
+    }
+    /**
+     * One dispatch attempt: hooks + wire + freeze. `fireErrorHook = false`
+     * suppresses `onError` so a recovered auto-mode WS probe failure doesn't
+     * surface as a phantom error when the fallback HTTP call succeeds.
+     */
+    async dispatchOnce(kind, method, params, credential, opts, selection, fireErrorHook) {
+        const { transport, transportReq } = selection;
+        const beforeCtx = this.beforeCtx(method, params, credential, transport.name, transportReq, opts);
+        await this.runHooks('onBeforeSend', beforeCtx);
+        try {
+            const raw = kind === 'call'
+                ? await transport.call(transportReq)
+                : kind === 'stream'
+                    ? await transport.stream(transportReq)
+                    : await transport.binary(transportReq);
+            if (transport.name === 'ws-envelope' && this.wsState === 'unknown') {
+                this.wsState = 'proven';
+            }
+            // For streams, wrap `chunks` in the instrumented iterable BEFORE
+            // freezing — hook and caller must see the same iterable so a hook
+            // that iterates doesn't steal frames from the caller.
+            const toFreeze = raw.kind === 'stream' && this.hooks.onStreamFrame
+                ? {
+                    ...raw,
+                    chunks: this.instrumentStream(raw.chunks, beforeCtx, raw.meta),
+                }
+                : raw;
+            const frozen = freezeResult(toFreeze);
+            await this.runHooks('onAfterReceive', {
+                ...beforeCtx,
+                result: frozen,
+                meta: frozen.meta,
+            });
+            return frozen;
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            if (error instanceof WebOSError && !error.details) {
+                withDetails(error, {
+                    method,
+                    params,
+                    url: transport.url ?? this.url,
+                    transport: transport.name,
+                    correlationId: opts?.correlationId,
+                });
+            }
+            if (fireErrorHook) {
+                await this.runHooks('onError', {
+                    ...beforeCtx,
+                    error,
+                    meta: error.details?.meta,
+                });
+            }
+            throw error;
+        }
+    }
+    beforeCtx(method, params, credential, transport, transportReq, opts) {
+        return {
+            method,
+            params,
+            credential,
+            transport,
+            url: transportReq.url ?? this.url,
+            correlationId: opts?.correlationId,
+        };
+    }
+    /**
+     * Wrap a stream iterable so each chunk fires `onStreamFrame`. Errors
+     * during hook evaluation are swallowed per the hook contract (pure
+     * observation); a hook that misbehaves never aborts the stream.
+     */
+    async *instrumentStream(chunks, beforeCtx, meta) {
+        let index = 0;
+        for await (const data of chunks) {
+            if (this.hooks.onStreamFrame) {
+                try {
+                    await this.hooks.onStreamFrame({ ...beforeCtx, index, data, meta });
+                }
+                catch (err) {
+                    this.logHookError('onStreamFrame', err);
+                }
+            }
+            index++;
+            yield data;
+        }
+    }
+    async runHooks(key, ctx) {
+        const hook = this.hooks[key];
+        if (!hook)
+            return;
+        try {
+            await hook(ctx);
+        }
+        catch (err) {
+            this.logHookError(key, err);
+        }
+    }
+    /**
+     * Log a hook-layer failure. Only the error's name + message are
+     * surfaced — the error may chain a `cause` that captured a credential
+     * or other sensitive ref by closure, and the client never leaks those
+     * per §9.0.1. Consumers who need full diagnostics provide a
+     * `logger` with their own redaction policy.
+     */
+    logHookError(key, err) {
+        const e = err instanceof Error ? err : new Error(String(err));
+        this.logger.error(`[kernel-client] hook "${key}" threw: ${e.name}: ${e.message}`);
+    }
+}
+function isRoutedOnly(schema) {
+    if (!schema)
+        return false;
+    const binding = schema.binding;
+    return !!binding?.route;
+}
+//# sourceMappingURL=client.js.map

package/dist/client/client.js.map

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