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

package/dist/store/store.typecheck.js

@@ -0,0 +1,41 @@
+import { Query } from '../graph/index.js';
+const options = { page: { size: 32 } };
+const nodeGraph = Query.from({ kind: 'node', paths: [path] }).select({ kind: 'graph' });
+const nodeProjection = Query.from({ kind: 'node', paths: [path] }).select({
+    kind: 'nodes',
+    projection: { kind: 'reference' },
+});
+const edgeSource = Query.from({ kind: 'edge', definitions: [edge] });
+const edgeProjection = edgeSource.select({
+    kind: 'edges',
+    projection: { edge: 'reference', source: 'value', target: 'reference' },
+});
+const read = store.read(nodeGraph, options);
+const peek = store.peek(nodeProjection, options);
+const snapshot = store.getSnapshot(edgeProjection, options);
+// @ts-expect-error ready is the successful local snapshot state; fresh is retired.
+const retiredFreshSnapshot = { state: 'fresh' };
+void retiredFreshSnapshot;
+store.subscribe(nodeGraph, () => undefined, options);
+store.observe(nodeProjection, (value) => {
+    if ('response' in value && value.response !== undefined) {
+        const result = value.response.result;
+        void result;
+    }
+}, options);
+// @ts-expect-error Query-page identity is required for every observed Store shape.
+store.read(nodeGraph);
+// @ts-expect-error Query-page identity is required for cache peeks.
+store.peek(nodeGraph);
+// @ts-expect-error Query-page identity is required for preloading.
+store.preload(nodeGraph);
+// @ts-expect-error Query-page identity is required for subscriptions.
+store.subscribe(nodeGraph, () => undefined);
+// @ts-expect-error Query-page identity is required for snapshot lookup.
+store.getSnapshot(nodeGraph);
+// @ts-expect-error Query-page identity is required for observations.
+store.observe(nodeGraph, () => undefined);
+// @ts-expect-error watch is reserved for a future remote-liveness protocol.
+store.watch(nodeGraph, () => undefined, options);
+void {};
+//# sourceMappingURL=store.typecheck.js.map

package/dist/store/store.typecheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.typecheck.js","sourceRoot":"","sources":["../../store/store.typecheck.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAMzC,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAW,CAAA;AAC/C,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAA;AACvF,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC;IACxE,IAAI,EAAE,OAAO;IACb,UAAU,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;CAClC,CAAC,CAAA;AACF,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AACpE,MAAM,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,OAAO;IACb,UAAU,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE;CACxE,CAAC,CAAA;AAEF,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;AAC3C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,CAAA;AAChD,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,cAAc,EAAE,OAAO,CAAC,CAAA;AAC3D,mFAAmF;AACnF,MAAM,oBAAoB,GAAkB,EAAE,KAAK,EAAE,OAAO,EAAE,CAAA;AAC9D,KAAK,oBAAoB,CAAA;AAEzB,KAAK,CAAC,SAAS,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;AACpD,KAAK,CAAC,OAAO,CACX,cAAc,EACd,CAAC,KAAK,EAAE,EAAE;IACR,IAAI,UAAU,IAAI,KAAK,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACxD,MAAM,MAAM,GAAoD,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAA;QACrF,KAAK,MAAM,CAAA;IACb,CAAC;AACH,CAAC,EACD,OAAO,CACR,CAAA;AAED,mFAAmF;AACnF,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;AACrB,oEAAoE;AACpE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;AACrB,mEAAmE;AACnE,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;AACxB,sEAAsE;AACtE,KAAK,CAAC,SAAS,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;AAC3C,wEAAwE;AACxE,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC,CAAA;AAC5B,qEAAqE;AACrE,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;AACzC,4EAA4E;AAC5E,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;AAkChD,KAAM,EAAsB,CAAA"}

package/dist/transport/auto/decision.d.ts

@@ -0,0 +1,23 @@
+export type AutoSelection = 'websocket' | 'http';
+export type AutoDecisionTicket = {
+    readonly kind: 'selected';
+    readonly selection: AutoSelection;
+} | {
+    readonly kind: 'wait';
+    readonly selection: Promise<AutoSelection | undefined>;
+} | {
+    readonly kind: 'probe';
+};
+/** Serializes the one initial transport decision without retaining invocation values. */
+export declare class AutoDecision {
+    private selected;
+    private pending;
+    private closed;
+    begin(): AutoDecisionTicket;
+    select(selection: AutoSelection): void;
+    /** Permanently degrade a prior or pending WebSocket selection to HTTP. */
+    demote(): void;
+    release(): void;
+    close(): void;
+}
+//# sourceMappingURL=decision.d.ts.map

