@deepexi/datasense-connector 3.0.1 → 3.1.0

package/runtime/protocol.d.ts

@@ -1,276 +0,0 @@
-/**
- * guest 运行时与宿主（runner 执行子进程 / 父进程）之间的消息契约。
- *
- * 消息只用 JSON 兼容结构。子进程起来后发 `ready`，父进程回一条 `execute`；之后子进程按需发 `call`
- * （宿主调用），父进程逐条回 `reply`；最后子进程发 `result` 或 `failure`。父进程随时可以发 `cancel`。
- *
- * 宿主调用的 payload 与 shared 的出站网关线协议（`EgressHttpRequest` 等）结构一致；SDK 不依赖 shared，
- * 这里自己定义一份同形的类型。子进程里跑的是不可信代码，父进程用 `parseChildMessage` 逐字段重建消息，
- * 不直接信任子进程产出的结构。
- */
-import type { DefinitionSummary, NormalizedDiscoverResult } from '../validate.js';
-export type { DefinitionSummary } from '../validate.js';
-export type NormalizedDiscover = NormalizedDiscoverResult;
-export type HostMethod = 'definition' | 'declaration' | 'http' | 'db.query' | 'db.next' | 'db.close' | 'crypto' | 'cache.get' | 'cache.set' | 'secret.reveal' | 'emit';
-export declare const HOST_METHODS: readonly HostMethod[];
-export interface GuestPushRequest {
-    requestId: string;
-    push: string;
-    receivedAt: string;
-    headers: Record<string, string>;
-    body: string;
-}
-/**
- * 作业：
- * - `check`：只跑连接器的 `check`（没有时直接成功），结果 `{ kind: 'check'; ok: true; logs }`；
- * - `pull` 带 `discoverFirst: true` 时 `tables` 可为 `[]`：guest 先跑 check + discover、经宿主调用 `declaration` 上报声明，
- *   再用声明里该数据流的表跑拉取（预览用）。
- */
-export type GuestJob = {
-    kind: 'push';
-    config: Record<string, unknown>;
-    secretFields: string[];
-    requests: GuestPushRequest[];
-} | {
-    kind: 'discover';
-    config: Record<string, unknown>;
-    secretFields: string[];
-} | {
-    kind: 'check';
-    config: Record<string, unknown>;
-    secretFields: string[];
-} | {
-    kind: 'pull';
-    config: Record<string, unknown>;
-    secretFields: string[];
-    stream: string;
-    mode: 'full' | 'incremental';
-    state: unknown;
-    streamConfig: Record<string, unknown>;
-    tables: string[];
-    discoverFirst?: boolean;
-};
-export interface HostCallError {
-    code: string;
-    message: string;
-    status?: number;
-    retryAfterMs?: number;
-}
-export type ParentMessage = {
-    type: 'execute';
-    guest: string;
-    code: string;
-    expect: {
-        name: string;
-        version: string;
-    };
-    job: GuestJob;
-} | {
-    type: 'reply';
-    id: number;
-    ok: true;
-    value: unknown;
-} | {
-    type: 'reply';
-    id: number;
-    ok: false;
-    error: HostCallError;
-} | {
-    type: 'cancel';
-};
-export interface GuestLog {
-    at: string;
-    level: 'info' | 'warn' | 'error';
-    message: string;
-    requestId?: string;
-}
-/** 与 shared 的 `RunnerPushResult` 同形。 */
-export interface GuestPushResult {
-    kind: 'push';
-    records: Array<{
-        requestId: string;
-        table: string;
-        row: Record<string, unknown>;
-    }>;
-    removals: Array<{
-        requestId: string;
-        table: string;
-        key: Record<string, unknown>;
-    }>;
-    rejected: Array<{
-        requestId: string;
-        code: string;
-        message: string;
-    }>;
-    logs: GuestLog[];
-}
-/** `pull` 的 `stopped: true`：某次 `emit` 的回复带 `{ stop: true }`，guest 触发 `ctx.signal` 后正常结束（不是 `CANCELED`）。 */
-export type GuestResult = GuestPushResult | {
-    kind: 'discover';
-    summary: DefinitionSummary;
-    discover: NormalizedDiscover;
-    logs: GuestLog[];
-} | {
-    kind: 'check';
-    ok: true;
-    logs: GuestLog[];
-} | {
-    kind: 'pull';
-    emittedBatches: number;
-    stopped?: boolean;
-    logs: GuestLog[];
-};
-export type GuestFailureCode = 'CONNECTOR_LOAD_FAILED' | 'CONFIG_INVALID' | 'SCHEMA_ERROR' | 'FATAL_ERROR' | 'AUTH_ERROR' | 'TRANSIENT_ERROR' | 'PUSH_UNKNOWN' | 'CANCELED';
-export declare const GUEST_FAILURE_CODES: readonly GuestFailureCode[];
-export type ChildMessage = {
-    type: 'ready';
-} | {
-    type: 'call';
-    id: number;
-    method: HostMethod;
-    payload: unknown;
-} | {
-    type: 'result';
-    result: GuestResult;
-} | {
-    type: 'failure';
-    code: GuestFailureCode;
-    message: string;
-    stack?: string;
-    logs: GuestLog[];
-};
-export interface EgressHttpRequest {
-    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD';
-    url: string;
-    headers: Record<string, string>;
-    query: Record<string, string | string[]>;
-    body: string | null;
-    bodyEncoding: 'utf8' | 'base64';
-    timeoutMs?: number;
-}
-export interface EgressHttpResponse {
-    status: number;
-    url: string;
-    headers: Record<string, string>;
-    body: string;
-    bodyEncoding: 'utf8' | 'base64';
-}
-export interface DbQueryRequest {
-    sql: string;
-    params: unknown[];
-}
-export interface DbQueryResponse {
-    cursorId: string | null;
-    fields: Array<{
-        name: string;
-        dataTypeId: number;
-    }>;
-    rows: Array<Record<string, unknown>>;
-    done: boolean;
-}
-export interface DbCursorRequest {
-    cursorId: string;
-}
-export interface DbNextResponse {
-    rows: Array<Record<string, unknown>>;
-    done: boolean;
-}
-export type CryptoRequest = {
-    op: 'hmac';
-    algorithm: 'sha1' | 'sha256' | 'sha512';
-    key: string;
-    data: string;
-    encoding: 'hex' | 'base64';
-} | {
-    op: 'sign';
-    algorithm: 'rsa-sha256';
-    key: string;
-    data: string;
-    encoding: 'hex' | 'base64';
-} | {
-    op: 'hash';
-    algorithm: 'md5' | 'sha1' | 'sha256' | 'sha512';
-    data: string;
-    encoding: 'hex' | 'base64';
-};
-export interface CryptoResponse {
-    value: string;
-}
-export interface CacheGetRequest {
-    key: string;
-}
-export interface CacheEntry {
-    value: string;
-    expiresAt: string;
-}
-export interface CacheSetRequest {
-    key: string;
-    value: string;
-    ttlSeconds: number;
-}
-export interface SecretRevealRequest {
-    field: string;
-}
-export interface SecretRevealResponse {
-    value: string;
-}
-/** `emit` 的 payload：与 shared 的 `RunnerPullBatch` 去掉 `seq` 后同形；`seq` 由宿主编号。 */
-/**
- * `definition` 宿主调用的回复（connector `POST /runner/v1/runs/:runId/definition`）：204 无正文，
- * 或 200 带本次运行的生效限流（连接器声明与连接覆盖取小）。guest 用 `rateLimit.concurrency` 收紧 `ctx.map` 的并发。
- */
-export interface DefinitionReply {
-    rateLimit?: {
-        perSecond: number;
-        concurrency: number;
-    };
-}
-/** `declaration` 宿主调用的 payload（`discoverFirst` 的拉取作业在 discover 之后、拉取之前发一次），回复 null。 */
-export interface DeclarationReport {
-    summary: DefinitionSummary;
-    discover: NormalizedDiscover;
-}
-/** `emit` 宿主调用的回复：`stop: true` 时 guest 不再发 `emit`，以 `stopped: true` 结束。其余字段（seq 等）guest 不看。 */
-export interface EmitReply {
-    stop?: boolean;
-}
-export interface GuestPullBatch {
-    records: Array<{
-        table: string;
-        row: Record<string, unknown>;
-    }>;
-    removals: Array<{
-        table: string;
-        key: Record<string, unknown>;
-    }>;
-    checkpoint?: {
-        state: unknown;
-    };
-    logs: GuestLog[];
-    /** 自上一批以来丢弃的超大记录 / 删除标记条数；为 0 时不带。 */
-    dropped?: number;
-}
-/** 解析父进程消息（子进程侧）；结构不合法时返回 null。 */
-export declare function parseParentMessage(value: unknown): ParentMessage | null;
-/**
- * `parseChildMessage` 拒绝一条 `emit` 时用来区分原因：记录或删除标记落在作业没声明的表上时返回第一张这样的表名，
- * 宿主据此按 `SCHEMA_ERROR` 结束运行（与 guest 自己检查到时同一个错误码），而不是按子进程崩溃处理；其他情况返回 null。
- */
-export declare function undeclaredEmitTable(value: unknown, job: GuestJob, options?: ParseChildOptions): string | null;
-/** `parseChildMessage` 的运行期上下文。 */
-export interface ParseChildOptions {
-    /**
-     * `discoverFirst` 的拉取作业：本次运行 `declaration` 上报的该数据流的表（`emit` 的表必须在其中）。
-     * 其他作业忽略，按 `job.tables` 校验。
-     */
-    tables?: readonly string[];
-    /** 本次运行是否已经上报过 `declaration`：为 true 时再来的 `declaration` 调用不合法（协议错误）。 */
-    declared?: boolean;
-}
-/**
- * 解析子进程消息（父进程侧）并重建一份干净的对象；结构不合法时返回 null（父进程按崩溃处理）。
- * 宿主调用的 payload 按方法校验：`definition` 只出现在 discover / check / pull 作业，`declaration` 只出现在
- * `discoverFirst` 的拉取作业且每次运行至多一次（`options.declared`），`emit` 只出现在 pull 作业且表必须在 `job.tables`（`discoverFirst` 时为 `options.tables`）里，
- * `secret.reveal` 的字段必须在 `job.secretFields` 里；结果的 `kind` 必须与作业一致。
- */
-export declare function parseChildMessage(value: unknown, job: GuestJob, options?: ParseChildOptions): ChildMessage | null;

