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

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,12 @@
+import type { IssuerId } from '@astrale-os/kernel-core/auth';
+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 admitKernel(input: string, insecure: boolean): IssuerId;
+export declare function kernelInvocationEndpoint(input: IssuerId): 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":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAO5D,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,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,QAAQ,CAmBtE;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAEhE;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,70 @@
+import { issuer } from '@astrale-os/kernel-core/auth';
+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 admitKernel(input, insecure) {
+    let url;
+    let admitted;
+    try {
+        admitted = issuer.accept(input);
+        url = new URL(admitted);
+    }
+    catch (cause) {
+        throw new TypeError('Session Kernel issuer is invalid.', { cause });
+    }
+    if (url.username !== '' ||
+        url.password !== '' ||
+        url.hash !== '' ||
+        url.search !== '' ||
+        (url.protocol !== 'https:' && !(insecure && url.protocol === 'http:'))) {
+        throw new TypeError('Session Kernel issuer is invalid.');
+    }
+    return admitted;
+}
+export function kernelInvocationEndpoint(input) {
+    return `${input}/invoke`;
+}
+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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"}

package/dist/session/discovery/bundle.d.ts

@@ -0,0 +1,18 @@
+import type { bundle } from '@astrale-os/kernel-dsl/v1';
+import type { publication } from '@astrale-os/kernel-protocol';
+import type { Fetch } from '../../transport/http/index.js';
+import type { SessionOperation, SessionPolicy } from '../context/index.js';
+export interface BundleDiscoveryOptions {
+    readonly fetch: Fetch;
+    readonly policy: Readonly<SessionPolicy>;
+    readonly maximumBytes: number;
+}
+export declare class BundleDiscovery {
+    private readonly options;
+    private readonly bundles;
+    constructor(options: BundleDiscoveryOptions);
+    get(publication: publication.Publication, operation: SessionOperation): Promise<bundle.Bundle>;
+    clear(): void;
+    private fetch;
+}
+//# sourceMappingURL=bundle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../../../session/discovery/bundle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAI9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAA;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAM1E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAA;IACxC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAC9B;AAED,qBAAa,eAAe;IAGd,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAE3D,YAA6B,OAAO,EAAE,sBAAsB,EAAI;IAE1D,GAAG,CACP,WAAW,EAAE,WAAW,CAAC,WAAW,EACpC,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAQxB;IAED,KAAK,IAAI,IAAI,CAEZ;YAEa,KAAK;CAiCpB"}

package/dist/session/discovery/bundle.js

@@ -0,0 +1,55 @@
+import { publication as publicationCodec } from '@astrale-os/kernel-protocol';
+import { ClientError } from '../../errors/index.js';
+import { allowEndpoint, runSessionOperation } from '../context/index.js';
+import { boundedResponse, requireExactResponse } from './publication.js';
+export class BundleDiscovery {
+    options;
+    bundles = new Map();
+    constructor(options) {
+        this.options = options;
+    }
+    async get(publication, operation) {
+        const key = bundleKey(publication);
+        const existing = this.bundles.get(key);
+        if (existing !== undefined)
+            return existing;
+        const discovered = await this.fetch(publication, operation);
+        const retained = this.bundles.get(key) ?? discovered;
+        this.bundles.set(key, retained);
+        return retained;
+    }
+    clear() {
+        this.bundles.clear();
+    }
+    async fetch(publication, operation) {
+        if (publication.schema.bundle.ref.size > this.options.maximumBytes) {
+            throw new ClientError('Bundle artifact exceeds its byte limit.');
+        }
+        const href = publication.schema.bundle.href;
+        allowEndpoint(href, this.options.policy);
+        const response = await runSessionOperation(operation, (signal) => this.options.fetch(href, {
+            headers: { accept: publication.schema.bundle.ref.mediaType },
+            redirect: 'manual',
+            signal,
+        }));
+        requireExactResponse(response, href, 'Bundle retrieval');
+        if (!response.ok)
+            throw new ClientError(`Bundle retrieval returned HTTP ${response.status}.`);
+        if (response.headers.get('content-type') !== publication.schema.bundle.ref.mediaType) {
+            throw new ClientError('Bundle artifact media type differs from its descriptor.');
+        }
+        const etag = response.headers.get('etag');
+        if (etag !== null && etag !== `"${publication.schema.bundle.ref.digest}"`) {
+            throw new ClientError('Bundle response ETag differs from its descriptor.');
+        }
+        const bytes = await runSessionOperation(operation, (signal) => boundedResponse(response, publication.schema.bundle.ref.size, signal));
+        if (bytes.byteLength !== publication.schema.bundle.ref.size) {
+            throw new ClientError('Bundle artifact size differs from its descriptor.');
+        }
+        return publicationCodec.decodeBundle(publication, bytes);
+    }
+}
+function bundleKey(publication) {
+    return `${new URL(publication.schema.bundle.href).origin}\u0000${publication.etag}`;
+}
+//# sourceMappingURL=bundle.js.map