package/dist/transport/auto/decision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision.d.ts","sourceRoot":"","sources":["../../../transport/auto/decision.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,MAAM,CAAA;AAEhD,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAA;CAAE,GAChE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAA;CAAE,GACjF;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAA;AAE9B,yFAAyF;AACzF,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,OAAO,CAKF;IACb,OAAO,CAAC,MAAM,CAAQ;IAEtB,KAAK,IAAI,kBAAkB,CAU1B;IAED,MAAM,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI,CAKrC;IAED,0EAA0E;IAC1E,MAAM,IAAI,IAAI,CAKb;IAED,OAAO,IAAI,IAAI,CAId;IAED,KAAK,IAAI,IAAI,CAKZ;CACF"}

package/dist/transport/auto/decision.js

@@ -0,0 +1,49 @@
+/** Serializes the one initial transport decision without retaining invocation values. */
+export class AutoDecision {
+    selected;
+    pending;
+    closed = false;
+    begin() {
+        if (this.closed)
+            return { kind: 'wait', selection: Promise.resolve(undefined) };
+        if (this.selected)
+            return { kind: 'selected', selection: this.selected };
+        if (this.pending)
+            return { kind: 'wait', selection: this.pending.promise };
+        let resolve;
+        const promise = new Promise((settle) => {
+            resolve = settle;
+        });
+        this.pending = { promise, resolve };
+        return { kind: 'probe' };
+    }
+    select(selection) {
+        if (this.closed || this.selected)
+            return;
+        this.selected = selection;
+        this.pending?.resolve(selection);
+        this.pending = undefined;
+    }
+    /** Permanently degrade a prior or pending WebSocket selection to HTTP. */
+    demote() {
+        if (this.closed || this.selected === 'http')
+            return;
+        this.selected = 'http';
+        this.pending?.resolve('http');
+        this.pending = undefined;
+    }
+    release() {
+        if (this.closed || this.selected)
+            return;
+        this.pending?.resolve(undefined);
+        this.pending = undefined;
+    }
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.pending?.resolve(undefined);
+        this.pending = undefined;
+    }
+}
+//# sourceMappingURL=decision.js.map

package/dist/transport/auto/decision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision.js","sourceRoot":"","sources":["../../../transport/auto/decision.ts"],"names":[],"mappings":"AAOA,yFAAyF;AACzF,MAAM,OAAO,YAAY;IACf,QAAQ,CAA2B;IACnC,OAAO,CAKF;IACL,MAAM,GAAG,KAAK,CAAA;IAEtB,KAAK;QACH,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAA;QAC/E,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAA;QACxE,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAA;QAC1E,IAAI,OAAwD,CAAA;QAC5D,MAAM,OAAO,GAAG,IAAI,OAAO,CAA4B,CAAC,MAAM,EAAE,EAAE;YAChE,OAAO,GAAG,MAAM,CAAA;QAClB,CAAC,CAAC,CAAA;QACF,IAAI,CAAC,OAAO,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,CAAA;QACnC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;IAC1B,CAAC;IAED,MAAM,CAAC,SAAwB;QAC7B,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAM;QACxC,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAA;QACzB,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAA;QAChC,IAAI,CAAC,OAAO,GAAG,SAAS,CAAA;IAC1B,CAAC;IAED,0EAA0E;IAC1E,MAAM;QACJ,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,KAAK,MAAM;YAAE,OAAM;QACnD,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAA;QACtB,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;QAC7B,IAAI,CAAC,OAAO,GAAG,SAAS,CAAA;IAC1B,CAAC;IAED,OAAO;QACL,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAM;QACxC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAA;QAChC,IAAI,CAAC,OAAO,GAAG,SAAS,CAAA;IAC1B,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,MAAM;YAAE,OAAM;QACvB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QAClB,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAA;QAChC,IAAI,CAAC,OAAO,GAAG,SAAS,CAAA;IAC1B,CAAC;CACF"}

