node-best-practices

Use Node.js type stripping: on Node 22.6+ run with --experimental-strip-types, and on Node 22.19+/23.6+/24+ run .ts files directly with no flags. Your code must use import type for type-only imports, avoid enums and namespaces, and use .ts extensions in imports.

Use the close-with-grace package to register a shutdown handler that responds to SIGTERM and SIGINT. Inside the handler, stop accepting new requests, close the HTTP server, then close database and cache connections in reverse initialization order.

Run tests with --test-reporter=spec and --test-timeout to identify hanging tests, then isolate files individually. Common causes include race conditions, hardcoded ports, shared module state, and unawaited promises; use dynamic port 0 and t.mock for determinism.

No. Type stripping only removes type annotations without transforming code, so enums, namespaces, and constructor parameter properties are unsupported. Replace enums with const objects using as const and declare class properties explicitly.

Use async-cache-dedupe for async caching with TTL, stale-while-revalidate, and automatic request deduplication, with optional Redis storage. For simple bounded in-memory caching, use lru-cache with max size and TTL options.

NODE_ENV conflates environment detection, logging behavior, security settings, and optimization flags into one variable, causing hidden behavior changes. Use explicit environment variables per concern, validated with Zod or env-schema, for clearer and more testable configuration.