@ruiapp/rapid-core 0.5.11 → 0.5.13

package/src/core/request.ts

@@ -1,95 +1,95 @@
-import qs from "qs";
-import { parseFormDataBody } from "./http/formDataParser";
-import { getCookies } from "~/deno-std/http/cookie";
-import { IRpdServer } from "./server";
-import { Logger } from "~/facilities/log/LogFacility";
-
-export const GlobalRequest = global.Request;
-
-export interface RapidRequestBody {
-  type: "form-data" | "json" | "form";
-  value: any;
-}
-
-export class RapidRequest {
-  #logger: Logger;
-  #raw: Request;
-  #bodyParsed: boolean;
-  #body: RapidRequestBody;
-  #headers: Headers;
-  #parsedCookies: Record<string, string>;
-  method: string;
-  url: URL;
-
-  constructor(server: IRpdServer, req: Request) {
-    this.#logger = server.getLogger();
-    this.#raw = req;
-    this.method = req.method;
-    this.url = new URL(req.url);
-    this.#headers = req.headers;
-  }
-
-  async parseBody(): Promise<void> {
-    if (this.#bodyParsed) {
-      this.#logger.warn("Request body has been parsed. 'parseBody()' method should not be called more than once.");
-      return;
-    }
-
-    const requestMethod = this.method;
-    if (requestMethod !== "POST" && requestMethod !== "PUT" && requestMethod !== "PATCH") {
-      this.#body = null;
-      this.#bodyParsed = true;
-      return;
-    }
-
-    const contentLength = parseInt(this.#headers.get("Content-Length") || "0", 10);
-    if (!contentLength) {
-      this.#body = null;
-      this.#bodyParsed = true;
-      return;
-    }
-
-    const req = this.#raw;
-    const contentType = this.#headers.get("Content-Type") || "application/json";
-    if (contentType.includes("json")) {
-      this.#body = {
-        type: "json",
-        value: await req.json(),
-      };
-    } else if (contentType.startsWith("application/x-www-form-urlencoded")) {
-      const bodyText = await req.text();
-      this.#body = {
-        type: "form",
-        value: qs.parse(bodyText),
-      };
-    } else if (contentType.startsWith("multipart/form-data")) {
-      this.#body = {
-        type: "form-data",
-        value: await parseFormDataBody(req),
-      };
-    }
-    this.#bodyParsed = true;
-  }
-
-  get rawRequest(): Request {
-    return this.#raw;
-  }
-
-  get headers(): Headers {
-    return this.#headers;
-  }
-
-  get cookies(): Record<string, string> {
-    if (!this.#parsedCookies) {
-      this.#parsedCookies = getCookies(this.#headers);
-    }
-    return this.#parsedCookies;
-  }
-
-  get body(): RapidRequestBody {
-    if (!this.#bodyParsed) {
-      throw new Error("Request body not parsed, you should call 'parseBody()' method before getting the body.");
-    }
-    return this.#body;
-  }
-}
+import qs from "qs";
+import { parseFormDataBody } from "./http/formDataParser";
+import { getCookies } from "~/deno-std/http/cookie";
+import { IRpdServer } from "./server";
+import { Logger } from "~/facilities/log/LogFacility";
+
+export const GlobalRequest = global.Request;
+
+export interface RapidRequestBody {
+  type: "form-data" | "json" | "form";
+  value: any;
+}
+
+export class RapidRequest {
+  #logger: Logger;
+  #raw: Request;
+  #bodyParsed: boolean;
+  #body: RapidRequestBody;
+  #headers: Headers;
+  #parsedCookies: Record<string, string>;
+  method: string;
+  url: URL;
+
+  constructor(server: IRpdServer, req: Request) {
+    this.#logger = server.getLogger();
+    this.#raw = req;
+    this.method = req.method;
+    this.url = new URL(req.url);
+    this.#headers = req.headers;
+  }
+
+  async parseBody(): Promise<void> {
+    if (this.#bodyParsed) {
+      this.#logger.warn("Request body has been parsed. 'parseBody()' method should not be called more than once.");
+      return;
+    }
+
+    const requestMethod = this.method;
+    if (requestMethod !== "POST" && requestMethod !== "PUT" && requestMethod !== "PATCH") {
+      this.#body = null;
+      this.#bodyParsed = true;
+      return;
+    }
+
+    const contentLength = parseInt(this.#headers.get("Content-Length") || "0", 10);
+    if (!contentLength) {
+      this.#body = null;
+      this.#bodyParsed = true;
+      return;
+    }
+
+    const req = this.#raw;
+    const contentType = this.#headers.get("Content-Type") || "application/json";
+    if (contentType.includes("json")) {
+      this.#body = {
+        type: "json",
+        value: await req.json(),
+      };
+    } else if (contentType.startsWith("application/x-www-form-urlencoded")) {
+      const bodyText = await req.text();
+      this.#body = {
+        type: "form",
+        value: qs.parse(bodyText),
+      };
+    } else if (contentType.startsWith("multipart/form-data")) {
+      this.#body = {
+        type: "form-data",
+        value: await parseFormDataBody(req),
+      };
+    }
+    this.#bodyParsed = true;
+  }
+
+  get rawRequest(): Request {
+    return this.#raw;
+  }
+
+  get headers(): Headers {
+    return this.#headers;
+  }
+
+  get cookies(): Record<string, string> {
+    if (!this.#parsedCookies) {
+      this.#parsedCookies = getCookies(this.#headers);
+    }
+    return this.#parsedCookies;
+  }
+
+  get body(): RapidRequestBody {
+    if (!this.#bodyParsed) {
+      throw new Error("Request body not parsed, you should call 'parseBody()' method before getting the body.");
+    }
+    return this.#body;
+  }
+}

