@catbee/utils 2.0.0-next.0 → 2.0.0

package/server/server.d.ts

@@ -1,303 +0,0 @@
-/*
- * The MIT License
- * 
- * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
- * 
- * 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.
- */
-
-import express, { Express, Router } from 'express';
-import http from 'http';
-import https from 'https';
-import { ServerConfig, ServerHooks } from '@catbee/utils/types';
-/**
- * Generate standardized error message for missing dependencies.
- */
-export declare const getDependencyErrorMessage: (packageName: string, x?: string) => string;
-/**
- * Map of critical dependencies to their error messages.
- */
-export declare const DependencyErrors: {
-    express: string;
-    helmet: string;
-    cors: string;
-    compression: string;
-    'express-rate-limit': string;
-    'cookie-parser': string;
-    '@scalar/express-api-reference': string;
-    'prom-client': string;
-};
-/**
- * Production-ready Express server with enterprise features.
- *
- * Core Features:
- * - Security: Helmet, CORS, rate limiting, timeouts
- * - Monitoring: Request logs, metrics, health checks
- * - Performance: Compression, caching, static files
- * - Reliability: Graceful shutdown, error handling
- * - Developer UX: OpenAPI docs, debugging tools
- * - Extensibility: Hooks, middleware, custom routes
- *
- * Designed for microservices and production workloads.
- * Includes K8s readiness probes and zero-downtime support.
- */
-export declare class ExpressServer {
-    /** Prometheus client registry for metrics collection */
-    private register;
-    /** HTTP server instance (null when not running) */
-    protected server: http.Server | https.Server | null;
-    /** Merged configuration with defaults applied */
-    protected config: ServerConfig;
-    /** User-defined lifecycle hooks */
-    protected hooks: ServerHooks;
-    /** Global API prefix (from config) */
-    protected globalPrefix: string;
-    /** Internal fallback router */
-    private rootRouter;
-    /** User-supplied router */
-    private externalRouter?;
-    /** Internal Express app instance */
-    private app;
-    /** Set of active WebSocket connections */
-    private connections;
-    /** Flag indicating if the server is shutting down */
-    private isShuttingDown;
-    /**
-     * Collection of registered health check functions.
-     * These are executed when the health check endpoint is accessed.
-     */
-    private healthChecks;
-    /** Prometheus metrics for monitoring */
-    private requestCounter?;
-    private routeTimings?;
-    private requestSizes?;
-    private clientIPs?;
-    /** Promise that resolves when initialization (middleware + routes) is complete */
-    private initPromise;
-    /**
-     * Initializes server with intelligent defaults and security best practices.
-     * All settings can be customized via config and hooks.
-     *
-     * Default Security:
-     * - Secure headers (Helmet)
-     * - Rate limiting
-     * - Request timeouts
-     * - Body size limits
-     * - CORS protection
-     *
-     * Default Monitoring:
-     * - Request/Response logging
-     * - Prometheus metrics
-     * - Health checks
-     * - Request tracing
-     */
-    constructor(config: Partial<ServerConfig>, hooks?: ServerHooks);
-    /**
-     * Execute a lifecycle hook safely with comprehensive error handling.
-     * Prevents hook failures from crashing the server while logging issues.
-     *
-     * @param hook Name of the lifecycle hook to execute
-     * @param args Arguments to pass to the hook function
-     */
-    private runHook;
-    /**
-     * Initialize the Express server with middleware and routes.
-     */
-    private initialize;
-    /**
-     * Configure and register all middlewares in the optimal order.
-     *
-     * Middleware Order (CRITICAL - don't change without understanding implications):
-     * 1.  Basic server configuration (trust proxy, x-powered-by)
-     * 2.  Request ID generation (for tracing)
-     * 3.  Request context setup (for logging correlation)
-     * 4.  Timeout protection (prevents hanging requests)
-     * 5.  Response time tracking (for performance monitoring)
-     * 6.  Request logging (after ID/context setup)
-     * 7.  Custom request hooks
-     * 8.  Security middleware (rate limiting, CORS, Helmet)
-     * 9.  Response compression
-     * 10. Static file serving
-     * 11. Request parsing (body parsing, cookies)
-     * 12. API documentation (OpenAPI)
-     * 13. Global headers
-     * 14. Custom response hooks
-     */
-    protected setupMiddleware(): Promise<void>;
-    /**
-     * Configure server routes and error handling.
-     * Sets up in following order:
-     *
-     * 1. Built-in routes (health, metrics)
-     * 2. Application routes
-     * 3. 404 handler
-     * 4. Error handler
-     */
-    protected setupRoutes(): Promise<void>;
-    /**
-     * Register a new health check function for monitoring service dependencies.
-     *
-     * Health checks are executed when the health endpoint is accessed and
-     * help determine if the service is ready to handle requests.
-     *
-     * Examples:
-     * - Database connectivity
-     * - External service availability
-     * - File system access
-     * - Memory/CPU usage checks
-     *
-     * @param name Unique identifier for the check (used in detailed responses)
-     * @param check Function returning boolean or Promise<boolean> indicating health
-     * @returns This instance for method chaining
-     */
-    registerHealthCheck(name: string, check: () => Promise<boolean> | boolean): this;
-    /**
-     * Run registered health checks and return whether the service is ready.
-     * Useful for readiness probes in deployment tooling.
-     *
-     * @returns Promise resolving to `true` when all checks pass, otherwise `false`.
-     */
-    ready(): Promise<boolean>;
-    /**
-     * Get the underlying Express application instance.
-     * Use this for advanced Express features not exposed by this wrapper.
-     *
-     * @returns The raw Express app instance
-     */
-    getApp(): Express;
-    /**
-     * Get the active HTTP/HTTPS server instance.
-     * Returns null if the server is not currently running.
-     *
-     * @returns The HTTP/HTTPS server instance or null
-     */
-    getServer(): http.Server | https.Server | null;
-    /**
-     * Start the HTTP server and begin listening for requests.
-     *
-     * This method:
-     * - Executes beforeStart hooks
-     * - Binds to the configured host/port
-     * - Sets up error handling for startup failures
-     * - Executes afterStart hooks on success
-     * - Logs startup information
-     *
-     * @returns Promise resolving to the running HTTP server instance
-     * @throws Error if server fails to start or port is already in use
-     */
-    start(): Promise<http.Server | https.Server>;
-    /**
-     * Stop the HTTP server gracefully.
-     *
-     * This method:
-     * - Executes beforeStop hooks
-     * - Stops accepting new connections
-     * - Waits for existing connections to finish
-     * - Closes the server
-     * - Executes afterStop hooks
-     * - Logs shutdown information
-     *
-     * Graceful shutdown ensures:
-     * - No requests are dropped
-     * - Resources are properly cleaned up
-     * - Monitoring systems are notified
-     */
-    stop(force?: boolean): Promise<void>;
-    /**
-     * Enable graceful shutdown on OS signals for production deployment.
-     *
-     * This is essential for:
-     * - Container orchestration (Docker, Kubernetes)
-     * - Process managers (PM2, systemd)
-     * - Load balancer health checks
-     * - Zero-downtime deployments
-     *
-     * @param signals Array of process signals to listen for (default: SIGINT, SIGTERM)
-     */
-    enableGracefulShutdown(signals?: NodeJS.Signals[]): this;
-    /**
-     * Set an externally created base router.
-     * This will override the internal rootRouter.
-     */
-    setBaseRouter(router: Router): this;
-    /**
-     * Create and register a new router (only used if not injecting one externally - use `setBaseRouter` instead).
-     */
-    createRouter(prefix?: string): Router;
-    /**
-     * Register a new route handler with support for multiple HTTP methods.
-     * The route is automatically registered under the globalPrefix if set.
-     *
-     * @param methods Array of HTTP methods (get, post, put, delete, etc.)
-     * @param path Route path with Express path patterns support
-     * @param handlers One or more Express request handlers (middleware + final handler)
-     * @returns This instance for method chaining
-     */
-    registerRoute(methods: Array<keyof Pick<Express, 'get' | 'post' | 'put' | 'delete' | 'patch' | 'options' | 'head'>>, path: string, ...handlers: Array<express.RequestHandler>): this;
-    /**
-     * Register custom middleware with optional path restriction.
-     *
-     * Use this for:
-     * - Adding authentication to specific routes
-     * - Custom logging or validation
-     * - Request transformation
-     * - Third-party middleware integration
-     *
-     * @param path Optional path prefix or middleware function if no path
-     * @param middleware Middleware handler (required if path is provided)
-     * @returns This instance for method chaining
-     */
-    registerMiddleware(path: string | express.RequestHandler, middleware?: express.RequestHandler): this;
-    /**
-     * Register one or more middleware functions to be applied globally.
-     * This is a simpler alternative to registerMiddleware when you just want
-     * to add middleware without path restrictions.
-     *
-     * @param middlewares One or more Express middleware functions
-     * @returns This instance for method chaining
-     */
-    useMiddleware(...middlewares: express.RequestHandler[]): this;
-    /**
-     * Get Prometheus registry (to add custom counters/histograms)
-     *
-     * @return {*}  {client.Registry}
-     */
-    getMetricsRegistry(): typeof import("prom-client").Registry;
-    /**
-     * Get server configuration
-     *
-     * @return {*}  {ServerConfig}
-     */
-    getConfig(): ServerConfig;
-    /**
-     * Wait until server initialization (middleware + routes) has completed.
-     * Useful for integration tests that inspect app before starting.
-     */
-    waitUntilReady(): Promise<void>;
-    private normalizePath;
-    private normalizeRouteForMetrics;
-    /**
-     * Destroy all active connections (gracefully if possible).
-     * If a connection does not close cleanly, it will be force-destroyed.
-     */
-    private destroyConnections;
-    private validateHttpsFiles;
-    private isBuiltServerConfig;
-    private throwDependancyError;
-}

