@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/credential/index.d.ts

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

package/dist/credential/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("./schema"), exports);
+//# sourceMappingURL=index.js.map

package/dist/credential/index.js.map

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

package/dist/credential/schema/index.d.ts

@@ -0,0 +1,2 @@
+export * from './types';
+export * from './tables';

package/dist/credential/schema/index.js

@@ -0,0 +1,19 @@
+"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("./types"), exports);
+__exportStar(require("./tables"), exports);
+//# sourceMappingURL=index.js.map

package/dist/credential/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/credential/schema/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,2CAAyB","sourcesContent":["export * from './types';\nexport * from './tables';\n"]}

package/dist/credential/schema/tables.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Credential Schema - Pod RDF 表定义
+ */
+/**
+ * Credential - 凭据存储
+ *
+ * 存储位置: /settings/credentials.ttl
+ *
+ * RDF 示例:
+ * <#cred-001> a udfs:Credential ;
+ *     udfs:provider </settings/ai/providers.ttl#google> ;
+ *     udfs:service "ai" ;
+ *     udfs:status "active" ;
+ *     udfs:apiKey "sk-xxx" ;
+ *     udfs:label "Google AI" .
+ */
+export declare const Credential: import("@undefineds.co/drizzle-solid/dist/core/schema").PodTableWithColumns<import("@undefineds.co/drizzle-solid/dist/core/schema").ResolvedColumns<{
+    id: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, true, false>;
+    provider: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
+    service: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+    status: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+    apiKey: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+    baseUrl: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+    proxyUrl: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+    projectId: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+    organizationId: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+    label: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+    lastUsedAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, false, false>;
+    failCount: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"integer", null, false, false>;
+    rateLimitResetAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, false, false>;
+}>>;

package/dist/credential/schema/tables.js

@@ -0,0 +1,42 @@
+"use strict";
+/**
+ * Credential Schema - Pod RDF 表定义
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Credential = void 0;
+const drizzle_solid_1 = require("@undefineds.co/drizzle-solid");
+const vocab_1 = require("../../vocab");
+/**
+ * Credential - 凭据存储
+ *
+ * 存储位置: /settings/credentials.ttl
+ *
+ * RDF 示例:
+ * <#cred-001> a udfs:Credential ;
+ *     udfs:provider </settings/ai/providers.ttl#google> ;
+ *     udfs:service "ai" ;
+ *     udfs:status "active" ;
+ *     udfs:apiKey "sk-xxx" ;
+ *     udfs:label "Google AI" .
+ */
+exports.Credential = (0, drizzle_solid_1.podTable)('Credential', {
+    id: (0, drizzle_solid_1.string)('id').primaryKey(),
+    provider: (0, drizzle_solid_1.uri)('provider'),
+    service: (0, drizzle_solid_1.string)('service'),
+    status: (0, drizzle_solid_1.string)('status'),
+    apiKey: (0, drizzle_solid_1.string)('apiKey'),
+    baseUrl: (0, drizzle_solid_1.string)('baseUrl'),
+    proxyUrl: (0, drizzle_solid_1.string)('proxyUrl'),
+    projectId: (0, drizzle_solid_1.string)('projectId'),
+    organizationId: (0, drizzle_solid_1.string)('organizationId'),
+    label: (0, drizzle_solid_1.string)('label'),
+    lastUsedAt: (0, drizzle_solid_1.datetime)('lastUsedAt'),
+    failCount: (0, drizzle_solid_1.int)('failCount'),
+    rateLimitResetAt: (0, drizzle_solid_1.datetime)('rateLimitResetAt'),
+}, {
+    base: '/settings/credentials.ttl',
+    type: vocab_1.UDFS.Credential,
+    namespace: vocab_1.UDFS_NAMESPACE,
+    subjectTemplate: '#{id}',
+});
+//# sourceMappingURL=tables.js.map

