topsyde-utils 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE. 

package/README.md

@@ -0,0 +1,192 @@
+# topsyde-utils
+
+A comprehensive bundle of TypeScript utility classes and functions designed to simplify common programming tasks.
+
+## Installation
+
+```bash
+npm install topsyde-utils
+# or
+yarn add topsyde-utils
+```
+
+## Features
+
+- **Error Handling**: Custom error classes like `Throwable` for expected errors that shouldn't trigger retries
+- **Type Guards**: Robust type checking with the `Guards` class
+- **Utility Functions**: Extensive collection of helper functions in the `Lib` class
+- **Singleton Pattern**: Easy implementation of the singleton pattern
+- **Application Utilities**: Response formatting for web applications
+- **Type Definitions**: Useful TypeScript type definitions
+
+## Usage Examples
+
+### Throwable Error Handling
+
+```typescript
+import { Throwable, Lib } from 'topsyde-utils';
+
+// Basic usage
+throw new Throwable("This operation failed but it's expected");
+
+// With context
+throw new Throwable("User not found", { 
+  context: { userId: 123, operation: "fetch" } 
+});
+
+// Using with RetryHandler
+await Lib.RetryHandler(async () => {
+  // If this throws a Throwable, RetryHandler won't retry
+  const result = await someOperation();
+  if (!result) {
+    throw new Throwable("Expected failure condition");
+  }
+  return result;
+});
+```
+
+### Type Guards
+
+```typescript
+import { Guards } from 'topsyde-utils';
+
+if (Guards.IsString(value)) {
+  // value is guaranteed to be a string
+  console.log(value.toUpperCase());
+}
+
+if (Guards.IsNumber(value, true)) {
+  // value is guaranteed to be a non-null number
+  console.log(value.toFixed(2));
+}
+```
+
+### Utility Functions
+
+```typescript
+import { Lib } from 'topsyde-utils';
+
+// Date formatting
+const formattedDate = Lib.FormatDate(new Date(), "DD/MM/YYYY");
+
+// Retry mechanism
+const result = await Lib.RetryHandler(
+  async () => await fetchData(),
+  3 // number of retries
+);
+
+// UUID generation
+const id = Lib.UUID();
+```
+
+### Singleton Pattern
+
+```typescript
+import { Singleton } from 'topsyde-utils';
+
+class Database extends Singleton {
+  connect() {
+    // Connect to database
+  }
+}
+
+// Get the singleton instance
+const db = Database.getInstance();
+db.connect();
+```
+
+### Using Modules from Subdirectories
+
+The package organizes related functionality into modules. For example, the router module:
+
+```typescript
+// Import the entire Router module
+import { Router } from 'topsyde-utils';
+
+// Create a new router
+const router = new Router.Router();
+
+// Add a route
+router.addRoute(new Router.Route('/users', 'GET', async (req, res) => {
+  // Handle request
+}));
+
+// Use middleware
+Router.applyMiddleware(req, res, [
+  Router.commonMiddleware.logger,
+  Router.commonMiddleware.cors
+]);
+```
+
+## API Documentation
+
+### Throwable
+
+Custom error class for errors that are expected to be thrown and should not trigger retry mechanisms or be reported to error monitoring services.
+
+```typescript
+new Throwable(message, options);
+```
+
+- `message`: Error message or existing Error object to wrap
+- `options`: Configuration options
+  - `logError`: Whether to log this error to console (default: true)
+  - `context`: Additional context data to attach to the error
+
+### Guards
+
+Type guard utilities for safe type checking.
+
+- `IsString(value, excludeNull?)`: Check if value is a string
+- `IsNumber(value, excludeNull?)`: Check if value is a number
+- `IsBoolean(value, excludeNull?)`: Check if value is a boolean
+- `IsArray(value, excludeNull?)`: Check if value is an array
+- `IsObject(value, excludeNull?)`: Check if value is an object
+- `IsFunction(value, excludeNull?)`: Check if value is a function
+- `IsNil(value)`: Check if value is null or undefined
+- `IsType<T>(obj, keys?)`: Check if object matches a type
+
+### Lib
+
+Extensive utility library with various helper functions.
+
+- Date/Time utilities
+- Retry mechanisms
+- Logging functions
+- String manipulation
+- UUID generation
+- And many more...
+
+## Development
+
+### Automatic Index Generation
+
+This package includes a script to automatically generate index files based on the contents of the src directory and its subdirectories. This makes it easier to maintain the package as you add or modify files.
+
+The script:
+1. Exports all named exports from all files
+2. Exports all default exports with capitalized names
+3. Creates barrel files (index.ts) for each subdirectory
+4. Imports and re-exports subdirectory modules in the main index.ts
+
+To generate the index files:
+
+```bash
+npm run generate-indexes
+```
+
+To build the package with the updated indexes:
+
+```bash
+npm run build:indexes
+```
+
+#### Naming Conventions
+
+- Default exports from files directly in src are exported with their capitalized name (e.g., `app.ts` → `App`)
+- Default exports from files in subdirectories are exported with the directory name as a prefix (e.g., `router/route.ts` → `RouterRoute`)
+- Subdirectories are exported as modules with the capitalized directory name (e.g., `router/` → `Router`)
+
+## License
+
+MIT

