feat(dns-providers): add provider-agnostic DNS provider form metadata and reusable UI for create/edit flows

ts/dns/manager.dns.ts

@@ -302,7 +302,9 @@ export class DnsManager {
 
   /**
    * Build an IConvenientDnsProvider that dispatches each ACME challenge to
-   * the right CloudflareDnsProvider based on the challenge's hostName.
+   * the right provider client (whichever provider type owns the parent zone),
+   * based on the challenge's hostName. Provider-agnostic — uses the IDnsProviderClient
+   * interface, so any registered provider implementation works.
    * Returned object plugs directly into smartacme's Dns01Handler.
    */
   public buildAcmeConvenientDnsProvider(): plugins.tsclass.network.IConvenientDnsProvider {

ts/dns/providers/cloudflare.provider.ts

@@ -27,14 +27,6 @@ export class CloudflareDnsProvider implements IDnsProviderClient {
     this.cfAccount = new plugins.cloudflare.CloudflareAccount(apiToken);
   }
 
-  /**
-   * Returns the underlying CloudflareAccount — used by ACME DNS-01
-   * to wrap into a smartacme Dns01Handler.
-   */
-  public getCloudflareAccount(): plugins.cloudflare.CloudflareAccount {
-    return this.cfAccount;
-  }
-
   public async testConnection(): Promise<IConnectionTestResult> {
     try {
       // Listing zones is the lightest-weight call that proves the token works.

ts/dns/providers/factory.ts

@@ -9,6 +9,21 @@ import { CloudflareDnsProvider } from './cloudflare.provider.js';
  * Instantiate a runtime DNS provider client from a stored DnsProviderDoc.
  *
  * @throws if the provider type is not supported.
+ *
+ * ## Adding a new provider (e.g. Route53)
+ *
+ * 1. **Type union** — extend `TDnsProviderType` in
+ *    `ts_interfaces/data/dns-provider.ts` (e.g. `'cloudflare' | 'route53'`).
+ * 2. **Credentials interface** — add `IRoute53Credentials` and append it to
+ *    the `TDnsProviderCredentials` discriminated union.
+ * 3. **Descriptor** — append a new entry to `dnsProviderTypeDescriptors` so
+ *    the OpsServer UI picks up the new type and renders the right credential
+ *    form fields automatically.
+ * 4. **Provider class** — create `ts/dns/providers/route53.provider.ts`
+ *    implementing `IDnsProviderClient`.
+ * 5. **Factory case** — add a new `case 'route53':` below. The
+ *    `_exhaustive: never` line will fail to compile until you do.
+ * 6. **Index** — re-export the new class from `ts/dns/providers/index.ts`.
  */
 export function createDnsProvider(
   type: TDnsProviderType,
@@ -24,6 +39,8 @@ export function createDnsProvider(
       return new CloudflareDnsProvider(credentials.apiToken);
     }
     default: {
+      // If you see a TypeScript error here after extending TDnsProviderType,
+      // add a `case` for the new type above. The `never` enforces exhaustiveness.
       const _exhaustive: never = type;
       throw new Error(`createDnsProvider: unsupported provider type: ${_exhaustive}`);
     }