package/stream/stream.utils.d.ts

@@ -1,111 +0,0 @@
-/*
- * The MIT License
- * 
- * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
- * 
- * 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.
- */
-
-import { Readable, Transform } from 'stream';
-import type { BufferEncoding } from '@catbee/utils/crypto';
-/**
- * Convert a buffer or string to a readable stream.
- *
- * @param data - Buffer or string to convert
- * @returns Readable stream containing the data
- *
- * @example
- * ```typescript
- * const stream = bufferToStream(Buffer.from('Hello world'));
- * // or
- * const stream = bufferToStream('Hello world');
- * ```
- */
-export declare function bufferToStream(data: Buffer | string): Readable;
-/**
- * Convert a readable stream to a buffer.
- *
- * @param stream - Readable stream to convert
- * @returns Promise resolving to a buffer containing all stream data
- *
- * @example
- * ```typescript
- * const buffer = await streamToBuffer(fs.createReadStream('file.txt'));
- * console.log(buffer.toString()); // Contents of file.txt
- * ```
- */
-export declare function streamToBuffer(stream: Readable): Promise<Buffer>;
-/**
- * Convert a readable stream to a string.
- *
- * @param stream - Readable stream to convert
- * @param encoding - Character encoding (default: 'utf8')
- * @returns Promise resolving to a string containing all stream data
- *
- * @example
- * ```typescript
- * const content = await streamToString(fs.createReadStream('file.txt'));
- * console.log(content); // Contents of file.txt as string
- * ```
- */
-export declare function streamToString(stream: Readable, encoding?: BufferEncoding): Promise<string>;
-/**
- * Create a transform stream that limits the rate of data flow.
- *
- * @param bytesPerSecond - Maximum bytes per second
- * @returns Transform stream that throttles data flow
- */
-export declare function createThrottleStream(bytesPerSecond: number): Transform;
-/**
- * Create a transform stream that batches data into chunks of specified size.
- *
- * @param size - Size of each batch (items for object mode, bytes for binary mode)
- * @param options - Stream options
- * @returns Transform stream that batches data
- *
- * @example
- * ```typescript
- * // Batch lines from a file into arrays of 100 lines each
- * createReadStream('large-file.txt')
- *   .pipe(createLineStream())
- *   .pipe(createBatchStream(100))
- *   .on('data', batch => console.log(`Processing batch of ${batch.length} lines`));
- * ```
- */
-export declare function createBatchStream(size: number, options?: {
-    objectMode?: boolean;
-}): Transform;
-/**
- * Create a transform stream that splits text data by newlines.
- *
- * @param options - Options for the line stream
- * @returns Transform stream that emits lines
- *
- * @example
- * ```typescript
- * // Process a file line by line
- * createReadStream('file.txt')
- *   .pipe(createLineStream())
- *   .on('data', line => console.log(`Line: ${line}`));
- * ```
- */
-export declare function createLineStream(options?: {
-    encoding?: BufferEncoding;
-    includeNewlines?: boolean;
-}): Transform;