package/dist/credential/schema/tables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.js","sourceRoot":"","sources":["../../../src/credential/schema/tables.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,gEAAoF;AACpF,uCAAmD;AAEnD;;;;;;;;;;;;GAYG;AACU,QAAA,UAAU,GAAG,IAAA,wBAAQ,EAChC,YAAY,EACZ;IACE,EAAE,EAAE,IAAA,sBAAM,EAAC,IAAI,CAAC,CAAC,UAAU,EAAE;IAC7B,QAAQ,EAAE,IAAA,mBAAG,EAAC,UAAU,CAAC;IACzB,OAAO,EAAE,IAAA,sBAAM,EAAC,SAAS,CAAC;IAC1B,MAAM,EAAE,IAAA,sBAAM,EAAC,QAAQ,CAAC;IACxB,MAAM,EAAE,IAAA,sBAAM,EAAC,QAAQ,CAAC;IACxB,OAAO,EAAE,IAAA,sBAAM,EAAC,SAAS,CAAC;IAC1B,QAAQ,EAAE,IAAA,sBAAM,EAAC,UAAU,CAAC;IAC5B,SAAS,EAAE,IAAA,sBAAM,EAAC,WAAW,CAAC;IAC9B,cAAc,EAAE,IAAA,sBAAM,EAAC,gBAAgB,CAAC;IACxC,KAAK,EAAE,IAAA,sBAAM,EAAC,OAAO,CAAC;IACtB,UAAU,EAAE,IAAA,wBAAQ,EAAC,YAAY,CAAC;IAClC,SAAS,EAAE,IAAA,mBAAG,EAAC,WAAW,CAAC;IAC3B,gBAAgB,EAAE,IAAA,wBAAQ,EAAC,kBAAkB,CAAC;CAC/C,EACD;IACE,IAAI,EAAE,2BAA2B;IACjC,IAAI,EAAE,YAAI,CAAC,UAAU;IACrB,SAAS,EAAE,sBAAc;IACzB,eAAe,EAAE,OAAO;CACzB,CACF,CAAC","sourcesContent":["/**\n * Credential Schema - Pod RDF 表定义\n */\n\nimport { podTable, string, int, datetime, uri } from '@undefineds.co/drizzle-solid';\nimport { UDFS, UDFS_NAMESPACE } from '../../vocab';\n\n/**\n * Credential - 凭据存储\n *\n * 存储位置: /settings/credentials.ttl\n *\n * RDF 示例:\n * <#cred-001> a udfs:Credential ;\n *     udfs:provider </settings/ai/providers.ttl#google> ;\n *     udfs:service \"ai\" ;\n *     udfs:status \"active\" ;\n *     udfs:apiKey \"sk-xxx\" ;\n *     udfs:label \"Google AI\" .\n */\nexport const Credential = podTable(\n  'Credential',\n  {\n    id: string('id').primaryKey(),\n    provider: uri('provider'),\n    service: string('service'),\n    status: string('status'),\n    apiKey: string('apiKey'),\n    baseUrl: string('baseUrl'),\n    proxyUrl: string('proxyUrl'),\n    projectId: string('projectId'),\n    organizationId: string('organizationId'),\n    label: string('label'),\n    lastUsedAt: datetime('lastUsedAt'),\n    failCount: int('failCount'),\n    rateLimitResetAt: datetime('rateLimitResetAt'),\n  },\n  {\n    base: '/settings/credentials.ttl',\n    type: UDFS.Credential,\n    namespace: UDFS_NAMESPACE,\n    subjectTemplate: '#{id}',\n  },\n);\n\n"]}

package/dist/credential/schema/types.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Credential Schema 类型定义
+ */
+/**
+ * 服务类型
+ */
+export declare enum ServiceType {
+    AI = "ai",
+    STORAGE = "storage",
+    DNS = "dns"
+}
+/**
+ * 凭据状态
+ */
+export declare enum CredentialStatus {
+    ACTIVE = "active",
+    INACTIVE = "inactive",
+    RATE_LIMITED = "rate_limited",
+    EXPIRED = "expired"
+}

package/dist/credential/schema/types.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * Credential Schema 类型定义
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CredentialStatus = exports.ServiceType = void 0;
+/**
+ * 服务类型
+ */
+var ServiceType;
+(function (ServiceType) {
+    ServiceType["AI"] = "ai";
+    ServiceType["STORAGE"] = "storage";
+    ServiceType["DNS"] = "dns";
+})(ServiceType || (exports.ServiceType = ServiceType = {}));
+/**
+ * 凭据状态
+ */
+var CredentialStatus;
+(function (CredentialStatus) {
+    CredentialStatus["ACTIVE"] = "active";
+    CredentialStatus["INACTIVE"] = "inactive";
+    CredentialStatus["RATE_LIMITED"] = "rate_limited";
+    CredentialStatus["EXPIRED"] = "expired";
+})(CredentialStatus || (exports.CredentialStatus = CredentialStatus = {}));
+//# sourceMappingURL=types.js.map