package/dist/app.d.ts

@@ -0,0 +1,11 @@
+export declare const RESPONSE_INIT: (status?: number, headers?: HeadersInit) => ResponseInit;
+export declare const RESPONSE_METHOD_OPTIONS: {
+    name: string;
+    value: string;
+};
+declare class Application {
+    static Response(data: any, status?: number, headers?: HeadersInit): Response;
+    static Error<T extends BodyInit | unknown | Error>(error: T, status?: number, headers?: HeadersInit): Response;
+    static Throw<T extends BodyInit | unknown | Error>(error: T, status?: number, headers?: HeadersInit): Response;
+}
+export default Application;

package/dist/app.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RESPONSE_METHOD_OPTIONS = exports.RESPONSE_INIT = void 0;
+const RESPONSE_INIT = (status, headers) => {
+    return {
+        status: status ?? 200,
+        headers: {
+            "Content-Type": "application/json",
+            "Access-Control-Allow-Methods": "GET, POST, OPTIONS",
+            "Access-Control-Allow-Headers": "Content-Type, Authorization",
+            "Access-Control-Allow-Credentials": "true",
+        },
+    };
+};
+exports.RESPONSE_INIT = RESPONSE_INIT;
+exports.RESPONSE_METHOD_OPTIONS = {
+    name: "Access-Control-Max-Age",
+    value: "86400",
+};
+class Application {
+    static Response(data, status = 200, headers) {
+        return Response.json({ status: true, data }, (0, exports.RESPONSE_INIT)(status, headers));
+    }
+    static Error(error, status = 200, headers) {
+        return Response.json({ status: false, error }, (0, exports.RESPONSE_INIT)(status, headers));
+    }
+    static Throw(error, status = 400, headers) {
+        return Response.json(error, (0, exports.RESPONSE_INIT)(status, headers));
+    }
+}
+exports.default = Application;
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":";;;AAAO,MAAM,aAAa,GAAG,CAAC,MAAe,EAAE,OAAqB,EAAgB,EAAE;IACrF,OAAO;QACN,MAAM,EAAE,MAAM,IAAI,GAAG;QACrB,OAAO,EAAE;YACR,cAAc,EAAE,kBAAkB;YAClC,8BAA8B,EAAE,oBAAoB;YACpD,8BAA8B,EAAE,6BAA6B;YAC7D,kCAAkC,EAAE,MAAM;SAC1C;KACD,CAAC;AACH,CAAC,CAAC;AAVW,QAAA,aAAa,iBAUxB;AAEW,QAAA,uBAAuB,GAAG;IACtC,IAAI,EAAE,wBAAwB;IAC9B,KAAK,EAAE,OAAO;CACd,CAAC;AAEF,MAAM,WAAW;IACT,MAAM,CAAC,QAAQ,CAAC,IAAS,EAAE,SAAiB,GAAG,EAAE,OAAqB;QAC5E,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,IAAA,qBAAa,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9E,CAAC;IAEM,MAAM,CAAC,KAAK,CAAuC,KAAQ,EAAE,SAAiB,GAAG,EAAE,OAAqB;QAC9G,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAA,qBAAa,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAChF,CAAC;IAEM,MAAM,CAAC,KAAK,CAAuC,KAAQ,EAAE,SAAiB,GAAG,EAAE,OAAqB;QAC9G,OAAO,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,IAAA,qBAAa,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7D,CAAC;CACD;AAED,kBAAe,WAAW,CAAC"}