package/runtime/protocol.js

@@ -1,409 +0,0 @@
-export const HOST_METHODS = Object.freeze([
-    'definition', 'declaration', 'http', 'db.query', 'db.next', 'db.close', 'crypto', 'cache.get', 'cache.set', 'secret.reveal', 'emit',
-]);
-export const GUEST_FAILURE_CODES = Object.freeze([
-    'CONNECTOR_LOAD_FAILED', 'CONFIG_INVALID', 'SCHEMA_ERROR', 'FATAL_ERROR', 'AUTH_ERROR', 'TRANSIENT_ERROR', 'PUSH_UNKNOWN', 'CANCELED',
-]);
-const HTTP_METHODS = new Set(['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD']);
-const BODY_ENCODINGS = new Set(['utf8', 'base64']);
-const DIGEST_ENCODINGS = new Set(['hex', 'base64']);
-const HMAC_ALGORITHMS = new Set(['sha1', 'sha256', 'sha512']);
-const HASH_ALGORITHMS = new Set(['md5', 'sha1', 'sha256', 'sha512']);
-const LOG_LEVELS = new Set(['info', 'warn', 'error']);
-const SYNC_MODES = new Set(['full', 'incremental']);
-const SNAPSHOTS = new Set(['complete', 'partial']);
-const HOST_METHOD_SET = new Set(HOST_METHODS);
-const FAILURE_CODE_SET = new Set(GUEST_FAILURE_CODES);
-function isRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-function isStringArray(value) {
-    return Array.isArray(value) && value.every((item) => typeof item === 'string');
-}
-function isStringRecord(value) {
-    return isRecord(value) && Object.values(value).every((item) => typeof item === 'string');
-}
-function isId(value) {
-    return typeof value === 'number' && Number.isSafeInteger(value) && value > 0;
-}
-function parsePushRequest(value) {
-    if (!isRecord(value))
-        return null;
-    const { requestId, push, receivedAt, headers, body } = value;
-    if (typeof requestId !== 'string' || typeof push !== 'string' || typeof receivedAt !== 'string' || !isStringRecord(headers) || typeof body !== 'string')
-        return null;
-    return { requestId, push, receivedAt, headers: { ...headers }, body };
-}
-function parseJob(value) {
-    if (!isRecord(value) || !isRecord(value.config) || !isStringArray(value.secretFields))
-        return null;
-    const config = value.config;
-    const secretFields = [...value.secretFields];
-    if (value.kind === 'push') {
-        if (!Array.isArray(value.requests))
-            return null;
-        const requests = [];
-        for (const item of value.requests) {
-            const request = parsePushRequest(item);
-            if (!request)
-                return null;
-            requests.push(request);
-        }
-        return { kind: 'push', config, secretFields, requests };
-    }
-    if (value.kind === 'discover')
-        return { kind: 'discover', config, secretFields };
-    if (value.kind === 'check')
-        return { kind: 'check', config, secretFields };
-    if (value.kind === 'pull') {
-        const { stream, mode, streamConfig, tables, discoverFirst } = value;
-        if (typeof stream !== 'string' || typeof mode !== 'string' || !SYNC_MODES.has(mode) || !isRecord(streamConfig) || !isStringArray(tables))
-            return null;
-        if (discoverFirst !== undefined && typeof discoverFirst !== 'boolean')
-            return null;
-        return {
-            kind: 'pull', config, secretFields, stream, mode: mode, state: value.state, streamConfig, tables: [...tables],
-            ...(discoverFirst === true ? { discoverFirst: true } : {}),
-        };
-    }
-    return null;
-}
-function parseHostError(value) {
-    if (!isRecord(value) || typeof value.code !== 'string' || typeof value.message !== 'string')
-        return null;
-    const error = { code: value.code, message: value.message };
-    if (value.status !== undefined) {
-        if (typeof value.status !== 'number' || !Number.isInteger(value.status))
-            return null;
-        error.status = value.status;
-    }
-    if (value.retryAfterMs !== undefined) {
-        if (typeof value.retryAfterMs !== 'number' || !Number.isFinite(value.retryAfterMs) || value.retryAfterMs < 0)
-            return null;
-        error.retryAfterMs = value.retryAfterMs;
-    }
-    return error;
-}
-export function parseParentMessage(value) {
-    if (!isRecord(value))
-        return null;
-    switch (value.type) {
-        case 'execute': {
-            const { guest, code, expect } = value;
-            if (typeof guest !== 'string' || typeof code !== 'string')
-                return null;
-            if (!isRecord(expect) || typeof expect.name !== 'string' || typeof expect.version !== 'string')
-                return null;
-            const job = parseJob(value.job);
-            return job ? { type: 'execute', guest, code, expect: { name: expect.name, version: expect.version }, job } : null;
-        }
-        case 'reply': {
-            if (!isId(value.id))
-                return null;
-            if (value.ok === true)
-                return { type: 'reply', id: value.id, ok: true, value: value.value };
-            if (value.ok !== false)
-                return null;
-            const error = parseHostError(value.error);
-            return error ? { type: 'reply', id: value.id, ok: false, error } : null;
-        }
-        case 'cancel':
-            return { type: 'cancel' };
-        default:
-            return null;
-    }
-}
-function parseLogs(value) {
-    if (!Array.isArray(value))
-        return null;
-    const logs = [];
-    for (const entry of value) {
-        if (!isRecord(entry) || typeof entry.at !== 'string' || typeof entry.level !== 'string' || !LOG_LEVELS.has(entry.level) || typeof entry.message !== 'string')
-            return null;
-        if (entry.requestId !== undefined && typeof entry.requestId !== 'string')
-            return null;
-        logs.push({
-            at: entry.at,
-            level: entry.level,
-            message: entry.message,
-            ...(entry.requestId !== undefined ? { requestId: entry.requestId } : {}),
-        });
-    }
-    return logs;
-}
-function parseSummary(value) {
-    if (!isRecord(value))
-        return null;
-    const { name, version, hosts, db, rateLimit, pushes, streams, secretFields, exposeToScript, config } = value;
-    if (typeof name !== 'string' || typeof version !== 'string')
-        return null;
-    if (!isStringArray(hosts) || !isStringArray(pushes) || !isStringArray(streams) || !isStringArray(secretFields) || !isStringArray(exposeToScript))
-        return null;
-    if (db !== null && !(isRecord(db) && db.engine === 'postgresql'))
-        return null;
-    let parsedRateLimit = null;
-    if (rateLimit !== null) {
-        if (!isRecord(rateLimit) || typeof rateLimit.perSecond !== 'number' || typeof rateLimit.concurrency !== 'number')
-            return null;
-        parsedRateLimit = { perSecond: rateLimit.perSecond, concurrency: rateLimit.concurrency };
-    }
-    return {
-        name, version, hosts: [...hosts], db: db === null ? null : { engine: 'postgresql' }, rateLimit: parsedRateLimit,
-        pushes: [...pushes], streams: [...streams], secretFields: [...secretFields], exposeToScript: [...exposeToScript],
-        ...(isRecord(config) ? { config } : {}),
-    };
-}
-function parseTables(value) {
-    if (!isRecord(value))
-        return null;
-    const tables = {};
-    for (const [name, table] of Object.entries(value)) {
-        if (!isRecord(table) || !isRecord(table.columns) || !isStringArray(table.primaryKey))
-            return null;
-        tables[name] = table;
-    }
-    return tables;
-}
-function parseDiscover(value) {
-    if (!isRecord(value) || !isRecord(value.streams) || !isRecord(value.pushes))
-        return null;
-    const result = { streams: {}, pushes: {} };
-    for (const [name, stream] of Object.entries(value.streams)) {
-        if (!isRecord(stream) || !isStringArray(stream.syncModes) || !stream.syncModes.every((mode) => SYNC_MODES.has(mode)))
-            return null;
-        if (typeof stream.snapshot !== 'string' || !SNAPSHOTS.has(stream.snapshot))
-            return null;
-        if (stream.params !== undefined && !(isRecord(stream.params) && stream.params.kind === 'object'))
-            return null;
-        const tables = parseTables(stream.tables);
-        if (!tables)
-            return null;
-        result.streams[name] = {
-            tables,
-            syncModes: [...stream.syncModes],
-            snapshot: stream.snapshot,
-            ...(stream.params !== undefined ? { params: stream.params } : {}),
-        };
-    }
-    for (const [name, push] of Object.entries(value.pushes)) {
-        if (!isRecord(push))
-            return null;
-        const tables = parseTables(push.tables);
-        if (!tables)
-            return null;
-        result.pushes[name] = { tables };
-    }
-    return result;
-}
-function parsePushResult(value, requestIds) {
-    const { records, removals, rejected } = value;
-    if (!Array.isArray(records) || !Array.isArray(removals) || !Array.isArray(rejected))
-        return null;
-    const logs = parseLogs(value.logs);
-    if (!logs)
-        return null;
-    const result = { kind: 'push', records: [], removals: [], rejected: [], logs };
-    for (const item of records) {
-        if (!isRecord(item) || typeof item.requestId !== 'string' || !requestIds.has(item.requestId))
-            return null;
-        if (typeof item.table !== 'string' || !isRecord(item.row))
-            return null;
-        result.records.push({ requestId: item.requestId, table: item.table, row: item.row });
-    }
-    for (const item of removals) {
-        if (!isRecord(item) || typeof item.requestId !== 'string' || !requestIds.has(item.requestId))
-            return null;
-        if (typeof item.table !== 'string' || !isRecord(item.key))
-            return null;
-        result.removals.push({ requestId: item.requestId, table: item.table, key: item.key });
-    }
-    for (const item of rejected) {
-        if (!isRecord(item) || typeof item.requestId !== 'string' || !requestIds.has(item.requestId))
-            return null;
-        if (typeof item.code !== 'string' || typeof item.message !== 'string')
-            return null;
-        result.rejected.push({ requestId: item.requestId, code: item.code, message: item.message });
-    }
-    return result;
-}
-function parseResult(value, job) {
-    if (!isRecord(value) || value.kind !== job.kind)
-        return null;
-    if (job.kind === 'push')
-        return parsePushResult(value, new Set(job.requests.map((request) => request.requestId)));
-    const logs = parseLogs(value.logs);
-    if (!logs)
-        return null;
-    if (job.kind === 'discover') {
-        const summary = parseSummary(value.summary);
-        const discover = parseDiscover(value.discover);
-        return summary && discover ? { kind: 'discover', summary, discover, logs } : null;
-    }
-    if (job.kind === 'check')
-        return value.ok === true ? { kind: 'check', ok: true, logs } : null;
-    const emittedBatches = value.emittedBatches;
-    if (typeof emittedBatches !== 'number' || !Number.isSafeInteger(emittedBatches) || emittedBatches < 0)
-        return null;
-    if (value.stopped !== undefined && typeof value.stopped !== 'boolean')
-        return null;
-    return { kind: 'pull', emittedBatches, ...(value.stopped === true ? { stopped: true } : {}), logs };
-}
-function parseDeclaration(value) {
-    if (!isRecord(value))
-        return null;
-    const summary = parseSummary(value.summary);
-    const discover = parseDiscover(value.discover);
-    return summary && discover ? { summary, discover } : null;
-}
-function parseBatch(value, tables) {
-    if (!isRecord(value) || !Array.isArray(value.records) || !Array.isArray(value.removals))
-        return null;
-    const logs = parseLogs(value.logs);
-    if (!logs)
-        return null;
-    const batch = { records: [], removals: [], logs };
-    for (const item of value.records) {
-        if (!isRecord(item) || typeof item.table !== 'string' || !tables.has(item.table) || !isRecord(item.row))
-            return null;
-        batch.records.push({ table: item.table, row: item.row });
-    }
-    for (const item of value.removals) {
-        if (!isRecord(item) || typeof item.table !== 'string' || !tables.has(item.table) || !isRecord(item.key))
-            return null;
-        batch.removals.push({ table: item.table, key: item.key });
-    }
-    if (value.checkpoint !== undefined) {
-        if (!isRecord(value.checkpoint) || !Object.hasOwn(value.checkpoint, 'state'))
-            return null;
-        batch.checkpoint = { state: value.checkpoint.state };
-    }
-    if (value.dropped !== undefined) {
-        if (typeof value.dropped !== 'number' || !Number.isSafeInteger(value.dropped) || value.dropped < 0)
-            return null;
-        batch.dropped = value.dropped;
-    }
-    return batch;
-}
-function parseHttpRequest(value) {
-    if (!isRecord(value))
-        return null;
-    const { method, url, headers, query, body, bodyEncoding, timeoutMs } = value;
-    if (typeof method !== 'string' || !HTTP_METHODS.has(method) || typeof url !== 'string' || !isStringRecord(headers))
-        return null;
-    if (!isRecord(query) || !Object.values(query).every((item) => typeof item === 'string' || isStringArray(item)))
-        return null;
-    if (body !== null && typeof body !== 'string')
-        return null;
-    if (typeof bodyEncoding !== 'string' || !BODY_ENCODINGS.has(bodyEncoding))
-        return null;
-    if (timeoutMs !== undefined && (typeof timeoutMs !== 'number' || !Number.isFinite(timeoutMs) || timeoutMs <= 0))
-        return null;
-    const parsedQuery = {};
-    for (const [key, item] of Object.entries(query))
-        parsedQuery[key] = Array.isArray(item) ? [...item] : item;
-    return {
-        method: method, url, headers: { ...headers }, query: parsedQuery, body,
-        bodyEncoding: bodyEncoding, ...(timeoutMs !== undefined ? { timeoutMs } : {}),
-    };
-}
-function parseCryptoRequest(value) {
-    if (!isRecord(value) || typeof value.data !== 'string' || typeof value.algorithm !== 'string')
-        return null;
-    if (typeof value.encoding !== 'string' || !DIGEST_ENCODINGS.has(value.encoding))
-        return null;
-    const { data, algorithm } = value;
-    const encoding = value.encoding;
-    if (value.op === 'hash') {
-        return HASH_ALGORITHMS.has(algorithm) ? { op: 'hash', algorithm: algorithm, data, encoding } : null;
-    }
-    if (typeof value.key !== 'string')
-        return null;
-    if (value.op === 'hmac') {
-        return HMAC_ALGORITHMS.has(algorithm) ? { op: 'hmac', algorithm: algorithm, key: value.key, data, encoding } : null;
-    }
-    if (value.op === 'sign')
-        return algorithm === 'rsa-sha256' ? { op: 'sign', algorithm: 'rsa-sha256', key: value.key, data, encoding } : null;
-    return null;
-}
-function parsePayload(method, payload, job, options) {
-    switch (method) {
-        case 'definition':
-            return job.kind === 'push' ? null : parseSummary(payload);
-        case 'declaration':
-            if (options.declared === true)
-                return null;
-            return job.kind === 'pull' && job.discoverFirst === true ? parseDeclaration(payload) : null;
-        case 'http':
-            return parseHttpRequest(payload);
-        case 'db.query':
-            return isRecord(payload) && typeof payload.sql === 'string' && Array.isArray(payload.params) ? { sql: payload.sql, params: [...payload.params] } : null;
-        case 'db.next':
-        case 'db.close':
-            return isRecord(payload) && typeof payload.cursorId === 'string' ? { cursorId: payload.cursorId } : null;
-        case 'crypto':
-            return parseCryptoRequest(payload);
-        case 'cache.get':
-            return isRecord(payload) && typeof payload.key === 'string' ? { key: payload.key } : null;
-        case 'cache.set': {
-            if (!isRecord(payload) || typeof payload.key !== 'string' || typeof payload.value !== 'string')
-                return null;
-            const ttl = payload.ttlSeconds;
-            return typeof ttl === 'number' && Number.isSafeInteger(ttl) && ttl > 0 ? { key: payload.key, value: payload.value, ttlSeconds: ttl } : null;
-        }
-        case 'secret.reveal':
-            return isRecord(payload) && typeof payload.field === 'string' && job.secretFields.includes(payload.field) ? { field: payload.field } : null;
-        case 'emit':
-            if (job.kind !== 'pull')
-                return null;
-            return parseBatch(payload, new Set(job.discoverFirst === true ? options.tables ?? [] : job.tables));
-    }
-}
-export function undeclaredEmitTable(value, job, options = {}) {
-    if (job.kind !== 'pull' || !isRecord(value) || value.type !== 'call' || value.method !== 'emit' || !isRecord(value.payload))
-        return null;
-    const allowed = new Set(job.discoverFirst === true ? options.tables ?? [] : job.tables);
-    for (const key of ['records', 'removals']) {
-        const items = value.payload[key];
-        if (!Array.isArray(items))
-            continue;
-        for (const item of items) {
-            if (isRecord(item) && typeof item.table === 'string' && !allowed.has(item.table))
-                return item.table;
-        }
-    }
-    return null;
-}
-export function parseChildMessage(value, job, options = {}) {
-    if (!isRecord(value))
-        return null;
-    switch (value.type) {
-        case 'ready':
-            return { type: 'ready' };
-        case 'call': {
-            if (!isId(value.id) || typeof value.method !== 'string' || !HOST_METHOD_SET.has(value.method))
-                return null;
-            const method = value.method;
-            const payload = parsePayload(method, value.payload, job, options);
-            return payload === null ? null : { type: 'call', id: value.id, method, payload };
-        }
-        case 'result': {
-            const result = parseResult(value.result, job);
-            return result ? { type: 'result', result } : null;
-        }
-        case 'failure': {
-            if (typeof value.code !== 'string' || !FAILURE_CODE_SET.has(value.code) || typeof value.message !== 'string')
-                return null;
-            if (value.stack !== undefined && typeof value.stack !== 'string')
-                return null;
-            const logs = parseLogs(value.logs);
-            if (!logs)
-                return null;
-            return {
-                type: 'failure', code: value.code, message: value.message,
-                ...(value.stack !== undefined ? { stack: value.stack } : {}), logs,
-            };
-        }
-        default:
-            return null;
-    }
-}