@eggjs/tegg-dns-cache 3.68.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2017-present Alibaba Group Holding Limited and other contributors.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,144 @@
+# @eggjs/tegg-dns-cache
+
+DNS cache plugin for tegg framework. This plugin provides DNS caching capabilities to improve performance and reduce DNS lookup time.
+
+## Features
+
+- 🚀 DNS lookup caching with LRU algorithm
+- ⚖️ Round-robin address rotation for load balancing
+- 🔄 Support both `dns.lookup` and `dns.resolve` modes
+- ⏱️ Configurable cache TTL
+- 🔌 Automatic integration with egg httpclient
+- 🎯 Custom DNS nameservers support
+
+## Installation
+
+```bash
+npm install @eggjs/tegg-dns-cache --save
+```
+
+## Usage
+
+### Enable Plugin
+
+```js
+// config/plugin.js
+exports.dnsCache = {
+  enable: true,
+  package: '@eggjs/tegg-dns-cache',
+};
+```
+
+### Configuration
+
+```js
+// config/config.default.js
+exports.dnsCache = {
+  // DNS resolution mode: 'lookup' or 'resolve' (default: 'resolve')
+  // - lookup: Use dns.lookup, respects /etc/hosts, but no TTL support
+  // - resolve: Use dns.resolve, queries DNS directly, TTL supported
+  mode: 'resolve',
+  
+  // Custom DNS nameservers (only for 'resolve' mode)
+  dnsServers: ['8.8.8.8', '1.1.1.1'],
+  
+  // Maximum cache entries (default: 1000)
+  maxCacheLength: 1000,
+  
+  // Cache lookup interval in ms (only for 'lookup' mode, default: 10000)
+  lookupInterval: 10000,
+  
+  // Enable address rotation for multiple IPs (default: true)
+  addressRotation: true,
+};
+```
+
+## DNS Resolution Modes
+
+### Resolve Mode (Recommended)
+
+Uses `dns.resolve4()` to query DNS servers directly. Supports TTL from DNS records.
+
+**Advantages:**
+- Respects DNS TTL from authoritative servers
+- More control over DNS resolution
+- Can specify custom nameservers
+
+**Note:** Does not respect `/etc/hosts` file.
+
+```js
+exports.dnsCache = {
+  mode: 'resolve',
+  dnsServers: ['8.8.8.8', '1.1.1.1'], // Optional custom DNS servers
+};
+```
+
+### Lookup Mode
+
+Uses `dns.lookup()` which respects system DNS configuration and `/etc/hosts`.
+
+**Advantages:**
+- Respects `/etc/hosts` entries
+- Uses system DNS configuration
+
+**Disadvantages:**
+- Fixed cache interval (no real TTL)
+- Less control over resolution
+
+```js
+exports.dnsCache = {
+  mode: 'lookup',
+  lookupInterval: 10000, // Cache refresh interval in ms
+};
+```
+
+## API
+
+### Access DNS Resolver
+
+```js
+// In controller or service
+const resolver = this.app.dnsResolver;
+
+// Get cached DNS record
+const record = resolver.getCacheRecord('example.com');
+console.log(record); // { ip: '93.184.216.34', family: 4, ttl: 60000, ... }
+
+// Clear DNS cache
+resolver.resetCache();
+
+// Get the underlying LRU cache
+const cache = resolver.getDnsCache();
+```
+
+## Address Rotation
+
+When a hostname resolves to multiple IP addresses, the plugin can automatically rotate through them for load balancing:
+
+```js
+exports.dnsCache = {
+  addressRotation: true, // Enable round-robin rotation
+};
+```
+
+Each request to the same hostname will use the next IP address in rotation.
+
+## Integration with HttpClient
+
+The plugin automatically integrates with egg's built-in httpclient. All HTTP requests will benefit from DNS caching:
+
+```js
+// This request will use cached DNS
+await this.app.httpclient.request('https://example.com/api');
+```
+
+## Performance Benefits
+
+- **Reduced DNS lookup time**: Cached DNS results eliminate network round trips
+- **Lower DNS server load**: Fewer queries to DNS servers
+- **Improved request throughput**: Faster connection establishment
+- **Load distribution**: Address rotation spreads load across multiple IPs
+
+## License
+
+MIT

package/app.d.ts

@@ -0,0 +1,10 @@
+import { Application } from 'egg';
+export default class DnsCacheAppHook {
+    private readonly app;
+    private dnsResolver;
+    constructor(app: Application);
+    configWillLoad(): void;
+    configDidLoad(): void;
+    didLoad(): Promise<void>;
+    beforeClose(): void;
+}