package/dist/consts.d.ts

@@ -0,0 +1,30 @@
+export declare const DEFAULT_FALSE_RESPONSE = "Something went wrong. Please try again later.";
+export declare const LOG_COLORS: {
+    reset: string;
+    bright: string;
+    dim: string;
+    underscore: string;
+    blink: string;
+    reverse: string;
+    hidden: string;
+    text: {
+        black: string;
+        red: string;
+        green: string;
+        yellow: string;
+        blue: string;
+        magenta: string;
+        cyan: string;
+        white: string;
+    };
+    bg: {
+        black: string;
+        red: string;
+        green: string;
+        yellow: string;
+        blue: string;
+        magenta: string;
+        cyan: string;
+        white: string;
+    };
+};

package/dist/consts.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LOG_COLORS = exports.DEFAULT_FALSE_RESPONSE = void 0;
+exports.DEFAULT_FALSE_RESPONSE = "Something went wrong. Please try again later.";
+exports.LOG_COLORS = {
+    reset: "\x1b[0m",
+    bright: "\x1b[1m",
+    dim: "\x1b[2m",
+    underscore: "\x1b[4m",
+    blink: "\x1b[5m",
+    reverse: "\x1b[7m",
+    hidden: "\x1b[8m",
+    text: {
+        black: "\x1b[30m",
+        red: "\x1b[31m",
+        green: "\x1b[32m",
+        yellow: "\x1b[33m",
+        blue: "\x1b[34m",
+        magenta: "\x1b[35m",
+        cyan: "\x1b[36m",
+        white: "\x1b[37m",
+    },
+    bg: {
+        black: "\x1b[40m",
+        red: "\x1b[41m",
+        green: "\x1b[42m",
+        yellow: "\x1b[43m",
+        blue: "\x1b[44m",
+        magenta: "\x1b[45m",
+        cyan: "\x1b[46m",
+        white: "\x1b[47m",
+    },
+};
+//# sourceMappingURL=consts.js.map

package/dist/consts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":";;;AAAa,QAAA,sBAAsB,GAAG,+CAA+C,CAAC;AAEzE,QAAA,UAAU,GAAG;IACzB,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,GAAG,EAAE,SAAS;IACd,UAAU,EAAE,SAAS;IACrB,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,SAAS;IAEjB,IAAI,EAAE;QACL,KAAK,EAAE,UAAU;QACjB,GAAG,EAAE,UAAU;QACf,KAAK,EAAE,UAAU;QACjB,MAAM,EAAE,UAAU;QAClB,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,UAAU;QACnB,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,UAAU;KACjB;IACD,EAAE,EAAE;QACH,KAAK,EAAE,UAAU;QACjB,GAAG,EAAE,UAAU;QACf,KAAK,EAAE,UAAU;QACjB,MAAM,EAAE,UAAU;QAClB,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,UAAU;QACnB,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,UAAU;KACjB;CACD,CAAC"}

package/dist/enums.d.ts

@@ -0,0 +1,13 @@
+export declare enum E_IS {
+    ARRAY = "array",
+    OBJECT = "object",
+    FUNCTION = "function",
+    STRING = "string",
+    NUMBER = "number",
+    BOOLEAN = "boolean",
+    REGEX = "regex"
+}
+export declare enum E_ENVIRONMENTS {
+    DEV = "development",
+    PROD = "production"
+}

