@catbee/utils 0.0.7 → 0.0.8-next.0

package/build/src/index.js

@@ -1,69 +0,0 @@
-"use strict";
-/*
- * The MIT License
- *
- * Copyright (c) 2025 Catbee Technologies
- *
- * 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.
- */
-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 });
-exports.getConfig = exports.setConfig = void 0;
-var config_1 = require("./config");
-Object.defineProperty(exports, "setConfig", { enumerable: true, get: function () { return config_1.setConfig; } });
-Object.defineProperty(exports, "getConfig", { enumerable: true, get: function () { return config_1.getConfig; } });
-__exportStar(require("./utils/array.utils"), exports);
-__exportStar(require("./utils/async.utils"), exports);
-__exportStar(require("./utils/cache.utils"), exports);
-__exportStar(require("./utils/context-store.utils"), exports);
-__exportStar(require("./utils/crypto.utils"), exports);
-__exportStar(require("./utils/decorators.utils"), exports);
-__exportStar(require("./utils/dir.utils"), exports);
-__exportStar(require("./utils/env.utils"), exports);
-__exportStar(require("./utils/exception.utils"), exports);
-__exportStar(require("./utils/fs.utils"), exports);
-__exportStar(require("./utils/http-status-codes"), exports);
-__exportStar(require("./utils/id.utils"), exports);
-__exportStar(require("./utils/logger.utils"), exports);
-__exportStar(require("./utils/middleware.utils"), exports);
-__exportStar(require("./utils/obj.utils"), exports);
-__exportStar(require("./utils/request.utils"), exports);
-__exportStar(require("./utils/response.utils"), exports);
-__exportStar(require("./utils/string.utils"), exports);
-__exportStar(require("./utils/url.utils"), exports);
-__exportStar(require("./utils/validate.utils"), exports);
-__exportStar(require("./types/index"), exports);
-__exportStar(require("./types/server"), exports);
-__exportStar(require("./types/api-response"), exports);
-__exportStar(require("./servers/server"), exports);
-__exportStar(require("./servers/server.builder"), exports);
-//# sourceMappingURL=index.js.map

