tspace-spear 1.2.7 → 1.2.9-beta.1

package/dist/lib/core/types/index.d.ts

@@ -22,7 +22,7 @@ type THeaders<T = IncomingHttpHeaders> = {
 type TQuery<T = Record<string, string | undefined>> = T;
 type TParams<T = Record<string, string | number | undefined>> = T;
 type TBody<T = Record<string, any>> = T;
-type TCookies<T = Record<string, any | undefined>> = T;
+type TCookies<T = Record<string, string | undefined>> = T;
 type TFile = {
     size: number;
     sizes: {
@@ -54,35 +54,35 @@ type THttpResponder = {
      */
     uWS: any;
     /** 200 OK - Standard successful response */
-    ok: (data?: Record<string, any>) => any;
+    ok: <T extends Record<string, any>>(data?: T) => T.Response & T;
     /** 201 Created - Resource successfully created */
-    created: (data?: Record<string, any>) => any;
+    created: <T extends Record<string, any>>(data?: T) => T.Response & T;
     /** 202 Accepted - Request accepted for processing */
-    accepted: (data?: Record<string, any>) => any;
+    accepted: <T extends Record<string, any>>(data?: T) => T.Response & T;
     /** 204 No Content - Successful request with no response body */
-    noContent: (message?: string) => any;
+    noContent: <T extends string>(message?: T) => T.Response & T;
     /** 400 Bad Request - Invalid request from client */
-    badRequest: (message?: string) => any;
+    badRequest: <T extends string>(message?: T) => T.Response & T;
     /** 401 Unauthorized - Authentication required or failed */
-    unauthorized: (message?: string) => any;
+    unauthorized: <T extends string>(message?: T) => T.Response & T;
     /** 402 Payment Required - Reserved for future/payment flow */
-    paymentRequired: (message?: string) => any;
+    paymentRequired: <T extends string>(message?: T) => T.Response & T;
     /** 403 Forbidden - Client does not have access rights */
-    forbidden: (message?: string) => any;
+    forbidden: <T extends string>(message?: T) => T.Response & T;
+    /** 404 Not Found - Resource does not exist */
+    notFound: <T extends string>(message?: T) => T.Response & T;
     /** 422 Unprocessable Entity - Valid request but semantic errors */
-    unprocessable: (message?: string) => any;
+    unprocessable: <T extends string>(message?: T) => T.Response & T;
     /** 429 Too Many Requests - Rate limit exceeded */
-    tooManyRequests: (message?: string) => any;
-    /** 404 Not Found - Resource does not exist */
-    notFound: (message?: string) => any;
+    tooManyRequests: <T extends string>(message?: T) => T.Response & T;
     /** 500 Internal Server Error - Generic server failure */
-    serverError: (message?: string) => any;
+    serverError: <T extends string>(message?: T) => T.Response & T;
     /** 502 Bad Gateway - Invalid response from upstream server */
-    badGateway: (message?: string) => any;
+    badGateway: <T extends string>(message?: T) => T.Response & T;
     /** 503 Service Unavailable - Server temporarily unavailable */
-    unavailable: (message?: string) => any;
+    unavailable: <T extends string>(message?: T) => T.Response & T;
     /** 504 Gateway Timeout - Upstream server timeout */
-    gatewayTimeout: (message?: string) => any;
+    gatewayTimeout: <T extends string>(message?: T) => T.Response & T;
     /**
      * Serve a media file (video, image, PDF, etc.) from file system.
      * @param filePath Absolute or relative path to media file
@@ -92,7 +92,7 @@ type THttpResponder = {
      * Send JSON response.
      * @param data JSON serializable object
      */
-    json: (data?: Record<string, any>) => any;
+    json: <T extends Record<string, any>>(data?: T) => T.Response & T;
     /**
      * Send error response (generic wrapper).
      * @param err Error object or message
@@ -133,7 +133,7 @@ type THttpResponder = {
          *
          * @param data JSON-serializable object to send as response body
          */
-        json: (data?: Record<string, any>) => any;
+        json: <T extends Record<string, any>>(data?: T) => T.Response & T;
         /**
          * Send plain text response with the previously set status code.
          *
@@ -162,6 +162,11 @@ type THttpResponder = {
         httpOnly?: boolean;
         expires?: Date;
     }>) => any;
+    /**
+     * Set HTTP status code.
+     * @param code http status code
+     */
+    setStatusCode: (code: TStatusCode) => void;
 };
 type TStatusCode = 200 | 201 | 202 | 203 | 204 | 300 | 301 | 302 | 303 | 304 | 400 | 401 | 402 | 403 | 404 | 405 | 406 | 407 | 408 | 409 | 410 | 411 | 412 | 413 | 414 | 415 | 416 | 417 | 418 | 421 | 422 | 423 | 424 | 425 | 426 | 428 | 429 | 431 | 451 | 500 | 501 | 502 | 503 | 504 | 505;
 type TResponse = ServerResponse & THttpResponder;
@@ -176,7 +181,7 @@ type TRoute = {
     params: string[];
 };
 type TMethod = 'get' | 'post' | 'patch' | 'put' | 'delete' | 'all' | 'head' | 'options';
-type TMethodInput = Uppercase<TMethod>;
+type TMethodInput = Uppercase<Exclude<TMethod, 'all'>>;
 type HandlerUWS = (res: unknown, req: unknown) => void | Promise<void>;
 type UWS = {
     App: () => {
@@ -244,7 +249,15 @@ type TSwaggerDoc = {
         method: string;
         params: string[];
     }[];
-    globalPrefix?: string;
+    globalPrefix?: {
+        path: string;
+        options: {
+            exclude: {
+                path: string;
+                method?: T.MethodInput[] | '*';
+            }[];
+        };
+    };
     specs?: (TSwagger & {
         path: string;
         method: string;
@@ -318,7 +331,7 @@ type TWSHandler = {
     error: (ws: WebSocket & Partial<any>, error: Error) => void;
 };
 export declare namespace T {
-    type Context<O extends Partial<Pick<TContextBase, "body" | "query" | "files" | "params">> = {}> = TContext<O>;
+    type Context<O extends Partial<Pick<TContextBase, "query" | "params" | "body" | "cookies" | "files">> = {}> = TContext<O>;
     type Adapter = TAdapter;
     type AdapterServer = TAdapterServer;
     type Application = TApplication;
@@ -328,22 +341,22 @@ export declare namespace T {
     type Route = TRoute;
     type Method = TMethod;
     type ErrorFunction = TErrorFunction;
-    type HttpStatus = THttpResponder;
+    type HttpResponder = THttpResponder;
     type ContextHandler = TContextHandler;
     type WebSocketHandler = TWSHandler;
     type StatusCode = TStatusCode;
     type MethodInput = TMethodInput;
     type Response = TResponse;
     type Request = TRequest;
-    type FileUpload<T = Record<string, TFile[] | undefined>> = T;
-    type FileInput = TFile;
-    type Cookies<T = Record<string, any>> = TCookies<T>;
-    type Params<T = Record<string, string>> = TParams<T>;
-    type Query<T = Record<string, string>> = TQuery<T>;
-    type Body<T = Record<string, any>> = TBody<T>;
     type Headers<T = IncomingHttpHeaders> = THeaders<T>;
     type Ip = TIp;
     type Ips = TIps;
+    type FileInput = TFile;
+    type FileUpload<T = Record<string, TFile[] | undefined>> = T;
+    type Cookies<T = Record<string, string | undefined>> = TCookies<T>;
+    type Params<T = Record<string, string | number | undefined>> = TParams<T>;
+    type Query<T = Record<string, string | undefined>> = TQuery<T>;
+    type Body<T = Record<string, any>> = TBody<T>;
     namespace Swagger {
         type Spec = TSwagger;
         type Format = TSwaggerFormat;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tspace-spear",
-  "version": "1.2.7",
+  "version": "1.2.9-beta.1",
   "description": "tspace-spear is a lightweight, high-performance API framework for Node.js that leverages the native HTTP server and supports uWebSockets.js (C++) for maximum speed and efficiency.",
   "main": "./dist/lib/index.js",
   "types": "./dist/lib/index.d.ts",
@@ -8,7 +8,7 @@
     "dist"
   ],
   "bin": {
-    "tspace-spear": "./dist/cli/index.js"
+    "spear": "./dist/cli/index.js"
   },
   "type": "commonjs",
   "repository": {
@@ -42,10 +42,10 @@
     "beta": "npm run build && npm publish --tag beta",
     "bm:node": "npm run benchmark:node",
     "bm:bun": "npm run benchmark:bun",
-    "benchmark:node": "npm run build && node benchmarks/tests/benchmark.node.js",
-    "benchmark:bun": "npm run build && bun run benchmarks/tests/benchmark.bun.js",
+    "benchmark:node": "npm run build && node --no-warnings --optimize-for-size benchmarks/tests/benchmark.node.js",
+    "benchmark:bun": "npm run build && bun run  --no-warnings --optimize-for-size benchmarks/tests/benchmark.bun.js",
     "load": "autocannon -c 100 -d 30 -p 10 localhost:5000",
-    "test": "ts-mocha ./__tests__/**/*.test.ts --reporter spec --no-timeouts --recursive --reporter mochawesome --reporter-options reportDir=__tests-report__,reportFilename=errors.html,reportTitle=Unit-test --exit",
+    "test": "ts-mocha ./__tests__/**/*.test.ts --reporter spec --slow 0 --no-timeouts --recursive --reporter mochawesome --reporter-options reportDir=__tests-report__,reportFilename=errors.html,reportTitle=Unit-test --exit",
     "docs": "npx docsify-cli serve docs"
   },
   "exports": {
@@ -58,6 +58,11 @@
       "types": "./dist/lib/core/client/index.d.ts",
       "import": "./dist/lib/core/client/index.js",
       "require": "./dist/lib/core/client/index.js"
+    },
+    "./exception": {
+      "types": "./dist/lib/core/exception/index.d.ts",
+      "import": "./dist/lib/core/exception/index.js",
+      "require": "./dist/lib/core/exception/index.js"
     }
   },
   "engines": {
@@ -67,7 +72,6 @@
     "busboy": "1.6.0",
     "fast-querystring": "1.1.2",
     "mime-types": "2.1.35",
-    "node-fetch": "2.7.0",
     "on-finished": "2.4.1",
     "reflect-metadata": "0.2.2",
     "swagger-ui-dist": "5.32.0",
@@ -101,9 +105,14 @@
     "elysia": "1.4.28",
     "express": "4.19.2",
     "fastify": "4.28.1",
+    "form-data": "4.0.5",
+    "graphql": "16.14.0",
+    "graphql-http": "1.22.4",
+    "graphql-yoga": "5.21.0",
     "hono": "4.12.9",
     "mocha": "10.2.0",
     "mochawesome": "7.1.3",
+    "node-fetch": "2.7.0",
     "ts-mocha": "10.0.0",
     "ts-node": "10.9.2",
     "typescript": "5.6.2",