package/dist/enums.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.E_ENVIRONMENTS = exports.E_IS = void 0;
+var E_IS;
+(function (E_IS) {
+    E_IS["ARRAY"] = "array";
+    E_IS["OBJECT"] = "object";
+    E_IS["FUNCTION"] = "function";
+    E_IS["STRING"] = "string";
+    E_IS["NUMBER"] = "number";
+    E_IS["BOOLEAN"] = "boolean";
+    E_IS["REGEX"] = "regex";
+})(E_IS || (exports.E_IS = E_IS = {}));
+var E_ENVIRONMENTS;
+(function (E_ENVIRONMENTS) {
+    E_ENVIRONMENTS["DEV"] = "development";
+    E_ENVIRONMENTS["PROD"] = "production";
+})(E_ENVIRONMENTS || (exports.E_ENVIRONMENTS = E_ENVIRONMENTS = {}));
+//# sourceMappingURL=enums.js.map

package/dist/enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.js","sourceRoot":"","sources":["../src/enums.ts"],"names":[],"mappings":";;;AAAA,IAAY,IAQX;AARD,WAAY,IAAI;IACd,uBAAe,CAAA;IACf,yBAAiB,CAAA;IACjB,6BAAqB,CAAA;IACrB,yBAAiB,CAAA;IACjB,yBAAiB,CAAA;IACjB,2BAAmB,CAAA;IACnB,uBAAe,CAAA;AACjB,CAAC,EARW,IAAI,oBAAJ,IAAI,QAQf;AAGD,IAAY,cAGX;AAHD,WAAY,cAAc;IACxB,qCAAmB,CAAA;IACnB,qCAAmB,CAAA;AACrB,CAAC,EAHW,cAAc,8BAAd,cAAc,QAGzB"}

package/dist/errors.d.ts

@@ -0,0 +1,37 @@
+export declare enum ERROR_CODE {
+    NO_REQUEST = -1,
+    UNKNOWN_ERROR = 0,
+    INVALID_METHOD = 1,
+    INVALID_REQUEST = 2,
+    INVALID_CONTROLLER = 3,
+    INVALID_ACTION = 4,
+    NO_ACTION_IN_MAP = 5,
+    NO_METHOD_HANDLER = 6,
+    INVALID_METHOD_INPUT = 7,
+    REQ_BODY_EMPTY = 8
+}
+export declare enum HTTP_ERROR_CODE {
+    OK = 200,
+    BAD_REQUEST = 400,
+    UNAUTHORIZED = 401,
+    FORBIDDEN = 403,
+    NOT_FOUND = 404,
+    INTERNAL_SERVER_ERROR = 500
+}
+export declare enum WS_ERROR_CODE {
+    NORMAL_CLOSURE = 1000,
+    GOING_AWAY = 1001,
+    PROTOCOL_ERROR = 1002,
+    UNSUPPORTED_DATA = 1003,
+    NO_STATUS_RECEIVED = 1005,
+    ABNORMAL_CLOSURE = 1006,
+    INVALID_FRAME_PAYLOAD_DATA = 1007,
+    POLICY_VIOLATION = 1008,
+    MESSAGE_TOO_BIG = 1009,
+    MISSING_EXTENSION = 1010,
+    INTERNAL_ERROR = 1011,
+    SERVICE_RESTART = 1012,
+    TRY_AGAIN_LATER = 1013,
+    BAD_GATEWAY = 1014,
+    TLS_HANDSHAKE = 1015
+}

