@hypequery/deployment 0.4.0 → 0.5.0

package/README.md

@@ -1,13 +1,12 @@
 # @hypequery/deployment
 
-Provider-neutral verification, intake, activation, and HTTP control-plane
+Provider-neutral verification, intake, activation, runtime, and HTTP hosting
 building blocks for Hypequery deployment bundles.
 
 The package accepts the authenticated multipart transport emitted by
 `hypequery deploy`, reconstructs only manifest-declared files in temporary
 storage, and revalidates the release, bundle manifest, file hashes, deployment
-identity, and runtime references before handing the submission to a store. It
-does not activate or execute a release.
+identity, and runtime references before handing the submission to a store.
 
 ## Intake adapters
 
@@ -292,4 +291,58 @@ Semantic-plan and compiled-SQL adapters own database execution. The core passes
 only validated values, the fixed implementation artifact, and closed typed SQL
 parameter bindings; it does not select credentials or interpolate SQL.
 
+## Data-plane hosting
+
+`createDeploymentHost` keeps route/schema execution and supervised runtime
+dispatch pinned to the same activation revision. Reconciliation builds a new
+data plane from the supervisor's immutable generation view and publishes it
+only after confirming that the active generation did not change during
+configuration.
+
+`createDeploymentDataPlaneFetchHandler` and
+`createDeploymentDataPlaneNodeHandler` expose a hosted data plane over HTTP.
+They accept either query parameters or one bounded UTF-8 JSON body, reject
+duplicate JSON property names, forward cancellation, and return bounded JSON
+errors. Public cache metadata is emitted only when execution confirms the
+request was public, tenant-independent, and unauthenticated.
+
+For a single-node service, `createFileSystemDeploymentHost` composes the
+filesystem submission store, activation registry, intake, control plane,
+runtime materializer, supervisor, and generation-pinned data plane. It
+reconciles configured targets at startup and schedules reconciliation after a
+durable activation without changing an already-successful activation response
+if runtime startup later fails.
+
+```ts
+import {
+  createDeploymentDataPlaneNodeHandler,
+  createFileSystemDeploymentHost,
+} from '@hypequery/deployment';
+
+const service = createFileSystemDeploymentHost({
+  directory: '/var/lib/hypequery/deployments',
+  targets: [{ project: 'analytics', environment: 'production' }],
+  intake: { authenticator: deploymentAuthenticator, authorizer: deploymentAuthorizer },
+  controlPlane: { authenticator: operatorAuthenticator, authorizer: operatorAuthorizer },
+  configureDataPlane: () => ({
+    authenticate: queryAuthenticator,
+    resolveTenant,
+    executeSemanticPlan,
+    executeCompiledSql,
+    runtimeArgument: ({ input, principal, tenant }) => ({ input, principal, tenant }),
+  }),
+});
+
+await service.start();
+const queryHandler = createDeploymentDataPlaneNodeHandler(
+  service.host.dataPlane({ project: 'analytics', environment: 'production' }),
+);
+```
+
+Cloud and other distributed systems can use the same host, supervisor, and HTTP
+adapter interfaces while supplying provider-owned persistence, runtime, SQL,
+authentication, tenant, routing, and observability implementations. The
+filesystem assembly is a reference single-host composition, not a distributed
+control plane.
+
 The package is ESM-only and requires Node.js 20 or newer.

package/dist/control-plane.d.ts

@@ -1,5 +1,5 @@
 import { type ProtocolDeploymentReleaseTarget } from '@hypequery/protocol';
-import { type DeploymentActivationRegistry } from './activation.js';
+import { type DeploymentActivationRecord, type DeploymentActivationRegistry } from './activation.js';
 import { type DeploymentControlPlaneLimits } from './control-plane-limits.js';
 import type { DeploymentAuthenticator, DeploymentIntake, DeploymentIntakeRequest, DeploymentIntakeResponse } from './types.js';
 export type DeploymentControlPlaneAction = 'activate' | 'read-current-activation' | 'read-activation-history';
@@ -29,6 +29,9 @@ export interface DeploymentControlPlaneOptions<Principal> {
     readonly authenticator: DeploymentAuthenticator<Principal>;
     readonly authorizer: DeploymentControlPlaneAuthorizer<Principal>;
     readonly limits?: Partial<DeploymentControlPlaneLimits>;
+    /** Called after a successful activation has been durably committed. */
+    readonly onActivation?: (activation: DeploymentActivationRecord) => void | Promise<void>;
+    readonly onBackgroundError?: (error: unknown) => void;
 }
 export type DeploymentControlPlaneErrorCode = 'HQ_CONTROL_BAD_REQUEST' | 'HQ_CONTROL_UNAUTHENTICATED' | 'HQ_CONTROL_FORBIDDEN' | 'HQ_CONTROL_NOT_FOUND' | 'HQ_CONTROL_METHOD_NOT_ALLOWED' | 'HQ_CONTROL_TOO_LARGE' | 'HQ_CONTROL_RELEASE_NOT_FOUND' | 'HQ_CONTROL_RELEASE_UNAVAILABLE' | 'HQ_CONTROL_INTERNAL';
 export declare function createDeploymentControlPlane<Principal>(options: DeploymentControlPlaneOptions<Principal>): DeploymentControlPlane;

package/dist/control-plane.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"control-plane.d.ts","sourceRoot":"","sources":["../src/control-plane.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,+BAA+B,EACrC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAGL,KAAK,4BAA4B,EAClC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EACV,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,YAAY,CAAC;AAMpB,MAAM,MAAM,4BAA4B,GACpC,UAAU,GACV,yBAAyB,GACzB,yBAAyB,CAAC;AAE9B,MAAM,WAAW,wCAAwC,CAAC,SAAS;IACjE,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,4BAA4B,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,+BAA+B,CAAC;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,WAAW,gCAAgC,CAAC,SAAS;IACzD,SAAS,CAAC,KAAK,EAAE,wCAAwC,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACzF;AAED,MAAM,WAAW,6BAA8B,SAAQ,uBAAuB;IAC5E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC;IAClF,sEAAsE;IACtE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,MAAM,8BAA8B,GAAG,wBAAwB,CAAC;AAEtE,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,OAAO,EAAE,6BAA6B,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAAC;CACzF;AAED,MAAM,WAAW,6BAA6B,CAAC,SAAS;IACtD,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,4BAA4B,CAAC;IACnD,QAAQ,CAAC,aAAa,EAAE,uBAAuB,CAAC,SAAS,CAAC,CAAC;IAC3D,QAAQ,CAAC,UAAU,EAAE,gCAAgC,CAAC,SAAS,CAAC,CAAC;IACjE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,4BAA4B,CAAC,CAAC;CACzD;AAED,MAAM,MAAM,+BAA+B,GACvC,wBAAwB,GACxB,4BAA4B,GAC5B,sBAAsB,GACtB,sBAAsB,GACtB,+BAA+B,GAC/B,sBAAsB,GACtB,8BAA8B,GAC9B,gCAAgC,GAChC,qBAAqB,CAAC;AA+X1B,wBAAgB,4BAA4B,CAAC,SAAS,EACpD,OAAO,EAAE,6BAA6B,CAAC,SAAS,CAAC,GAChD,sBAAsB,CAkHxB"}
+{"version":3,"file":"control-plane.d.ts","sourceRoot":"","sources":["../src/control-plane.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,+BAA+B,EACrC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAEL,KAAK,0BAA0B,EAC/B,KAAK,4BAA4B,EAClC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EACV,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,YAAY,CAAC;AAMpB,MAAM,MAAM,4BAA4B,GACpC,UAAU,GACV,yBAAyB,GACzB,yBAAyB,CAAC;AAE9B,MAAM,WAAW,wCAAwC,CAAC,SAAS;IACjE,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,4BAA4B,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,+BAA+B,CAAC;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,WAAW,gCAAgC,CAAC,SAAS;IACzD,SAAS,CAAC,KAAK,EAAE,wCAAwC,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACzF;AAED,MAAM,WAAW,6BAA8B,SAAQ,uBAAuB;IAC5E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC;IAClF,sEAAsE;IACtE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,MAAM,8BAA8B,GAAG,wBAAwB,CAAC;AAEtE,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,OAAO,EAAE,6BAA6B,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAAC;CACzF;AAED,MAAM,WAAW,6BAA6B,CAAC,SAAS;IACtD,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,4BAA4B,CAAC;IACnD,QAAQ,CAAC,aAAa,EAAE,uBAAuB,CAAC,SAAS,CAAC,CAAC;IAC3D,QAAQ,CAAC,UAAU,EAAE,gCAAgC,CAAC,SAAS,CAAC,CAAC;IACjE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,4BAA4B,CAAC,CAAC;IACxD,uEAAuE;IACvE,QAAQ,CAAC,YAAY,CAAC,EAAE,CACtB,UAAU,EAAE,0BAA0B,KACnC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACvD;AAED,MAAM,MAAM,+BAA+B,GACvC,wBAAwB,GACxB,4BAA4B,GAC5B,sBAAsB,GACtB,sBAAsB,GACtB,+BAA+B,GAC/B,sBAAsB,GACtB,8BAA8B,GAC9B,gCAAgC,GAChC,qBAAqB,CAAC;AA+X1B,wBAAgB,4BAA4B,CAAC,SAAS,EACpD,OAAO,EAAE,6BAA6B,CAAC,SAAS,CAAC,GAChD,sBAAsB,CAoIxB"}

package/dist/control-plane.js

@@ -269,6 +269,24 @@ function validatedHistoryQuery(query, maximum) {
 }
 export function createDeploymentControlPlane(options) {
     const limits = resolveDeploymentControlPlaneLimits(options.limits);
+    function reportBackgroundError(error) {
+        try {
+            options.onBackgroundError?.(error);
+        }
+        catch {
+            // Diagnostics cannot change the result of an already-durable activation.
+        }
+    }
+    function notifyActivation(activation) {
+        try {
+            const operation = options.onActivation?.(activation);
+            if (operation)
+                void Promise.resolve(operation).catch(reportBackgroundError);
+        }
+        catch (error) {
+            reportBackgroundError(error);
+        }
+    }
     async function authenticateAndAuthorize(request, action, target) {
         throwIfAborted(request.signal);
         const token = bearerToken(request.headers);
@@ -334,6 +352,7 @@ export function createDeploymentControlPlane(options) {
                     current: result.current,
                 });
             }
+            notifyActivation(result.activation);
             return activationResponse(result.status, result.activation);
         }
         requireMethod(method, 'GET');