package/dist/transport/auto/fallback.d.ts

@@ -0,0 +1,17 @@
+import type { RequestOptions, TransportRequest } from '../index.js';
+import { TransportError } from '../../errors/index.js';
+/** One invocation-owned total timeout budget shared by selection and fallback. */
+export declare class InvocationBudget {
+    private readonly input;
+    private readonly started;
+    private readonly timeoutMs;
+    constructor(input: RequestOptions | undefined, defaultTimeoutMs: number);
+    options(): RequestOptions;
+    get cancelled(): boolean;
+    get idempotency(): 'supplied' | 'absent';
+    wait(decision: Promise<'websocket' | 'http' | undefined>): Promise<'websocket' | 'http' | undefined>;
+    private remaining;
+}
+export declare function mayFallback(error: unknown): error is TransportError;
+export declare function warningTarget(input: TransportRequest): TransportRequest['call']['target'];
+//# sourceMappingURL=fallback.d.ts.map

package/dist/transport/auto/fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback.d.ts","sourceRoot":"","sources":["../../../transport/auto/fallback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEnE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAKtD,kFAAkF;AAClF,qBAAa,gBAAgB;IAKzB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAElC,YACmB,KAAK,EAAE,cAAc,GAAG,SAAS,EAClD,gBAAgB,EAAE,MAAM,EAGzB;IAED,OAAO,IAAI,cAAc,CASxB;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,WAAW,IAAI,UAAU,GAAG,QAAQ,CAEvC;IAEK,IAAI,CACR,QAAQ,EAAE,OAAO,CAAC,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC,GAClD,OAAO,CAAC,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC,CA2B3C;IAED,OAAO,CAAC,SAAS;CAUlB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAEnE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,gBAAgB,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAEzF"}

package/dist/transport/auto/fallback.js

@@ -0,0 +1,77 @@
+import { TransportError } from '../../errors/index.js';
+import { positiveInteger } from '../index.js';
+const MAXIMUM_TIMEOUT_MS = 2_147_483_647;
+/** One invocation-owned total timeout budget shared by selection and fallback. */
+export class InvocationBudget {
+    input;
+    started = Date.now();
+    timeoutMs;
+    constructor(input, defaultTimeoutMs) {
+        this.input = input;
+        this.timeoutMs = positiveInteger(input?.timeoutMs ?? defaultTimeoutMs, 'timeoutMs');
+    }
+    options() {
+        const remaining = this.remaining();
+        return Object.freeze({
+            ...(this.input?.signal === undefined ? {} : { signal: this.input.signal }),
+            timeoutMs: remaining,
+            ...(this.input?.idempotencyKey === undefined
+                ? {}
+                : { idempotencyKey: this.input.idempotencyKey }),
+        });
+    }
+    get cancelled() {
+        return this.input?.signal?.aborted === true;
+    }
+    get idempotency() {
+        return this.input?.idempotencyKey === undefined ? 'absent' : 'supplied';
+    }
+    async wait(decision) {
+        if (this.input?.signal?.aborted)
+            throw abortReason(this.input.signal);
+        const remaining = this.remaining();
+        let timer;
+        let abort;
+        const interrupted = new Promise((_resolve, reject) => {
+            timer = setTimeout(() => reject(new TransportError('Automatic transport decision exceeded its timeout.', {
+                phase: 'timeout',
+                delivery: 'not-sent',
+            })), remaining);
+            if (this.input?.signal) {
+                abort = () => reject(abortReason(this.input.signal));
+                this.input.signal.addEventListener('abort', abort, { once: true });
+            }
+        });
+        try {
+            return await Promise.race([decision, interrupted]);
+        }
+        finally {
+            if (timer)
+                clearTimeout(timer);
+            if (abort && this.input?.signal)
+                this.input.signal.removeEventListener('abort', abort);
+        }
+    }
+    remaining() {
+        const remaining = Math.min(MAXIMUM_TIMEOUT_MS, this.timeoutMs - (Date.now() - this.started));
+        if (remaining < 1) {
+            throw new TransportError('Automatic transport invocation exceeded its timeout.', {
+                phase: 'timeout',
+                delivery: 'not-sent',
+            });
+        }
+        return remaining;
+    }
+}
+export function mayFallback(error) {
+    return error instanceof TransportError && error.phase !== 'closed' && error.phase !== 'timeout';
+}
+export function warningTarget(input) {
+    return input.call.target;
+}
+function abortReason(signal) {
+    return signal.reason instanceof Error
+        ? signal.reason
+        : new Error(signal.reason === undefined ? 'request was cancelled' : String(signal.reason));
+}
+//# sourceMappingURL=fallback.js.map

