@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/dns/cloudflare/CloudflareDnsProvider.js

@@ -0,0 +1,227 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CloudflareDnsProvider = void 0;
+const global_logger_factory_1 = require("global-logger-factory");
+/**
+ * 基于 Cloudflare API v4 的 DNS 提供方实现。
+ */
+class CloudflareDnsProvider {
+    constructor(options) {
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        /** 缓存 domain -> zoneId 的映射 */
+        this.zoneIdCache = new Map();
+        this.apiToken = this.normalizeString(options.apiToken) ?? '';
+        this.baseUrl = (this.normalizeString(options.baseUrl) ?? 'https://api.cloudflare.com/client/v4').replace(/\/$/, '');
+        this.timeoutMs = this.normalizeTimeout(options.timeoutMs) ?? 10_000;
+        this.configuredZoneId = this.normalizeString(options.zoneId);
+        this.enabled = this.apiToken.length > 0;
+        if (!this.enabled) {
+            this.logger.info('CloudflareDnsProvider 未配置 apiToken，将以禁用状态运行。');
+        }
+    }
+    async upsertRecord(options) {
+        if (!this.enabled) {
+            this.logger.debug('DNS provider disabled，跳过 upsert。');
+            return;
+        }
+        const zoneId = await this.getZoneId(options.domain);
+        const fullName = this.buildFullName(options.subdomain, options.domain);
+        const ttl = options.ttl ?? 1; // Cloudflare: 1 = auto
+        // 查找所有同名记录（不限类型），以处理 CNAME 与 A/AAAA 冲突
+        const existing = await this.findRecord(zoneId, fullName);
+        if (existing) {
+            // 如果现有记录类型不同（如 CNAME vs AAAA），必须先删除旧记录
+            if (existing.type !== options.type) {
+                this.logger.info(`发现 DNS 类型冲突 (现有: ${existing.type}, 目标: ${options.type})，正在删除旧记录 ${fullName}...`);
+                await this.callApi(`zones/${zoneId}/dns_records/${existing.id}`, 'DELETE');
+                // 删除后继续执行创建逻辑
+            }
+            else {
+                // 类型相同，检查内容是否需要更新
+                if (existing.content === options.value && (existing.ttl === ttl || ttl === 1)) {
+                    this.logger.debug(`DNS 记录已存在且一致，跳过更新 ${fullName} ${options.type}`);
+                    return;
+                }
+                // 更新现有记录
+                await this.callApi(`zones/${zoneId}/dns_records/${existing.id}`, 'PATCH', {
+                    type: options.type,
+                    name: fullName,
+                    content: options.value,
+                    ttl,
+                    proxied: false, // DNS-01 验证需要关闭代理
+                });
+                this.logger.info(`已更新 DNS 记录 ${fullName} ${options.type}`);
+                return;
+            }
+        }
+        // 创建新记录
+        await this.callApi(`zones/${zoneId}/dns_records`, 'POST', {
+            type: options.type,
+            name: fullName,
+            content: options.value,
+            ttl,
+            proxied: false,
+        });
+        this.logger.info(`已创建 DNS 记录 ${fullName} ${options.type}`);
+    }
+    async deleteRecord(options) {
+        if (!this.enabled) {
+            this.logger.debug('DNS provider disabled，跳过 delete。');
+            return;
+        }
+        const zoneId = await this.getZoneId(options.domain);
+        const fullName = this.buildFullName(options.subdomain, options.domain);
+        // 删除时也要支持泛查找，以防类型传错，但通常 deleteRecord 会传 type
+        const existing = await this.findRecord(zoneId, fullName, options.type, options.value);
+        if (!existing) {
+            this.logger.debug(`DNS 记录不存在，跳过删除 ${fullName} ${options.type}`);
+            return;
+        }
+        await this.callApi(`zones/${zoneId}/dns_records/${existing.id}`, 'DELETE');
+        this.logger.info(`已删除 DNS 记录 ${fullName} ${options.type}`);
+    }
+    async listRecords(options) {
+        if (!this.enabled) {
+            return [];
+        }
+        const zoneId = await this.getZoneId(options.domain);
+        const params = new URLSearchParams();
+        if (options.subdomain) {
+            params.set('name', this.buildFullName(options.subdomain, options.domain));
+        }
+        if (options.type) {
+            params.set('type', options.type);
+        }
+        params.set('per_page', '100');
+        const queryString = params.toString();
+        const endpoint = `zones/${zoneId}/dns_records${queryString ? `?${queryString}` : ''}`;
+        const response = await this.callApi(endpoint, 'GET');
+        return response.map((record) => this.toRecordSummary(record, options.domain));
+    }
+    /**
+     * 获取 Zone ID，优先使用配置的，否则自动查找
+     * 支持从子域名向上递归查找 Zone
+     */
+    async getZoneId(domain) {
+        if (this.configuredZoneId) {
+            return this.configuredZoneId;
+        }
+        const cached = this.zoneIdCache.get(domain);
+        if (cached) {
+            return cached;
+        }
+        // 自动查找 Zone ID，如果找不到则尝试向上级域名查找
+        let currentDomain = domain;
+        while (currentDomain.includes('.')) {
+            const response = await this.callApi(`zones?name=${encodeURIComponent(currentDomain)}&status=active`, 'GET');
+            if (response.length > 0) {
+                const zoneId = response[0].id;
+                // 注意：这里缓存的是原始查询域名 -> 找到的 zoneId
+                this.zoneIdCache.set(domain, zoneId);
+                this.logger.debug(`已查找到域名 ${domain} 的所属 Zone (${currentDomain}) ID: ${zoneId}`);
+                return zoneId;
+            }
+            // 移除第一段 (如 a.b.com -> b.com)
+            const parts = currentDomain.split('.');
+            if (parts.length <= 2)
+                break; // 已经到了顶级域名，停止
+            currentDomain = parts.slice(1).join('.');
+        }
+        throw new Error(`找不到域名 ${domain} 的任何所属 Zone，请检查域名是否正确或手动提供 zoneId`);
+    }
+    /**
+     * 查找现有 DNS 记录
+     */
+    async findRecord(zoneId, fullName, type, value) {
+        const params = new URLSearchParams({
+            name: fullName,
+        });
+        if (type) {
+            params.set('type', type);
+        }
+        if (value) {
+            params.set('content', value);
+        }
+        const response = await this.callApi(`zones/${zoneId}/dns_records?${params.toString()}`, 'GET');
+        return response[0];
+    }
+    /**
+     * 调用 Cloudflare API
+     */
+    async callApi(endpoint, method, body) {
+        const url = `${this.baseUrl}/${endpoint}`;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const response = await fetch(url, {
+                method,
+                headers: {
+                    'Authorization': `Bearer ${this.apiToken}`,
+                    'Content-Type': 'application/json',
+                },
+                body: body ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            const data = await response.json();
+            if (!data.success) {
+                const errorMsg = data.errors.map((e) => `${e.code}: ${e.message}`).join(', ');
+                throw new Error(`Cloudflare API 错误: ${errorMsg}`);
+            }
+            return data.result;
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error.name === 'AbortError') {
+                throw new Error(`Cloudflare API 请求超时 (${this.timeoutMs}ms)`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * 构建完整域名
+     */
+    buildFullName(subdomain, domain) {
+        if (subdomain === '@' || subdomain === '') {
+            return domain;
+        }
+        return `${subdomain}.${domain}`;
+    }
+    /**
+     * 转换为通用记录摘要
+     */
+    toRecordSummary(record, domain) {
+        const subdomain = record.name === domain ? '@' : record.name.replace(`.${domain}`, '');
+        return {
+            id: record.id,
+            domain,
+            subdomain,
+            type: record.type,
+            value: record.content,
+            ttl: record.ttl,
+            line: 'default',
+            lineId: 'default',
+        };
+    }
+    normalizeString(value) {
+        if (typeof value !== 'string') {
+            return undefined;
+        }
+        const trimmed = value.trim();
+        return trimmed.length > 0 ? trimmed : undefined;
+    }
+    normalizeTimeout(value) {
+        if (typeof value === 'number' && Number.isFinite(value) && value > 0) {
+            return value;
+        }
+        if (typeof value === 'string') {
+            const parsed = Number(value);
+            if (Number.isFinite(parsed) && parsed > 0) {
+                return parsed;
+            }
+        }
+        return undefined;
+    }
+}
+exports.CloudflareDnsProvider = CloudflareDnsProvider;
+//# sourceMappingURL=CloudflareDnsProvider.js.map

package/dist/dns/cloudflare/CloudflareDnsProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CloudflareDnsProvider.js","sourceRoot":"","sources":["../../../src/dns/cloudflare/CloudflareDnsProvider.ts"],"names":[],"mappings":"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","sourcesContent":["import { getLoggerFor } from 'global-logger-factory';\nimport type {\n  DeleteDnsRecordInput,\n  DnsRecordSummary,\n  DnsRecordTypeValue,\n  ListDnsRecordsInput,\n  ListableDnsProvider,\n  UpsertDnsRecordInput,\n} from '../DnsProvider';\n\nexport interface CloudflareDnsProviderOptions {\n  /** Cloudflare API Token（推荐使用受限 Token） */\n  apiToken?: string | null;\n  /** Zone ID，如果不提供会自动查找 */\n  zoneId?: string | null;\n  /** API 根地址，默认为 `https://api.cloudflare.com/client/v4` */\n  baseUrl?: string | null;\n  /** HTTP 请求超时毫秒数，默认 10s */\n  timeoutMs?: number | string | null;\n}\n\ninterface CloudflareApiResponse<T> {\n  success: boolean;\n  errors: Array<{ code: number; message: string }>;\n  messages: string[];\n  result: T;\n  result_info?: {\n    page: number;\n    per_page: number;\n    total_count: number;\n    total_pages: number;\n  };\n}\n\ninterface CloudflareDnsRecord {\n  id: string;\n  zone_id: string;\n  zone_name: string;\n  name: string;\n  type: string;\n  content: string;\n  proxied: boolean;\n  ttl: number;\n  created_on: string;\n  modified_on: string;\n}\n\ninterface CloudflareZone {\n  id: string;\n  name: string;\n  status: string;\n}\n\n/**\n * 基于 Cloudflare API v4 的 DNS 提供方实现。\n */\nexport class CloudflareDnsProvider implements ListableDnsProvider {\n  private readonly logger = getLoggerFor(this);\n  private readonly apiToken: string;\n  private readonly baseUrl: string;\n  private readonly timeoutMs: number;\n  private readonly enabled: boolean;\n  private readonly configuredZoneId?: string;\n  \n  /** 缓存 domain -> zoneId 的映射 */\n  private readonly zoneIdCache = new Map<string, string>();\n\n  public constructor(options: CloudflareDnsProviderOptions) {\n    this.apiToken = this.normalizeString(options.apiToken) ?? '';\n    this.baseUrl = (this.normalizeString(options.baseUrl) ?? 'https://api.cloudflare.com/client/v4').replace(/\\/$/, '');\n    this.timeoutMs = this.normalizeTimeout(options.timeoutMs) ?? 10_000;\n    this.configuredZoneId = this.normalizeString(options.zoneId);\n    this.enabled = this.apiToken.length > 0;\n    \n    if (!this.enabled) {\n      this.logger.info('CloudflareDnsProvider 未配置 apiToken，将以禁用状态运行。');\n    }\n  }\n\n  public async upsertRecord(options: UpsertDnsRecordInput): Promise<void> {\n    if (!this.enabled) {\n      this.logger.debug('DNS provider disabled，跳过 upsert。');\n      return;\n    }\n\n    const zoneId = await this.getZoneId(options.domain);\n    const fullName = this.buildFullName(options.subdomain, options.domain);\n    const ttl = options.ttl ?? 1; // Cloudflare: 1 = auto\n\n    // 查找所有同名记录（不限类型），以处理 CNAME 与 A/AAAA 冲突\n    const existing = await this.findRecord(zoneId, fullName);\n\n    if (existing) {\n      // 如果现有记录类型不同（如 CNAME vs AAAA），必须先删除旧记录\n      if (existing.type !== options.type) {\n        this.logger.info(`发现 DNS 类型冲突 (现有: ${existing.type}, 目标: ${options.type})，正在删除旧记录 ${fullName}...`);\n        await this.callApi(\n          `zones/${zoneId}/dns_records/${existing.id}`,\n          'DELETE'\n        );\n        // 删除后继续执行创建逻辑\n      } else {\n        // 类型相同，检查内容是否需要更新\n        if (existing.content === options.value && (existing.ttl === ttl || ttl === 1)) {\n          this.logger.debug(`DNS 记录已存在且一致，跳过更新 ${fullName} ${options.type}`);\n          return;\n        }\n\n        // 更新现有记录\n        await this.callApi<CloudflareDnsRecord>(\n          `zones/${zoneId}/dns_records/${existing.id}`,\n          'PATCH',\n          {\n            type: options.type,\n            name: fullName,\n            content: options.value,\n            ttl,\n            proxied: false, // DNS-01 验证需要关闭代理\n          }\n        );\n        this.logger.info(`已更新 DNS 记录 ${fullName} ${options.type}`);\n        return;\n      }\n    }\n\n    // 创建新记录\n    await this.callApi<CloudflareDnsRecord>(\n      `zones/${zoneId}/dns_records`,\n      'POST',\n      {\n        type: options.type,\n        name: fullName,\n        content: options.value,\n        ttl,\n        proxied: false,\n      }\n    );\n    this.logger.info(`已创建 DNS 记录 ${fullName} ${options.type}`);\n  }\n\n  public async deleteRecord(options: DeleteDnsRecordInput): Promise<void> {\n    if (!this.enabled) {\n      this.logger.debug('DNS provider disabled，跳过 delete。');\n      return;\n    }\n\n    const zoneId = await this.getZoneId(options.domain);\n    const fullName = this.buildFullName(options.subdomain, options.domain);\n    // 删除时也要支持泛查找，以防类型传错，但通常 deleteRecord 会传 type\n    const existing = await this.findRecord(zoneId, fullName, options.type, options.value);\n\n    if (!existing) {\n      this.logger.debug(`DNS 记录不存在，跳过删除 ${fullName} ${options.type}`);\n      return;\n    }\n\n    await this.callApi<{ id: string }>(\n      `zones/${zoneId}/dns_records/${existing.id}`,\n      'DELETE'\n    );\n    this.logger.info(`已删除 DNS 记录 ${fullName} ${options.type}`);\n  }\n\n  public async listRecords(options: ListDnsRecordsInput): Promise<DnsRecordSummary[]> {\n    if (!this.enabled) {\n      return [];\n    }\n\n    const zoneId = await this.getZoneId(options.domain);\n    const params = new URLSearchParams();\n    \n    if (options.subdomain) {\n      params.set('name', this.buildFullName(options.subdomain, options.domain));\n    }\n    if (options.type) {\n      params.set('type', options.type);\n    }\n    params.set('per_page', '100');\n\n    const queryString = params.toString();\n    const endpoint = `zones/${zoneId}/dns_records${queryString ? `?${queryString}` : ''}`;\n    const response = await this.callApi<CloudflareDnsRecord[]>(endpoint, 'GET');\n\n    return response.map((record) => this.toRecordSummary(record, options.domain));\n  }\n\n  /**\n   * 获取 Zone ID，优先使用配置的，否则自动查找\n   * 支持从子域名向上递归查找 Zone\n   */\n  private async getZoneId(domain: string): Promise<string> {\n    if (this.configuredZoneId) {\n      return this.configuredZoneId;\n    }\n\n    const cached = this.zoneIdCache.get(domain);\n    if (cached) {\n      return cached;\n    }\n\n    // 自动查找 Zone ID，如果找不到则尝试向上级域名查找\n    let currentDomain = domain;\n    while (currentDomain.includes('.')) {\n      const response = await this.callApi<CloudflareZone[]>(\n        `zones?name=${encodeURIComponent(currentDomain)}&status=active`,\n        'GET'\n      );\n\n      if (response.length > 0) {\n        const zoneId = response[0].id;\n        // 注意：这里缓存的是原始查询域名 -> 找到的 zoneId\n        this.zoneIdCache.set(domain, zoneId);\n        this.logger.debug(`已查找到域名 ${domain} 的所属 Zone (${currentDomain}) ID: ${zoneId}`);\n        return zoneId;\n      }\n\n      // 移除第一段 (如 a.b.com -> b.com)\n      const parts = currentDomain.split('.');\n      if (parts.length <= 2) break; // 已经到了顶级域名，停止\n      currentDomain = parts.slice(1).join('.');\n    }\n\n    throw new Error(`找不到域名 ${domain} 的任何所属 Zone，请检查域名是否正确或手动提供 zoneId`);\n  }\n\n  /**\n   * 查找现有 DNS 记录\n   */\n  private async findRecord(\n    zoneId: string,\n    fullName: string,\n    type?: DnsRecordTypeValue,\n    value?: string\n  ): Promise<CloudflareDnsRecord | undefined> {\n    const params = new URLSearchParams({\n      name: fullName,\n    });\n    if (type) {\n      params.set('type', type);\n    }\n    if (value) {\n      params.set('content', value);\n    }\n\n    const response = await this.callApi<CloudflareDnsRecord[]>(\n      `zones/${zoneId}/dns_records?${params.toString()}`,\n      'GET'\n    );\n\n    return response[0];\n  }\n\n  /**\n   * 调用 Cloudflare API\n   */\n  private async callApi<T>(endpoint: string, method: string, body?: unknown): Promise<T> {\n    const url = `${this.baseUrl}/${endpoint}`;\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);\n\n    try {\n      const response = await fetch(url, {\n        method,\n        headers: {\n          'Authorization': `Bearer ${this.apiToken}`,\n          'Content-Type': 'application/json',\n        },\n        body: body ? JSON.stringify(body) : undefined,\n        signal: controller.signal,\n      });\n\n      clearTimeout(timeoutId);\n\n      const data = await response.json() as CloudflareApiResponse<T>;\n\n      if (!data.success) {\n        const errorMsg = data.errors.map((e) => `${e.code}: ${e.message}`).join(', ');\n        throw new Error(`Cloudflare API 错误: ${errorMsg}`);\n      }\n\n      return data.result;\n    } catch (error: unknown) {\n      clearTimeout(timeoutId);\n      if ((error as Error).name === 'AbortError') {\n        throw new Error(`Cloudflare API 请求超时 (${this.timeoutMs}ms)`);\n      }\n      throw error;\n    }\n  }\n\n  /**\n   * 构建完整域名\n   */\n  private buildFullName(subdomain: string, domain: string): string {\n    if (subdomain === '@' || subdomain === '') {\n      return domain;\n    }\n    return `${subdomain}.${domain}`;\n  }\n\n  /**\n   * 转换为通用记录摘要\n   */\n  private toRecordSummary(record: CloudflareDnsRecord, domain: string): DnsRecordSummary {\n    const subdomain = record.name === domain ? '@' : record.name.replace(`.${domain}`, '');\n    return {\n      id: record.id,\n      domain,\n      subdomain,\n      type: record.type as DnsRecordTypeValue,\n      value: record.content,\n      ttl: record.ttl,\n      line: 'default',\n      lineId: 'default',\n    };\n  }\n\n  private normalizeString(value: unknown): string | undefined {\n    if (typeof value !== 'string') {\n      return undefined;\n    }\n    const trimmed = value.trim();\n    return trimmed.length > 0 ? trimmed : undefined;\n  }\n\n  private normalizeTimeout(value: unknown): number | undefined {\n    if (typeof value === 'number' && Number.isFinite(value) && value > 0) {\n      return value;\n    }\n    if (typeof value === 'string') {\n      const parsed = Number(value);\n      if (Number.isFinite(parsed) && parsed > 0) {\n        return parsed;\n      }\n    }\n    return undefined;\n  }\n}"]}

package/dist/dns/cloudflare/index.d.ts

@@ -0,0 +1 @@
+export * from './CloudflareDnsProvider';

package/dist/dns/cloudflare/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./CloudflareDnsProvider"), exports);
+//# sourceMappingURL=index.js.map

package/dist/dns/cloudflare/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/dns/cloudflare/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0DAAwC","sourcesContent":["export * from './CloudflareDnsProvider';\n"]}

package/dist/dns/tencent/TencentDnsProvider.d.ts

@@ -0,0 +1,42 @@
+import type { DeleteDnsRecordInput, DnsRecordSummary, ListDnsRecordsInput, ListableDnsProvider, UpsertDnsRecordInput } from '../DnsProvider';
+interface TencentDnsProviderOptions {
+    tokenId?: string | null;
+    token?: string | null;
+    /** API 根地址，默认为 `https://dnsapi.cn`。 */
+    baseUrl?: string | null;
+    /**
+     * 默认线路 ID，腾讯云 DNS 默认线路为 `0`。
+     * 若未指定且记录已存在，将复用已有线路。
+     */
+    defaultLineId?: string | null;
+    /** HTTP 请求超时毫秒数，默认 10s。 */
+    timeoutMs?: number | string | null;
+    /** User-Agent 标识，便于审计。 */
+    userAgent?: string | null;
+}
+/**
+ * 基于腾讯云 DNSPod v2 API 的 DNS 提供方实现。
+ */
+export declare class TencentDnsProvider implements ListableDnsProvider {
+    private readonly logger;
+    private readonly tokenId;
+    private readonly token;
+    private readonly baseUrl;
+    private readonly defaultLineId;
+    private readonly timeoutMs;
+    private readonly userAgent?;
+    private readonly enabled;
+    constructor(options: TencentDnsProviderOptions);
+    upsertRecord(options: UpsertDnsRecordInput): Promise<void>;
+    deleteRecord(options: DeleteDnsRecordInput): Promise<void>;
+    listRecords(options: ListDnsRecordsInput): Promise<DnsRecordSummary[]>;
+    private toSummary;
+    private findRecord;
+    private compareLine;
+    private compareTtl;
+    private normalizeTtl;
+    private callApi;
+    private normalizeString;
+    private normalizeTimeout;
+}
+export {};

package/dist/dns/tencent/TencentDnsProvider.js

@@ -0,0 +1,221 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TencentDnsProvider = void 0;
+const node_https_1 = require("node:https");
+const node_url_1 = require("node:url");
+const global_logger_factory_1 = require("global-logger-factory");
+/**
+ * 基于腾讯云 DNSPod v2 API 的 DNS 提供方实现。
+ */
+class TencentDnsProvider {
+    constructor(options) {
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        this.tokenId = this.normalizeString(options.tokenId) ?? '';
+        this.token = this.normalizeString(options.token) ?? '';
+        this.baseUrl = (this.normalizeString(options.baseUrl) ?? 'https://dnsapi.cn').replace(/\/$/, '');
+        this.defaultLineId = this.normalizeString(options.defaultLineId) ?? '0';
+        this.timeoutMs = this.normalizeTimeout(options.timeoutMs) ?? 10_000;
+        this.userAgent = this.normalizeString(options.userAgent) ?? undefined;
+        this.enabled = this.tokenId.length > 0 && this.token.length > 0;
+        if (!this.enabled) {
+            this.logger.info('TencentDnsProvider 未配置 token，将以禁用状态运行。');
+        }
+    }
+    async upsertRecord(options) {
+        if (!this.enabled) {
+            this.logger.debug('DNS provider disabled，跳过 upsert。');
+            return;
+        }
+        const existing = await this.findRecord(options.domain, options.subdomain, options.type);
+        const lineId = options.lineId ?? existing?.line_id ?? this.defaultLineId;
+        const ttl = this.normalizeTtl(options.ttl ?? (typeof existing?.ttl === 'number' ? existing.ttl : undefined));
+        if (existing) {
+            if (existing.value === options.value && this.compareLine(existing, lineId) && this.compareTtl(existing, ttl)) {
+                this.logger.debug(`DNS 记录已存在且一致，跳过更新 ${options.subdomain}.${options.domain} ${options.type}`);
+                return;
+            }
+            await this.callApi('Record.Modify', {
+                domain: options.domain,
+                record_id: existing.id,
+                sub_domain: options.subdomain,
+                record_type: options.type,
+                value: options.value,
+                record_line_id: lineId,
+                ttl,
+            });
+            this.logger.info(`已更新 DNS 记录 ${options.subdomain}.${options.domain} ${options.type}`);
+            return;
+        }
+        await this.callApi('Record.Create', {
+            domain: options.domain,
+            sub_domain: options.subdomain,
+            record_type: options.type,
+            value: options.value,
+            record_line_id: lineId,
+            ttl,
+        });
+        this.logger.info(`已创建 DNS 记录 ${options.subdomain}.${options.domain} ${options.type}`);
+    }
+    async deleteRecord(options) {
+        if (!this.enabled) {
+            this.logger.debug('DNS provider disabled，跳过 delete。');
+            return;
+        }
+        const record = await this.findRecord(options.domain, options.subdomain, options.type, options.value);
+        if (!record) {
+            this.logger.debug(`未找到可删除的 DNS 记录 ${options.subdomain}.${options.domain} ${options.type}`);
+            return;
+        }
+        await this.callApi('Record.Delete', {
+            domain: options.domain,
+            record_id: record.id,
+        });
+        this.logger.info(`已删除 DNS 记录 ${options.subdomain}.${options.domain} ${options.type}`);
+    }
+    async listRecords(options) {
+        if (!this.enabled) {
+            return [];
+        }
+        const records = await this.callApi('Record.List', {
+            domain: options.domain,
+            sub_domain: options.subdomain,
+            record_type: options.type,
+        });
+        const list = Array.isArray(records.records) ? records.records : [];
+        return list.map((record) => this.toSummary(options.domain, record));
+    }
+    toSummary(domain, record) {
+        return {
+            id: String(record.id),
+            domain,
+            subdomain: record.name,
+            type: record.type,
+            value: record.value,
+            ttl: typeof record.ttl === 'number' ? record.ttl : Number.parseInt(record.ttl, 10),
+            line: record.line,
+            lineId: record.line_id,
+        };
+    }
+    async findRecord(domain, subdomain, type, value) {
+        if (!this.enabled) {
+            return undefined;
+        }
+        const response = await this.callApi('Record.List', {
+            domain,
+            sub_domain: subdomain,
+            record_type: type,
+        });
+        const records = Array.isArray(response.records) ? response.records : [];
+        const normalizedValue = value?.trim().toLowerCase();
+        return records.find((record) => {
+            if (record.type?.toUpperCase() !== type.toUpperCase()) {
+                return false;
+            }
+            if (!normalizedValue) {
+                return true;
+            }
+            return String(record.value ?? '').trim().toLowerCase() === normalizedValue;
+        });
+    }
+    compareLine(record, lineId) {
+        return String(record.line_id ?? '').trim() === lineId.trim();
+    }
+    compareTtl(record, ttl) {
+        if (ttl == null) {
+            return true;
+        }
+        const current = typeof record.ttl === 'number' ? record.ttl : Number.parseInt(record.ttl, 10);
+        return Number.isFinite(current) ? current === ttl : true;
+    }
+    normalizeTtl(ttl) {
+        if (ttl == null) {
+            return undefined;
+        }
+        const value = Math.max(1, Math.trunc(ttl));
+        return Number.isFinite(value) ? value : undefined;
+    }
+    async callApi(endpoint, payload) {
+        if (!this.enabled) {
+            throw new Error('Tencent DNS provider 已禁用，无法调用 API。');
+        }
+        const url = new node_url_1.URL(`/` + endpoint.replace(/^\//, ''), this.baseUrl);
+        const body = new URLSearchParams({
+            login_token: `${this.tokenId},${this.token}`,
+            format: 'json',
+            lang: 'en',
+            error_on_empty: 'no',
+        });
+        for (const [key, value] of Object.entries(payload)) {
+            if (value === undefined || value === null || value === '') {
+                continue;
+            }
+            body.append(key, String(value));
+        }
+        const bodyString = body.toString();
+        const responseText = await new Promise((resolve, reject) => {
+            const request = (0, node_https_1.request)({
+                method: 'POST',
+                protocol: url.protocol,
+                hostname: url.hostname,
+                port: url.port ? Number(url.port) : undefined,
+                path: url.pathname,
+                headers: {
+                    'Content-Type': 'application/x-www-form-urlencoded',
+                    'Content-Length': Buffer.byteLength(bodyString),
+                    ...(this.userAgent ? { 'User-Agent': this.userAgent } : {}),
+                },
+                timeout: this.timeoutMs,
+            }, (res) => {
+                const chunks = [];
+                res.on('data', (chunk) => chunks.push(Buffer.from(chunk)));
+                res.on('end', () => {
+                    const data = Buffer.concat(chunks).toString('utf-8');
+                    if (res.statusCode && res.statusCode >= 200 && res.statusCode < 300) {
+                        resolve(data);
+                    }
+                    else {
+                        reject(new Error(`Tencent DNS API ${endpoint} HTTP ${res.statusCode ?? 0}: ${data}`));
+                    }
+                });
+            });
+            request.on('error', (error) => reject(error));
+            request.on('timeout', () => {
+                request.destroy(new Error(`Tencent DNS API ${endpoint} request timed out after ${this.timeoutMs}ms`));
+            });
+            request.write(bodyString);
+            request.end();
+        });
+        let parsed;
+        try {
+            parsed = JSON.parse(responseText);
+        }
+        catch (error) {
+            throw new Error(`Tencent DNS API ${endpoint} 返回非法 JSON: ${error.message}`);
+        }
+        if (parsed.status?.code !== '1') {
+            throw new Error(`Tencent DNS API ${endpoint} 调用失败: ${parsed.status?.message ?? 'Unknown error'}`);
+        }
+        return parsed;
+    }
+    normalizeString(value) {
+        if (typeof value !== 'string') {
+            return undefined;
+        }
+        const trimmed = value.trim();
+        return trimmed.length > 0 ? trimmed : undefined;
+    }
+    normalizeTimeout(value) {
+        if (typeof value === 'number' && Number.isFinite(value) && value > 0) {
+            return Math.trunc(value);
+        }
+        if (typeof value === 'string') {
+            const parsed = Number(value.trim());
+            if (Number.isFinite(parsed) && parsed > 0) {
+                return Math.trunc(parsed);
+            }
+        }
+        return undefined;
+    }
+}
+exports.TencentDnsProvider = TencentDnsProvider;
+//# sourceMappingURL=TencentDnsProvider.js.map

package/dist/dns/tencent/TencentDnsProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TencentDnsProvider.js","sourceRoot":"","sources":["../../../src/dns/tencent/TencentDnsProvider.ts"],"names":[],"mappings":"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","sourcesContent":["import { request as httpsRequest } from 'node:https';\nimport { URL } from 'node:url';\nimport { getLoggerFor } from 'global-logger-factory';\nimport type {\n  DeleteDnsRecordInput,\n  DnsProvider,\n  DnsRecordSummary,\n  DnsRecordTypeValue,\n  ListDnsRecordsInput,\n  ListableDnsProvider,\n  UpsertDnsRecordInput,\n} from '../DnsProvider';\n\ninterface TencentDnsProviderOptions {\n  tokenId?: string | null;\n  token?: string | null;\n  /** API 根地址，默认为 `https://dnsapi.cn`。 */\n  baseUrl?: string | null;\n  /**\n   * 默认线路 ID，腾讯云 DNS 默认线路为 `0`。\n   * 若未指定且记录已存在，将复用已有线路。\n   */\n  defaultLineId?: string | null;\n  /** HTTP 请求超时毫秒数，默认 10s。 */\n  timeoutMs?: number | string | null;\n  /** User-Agent 标识，便于审计。 */\n  userAgent?: string | null;\n}\n\ninterface TencentApiStatus {\n  code: string;\n  message: string;\n  created_at?: string;\n}\n\ntype TencentApiResponse<T> = T & { status: TencentApiStatus };\n\ninterface TencentRecordInfo {\n  id: string;\n  name: string;\n  type: string;\n  value: string;\n  ttl: number | string;\n  line: string;\n  line_id: string;\n}\n\n/**\n * 基于腾讯云 DNSPod v2 API 的 DNS 提供方实现。\n */\nexport class TencentDnsProvider implements ListableDnsProvider {\n  private readonly logger = getLoggerFor(this);\n  private readonly tokenId: string;\n  private readonly token: string;\n  private readonly baseUrl: string;\n  private readonly defaultLineId: string;\n  private readonly timeoutMs: number;\n  private readonly userAgent?: string;\n  private readonly enabled: boolean;\n\n  public constructor(options: TencentDnsProviderOptions) {\n    this.tokenId = this.normalizeString(options.tokenId) ?? '';\n    this.token = this.normalizeString(options.token) ?? '';\n    this.baseUrl = (this.normalizeString(options.baseUrl) ?? 'https://dnsapi.cn').replace(/\\/$/, '');\n    this.defaultLineId = this.normalizeString(options.defaultLineId) ?? '0';\n    this.timeoutMs = this.normalizeTimeout(options.timeoutMs) ?? 10_000;\n    this.userAgent = this.normalizeString(options.userAgent) ?? undefined;\n    this.enabled = this.tokenId.length > 0 && this.token.length > 0;\n    if (!this.enabled) {\n      this.logger.info('TencentDnsProvider 未配置 token，将以禁用状态运行。');\n    }\n  }\n\n  public async upsertRecord(options: UpsertDnsRecordInput): Promise<void> {\n    if (!this.enabled) {\n      this.logger.debug('DNS provider disabled，跳过 upsert。');\n      return;\n    }\n    const existing = await this.findRecord(options.domain, options.subdomain, options.type);\n    const lineId = options.lineId ?? existing?.line_id ?? this.defaultLineId;\n    const ttl = this.normalizeTtl(options.ttl ?? (typeof existing?.ttl === 'number' ? existing.ttl : undefined));\n\n    if (existing) {\n      if (existing.value === options.value && this.compareLine(existing, lineId) && this.compareTtl(existing, ttl)) {\n        this.logger.debug(`DNS 记录已存在且一致，跳过更新 ${options.subdomain}.${options.domain} ${options.type}`);\n        return;\n      }\n\n      await this.callApi('Record.Modify', {\n        domain: options.domain,\n        record_id: existing.id,\n        sub_domain: options.subdomain,\n        record_type: options.type,\n        value: options.value,\n        record_line_id: lineId,\n        ttl,\n      });\n      this.logger.info(`已更新 DNS 记录 ${options.subdomain}.${options.domain} ${options.type}`);\n      return;\n    }\n\n    await this.callApi('Record.Create', {\n      domain: options.domain,\n      sub_domain: options.subdomain,\n      record_type: options.type,\n      value: options.value,\n      record_line_id: lineId,\n      ttl,\n    });\n    this.logger.info(`已创建 DNS 记录 ${options.subdomain}.${options.domain} ${options.type}`);\n  }\n\n  public async deleteRecord(options: DeleteDnsRecordInput): Promise<void> {\n    if (!this.enabled) {\n      this.logger.debug('DNS provider disabled，跳过 delete。');\n      return;\n    }\n    const record = await this.findRecord(options.domain, options.subdomain, options.type, options.value);\n    if (!record) {\n      this.logger.debug(`未找到可删除的 DNS 记录 ${options.subdomain}.${options.domain} ${options.type}`);\n      return;\n    }\n\n    await this.callApi('Record.Delete', {\n      domain: options.domain,\n      record_id: record.id,\n    });\n    this.logger.info(`已删除 DNS 记录 ${options.subdomain}.${options.domain} ${options.type}`);\n  }\n\n  public async listRecords(options: ListDnsRecordsInput): Promise<DnsRecordSummary[]> {\n    if (!this.enabled) {\n      return [];\n    }\n    const records = await this.callApi<'records', TencentRecordInfo[]>(\n      'Record.List',\n      {\n        domain: options.domain,\n        sub_domain: options.subdomain,\n        record_type: options.type,\n      }\n    );\n    const list = Array.isArray(records.records) ? records.records : [];\n    return list.map((record) => this.toSummary(options.domain, record));\n  }\n\n  private toSummary(domain: string, record: TencentRecordInfo): DnsRecordSummary {\n    return {\n      id: String(record.id),\n      domain,\n      subdomain: record.name,\n      type: record.type as DnsRecordTypeValue,\n      value: record.value,\n      ttl: typeof record.ttl === 'number' ? record.ttl : Number.parseInt(record.ttl, 10),\n      line: record.line,\n      lineId: record.line_id,\n    };\n  }\n\n  private async findRecord(domain: string, subdomain: string, type: DnsRecordTypeValue, value?: string): Promise<TencentRecordInfo | undefined> {\n    if (!this.enabled) {\n      return undefined;\n    }\n    const response = await this.callApi<'records', TencentRecordInfo[]>(\n      'Record.List',\n      {\n        domain,\n        sub_domain: subdomain,\n        record_type: type,\n      }\n    );\n    const records = Array.isArray(response.records) ? response.records : [];\n    const normalizedValue = value?.trim().toLowerCase();\n    return records.find((record) => {\n      if (record.type?.toUpperCase() !== type.toUpperCase()) {\n        return false;\n      }\n      if (!normalizedValue) {\n        return true;\n      }\n      return String(record.value ?? '').trim().toLowerCase() === normalizedValue;\n    });\n  }\n\n  private compareLine(record: TencentRecordInfo, lineId: string): boolean {\n    return String(record.line_id ?? '').trim() === lineId.trim();\n  }\n\n  private compareTtl(record: TencentRecordInfo, ttl?: number): boolean {\n    if (ttl == null) {\n      return true;\n    }\n    const current = typeof record.ttl === 'number' ? record.ttl : Number.parseInt(record.ttl, 10);\n    return Number.isFinite(current) ? current === ttl : true;\n  }\n\n  private normalizeTtl(ttl?: number): number | undefined {\n    if (ttl == null) {\n      return undefined;\n    }\n    const value = Math.max(1, Math.trunc(ttl));\n    return Number.isFinite(value) ? value : undefined;\n  }\n\n  private async callApi<K extends string, R>(endpoint: string, payload: Record<string, string | number | undefined>): Promise<TencentApiResponse<{ [key in K]: R }>> {\n    if (!this.enabled) {\n      throw new Error('Tencent DNS provider 已禁用，无法调用 API。');\n    }\n    const url = new URL(`/` + endpoint.replace(/^\\//, ''), this.baseUrl);\n    const body = new URLSearchParams({\n      login_token: `${this.tokenId},${this.token}`,\n      format: 'json',\n      lang: 'en',\n      error_on_empty: 'no',\n    });\n\n    for (const [ key, value ] of Object.entries(payload)) {\n      if (value === undefined || value === null || value === '') {\n        continue;\n      }\n      body.append(key, String(value));\n    }\n\n    const bodyString = body.toString();\n\n    const responseText = await new Promise<string>((resolve, reject) => {\n      const request = httpsRequest({\n        method: 'POST',\n        protocol: url.protocol,\n        hostname: url.hostname,\n        port: url.port ? Number(url.port) : undefined,\n        path: url.pathname,\n        headers: {\n          'Content-Type': 'application/x-www-form-urlencoded',\n          'Content-Length': Buffer.byteLength(bodyString),\n          ...(this.userAgent ? { 'User-Agent': this.userAgent } : {}),\n        },\n        timeout: this.timeoutMs,\n      }, (res) => {\n        const chunks: Buffer[] = [];\n        res.on('data', (chunk) => chunks.push(Buffer.from(chunk)));\n        res.on('end', () => {\n          const data = Buffer.concat(chunks).toString('utf-8');\n          if (res.statusCode && res.statusCode >= 200 && res.statusCode < 300) {\n            resolve(data);\n          } else {\n            reject(new Error(`Tencent DNS API ${endpoint} HTTP ${res.statusCode ?? 0}: ${data}`));\n          }\n        });\n      });\n\n      request.on('error', (error) => reject(error));\n      request.on('timeout', () => {\n        request.destroy(new Error(`Tencent DNS API ${endpoint} request timed out after ${this.timeoutMs}ms`));\n      });\n      request.write(bodyString);\n      request.end();\n    });\n\n    let parsed: TencentApiResponse<{ [key in K]: R }>;\n    try {\n      parsed = JSON.parse(responseText) as TencentApiResponse<{ [key in K]: R }>;\n    } catch (error: unknown) {\n      throw new Error(`Tencent DNS API ${endpoint} 返回非法 JSON: ${(error as Error).message}`);\n    }\n\n    if (parsed.status?.code !== '1') {\n      throw new Error(`Tencent DNS API ${endpoint} 调用失败: ${parsed.status?.message ?? 'Unknown error'}`);\n    }\n\n    return parsed;\n  }\n\n  private normalizeString(value?: string | null): string | undefined {\n    if (typeof value !== 'string') {\n      return undefined;\n    }\n    const trimmed = value.trim();\n    return trimmed.length > 0 ? trimmed : undefined;\n  }\n\n  private normalizeTimeout(value?: number | string | null): number | undefined {\n    if (typeof value === 'number' && Number.isFinite(value) && value > 0) {\n      return Math.trunc(value);\n    }\n    if (typeof value === 'string') {\n      const parsed = Number(value.trim());\n      if (Number.isFinite(parsed) && parsed > 0) {\n        return Math.trunc(parsed);\n      }\n    }\n    return undefined;\n  }\n}\n"]}