package/dist/errors.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WS_ERROR_CODE = exports.HTTP_ERROR_CODE = exports.ERROR_CODE = void 0;
+// Error code enums
+var ERROR_CODE;
+(function (ERROR_CODE) {
+    ERROR_CODE[ERROR_CODE["NO_REQUEST"] = -1] = "NO_REQUEST";
+    ERROR_CODE[ERROR_CODE["UNKNOWN_ERROR"] = 0] = "UNKNOWN_ERROR";
+    ERROR_CODE[ERROR_CODE["INVALID_METHOD"] = 1] = "INVALID_METHOD";
+    ERROR_CODE[ERROR_CODE["INVALID_REQUEST"] = 2] = "INVALID_REQUEST";
+    ERROR_CODE[ERROR_CODE["INVALID_CONTROLLER"] = 3] = "INVALID_CONTROLLER";
+    ERROR_CODE[ERROR_CODE["INVALID_ACTION"] = 4] = "INVALID_ACTION";
+    ERROR_CODE[ERROR_CODE["NO_ACTION_IN_MAP"] = 5] = "NO_ACTION_IN_MAP";
+    ERROR_CODE[ERROR_CODE["NO_METHOD_HANDLER"] = 6] = "NO_METHOD_HANDLER";
+    ERROR_CODE[ERROR_CODE["INVALID_METHOD_INPUT"] = 7] = "INVALID_METHOD_INPUT";
+    ERROR_CODE[ERROR_CODE["REQ_BODY_EMPTY"] = 8] = "REQ_BODY_EMPTY";
+})(ERROR_CODE || (exports.ERROR_CODE = ERROR_CODE = {}));
+var HTTP_ERROR_CODE;
+(function (HTTP_ERROR_CODE) {
+    HTTP_ERROR_CODE[HTTP_ERROR_CODE["OK"] = 200] = "OK";
+    HTTP_ERROR_CODE[HTTP_ERROR_CODE["BAD_REQUEST"] = 400] = "BAD_REQUEST";
+    HTTP_ERROR_CODE[HTTP_ERROR_CODE["UNAUTHORIZED"] = 401] = "UNAUTHORIZED";
+    HTTP_ERROR_CODE[HTTP_ERROR_CODE["FORBIDDEN"] = 403] = "FORBIDDEN";
+    HTTP_ERROR_CODE[HTTP_ERROR_CODE["NOT_FOUND"] = 404] = "NOT_FOUND";
+    HTTP_ERROR_CODE[HTTP_ERROR_CODE["INTERNAL_SERVER_ERROR"] = 500] = "INTERNAL_SERVER_ERROR";
+})(HTTP_ERROR_CODE || (exports.HTTP_ERROR_CODE = HTTP_ERROR_CODE = {}));
+var WS_ERROR_CODE;
+(function (WS_ERROR_CODE) {
+    // WebSocket close event codes
+    WS_ERROR_CODE[WS_ERROR_CODE["NORMAL_CLOSURE"] = 1000] = "NORMAL_CLOSURE";
+    WS_ERROR_CODE[WS_ERROR_CODE["GOING_AWAY"] = 1001] = "GOING_AWAY";
+    WS_ERROR_CODE[WS_ERROR_CODE["PROTOCOL_ERROR"] = 1002] = "PROTOCOL_ERROR";
+    WS_ERROR_CODE[WS_ERROR_CODE["UNSUPPORTED_DATA"] = 1003] = "UNSUPPORTED_DATA";
+    WS_ERROR_CODE[WS_ERROR_CODE["NO_STATUS_RECEIVED"] = 1005] = "NO_STATUS_RECEIVED";
+    WS_ERROR_CODE[WS_ERROR_CODE["ABNORMAL_CLOSURE"] = 1006] = "ABNORMAL_CLOSURE";
+    WS_ERROR_CODE[WS_ERROR_CODE["INVALID_FRAME_PAYLOAD_DATA"] = 1007] = "INVALID_FRAME_PAYLOAD_DATA";
+    WS_ERROR_CODE[WS_ERROR_CODE["POLICY_VIOLATION"] = 1008] = "POLICY_VIOLATION";
+    WS_ERROR_CODE[WS_ERROR_CODE["MESSAGE_TOO_BIG"] = 1009] = "MESSAGE_TOO_BIG";
+    WS_ERROR_CODE[WS_ERROR_CODE["MISSING_EXTENSION"] = 1010] = "MISSING_EXTENSION";
+    WS_ERROR_CODE[WS_ERROR_CODE["INTERNAL_ERROR"] = 1011] = "INTERNAL_ERROR";
+    WS_ERROR_CODE[WS_ERROR_CODE["SERVICE_RESTART"] = 1012] = "SERVICE_RESTART";
+    WS_ERROR_CODE[WS_ERROR_CODE["TRY_AGAIN_LATER"] = 1013] = "TRY_AGAIN_LATER";
+    WS_ERROR_CODE[WS_ERROR_CODE["BAD_GATEWAY"] = 1014] = "BAD_GATEWAY";
+    WS_ERROR_CODE[WS_ERROR_CODE["TLS_HANDSHAKE"] = 1015] = "TLS_HANDSHAKE";
+})(WS_ERROR_CODE || (exports.WS_ERROR_CODE = WS_ERROR_CODE = {}));
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAAA,mBAAmB;AACnB,IAAY,UAWX;AAXD,WAAY,UAAU;IACrB,wDAAe,CAAA;IACf,6DAAiB,CAAA;IACjB,+DAAkB,CAAA;IAClB,iEAAmB,CAAA;IACnB,uEAAsB,CAAA;IACtB,+DAAkB,CAAA;IAClB,mEAAoB,CAAA;IACpB,qEAAqB,CAAA;IACrB,2EAAwB,CAAA;IACxB,+DAAkB,CAAA;AACnB,CAAC,EAXW,UAAU,0BAAV,UAAU,QAWrB;AAED,IAAY,eAOX;AAPD,WAAY,eAAe;IAC1B,mDAAQ,CAAA;IACR,qEAAiB,CAAA;IACjB,uEAAkB,CAAA;IAClB,iEAAe,CAAA;IACf,iEAAe,CAAA;IACf,yFAA2B,CAAA;AAC5B,CAAC,EAPW,eAAe,+BAAf,eAAe,QAO1B;AAED,IAAY,aAiBX;AAjBD,WAAY,aAAa;IACxB,8BAA8B;IAC9B,wEAAqB,CAAA;IACrB,gEAAiB,CAAA;IACjB,wEAAqB,CAAA;IACrB,4EAAuB,CAAA;IACvB,gFAAyB,CAAA;IACzB,4EAAuB,CAAA;IACvB,gGAAiC,CAAA;IACjC,4EAAuB,CAAA;IACvB,0EAAsB,CAAA;IACtB,8EAAwB,CAAA;IACxB,wEAAqB,CAAA;IACrB,0EAAsB,CAAA;IACtB,0EAAsB,CAAA;IACtB,kEAAkB,CAAA;IAClB,sEAAoB,CAAA;AACrB,CAAC,EAjBW,aAAa,6BAAb,aAAa,QAiBxB"}

