tspace-spear 1.2.0 → 1.2.1

package/{build → dist}/lib/core/decorators/context.js

@@ -1,6 +1,24 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Cookies = exports.Query = exports.Params = exports.Files = exports.Body = void 0;
+/**
+ * Extract specific fields from `ctx.body`.
+ *
+ * This decorator filters the request body and keeps only the
+ * specified keys. The filtered result replaces `ctx.body`
+ * before the controller method is executed.
+ *
+ * @example
+ * ```ts
+ * @Body('email', 'password')
+ * async login(ctx: T.Context) {
+ *   // ctx.body = { email: "...", password: "..." }
+ * }
+ * ```
+ *
+ * @param {...string} bodyParms - Body field names to extract.
+ * @returns {MethodDecorator}
+ */
 const Body = (...bodyParms) => {
     return function (target, key, descriptor) {
         const originalMethod = descriptor.value;
@@ -14,6 +32,23 @@ const Body = (...bodyParms) => {
     };
 };
 exports.Body = Body;
+/**
+ * Extract specific uploaded files from `ctx.files`.
+ *
+ * Filters uploaded files and keeps only the specified
+ * file field names before executing the controller method.
+ *
+ * @example
+ * ```ts
+ * \@Files('avatar', 'resume')
+ * async upload(ctx: T.Context) {
+ *   // ctx.files = { avatar: File, resume: File }
+ * }
+ * ```
+ *
+ * @param {...string} filesParms - File field names to extract.
+ * @returns {MethodDecorator}
+ */
 const Files = (...filesParms) => {
     return function (target, key, descriptor) {
         const originalMethod = descriptor.value;
@@ -27,6 +62,23 @@ const Files = (...filesParms) => {
     };
 };
 exports.Files = Files;
+/**
+ * Extract specific route parameters from `ctx.params`.
+ *
+ * Filters route parameters and keeps only the specified
+ * parameter names.
+ *
+ * @example
+ * ```ts
+ * \@Params('id')
+ * async getUser(ctx: T.Context) {
+ *   // ctx.params = { id: "123" }
+ * }
+ * ```
+ *
+ * @param {...string} paramsData - Route parameter names to extract.
+ * @returns {MethodDecorator}
+ */
 const Params = (...paramsData) => {
     return function (target, key, descriptor) {
         const originalMethod = descriptor.value;
@@ -40,6 +92,23 @@ const Params = (...paramsData) => {
     };
 };
 exports.Params = Params;
+/**
+ * Extract specific query parameters from `ctx.query`.
+ *
+ * Filters query parameters and keeps only the specified
+ * query keys.
+ *
+ * @example
+ * ```ts
+ * \@Query('page', 'limit')
+ * async listUsers(ctx: T.Context) {
+ *   // ctx.query = { page: "1", limit: "10" }
+ * }
+ * ```
+ *
+ * @param {...string} queryParms - Query parameter names to extract.
+ * @returns {MethodDecorator}
+ */
 const Query = (...queryParms) => {
     return function (target, key, descriptor) {
         const originalMethod = descriptor.value;
@@ -53,6 +122,23 @@ const Query = (...queryParms) => {
     };
 };
 exports.Query = Query;
+/**
+ * Extract specific cookies from `ctx.cookies`.
+ *
+ * Filters cookies and keeps only the specified cookie keys
+ * before executing the controller method.
+ *
+ * @example
+ * ```ts
+ * \@Cookies('token')
+ * async profile(ctx: T.Context) {
+ *   // ctx.cookies = { token: "..." }
+ * }
+ * ```
+ *
+ * @param {...string} cookiesParms - Cookie names to extract.
+ * @returns {MethodDecorator}
+ */
 const Cookies = (...cookiesParms) => {
     return function (target, key, descriptor) {
         const originalMethod = descriptor.value;

package/dist/lib/core/decorators/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../../src/lib/core/decorators/context.ts"],"names":[],"mappings":"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"}

package/dist/lib/core/decorators/controller.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Controller = void 0;
+/**
+ * Declares a class as a controller and assigns a base route path.
+ *
+ * The provided path will be used as the **base URL prefix**
+ * for all routes defined inside the controller. The path must
+ * start with `/`.
+ *
+ * This decorator stores the controller path using
+ * `Reflect.defineMetadata` under the key `"controllers"`.
+ * The framework can later read this metadata to register
+ * routes automatically.
+ *
+ * @example
+ * ```ts
+ * \@Controller('/users')
+ * class UserController {
+ *
+ *   async list(ctx: T.Context) {
+ *     return [{ id: 1, name: "John" }];
+ *   }
+ *
+ * }
+ * ```
+ *
+ * If a route handler defines `/profile`, the final route becomes:
+ *
+ * ```
+ * /users/profile
+ * ```
+ *
+ * @param {`/${string}`} path - Base route path for the controller.
+ * @returns {ClassDecorator}
+ */
+const Controller = (path) => {
+    return (target) => {
+        return Reflect.defineMetadata("controllers", path, target);
+    };
+};
+exports.Controller = Controller;
+//# sourceMappingURL=controller.js.map

package/dist/lib/core/decorators/controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.js","sourceRoot":"","sources":["../../../../src/lib/core/decorators/controller.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACI,MAAM,UAAU,GAAG,CAAC,IAAkB,EAAkB,EAAE;IAC/D,OAAO,CAAC,MAAM,EAAE,EAAE;QAChB,OAAO,OAAO,CAAC,cAAc,CAAC,aAAa,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7D,CAAC,CAAC;AACJ,CAAC,CAAA;AAJY,QAAA,UAAU,cAItB"}

package/dist/lib/core/decorators/headers.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WriteHeader = void 0;
+/**
+ * Sets the HTTP response headers and status code before the controller method executes.
+ *
+ * This decorator calls `res.writeHead()` on the underlying Node.js response object,
+ * allowing you to define the response **status code** and **headers** in advance.
+ *
+ * @example
+ * ```ts
+ * class UserController {
+ *
+ *   \@WriteHeader(200, { "Content-Type": "application/json" })
+ *   async profile(ctx: T.Context) {
+ *     return { id: 1, name: "John" };
+ *   }
+ *
+ * }
+ * ```
+ *
+ * Example response:
+ *
+ * ```
+ * HTTP/1.1 200 OK
+ * Content-Type: application/json
+ * ```
+ *
+ * @param {number} statusCode - HTTP status code to send with the response.
+ * @param {OutgoingHttpHeaders} contentType - Response headers to set.
+ * @returns {Function}
+ */
+const WriteHeader = (statusCode, contentType) => {
+    return (target, key, descriptor) => {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (ctx, next) {
+            ctx.res.writeHead(...[statusCode, contentType]);
+            return await originalMethod.call(this, ctx, next);
+        };
+        return descriptor;
+    };
+};
+exports.WriteHeader = WriteHeader;
+//# sourceMappingURL=headers.js.map

package/dist/lib/core/decorators/headers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.js","sourceRoot":"","sources":["../../../../src/lib/core/decorators/headers.ts"],"names":[],"mappings":";;;AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACI,MAAM,WAAW,GAAG,CAAC,UAAkB,EAAE,WAAgC,EAAY,EAAE;IAC5F,OAAO,CAAC,MAAW,EAAE,GAAW,EAAE,UAA8B,EAAE,EAAE;QAClE,MAAM,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC;QAExC,UAAU,CAAC,KAAK,GAAG,KAAK,WAAW,GAAc,EAAE,IAAoB;YACrE,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;YAChD,OAAO,MAAM,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QACpD,CAAC,CAAC;QAEF,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC,CAAC;AAXW,QAAA,WAAW,eAWtB"}

package/dist/lib/core/decorators/methods.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Options = exports.Head = exports.Delete = exports.Patch = exports.Put = exports.Post = exports.Get = void 0;
+const methodDecorator = (method) => {
+    return (path) => {
+        return (target, propertyKey) => {
+            const controller = target.constructor;
+            const routers = Reflect.hasMetadata("routers", controller)
+                ? Reflect.getMetadata("routers", controller)
+                : [];
+            routers.push({
+                method,
+                path,
+                handler: propertyKey,
+            });
+            Reflect.defineMetadata("routers", routers, controller);
+        };
+    };
+};
+/**
+ * Maps a controller method to an HTTP GET route.
+ *
+ * @example
+ * ```ts
+ * \@Get('/users')
+ * async list(ctx: T.Context) {
+ *   return [{ id: 1, name: "John" }];
+ * }
+ * ```
+ */
+exports.Get = methodDecorator('get');
+/**
+ * Maps a controller method to an HTTP POST route.
+ *
+ * @example
+ * ```ts
+ * \@Post('/users')
+ * async create(ctx: T.Context) {
+ *   return { success: true };
+ * }
+ * ```
+ */
+exports.Post = methodDecorator('post');
+/**
+ * Maps a controller method to an HTTP PUT route.
+ *
+ * Used for replacing a resource.
+ *
+ * @example
+ * ```ts
+ * \@Put('/users/:id')
+ * async update(ctx: T.Context) {}
+ * ```
+ */
+exports.Put = methodDecorator('put');
+/**
+ * Maps a controller method to an HTTP PATCH route.
+ *
+ * Used for partially updating a resource.
+ *
+ * @example
+ * ```ts
+ * \@Patch('/users/:id')
+ * async patch(ctx: T.Context) {}
+ * ```
+ */
+exports.Patch = methodDecorator('patch');
+/**
+ * Maps a controller method to an HTTP DELETE route.
+ *
+ * @example
+ * ```ts
+ * \@Delete('/users/:id')
+ * async remove(ctx: T.Context) {}
+ * ```
+ */
+exports.Delete = methodDecorator('delete');
+/**
+ * Maps a controller method to an HTTP HEAD route.
+ *
+ * HEAD responses contain only headers and no response body.
+ *
+ * @example
+ * ```ts
+ * \@Head('/health')
+ * async health(ctx: T.Context) {}
+ * ```
+ */
+exports.Head = methodDecorator('head');
+/**
+ * Maps a controller method to an HTTP OPTIONS route.
+ *
+ * Typically used for CORS preflight requests.
+ *
+ * @example
+ * ```ts
+ * \@Options('/users')
+ * async options(ctx: T.Context) {}
+ * ```
+ */
+exports.Options = methodDecorator('options');
+//# sourceMappingURL=methods.js.map

package/dist/lib/core/decorators/methods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"methods.js","sourceRoot":"","sources":["../../../../src/lib/core/decorators/methods.ts"],"names":[],"mappings":";;;AAEA,MAAM,eAAe,GAAG,CAAC,MAAgB,EAAE,EAAE;IAC3C,OAAO,CAAC,IAAkB,EAAE,EAAE;QAC5B,OAAO,CAAC,MAAU,EAAE,WAAe,EAAE,EAAE;YACrC,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC;YAEtC,MAAM,OAAO,GAAe,OAAO,CAAC,WAAW,CAAC,SAAS,EAAE,UAAU,CAAC;gBACpE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,SAAS,EAAE,UAAU,CAAC;gBAC5C,CAAC,CAAC,EAAE,CAAC;YAEP,OAAO,CAAC,IAAI,CAAC;gBACX,MAAM;gBACN,IAAI;gBACJ,OAAO,EAAE,WAAW;aACrB,CAAC,CAAC;YAEH,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;QACzD,CAAC,CAAA;IACH,CAAC,CAAA;AACH,CAAC,CAAA;AAED;;;;;;;;;;GAUG;AACU,QAAA,GAAG,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;AAE1C;;;;;;;;;;GAUG;AACU,QAAA,IAAI,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;AAE5C;;;;;;;;;;GAUG;AACU,QAAA,GAAG,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;AAE1C;;;;;;;;;;GAUG;AACU,QAAA,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;AAE9C;;;;;;;;GAQG;AACU,QAAA,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;AAEhD;;;;;;;;;;GAUG;AACU,QAAA,IAAI,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;AAE5C;;;;;;;;;;GAUG;AACU,QAAA,OAAO,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC"}

package/dist/lib/core/decorators/middleware.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Middleware = void 0;
+/**
+ * Attaches a middleware function to a controller method.
+ *
+ * The middleware will be executed **before the route handler**.
+ * If the middleware calls `next(err)`, the error will be forwarded
+ * to the framework's error handler. Otherwise, the original
+ * controller method will be executed.
+ *
+ * This decorator also stores middleware metadata using `Reflect.defineMetadata`
+ * so the framework can discover and execute it during the request lifecycle.
+ *
+ * @example
+ * ```ts
+ * class UserController {
+ *
+ *   \@Middleware(authMiddleware)
+ *   async profile(ctx: T.Context) {
+ *     return { user: ctx.user };
+ *   }
+ *
+ * }
+ * ```
+ *
+ * Example middleware:
+ *
+ * ```ts
+ * const authMiddleware: T.RequestFunction = (ctx, next) => {
+ *   if (!ctx.user) {
+ *     return next(new Error("Unauthorized"));
+ *   }
+ *   next();
+ * };
+ * ```
+ *
+ * @param {T.RequestFunction} middleware - Middleware function to execute before the route handler.
+ * @returns {MethodDecorator}
+ */
+const Middleware = (middleware) => {
+    return (target, key, descriptor) => {
+        const originalMethod = descriptor.value;
+        descriptor.value = function (ctx, next) {
+            try {
+                Reflect.defineMetadata("middlewares", descriptor, target);
+                return middleware(ctx, (err) => {
+                    if (err != null) {
+                        return next(err);
+                    }
+                    return originalMethod.call(this, ctx, next);
+                });
+            }
+            catch (error) {
+                return next(error);
+            }
+        };
+    };
+};
+exports.Middleware = Middleware;
+//# sourceMappingURL=middleware.js.map

package/dist/lib/core/decorators/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../../../src/lib/core/decorators/middleware.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACI,MAAM,UAAU,GAAG,CAAC,UAA6B,EAAY,EAAE;IAEpE,OAAO,CAAC,MAAW,EAAE,GAAW,EAAE,UAA8B,EAAE,EAAE;QAClE,MAAM,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC;QAExC,UAAU,CAAC,KAAK,GAAG,UAAU,GAAc,EAAE,IAAoB;YAC/D,IAAI;gBAEF,OAAO,CAAC,cAAc,CAAC,aAAa,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;gBAE1D,OAAO,UAAU,CAAC,GAAG,EAAE,CAAC,GAAS,EAAE,EAAE;oBACnC,IAAI,GAAG,IAAI,IAAI,EAAE;wBACf,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;qBAClB;oBAED,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;gBAC9C,CAAC,CAAC,CAAC;aAEJ;YAAC,OAAO,KAAU,EAAE;gBACnB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;aACpB;QACH,CAAC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,CAAC;AAvBW,QAAA,UAAU,cAuBrB"}

package/dist/lib/core/decorators/statusCode.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StatusCode = void 0;
+/**
+ * Sets the HTTP response status code before executing the controller method.
+ *
+ * The provided status code will be automatically clamped between **100** and **599**
+ * to ensure a valid HTTP status range. It also sets the default
+ * `Content-Type` header to `application/json`.
+ *
+ * @example
+ * ```ts
+ * class UserController {
+ *   \@StatusCode(201)
+ *   async create(ctx: T.Context) {
+ *     return { success: true };
+ *   }
+ * }
+ * ```
+ *
+ * In this example the response will be sent with:
+ * - Status: **201 Created**
+ * - Header: `Content-Type: application/json`
+ *
+ * @param {T.StatusCode} statusCode - HTTP status code to send with the response.
+ * @returns {MethodDecorator}
+ */
+const StatusCode = (statusCode) => {
+    return (target, key, descriptor) => {
+        const originalMethod = descriptor.value;
+        const code = statusCode < 100 ? 100 : statusCode > 599 ? 599 : statusCode;
+        descriptor.value = async function (ctx, next) {
+            ctx.res.writeHead(code, { 'Content-Type': 'application/json' });
+            return await originalMethod.call(this, ctx, next);
+        };
+        return descriptor;
+    };
+};
+exports.StatusCode = StatusCode;
+//# sourceMappingURL=statusCode.js.map

package/dist/lib/core/decorators/statusCode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusCode.js","sourceRoot":"","sources":["../../../../src/lib/core/decorators/statusCode.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACI,MAAM,UAAU,GAAG,CAAC,UAAwB,EAAY,EAAE;IAC7D,OAAO,CAAC,MAAW,EAAE,GAAW,EAAE,UAA8B,EAAE,EAAE;QAChE,MAAM,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC;QAExC,MAAM,IAAI,GAAG,UAAU,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC;QAE1E,UAAU,CAAC,KAAK,GAAG,KAAK,WAAW,GAAc,EAAE,IAAoB;YACnE,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;YAChE,OAAO,MAAM,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QACtD,CAAC,CAAC;QAEF,OAAO,UAAU,CAAC;IACtB,CAAC,CAAC;AACN,CAAC,CAAC;AAbW,QAAA,UAAU,cAarB"}

package/dist/lib/core/decorators/swagger.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Swagger = void 0;
+/**
+ * Attaches Swagger/OpenAPI specification metadata to a controller method.
+ *
+ * This decorator stores route documentation using `Reflect.defineMetadata`
+ * so the framework can later collect it and generate **Swagger / OpenAPI**
+ * documentation automatically.
+ *
+ * The metadata is stored on the controller constructor under the key `"swaggers"`.
+ * Each decorated method contributes a Swagger specification object.
+ *
+ * @example
+ * ```ts
+ * class UserController {
+ *
+ *   \@Swagger({
+ *     summary: "Get user profile",
+ *     description: "Returns the authenticated user's profile",
+ *     tags: ["Users"],
+ *     responses: {
+ *       200: {
+ *         description: "Successful response"
+ *       }
+ *     }
+ *   })
+ *   async profile(ctx: T.Context) {
+ *     return { id: 1, name: "John" };
+ *   }
+ *
+ * }
+ * ```
+ *
+ * @param {T.Swagger.Spec} data - Swagger/OpenAPI specification for the route.
+ * @returns {MethodDecorator}
+ */
+const Swagger = (data) => {
+    return (target, propertyKey) => {
+        const controller = target.constructor;
+        const swaggers = Reflect.hasMetadata("swaggers", controller)
+            ? Reflect.getMetadata("swaggers", controller)
+            : [];
+        swaggers.push({
+            handler: propertyKey,
+            ...data,
+        });
+        Reflect.defineMetadata("swaggers", swaggers, controller);
+    };
+};
+exports.Swagger = Swagger;
+//# sourceMappingURL=swagger.js.map

package/dist/lib/core/decorators/swagger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"swagger.js","sourceRoot":"","sources":["../../../../src/lib/core/decorators/swagger.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACI,MAAM,OAAO,GAAG,CAAC,IAAoB,EAAE,EAAE;IAC9C,OAAO,CAAC,MAAW,EAAE,WAAgB,EAAE,EAAE;QACvC,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC;QAEtC,MAAM,QAAQ,GAAU,OAAO,CAAC,WAAW,CAAC,UAAU,EAAE,UAAU,CAAC;YACjE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,UAAU,EAAE,UAAU,CAAC;YAC7C,CAAC,CAAC,EAAE,CAAC;QAEP,QAAQ,CAAC,IAAI,CAAC;YACZ,OAAO,EAAE,WAAW;YACpB,GAAG,IAAI;SACR,CAAC,CAAC;QAEH,OAAO,CAAC,cAAc,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC3D,CAAC,CAAC;AACJ,CAAC,CAAC;AAfW,QAAA,OAAO,WAelB"}