@numa-tech/numa 1.14.23 → 1.14.24

package/dist/mail/client.js

@@ -0,0 +1,251 @@
+import { readFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { MailArchiveError } from "./errors.js";
+import { CloudflareD1DatabaseListResponseSchema, CloudflareD1QueryResponseSchema } from "./schemas.js";
+const CLOUDFLARE_API_BASE_URL = "https://api.cloudflare.com/client/v4";
+const DEFAULT_D1_DATABASE_NAME = "active-code-inbox-mail-routing-prd";
+const DEFAULT_LIMIT = 50;
+const MAX_LIMIT = 100;
+const MAX_ENV_FILE_BYTES = 64 * 1024;
+export const DEFAULT_CLOUDFLARE_ENV_FILE = join(homedir(), ".config", "active-code-inbox", "cloudflare-microconect_com.env");
+function parseEnvValue(value) {
+    const trimmed = value.trim();
+    if (trimmed.length >= 2) {
+        const first = trimmed[0];
+        const last = trimmed.at(-1);
+        if ((first === "\"" && last === "\"") || (first === "'" && last === "'")) {
+            return trimmed.slice(1, -1);
+        }
+    }
+    return trimmed;
+}
+export function parseCloudflareEnv(content) {
+    const values = new Map();
+    for (const line of content.split(/\r?\n/u)) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        const match = /^(?:export\s+)?([A-Z][A-Z0-9_]*)\s*=\s*(.*)$/u.exec(trimmed);
+        if (!match)
+            continue;
+        values.set(match[1], parseEnvValue(match[2]));
+    }
+    const accountId = values.get("CLOUDFLARE_ACCOUNT_ID") ?? "";
+    const apiToken = values.get("CLOUDFLARE_API_TOKEN") ?? "";
+    const zoneId = values.get("CLOUDFLARE_ZONE_ID") || undefined;
+    const d1DatabaseId = values.get("CLOUDFLARE_D1_DATABASE_ID") || undefined;
+    const d1DatabaseName = values.get("CLOUDFLARE_D1_DATABASE_NAME")
+        || DEFAULT_D1_DATABASE_NAME;
+    if (!/^[a-f0-9]{32}$/iu.test(accountId)) {
+        throw new MailArchiveError("CLOUDFLARE_ACCOUNT_ID 缺失或格式无效。", "mail_archive_credentials_invalid");
+    }
+    if (apiToken.length < 20 || /[\r\n]/u.test(apiToken)) {
+        throw new MailArchiveError("CLOUDFLARE_API_TOKEN 缺失或格式无效。", "mail_archive_credentials_invalid");
+    }
+    if (zoneId && !/^[a-f0-9]{32}$/iu.test(zoneId)) {
+        throw new MailArchiveError("CLOUDFLARE_ZONE_ID 格式无效。", "mail_archive_credentials_invalid");
+    }
+    if (d1DatabaseId && !/^[a-f0-9-]{36}$/iu.test(d1DatabaseId)) {
+        throw new MailArchiveError("CLOUDFLARE_D1_DATABASE_ID 格式无效。", "mail_archive_credentials_invalid");
+    }
+    if (!/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/u.test(d1DatabaseName)) {
+        throw new MailArchiveError("CLOUDFLARE_D1_DATABASE_NAME 格式无效。", "mail_archive_credentials_invalid");
+    }
+    return { accountId, apiToken, ...(zoneId ? { zoneId } : {}), ...(d1DatabaseId ? { d1DatabaseId } : {}), d1DatabaseName };
+}
+export async function readCloudflareEnv(path = DEFAULT_CLOUDFLARE_ENV_FILE) {
+    let content;
+    try {
+        content = await readFile(path, "utf8");
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new MailArchiveError(`无法读取 Cloudflare 配置文件: ${message}`, "mail_archive_env_file_unreadable");
+    }
+    if (Buffer.byteLength(content, "utf8") > MAX_ENV_FILE_BYTES) {
+        throw new MailArchiveError("Cloudflare 配置文件超过 64 KiB。", "mail_archive_env_file_too_large");
+    }
+    return parseCloudflareEnv(content);
+}
+function parseDateOption(value, option) {
+    if (value == null)
+        return {};
+    const millis = Date.parse(value);
+    if (!Number.isFinite(millis)) {
+        throw new MailArchiveError(`${option} 必须是有效的 ISO-8601 时间。`, "mail_archive_input_invalid");
+    }
+    return { value: new Date(millis).toISOString(), millis };
+}
+function normalizeRecipient(value) {
+    const recipient = value.trim().toLowerCase();
+    if (recipient.length > 320 || !/^[^\s@]+@[^\s@]+\.[^\s@]+$/u.test(recipient)) {
+        throw new MailArchiveError("收件地址格式无效。", "mail_archive_input_invalid");
+    }
+    return recipient;
+}
+function parseLimit(value) {
+    const limit = value ?? DEFAULT_LIMIT;
+    if (!Number.isInteger(limit) || limit < 1 || limit > MAX_LIMIT) {
+        throw new MailArchiveError(`limit 必须是 1 到 ${MAX_LIMIT} 之间的整数。`, "mail_archive_input_invalid");
+    }
+    return limit;
+}
+function isoFromMillis(value) {
+    if (value == null || !Number.isFinite(value))
+        return null;
+    return new Date(value).toISOString();
+}
+function deliveryRecord(row) {
+    let delivery;
+    try {
+        delivery = JSON.parse(row.delivery_json);
+    }
+    catch {
+        throw new MailArchiveError(`Cloudflare D1 返回的 delivery_json 无法解析（${row.delivery_id}）。`, "mail_archive_invalid_response");
+    }
+    if (!delivery || typeof delivery !== "object") {
+        throw new MailArchiveError(`Cloudflare D1 返回的 delivery_json 格式无效（${row.delivery_id}）。`, "mail_archive_invalid_response");
+    }
+    const envelope = delivery.envelope;
+    const raw = delivery.raw;
+    if (!envelope || typeof envelope !== "object" || !raw || typeof raw !== "object") {
+        throw new MailArchiveError(`Cloudflare D1 返回的投递记录缺少 envelope/raw（${row.delivery_id}）。`, "mail_archive_invalid_response");
+    }
+    const sender = envelope.from;
+    const recipient = envelope.to;
+    const receivedAt = delivery.receivedAt;
+    const rawSize = raw.size;
+    if (typeof sender !== "string" || typeof recipient !== "string"
+        || typeof receivedAt !== "string" || typeof rawSize !== "number") {
+        throw new MailArchiveError(`Cloudflare D1 返回的投递记录字段无效（${row.delivery_id}）。`, "mail_archive_invalid_response");
+    }
+    return {
+        deliveryId: row.delivery_id,
+        receivedAt,
+        sender,
+        recipient,
+        rawSizeBytes: rawSize,
+        status: row.status,
+        enqueueAttempts: row.enqueue_attempts,
+        deliveryAttempts: row.delivery_attempts,
+        lastAttemptedAt: isoFromMillis(row.last_attempted_at),
+        deliveredAt: isoFromMillis(row.delivered_at),
+        errorCode: row.error_code ?? null,
+        bodyAvailable: false
+    };
+}
+function cloudflareErrorMessage(body, fallback) {
+    if (!body || typeof body !== "object")
+        return fallback;
+    const errors = body.errors;
+    if (!Array.isArray(errors))
+        return fallback;
+    const messages = errors
+        .map((item) => item && typeof item === "object" && typeof item.message === "string"
+        ? item.message : undefined)
+        .filter((item) => Boolean(item));
+    return messages.join("; ") || fallback;
+}
+export class CloudflareMailArchiveClient {
+    credentials;
+    fetchImpl;
+    constructor(credentials, dependencies = {}) {
+        this.credentials = credentials;
+        this.fetchImpl = dependencies.fetch ?? fetch;
+    }
+    apiUrl(path) {
+        return `${CLOUDFLARE_API_BASE_URL}/accounts/${encodeURIComponent(this.credentials.accountId)}${path}`;
+    }
+    async request(path, init = {}) {
+        const headers = new Headers(init.headers);
+        headers.set("Authorization", `Bearer ${this.credentials.apiToken}`);
+        headers.set("Accept", "application/json");
+        if (init.body != null && !headers.has("Content-Type"))
+            headers.set("Content-Type", "application/json");
+        let response;
+        try {
+            response = await this.fetchImpl(this.apiUrl(path), { ...init, headers });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new MailArchiveError(`Cloudflare API 请求失败: ${message}`, "mail_archive_network_error");
+        }
+        const text = await response.text();
+        let body = {};
+        if (text) {
+            try {
+                body = JSON.parse(text);
+            }
+            catch {
+                body = text;
+            }
+        }
+        if (!response.ok) {
+            throw new MailArchiveError(`Cloudflare API 返回 HTTP ${response.status}: ${cloudflareErrorMessage(body, response.statusText || "请求失败")}`, response.status === 401 || response.status === 403 ? "mail_archive_forbidden" : "mail_archive_api_error", response.status);
+        }
+        return body;
+    }
+    async databaseId() {
+        if (this.credentials.d1DatabaseId) {
+            return { id: this.credentials.d1DatabaseId, name: this.credentials.d1DatabaseName };
+        }
+        const body = CloudflareD1DatabaseListResponseSchema.safeParse(await this.request("/d1/database?per_page=100"));
+        if (!body.success || !body.data.success) {
+            throw new MailArchiveError("Cloudflare D1 数据库列表响应格式无效。", "mail_archive_invalid_response");
+        }
+        const database = (body.data.result ?? []).find((item) => item.name === this.credentials.d1DatabaseName);
+        if (!database) {
+            throw new MailArchiveError(`找不到 Cloudflare D1 数据库: ${this.credentials.d1DatabaseName}`, "mail_archive_database_not_found");
+        }
+        return { id: database.uuid, name: database.name };
+    }
+    async search(input) {
+        const recipient = normalizeRecipient(input.recipient);
+        const since = parseDateOption(input.since, "--since");
+        const until = parseDateOption(input.until, "--until");
+        if (since.millis !== undefined && until.millis !== undefined && since.millis >= until.millis) {
+            throw new MailArchiveError("--since 必须早于 --until。", "mail_archive_input_invalid");
+        }
+        const limit = parseLimit(input.limit);
+        const database = await this.databaseId();
+        const clauses = ["lower(json_extract(delivery_json, '$.envelope.to')) = lower(?)"];
+        const params = [recipient];
+        if (since.millis !== undefined) {
+            clauses.push("created_at >= ?");
+            params.push(since.millis);
+        }
+        if (until.millis !== undefined) {
+            clauses.push("created_at < ?");
+            params.push(until.millis);
+        }
+        const sql = `SELECT delivery_id, delivery_json, status, enqueue_attempts, delivery_attempts,
+      last_queued_at, last_attempted_at, delivered_at, error_code, created_at, updated_at
+      FROM mail_delivery_spool WHERE ${clauses.join(" AND ")}
+      ORDER BY created_at DESC LIMIT ?`;
+        params.push(limit + 1);
+        const body = CloudflareD1QueryResponseSchema.safeParse(await this.request(`/d1/database/${encodeURIComponent(database.id)}/query`, {
+            method: "POST",
+            body: JSON.stringify({ sql, params })
+        }));
+        if (!body.success || !body.data.success || body.data.result.length !== 1 || !body.data.result[0].success) {
+            throw new MailArchiveError("Cloudflare D1 查询响应格式无效。", "mail_archive_invalid_response");
+        }
+        const rows = body.data.result[0].results;
+        const records = rows.slice(0, limit).map(deliveryRecord);
+        return {
+            schemaVersion: 1,
+            source: "cloudflare-d1-delivery-ledger",
+            databaseName: database.name,
+            recipient,
+            since: since.value ?? null,
+            until: until.value ?? null,
+            records,
+            hasMore: rows.length > limit,
+            bodyAvailable: false,
+            note: "Cloudflare 成功转交后会删除 R2 原始邮件；本查询只返回投递元数据，正文请到 Code Inbox 归档查看。"
+        };
+    }
+}
+export { DEFAULT_D1_DATABASE_NAME, MAX_LIMIT };
+//# sourceMappingURL=client.js.map

