@yg-toolkit/datapull 0.1.0

package/dist/connections/service.js

@@ -0,0 +1,220 @@
+import { DataPullError } from "../core/errors.js";
+import { validatePathSegment } from "../utils/path.js";
+import { ConfigStore } from "../config/store.js";
+const DEFAULT_PORTS = {
+    mysql: 3306,
+    postgresql: 5432,
+    sqlserver: 1433,
+};
+export const SQLSERVER_TRUST_WARNING = "连接保持加密，但不会验证 SQL Server 身份，可能受到中间人攻击。";
+export class ConnectionService {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    async list() {
+        return (await this.store.read()).connections;
+    }
+    async get(alias) {
+        const connection = (await this.list()).find((item) => item.alias.toLocaleLowerCase("en-US") === alias.toLocaleLowerCase("en-US"));
+        if (connection === undefined) {
+            throw new DataPullError("CONNECTION_NOT_FOUND", `未找到登记连接：${alias}`, 3, { connectionAlias: alias });
+        }
+        return connection;
+    }
+    async add(connection) {
+        validatePathSegment(connection.alias, "连接别名");
+        await this.store.updateConnections((connections) => {
+            if (connections.some((item) => item.alias.toLocaleLowerCase("en-US") ===
+                connection.alias.toLocaleLowerCase("en-US"))) {
+                throw new DataPullError("CONNECTION_ALIAS_CONFLICT", `连接别名已存在：${connection.alias}`, 2);
+            }
+            return [...connections, connection];
+        });
+        return connection;
+    }
+    async update(alias, changes) {
+        let updated;
+        await this.store.updateConnections((connections) => connections.map((connection) => {
+            if (connection.alias.toLocaleLowerCase("en-US") !== alias.toLocaleLowerCase("en-US")) {
+                return connection;
+            }
+            updated = normalizeConnection({ ...connection, ...changes, alias: connection.alias });
+            return updated;
+        }));
+        if (updated === undefined) {
+            throw new DataPullError("CONNECTION_NOT_FOUND", `未找到登记连接：${alias}`, 3);
+        }
+        return updated;
+    }
+    async remove(alias) {
+        const current = await this.get(alias);
+        await this.store.updateConnections((connections) => connections.filter((connection) => connection.alias.toLocaleLowerCase("en-US") !== alias.toLocaleLowerCase("en-US")));
+        return current;
+    }
+    async setFavorite(alias, database, favorite) {
+        validatePathSegment(database, "数据库名");
+        const connection = await this.get(alias);
+        const values = new Set(connection.favoriteDatabases);
+        if (favorite)
+            values.add(database);
+        else
+            values.delete(database);
+        await this.update(alias, { favoriteDatabases: [...values] });
+    }
+    async rememberDatabase(alias, database) {
+        validatePathSegment(database, "数据库名");
+        const connection = await this.get(alias);
+        const recent = [database, ...connection.recentDatabases.filter((item) => item !== database)].slice(0, 10);
+        let updated;
+        await this.store.updateConnections((connections) => connections.map((item) => {
+            if (item.alias !== connection.alias)
+                return item;
+            updated = { ...item, recentDatabases: recent };
+            return updated;
+        }));
+        if (updated === undefined) {
+            throw new DataPullError("CONNECTION_NOT_FOUND", `未找到登记连接：${alias}`, 3);
+        }
+    }
+    async resolve(alias, database, options = {}) {
+        const connection = await this.get(alias);
+        if (connection.authMode === "integrated" && process.platform !== "win32") {
+            throw new DataPullError("CONFIG_INVALID", "Windows 集成认证只支持 Windows 上的 SQL Server。", 3);
+        }
+        if (connection.authMode === "url") {
+            const value = await this.store.resolveSecret(required(connection.urlRef, "urlRef"));
+            const url = parseConnectionUrl(connection.engine, value);
+            return applyResolveOptions({
+                ...connection,
+                host: url.hostname,
+                port: url.port.length > 0 ? Number(url.port) : DEFAULT_PORTS[connection.engine],
+                username: decodeUrlComponent(url.username),
+                password: decodeUrlComponent(url.password),
+                sslMode: connection.sslMode ?? url.searchParams.get("sslmode") ?? undefined,
+                secretUrl: value,
+                ...(database === undefined ? {} : { database }),
+            }, options);
+        }
+        if (connection.authMode === "password") {
+            return applyResolveOptions({
+                ...connection,
+                port: connection.port ?? DEFAULT_PORTS[connection.engine],
+                password: await this.store.resolveSecret(required(connection.credentialRef, "credentialRef")),
+                ...(database === undefined ? {} : { database }),
+            }, options);
+        }
+        return applyResolveOptions({
+            ...connection,
+            port: connection.port ?? DEFAULT_PORTS[connection.engine],
+            ...(database === undefined ? {} : { database }),
+        }, options);
+    }
+}
+export function createConnection(input) {
+    const { trustServerCertificate, ...connectionInput } = input;
+    return normalizeConnection({
+        ...connectionInput,
+        recentDatabases: [],
+        favoriteDatabases: [],
+        ...(connectionInput.engine === "sqlserver"
+            ? {
+                tls: {
+                    encrypt: true,
+                    trustServerCertificate: trustServerCertificate ?? false,
+                },
+            }
+            : {}),
+    });
+}
+function normalizeConnection(connection) {
+    const parsed = structuredClone(connection);
+    if (parsed.authMode === "url") {
+        delete parsed.host;
+        delete parsed.port;
+        delete parsed.username;
+        delete parsed.credentialRef;
+    }
+    else {
+        delete parsed.urlRef;
+    }
+    if (parsed.authMode === "integrated") {
+        delete parsed.username;
+        delete parsed.credentialRef;
+    }
+    if (parsed.engine === "sqlserver") {
+        parsed.tls = {
+            encrypt: true,
+            trustServerCertificate: parsed.tls?.trustServerCertificate ?? false,
+        };
+    }
+    else
+        delete parsed.tls;
+    return parsed;
+}
+function applyResolveOptions(connection, options) {
+    if (options.trustServerCertificate === undefined) {
+        return connection;
+    }
+    if (connection.engine !== "sqlserver") {
+        throw new DataPullError("INVALID_ARGUMENT", "信任服务器证书只适用于 SQL Server。", 2);
+    }
+    return {
+        ...connection,
+        tls: {
+            encrypt: true,
+            trustServerCertificate: options.trustServerCertificate,
+        },
+    };
+}
+function parseConnectionUrl(engine, value) {
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch (error) {
+        throw new DataPullError("CONFIG_INVALID", "完整连接 URL 无法解析。", 3, undefined, error instanceof Error ? { cause: error } : undefined);
+    }
+    const allowed = {
+        mysql: ["mysql:"],
+        postgresql: ["postgres:", "postgresql:"],
+        sqlserver: ["sqlserver:", "mssql:"],
+    };
+    if (!allowed[engine].includes(url.protocol) || url.hostname.length === 0) {
+        throw new DataPullError("CONFIG_INVALID", `连接 URL 与 ${engine} 不匹配。`, 3);
+    }
+    return url;
+}
+function required(value, field) {
+    if (value !== undefined)
+        return value;
+    throw new DataPullError("CONFIG_INVALID", `连接缺少 ${field}。`, 3);
+}
+function decodeUrlComponent(value) {
+    try {
+        return decodeURIComponent(value);
+    }
+    catch (error) {
+        throw new DataPullError("CONFIG_INVALID", "连接 URL 包含无效的百分号编码。", 3, undefined, error instanceof Error ? { cause: error } : undefined);
+    }
+}
+export function redactedConnection(connection) {
+    return {
+        ...connection,
+        credentialRef: connection.credentialRef,
+        urlRef: connection.urlRef,
+        ...(connectionSecurityWarnings(connection).length === 0
+            ? {}
+            : { securityWarnings: connectionSecurityWarnings(connection) }),
+    };
+}
+export function connectionSecurityWarnings(connection) {
+    return connection.engine === "sqlserver" &&
+        connection.tls?.trustServerCertificate === true
+        ? [SQLSERVER_TRUST_WARNING]
+        : [];
+}
+export function cloneConfig(config) {
+    return structuredClone(config);
+}
+//# sourceMappingURL=service.js.map

