Feature express server by cyber-hari · Pull Request #6 · catbee-technologies/catbee-utils

cyber-hari · 2025-08-23T17:40:35Z

No description provided.

github-actions · 2025-08-23T17:41:11Z

File	% Stmts	% Branch	% Funcs	% Lines	Uncovered Line #s
All files	84.68	67.97	87.36	84.81
src	100	100	100	100
config.ts	100	100	100	100
src/servers	8.48	0	0	8.84
express.server.ts	8.48	0	0	8.84	275-292,331-1149
src/utils	94.72	85.47	96.94	95.23
array.utils.ts	99.39	97.27	100	100	212
async.utils.ts	93.18	83.6	92.3	92.99	107-108,153,174-175,281-288,316,484-486
cache.utils.ts	97.67	89.79	100	97.56	278-279
context-store.utils.ts	92.85	76.19	95.45	92.85	181,201,219,253
crypto.utils.ts	94.18	75.34	100	96.34	315-316,383
decorators.utils.ts	100	88.04	100	100	485-486,506,522-528,546-552
dir.utils.ts	94.65	82.35	89.74	95.45	247,283-294,416
env.utils.ts	89.05	80.47	100	89.73	341,384,508,513,576,581-584,618,623-626,672,691,719,812-813,832-844
exception.utils.ts	89.32	75	100	89.32	313,319-321,325-329,333,337-343
fs.utils.ts	91.07	88	100	90.82	122,178-183,253-255,301
http-status-codes.ts	100	100	100	100
id.utils.ts	100	80	100	100	83
logger.utils.ts	88.88	72.34	85	90.47	83-91,238
middleware.utils.ts	95.89	80.64	94.44	95.83	99-100,237
obj.utils.ts	96.87	96.51	100	97.5	192,209
request.utils.ts	92.42	80	100	95.16	181,186-187
response.utils.ts	100	100	100	100
string.utils.ts	100	100	100	100
url.utils.ts	97.8	90.9	100	100	69,101,159,273
validate.utils.ts	98.09	97.14	100	100	37,77
-------------------------	---------	----------	---------	---------	---------------------------------------------------------------------

github-actions · 2025-08-23T17:41:16Z

Package	Line Rate	Branch Rate	Health
src	100%	100%	✔
src.servers	9%	0%	❌
src.utils	95%	85%	✔
Summary	85% (1827 / 2154)	68% (1089 / 1602)	✔

Copilot

Pull Request Overview

This PR adds a feature-complete Express server implementation with enterprise-grade capabilities including security middleware, monitoring, health checks, and graceful shutdown handling. It also updates the project license from Apache-2.0 to MIT and adds license headers across all source files.

Implements a comprehensive ExpressServer class with production-ready features
Updates middleware utilities to support new server functionality
Changes project license from Apache-2.0 to MIT with automated license header management

Reviewed Changes

Copilot reviewed 30 out of 31 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
src/servers/express.server.ts	New Express server implementation with security, monitoring, and lifecycle management
src/utils/middleware.utils.ts	Enhanced middleware with better error handling and request timeout support
tests/servers/express.server.test.ts	Basic test structure for Express server (currently skipped)
tests/utils/middleware.utils.test.ts	Updated middleware tests with improved response time testing
package.json	Updated dependencies, license change, and build script modifications
LICENSE	Changed from Apache-2.0 to MIT license
Multiple src files	Added MIT license headers to all source files

Comments suppressed due to low confidence (1)

src/servers/express.server.ts:1

The code assigns to req.id but the type declaration shows it as optional (id?: string). This could lead to type confusion since the middleware always sets this property. Consider making the type declaration non-optional or using a more explicit assignment approach.

