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

package/dist/store/types.d.ts

@@ -1,168 +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`.
- */
-import type { Graph, Node, PermName } from '@astrale-os/kernel-core';
-import type { MutationResultWire, OrderInput, PatchBuilder } from '../graph/index.js';
-/**
- * Read options (FRONTEND §4.3 / SHELL_REACT §1.5). The store honors `live`,
- * `window`, and `with` (folded into the shape AST — it participates in the
- * shape key). `suspend`/`keepPrevious` are render-time concerns honored by the
- * React bindings, not the store. Isolation (`scope`) is via `forScope`, not a
- * per-read option; retention is a `createMemory` / `preload` concern.
- */
-export interface ReadOptions {
-    /** default true — a subscribed shape self-invalidates (Tier 0). false = one-shot. */
-    live?: boolean;
-    /** default true — cold shapes await first data (React bindings only). */
-    suspend?: boolean;
-    /** show the previous shape's data while a new one confirms (React bindings only). */
-    keepPrevious?: boolean;
-    /** visibility permission — folded onto the AST, so it keys the shape (READ-only lit up today). */
-    with?: PermName;
-    /** window growth: 'append' (default, infinite) vs 'paged' (replace). */
-    window?: 'append' | 'paged';
-}
-/**
- * Write options (FRONTEND §4.4 / SHELL_REACT §5). Optimistic-auto by default:
- * the authored patch IS the overlay (the six patch arms). `false` skips the
- * overlay and reconciles from the server (server-computed effects); a function
- * supplies a MANUAL overlay patch decoupled from what is dispatched (§1.6 —
- * method dispatch that knows its effect shape).
- */
-export interface MutateOptions {
-    /** default 'auto'. false = no overlay (reconcile from server). fn = manual overlay patch. */
-    optimistic?: 'auto' | false | ((overlay: PatchBuilder) => void);
-    /** default 'auto'. false = keep the overlay on failure (caller reconciles). */
-    rollback?: 'auto' | false;
-    /** invoked with the mutation result once the write commits. */
-    onCommit?: (result: MutationResultWire) => void;
-    /** invoked with the failure once the write rejects (in addition to the error channel). */
-    onError?: (error: unknown) => void;
-    scope?: string;
-}
-/** Window continuation (SHELL_REACT §1.1 `Windowed`). */
-export interface Windowed {
-    readonly more: {
-        readonly has: boolean;
-        load(): Promise<void>;
-        readonly pending: boolean;
-    };
-}
-/**
- * The live read envelope (FRONTEND §4.2). One unified shape carries every
- * accessor; the React bindings project the relevant subset (`node`, `children`,
- * `nodes`/`roots`/`gathered`). `seq` is 0 until the wire carries one (§6.1).
- */
-export interface LiveResult extends Windowed {
-    readonly graph: Graph;
-    readonly roots: readonly Node[];
-    readonly nodes: readonly Node[];
-    readonly first: Node | null;
-    /** `first` — the point-read projection (`useNode`). */
-    readonly node: Node | null;
-    /** ordered descendants under the shape's roots (`useChildren`). */
-    readonly children: readonly Node[];
-    gathered(alias: string): {
-        readonly nodes: readonly Node[];
-        readonly first: Node | null;
-    };
-    /** a (re)validation is in flight; data shown is last-good (stale-while-revalidate). */
-    readonly pending: boolean;
-    /** data is known-stale (a revalidation is due or in flight); last-good shown. */
-    readonly stale: boolean;
-    /** last refresh failure; last-good data retained. */
-    readonly error: unknown;
-    /** Tier-0 self-invalidation active for this shape (observed). */
-    readonly live: boolean;
-    readonly seq: number;
-    refetch(): Promise<void>;
-}
-/** The derived data half of a {@link LiveResult}, built by `materialize`. */
-export interface MaterializedShape {
-    readonly graph: Graph;
-    readonly roots: Node[];
-    readonly nodes: Node[];
-    readonly first: Node | null;
-    readonly children: Node[];
-    gathered(alias: string): {
-        nodes: Node[];
-        first: Node | null;
-    };
-}
-/** One gather step's derived metadata. */
-export interface GatherMeta {
-    readonly as: string;
-    readonly edgeClasses?: string[];
-    readonly dir: 'in' | 'out' | 'both';
-    readonly order?: OrderInput;
-}
-/** A shape's structural metadata, derived once from its canonical AST. */
-export interface ShapeMeta {
-    readonly moveDepth: number;
-    readonly moveClasses?: string[];
-    readonly moveOrder?: OrderInput;
-    readonly gathers: GatherMeta[];
-}
-/** Options for `createMemory`. */
-export interface MemoryOptions {
-    /** default principal/isolation key. */
-    scope?: string;
-    /** retain an unobserved shape this long before release (GC). Default 30s. */
-    ttlMs?: number;
-    /** retain a tombstone this long before sweeping. Default 5min. */
-    tombstoneTtlMs?: number;
-    /** injectable clock (tests). Default `Date.now`. */
-    now?: () => number;
-    /**
-     * Event channel (FRONTEND §5.7 loudness) — warm-read refresh failures,
-     * rolled-back mutations, DIVERGENCE (a dropped overlay differed from the
-     * refetched truth), and (in `dev`) invariant violations.
-     */
-    onError?: (event: MemoryEvent) => void;
-    /**
-     * Enable dev-mode invariant checks after each notify batch (§5.7): no
-     * optimistic ids survive in settled membership, every membership id resolves
-     * in the entity store, listener count == observer count. Violations surface
-     * on {@link MemoryOptions.onError} as `{ kind: 'invariant' }`. Default off.
-     */
-    dev?: boolean;
-    /** max coalesced revalidations in flight per drain (§5.7 operational). Default 4. */
-    concurrency?: number;
-    /** amortized `sweep()` cadence: run GC every N memory ops. Default 128. */
-    sweepEvery?: number;
-}
-/**
- * A surfaced memory event (SHELL_REACT `ShellError` superset). The channel is
- * widened past pure errors so a Tier-0 misprediction is LOUD: when a held
- * display overlay is dropped and the reconciling refetch disagreed with what it
- * showed, a `divergence` event fires. `invariant` events only fire under
- * `dev`. When §6/§7 land and structural optimism returns, `divergence` remains
- * the tripwire that a prediction was wrong.
- */
-export type MemoryEvent = {
-    kind: 'refresh';
-    shape: string;
-    error: unknown;
-} | {
-    kind: 'mutation';
-    mutationId: string;
-    error: unknown;
-} | {
-    kind: 'divergence';
-    shape: string;
-    id: string;
-    detail: string;
-} | {
-    kind: 'invariant';
-    shape: string;
-    detail: string;
-};
-/**
- * Back-compat alias — the event channel was `MemoryError` before it widened to
- * carry divergence/invariant events. A handler that only switches on `refresh`
- * / `mutation` still type-checks; an exhaustive one gains two new arms.
- */
-export type MemoryError = MemoryEvent;
-//# sourceMappingURL=types.d.ts.map

package/dist/store/types.d.ts.map

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

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"}