package/src/core/response.ts

@@ -1,79 +1,79 @@
-import { isArray, isObject } from "lodash";
-import { HttpStatus, ResponseData } from "./http-types";
-
-export const GlobalResponse = global.Response;
-
-function mergeHeaders(target: Headers, source: HeadersInit) {
-  if (source instanceof Headers) {
-    for (const keyValuePair of source.entries()) {
-      target.set(keyValuePair[0], keyValuePair[1]);
-    }
-  } else if (isArray(source)) {
-    for (const keyValuePair of source) {
-      target.set(keyValuePair[0], keyValuePair[1]);
-    }
-  } else if (isObject(source)) {
-    Object.entries(source).forEach(([key, value]) => target.set(key, value));
-  }
-}
-
-interface NewResponseOptions {
-  body?: ResponseData;
-  status?: HttpStatus;
-  headers?: HeadersInit;
-}
-
-function newResponse(options: NewResponseOptions) {
-  return new Response(options.body, {
-    headers: options.headers,
-    status: options.status || 200,
-  });
-}
-
-export class RapidResponse {
-  // TODO: remove this field.
-  #response: Response;
-  status: number;
-  body: BodyInit;
-  headers: Headers;
-
-  constructor(body?: BodyInit, init?: ResponseInit) {
-    this.body = body;
-    this.headers = new Headers(init?.headers);
-    this.status = init?.status;
-  }
-
-  json(obj: any, status?: HttpStatus, headers?: HeadersInit) {
-    let body: string | null = null;
-    if (obj) {
-      body = JSON.stringify(obj);
-    }
-    this.headers.set("Content-Type", "application/json");
-    const responseHeaders = new Headers(this.headers);
-    if (headers) {
-      mergeHeaders(responseHeaders, headers);
-    }
-    this.status = status || 200;
-    this.body = body;
-    this.#response = newResponse({ body, status: this.status, headers: responseHeaders });
-  }
-
-  redirect(location: string, status?: HttpStatus) {
-    this.headers.set("Location", location);
-    this.status = status || 302;
-    this.#response = newResponse({
-      headers: this.headers,
-      status: this.status,
-    });
-  }
-
-  getResponse() {
-    if (!this.#response) {
-      this.#response = new Response(this.body, {
-        status: this.status || (this.body ? 200 : 404),
-        headers: this.headers,
-      });
-    }
-    return this.#response;
-  }
-}
+import { isArray, isObject } from "lodash";
+import { HttpStatus, ResponseData } from "./http-types";
+
+export const GlobalResponse = global.Response;
+
+function mergeHeaders(target: Headers, source: HeadersInit) {
+  if (source instanceof Headers) {
+    for (const keyValuePair of source.entries()) {
+      target.set(keyValuePair[0], keyValuePair[1]);
+    }
+  } else if (isArray(source)) {
+    for (const keyValuePair of source) {
+      target.set(keyValuePair[0], keyValuePair[1]);
+    }
+  } else if (isObject(source)) {
+    Object.entries(source).forEach(([key, value]) => target.set(key, value));
+  }
+}
+
+interface NewResponseOptions {
+  body?: ResponseData;
+  status?: HttpStatus;
+  headers?: HeadersInit;
+}
+
+function newResponse(options: NewResponseOptions) {
+  return new Response(options.body, {
+    headers: options.headers,
+    status: options.status || 200,
+  });
+}
+
+export class RapidResponse {
+  // TODO: remove this field.
+  #response: Response;
+  status: number;
+  body: BodyInit;
+  headers: Headers;
+
+  constructor(body?: BodyInit, init?: ResponseInit) {
+    this.body = body;
+    this.headers = new Headers(init?.headers);
+    this.status = init?.status;
+  }
+
+  json(obj: any, status?: HttpStatus, headers?: HeadersInit) {
+    let body: string | null = null;
+    if (obj) {
+      body = JSON.stringify(obj);
+    }
+    this.headers.set("Content-Type", "application/json");
+    const responseHeaders = new Headers(this.headers);
+    if (headers) {
+      mergeHeaders(responseHeaders, headers);
+    }
+    this.status = status || 200;
+    this.body = body;
+    this.#response = newResponse({ body, status: this.status, headers: responseHeaders });
+  }
+
+  redirect(location: string, status?: HttpStatus) {
+    this.headers.set("Location", location);
+    this.status = status || 302;
+    this.#response = newResponse({
+      headers: this.headers,
+      status: this.status,
+    });
+  }
+
+  getResponse() {
+    if (!this.#response) {
+      this.#response = new Response(this.body, {
+        status: this.status || (this.body ? 200 : 404),
+        headers: this.headers,
+      });
+    }
+    return this.#response;
+  }
+}