package/dist/data-plane-adapters.d.ts

@@ -0,0 +1,18 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import { type DeploymentDataPlane } from './data-plane.js';
+export type DeploymentDataPlaneFetchHandler = (request: Request) => Promise<Response>;
+export type DeploymentDataPlaneNodeHandler = (request: IncomingMessage, response: ServerResponse) => Promise<void>;
+export interface DeploymentDataPlaneAdapterRequest {
+    readonly method: string;
+    readonly path: string;
+    readonly query: Readonly<Record<string, string | readonly string[]>>;
+    readonly headers: Readonly<Record<string, string>>;
+}
+export interface DeploymentDataPlaneAdapterOptions {
+    /** Request body limit from 1 through 1,048,576 bytes. */
+    readonly maxRequestBytes?: number;
+    readonly credentials?: (request: DeploymentDataPlaneAdapterRequest) => unknown;
+}
+export declare function createDeploymentDataPlaneFetchHandler(dataPlane: DeploymentDataPlane, options?: DeploymentDataPlaneAdapterOptions): DeploymentDataPlaneFetchHandler;
+export declare function createDeploymentDataPlaneNodeHandler(dataPlane: DeploymentDataPlane, options?: DeploymentDataPlaneAdapterOptions): DeploymentDataPlaneNodeHandler;
+//# sourceMappingURL=data-plane-adapters.d.ts.map

package/dist/data-plane-adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-plane-adapters.d.ts","sourceRoot":"","sources":["../src/data-plane-adapters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAIjE,OAAO,EAEL,KAAK,mBAAmB,EAEzB,MAAM,iBAAiB,CAAC;AAGzB,MAAM,MAAM,+BAA+B,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AACtF,MAAM,MAAM,8BAA8B,GAAG,CAC3C,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,cAAc,KACrB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;IACrE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,iCAAiC;IAChD,yDAAyD;IACzD,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,iCAAiC,KAAK,OAAO,CAAC;CAChF;AAoPD,wBAAgB,qCAAqC,CACnD,SAAS,EAAE,mBAAmB,EAC9B,OAAO,GAAE,iCAAsC,GAC9C,+BAA+B,CAwBjC;AAqDD,wBAAgB,oCAAoC,CAClD,SAAS,EAAE,mBAAmB,EAC9B,OAAO,GAAE,iCAAsC,GAC9C,8BAA8B,CAuChC"}

package/dist/data-plane-adapters.js