package/dist/credential/schema/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/credential/schema/types.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH;;GAEG;AACH,IAAY,WAIX;AAJD,WAAY,WAAW;IACrB,wBAAS,CAAA;IACT,kCAAmB,CAAA;IACnB,0BAAW,CAAA;AACb,CAAC,EAJW,WAAW,2BAAX,WAAW,QAItB;AAED;;GAEG;AACH,IAAY,gBAKX;AALD,WAAY,gBAAgB;IAC1B,qCAAiB,CAAA;IACjB,yCAAqB,CAAA;IACrB,iDAA6B,CAAA;IAC7B,uCAAmB,CAAA;AACrB,CAAC,EALW,gBAAgB,gCAAhB,gBAAgB,QAK3B","sourcesContent":["/**\n * Credential Schema 类型定义\n */\n\n/**\n * 服务类型\n */\nexport enum ServiceType {\n  AI = 'ai',\n  STORAGE = 'storage',\n  DNS = 'dns',\n}\n\n/**\n * 凭据状态\n */\nexport enum CredentialStatus {\n  ACTIVE = 'active',\n  INACTIVE = 'inactive',\n  RATE_LIMITED = 'rate_limited',\n  EXPIRED = 'expired',\n}\n"]}

package/dist/dns/DnsProvider.d.ts

@@ -0,0 +1,46 @@
+export type DnsRecordTypeValue = 'A' | 'AAAA' | 'CNAME' | 'TXT';
+export type DnsRecordType = DnsRecordTypeValue;
+export interface UpsertDnsRecordInput {
+    /** 根域名，例如 `example.com`。 */
+    domain: string;
+    /** 子域名（相对形式），根域使用 `@`。 */
+    subdomain: string;
+    type: DnsRecordTypeValue;
+    value: string;
+    /** TTL 秒数，供应商若不支持将退回默认值。 */
+    ttl?: number;
+    /** DNS 线路 ID，未指定时使用默认线路。 */
+    lineId?: string;
+}
+export interface DeleteDnsRecordInput {
+    domain: string;
+    subdomain: string;
+    type: DnsRecordTypeValue;
+    /**
+     * 若提供 value，仅当记录值匹配时才删除；
+     * 否则会删除第一条匹配类型的记录。
+     */
+    value?: string;
+}
+export interface DnsProvider {
+    upsertRecord(options: UpsertDnsRecordInput): Promise<void>;
+    deleteRecord(options: DeleteDnsRecordInput): Promise<void>;
+}
+export interface DnsRecordSummary {
+    id: string;
+    domain: string;
+    subdomain: string;
+    type: DnsRecordTypeValue;
+    value: string;
+    ttl: number;
+    line: string;
+    lineId: string;
+}
+export interface ListDnsRecordsInput {
+    domain: string;
+    subdomain?: string;
+    type?: DnsRecordTypeValue;
+}
+export interface ListableDnsProvider extends DnsProvider {
+    listRecords(options: ListDnsRecordsInput): Promise<DnsRecordSummary[]>;
+}

package/dist/dns/DnsProvider.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=DnsProvider.js.map

