@serve.zone/dcrouter 2.12.4 → 5.0.3

package/dist_ts/ts/classes.dcrouter.d.ts

@@ -1,238 +0,0 @@
-import * as plugins from './plugins.js';
-import { UnifiedEmailServer, type IUnifiedEmailServerOptions } from './mail/routing/classes.unified.email.server.js';
-import type { IEmailRoute } from './mail/routing/interfaces.js';
-import { StorageManager, type IStorageConfig } from './storage/index.js';
-import { OpsServer } from './opsserver/index.js';
-export interface IDcRouterOptions {
-    /**
-     * Direct SmartProxy configuration - gives full control over HTTP/HTTPS and TCP/SNI traffic
-     * This is the preferred way to configure HTTP/HTTPS and general TCP/SNI traffic
-     */
-    smartProxyConfig?: plugins.smartproxy.ISmartProxyOptions;
-    /**
-     * Email server configuration
-     * This enables all email handling with pattern-based routing
-     */
-    emailConfig?: IUnifiedEmailServerOptions;
-    /**
-     * Custom email port configuration
-     * Allows configuring specific ports for email handling
-     * This overrides the default port mapping in the emailConfig
-     */
-    emailPortConfig?: {
-        /** External to internal port mapping */
-        portMapping?: Record<number, number>;
-        /** Custom port configuration for specific ports */
-        portSettings?: Record<number, any>;
-        /** Path to store received emails */
-        receivedEmailsPath?: string;
-    };
-    /** TLS/certificate configuration */
-    tls?: {
-        /** Contact email for ACME certificates */
-        contactEmail: string;
-        /** Domain for main certificate */
-        domain?: string;
-        /** Path to certificate file (if not using auto-provisioning) */
-        certPath?: string;
-        /** Path to key file (if not using auto-provisioning) */
-        keyPath?: string;
-        /** Path to CA certificate file (for custom CAs) */
-        caPath?: string;
-    };
-    /**
-     * The nameserver domains (e.g., ['ns1.example.com', 'ns2.example.com'])
-     * These will automatically get A records pointing to publicIp or proxyIps[0]
-     * These are what go in the NS records for ALL domains in dnsScopes
-     */
-    dnsNsDomains?: string[];
-    /**
-     * Domains this DNS server is authoritative for (e.g., ['example.com', 'mail.example.org'])
-     * NS records will be auto-generated for these domains
-     * Any DNS record outside these scopes will trigger a warning
-     * Email domains with `internal-dns` mode must be included here
-     */
-    dnsScopes?: string[];
-    /**
-     * IPs of proxies that forward traffic to your server (optional)
-     * When defined AND useIngressProxy is true, A records with server IP are replaced with proxy IPs
-     * If not defined or empty, all A records use the real server IP
-     * Helps hide real server IP for security/privacy
-     */
-    proxyIps?: string[];
-    /**
-     * Public IP address for nameserver A records (required if proxyIps not set)
-     * This is the IP that will be used for the nameserver domains (dnsNsDomains)
-     * If proxyIps is set, the first proxy IP will be used instead
-     */
-    publicIp?: string;
-    /**
-     * DNS records to register
-     * Must be within the defined dnsScopes (or receive warning)
-     * Only need A, CNAME, TXT, MX records (NS records auto-generated, SOA handled by smartdns)
-     * Can use `useIngressProxy: false` to expose real server IP (defaults to true)
-     */
-    dnsRecords?: Array<{
-        name: string;
-        type: 'A' | 'AAAA' | 'CNAME' | 'MX' | 'TXT' | 'NS' | 'SOA';
-        value: string;
-        ttl?: number;
-        useIngressProxy?: boolean;
-    }>;
-    /** DNS challenge configuration for ACME (optional) */
-    dnsChallenge?: {
-        /** Cloudflare API key for DNS challenges */
-        cloudflareApiKey?: string;
-    };
-    /** Storage configuration */
-    storage?: IStorageConfig;
-}
-/**
- * DcRouter can be run on ingress and egress to and from a datacenter site.
- */
-/**
- * Context passed to HTTP routing rules
- */
-/**
- * Context passed to port proxy (SmartProxy) routing rules
- */
-export interface PortProxyRuleContext {
-    proxy: plugins.smartproxy.SmartProxy;
-    routes: plugins.smartproxy.IRouteConfig[];
-}
-export declare class DcRouter {
-    options: IDcRouterOptions;
-    smartProxy?: plugins.smartproxy.SmartProxy;
-    dnsServer?: plugins.smartdns.dnsServerMod.DnsServer;
-    emailServer?: UnifiedEmailServer;
-    storageManager: StorageManager;
-    opsServer: OpsServer;
-    typedrouter: plugins.typedrequest.TypedRouter;
-    private qenv;
-    constructor(optionsArg: IDcRouterOptions);
-    start(): Promise<void>;
-    /**
-     * Log comprehensive startup summary
-     */
-    private logStartupSummary;
-    /**
-     * Set up SmartProxy with direct configuration and automatic email routes
-     */
-    private setupSmartProxy;
-    /**
-     * Generate SmartProxy routes for email configuration
-     */
-    private generateEmailRoutes;
-    /**
-     * Generate SmartProxy routes for DNS configuration
-     */
-    private generateDnsRoutes;
-    /**
-     * Check if a domain matches a pattern (including wildcard support)
-     * @param domain The domain to check
-     * @param pattern The pattern to match against (e.g., "*.example.com")
-     * @returns Whether the domain matches the pattern
-     */
-    private isDomainMatch;
-    stop(): Promise<void>;
-    /**
-     * Update SmartProxy configuration
-     * @param config New SmartProxy configuration
-     */
-    updateSmartProxyConfig(config: plugins.smartproxy.ISmartProxyOptions): Promise<void>;
-    /**
-     * Set up unified email handling with pattern-based routing
-     * This implements the consolidated emailConfig approach
-     */
-    private setupUnifiedEmailHandling;
-    /**
-     * Update the unified email configuration
-     * @param config New email configuration
-     */
-    updateEmailConfig(config: IUnifiedEmailServerOptions): Promise<void>;
-    /**
-     * Stop all unified email components
-     */
-    private stopUnifiedEmailComponents;
-    /**
-     * Update domain rules for email routing
-     * @param rules New domain rules to apply
-     */
-    updateEmailRoutes(routes: IEmailRoute[]): Promise<void>;
-    /**
-     * Get statistics from all components
-     */
-    getStats(): any;
-    /**
-     * Configure MTA for email handling with custom port and storage settings
-     * @param config Configuration for the MTA service
-     */
-    configureEmailMta(config: {
-        internalPort: number;
-        host?: string;
-        secure?: boolean;
-        storagePath?: string;
-        portMapping?: Record<number, number>;
-    }): Promise<boolean>;
-    /**
-     * Register DNS records with the DNS server
-     * @param records Array of DNS records to register
-     */
-    private registerDnsRecords;
-    /**
-     * Parse DNS record data based on record type
-     * @param type DNS record type
-     * @param value DNS record value
-     * @returns Parsed data for the DNS response
-     */
-    private parseDnsRecordData;
-    /**
-     * Set up DNS server with socket handler for DoH
-     */
-    private setupDnsWithSocketHandler;
-    /**
-     * Create DNS socket handler for DoH
-     */
-    private createDnsSocketHandler;
-    /**
-     * Validate DNS configuration
-     */
-    private validateDnsConfiguration;
-    /**
-     * Generate email DNS records for domains with internal-dns mode
-     */
-    private generateEmailDnsRecords;
-    /**
-     * Load DKIM records from JSON files
-     * Reads all *.dkimrecord.json files from the DNS records directory
-     */
-    private loadDkimRecords;
-    /**
-     * Initialize DKIM keys for all configured email domains
-     * This ensures DKIM records are available immediately at startup
-     */
-    private initializeDkimForEmailDomains;
-    /**
-     * Generate authoritative DNS records (NS only) for all domains in dnsScopes
-     * SOA records are now automatically generated by smartdns with primaryNameserver setting
-     */
-    private generateAuthoritativeRecords;
-    /**
-     * Extract the base domain from a DNS record name
-     */
-    private extractDomain;
-    /**
-     * Apply proxy IP replacement logic to DNS records
-     */
-    private applyProxyIpReplacement;
-    /**
-     * Detect the server's public IP address
-     */
-    private detectServerPublicIp;
-    /**
-     * Create mail socket handler for email traffic
-     */
-    private createMailSocketHandler;
-}
-export type { IUnifiedEmailServerOptions };
-export default DcRouter;