mahameru 0.0.0

package/README.md

@@ -0,0 +1,28 @@
+# mahameru
+
+[![npm version](https://img.shields.io/npm/v/mahameru.svg)](https://www.npmjs.com/package/mahameru)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+> ⚠️ **IMPORTANT NOTICE:** This package is currently under active development and is **not yet ready for production use**. 
+
+---
+
+## 🚧 Work in Progress
+
+**mahameru** is still in its early stages. APIs, features, and configurations are subject to drastic changes without prior notice. 
+
+* **Current Status:** Experimental / Alpha
+* **Production Ready:** No
+
+### Installing for testing
+If you want to experiment with it or contribute, you can install it via npm:
+
+```bash
+npm i -g mahameru
+```
+Go to your favorite directory projects and run:
+```bash
+mahameru init
+```
+
+That's it!

package/dist/api.error.cjs

@@ -0,0 +1,107 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/api.error.ts
+var api_error_exports = {};
+__export(api_error_exports, {
+  APIError: () => APIError,
+  APIErrorCode: () => APIErrorCode,
+  API_ERROR_STATUS: () => API_ERROR_STATUS
+});
+module.exports = __toCommonJS(api_error_exports);
+var APIErrorCode = {
+  BAD_REQUEST: "BAD_REQUEST",
+  UNAUTHORIZED: "UNAUTHORIZED",
+  FORBIDDEN: "FORBIDDEN",
+  NOT_FOUND: "NOT_FOUND",
+  ROUTE_NOT_FOUND: "ROUTE_NOT_FOUND",
+  TOO_MANY_REQUESTS: "TOO_MANY_REQUESTS",
+  CONFLICT: "CONFLICT",
+  INTERNAL_SERVER_ERROR: "INTERNAL_SERVER_ERROR",
+  TOKEN_EXPIRED: "TOKEN_EXPIRED",
+  REFRESH_TOKEN_EXPIRED: "REFRESH_TOKEN_EXPIRED",
+  ACCESS_TOKEN_EXPIRED: "ACCESS_TOKEN_EXPIRED",
+  ACCESS_TOKEN_REQUIRED: "ACCESS_TOKEN_REQUIRED",
+  TOKEN_REFRESH_TOO_EARLY: "TOKEN_REFRESH_TOO_EARLY",
+  EMAIL_NOT_VERIFIED: "EMAIL_NOT_VERIFIED",
+  PHONE_NOT_VERIFIED: "PHONE_NOT_VERIFIED",
+  TOKEN_NOT_FOUND: "TOKEN_NOT_FOUND",
+  INVALID_TOKEN: "INVALID_TOKEN",
+  RESET_PASSWORD_TOKEN_USED: "RESET_PASSWORD_TOKEN_USED",
+  RESET_PASSWORD_NEEDED: "RESET_PASSWORD_NEEDED",
+  ROLE_DISABLED: "ROLE_DISABLED",
+  SESSION_NOT_FOUND: "SESSION_NOT_FOUND",
+  SESSION_DISABLED: "SESSION_DISABLED",
+  INVALID_RESPONSE: "INVALID_RESPONSE",
+  UNKNOWN_CLIENT_ERROR: "UNKNOWN_CLIENT_ERROR",
+  INVALID_CREDENTIALS: "INVALID_CREDENTIALS",
+  VALIDATION_ERROR: "VALIDATION_ERROR"
+};
+var API_ERROR_STATUS = {
+  BAD_REQUEST: 400,
+  UNAUTHORIZED: 401,
+  FORBIDDEN: 403,
+  NOT_FOUND: 404,
+  ROUTE_NOT_FOUND: 404,
+  TOO_MANY_REQUESTS: 429,
+  CONFLICT: 409,
+  INTERNAL_SERVER_ERROR: 500,
+  TOKEN_EXPIRED: 401,
+  REFRESH_TOKEN_EXPIRED: 401,
+  ACCESS_TOKEN_EXPIRED: 401,
+  ACCESS_TOKEN_REQUIRED: 401,
+  TOKEN_REFRESH_TOO_EARLY: 403,
+  EMAIL_NOT_VERIFIED: 401,
+  PHONE_NOT_VERIFIED: 401,
+  TOKEN_NOT_FOUND: 404,
+  INVALID_TOKEN: 401,
+  RESET_PASSWORD_TOKEN_USED: 401,
+  RESET_PASSWORD_NEEDED: 400,
+  ROLE_DISABLED: 403,
+  SESSION_NOT_FOUND: 404,
+  SESSION_DISABLED: 401,
+  INVALID_RESPONSE: 500,
+  UNKNOWN_CLIENT_ERROR: 400,
+  INVALID_CREDENTIALS: 400,
+  VALIDATION_ERROR: 400
+};
+var APIError = class _APIError extends Error {
+  static {
+    __name(this, "APIError");
+  }
+  code;
+  status;
+  details;
+  constructor(...args) {
+    const [code, message, details] = args;
+    super(message);
+    this.name = "APIError";
+    this.code = code;
+    this.status = API_ERROR_STATUS[code];
+    this.details = details;
+    Object.setPrototypeOf(this, _APIError.prototype);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  APIError,
+  APIErrorCode,
+  API_ERROR_STATUS
+});
+//# sourceMappingURL=api.error.cjs.map

package/dist/api.error.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/api.error.ts"],"sourcesContent":["export const APIErrorCode = {\r\n    BAD_REQUEST: 'BAD_REQUEST',\r\n    UNAUTHORIZED: 'UNAUTHORIZED',\r\n    FORBIDDEN: 'FORBIDDEN',\r\n    NOT_FOUND: 'NOT_FOUND',\r\n    ROUTE_NOT_FOUND: 'ROUTE_NOT_FOUND',\r\n    TOO_MANY_REQUESTS: 'TOO_MANY_REQUESTS',\r\n    CONFLICT: 'CONFLICT',\r\n    INTERNAL_SERVER_ERROR: 'INTERNAL_SERVER_ERROR',\r\n    TOKEN_EXPIRED: 'TOKEN_EXPIRED',\r\n    REFRESH_TOKEN_EXPIRED: 'REFRESH_TOKEN_EXPIRED',\r\n    ACCESS_TOKEN_EXPIRED: 'ACCESS_TOKEN_EXPIRED',\r\n    ACCESS_TOKEN_REQUIRED: 'ACCESS_TOKEN_REQUIRED',\r\n    TOKEN_REFRESH_TOO_EARLY: 'TOKEN_REFRESH_TOO_EARLY',\r\n    EMAIL_NOT_VERIFIED: 'EMAIL_NOT_VERIFIED',\r\n    PHONE_NOT_VERIFIED: 'PHONE_NOT_VERIFIED',\r\n    TOKEN_NOT_FOUND: 'TOKEN_NOT_FOUND',\r\n    INVALID_TOKEN: 'INVALID_TOKEN',\r\n    RESET_PASSWORD_TOKEN_USED: 'RESET_PASSWORD_TOKEN_USED',\r\n    RESET_PASSWORD_NEEDED: 'RESET_PASSWORD_NEEDED',\r\n    ROLE_DISABLED: 'ROLE_DISABLED',\r\n    SESSION_NOT_FOUND: 'SESSION_NOT_FOUND',\r\n    SESSION_DISABLED: 'SESSION_DISABLED',\r\n    INVALID_RESPONSE: 'INVALID_RESPONSE',\r\n    UNKNOWN_CLIENT_ERROR: 'UNKNOWN_CLIENT_ERROR',\r\n    INVALID_CREDENTIALS: 'INVALID_CREDENTIALS',\r\n    VALIDATION_ERROR: 'VALIDATION_ERROR'\r\n} as const\r\n\r\nexport type APIErrorCode = (typeof APIErrorCode)[keyof typeof APIErrorCode]\r\n\r\nexport const API_ERROR_STATUS: Record<APIErrorCode, number> = {\r\n    BAD_REQUEST: 400,\r\n    UNAUTHORIZED: 401,\r\n    FORBIDDEN: 403,\r\n    NOT_FOUND: 404,\r\n    ROUTE_NOT_FOUND: 404,\r\n    TOO_MANY_REQUESTS: 429,\r\n    CONFLICT: 409,\r\n    INTERNAL_SERVER_ERROR: 500,\r\n    TOKEN_EXPIRED: 401,\r\n    REFRESH_TOKEN_EXPIRED: 401,\r\n    ACCESS_TOKEN_EXPIRED: 401,\r\n    ACCESS_TOKEN_REQUIRED: 401,\r\n    TOKEN_REFRESH_TOO_EARLY: 403,\r\n    EMAIL_NOT_VERIFIED: 401,\r\n    PHONE_NOT_VERIFIED: 401,\r\n    TOKEN_NOT_FOUND: 404,\r\n    INVALID_TOKEN: 401,\r\n    RESET_PASSWORD_TOKEN_USED: 401,\r\n    RESET_PASSWORD_NEEDED: 400,\r\n    ROLE_DISABLED: 403,\r\n    SESSION_NOT_FOUND: 404,\r\n    SESSION_DISABLED: 401,\r\n    INVALID_RESPONSE: 500,\r\n    UNKNOWN_CLIENT_ERROR: 400,\r\n    INVALID_CREDENTIALS: 400,\r\n    VALIDATION_ERROR: 400\r\n}\r\n\r\nexport type APIErrorDetailsMap = {\r\n    TOKEN_REFRESH_TOO_EARLY: {\r\n        retryIn: number\r\n        retryAt: number\r\n    },\r\n    TOO_MANY_REQUESTS: {\r\n        retryIn: number\r\n        retryAt: number\r\n    },\r\n    VALIDATION_ERROR: {\r\n        details: {\r\n            field: PropertyKey\r\n            message: string\r\n        }[]\r\n    }\r\n}\r\n\r\nexport type APIErrorDetails<T extends APIErrorCode> = T extends keyof APIErrorDetailsMap ? APIErrorDetailsMap[T] : never\r\n\r\ntype APIErrorCodeWithDetails = keyof APIErrorDetailsMap\r\ntype APIErrorCodeWithoutDetails = Exclude<APIErrorCode, APIErrorCodeWithDetails>\r\ntype AnyAPIErrorDetails = APIErrorDetailsMap[APIErrorCodeWithDetails]\r\ntype APIErrorConstructorArgs =\r\n    | [code: APIErrorCodeWithoutDetails, message?: string]\r\n    | {\r\n        [TCode in APIErrorCodeWithDetails]: [\r\n            code: TCode,\r\n            message: string | undefined,\r\n            details: APIErrorDetails<TCode>\r\n        ]\r\n    }[APIErrorCodeWithDetails]\r\n\r\nexport class APIError extends Error {\r\n    public code: APIErrorCode\r\n    public readonly status: number\r\n    public readonly details?: AnyAPIErrorDetails\r\n\r\n    constructor(...args: APIErrorConstructorArgs) {\r\n        const [code, message, details] = args\r\n\r\n        super(message)\r\n        this.name = 'APIError'\r\n        this.code = code\r\n        this.status = API_ERROR_STATUS[code]\r\n        this.details = details\r\n\r\n        Object.setPrototypeOf(this, APIError.prototype)\r\n    }\r\n}\r\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;AAAO,IAAMA,eAAe;EACxBC,aAAa;EACbC,cAAc;EACdC,WAAW;EACXC,WAAW;EACXC,iBAAiB;EACjBC,mBAAmB;EACnBC,UAAU;EACVC,uBAAuB;EACvBC,eAAe;EACfC,uBAAuB;EACvBC,sBAAsB;EACtBC,uBAAuB;EACvBC,yBAAyB;EACzBC,oBAAoB;EACpBC,oBAAoB;EACpBC,iBAAiB;EACjBC,eAAe;EACfC,2BAA2B;EAC3BC,uBAAuB;EACvBC,eAAe;EACfC,mBAAmB;EACnBC,kBAAkB;EAClBC,kBAAkB;EAClBC,sBAAsB;EACtBC,qBAAqB;EACrBC,kBAAkB;AACtB;AAIO,IAAMC,mBAAiD;EAC1D1B,aAAa;EACbC,cAAc;EACdC,WAAW;EACXC,WAAW;EACXC,iBAAiB;EACjBC,mBAAmB;EACnBC,UAAU;EACVC,uBAAuB;EACvBC,eAAe;EACfC,uBAAuB;EACvBC,sBAAsB;EACtBC,uBAAuB;EACvBC,yBAAyB;EACzBC,oBAAoB;EACpBC,oBAAoB;EACpBC,iBAAiB;EACjBC,eAAe;EACfC,2BAA2B;EAC3BC,uBAAuB;EACvBC,eAAe;EACfC,mBAAmB;EACnBC,kBAAkB;EAClBC,kBAAkB;EAClBC,sBAAsB;EACtBC,qBAAqB;EACrBC,kBAAkB;AACtB;AAkCO,IAAME,WAAN,MAAMA,kBAAiBC,MAAAA;EA5F9B,OA4F8BA;;;EACnBC;EACSC;EACAC;EAEhB,eAAeC,MAA+B;AAC1C,UAAM,CAACH,MAAMI,SAASF,OAAAA,IAAWC;AAEjC,UAAMC,OAAAA;AACN,SAAKC,OAAO;AACZ,SAAKL,OAAOA;AACZ,SAAKC,SAASJ,iBAAiBG,IAAAA;AAC/B,SAAKE,UAAUA;AAEfI,WAAOC,eAAe,MAAMT,UAASU,SAAS;EAClD;AACJ;","names":["APIErrorCode","BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","ROUTE_NOT_FOUND","TOO_MANY_REQUESTS","CONFLICT","INTERNAL_SERVER_ERROR","TOKEN_EXPIRED","REFRESH_TOKEN_EXPIRED","ACCESS_TOKEN_EXPIRED","ACCESS_TOKEN_REQUIRED","TOKEN_REFRESH_TOO_EARLY","EMAIL_NOT_VERIFIED","PHONE_NOT_VERIFIED","TOKEN_NOT_FOUND","INVALID_TOKEN","RESET_PASSWORD_TOKEN_USED","RESET_PASSWORD_NEEDED","ROLE_DISABLED","SESSION_NOT_FOUND","SESSION_DISABLED","INVALID_RESPONSE","UNKNOWN_CLIENT_ERROR","INVALID_CREDENTIALS","VALIDATION_ERROR","API_ERROR_STATUS","APIError","Error","code","status","details","args","message","name","Object","setPrototypeOf","prototype"]}

package/dist/api.error.d.cts

@@ -0,0 +1,65 @@
+declare const APIErrorCode: {
+    readonly BAD_REQUEST: "BAD_REQUEST";
+    readonly UNAUTHORIZED: "UNAUTHORIZED";
+    readonly FORBIDDEN: "FORBIDDEN";
+    readonly NOT_FOUND: "NOT_FOUND";
+    readonly ROUTE_NOT_FOUND: "ROUTE_NOT_FOUND";
+    readonly TOO_MANY_REQUESTS: "TOO_MANY_REQUESTS";
+    readonly CONFLICT: "CONFLICT";
+    readonly INTERNAL_SERVER_ERROR: "INTERNAL_SERVER_ERROR";
+    readonly TOKEN_EXPIRED: "TOKEN_EXPIRED";
+    readonly REFRESH_TOKEN_EXPIRED: "REFRESH_TOKEN_EXPIRED";
+    readonly ACCESS_TOKEN_EXPIRED: "ACCESS_TOKEN_EXPIRED";
+    readonly ACCESS_TOKEN_REQUIRED: "ACCESS_TOKEN_REQUIRED";
+    readonly TOKEN_REFRESH_TOO_EARLY: "TOKEN_REFRESH_TOO_EARLY";
+    readonly EMAIL_NOT_VERIFIED: "EMAIL_NOT_VERIFIED";
+    readonly PHONE_NOT_VERIFIED: "PHONE_NOT_VERIFIED";
+    readonly TOKEN_NOT_FOUND: "TOKEN_NOT_FOUND";
+    readonly INVALID_TOKEN: "INVALID_TOKEN";
+    readonly RESET_PASSWORD_TOKEN_USED: "RESET_PASSWORD_TOKEN_USED";
+    readonly RESET_PASSWORD_NEEDED: "RESET_PASSWORD_NEEDED";
+    readonly ROLE_DISABLED: "ROLE_DISABLED";
+    readonly SESSION_NOT_FOUND: "SESSION_NOT_FOUND";
+    readonly SESSION_DISABLED: "SESSION_DISABLED";
+    readonly INVALID_RESPONSE: "INVALID_RESPONSE";
+    readonly UNKNOWN_CLIENT_ERROR: "UNKNOWN_CLIENT_ERROR";
+    readonly INVALID_CREDENTIALS: "INVALID_CREDENTIALS";
+    readonly VALIDATION_ERROR: "VALIDATION_ERROR";
+};
+type APIErrorCode = (typeof APIErrorCode)[keyof typeof APIErrorCode];
+declare const API_ERROR_STATUS: Record<APIErrorCode, number>;
+type APIErrorDetailsMap = {
+    TOKEN_REFRESH_TOO_EARLY: {
+        retryIn: number;
+        retryAt: number;
+    };
+    TOO_MANY_REQUESTS: {
+        retryIn: number;
+        retryAt: number;
+    };
+    VALIDATION_ERROR: {
+        details: {
+            field: PropertyKey;
+            message: string;
+        }[];
+    };
+};
+type APIErrorDetails<T extends APIErrorCode> = T extends keyof APIErrorDetailsMap ? APIErrorDetailsMap[T] : never;
+type APIErrorCodeWithDetails = keyof APIErrorDetailsMap;
+type APIErrorCodeWithoutDetails = Exclude<APIErrorCode, APIErrorCodeWithDetails>;
+type AnyAPIErrorDetails = APIErrorDetailsMap[APIErrorCodeWithDetails];
+type APIErrorConstructorArgs = [code: APIErrorCodeWithoutDetails, message?: string] | {
+    [TCode in APIErrorCodeWithDetails]: [
+        code: TCode,
+        message: string | undefined,
+        details: APIErrorDetails<TCode>
+    ];
+}[APIErrorCodeWithDetails];
+declare class APIError extends Error {
+    code: APIErrorCode;
+    readonly status: number;
+    readonly details?: AnyAPIErrorDetails;
+    constructor(...args: APIErrorConstructorArgs);
+}
+
+export { APIError, APIErrorCode, type APIErrorDetails, type APIErrorDetailsMap, API_ERROR_STATUS };

package/dist/api.error.d.ts

@@ -0,0 +1,65 @@
+declare const APIErrorCode: {
+    readonly BAD_REQUEST: "BAD_REQUEST";
+    readonly UNAUTHORIZED: "UNAUTHORIZED";
+    readonly FORBIDDEN: "FORBIDDEN";
+    readonly NOT_FOUND: "NOT_FOUND";
+    readonly ROUTE_NOT_FOUND: "ROUTE_NOT_FOUND";
+    readonly TOO_MANY_REQUESTS: "TOO_MANY_REQUESTS";
+    readonly CONFLICT: "CONFLICT";
+    readonly INTERNAL_SERVER_ERROR: "INTERNAL_SERVER_ERROR";
+    readonly TOKEN_EXPIRED: "TOKEN_EXPIRED";
+    readonly REFRESH_TOKEN_EXPIRED: "REFRESH_TOKEN_EXPIRED";
+    readonly ACCESS_TOKEN_EXPIRED: "ACCESS_TOKEN_EXPIRED";
+    readonly ACCESS_TOKEN_REQUIRED: "ACCESS_TOKEN_REQUIRED";
+    readonly TOKEN_REFRESH_TOO_EARLY: "TOKEN_REFRESH_TOO_EARLY";
+    readonly EMAIL_NOT_VERIFIED: "EMAIL_NOT_VERIFIED";
+    readonly PHONE_NOT_VERIFIED: "PHONE_NOT_VERIFIED";
+    readonly TOKEN_NOT_FOUND: "TOKEN_NOT_FOUND";
+    readonly INVALID_TOKEN: "INVALID_TOKEN";
+    readonly RESET_PASSWORD_TOKEN_USED: "RESET_PASSWORD_TOKEN_USED";
+    readonly RESET_PASSWORD_NEEDED: "RESET_PASSWORD_NEEDED";
+    readonly ROLE_DISABLED: "ROLE_DISABLED";
+    readonly SESSION_NOT_FOUND: "SESSION_NOT_FOUND";
+    readonly SESSION_DISABLED: "SESSION_DISABLED";
+    readonly INVALID_RESPONSE: "INVALID_RESPONSE";
+    readonly UNKNOWN_CLIENT_ERROR: "UNKNOWN_CLIENT_ERROR";
+    readonly INVALID_CREDENTIALS: "INVALID_CREDENTIALS";
+    readonly VALIDATION_ERROR: "VALIDATION_ERROR";
+};
+type APIErrorCode = (typeof APIErrorCode)[keyof typeof APIErrorCode];
+declare const API_ERROR_STATUS: Record<APIErrorCode, number>;
+type APIErrorDetailsMap = {
+    TOKEN_REFRESH_TOO_EARLY: {
+        retryIn: number;
+        retryAt: number;
+    };
+    TOO_MANY_REQUESTS: {
+        retryIn: number;
+        retryAt: number;
+    };
+    VALIDATION_ERROR: {
+        details: {
+            field: PropertyKey;
+            message: string;
+        }[];
+    };
+};
+type APIErrorDetails<T extends APIErrorCode> = T extends keyof APIErrorDetailsMap ? APIErrorDetailsMap[T] : never;
+type APIErrorCodeWithDetails = keyof APIErrorDetailsMap;
+type APIErrorCodeWithoutDetails = Exclude<APIErrorCode, APIErrorCodeWithDetails>;
+type AnyAPIErrorDetails = APIErrorDetailsMap[APIErrorCodeWithDetails];
+type APIErrorConstructorArgs = [code: APIErrorCodeWithoutDetails, message?: string] | {
+    [TCode in APIErrorCodeWithDetails]: [
+        code: TCode,
+        message: string | undefined,
+        details: APIErrorDetails<TCode>
+    ];
+}[APIErrorCodeWithDetails];
+declare class APIError extends Error {
+    code: APIErrorCode;
+    readonly status: number;
+    readonly details?: AnyAPIErrorDetails;
+    constructor(...args: APIErrorConstructorArgs);
+}
+
+export { APIError, APIErrorCode, type APIErrorDetails, type APIErrorDetailsMap, API_ERROR_STATUS };

package/dist/api.error.js

@@ -0,0 +1,83 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/api.error.ts
+var APIErrorCode = {
+  BAD_REQUEST: "BAD_REQUEST",
+  UNAUTHORIZED: "UNAUTHORIZED",
+  FORBIDDEN: "FORBIDDEN",
+  NOT_FOUND: "NOT_FOUND",
+  ROUTE_NOT_FOUND: "ROUTE_NOT_FOUND",
+  TOO_MANY_REQUESTS: "TOO_MANY_REQUESTS",
+  CONFLICT: "CONFLICT",
+  INTERNAL_SERVER_ERROR: "INTERNAL_SERVER_ERROR",
+  TOKEN_EXPIRED: "TOKEN_EXPIRED",
+  REFRESH_TOKEN_EXPIRED: "REFRESH_TOKEN_EXPIRED",
+  ACCESS_TOKEN_EXPIRED: "ACCESS_TOKEN_EXPIRED",
+  ACCESS_TOKEN_REQUIRED: "ACCESS_TOKEN_REQUIRED",
+  TOKEN_REFRESH_TOO_EARLY: "TOKEN_REFRESH_TOO_EARLY",
+  EMAIL_NOT_VERIFIED: "EMAIL_NOT_VERIFIED",
+  PHONE_NOT_VERIFIED: "PHONE_NOT_VERIFIED",
+  TOKEN_NOT_FOUND: "TOKEN_NOT_FOUND",
+  INVALID_TOKEN: "INVALID_TOKEN",
+  RESET_PASSWORD_TOKEN_USED: "RESET_PASSWORD_TOKEN_USED",
+  RESET_PASSWORD_NEEDED: "RESET_PASSWORD_NEEDED",
+  ROLE_DISABLED: "ROLE_DISABLED",
+  SESSION_NOT_FOUND: "SESSION_NOT_FOUND",
+  SESSION_DISABLED: "SESSION_DISABLED",
+  INVALID_RESPONSE: "INVALID_RESPONSE",
+  UNKNOWN_CLIENT_ERROR: "UNKNOWN_CLIENT_ERROR",
+  INVALID_CREDENTIALS: "INVALID_CREDENTIALS",
+  VALIDATION_ERROR: "VALIDATION_ERROR"
+};
+var API_ERROR_STATUS = {
+  BAD_REQUEST: 400,
+  UNAUTHORIZED: 401,
+  FORBIDDEN: 403,
+  NOT_FOUND: 404,
+  ROUTE_NOT_FOUND: 404,
+  TOO_MANY_REQUESTS: 429,
+  CONFLICT: 409,
+  INTERNAL_SERVER_ERROR: 500,
+  TOKEN_EXPIRED: 401,
+  REFRESH_TOKEN_EXPIRED: 401,
+  ACCESS_TOKEN_EXPIRED: 401,
+  ACCESS_TOKEN_REQUIRED: 401,
+  TOKEN_REFRESH_TOO_EARLY: 403,
+  EMAIL_NOT_VERIFIED: 401,
+  PHONE_NOT_VERIFIED: 401,
+  TOKEN_NOT_FOUND: 404,
+  INVALID_TOKEN: 401,
+  RESET_PASSWORD_TOKEN_USED: 401,
+  RESET_PASSWORD_NEEDED: 400,
+  ROLE_DISABLED: 403,
+  SESSION_NOT_FOUND: 404,
+  SESSION_DISABLED: 401,
+  INVALID_RESPONSE: 500,
+  UNKNOWN_CLIENT_ERROR: 400,
+  INVALID_CREDENTIALS: 400,
+  VALIDATION_ERROR: 400
+};
+var APIError = class _APIError extends Error {
+  static {
+    __name(this, "APIError");
+  }
+  code;
+  status;
+  details;
+  constructor(...args) {
+    const [code, message, details] = args;
+    super(message);
+    this.name = "APIError";
+    this.code = code;
+    this.status = API_ERROR_STATUS[code];
+    this.details = details;
+    Object.setPrototypeOf(this, _APIError.prototype);
+  }
+};
+export {
+  APIError,
+  APIErrorCode,
+  API_ERROR_STATUS
+};
+//# sourceMappingURL=api.error.js.map

package/dist/api.error.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/api.error.ts"],"sourcesContent":["export const APIErrorCode = {\r\n    BAD_REQUEST: 'BAD_REQUEST',\r\n    UNAUTHORIZED: 'UNAUTHORIZED',\r\n    FORBIDDEN: 'FORBIDDEN',\r\n    NOT_FOUND: 'NOT_FOUND',\r\n    ROUTE_NOT_FOUND: 'ROUTE_NOT_FOUND',\r\n    TOO_MANY_REQUESTS: 'TOO_MANY_REQUESTS',\r\n    CONFLICT: 'CONFLICT',\r\n    INTERNAL_SERVER_ERROR: 'INTERNAL_SERVER_ERROR',\r\n    TOKEN_EXPIRED: 'TOKEN_EXPIRED',\r\n    REFRESH_TOKEN_EXPIRED: 'REFRESH_TOKEN_EXPIRED',\r\n    ACCESS_TOKEN_EXPIRED: 'ACCESS_TOKEN_EXPIRED',\r\n    ACCESS_TOKEN_REQUIRED: 'ACCESS_TOKEN_REQUIRED',\r\n    TOKEN_REFRESH_TOO_EARLY: 'TOKEN_REFRESH_TOO_EARLY',\r\n    EMAIL_NOT_VERIFIED: 'EMAIL_NOT_VERIFIED',\r\n    PHONE_NOT_VERIFIED: 'PHONE_NOT_VERIFIED',\r\n    TOKEN_NOT_FOUND: 'TOKEN_NOT_FOUND',\r\n    INVALID_TOKEN: 'INVALID_TOKEN',\r\n    RESET_PASSWORD_TOKEN_USED: 'RESET_PASSWORD_TOKEN_USED',\r\n    RESET_PASSWORD_NEEDED: 'RESET_PASSWORD_NEEDED',\r\n    ROLE_DISABLED: 'ROLE_DISABLED',\r\n    SESSION_NOT_FOUND: 'SESSION_NOT_FOUND',\r\n    SESSION_DISABLED: 'SESSION_DISABLED',\r\n    INVALID_RESPONSE: 'INVALID_RESPONSE',\r\n    UNKNOWN_CLIENT_ERROR: 'UNKNOWN_CLIENT_ERROR',\r\n    INVALID_CREDENTIALS: 'INVALID_CREDENTIALS',\r\n    VALIDATION_ERROR: 'VALIDATION_ERROR'\r\n} as const\r\n\r\nexport type APIErrorCode = (typeof APIErrorCode)[keyof typeof APIErrorCode]\r\n\r\nexport const API_ERROR_STATUS: Record<APIErrorCode, number> = {\r\n    BAD_REQUEST: 400,\r\n    UNAUTHORIZED: 401,\r\n    FORBIDDEN: 403,\r\n    NOT_FOUND: 404,\r\n    ROUTE_NOT_FOUND: 404,\r\n    TOO_MANY_REQUESTS: 429,\r\n    CONFLICT: 409,\r\n    INTERNAL_SERVER_ERROR: 500,\r\n    TOKEN_EXPIRED: 401,\r\n    REFRESH_TOKEN_EXPIRED: 401,\r\n    ACCESS_TOKEN_EXPIRED: 401,\r\n    ACCESS_TOKEN_REQUIRED: 401,\r\n    TOKEN_REFRESH_TOO_EARLY: 403,\r\n    EMAIL_NOT_VERIFIED: 401,\r\n    PHONE_NOT_VERIFIED: 401,\r\n    TOKEN_NOT_FOUND: 404,\r\n    INVALID_TOKEN: 401,\r\n    RESET_PASSWORD_TOKEN_USED: 401,\r\n    RESET_PASSWORD_NEEDED: 400,\r\n    ROLE_DISABLED: 403,\r\n    SESSION_NOT_FOUND: 404,\r\n    SESSION_DISABLED: 401,\r\n    INVALID_RESPONSE: 500,\r\n    UNKNOWN_CLIENT_ERROR: 400,\r\n    INVALID_CREDENTIALS: 400,\r\n    VALIDATION_ERROR: 400\r\n}\r\n\r\nexport type APIErrorDetailsMap = {\r\n    TOKEN_REFRESH_TOO_EARLY: {\r\n        retryIn: number\r\n        retryAt: number\r\n    },\r\n    TOO_MANY_REQUESTS: {\r\n        retryIn: number\r\n        retryAt: number\r\n    },\r\n    VALIDATION_ERROR: {\r\n        details: {\r\n            field: PropertyKey\r\n            message: string\r\n        }[]\r\n    }\r\n}\r\n\r\nexport type APIErrorDetails<T extends APIErrorCode> = T extends keyof APIErrorDetailsMap ? APIErrorDetailsMap[T] : never\r\n\r\ntype APIErrorCodeWithDetails = keyof APIErrorDetailsMap\r\ntype APIErrorCodeWithoutDetails = Exclude<APIErrorCode, APIErrorCodeWithDetails>\r\ntype AnyAPIErrorDetails = APIErrorDetailsMap[APIErrorCodeWithDetails]\r\ntype APIErrorConstructorArgs =\r\n    | [code: APIErrorCodeWithoutDetails, message?: string]\r\n    | {\r\n        [TCode in APIErrorCodeWithDetails]: [\r\n            code: TCode,\r\n            message: string | undefined,\r\n            details: APIErrorDetails<TCode>\r\n        ]\r\n    }[APIErrorCodeWithDetails]\r\n\r\nexport class APIError extends Error {\r\n    public code: APIErrorCode\r\n    public readonly status: number\r\n    public readonly details?: AnyAPIErrorDetails\r\n\r\n    constructor(...args: APIErrorConstructorArgs) {\r\n        const [code, message, details] = args\r\n\r\n        super(message)\r\n        this.name = 'APIError'\r\n        this.code = code\r\n        this.status = API_ERROR_STATUS[code]\r\n        this.details = details\r\n\r\n        Object.setPrototypeOf(this, APIError.prototype)\r\n    }\r\n}\r\n"],"mappings":";;;;AAAO,IAAMA,eAAe;EACxBC,aAAa;EACbC,cAAc;EACdC,WAAW;EACXC,WAAW;EACXC,iBAAiB;EACjBC,mBAAmB;EACnBC,UAAU;EACVC,uBAAuB;EACvBC,eAAe;EACfC,uBAAuB;EACvBC,sBAAsB;EACtBC,uBAAuB;EACvBC,yBAAyB;EACzBC,oBAAoB;EACpBC,oBAAoB;EACpBC,iBAAiB;EACjBC,eAAe;EACfC,2BAA2B;EAC3BC,uBAAuB;EACvBC,eAAe;EACfC,mBAAmB;EACnBC,kBAAkB;EAClBC,kBAAkB;EAClBC,sBAAsB;EACtBC,qBAAqB;EACrBC,kBAAkB;AACtB;AAIO,IAAMC,mBAAiD;EAC1D1B,aAAa;EACbC,cAAc;EACdC,WAAW;EACXC,WAAW;EACXC,iBAAiB;EACjBC,mBAAmB;EACnBC,UAAU;EACVC,uBAAuB;EACvBC,eAAe;EACfC,uBAAuB;EACvBC,sBAAsB;EACtBC,uBAAuB;EACvBC,yBAAyB;EACzBC,oBAAoB;EACpBC,oBAAoB;EACpBC,iBAAiB;EACjBC,eAAe;EACfC,2BAA2B;EAC3BC,uBAAuB;EACvBC,eAAe;EACfC,mBAAmB;EACnBC,kBAAkB;EAClBC,kBAAkB;EAClBC,sBAAsB;EACtBC,qBAAqB;EACrBC,kBAAkB;AACtB;AAkCO,IAAME,WAAN,MAAMA,kBAAiBC,MAAAA;EA5F9B,OA4F8BA;;;EACnBC;EACSC;EACAC;EAEhB,eAAeC,MAA+B;AAC1C,UAAM,CAACH,MAAMI,SAASF,OAAAA,IAAWC;AAEjC,UAAMC,OAAAA;AACN,SAAKC,OAAO;AACZ,SAAKL,OAAOA;AACZ,SAAKC,SAASJ,iBAAiBG,IAAAA;AAC/B,SAAKE,UAAUA;AAEfI,WAAOC,eAAe,MAAMT,UAASU,SAAS;EAClD;AACJ;","names":["APIErrorCode","BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","ROUTE_NOT_FOUND","TOO_MANY_REQUESTS","CONFLICT","INTERNAL_SERVER_ERROR","TOKEN_EXPIRED","REFRESH_TOKEN_EXPIRED","ACCESS_TOKEN_EXPIRED","ACCESS_TOKEN_REQUIRED","TOKEN_REFRESH_TOO_EARLY","EMAIL_NOT_VERIFIED","PHONE_NOT_VERIFIED","TOKEN_NOT_FOUND","INVALID_TOKEN","RESET_PASSWORD_TOKEN_USED","RESET_PASSWORD_NEEDED","ROLE_DISABLED","SESSION_NOT_FOUND","SESSION_DISABLED","INVALID_RESPONSE","UNKNOWN_CLIENT_ERROR","INVALID_CREDENTIALS","VALIDATION_ERROR","API_ERROR_STATUS","APIError","Error","code","status","details","args","message","name","Object","setPrototypeOf","prototype"]}

package/dist/base-class/base.controller.cjs

@@ -0,0 +1,148 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/base-class/base.controller.ts
+var base_controller_exports = {};
+__export(base_controller_exports, {
+  BaseController: () => BaseController
+});
+module.exports = __toCommonJS(base_controller_exports);
+var BaseController = class {
+  static {
+    __name(this, "BaseController");
+  }
+  defaultLimit = 10;
+  maxLimit = 100;
+  defaultOffset = 0;
+  defaultSortBy = "createdAt";
+  defaultSortDirection = "ASC";
+  allowedSortFields = [];
+  constructor(options) {
+    if (options) {
+      if (options.defaultLimit !== void 0) {
+        this.defaultLimit = options.defaultLimit;
+      }
+      if (options.maxLimit !== void 0) {
+        this.maxLimit = options.maxLimit;
+      }
+      if (options.defaultOffset !== void 0) {
+        this.defaultOffset = options.defaultOffset;
+      }
+      if (options.defaultSortBy !== void 0) {
+        this.defaultSortBy = options.defaultSortBy;
+      }
+      if (options.defaultSortDirection !== void 0) {
+        this.defaultSortDirection = options.defaultSortDirection;
+      }
+      if (options.allowedSortFields !== void 0) {
+        this.allowedSortFields = [
+          ...new Set(options.allowedSortFields)
+        ];
+      }
+    }
+  }
+  parseListQuery = /* @__PURE__ */ __name((request) => {
+    const { query: rawQuery, limit: rawLimit, offset: rawOffset, sortBy: rawSortBy, sortDirection: rawSortDirection } = request.query;
+    return {
+      query: this.parseQuery(rawQuery),
+      limit: this.parseLimit(rawLimit),
+      offset: this.parseOffset(rawOffset),
+      sortBy: this.parseSortBy(rawSortBy),
+      sortDirection: this.parseSortDirection(rawSortDirection)
+    };
+  }, "parseListQuery");
+  //@ts-ignore
+  parseTypeORMFindManyOptions(rawQuery) {
+    try {
+      if (typeof rawQuery === "string" && rawQuery.trim().length > 0) {
+        const result = JSON.parse(rawQuery);
+        if ("where" in result && typeof result.where === "object" && result.where !== null || "relations" in result && typeof result.relations === "object" && result.relations !== null || "order" in result && typeof result.order === "object" || "select" in result && typeof result.select === "object" || "take" in result || "skip" in result) {
+          if ("take" in result) result.take = parseInt(result.take);
+          if ("skip" in result) result.skip = parseInt(result.skip);
+          return result;
+        }
+      }
+    } catch {
+      return void 0;
+    }
+    return void 0;
+  }
+  parseQuery(rawQuery) {
+    if (Array.isArray(rawQuery)) {
+      rawQuery = rawQuery[0];
+    }
+    if (typeof rawQuery !== "string" || rawQuery.trim().length === 0) {
+      return void 0;
+    }
+    return rawQuery;
+  }
+  parseLimit(rawLimit) {
+    const parsed = this.parseInteger(rawLimit);
+    if (parsed === null || parsed < 1) {
+      return this.defaultLimit;
+    }
+    return Math.min(parsed, this.maxLimit);
+  }
+  parseOffset(rawOffset) {
+    const parsed = this.parseInteger(rawOffset);
+    if (parsed === null || parsed < 0) {
+      return this.defaultOffset;
+    }
+    return parsed;
+  }
+  parseSortBy(rawSortBy) {
+    if (Array.isArray(rawSortBy)) {
+      rawSortBy = rawSortBy[0];
+    }
+    if (typeof rawSortBy !== "string") {
+      return this.defaultSortBy;
+    }
+    if (!this.allowedSortFields.includes(rawSortBy)) {
+      return this.defaultSortBy;
+    }
+    return rawSortBy;
+  }
+  parseSortDirection(rawSortDirection) {
+    if (Array.isArray(rawSortDirection)) {
+      rawSortDirection = rawSortDirection[0];
+    }
+    if (typeof rawSortDirection !== "string") {
+      return this.defaultSortDirection;
+    }
+    return rawSortDirection.toLowerCase() === "desc" ? "DESC" : "ASC";
+  }
+  parseInteger(value) {
+    if (Array.isArray(value)) {
+      value = value[0];
+    }
+    if (typeof value !== "string" || value.trim().length === 0) {
+      return null;
+    }
+    const numberValue = Number(value);
+    if (!Number.isFinite(numberValue)) {
+      return null;
+    }
+    return Math.floor(numberValue);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BaseController
+});
+//# sourceMappingURL=base.controller.cjs.map

package/dist/base-class/base.controller.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/base-class/base.controller.ts"],"sourcesContent":["import type { FindManyOptions } from 'typeorm'\r\nimport type { Request } from \"express\"\r\nimport type { BaseEntity } from \"./base.entity.js\"\r\n\r\ntype BaseControllerOptions<T> = {\r\n    defaultLimit?: number\r\n    maxLimit?: number\r\n    defaultOffset?: number\r\n    defaultSortBy?: keyof T\r\n    defaultSortDirection?: 'ASC' | 'DESC'\r\n    allowedSortFields?: (keyof T)[]\r\n}\r\n\r\nexport type SortDirection = \"ASC\" | \"DESC\"\r\n\r\nexport type ParsedListQuery<T> = {\r\n    query: string | undefined;\r\n    limit: number;\r\n    offset: number;\r\n    sortBy: keyof T | keyof BaseEntity;\r\n    sortDirection: SortDirection\r\n}\r\n\r\nexport class BaseController<T> {\r\n    private defaultLimit = 10\r\n    private maxLimit = 100\r\n    private defaultOffset = 0\r\n    private defaultSortBy: keyof T | keyof BaseEntity = 'createdAt'\r\n    private defaultSortDirection: 'ASC' | 'DESC' = 'ASC'\r\n    private allowedSortFields: (keyof T)[] = []\r\n\r\n    constructor(options?: BaseControllerOptions<T>) {\r\n        if (options) {\r\n            if (options.defaultLimit !== undefined) {\r\n                this.defaultLimit = options.defaultLimit\r\n            }\r\n\r\n            if (options.maxLimit !== undefined) {\r\n                this.maxLimit = options.maxLimit\r\n            }\r\n\r\n            if (options.defaultOffset !== undefined) {\r\n                this.defaultOffset = options.defaultOffset\r\n            }\r\n\r\n            if (options.defaultSortBy !== undefined) {\r\n                this.defaultSortBy = options.defaultSortBy\r\n            }\r\n\r\n            if (options.defaultSortDirection !== undefined) {\r\n                this.defaultSortDirection = options.defaultSortDirection\r\n            }\r\n\r\n            if (options.allowedSortFields !== undefined) {\r\n                this.allowedSortFields = [...new Set(options.allowedSortFields)]\r\n            }\r\n        }\r\n    }\r\n\r\n    parseListQuery = (request: Request): ParsedListQuery<T> => {\r\n        const { query: rawQuery, limit: rawLimit, offset: rawOffset, sortBy: rawSortBy, sortDirection: rawSortDirection } = request.query\r\n\r\n        return {\r\n            query: this.parseQuery(rawQuery),\r\n            limit: this.parseLimit(rawLimit),\r\n            offset: this.parseOffset(rawOffset),\r\n            sortBy: this.parseSortBy(rawSortBy),\r\n            sortDirection: this.parseSortDirection(rawSortDirection)\r\n        }\r\n    }\r\n\r\n    //@ts-ignore\r\n    private parseTypeORMFindManyOptions(rawQuery: unknown): FindManyOptions<T> | undefined {\r\n        try {\r\n            if (typeof rawQuery === 'string' && rawQuery.trim().length > 0) {\r\n                const result = JSON.parse(rawQuery)\r\n\r\n                if (\r\n                    \"where\" in result && typeof result.where === 'object' && result.where !== null ||\r\n                    \"relations\" in result && typeof result.relations === 'object' && result.relations !== null ||\r\n                    \"order\" in result && typeof result.order === 'object' ||\r\n                    \"select\" in result && typeof result.select === 'object' ||\r\n                    \"take\" in result ||\r\n                    \"skip\" in result\r\n                ) {\r\n                    if (\"take\" in result)\r\n                        result.take = parseInt(result.take)\r\n\r\n                    if (\"skip\" in result)\r\n                        result.skip = parseInt(result.skip)\r\n\r\n                    return result as FindManyOptions<T>\r\n                }\r\n            }\r\n        } catch {\r\n            return undefined\r\n        }\r\n\r\n        return undefined\r\n    }\r\n\r\n    private parseQuery(rawQuery: unknown): string | undefined {\r\n        if (Array.isArray(rawQuery)) {\r\n            rawQuery = rawQuery[0]\r\n        }\r\n\r\n        if (typeof rawQuery !== 'string' || rawQuery.trim().length === 0) {\r\n            return undefined\r\n        }\r\n\r\n        return rawQuery\r\n    }\r\n\r\n    private parseLimit(rawLimit: unknown): number {\r\n        const parsed = this.parseInteger(rawLimit)\r\n\r\n        if (parsed === null || parsed < 1) {\r\n            return this.defaultLimit\r\n        }\r\n\r\n        return Math.min(parsed, this.maxLimit)\r\n    }\r\n\r\n    private parseOffset(rawOffset: unknown): number {\r\n        const parsed = this.parseInteger(rawOffset)\r\n\r\n        if (parsed === null || parsed < 0) {\r\n            return this.defaultOffset\r\n        }\r\n\r\n        return parsed\r\n    }\r\n\r\n    private parseSortBy(rawSortBy: unknown): keyof T | keyof BaseEntity {\r\n        if (Array.isArray(rawSortBy)) {\r\n            rawSortBy = rawSortBy[0]\r\n        }\r\n\r\n        if (typeof rawSortBy !== 'string') {\r\n            return this.defaultSortBy\r\n        }\r\n\r\n        if (!this.allowedSortFields.includes(rawSortBy as keyof T)) {\r\n            return this.defaultSortBy\r\n        }\r\n\r\n        return rawSortBy as keyof T\r\n    }\r\n\r\n    private parseSortDirection(rawSortDirection: unknown): 'ASC' | 'DESC' {\r\n        if (Array.isArray(rawSortDirection)) {\r\n            rawSortDirection = rawSortDirection[0]\r\n        }\r\n\r\n        if (typeof rawSortDirection !== 'string') {\r\n            return this.defaultSortDirection\r\n        }\r\n\r\n        return rawSortDirection.toLowerCase() === 'desc' ? 'DESC' : 'ASC'\r\n    }\r\n\r\n    private parseInteger(value: unknown): number | null {\r\n        if (Array.isArray(value)) {\r\n            value = value[0]\r\n        }\r\n\r\n        if (typeof value !== 'string' || value.trim().length === 0) {\r\n            return null\r\n        }\r\n\r\n        const numberValue = Number(value)\r\n\r\n        if (!Number.isFinite(numberValue)) {\r\n            return null\r\n        }\r\n\r\n        return Math.floor(numberValue)\r\n    }\r\n}\r\n"],"mappings":"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","names":["BaseController","defaultLimit","maxLimit","defaultOffset","defaultSortBy","defaultSortDirection","allowedSortFields","options","undefined","Set","parseListQuery","request","query","rawQuery","limit","rawLimit","offset","rawOffset","sortBy","rawSortBy","sortDirection","rawSortDirection","parseQuery","parseLimit","parseOffset","parseSortBy","parseSortDirection","parseTypeORMFindManyOptions","trim","length","result","JSON","parse","where","relations","order","select","take","parseInt","skip","Array","isArray","parsed","parseInteger","Math","min","includes","toLowerCase","value","numberValue","Number","isFinite","floor"]}