package/dist/guards.d.ts

@@ -0,0 +1,19 @@
+import type { NonNullableType } from "./types";
+declare class Guards {
+    static IsString(value: any): value is string;
+    static IsString(value: any, excludeNull: true): value is NonNullableType<string>;
+    static IsNumber(value: any): value is number;
+    static IsNumber(value: any, excludeNull: true): value is NonNullableType<number>;
+    static IsBoolean(value: any): value is boolean;
+    static IsBoolean(value: any, excludeNull: true): value is NonNullableType<boolean>;
+    static IsArray<T>(value: any): value is T[];
+    static IsArray<T>(value: any, excludeNull: true): value is NonNullableType<T[]>;
+    static IsObject(value: any): value is object;
+    static IsObject(value: any, excludeNull: true): value is NonNullableType<object>;
+    static IsFunction(value: any): value is Function;
+    static IsFunction(value: any, excludeNull: true): value is NonNullableType<Function>;
+    static IsNil(value: any): value is null | undefined;
+    static IsType<T>(obj: any): obj is T;
+    static IsType<T>(obj: any, keys: (keyof T)[]): obj is T;
+}
+export default Guards;

package/dist/guards.js

@@ -0,0 +1,42 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const lib_1 = __importDefault(require("./lib"));
+class Guards {
+    static IsString(value, excludeNull = false) {
+        const output = lib_1.default.IsString(value);
+        return excludeNull ? !Guards.IsNil(value) && output : output;
+    }
+    static IsNumber(value, excludeNull = false) {
+        const output = lib_1.default.IsNumber(value);
+        return excludeNull ? !Guards.IsNil(value) && output : output;
+    }
+    static IsBoolean(value, excludeNull = false) {
+        const output = lib_1.default.GetType(value, true) === "boolean";
+        return excludeNull ? !Guards.IsNil(value) && output : output;
+    }
+    static IsArray(value, excludeNull = false) {
+        const output = lib_1.default.IsArray(value);
+        return excludeNull ? !Guards.IsNil(value) && output : output;
+    }
+    static IsObject(value, excludeNull = false) {
+        const output = lib_1.default.IsObject(value);
+        return excludeNull ? !Guards.IsNil(value) && output : output;
+    }
+    static IsFunction(value, excludeNull = false) {
+        const output = lib_1.default.IsFunction(value);
+        return excludeNull ? !Guards.IsNil(value) && output : output;
+    }
+    static IsNil(value) {
+        return lib_1.default.IsNil(value);
+    }
+    static IsType(obj, keys) {
+        if (!keys)
+            return !this.IsNil(obj);
+        return keys.every((key) => key in obj);
+    }
+}
+exports.default = Guards;
+//# sourceMappingURL=guards.js.map