package/dist/session/discovery/bundle.js.map

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

package/dist/session/discovery/discovery.d.ts

@@ -0,0 +1,20 @@
+import type { IssuerId } from '@astrale-os/kernel-core/auth';
+import type { SessionOperation, SessionPolicy } from '../context/index.js';
+import type { BundleDiscovery } from './bundle.js';
+import type { PublicationDiscovery } from './publication.js';
+import type { SessionSnapshot } from './snapshot.js';
+export declare class SessionDiscovery {
+    readonly kernel: IssuerId;
+    private readonly policy;
+    private readonly publications;
+    private readonly bundles;
+    private readonly requireOpen;
+    private readonly acquisitionOperation;
+    private retained?;
+    private flight?;
+    constructor(kernel: IssuerId, policy: Readonly<SessionPolicy>, publications: PublicationDiscovery, bundles: BundleDiscovery, requireOpen: () => void, acquisitionOperation: () => SessionOperation);
+    snapshot(operation: SessionOperation): Promise<SessionSnapshot>;
+    clear(): void;
+    private acquireSnapshot;
+}
+//# sourceMappingURL=discovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../session/discovery/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAMpD,qBAAa,gBAAgB;IAKzB,QAAQ,CAAC,MAAM,EAAE,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IATvC,OAAO,CAAC,QAAQ,CAAC,CAAiB;IAClC,OAAO,CAAC,MAAM,CAAC,CAA0B;IAEzC,YACW,MAAM,EAAE,QAAQ,EACR,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC/B,YAAY,EAAE,oBAAoB,EAClC,OAAO,EAAE,eAAe,EACxB,WAAW,EAAE,MAAM,IAAI,EACvB,oBAAoB,EAAE,MAAM,gBAAgB,EAC3D;IAEJ,QAAQ,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAY9D;IAED,KAAK,IAAI,IAAI,CAIZ;YAEa,eAAe;CAY9B"}

package/dist/session/discovery/discovery.js

@@ -0,0 +1,56 @@
+import { runSessionOperation } from '../context/index.js';
+import { rootViewCatalog } from '../views/index.js';
+import { createSessionSnapshot } from './snapshot.js';
+export class SessionDiscovery {
+    kernel;
+    policy;
+    publications;
+    bundles;
+    requireOpen;
+    acquisitionOperation;
+    retained;
+    flight;
+    constructor(kernel, policy, publications, bundles, requireOpen, acquisitionOperation) {
+        this.kernel = kernel;
+        this.policy = policy;
+        this.publications = publications;
+        this.bundles = bundles;
+        this.requireOpen = requireOpen;
+        this.acquisitionOperation = acquisitionOperation;
+    }
+    snapshot(operation) {
+        this.requireOpen();
+        const current = this.flight;
+        if (current !== undefined)
+            return runSessionOperation(operation, () => current);
+        const flight = this.acquireSnapshot(this.acquisitionOperation());
+        this.flight = flight;
+        void flight
+            .finally(() => {
+            if (this.flight === flight)
+                this.flight = undefined;
+        })
+            .catch(() => undefined);
+        return runSessionOperation(operation, () => flight);
+    }
+    clear() {
+        this.publications.invalidate();
+        this.bundles.clear();
+        this.retained = undefined;
+    }
+    async acquireSnapshot(operation) {
+        const previous = this.publications.current();
+        const publication = await this.publications.revalidate(operation);
+        if (previous !== undefined && previous.etag !== publication.etag)
+            this.bundles.clear();
+        const artifact = await this.bundles.get(publication, operation);
+        this.requireOpen();
+        if (this.retained?.publication.etag === publication.etag)
+            return this.retained;
+        const views = rootViewCatalog(publication, artifact, this.policy);
+        const snapshot = createSessionSnapshot(this.kernel, publication, artifact, views);
+        this.retained = snapshot;
+        return snapshot;
+    }
+}
+//# sourceMappingURL=discovery.js.map