package/dist/base-class/base.controller.d.cts

@@ -0,0 +1,38 @@
+import { Request } from 'express';
+import { BaseEntity } from './base.entity.cjs';
+
+type BaseControllerOptions<T> = {
+    defaultLimit?: number;
+    maxLimit?: number;
+    defaultOffset?: number;
+    defaultSortBy?: keyof T;
+    defaultSortDirection?: 'ASC' | 'DESC';
+    allowedSortFields?: (keyof T)[];
+};
+type SortDirection = "ASC" | "DESC";
+type ParsedListQuery<T> = {
+    query: string | undefined;
+    limit: number;
+    offset: number;
+    sortBy: keyof T | keyof BaseEntity;
+    sortDirection: SortDirection;
+};
+declare class BaseController<T> {
+    private defaultLimit;
+    private maxLimit;
+    private defaultOffset;
+    private defaultSortBy;
+    private defaultSortDirection;
+    private allowedSortFields;
+    constructor(options?: BaseControllerOptions<T>);
+    parseListQuery: (request: Request) => ParsedListQuery<T>;
+    private parseTypeORMFindManyOptions;
+    private parseQuery;
+    private parseLimit;
+    private parseOffset;
+    private parseSortBy;
+    private parseSortDirection;
+    private parseInteger;
+}
+
+export { BaseController, type ParsedListQuery, type SortDirection };