package/dist/guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.js","sourceRoot":"","sources":["../src/guards.ts"],"names":[],"mappings":";;;;;AACA,gDAAwB;AAExB,MAAM,MAAM;IAGJ,MAAM,CAAC,QAAQ,CAAC,KAAU,EAAE,cAAuB,KAAK;QAC9D,MAAM,MAAM,GAAG,aAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACnC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAC9D,CAAC;IAIM,MAAM,CAAC,QAAQ,CAAC,KAAU,EAAE,cAAuB,KAAK;QAC9D,MAAM,MAAM,GAAG,aAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACnC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAC9D,CAAC;IAIM,MAAM,CAAC,SAAS,CAAC,KAAU,EAAE,cAAuB,KAAK;QAC/D,MAAM,MAAM,GAAG,aAAG,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,SAAS,CAAC;QACtD,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAC9D,CAAC;IAIM,MAAM,CAAC,OAAO,CAAI,KAAU,EAAE,cAAuB,KAAK;QAChE,MAAM,MAAM,GAAG,aAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAClC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAC9D,CAAC;IAIM,MAAM,CAAC,QAAQ,CAAC,KAAU,EAAE,cAAuB,KAAK;QAC9D,MAAM,MAAM,GAAG,aAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACnC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAC9D,CAAC;IAIM,MAAM,CAAC,UAAU,CAAC,KAAU,EAAE,cAAuB,KAAK;QAChE,MAAM,MAAM,GAAG,aAAG,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACrC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAC9D,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,KAAU;QAC7B,OAAO,aAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAIM,MAAM,CAAC,MAAM,CAAI,GAAQ,EAAE,IAAkB;QACnD,IAAI,CAAC,IAAI;YAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;IACxC,CAAC;CACD;AAED,kBAAe,MAAM,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export { default as App } from './app';
+export { default as Guards } from './guards';
+export { default as Initializable } from './initializable';
+export { default as Lib } from './lib';
+export { default as RouterRoute } from './router/route';
+export { default as RouterRouter } from './router/router';
+export { default as Singleton } from './singleton';
+export { default as Throwable } from './throwable';
+export { ERROR_CODE, HTTP_ERROR_CODE, WS_ERROR_CODE } from './errors';
+export { E_IS, E_ENVIRONMENTS } from './enums';
+export { RESPONSE_INIT, RESPONSE_METHOD_OPTIONS } from './app';
+import * as RouterModule from './router';
+export { RouterModule as Router };

package/dist/index.js