package/dist/session/discovery/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../../session/discovery/discovery.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAErD,MAAM,OAAO,gBAAgB;IAKhB,MAAM;IACE,MAAM;IACN,YAAY;IACZ,OAAO;IACP,WAAW;IACX,oBAAoB;IAT/B,QAAQ,CAAkB;IAC1B,MAAM,CAA2B;IAEzC,YACW,MAAgB,EACR,MAA+B,EAC/B,YAAkC,EAClC,OAAwB,EACxB,WAAuB,EACvB,oBAA4C;sBALpD,MAAM;sBACE,MAAM;4BACN,YAAY;uBACZ,OAAO;2BACP,WAAW;oCACX,oBAAoB;IACpC,CAAC;IAEJ,QAAQ,CAAC,SAA2B;QAClC,IAAI,CAAC,WAAW,EAAE,CAAA;QAClB,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAA;QAC3B,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,mBAAmB,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,CAAA;QAC/E,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC,CAAA;QAChE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,KAAK,MAAM;aACR,OAAO,CAAC,GAAG,EAAE;YACZ,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM;gBAAE,IAAI,CAAC,MAAM,GAAG,SAAS,CAAA;QACrD,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;QACzB,OAAO,mBAAmB,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,CAAA;IACrD,CAAC;IAED,KAAK;QACH,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,CAAA;QAC9B,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;QACpB,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAA;IAC3B,CAAC;IAEO,KAAK,CAAC,eAAe,CAAC,SAA2B;QACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAA;QAC5C,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,SAAS,CAAC,CAAA;QACjE,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,IAAI,KAAK,WAAW,CAAC,IAAI;YAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;QACtF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,CAAA;QAC/D,IAAI,CAAC,WAAW,EAAE,CAAA;QAClB,IAAI,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,IAAI,KAAK,WAAW,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC,QAAQ,CAAA;QAC9E,MAAM,KAAK,GAAG,eAAe,CAAC,WAAW,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;QACjE,MAAM,QAAQ,GAAG,qBAAqB,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAA;QACjF,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,OAAO,QAAQ,CAAA;IACjB,CAAC;CACF"}

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

@@ -0,0 +1,21 @@
+import type { IssuerId } from '@astrale-os/kernel-core/auth';
+import type { Fetch } from '../../transport/http/index.js';
+import type { SessionOperation, SessionPolicy } from '../context/index.js';
+import type { SessionSnapshot } from './snapshot.js';
+export type { SessionSnapshot } from './snapshot.js';
+export interface SessionDiscovery {
+    readonly kernel: IssuerId;
+    snapshot(operation: SessionOperation): Promise<SessionSnapshot>;
+    clear(): void;
+}
+export interface SessionDiscoveryOptions {
+    readonly kernel: IssuerId;
+    readonly fetch: Fetch;
+    readonly policy: Readonly<SessionPolicy>;
+    readonly maximumPublicationBytes: number;
+    readonly maximumBundleBytes: number;
+    readonly requireOpen: () => void;
+    readonly acquisitionOperation: () => SessionOperation;
+}
+export declare function createSessionDiscovery(options: SessionDiscoveryOptions): SessionDiscovery;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../session/discovery/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAA;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAMpD,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAEpD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IAC/D,KAAK,IAAI,IAAI,CAAA;CACd;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAA;IACxC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAA;IACxC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,IAAI,CAAA;IAChC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;CACtD;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,GAAG,gBAAgB,CAkBzF"}

package/dist/session/discovery/index.js