package/app.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const DnsResolver_1 = require("./lib/DnsResolver");
+class DnsCacheAppHook {
+    constructor(app) {
+        this.app = app;
+    }
+    configWillLoad() {
+        if (!this.app.config.dnsCache) {
+            this.app.logger.warn('[tegg-dns-cache-plugin] DNS cache is disabled, please setup dnsCache config.');
+        }
+        const config = this.app.config.dnsCache || {};
+        // Create DNS resolver instance
+        const useDNSResolver = config.mode !== 'lookup';
+        this.dnsResolver = new DnsResolver_1.DnsResolver({
+            useResolver: useDNSResolver,
+            servers: config.dnsServers,
+            max: config.maxCacheLength || 1000,
+            dnsCacheLookupInterval: config.lookupInterval || 10000,
+            addressRotation: config.addressRotation !== false,
+        }, { logger: this.app.logger });
+        const lookupFunction = this.dnsResolver.getLookupFunction();
+        this.app.config.httpclient = this.app.config.httpclient || {};
+        this.app.config.httpclient.lookup = lookupFunction;
+    }
+    configDidLoad() {
+        // Add dnsResolver to app
+        this.app.dnsResolver = this.dnsResolver;
+    }
+    async didLoad() {
+        await this.app.moduleHandler.ready();
+    }
+    beforeClose() {
+        // Cleanup DNS cache resources
+        this.dnsResolver.resetCache();
+    }
+}
+exports.default = DnsCacheAppHook;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXBwLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiYXBwLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBQ0EsbURBQWdEO0FBRWhELE1BQXFCLGVBQWU7SUFJbEMsWUFBWSxHQUFnQjtRQUMxQixJQUFJLENBQUMsR0FBRyxHQUFHLEdBQUcsQ0FBQztJQUNqQixDQUFDO0lBRUQsY0FBYztRQUNaLElBQUksQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDLE1BQU0sQ0FBQyxRQUFRLEVBQUUsQ0FBQztZQUM5QixJQUFJLENBQUMsR0FBRyxDQUFDLE1BQU0sQ0FBQyxJQUFJLENBQ2xCLDhFQUE4RSxDQUMvRSxDQUFDO1FBQ0osQ0FBQztRQUNELE1BQU0sTUFBTSxHQUFHLElBQUksQ0FBQyxHQUFHLENBQUMsTUFBTSxDQUFDLFFBQVEsSUFBSSxFQUFFLENBQUM7UUFFOUMsK0JBQStCO1FBQy9CLE1BQU0sY0FBYyxHQUFHLE1BQU0sQ0FBQyxJQUFJLEtBQUssUUFBUSxDQUFDO1FBQ2hELElBQUksQ0FBQyxXQUFXLEdBQUcsSUFBSSx5QkFBVyxDQUNoQztZQUNFLFdBQVcsRUFBRSxjQUFjO1lBQzNCLE9BQU8sRUFBRSxNQUFNLENBQUMsVUFBVTtZQUMxQixHQUFHLEVBQUUsTUFBTSxDQUFDLGNBQWMsSUFBSSxJQUFJO1lBQ2xDLHNCQUFzQixFQUFFLE1BQU0sQ0FBQyxjQUFjLElBQUksS0FBSztZQUN0RCxlQUFlLEVBQUUsTUFBTSxDQUFDLGVBQWUsS0FBSyxLQUFLO1NBQ2xELEVBQ0QsRUFBRSxNQUFNLEVBQUUsSUFBSSxDQUFDLEdBQUcsQ0FBQyxNQUFNLEVBQUUsQ0FDNUIsQ0FBQztRQUNGLE1BQU0sY0FBYyxHQUFHLElBQUksQ0FBQyxXQUFXLENBQUMsaUJBQWlCLEVBQUUsQ0FBQztRQUM1RCxJQUFJLENBQUMsR0FBRyxDQUFDLE1BQU0sQ0FBQyxVQUFVLEdBQUcsSUFBSSxDQUFDLEdBQUcsQ0FBQyxNQUFNLENBQUMsVUFBVSxJQUFJLEVBQUUsQ0FBQztRQUM5RCxJQUFJLENBQUMsR0FBRyxDQUFDLE1BQU0sQ0FBQyxVQUFVLENBQUMsTUFBTSxHQUFHLGNBQWMsQ0FBQztJQUNyRCxDQUFDO0lBRUQsYUFBYTtRQUNYLHlCQUF5QjtRQUN6QixJQUFJLENBQUMsR0FBRyxDQUFDLFdBQVcsR0FBRyxJQUFJLENBQUMsV0FBVyxDQUFDO0lBQzFDLENBQUM7SUFFRCxLQUFLLENBQUMsT0FBTztRQUNYLE1BQU0sSUFBSSxDQUFDLEdBQUcsQ0FBQyxhQUFhLENBQUMsS0FBSyxFQUFFLENBQUM7SUFDdkMsQ0FBQztJQUVELFdBQVc7UUFDVCw4QkFBOEI7UUFDOUIsSUFBSSxDQUFDLFdBQVcsQ0FBQyxVQUFVLEVBQUUsQ0FBQztJQUNoQyxDQUFDO0NBQ0Y7QUE5Q0Qsa0NBOENDIn0=