@@ -0,0 +1,75 @@
+"use strict";
+// This file is auto-generated by scripts/generate-indexes.sh
+// Do not edit this file directly
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Router = exports.RESPONSE_METHOD_OPTIONS = exports.RESPONSE_INIT = exports.E_ENVIRONMENTS = exports.E_IS = exports.WS_ERROR_CODE = exports.HTTP_ERROR_CODE = exports.ERROR_CODE = exports.Throwable = exports.Singleton = exports.RouterRouter = exports.RouterRoute = exports.Lib = exports.Initializable = exports.Guards = exports.App = void 0;
+// Export all modules
+// Export default classes
+var app_1 = require("./app");
+Object.defineProperty(exports, "App", { enumerable: true, get: function () { return __importDefault(app_1).default; } });
+var guards_1 = require("./guards");
+Object.defineProperty(exports, "Guards", { enumerable: true, get: function () { return __importDefault(guards_1).default; } });
+var initializable_1 = require("./initializable");
+Object.defineProperty(exports, "Initializable", { enumerable: true, get: function () { return __importDefault(initializable_1).default; } });
+var lib_1 = require("./lib");
+Object.defineProperty(exports, "Lib", { enumerable: true, get: function () { return __importDefault(lib_1).default; } });
+var route_1 = require("./router/route");
+Object.defineProperty(exports, "RouterRoute", { enumerable: true, get: function () { return __importDefault(route_1).default; } });
+var router_1 = require("./router/router");
+Object.defineProperty(exports, "RouterRouter", { enumerable: true, get: function () { return __importDefault(router_1).default; } });
+var singleton_1 = require("./singleton");
+Object.defineProperty(exports, "Singleton", { enumerable: true, get: function () { return __importDefault(singleton_1).default; } });
+var throwable_1 = require("./throwable");
+Object.defineProperty(exports, "Throwable", { enumerable: true, get: function () { return __importDefault(throwable_1).default; } });
+// Re-export specific items for backward compatibility
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "ERROR_CODE", { enumerable: true, get: function () { return errors_1.ERROR_CODE; } });
+Object.defineProperty(exports, "HTTP_ERROR_CODE", { enumerable: true, get: function () { return errors_1.HTTP_ERROR_CODE; } });
+Object.defineProperty(exports, "WS_ERROR_CODE", { enumerable: true, get: function () { return errors_1.WS_ERROR_CODE; } });
+var enums_1 = require("./enums");
+Object.defineProperty(exports, "E_IS", { enumerable: true, get: function () { return enums_1.E_IS; } });
+Object.defineProperty(exports, "E_ENVIRONMENTS", { enumerable: true, get: function () { return enums_1.E_ENVIRONMENTS; } });
+var app_2 = require("./app");
+Object.defineProperty(exports, "RESPONSE_INIT", { enumerable: true, get: function () { return app_2.RESPONSE_INIT; } });
+Object.defineProperty(exports, "RESPONSE_METHOD_OPTIONS", { enumerable: true, get: function () { return app_2.RESPONSE_METHOD_OPTIONS; } });
+// Barrel exports for subdirectories
+// Create module for router
+const RouterModule = __importStar(require("./router"));
+exports.Router = RouterModule;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,6DAA6D;AAC7D,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEjC,qBAAqB;AAErB,yBAAyB;AACzB,6BAAuC;AAA9B,2GAAA,OAAO,OAAO;AACvB,mCAA6C;AAApC,iHAAA,OAAO,OAAU;AAC1B,iDAA2D;AAAlD,+HAAA,OAAO,OAAiB;AACjC,6BAAuC;AAA9B,2GAAA,OAAO,OAAO;AACvB,wCAAwD;AAA/C,qHAAA,OAAO,OAAe;AAC/B,0CAA0D;AAAjD,uHAAA,OAAO,OAAgB;AAChC,yCAAmD;AAA1C,uHAAA,OAAO,OAAa;AAC7B,yCAAmD;AAA1C,uHAAA,OAAO,OAAa;AAE7B,sDAAsD;AACtD,mCAAsE;AAA7D,oGAAA,UAAU,OAAA;AAAE,yGAAA,eAAe,OAAA;AAAE,uGAAA,aAAa,OAAA;AACnD,iCAA+C;AAAtC,6FAAA,IAAI,OAAA;AAAE,uGAAA,cAAc,OAAA;AAC7B,6BAA+D;AAAtD,oGAAA,aAAa,OAAA;AAAE,8GAAA,uBAAuB,OAAA;AAE/C,oCAAoC;AACpC,2BAA2B;AAC3B,uDAAyC;AAChB,8BAAM"}