@@ -0,0 +1,16 @@
+import { BundleDiscovery } from './bundle.js';
+import { SessionDiscovery as SessionDiscoveryImplementation } from './discovery.js';
+import { PublicationDiscovery } from './publication.js';
+export function createSessionDiscovery(options) {
+    return new SessionDiscoveryImplementation(options.kernel, options.policy, new PublicationDiscovery({
+        kernel: options.kernel,
+        fetch: options.fetch,
+        policy: options.policy,
+        maximumBytes: options.maximumPublicationBytes,
+    }), new BundleDiscovery({
+        fetch: options.fetch,
+        policy: options.policy,
+        maximumBytes: options.maximumBundleBytes,
+    }), options.requireOpen, options.acquisitionOperation);
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../session/discovery/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,EAAE,gBAAgB,IAAI,8BAA8B,EAAE,MAAM,gBAAgB,CAAA;AACnF,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAoBvD,MAAM,UAAU,sBAAsB,CAAC,OAAgC;IACrE,OAAO,IAAI,8BAA8B,CACvC,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,MAAM,EACd,IAAI,oBAAoB,CAAC;QACvB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,YAAY,EAAE,OAAO,CAAC,uBAAuB;KAC9C,CAAC,EACF,IAAI,eAAe,CAAC;QAClB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,YAAY,EAAE,OAAO,CAAC,kBAAkB;KACzC,CAAC,EACF,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,oBAAoB,CAC7B,CAAA;AACH,CAAC"}

package/dist/session/discovery/publication.d.ts

@@ -0,0 +1,24 @@
+import type { IssuerId } from '@astrale-os/kernel-core/auth';
+import type { publication } from '@astrale-os/kernel-protocol';
+import type { Fetch } from '../../transport/http/index.js';
+import type { SessionOperation } from '../context/index.js';
+import { type SessionPolicy } from '../context/index.js';
+export interface PublicationDiscoveryOptions {
+    readonly kernel: IssuerId;
+    readonly fetch: Fetch;
+    readonly policy: Readonly<SessionPolicy>;
+    readonly maximumBytes: number;
+}
+export declare class PublicationDiscovery {
+    private readonly options;
+    private publication;
+    private revision;
+    constructor(options: PublicationDiscoveryOptions);
+    current(): publication.Publication | undefined;
+    revalidate(operation: SessionOperation): Promise<publication.Publication>;
+    invalidate(): void;
+    private fetch;
+}
+export declare function boundedResponse(response: Response, maximum: number, signal: AbortSignal): Promise<Uint8Array>;
+export declare function requireExactResponse(response: Response, expected: string, label: string): void;
+//# sourceMappingURL=publication.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"publication.d.ts","sourceRoot":"","sources":["../../../session/discovery/publication.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAI9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAA;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAG3D,OAAO,EAAsC,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAE5F,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAA;IACxC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAC9B;AAED,qBAAa,oBAAoB;IAInB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,WAAW,CAAqC;IACxD,OAAO,CAAC,QAAQ,CAAI;IAEpB,YAA6B,OAAO,EAAE,2BAA2B,EAAI;IAErE,OAAO,IAAI,WAAW,CAAC,WAAW,GAAG,SAAS,CAE7C;IAEK,UAAU,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,CAQ9E;IAED,UAAU,IAAI,IAAI,CAGjB;YAEa,KAAK;CA2CpB;AAED,wBAAsB,eAAe,CACnC,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,UAAU,CAAC,CAiCrB;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAI9F"}

package/dist/session/discovery/publication.js

@@ -0,0 +1,122 @@
+import { codecs, publication as publicationCodec } from '@astrale-os/kernel-protocol';
+import { ClientError } from '../../errors/index.js';
+import { allowEndpoint, runSessionOperation } from '../context/index.js';
+export class PublicationDiscovery {
+    options;
+    publication;
+    revision = 0;
+    constructor(options) {
+        this.options = options;
+    }
+    current() {
+        return this.publication;
+    }
+    async revalidate(operation) {
+        const revision = this.revision;
+        const previous = this.publication;
+        const discovered = await this.fetch(operation, previous);
+        if (revision !== this.revision)
+            return this.revalidate(operation);
+        const retained = previous?.etag === discovered.etag ? previous : discovered;
+        this.publication = retained;
+        return retained;
+    }
+    invalidate() {
+        this.revision += 1;
+        this.publication = undefined;
+    }
+    async fetch(operation, previous) {
+        const url = publicationCodec.url(this.options.kernel);
+        allowEndpoint(url, this.options.policy);
+        const response = await runSessionOperation(operation, (signal) => this.options.fetch(url, {
+            headers: {
+                accept: 'application/json',
+                ...(previous === undefined ? {} : { 'if-none-match': `"${previous.etag}"` }),
+            },
+            redirect: 'manual',
+            signal,
+        }));
+        requireExactResponse(response, url, 'Publication discovery');
+        if (response.status === 304) {
+            if (previous === undefined) {
+                throw new ClientError('Publication discovery returned an unexpected not-modified response.');
+            }
+            const etag = response.headers.get('etag');
+            if (etag !== null && etag !== `"${previous.etag}"`) {
+                throw new ClientError('Publication not-modified ETag differs from the cached snapshot.');
+            }
+            return previous;
+        }
+        if (!response.ok) {
+            throw new ClientError(`Publication discovery returned HTTP ${response.status}.`);
+        }
+        const body = await runSessionOperation(operation, (signal) => boundedResponse(response, this.options.maximumBytes, signal));
+        const admitted = publicationCodec.accept(codecs.json.decode(body));
+        if (admitted.identity.issuer !== this.options.kernel) {
+            throw new ClientError('Publication issuer differs from the requested Kernel issuer.');
+        }
+        const etag = response.headers.get('etag');
+        if (etag !== null && etag !== `"${admitted.etag}"`) {
+            throw new ClientError('Publication response ETag differs from its canonical content.');
+        }
+        return admitted;
+    }
+}
+export async function boundedResponse(response, maximum, signal) {
+    const declared = response.headers.get('content-length');
+    if (declared !== null) {
+        const length = Number(declared);
+        if (!Number.isSafeInteger(length) || length < 0) {
+            throw new ClientError('Response Content-Length is invalid.');
+        }
+        if (length > maximum)
+            throw new ClientError('Response exceeds its byte limit.');
+    }
+    if (response.body === null)
+        return new Uint8Array();
+    const reader = response.body.getReader();
+    const chunks = [];
+    let total = 0;
+    const abort = () => void reader.cancel(signal.reason).catch(() => undefined);
+    if (signal.aborted)
+        abort();
+    else
+        signal.addEventListener('abort', abort, { once: true });
+    try {
+        while (true) {
+            if (signal.aborted)
+                throw signal.reason;
+            const next = await reader.read();
+            if (next.done)
+                break;
+            total += next.value.byteLength;
+            if (total > maximum) {
+                await reader.cancel('response exceeds byte limit').catch(() => undefined);
+                throw new ClientError('Response exceeds its byte limit.');
+            }
+            chunks.push(next.value);
+        }
+    }
+    finally {
+        signal.removeEventListener('abort', abort);
+        reader.releaseLock();
+    }
+    return join(chunks, total);
+}
+export function requireExactResponse(response, expected, label) {
+    if (response.redirected || response.url !== expected) {
+        throw new ClientError(`${label} did not return the exact requested URL.`);
+    }
+}
+function join(parts, length) {
+    if (parts.length === 1)
+        return new Uint8Array(parts[0]);
+    const output = new Uint8Array(length);
+    let offset = 0;
+    for (const part of parts) {
+        output.set(part, offset);
+        offset += part.byteLength;
+    }
+    return output;
+}
+//# sourceMappingURL=publication.js.map

package/dist/session/discovery/publication.js.map

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

package/dist/session/discovery/snapshot.d.ts

@@ -0,0 +1,13 @@
+import type { IssuerId } from '@astrale-os/kernel-core/auth';
+import type { bundle } from '@astrale-os/kernel-dsl/v1';
+import type { publication } from '@astrale-os/kernel-protocol';
+import type { ViewCatalog } from '../views/index.js';
+/** Coherent public observation acquired through one Client Session at one Publication ETag. */
+export interface SessionSnapshot {
+    readonly kernel: IssuerId;
+    readonly publication: publication.Publication;
+    readonly bundle: bundle.Bundle;
+    readonly views: ViewCatalog;
+}
+export declare function createSessionSnapshot(kernel: IssuerId, publication: publication.Publication, artifact: bundle.Bundle, views: ViewCatalog): SessionSnapshot;
+//# sourceMappingURL=snapshot.d.ts.map