package/dist/dns/DnsProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DnsProvider.js","sourceRoot":"","sources":["../../src/dns/DnsProvider.ts"],"names":[],"mappings":"","sourcesContent":["export type DnsRecordTypeValue = 'A' | 'AAAA' | 'CNAME' | 'TXT';\nexport type DnsRecordType = DnsRecordTypeValue;\n\nexport interface UpsertDnsRecordInput {\n  /** 根域名，例如 `example.com`。 */\n  domain: string;\n  /** 子域名（相对形式），根域使用 `@`。 */\n  subdomain: string;\n  type: DnsRecordTypeValue;\n  value: string;\n  /** TTL 秒数，供应商若不支持将退回默认值。 */\n  ttl?: number;\n  /** DNS 线路 ID，未指定时使用默认线路。 */\n  lineId?: string;\n}\n\nexport interface DeleteDnsRecordInput {\n  domain: string;\n  subdomain: string;\n  type: DnsRecordTypeValue;\n  /**\n   * 若提供 value，仅当记录值匹配时才删除；\n   * 否则会删除第一条匹配类型的记录。\n   */\n  value?: string;\n}\n\nexport interface DnsProvider {\n  upsertRecord(options: UpsertDnsRecordInput): Promise<void>;\n  deleteRecord(options: DeleteDnsRecordInput): Promise<void>;\n}\n\nexport interface DnsRecordSummary {\n  id: string;\n  domain: string;\n  subdomain: string;\n  type: DnsRecordTypeValue;\n  value: string;\n  ttl: number;\n  line: string;\n  lineId: string;\n}\n\nexport interface ListDnsRecordsInput {\n  domain: string;\n  subdomain?: string;\n  type?: DnsRecordTypeValue;\n}\n\nexport interface ListableDnsProvider extends DnsProvider {\n  listRecords(options: ListDnsRecordsInput): Promise<DnsRecordSummary[]>;\n}\n"]}

package/dist/dns/DnsProvider.jsonld

@@ -0,0 +1,161 @@
+{
+  "@context": [
+    "https://linkedsoftwaredependencies.org/bundles/npm/@undefineds.co/xpod/^0.0.0/components/context.jsonld"
+  ],
+  "@id": "npmd:@undefineds.co/xpod",
+  "components": [
+    {
+      "@id": "undefineds:dist/dns/DnsProvider.jsonld#DnsProvider",
+      "@type": "AbstractClass",
+      "requireElement": "DnsProvider",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/dns/DnsProvider.jsonld#DnsProvider__member_upsertRecord",
+          "memberFieldName": "upsertRecord"
+        },
+        {
+          "@id": "undefineds:dist/dns/DnsProvider.jsonld#DnsProvider__member_deleteRecord",
+          "memberFieldName": "deleteRecord"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/dns/DnsProvider.jsonld#ListDnsRecordsInput",
+      "@type": "AbstractClass",
+      "requireElement": "ListDnsRecordsInput",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/dns/DnsProvider.jsonld#ListDnsRecordsInput__member_domain",
+          "memberFieldName": "domain"
+        },
+        {
+          "@id": "undefineds:dist/dns/DnsProvider.jsonld#ListDnsRecordsInput__member_subdomain",
+          "memberFieldName": "subdomain"
+        },
+        {
+          "@id": "undefineds:dist/dns/DnsProvider.jsonld#ListDnsRecordsInput__member_type",
+          "memberFieldName": "type"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/dns/DnsProvider.jsonld#ListableDnsProvider",
+      "@type": "AbstractClass",
+      "requireElement": "ListableDnsProvider",
+      "extends": [
+        "undefineds:dist/dns/DnsProvider.jsonld#DnsProvider"
+      ],
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/dns/DnsProvider.jsonld#ListableDnsProvider__member_listRecords",
+          "memberFieldName": "listRecords"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/dns/DnsProvider.jsonld#DeleteDnsRecordInput",
+      "@type": "AbstractClass",
+      "requireElement": "DeleteDnsRecordInput",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/dns/DnsProvider.jsonld#DeleteDnsRecordInput__member_domain",
+          "memberFieldName": "domain"
+        },
+        {
+          "@id": "undefineds:dist/dns/DnsProvider.jsonld#DeleteDnsRecordInput__member_subdomain",
+          "memberFieldName": "subdomain"
+        },
+        {
+          "@id": "undefineds:dist/dns/DnsProvider.jsonld#DeleteDnsRecordInput__member_type",
+          "memberFieldName": "type"
+        },
+        {
+          "@id": "undefineds:dist/dns/DnsProvider.jsonld#DeleteDnsRecordInput__member_value",
+          "memberFieldName": "value"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/dns/DnsProvider.jsonld#DnsRecordSummary",
+      "@type": "AbstractClass",
+      "requireElement": "DnsRecordSummary",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/dns/DnsProvider.jsonld#DnsRecordSummary__member_id",
+          "memberFieldName": "id"
+        },
+        {
+          "@id": "undefineds:dist/dns/DnsProvider.jsonld#DnsRecordSummary__member_domain",
+          "memberFieldName": "domain"
+        },
+        {
+          "@id": "undefineds:dist/dns/DnsProvider.jsonld#DnsRecordSummary__member_subdomain",
+          "memberFieldName": "subdomain"
+        },
+        {
+          "@id": "undefineds:dist/dns/DnsProvider.jsonld#DnsRecordSummary__member_type",
+          "memberFieldName": "type"
+        },
+        {
+          "@id": "undefineds:dist/dns/DnsProvider.jsonld#DnsRecordSummary__member_value",
+          "memberFieldName": "value"
+        },
+        {
+          "@id": "undefineds:dist/dns/DnsProvider.jsonld#DnsRecordSummary__member_ttl",
+          "memberFieldName": "ttl"
+        },
+        {
+          "@id": "undefineds:dist/dns/DnsProvider.jsonld#DnsRecordSummary__member_line",
+          "memberFieldName": "line"
+        },
+        {
+          "@id": "undefineds:dist/dns/DnsProvider.jsonld#DnsRecordSummary__member_lineId",
+          "memberFieldName": "lineId"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/dns/DnsProvider.jsonld#UpsertDnsRecordInput",
+      "@type": "AbstractClass",
+      "requireElement": "UpsertDnsRecordInput",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/dns/DnsProvider.jsonld#UpsertDnsRecordInput__member_domain",
+          "memberFieldName": "domain"
+        },
+        {
+          "@id": "undefineds:dist/dns/DnsProvider.jsonld#UpsertDnsRecordInput__member_subdomain",
+          "memberFieldName": "subdomain"
+        },
+        {
+          "@id": "undefineds:dist/dns/DnsProvider.jsonld#UpsertDnsRecordInput__member_type",
+          "memberFieldName": "type"
+        },
+        {
+          "@id": "undefineds:dist/dns/DnsProvider.jsonld#UpsertDnsRecordInput__member_value",
+          "memberFieldName": "value"
+        },
+        {
+          "@id": "undefineds:dist/dns/DnsProvider.jsonld#UpsertDnsRecordInput__member_ttl",
+          "memberFieldName": "ttl"
+        },
+        {
+          "@id": "undefineds:dist/dns/DnsProvider.jsonld#UpsertDnsRecordInput__member_lineId",
+          "memberFieldName": "lineId"
+        }
+      ],
+      "constructorArguments": []
+    }
+  ]
+}

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