/*

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

src/servers/express.server.ts

…are utilities - Implement Express server framework with enterprise-ready features: - Security middleware (helmet, CORS, rate limiting) - Monitoring and health checks - Graceful shutdown support - Extensibility for future features - Add comprehensive test coverage for server functionality - Update deepObjMerge utility to support: - Circular references - Special objects (Date, RegExp, Set, Map) - TypedArrays and complex cloning scenarios

Copilot

Pull Request Overview

This PR introduces an Express server implementation with comprehensive enterprise features. It adds a production-ready Express server class with security, monitoring, performance optimization, and reliability features, along with a fluent configuration builder pattern and updated test coverage.

Adds ExpressServer class with security (CORS, Helmet, rate limiting), monitoring (metrics, health checks), and reliability features (graceful shutdown)
Implements ServerConfigBuilder for fluent server configuration with validation
Updates existing utilities with MIT license headers and enhances deepObjMerge function with comprehensive object cloning

Reviewed Changes

Copilot reviewed 40 out of 41 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
tests/utils/obj.utils.test.ts	Comprehensive test coverage for enhanced deepObjMerge function with object cloning capabilities
tests/utils/middleware.utils.test.ts	Updated middleware tests with corrected error message and logging parameter
tests/servers/server.test.ts	Full test suite for ExpressServer including lifecycle, routes, health checks, and graceful shutdown
tests/servers/server.builder.test.ts	Complete test coverage for ServerConfigBuilder validation and configuration methods
tests/config.test.ts	Updated config tests to include new logger properties
src/utils/*.ts	Added MIT license headers to all utility files
src/types/server.ts	Comprehensive server configuration interface with detailed documentation
src/servers/server.ts	Production-ready Express server implementation with enterprise features
src/servers/server.builder.ts	Fluent builder pattern for server configuration with validation
src/config.ts	Enhanced configuration with server defaults and Express request interface extension

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

Copilot · 2025-08-27T09:58:42Z

tests/utils/obj.utils.test.ts

+
+    it('should clone Date objects', () => {
+      const d = new Date();
+      const result: any = deepObjMerge({}, { d });


[nitpick] Consider using a more specific type instead of 'any' for better type safety. You could define an interface or use a generic type parameter.

Suggested change

const result: any = deepObjMerge({}, { d });

const result: { d: Date } = deepObjMerge({}, { d });

Copilot · 2025-08-27T09:58:43Z

tests/utils/obj.utils.test.ts

+
+    it('should clone RegExp objects', () => {
+      const r = /abc/gi;
+      const result: any = deepObjMerge({}, { r });


[nitpick] Consider using a more specific type instead of 'any' for better type safety. You could define an interface or use a generic type parameter.

Suggested change

const result: any = deepObjMerge({}, { r });

const result: { r: RegExp } = deepObjMerge({}, { r });

Copilot · 2025-08-27T09:58:43Z

src/servers/server.ts

+        name: `${safeAppName}_http_request_duration_seconds`,
+        help: 'Duration of HTTP requests by route',
+        labelNames: ['method', 'route', 'status'],
+        buckets: [0.1, 0.3, 0.5, 0.7, 1, 3, 5, 7, 10],


[nitpick] Consider extracting histogram buckets to a named constant for better maintainability and potential reuse across metrics.

Suggested change

buckets: [0.1, 0.3, 0.5, 0.7, 1, 3, 5, 7, 10],

buckets: HTTP_REQUEST_DURATION_BUCKETS,

Copilot · 2025-08-27T09:58:43Z

src/servers/server.ts

+        name: `${safeAppName}_http_request_size_bytes`,
+        help: 'Size of HTTP request bodies',
+        labelNames: ['method', 'route'],
+        buckets: [100, 1000, 10000, 100000, 1000000],


[nitpick] Consider extracting size histogram buckets to a named constant for better maintainability and potential reuse across metrics.

Suggested change

buckets: [100, 1000, 10000, 100000, 1000000],

buckets: REQUEST_SIZE_BUCKETS,

cyber-hari requested a review from Copilot August 23, 2025 17:40

github-actions bot added test utils types dependency feature scripts labels Aug 23, 2025

cyber-hari changed the base branch from main to feature-next August 23, 2025 17:40