@hypequery/deployment 0.7.5 → 0.9.0

package/dist/utils/semantic-budget-limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-budget-limits.d.ts","sourceRoot":"","sources":["../../src/utils/semantic-budget-limits.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,CAKjF;AAED,mFAAmF;AACnF,wBAAgB,MAAM,CAAC,GAAG,MAAM,EAAE,SAAS,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,GAAG,MAAM,GAAG,SAAS,CAGrF;AAED,oFAAoF;AACpF,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE7E"}

package/dist/utils/semantic-budget-limits.js

@@ -0,0 +1,15 @@
+/** Drops explicitly-undefined properties, so a spread cannot erase a default. */
+export function definedLimits(limits) {
+    if (limits === undefined)
+        return {};
+    return Object.fromEntries(Object.entries(limits).filter(([, value]) => value !== undefined));
+}
+/** The lowest of every ceiling that applies. A caller can tighten, never widen. */
+export function lowest(...values) {
+    const finite = values.filter((value) => value !== undefined);
+    return finite.length === 0 ? undefined : Math.min(...finite);
+}
+/** A declared ceiling under a server one; declaring nothing leaves the server's. */
+export function tighten(declared, ceiling) {
+    return declared === undefined ? ceiling : Math.min(declared, ceiling);
+}

package/dist/utils/semantic-executor-failure.d.ts

@@ -0,0 +1,21 @@
+import type { ProtocolSemanticInvocationFailureCategory } from '@hypequery/protocol';
+/**
+ * The category an executor claimed, when it deliberately claimed one.
+ *
+ * The `hypequerySemanticFailure` marker, not the shape of the error, is what
+ * grants the claim. Allow-listing a `category` string alone would let a
+ * provider or library exception that happens to carry a generic one — a
+ * `not-found` from an HTTP client, say — put its own message in front of a
+ * caller and decide whether the call is retried. This module refuses to unwrap
+ * a cause for exactly that reason, and duck-typing would have reopened the door
+ * beside it. An error without the marker stays `executor-failed` with the
+ * generic message.
+ */
+export declare function claimedFailure(error: unknown): {
+    category: ProtocolSemanticInvocationFailureCategory;
+    code: string;
+    message: string;
+    retryable: boolean;
+    relist: boolean;
+} | undefined;
+//# sourceMappingURL=semantic-executor-failure.d.ts.map

package/dist/utils/semantic-executor-failure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-executor-failure.d.ts","sourceRoot":"","sources":["../../src/utils/semantic-executor-failure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yCAAyC,EAAE,MAAM,qBAAqB,CAAC;AAiCrF;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG;IAC9C,QAAQ,EAAE,yCAAyC,CAAC;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;CACjB,GAAG,SAAS,CAgBZ"}

package/dist/utils/semantic-executor-failure.js