@@ -0,0 +1,51 @@
+import type { DeleteDnsRecordInput, DnsRecordSummary, ListDnsRecordsInput, ListableDnsProvider, UpsertDnsRecordInput } from '../DnsProvider';
+export interface CloudflareDnsProviderOptions {
+    /** Cloudflare API Token（推荐使用受限 Token） */
+    apiToken?: string | null;
+    /** Zone ID，如果不提供会自动查找 */
+    zoneId?: string | null;
+    /** API 根地址，默认为 `https://api.cloudflare.com/client/v4` */
+    baseUrl?: string | null;
+    /** HTTP 请求超时毫秒数，默认 10s */
+    timeoutMs?: number | string | null;
+}
+/**
+ * 基于 Cloudflare API v4 的 DNS 提供方实现。
+ */
+export declare class CloudflareDnsProvider implements ListableDnsProvider {
+    private readonly logger;
+    private readonly apiToken;
+    private readonly baseUrl;
+    private readonly timeoutMs;
+    private readonly enabled;
+    private readonly configuredZoneId?;
+    /** 缓存 domain -> zoneId 的映射 */
+    private readonly zoneIdCache;
+    constructor(options: CloudflareDnsProviderOptions);
+    upsertRecord(options: UpsertDnsRecordInput): Promise<void>;
+    deleteRecord(options: DeleteDnsRecordInput): Promise<void>;
+    listRecords(options: ListDnsRecordsInput): Promise<DnsRecordSummary[]>;
+    /**
+     * 获取 Zone ID，优先使用配置的，否则自动查找
+     * 支持从子域名向上递归查找 Zone
+     */
+    private getZoneId;
+    /**
+     * 查找现有 DNS 记录
+     */
+    private findRecord;
+    /**
+     * 调用 Cloudflare API
+     */
+    private callApi;
+    /**
+     * 构建完整域名
+     */
+    private buildFullName;
+    /**
+     * 转换为通用记录摘要
+     */
+    private toRecordSummary;
+    private normalizeString;
+    private normalizeTimeout;
+}