package/dist/mail/client.js.map

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

package/dist/mail/commands.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerMailCommands(program: Command): void;

package/dist/mail/commands.js

@@ -0,0 +1,76 @@
+import process from "node:process";
+import { loadAppConfig } from "../app-config.js";
+import { DEFAULT_CLOUDFLARE_ENV_FILE, CloudflareMailArchiveClient, readCloudflareEnv } from "./client.js";
+import { MailArchiveError } from "./errors.js";
+function jsonEnabled(command, configuredOutput) {
+    return Boolean(command.optsWithGlobals().json || configuredOutput === "json");
+}
+function printJson(value) {
+    process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
+}
+function addExamples(command, examples) {
+    return command.addHelpText("after", `\nExamples:\n${examples.map((item) => `  ${item}`).join("\n")}\n`);
+}
+function limit(value) {
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isInteger(parsed) || parsed < 1 || parsed > 100 || String(parsed) !== value.trim()) {
+        throw new MailArchiveError("--limit 必须是 1 到 100 之间的整数。", "mail_archive_input_invalid");
+    }
+    return parsed;
+}
+function formatDate(value) {
+    if (!value)
+        return "-";
+    return new Date(value).toLocaleString("zh-CN", { hour12: false });
+}
+export function registerMailCommands(program) {
+    const mail = program
+        .command("mail")
+        .description("邮件链路诊断与 Cloudflare 投递账本查询");
+    const archive = mail
+        .command("archive")
+        .description("查询邮件投递元数据（不读取验证码、激活链接或正文）");
+    addExamples(archive
+        .command("search <recipient>")
+        .description("按精确收件地址查询 Cloudflare D1 邮件投递账本")
+        .option("--env-file <file>", "Cloudflare env 文件", DEFAULT_CLOUDFLARE_ENV_FILE)
+        .option("--since <iso>", "起始时间（ISO-8601，含起始值）")
+        .option("--until <iso>", "结束时间（ISO-8601，不含结束值）")
+        .option("-l, --limit <number>", "返回条数，1-100", limit, 50)
+        .action(async (recipient, options, command) => {
+        const credentials = await readCloudflareEnv(options.envFile);
+        const result = await new CloudflareMailArchiveClient(credentials).search({
+            recipient,
+            since: options.since,
+            until: options.until,
+            limit: options.limit
+        });
+        const config = await loadAppConfig();
+        if (jsonEnabled(command, config.output)) {
+            printJson({ ok: true, ...result });
+            return;
+        }
+        process.stdout.write(`Cloudflare 邮件投递账本\n`);
+        process.stdout.write(`收件地址: ${result.recipient}\n`);
+        process.stdout.write(`数据库: ${result.databaseName}\n`);
+        process.stdout.write(`记录数: ${result.records.length}${result.hasMore ? "+" : ""}\n`);
+        if (result.records.length === 0) {
+            process.stdout.write("没有找到匹配的 Cloudflare 投递记录。\n");
+        }
+        else {
+            for (const record of result.records) {
+                process.stdout.write(`- ${formatDate(record.receivedAt)}  ${record.status}`
+                    + `  from=${record.sender}  size=${record.rawSizeBytes}B`
+                    + `  attempts=${record.deliveryAttempts}`
+                    + `  delivery=${record.deliveryId}\n`);
+                if (record.errorCode)
+                    process.stdout.write(`  error=${record.errorCode}\n`);
+            }
+        }
+        process.stdout.write(`说明: ${result.note}\n`);
+    }), [
+        "numa mail archive search kenneth.davis@mail.microconnect.com",
+        "numa mail archive search kenneth.davis@mail.microconnect.com --since 2026-09-02T00:00:00Z --json"
+    ]);
+}
+//# sourceMappingURL=commands.js.map

