@noony-serverless/core 0.6.0 → 0.8.0

package/build/core/handler.d.ts

@@ -23,6 +23,30 @@ export interface BaseMiddleware<T = unknown, U = unknown> {
  * process a request/response flow either before the main handler (via `before`),
  * after the main handler (via `after`), or handle errors (via `onError`).
  *
+ * @example Type-safe handler with explicit types
+ * interface LoginRequest {
+ *   email: string;
+ *   password: string;
+ * }
+ *
+ * interface AuthUser extends BaseAuthenticatedUser {
+ *   role: 'admin' | 'user';
+ * }
+ *
+ * const handler = new Handler<LoginRequest, AuthUser>()
+ *   .use(new ErrorHandlerMiddleware<LoginRequest, AuthUser>())
+ *   .use(new BodyValidationMiddleware<LoginRequest, AuthUser>(loginSchema))
+ *   .handle(loginController);  // ✅ No 'as any' needed
+ *
+ * @example Type inference with createTypedHandler
+ * async function loginController(context: Context<LoginRequest, AuthUser>) {
+ *   // controller logic
+ * }
+ *
+ * const handler = createTypedHandler(loginController)
+ *   .use(new ErrorHandlerMiddleware())  // Types inferred
+ *   .handle(loginController);  // ✅ No 'as any' needed
+ *
  * interface MessagePayload {
  *   action: string;
  *   data: Record<string, unknown>;
@@ -45,7 +69,7 @@ export declare class Handler<T = unknown, U = unknown> {
     private errorMiddlewares;
     private middlewaresPrecomputed;
     static use<T = unknown, U = unknown>(middleware: BaseMiddleware<T, U>): Handler<T, U>;
-    use<NewT = T, NewU = U>(middleware: BaseMiddleware<NewT, NewU>): Handler<NewT, NewU>;
+    use(middleware: BaseMiddleware<T, U>): Handler<T, U>;
     handle(handler: (context: Context<T, U>) => Promise<void | unknown>): Handler<T, U>;
     /**
      * Performance optimization: Pre-compute middleware arrays to avoid runtime array operations
@@ -69,4 +93,30 @@ export declare class Handler<T = unknown, U = unknown> {
      */
     executeGeneric(req: GenericRequest<T>, res: GenericResponse): Promise<void>;
 }
+/**
+ * Helper to infer types automatically from the controller function.
+ *
+ * This helper is a permanent feature that improves Developer Experience (DX).
+ * It eliminates the need to write explicit generic type parameters when they
+ * are already defined in the controller signature.
+ *
+ * @example
+ * // Controller with explicit types
+ * async function loginController(context: Context<LoginRequest, AuthUser>) {
+ *   const { email, password } = context.req.validatedBody!;
+ *   // ... authentication logic
+ * }
+ *
+ * // Helper infers LoginRequest and AuthUser automatically
+ * const handler = createTypedHandler(loginController)
+ *   .use(new ErrorHandlerMiddleware())  // Types inferred
+ *   .use(new BodyValidationMiddleware(loginSchema))
+ *   .handle(loginController);  // ✅ Types match perfectly, no 'as any' needed
+ *
+ * @template T - The request body type (inferred from controller's Context<T, U>)
+ * @template U - The user type (inferred from controller's Context<T, U>)
+ * @param controller - The controller function with explicit Context<T, U> types
+ * @returns A new Handler instance with types inferred from the controller
+ */
+export declare function createTypedHandler<T, U>(_controller: (context: Context<T, U>) => Promise<void | unknown>): Handler<T, U>;
 //# sourceMappingURL=handler.d.ts.map

package/build/core/handler.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Handler = void 0;
+exports.createTypedHandler = createTypedHandler;
 // Container import removed - now using containerPool for performance
 const core_1 = require("./core");
 const containerPool_1 = require("./containerPool");
@@ -12,6 +13,30 @@ const containerPool_1 = require("./containerPool");
  * process a request/response flow either before the main handler (via `before`),
  * after the main handler (via `after`), or handle errors (via `onError`).
  *
+ * @example Type-safe handler with explicit types
+ * interface LoginRequest {
+ *   email: string;
+ *   password: string;
+ * }
+ *
+ * interface AuthUser extends BaseAuthenticatedUser {
+ *   role: 'admin' | 'user';
+ * }
+ *
+ * const handler = new Handler<LoginRequest, AuthUser>()
+ *   .use(new ErrorHandlerMiddleware<LoginRequest, AuthUser>())
+ *   .use(new BodyValidationMiddleware<LoginRequest, AuthUser>(loginSchema))
+ *   .handle(loginController);  // ✅ No 'as any' needed
+ *
+ * @example Type inference with createTypedHandler
+ * async function loginController(context: Context<LoginRequest, AuthUser>) {
+ *   // controller logic
+ * }
+ *
+ * const handler = createTypedHandler(loginController)
+ *   .use(new ErrorHandlerMiddleware())  // Types inferred
+ *   .handle(loginController);  // ✅ No 'as any' needed
+ *
  * interface MessagePayload {
  *   action: string;
  *   data: Record<string, unknown>;
@@ -40,12 +65,8 @@ class Handler {
         return handler;
     }
     use(middleware) {
-        const handler = new Handler();
-        handler.baseMiddlewares = [
-            ...this.baseMiddlewares,
-            middleware,
-        ];
-        return handler;
+        this.baseMiddlewares.push(middleware);
+        return this;
     }
     handle(handler) {
         this.handler = handler;
@@ -152,4 +173,32 @@ class Handler {
     }
 }
 exports.Handler = Handler;
+/**
+ * Helper to infer types automatically from the controller function.
+ *
+ * This helper is a permanent feature that improves Developer Experience (DX).
+ * It eliminates the need to write explicit generic type parameters when they
+ * are already defined in the controller signature.
+ *
+ * @example
+ * // Controller with explicit types
+ * async function loginController(context: Context<LoginRequest, AuthUser>) {
+ *   const { email, password } = context.req.validatedBody!;
+ *   // ... authentication logic
+ * }
+ *
+ * // Helper infers LoginRequest and AuthUser automatically
+ * const handler = createTypedHandler(loginController)
+ *   .use(new ErrorHandlerMiddleware())  // Types inferred
+ *   .use(new BodyValidationMiddleware(loginSchema))
+ *   .handle(loginController);  // ✅ Types match perfectly, no 'as any' needed
+ *
+ * @template T - The request body type (inferred from controller's Context<T, U>)
+ * @template U - The user type (inferred from controller's Context<T, U>)
+ * @param controller - The controller function with explicit Context<T, U> types
+ * @returns A new Handler instance with types inferred from the controller
+ */
+function createTypedHandler(_controller) {
+    return new Handler();
+}
 //# sourceMappingURL=handler.js.map

package/build/core/logger.js

@@ -5,7 +5,6 @@ const otel_helper_1 = require("../utils/otel.helper");
 // Import trace for dynamic OTEL operations
 let trace = null;
 try {
-    // eslint-disable-next-line @typescript-eslint/no-var-requires
     trace = require('@opentelemetry/api').trace;
 }
 catch {

package/build/core/telemetry/providers/opentelemetry-provider.js

@@ -76,19 +76,14 @@ class OpenTelemetryProvider {
     async initialize(config) {
         try {
             // Dynamic require to avoid compile-time dependency on OTEL packages
-            // eslint-disable-next-line @typescript-eslint/no-var-requires
             const otelApi = require('@opentelemetry/api');
             const { trace, metrics } = otelApi;
-            // eslint-disable-next-line @typescript-eslint/no-var-requires
             const sdkNode = require('@opentelemetry/sdk-node');
             const { NodeSDK } = sdkNode;
-            // eslint-disable-next-line @typescript-eslint/no-var-requires
             const exporterHttp = require('@opentelemetry/exporter-trace-otlp-http');
             const { OTLPTraceExporter } = exporterHttp;
-            // eslint-disable-next-line @typescript-eslint/no-var-requires
             const resources = require('@opentelemetry/resources');
             const { Resource } = resources;
-            // eslint-disable-next-line @typescript-eslint/no-var-requires
             const semConv = require('@opentelemetry/semantic-conventions');
             const { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION } = semConv;
             // Create resource with service metadata
@@ -201,7 +196,6 @@ class OpenTelemetryProvider {
             return;
         try {
             // Try to get active span for correlation
-            // eslint-disable-next-line @typescript-eslint/no-var-requires
             const { trace } = require('@opentelemetry/api');
             const span = trace.getActiveSpan();
             const traceContext = span
@@ -274,7 +268,6 @@ class OpenTelemetryProvider {
             // Add Cloud Trace propagator (priority 1 - reads X-Cloud-Trace-Context from GCP)
             if (useCloudTrace) {
                 try {
-                    // eslint-disable-next-line @typescript-eslint/no-var-requires
                     const cloudPropagator = require('@google-cloud/opentelemetry-cloud-trace-propagator');
                     const { CloudPropagator } = cloudPropagator;
                     propagators.push(new CloudPropagator());
@@ -287,7 +280,6 @@ class OpenTelemetryProvider {
             }
             // Add W3C Trace Context propagator (priority 2 - standard traceparent)
             if (useW3C) {
-                // eslint-disable-next-line @typescript-eslint/no-var-requires
                 const otelCore = require('@opentelemetry/core');
                 const { W3CTraceContextPropagator } = otelCore;
                 propagators.push(new W3CTraceContextPropagator());
@@ -295,7 +287,6 @@ class OpenTelemetryProvider {
             }
             // If multiple propagators, use CompositePropagator
             if (propagators.length > 1) {
-                // eslint-disable-next-line @typescript-eslint/no-var-requires
                 const otelCore = require('@opentelemetry/core');
                 const { CompositePropagator } = otelCore;
                 return new CompositePropagator({ propagators });
@@ -305,7 +296,6 @@ class OpenTelemetryProvider {
                 return propagators[0];
             }
             // Fallback to W3C if no propagators configured
-            // eslint-disable-next-line @typescript-eslint/no-var-requires
             const otelCore = require('@opentelemetry/core');
             const { W3CTraceContextPropagator } = otelCore;
             return new W3CTraceContextPropagator();
@@ -314,7 +304,6 @@ class OpenTelemetryProvider {
             console.error('[Telemetry] Failed to create propagator:', error);
             // Return W3C propagator as safe fallback
             try {
-                // eslint-disable-next-line @typescript-eslint/no-var-requires
                 const otelCore = require('@opentelemetry/core');
                 const { W3CTraceContextPropagator } = otelCore;
                 return new W3CTraceContextPropagator();

package/build/middlewares/dependencyInjectionMiddleware.js

@@ -1,5 +1,4 @@
 "use strict";
-/* eslint-disable @typescript-eslint/no-explicit-any */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.dependencyInjection = exports.DependencyInjectionMiddleware = void 0;
 const containerPool_1 = require("../core/containerPool");

package/build/middlewares/openTelemetryMiddleware.js

@@ -188,7 +188,6 @@ class OpenTelemetryMiddleware {
                     const carrier = (0, pubsub_trace_utils_1.createParentContext)(traceContext);
                     // Try to extract parent context using OpenTelemetry API
                     try {
-                        // eslint-disable-next-line @typescript-eslint/no-var-requires
                         const otelApi = require('@opentelemetry/api');
                         const { propagation, context: otelContext } = otelApi;
                         // Extract parent context from carrier
@@ -247,7 +246,6 @@ class OpenTelemetryMiddleware {
                 });
                 // Add X-Trace-Id header with clean trace ID
                 try {
-                    // eslint-disable-next-line @typescript-eslint/no-var-requires
                     const otelApi = require('@opentelemetry/api');
                     const { context: otelContext, trace } = otelApi;
                     // Get span from active context

package/build/utils/otel.helper.js

@@ -14,7 +14,6 @@ exports.isOTELInstalled = exports.isOTELActive = exports.createCloudLoggingEntry
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 let trace;
 try {
-    // eslint-disable-next-line @typescript-eslint/no-var-requires
     const otelApi = require('@opentelemetry/api');
     trace = otelApi.trace;
 }

package/build/utils/pubsub-trace.utils.js

@@ -84,7 +84,6 @@ function injectTraceContext(message, context) {
     const attributes = message.attributes || {};
     try {
         // Try to use OpenTelemetry API if available
-        // eslint-disable-next-line @typescript-eslint/no-var-requires
         const otelApi = require('@opentelemetry/api');
         const { trace, propagation, context: otelContext } = otelApi;
         // Get current context (either from provided context or active context)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noony-serverless/core",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "A Middy base framework compatible with Firebase and GCP Cloud Functions with TypeScript",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -38,36 +38,40 @@
     "lint": "eslint . --ext .ts",
     "lint:fix": "eslint . --ext .ts --fix",
     "format": "prettier --write \"**/*.{ts,js,json}\"",
-    "format:check": "prettier --check \"src/**/*.{ts,js,json}\""
+    "format:check": "prettier --check \"src/**/*.{ts,js,json}\"",
+    "audit": "npm audit --audit-level=moderate",
+    "audit:fix": "npm audit fix",
+    "audit:production": "npm audit --omit=dev --audit-level=moderate"
   },
   "dependencies": {
     "@google-cloud/firestore": "^8.2.0",
     "@google-cloud/functions-framework": "^5.0.0",
     "@google-cloud/pubsub": "^5.2.2",
     "@types/jsonwebtoken": "^9.0.10",
-    "axios": "^1.11.0",
-    "fastify": "^5.7.1",
+    "axios": "^1.13.4",
+    "fastify": "^5.7.4",
     "firebase-admin": "^13.6.0",
     "firebase-functions": "^6.6.0",
     "jsonwebtoken": "^9.0.3",
     "reflect-metadata": "^0.2.2",
     "typedi": "^0.10.0",
-    "zod": "^4.3.5"
+    "zod": "^4.3.6"
   },
   "devDependencies": {
     "@types/jest": "^29.5.14",
     "@types/module-alias": "^2.0.4",
-    "@types/node": "^20.19.30",
-    "@typescript-eslint/eslint-plugin": "^6.21.0",
-    "@typescript-eslint/parser": "^6.21.0",
+    "@types/node": "^20.19.31",
+    "@typescript-eslint/eslint-plugin": "^8.54.0",
+    "@typescript-eslint/parser": "^8.54.0",
     "concurrently": "^9.2.1",
-    "eslint": "^8.57.1",
-    "eslint-config-prettier": "^9.1.2",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.5",
     "firebase-functions-test": "^3.4.1",
+    "globals": "^17.3.0",
     "jest": "^29.7.0",
     "module-alias": "^2.2.3",
-    "prettier": "^3.8.0",
+    "prettier": "^3.8.1",
     "ts-jest": "^29.4.6",
     "typescript": "^5.9.3"
   },
@@ -128,7 +132,9 @@
     "@google-cloud/opentelemetry-cloud-trace-propagator": "^0.21.0"
   },
   "overrides": {
-    "body-parser": "^2.2.2"
+    "body-parser": "^2.2.2",
+    "fast-xml-parser": "^5.3.4",
+    "lodash": "^4.17.21"
   },
   "directories": {
     "doc": "docs",