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

package/dist/session/routing/cache.js

@@ -0,0 +1,110 @@
+import { DEFAULT_MAXIMUM_ROUTES } from '../context/index.js';
+/** Confidential, process-local warm routing state owned by exactly one ClientSession. */
+export class RouteCache {
+    maximumAgeMs;
+    maximumSize;
+    entries = new Map();
+    constructor(maximumAgeMs, maximumSize = DEFAULT_MAXIMUM_ROUTES) {
+        this.maximumAgeMs = maximumAgeMs;
+        this.maximumSize = maximumSize;
+    }
+    async key(source, call, auth) {
+        const credential = auth.credential === undefined ? 'anonymous' : await digestText(auth.credential);
+        const delegate = auth.delegate === undefined ? 'anonymous' : await digestText(canonicalDelegate(auth.delegate));
+        return JSON.stringify([source, call.target, credential, delegate]);
+    }
+    get(key, now = Date.now()) {
+        const entry = this.entries.get(key);
+        if (entry === undefined)
+            return undefined;
+        if (entry.expiresAt <= now) {
+            this.entries.delete(key);
+            return undefined;
+        }
+        this.entries.delete(key);
+        this.entries.set(key, entry);
+        return entry;
+    }
+    learn(key, route, credential, now = Date.now()) {
+        const credentialExpiry = credential === undefined ? undefined : jwtExpiry(credential);
+        const expiresAt = Math.min(now + this.maximumAgeMs, credentialExpiry ?? Number.POSITIVE_INFINITY);
+        const entry = Object.freeze({
+            route,
+            ...(credential === undefined ? {} : { credential }),
+            expiresAt,
+        });
+        // A carrier with no supported finite expiry may be used for this follow, but never warmed.
+        if (credential !== undefined && credentialExpiry === undefined)
+            return entry;
+        if (expiresAt <= now)
+            return entry;
+        this.entries.delete(key);
+        while (this.entries.size >= this.maximumSize) {
+            const oldest = this.entries.keys().next().value;
+            if (oldest === undefined)
+                break;
+            this.entries.delete(oldest);
+        }
+        this.entries.set(key, entry);
+        return entry;
+    }
+    delete(key) {
+        this.entries.delete(key);
+    }
+    clear() {
+        this.entries.clear();
+    }
+}
+function canonicalDelegate(input) {
+    return JSON.stringify({
+        ttlSeconds: input.ttlSeconds,
+        delegation: canonicalExpr(input.delegation),
+    });
+}
+function canonicalExpr(input) {
+    if (input.kind === 'identity') {
+        return 'self' in input
+            ? { kind: 'identity', self: true }
+            : { kind: 'identity', credential: input.credential };
+    }
+    if (input.kind === 'exclude') {
+        return {
+            kind: 'exclude',
+            base: canonicalExpr(input.base),
+            excluded: input.excluded.map(canonicalExpr),
+        };
+    }
+    return { kind: input.kind, operands: input.operands.map(canonicalExpr) };
+}
+async function digestText(input) {
+    if (globalThis.crypto?.subtle === undefined) {
+        throw new TypeError('Session route caching requires Web Crypto SHA-256 support.');
+    }
+    const bytes = await globalThis.crypto.subtle.digest('SHA-256', new TextEncoder().encode(input));
+    return [...new Uint8Array(bytes)].map((byte) => byte.toString(16).padStart(2, '0')).join('');
+}
+function jwtExpiry(input) {
+    const parts = input.split('.');
+    if (parts.length !== 3)
+        return undefined;
+    try {
+        const encoded = parts[1].replace(/-/gu, '+').replace(/_/gu, '/');
+        const padding = '='.repeat((4 - (encoded.length % 4)) % 4);
+        const json = decodeBase64(encoded + padding);
+        const payload = JSON.parse(json);
+        return typeof payload.exp === 'number' && Number.isSafeInteger(payload.exp) && payload.exp > 0
+            ? payload.exp * 1_000
+            : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function decodeBase64(input) {
+    if (typeof globalThis.atob === 'function') {
+        const binary = globalThis.atob(input);
+        return new TextDecoder().decode(Uint8Array.from(binary, (character) => character.charCodeAt(0)));
+    }
+    throw new TypeError('Session route caching requires base64 decoding support.');
+}
+//# sourceMappingURL=cache.js.map

package/dist/session/routing/cache.js.map

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

package/dist/session/routing/dispatch.d.ts

@@ -0,0 +1,35 @@
+import type { IssuerId } from '@astrale-os/kernel-core/auth';
+import type { Result } from '@astrale-os/kernel-ports/functions';
+import type { Call } from '../../client/index.js';
+import type { SessionOperation, SessionPolicy } from '../context/index.js';
+import type { SessionDiscovery } from '../discovery/index.js';
+import type { SessionAuth } from './auth.js';
+import type { RouteCache } from './cache.js';
+import type { ClientPoolCapability } from './envelope.js';
+import type { SessionEnvelopeTransport, SessionRequestOptions } from './request.js';
+export interface SessionDispatcherOptions {
+    readonly url: string;
+    readonly sourceIssuer?: IssuerId;
+    readonly pool: ClientPoolCapability;
+    readonly websocketAvailable: boolean;
+    readonly auth?: SessionAuth;
+    readonly cache: RouteCache;
+    readonly policy: Readonly<SessionPolicy>;
+    readonly envelopeTransport: SessionEnvelopeTransport;
+    readonly discovery: SessionDiscovery;
+    readonly requireOpen: () => void;
+}
+export declare class SessionDispatcher {
+    private readonly state;
+    constructor(state: SessionDispatcherOptions);
+    dispatch(input: Call, options: SessionRequestOptions, operation: SessionOperation): Promise<Result>;
+    private dispatchSource;
+    private followSource;
+    private dispatchDestinationWithRecovery;
+    private dispatchDestination;
+    private sourceKernel;
+}
+export declare function requireResultKind<Kind extends 'value' | 'stream' | 'binary'>(expected: Kind, result: Result): Extract<Result, {
+    kind: Kind;
+}>;
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/session/routing/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../../session/routing/dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAA;AAGhE,OAAO,KAAK,EAAuB,IAAI,EAAU,MAAM,uBAAuB,CAAA;AAC9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,WAAW,CAAA;AAC3D,OAAO,KAAK,EAAgB,UAAU,EAAE,MAAM,YAAY,CAAA;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACzD,OAAO,KAAK,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAQnF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAA;IAChC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAA;IACnC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAA;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAA;IACxC,QAAQ,CAAC,iBAAiB,EAAE,wBAAwB,CAAA;IACpD,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAA;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,IAAI,CAAA;CACjC;AAaD,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAAlC,YAA6B,KAAK,EAAE,wBAAwB,EAAI;IAE1D,QAAQ,CACZ,KAAK,EAAE,IAAI,EACX,OAAO,EAAE,qBAAqB,EAC9B,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAejB;YAEa,cAAc;YAoBd,YAAY;YAiBZ,+BAA+B;YAyB/B,mBAAmB;YA8BnB,YAAY;CAO3B;AAED,wBAAgB,iBAAiB,CAAC,IAAI,SAAS,OAAO,GAAG,QAAQ,GAAG,QAAQ,EAC1E,QAAQ,EAAE,IAAI,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC,CAIjC"}

package/dist/session/routing/dispatch.js

@@ -0,0 +1,101 @@
+import { acceptCall, isAdmittedMissError, isAdmittedStaleRouteError } from '../../client/index.js';
+import { ClientError } from '../../errors/index.js';
+import { runSessionOperation, sessionTransportOptions, allowEndpoint } from '../context/index.js';
+import { resolveAuth } from './auth.js';
+import { selectEnvelope } from './envelope.js';
+export class SessionDispatcher {
+    state;
+    constructor(state) {
+        this.state = state;
+    }
+    async dispatch(input, options, operation) {
+        this.state.requireOpen();
+        const call = acceptCall(input);
+        // Authority is resolved before warm lookup so changed credentials or delegation cannot reuse a
+        // carrier minted for a different caller partition.
+        const auth = await resolveAuth(this.state.auth, call, operation);
+        const source = await this.sourceKernel(operation);
+        const cacheKey = await this.state.cache.key(source.issuer, call, auth);
+        const dispatch = Object.freeze({ call, auth, source, cacheKey });
+        const learned = this.state.cache.get(cacheKey);
+        if (learned !== undefined) {
+            return this.dispatchDestinationWithRecovery(learned, dispatch, options, operation);
+        }
+        const result = await this.dispatchSource(dispatch, undefined, options, operation);
+        return this.followSource(result, dispatch, options, operation);
+    }
+    async dispatchSource(state, routing, options, operation) {
+        this.state.requireOpen();
+        allowEndpoint(this.state.url, this.state.policy);
+        const client = this.state.pool.clientFor(Object.freeze({ transport: 'http', url: this.state.url }));
+        return runSessionOperation(operation, () => authenticated(client, state.auth.credential).dispatch(state.call, {
+            ...sessionTransportOptions(operation, options.idempotencyKey),
+            ...(state.auth.delegate === undefined ? {} : { delegate: state.auth.delegate }),
+            ...(routing === undefined ? {} : { routing }),
+        }));
+    }
+    async followSource(result, state, options, operation) {
+        if (result.kind !== 'redirect')
+            return result;
+        const redirect = result.redirect;
+        if (redirect.route.via.issuer !== state.source.issuer) {
+            throw new ClientError('Redirect issuer differs from the session-pinned source Kernel identity.');
+        }
+        const learned = this.state.cache.learn(state.cacheKey, redirect.route, redirect.credential);
+        return this.dispatchDestinationWithRecovery(learned, state, options, operation);
+    }
+    async dispatchDestinationWithRecovery(learned, state, options, operation) {
+        try {
+            return await this.dispatchDestination(learned, state.call, options, operation);
+        }
+        catch (cause) {
+            const stale = isAdmittedStaleRouteError(cause);
+            const miss = isAdmittedMissError(cause);
+            if (!stale && !miss)
+                throw cause;
+            this.state.cache.delete(state.cacheKey);
+            if (!operation.claimRecovery())
+                throw cause;
+            const routing = stale
+                ? Object.freeze({
+                    kind: 'refresh',
+                    stale: learned.route.via.publication.etag,
+                })
+                : undefined;
+            const refreshed = await this.dispatchSource(state, routing, options, operation);
+            return this.followSource(refreshed, state, options, operation);
+        }
+    }
+    async dispatchDestination(learned, call, options, operation) {
+        if (learned.route.via.issuer !== (await this.sourceKernel(operation)).issuer) {
+            throw new ClientError('Learned route issuer differs from the session-pinned source Kernel.');
+        }
+        const envelope = selectEnvelope(learned.route.endpoint, this.state.envelopeTransport, this.state.websocketAvailable, this.state.pool, this.state.policy);
+        const result = await runSessionOperation(operation, () => authenticated(envelope.client, learned.credential).dispatch(call, {
+            ...sessionTransportOptions(operation, options.idempotencyKey),
+            routing: learned.route.via,
+        }));
+        if (result.kind === 'redirect') {
+            throw new ClientError('A destination redirect is invalid; only the source Kernel may redirect.');
+        }
+        return result;
+    }
+    async sourceKernel(operation) {
+        if (this.state.sourceIssuer !== undefined) {
+            return Object.freeze({ issuer: this.state.sourceIssuer });
+        }
+        const discovered = await this.state.discovery.discover(this.state.url, operation);
+        return Object.freeze({ issuer: discovered.publication.identity.issuer });
+    }
+}
+export function requireResultKind(expected, result) {
+    if (result.kind === expected)
+        return result;
+    if (result.kind === 'stream')
+        void result.stream.cancel(`Expected ${expected} result.`);
+    throw new ClientError(`Function returned ${result.kind}; ${expected} was required.`);
+}
+function authenticated(client, credential) {
+    return credential === undefined ? client : client.as(credential);
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/session/routing/dispatch.js.map

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

package/dist/session/routing/envelope.d.ts

@@ -0,0 +1,14 @@
+import type { publication } from '@astrale-os/kernel-protocol';
+import type { Client } from '../../client/index.js';
+import type { ClientTarget } from '../../pool/index.js';
+import type { SessionPolicy } from '../context/index.js';
+import type { SessionEnvelopeTransport } from './request.js';
+export interface ClientPoolCapability {
+    clientFor(target: ClientTarget): Client;
+}
+export interface EnvelopeSelection {
+    readonly client: Client;
+    readonly destination: ClientTarget;
+}
+export declare function selectEnvelope(endpoints: publication.InvocationEndpoints, preference: SessionEnvelopeTransport, websocketAvailable: boolean, pool: ClientPoolCapability, policy: Readonly<SessionPolicy>): EnvelopeSelection;
+//# sourceMappingURL=envelope.d.ts.map

package/dist/session/routing/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../../session/routing/envelope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAE9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAA;AAK5D,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAAA;CACxC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAA;CACnC;AAED,wBAAgB,cAAc,CAC5B,SAAS,EAAE,WAAW,CAAC,mBAAmB,EAC1C,UAAU,EAAE,wBAAwB,EACpC,kBAAkB,EAAE,OAAO,EAC3B,IAAI,EAAE,oBAAoB,EAC1B,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,GAC9B,iBAAiB,CA+BnB"}

package/dist/session/routing/envelope.js

@@ -0,0 +1,36 @@
+import { ClientError } from '../../errors/index.js';
+import { allowEndpoint } from '../context/index.js';
+export function selectEnvelope(endpoints, preference, websocketAvailable, pool, policy) {
+    let destination;
+    if (preference === 'websocket') {
+        if (endpoints.websocket === undefined) {
+            throw new ClientError('Callable does not advertise a WebSocket endpoint.');
+        }
+        if (!websocketAvailable)
+            throw new ClientError('No WebSocket implementation is available.');
+        allowEndpoint(endpoints.websocket, policy);
+        destination = Object.freeze({ transport: 'websocket', url: endpoints.websocket });
+    }
+    else if (preference === 'auto' && endpoints.websocket !== undefined && websocketAvailable) {
+        allowEndpoint(endpoints.http, policy);
+        allowEndpoint(endpoints.websocket, policy);
+        destination = Object.freeze({
+            transport: 'auto',
+            endpoints: Object.freeze({ http: endpoints.http, websocket: endpoints.websocket }),
+        });
+    }
+    else {
+        allowEndpoint(endpoints.http, policy);
+        destination = Object.freeze({ transport: 'http', url: endpoints.http });
+    }
+    const client = pool.clientFor(destination);
+    if (client === null ||
+        typeof client !== 'object' ||
+        typeof client.dispatch !== 'function' ||
+        typeof client.as !== 'function' ||
+        typeof client.close !== 'function') {
+        throw new TypeError('Session client pool capability returned an invalid Client.');
+    }
+    return Object.freeze({ client, destination });
+}
+//# sourceMappingURL=envelope.js.map

package/dist/session/routing/envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../../../session/routing/envelope.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAWnD,MAAM,UAAU,cAAc,CAC5B,SAA0C,EAC1C,UAAoC,EACpC,kBAA2B,EAC3B,IAA0B,EAC1B,MAA+B;IAE/B,IAAI,WAAyB,CAAA;IAC7B,IAAI,UAAU,KAAK,WAAW,EAAE,CAAC;QAC/B,IAAI,SAAS,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACtC,MAAM,IAAI,WAAW,CAAC,mDAAmD,CAAC,CAAA;QAC5E,CAAC;QACD,IAAI,CAAC,kBAAkB;YAAE,MAAM,IAAI,WAAW,CAAC,2CAA2C,CAAC,CAAA;QAC3F,aAAa,CAAC,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;QAC1C,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,EAAE,SAAS,CAAC,SAAS,EAAE,CAAC,CAAA;IACnF,CAAC;SAAM,IAAI,UAAU,KAAK,MAAM,IAAI,SAAS,CAAC,SAAS,KAAK,SAAS,IAAI,kBAAkB,EAAE,CAAC;QAC5F,aAAa,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QACrC,aAAa,CAAC,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;QAC1C,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC;YAC1B,SAAS,EAAE,MAAM;YACjB,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,SAAS,EAAE,CAAC;SACnF,CAAC,CAAA;IACJ,CAAC;SAAM,CAAC;QACN,aAAa,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QACrC,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC,CAAA;IACzE,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;IAC1C,IACE,MAAM,KAAK,IAAI;QACf,OAAO,MAAM,KAAK,QAAQ;QAC1B,OAAO,MAAM,CAAC,QAAQ,KAAK,UAAU;QACrC,OAAO,MAAM,CAAC,EAAE,KAAK,UAAU;QAC/B,OAAO,MAAM,CAAC,KAAK,KAAK,UAAU,EAClC,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,4DAA4D,CAAC,CAAA;IACnF,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAA;AAC/C,CAAC"}

package/dist/session/routing/index.d.ts

@@ -0,0 +1,6 @@
+export { admitSessionAuth, resolveAuth, type Auth, type EffectiveAuth, type SessionAuth, } from './auth.js';
+export { RouteCache, type LearnedRoute } from './cache.js';
+export { requireResultKind, SessionDispatcher, type SessionDispatcherOptions } from './dispatch.js';
+export { type ClientPoolCapability, type EnvelopeSelection } from './envelope.js';
+export { admitEnvelopeTransport, admitRequestOptions, type SessionEnvelopeTransport, type SessionRequestOptions, } from './request.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/session/routing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../session/routing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,KAAK,IAAI,EACT,KAAK,aAAa,EAClB,KAAK,WAAW,GACjB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAA;AAC1D,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,MAAM,eAAe,CAAA;AACnG,OAAO,EAAE,KAAK,oBAAoB,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACjF,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,GAC3B,MAAM,cAAc,CAAA"}

package/dist/session/routing/index.js

@@ -0,0 +1,6 @@
+export { admitSessionAuth, resolveAuth, } from './auth.js';
+export { RouteCache } from './cache.js';
+export { requireResultKind, SessionDispatcher } from './dispatch.js';
+export {} from './envelope.js';
+export { admitEnvelopeTransport, admitRequestOptions, } from './request.js';
+//# sourceMappingURL=index.js.map

package/dist/session/routing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../session/routing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,WAAW,GAIZ,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,UAAU,EAAqB,MAAM,YAAY,CAAA;AAC1D,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAiC,MAAM,eAAe,CAAA;AACnG,OAAO,EAAqD,MAAM,eAAe,CAAA;AACjF,OAAO,EACL,sBAAsB,EACtB,mBAAmB,GAGpB,MAAM,cAAc,CAAA"}

package/dist/session/routing/request.d.ts

@@ -0,0 +1,9 @@
+import type { invocation } from '@astrale-os/kernel-protocol';
+import type { SessionControlOptions } from '../context/index.js';
+export type SessionEnvelopeTransport = 'auto' | 'http' | 'websocket';
+export interface SessionRequestOptions extends SessionControlOptions {
+    readonly idempotencyKey?: invocation.IdempotencyKey;
+}
+export declare function admitRequestOptions(input?: SessionRequestOptions): Readonly<SessionRequestOptions>;
+export declare function admitEnvelopeTransport(input: SessionEnvelopeTransport): SessionEnvelopeTransport;
+//# sourceMappingURL=request.d.ts.map

package/dist/session/routing/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../../session/routing/request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAI7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAIhE,MAAM,MAAM,wBAAwB,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,CAAA;AAEpE,MAAM,WAAW,qBAAsB,SAAQ,qBAAqB;IAClE,QAAQ,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC,cAAc,CAAA;CACpD;AAED,wBAAgB,mBAAmB,CACjC,KAAK,GAAE,qBAA0B,GAChC,QAAQ,CAAC,qBAAqB,CAAC,CAiBjC;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,wBAAwB,GAAG,wBAAwB,CAKhG"}

package/dist/session/routing/request.js

@@ -0,0 +1,26 @@
+import { invocation as invocationProtocol } from '@astrale-os/kernel-protocol';
+import { admitControlOptions } from '../context/index.js';
+export function admitRequestOptions(input = {}) {
+    if (input === null || typeof input !== 'object' || Array.isArray(input)) {
+        throw new TypeError('Session request options are invalid.');
+    }
+    const control = admitControlOptions(input);
+    const fields = Reflect.ownKeys(input);
+    if (fields.some((field) => !['signal', 'timeoutMs', 'idempotencyKey'].includes(String(field)))) {
+        throw new TypeError('Session request options contain unsupported fields.');
+    }
+    const idempotencyKey = input.idempotencyKey === undefined
+        ? undefined
+        : invocationProtocol.acceptIdempotencyKey(input.idempotencyKey, 'request.idempotencyKey');
+    return Object.freeze({
+        ...control,
+        ...(idempotencyKey === undefined ? {} : { idempotencyKey }),
+    });
+}
+export function admitEnvelopeTransport(input) {
+    if (input !== 'auto' && input !== 'http' && input !== 'websocket') {
+        throw new TypeError('Session envelope transport is invalid.');
+    }
+    return input;
+}
+//# sourceMappingURL=request.js.map

package/dist/session/routing/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../../session/routing/request.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,IAAI,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAI9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAQzD,MAAM,UAAU,mBAAmB,CACjC,KAAK,GAA0B,EAAE;IAEjC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,SAAS,CAAC,sCAAsC,CAAC,CAAA;IAC7D,CAAC;IACD,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAA;IAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IACrC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,WAAW,EAAE,gBAAgB,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/F,MAAM,IAAI,SAAS,CAAC,qDAAqD,CAAC,CAAA;IAC5E,CAAC;IACD,MAAM,cAAc,GAClB,KAAK,CAAC,cAAc,KAAK,SAAS;QAChC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,kBAAkB,CAAC,oBAAoB,CAAC,KAAK,CAAC,cAAc,EAAE,wBAAwB,CAAC,CAAA;IAC7F,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,OAAO;QACV,GAAG,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC;KAC5D,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAA+B;IACpE,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,WAAW,EAAE,CAAC;QAClE,MAAM,IAAI,SAAS,CAAC,wCAAwC,CAAC,CAAA;IAC/D,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/session/session.d.ts

@@ -0,0 +1,56 @@
+import type { IssuerId } from '@astrale-os/kernel-core/auth';
+import type { PathLike } from '@astrale-os/kernel-core/path';
+import type { Input, Result } from '@astrale-os/kernel-ports/functions';
+import type { Call } from '../client/index.js';
+import type { ClientFactory, ClientPool as ClientPoolType } from '../pool/index.js';
+import type { ClientWarning } from '../transport/auto/index.js';
+import type { Fetch } from '../transport/http/index.js';
+import type { WebSocketConstructor } from '../transport/websocket/index.js';
+import type { SessionControlOptions, SessionPolicy } from './context/index.js';
+import type { SessionSnapshot } from './discovery/index.js';
+import type { SessionAuth, SessionEnvelopeTransport, SessionRequestOptions } from './routing/index.js';
+import type { ViewCatalog } from './views/index.js';
+export interface ClientSessionOptions {
+    /** Source Kernel invocation endpoint. */
+    readonly url: string;
+    /**
+     * Exact source Kernel identity when it is not represented by the root Publication discovered at
+     * the endpoint origin, as for a path-multiplexed managed child.
+     */
+    readonly sourceIssuer?: IssuerId;
+    readonly fetch?: Fetch;
+    readonly client?: ClientFactory;
+    readonly pool?: Pick<ClientPoolType, 'clientFor'>;
+    readonly websocket?: WebSocketConstructor;
+    readonly auth?: SessionAuth;
+    readonly policy: SessionPolicy;
+    readonly envelopeTransport?: SessionEnvelopeTransport;
+    readonly onWarning?: (warning: ClientWarning) => void;
+    readonly maximumPublicationBytes?: number;
+    readonly maximumBundleBytes?: number;
+    readonly maximumResponseBytes?: number;
+    readonly timeoutMs?: number;
+}
+/** Caller-owned discovery and redirect-following conversation over one source invocation endpoint. */
+export declare class ClientSession {
+    readonly url: string;
+    private readonly ownedPool?;
+    private readonly discovery;
+    private readonly dispatcher;
+    private readonly lifecycle;
+    private readonly timeoutMs;
+    private readonly routes;
+    private readonly admitTargetViews;
+    private closed;
+    constructor(options: ClientSessionOptions);
+    snapshot(options?: SessionControlOptions): Promise<SessionSnapshot>;
+    viewsFor(target: PathLike, options?: SessionControlOptions): Promise<ViewCatalog>;
+    dispatch(call: Call, options?: SessionRequestOptions): Promise<Result>;
+    call(call: Call, options?: SessionRequestOptions): Promise<Input>;
+    stream(call: Call, options?: SessionRequestOptions): Promise<import("@astrale-os/kernel-ports/functions").Stream>;
+    binary(call: Call, options?: SessionRequestOptions): Promise<import("@astrale-os/kernel-ports/functions").Binary>;
+    close(): void;
+    private requireOpen;
+    private operation;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session/session.d.ts.map

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