package/dist/mail/commands.js.map

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

package/dist/mail/errors.d.ts

@@ -0,0 +1,6 @@
+export declare function redactMailDiagnosticText(value: string): string;
+export declare class MailArchiveError extends Error {
+    readonly code: string;
+    readonly status?: number | undefined;
+    constructor(message: string, code: string, status?: number | undefined);
+}

package/dist/mail/errors.js

@@ -0,0 +1,16 @@
+export function redactMailDiagnosticText(value) {
+    return value
+        .replace(/Bearer\s+[A-Za-z0-9._~+/=-]+/giu, "Bearer [REDACTED]")
+        .replace(/(CLOUDFLARE_API_TOKEN\s*=\s*)[^\s,]+/giu, "$1[REDACTED]");
+}
+export class MailArchiveError extends Error {
+    code;
+    status;
+    constructor(message, code, status) {
+        super(redactMailDiagnosticText(message));
+        this.code = code;
+        this.status = status;
+        this.name = "MailArchiveError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/mail/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/mail/errors.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,wBAAwB,CAAC,KAAa;IACpD,OAAO,KAAK;SACT,OAAO,CAAC,iCAAiC,EAAE,mBAAmB,CAAC;SAC/D,OAAO,CAAC,yCAAyC,EAAE,cAAc,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAGvB,IAAI;IACJ,MAAM;IAHxB,YACE,OAAe,EACC,IAAY,EACZ,MAAe;QAE/B,KAAK,CAAC,wBAAwB,CAAC,OAAO,CAAC,CAAC,CAAC;oBAHzB,IAAI;sBACJ,MAAM;QAGtB,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF"}

package/dist/mail/schemas.d.ts

@@ -0,0 +1,65 @@
+import { z } from "zod";
+export declare const CloudflareD1DatabaseSchema: z.ZodObject<{
+    uuid: z.ZodString;
+    name: z.ZodString;
+}, z.core.$loose>;
+export declare const CloudflareD1DatabaseListResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    result: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        uuid: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$loose>>>;
+    errors: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+}, z.core.$loose>;
+export declare const CloudflareD1RowSchema: z.ZodObject<{
+    delivery_id: z.ZodString;
+    delivery_json: z.ZodString;
+    status: z.ZodString;
+    enqueue_attempts: z.ZodNumber;
+    delivery_attempts: z.ZodNumber;
+    last_queued_at: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    last_attempted_at: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    delivered_at: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    error_code: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    created_at: z.ZodNumber;
+    updated_at: z.ZodNumber;
+}, z.core.$loose>;
+export declare const CloudflareD1QueryResultSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    results: z.ZodArray<z.ZodObject<{
+        delivery_id: z.ZodString;
+        delivery_json: z.ZodString;
+        status: z.ZodString;
+        enqueue_attempts: z.ZodNumber;
+        delivery_attempts: z.ZodNumber;
+        last_queued_at: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        last_attempted_at: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        delivered_at: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        error_code: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        created_at: z.ZodNumber;
+        updated_at: z.ZodNumber;
+    }, z.core.$loose>>;
+    errors: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+}, z.core.$loose>;
+export declare const CloudflareD1QueryResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    result: z.ZodArray<z.ZodObject<{
+        success: z.ZodBoolean;
+        results: z.ZodArray<z.ZodObject<{
+            delivery_id: z.ZodString;
+            delivery_json: z.ZodString;
+            status: z.ZodString;
+            enqueue_attempts: z.ZodNumber;
+            delivery_attempts: z.ZodNumber;
+            last_queued_at: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            last_attempted_at: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            delivered_at: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            error_code: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            created_at: z.ZodNumber;
+            updated_at: z.ZodNumber;
+        }, z.core.$loose>>;
+        errors: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    }, z.core.$loose>>;
+    errors: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+}, z.core.$loose>;
+export type CloudflareD1Row = z.infer<typeof CloudflareD1RowSchema>;

