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

package/dist/pool/pool.d.ts

@@ -1,63 +1,24 @@
-import type { KernelClient } from '../client/client.js';
-import type { FnMap } from '../client/fn-map.js';
-/**
- * Factory for constructing a `KernelClient` bound to a given URL.
- *
- * The ClientSession's default factory wires `fetch`, `codec`, `requestTimeout`,
- * `defaultTransport`, `defaultProtocol`, `schema`, `hooks`, `retry` from a single
- * base config. Consumers who need custom wire-layer config replace the
- * factory — it is the one wiring seam between ClientSession's config and the
- * client's.
- */
-export type ClientFactory<M extends FnMap = FnMap> = (url: string) => KernelClient<M>;
-/**
- * `ClientPool` configuration. Spec §9.1.
- */
-export type ClientPoolConfig<M extends FnMap = FnMap> = {
-    /** How to build a `KernelClient` for a URL the pool hasn't seen. */
-    clientFactory: ClientFactory<M>;
-    /**
-     * Maximum cached clients. Least-recently-used is evicted when
-     * exceeded. Default: `32`.
-     */
-    maxSize?: number;
-};
-/**
- * URL → `KernelClient` map with bounded LRU eviction. Spec §9.1.
- *
- * Invariants:
- * - Idempotent `disconnect()` — subsequent calls are no-ops.
- * - Post-disconnect `clientFor` throws `PoolClosedError`.
- * - Eviction cascades `disconnect()` to the evicted client.
- * - Calls to `clientFor(url)` return the same instance for the same
- *   URL (until eviction), so pooled-client hook registration is stable.
- */
-export declare class ClientPool<M extends FnMap = FnMap> {
-    private readonly entries;
-    private readonly factory;
-    private readonly maxSize;
+import type { Client } from '../client/index.js';
+import type { ClientTarget } from './target.js';
+export type ClientFactory = (target: ClientTarget) => Client;
+export interface ClientPoolOptions {
+    readonly client: ClientFactory;
+    /** Maximum retained endpoint/transport Clients. Default: 32. */
+    readonly maximumSize?: number;
+}
+/** Bounded LRU pool for shareable one-hop Clients; eviction closes the selected Client. */
+export declare class ClientPool {
+    private readonly clients;
+    private readonly createClient;
+    private readonly maximumSize;
     private closed;
-    private clock;
-    constructor(config: ClientPoolConfig<M>);
-    /**
-     * Resolve or create a client for `url`. Throws `PoolClosedError` if
-     * the pool has been disconnected.
-     */
-    clientFor(url: string): KernelClient<M>;
-    /**
-     * Evict a specific URL and call its client's `disconnect()`.
-     * Idempotent — no-op for unknown URLs.
-     */
-    evict(url: string): void;
-    /**
-     * Tear down every cached client. Idempotent. After disconnect,
-     * `clientFor` throws `PoolClosedError`.
-     */
-    disconnect(): void;
-    /** Current number of cached clients — pool introspection helper. */
+    constructor(options: ClientPoolOptions);
+    clientFor(target: ClientTarget): Client;
+    evict(target: ClientTarget): void;
+    close(): void;
     get size(): number;
-    /** Whether `disconnect()` has been called. */
     get isClosed(): boolean;
-    private evictLeastRecentlyUsed;
+    private evictOldest;
+    private requireOpen;
 }
 //# sourceMappingURL=pool.d.ts.map

package/dist/pool/pool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../src/pool/pool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAIhD;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,IAAI,CAAC,GAAG,EAAE,MAAM,KAAK,YAAY,CAAC,CAAC,CAAC,CAAA;AAErF;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,IAAI;IACtD,oEAAoE;IACpE,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;IAC/B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAQD;;;;;;;;;GASG;AACH,qBAAa,UAAU,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAC1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,KAAK,CAAI;IAEjB,YAAY,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAMtC;IAED;;;OAGG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,CAWtC;IAED;;;OAGG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAKvB;IAED;;;OAGG;IACH,UAAU,IAAI,IAAI,CAKjB;IAED,oEAAoE;IACpE,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,8CAA8C;IAC9C,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,OAAO,CAAC,sBAAsB;CAW/B"}
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../pool/pool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAK/C,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,YAAY,KAAK,MAAM,CAAA;AAE5D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;IAC9B,gEAAgE;IAChE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED,2FAA2F;AAC3F,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAGrB;IACH,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IACpC,OAAO,CAAC,MAAM,CAAQ;IAEtB,YAAY,OAAO,EAAE,iBAAiB,EASrC;IAED,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CActC;IAED,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAOhC;IAED,KAAK,IAAI,IAAI,CAKZ;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,WAAW;CAGpB"}

package/dist/pool/pool.js

@@ -1,87 +1,70 @@
-import { PoolClosedError } from './errors.js';
-/**
- * URL → `KernelClient` map with bounded LRU eviction. Spec §9.1.
- *
- * Invariants:
- * - Idempotent `disconnect()` — subsequent calls are no-ops.
- * - Post-disconnect `clientFor` throws `PoolClosedError`.
- * - Eviction cascades `disconnect()` to the evicted client.
- * - Calls to `clientFor(url)` return the same instance for the same
- *   URL (until eviction), so pooled-client hook registration is stable.
- */
+import { ClientError } from '../errors/index.js';
+import { admitTarget, targetKey } from './target.js';
+/** Bounded LRU pool for shareable one-hop Clients; eviction closes the selected Client. */
 export class ClientPool {
-    entries = new Map();
-    factory;
-    maxSize;
+    clients = new Map();
+    createClient;
+    maximumSize;
     closed = false;
-    clock = 0;
-    constructor(config) {
-        this.factory = config.clientFactory;
-        this.maxSize = config.maxSize ?? 32;
-        if (this.maxSize < 1) {
-            throw new Error(`ClientPool.maxSize must be >= 1 (got ${this.maxSize})`);
+    constructor(options) {
+        if (typeof options?.client !== 'function') {
+            throw new TypeError('ClientPool client factory is invalid.');
+        }
+        this.createClient = options.client;
+        this.maximumSize = options.maximumSize ?? 32;
+        if (!Number.isSafeInteger(this.maximumSize) || this.maximumSize < 1) {
+            throw new TypeError('ClientPool maximumSize must be a positive safe integer.');
         }
     }
-    /**
-     * Resolve or create a client for `url`. Throws `PoolClosedError` if
-     * the pool has been disconnected.
-     */
-    clientFor(url) {
-        if (this.closed)
-            throw new PoolClosedError();
-        const existing = this.entries.get(url);
+    clientFor(target) {
+        this.requireOpen();
+        const admitted = admitTarget(target);
+        const key = targetKey(admitted);
+        const existing = this.clients.get(key);
         if (existing) {
-            existing.lastUsed = ++this.clock;
+            this.clients.delete(key);
+            this.clients.set(key, existing);
             return existing.client;
         }
-        if (this.entries.size >= this.maxSize)
-            this.evictLeastRecentlyUsed();
-        const client = this.factory(url);
-        this.entries.set(url, { client, lastUsed: ++this.clock });
+        if (this.clients.size === this.maximumSize)
+            this.evictOldest();
+        const client = this.createClient(admitted);
+        this.clients.set(key, { target: admitted, client });
         return client;
     }
-    /**
-     * Evict a specific URL and call its client's `disconnect()`.
-     * Idempotent — no-op for unknown URLs.
-     */
-    evict(url) {
-        const entry = this.entries.get(url);
+    evict(target) {
+        const admitted = admitTarget(target);
+        const key = targetKey(admitted);
+        const entry = this.clients.get(key);
         if (!entry)
             return;
-        this.entries.delete(url);
-        entry.client.disconnect();
+        this.clients.delete(key);
+        entry.client.close();
     }
-    /**
-     * Tear down every cached client. Idempotent. After disconnect,
-     * `clientFor` throws `PoolClosedError`.
-     */
-    disconnect() {
+    close() {
         if (this.closed)
             return;
         this.closed = true;
-        for (const { client } of this.entries.values())
-            client.disconnect();
-        this.entries.clear();
+        for (const { client } of this.clients.values())
+            client.close();
+        this.clients.clear();
     }
-    /** Current number of cached clients — pool introspection helper. */
     get size() {
-        return this.entries.size;
+        return this.clients.size;
     }
-    /** Whether `disconnect()` has been called. */
     get isClosed() {
         return this.closed;
     }
-    evictLeastRecentlyUsed() {
-        let oldestUrl;
-        let oldestTs = Number.POSITIVE_INFINITY;
-        for (const [url, entry] of this.entries) {
-            if (entry.lastUsed < oldestTs) {
-                oldestTs = entry.lastUsed;
-                oldestUrl = url;
-            }
-        }
-        if (oldestUrl !== undefined)
-            this.evict(oldestUrl);
+    evictOldest() {
+        const oldest = this.clients.entries().next().value;
+        if (!oldest)
+            return;
+        this.clients.delete(oldest[0]);
+        oldest[1].client.close();
+    }
+    requireOpen() {
+        if (this.closed)
+            throw new ClientError('ClientPool is closed.');
     }
 }
 //# sourceMappingURL=pool.js.map

package/dist/pool/pool.js.map

@@ -1 +1 @@
-{"version":3,"file":"pool.js","sourceRoot":"","sources":["../../src/pool/pool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAgC7C;;;;;;;;;GASG;AACH,MAAM,OAAO,UAAU;IACJ,OAAO,GAAG,IAAI,GAAG,EAAwB,CAAA;IACzC,OAAO,CAAkB;IACzB,OAAO,CAAQ;IACxB,MAAM,GAAG,KAAK,CAAA;IACd,KAAK,GAAG,CAAC,CAAA;IAEjB,YAAY,MAA2B;QACrC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,aAAa,CAAA;QACnC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAA;QACnC,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,wCAAwC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAA;QAC1E,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,GAAW;QACnB,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,eAAe,EAAE,CAAA;QAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACtC,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,QAAQ,GAAG,EAAE,IAAI,CAAC,KAAK,CAAA;YAChC,OAAO,QAAQ,CAAC,MAAM,CAAA;QACxB,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,sBAAsB,EAAE,CAAA;QACpE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAChC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAA;QACzD,OAAO,MAAM,CAAA;IACf,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,GAAW;QACf,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACnC,IAAI,CAAC,KAAK;YAAE,OAAM;QAClB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACxB,KAAK,CAAC,MAAM,CAAC,UAAU,EAAE,CAAA;IAC3B,CAAC;IAED;;;OAGG;IACH,UAAU;QACR,IAAI,IAAI,CAAC,MAAM;YAAE,OAAM;QACvB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QAClB,KAAK,MAAM,EAAE,MAAM,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;YAAE,MAAM,CAAC,UAAU,EAAE,CAAA;QACnE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;IACtB,CAAC;IAED,oEAAoE;IACpE,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAA;IAC1B,CAAC;IAED,8CAA8C;IAC9C,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;IAEO,sBAAsB;QAC5B,IAAI,SAA6B,CAAA;QACjC,IAAI,QAAQ,GAAG,MAAM,CAAC,iBAAiB,CAAA;QACvC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACxC,IAAI,KAAK,CAAC,QAAQ,GAAG,QAAQ,EAAE,CAAC;gBAC9B,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAA;gBACzB,SAAS,GAAG,GAAG,CAAA;YACjB,CAAC;QACH,CAAC;QACD,IAAI,SAAS,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IACpD,CAAC;CACF"}
+{"version":3,"file":"pool.js","sourceRoot":"","sources":["../../pool/pool.ts"],"names":[],"mappings":"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"}

package/dist/pool/target.d.ts

@@ -0,0 +1,16 @@
+export type ClientTarget = {
+    readonly transport: 'http';
+    readonly url: string;
+} | {
+    readonly transport: 'websocket';
+    readonly url: string;
+} | {
+    readonly transport: 'auto';
+    readonly endpoints: {
+        readonly http: string;
+        readonly websocket: string;
+    };
+};
+export declare function admitTarget(input: ClientTarget): ClientTarget;
+export declare function targetKey(target: ClientTarget): string;
+//# sourceMappingURL=target.d.ts.map

package/dist/pool/target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../pool/target.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACzD;IACE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;CAC1E,CAAA;AAEL,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,CAuB7D;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAItD"}

package/dist/pool/target.js

@@ -0,0 +1,50 @@
+export function admitTarget(input) {
+    if (input === null || typeof input !== 'object') {
+        throw new TypeError('Client target must be an object.');
+    }
+    if (input.transport === 'http') {
+        return Object.freeze({ transport: 'http', url: endpoint(input.url, ['http:', 'https:']) });
+    }
+    if (input.transport === 'websocket') {
+        const url = new URL(endpoint(input.url, ['http:', 'https:', 'ws:', 'wss:']));
+        if (url.protocol === 'http:')
+            url.protocol = 'ws:';
+        if (url.protocol === 'https:')
+            url.protocol = 'wss:';
+        return Object.freeze({ transport: 'websocket', url: url.toString() });
+    }
+    if (input.transport === 'auto' && input.endpoints && typeof input.endpoints === 'object') {
+        return Object.freeze({
+            transport: 'auto',
+            endpoints: Object.freeze({
+                http: endpoint(input.endpoints.http, ['http:', 'https:']),
+                websocket: endpoint(input.endpoints.websocket, ['http:', 'https:', 'ws:', 'wss:']),
+            }),
+        });
+    }
+    throw new TypeError('Client target transport is invalid.');
+}
+export function targetKey(target) {
+    return target.transport === 'auto'
+        ? `auto\u0000${target.endpoints.http}\u0000${target.endpoints.websocket}`
+        : `${target.transport}\u0000${target.url}`;
+}
+function endpoint(input, protocols) {
+    if (typeof input !== 'string')
+        throw new TypeError('Client target URL must be a string.');
+    let url;
+    try {
+        url = new URL(input);
+    }
+    catch (cause) {
+        throw new TypeError('Client target URL is invalid.', { cause });
+    }
+    if (!protocols.includes(url.protocol) ||
+        url.username !== '' ||
+        url.password !== '' ||
+        url.hash !== '') {
+        throw new TypeError('Client target URL is invalid.');
+    }
+    return url.toString();
+}
+//# sourceMappingURL=target.js.map

package/dist/pool/target.js.map

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

package/dist/session/context/control.d.ts

@@ -0,0 +1,6 @@
+export interface SessionControlOptions {
+    readonly signal?: AbortSignal;
+    readonly timeoutMs?: number;
+}
+export declare function admitControlOptions(input: SessionControlOptions | undefined): Readonly<SessionControlOptions>;
+//# sourceMappingURL=control.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"control.d.ts","sourceRoot":"","sources":["../../../session/context/control.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,qBAAqB,GAAG,SAAS,GACvC,QAAQ,CAAC,qBAAqB,CAAC,CAcjC"}

package/dist/session/context/control.js

@@ -0,0 +1,18 @@
+import { platformDuration } from './limits.js';
+export function admitControlOptions(input) {
+    if (input === undefined)
+        return Object.freeze({});
+    if (input === null || typeof input !== 'object' || Array.isArray(input)) {
+        throw new TypeError('Session control options are invalid.');
+    }
+    if (input.signal !== undefined && !(input.signal instanceof AbortSignal)) {
+        throw new TypeError('Session cancellation signal is invalid.');
+    }
+    return Object.freeze({
+        ...(input.signal === undefined ? {} : { signal: input.signal }),
+        ...(input.timeoutMs === undefined
+            ? {}
+            : { timeoutMs: platformDuration(input.timeoutMs, 'timeoutMs') }),
+    });
+}
+//# sourceMappingURL=control.js.map

package/dist/session/context/control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.js","sourceRoot":"","sources":["../../../session/context/control.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAO9C,MAAM,UAAU,mBAAmB,CACjC,KAAwC;IAExC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IACjD,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,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,YAAY,WAAW,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,SAAS,CAAC,yCAAyC,CAAC,CAAA;IAChE,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;QAC/D,GAAG,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS;YAC/B,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,SAAS,EAAE,gBAAgB,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,EAAE,CAAC;KACnE,CAAC,CAAA;AACJ,CAAC"}

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

@@ -0,0 +1,5 @@
+export { admitControlOptions, type SessionControlOptions } from './control.js';
+export { DEFAULT_MAXIMUM_BUNDLE_BYTES, DEFAULT_MAXIMUM_PUBLICATION_BYTES, DEFAULT_MAXIMUM_RESPONSE_BYTES, DEFAULT_MAXIMUM_ROUTES, DEFAULT_TIMEOUT_MS, platformDuration, positive, } from './limits.js';
+export { createSessionOperation, runSessionOperation, sessionTransportOptions, type SessionOperation, } from './operation.js';
+export { admitPolicy, allowEndpoint, endpoint, type SessionPolicy } from './policy.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../session/context/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,KAAK,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAC9E,OAAO,EACL,4BAA4B,EAC5B,iCAAiC,EACjC,8BAA8B,EAC9B,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,GACT,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA"}

package/dist/session/context/index.js

@@ -0,0 +1,5 @@
+export { admitControlOptions } from './control.js';
+export { DEFAULT_MAXIMUM_BUNDLE_BYTES, DEFAULT_MAXIMUM_PUBLICATION_BYTES, DEFAULT_MAXIMUM_RESPONSE_BYTES, DEFAULT_MAXIMUM_ROUTES, DEFAULT_TIMEOUT_MS, platformDuration, positive, } from './limits.js';
+export { createSessionOperation, runSessionOperation, sessionTransportOptions, } from './operation.js';
+export { admitPolicy, allowEndpoint, endpoint } from './policy.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../session/context/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAA8B,MAAM,cAAc,CAAA;AAC9E,OAAO,EACL,4BAA4B,EAC5B,iCAAiC,EACjC,8BAA8B,EAC9B,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,GACT,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,GAExB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAsB,MAAM,aAAa,CAAA"}

package/dist/session/context/limits.d.ts

@@ -0,0 +1,8 @@
+export declare const DEFAULT_MAXIMUM_PUBLICATION_BYTES: number;
+export declare const DEFAULT_MAXIMUM_BUNDLE_BYTES: number;
+export declare const DEFAULT_MAXIMUM_RESPONSE_BYTES: number;
+export declare const DEFAULT_TIMEOUT_MS = 30000;
+export declare const DEFAULT_MAXIMUM_ROUTES = 256;
+export declare function positive(input: number, label: string): number;
+export declare function platformDuration(input: number, label: string): number;
+//# sourceMappingURL=limits.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../../../session/context/limits.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iCAAiC,QAAc,CAAA;AAC5D,eAAO,MAAM,4BAA4B,QAAmB,CAAA;AAC5D,eAAO,MAAM,8BAA8B,QAAmB,CAAA;AAC9D,eAAO,MAAM,kBAAkB,QAAS,CAAA;AACxC,eAAO,MAAM,sBAAsB,MAAM,CAAA;AAEzC,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAK7D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMrE"}

package/dist/session/context/limits.js

@@ -0,0 +1,19 @@
+export const DEFAULT_MAXIMUM_PUBLICATION_BYTES = 1024 * 1024;
+export const DEFAULT_MAXIMUM_BUNDLE_BYTES = 16 * 1024 * 1024;
+export const DEFAULT_MAXIMUM_RESPONSE_BYTES = 16 * 1024 * 1024;
+export const DEFAULT_TIMEOUT_MS = 30_000;
+export const DEFAULT_MAXIMUM_ROUTES = 256;
+export function positive(input, label) {
+    if (!Number.isSafeInteger(input) || input < 1) {
+        throw new TypeError(`${label} must be a positive safe integer.`);
+    }
+    return input;
+}
+export function platformDuration(input, label) {
+    const admitted = positive(input, label);
+    if (admitted > 2_147_483_647) {
+        throw new TypeError(`${label} exceeds the platform timer range.`);
+    }
+    return admitted;
+}
+//# sourceMappingURL=limits.js.map

package/dist/session/context/limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.js","sourceRoot":"","sources":["../../../session/context/limits.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iCAAiC,GAAG,IAAI,GAAG,IAAI,CAAA;AAC5D,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAA;AAC5D,MAAM,CAAC,MAAM,8BAA8B,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAA;AAC9D,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAA;AACxC,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAA;AAEzC,MAAM,UAAU,QAAQ,CAAC,KAAa,EAAE,KAAa;IACnD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,mCAAmC,CAAC,CAAA;IAClE,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,KAAa;IAC3D,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;IACvC,IAAI,QAAQ,GAAG,aAAa,EAAE,CAAC;QAC7B,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,oCAAoC,CAAC,CAAA;IACnE,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/session/context/operation.d.ts

@@ -0,0 +1,20 @@
+import type { RequestOptions } from '../../transport/index.js';
+export interface SessionOperation {
+    readonly signal: AbortSignal;
+    readonly deadline: number;
+    readonly idempotencyKey?: RequestOptions['idempotencyKey'];
+    /** Atomically spend this operation's sole Stale-or-Miss source-resolution allowance. */
+    claimRecovery(): boolean;
+}
+/** Create one total wall-clock budget for a complete public Client Session operation. */
+export declare function createSessionOperation(lifecycle: AbortSignal, input: {
+    readonly signal?: AbortSignal;
+    readonly timeoutMs?: number;
+    readonly idempotencyKey?: RequestOptions['idempotencyKey'];
+} | undefined, defaultTimeoutMs: number): SessionOperation;
+export declare function remainingSessionTime(operation: SessionOperation): number;
+export declare function sessionTransportOptions(operation: SessionOperation, idempotencyKey?: RequestOptions['idempotencyKey']): RequestOptions;
+/** Settle independently of a caller capability that ignores its supplied AbortSignal. */
+export declare function runSessionOperation<Result>(operation: SessionOperation, task: (signal: AbortSignal) => Result | PromiseLike<Result>): Promise<Result>;
+export declare function requireSessionOperation(operation: SessionOperation): void;
+//# sourceMappingURL=operation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operation.d.ts","sourceRoot":"","sources":["../../../session/context/operation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAI9D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC,gBAAgB,CAAC,CAAA;IAC1D,wFAAwF;IACxF,aAAa,IAAI,OAAO,CAAA;CACzB;AAED,yFAAyF;AACzF,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,WAAW,EACtB,KAAK,EACD;IACE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC,gBAAgB,CAAC,CAAA;CAC3D,GACD,SAAS,EACb,gBAAgB,EAAE,MAAM,GACvB,gBAAgB,CAiBlB;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAKxE;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,gBAAgB,EAC3B,cAAc,CAAC,EAAE,cAAc,CAAC,gBAAgB,CAAC,GAChD,cAAc,CAMhB;AAED,yFAAyF;AACzF,wBAAgB,mBAAmB,CAAC,MAAM,EACxC,SAAS,EAAE,gBAAgB,EAC3B,IAAI,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,GAC1D,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAGzE"}

package/dist/session/context/operation.js

@@ -0,0 +1,70 @@
+import { ClientError } from '../../errors/index.js';
+/** Create one total wall-clock budget for a complete public Client Session operation. */
+export function createSessionOperation(lifecycle, input, defaultTimeoutMs) {
+    const timeoutMs = input?.timeoutMs ?? defaultTimeoutMs;
+    const deadline = Date.now() + timeoutMs;
+    const timeout = AbortSignal.timeout(timeoutMs);
+    const signals = input?.signal === undefined ? [lifecycle, timeout] : [input.signal, lifecycle, timeout];
+    let recoveryClaimed = false;
+    return Object.freeze({
+        signal: AbortSignal.any(signals),
+        deadline,
+        ...(input?.idempotencyKey === undefined ? {} : { idempotencyKey: input.idempotencyKey }),
+        claimRecovery: () => {
+            if (recoveryClaimed)
+                return false;
+            recoveryClaimed = true;
+            return true;
+        },
+    });
+}
+export function remainingSessionTime(operation) {
+    requireSessionOperation(operation);
+    const remaining = operation.deadline - Date.now();
+    if (remaining < 1)
+        throw new ClientError('Session operation timed out.');
+    return remaining;
+}
+export function sessionTransportOptions(operation, idempotencyKey) {
+    return Object.freeze({
+        signal: operation.signal,
+        timeoutMs: remainingSessionTime(operation),
+        ...(idempotencyKey === undefined ? {} : { idempotencyKey }),
+    });
+}
+/** Settle independently of a caller capability that ignores its supplied AbortSignal. */
+export function runSessionOperation(operation, task) {
+    try {
+        requireSessionOperation(operation);
+    }
+    catch (error) {
+        return Promise.reject(error);
+    }
+    let abort;
+    const interrupted = new Promise((_resolve, reject) => {
+        abort = () => reject(sessionInterruption(operation.signal.reason));
+        operation.signal.addEventListener('abort', abort, { once: true });
+    });
+    const execution = Promise.resolve().then(() => {
+        requireSessionOperation(operation);
+        return task(operation.signal);
+    });
+    return Promise.race([execution, interrupted]).finally(() => {
+        if (abort !== undefined)
+            operation.signal.removeEventListener('abort', abort);
+    });
+}
+export function requireSessionOperation(operation) {
+    if (!operation.signal.aborted)
+        return;
+    throw sessionInterruption(operation.signal.reason);
+}
+function sessionInterruption(reason) {
+    if (reason instanceof DOMException && reason.name === 'TimeoutError') {
+        return new ClientError('Session operation timed out.', { cause: reason });
+    }
+    return reason instanceof Error
+        ? reason
+        : new ClientError('Session operation was cancelled.', { cause: reason });
+}
+//# sourceMappingURL=operation.js.map

package/dist/session/context/operation.js.map

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

package/dist/session/context/policy.d.ts

@@ -0,0 +1,10 @@
+export interface SessionPolicy {
+    readonly maximumRouteAgeMs: number;
+    readonly allowEndpoint?: (url: string) => boolean;
+    readonly allowInsecureHttp?: boolean;
+}
+export declare function admitPolicy(input: SessionPolicy): Readonly<SessionPolicy>;
+export declare function endpoint(input: string, insecure: boolean): string;
+export declare function websocketEndpoint(input: string, insecure: boolean): string;
+export declare function allowEndpoint(url: string, policy: Readonly<SessionPolicy>): void;
+//# sourceMappingURL=policy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../../session/context/policy.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAA;IACjD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAA;CACrC;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,QAAQ,CAAC,aAAa,CAAC,CAezE;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAgBjE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAgB1E;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,IAAI,CAahF"}

package/dist/session/context/policy.js

@@ -0,0 +1,63 @@
+import { ClientError } from '../../errors/index.js';
+import { positive } from './limits.js';
+export function admitPolicy(input) {
+    if (input === null || typeof input !== 'object') {
+        throw new TypeError('Session policy is invalid.');
+    }
+    if (input.allowEndpoint !== undefined && typeof input.allowEndpoint !== 'function') {
+        throw new TypeError('Session endpoint policy is invalid.');
+    }
+    if (input.allowInsecureHttp !== undefined && typeof input.allowInsecureHttp !== 'boolean') {
+        throw new TypeError('Session insecure-transport policy is invalid.');
+    }
+    return Object.freeze({
+        maximumRouteAgeMs: positive(input.maximumRouteAgeMs, 'maximumRouteAgeMs'),
+        ...(input.allowEndpoint === undefined ? {} : { allowEndpoint: input.allowEndpoint }),
+        ...(input.allowInsecureHttp === true ? { allowInsecureHttp: true } : {}),
+    });
+}
+export function endpoint(input, insecure) {
+    let url;
+    try {
+        url = new URL(input);
+    }
+    catch (cause) {
+        throw new TypeError('Session endpoint is invalid.', { cause });
+    }
+    if (url.username !== '' ||
+        url.password !== '' ||
+        url.hash !== '' ||
+        (url.protocol !== 'https:' && !(insecure && url.protocol === 'http:'))) {
+        throw new TypeError('Session endpoint is invalid.');
+    }
+    return url.toString();
+}
+export function websocketEndpoint(input, insecure) {
+    let url;
+    try {
+        url = new URL(input);
+    }
+    catch (cause) {
+        throw new TypeError('Session WebSocket endpoint is invalid.', { cause });
+    }
+    if (url.username !== '' ||
+        url.password !== '' ||
+        url.hash !== '' ||
+        (url.protocol !== 'wss:' && !(insecure && url.protocol === 'ws:'))) {
+        throw new TypeError('Session WebSocket endpoint is invalid.');
+    }
+    return url.toString();
+}
+export function allowEndpoint(url, policy) {
+    const parsed = new URL(url);
+    if (parsed.protocol !== 'https:' && parsed.protocol !== 'wss:') {
+        if ((parsed.protocol !== 'http:' && parsed.protocol !== 'ws:') ||
+            policy.allowInsecureHttp !== true) {
+            throw new ClientError('Insecure or unsupported endpoint is not allowed.');
+        }
+    }
+    if (policy.allowEndpoint?.(parsed.toString()) === false) {
+        throw new ClientError('Endpoint is denied by Session policy.');
+    }
+}
+//# sourceMappingURL=policy.js.map

package/dist/session/context/policy.js.map

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