raiton 3.0.1 → 3.1.0

package/source/sdk/encryption.ts

@@ -2,7 +2,7 @@ import crypto from "node:crypto";
 import argon2, {Options} from "argon2";
 import {HashAlgoEnum, PasswordAlgoEnum} from "./enums";
 import bcrypt from "bcrypt";
-import {IDerivationOptions, IEncryptionResult, IScryptOptions} from "@/types";
+import {DerivationOptionsInterface, EncryptionResultType, ScryptOptionsInterface} from "../types";
 
 export class Encryption {
     static get algos() {
@@ -24,7 +24,7 @@ export class Encryption {
         return this.make(value).then(result => result === hash);
     }
 
-    async make(value: string, options?: IDerivationOptions | IScryptOptions): Promise<IEncryptionResult> {
+    async make(value: string, options?: DerivationOptionsInterface | ScryptOptionsInterface): Promise<EncryptionResultType> {
         if (!value) {
             throw new Error('Value cannot be empty');
         }
@@ -45,9 +45,9 @@ export class Encryption {
             case HashAlgoEnum.SHA3_512:
                 return this.sha3_512(value);
             case HashAlgoEnum.PBKDF2:
-                return this.pbkdf2(value, options as IDerivationOptions | undefined);
+                return this.pbkdf2(value, options as DerivationOptionsInterface | undefined);
             case HashAlgoEnum.SCRYPT:
-                return this.scrypt(value, options as IScryptOptions | undefined);
+                return this.scrypt(value, options as ScryptOptionsInterface | undefined);
             case HashAlgoEnum.ARGON2ID:
             case HashAlgoEnum.BCRYPT:
                 return this.password(value);
@@ -56,35 +56,35 @@ export class Encryption {
         }
     }
 
-    protected sha256(value: string): IEncryptionResult {
+    protected sha256(value: string): EncryptionResultType {
         return crypto.createHash("sha256").update(value).digest("hex");
     }
 
-    protected sha512(value: string): IEncryptionResult {
+    protected sha512(value: string): EncryptionResultType {
         return crypto.createHash("sha512").update(value).digest("hex");
     }
 
-    protected md5(value: string): IEncryptionResult {
+    protected md5(value: string): EncryptionResultType {
         return crypto.createHash("md5").update(value).digest("hex");
     }
 
-    protected ripemd160(value: string): IEncryptionResult {
+    protected ripemd160(value: string): EncryptionResultType {
         return crypto.createHash("ripemd160").update(value).digest("hex");
     }
 
-    protected blake2b(value: string): IEncryptionResult {
+    protected blake2b(value: string): EncryptionResultType {
         return crypto.createHash("blake2b512").update(value).digest("hex");
     }
 
-    protected sha3_256(value: string): IEncryptionResult {
+    protected sha3_256(value: string): EncryptionResultType {
         return crypto.createHash("sha3-256").update(value).digest("hex");
     }
 
-    protected sha3_512(value: string): IEncryptionResult {
+    protected sha3_512(value: string): EncryptionResultType {
         return crypto.createHash("sha3-512").update(value).digest("hex");
     }
 
-    protected pbkdf2(value: string, options?: IDerivationOptions): IEncryptionResult {
+    protected pbkdf2(value: string, options?: DerivationOptionsInterface): EncryptionResultType {
         const {salt, iterations, keylen, digest} = options || {};
         const usedSalt = salt ?? crypto.randomBytes(16).toString("hex");
         const usedIterations = iterations ?? 100_000;
@@ -96,8 +96,8 @@ export class Encryption {
         return `pbkdf2$${usedDigest}$${usedIterations}$${usedSalt}$${derived}`;
     }
 
-    protected scrypt(value: string, options?: IScryptOptions): IEncryptionResult {
-        const {salt, keylen, cost, blockSize, parallelization} = options || {} as IScryptOptions;
+    protected scrypt(value: string, options?: ScryptOptionsInterface): EncryptionResultType {
+        const {salt, keylen, cost, blockSize, parallelization} = options || {} as ScryptOptionsInterface;
         const usedSalt = salt ?? crypto.randomBytes(16).toString("hex");
         const usedKeylen = keylen ?? 64;
         const usedCost = cost ?? 16384; // N
@@ -120,7 +120,7 @@ export class Encryption {
 
     async password(value: string, options?: (Options & {
         raw?: boolean
-    }) | (string | number) | undefined): Promise<IEncryptionResult> {
+    }) | (string | number) | undefined): Promise<EncryptionResultType> {
         switch (this.algo) {
             case HashAlgoEnum.ARGON2ID: {
                 return await argon2.hash(value, {

package/source/sdk/env.ts

@@ -1,9 +1,9 @@
-import {IGenericValue} from "../types/generic";
+import {GenericValueType} from "../types/generic";
 import {getType} from "./utilities";
 
-export function env<T>(key: string, type?: IGenericValue): T | undefined {
+export function env<T>(key: string, type?: GenericValueType): T | undefined {
     const value = process.env[key];
-    type = type || getType(value) as IGenericValue;
+    type = type || getType(value) as GenericValueType;
 
     if (value) {
         switch (type) {
@@ -28,10 +28,10 @@ export function env<T>(key: string, type?: IGenericValue): T | undefined {
     return undefined;
 }
 
-export function envGroup(key: string): Record<string, IGenericValue | undefined> {
+export function envGroup(key: string): Record<string, GenericValueType | undefined> {
     const filtered = Object.entries(process.env)
         .filter(([index]) => key.startsWith(index))
-    const gen: Record<string, IGenericValue | undefined> = {}
+    const gen: Record<string, GenericValueType | undefined> = {}
 
     for (const [index, value] of filtered)
         gen[index] = env(value as any, undefined)

package/source/sdk/exceptions/http-exception.ts

@@ -1,6 +1,6 @@
-import {HttpStatus} from "@/sdk/enums/http-status.enum";
-import {Raiton} from "@/core";
-import {HttpResponseBaseInterface} from "@/types";
+import {HttpStatus} from "../enums/http-status.enum";
+import {Raiton} from "../../core";
+import {HttpResponseBaseInterface} from "../../types";
 
 export class HttpException extends Error {
 

package/source/sdk/parameter-bag.ts

@@ -1,4 +1,4 @@
-import {ParseableEntriesType, ParseablePrimitiveType} from "@/types";
+import {ParseableEntriesType, ParseablePrimitiveType} from "../types";
 import {stabilizeJson} from "./utilities";
 import {DynamicParameter, IDynamicParameters, IDynamicProps, IParameter,} from "@protorians/parameters";
 

package/source/sdk/plugins/body-parser.plugin.ts

@@ -1,13 +1,13 @@
-import type {MiddlewareParameters, Plugin} from "@/types";
-import {RequestContext} from "@/core/context";
+import type {MiddlewareParametersInterface, PluginInterface} from "../../types";
+import {RequestContext} from "../../core/context";
 import {Logger} from "@protorians/logger";
-import {tryParseJson} from "@/sdk/utilities/json.util";
+import {tryParseJson} from "../utilities/json.util";
 
-export function bodyParserPlugin(): Plugin {
+export function bodyParserPlugin(): PluginInterface {
     return {
         name: 'body-parser-plugin',
         setup: (scope) => {
-            scope.use(async ({context, next}: MiddlewareParameters) => {
+            scope.use(async ({context, next}: MiddlewareParametersInterface) => {
                 const contentType = context.req.headers.get('content-type') || '';
 
                 if (context.req.body && !context.state.bodyParsed) {

package/source/sdk/plugins/security/body-limit.ts

@@ -1,10 +1,10 @@
-import {definePlugin} from "@/core/plugins";
-import {MiddlewareParameters} from "@/types";
+import {definePlugin} from "../../../core/plugins";
+import {MiddlewareParametersInterface} from "../../../types";
 
 
 export const secureBodyLimit = (maxBytes = 1_000_000) =>
   definePlugin((scope) => {
-    scope.use(async ({context, next}: MiddlewareParameters) => {
+    scope.use(async ({context, next}: MiddlewareParametersInterface) => {
       const len = Number(
         context.req.headers.get('content-length') ?? 0
       )

package/source/sdk/plugins/security/cors.ts

@@ -1,5 +1,5 @@
-import {definePlugin} from "@/core/plugins";
-import {Context, MiddlewareParameters, NextCallable} from "@/types";
+import {definePlugin} from "../../../core/plugins";
+import {ContextInterface, MiddlewareParametersInterface, MiddlewareNextCallable} from "../../../types";
 
 export interface CorsOptions {
     origin?: string | string[]
@@ -9,7 +9,7 @@ export interface CorsOptions {
 
 export const secureCors = (opts: CorsOptions = {}) =>
     definePlugin((scope) => {
-        scope.use(async ({context, next}: MiddlewareParameters) => {
+        scope.use(async ({context, next}: MiddlewareParametersInterface) => {
             const origin = context.req.headers.get('origin')
 
             if (opts.origin) {

package/source/sdk/plugins/security/headers.ts

@@ -1,9 +1,9 @@
-import {definePlugin} from "@/core/plugins";
-import {Context, MiddlewareParameters, NextCallable} from "@/types";
+import {definePlugin} from "../../../core/plugins";
+import {ContextInterface, MiddlewareParametersInterface, MiddlewareNextCallable} from "../../../types";
 
 
 export const secureHeaders = definePlugin((scope) => {
-  scope.use(async ({context, next}: MiddlewareParameters) => {
+  scope.use(async ({context, next}: MiddlewareParametersInterface) => {
     context.reply.header('X-Content-Type-Options', 'nosniff')
     context.reply.header('X-Frame-Options', 'DENY')
     context.reply.header('Referrer-Policy', 'no-referrer')

package/source/sdk/plugins/security/method-guard.ts

@@ -1,10 +1,10 @@
-import {definePlugin} from "@/core/plugins";
-import {Context, MiddlewareParameters, NextCallable} from "@/types";
+import {definePlugin} from "../../../core/plugins";
+import {ContextInterface, MiddlewareParametersInterface, MiddlewareNextCallable} from "../../../types";
 
 
 export const secureMethodGuard = (allowed: string[]) =>
   definePlugin((scope) => {
-    scope.use(async ({context, next}: MiddlewareParameters) => {
+    scope.use(async ({context, next}: MiddlewareParametersInterface) => {
       if (!allowed.includes(context.req.method)) {
         context.reply.status(405)
         return context.send({ error: 'Method not allowed' })

package/source/sdk/plugins/security/rate-limit.ts

@@ -1,5 +1,5 @@
-import {definePlugin} from "@/core/plugins";
-import {Context, MiddlewareParameters, NextCallable} from "@/types";
+import {definePlugin} from "../../../core/plugins";
+import {ContextInterface, MiddlewareParametersInterface, MiddlewareNextCallable} from "../../../types";
 
 
 export interface RateLimitOptions {
@@ -16,7 +16,7 @@ export const secureRateLimit = (
         const windowMs = opts.windowMs ?? 60_000
         const max = opts.max ?? 100
 
-        scope.use(async ({context, next}: MiddlewareParameters) => {
+        scope.use(async ({context, next}: MiddlewareParametersInterface) => {
             const ip =
                 context.req.remoteAddress ?? 'unknown'
             const now = Date.now()

package/source/sdk/repositories.ts

@@ -1,4 +1,4 @@
-import {Throwable} from "@/sdk/exceptions";
+import {Throwable} from "./exceptions";
 
 
 export class DelegateRepository {

package/source/sdk/responses/error.ts

@@ -1,5 +1,5 @@
-import type {ErrorResponseInterface} from "@/types";
-import {HttpResponse} from "@/sdk/responses/http";
+import type {ErrorResponseInterface} from "../../types";
+import {HttpResponse} from "./http";
 
 
 export class HttpErrorResponse {

package/source/sdk/responses/helpers.ts

@@ -1,6 +1,6 @@
-import {HttpResponse, HttpStatus} from "@/sdk";
-import {HttpResponseInterface} from "@/types";
-import {Raiton} from "@/core";
+import {HttpResponse, HttpStatus} from "..";
+import {HttpResponseInterface} from "../../types";
+import {Raiton} from "../../core";
 
 
 export function RaitonResponses(

package/source/sdk/responses/http-throwable.ts

@@ -1,6 +1,6 @@
-import {HttpResponseInterface} from "@/types";
-import {HttpStatus} from "@/sdk/enums";
-import {Raiton} from "@/core";
+import {HttpResponseInterface} from "../../types";
+import {HttpStatus} from "../enums";
+import {Raiton} from "../../core";
 
 
 export class ThrowableResponse extends Error {

package/source/sdk/responses/http.ts

@@ -1,6 +1,6 @@
-import {HttpResponseInterface} from "@/types";
-import {HttpStatus} from "@/sdk/enums";
-import {ThrowableResponse} from "@/sdk/responses";
+import {HttpResponseInterface} from "../../types";
+import {HttpStatus} from "../enums";
+import {ThrowableResponse} from ".";
 
 
 export class HttpResponse {

package/source/sdk/runtime/bun/server.ts

@@ -1,4 +1,4 @@
-import {RuntimeAdapterInterface} from '@/types'
+import {RuntimeAdapterInterface} from '../../../types'
 
 export const bunRuntime: RuntimeAdapterInterface = {
     createServer(handler) {

package/source/sdk/runtime/deno/server.ts

@@ -1,4 +1,4 @@
-import {RuntimeAdapterInterface} from '@/types'
+import {RuntimeAdapterInterface} from '../../../types'
 
 export const denoRuntime: RuntimeAdapterInterface = {
     createServer(handler) {

package/source/sdk/runtime/index.ts

@@ -1,9 +1,9 @@
-import type {RuntimeAdapterInterface, RuntimeHandlerCallable, RuntimeInterface, RuntimeServerInterface} from "@/types";
-import {RuntimeType} from "@/sdk/enums/runtime.enum";
-import {nodeRuntime} from "@/sdk/runtime/node/server";
-import {bunRuntime} from "@/sdk/runtime/bun/server";
-import {denoRuntime} from "@/sdk/runtime/deno/server";
-import {webRuntime} from "@/sdk/runtime/web/server";
+import type {RuntimeAdapterInterface, RuntimeHandlerCallable, RuntimeInterface, RuntimeServerInterface} from "../../types";
+import {RuntimeType} from "../enums/runtime.enum";
+import {nodeRuntime} from "./node/server";
+import {bunRuntime} from "./bun/server";
+import {denoRuntime} from "./deno/server";
+import {webRuntime} from "./web/server";
 
 
 export class Runtime implements RuntimeInterface {

package/source/sdk/runtime/node/server.ts

@@ -3,7 +3,7 @@ import {
     RuntimeAdapterInterface,
     RuntimeRequestInterface,
     RuntimeReplyInterface
-} from '@/types'
+} from '../../../types'
 
 export const nodeRuntime: RuntimeAdapterInterface = {
     createServer(handler) {

package/source/sdk/runtime/web/server.ts

@@ -1,4 +1,4 @@
-import {RuntimeAdapterInterface, RuntimeReplyInterface, RuntimeRequestInterface} from '@/types'
+import {RuntimeAdapterInterface, RuntimeReplyInterface, RuntimeRequestInterface} from '../../../types'
 
 export const webRuntime: RuntimeAdapterInterface = {
     createServer(handler) {

package/source/sdk/utilities/utilities.util.ts

@@ -1,6 +1,6 @@
-import {IGenericValueType} from "../../types";
+import {GenericValuesType} from "../../types";
 
-export function getType(value: any): IGenericValueType {
+export function getType(value: any): GenericValuesType {
     if (typeof value === "string") return "string";
     if (typeof value === "boolean") return "boolean";
     if (typeof value === "bigint") return "bigInt";

package/source/types/application.ts

@@ -1,6 +1,6 @@
-import {HttpMethod} from "@/sdk";
+import {HttpMethod} from "../sdk";
 
-export interface ApplicationConfig {
+export interface ApplicationConfigInterface {
     workdir?: string;
     hostname?: string;
     port?: number;
@@ -12,13 +12,13 @@ export interface ApplicationConfig {
 }
 
 export interface ApplicationInterface {
-    readonly config: ApplicationConfig;
+    readonly config: ApplicationConfigInterface;
 
     get hostname(): string;
 
-    setOption<K extends keyof ApplicationConfig>(key: K, value: ApplicationConfig[K]): this;
+    setOption<K extends keyof ApplicationConfigInterface>(key: K, value: ApplicationConfigInterface[K]): this;
 
-    setOptions(options: ApplicationConfig): this;
+    setOptions(options: ApplicationConfigInterface): this;
 
     register(plugin: any): this;
 

package/source/types/artifact.ts

@@ -1,44 +1,3 @@
-export interface ArtifactEntry {
-    id: string;
-    timestamp: Date;
-    size: number;
-}
-
-export interface ArtifactsConfig {
+export interface ArtifactsConfigInterface {
     types: string[]
-}
-
-// export type ArtifactDecoratorHandler = () => void;
-
-// export interface ArtifactDecorator {
-//     syntax: RegExp;
-//     handler: ArtifactDecoratorHandler;
-// }
-
-// export interface ArtifactOptions {
-//     readonly artifact: string;
-//     readonly provider: string;
-//     readonly decorator: ArtifactDecorator;
-//     verbose?: boolean;
-// }
-
-// export interface ArtifactInterface {
-//     readonly options: ArtifactOptions;
-//     readonly directory: string;
-//     readonly file: string;
-//     readonly workdir: string;
-//
-//     get files(): string[];
-//
-//     get extensions(): string[];
-//
-//     scan(): string[];
-//
-//     generate(): boolean;
-// }
-
-// export interface ArtifactEntry {
-//     vendor: string;
-//     decorator: string;
-//     pattern: string;
-// }
+}

package/source/types/builder.ts

@@ -1,19 +1,19 @@
 import {WatchEventType} from "node:fs";
 
-export interface BuildCommandOptions {
+export interface BuildCommandOptionsInterface {
     develop?: boolean;
     bootstrap?: boolean;
 }
 
-export interface BuilderConfig {
+export interface BuilderConfigInterface {
     development?: boolean;
 }
 
-export type BuilderBootCallable = (builder: BuilderInterface) => Promise<void>
+export type BuilderBootCallableType = (builder: BuilderInterface) => Promise<void>
 
 export interface BuilderInterface {
     readonly workdir: string;
-    readonly options: BuilderConfig;
+    readonly options: BuilderConfigInterface;
     // readonly signal: ISignalStack<BuilderSignalMap>;
 
     // get context(): BuildContext<BuildOptions> | null;
@@ -36,7 +36,7 @@ export interface BuilderInterface {
 }
 
 
-export interface BuilderHMRDeclaration {
+export interface BuilderHMRDeclarationInterface {
     filename: string;
     timestamp?: number;
     version?: number;

package/source/types/config.ts

@@ -1,7 +1,7 @@
-import type {ArtifactsConfig} from "@/types/artifact";
+import type {ArtifactsConfigInterface} from "./artifact";
 
-export interface Configurable {
+export interface ConfigurableInterface {
     rootDir: string;
     version: string;
-    artifacts?: ArtifactsConfig
+    artifacts?: ArtifactsConfigInterface
 }

package/source/types/controller.ts

@@ -1,6 +1,6 @@
-import {HttpMethod, Parametrable} from "@/sdk/enums";
-import {Context} from "@/types/core";
-import {MiddlewareCallable, MiddlewareType} from "@/types/middleware";
+import {HttpMethod, Parametrable} from "../sdk/enums";
+import {ContextInterface} from "./core";
+import {MiddlewareCallable, MiddlewareType} from "./middleware";
 
 export interface ControllerMetaInterface {
     prefix?: string;
@@ -20,14 +20,14 @@ export interface ParamMetaInterface {
     index: number;
     type: Parametrable;
     key?: string;
-    callable?: (ctx: Context) => any;
+    callable?: (ctx: ContextInterface) => any;
     metatype?: any;
 }
 
-export interface RouteDecoratorParameters {
+export interface RouteDecoratorParametersInterface {
     controller: ControllerMetaInterface;
     route: RouteMetaInterface;
     index: number;
 }
 
-export type RouteDecoratorCallable = (parameters: RouteDecoratorParameters) => void;
+export type RouteDecoratorCallable = (parameters: RouteDecoratorParametersInterface) => void;

package/source/types/contruct.ts

@@ -1,3 +1,3 @@
 
 
-export type IConstructor<T = any> = new (...args: any[]) => T;
+export type ConstructorType<T = any> = new (...args: any[]) => T;

package/source/types/core.ts

@@ -3,18 +3,16 @@ import type {
     RuntimeReplyInterface
 } from './runtime'
 
-export type HookName =
+export type HookNameType =
     | 'onRequest'
     | 'preParsing'
     | 'preHandler'
     | 'onSend'
     | 'onResponse'
 
-export type HookHandler = (
-    ctx: Context
-) => Promise<void> | void
+export type HookHandlerCallable = (ctx: ContextInterface) => Promise<void> | void
 
-export interface Context {
+export interface ContextInterface {
     req: RuntimeRequestInterface
     reply: RuntimeReplyInterface
 

package/source/types/directory.ts

@@ -1,6 +1,6 @@
 
 
-export interface IFileStatInfo {
+export interface FileStatInfoInterface {
     absolute: string;
     relative: string;
     dir: string;

package/source/types/encryption.ts

@@ -1,17 +1,26 @@
 
-export type IEncryptionResult = string;
+export type EncryptionResultType = string;
 
-export interface IDerivationOptions {
-    salt?: string; // hex string; if not provided, a random 16-byte salt will be generated
-    iterations?: number; // for PBKDF2
-    keylen?: number; // bytes length for derived key (default 64)
-    digest?: string; // for PBKDF2 digest (default 'sha512')
+export interface DerivationOptionsInterface {
+    // hex string; if not provided, a random 16-byte salt will be generated
+    salt?: string;
+    // for PBKDF2
+    iterations?: number;
+    // bytes length for derived key (default 64)
+    keylen?: number;
+    // for PBKDF2 digest (default 'sha512')
+    digest?: string;
 }
 
-export interface IScryptOptions {
-    salt?: string; // hex string; if not provided, a random 16-byte salt will be generated
-    keylen?: number; // bytes length for derived key (default 64)
-    cost?: number; // N parameter (default 16384)
-    blockSize?: number; // r parameter (default 8)
-    parallelization?: number; // p parameter (default 1)
+export interface ScryptOptionsInterface {
+    // hex string; if not provided, a random 16-byte salt will be generated
+    salt?: string;
+    // bytes length for derived key (default 64)
+    keylen?: number;
+    // N parameter (default 16384)
+    cost?: number;
+    // r parameter (default 8)
+    blockSize?: number;
+    // p parameter (default 1)
+    parallelization?: number;
 }

package/source/types/generic.ts

@@ -1,3 +1,3 @@
-export type IGenericValue = 'string' | 'int' | 'bigInt' | 'float' | 'boolean'
+export type GenericValueType = 'string' | 'int' | 'bigInt' | 'float' | 'boolean'
 
-export type IGenericValueType = IGenericValue | 'array' | 'object' | 'function' | undefined;
+export type GenericValuesType = GenericValueType | 'array' | 'object' | 'function' | undefined;

package/source/types/guard.ts

@@ -0,0 +1,12 @@
+import {MiddlewareParametersInterface} from "./middleware";
+
+export interface GuardOptions {
+    name: string;
+    handler: GuardCallable
+}
+
+export interface GuardDeclaration extends GuardOptions {
+    enabled: boolean;
+}
+
+export type GuardCallable = (parameters: MiddlewareParametersInterface) => Promise<boolean> | boolean

package/source/types/index.ts

@@ -1,14 +1,12 @@
 export type * from "./config"
 export type * from "./builder"
 export type * from "./thread"
-export type * from "./access-guards"
+export type * from "./guard"
 export type * from "./contruct"
 export type * from "./directory"
 export type * from "./encryption"
 export type * from "./generic"
-export type * from "./http-responses"
 export type * from "./parseable"
-export type * from "./scheme"
 export type * from "./values"
 export type * from "./utilities"
 export type * from "./artifact"

package/source/types/injection.ts

@@ -1,10 +1,10 @@
-import {IConstructor} from "@/types/contruct";
+import {ConstructorType} from "./contruct";
 import {LifetimeEnum} from "@protorians/core";
 
 
 export interface ContainerDefinitionInterface<T = any> {
     name: string;
-    construct: IConstructor<T>;
+    construct: ConstructorType<T>;
     lifetime: LifetimeEnum;
     instance?: any;
     scope?: Symbol;

package/source/types/lifecycle.ts

@@ -1,11 +1,11 @@
-export interface OnMount {
+export interface OnMountInterface {
     onMount(): void | Promise<void>;
 }
 
-export interface OnUnmount {
+export interface OnUnmountInterface {
     onUnmount(): void | Promise<void>;
 }
 
-export interface OnInit {
+export interface OnInitInterface {
     onInit(): void | Promise<void>;
 }