package/dist/mail/schemas.js

@@ -0,0 +1,34 @@
+import { z } from "zod";
+export const CloudflareD1DatabaseSchema = z.object({
+    uuid: z.string().min(1),
+    name: z.string().min(1)
+}).passthrough();
+export const CloudflareD1DatabaseListResponseSchema = z.object({
+    success: z.boolean(),
+    result: z.array(CloudflareD1DatabaseSchema).optional(),
+    errors: z.array(z.unknown()).optional()
+}).passthrough();
+export const CloudflareD1RowSchema = z.object({
+    delivery_id: z.string().min(1),
+    delivery_json: z.string().min(1),
+    status: z.string().min(1),
+    enqueue_attempts: z.number().int().nonnegative(),
+    delivery_attempts: z.number().int().nonnegative(),
+    last_queued_at: z.number().int().nullable().optional(),
+    last_attempted_at: z.number().int().nullable().optional(),
+    delivered_at: z.number().int().nullable().optional(),
+    error_code: z.string().nullable().optional(),
+    created_at: z.number().int(),
+    updated_at: z.number().int()
+}).passthrough();
+export const CloudflareD1QueryResultSchema = z.object({
+    success: z.boolean(),
+    results: z.array(CloudflareD1RowSchema),
+    errors: z.array(z.unknown()).optional()
+}).passthrough();
+export const CloudflareD1QueryResponseSchema = z.object({
+    success: z.boolean(),
+    result: z.array(CloudflareD1QueryResultSchema),
+    errors: z.array(z.unknown()).optional()
+}).passthrough();
+//# sourceMappingURL=schemas.js.map

