@serve.zone/dcrouter 2.12.4

package/dist_ts/storage/classes.storagemanager.js

@@ -0,0 +1,341 @@
+import * as plugins from '../plugins.js';
+import { logger } from '../logger.js';
+// Promisify filesystem operations
+const readFile = plugins.util.promisify(plugins.fs.readFile);
+const writeFile = plugins.util.promisify(plugins.fs.writeFile);
+const unlink = plugins.util.promisify(plugins.fs.unlink);
+const rename = plugins.util.promisify(plugins.fs.rename);
+const readdir = plugins.util.promisify(plugins.fs.readdir);
+/**
+ * Central storage manager for DcRouter
+ * Provides unified key-value storage with multiple backend support
+ */
+export class StorageManager {
+    constructor(config) {
+        this.memoryStore = new Map();
+        this.config = config || {};
+        // Check if both fsPath and custom functions are provided
+        if (config?.fsPath && (config?.readFunction || config?.writeFunction)) {
+            console.warn('⚠️  WARNING: Both fsPath and custom read/write functions are configured.\n' +
+                '   Using custom read/write functions. fsPath will be ignored.');
+        }
+        // Determine backend based on configuration
+        if (config?.readFunction && config?.writeFunction) {
+            this.backend = 'custom';
+        }
+        else if (config?.fsPath) {
+            // Set up internal read/write functions for filesystem
+            this.backend = 'custom'; // Use custom backend with internal functions
+            this.fsBasePath = plugins.path.resolve(config.fsPath);
+            this.ensureDirectory(this.fsBasePath);
+            // Set up internal filesystem read/write functions
+            this.config.readFunction = async (key) => {
+                return this.fsRead(key);
+            };
+            this.config.writeFunction = async (key, value) => {
+                await this.fsWrite(key, value);
+            };
+        }
+        else {
+            this.backend = 'memory';
+            this.showMemoryWarning();
+        }
+        logger.log('info', `StorageManager initialized with ${this.backend} backend`);
+    }
+    /**
+     * Show warning when using memory backend
+     */
+    showMemoryWarning() {
+        console.warn('⚠️  WARNING: StorageManager is using in-memory storage.\n' +
+            '   Data will be lost when the process restarts.\n' +
+            '   Configure storage.fsPath or storage functions for persistence.');
+    }
+    /**
+     * Ensure directory exists for filesystem backend
+     */
+    async ensureDirectory(dirPath) {
+        try {
+            await plugins.smartfile.fs.ensureDir(dirPath);
+        }
+        catch (error) {
+            logger.log('error', `Failed to create storage directory: ${error.message}`);
+            throw error;
+        }
+    }
+    /**
+     * Validate and sanitize storage key
+     */
+    validateKey(key) {
+        if (!key || typeof key !== 'string') {
+            throw new Error('Storage key must be a non-empty string');
+        }
+        // Ensure key starts with /
+        if (!key.startsWith('/')) {
+            key = '/' + key;
+        }
+        // Remove any dangerous path elements
+        key = key.replace(/\.\./g, '').replace(/\/+/g, '/');
+        return key;
+    }
+    /**
+     * Convert key to filesystem path
+     */
+    keyToPath(key) {
+        if (!this.fsBasePath) {
+            throw new Error('Filesystem base path not configured');
+        }
+        // Remove leading slash and convert to path
+        const relativePath = key.substring(1);
+        return plugins.path.join(this.fsBasePath, relativePath);
+    }
+    /**
+     * Internal filesystem read function
+     */
+    async fsRead(key) {
+        const filePath = this.keyToPath(key);
+        try {
+            const content = await readFile(filePath, 'utf8');
+            return content;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return null;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Internal filesystem write function
+     */
+    async fsWrite(key, value) {
+        const filePath = this.keyToPath(key);
+        const dir = plugins.path.dirname(filePath);
+        // Ensure directory exists
+        await plugins.smartfile.fs.ensureDir(dir);
+        // Write atomically with temp file
+        const tempPath = `${filePath}.tmp`;
+        await writeFile(tempPath, value, 'utf8');
+        await rename(tempPath, filePath);
+    }
+    /**
+     * Get value by key
+     */
+    async get(key) {
+        key = this.validateKey(key);
+        try {
+            switch (this.backend) {
+                case 'custom': {
+                    if (!this.config.readFunction) {
+                        throw new Error('Read function not configured');
+                    }
+                    try {
+                        return await this.config.readFunction(key);
+                    }
+                    catch (error) {
+                        // Assume null if read fails (key doesn't exist)
+                        return null;
+                    }
+                }
+                case 'memory': {
+                    return this.memoryStore.get(key) || null;
+                }
+                default:
+                    throw new Error(`Unknown backend: ${this.backend}`);
+            }
+        }
+        catch (error) {
+            logger.log('error', `Storage get error for key ${key}: ${error.message}`);
+            throw error;
+        }
+    }
+    /**
+     * Set value by key
+     */
+    async set(key, value) {
+        key = this.validateKey(key);
+        if (typeof value !== 'string') {
+            throw new Error('Storage value must be a string');
+        }
+        try {
+            switch (this.backend) {
+                case 'filesystem': {
+                    const filePath = this.keyToPath(key);
+                    const dirPath = plugins.path.dirname(filePath);
+                    // Ensure directory exists
+                    await plugins.smartfile.fs.ensureDir(dirPath);
+                    // Write atomically
+                    const tempPath = filePath + '.tmp';
+                    await writeFile(tempPath, value, 'utf8');
+                    await rename(tempPath, filePath);
+                    break;
+                }
+                case 'custom': {
+                    if (!this.config.writeFunction) {
+                        throw new Error('Write function not configured');
+                    }
+                    await this.config.writeFunction(key, value);
+                    break;
+                }
+                case 'memory': {
+                    this.memoryStore.set(key, value);
+                    break;
+                }
+                default:
+                    throw new Error(`Unknown backend: ${this.backend}`);
+            }
+        }
+        catch (error) {
+            logger.log('error', `Storage set error for key ${key}: ${error.message}`);
+            throw error;
+        }
+    }
+    /**
+     * Delete value by key
+     */
+    async delete(key) {
+        key = this.validateKey(key);
+        try {
+            switch (this.backend) {
+                case 'filesystem': {
+                    const filePath = this.keyToPath(key);
+                    try {
+                        await unlink(filePath);
+                    }
+                    catch (error) {
+                        if (error.code !== 'ENOENT') {
+                            throw error;
+                        }
+                    }
+                    break;
+                }
+                case 'custom': {
+                    // Try to delete by setting empty value
+                    if (this.config.writeFunction) {
+                        await this.config.writeFunction(key, '');
+                    }
+                    break;
+                }
+                case 'memory': {
+                    this.memoryStore.delete(key);
+                    break;
+                }
+                default:
+                    throw new Error(`Unknown backend: ${this.backend}`);
+            }
+        }
+        catch (error) {
+            logger.log('error', `Storage delete error for key ${key}: ${error.message}`);
+            throw error;
+        }
+    }
+    /**
+     * List keys by prefix
+     */
+    async list(prefix) {
+        prefix = prefix ? this.validateKey(prefix) : '/';
+        try {
+            switch (this.backend) {
+                case 'custom': {
+                    // If we have fsBasePath, this is actually filesystem backend
+                    if (this.fsBasePath) {
+                        const basePath = this.keyToPath(prefix);
+                        const keys = [];
+                        const walkDir = async (dir, baseDir) => {
+                            try {
+                                const entries = await readdir(dir, { withFileTypes: true });
+                                for (const entry of entries) {
+                                    const fullPath = plugins.path.join(dir, entry.name);
+                                    if (entry.isDirectory()) {
+                                        await walkDir(fullPath, baseDir);
+                                    }
+                                    else if (entry.isFile()) {
+                                        // Convert path back to key
+                                        const relativePath = plugins.path.relative(this.fsBasePath, fullPath);
+                                        const key = '/' + relativePath.replace(/\\/g, '/');
+                                        if (key.startsWith(prefix)) {
+                                            keys.push(key);
+                                        }
+                                    }
+                                }
+                            }
+                            catch (error) {
+                                if (error.code !== 'ENOENT') {
+                                    throw error;
+                                }
+                            }
+                        };
+                        await walkDir(basePath, basePath);
+                        return keys.sort();
+                    }
+                    else {
+                        // True custom backends need to implement their own listing
+                        logger.log('warn', 'List operation not supported for custom backend');
+                        return [];
+                    }
+                }
+                case 'memory': {
+                    const keys = [];
+                    for (const key of this.memoryStore.keys()) {
+                        if (key.startsWith(prefix)) {
+                            keys.push(key);
+                        }
+                    }
+                    return keys.sort();
+                }
+                default:
+                    throw new Error(`Unknown backend: ${this.backend}`);
+            }
+        }
+        catch (error) {
+            logger.log('error', `Storage list error for prefix ${prefix}: ${error.message}`);
+            throw error;
+        }
+    }
+    /**
+     * Check if key exists
+     */
+    async exists(key) {
+        key = this.validateKey(key);
+        try {
+            const value = await this.get(key);
+            return value !== null;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    /**
+     * Get storage backend type
+     */
+    getBackend() {
+        // If we're using custom backend with fsBasePath, report it as filesystem
+        if (this.backend === 'custom' && this.fsBasePath) {
+            return 'filesystem';
+        }
+        return this.backend;
+    }
+    /**
+     * JSON helper: Get and parse JSON value
+     */
+    async getJSON(key) {
+        const value = await this.get(key);
+        if (value === null) {
+            return null;
+        }
+        try {
+            return JSON.parse(value);
+        }
+        catch (error) {
+            logger.log('error', `Failed to parse JSON for key ${key}: ${error.message}`);
+            throw error;
+        }
+    }
+    /**
+     * JSON helper: Set value as JSON
+     */
+    async setJSON(key, value) {
+        const jsonString = JSON.stringify(value, null, 2);
+        await this.set(key, jsonString);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5zdG9yYWdlbWFuYWdlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL3N0b3JhZ2UvY2xhc3Nlcy5zdG9yYWdlbWFuYWdlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGVBQWUsQ0FBQztBQUN6QyxPQUFPLEVBQUUsTUFBTSxFQUFFLE1BQU0sY0FBYyxDQUFDO0FBRXRDLGtDQUFrQztBQUNsQyxNQUFNLFFBQVEsR0FBRyxPQUFPLENBQUMsSUFBSSxDQUFDLFNBQVMsQ0FBQyxPQUFPLENBQUMsRUFBRSxDQUFDLFFBQVEsQ0FBQyxDQUFDO0FBQzdELE1BQU0sU0FBUyxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsU0FBUyxDQUFDLE9BQU8sQ0FBQyxFQUFFLENBQUMsU0FBUyxDQUFDLENBQUM7QUFDL0QsTUFBTSxNQUFNLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxTQUFTLENBQUMsT0FBTyxDQUFDLEVBQUUsQ0FBQyxNQUFNLENBQUMsQ0FBQztBQUN6RCxNQUFNLE1BQU0sR0FBRyxPQUFPLENBQUMsSUFBSSxDQUFDLFNBQVMsQ0FBQyxPQUFPLENBQUMsRUFBRSxDQUFDLE1BQU0sQ0FBQyxDQUFDO0FBQ3pELE1BQU0sT0FBTyxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsU0FBUyxDQUFDLE9BQU8sQ0FBQyxFQUFFLENBQUMsT0FBTyxDQUFDLENBQUM7QUFtQjNEOzs7R0FHRztBQUNILE1BQU0sT0FBTyxjQUFjO0lBTXpCLFlBQVksTUFBdUI7UUFKM0IsZ0JBQVcsR0FBd0IsSUFBSSxHQUFHLEVBQUUsQ0FBQztRQUtuRCxJQUFJLENBQUMsTUFBTSxHQUFHLE1BQU0sSUFBSSxFQUFFLENBQUM7UUFFM0IseURBQXlEO1FBQ3pELElBQUksTUFBTSxFQUFFLE1BQU0sSUFBSSxDQUFDLE1BQU0sRUFBRSxZQUFZLElBQUksTUFBTSxFQUFFLGFBQWEsQ0FBQyxFQUFFLENBQUM7WUFD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

package/dist_ts/storage/index.d.ts

@@ -0,0 +1 @@
+export * from './classes.storagemanager.js';

package/dist_ts/storage/index.js

@@ -0,0 +1,3 @@
+// Storage module exports
+export * from './classes.storagemanager.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9zdG9yYWdlL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLHlCQUF5QjtBQUN6QixjQUFjLDZCQUE2QixDQUFDIn0=

package/dist_ts/ts/00_commitinfo_data.d.ts

@@ -0,0 +1,8 @@
+/**
+ * autocreated commitinfo by @push.rocks/commitinfo
+ */
+export declare const commitinfo: {
+    name: string;
+    version: string;
+    description: string;
+};

package/dist_ts/ts/00_commitinfo_data.js

@@ -0,0 +1,9 @@
+/**
+ * autocreated commitinfo by @push.rocks/commitinfo
+ */
+export const commitinfo = {
+    name: '@serve.zone/platformservice',
+    version: '2.12.0',
+    description: 'A multifaceted platform service handling mail, SMS, letter delivery, and AI services.'
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSw2QkFBNkI7SUFDbkMsT0FBTyxFQUFFLFFBQVE7SUFDakIsV0FBVyxFQUFFLHVGQUF1RjtDQUNyRyxDQUFBIn0=

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

@@ -0,0 +1,238 @@
+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;