package/string/string.utils.d.ts

@@ -1,124 +0,0 @@
-/*
- * The MIT License
- * 
- * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
- * 
- * 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.
- */
-
-/**
- * Capitalizes the first character of a string.
- *
- * @param {string} str - The input string.
- * @returns {string} The string with the first character in uppercase.
- */
-export declare function capitalize(str: string): string;
-/**
- * Converts a string to kebab-case (e.g., "FooBar test" → "foo-bar-test").
- *
- * @param {string} str - The input string.
- * @returns {string} The kebab-cased string.
- */
-export declare function toKebabCase(str: string): string;
-/**
- * Converts a kebab-case or snake_case string to camelCase.
- *
- * @param {string} str - The input string.
- * @returns {string} The camelCased string.
- */
-export declare function toCamelCase(str: string): string;
-/**
- * Converts a string to a URL-friendly slug (lowercase, dashes, alphanumeric).
- *
- * @param {string} str - The input string.
- * @returns {string} The slugified string.
- */
-export declare function slugify(str: string): string;
-/**
- * Truncates a string to a specific length, appending '...' if truncated.
- *
- * @param {string} str - The input string.
- * @param {number} len - The maximum length.
- * @returns {string} The truncated string.
- */
-export declare function truncate(str: string, len: number): string;
-/**
- * Converts a string to PascalCase (e.g., "foo-bar" → "FooBar").
- *
- * @param {string} str - The input string.
- * @returns {string} The PascalCased string.
- */
-export declare function toPascalCase(str: string): string;
-/**
- * Converts a string to snake_case (e.g., "FooBar test" → "foo_bar_test").
- *
- * @param {string} str - The input string.
- * @returns {string} The snake_cased string.
- */
-export declare function toSnakeCase(str: string): string;
-/**
- * Masks a string by replacing characters with a mask character.
- * Useful for hiding sensitive information like credit cards or passwords.
- *
- * @param {string} str - The string to mask.
- * @param {number} [visibleStart=0] - Number of characters to show at start.
- * @param {number} [visibleEnd=0] - Number of characters to show at end.
- * @param {string} [maskChar="*"] - Character to use for masking.
- * @returns {string} The masked string.
- */
-export declare function mask(str: string, visibleStart?: number, visibleEnd?: number, maskChar?: string): string;
-/**
- * Removes all HTML tags from a string.
- *
- * @param {string} str - The HTML string to process.
- * @returns {string} The string with HTML tags removed.
- */
-export declare function stripHtml(str: string): string;
-/**
- * Performs case-insensitive string comparison.
- *
- * @param {string} a - First string.
- * @param {string} b - Second string.
- * @returns {boolean} True if the strings are equal ignoring case.
- */
-export declare function equalsIgnoreCase(a: string, b: string): boolean;
-/**
- * Reverses a string.
- *
- * @param {string} str - The string to reverse.
- * @returns {string} The reversed string.
- */
-export declare function reverse(str: string): string;
-/**
- * Counts occurrences of a substring within a string.
- *
- * @param {string} str - The source string.
- * @param {string} substring - The substring to count.
- * @param {boolean} [caseSensitive=true] - Whether to perform case-sensitive counting.
- * @returns {number} Number of occurrences.
- */
-export declare function countOccurrences(str: string, substring: string, caseSensitive?: boolean): number;
-/**
- * Convert a string to Title Case (each word capitalized).
- * Preserves existing spacing and punctuation between words.
- *
- * @param str - Input string
- * @returns Title-cased string
- */
-export declare function toTitleCase(str: string): string;