package/dist/mail/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/mail/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACxB,CAAC,CAAC,WAAW,EAAE,CAAC;AAEjB,MAAM,CAAC,MAAM,sCAAsC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7D,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC,QAAQ,EAAE;IACtD,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC,WAAW,EAAE,CAAC;AAEjB,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAChD,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACjD,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACtD,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACzD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACpD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC5C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC5B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;CAC7B,CAAC,CAAC,WAAW,EAAE,CAAC;AAEjB,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC,WAAW,EAAE,CAAC;AAEjB,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,6BAA6B,CAAC;IAC9C,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC,WAAW,EAAE,CAAC"}

package/dist/pipeline/client.d.ts

@@ -26,6 +26,12 @@ export interface TriggerBuildInput extends ProductionApprovalInput {
     parameters: Record<string, string>;
     idempotencyKey: string;
 }
+export interface BindingAdjustmentInput {
+    bindingId: number;
+    jobId: number;
+    expectedVersion: number;
+    reason: string;
+}
 export declare class PipelineClient {
     private readonly config;
     private readonly fetchImpl;
@@ -89,6 +95,20 @@ export declare class PipelineClient {
         queueId?: number | null | undefined;
         pollUrl?: string | undefined;
     }>;
+    adjustBinding(input: BindingAdjustmentInput): Promise<{
+        [x: string]: unknown;
+        id: number;
+        applicationCode: string;
+        jobId: number;
+        jobFullName?: string | null | undefined;
+        instanceId?: number | null | undefined;
+        instanceCode?: string | null | undefined;
+        tier: string;
+        bindingSource: string;
+        confirmationStatus: string;
+        productionLocked: boolean;
+        version: number;
+    }>;
     getBuild(identifier: string): Promise<{
         [x: string]: unknown;
         requestId?: string | undefined;

package/dist/pipeline/client.js

@@ -1,6 +1,6 @@
 import { resolveBackendUrl } from "../backend.js";
 import { ensureAccessToken, fetchWithKeycloakIdentity } from "../oauth.js";
-import { ApiErrorSchema, BuildListSchema, BuildLogSchema, BuildSchema, PipelineDetailSchema, PipelineListSchema } from "./schemas.js";
+import { ApiErrorSchema, BuildListSchema, BuildLogSchema, BuildSchema, JenkinsBindingSchema, PipelineDetailSchema, PipelineListSchema } from "./schemas.js";
 import { PipelineError, redactPipelineText } from "./errors.js";
 function requestIdFrom(response, body) {
     if (body && typeof body === "object" && "requestId" in body && typeof body.requestId === "string")
@@ -87,6 +87,26 @@ export class PipelineClient {
             body: JSON.stringify(input)
         }, [200, 202]);
     }
+    adjustBinding(input) {
+        if (!Number.isSafeInteger(input.bindingId) || input.bindingId < 1
+            || !Number.isSafeInteger(input.jobId) || input.jobId < 1
+            || !Number.isSafeInteger(input.expectedVersion) || input.expectedVersion < 0
+            || !input.reason.trim() || input.reason.trim().length > 800) {
+            throw new PipelineError("Binding adjustment input is invalid.", "JENKINS_CLI_INPUT_INVALID");
+        }
+        const bindingId = encodeURIComponent(String(input.bindingId));
+        return this.json(`/api/v1/admin/jenkins/bindings/${bindingId}/adjust`, JenkinsBindingSchema, {
+            method: "POST",
+            headers: {
+                "Idempotency-Key": `binding-adjust-${input.bindingId}-${input.jobId}-${input.expectedVersion}`
+            },
+            body: JSON.stringify({
+                jobId: input.jobId,
+                expectedVersion: input.expectedVersion,
+                reason: input.reason.trim()
+            })
+        }, [200]);
+    }
     getBuild(identifier) {
         return this.json(`/api/v1/jenkins/builds/${encodeURIComponent(identifier)}`, BuildSchema);
     }

package/dist/pipeline/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/pipeline/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,yBAAyB,EAA8B,MAAM,aAAa,CAAC;AACvG,OAAO,EACL,cAAc,EACd,eAAe,EACf,cAAc,EACd,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAGnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAoBhE,SAAS,aAAa,CAAC,QAAkB,EAAE,IAAa;IACtD,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,WAAW,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC;IACzH,OAAO,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,SAAS,CAAC;AAC3D,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,QAAkB;IAC5C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,IAAI,CAAC;QAAC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;AACpE,CAAC;AAED,SAAS,UAAU,CAAC,QAAkB,EAAE,IAAa;IACnD,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO;QAC5B,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,QAAQ,CAAC,UAAU,IAAI,sCAAsC;QACtF,CAAC,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,IAAI,sCAAsC,CAAC;IACpG,OAAO,IAAI,aAAa,CACtB,6BAA6B,QAAQ,CAAC,MAAM,KAAK,kBAAkB,CAAC,OAAO,CAAC,EAAE,EAC9E,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,mBAAmB,CAAC,CAAC,CAAC,mBAAmB,EAC9E,QAAQ,CAAC,MAAM,EACf,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAC9B,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,IAAY,EAAE,OAAoD;IACnF,MAAM,KAAK,GAAG,IAAI,eAAe,EAAE,CAAC;IACpC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,EAAE;YAAE,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACrH,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3D,CAAC;AAED,MAAM,OAAO,cAAc;IAII,MAAM;IAHlB,SAAS,CAAe;IACxB,aAAa,CAAwB;IAEtD,YAA6B,MAAkB,EAAE,YAAY,GAA+B,EAAE;sBAAjE,MAAM;QACjC,IAAI,CAAC,SAAS,GAAG,YAAY,CAAC,KAAK,IAAI,KAAK,CAAC;QAC7C,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC,aAAa,IAAI,iBAAiB,CAAC;IACvE,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAAC,IAAY,EAAE,IAAI,GAAgB,EAAE;QACnE,MAAM,GAAG,GAAG,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACpE,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;QAC1C,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI;YAAE,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;QACvE,OAAO,yBAAyB,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE;YAC/E,KAAK,EAAE,IAAI,CAAC,SAAS;YACrB,aAAa,EAAE,IAAI,CAAC,aAAa;SAClC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,IAAI,CAChB,IAAY,EACZ,MAAkH,EAClH,IAAI,GAAgB,EAAE,EACtB,gBAA2B;QAE3B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC3D,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,MAAM,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACnD,IAAI,gBAAgB,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACpE,MAAM,IAAI,aAAa,CACrB,sCAAsC,QAAQ,CAAC,MAAM,cAAc,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EACnG,0BAA0B,EAC1B,QAAQ,CAAC,MAAM,EACf,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAC9B,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,aAAa,CACrB,sDAAsD,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EAC5E,0BAA0B,EAC1B,QAAQ,CAAC,MAAM,EACf,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAC9B,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,aAAa,CAAC,OAAO,GAAwB,EAAE;QAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,2BAA2B,EAAE;YACtD,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM;SAC7E,CAAC,EAAE,kBAAkB,CAAC,CAAC;IAC1B,CAAC;IAED,eAAe,CAAC,eAAuB;QACrC,OAAO,IAAI,CAAC,IAAI,CAAC,6BAA6B,kBAAkB,CAAC,eAAe,CAAC,EAAE,EAAE,oBAAoB,CAAC,CAAC;IAC7G,CAAC;IAED,UAAU,CAAC,OAAO,GAAqB,EAAE;QACvC,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,wBAAwB,EAAE;YACnD,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM;YAC5E,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK;SACnE,CAAC,EAAE,eAAe,CAAC,CAAC;IACvB,CAAC;IAED,YAAY,CAAC,KAAwB;QACnC,OAAO,IAAI,CAAC,IAAI,CAAC,wBAAwB,EAAE,WAAW,EAAE;YACtD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,iBAAiB,EAAE,KAAK,CAAC,cAAc,EAAE;YACpD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;SAC5B,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IACjB,CAAC;IAED,QAAQ,CAAC,UAAkB;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,0BAA0B,kBAAkB,CAAC,UAAU,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;IAC5F,CAAC;IAED,SAAS,CAAC,UAAkB,EAAE,QAAQ,GAA4B,EAAE;QAClE,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,IAAI,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACpG,OAAO,IAAI,CAAC,IAAI,CAAC,0BAA0B,kBAAkB,CAAC,UAAU,CAAC,OAAO,EAAE,WAAW,EAAE;YAC7F,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1C,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IACjB,CAAC;IAED,UAAU,CAAC,UAAkB,EAAE,UAAkC,EAAE,QAAQ,GAA4B,EAAE;QACvG,OAAO,IAAI,CAAC,IAAI,CAAC,0BAA0B,kBAAkB,CAAC,UAAU,CAAC,QAAQ,EAAE,WAAW,EAAE;YAC9F,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,GAAG,QAAQ,EAAE,CAAC;SAClE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IACjB,CAAC;IAED,MAAM,CAAC,UAAkB,EAAE,MAAM,GAAG,CAAC,EAAE,KAAc;QACnD,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,0BAA0B,kBAAkB,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,cAAc,CAAC,CAAC;IACjI,CAAC;CACF"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/pipeline/client.ts"],"names":[],"mappings":"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"}

