@hypequery/deployment 0.2.0 → 0.4.0

package/dist/control-plane.js

@@ -0,0 +1,362 @@
+import { validateProtocolDeploymentReleaseTarget, } from '@hypequery/protocol';
+import { DeploymentActivationError, } from './activation.js';
+import { resolveDeploymentControlPlaneLimits, } from './control-plane-limits.js';
+const IDENTITY_PATTERN = /^[0-9a-f]{64}$/;
+const JSON_CONTENT_TYPE = /^application\/json(?:;\s*charset=utf-8)?$/i;
+const textDecoder = new TextDecoder('utf-8', { fatal: true });
+const ERROR_STATUS = Object.freeze({
+    HQ_CONTROL_BAD_REQUEST: 400,
+    HQ_CONTROL_UNAUTHENTICATED: 401,
+    HQ_CONTROL_FORBIDDEN: 403,
+    HQ_CONTROL_NOT_FOUND: 404,
+    HQ_CONTROL_METHOD_NOT_ALLOWED: 405,
+    HQ_CONTROL_TOO_LARGE: 413,
+    HQ_CONTROL_RELEASE_NOT_FOUND: 404,
+    HQ_CONTROL_RELEASE_UNAVAILABLE: 503,
+    HQ_CONTROL_INTERNAL: 500,
+});
+class ControlPlaneError extends Error {
+    code;
+    status;
+    expose;
+    headers;
+    constructor(code, message, options = {}) {
+        super(message, options.cause === undefined ? undefined : { cause: options.cause });
+        this.name = 'DeploymentControlPlaneError';
+        this.code = code;
+        this.status = ERROR_STATUS[code];
+        this.expose = options.expose ?? this.status < 500;
+        this.headers = Object.freeze({ ...options.headers });
+    }
+}
+function requestHeader(headers, expectedName) {
+    const values = Object.entries(headers)
+        .filter(([name, value]) => value !== undefined && name.toLowerCase() === expectedName)
+        .map(([, value]) => value);
+    if (values.length > 1) {
+        throw new ControlPlaneError('HQ_CONTROL_BAD_REQUEST', `Duplicate ${expectedName} header.`);
+    }
+    return values[0];
+}
+function bearerToken(headers) {
+    const authorization = requestHeader(headers, 'authorization');
+    const token = authorization?.startsWith('Bearer ') ? authorization.slice(7) : '';
+    if (token.length < 1 || token.length > 4096 || token.trim() !== token
+        || [...token].some(character => {
+            const code = character.charCodeAt(0);
+            return code < 0x21 || code > 0x7e;
+        })) {
+        throw new ControlPlaneError('HQ_CONTROL_UNAUTHENTICATED', 'A valid bearer credential is required.', { headers: { 'www-authenticate': 'Bearer' } });
+    }
+    return token;
+}
+function jsonResponse(status, body, headers = {}) {
+    const encoded = `${JSON.stringify(body)}\n`;
+    return Object.freeze({
+        status,
+        headers: Object.freeze({
+            'content-type': 'application/json; charset=utf-8',
+            'content-length': String(Buffer.byteLength(encoded)),
+            'cache-control': 'no-store',
+            ...headers,
+        }),
+        body: encoded,
+    });
+}
+function sanitizeMessage(input) {
+    return [...input].map(character => {
+        const code = character.codePointAt(0) ?? 0;
+        return code < 0x20 || code === 0x7f ? ' ' : character;
+    }).join('').slice(0, 1024).trim() || 'The deployment control-plane request was rejected.';
+}
+function errorResponse(error) {
+    const value = error instanceof ControlPlaneError
+        ? error
+        : new ControlPlaneError('HQ_CONTROL_INTERNAL', 'The deployment control-plane request could not be processed.', { expose: false, cause: error });
+    return jsonResponse(value.status, {
+        error: {
+            code: value.code,
+            message: sanitizeMessage(value.expose
+                ? value.message
+                : 'The deployment control-plane request could not be processed.'),
+        },
+    }, value.headers);
+}
+function decodeTargetSegment(input) {
+    try {
+        return decodeURIComponent(input);
+    }
+    catch (error) {
+        throw new ControlPlaneError('HQ_CONTROL_BAD_REQUEST', 'Deployment target path encoding is invalid.', { cause: error });
+    }
+}
+function validatedTarget(project, environment) {
+    try {
+        return validateProtocolDeploymentReleaseTarget({
+            project: decodeTargetSegment(project),
+            environment: decodeTargetSegment(environment),
+        });
+    }
+    catch (error) {
+        if (error instanceof ControlPlaneError)
+            throw error;
+        throw new ControlPlaneError('HQ_CONTROL_BAD_REQUEST', 'Deployment target path is invalid.', { cause: error });
+    }
+}
+function parseRoute(path) {
+    if (path === '/v1/deployments/submissions')
+        return Object.freeze({ kind: 'submission' });
+    const segments = path.split('/');
+    if (segments.length !== 7 || segments[0] !== '' || segments[1] !== 'v1'
+        || segments[2] !== 'deployments' || segments[3] !== 'targets')
+        return undefined;
+    if (segments[6] !== 'activation' && segments[6] !== 'activations')
+        return undefined;
+    const target = validatedTarget(segments[4], segments[5]);
+    if (segments[6] === 'activation')
+        return Object.freeze({ kind: 'activation', target });
+    if (segments[6] === 'activations')
+        return Object.freeze({ kind: 'history', target });
+    return undefined;
+}
+function requireMethod(method, ...expected) {
+    if (!expected.includes(method)) {
+        const allowed = expected.join(', ');
+        throw new ControlPlaneError('HQ_CONTROL_METHOD_NOT_ALLOWED', `This deployment control-plane route requires ${allowed}.`, { headers: { allow: allowed } });
+    }
+}
+function requireNoQuery(request) {
+    if (request.query && Object.keys(request.query).length > 0) {
+        throw new ControlPlaneError('HQ_CONTROL_BAD_REQUEST', 'This deployment control-plane route does not accept query parameters.');
+    }
+}
+function requireNoBody(request) {
+    const length = requestHeader(request.headers, 'content-length');
+    const transferEncoding = requestHeader(request.headers, 'transfer-encoding');
+    if (request.hasBody || transferEncoding !== undefined || (length !== undefined && length !== '0')) {
+        throw new ControlPlaneError('HQ_CONTROL_BAD_REQUEST', 'This deployment control-plane route does not accept a request body.');
+    }
+}
+function throwIfAborted(signal) {
+    if (signal?.aborted) {
+        throw new ControlPlaneError('HQ_CONTROL_BAD_REQUEST', 'The deployment control-plane request was aborted.', { cause: signal.reason });
+    }
+}
+async function readBoundedBody(request, maximum) {
+    const declared = requestHeader(request.headers, 'content-length');
+    let declaredLength;
+    if (declared !== undefined) {
+        if (!/^(?:0|[1-9][0-9]*)$/.test(declared)) {
+            throw new ControlPlaneError('HQ_CONTROL_BAD_REQUEST', 'Content-Length must be a non-negative decimal integer.');
+        }
+        declaredLength = Number(declared);
+        if (!Number.isSafeInteger(declaredLength) || declaredLength > maximum) {
+            throw new ControlPlaneError('HQ_CONTROL_TOO_LARGE', 'The activation request exceeds its byte limit.');
+        }
+    }
+    const chunks = [];
+    let total = 0;
+    try {
+        for await (const chunk of request.body) {
+            throwIfAborted(request.signal);
+            if (!(chunk instanceof Uint8Array)) {
+                throw new ControlPlaneError('HQ_CONTROL_BAD_REQUEST', 'The activation request body yielded a non-byte chunk.');
+            }
+            total += chunk.byteLength;
+            if (total > maximum) {
+                throw new ControlPlaneError('HQ_CONTROL_TOO_LARGE', 'The activation request exceeds its byte limit.');
+            }
+            if (declaredLength !== undefined && total > declaredLength) {
+                throw new ControlPlaneError('HQ_CONTROL_BAD_REQUEST', 'The activation request body does not match Content-Length.');
+            }
+            chunks.push(Buffer.from(chunk));
+        }
+    }
+    catch (error) {
+        if (error instanceof ControlPlaneError)
+            throw error;
+        throw new ControlPlaneError('HQ_CONTROL_BAD_REQUEST', 'The activation request body could not be read.', { cause: error });
+    }
+    throwIfAborted(request.signal);
+    if (declaredLength !== undefined && total !== declaredLength) {
+        throw new ControlPlaneError('HQ_CONTROL_BAD_REQUEST', 'The activation request body does not match Content-Length.');
+    }
+    return Buffer.concat(chunks, total);
+}
+function parseActivationBody(bytes) {
+    let input;
+    try {
+        input = JSON.parse(textDecoder.decode(bytes));
+    }
+    catch (error) {
+        throw new ControlPlaneError('HQ_CONTROL_BAD_REQUEST', 'The activation request must be valid UTF-8 JSON.', { cause: error });
+    }
+    if (typeof input !== 'object' || input === null || Array.isArray(input)) {
+        throw new ControlPlaneError('HQ_CONTROL_BAD_REQUEST', 'The activation request is invalid.');
+    }
+    const value = input;
+    const expected = ['expectedRevision', 'kind', 'releaseIdentity', 'version'];
+    if (Object.keys(value).sort().join('\0') !== expected.join('\0')
+        || value.kind !== 'hypequery-deployment-activation-request' || value.version !== 1
+        || typeof value.releaseIdentity !== 'string'
+        || !IDENTITY_PATTERN.test(value.releaseIdentity)
+        || (value.expectedRevision !== null
+            && (typeof value.expectedRevision !== 'string'
+                || !IDENTITY_PATTERN.test(value.expectedRevision)))) {
+        throw new ControlPlaneError('HQ_CONTROL_BAD_REQUEST', 'The activation request is invalid.');
+    }
+    return Object.freeze({
+        releaseIdentity: value.releaseIdentity,
+        expectedRevision: value.expectedRevision,
+    });
+}
+function activationError(error) {
+    switch (error.code) {
+        case 'HQ_DEPLOYMENT_ACTIVATION_INVALID_REQUEST':
+            throw new ControlPlaneError('HQ_CONTROL_BAD_REQUEST', 'The deployment activation request is invalid.', { cause: error });
+        case 'HQ_DEPLOYMENT_ACTIVATION_TARGET_MISMATCH':
+            throw new ControlPlaneError('HQ_CONTROL_BAD_REQUEST', 'The deployment release does not match the requested target.', { cause: error });
+        case 'HQ_DEPLOYMENT_ACTIVATION_RELEASE_NOT_FOUND':
+            throw new ControlPlaneError('HQ_CONTROL_RELEASE_NOT_FOUND', 'The deployment release was not found.', { cause: error });
+        case 'HQ_DEPLOYMENT_ACTIVATION_RELEASE_UNAVAILABLE':
+            throw new ControlPlaneError('HQ_CONTROL_RELEASE_UNAVAILABLE', 'The deployment release is temporarily unavailable.', { cause: error });
+        default:
+            throw new ControlPlaneError('HQ_CONTROL_INTERNAL', 'The deployment activation state could not be processed.', { expose: false, cause: error });
+    }
+}
+async function activationCall(operation) {
+    try {
+        return await operation();
+    }
+    catch (error) {
+        if (error instanceof DeploymentActivationError)
+            activationError(error);
+        throw error;
+    }
+}
+function activationResponse(status, activation) {
+    return jsonResponse(status === 'activated' ? 201 : 200, {
+        kind: 'hypequery-deployment-activation-response',
+        version: 1,
+        status,
+        activation,
+    });
+}
+function validatedHistoryQuery(query, maximum) {
+    const values = query ?? {};
+    if (Object.keys(values).some(key => key !== 'limit' && key !== 'before')) {
+        throw new ControlPlaneError('HQ_CONTROL_BAD_REQUEST', 'History query parameters are invalid.');
+    }
+    const limitInput = values.limit;
+    if (limitInput !== undefined && typeof limitInput !== 'string') {
+        throw new ControlPlaneError('HQ_CONTROL_BAD_REQUEST', 'History limit is invalid.');
+    }
+    const limit = limitInput === undefined ? maximum : Number(limitInput);
+    if (!Number.isSafeInteger(limit) || limit < 1 || limit > maximum
+        || (limitInput !== undefined && String(limit) !== limitInput)) {
+        throw new ControlPlaneError('HQ_CONTROL_BAD_REQUEST', 'History limit is invalid.');
+    }
+    const before = values.before;
+    if (before !== undefined && typeof before !== 'string') {
+        throw new ControlPlaneError('HQ_CONTROL_BAD_REQUEST', 'History cursor is invalid.');
+    }
+    if (before !== undefined) {
+        if (!IDENTITY_PATTERN.test(before)) {
+            throw new ControlPlaneError('HQ_CONTROL_BAD_REQUEST', 'History cursor is invalid.');
+        }
+    }
+    return Object.freeze({ limit, ...(before === undefined ? {} : { before }) });
+}
+export function createDeploymentControlPlane(options) {
+    const limits = resolveDeploymentControlPlaneLimits(options.limits);
+    async function authenticateAndAuthorize(request, action, target) {
+        throwIfAborted(request.signal);
+        const token = bearerToken(request.headers);
+        const principal = await options.authenticator.authenticate({ token, signal: request.signal });
+        if (principal === null) {
+            throw new ControlPlaneError('HQ_CONTROL_UNAUTHENTICATED', 'The bearer credential is invalid.', { headers: { 'www-authenticate': 'Bearer' } });
+        }
+        throwIfAborted(request.signal);
+        const allowed = await options.authorizer.authorize({
+            principal,
+            action,
+            target,
+            signal: request.signal,
+        });
+        if (!allowed) {
+            throw new ControlPlaneError('HQ_CONTROL_FORBIDDEN', 'The caller is not authorized for the deployment target.');
+        }
+        throwIfAborted(request.signal);
+    }
+    async function process(request) {
+        const method = request.method.toUpperCase();
+        const route = parseRoute(request.path);
+        if (!route) {
+            throw new ControlPlaneError('HQ_CONTROL_NOT_FOUND', 'Deployment route not found.');
+        }
+        if (route.kind === 'submission') {
+            requireMethod(method, 'POST');
+            requireNoQuery(request);
+            return options.intake.handle(request);
+        }
+        const target = route.target;
+        if (route.kind === 'activation') {
+            if (method === 'GET') {
+                requireNoQuery(request);
+                requireNoBody(request);
+                await authenticateAndAuthorize(request, 'read-current-activation', target);
+                const current = await activationCall(() => options.activations.current(target));
+                return jsonResponse(200, {
+                    kind: 'hypequery-deployment-current-activation',
+                    version: 1,
+                    target,
+                    activation: current ?? null,
+                });
+            }
+            requireMethod(method, 'GET', 'PUT');
+            requireNoQuery(request);
+            await authenticateAndAuthorize(request, 'activate', target);
+            const contentType = requestHeader(request.headers, 'content-type');
+            if (!contentType || !JSON_CONTENT_TYPE.test(contentType)) {
+                throw new ControlPlaneError('HQ_CONTROL_BAD_REQUEST', 'Activation requests require application/json with UTF-8 encoding.');
+            }
+            const body = parseActivationBody(await readBoundedBody(request, limits.maxActivationRequestBytes));
+            const result = await activationCall(() => options.activations.activate({
+                target,
+                releaseIdentity: body.releaseIdentity,
+                expectedRevision: body.expectedRevision,
+            }));
+            if (result.status === 'conflict') {
+                return jsonResponse(409, {
+                    kind: 'hypequery-deployment-activation-response',
+                    version: 1,
+                    status: 'conflict',
+                    current: result.current,
+                });
+            }
+            return activationResponse(result.status, result.activation);
+        }
+        requireMethod(method, 'GET');
+        requireNoBody(request);
+        await authenticateAndAuthorize(request, 'read-activation-history', target);
+        const historyQuery = validatedHistoryQuery(request.query, limits.maxHistoryPageSize);
+        const page = await activationCall(() => (options.activations.historyPage(target, historyQuery)));
+        return jsonResponse(200, {
+            kind: 'hypequery-deployment-activation-history',
+            version: 1,
+            target,
+            activations: page.activations,
+            nextBefore: page.nextBefore,
+        });
+    }
+    return Object.freeze({
+        async handle(request) {
+            try {
+                return await process(request);
+            }
+            catch (error) {
+                return errorResponse(error);
+            }
+        },
+    });
+}

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

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

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

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

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

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

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

@@ -0,0 +1,78 @@
+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 credentials?: unknown;
+    readonly signal?: AbortSignal;
+}
+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>;
+}
+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

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