package/src/core/routeContext.ts

@@ -1,100 +1,100 @@
-import { isArray, isObject } from "lodash";
-import { RapidRequest } from "./request";
-import { RapidResponse } from "./response";
-import { HttpStatus, ResponseData } from "./http-types";
-import { IRpdServer } from "./server";
-import { Logger } from "~/facilities/log/LogFacility";
-import { IDatabaseAccessor, IDatabaseClient } from "~/types";
-
-export type Next = () => Promise<void>;
-
-// TODO: should divide to RequestContext and OperationContext
-
-export class RouteContext {
-  readonly request: RapidRequest;
-  readonly response: RapidResponse;
-  readonly state: Record<string, any>;
-  readonly databaseAccessor: IDatabaseAccessor;
-  method: string;
-  path: string;
-  params: Record<string, string>;
-  routeConfig: any;
-  #server: IRpdServer;
-  #dbTransactionClient: IDatabaseClient | null;
-
-  static newSystemOperationContext(server: IRpdServer) {
-    return new RouteContext(server);
-  }
-
-  constructor(server: IRpdServer, request?: RapidRequest) {
-    this.#server = server;
-    this.#dbTransactionClient = null;
-    this.databaseAccessor = server.getDatabaseAccessor();
-    this.request = request;
-    this.state = {};
-    this.response = new RapidResponse();
-
-    // `method` and `path` are used by `koa-tree-router` to match route
-    if (this.request) {
-      this.method = request.method;
-      this.path = request.url.pathname;
-    }
-  }
-
-  clone(): RouteContext {
-    const clonedContext = new RouteContext(this.#server);
-    clonedContext.method = this.method;
-    clonedContext.path = this.path;
-    clonedContext.params = this.params;
-    clonedContext.setState(this.state);
-
-    return clonedContext;
-  }
-
-  setState(state: Record<string, any>) {
-    Object.assign(this.state, state);
-  }
-
-  // `koa-tree-router` uses this method to set headers
-  set(headerName: string, headerValue: string) {
-    this.response.headers.set(headerName, headerValue);
-  }
-
-  json(obj: any, status?: HttpStatus, headers?: HeadersInit) {
-    this.response.json(obj, status, headers);
-  }
-
-  redirect(url: string, status?: HttpStatus) {
-    this.response.redirect(url, status);
-  }
-
-  getDbTransactionClient(): IDatabaseClient | null {
-    return this.#dbTransactionClient;
-  }
-
-  async beginDbTransaction(): Promise<IDatabaseClient> {
-    let dbClient = this.#dbTransactionClient;
-    if (dbClient) {
-      throw new Error("Database transaction has been started. You can not start a transaction more than once in a request context.");
-    }
-
-    dbClient = await this.databaseAccessor.getClient();
-    await this.databaseAccessor.queryDatabaseObject("BEGIN", [], dbClient);
-    this.#dbTransactionClient = dbClient;
-    return dbClient;
-  }
-
-  async commitDbTransaction(): Promise<void> {
-    if (!this.#dbTransactionClient) {
-      throw new Error("Database transaction has not been started. You should call beginDbTransaction() first.");
-    }
-    await this.databaseAccessor.queryDatabaseObject("COMMIT", [], this.#dbTransactionClient);
-  }
-
-  async rollbackDbTransaction(): Promise<void> {
-    if (!this.#dbTransactionClient) {
-      throw new Error("Database transaction has not been started. You should call beginDbTransaction() first.");
-    }
-    await this.databaseAccessor.queryDatabaseObject("ROLLBACK", [], this.#dbTransactionClient);
-  }
-}
+import { isArray, isObject } from "lodash";
+import { RapidRequest } from "./request";
+import { RapidResponse } from "./response";
+import { HttpStatus, ResponseData } from "./http-types";
+import { IRpdServer } from "./server";
+import { Logger } from "~/facilities/log/LogFacility";
+import { IDatabaseAccessor, IDatabaseClient } from "~/types";
+
+export type Next = () => Promise<void>;
+
+// TODO: should divide to RequestContext and OperationContext
+
+export class RouteContext {
+  readonly request: RapidRequest;
+  readonly response: RapidResponse;
+  readonly state: Record<string, any>;
+  readonly databaseAccessor: IDatabaseAccessor;
+  method: string;
+  path: string;
+  params: Record<string, string>;
+  routeConfig: any;
+  #server: IRpdServer;
+  #dbTransactionClient: IDatabaseClient | null;
+
+  static newSystemOperationContext(server: IRpdServer) {
+    return new RouteContext(server);
+  }
+
+  constructor(server: IRpdServer, request?: RapidRequest) {
+    this.#server = server;
+    this.#dbTransactionClient = null;
+    this.databaseAccessor = server.getDatabaseAccessor();
+    this.request = request;
+    this.state = {};
+    this.response = new RapidResponse();
+
+    // `method` and `path` are used by `koa-tree-router` to match route
+    if (this.request) {
+      this.method = request.method;
+      this.path = request.url.pathname;
+    }
+  }
+
+  clone(): RouteContext {
+    const clonedContext = new RouteContext(this.#server);
+    clonedContext.method = this.method;
+    clonedContext.path = this.path;
+    clonedContext.params = this.params;
+    clonedContext.setState(this.state);
+
+    return clonedContext;
+  }
+
+  setState(state: Record<string, any>) {
+    Object.assign(this.state, state);
+  }
+
+  // `koa-tree-router` uses this method to set headers
+  set(headerName: string, headerValue: string) {
+    this.response.headers.set(headerName, headerValue);
+  }
+
+  json(obj: any, status?: HttpStatus, headers?: HeadersInit) {
+    this.response.json(obj, status, headers);
+  }
+
+  redirect(url: string, status?: HttpStatus) {
+    this.response.redirect(url, status);
+  }
+
+  getDbTransactionClient(): IDatabaseClient | null {
+    return this.#dbTransactionClient;
+  }
+
+  async beginDbTransaction(): Promise<IDatabaseClient> {
+    let dbClient = this.#dbTransactionClient;
+    if (dbClient) {
+      throw new Error("Database transaction has been started. You can not start a transaction more than once in a request context.");
+    }
+
+    dbClient = await this.databaseAccessor.getClient();
+    await this.databaseAccessor.queryDatabaseObject("BEGIN", [], dbClient);
+    this.#dbTransactionClient = dbClient;
+    return dbClient;
+  }
+
+  async commitDbTransaction(): Promise<void> {
+    if (!this.#dbTransactionClient) {
+      throw new Error("Database transaction has not been started. You should call beginDbTransaction() first.");
+    }
+    await this.databaseAccessor.queryDatabaseObject("COMMIT", [], this.#dbTransactionClient);
+  }
+
+  async rollbackDbTransaction(): Promise<void> {
+    if (!this.#dbTransactionClient) {
+      throw new Error("Database transaction has not been started. You should call beginDbTransaction() first.");
+    }
+    await this.databaseAccessor.queryDatabaseObject("ROLLBACK", [], this.#dbTransactionClient);
+  }
+}