@@ -0,0 +1,304 @@
+import { DEFAULT_PROTOCOL_SCHEMA_VALUE_LIMITS, } from '@hypequery/protocol';
+import { DeploymentDataPlaneError, } from './data-plane.js';
+import { DeploymentHostError } from './host.js';
+class AdapterError extends Error {
+    code;
+    status;
+    constructor(code, status, message) {
+        super(message);
+        this.code = code;
+        this.status = status;
+    }
+}
+const JSON_CONTENT_TYPE = /^application\/json(?:;\s*charset=utf-8)?$/i;
+function maximumBytes(input) {
+    const maximum = DEFAULT_PROTOCOL_SCHEMA_VALUE_LIMITS.maxInputBytes;
+    const value = input ?? maximum;
+    if (!Number.isSafeInteger(value) || value < 1 || value > maximum) {
+        throw new RangeError(`maxRequestBytes must be an integer between 1 and ${maximum}`);
+    }
+    return value;
+}
+function queryParameters(search) {
+    const query = Object.create(null);
+    for (const [name, value] of search) {
+        const current = query[name];
+        if (current === undefined)
+            query[name] = value;
+        else if (typeof current === 'string')
+            query[name] = Object.freeze([current, value]);
+        else
+            query[name] = Object.freeze([...current, value]);
+    }
+    return Object.freeze(query);
+}
+function contentLength(headers, maximum) {
+    const value = headers['content-length'];
+    if (value === undefined)
+        return undefined;
+    if (!/^(?:0|[1-9][0-9]*)$/.test(value)) {
+        throw new AdapterError('HQ_DATA_PLANE_INPUT_INVALID', 400, 'Content-Length is invalid.');
+    }
+    const length = Number(value);
+    if (!Number.isSafeInteger(length)) {
+        throw new AdapterError('HQ_DATA_PLANE_INPUT_INVALID', 400, 'Content-Length is invalid.');
+    }
+    if (length > maximum) {
+        throw new AdapterError('HQ_DATA_PLANE_REQUEST_TOO_LARGE', 413, 'The data-plane request exceeds its byte limit.');
+    }
+    return length;
+}
+function requestInput(query, body, contentType) {
+    const hasQuery = Object.keys(query).length > 0;
+    if (body !== undefined && hasQuery) {
+        throw new AdapterError('HQ_DATA_PLANE_INPUT_INVALID', 400, 'A data-plane request cannot contain both query parameters and a JSON body.');
+    }
+    if (body !== undefined) {
+        if (!contentType || !JSON_CONTENT_TYPE.test(contentType)) {
+            throw new AdapterError('HQ_DATA_PLANE_INPUT_INVALID', 400, 'Data-plane request bodies require application/json with UTF-8 encoding.');
+        }
+        return body;
+    }
+    return hasQuery ? JSON.stringify(query) : undefined;
+}
+function credentials(options, request) {
+    return options.credentials ? options.credentials(request) : request.headers.authorization;
+}
+function cacheControl(result) {
+    if (result.cacheTtlMs === undefined || result.cacheTtlMs <= 0)
+        return 'no-store';
+    return `public, max-age=${Math.floor(result.cacheTtlMs / 1_000)}`;
+}
+function successResponse(result) {
+    if (result.output === undefined) {
+        return Object.freeze({
+            status: 204,
+            headers: Object.freeze({ 'cache-control': cacheControl(result) }),
+        });
+    }
+    const body = `${JSON.stringify(result.output)}\n`;
+    return Object.freeze({
+        status: 200,
+        headers: Object.freeze({
+            'content-type': 'application/json; charset=utf-8',
+            'content-length': String(Buffer.byteLength(body)),
+            'cache-control': cacheControl(result),
+        }),
+        body,
+    });
+}
+function errorStatus(error) {
+    switch (error.code) {
+        case 'HQ_DATA_PLANE_INPUT_INVALID': return 400;
+        case 'HQ_DATA_PLANE_UNAUTHENTICATED': return 401;
+        case 'HQ_DATA_PLANE_FORBIDDEN':
+        case 'HQ_DATA_PLANE_TENANT_REQUIRED': return 403;
+        case 'HQ_DATA_PLANE_ROUTE_NOT_FOUND': return 404;
+        case 'HQ_DATA_PLANE_METHOD_NOT_ALLOWED': return 405;
+        case 'HQ_DATA_PLANE_ABORTED': return 499;
+        case 'HQ_DATA_PLANE_EXECUTOR_UNAVAILABLE': return 503;
+        default: return 500;
+    }
+}
+function errorResponse(error) {
+    let status = 500;
+    let code = 'HQ_DATA_PLANE_INTERNAL';
+    let message = 'The deployment data-plane request could not be processed.';
+    let path;
+    if (error instanceof AdapterError) {
+        status = error.status;
+        code = error.code;
+        message = error.message;
+    }
+    else if (error instanceof DeploymentDataPlaneError) {
+        status = errorStatus(error);
+        code = error.code;
+        if (status < 500) {
+            message = error.message;
+            path = error.path;
+        }
+    }
+    else if (error instanceof DeploymentHostError) {
+        code = error.code;
+        if (error.code === 'HQ_DEPLOYMENT_HOST_NOT_READY'
+            || error.code === 'HQ_DEPLOYMENT_HOST_CLOSED') {
+            status = 503;
+            message = error.message;
+        }
+    }
+    const body = `${JSON.stringify({
+        error: { code, message, ...(path === undefined ? {} : { path }) },
+    })}\n`;
+    return Object.freeze({
+        status,
+        headers: Object.freeze({
+            'content-type': 'application/json; charset=utf-8',
+            'content-length': String(Buffer.byteLength(body)),
+            'cache-control': 'no-store',
+            ...(status === 401 ? { 'www-authenticate': 'Bearer' } : {}),
+        }),
+        body,
+    });
+}
+async function execute(dataPlane, options, request, input, signal) {
+    try {
+        const result = await dataPlane.executeJson({
+            ...request,
+            input,
+            credentials: credentials(options, request),
+            signal,
+        });
+        return successResponse(result);
+    }
+    catch (error) {
+        return errorResponse(error);
+    }
+}
+function fetchHeaders(input) {
+    const headers = Object.create(null);
+    for (const [name, value] of input)
+        headers[name.toLowerCase()] = value;
+    if (headers.authorization?.includes(',')) {
+        throw new AdapterError('HQ_DATA_PLANE_INPUT_INVALID', 400, 'Authorization header is ambiguous.');
+    }
+    return Object.freeze(headers);
+}
+async function fetchBytes(stream, declared, maximum) {
+    if (stream === null) {
+        if (declared !== undefined && declared !== 0) {
+            throw new AdapterError('HQ_DATA_PLANE_INPUT_INVALID', 400, 'Request body length is invalid.');
+        }
+        return undefined;
+    }
+    const reader = stream.getReader();
+    const chunks = [];
+    let total = 0;
+    try {
+        while (true) {
+            const result = await reader.read();
+            if (result.done)
+                break;
+            total += result.value.byteLength;
+            if (total > maximum)
+                throw new AdapterError('HQ_DATA_PLANE_REQUEST_TOO_LARGE', 413, 'The data-plane request exceeds its byte limit.');
+            if (declared !== undefined && total > declared) {
+                throw new AdapterError('HQ_DATA_PLANE_INPUT_INVALID', 400, 'Request body length is invalid.');
+            }
+            chunks.push(result.value);
+        }
+    }
+    catch (error) {
+        await reader.cancel(error).catch(() => undefined);
+        throw error;
+    }
+    finally {
+        reader.releaseLock();
+    }
+    if (declared !== undefined && total !== declared) {
+        throw new AdapterError('HQ_DATA_PLANE_INPUT_INVALID', 400, 'Request body length is invalid.');
+    }
+    const bytes = new Uint8Array(total);
+    let offset = 0;
+    for (const chunk of chunks) {
+        bytes.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return bytes.byteLength === 0 ? undefined : bytes;
+}
+export function createDeploymentDataPlaneFetchHandler(dataPlane, options = {}) {
+    const maximum = maximumBytes(options.maxRequestBytes);
+    return async (request) => {
+        let response;
+        try {
+            const url = new URL(request.url);
+            const headers = fetchHeaders(request.headers);
+            const query = queryParameters(url.searchParams);
+            const body = await fetchBytes(request.body, contentLength(headers, maximum), maximum);
+            const adapted = Object.freeze({
+                method: request.method.toUpperCase(), path: url.pathname, query, headers,
+            });
+            response = await execute(dataPlane, options, adapted, requestInput(query, body, headers['content-type']), request.signal);
+        }
+        catch (error) {
+            response = errorResponse(error);
+        }
+        return new Response(response.body ?? null, { status: response.status, headers: response.headers });
+    };
+}
+function nodeHeaders(request) {
+    const headers = Object.create(null);
+    for (let index = 0; index < request.rawHeaders.length; index += 2) {
+        const name = request.rawHeaders[index].toLowerCase();
+        const value = request.rawHeaders[index + 1];
+        if (name === 'authorization' && headers[name] !== undefined) {
+            throw new AdapterError('HQ_DATA_PLANE_INPUT_INVALID', 400, 'Authorization header is ambiguous.');
+        }
+        headers[name] = headers[name] === undefined ? value : `${headers[name]}, ${value}`;
+    }
+    return Object.freeze(headers);
+}
+function nodeHasBody(headers) {
+    return headers['transfer-encoding'] !== undefined
+        || headers['content-length'] !== undefined && headers['content-length'] !== '0';
+}
+async function nodeBytes(request, hasBody, declared, maximum) {
+    if (!hasBody)
+        return undefined;
+    const chunks = [];
+    let total = 0;
+    for await (const chunk of request) {
+        const bytes = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        total += bytes.byteLength;
+        if (total > maximum)
+            throw new AdapterError('HQ_DATA_PLANE_REQUEST_TOO_LARGE', 413, 'The data-plane request exceeds its byte limit.');
+        if (declared !== undefined && total > declared) {
+            throw new AdapterError('HQ_DATA_PLANE_INPUT_INVALID', 400, 'Request body length is invalid.');
+        }
+        chunks.push(bytes);
+    }
+    if (declared !== undefined && total !== declared) {
+        throw new AdapterError('HQ_DATA_PLANE_INPUT_INVALID', 400, 'Request body length is invalid.');
+    }
+    return total === 0 ? undefined : Buffer.concat(chunks, total);
+}
+function sendNodeResponse(response, result) {
+    if (response.writableEnded || response.headersSent)
+        return;
+    response.statusCode = result.status;
+    for (const [name, value] of Object.entries(result.headers))
+        response.setHeader(name, value);
+    response.end(result.body);
+}
+export function createDeploymentDataPlaneNodeHandler(dataPlane, options = {}) {
+    const maximum = maximumBytes(options.maxRequestBytes);
+    return async (request, response) => {
+        const abort = new AbortController();
+        const onRequestClose = () => {
+            if (!request.complete)
+                abort.abort(new Error('The data-plane request was interrupted.'));
+        };
+        const onResponseClose = () => {
+            if (!response.writableEnded)
+                abort.abort(new Error('The data-plane response was interrupted.'));
+        };
+        request.once('close', onRequestClose);
+        response.once('close', onResponseClose);
+        try {
+            const url = new URL(request.url ?? '/', 'http://deployment-data-plane.invalid');
+            const headers = nodeHeaders(request);
+            const query = queryParameters(url.searchParams);
+            const body = await nodeBytes(request, nodeHasBody(headers), contentLength(headers, maximum), maximum);
+            const adapted = Object.freeze({
+                method: (request.method ?? 'GET').toUpperCase(), path: url.pathname, query, headers,
+            });
+            sendNodeResponse(response, await execute(dataPlane, options, adapted, requestInput(query, body, headers['content-type']), abort.signal));
+        }
+        catch (error) {
+            sendNodeResponse(response, errorResponse(error));
+        }
+        finally {
+            request.off('close', onRequestClose);
+            response.off('close', onResponseClose);
+        }
+    };
+}

package/dist/data-plane.d.ts

@@ -19,9 +19,14 @@ export interface DeploymentDataPlaneRequest {
     readonly method: string;
     readonly path: string;
     readonly input?: unknown;
+    readonly query?: Readonly<Record<string, string | readonly string[]>>;
+    readonly headers?: Readonly<Record<string, string>>;
     readonly credentials?: unknown;
     readonly signal?: AbortSignal;
 }
+export type DeploymentDataPlaneJsonRequest = Omit<DeploymentDataPlaneRequest, 'input'> & {
+    readonly input?: string | Uint8Array;
+};
 export interface DeploymentDataPlaneAuthenticationInput {
     readonly credentials: unknown;
     readonly request: DeploymentDataPlaneRequest;
@@ -64,6 +69,7 @@ export interface DeploymentDataPlaneResult {
 }
 export interface DeploymentDataPlane {
     execute(request: DeploymentDataPlaneRequest): Promise<DeploymentDataPlaneResult>;
+    executeJson(request: DeploymentDataPlaneJsonRequest): Promise<DeploymentDataPlaneResult>;
 }
 export interface DeploymentDataPlaneOptions {
     readonly deployment: ProtocolDeploymentContract;

package/dist/data-plane.d.ts.map

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

package/dist/data-plane.js

@@ -1,4 +1,4 @@
-import { createProtocolSchemaValueParser, ProtocolSchemaValueError, validateProtocolDeploymentContract, } from '@hypequery/protocol';
+import { createProtocolSchemaValueParser, ProtocolSchemaValueError, ProtocolValueError, validateProtocolDeploymentContract, } from '@hypequery/protocol';
 import { resolveDeploymentDataPlaneLimits, } from './data-plane-limits.js';
 export class DeploymentDataPlaneError extends Error {
     code;
@@ -72,129 +72,138 @@ export function createDeploymentDataPlane(options) {
     const limits = resolveDeploymentDataPlaneLimits(options.limits);
     const routes = routeTable(deployment, limits);
     const paths = new Set(deployment.queries.map(query => query.endpoint.path));
-    return Object.freeze({
-        async execute(request) {
-            throwIfAborted(request.signal);
-            const route = routes.get(`${request.method}\0${request.path}`);
-            if (!route) {
-                if (paths.has(request.path)) {
-                    throw dataPlaneError('HQ_DATA_PLANE_METHOD_NOT_ALLOWED', 'The deployment route does not support this method.');
-                }
-                throw dataPlaneError('HQ_DATA_PLANE_ROUTE_NOT_FOUND', 'The deployment route was not found.');
+    async function execute(request, json) {
+        throwIfAborted(request.signal);
+        const route = routes.get(`${request.method}\0${request.path}`);
+        if (!route) {
+            if (paths.has(request.path)) {
+                throw dataPlaneError('HQ_DATA_PLANE_METHOD_NOT_ALLOWED', 'The deployment route does not support this method.');
             }
-            const { query } = route;
-            let principal = null;
-            if (query.endpoint.access.kind === 'authenticated' && !options.authenticate) {
-                throw dataPlaneError('HQ_DATA_PLANE_CONFIGURATION', 'An authenticator is required for this deployment route.');
+            throw dataPlaneError('HQ_DATA_PLANE_ROUTE_NOT_FOUND', 'The deployment route was not found.');
+        }
+        const { query } = route;
+        let principal = null;
+        if (query.endpoint.access.kind === 'authenticated' && !options.authenticate) {
+            throw dataPlaneError('HQ_DATA_PLANE_CONFIGURATION', 'An authenticator is required for this deployment route.');
+        }
+        if (options.authenticate
+            && (query.endpoint.access.kind === 'authenticated' || request.credentials !== undefined)) {
+            try {
+                principal = await options.authenticate({ credentials: request.credentials, request, query });
             }
-            if (options.authenticate
-                && (query.endpoint.access.kind === 'authenticated' || request.credentials !== undefined)) {
-                try {
-                    principal = await options.authenticate({ credentials: request.credentials, request, query });
-                }
-                catch (error) {
-                    throw dataPlaneError('HQ_DATA_PLANE_UNAUTHENTICATED', 'Authentication failed.', error);
-                }
+            catch (error) {
+                throw dataPlaneError('HQ_DATA_PLANE_UNAUTHENTICATED', 'Authentication failed.', error);
             }
-            throwIfAborted(request.signal);
-            if (query.endpoint.access.kind === 'authenticated') {
-                if (!principal) {
-                    throw dataPlaneError('HQ_DATA_PLANE_UNAUTHENTICATED', 'Authentication is required.');
-                }
-                if (missing(query.endpoint.access.roles, principal.roles).length > 0
-                    || missing(query.endpoint.access.scopes, principal.scopes).length > 0) {
-                    throw dataPlaneError('HQ_DATA_PLANE_FORBIDDEN', 'The principal lacks required access.');
-                }
+        }
+        throwIfAborted(request.signal);
+        if (query.endpoint.access.kind === 'authenticated') {
+            if (!principal) {
+                throw dataPlaneError('HQ_DATA_PLANE_UNAUTHENTICATED', 'Authentication is required.');
+            }
+            if (missing(query.endpoint.access.roles, principal.roles).length > 0
+                || missing(query.endpoint.access.scopes, principal.scopes).length > 0) {
+                throw dataPlaneError('HQ_DATA_PLANE_FORBIDDEN', 'The principal lacks required access.');
             }
-            let tenant;
-            if (query.endpoint.tenant.kind !== 'not-required') {
-                if (!options.resolveTenant) {
-                    if (query.endpoint.tenant.kind === 'required') {
-                        throw dataPlaneError('HQ_DATA_PLANE_CONFIGURATION', 'A tenant resolver is required for this deployment route.');
-                    }
+        }
+        let tenant;
+        if (query.endpoint.tenant.kind !== 'not-required') {
+            if (!options.resolveTenant) {
+                if (query.endpoint.tenant.kind === 'required') {
+                    throw dataPlaneError('HQ_DATA_PLANE_CONFIGURATION', 'A tenant resolver is required for this deployment route.');
                 }
-                else {
-                    try {
-                        tenant = await options.resolveTenant({ principal, request, query });
-                    }
-                    catch (error) {
-                        throw dataPlaneError('HQ_DATA_PLANE_FORBIDDEN', 'Tenant resolution failed.', error);
-                    }
+            }
+            else {
+                try {
+                    tenant = await options.resolveTenant({ principal, request, query });
                 }
-                if (query.endpoint.tenant.kind === 'required' && (tenant === undefined || tenant === null)) {
-                    throw dataPlaneError('HQ_DATA_PLANE_TENANT_REQUIRED', 'Tenant context is required.');
+                catch (error) {
+                    throw dataPlaneError('HQ_DATA_PLANE_FORBIDDEN', 'Tenant resolution failed.', error);
                 }
             }
-            throwIfAborted(request.signal);
-            let input;
-            try {
-                input = route.input.parse(request.input);
+            if (query.endpoint.tenant.kind === 'required' && (tenant === undefined || tenant === null)) {
+                throw dataPlaneError('HQ_DATA_PLANE_TENANT_REQUIRED', 'Tenant context is required.');
             }
-            catch (error) {
-                if (error instanceof ProtocolSchemaValueError) {
-                    throw dataPlaneError('HQ_DATA_PLANE_INPUT_INVALID', 'The request input does not match the deployment schema.', error, error.path);
-                }
-                throw error;
+        }
+        throwIfAborted(request.signal);
+        let input;
+        try {
+            if (json && request.input !== undefined) {
+                if (typeof route.input.parseJson !== 'function')
+                    throw dataPlaneError('HQ_DATA_PLANE_CONFIGURATION', 'The route input parser does not support JSON request bodies.');
+                input = route.input.parseJson(request.input);
             }
-            const common = { query, input, principal, tenant, request, signal: request.signal };
-            let output;
-            try {
-                switch (query.implementation.kind) {
-                    case 'semantic-plan':
-                        if (!options.executeSemanticPlan)
-                            throw dataPlaneError('HQ_DATA_PLANE_EXECUTOR_UNAVAILABLE', 'No semantic-plan executor is configured.');
-                        output = await options.executeSemanticPlan({
-                            ...common,
-                            implementation: query.implementation,
-                            deployment,
-                        });
-                        break;
-                    case 'compiled-sql':
-                        if (!options.executeCompiledSql)
-                            throw dataPlaneError('HQ_DATA_PLANE_EXECUTOR_UNAVAILABLE', 'No compiled SQL executor is configured.');
-                        output = await options.executeCompiledSql({
-                            ...common,
-                            implementation: query.implementation,
-                            parameters: sqlParameters(query, input, tenant),
-                        });
-                        break;
-                    case 'runtime-reference':
-                        if (!options.executeRuntimeReference)
-                            throw dataPlaneError('HQ_DATA_PLANE_EXECUTOR_UNAVAILABLE', 'No runtime-reference executor is configured.');
-                        output = await options.executeRuntimeReference({
-                            ...common,
-                            implementation: query.implementation,
-                        });
-                        break;
-                }
+            else {
+                input = route.input.parse(request.input);
             }
-            catch (error) {
-                if (error instanceof DeploymentDataPlaneError)
-                    throw error;
-                if (request.signal?.aborted) {
-                    throw dataPlaneError('HQ_DATA_PLANE_ABORTED', 'The data-plane request was aborted.', error);
-                }
-                throw dataPlaneError('HQ_DATA_PLANE_EXECUTION_FAILED', 'Deployment query execution failed.', error);
+        }
+        catch (error) {
+            if (error instanceof ProtocolSchemaValueError || error instanceof ProtocolValueError) {
+                throw dataPlaneError('HQ_DATA_PLANE_INPUT_INVALID', 'The request input does not match the deployment schema.', error, error.path);
             }
-            try {
-                output = route.output.parse(output);
+            throw error;
+        }
+        const common = { query, input, principal, tenant, request, signal: request.signal };
+        let output;
+        try {
+            switch (query.implementation.kind) {
+                case 'semantic-plan':
+                    if (!options.executeSemanticPlan)
+                        throw dataPlaneError('HQ_DATA_PLANE_EXECUTOR_UNAVAILABLE', 'No semantic-plan executor is configured.');
+                    output = await options.executeSemanticPlan({
+                        ...common,
+                        implementation: query.implementation,
+                        deployment,
+                    });
+                    break;
+                case 'compiled-sql':
+                    if (!options.executeCompiledSql)
+                        throw dataPlaneError('HQ_DATA_PLANE_EXECUTOR_UNAVAILABLE', 'No compiled SQL executor is configured.');
+                    output = await options.executeCompiledSql({
+                        ...common,
+                        implementation: query.implementation,
+                        parameters: sqlParameters(query, input, tenant),
+                    });
+                    break;
+                case 'runtime-reference':
+                    if (!options.executeRuntimeReference)
+                        throw dataPlaneError('HQ_DATA_PLANE_EXECUTOR_UNAVAILABLE', 'No runtime-reference executor is configured.');
+                    output = await options.executeRuntimeReference({
+                        ...common,
+                        implementation: query.implementation,
+                    });
+                    break;
             }
-            catch (error) {
-                if (error instanceof ProtocolSchemaValueError) {
-                    throw dataPlaneError('HQ_DATA_PLANE_OUTPUT_INVALID', 'The query output does not match the deployment schema.', error, error.path);
-                }
+        }
+        catch (error) {
+            if (error instanceof DeploymentDataPlaneError)
                 throw error;
+            if (request.signal?.aborted) {
+                throw dataPlaneError('HQ_DATA_PLANE_ABORTED', 'The data-plane request was aborted.', error);
+            }
+            throw dataPlaneError('HQ_DATA_PLANE_EXECUTION_FAILED', 'Deployment query execution failed.', error);
+        }
+        try {
+            output = route.output.parse(output);
+        }
+        catch (error) {
+            if (error instanceof ProtocolSchemaValueError) {
+                throw dataPlaneError('HQ_DATA_PLANE_OUTPUT_INVALID', 'The query output does not match the deployment schema.', error, error.path);
             }
-            const publicCacheTtlMs = query.endpoint.access.kind === 'public'
-                && query.endpoint.tenant.kind === 'not-required'
-                && principal === null
-                ? query.endpoint.cacheTtlMs
-                : undefined;
-            return Object.freeze({
-                query: query.name,
-                output,
-                ...(publicCacheTtlMs === undefined ? {} : { cacheTtlMs: publicCacheTtlMs }),
-            });
-        },
+            throw error;
+        }
+        const publicCacheTtlMs = query.endpoint.access.kind === 'public'
+            && query.endpoint.tenant.kind === 'not-required'
+            && principal === null
+            ? query.endpoint.cacheTtlMs
+            : undefined;
+        return Object.freeze({
+            query: query.name,
+            output,
+            ...(publicCacheTtlMs === undefined ? {} : { cacheTtlMs: publicCacheTtlMs }),
+        });
+    }
+    return Object.freeze({
+        execute: (request) => execute(request, false),
+        executeJson: (request) => execute(request, true),
     });
 }

package/dist/filesystem-host.d.ts

@@ -0,0 +1,51 @@
+import type { ProtocolDeploymentReleaseTarget } from '@hypequery/protocol';
+import { type DeploymentActivationRegistry } from './activation.js';
+import { type DeploymentControlPlane, type DeploymentControlPlaneAuthorizer } from './control-plane.js';
+import type { DeploymentControlPlaneLimits } from './control-plane-limits.js';
+import { type FileSystemDeploymentSubmissionStore } from './filesystem-store.js';
+import { type DeploymentHost, type DeploymentHostDataPlaneConfiguration, type DeploymentHostDataPlaneInput } from './host.js';
+import type { DeploymentIntakeLimits } from './limits.js';
+import { type NodeDeploymentRuntimeFactoryOptions } from './node-runtime-factory.js';
+import { type DeploymentRuntimeMaterializer } from './runtime-materialization.js';
+import { type DeploymentRuntimeFactory, type DeploymentRuntimeSupervisor } from './runtime-supervisor.js';
+import type { DeploymentAuthenticator, DeploymentAuthorizer, DeploymentIntake } from './types.js';
+export interface FileSystemDeploymentHostOptions<SubmissionPrincipal, ControlPrincipal> {
+    readonly directory: string;
+    readonly targets: readonly ProtocolDeploymentReleaseTarget[];
+    readonly intake: {
+        readonly authenticator: DeploymentAuthenticator<SubmissionPrincipal>;
+        readonly authorizer: DeploymentAuthorizer<SubmissionPrincipal>;
+        readonly limits?: Partial<DeploymentIntakeLimits>;
+        readonly temporaryDirectory?: string;
+    };
+    readonly controlPlane: {
+        readonly authenticator: DeploymentAuthenticator<ControlPrincipal>;
+        readonly authorizer: DeploymentControlPlaneAuthorizer<ControlPrincipal>;
+        readonly limits?: Partial<DeploymentControlPlaneLimits>;
+    };
+    readonly configureDataPlane: (input: DeploymentHostDataPlaneInput) => DeploymentHostDataPlaneConfiguration | Promise<DeploymentHostDataPlaneConfiguration>;
+    /** Defaults to the reference Node worker runtime factory. */
+    readonly runtimeFactory?: DeploymentRuntimeFactory;
+    readonly nodeRuntime?: NodeDeploymentRuntimeFactoryOptions;
+    readonly activationClock?: () => Date;
+    readonly maxMaterializationAttempts?: number;
+    readonly drainTimeoutMs?: number;
+    readonly maxReconcileAttempts?: number;
+    readonly maxHostStabilityAttempts?: number;
+    readonly onBackgroundError?: (error: unknown) => void;
+}
+export interface FileSystemDeploymentHost<SubmissionPrincipal> {
+    readonly store: FileSystemDeploymentSubmissionStore<SubmissionPrincipal>;
+    readonly activations: DeploymentActivationRegistry;
+    readonly intake: DeploymentIntake;
+    readonly controlPlane: DeploymentControlPlane;
+    readonly materializer: DeploymentRuntimeMaterializer;
+    readonly supervisor: DeploymentRuntimeSupervisor;
+    readonly host: DeploymentHost;
+    start(options?: {
+        readonly signal?: AbortSignal;
+    }): Promise<void>;
+    close(): Promise<void>;
+}
+export declare function createFileSystemDeploymentHost<SubmissionPrincipal, ControlPrincipal>(options: FileSystemDeploymentHostOptions<SubmissionPrincipal, ControlPrincipal>): FileSystemDeploymentHost<SubmissionPrincipal>;
+//# sourceMappingURL=filesystem-host.d.ts.map

package/dist/filesystem-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-host.d.ts","sourceRoot":"","sources":["../src/filesystem-host.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,gCAAgC,EACtC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAEL,KAAK,mCAAmC,EACzC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,oCAAoC,EACzC,KAAK,4BAA4B,EAClC,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAEL,KAAK,mCAAmC,EACzC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAEL,KAAK,6BAA6B,EACnC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EACjC,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EACV,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,+BAA+B,CAAC,mBAAmB,EAAE,gBAAgB;IACpF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,+BAA+B,EAAE,CAAC;IAC7D,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,aAAa,EAAE,uBAAuB,CAAC,mBAAmB,CAAC,CAAC;QACrE,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC,mBAAmB,CAAC,CAAC;QAC/D,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;QAClD,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;KACtC,CAAC;IACF,QAAQ,CAAC,YAAY,EAAE;QACrB,QAAQ,CAAC,aAAa,EAAE,uBAAuB,CAAC,gBAAgB,CAAC,CAAC;QAClE,QAAQ,CAAC,UAAU,EAAE,gCAAgC,CAAC,gBAAgB,CAAC,CAAC;QACxE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,4BAA4B,CAAC,CAAC;KACzD,CAAC;IACF,QAAQ,CAAC,kBAAkB,EAAE,CAC3B,KAAK,EAAE,4BAA4B,KAChC,oCAAoC,GAAG,OAAO,CAAC,oCAAoC,CAAC,CAAC;IAC1F,6DAA6D;IAC7D,QAAQ,CAAC,cAAc,CAAC,EAAE,wBAAwB,CAAC;IACnD,QAAQ,CAAC,WAAW,CAAC,EAAE,mCAAmC,CAAC;IAC3D,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;IACtC,QAAQ,CAAC,0BAA0B,CAAC,EAAE,MAAM,CAAC;IAC7C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAC3C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACvD;AAED,MAAM,WAAW,wBAAwB,CAAC,mBAAmB;IAC3D,QAAQ,CAAC,KAAK,EAAE,mCAAmC,CAAC,mBAAmB,CAAC,CAAC;IACzE,QAAQ,CAAC,WAAW,EAAE,4BAA4B,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,sBAAsB,CAAC;IAC9C,QAAQ,CAAC,YAAY,EAAE,6BAA6B,CAAC;IACrD,QAAQ,CAAC,UAAU,EAAE,2BAA2B,CAAC;IACjD,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,KAAK,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAgB,8BAA8B,CAAC,mBAAmB,EAAE,gBAAgB,EAClF,OAAO,EAAE,+BAA+B,CAAC,mBAAmB,EAAE,gBAAgB,CAAC,GAC9E,wBAAwB,CAAC,mBAAmB,CAAC,CAgE/C"}

package/dist/filesystem-host.js

@@ -0,0 +1,73 @@
+import { createFileSystemDeploymentActivationRegistry, } from './activation.js';
+import { createDeploymentControlPlane, } from './control-plane.js';
+import { createFileSystemDeploymentSubmissionStore, } from './filesystem-store.js';
+import { createDeploymentHost, } from './host.js';
+import { createDeploymentIntake } from './intake.js';
+import { createNodeWorkerDeploymentRuntimeFactory, } from './node-runtime-factory.js';
+import { createDeploymentRuntimeMaterializer, } from './runtime-materialization.js';
+import { createDeploymentRuntimeSupervisor, } from './runtime-supervisor.js';
+export function createFileSystemDeploymentHost(options) {
+    if (options.runtimeFactory !== undefined && options.nodeRuntime !== undefined) {
+        throw new TypeError('runtimeFactory and nodeRuntime cannot both be configured.');
+    }
+    const targets = Object.freeze([...options.targets]);
+    const store = createFileSystemDeploymentSubmissionStore({
+        directory: options.directory,
+    });
+    const activations = createFileSystemDeploymentActivationRegistry({
+        directory: options.directory,
+        releases: store,
+        clock: options.activationClock,
+    });
+    const intake = createDeploymentIntake({
+        ...options.intake,
+        store,
+    });
+    const materializer = createDeploymentRuntimeMaterializer({
+        activations,
+        releases: store,
+        maxStabilityAttempts: options.maxMaterializationAttempts,
+    });
+    const runtimeFactory = options.runtimeFactory
+        ?? createNodeWorkerDeploymentRuntimeFactory(options.nodeRuntime);
+    const supervisor = createDeploymentRuntimeSupervisor({
+        materializer,
+        factory: runtimeFactory,
+        drainTimeoutMs: options.drainTimeoutMs,
+        maxReconcileAttempts: options.maxReconcileAttempts,
+        onBackgroundError: options.onBackgroundError,
+    });
+    const host = createDeploymentHost({
+        supervisor,
+        configureDataPlane: options.configureDataPlane,
+        maxStabilityAttempts: options.maxHostStabilityAttempts,
+        onBackgroundError: options.onBackgroundError,
+    });
+    const controlPlane = createDeploymentControlPlane({
+        intake,
+        activations,
+        ...options.controlPlane,
+        onActivation: activation => host.scheduleReconcile(activation.target),
+        onBackgroundError: options.onBackgroundError,
+    });
+    let startPromise;
+    const result = {
+        store,
+        activations,
+        intake,
+        controlPlane,
+        materializer,
+        supervisor,
+        host,
+        start(startOptions = {}) {
+            const pending = startPromise ??= host.start(targets, startOptions).then(() => undefined);
+            void pending.catch(() => {
+                if (startPromise === pending)
+                    startPromise = undefined;
+            });
+            return pending;
+        },
+        close: () => host.close(),
+    };
+    return Object.freeze(result);
+}

package/dist/host.d.ts

@@ -0,0 +1,40 @@
+import { type ProtocolDeploymentContract, type ProtocolDeploymentReleaseTarget } from '@hypequery/protocol';
+import { type DeploymentDataPlane, type DeploymentDataPlaneOptions, type DeploymentDataPlaneRequest, type DeploymentDataPlaneResult, type DeploymentRuntimeReferenceExecutionInput } from './data-plane.js';
+import type { DeploymentRuntimeReconcileResult, DeploymentRuntimeStatus, DeploymentRuntimeSupervisor } from './runtime-supervisor.js';
+export type DeploymentHostErrorCode = 'HQ_DEPLOYMENT_HOST_CONFIGURATION' | 'HQ_DEPLOYMENT_HOST_CLOSED' | 'HQ_DEPLOYMENT_HOST_NOT_READY' | 'HQ_DEPLOYMENT_HOST_RECONCILE_FAILED' | 'HQ_DEPLOYMENT_HOST_RECONCILE_UNSTABLE';
+export declare class DeploymentHostError extends Error {
+    readonly code: DeploymentHostErrorCode;
+    constructor(code: DeploymentHostErrorCode, message: string, options?: {
+        readonly cause?: unknown;
+    });
+}
+export interface DeploymentHostDataPlaneInput {
+    readonly target: ProtocolDeploymentReleaseTarget;
+    readonly status: DeploymentRuntimeStatus;
+    readonly deployment: ProtocolDeploymentContract;
+}
+export type DeploymentHostDataPlaneConfiguration = Omit<DeploymentDataPlaneOptions, 'deployment' | 'executeRuntimeReference'> & {
+    readonly runtimeArgument: (input: DeploymentRuntimeReferenceExecutionInput) => unknown;
+};
+export interface DeploymentHostOptions {
+    readonly supervisor: DeploymentRuntimeSupervisor;
+    readonly configureDataPlane: (input: DeploymentHostDataPlaneInput) => DeploymentHostDataPlaneConfiguration | Promise<DeploymentHostDataPlaneConfiguration>;
+    /** Generation-stability attempts from 1 through 16. */
+    readonly maxStabilityAttempts?: number;
+    readonly onBackgroundError?: (error: unknown) => void;
+}
+export interface DeploymentHost {
+    start(targets: readonly ProtocolDeploymentReleaseTarget[], options?: {
+        readonly signal?: AbortSignal;
+    }): Promise<readonly DeploymentRuntimeReconcileResult[]>;
+    reconcile(target: ProtocolDeploymentReleaseTarget, options?: {
+        readonly signal?: AbortSignal;
+    }): Promise<DeploymentRuntimeReconcileResult>;
+    scheduleReconcile(target: ProtocolDeploymentReleaseTarget): void;
+    execute(target: ProtocolDeploymentReleaseTarget, request: DeploymentDataPlaneRequest): Promise<DeploymentDataPlaneResult>;
+    dataPlane(target: ProtocolDeploymentReleaseTarget): DeploymentDataPlane;
+    status(target: ProtocolDeploymentReleaseTarget): DeploymentRuntimeStatus | undefined;
+    close(): Promise<void>;
+}
+export declare function createDeploymentHost(options: DeploymentHostOptions): DeploymentHost;
+//# sourceMappingURL=host.d.ts.map

package/dist/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,0BAA0B,EAC/B,KAAK,+BAA+B,EACrC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAEL,KAAK,mBAAmB,EAExB,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,KAAK,wCAAwC,EAC9C,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAEV,gCAAgC,EAChC,uBAAuB,EACvB,2BAA2B,EAC5B,MAAM,yBAAyB,CAAC;AAKjC,MAAM,MAAM,uBAAuB,GAC/B,kCAAkC,GAClC,2BAA2B,GAC3B,8BAA8B,GAC9B,qCAAqC,GACrC,uCAAuC,CAAC;AAE5C,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;gBAGrC,IAAI,EAAE,uBAAuB,EAC7B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAM7C;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,MAAM,EAAE,+BAA+B,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,0BAA0B,CAAC;CACjD;AAED,MAAM,MAAM,oCAAoC,GAAG,IAAI,CACrD,0BAA0B,EAC1B,YAAY,GAAG,yBAAyB,CACzC,GAAG;IACF,QAAQ,CAAC,eAAe,EAAE,CAAC,KAAK,EAAE,wCAAwC,KAAK,OAAO,CAAC;CACxF,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,UAAU,EAAE,2BAA2B,CAAC;IACjD,QAAQ,CAAC,kBAAkB,EAAE,CAC3B,KAAK,EAAE,4BAA4B,KAChC,oCAAoC,GAAG,OAAO,CAAC,oCAAoC,CAAC,CAAC;IAC1F,uDAAuD;IACvD,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACvD;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CACH,OAAO,EAAE,SAAS,+BAA+B,EAAE,EACnD,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAC1C,OAAO,CAAC,SAAS,gCAAgC,EAAE,CAAC,CAAC;IACxD,SAAS,CACP,MAAM,EAAE,+BAA+B,EACvC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAC1C,OAAO,CAAC,gCAAgC,CAAC,CAAC;IAC7C,iBAAiB,CAAC,MAAM,EAAE,+BAA+B,GAAG,IAAI,CAAC;IACjE,OAAO,CACL,MAAM,EAAE,+BAA+B,EACvC,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACtC,SAAS,CAAC,MAAM,EAAE,+BAA+B,GAAG,mBAAmB,CAAC;IACxE,MAAM,CAAC,MAAM,EAAE,+BAA+B,GAAG,uBAAuB,GAAG,SAAS,CAAC;IACrF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAiDD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAmLnF"}

package/dist/host.js

@@ -0,0 +1,183 @@
+import { validateProtocolDeploymentReleaseTarget, } from '@hypequery/protocol';
+import { createDeploymentDataPlane, } from './data-plane.js';
+import { createDeploymentRuntimeSupervisorExecutor } from './data-plane-runtime.js';
+const DEFAULT_STABILITY_ATTEMPTS = 4;
+const MAX_STABILITY_ATTEMPTS = 16;
+export class DeploymentHostError extends Error {
+    code;
+    constructor(code, message, options = {}) {
+        super(message, options.cause === undefined ? undefined : { cause: options.cause });
+        this.name = 'DeploymentHostError';
+        this.code = code;
+    }
+}
+function hostError(code, message, cause) {
+    return new DeploymentHostError(code, message, { cause });
+}
+function targetKey(target) {
+    return JSON.stringify([target.project, target.environment]);
+}
+function target(input) {
+    try {
+        return validateProtocolDeploymentReleaseTarget(input);
+    }
+    catch (error) {
+        throw hostError('HQ_DEPLOYMENT_HOST_CONFIGURATION', 'The deployment host target is invalid.', error);
+    }
+}
+function stabilityAttempts(input) {
+    const value = input ?? DEFAULT_STABILITY_ATTEMPTS;
+    if (!Number.isSafeInteger(value) || value < 1 || value > MAX_STABILITY_ATTEMPTS) {
+        throw hostError('HQ_DEPLOYMENT_HOST_CONFIGURATION', `maxStabilityAttempts must be between 1 and ${MAX_STABILITY_ATTEMPTS}.`);
+    }
+    return value;
+}
+function sameGeneration(left, right) {
+    return left?.status.activationRevision === right?.status.activationRevision;
+}
+export function createDeploymentHost(options) {
+    if (!options.supervisor || typeof options.configureDataPlane !== 'function') {
+        throw hostError('HQ_DEPLOYMENT_HOST_CONFIGURATION', 'A runtime supervisor and data-plane configurator are required.');
+    }
+    const maximumAttempts = stabilityAttempts(options.maxStabilityAttempts);
+    const active = new Map();
+    const updates = new Map();
+    const background = new Set();
+    let closed = false;
+    let closePromise;
+    function ensureOpen() {
+        if (closed)
+            throw hostError('HQ_DEPLOYMENT_HOST_CLOSED', 'The deployment host is closed.');
+    }
+    function serialize(key, operation) {
+        const previous = updates.get(key) ?? Promise.resolve();
+        const current = previous.catch(() => undefined).then(operation);
+        const tracked = current.finally(() => {
+            if (updates.get(key) === tracked)
+                updates.delete(key);
+        });
+        updates.set(key, tracked);
+        return tracked;
+    }
+    async function install(desiredTarget, signal) {
+        for (let attempt = 0; attempt < maximumAttempts; attempt += 1) {
+            ensureOpen();
+            const result = await options.supervisor.reconcile(desiredTarget, { signal });
+            ensureOpen();
+            if (result.status === 'deactivated' || result.status === 'no-active-release') {
+                active.delete(targetKey(desiredTarget));
+                return result;
+            }
+            const generation = options.supervisor.generation(desiredTarget);
+            if (!generation
+                || generation.status.activationRevision !== result.runtime.activationRevision) {
+                continue;
+            }
+            let configuration;
+            try {
+                configuration = await options.configureDataPlane(Object.freeze({
+                    target: desiredTarget,
+                    status: generation.status,
+                    deployment: generation.deployment,
+                }));
+            }
+            catch (error) {
+                throw hostError('HQ_DEPLOYMENT_HOST_RECONCILE_FAILED', 'The active deployment data plane could not be configured.', error);
+            }
+            ensureOpen();
+            let dataPlane;
+            try {
+                dataPlane = createDeploymentDataPlane({
+                    ...configuration,
+                    deployment: generation.deployment,
+                    executeRuntimeReference: createDeploymentRuntimeSupervisorExecutor({
+                        supervisor: options.supervisor,
+                        target: desiredTarget,
+                        activationRevision: generation.status.activationRevision,
+                        argument: configuration.runtimeArgument,
+                    }),
+                });
+            }
+            catch (error) {
+                throw hostError('HQ_DEPLOYMENT_HOST_RECONCILE_FAILED', 'The active deployment data plane could not be constructed.', error);
+            }
+            const confirmed = options.supervisor.generation(desiredTarget);
+            if (!sameGeneration(generation, confirmed))
+                continue;
+            active.set(targetKey(desiredTarget), Object.freeze({ generation, dataPlane }));
+            return result;
+        }
+        throw hostError('HQ_DEPLOYMENT_HOST_RECONCILE_UNSTABLE', 'The active deployment generation changed repeatedly during host reconciliation.');
+    }
+    const host = {
+        async start(targets, startOptions = {}) {
+            ensureOpen();
+            const validated = targets.map(target);
+            const keys = validated.map(targetKey);
+            if (new Set(keys).size !== keys.length) {
+                throw hostError('HQ_DEPLOYMENT_HOST_CONFIGURATION', 'Deployment host startup targets must be unique.');
+            }
+            return Object.freeze(await Promise.all(validated.map(candidate => (host.reconcile(candidate, startOptions)))));
+        },
+        reconcile(input, reconcileOptions = {}) {
+            ensureOpen();
+            const desiredTarget = target(input);
+            return serialize(targetKey(desiredTarget), () => install(desiredTarget, reconcileOptions.signal));
+        },
+        scheduleReconcile(input) {
+            ensureOpen();
+            const operation = host.reconcile(input).then(() => undefined).catch(error => {
+                try {
+                    options.onBackgroundError?.(error);
+                }
+                catch {
+                    // A diagnostic callback cannot make reconciliation an unhandled rejection.
+                }
+            });
+            background.add(operation);
+            void operation.finally(() => background.delete(operation)).catch(() => undefined);
+        },
+        async execute(input, request) {
+            ensureOpen();
+            const desiredTarget = target(input);
+            const hosted = active.get(targetKey(desiredTarget));
+            if (!hosted) {
+                throw hostError('HQ_DEPLOYMENT_HOST_NOT_READY', 'No deployment data plane is ready for target.');
+            }
+            return await hosted.dataPlane.execute(request);
+        },
+        dataPlane(input) {
+            ensureOpen();
+            const desiredTarget = target(input);
+            return Object.freeze({
+                execute: (request) => host.execute(desiredTarget, request),
+                executeJson: (request) => {
+                    ensureOpen();
+                    const hosted = active.get(targetKey(desiredTarget));
+                    if (!hosted) {
+                        throw hostError('HQ_DEPLOYMENT_HOST_NOT_READY', 'No deployment data plane is ready for target.');
+                    }
+                    return hosted.dataPlane.executeJson(request);
+                },
+            });
+        },
+        status(input) {
+            ensureOpen();
+            const desiredTarget = target(input);
+            return active.get(targetKey(desiredTarget))?.generation.status;
+        },
+        close() {
+            if (closePromise)
+                return closePromise;
+            closed = true;
+            closePromise = (async () => {
+                await Promise.allSettled([...updates.values()]);
+                await Promise.allSettled([...background]);
+                active.clear();
+                await options.supervisor.close();
+            })();
+            return closePromise;
+        },
+    };
+    return Object.freeze(host);
+}

package/dist/index.d.ts

@@ -20,12 +20,18 @@ export type { NodeDeploymentRuntimeErrorCode, NodeDeploymentRuntimeFactoryOption
 export { createDeploymentRuntimeMaterializer, DeploymentRuntimeMaterializationError, } from './runtime-materialization.js';
 export type { DeploymentRuntimeArtifactSnapshot, DeploymentRuntimeMaterializationErrorCode, DeploymentRuntimeMaterializer, DeploymentRuntimeMaterializerOptions, DeploymentRuntimeQueryBinding, DeploymentRuntimeRelease, DeploymentRuntimeReleaseReader, DeploymentRuntimeSnapshot, } from './runtime-materialization.js';
 export { createDeploymentRuntimeSupervisor, DeploymentRuntimeSupervisorError, } from './runtime-supervisor.js';
-export type { DeploymentRuntimeFactory, DeploymentRuntimeInstance, DeploymentRuntimeInstanceInvocation, DeploymentRuntimeInvocation, DeploymentRuntimeReconcileResult, DeploymentRuntimeStatus, DeploymentRuntimeSupervisor, DeploymentRuntimeSupervisorErrorCode, DeploymentRuntimeSupervisorOptions, } from './runtime-supervisor.js';
+export type { DeploymentRuntimeFactory, DeploymentRuntimeGeneration, DeploymentRuntimeInstance, DeploymentRuntimeInstanceInvocation, DeploymentRuntimeInvocation, DeploymentRuntimeReconcileResult, DeploymentRuntimeStatus, DeploymentRuntimeSupervisor, DeploymentRuntimeSupervisorErrorCode, DeploymentRuntimeSupervisorOptions, } from './runtime-supervisor.js';
 export type { DeploymentAuthenticationInput, DeploymentAuthenticator, DeploymentAuthorizationInput, DeploymentAuthorizer, DeploymentIntake, DeploymentIntakeOptions, DeploymentIntakeRequest, DeploymentIntakeResponse, DeploymentSubmissionResponse, DeploymentSubmissionStore, VerifiedDeploymentSubmission, } from './types.js';
 export { createDeploymentDataPlane, DeploymentDataPlaneError, } from './data-plane.js';
-export type { DeploymentCompiledSqlExecutionInput, DeploymentDataPlane, DeploymentDataPlaneAuthenticationInput, DeploymentDataPlaneErrorCode, DeploymentDataPlaneExecutionInput, DeploymentDataPlaneOptions, DeploymentDataPlanePrincipal, DeploymentDataPlaneRequest, DeploymentDataPlaneResult, DeploymentDataPlaneTenantInput, DeploymentRuntimeReferenceExecutionInput, DeploymentSemanticPlanExecutionInput, } from './data-plane.js';
+export type { DeploymentCompiledSqlExecutionInput, DeploymentDataPlane, DeploymentDataPlaneAuthenticationInput, DeploymentDataPlaneErrorCode, DeploymentDataPlaneExecutionInput, DeploymentDataPlaneJsonRequest, DeploymentDataPlaneOptions, DeploymentDataPlanePrincipal, DeploymentDataPlaneRequest, DeploymentDataPlaneResult, DeploymentDataPlaneTenantInput, DeploymentRuntimeReferenceExecutionInput, DeploymentSemanticPlanExecutionInput, } from './data-plane.js';
 export { DEFAULT_DEPLOYMENT_DATA_PLANE_LIMITS, resolveDeploymentDataPlaneLimits, } from './data-plane-limits.js';
 export type { DeploymentDataPlaneLimits } from './data-plane-limits.js';
 export { createDeploymentRuntimeSupervisorExecutor } from './data-plane-runtime.js';
 export type { DeploymentRuntimeSupervisorExecutorOptions } from './data-plane-runtime.js';
+export { createDeploymentDataPlaneFetchHandler, createDeploymentDataPlaneNodeHandler, } from './data-plane-adapters.js';
+export type { DeploymentDataPlaneAdapterOptions, DeploymentDataPlaneAdapterRequest, DeploymentDataPlaneFetchHandler, DeploymentDataPlaneNodeHandler, } from './data-plane-adapters.js';
+export { createDeploymentHost, DeploymentHostError, } from './host.js';
+export { createFileSystemDeploymentHost } from './filesystem-host.js';
+export type { FileSystemDeploymentHost, FileSystemDeploymentHostOptions, } from './filesystem-host.js';
+export type { DeploymentHost, DeploymentHostDataPlaneConfiguration, DeploymentHostDataPlaneInput, DeploymentHostErrorCode, DeploymentHostOptions, } from './host.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -13,3 +13,6 @@ export { createDeploymentRuntimeSupervisor, DeploymentRuntimeSupervisorError, }
 export { createDeploymentDataPlane, DeploymentDataPlaneError, } from './data-plane.js';
 export { DEFAULT_DEPLOYMENT_DATA_PLANE_LIMITS, resolveDeploymentDataPlaneLimits, } from './data-plane-limits.js';
 export { createDeploymentRuntimeSupervisorExecutor } from './data-plane-runtime.js';
+export { createDeploymentDataPlaneFetchHandler, createDeploymentDataPlaneNodeHandler, } from './data-plane-adapters.js';
+export { createDeploymentHost, DeploymentHostError, } from './host.js';
+export { createFileSystemDeploymentHost } from './filesystem-host.js';

package/dist/runtime-supervisor.d.ts

@@ -1,4 +1,4 @@
-import type { ProtocolDeploymentReleaseTarget } from '@hypequery/protocol';
+import type { ProtocolDeploymentContract, 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 {
@@ -39,6 +39,10 @@ export interface DeploymentRuntimeStatus {
     readonly releaseIdentity: string;
     readonly bundleIdentity: string;
 }
+export interface DeploymentRuntimeGeneration {
+    readonly status: DeploymentRuntimeStatus;
+    readonly deployment: ProtocolDeploymentContract;
+}
 export type DeploymentRuntimeReconcileResult = {
     readonly status: 'activated';
     readonly runtime: DeploymentRuntimeStatus;
@@ -57,6 +61,7 @@ export interface DeploymentRuntimeSupervisor {
     }): Promise<DeploymentRuntimeReconcileResult>;
     invoke(input: DeploymentRuntimeInvocation): Promise<unknown>;
     status(target: ProtocolDeploymentReleaseTarget): DeploymentRuntimeStatus | undefined;
+    generation(target: ProtocolDeploymentReleaseTarget): DeploymentRuntimeGeneration | undefined;
     close(): Promise<void>;
 }
 export interface DeploymentRuntimeSupervisorOptions {

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

@@ -1 +1 @@
-{"version":3,"file":"runtime-supervisor.d.ts","sourceRoot":"","sources":["../src/runtime-supervisor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runtime-supervisor.d.ts","sourceRoot":"","sources":["../src/runtime-supervisor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,0BAA0B,EAC1B,+BAA+B,EAChC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EACV,6BAA6B,EAC7B,6BAA6B,EAC7B,yBAAyB,EAC1B,MAAM,8BAA8B,CAAC;AAOtC,MAAM,MAAM,oCAAoC,GAC5C,qCAAqC,GACrC,8BAA8B,GAC9B,sBAAsB,GACtB,4BAA4B,GAC5B,iCAAiC,GACjC,yBAAyB,GACzB,0BAA0B,GAC1B,8BAA8B,GAC9B,+BAA+B,GAC/B,oBAAoB,CAAC;AAEzB,qBAAa,gCAAiC,SAAQ,KAAK;IACzD,QAAQ,CAAC,IAAI,EAAE,oCAAoC,CAAC;gBAGlD,IAAI,EAAE,oCAAoC,EAC1C,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAM7C;AAED,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,6BAA6B,CAAC;IAChD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,WAAW,yBAAyB;IACxC,WAAW,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,MAAM,CAAC,KAAK,EAAE,mCAAmC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,CACH,QAAQ,EAAE,yBAAyB,EACnC,KAAK,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACvC,OAAO,CAAC,yBAAyB,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,MAAM,EAAE,+BAA+B,CAAC;IACjD,+EAA+E;IAC/E,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,+BAA+B,CAAC;IACjD,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,0BAA0B,CAAC;CACjD;AAED,MAAM,MAAM,gCAAgC,GACxC;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAA;CAAE,GAC3E;IAAE,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAA;CAAE,GACjF;IAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAA;CAAE,GAC9E;IAAE,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAE7C,MAAM,WAAW,2BAA2B;IAC1C,SAAS,CACP,MAAM,EAAE,+BAA+B,EACvC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAC1C,OAAO,CAAC,gCAAgC,CAAC,CAAC;IAC7C,MAAM,CAAC,KAAK,EAAE,2BAA2B,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,MAAM,CAAC,MAAM,EAAE,+BAA+B,GAAG,uBAAuB,GAAG,SAAS,CAAC;IACrF,UAAU,CAAC,MAAM,EAAE,+BAA+B,GAAG,2BAA2B,GAAG,SAAS,CAAC;IAC7F,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,YAAY,EAAE,6BAA6B,CAAC;IACrD,QAAQ,CAAC,OAAO,EAAE,wBAAwB,CAAC;IAC3C,oEAAoE;IACpE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,uDAAuD;IACvD,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACvD;AAsFD,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,kCAAkC,GAC1C,2BAA2B,CA6P7B"}

package/dist/runtime-supervisor.js

@@ -232,6 +232,13 @@ export function createDeploymentRuntimeSupervisor(options) {
             const generation = active.get(targetKey(target));
             return generation ? status(generation) : undefined;
         },
+        generation(target) {
+            const generation = active.get(targetKey(target));
+            return generation ? Object.freeze({
+                status: status(generation),
+                deployment: generation.snapshot.deployment,
+            }) : undefined;
+        },
         close() {
             if (closePromise)
                 return closePromise;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypequery/deployment",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Provider-neutral deployment verification and intake for Hypequery",
   "license": "Apache-2.0",
   "type": "module",
@@ -18,7 +18,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@hypequery/protocol": "0.7.0"
+    "@hypequery/protocol": "0.8.0"
   },
   "devDependencies": {
     "@types/node": "^22.5.0",