package/type/type.utils.d.ts

@@ -1,129 +0,0 @@
-/*
- * The MIT License
- * 
- * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
- * 
- * 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.
- */
-
-/**
- * Check if a value is of a specific primitive type.
- *
- * @param value - Value to check
- * @param type - Type to check against
- * @returns Whether the value is of the specified type
- *
- * @example
- * ```typescript
- * isPrimitiveType('hello', 'string'); // true
- * isPrimitiveType(42, 'number'); // true
- * isPrimitiveType(true, 'boolean'); // true
- * isPrimitiveType(null, 'null'); // true
- * isPrimitiveType(undefined, 'undefined'); // true
- * isPrimitiveType({}, 'object'); // true
- * isPrimitiveType([], 'array'); // true
- * ```
- */
-export declare function isPrimitiveType(value: unknown, type: 'string' | 'number' | 'boolean' | 'symbol' | 'bigint' | 'function' | 'object' | 'array' | 'null' | 'undefined'): boolean;
-/**
- * Get the primitive type of a value as a string.
- *
- * @param value - Value to get the type of
- * @returns String representing the type
- *
- * @example
- * ```typescript
- * getTypeOf('hello'); // 'string'
- * getTypeOf(42); // 'number'
- * getTypeOf([]); // 'array'
- * getTypeOf(null); // 'null'
- * ```
- */
-export declare function getTypeOf(value: unknown): string;
-/**
- * Type guard for checking if a value is an array of a specific type.
- *
- * @param value - Value to check
- * @param itemTypeGuard - Function that checks if items are of the expected type
- * @returns True if the value is an array with items of the expected type
- *
- * @example
- * ```typescript
- * isArrayOf([1, 2, 3], (item): item is number => typeof item === 'number'); // true
- * isArrayOf(['a', 'b', 'c'], (item): item is string => typeof item === 'string'); // true
- * isArrayOf([1, '2', 3], (item): item is number => typeof item === 'number'); // false
- * ```
- */
-export declare function isArrayOf<T>(value: unknown, itemTypeGuard: (item: unknown) => item is T): value is T[];
-/**
- * Convert a value to a string.
- *
- * @param value - Value to convert
- * @param defaultValue - Default value if conversion fails
- * @returns String representation of the value
- */
-export declare function toStr(value: unknown, defaultValue?: string): string;
-/**
- * Convert a value to a number.
- *
- * @param value - Value to convert
- * @param defaultValue - Default value if conversion fails
- * @returns Numeric representation of the value
- */
-export declare function toNum(value: unknown, defaultValue?: number): number;
-/**
- * Convert a value to a boolean.
- *
- * @param value - Value to convert
- * @param defaultValue - Default value if conversion fails
- * @returns Boolean representation of the value
- */
-export declare function toBool(value: unknown, defaultValue?: boolean): boolean;
-/**
- * Ensure a value matches the expected type, or provide a default.
- *
- * @param value - Value to check
- * @param expectedType - Expected primitive type
- * @param defaultValue - Default value to use if type doesn't match
- * @returns The value if it matches the type, otherwise the default
- *
- * @example
- * ```typescript
- * ensureType(42, 'number', 0); // 42
- * ensureType('42', 'number', 0); // 0
- * ensureType(undefined, 'string', 'default'); // 'default'
- * ```
- */
-export declare function ensureType<T>(value: unknown, expectedType: string, defaultValue: T): T;
-/**
- * Check whether a value is neither null nor undefined.
- * Useful in filter chains and guards.
- *
- * @param value - Value to check
- * @returns True when value !== null && value !== undefined
- */
-export declare function isDefined<T>(value: T | null | undefined): value is T;
-/**
- * Check whether a value is empty.
- * Supports strings, arrays, maps, sets and plain objects.
- *
- * @param value - Value to inspect
- * @returns True when value is considered empty
- */
-export declare function isEmpty(value: any): boolean;