package/dist/transport/auto/fallback.js.map

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

package/dist/transport/auto/index.d.ts

@@ -0,0 +1,3 @@
+export { AutoTransport, type AutoTransportOptions } from './transport.js';
+export { formatClientWarning, type ClientWarning } from './warning.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/transport/auto/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../transport/auto/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AACzE,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAA"}

package/dist/transport/auto/index.js

@@ -0,0 +1,3 @@
+export { AutoTransport } from './transport.js';
+export { formatClientWarning } from './warning.js';
+//# sourceMappingURL=index.js.map

package/dist/transport/auto/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../transport/auto/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAA6B,MAAM,gBAAgB,CAAA;AACzE,OAAO,EAAE,mBAAmB,EAAsB,MAAM,cAAc,CAAA"}

package/dist/transport/auto/transport.d.ts

@@ -0,0 +1,38 @@
+import type { Fetch } from '../http/index.js';
+import type { RequestOptions, Transport, TransportRequest, TransportResult } from '../index.js';
+import type { WebSocketConstructor } from '../websocket/index.js';
+import type { ClientWarning } from './warning.js';
+export interface AutoTransportOptions {
+    readonly endpoints: {
+        readonly http: string;
+        readonly websocket: string;
+    };
+    readonly codec?: 'json' | 'msgpack';
+    readonly fetch?: Fetch;
+    readonly websocket?: WebSocketConstructor;
+    readonly headers?: Readonly<Record<string, string>>;
+    readonly timeoutMs?: number;
+    readonly maximumRequestBytes?: number;
+    readonly maximumResponseBytes?: number;
+    readonly maximumBufferedBytes?: number;
+    readonly maximumActiveInvocations?: number;
+    readonly maximumBufferedStreamItems?: number;
+    readonly onWarning?: (warning: ClientWarning) => void;
+}
+/** Sticky WebSocket-first Transport with one delivery-aware HTTP fallback decision. */
+export declare class AutoTransport implements Transport {
+    private readonly websocket;
+    private readonly http;
+    private readonly decision;
+    private readonly timeoutMs;
+    private readonly onWarning;
+    private closed;
+    constructor(options: AutoTransportOptions);
+    dispatch(input: TransportRequest, options?: RequestOptions): Promise<TransportResult>;
+    private dispatchWithBudget;
+    close(): void;
+    private determine;
+    private tryWebsocket;
+    private requireOpen;
+}
+//# sourceMappingURL=transport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../transport/auto/transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC/F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAUjD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IACzE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,oBAAoB,CAAA;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACnD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;IACrC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAA;IACtC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAA;IACtC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAA;IAC1C,QAAQ,CAAC,0BAA0B,CAAC,EAAE,MAAM,CAAA;IAC5C,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAA;CACtD;AAID,uFAAuF;AACvF,qBAAa,aAAc,YAAW,SAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgD;IAC1E,OAAO,CAAC,MAAM,CAAQ;IAEtB,YAAY,OAAO,EAAE,oBAAoB,EA2CxC;IAEK,QAAQ,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAI1F;YAEa,kBAAkB;IAqBhC,KAAK,IAAI,IAAI,CAKZ;YAEa,SAAS;YAOT,YAAY;IAwC1B,OAAO,CAAC,WAAW;CAOpB"}

package/dist/transport/auto/transport.js