package/config/config.default.d.ts

@@ -0,0 +1,26 @@
+/**
+ * DNS Cache Configuration
+ *
+ * The DNS cache plugin provides DNS caching and resolution capabilities to improve performance
+ * by caching DNS lookups and supports both dns.lookup and dns.resolve modes with address rotation.
+ *
+ * @property {'lookup' | 'resolve'} mode - Use dns.lookup or dns.resolve, default is 'resolve'.
+ *   - lookup: Use dns.lookup mode (old behavior), respects system DNS configuration and /etc/hosts, but does not support ttl.
+ *   - resolve: Use dns.resolve mode (new feature), queries DNS servers directly, ttl supported.
+ *     Note: When using resolve mode, /etc/hosts is not respected. You may need to implement custom logic
+ *     if you want to include /etc/hosts resolution.
+ * @property {Number} maxCacheLength - Maximum number of DNS cache entries, default is 1000.
+ *   Uses LRU (Least Recently Used) algorithm to evict old entries when cache is full.
+ * @property {Number} lookupInterval - Only works when mode is 'lookup'. DNS cache lookup interval in milliseconds, default is 10000 (10 seconds).
+ * @property {Boolean} addressRotation - Enable round-robin address rotation when multiple IP addresses
+ *   are returned for a hostname, default is true. Helps distribute load across multiple servers.
+ * @property {Array<String>} dnsServers - Custom DNS nameservers for dns.resolve mode, e.g. ['8.8.8.8', '1.1.1.1'].
+ *   Only effective when mode is 'resolve'. If not set, uses system default DNS servers.
+ */
+export declare const dnsCache: {
+    mode: "lookup" | "resolve";
+    maxCacheLength: number;
+    lookupInterval: number;
+    addressRotation: boolean;
+    dnsServers: string[] | undefined;
+};