package/dist/pipeline/commands.js

@@ -70,6 +70,16 @@ function positiveInteger(value, label, fallback, maximum) {
     }
     return parsed;
 }
+function nonNegativeInteger(value, label, maximum) {
+    if (value == null) {
+        throw new PipelineError(`${label} is required.`, "JENKINS_CLI_INPUT_INVALID");
+    }
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < 0 || parsed > maximum) {
+        throw new PipelineError(`${label} must be an integer between 0 and ${maximum}.`, "JENKINS_CLI_INPUT_INVALID");
+    }
+    return parsed;
+}
 function collect(value, previous) {
     return [...previous, value];
 }
@@ -217,6 +227,31 @@ export function registerPipelineCommands(program, dependencies = {}) {
         "用于在未保存 requestId 时按应用、环境、分支或状态找回构建记录。",
         "--cursor 使用上一页响应返回的游标；--limit 控制每页条数，不是页码。"
     ]);
+    addExamples(pipeline.command("binding-adjust <binding-id>")
+        .description("将已确认的 Jenkins binding 切换到另一个当前同步的 Job")
+        .requiredOption("--job-id <id>", "目标 Jenkins Job ID")
+        .requiredOption("--expected-version <number>", "当前 binding 的乐观锁版本")
+        .requiredOption("--reason <text>", "调整原因，最多 800 个字符")
+        .option("--yes", "确认停用旧 binding 并建立 successor binding")
+        .action(async (bindingId, options, command) => {
+        if (!options.yes)
+            throw new PipelineError("Adjusting a binding requires --yes.", "JENKINS_CONFIRMATION_REQUIRED");
+        const reason = options.reason?.trim() ?? "";
+        if (!reason || reason.length > 800) {
+            throw new PipelineError("reason must be 1-800 characters.", "JENKINS_CLI_INPUT_INVALID");
+        }
+        const result = await client().adjustBinding({
+            bindingId: positiveInteger(identifier(bindingId, "binding-id"), "binding-id", 1, Number.MAX_SAFE_INTEGER),
+            jobId: positiveInteger(options.jobId, "job-id", 1, Number.MAX_SAFE_INTEGER),
+            expectedVersion: nonNegativeInteger(options.expectedVersion, "expected-version", Number.MAX_SAFE_INTEGER),
+            reason
+        });
+        await output(command, { ok: true, binding: result }, `${result.id}\t${result.confirmationStatus}\tJob ${result.jobId}\t${result.tier}\tv${result.version}`);
+    }), ["numa pipeline binding-adjust 4 --job-id 123 --expected-version 0 --reason 'repair synchronized Jenkins target' --yes --json"], [
+        "该命令只修改 DevOps platform binding，不改 Jenkins Job 配置，不改应用仓库，也不触发构建。",
+        "旧 binding 会保留为 DISABLED；历史构建仍引用旧 binding，平台返回新的 successor binding。",
+        "结果不明时使用完全相同的 binding-id、job-id 和 expected-version 重试；服务端会安全返回已提交的 successor。"
+    ]);
     addExamples(pipeline.command("build <application>")
         .description("触发流水线构建；生产要求 ops-admin 及审批 ID 或具体说明")
         .requiredOption("--tier <tier>", "develop|staging|production")