package/build/src/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;;;;;;;;;;;;;;;;AAEH,mCAAgD;AAAvC,mGAAA,SAAS,OAAA;AAAE,mGAAA,SAAS,OAAA;AAE7B,sDAAoC;AACpC,sDAAoC;AACpC,sDAAoC;AACpC,8DAA4C;AAC5C,uDAAqC;AACrC,2DAAyC;AACzC,oDAAkC;AAClC,oDAAkC;AAClC,0DAAwC;AACxC,mDAAiC;AACjC,4DAA0C;AAC1C,mDAAiC;AACjC,uDAAqC;AACrC,2DAAyC;AACzC,oDAAkC;AAClC,wDAAsC;AACtC,yDAAuC;AACvC,uDAAqC;AACrC,oDAAkC;AAClC,yDAAuC;AAEvC,gDAA8B;AAC9B,iDAA+B;AAC/B,uDAAqC;AAErC,mDAAiC;AACjC,2DAAyC","sourcesContent":["/*\n * The MIT License\n *\n * Copyright (c) 2025 Catbee Technologies\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nexport { setConfig, getConfig } from './config';\n\nexport * from './utils/array.utils';\nexport * from './utils/async.utils';\nexport * from './utils/cache.utils';\nexport * from './utils/context-store.utils';\nexport * from './utils/crypto.utils';\nexport * from './utils/decorators.utils';\nexport * from './utils/dir.utils';\nexport * from './utils/env.utils';\nexport * from './utils/exception.utils';\nexport * from './utils/fs.utils';\nexport * from './utils/http-status-codes';\nexport * from './utils/id.utils';\nexport * from './utils/logger.utils';\nexport * from './utils/middleware.utils';\nexport * from './utils/obj.utils';\nexport * from './utils/request.utils';\nexport * from './utils/response.utils';\nexport * from './utils/string.utils';\nexport * from './utils/url.utils';\nexport * from './utils/validate.utils';\n\nexport * from './types/index';\nexport * from './types/server';\nexport * from './types/api-response';\n\nexport * from './servers/server';\nexport * from './servers/server.builder';\n"]}

package/build/src/servers/server.builder.d.ts

@@ -1,508 +0,0 @@
-import { ServerConfig } from '../types/server';
-/**
- * Builder class for creating and configuring an Express server configuration.
- *
- * This class provides a fluent interface to configure all aspects of the Express server
- * including security settings, middleware, routing, and more.
- *
- * @example
- * ```typescript
- * const serverConfig = new ServerConfigBuilder()
- *   .withPort(3000)
- *   .withHost('localhost')
- *   .enableCors()
- *   .enableHelmet()
- *   .build();
- * ```
- */
-export declare const BUILD_MARKER: unique symbol;
-export declare class ServerConfigBuilder {
-    private config;
-    /**
-     * Validates that a port number is valid and usable.
-     *
-     * @private
-     * @param port - The port number to validate
-     * @throws {Error} If port is not an integer or is outside the valid range (1-65535)
-     */
-    private validatePort;
-    /**
-     * Sets the port the server will listen on.
-     *
-     * @param port - The port number (1-65535)
-     * @returns The builder instance for chaining
-     * @throws {Error} If port is invalid
-     * @default 3000 (can be overridden via PORT env variable)
-     *
-     * @example
-     * ```typescript
-     * builder.withPort(3000)
-     * ```
-     */
-    withPort(port: number): this;
-    /**
-     * Sets the hostname the server will bind to.
-     *
-     * @param host - The hostname (e.g., 'localhost', '0.0.0.0', '127.0.0.1')
-     * @returns The builder instance for chaining
-     * @default '0.0.0.0' (can be overridden via HOST env variable)
-     *
-     * @example
-     * ```typescript
-     * builder.withHost('0.0.0.0') // Listen on all interfaces
-     * ```
-     */
-    withHost(host: string): this;
-    /**
-     * Configures Cross-Origin Resource Sharing (CORS) for the server.
-     *
-     * @param opts - CORS options object or boolean (true to enable with defaults, false to disable)
-     * @returns The builder instance for chaining
-     * @default false (CORS is disabled by default)
-     *
-     * @example
-     * ```typescript
-     * // Enable CORS with default options
-     * builder.withCors(true)
-     *
-     * // Configure CORS with specific options
-     * builder.withCors({
-     *   origin: ['https://example.com'],
-     *   methods: ['GET', 'POST']
-     * })
-     * ```
-     */
-    withCors(opts: ServerConfig['cors']): this;
-    /**
-     * Enables CORS with default settings
-     *
-     * @returns The builder instance for chaining
-     */
-    enableCors(): this;
-    /**
-     * Disables CORS
-     *
-     * @returns The builder instance for chaining
-     */
-    disableCors(): this;
-    /**
-     * Configures the Helmet middleware for setting HTTP security headers.
-     *
-     * @param opts - Helmet options object or boolean (true to enable with defaults, false to disable)
-     * @returns The builder instance for chaining
-     * @default false (Helmet is disabled by default)
-     *
-     * @example
-     * ```typescript
-     * // Enable Helmet with default settings
-     * builder.withHelmet(true)
-     *
-     * // Configure Helmet with specific options
-     * builder.withHelmet({
-     *   contentSecurityPolicy: false,
-     *   xssFilter: true
-     * })
-     * ```
-     */
-    withHelmet(opts: ServerConfig['helmet']): this;
-    /**
-     * Enables Helmet with default settings
-     *
-     * @returns The builder instance for chaining
-     */
-    enableHelmet(): this;
-    /**
-     * Disables Helmet
-     *
-     * @returns The builder instance for chaining
-     */
-    disableHelmet(): this;
-    /**
-     * Configures response compression middleware.
-     *
-     * @param opts - Compression options object or boolean (true to enable with defaults, false to disable)
-     * @returns The builder instance for chaining
-     * @default false (Compression is disabled by default)
-     *
-     * @example
-     * ```typescript
-     * // Enable compression with default settings
-     * builder.withCompression(true)
-     *
-     * // Configure compression with specific options
-     * builder.withCompression({
-     *   level: 6,
-     *   threshold: 1024
-     * })
-     * ```
-     */
-    withCompression(opts: ServerConfig['compression']): this;
-    /**
-     * Enables compression with default settings
-     *
-     * @returns The builder instance for chaining
-     */
-    enableCompression(): this;
-    /**
-     * Disables compression
-     *
-     * @returns The builder instance for chaining
-     */
-    disableCompression(): this;
-    /**
-     * Configures rate limiting to protect against brute-force attacks.
-     *
-     * @param opts - Rate limit configuration options
-     * @returns The builder instance for chaining
-     * @default { enable: false, windowMs: 15 * 60 * 1000, max: 100, message: 'Too many requests', standardHeaders: true, legacyHeaders: false }
-     *
-     * @example
-     * ```typescript
-     * builder.withRateLimit({
-     *   enable: true,
-     *   windowMs: 15 * 60 * 1000, // 15 minutes
-     *   max: 100 // limit each IP to 100 requests per windowMs
-     * })
-     * ```
-     */
-    withRateLimit(opts: Partial<ServerConfig['rateLimit']>): this;
-    /**
-     * Enables rate limiting with default or custom settings
-     *
-     * @param opts - Optional rate limit configuration (max requests, window, etc.)
-     * @returns The builder instance for chaining
-     */
-    enableRateLimit(opts?: Omit<Partial<NonNullable<ServerConfig['rateLimit']>>, 'enable'>): this;
-    /**
-     * Disables rate limiting
-     *
-     * @returns The builder instance for chaining
-     */
-    disableRateLimit(): this;
-    /**
-     * Configures HTTP request logging middleware.
-     *
-     * @param opts - Request logging configuration options
-     * @returns The builder instance for chaining
-     * @default { enable: true in dev/false in prod, ignorePaths: ['/healthz', '/favicon.ico', '/metrics', '/docs', '/.well-known'], skipNotFoundRoutes: false }
-     *
-     * @example
-     * ```typescript
-     * builder.withRequestLogging({
-     *   enable: true,
-     *   ignorePaths: ['/health', '/metrics'],
-     *   skipNotFoundRoutes: true
-     * })
-     * ```
-     */
-    withRequestLogging(opts: Partial<NonNullable<ServerConfig['requestLogging']>>): this;
-    /**
-     * Enables request logging with default or custom settings
-     *
-     * @param opts - Optional request logging configuration
-     * @returns The builder instance for chaining
-     */
-    enableRequestLogging(opts?: Omit<Partial<NonNullable<ServerConfig['requestLogging']>>, 'enable'>): this;
-    /**
-     * Disables request logging
-     *
-     * @returns The builder instance for chaining
-     */
-    disableRequestLogging(): this;
-    /**
-     * Configures server metrics collection and endpoints.
-     *
-     * @param opts - Metrics configuration options
-     * @returns The builder instance for chaining
-     * @default { enable: false, path: '/metrics', withGlobalPrefix: false }
-     *
-     * @example
-     * ```typescript
-     * builder.withMetrics({
-     *   enable: true,
-     *   path: '/metrics'
-     * })
-     * ```
-     */
-    withMetrics(opts: Partial<NonNullable<ServerConfig['metrics']>>): this;
-    /**
-     * Enables Prometheus metrics collection and endpoint
-     *
-     * @param opts - Optional metrics configuration
-     * @returns The builder instance for chaining
-     */
-    enableMetrics(opts?: Omit<Partial<NonNullable<ServerConfig['metrics']>>, 'enable'>): this;
-    /**
-     * Disables Prometheus metrics
-     *
-     * @returns The builder instance for chaining
-     */
-    disableMetrics(): this;
-    /**
-     * Configures server health check endpoint.
-     *
-     * @param opts - Health check configuration options
-     * @returns The builder instance for chaining
-     * @default { path: '/healthz', detailed: true, withGlobalPrefix: false }
-     *
-     * @example
-     * ```typescript
-     * builder.withHealthCheck({
-     *   path: '/health',
-     *   detailed: true
-     * })
-     * ```
-     */
-    withHealthCheck(opts: Partial<NonNullable<ServerConfig['healthCheck']>>): this;
-    /**
-     * Configures OpenAPI/Swagger documentation for the API.
-     *
-     * @param opts - OpenAPI configuration options
-     * @returns The builder instance for chaining
-     * @default { enable: false, mountPath: '/docs', verbose: false, withGlobalPrefix: false }
-     *
-     * @example
-     * ```typescript
-     * builder.withOpenApi({
-     *   enable: true,
-     *   path: '/api-docs',
-     *   filePath: './openapi.yaml'
-     * })
-     * ```
-     */
-    withOpenApi(opts: Partial<NonNullable<ServerConfig['openApi']>>): this;
-    /**
-     * Enables OpenAPI documentation with required file path
-     *
-     * @param filePath - Path to OpenAPI specification file (required)
-     * @param opts - Optional OpenAPI configuration
-     * @returns The builder instance for chaining
-     */
-    enableOpenApi(filePath: string, opts?: Omit<Partial<NonNullable<ServerConfig['openApi']>>, 'enable' | 'filePath'>): this;
-    /**
-     * Disables OpenAPI documentation
-     *
-     * @returns The builder instance for chaining
-     */
-    disableOpenApi(): this;
-    /**
-     * Configures the server as a microservice with versioning.
-     *
-     * @param opts - Microservice configuration options including app name and service version
-     * @returns The builder instance for chaining
-     * @default { isMicroservice: false, appName: 'express_app' }
-     *
-     * @example
-     * ```typescript
-     * builder.withMicroService({
-     *   appName: 'user-service',
-     *   serviceVersion: {
-     *     enable: true,
-     *     version: '1.2.3'
-     *   }
-     * })
-     * ```
-     */
-    withMicroService(opts: {
-        appName: NonNullable<ServerConfig['appName']>;
-        serviceVersion: Partial<NonNullable<ServerConfig['serviceVersion']>>;
-    }): this;
-    /**
-     * Configures the trust proxy settings to determine if X-Forwarded-* headers should be trusted.
-     *
-     * @param opts - Trust proxy configuration options
-     * @returns The builder instance for chaining
-     * @default false
-     *
-     * @example
-     * ```typescript
-     * // Trust proxy headers (useful when behind a load balancer)
-     * builder.withTrustProxy(true)
-     * ```
-     */
-    withTrustProxy(opts: NonNullable<ServerConfig['trustProxy']>): this;
-    /**
-     * Configures the request ID middleware for tracing requests across services.
-     *
-     * @param opts - Request ID configuration options
-     * @returns The builder instance for chaining
-     * @default { headerName: 'x-request-id', exposeHeader: true }
-     *
-     * @example
-     * ```typescript
-     * builder.withRequestId({
-     *   headerName: 'X-Request-Id',
-     *   generator: () => crypto.randomUUID()
-     * })
-     * ```
-     */
-    withRequestId(opts: Partial<NonNullable<ServerConfig['requestId']>>): this;
-    /**
-     * Configures the response time middleware for measuring request processing times.
-     *
-     * @param opts - Response time configuration options
-     * @returns The builder instance for chaining
-     * @default { enable: false, addHeader: true, logOnComplete: false }
-     *
-     * @example
-     * ```typescript
-     * builder.withResponseTime({
-     *   enable: true,
-     *   addHeader: true,
-     *   logOnComplete: true
-     * })
-     * ```
-     */
-    withResponseTime(opts: Partial<NonNullable<ServerConfig['responseTime']>>): this;
-    /**
-     * Enables response time tracking with default or custom settings
-     *
-     * @param opts - Optional response time configuration
-     * @returns The builder instance for chaining
-     */
-    enableResponseTime(opts?: Omit<Partial<NonNullable<ServerConfig['responseTime']>>, 'enable'>): this;
-    /**
-     * Disables response time tracking
-     *
-     * @returns The builder instance for chaining
-     */
-    disableResponseTime(): this;
-    /**
-     * Configures the body parser middleware options for parsing request bodies.
-     *
-     * @param opts - Body parser configuration options
-     * @returns The builder instance for chaining
-     * @default { json: { limit: '1mb' }, urlencoded: { extended: true, limit: '1mb' } }
-     *
-     * @example
-     * ```typescript
-     * builder.withBodyParser({
-     *   json: {
-     *     limit: '1mb'
-     *   },
-     *   urlencoded: {
-     *     extended: true,
-     *     limit: '1mb'
-     *   }
-     * })
-     * ```
-     */
-    withBodyParser(opts: NonNullable<ServerConfig['bodyParser']>): this;
-    /**
-     * Configures cookie parsing middleware.
-     *
-     * @param opts - Cookie parser options or boolean (true to enable with defaults, false to disable)
-     * @returns The builder instance for chaining
-     * @default false
-     *
-     * @example
-     * ```typescript
-     * // Enable cookie parsing with default options
-     * builder.withCookies(true)
-     *
-     * // Enable cookie parsing with specific options
-     * builder.withCookies({
-     *   secret: 'your-secret-key',
-     *   secure: true
-     * })
-     * ```
-     */
-    withCookies(opts: ServerConfig['cookieParser']): this;
-    /**
-     * Adds a static folder to serve files from.
-     *
-     * @param folder - Static folder configuration
-     * @returns The builder instance for chaining
-     *
-     * @example
-     * ```typescript
-     * builder.withStaticFolder({
-     *   path: '/assets',
-     *   directory: './public',
-     *   options: { maxAge: '1d' }
-     * })
-     * ```
-     */
-    withStaticFolder(folder: NonNullable<ServerConfig['staticFolders']>[number]): this;
-    /**
-     * Sets global headers to be included in all responses.
-     *
-     * @param headers - Object containing header name/value pairs or functions that return values
-     * @returns The builder instance for chaining
-     * @default {}
-     *
-     * @example
-     * ```typescript
-     * builder.withGlobalHeaders({
-     *   'X-Powered-By': 'Catbee',
-     *   'Server-Time': () => new Date().toISOString()
-     * })
-     * ```
-     */
-    withGlobalHeaders(headers: NonNullable<ServerConfig['globalHeaders']>): this;
-    /**
-     * Sets a global prefix for all routes.
-     *
-     * @param prefix - The prefix to prepend to all routes (e.g., '/api/v1')
-     * @returns The builder instance for chaining
-     * @default '/'
-     *
-     * @example
-     * ```typescript
-     * builder.withGlobalPrefix('/api/v1')
-     * ```
-     */
-    withGlobalPrefix(prefix: string): this;
-    /**
-     * Applies custom configuration overrides directly.
-     *
-     * @param overrides - Custom configuration options to merge
-     * @returns The builder instance for chaining
-     *
-     * @example
-     * ```typescript
-     * builder.withCustom({
-     *   port: 8080,
-     *   customMiddleware: myMiddlewareFunction
-     * })
-     * ```
-     */
-    withCustom(overrides: Partial<ServerConfig>): this;
-    /**
-     * Configures HTTPS server options.
-     *
-     * @param opts - HTTPS configuration (key, cert, ca, passphrase, etc.)
-     * @returns The builder instance for chaining
-     *
-     * @example
-     * ```typescript
-     * builder.withHttps({
-     *   key: './localhost-key.pem',
-     *   cert: './localhost-cert.pem'
-     * })
-     * ```
-     */
-    withHttps(opts: NonNullable<ServerConfig['https']>): this;
-    /**
-     * Builds and returns the final server configuration.
-     *
-     * This method merges the user-specified configuration with default values,
-     * ensures all sections with 'enable' flags are properly structured, and
-     * produces the final configuration to be used by the server.
-     *
-     * @returns The complete ServerConfig object
-     *
-     * @example
-     * ```typescript
-     * const config = new ServerConfigBuilder()
-     *   .withPort(3000)
-     *   .withHost('localhost')
-     *   .withCors(true)
-     *   .build();
-     * ```
-     */
-    build(): Readonly<ServerConfig>;
-    private mergeConfig;
-    private setEnabled;
-}
-//# sourceMappingURL=server.builder.d.ts.map