@avleon/core 0.0.43 → 0.0.44

package/README.md

@@ -38,6 +38,7 @@ Avleon is a powerful, TypeScript-based web framework built on top of Fastify, de
   - [mapPut](#mapput)
   - [mapDelete](#mapdelete)
 - [Testing](#testing)
+- [WebSocket](#websocket-intregation-socketio)
 
 ## Features
 
@@ -68,7 +69,6 @@ pnpm dlx @avleon/cli new myapp
 ## Quick Start
 
 ### Minimal
-
 ```typescript
 import { Avleon } from "@avleon/core";
 
@@ -78,7 +78,6 @@ app.run(); // or app.run(3000);
 ```
 
 ### Controller Based
-
 ```typescript
 import { Avleon, ApiController, Get, Results } from "@avleon/core";
 
@@ -100,7 +99,6 @@ app.run();
 ## Core Concepts
 
 ### Application Creation
-
 Avleon provides a builder pattern for creating applications:
 
 ```typescript
@@ -118,7 +116,6 @@ app.run(); // or app.run(port)
 ```
 
 ### Controllers
-
 Controllers are the entry points for your API requests. They are defined using the `@ApiController` decorator:
 
 ```typescript
@@ -129,7 +126,6 @@ class UserController {
 ```
 
 ### Route Methods
-
 Define HTTP methods using decorators:
 
 ```typescript
@@ -155,7 +151,6 @@ async deleteUser(@Param('id') id: string) {
 ```
 
 ### Parameter Decorators
-
 Extract data from requests using parameter decorators:
 
 ```typescript
@@ -190,7 +185,6 @@ async uploadFiles(
 ``` -->
 
 ### Error Handling
-
 Return standardized responses using the `HttpResponse` and `HttpExceptions` class:
 
 ```typescript
@@ -207,7 +201,6 @@ async getUser(@Param('id') id: string) {
 ```
 
 ### Middleware
-
 Create and apply middleware for cross-cutting concerns:
 
 ```typescript
@@ -240,7 +233,6 @@ class UserController {
 ```
 
 ### Authentication & Authorization
-
 Secure your API with authentication and authorization:
 
 ```typescript
@@ -293,7 +285,6 @@ class AdminController {
 ```
 
 ### Validation
-
 Validate request data using class-validator:
 
 ```typescript
@@ -340,7 +331,6 @@ class UserDto {
 ```
 
 ### OpenAPI Documentation
-
 Generate API documentation automatically:
 
 ```typescript 
@@ -376,7 +366,6 @@ app.useOpenApi(OpenApiConfig, (config) => {
 ### Database Integration
 
 ## 1. Knex
-
 ```typescript
 const app = Avleon.createApplication();
 app.useKnex({
@@ -417,7 +406,6 @@ app.useKenx(KnexConfig)
 ```
 
 ### Exmaple uses
-
 ```typescript
 import { DB, AppService } from "@avleon/core";
 
@@ -505,7 +493,6 @@ export class UserService {
 ```
 
 ### File Uploads & File Storage
-
 Handle file uploads with multipart support:
 
 ```typescript
@@ -555,7 +542,6 @@ async uploadSingleFile(@UploadFile('file') file: MultipartFile) {
 ```
 
 ### Static Files
-
 Serve static files:
 
 ```typescript
@@ -569,15 +555,12 @@ app.useStaticFiles({
 ```
 
 ## Configuration
-
 Coming soon...
 
 ## Route Mapping
-
 Avleon provides several methods for mapping routes in your application:
 
 ### mapGet
-
 The `mapGet` method is used to define GET routes in your application. It takes a path string and a handler function as parameters.
 
 ```typescript
@@ -588,7 +571,6 @@ app.mapGet("/users", async (req, res) => {
 ```
 
 ### mapPost
-
 The `mapPost` method is used to define POST routes in your application. It takes a path string and a handler function as parameters.
 
 ```typescript
@@ -601,7 +583,6 @@ app.mapPost("/users", async (req, res) => {
 ```
 
 ### mapPut
-
 The `mapPut` method is used to define PUT routes in your application. It takes a path string and a handler function as parameters.
 
 ```typescript
@@ -615,7 +596,6 @@ app.mapPut("/users/:id", async (req, res) => {
 ```
 
 ### mapDelete
-
 The `mapDelete` method is used to define DELETE routes in your application. It takes a path string and a handler function as parameters.
 
 ```typescript
@@ -628,7 +608,6 @@ app.mapDelete("/users/:id", async (req, res) => {
 ```
 
 ### Add openapi and middleware support for inline route
-
 Each of these methods returns a route object that can be used to add middleware or Swagger documentation to the route.
 
 ```typescript
@@ -662,6 +641,30 @@ app
     },
   });
 ```
+### Websocket Intregation (Socket.io)
+```typescript
+app.useSocketIO({
+  cors:{origin:"*"}
+})
+```
+Now in controller or service use EventDispatcher
+
+
+```typescript
+export class UserService{
+  constructor(
+    private readonly dispatcher: EventDispatcher
+  )
+
+  async create(){
+    ...rest code
+
+    await this.dispatcher.dispatch("users:notifications",{created:true, userId: newUser.Id})
+  }
+  
+}
+```
+
 
 ### Testing
 

package/dist/helpers.d.ts

@@ -31,4 +31,14 @@ type ValidationError = {
 export declare function validateRequestBody(target: Constructor, value: object, options?: "object" | "array"): ValidationError;
 export declare function pick<T extends object>(obj: T, paths: string[]): Partial<T>;
 export declare function exclude<T extends object>(obj: T | T[], paths: string[]): Partial<T> | Partial<T>[];
+export declare function autoCast(value: any, typeHint?: any, schema?: any): any;
+/**
+ * Deeply normalizes query strings into nested JS objects.
+ * Supports:
+ *  - filter[name]=john
+ *  - filter[user][age]=25
+ *  - filter[tags][]=a&filter[tags][]=b
+ *  - filter=name&filter=sorna
+ */
+export declare function normalizeQueryDeep(query: Record<string, any>): Record<string, any>;
 export {};

package/dist/helpers.js

@@ -21,6 +21,8 @@ exports.validateObjectByInstance = validateObjectByInstance;
 exports.validateRequestBody = validateRequestBody;
 exports.pick = pick;
 exports.exclude = exclude;
+exports.autoCast = autoCast;
+exports.normalizeQueryDeep = normalizeQueryDeep;
 /**
  * @copyright 2024
  * @author Tareq Hossain
@@ -290,3 +292,128 @@ function exclude(obj, paths) {
     }
     return clone;
 }
+function autoCast(value, typeHint, schema) {
+    var _a, _b;
+    if (value === null || value === undefined)
+        return value;
+    if (Array.isArray(value)) {
+        const elementType = Array.isArray(typeHint) ? typeHint[0] : undefined;
+        return value.map((v) => autoCast(v, elementType));
+    }
+    if (typeof value === "object" && !(value instanceof Date)) {
+        const result = {};
+        for (const [key, val] of Object.entries(value)) {
+            let fieldType = undefined;
+            if ((_b = (_a = schema === null || schema === void 0 ? void 0 : schema.properties) === null || _a === void 0 ? void 0 : _a[key]) === null || _b === void 0 ? void 0 : _b.type) {
+                const t = schema.properties[key].type;
+                fieldType =
+                    t === "integer" || t === "number"
+                        ? Number
+                        : t === "boolean"
+                            ? Boolean
+                            : t === "array"
+                                ? Array
+                                : t === "object"
+                                    ? Object
+                                    : String;
+            }
+            result[key] = autoCast(val, fieldType);
+        }
+        return result;
+    }
+    if (typeof value !== "string")
+        return value;
+    const trimmed = value.trim();
+    if (typeHint === Boolean || trimmed.toLowerCase() === "true")
+        return true;
+    if (trimmed.toLowerCase() === "false")
+        return false;
+    if (typeHint === Number || (!isNaN(Number(trimmed)) && trimmed !== "")) {
+        const n = Number(trimmed);
+        if (!isNaN(n))
+            return n;
+    }
+    if ((trimmed.startsWith("{") && trimmed.endsWith("}")) ||
+        (trimmed.startsWith("[") && trimmed.endsWith("]"))) {
+        try {
+            const parsed = JSON.parse(trimmed);
+            return autoCast(parsed, typeHint, schema);
+        }
+        catch (_c) {
+            return trimmed;
+        }
+    }
+    if (typeHint === Date ||
+        /^\d{4}-\d{2}-\d{2}([Tt]\d{2}:\d{2})?/.test(trimmed)) {
+        const d = new Date(trimmed);
+        if (!isNaN(d.getTime()))
+            return d;
+    }
+    return trimmed;
+}
+/**
+ * Deeply normalizes query strings into nested JS objects.
+ * Supports:
+ *  - filter[name]=john
+ *  - filter[user][age]=25
+ *  - filter[tags][]=a&filter[tags][]=b
+ *  - filter=name&filter=sorna
+ */
+function normalizeQueryDeep(query) {
+    const result = {};
+    const setDeep = (obj, path, value) => {
+        let current = obj;
+        for (let i = 0; i < path.length; i++) {
+            const key = path[i];
+            const nextKey = path[i + 1];
+            if (i === path.length - 1) {
+                if (key === "") {
+                    if (!Array.isArray(current))
+                        current = [];
+                    current.push(value);
+                }
+                else if (Array.isArray(current[key])) {
+                    current[key].push(value);
+                }
+                else if (current[key] !== undefined) {
+                    current[key] = [current[key], value];
+                }
+                else {
+                    current[key] = value;
+                }
+            }
+            else {
+                if (!current[key]) {
+                    current[key] = nextKey === "" || /^\d+$/.test(nextKey) ? [] : {};
+                }
+                current = current[key];
+            }
+        }
+    };
+    for (const [rawKey, rawValue] of Object.entries(query)) {
+        const path = [];
+        const regex = /([^\[\]]+)|(\[\])/g;
+        let match;
+        while ((match = regex.exec(rawKey)) !== null) {
+            if (match[1])
+                path.push(match[1]);
+            else if (match[2])
+                path.push("");
+        }
+        if (path.length === 0) {
+            if (result[rawKey]) {
+                if (Array.isArray(result[rawKey]))
+                    result[rawKey].push(rawValue);
+                else
+                    result[rawKey] = [result[rawKey], rawValue];
+            }
+            else {
+                result[rawKey] = rawValue;
+            }
+        }
+        else {
+            setDeep(result, path, rawValue);
+        }
+    }
+    return result;
+}

package/dist/icore.js

@@ -503,29 +503,25 @@ class AvleonApplication {
         // Initialize args array with correct length
         const maxIndex = Math.max(...meta.params.map((p) => p.index || 0), ...meta.query.map((q) => q.index), ...meta.body.map((b) => b.index), ...meta.currentUser.map((u) => u.index), ...meta.headers.map((h) => h.index), ...(((_a = meta.request) === null || _a === void 0 ? void 0 : _a.map((r) => r.index)) || []), ...(((_b = meta.file) === null || _b === void 0 ? void 0 : _b.map((f) => f.index)) || []), ...(((_c = meta.files) === null || _c === void 0 ? void 0 : _c.map((f) => f.index)) || []), -1) + 1;
         const args = new Array(maxIndex).fill(undefined);
-        // Map route parameters
         meta.params.forEach((p) => {
-            args[p.index] =
-                p.key == "all" ? { ...req.query } : req.params[p.key] || null;
+            var _a;
+            const raw = p.key === "all" ? { ...req.params } : ((_a = req.params[p.key]) !== null && _a !== void 0 ? _a : null);
+            args[p.index] = (0, helpers_1.autoCast)(raw, p.dataType, p.schema);
         });
-        // Map query parameters
         meta.query.forEach((q) => {
-            args[q.index] = q.key == "all" ? { ...req.query } : req.query[q.key];
+            const raw = q.key === "all" ? (0, helpers_1.normalizeQueryDeep)({ ...req.query }) : req.query[q.key];
+            args[q.index] = (0, helpers_1.autoCast)(raw, q.dataType, q.schema);
         });
-        // Map body data (including form data)
         meta.body.forEach((body) => {
             args[body.index] = { ...req.body, ...req.formData };
         });
-        // Map current user
         meta.currentUser.forEach((user) => {
             args[user.index] = req.user;
         });
-        // Map headers
         meta.headers.forEach((header) => {
             args[header.index] =
                 header.key === "all" ? { ...req.headers } : req.headers[header.key];
         });
-        // Map request object
         if (meta.request && meta.request.length > 0) {
             meta.request.forEach((r) => {
                 args[r.index] = req;
@@ -538,11 +534,9 @@ class AvleonApplication {
             ((_d = req.headers["content-type"]) === null || _d === void 0 ? void 0 : _d.startsWith("multipart/form-data"))) {
             const files = await req.saveRequestFiles();
             if (!files || files.length === 0) {
-                // Only throw error if files are explicitly required
                 if (meta.files && meta.files.length > 0) {
                     throw new exceptions_1.BadRequestException({ error: "No files uploaded" });
                 }
-                // For single file (@File()), set to null
                 if (meta.file && meta.file.length > 0) {
                     meta.file.forEach((f) => {
                         args[f.index] = null;
@@ -550,7 +544,6 @@ class AvleonApplication {
                 }
             }
             else {
-                // Create file info objects
                 const fileInfo = files.map((file) => ({
                     type: file.type,
                     filepath: file.filepath,
@@ -559,16 +552,14 @@ class AvleonApplication {
                     encoding: file.encoding,
                     mimetype: file.mimetype,
                     fields: file.fields,
+                    toBuffer: file.toBuffer,
                 }));
-                // Handle single file decorator (@File())
                 if (meta.file && meta.file.length > 0) {
                     meta.file.forEach((f) => {
                         if (f.fieldName === "all") {
-                            // Return first file if "all" is specified
                             args[f.index] = fileInfo[0] || null;
                         }
                         else {
-                            // Find specific file by fieldname
                             const file = fileInfo.find((x) => x.fieldname === f.fieldName);
                             if (!file) {
                                 throw new exceptions_1.BadRequestException(`File field "${f.fieldName}" not found in uploaded files`);
@@ -594,12 +585,10 @@ class AvleonApplication {
             }
         }
         else if (needsFiles) {
-            // Files expected but request is not multipart/form-data
             throw new exceptions_1.BadRequestException({
                 error: "Invalid content type. Expected multipart/form-data for file uploads",
             });
         }
-        // Cache the result
         cache.set(cacheKey, args);
         return args;
     }
@@ -830,6 +819,7 @@ class AvleonApplication {
             return reply.status(500).send({
                 code: 500,
                 message: error.message || "Internal Server Error",
+                ...(process.env.NODE_ENV === "development" && { stack: error.stack }),
             });
         });
         await this.app.ready();

package/dist/params.js

@@ -13,45 +13,52 @@ const swagger_schema_1 = require("./swagger-schema");
 function createParamDecorator(type) {
     return function (key, options = {}) {
         return function (target, propertyKey, parameterIndex) {
-            var _a;
-            const existingParams = Reflect.getMetadata(type, target, propertyKey) || [];
-            const parameterTypes = Reflect.getMetadata("design:paramtypes", target, propertyKey) || [];
-            const functionSource = target[propertyKey].toString();
-            const paramNames = (_a = functionSource
-                .match(/\(([^)]*)\)/)) === null || _a === void 0 ? void 0 : _a[1].split(",").map((name) => name.trim());
-            const paramDataType = parameterTypes[parameterIndex];
-            existingParams.push({
-                index: parameterIndex,
-                key: key ? key : "all",
-                name: paramNames[parameterIndex],
-                required: options.required == undefined ? true : options.required,
-                validate: options.validate == undefined ? true : options.validate,
-                dataType: (0, helpers_1.getDataType)(paramDataType),
-                validatorClass: (0, helpers_1.isClassValidatorClass)(paramDataType),
-                schema: (0, helpers_1.isClassValidatorClass)(paramDataType)
-                    ? (0, swagger_schema_1.generateSwaggerSchema)(paramDataType)
-                    : null,
-                type,
-            });
+            var _a, _b, _c, _d;
+            // Determine correct meta key
+            let metaKey;
             switch (type) {
                 case "route:param":
-                    Reflect.defineMetadata(container_1.PARAM_META_KEY, existingParams, target, propertyKey);
+                    metaKey = container_1.PARAM_META_KEY;
                     break;
                 case "route:query":
-                    Reflect.defineMetadata(container_1.QUERY_META_KEY, existingParams, target, propertyKey);
+                    metaKey = container_1.QUERY_META_KEY;
                     break;
                 case "route:body":
-                    Reflect.defineMetadata(container_1.REQUEST_BODY_META_KEY, existingParams, target, propertyKey);
+                    metaKey = container_1.REQUEST_BODY_META_KEY;
                     break;
                 case "route:user":
-                    Reflect.defineMetadata(container_1.REQUEST_USER_META_KEY, existingParams, target, propertyKey);
+                    metaKey = container_1.REQUEST_USER_META_KEY;
                     break;
                 case "route:header":
-                    Reflect.defineMetadata(container_1.REQUEST_HEADER_META_KEY, existingParams, target, propertyKey);
+                    metaKey = container_1.REQUEST_HEADER_META_KEY;
                     break;
                 default:
-                    break;
+                    throw new Error(`Unknown param decorator type: ${String(type)}`);
             }
+            // Retrieve and preserve existing metadata
+            const existingParams = Reflect.getMetadata(metaKey, target, propertyKey) || [];
+            // Get parameter names (fallback safe)
+            const functionSource = target[propertyKey].toString();
+            const paramNames = ((_b = (_a = functionSource.match(/\(([^)]*)\)/)) === null || _a === void 0 ? void 0 : _a[1]) === null || _b === void 0 ? void 0 : _b.split(",").map((n) => n.trim())) || [];
+            // Determine the param type
+            const parameterTypes = Reflect.getMetadata("design:paramtypes", target, propertyKey) || [];
+            const paramDataType = parameterTypes[parameterIndex];
+            // Append new parameter
+            existingParams.push({
+                index: parameterIndex,
+                key: typeof key === "string" ? key : "all",
+                name: paramNames[parameterIndex],
+                required: (_c = options.required) !== null && _c !== void 0 ? _c : true,
+                validate: (_d = options.validate) !== null && _d !== void 0 ? _d : true,
+                dataType: (0, helpers_1.getDataType)(paramDataType),
+                validatorClass: (0, helpers_1.isClassValidatorClass)(paramDataType),
+                schema: (0, helpers_1.isClassValidatorClass)(paramDataType)
+                    ? (0, swagger_schema_1.generateSwaggerSchema)(paramDataType)
+                    : null,
+                type,
+            });
+            // Save back using the correct meta key
+            Reflect.defineMetadata(metaKey, existingParams, target, propertyKey);
         };
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@avleon/core",
-  "version": "0.0.43",
+  "version": "0.0.44",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "keywords": [