@@ -0,0 +1,52 @@
+/**
+ * Categories an injected executor may claim for itself.
+ *
+ * Execution is injected, so the executor is the only component that knows the
+ * difference between "this query broke", "this deployment cannot express that",
+ * and "this deployment is incoherent". Every category here is one only the
+ * executor can determine; the ones it must never claim — `unauthenticated`,
+ * `forbidden`, `cancelled`, `stale-activation` — are decided by this module and
+ * are deliberately absent.
+ */
+const EXECUTOR_CATEGORIES = new Set([
+    'unsupported-capability',
+    'budget-exceeded',
+    'tenant-required',
+    'configuration-invalid',
+    'not-found',
+    'input-invalid',
+    'output-invalid',
+    'executor-unavailable',
+    'executor-failed',
+]);
+/**
+ * The category an executor claimed, when it deliberately claimed one.
+ *
+ * The `hypequerySemanticFailure` marker, not the shape of the error, is what
+ * grants the claim. Allow-listing a `category` string alone would let a
+ * provider or library exception that happens to carry a generic one — a
+ * `not-found` from an HTTP client, say — put its own message in front of a
+ * caller and decide whether the call is retried. This module refuses to unwrap
+ * a cause for exactly that reason, and duck-typing would have reopened the door
+ * beside it. An error without the marker stays `executor-failed` with the
+ * generic message.
+ */
+export function claimedFailure(error) {
+    if (typeof error !== 'object' || error === null)
+        return undefined;
+    const shape = error;
+    if (shape.hypequerySemanticFailure !== true)
+        return undefined;
+    if (typeof shape.category !== 'string' || !EXECUTOR_CATEGORIES.has(shape.category)) {
+        return undefined;
+    }
+    return {
+        category: shape.category,
+        code: typeof shape.code === 'string' && /^[A-Z][A-Z0-9_]*$/.test(shape.code)
+            ? shape.code
+            : 'HQ_SEMANTIC_EXECUTION_FAILED',
+        message: typeof shape.message === 'string' ? shape.message : 'Semantic execution failed.',
+        retryable: shape.retryable === true,
+        relist: shape.relist === true,
+    };
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hypequery/deployment",
-  "version": "0.7.5",
-  "description": "Verified deployment intake, activation, and runtime hosting for Hypequery analytics",
+  "version": "0.9.0",
+  "description": "Verified deployment intake, activation, and semantic invocation for Hypequery analytics",
   "keywords": [
     "hypequery",
     "deployment",
@@ -26,12 +26,13 @@
     "README.md"
   ],
   "dependencies": {
-    "@hypequery/protocol": "0.12.0"
+    "@hypequery/protocol": "0.14.0"
   },
   "devDependencies": {
     "@types/node": "^22.5.0",
     "typescript": "^5.7.3",
-    "vitest": "^3.2.6"
+    "vitest": "^3.2.6",
+    "@hypequery/datasets": "0.17.0"
   },
   "engines": {
     "node": ">=20"

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

@@ -1,18 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,304 +0,0 @@
-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-limits.d.ts

@@ -1,5 +0,0 @@
-import { type ProtocolSchemaValueLimits } from '@hypequery/protocol';
-export type DeploymentDataPlaneLimits = ProtocolSchemaValueLimits;
-export declare const DEFAULT_DEPLOYMENT_DATA_PLANE_LIMITS: Readonly<ProtocolSchemaValueLimits>;
-export declare function resolveDeploymentDataPlaneLimits(input?: Partial<DeploymentDataPlaneLimits>): Readonly<DeploymentDataPlaneLimits>;
-//# sourceMappingURL=data-plane-limits.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"data-plane-limits.d.ts","sourceRoot":"","sources":["../src/data-plane-limits.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,yBAAyB,EAC/B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,MAAM,yBAAyB,GAAG,yBAAyB,CAAC;AAElE,eAAO,MAAM,oCAAoC,qCAAuC,CAAC;AAEzF,wBAAgB,gCAAgC,CAC9C,KAAK,GAAE,OAAO,CAAC,yBAAyB,CAAM,GAC7C,QAAQ,CAAC,yBAAyB,CAAC,CAErC"}

package/dist/data-plane-limits.js

@@ -1,5 +0,0 @@
-import { DEFAULT_PROTOCOL_SCHEMA_VALUE_LIMITS, resolveProtocolSchemaValueLimits, } from '@hypequery/protocol';
-export const DEFAULT_DEPLOYMENT_DATA_PLANE_LIMITS = DEFAULT_PROTOCOL_SCHEMA_VALUE_LIMITS;
-export function resolveDeploymentDataPlaneLimits(input = {}) {
-    return resolveProtocolSchemaValueLimits({ limits: input });
-}

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

@@ -1,13 +0,0 @@
-import type { ProtocolDeploymentReleaseTarget } from '@hypequery/protocol';
-import type { DeploymentRuntimeReferenceExecutionInput } from './data-plane.js';
-import type { DeploymentRuntimeSupervisor } from './runtime-supervisor.js';
-export interface DeploymentRuntimeSupervisorExecutorOptions {
-    readonly supervisor: DeploymentRuntimeSupervisor;
-    readonly target: ProtocolDeploymentReleaseTarget;
-    /** The immutable activation generation used to build the matching data plane. */
-    readonly activationRevision: string;
-    /** Convert provider-neutral execution context into the runtime handler's argument contract. */
-    readonly argument: (input: DeploymentRuntimeReferenceExecutionInput) => unknown;
-}
-export declare function createDeploymentRuntimeSupervisorExecutor(options: DeploymentRuntimeSupervisorExecutorOptions): (input: DeploymentRuntimeReferenceExecutionInput) => Promise<unknown>;
-//# sourceMappingURL=data-plane-runtime.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"data-plane-runtime.d.ts","sourceRoot":"","sources":["../src/data-plane-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,KAAK,EACV,wCAAwC,EACzC,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAE3E,MAAM,WAAW,0CAA0C;IACzD,QAAQ,CAAC,UAAU,EAAE,2BAA2B,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,+BAA+B,CAAC;IACjD,iFAAiF;IACjF,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,+FAA+F;IAC/F,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,wCAAwC,KAAK,OAAO,CAAC;CACjF;AAED,wBAAgB,yCAAyC,CACvD,OAAO,EAAE,0CAA0C,GAClD,CAAC,KAAK,EAAE,wCAAwC,KAAK,OAAO,CAAC,OAAO,CAAC,CAWvE"}

package/dist/data-plane-runtime.js

@@ -1,12 +0,0 @@
-export function createDeploymentRuntimeSupervisorExecutor(options) {
-    if (!/^[0-9a-f]{64}$/.test(options.activationRevision)) {
-        throw new RangeError('activationRevision must be a lowercase SHA-256 identity');
-    }
-    return async (input) => await options.supervisor.invoke({
-        target: options.target,
-        activationRevision: options.activationRevision,
-        query: input.query.name,
-        argument: options.argument(input),
-        signal: input.signal,
-    });
-}

package/dist/data-plane.d.ts

@@ -1,84 +0,0 @@
-import type { ProtocolDeploymentContract, ProtocolNamedQueryContract, ProtocolQueryImplementation } from '@hypequery/protocol';
-import { type DeploymentDataPlaneLimits } from './data-plane-limits.js';
-export type DeploymentDataPlaneErrorCode = 'HQ_DATA_PLANE_CONFIGURATION' | 'HQ_DATA_PLANE_ROUTE_NOT_FOUND' | 'HQ_DATA_PLANE_METHOD_NOT_ALLOWED' | 'HQ_DATA_PLANE_UNAUTHENTICATED' | 'HQ_DATA_PLANE_FORBIDDEN' | 'HQ_DATA_PLANE_TENANT_REQUIRED' | 'HQ_DATA_PLANE_INPUT_INVALID' | 'HQ_DATA_PLANE_OUTPUT_INVALID' | 'HQ_DATA_PLANE_EXECUTOR_UNAVAILABLE' | 'HQ_DATA_PLANE_EXECUTION_FAILED' | 'HQ_DATA_PLANE_ABORTED';
-export declare class DeploymentDataPlaneError extends Error {
-    readonly code: DeploymentDataPlaneErrorCode;
-    readonly path?: string;
-    constructor(code: DeploymentDataPlaneErrorCode, message: string, options?: {
-        readonly path?: string;
-        readonly cause?: unknown;
-    });
-}
-export interface DeploymentDataPlanePrincipal {
-    readonly subject?: string;
-    readonly roles?: readonly string[];
-    readonly scopes?: readonly string[];
-    readonly claims?: Readonly<Record<string, unknown>>;
-}
-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;
-    readonly query: ProtocolNamedQueryContract;
-}
-export interface DeploymentDataPlaneTenantInput {
-    readonly principal: DeploymentDataPlanePrincipal | null;
-    readonly request: DeploymentDataPlaneRequest;
-    readonly query: ProtocolNamedQueryContract;
-}
-export interface DeploymentDataPlaneExecutionInput {
-    readonly query: ProtocolNamedQueryContract;
-    readonly input: unknown;
-    readonly principal: DeploymentDataPlanePrincipal | null;
-    readonly tenant: unknown;
-    readonly request: DeploymentDataPlaneRequest;
-    readonly signal?: AbortSignal;
-}
-export interface DeploymentSemanticPlanExecutionInput extends DeploymentDataPlaneExecutionInput {
-    readonly implementation: Extract<ProtocolQueryImplementation, {
-        readonly kind: 'semantic-plan';
-    }>;
-    readonly deployment: ProtocolDeploymentContract;
-}
-export interface DeploymentCompiledSqlExecutionInput extends DeploymentDataPlaneExecutionInput {
-    readonly implementation: Extract<ProtocolQueryImplementation, {
-        readonly kind: 'compiled-sql';
-    }>;
-    readonly parameters: Readonly<Record<string, unknown>>;
-}
-export interface DeploymentRuntimeReferenceExecutionInput extends DeploymentDataPlaneExecutionInput {
-    readonly implementation: Extract<ProtocolQueryImplementation, {
-        readonly kind: 'runtime-reference';
-    }>;
-}
-export interface DeploymentDataPlaneResult {
-    readonly query: string;
-    readonly output: unknown;
-    readonly cacheTtlMs?: number;
-}
-export interface DeploymentDataPlane {
-    execute(request: DeploymentDataPlaneRequest): Promise<DeploymentDataPlaneResult>;
-    executeJson(request: DeploymentDataPlaneJsonRequest): Promise<DeploymentDataPlaneResult>;
-}
-export interface DeploymentDataPlaneOptions {
-    readonly deployment: ProtocolDeploymentContract;
-    readonly authenticate?: (input: DeploymentDataPlaneAuthenticationInput) => Promise<DeploymentDataPlanePrincipal | null>;
-    readonly resolveTenant?: (input: DeploymentDataPlaneTenantInput) => Promise<unknown>;
-    readonly executeSemanticPlan?: (input: DeploymentSemanticPlanExecutionInput) => Promise<unknown>;
-    readonly executeCompiledSql?: (input: DeploymentCompiledSqlExecutionInput) => Promise<unknown>;
-    readonly executeRuntimeReference?: (input: DeploymentRuntimeReferenceExecutionInput) => Promise<unknown>;
-    readonly limits?: Partial<DeploymentDataPlaneLimits>;
-}
-export declare function createDeploymentDataPlane(options: DeploymentDataPlaneOptions): DeploymentDataPlane;
-//# sourceMappingURL=data-plane.d.ts.map

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

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