@@ -0,0 +1,141 @@
+import { TransportError } from '../../errors/index.js';
+import { HttpTransport } from '../http/index.js';
+import { positiveInteger } from '../index.js';
+import { WebSocketTransport } from '../websocket/index.js';
+import { AutoDecision } from './decision.js';
+import { InvocationBudget, mayFallback, warningTarget } from './fallback.js';
+import { emitWarning } from './warning.js';
+const DEFAULT_TIMEOUT_MS = 30_000;
+/** Sticky WebSocket-first Transport with one delivery-aware HTTP fallback decision. */
+export class AutoTransport {
+    websocket;
+    http;
+    decision = new AutoDecision();
+    timeoutMs;
+    onWarning;
+    closed = false;
+    constructor(options) {
+        if (options === null || typeof options !== 'object') {
+            throw new TypeError('AutoTransport options must be an object.');
+        }
+        if (options.onWarning !== undefined && typeof options.onWarning !== 'function') {
+            throw new TypeError('AutoTransport onWarning must be a function.');
+        }
+        this.timeoutMs = positiveInteger(options.timeoutMs ?? DEFAULT_TIMEOUT_MS, 'timeoutMs');
+        this.onWarning = options.onWarning;
+        this.http = new HttpTransport({
+            url: options.endpoints.http,
+            ...(options.codec === undefined ? {} : { codec: options.codec }),
+            ...(options.fetch === undefined ? {} : { fetch: options.fetch }),
+            ...(options.headers === undefined ? {} : { headers: options.headers }),
+            timeoutMs: this.timeoutMs,
+            ...(options.maximumRequestBytes === undefined
+                ? {}
+                : { maximumRequestBytes: options.maximumRequestBytes }),
+            ...(options.maximumResponseBytes === undefined
+                ? {}
+                : { maximumResponseBytes: options.maximumResponseBytes }),
+        });
+        this.websocket = new WebSocketTransport({
+            url: options.endpoints.websocket,
+            ...(options.codec === undefined ? {} : { codec: options.codec }),
+            ...(options.websocket === undefined ? {} : { websocket: options.websocket }),
+            timeoutMs: this.timeoutMs,
+            ...(options.maximumRequestBytes === undefined
+                ? {}
+                : { maximumRequestBytes: options.maximumRequestBytes }),
+            ...(options.maximumResponseBytes === undefined
+                ? {}
+                : { maximumResponseBytes: options.maximumResponseBytes }),
+            ...(options.maximumBufferedBytes === undefined
+                ? {}
+                : { maximumBufferedBytes: options.maximumBufferedBytes }),
+            ...(options.maximumActiveInvocations === undefined
+                ? {}
+                : { maximumActiveInvocations: options.maximumActiveInvocations }),
+            ...(options.maximumBufferedStreamItems === undefined
+                ? {}
+                : { maximumBufferedStreamItems: options.maximumBufferedStreamItems }),
+        });
+    }
+    async dispatch(input, options) {
+        this.requireOpen();
+        const budget = new InvocationBudget(options, this.timeoutMs);
+        return this.dispatchWithBudget(input, budget);
+    }
+    async dispatchWithBudget(input, budget) {
+        const ticket = this.decision.begin();
+        if (ticket.kind === 'selected') {
+            return ticket.selection === 'websocket'
+                ? this.tryWebsocket(input, budget, false)
+                : this.http.dispatch(input, budget.options());
+        }
+        if (ticket.kind === 'wait') {
+            const selection = await budget.wait(ticket.selection);
+            this.requireOpen();
+            if (!selection)
+                return this.dispatchWithBudget(input, budget);
+            return selection === 'websocket'
+                ? this.tryWebsocket(input, budget, false)
+                : this.http.dispatch(input, budget.options());
+        }
+        return this.determine(input, budget);
+    }
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.decision.close();
+        this.websocket.close();
+    }
+    async determine(input, budget) {
+        return this.tryWebsocket(input, budget, true);
+    }
+    async tryWebsocket(input, budget, probing) {
+        try {
+            const result = await this.websocket.dispatch(input, budget.options());
+            if (probing)
+                this.decision.select('websocket');
+            return result;
+        }
+        catch (error) {
+            if (budget.cancelled) {
+                if (probing)
+                    this.decision.release();
+                throw error;
+            }
+            if (error instanceof TransportError && error.delivery === 'unknown') {
+                this.decision.demote();
+                throw error;
+            }
+            if (!mayFallback(error)) {
+                if (probing) {
+                    this.decision.select('websocket');
+                }
+                throw error;
+            }
+            const idempotency = budget.idempotency;
+            const warning = {
+                code: 'AUTO_TRANSPORT_DOWNGRADED',
+                target: warningTarget(input),
+                websocket: this.websocket.url,
+                http: this.http.url,
+                phase: error.phase,
+                delivery: 'not-sent',
+                idempotency,
+            };
+            emitWarning(Object.freeze(warning), this.onWarning);
+            this.decision.demote();
+            return this.http.dispatch(input, budget.options());
+        }
+    }
+    requireOpen() {
+        if (!this.closed)
+            return;
+        throw new TransportError('AutoTransport is closed.', {
+            phase: 'closed',
+            delivery: 'not-sent',
+        });
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport/auto/transport.js.map

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

package/dist/transport/auto/warning.d.ts

@@ -0,0 +1,14 @@
+import type { NodePath } from '@astrale-os/kernel-core/path';
+import type { TransportPhase } from '../../errors/index.js';
+export interface ClientWarning {
+    readonly code: 'AUTO_TRANSPORT_DOWNGRADED';
+    readonly target: NodePath;
+    readonly websocket: string;
+    readonly http: string;
+    readonly phase: TransportPhase;
+    readonly delivery: 'not-sent';
+    readonly idempotency: 'supplied' | 'absent';
+}
+export declare function formatClientWarning(warning: ClientWarning): string;
+export declare function emitWarning(warning: ClientWarning, observer: ((warning: ClientWarning) => void) | undefined): void;
+//# sourceMappingURL=warning.d.ts.map

package/dist/transport/auto/warning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warning.d.ts","sourceRoot":"","sources":["../../../transport/auto/warning.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAE3D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAA;IAC1C,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;IAC9B,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAA;IAC7B,QAAQ,CAAC,WAAW,EAAE,UAAU,GAAG,QAAQ,CAAA;CAC5C;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAMlE;AAED,wBAAgB,WAAW,CACzB,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAC,GAAG,SAAS,GACvD,IAAI,CAON"}

package/dist/transport/auto/warning.js

@@ -0,0 +1,19 @@
+export function formatClientWarning(warning) {
+    return [
+        '[Astrale] WebSocket was unavailable before send; using HTTP for this client.',
+        `idempotency=${warning.idempotency}`,
+        `target=${JSON.stringify(warning.target)} websocket=${warning.websocket} http=${warning.http} phase=${warning.phase}`,
+    ].join(' ');
+}
+export function emitWarning(warning, observer) {
+    try {
+        if (observer)
+            observer(warning);
+        else
+            globalThis.console?.warn(formatClientWarning(warning));
+    }
+    catch {
+        // Warning observation cannot change invocation settlement.
+    }
+}
+//# sourceMappingURL=warning.js.map

package/dist/transport/auto/warning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"warning.js","sourceRoot":"","sources":["../../../transport/auto/warning.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,mBAAmB,CAAC,OAAsB;IACxD,OAAO;QACL,8EAA8E;QAC9E,eAAe,OAAO,CAAC,WAAW,EAAE;QACpC,UAAU,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,OAAO,CAAC,SAAS,SAAS,OAAO,CAAC,IAAI,UAAU,OAAO,CAAC,KAAK,EAAE;KACtH,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACb,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,OAAsB,EACtB,QAAwD;IAExD,IAAI,CAAC;QACH,IAAI,QAAQ;YAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;;YAC1B,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAA;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,2DAA2D;IAC7D,CAAC;AACH,CAAC"}

package/dist/transport/deadline.d.ts

@@ -0,0 +1,12 @@
+export interface ControlledSignal {
+    readonly signal: AbortSignal;
+    readonly timedOut: boolean;
+    cancel(reason?: unknown): void;
+    close(): void;
+}
+/** One caller signal plus one transport-owned lifetime deadline. */
+export declare function controlledSignal(parent: AbortSignal | undefined, timeoutMs: number): ControlledSignal;
+export declare function positiveInteger(input: number, label: string): number;
+export declare function requireLive(control: ControlledSignal): void;
+export declare function asError(value: unknown): Error;
+//# sourceMappingURL=deadline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deadline.d.ts","sourceRoot":"","sources":["../../transport/deadline.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IAC9B,KAAK,IAAI,IAAI,CAAA;CACd;AAED,oEAAoE;AACpE,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,SAAS,EAAE,MAAM,GAChB,gBAAgB,CAqBlB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAKpE;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAG3D;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAE7C"}

package/dist/transport/deadline.js

@@ -0,0 +1,40 @@
+/** One caller signal plus one transport-owned lifetime deadline. */
+export function controlledSignal(parent, timeoutMs) {
+    const controller = new AbortController();
+    let timedOut = false;
+    const abort = () => controller.abort(parent?.reason);
+    if (parent?.aborted)
+        abort();
+    else
+        parent?.addEventListener('abort', abort, { once: true });
+    const timer = setTimeout(() => {
+        timedOut = true;
+        controller.abort(new Error('request timeout'));
+    }, timeoutMs);
+    return {
+        signal: controller.signal,
+        get timedOut() {
+            return timedOut;
+        },
+        cancel: (reason) => controller.abort(reason),
+        close: () => {
+            clearTimeout(timer);
+            parent?.removeEventListener('abort', abort);
+        },
+    };
+}
+export function positiveInteger(input, label) {
+    if (!Number.isSafeInteger(input) || input < 1 || input > 2_147_483_647) {
+        throw new TypeError(`${label} must be a positive safe platform integer.`);
+    }
+    return input;
+}
+export function requireLive(control) {
+    if (!control.signal.aborted)
+        return;
+    throw control.signal.reason ?? new Error('request was cancelled.');
+}
+export function asError(value) {
+    return value instanceof Error ? value : new Error(String(value));
+}
+//# sourceMappingURL=deadline.js.map

package/dist/transport/deadline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deadline.js","sourceRoot":"","sources":["../../transport/deadline.ts"],"names":[],"mappings":"AAOA,oEAAoE;AACpE,MAAM,UAAU,gBAAgB,CAC9B,MAA+B,EAC/B,SAAiB;IAEjB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;IACxC,IAAI,QAAQ,GAAG,KAAK,CAAA;IACpB,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpD,IAAI,MAAM,EAAE,OAAO;QAAE,KAAK,EAAE,CAAA;;QACvB,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;IAC7D,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;QAC5B,QAAQ,GAAG,IAAI,CAAA;QACf,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAA;IAChD,CAAC,EAAE,SAAS,CAAC,CAAA;IACb,OAAO;QACL,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,IAAI,QAAQ;YACV,OAAO,QAAQ,CAAA;QACjB,CAAC;QACD,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC;QAC5C,KAAK,EAAE,GAAG,EAAE;YACV,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QAC7C,CAAC;KACF,CAAA;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,KAAa;IAC1D,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,aAAa,EAAE,CAAC;QACvE,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,4CAA4C,CAAC,CAAA;IAC3E,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAyB;IACnD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO;QAAE,OAAM;IACnC,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;AACpE,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;AAClE,CAAC"}

package/dist/transport/http/index.d.ts

@@ -0,0 +1,2 @@
+export { HttpTransport, type Fetch, type HttpTransportOptions } from './transport.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/transport/http/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../transport/http/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,KAAK,EAAE,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/transport/http/index.js

@@ -0,0 +1,2 @@
+export { HttpTransport } from './transport.js';
+//# sourceMappingURL=index.js.map

package/dist/transport/http/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../transport/http/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAyC,MAAM,gBAAgB,CAAA"}

package/dist/transport/http/response.d.ts

@@ -0,0 +1,8 @@
+import { codecs, invocation as protocol } from '@astrale-os/kernel-protocol';
+export declare function codecForResponse(contentType: string | null): Promise<codecs.Codec | undefined>;
+export declare function readBoundedBody(response: Response, maximumBytes: number, signal: AbortSignal): Promise<Uint8Array>;
+export declare function requireId(expected: protocol.RequestId, received: protocol.RequestId): void;
+export declare function decodeProtocol<T>(label: string, decode: () => T): T;
+export declare function normalizeMediaType(input: string | null): string | undefined;
+export declare function binaryHeaders(input: Headers, names: readonly string[]): Readonly<Record<string, string>>;
+//# sourceMappingURL=response.d.ts.map

package/dist/transport/http/response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../../transport/http/response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,IAAI,QAAQ,EAAE,MAAM,6BAA6B,CAAA;AAK5E,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,GAAG,IAAI,GACzB,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,SAAS,CAAC,CAOnC;AAED,wBAAsB,eAAe,CACnC,QAAQ,EAAE,QAAQ,EAClB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,UAAU,CAAC,CA+BrB;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,SAAS,GAAG,IAAI,CAM1F;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAOnE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAI3E;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAUlC"}