package/dist/connections/service.js.map

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

package/dist/core/errors.d.ts

@@ -0,0 +1,9 @@
+export type ExitCode = 1 | 2 | 3 | 4 | 5;
+export declare class DataPullError extends Error {
+    readonly code: string;
+    readonly exitCode: ExitCode;
+    readonly details?: Record<string, unknown>;
+    constructor(code: string, message: string, exitCode: ExitCode, details?: Record<string, unknown>, options?: ErrorOptions);
+}
+export declare function asDataPullError(error: unknown): DataPullError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEzC,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE3C,YACE,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,CAAC,EAAE,YAAY,EAOvB;CACF;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAe7D"}

package/dist/core/errors.js

@@ -0,0 +1,29 @@
+export class DataPullError extends Error {
+    code;
+    exitCode;
+    details;
+    constructor(code, message, exitCode, details, options) {
+        super(message, options);
+        this.name = "DataPullError";
+        this.code = code;
+        this.exitCode = exitCode;
+        if (details !== undefined)
+            this.details = details;
+    }
+}
+export function asDataPullError(error) {
+    if (error instanceof DataPullError)
+        return error;
+    if (isPromptCancellation(error)) {
+        return new DataPullError("OPERATION_CANCELLED", "操作已取消。", 1, {
+            outputFilesChanged: false,
+        });
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    return new DataPullError("UNEXPECTED_ERROR", "发生未预期错误，请使用 datapull doctor 检查环境。", 1, { cause: message }, error instanceof Error ? { cause: error } : undefined);
+}
+function isPromptCancellation(error) {
+    return (error instanceof Error &&
+        (error.name === "ExitPromptError" || error.message.includes("force closed")));
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,aAAc,SAAQ,KAAK;IAC7B,IAAI,CAAS;IACb,QAAQ,CAAW;IACnB,OAAO,CAA2B;IAE3C,YACE,IAAY,EACZ,OAAe,EACf,QAAkB,EAClB,OAAiC,EACjC,OAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,OAAO,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACpD,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,YAAY,aAAa;QAAE,OAAO,KAAK,CAAC;IACjD,IAAI,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,IAAI,aAAa,CAAC,qBAAqB,EAAE,QAAQ,EAAE,CAAC,EAAE;YAC3D,kBAAkB,EAAE,KAAK;SAC1B,CAAC,CAAC;IACL,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,IAAI,aAAa,CACtB,kBAAkB,EAClB,mCAAmC,EACnC,CAAC,EACD,EAAE,KAAK,EAAE,OAAO,EAAE,EAClB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CACtD,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAc;IAC1C,OAAO,CACL,KAAK,YAAY,KAAK;QACtB,CAAC,KAAK,CAAC,IAAI,KAAK,iBAAiB,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAC7E,CAAC;AACJ,CAAC"}

package/dist/core/output.d.ts

@@ -0,0 +1,16 @@
+import type { DataPullError } from "./errors.js";
+export interface OutputOptions {
+    command: string;
+    json: boolean;
+}
+export declare class Output {
+    readonly command: string;
+    readonly json: boolean;
+    constructor(options: OutputOptions);
+    info(message: string): void;
+    warn(message: string): void;
+    success(payload: object, message?: string): void;
+    failure(error: DataPullError, extra?: Record<string, unknown>): void;
+    private writeInstallationGuidance;
+}
+//# sourceMappingURL=output.d.ts.map

package/dist/core/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/core/output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,qBAAa,MAAM;IACjB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAEvB,YAAY,OAAO,EAAE,aAAa,EAGjC;IAED,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAG1B;IAED,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1B;IAED,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAQ/C;IAED,OAAO,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI,CAkBvE;IAED,OAAO,CAAC,yBAAyB;CAwBlC"}

package/dist/core/output.js

@@ -0,0 +1,91 @@
+export class Output {
+    command;
+    json;
+    constructor(options) {
+        this.command = options.command;
+        this.json = options.json;
+    }
+    info(message) {
+        if (this.json)
+            process.stderr.write(`${message}\n`);
+        else
+            process.stdout.write(`${message}\n`);
+    }
+    warn(message) {
+        process.stderr.write(`${message}\n`);
+    }
+    success(payload, message) {
+        if (this.json) {
+            process.stdout.write(`${JSON.stringify({ ok: true, command: this.command, ...payload })}\n`);
+            return;
+        }
+        if (message !== undefined)
+            this.info(message);
+    }
+    failure(error, extra = {}) {
+        if (this.json) {
+            process.stdout.write(`${JSON.stringify({
+                ok: false,
+                command: this.command,
+                ...extra,
+                error: {
+                    code: error.code,
+                    message: error.message,
+                    ...(error.details === undefined ? {} : { details: error.details }),
+                },
+            })}\n`);
+            return;
+        }
+        this.warn(`错误 [${error.code}]：${error.message}`);
+        this.writeInstallationGuidance(extra);
+    }
+    writeInstallationGuidance(extra) {
+        const plans = installationPlans(extra);
+        const manualRequired = stringArray(extra.manualRequired);
+        if (plans.length === 0 && manualRequired.length === 0)
+            return;
+        this.warn("手工安装指引（执行前请核对来源与权限）：");
+        for (const plan of plans) {
+            const tool = stringValue(plan.tool) ?? "未知工具";
+            const source = stringValue(plan.source) ?? "未提供";
+            const sourceUrl = stringValue(plan.sourceUrl);
+            const command = stringValue(plan.command);
+            const args = stringArray(plan.args);
+            const permission = stringValue(plan.permission) ?? "未提供";
+            const downloadImpact = stringValue(plan.downloadImpact) ?? "未提供";
+            this.warn(`- 工具：${tool}`);
+            this.warn(`  来源：${source}${sourceUrl === undefined ? "" : `（${sourceUrl}）`}`);
+            if (command !== undefined)
+                this.warn(`  命令：${[command, ...args].join(" ")}`);
+            this.warn(`  权限：${permission}`);
+            this.warn(`  下载影响：${downloadImpact}`);
+        }
+        if (manualRequired.length > 0) {
+            this.warn(`- 当前适配器无法自动处理：${manualRequired.join("、")}`);
+        }
+    }
+}
+function installationPlans(extra) {
+    const direct = recordArray(extra.installation);
+    if (direct.length > 0)
+        return direct;
+    const actionPlan = recordValue(extra.actionPlan);
+    return actionPlan === undefined ? [] : recordArray(actionPlan.installation);
+}
+function recordValue(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function recordArray(value) {
+    return Array.isArray(value)
+        ? value.map(recordValue).filter((item) => item !== undefined)
+        : [];
+}
+function stringValue(value) {
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function stringArray(value) {
+    return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+}
+//# sourceMappingURL=output.js.map

package/dist/core/output.js.map

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

package/dist/core/runtime.d.ts

@@ -0,0 +1,3 @@
+export declare const MINIMUM_NODE_VERSION: readonly [22, 12, 0];
+export declare function assertSupportedNode(version?: string): void;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/core/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/core/runtime.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,oBAAoB,YAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAU,CAAC;AAEzD,wBAAgB,mBAAmB,CAAC,OAAO,SAAwB,GAAG,IAAI,CAiBzE"}

package/dist/core/runtime.js

@@ -0,0 +1,14 @@
+import { DataPullError } from "./errors.js";
+export const MINIMUM_NODE_VERSION = [22, 12, 0];
+export function assertSupportedNode(version = process.versions.node) {
+    const current = version.split(".").map((part) => Number.parseInt(part, 10));
+    const supported = MINIMUM_NODE_VERSION.every((minimum, index) => {
+        const value = current[index] ?? 0;
+        const prefixEqual = MINIMUM_NODE_VERSION.slice(0, index).every((prefix, prefixIndex) => (current[prefixIndex] ?? 0) === prefix);
+        return !prefixEqual || value >= minimum;
+    });
+    if (!supported) {
+        throw new DataPullError("NODE_VERSION_UNSUPPORTED", `DataPull 需要 Node.js >= ${MINIMUM_NODE_VERSION.join(".")}，当前版本为 ${version}。`, 4, { currentVersion: version, minimumVersion: MINIMUM_NODE_VERSION.join(".") });
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/core/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/core/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAU,CAAC;AAEzD,MAAM,UAAU,mBAAmB,CAAC,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI;IACjE,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;IAC5E,MAAM,SAAS,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;QAC9D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,WAAW,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,KAAK,CAC5D,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,MAAM,CAChE,CAAC;QACF,OAAO,CAAC,WAAW,IAAI,KAAK,IAAI,OAAO,CAAC;IAC1C,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,aAAa,CACrB,0BAA0B,EAC1B,0BAA0B,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,OAAO,GAAG,EAC5E,CAAC,EACD,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,EAAE,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAC5E,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/doctor/service.d.ts

@@ -0,0 +1,9 @@
+import { ConfigStore } from "../config/store.js";
+import { ToolManager } from "../tools/manager.js";
+export interface DoctorCheck {
+    name: string;
+    ok: boolean;
+    detail: string;
+}
+export declare function runDoctor(store: ConfigStore, tools?: ToolManager): Promise<DoctorCheck[]>;
+//# sourceMappingURL=service.d.ts.map

package/dist/doctor/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/doctor/service.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIlD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,SAAS,CAC7B,KAAK,EAAE,WAAW,EAClB,KAAK,cAAoB,GACxB,OAAO,CAAC,WAAW,EAAE,CAAC,CAwCxB"}

package/dist/doctor/service.js

@@ -0,0 +1,81 @@
+import { constants } from "node:fs";
+import { access, readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { release } from "node:os";
+import { ConfigStore } from "../config/store.js";
+import { asDataPullError } from "../core/errors.js";
+import { MINIMUM_NODE_VERSION } from "../core/runtime.js";
+import { ToolManager } from "../tools/manager.js";
+import { INSTALL_ADAPTER_VERSION } from "../tools/catalog.js";
+import { discoverProjectRoot } from "../utils/path.js";
+export async function runDoctor(store, tools = new ToolManager()) {
+    const checks = [
+        {
+            name: "node",
+            ok: true,
+            detail: `Node.js ${process.versions.node}（最低 ${MINIMUM_NODE_VERSION.join(".")}）`,
+        },
+        platformCheck(await linuxDistribution()),
+        {
+            name: "install-adapter",
+            ok: true,
+            detail: `安装适配目录版本 ${INSTALL_ADAPTER_VERSION}`,
+        },
+    ];
+    try {
+        await store.read();
+        await store.readCredentials();
+        checks.push({ name: "config", ok: true, detail: store.paths.root });
+    }
+    catch (error) {
+        const normalized = asDataPullError(error);
+        checks.push({ name: "config", ok: false, detail: `${normalized.code}: ${normalized.message}` });
+    }
+    const root = await discoverProjectRoot();
+    try {
+        await access(root, constants.W_OK);
+        checks.push({ name: "project", ok: true, detail: root });
+    }
+    catch {
+        checks.push({ name: "project", ok: false, detail: `项目根目录不可写：${root}` });
+    }
+    for (const engine of ["mysql", "postgresql", "sqlserver"]) {
+        const statuses = await tools.inspect(engine);
+        checks.push({
+            name: `tools:${engine}`,
+            ok: statuses.every((status) => status.available),
+            detail: statuses
+                .map((status) => `${status.tool}=${status.available ? status.version ?? "available" : "missing"}`)
+                .join("; "),
+        });
+    }
+    return checks;
+}
+async function linuxDistribution() {
+    if (process.platform !== "linux")
+        return undefined;
+    try {
+        const content = await readFile(join("/", "etc", "os-release"), "utf8");
+        return content.match(/^ID=(?:"([^"]+)"|([^\n]+))$/mu)?.slice(1).find(Boolean);
+    }
+    catch {
+        return undefined;
+    }
+}
+function platformCheck(distribution) {
+    if (process.platform === "win32") {
+        return { name: "platform", ok: true, detail: `Windows ${release()}` };
+    }
+    if (process.platform === "darwin")
+        return { name: "platform", ok: true, detail: "macOS" };
+    if (process.platform === "linux") {
+        const supported = ["ubuntu", "debian", "fedora"].includes(distribution ?? "");
+        return {
+            name: "platform",
+            ok: supported,
+            detail: supported ? `Linux ${distribution}` : `未验证的 Linux 发行版：${distribution ?? "unknown"}`,
+        };
+    }
+    return { name: "platform", ok: false, detail: `不支持的平台：${process.platform}` };
+}
+//# sourceMappingURL=service.js.map

package/dist/doctor/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/doctor/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAQvD,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,KAAkB,EAClB,KAAK,GAAG,IAAI,WAAW,EAAE;IAEzB,MAAM,MAAM,GAAkB;QAC5B;YACE,IAAI,EAAE,MAAM;YACZ,EAAE,EAAE,IAAI;YACR,MAAM,EAAE,WAAW,OAAO,CAAC,QAAQ,CAAC,IAAI,OAAO,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG;SACjF;QACD,aAAa,CAAC,MAAM,iBAAiB,EAAE,CAAC;QACxC;YACE,IAAI,EAAE,iBAAiB;YACvB,EAAE,EAAE,IAAI;YACR,MAAM,EAAE,YAAY,uBAAuB,EAAE;SAC9C;KACF,CAAC;IACF,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,MAAM,KAAK,CAAC,eAAe,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACtE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,UAAU,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,IAAI,KAAK,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAClG,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,mBAAmB,EAAE,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,IAAI,EAAE,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,WAAW,CAAU,EAAE,CAAC;QACnE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,SAAS,MAAM,EAAE;YACvB,EAAE,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC;YAChD,MAAM,EAAE,QAAQ;iBACb,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,IAAI,WAAW,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;iBACjG,IAAI,CAAC,IAAI,CAAC;SACd,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,iBAAiB;IAC9B,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,SAAS,CAAC;IACnD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,CAAC;QACvE,OAAO,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAChF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,YAAqB;IAC1C,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,OAAO,EAAE,EAAE,EAAE,CAAC;IACxE,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAC1F,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;QAC9E,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,EAAE,EAAE,SAAS;YACb,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,SAAS,YAAY,EAAE,CAAC,CAAC,CAAC,kBAAkB,YAAY,IAAI,SAAS,EAAE;SAC5F,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;AAC/E,CAAC"}

package/dist/exporters/exporter.d.ts

@@ -0,0 +1,10 @@
+import type { DatabaseObject, ResolvedConnection } from "../types.js";
+export interface DatabaseConnectionTest {
+    serverVersion: string;
+}
+export interface DatabaseExporter {
+    listDatabases(connection: ResolvedConnection): Promise<string[]>;
+    test(connection: ResolvedConnection, database?: string): Promise<DatabaseConnectionTest>;
+    exportObjects(connection: ResolvedConnection, database: string, objectTypes: readonly string[]): Promise<DatabaseObject[]>;
+}
+//# sourceMappingURL=exporter.d.ts.map

package/dist/exporters/exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exporter.d.ts","sourceRoot":"","sources":["../../src/exporters/exporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtE,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,CAAC,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACjE,IAAI,CACF,UAAU,EAAE,kBAAkB,EAC9B,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACnC,aAAa,CACX,UAAU,EAAE,kBAAkB,EAC9B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CAC9B"}

package/dist/exporters/exporter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=exporter.js.map

package/dist/exporters/exporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exporter.js","sourceRoot":"","sources":["../../src/exporters/exporter.ts"],"names":[],"mappings":""}

package/dist/exporters/factory.d.ts

@@ -0,0 +1,4 @@
+import type { Engine } from "../types.js";
+import type { DatabaseExporter } from "./exporter.js";
+export declare function exporterFor(engine: Engine): DatabaseExporter;
+//# sourceMappingURL=factory.d.ts.map

package/dist/exporters/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/exporters/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAKtD,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAI5D"}

package/dist/exporters/factory.js

@@ -0,0 +1,11 @@
+import { MySqlExporter } from "./mysql.js";
+import { PostgreSqlExporter } from "./postgresql.js";
+import { SqlServerExporter } from "./sqlserver.js";
+export function exporterFor(engine) {
+    if (engine === "mysql")
+        return new MySqlExporter();
+    if (engine === "postgresql")
+        return new PostgreSqlExporter();
+    return new SqlServerExporter();
+}
+//# sourceMappingURL=factory.js.map

package/dist/exporters/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/exporters/factory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,IAAI,aAAa,EAAE,CAAC;IACnD,IAAI,MAAM,KAAK,YAAY;QAAE,OAAO,IAAI,kBAAkB,EAAE,CAAC;IAC7D,OAAO,IAAI,iBAAiB,EAAE,CAAC;AACjC,CAAC"}

package/dist/exporters/mysql.d.ts

@@ -0,0 +1,16 @@
+import { CredentialSecurity } from "../config/security.js";
+import type { DatabaseObject, ResolvedConnection } from "../types.js";
+import type { DatabaseConnectionTest, DatabaseExporter } from "./exporter.js";
+export declare class MySqlExporter implements DatabaseExporter {
+    private readonly security;
+    constructor(security?: CredentialSecurity);
+    listDatabases(connection: ResolvedConnection): Promise<string[]>;
+    test(connection: ResolvedConnection, database?: string): Promise<DatabaseConnectionTest>;
+    exportObjects(connection: ResolvedConnection, database: string, objectTypes: readonly string[]): Promise<DatabaseObject[]>;
+    private withOptionFile;
+    private query;
+    private firstRow;
+    private singleColumn;
+}
+export declare function stripMysqlDefiner(ddl: string): string;
+//# sourceMappingURL=mysql.d.ts.map

package/dist/exporters/mysql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mysql.d.ts","sourceRoot":"","sources":["../../src/exporters/mysql.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,KAAK,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAG9E,qBAAa,aAAc,YAAW,gBAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAArC,YAA6B,QAAQ,qBAA2B,EAAI;IAE9D,aAAa,CAAC,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAWrE;IAEK,IAAI,CACR,UAAU,EAAE,kBAAkB,EAC9B,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,sBAAsB,CAAC,CASjC;IAEK,aAAa,CACjB,UAAU,EAAE,kBAAkB,EAC9B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B,OAAO,CAAC,cAAc,EAAE,CAAC,CAwF3B;YAEa,cAAc;YA6Bd,KAAK;YAqBL,QAAQ;YAYR,YAAY;CAS3B;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIrD"}