tspace-spear 1.0.0 → 1.0.1

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

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Swagger = void 0;
+const Swagger = (data) => {
+    return (target, propertyKey) => {
+        const controller = target.constructor;
+        const swaggers = Reflect.hasMetadata("swaggers", controller)
+            ? Reflect.getMetadata("swaggers", controller)
+            : [];
+        swaggers.push(Object.assign({ handler: propertyKey }, data));
+        Reflect.defineMetadata("swaggers", swaggers, controller);
+    };
+};
+exports.Swagger = Swagger;
+//# sourceMappingURL=swagger.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"swagger.js","sourceRoot":"","sources":["../../../../src/lib/core/decorators/swagger.ts"],"names":[],"mappings":";;;AAEO,MAAM,OAAO,GAAG,CAAC,IAAe,EAAE,EAAE;IACvC,OAAO,CAAC,MAAW,EAAE,WAAgB,EAAE,EAAE;QACrC,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC;QAEtC,MAAM,QAAQ,GAAU,OAAO,CAAC,WAAW,CAAC,UAAU,EAAE,UAAU,CAAC;YACnE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,UAAU,EAAE,UAAU,CAAC;YAC7C,CAAC,CAAC,EAAE,CAAC;QAEL,QAAQ,CAAC,IAAI,iBACT,OAAO,EAAE,WAAW,IACjB,IAAI,EACT,CAAC;QAEH,OAAO,CAAC,cAAc,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC3D,CAAC,CAAA;AACL,CAAC,CAAA;AAfU,QAAA,OAAO,WAejB"}

package/build/lib/core/server/index.d.ts

@@ -1,11 +1,11 @@
-import { ServerResponse } from 'http';
-import { Router } from '../..';
-import type { TContext, TNextFunction, TApplication } from "../..";
+import findMyWayRouter from 'find-my-way';
+import { Server, ServerResponse } from 'http';
+import { Router, TContext, TNextFunction, TApplication } from '../..';
 /**
  *
- * The 'Application' class is used to create a server and handle HTTP requests.
+ * The 'Spear' class is used to create a server and handle HTTP requests.
  *
- * @returns {Application} application
+ * @returns {Spear} application
  * @example
  * new Application()
  *  .get('/' , () => 'Hello world!')
@@ -17,17 +17,22 @@ import type { TContext, TNextFunction, TApplication } from "../..";
  *  .listen(3000 , () => console.log('server listening on port : 3000'))
  *
  */
-declare class Application {
+declare class Spear {
     private readonly _controllers?;
     private readonly _middlewares?;
     private readonly _globalPrefix;
     private readonly _router;
+    private readonly _parser;
+    private _swagger;
+    private _swaggerAdditional;
     private _errorHandler;
     private _globalMiddlewares;
     private _formatResponse;
     private _onListeners;
     private _fileUploadOptions;
     constructor({ controllers, middlewares, globalPrefix, logger }?: TApplication);
+    get instance(): this;
+    get routers(): findMyWayRouter.Instance<findMyWayRouter.HTTPVersion.V1>;
     /**
      * The 'enableCors' is used to enable the cors origins on the server.
      *
@@ -49,14 +54,6 @@ declare class Application {
      * @returns {this}
      */
     use(middleware: (ctx: TContext, next: TNextFunction) => void): this;
-    /**
-     * The 'useRouter' method is used to add the router in the request context.
-     *
-     * @parms {Function} router
-     * @property  {Function} router - get() , post() , put() , patch() , delete()
-     * @returns {this}
-     */
-    useRouter(router: Router): this;
     /**
      * The 'useBodyParser' method is a middleware used to parse the request body of incoming HTTP requests.
      *
@@ -69,27 +66,56 @@ declare class Application {
      * @returns {this}
      */
     useCookiesParser(): this;
+    /**
+     * The 'useRouter' method is used to add the router in the request context.
+     *
+     * @parms {Function} router
+     * @property  {Function} router - get() , post() , put() , patch() , delete()
+     * @returns {this}
+     */
+    useRouter(router: Router): this;
     /**
      * The 'useFileUpload' method is a middleware used to handler file uploads. It adds a file upload of incoming HTTP requests.
      *
      * @param {?Object}
      * @property {?number} limits
-     * @property {?boolean} useTempFiles
      * @property {?string} tempFileDir
      * @property {?Object} removeTempFile
      * @property {boolean} removeTempFile.remove
      * @property {number} removeTempFile.ms
      * @returns
      */
-    useFileUpload({ limits, useTempFiles, tempFileDir, removeTempFile }?: {
-        limits?: number;
-        useTempFiles?: boolean;
+    useFileUpload({ limit, tempFileDir, removeTempFile }?: {
+        limit?: number;
         tempFileDir?: string;
         removeTempFile?: {
             remove: boolean;
             ms: number;
         };
     }): this;
+    /**
+     * The 'useSwagger' method is a middleware used to create swagger api.
+     *
+     * @param {?Object}
+     * @property {?string} path
+     * @property {?array} servers
+     * @property {?object} info
+     * @property {?array} tags
+     * @returns
+     */
+    useSwagger({ path, servers, info, tags }?: {
+        path?: `/${string}`;
+        servers?: {
+            url: string;
+            description?: string;
+        }[];
+        tags?: string[];
+        info?: {
+            title?: string;
+            description?: string;
+            version?: string;
+        };
+    }): this;
     /**
      * The 'formatResponse' method is used to format the response
      *
@@ -178,19 +204,22 @@ declare class Application {
      * @param {function} cb
      * @returns
      */
-    listen(port: number | (() => ServerResponse) | undefined, cb: () => void): Promise<void>;
+    listen(port: (number | (() => ServerResponse)) | undefined, cb: (callback: {
+        server: Server;
+        port: number;
+    }) => void): Promise<void>;
     private _logger;
     private _import;
     private _registerControllers;
     private _registerMiddlewares;
-    private _filesParser;
-    private _bodyParser;
-    private _cookiesParser;
     private _customizeResponse;
     private _nextFunction;
     private _wrapHandlers;
     private _wrapResponse;
     private _createServer;
+    private _normalizePath;
+}
+export { Spear };
+export declare class Application extends Spear {
 }
-export { Application };
-export default Application;
+export default Spear;