package/dist/base-class/base.controller.d.ts

@@ -0,0 +1,38 @@
+import { Request } from 'express';
+import { BaseEntity } from './base.entity.js';
+
+type BaseControllerOptions<T> = {
+    defaultLimit?: number;
+    maxLimit?: number;
+    defaultOffset?: number;
+    defaultSortBy?: keyof T;
+    defaultSortDirection?: 'ASC' | 'DESC';
+    allowedSortFields?: (keyof T)[];
+};
+type SortDirection = "ASC" | "DESC";
+type ParsedListQuery<T> = {
+    query: string | undefined;
+    limit: number;
+    offset: number;
+    sortBy: keyof T | keyof BaseEntity;
+    sortDirection: SortDirection;
+};
+declare class BaseController<T> {
+    private defaultLimit;
+    private maxLimit;
+    private defaultOffset;
+    private defaultSortBy;
+    private defaultSortDirection;
+    private allowedSortFields;
+    constructor(options?: BaseControllerOptions<T>);
+    parseListQuery: (request: Request) => ParsedListQuery<T>;
+    private parseTypeORMFindManyOptions;
+    private parseQuery;
+    private parseLimit;
+    private parseOffset;
+    private parseSortBy;
+    private parseSortDirection;
+    private parseInteger;
+}
+
+export { BaseController, type ParsedListQuery, type SortDirection };