package/config/config.default.js

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * DNS Cache Configuration
+ *
+ * The DNS cache plugin provides DNS caching and resolution capabilities to improve performance
+ * by caching DNS lookups and supports both dns.lookup and dns.resolve modes with address rotation.
+ *
+ * @property {'lookup' | 'resolve'} mode - Use dns.lookup or dns.resolve, default is 'resolve'.
+ *   - lookup: Use dns.lookup mode (old behavior), respects system DNS configuration and /etc/hosts, but does not support ttl.
+ *   - resolve: Use dns.resolve mode (new feature), queries DNS servers directly, ttl supported.
+ *     Note: When using resolve mode, /etc/hosts is not respected. You may need to implement custom logic
+ *     if you want to include /etc/hosts resolution.
+ * @property {Number} maxCacheLength - Maximum number of DNS cache entries, default is 1000.
+ *   Uses LRU (Least Recently Used) algorithm to evict old entries when cache is full.
+ * @property {Number} lookupInterval - Only works when mode is 'lookup'. DNS cache lookup interval in milliseconds, default is 10000 (10 seconds).
+ * @property {Boolean} addressRotation - Enable round-robin address rotation when multiple IP addresses
+ *   are returned for a hostname, default is true. Helps distribute load across multiple servers.
+ * @property {Array<String>} dnsServers - Custom DNS nameservers for dns.resolve mode, e.g. ['8.8.8.8', '1.1.1.1'].
+ *   Only effective when mode is 'resolve'. If not set, uses system default DNS servers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dnsCache = void 0;
+exports.dnsCache = {
+    mode: 'resolve',
+    maxCacheLength: 1000,
+    lookupInterval: 10000,
+    addressRotation: true,
+    dnsServers: undefined,
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlnLmRlZmF1bHQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJjb25maWcuZGVmYXVsdC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUE7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQWtCRzs7O0FBRVUsUUFBQSxRQUFRLEdBQUc7SUFDdEIsSUFBSSxFQUFFLFNBQWlDO0lBQ3ZDLGNBQWMsRUFBRSxJQUFJO0lBQ3BCLGNBQWMsRUFBRSxLQUFLO0lBQ3JCLGVBQWUsRUFBRSxJQUFJO0lBQ3JCLFVBQVUsRUFBRSxTQUFpQztDQUM5QyxDQUFDIn0=

package/lib/DnsResolver.d.ts

@@ -0,0 +1,97 @@
+import * as dns from 'node:dns';
+import { LRU } from 'ylru';
+import { EggLogger } from 'egg';
+import { LookupAddress } from 'node:dns';
+export interface DnsResolverOptions {
+    useResolver?: boolean;
+    max?: number;
+    dnsCacheLookupInterval?: number;
+    servers?: string[];
+    addressRotation?: boolean;
+}
+export interface DnsCacheRecord {
+    ip: string;
+    family: number;
+    ttl: number;
+    timestamp: number;
+    index: number;
+}
+export declare class DnsResolver {
+    private _maxCacheSize;
+    private _dnsCache;
+    private useResolver;
+    private dnsCacheLookupInterval;
+    private enableAddressRotation;
+    private resolver?;
+    private _resolve4?;
+    private _lookup?;
+    logger: EggLogger;
+    /**
+     * Create a DNS cache resolver instance
+     * @param options - Configuration options
+     * @param options.useResolver - enable dns.resolver, otherwise use dns.lookup by default
+     * @param options.max - Maximum cache size, default is 1000
+     * @param options.dnsCacheLookupInterval - DNS cache lookup interval in milliseconds, effective when useResolver == false, default is 10000
+     * @param options.servers - Custom DNS nameservers, effective when useResolver == true, e.g. ['8.8.8.8', '1.1.1.1']
+     * @param options.addressRotation - Enable address rotation for both lookup and resolve modes, default is true
+     */
+    constructor(options: DnsResolverOptions | undefined, args: {
+        logger: EggLogger;
+    });
+    get maxCacheSize(): number;
+    private _debugLog;
+    resetCacheSize(size: number): void;
+    /**
+     * Initialize DNS resolver with custom nameservers if provided
+     * @param defaultServers - Custom DNS nameservers
+     * @private
+     */
+    private _initializeResolver;
+    /**
+     * Get the lookup function compatible with dns.lookup signature
+     */
+    getLookupFunction(): typeof dns.lookup;
+    /**
+     * This method may throw error if there is dns query in progress!
+     * @throws Error
+     * @param {string[]} servers eg. ['8.8.8.8']
+     */
+    setServers(servers: string[]): void;
+    getDnsCache(): LRU;
+    /**
+     * Callback with record, handling rotation
+     * @param record - DNS record with rotation state
+     * @param options - Lookup options
+     * @param callback - Callback function
+     * @private
+     */
+    private _callbackWithRecord;
+    lookup(hostname: string): Promise<LookupAddress[]>;
+    resolve4(hostname: string): Promise<dns.RecordWithTtl[]>;
+    /**
+     * Update DNS cache with fresh resolution
+     * Supports both dns.lookup and dns.resolve modes
+     * @param hostname - The hostname to resolve
+     * @private
+     */
+    private _updateDNS;
+    /**
+     * Debug DNS errors
+     * @param err - Error object
+     * @param mode - 'lookup' or 'resolve'
+     * @private
+     */
+    private _errorDNS;
+    /**
+     * Clear the DNS cache
+     * @param recreate - Whether to recreate the cache instance, default is false.
+     *   If true, creates a new LRU instance even if cache already exists.
+     */
+    resetCache(recreate?: boolean): void;
+    /**
+     * Get a specific hostname's single record from cache
+     * @param hostname - Hostname to query
+     * @return {DnsCacheRecord | null} cache record
+     */
+    getCacheRecord(hostname: string): DnsCacheRecord | null;
+}

package/lib/DnsResolver.js

@@ -0,0 +1,346 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DnsResolver = void 0;
+const util = __importStar(require("node:util"));
+const dns = __importStar(require("node:dns"));
+const ylru_1 = require("ylru");
+const IP_REGEX = /^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$/;
+class DnsResolver {
+    /**
+     * Create a DNS cache resolver instance
+     * @param options - Configuration options
+     * @param options.useResolver - enable dns.resolver, otherwise use dns.lookup by default
+     * @param options.max - Maximum cache size, default is 1000
+     * @param options.dnsCacheLookupInterval - DNS cache lookup interval in milliseconds, effective when useResolver == false, default is 10000
+     * @param options.servers - Custom DNS nameservers, effective when useResolver == true, e.g. ['8.8.8.8', '1.1.1.1']
+     * @param options.addressRotation - Enable address rotation for both lookup and resolve modes, default is true
+     */
+    constructor(options = {}, args) {
+        this._maxCacheSize = options.max || 1000;
+        this._dnsCache = new ylru_1.LRU(this._maxCacheSize);
+        this.logger = args.logger;
+        // Set useResolver before using it
+        this.useResolver = options.useResolver === true;
+        this.dnsCacheLookupInterval = options.dnsCacheLookupInterval || 10000;
+        // Address rotation is enabled by default
+        this.enableAddressRotation = options.addressRotation !== false;
+        if (this.useResolver) {
+            this._initializeResolver(options.servers);
+        }
+        else {
+            // Use dns.lookup mode (old behavior)
+            this._lookup = util.promisify(dns.lookup);
+        }
+        this.resetCache = this.resetCache.bind(this);
+        this.logger.debug(`[dns-cache] DNS Resolver initialized in ${this.useResolver ? 'resolve' : 'lookup'} mode, maxCacheSize: ${this._maxCacheSize}, addressRotation: ${this.enableAddressRotation}`);
+    }
+    get maxCacheSize() {
+        return this._maxCacheSize;
+    }
+    _debugLog(msg, ...args) {
+        this.logger.debug.apply(this.logger, [msg, ...args]);
+    }
+    resetCacheSize(size) {
+        this._maxCacheSize = size;
+        this.resetCache(true);
+    }
+    /**
+     * Initialize DNS resolver with custom nameservers if provided
+     * @param defaultServers - Custom DNS nameservers
+     * @private
+     */
+    _initializeResolver(defaultServers) {
+        this.resolver = new dns.Resolver({
+            timeout: 3000,
+            tries: 2,
+        });
+        const hasDefaultServers = defaultServers &&
+            Array.isArray(defaultServers) &&
+            defaultServers.length > 0;
+        if (hasDefaultServers) {
+            this.resolver.setServers(defaultServers);
+            this._debugLog(`[dns-cache] Custom DNS servers configured: ${defaultServers.join(', ')}`);
+        }
+        this._resolve4 = util.promisify(this.resolver.resolve4.bind(this.resolver));
+    }
+    /**
+     * Get the lookup function compatible with dns.lookup signature
+     */
+    getLookupFunction() {
+        return ((hostname, options, callback) => {
+            // signature handling: lookup(hostname, cb) or lookup(hostname, options, cb)
+            if (typeof options === 'function') {
+                callback = options;
+                options = {};
+            }
+            if (typeof options === 'number') {
+                options = { family: options };
+            }
+            if (typeof callback !== 'function') {
+                throw new TypeError('callback must be a function');
+            }
+            options = options || {};
+            if (!options.family) {
+                options.family = 4;
+            }
+            // keep original dns.lookup behavior for literal IPs without hitting the network
+            if (IP_REGEX.test(hostname)) {
+                // theoretically this code will never be reached because urllib will
+                // directly return for literal IPs before calling lookup function
+                const family = typeof options.family === 'number' ? options.family : 4;
+                this.logger.debug(`[dns-cache] literal IP ${hostname} lookup, bypassing cache`);
+                if (options === null || options === void 0 ? void 0 : options.all) {
+                    return callback(null, [{ address: hostname, family }]);
+                }
+                return callback(null, hostname, family);
+            }
+            const record = this._dnsCache.get(hostname);
+            const now = Date.now();
+            if (record) {
+                // Check TTL - use the first record's TTL and timestamp
+                const firstRecord = record.records[0];
+                const ttl = firstRecord.ttl || 0;
+                const timestamp = firstRecord.timestamp || now;
+                if (now - timestamp >= ttl) {
+                    // refresh in background, keep serving cached value
+                    this._debugLog(`[dns-cache] Cache TTL expired for ${hostname}, refreshing in background. Age: ${now - timestamp}ms, TTL: ${ttl}ms`);
+                    this._updateDNS(hostname).catch(() => {
+                        // do nothing, error already logged in _updateDNS
+                    });
+                }
+                else {
+                    this._debugLog(`[dns-cache] Cache hit for ${hostname}, remaining TTL: ${ttl - (now - timestamp)}ms, records: ${record.records.length}`);
+                }
+                return this._callbackWithRecord(record, options, callback);
+            }
+            // No cached record, resolve and respond when ready
+            this._debugLog(`[dns-cache] Cache miss for ${hostname}, resolving...`);
+            this._updateDNS(hostname)
+                .then(record => {
+                this._callbackWithRecord(record, options, callback);
+            })
+                .catch(err => {
+                callback(err, '');
+            });
+        });
+    }
+    /**
+     * This method may throw error if there is dns query in progress!
+     * @throws Error
+     * @param {string[]} servers eg. ['8.8.8.8']
+     */
+    setServers(servers) {
+        if (this.resolver) {
+            this.resolver.setServers(servers);
+        }
+        else {
+            this.logger.warn('[dns-cache] Cannot set DNS servers when useResolver is false');
+        }
+    }
+    getDnsCache() {
+        return this._dnsCache;
+    }
+    /**
+     * Callback with record, handling rotation
+     * @param record - DNS record with rotation state
+     * @param options - Lookup options
+     * @param callback - Callback function
+     * @private
+     */
+    _callbackWithRecord(record, options, callback) {
+        // All records use the unified structure with rotation
+        if (record.records && Array.isArray(record.records)) {
+            const records = record.records;
+            const currentRecord = records[record.currentIndex % records.length];
+            if (records.length > 1) {
+                this._debugLog(`[dns-cache] Address rotation: using ${currentRecord.ip} (index ${record.currentIndex % records.length}/${records.length})`);
+            }
+            // Rotate to next address for next call (if enabled)
+            if (this.enableAddressRotation) {
+                record.currentIndex = (record.currentIndex + 1) % records.length;
+            }
+            if (options.all) {
+                return callback(null, [
+                    { address: currentRecord.ip, family: currentRecord.family || 4 },
+                ]);
+            }
+            return callback(null, currentRecord.ip, currentRecord.family || 4);
+        }
+        // Should not reach here, all records should use records structure
+        throw new Error('[dns_cache_error]: Invalid cache record structure');
+    }
+    async lookup(hostname) {
+        // handle localhost (some name servers may not resolve it)
+        if (hostname === 'localhost') {
+            this.logger.debug('[dns-cache] localhost lookup, bypassing cache');
+            return [{ address: '127.0.0.1', family: 4 }];
+        }
+        if (!this._lookup) {
+            throw new Error('DNS Resolver not initialized for lookup mode');
+        }
+        // Use { all: true } to get all addresses for rotation support
+        const addresses = await this._lookup(hostname, {
+            family: 4,
+            all: true,
+        });
+        return addresses;
+    }
+    async resolve4(hostname) {
+        // handle localhost (some name servers may not resolve it)
+        if (hostname === 'localhost') {
+            this.logger.debug('[dns-cache] localhost resolve, bypassing cache');
+            return [
+                {
+                    address: '127.0.0.1',
+                    ttl: Math.floor(Number.MAX_SAFE_INTEGER / 1000),
+                },
+            ]; // provide a default TTL
+        }
+        if (!this._resolve4) {
+            throw new Error('DNS Resolver not initialized for resolve mode');
+        }
+        const addresses = await this._resolve4(hostname, {
+            ttl: true,
+        });
+        return addresses;
+    }
+    /**
+     * Update DNS cache with fresh resolution
+     * Supports both dns.lookup and dns.resolve modes
+     * @param hostname - The hostname to resolve
+     * @private
+     */
+    async _updateDNS(hostname) {
+        // Use dns.lookup
+        if (!this.useResolver) {
+            try {
+                const addresses = await this.lookup(hostname);
+                const addressArray = Array.isArray(addresses) ? addresses : [addresses];
+                if (addressArray.length === 0) {
+                    throw new Error(`empty address for ${hostname}`);
+                }
+                const records = addressArray.map((addr, index) => ({
+                    ip: addr.address,
+                    family: addr.family || 4,
+                    ttl: this.dnsCacheLookupInterval,
+                    timestamp: Date.now(),
+                    index,
+                }));
+                const cacheEntry = {
+                    records,
+                    currentIndex: 0,
+                };
+                this._dnsCache.set(hostname, cacheEntry);
+                this._debugLog(`[dns-cache] dns.lookup succeeded for ${hostname}, resolved ${records.length} address(es): ${records.map(r => r.ip).join(', ')}, TTL: ${this.dnsCacheLookupInterval}ms`);
+                return cacheEntry;
+            }
+            catch (err) {
+                this._errorDNS(err, 'lookup', hostname);
+                throw err;
+            }
+        }
+        // Use dns.resolve
+        try {
+            const addresses = await this.resolve4(hostname);
+            const addressArray = Array.isArray(addresses) ? addresses : [addresses];
+            // Store all addresses with rotation index
+            const records = addressArray.map((addr, index) => {
+                const address = typeof addr === 'string' ? addr : addr.address;
+                const ttlSeconds = addr && Number.isInteger(addr.ttl) && addr.ttl >= 0 ? addr.ttl : 0;
+                return {
+                    ip: address,
+                    family: 4,
+                    ttl: ttlSeconds * 1000,
+                    timestamp: Date.now(),
+                    index,
+                };
+            });
+            if (records.length === 0 || !records[0].ip) {
+                throw new Error(`empty address for ${hostname}`);
+            }
+            // Store all records with rotation state
+            const cacheEntry = {
+                records,
+                currentIndex: 0,
+            };
+            this._dnsCache.set(hostname, cacheEntry);
+            this._debugLog(`[dns-cache] dns.resolve4 succeeded for ${hostname}, resolved ${records.length} address(es): ${records
+                .map(r => `${r.ip} (TTL: ${r.ttl}ms)`)
+                .join(', ')}`);
+            return cacheEntry;
+        }
+        catch (err) {
+            this._errorDNS(err, 'resolve', hostname);
+            throw err;
+        }
+    }
+    /**
+     * Debug DNS errors
+     * @param err - Error object
+     * @param mode - 'lookup' or 'resolve'
+     * @private
+     */
+    _errorDNS(err, mode, hostname) {
+        this.logger.error(`error occurred when resolving ${hostname} with dns.${mode}: ${err && err.message ? err.message : err}`);
+    }
+    /**
+     * Clear the DNS cache
+     * @param recreate - Whether to recreate the cache instance, default is false.
+     *   If true, creates a new LRU instance even if cache already exists.
+     */
+    resetCache(recreate = false) {
+        this._debugLog(`[dns-cache] Resetting DNS cache (recreate: ${recreate})`);
+        if (this._dnsCache)
+            this._dnsCache.reset();
+        if (recreate) {
+            this._dnsCache = new ylru_1.LRU(this._maxCacheSize);
+        }
+    }
+    /**
+     * Get a specific hostname's single record from cache
+     * @param hostname - Hostname to query
+     * @return {DnsCacheRecord | null} cache record
+     */
+    getCacheRecord(hostname) {
+        const entry = this._dnsCache.get(hostname);
+        if (entry && entry.records && Array.isArray(entry.records)) {
+            return entry.records[entry.currentIndex % entry.records.length];
+        }
+        return null;
+    }
+}
+exports.DnsResolver = DnsResolver;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiRG5zUmVzb2x2ZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJEbnNSZXNvbHZlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQSxnREFBa0M7QUFDbEMsOENBQWdDO0FBQ2hDLCtCQUEyQjtBQUkzQixNQUFNLFFBQVEsR0FBRyxzQ0FBc0MsQ0FBQztBQXVCeEQsTUFBYSxXQUFXO0lBV3RCOzs7Ozs7OztPQVFHO0lBQ0gsWUFBWSxVQUE4QixFQUFFLEVBQUUsSUFBMkI7UUFDdkUsSUFBSSxDQUFDLGFBQWEsR0FBRyxPQUFPLENBQUMsR0FBRyxJQUFJLElBQUksQ0FBQztRQUN6QyxJQUFJLENBQUMsU0FBUyxHQUFHLElBQUksVUFBRyxDQUFDLElBQUksQ0FBQyxhQUFhLENBQUMsQ0FBQztRQUM3QyxJQUFJLENBQUMsTUFBTSxHQUFHLElBQUksQ0FBQyxNQUFNLENBQUM7UUFFMUIsa0NBQWtDO1FBQ2xDLElBQUksQ0FBQyxXQUFXLEdBQUcsT0FBTyxDQUFDLFdBQVcsS0FBSyxJQUFJLENBQUM7UUFFaEQsSUFBSSxDQUFDLHNCQUFzQixHQUFHLE9BQU8sQ0FBQyxzQkFBc0IsSUFBSSxLQUFLLENBQUM7UUFFdEUseUNBQXlDO1FBQ3pDLElBQUksQ0FBQyxxQkFBcUIsR0FBRyxPQUFPLENBQUMsZUFBZSxLQUFLLEtBQUssQ0FBQztRQUUvRCxJQUFJLElBQUksQ0FBQyxXQUFXLEVBQUUsQ0FBQztZQUNyQixJQUFJLENBQUMsbUJBQW1CLENBQUMsT0FBTyxDQUFDLE9BQU8sQ0FBQyxDQUFDO1FBQzVDLENBQUM7YUFBTSxDQUFDO1lBQ04scUNBQXFDO1lBQ3JDLElBQUksQ0FBQyxPQUFPLEdBQUcsSUFBSSxDQUFDLFNBQVMsQ0FBQyxHQUFHLENBQUMsTUFBTSxDQUFDLENBQUM7UUFDNUMsQ0FBQztRQUVELElBQUksQ0FBQyxVQUFVLEdBQUcsSUFBSSxDQUFDLFVBQVUsQ0FBQyxJQUFJ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

package/lib/index.d.ts

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

package/lib/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("./DnsResolver"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJpbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7O0FBQUEsZ0RBQThCIn0=

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@eggjs/tegg-dns-cache",
+  "eggPlugin": {
+    "name": "dnsCache",
+    "dependencies": [
+      "tegg"
+    ]
+  },
+  "version": "3.68.0",
+  "types": "typings/index.d.ts",
+  "description": "tegg dns cache plugin",
+  "keywords": [
+    "egg",
+    "typescript",
+    "dns",
+    "cache",
+    "tegg"
+  ],
+  "files": [
+    "app.js",
+    "app.d.ts",
+    "agent.js",
+    "agent.d.ts",
+    "index.js",
+    "index.d.ts",
+    "types.js",
+    "types.d.ts",
+    "config/**/*.js",
+    "config/**/*.d.ts",
+    "lib/**/*.js",
+    "lib/**/*.d.ts",
+    "app/**/*.js",
+    "app/**/*.d.ts",
+    "typings/*.d.ts"
+  ],
+  "eggModule": {
+    "name": "teggDnsCache"
+  },
+  "scripts": {
+    "test": "cross-env NODE_ENV=test NODE_OPTIONS='--no-deprecation' mocha",
+    "clean": "tsc -b --clean",
+    "tsc": "ut run clean && tsc -p ./tsconfig.json",
+    "tsc:pub": "ut run clean && tsc -p ./tsconfig.pub.json",
+    "prepublishOnly": "ut tsc:pub"
+  },
+  "homepage": "https://github.com/eggjs/tegg",
+  "bugs": {
+    "url": "https://github.com/eggjs/tegg/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git@github.com:eggjs/tegg.git",
+    "directory": "plugin/dns-cache"
+  },
+  "egg": {
+    "typescript": true
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "peerDependencies": {
+    "egg": ">=3.32.0"
+  },
+  "dependencies": {
+    "@eggjs/tegg": "^3.68.0",
+    "ylru": "^2.0.0"
+  },
+  "devDependencies": {
+    "@eggjs/tegg-config": "^3.68.0",
+    "@eggjs/tegg-plugin": "^3.68.0",
+    "@types/mocha": "^10.0.10",
+    "@types/node": "^20.2.4",
+    "cross-env": "^7.0.3",
+    "egg": "^3.32.0",
+    "egg-mock": "^5.5.0",
+    "mocha": "^10.2.0",
+    "ts-node": "^10.9.1",
+    "typescript": "^5.0.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "gitHead": "c8c089bee4aaf48ccdea3d56d142c82044223ae3"
+}

package/typings/index.d.ts

@@ -0,0 +1,34 @@
+import 'egg';
+import '@eggjs/tegg-plugin';
+import * as dns from 'node:dns';
+import { DnsResolver, DnsCacheRecord } from '../lib';
+export { DnsResolver, DnsCacheRecord };
+
+declare module 'egg' {
+  interface TeggDnsCacheApplication {
+    /**
+     * DNS resolver instance, provides DNS caching capabilities
+     */
+    dnsResolver: DnsResolver;
+  }
+
+  interface Application extends TeggDnsCacheApplication {}
+
+  interface EggAppConfig {
+    /**
+     * DNS Cache Configuration
+     */
+    dnsCache: {
+      /** Use dns.lookup or dns.resolve, default is 'resolve' */
+      mode?: 'lookup' | 'resolve';
+      /** Custom DNS nameservers for dns.resolve mode */
+      dnsServers?: string[];
+      /** Maximum number of DNS cache entries, default is 1000 */
+      maxCacheLength?: number;
+      /** DNS cache lookup interval in milliseconds, default is 10000 */
+      lookupInterval?: number;
+      /** Enable round-robin address rotation, default is true */
+      addressRotation?: boolean;
+    };
+  }
+}