@hypequery/deployment 0.0.0-canary-20260719200737 → 0.1.0

package/dist/node-runtime-factory.js

@@ -1,274 +0,0 @@
-import { createHash } from 'node:crypto';
-import { chmod, lstat, mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises';
-import { tmpdir } from 'node:os';
-import path from 'node:path';
-import { Worker } from 'node:worker_threads';
-const DEFAULT_STARTUP_TIMEOUT_MS = 30_000;
-const MAX_STARTUP_TIMEOUT_MS = 5 * 60_000;
-const WORKER_SOURCE = [
-    "const { parentPort, workerData } = require('node:worker_threads');",
-    "const { pathToFileURL } = require('node:url');",
-    'const handlers = new Map();',
-    'function errorValue(error) {',
-    "  return { name: error instanceof Error ? error.name : 'Error',",
-    "    message: error instanceof Error ? error.message : String(error) };",
-    '}',
-    'function resolveEntrypoint(module, entrypoint) {',
-    '  let value = module;',
-    "  for (const segment of entrypoint.split('.')) value = value?.[segment];",
-    "  if (typeof value !== 'function') throw new Error(`Runtime entrypoint is unavailable: ${entrypoint}`);",
-    '  return value;',
-    '}',
-    '(async () => {',
-    '  for (const artifact of workerData.artifacts) {',
-    '    const module = await import(pathToFileURL(artifact.path).href);',
-    '    for (const entrypoint of artifact.entrypoints) {',
-    '      handlers.set(entrypoint, resolveEntrypoint(module, entrypoint));',
-    '    }',
-    '  }',
-    "  parentPort.postMessage({ kind: 'ready' });",
-    "  parentPort.on('message', async message => {",
-    "    if (message.kind === 'health') {",
-    "      parentPort.postMessage({ kind: 'result', id: message.id, value: null });",
-    '      return;',
-    '    }',
-    "    if (message.kind !== 'invoke') return;",
-    '    try {',
-    '      const handler = handlers.get(message.entrypoint);',
-    "      if (!handler) throw new Error(`Runtime entrypoint is unavailable: ${message.entrypoint}`);",
-    '      const value = await handler(message.argument);',
-    "      parentPort.postMessage({ kind: 'result', id: message.id, value });",
-    '    } catch (error) {',
-    "      parentPort.postMessage({ kind: 'failure', id: message.id, error: errorValue(error) });",
-    '    }',
-    '  });',
-    '})().catch(error => {',
-    "  parentPort.postMessage({ kind: 'fatal', error: errorValue(error) });",
-    '});',
-].join('\n');
-export class NodeDeploymentRuntimeError extends Error {
-    code;
-    constructor(code, message, options = {}) {
-        super(message, options.cause === undefined ? undefined : { cause: options.cause });
-        this.name = 'NodeDeploymentRuntimeError';
-        this.code = code;
-    }
-}
-function nodeRuntimeError(code, message, cause) {
-    return new NodeDeploymentRuntimeError(code, message, { cause });
-}
-function startupTimeout(input) {
-    const value = input ?? DEFAULT_STARTUP_TIMEOUT_MS;
-    if (!Number.isSafeInteger(value) || value < 1 || value > MAX_STARTUP_TIMEOUT_MS) {
-        throw nodeRuntimeError('HQ_NODE_RUNTIME_CONFIGURATION', `startupTimeoutMs must be between 1 and ${MAX_STARTUP_TIMEOUT_MS}.`);
-    }
-    return value;
-}
-function sha256(bytes) {
-    return createHash('sha256').update(bytes).digest('hex');
-}
-async function ensureTemporaryDirectory(input) {
-    const directory = path.resolve(input ?? tmpdir());
-    await mkdir(directory, { recursive: true, mode: 0o700 });
-    const stat = await lstat(directory);
-    if (stat.isSymbolicLink() || !stat.isDirectory()) {
-        throw nodeRuntimeError('HQ_NODE_RUNTIME_CONFIGURATION', 'The Node runtime temporary directory must be a regular directory.');
-    }
-    return directory;
-}
-function remoteError(input) {
-    const message = typeof input?.message === 'string'
-        ? input.message.slice(0, 4096)
-        : 'The runtime worker failed without an error message.';
-    const error = new Error(message);
-    if (typeof input?.name === 'string')
-        error.name = input.name.slice(0, 128);
-    return error;
-}
-function workerInstance(worker, directory, ready) {
-    const pending = new Map();
-    let sequence = 0;
-    let closed = false;
-    let closePromise;
-    let terminalError;
-    function failPending(error) {
-        for (const call of pending.values()) {
-            call.cleanup();
-            call.reject(error);
-        }
-        pending.clear();
-    }
-    worker.on('message', (message) => {
-        if ((message.kind !== 'result' && message.kind !== 'failure')
-            || !Number.isSafeInteger(message.id))
-            return;
-        const call = pending.get(message.id);
-        if (!call)
-            return;
-        pending.delete(message.id);
-        call.cleanup();
-        if (message.kind === 'result')
-            call.resolve(message.value);
-        else
-            call.reject(nodeRuntimeError('HQ_NODE_RUNTIME_INVOCATION_FAILED', 'The Node deployment runtime invocation failed.', remoteError(message.error)));
-    });
-    worker.on('error', error => {
-        terminalError = nodeRuntimeError('HQ_NODE_RUNTIME_WORKER_EXITED', 'The Node deployment runtime worker failed.', error);
-        failPending(terminalError);
-    });
-    worker.on('exit', code => {
-        if (!closed) {
-            terminalError = nodeRuntimeError('HQ_NODE_RUNTIME_WORKER_EXITED', `The Node deployment runtime worker exited unexpectedly with code ${code}.`);
-            failPending(terminalError);
-        }
-    });
-    function call(kind, payload, signal) {
-        if (closed || terminalError) {
-            return Promise.reject(terminalError ?? nodeRuntimeError('HQ_NODE_RUNTIME_CLOSED', 'The Node deployment runtime worker is closed.'));
-        }
-        if (signal?.aborted) {
-            return Promise.reject(nodeRuntimeError('HQ_NODE_RUNTIME_ABORTED', 'The Node deployment runtime invocation was aborted.', signal.reason));
-        }
-        const id = sequence;
-        sequence += 1;
-        return new Promise((resolve, reject) => {
-            const observeAbort = kind === 'health';
-            const abort = () => {
-                pending.delete(id);
-                reject(nodeRuntimeError('HQ_NODE_RUNTIME_ABORTED', 'The Node deployment runtime health check was aborted.', signal?.reason));
-            };
-            const cleanup = () => signal?.removeEventListener('abort', abort);
-            pending.set(id, { resolve, reject, cleanup });
-            if (observeAbort)
-                signal?.addEventListener('abort', abort, { once: true });
-            try {
-                worker.postMessage({ kind, id, ...payload });
-            }
-            catch (error) {
-                pending.delete(id);
-                cleanup();
-                reject(nodeRuntimeError('HQ_NODE_RUNTIME_INVOCATION_FAILED', 'The Node deployment runtime invocation could not be sent.', error));
-            }
-        });
-    }
-    return {
-        ready,
-        async healthCheck({ signal }) {
-            await call('health', {}, signal);
-        },
-        invoke(input) {
-            return call('invoke', {
-                entrypoint: input.binding.entrypoint,
-                argument: input.argument,
-            }, input.signal);
-        },
-        async close() {
-            if (closePromise)
-                return closePromise;
-            closed = true;
-            const error = nodeRuntimeError('HQ_NODE_RUNTIME_CLOSED', 'The Node deployment runtime worker was closed.');
-            failPending(error);
-            closePromise = (async () => {
-                try {
-                    await worker.terminate();
-                }
-                finally {
-                    await rm(directory, { force: true, recursive: true });
-                }
-            })();
-            return closePromise;
-        },
-    };
-}
-async function startWorker(snapshot, directory, timeoutMs, signal) {
-    if (signal?.aborted) {
-        throw nodeRuntimeError('HQ_NODE_RUNTIME_ABORTED', 'Node runtime startup was aborted.', signal.reason);
-    }
-    const artifacts = [];
-    for (const artifact of snapshot.artifacts) {
-        if (artifact.runtime !== 'node') {
-            throw nodeRuntimeError('HQ_NODE_RUNTIME_UNSUPPORTED_ARTIFACT', `The Node runtime factory cannot load a ${artifact.runtime} artifact.`);
-        }
-        const bytes = artifact.read();
-        if (bytes.byteLength !== artifact.byteLength || sha256(bytes) !== artifact.artifactSha256) {
-            throw nodeRuntimeError('HQ_NODE_RUNTIME_INVALID_ARTIFACT', 'Materialized Node runtime bytes do not match their identity.');
-        }
-        const artifactPath = path.join(directory, `${artifact.artifactSha256}.mjs`);
-        await writeFile(artifactPath, bytes, { flag: 'wx', mode: 0o600 });
-        artifacts.push(Object.freeze({ path: artifactPath, entrypoints: artifact.entrypoints }));
-    }
-    if (artifacts.length === 0) {
-        throw nodeRuntimeError('HQ_NODE_RUNTIME_UNSUPPORTED_ARTIFACT', 'The deployment snapshot contains no Node runtime artifacts.');
-    }
-    const worker = new Worker(WORKER_SOURCE, {
-        eval: true,
-        workerData: { artifacts },
-    });
-    let resolveReady;
-    let rejectReady;
-    const ready = new Promise((resolve, reject) => {
-        resolveReady = resolve;
-        rejectReady = reject;
-    });
-    const timer = setTimeout(() => {
-        rejectReady(nodeRuntimeError('HQ_NODE_RUNTIME_START_FAILED', 'The Node deployment runtime did not start before its deadline.'));
-    }, timeoutMs);
-    timer.unref();
-    const abort = () => rejectReady(nodeRuntimeError('HQ_NODE_RUNTIME_ABORTED', 'Node runtime startup was aborted.', signal?.reason));
-    signal?.addEventListener('abort', abort, { once: true });
-    const startupMessage = (message) => {
-        if (message.kind === 'ready')
-            resolveReady();
-        if (message.kind === 'fatal')
-            rejectReady(nodeRuntimeError('HQ_NODE_RUNTIME_START_FAILED', 'The Node deployment runtime could not import its artifacts.', remoteError(message.error)));
-    };
-    const startupError = (error) => rejectReady(nodeRuntimeError('HQ_NODE_RUNTIME_START_FAILED', 'The Node deployment runtime worker failed during startup.', error));
-    const startupExit = (code) => rejectReady(nodeRuntimeError('HQ_NODE_RUNTIME_START_FAILED', `The Node deployment runtime worker exited during startup with code ${code}.`));
-    worker.on('message', startupMessage);
-    worker.once('error', startupError);
-    worker.once('exit', startupExit);
-    const instance = workerInstance(worker, directory, ready);
-    try {
-        await ready;
-        return instance;
-    }
-    catch (error) {
-        try {
-            await instance.close();
-        }
-        catch {
-            // Preserve the startup failure; cleanup can be retried by the factory.
-        }
-        throw error;
-    }
-    finally {
-        clearTimeout(timer);
-        signal?.removeEventListener('abort', abort);
-        worker.off('message', startupMessage);
-        worker.off('error', startupError);
-        worker.off('exit', startupExit);
-    }
-}
-export function createNodeWorkerDeploymentRuntimeFactory(options = {}) {
-    const timeoutMs = startupTimeout(options.startupTimeoutMs);
-    return Object.freeze({
-        async start(snapshot, input) {
-            const root = await ensureTemporaryDirectory(options.temporaryDirectory);
-            const directory = await mkdtemp(path.join(root, 'hypequery-node-runtime-'));
-            try {
-                await chmod(directory, 0o700);
-                return await startWorker(snapshot, directory, timeoutMs, input.signal);
-            }
-            catch (error) {
-                try {
-                    await rm(directory, { force: true, recursive: true });
-                }
-                catch (cleanupError) {
-                    options.onCleanupError?.(cleanupError, directory);
-                    // Preserve the error that prevented a runtime from starting.
-                }
-                throw error;
-            }
-        },
-    });
-}

package/dist/runtime-materialization.d.ts

@@ -1,58 +0,0 @@
-import type { ProtocolDeploymentContract, ProtocolDeploymentReleaseEnvelope, ProtocolDeploymentReleaseTarget } from '@hypequery/protocol';
-import type { DeploymentActivationRecord, DeploymentActivationRegistry } from './activation.js';
-import { type VerifiedDeploymentBundle } from './bundle.js';
-export type DeploymentRuntimeMaterializationErrorCode = 'HQ_RUNTIME_MATERIALIZATION_CONFIGURATION' | 'HQ_RUNTIME_MATERIALIZATION_ACTIVATION_UNAVAILABLE' | 'HQ_RUNTIME_MATERIALIZATION_RELEASE_NOT_FOUND' | 'HQ_RUNTIME_MATERIALIZATION_RELEASE_INVALID' | 'HQ_RUNTIME_MATERIALIZATION_ARTIFACT_INVALID' | 'HQ_RUNTIME_MATERIALIZATION_UNSTABLE_ACTIVATION';
-export declare class DeploymentRuntimeMaterializationError extends Error {
-    readonly code: DeploymentRuntimeMaterializationErrorCode;
-    constructor(code: DeploymentRuntimeMaterializationErrorCode, message: string, options?: {
-        readonly cause?: unknown;
-    });
-}
-export interface DeploymentRuntimeRelease {
-    readonly release: ProtocolDeploymentReleaseEnvelope;
-    readonly releaseIdentity: string;
-    readonly bundle: VerifiedDeploymentBundle;
-}
-export interface DeploymentRuntimeReleaseReader {
-    /** Return only a fully revalidated accepted release and its closed bundle. */
-    read(releaseIdentity: string): Promise<DeploymentRuntimeRelease | undefined>;
-}
-export interface DeploymentRuntimeArtifactSnapshot {
-    readonly runtime: 'node' | 'python';
-    readonly artifactSha256: string;
-    readonly byteLength: number;
-    readonly entrypoints: readonly string[];
-    /** Returns a fresh copy so callers cannot mutate the materialized bytes. */
-    read(): Uint8Array;
-}
-export interface DeploymentRuntimeQueryBinding {
-    readonly query: string;
-    readonly runtime: 'node' | 'python';
-    readonly artifactSha256: string;
-    readonly entrypoint: string;
-}
-export interface DeploymentRuntimeSnapshot {
-    readonly target: ProtocolDeploymentReleaseTarget;
-    readonly activation: DeploymentActivationRecord;
-    readonly release: ProtocolDeploymentReleaseEnvelope;
-    readonly releaseIdentity: string;
-    readonly bundleIdentity: string;
-    readonly deployment: ProtocolDeploymentContract;
-    readonly artifacts: readonly DeploymentRuntimeArtifactSnapshot[];
-    readonly queries: readonly DeploymentRuntimeQueryBinding[];
-}
-export interface DeploymentRuntimeMaterializer {
-    /**
-     * Materialize the current activation and confirm it remained current while
-     * its bytes were copied. Returns undefined when the target has no activation.
-     */
-    current(target: ProtocolDeploymentReleaseTarget): Promise<DeploymentRuntimeSnapshot | undefined>;
-}
-export interface DeploymentRuntimeMaterializerOptions {
-    readonly activations: DeploymentActivationRegistry;
-    readonly releases: DeploymentRuntimeReleaseReader;
-    /** Activation-stability attempts from 1 through 16. */
-    readonly maxStabilityAttempts?: number;
-}
-export declare function createDeploymentRuntimeMaterializer(options: DeploymentRuntimeMaterializerOptions): DeploymentRuntimeMaterializer;
-//# sourceMappingURL=runtime-materialization.d.ts.map

package/dist/runtime-materialization.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"runtime-materialization.d.ts","sourceRoot":"","sources":["../src/runtime-materialization.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,0BAA0B,EAC1B,iCAAiC,EACjC,+BAA+B,EAChC,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EACV,0BAA0B,EAC1B,4BAA4B,EAC7B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,aAAa,CAAC;AAKrB,MAAM,MAAM,yCAAyC,GACjD,0CAA0C,GAC1C,mDAAmD,GACnD,8CAA8C,GAC9C,4CAA4C,GAC5C,6CAA6C,GAC7C,gDAAgD,CAAC;AAErD,qBAAa,qCAAsC,SAAQ,KAAK;IAC9D,QAAQ,CAAC,IAAI,EAAE,yCAAyC,CAAC;gBAGvD,IAAI,EAAE,yCAAyC,EAC/C,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAM7C;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE,iCAAiC,CAAC;IACpD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;CAC3C;AAED,MAAM,WAAW,8BAA8B;IAC7C,8EAA8E;IAC9E,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,GAAG,SAAS,CAAC,CAAC;CAC9E;AAED,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,4EAA4E;IAC5E,IAAI,IAAI,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,+BAA+B,CAAC;IACjD,QAAQ,CAAC,UAAU,EAAE,0BAA0B,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,iCAAiC,CAAC;IACpD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,0BAA0B,CAAC;IAChD,QAAQ,CAAC,SAAS,EAAE,SAAS,iCAAiC,EAAE,CAAC;IACjE,QAAQ,CAAC,OAAO,EAAE,SAAS,6BAA6B,EAAE,CAAC;CAC5D;AAED,MAAM,WAAW,6BAA6B;IAC5C;;;OAGG;IACH,OAAO,CAAC,MAAM,EAAE,+BAA+B,GAAG,OAAO,CAAC,yBAAyB,GAAG,SAAS,CAAC,CAAC;CAClG;AAED,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,WAAW,EAAE,4BAA4B,CAAC;IACnD,QAAQ,CAAC,QAAQ,EAAE,8BAA8B,CAAC;IAClD,uDAAuD;IACvD,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACxC;AA4LD,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,oCAAoC,GAC5C,6BAA6B,CA+C/B"}

package/dist/runtime-materialization.js

@@ -1,187 +0,0 @@
-import { createHash } from 'node:crypto';
-import { constants } from 'node:fs';
-import { lstat, open } from 'node:fs/promises';
-import path from 'node:path';
-import { prepareProtocolDeploymentReleaseEnvelope } from '@hypequery/protocol';
-import { validateDeploymentActivationRecord } from './activation.js';
-import { verifyDeploymentBundle, } from './bundle.js';
-const DEFAULT_STABILITY_ATTEMPTS = 4;
-const MAX_STABILITY_ATTEMPTS = 16;
-export class DeploymentRuntimeMaterializationError extends Error {
-    code;
-    constructor(code, message, options = {}) {
-        super(message, options.cause === undefined ? undefined : { cause: options.cause });
-        this.name = 'DeploymentRuntimeMaterializationError';
-        this.code = code;
-    }
-}
-function materializationError(code, message, cause) {
-    return new DeploymentRuntimeMaterializationError(code, message, { cause });
-}
-function sameTarget(left, right) {
-    return left.project === right.project && left.environment === right.environment;
-}
-function sha256(bytes) {
-    return createHash('sha256').update(bytes).digest('hex');
-}
-async function readArtifact(bundleDirectory, artifact) {
-    const artifactPath = path.join(bundleDirectory, ...artifact.path.split('/'));
-    let handle;
-    try {
-        const initial = await lstat(artifactPath);
-        if (initial.isSymbolicLink() || !initial.isFile() || initial.size !== artifact.byteLength) {
-            throw new Error('Runtime artifact is not the declared bounded regular file.');
-        }
-        handle = await open(artifactPath, constants.O_RDONLY | constants.O_NOFOLLOW);
-        const stat = await handle.stat();
-        if (!stat.isFile() || stat.size !== artifact.byteLength) {
-            throw new Error('Runtime artifact changed before materialization.');
-        }
-        const bytes = await handle.readFile();
-        if (bytes.byteLength !== artifact.byteLength || sha256(bytes) !== artifact.sha256) {
-            throw new Error('Runtime artifact bytes do not match the closed bundle manifest.');
-        }
-        await handle.close();
-        handle = undefined;
-        return Uint8Array.from(bytes);
-    }
-    catch (error) {
-        try {
-            await handle?.close();
-        }
-        catch {
-            // Preserve the validation failure that made this artifact unusable.
-        }
-        throw materializationError('HQ_RUNTIME_MATERIALIZATION_ARTIFACT_INVALID', 'A deployment runtime artifact could not be materialized.', error);
-    }
-}
-function artifactSnapshot(input, bytes) {
-    const materialized = Uint8Array.from(bytes);
-    return Object.freeze({
-        runtime: input.runtime,
-        artifactSha256: input.artifactSha256,
-        byteLength: materialized.byteLength,
-        entrypoints: Object.freeze([...input.entrypoints]),
-        read: () => Uint8Array.from(materialized),
-    });
-}
-async function materializeActivation(activation, releases) {
-    let stored;
-    try {
-        stored = await releases.read(activation.releaseIdentity);
-    }
-    catch (error) {
-        throw materializationError('HQ_RUNTIME_MATERIALIZATION_RELEASE_INVALID', 'The active deployment release could not be revalidated.', error);
-    }
-    if (!stored) {
-        throw materializationError('HQ_RUNTIME_MATERIALIZATION_RELEASE_NOT_FOUND', 'The active deployment release was not found.');
-    }
-    let release;
-    let releaseIdentity;
-    try {
-        const prepared = prepareProtocolDeploymentReleaseEnvelope(stored.release);
-        release = prepared.release;
-        releaseIdentity = prepared.identity;
-    }
-    catch (error) {
-        throw materializationError('HQ_RUNTIME_MATERIALIZATION_RELEASE_INVALID', 'The active deployment release envelope is invalid.', error);
-    }
-    if (stored.releaseIdentity !== activation.releaseIdentity
-        || releaseIdentity !== activation.releaseIdentity
-        || !sameTarget(release.target, activation.target)
-        || release.bundleIdentity !== stored.bundle.identity) {
-        throw materializationError('HQ_RUNTIME_MATERIALIZATION_RELEASE_INVALID', 'The active deployment release is inconsistent with its activation or bundle.');
-    }
-    let bundle;
-    try {
-        bundle = await verifyDeploymentBundle(stored.bundle.directory);
-    }
-    catch (error) {
-        throw materializationError('HQ_RUNTIME_MATERIALIZATION_RELEASE_INVALID', 'The active deployment bundle could not be revalidated.', error);
-    }
-    if (bundle.identity !== stored.bundle.identity
-        || bundle.identity !== release.bundleIdentity) {
-        throw materializationError('HQ_RUNTIME_MATERIALIZATION_RELEASE_INVALID', 'The active deployment bundle identity is inconsistent.');
-    }
-    const entrypoints = new Map();
-    const queries = [];
-    for (const query of bundle.contract.queries) {
-        const implementation = query.implementation;
-        if (implementation.kind !== 'runtime-reference')
-            continue;
-        const names = entrypoints.get(implementation.artifactSha256) ?? [];
-        names.push(implementation.entrypoint);
-        entrypoints.set(implementation.artifactSha256, names);
-        queries.push(Object.freeze({
-            query: query.name,
-            runtime: implementation.runtime,
-            artifactSha256: implementation.artifactSha256,
-            entrypoint: implementation.entrypoint,
-        }));
-    }
-    const artifacts = [];
-    for (const artifact of bundle.manifest.artifacts) {
-        const bytes = await readArtifact(bundle.directory, artifact);
-        artifacts.push(artifactSnapshot({
-            runtime: artifact.runtime,
-            artifactSha256: artifact.sha256,
-            entrypoints: [...new Set(entrypoints.get(artifact.sha256) ?? [])].sort(),
-        }, bytes));
-    }
-    artifacts.sort((left, right) => left.artifactSha256.localeCompare(right.artifactSha256));
-    queries.sort((left, right) => left.query.localeCompare(right.query));
-    return Object.freeze({
-        target: activation.target,
-        activation,
-        release,
-        releaseIdentity,
-        bundleIdentity: bundle.identity,
-        deployment: bundle.contract,
-        artifacts: Object.freeze(artifacts),
-        queries: Object.freeze(queries),
-    });
-}
-function stabilityAttempts(input) {
-    const value = input ?? DEFAULT_STABILITY_ATTEMPTS;
-    if (!Number.isSafeInteger(value) || value < 1 || value > MAX_STABILITY_ATTEMPTS) {
-        throw materializationError('HQ_RUNTIME_MATERIALIZATION_CONFIGURATION', `maxStabilityAttempts must be between 1 and ${MAX_STABILITY_ATTEMPTS}.`);
-    }
-    return value;
-}
-export function createDeploymentRuntimeMaterializer(options) {
-    const maximumAttempts = stabilityAttempts(options.maxStabilityAttempts);
-    if (!constants.O_NOFOLLOW) {
-        throw materializationError('HQ_RUNTIME_MATERIALIZATION_CONFIGURATION', 'Runtime materialization requires filesystem no-follow support.');
-    }
-    async function currentActivation(target) {
-        try {
-            const activation = await options.activations.current(target);
-            if (!activation)
-                return undefined;
-            const validated = validateDeploymentActivationRecord(activation);
-            if (!sameTarget(validated.target, target)) {
-                throw new Error('Deployment activation target does not match the requested target.');
-            }
-            return validated;
-        }
-        catch (error) {
-            throw materializationError('HQ_RUNTIME_MATERIALIZATION_ACTIVATION_UNAVAILABLE', 'Deployment activation state could not be read.', error);
-        }
-    }
-    return Object.freeze({
-        async current(target) {
-            for (let attempt = 0; attempt < maximumAttempts; attempt += 1) {
-                const activation = await currentActivation(target);
-                if (!activation)
-                    return undefined;
-                const snapshot = await materializeActivation(activation, options.releases);
-                const confirmed = await currentActivation(target);
-                if (!confirmed)
-                    return undefined;
-                if (confirmed.revision === activation.revision)
-                    return snapshot;
-            }
-            throw materializationError('HQ_RUNTIME_MATERIALIZATION_UNSTABLE_ACTIVATION', 'Deployment activation changed repeatedly during runtime materialization.');
-        },
-    });
-}

package/dist/runtime-supervisor.d.ts

@@ -1,70 +0,0 @@
-import type { ProtocolDeploymentReleaseTarget } from '@hypequery/protocol';
-import type { DeploymentRuntimeMaterializer, DeploymentRuntimeQueryBinding, DeploymentRuntimeSnapshot } from './runtime-materialization.js';
-export type DeploymentRuntimeSupervisorErrorCode = 'HQ_RUNTIME_SUPERVISOR_CONFIGURATION' | 'HQ_RUNTIME_SUPERVISOR_CLOSED' | 'HQ_RUNTIME_NOT_READY' | 'HQ_RUNTIME_QUERY_NOT_FOUND' | 'HQ_RUNTIME_QUERY_NOT_EXECUTABLE' | 'HQ_RUNTIME_START_FAILED' | 'HQ_RUNTIME_HEALTH_FAILED' | 'HQ_RUNTIME_INVOCATION_FAILED' | 'HQ_RUNTIME_RECONCILE_UNSTABLE' | 'HQ_RUNTIME_ABORTED';
-export declare class DeploymentRuntimeSupervisorError extends Error {
-    readonly code: DeploymentRuntimeSupervisorErrorCode;
-    constructor(code: DeploymentRuntimeSupervisorErrorCode, message: string, options?: {
-        readonly cause?: unknown;
-    });
-}
-export interface DeploymentRuntimeInstanceInvocation {
-    readonly query: string;
-    readonly binding: DeploymentRuntimeQueryBinding;
-    readonly argument: unknown;
-    readonly signal?: AbortSignal;
-}
-export interface DeploymentRuntimeInstance {
-    healthCheck(input: {
-        readonly signal?: AbortSignal;
-    }): Promise<void>;
-    invoke(input: DeploymentRuntimeInstanceInvocation): Promise<unknown>;
-    close(): Promise<void>;
-}
-export interface DeploymentRuntimeFactory {
-    start(snapshot: DeploymentRuntimeSnapshot, input: {
-        readonly signal?: AbortSignal;
-    }): Promise<DeploymentRuntimeInstance>;
-}
-export interface DeploymentRuntimeInvocation {
-    readonly target: ProtocolDeploymentReleaseTarget;
-    readonly query: string;
-    readonly argument: unknown;
-    readonly signal?: AbortSignal;
-}
-export interface DeploymentRuntimeStatus {
-    readonly target: ProtocolDeploymentReleaseTarget;
-    readonly activationRevision: string;
-    readonly releaseIdentity: string;
-    readonly bundleIdentity: string;
-}
-export type DeploymentRuntimeReconcileResult = {
-    readonly status: 'activated';
-    readonly runtime: DeploymentRuntimeStatus;
-} | {
-    readonly status: 'already-current';
-    readonly runtime: DeploymentRuntimeStatus;
-} | {
-    readonly status: 'deactivated';
-    readonly previous: DeploymentRuntimeStatus;
-} | {
-    readonly status: 'no-active-release';
-};
-export interface DeploymentRuntimeSupervisor {
-    reconcile(target: ProtocolDeploymentReleaseTarget, options?: {
-        readonly signal?: AbortSignal;
-    }): Promise<DeploymentRuntimeReconcileResult>;
-    invoke(input: DeploymentRuntimeInvocation): Promise<unknown>;
-    status(target: ProtocolDeploymentReleaseTarget): DeploymentRuntimeStatus | undefined;
-    close(): Promise<void>;
-}
-export interface DeploymentRuntimeSupervisorOptions {
-    readonly materializer: DeploymentRuntimeMaterializer;
-    readonly factory: DeploymentRuntimeFactory;
-    /** In-flight drain deadline from 0 through 300,000 milliseconds. */
-    readonly drainTimeoutMs?: number;
-    /** Activation-stability attempts from 1 through 16. */
-    readonly maxReconcileAttempts?: number;
-    readonly onBackgroundError?: (error: unknown) => void;
-}
-export declare function createDeploymentRuntimeSupervisor(options: DeploymentRuntimeSupervisorOptions): DeploymentRuntimeSupervisor;
-//# sourceMappingURL=runtime-supervisor.d.ts.map

package/dist/runtime-supervisor.d.ts.map

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