@arkstack/common 0.12.0 → 0.12.2

package/dist/index.d.ts

@@ -85,6 +85,7 @@ type ConfigShape = keyof ConfigRegistry extends never ? Record<string, any> : Co
 interface GlobalConfig {
   <X extends ConfigShape>(): X;
   <X extends ConfigShape, P extends DotPath<X>>(key: P): DotPathValue<X, P>;
+  <X extends ConfigShape, P extends DotPath<X>>(key: Record<P, Partial<DotPathValue<X, P>>>): void;
   <X extends ConfigShape, P extends DotPath<X>, D>(key: P, defaultValue: D): DotPathValue<X, P> | D;
 }
 interface FileImporter {
@@ -121,6 +122,7 @@ type HookArgs<N extends string, P extends string> = N extends keyof HookRegistry
 //#region src/system.d.ts
 declare const env: GlobalEnv;
 declare const appUrl: (link?: string) => string;
+declare const CONFIG_KEY: unique symbol;
 declare const config: GlobalConfig;
 declare const nodeEnv: () => "prod" | "dev";
 declare const outputDir: (cwd?: string) => string;
@@ -196,5 +198,5 @@ declare class Hook {
   static clear: () => void;
 }
 //#endregion
-export { AbstractModelConstructor, AppException, ArkstackErrorPayload, ArkstackErrorShape, ConfigRegistry, ConfigShape, DotPath, DotPathValue, Encryption, EnvRegistry, ErrorHandler, Exception, FileImporter, GlobalConfig, GlobalEnv, Hash, Hook, HookArgs, HookFor, HookName, HookPos, HookPositions, HookRegistry, IHook, Logger, LoggerChalk, LoggerLog, LoggerParseSignature, MergedConfig, ModelConstructor, ModelRegistry, Primitive, RequestException, UnionToIntersection, abort, abortIf, appUrl, assertFound, bindGracefulShutdown, bootWithDetectedPort, config, createErrorPayload, env, getErrorLogger, getModel, getPrimaryError, getValidationErrors, importFile, initializeGlobalContext, interopDefault, isModelNotFoundError, isValidationError, loadPrototypes, logUnhandledError, nodeEnv, normalizeStatusCode, outputDir, perPage, renderError, serializeError, shouldHideStack, shouldLogError, toErrorShape };
+export { AbstractModelConstructor, AppException, ArkstackErrorPayload, ArkstackErrorShape, CONFIG_KEY, ConfigRegistry, ConfigShape, DotPath, DotPathValue, Encryption, EnvRegistry, ErrorHandler, Exception, FileImporter, GlobalConfig, GlobalEnv, Hash, Hook, HookArgs, HookFor, HookName, HookPos, HookPositions, HookRegistry, IHook, Logger, LoggerChalk, LoggerLog, LoggerParseSignature, MergedConfig, ModelConstructor, ModelRegistry, Primitive, RequestException, UnionToIntersection, abort, abortIf, appUrl, assertFound, bindGracefulShutdown, bootWithDetectedPort, config, createErrorPayload, env, getErrorLogger, getModel, getPrimaryError, getValidationErrors, importFile, initializeGlobalContext, interopDefault, isModelNotFoundError, isValidationError, loadPrototypes, logUnhandledError, nodeEnv, normalizeStatusCode, outputDir, perPage, renderError, serializeError, shouldHideStack, shouldLogError, toErrorShape };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,7 +1,7 @@
-import { S as outputDir, _ as config, a as abort, b as interopDefault, c as getModel, d as RequestException, f as AppException, g as appUrl, h as Encryption, l as initializeGlobalContext, m as Hash, o as abortIf, p as Exception, s as assertFound, u as perPage, v as env, x as nodeEnv, y as importFile } from "./utils-C6d-ohT-.js";
+import { C as outputDir, S as nodeEnv, _ as appUrl, a as abort, b as importFile, c as getModel, d as RequestException, f as AppException, g as CONFIG_KEY, h as Encryption, l as initializeGlobalContext, m as Hash, o as abortIf, p as Exception, s as assertFound, u as perPage, v as config, x as interopDefault, y as env } from "./utils-D_dikzz8.js";
 import { Hook as Hook$1 } from "@arkstack/foundry";
-import { Arkstack } from "@arkstack/contract";
 import { str } from "@h3ravel/support";
+import { Arkstack } from "@arkstack/contract";
 import path from "node:path";
 import { ModelNotFoundException } from "arkormx";
 import { detect } from "detect-port";
@@ -481,6 +481,6 @@ var Hook = class {
 	};
 };
 //#endregion
-export { AppException, Encryption, ErrorHandler, Exception, Hash, Hook, Logger, RequestException, abort, abortIf, appUrl, assertFound, bindGracefulShutdown, bootWithDetectedPort, config, createErrorPayload, env, getErrorLogger, getModel, getPrimaryError, getValidationErrors, importFile, initializeGlobalContext, interopDefault, isModelNotFoundError, isValidationError, loadPrototypes, logUnhandledError, nodeEnv, normalizeStatusCode, outputDir, perPage, renderError, serializeError, shouldHideStack, shouldLogError, toErrorShape };
+export { AppException, CONFIG_KEY, Encryption, ErrorHandler, Exception, Hash, Hook, Logger, RequestException, abort, abortIf, appUrl, assertFound, bindGracefulShutdown, bootWithDetectedPort, config, createErrorPayload, env, getErrorLogger, getModel, getPrimaryError, getValidationErrors, importFile, initializeGlobalContext, interopDefault, isModelNotFoundError, isValidationError, loadPrototypes, logUnhandledError, nodeEnv, normalizeStatusCode, outputDir, perPage, renderError, serializeError, shouldHideStack, shouldLogError, toErrorShape };
 
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js

@@ -1,2 +1,2 @@
-import { a as abort, c as getModel, h as Encryption, i as uses, l as initializeGlobalContext, m as Hash, n as trait, o as abortIf, r as use, s as assertFound, t as crc32, u as perPage } from "../utils-C6d-ohT-.js";
+import { a as abort, c as getModel, h as Encryption, i as uses, l as initializeGlobalContext, m as Hash, n as trait, o as abortIf, r as use, s as assertFound, t as crc32, u as perPage } from "../utils-D_dikzz8.js";
 export { Encryption, Hash, abort, abortIf, assertFound, crc32, getModel, initializeGlobalContext, perPage, trait, use, uses };

package/dist/{utils-C6d-ohT-.js → utils-D_dikzz8.js}

@@ -1,7 +1,7 @@
 import { createCipheriv, createDecipheriv, createHash, randomBytes } from "node:crypto";
+import { Arr, Obj, undot } from "@h3ravel/support";
 import { createJiti } from "jiti";
 import { Arkstack } from "@arkstack/contract";
-import { Obj } from "@h3ravel/support";
 import { createRequire } from "module";
 import path, { resolve } from "node:path";
 import { pathToFileURL } from "node:url";
@@ -57,6 +57,8 @@ const appUrl = (link) => {
 		return link ? `${defaultUrl}/${link.replace(/^\/+/, "")}` : defaultUrl;
 	}
 };
+const CONFIG_KEY = Symbol("globalConfig");
+globalThis[CONFIG_KEY] = {};
 /**
 * Gets the application configuration.
 *
@@ -66,24 +68,32 @@ const appUrl = (link) => {
 */
 const config = (key, defaultValue) => {
 	if (typeof globalThis.env === "undefined") globalThis.env = (key, def) => key ? process.env[key] ?? def : process.env;
-	let files;
-	const dist = path.relative(Arkstack.rootDir(), outputDir());
-	const require = createRequire(import.meta.url);
-	try {
-		files = readdirSync(path.join(Arkstack.rootDir(), `${dist}/config`), { withFileTypes: true }).filter((file) => {
-			if (file.name.includes("middleware") && globalThis.arkctx?.runtime === "CLI") return false;
-			return file.isFile() && (file.name.endsWith(".js") || file.name.endsWith(".ts"));
-		});
-	} catch {
-		files = [];
+	const config = globalThis[CONFIG_KEY];
+	if (Object.entries(config).length < 1) {
+		let files;
+		const dist = path.relative(Arkstack.rootDir(), outputDir());
+		const require = createRequire(import.meta.url);
+		const configDir = env("CONFIG_PATH", path.join(Arkstack.rootDir(), `${dist}/config`));
+		try {
+			files = readdirSync(configDir, { withFileTypes: true }).filter((file) => {
+				if (file.name.includes("middleware") && globalThis.arkctx?.runtime === "CLI") return false;
+				return file.isFile() && (file.name.endsWith(".js") || file.name.endsWith(".ts"));
+			});
+		} catch {
+			files = [];
+		}
+		Object.assign(config, files.reduce((configs, file) => {
+			const configName = path.basename(file.name, path.extname(file.name));
+			configs[configName] = require(path.join(file.parentPath, file.name)).default(typeof globalThis.app === "function" ? globalThis.app() : {});
+			return configs;
+		}, {}));
+		globalThis[CONFIG_KEY] = config;
 	}
-	const config = files.reduce((configs, file) => {
-		const configName = path.basename(file.name, path.extname(file.name));
-		configs[configName] = require(path.join(file.parentPath, file.name)).default(typeof globalThis.app === "function" ? globalThis.app() : {});
-		return configs;
-	}, {});
-	if (key) return Obj.get(config, key, defaultValue);
-	return config;
+	if (typeof key === "object") {
+		const config = Object.assign({}, Arr.dot(globalThis[CONFIG_KEY]), key);
+		globalThis[CONFIG_KEY] = undot(config);
+	} else if (key) return Obj.get(globalThis[CONFIG_KEY], key, defaultValue);
+	return globalThis[CONFIG_KEY];
 };
 /**
 * Gets the current Node environment (development or production).
@@ -479,6 +489,6 @@ function uses(instance, trait) {
 	return false;
 }
 //#endregion
-export { outputDir as S, config as _, abort as a, interopDefault as b, getModel as c, RequestException as d, AppException as f, appUrl as g, Encryption as h, uses as i, initializeGlobalContext as l, Hash as m, trait as n, abortIf as o, Exception as p, use as r, assertFound as s, crc32 as t, perPage as u, env as v, nodeEnv as x, importFile as y };
+export { outputDir as C, nodeEnv as S, appUrl as _, abort as a, importFile as b, getModel as c, RequestException as d, AppException as f, CONFIG_KEY as g, Encryption as h, uses as i, initializeGlobalContext as l, Hash as m, trait as n, abortIf as o, Exception as p, use as r, assertFound as s, crc32 as t, perPage as u, config as v, interopDefault as x, env as y };
 
-//# sourceMappingURL=utils-C6d-ohT-.js.map
+//# sourceMappingURL=utils-D_dikzz8.js.map

package/dist/utils-D_dikzz8.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils-D_dikzz8.js","names":[],"sources":["../src/system.ts","../src/utils/encryption.ts","../src/utils/hash.ts","../src/Exceptions/Exception.ts","../src/Exceptions/AppException.ts","../src/Exceptions/RequestException.ts","../src/utils/helpers.ts","../src/utils/traits.ts"],"sourcesContent":["import { Arr, Obj, undot } from '@h3ravel/support'\nimport { ConfigRegistry, DotPath, FileImporter, GlobalConfig, GlobalEnv } from './types'\nimport { JitiOptions, JitiResolveOptions, createJiti } from 'jiti'\n\nimport { Arkstack } from '@arkstack/contract'\nimport { Dirent } from 'node:fs'\nimport { createRequire } from 'module'\nimport path from 'node:path'\nimport { pathToFileURL } from 'node:url'\nimport { readdirSync } from 'fs'\nimport { resolve } from 'node:path'\n\n/**\n * Read the .env file\n *\n * @param env\n * @param def\n * @returns\n */\nexport const env: GlobalEnv = <X = string, Y = undefined | X> (\n    env: string,\n    defaultValue?: Y,\n) => {\n    let val: string | number | boolean | undefined | null =\n        process.env[env] ?? ''\n\n    if ([true, 'true', 'on', false, 'false', 'off'].includes(val)) {\n        val = [true, 'true', 'on'].includes(val)\n    }\n\n    if (\n        !isNaN(Number(val)) &&\n        typeof val !== 'boolean' &&\n        typeof val !== 'undefined' &&\n        val !== ''\n    ) {\n        val = Number(val)\n    }\n\n    if (val === '') {\n        val = undefined\n    }\n\n    if (val === 'null') {\n        val = null\n    }\n\n    val ??= defaultValue as typeof val\n\n    return val as Y extends undefined ? X : Y\n}\n\n/**\n * Build the app url\n *\n * @param link\n * @returns\n */\nexport const appUrl = (link?: string): string => {\n    const port = env('PORT') || '3000'\n    const defaultUrl = `http://localhost:${port}`\n    const appUrl = env('APP_URL') ?? defaultUrl\n\n    try {\n        const url = new URL(appUrl)\n        // Append port only if APP_URL has a port or is localhost\n        if (url.port || url.hostname === 'localhost') {\n            url.port = port\n        }\n        // Remove trailing slash from base URL\n        const baseUrl = url.toString().replace(/\\/$/, '')\n        // Append link with proper path separator\n        if (link) {\n            // Ensure link starts with '/' and remove duplicate slashes\n            const normalizedLink = `/${link.replace(/^\\/+/, '')}`\n\n            return `${baseUrl}${normalizedLink}`\n        }\n\n        return baseUrl\n    } catch {\n        // Return default URL with link if provided\n        return link ? `${defaultUrl}/${link.replace(/^\\/+/, '')}` : defaultUrl\n    }\n}\n\nexport const CONFIG_KEY = Symbol('globalConfig');\n(globalThis as any)[CONFIG_KEY] = {}\n\n/**\n * Gets the application configuration.\n *\n * @param key             The configuration key to retrieve.\n * @param defaultValue    The default value to return if the key is not found.\n * @returns               The configuration value.\n */\nexport const config: GlobalConfig = <\n    X extends ConfigRegistry,\n    P extends DotPath<X> | undefined = undefined,\n> (\n    key?: P,\n    defaultValue?: any,\n) => {\n    if (typeof globalThis.env === 'undefined') {\n        globalThis.env = (key?: string, def?: any): any => key\n            ? process.env[key] ?? def\n            : process.env\n    }\n\n    const config = (globalThis as any)[CONFIG_KEY]\n\n    if (Object.entries(config).length < 1) {\n        let files: Dirent<string>[]\n        const dist = path.relative(Arkstack.rootDir(), outputDir())\n        const require = createRequire(import.meta.url)\n        const configDir = env('CONFIG_PATH', path.join(Arkstack.rootDir(), `${dist}/config`))\n\n        try {\n            files = readdirSync(configDir, {\n                withFileTypes: true,\n            }).filter((file) => {\n                if (file.name.includes('middleware') && globalThis.arkctx?.runtime === 'CLI')\n                    return false\n\n                return (\n                    file.isFile() && (file.name.endsWith('.js') || file.name.endsWith('.ts'))\n                )\n            })\n        } catch {\n            files = [] as Dirent<string>[]\n        }\n\n        Object.assign(config, files.reduce(\n            (configs, file) => {\n                const configName = path.basename(file.name, path.extname(file.name))\n\n                configs[configName] = require(\n                    path.join(file.parentPath, file.name),\n                ).default(typeof globalThis.app === 'function' ? globalThis.app() : {})\n\n                return configs\n            },\n            {} as Record<string, any>,\n        ) as X);\n\n        (globalThis as any)[CONFIG_KEY] = config\n    }\n\n    if (typeof key === 'object') {\n        const config = Object.assign({}, Arr.dot((globalThis as any)[CONFIG_KEY]), key);\n        (globalThis as any)[CONFIG_KEY] = undot(config)\n    } else if (key) {\n        return Obj.get((globalThis as any)[CONFIG_KEY], key as never, defaultValue)\n    }\n\n    return (globalThis as any)[CONFIG_KEY]\n}\n\n/**\n * Gets the current Node environment (development or production).\n *\n * @returns\n */\nexport const nodeEnv = () => {\n    let envValue = env<'development' | 'production'>('NODE_ENV', 'development')\n\n    if (envValue !== 'development' && envValue !== 'production') {\n        envValue = 'development'\n    }\n\n    return envValue === 'production' ? 'prod' : 'dev'\n}\n\n/**\n * Gets the output directory for the application based on the current environment.\n *\n * @param cwd  The current working directory (optional, defaults to Arkstack.rootDir()).\n * @returns\n */\nexport const outputDir = (cwd?: string) => {\n    cwd ??= Arkstack.rootDir()\n\n    const NODE_ENV = nodeEnv()\n\n    const output = {\n        dev: env('OUTPUT_DIR_DEV', '.arkstack/build'),\n        prod: env('OUTPUT_DIR', 'dist'),\n    }\n\n    return path.isAbsolute(output[NODE_ENV] ?? output.dev)\n        ? (output[NODE_ENV] ?? output.dev)\n        : path.join(cwd, output[NODE_ENV] ?? output.dev)\n}\n/**\n * \n * Dynamically imports a file at the given path with full TypeScript support,\n * including `tsconfig.json` path aliases. \n *\n * @param filePath - The path to the file to import. \n * @returns The imported module typed as `T`.\n *\n * @example\n * const config = await importFile<AppConfig>('./config/app.ts')\n */\nexport const importFile: FileImporter = async <T = unknown> (\n    filePath: string,\n    userOptions?: JitiOptions | undefined,\n    resolveOptions?: (JitiResolveOptions & { default?: true })\n): Promise<T> => {\n    const resolvedPath = resolve(filePath)\n    const jiti = createJiti(pathToFileURL(resolvedPath).href, {\n        ...userOptions,\n        interopDefault: false,\n        tsconfigPaths: true,\n    })\n\n    return await jiti.import<T>(resolvedPath, resolveOptions)\n}\n\n/**\n * Resolves the default export from a module, handling both CJS and ESM interop.\n * In CJS modules, the default export is often the module itself (a function or object),\n * while in ESM the default is nested under the `default` property.\n *\n * @param imp - The imported module\n * @returns The resolved default export\n */\nexport const interopDefault = <T> (imp: T | { default: T }): T => {\n    return typeof imp === 'function'\n        ? imp as T\n        : (imp as { default: T }).default\n}","import { createCipheriv, createDecipheriv, createHash, randomBytes } from 'node:crypto'\n\nimport { env } from '../system'\n\nexport class Encryption {\n    private static readonly algorithm = 'aes-256-gcm'\n\n    private static getKey () {\n        const secret = env('TWO_FACTOR_ENCRYPTION_KEY')\n\n        if (!secret) {\n            throw new Error('TWO_FACTOR_ENCRYPTION_KEY is required to use two-factor authentication')\n        }\n\n        return createHash('sha256').update(secret).digest()\n    }\n\n    static encrypt (value: string) {\n        const iv = randomBytes(12)\n        const cipher = createCipheriv(this.algorithm, this.getKey(), iv)\n        const ciphertext = Buffer.concat([\n            cipher.update(value, 'utf8'),\n            cipher.final(),\n        ])\n        const authTag = cipher.getAuthTag()\n\n        return [iv, authTag, ciphertext].map((part) => part.toString('base64url')).join(':')\n    }\n\n    static decrypt (payload: string) {\n        const [iv, authTag, ciphertext] = payload.split(':')\n\n        if (!iv || !authTag || !ciphertext) {\n            throw new Error('Invalid encrypted payload format')\n        }\n\n        const decipher = createDecipheriv(\n            this.algorithm,\n            this.getKey(),\n            Buffer.from(iv, 'base64url'),\n        )\n\n        decipher.setAuthTag(Buffer.from(authTag, 'base64url'))\n\n        const plaintext = Buffer.concat([\n            decipher.update(Buffer.from(ciphertext, 'base64url')),\n            decipher.final(),\n        ])\n\n        return plaintext.toString('utf8')\n    }\n}","import { Secret, TOTP } from 'otpauth'\nimport { compare, genSalt, hash } from 'bcryptjs'\n\nimport { env } from '../system'\n\nexport class Hash {\n  /**\n   * Hash a value using bcrypt\n   * \n   * @param value \n   * @returns \n   */\n  static async make (value: string): Promise<string> {\n    const salt = await genSalt(10)\n\n    return await hash(value, salt)\n  }\n\n  /**\n   * Verify a value against a hashed value\n   * \n   * @param value \n   * @param hashedValue \n   * @returns \n   */\n  static async verify (value: string, hashedValue: string): Promise<boolean> {\n    return await compare(value, hashedValue)\n  }\n\n  /**\n   * Generate a one-time password (OTP) using TOTP algorithm\n   * \n   * @param digits    The number of digits for the OTP, default is 6.\n   * @param label     A label to identify the OTP, can be an email or phone number.\n   * @param period    Interval of time for which a token is valid, in seconds.\n   * @returns \n   */\n  static otp (digits: number = 6, label: string = 'Alice', period: number = 30) {\n    return new TOTP({\n      label,\n      digits,\n      issuer: env('APP_NAME', 'Roseed'),\n      algorithm: 'SHA1',\n      period, // in seconds.\n      secret: 'US3WHSG7X5KAPV27VANWKQHF3SH3HULL',\n    })\n  }\n\n  static totp (secret: string, label: string, issuer: string = env('APP_NAME', 'Roseed'), period: number = 30) {\n    return new TOTP({\n      issuer,\n      label,\n      algorithm: 'SHA1',\n      digits: 6,\n      period,\n      secret: Secret.fromBase32(secret),\n    })\n  }\n}","export class Exception extends Error {\n    name: string\n\n    constructor(message?: string, options?: ErrorOptions) {\n        super(message, options)\n        this.name = 'Exception'\n    }\n}","import { Exception } from './Exception'\n\nexport class AppException extends Exception {\n    errors?: { [key: string]: string[] | string } | undefined = undefined\n\n    statusCode: number\n\n    constructor(message?: string, statusCode: number = 400, options?: ErrorOptions) {\n        super(message, options)\n        this.statusCode = statusCode\n    }\n}","import { AppException } from './AppException'\n\nexport class RequestException extends AppException {\n    statusCode: number\n\n    constructor(message?: string, statusCode: number = 400, options?: ErrorOptions) {\n        super(message, statusCode, options)\n        this.statusCode = statusCode\n    }\n\n    /**\n     * Asserts that a value is not null or undefined. \n     * \n     * @param value \n     * @param message \n     * @param code \n     * @throws {RequestException} Throws if the value is null or undefined.\n     */\n    static assertFound<T> (\n        value: T | null | undefined,\n        message: string,\n        code: number = 404,\n    ): asserts value is T {\n        if (!value) {\n            throw new RequestException(message, code)\n        }\n    }\n\n    /**\n     * Asserts that a value is not null or undefined. \n     * \n     * @param value \n     * @param message \n     * @param code \n     * @throws {RequestException} Throws if the value is null or undefined.\n     * @deprecated Use assertFound instead\n     */\n    static assertNotEmpty<T> (\n        value: T | null | undefined,\n        message: string,\n        code: number = 404,\n    ): asserts value is T {\n        return this.assertFound(value, message, code)\n    }\n\n    /**\n     * Asserts that a boolean condition is true. \n     * \n     * @param boolean \n     * @param message \n     * @param code \n     * @throws {RequestException} Throws if the boolean condition is true.\n     */\n    static abortIf<T> (\n        boolean: T,\n        message: string,\n        code?: number,\n    ): asserts  boolean is T {\n        if (boolean) {\n            throw new RequestException(message, code)\n        }\n    }\n}","import { getUserConfig, type Model, type ModelStatic } from 'arkormx'\nimport { importFile } from '../system'\nimport path from 'node:path'\nimport { Arkstack } from '@arkstack/contract'\nimport { RequestException } from '../Exceptions/RequestException'\n\nexport type AbstractModelConstructor<TModel = unknown> =\n    abstract new (attributes?: Record<string, unknown>) => TModel\n\nexport type ModelConstructor<TModel extends Model = Model> =\n    AbstractModelConstructor<TModel> &\n    Pick<ModelStatic<TModel>, keyof ModelStatic<TModel>>\n\n\nexport interface ModelRegistry { }\n\ntype ModelName = Extract<keyof ModelRegistry, string>\ntype ModelModule = Record<string, unknown> & {\n    default?: unknown;\n}\n\n/**\n * Determine the number of items to return per page based on the provided query parameters.\n * \n * @param query \n * @returns \n */\nexport const perPage = (query: { limit?: number; perPage?: number }) => {\n\n    const requestedPerPage = Number(query.limit ?? query.perPage ?? 15)\n\n    return Number.isFinite(requestedPerPage) && requestedPerPage > 0\n        ? Math.min(requestedPerPage, 50)\n        : 15\n}\n\n/**\n * Import an application model by name.\n *\n * Apps can augment `ModelRegistry` to make `getModel('User')` return `typeof User`.\n * Without a registry entry, pass the class type explicitly: `getModel<typeof User>('User')`.\n * \n * @param modelName \n */\nexport async function getModel<TName extends ModelName> (\n    modelName: TName\n): Promise<ModelRegistry[TName]>\nexport async function getModel<TModel extends AbstractModelConstructor = ModelConstructor> (\n    modelName: string\n): Promise<TModel>\nexport async function getModel (modelName: string) {\n    const resolveModelExport = (module: ModelModule | unknown, modelName: string) => {\n        if (!isModelModule(module)) {\n            return module\n        }\n\n        return module.default ?? module[modelName] ?? module\n    }\n\n    const isModelModule = (value: unknown): value is ModelModule => (\n        typeof value === 'object' && value !== null\n    )\n\n    const modelPath = getUserConfig().paths?.models || './src/models'\n    const modulePath = path.join(\n        path.isAbsolute(modelPath) ? modelPath : path.join(Arkstack.rootDir(), modelPath),\n        modelName\n    )\n    const module = await importFile<ModelModule | unknown>(modulePath)\n    const exportName = path.basename(modelName, path.extname(modelName))\n    const model = resolveModelExport(module, exportName)\n\n    if (typeof model !== 'function') {\n        throw new Error(`Model \"${modelName}\" not found`)\n    }\n\n    return model\n}\n\nexport const initializeGlobalContext = async (\n    { Request, Response, Session }: { Request?: any, Response?: any, Session?: any } = {}\n) => {\n    try {\n        const { Request: Req, Response: Res, Session: Ses } = await import('@arkstack/http')\n        Session ??= new Ses()\n        Request ??= new Req()\n        Response ??= new Res()\n    } catch {\n        Session ??= new class { }\n        Request ??= new class { }\n        Response ??= new class { }\n    }\n\n    globalThis.session ??= () => Session\n    globalThis.request ??= () => Request\n    globalThis.response ??= () => Response\n}\n\n/**\n * Thows to abort the current request\n * \n * @param message \n * @param code \n * @throws {RequestException}\n */\nexport const abort = (\n    message: string = 'Request Aborted',\n    code: number = 404,\n): void => {\n    RequestException.abortIf(true, message, code)\n}\n\n/**\n * Asserts that a boolean condition is true. \n * \n * @param boolean \n * @param message \n * @param code \n * @throws {RequestException} Throws if the boolean condition is true.\n */\nexport const abortIf = <T> (\n    boolean: T,\n    message: string = 'Request Aborted',\n    code: number = 404,\n): asserts  boolean is T => {\n    RequestException.abortIf(boolean, message, code)\n}\n\n/**\n * Asserts that a value is not null or undefined. \n * \n * @param value \n * @param message \n * @param code \n * @throws {RequestException} Throws if the value is null or undefined.\n */\nexport const assertFound = <T> (\n    value: T | null | undefined,\n    message: string,\n    code: number = 404,\n): asserts value is T => {\n    if (!value) {\n        throw new RequestException(message, code)\n    }\n}","/*\n**  Extracted from @traits-ts/core - Traits for TypeScript Classes\n**  Copyright (c) 2025 Dr. Ralf S. Engelschall <rse@engelschall.com>\n**  Licensed under MIT license <https://spdx.org/licenses/MIT>\n*/\n\nimport type { Model as ArkormModel } from 'arkormx'\n\n/**\n * CRC32 implementation in TypeScript, adapted from https://stackoverflow.com/a/18639999\n * Note: This implementation is not cryptographically secure and is only used for generating \n * unique identifiers for traits based on their factory function's string representation. \n */\nconst crcTable = [] as number[]\nfor (let n = 0; n < 256; n++) {\n    let c = n\n    for (let k = 0; k < 8; k++)\n        c = ((c & 1) ? (0xEDB88320 ^ (c >>> 1)) : (c >>> 1))\n    crcTable[n] = c\n}\nexport const crc32 = (str: string) => {\n    let crc = 0 ^ (-1)\n    for (let i = 0; i < str.length; i++)\n        crc = (crc >>> 8) ^ crcTable[(crc ^ str.charCodeAt(i)) & 0xFF]\n\n    return (crc ^ (-1)) >>> 0\n}\n\ntype ResolveTraitLike<T extends Trait | TypeFactory<Trait>> =\n    T extends TypeFactory<Trait>\n    ? ExtractFactory<ReturnType<T>>\n    : T extends Trait\n    ? ExtractFactory<T>\n    : unknown;\n\ntype Combine<T extends any[]> =\n    T extends [infer Head, ...infer Tail]\n    ? Head & Combine<Tail>\n    : object;\n\ntype MapClassesToPrototypes<T extends Array<(new () => any) & { prototype: any }>> = {\n    [K in keyof T]: T[K]['prototype'];\n}\n\ntype MapClassesToInstances<T extends Array<(new () => any) & { prototype: any }>> = {\n    [K in keyof T]: InstanceType<T[K]>;\n}\n\ntype CombineClasses<T extends Array<(new () => any) & { prototype: any }>> =\n    (new () => Combine<MapClassesToInstances<T>>) & { prototype: Combine<MapClassesToPrototypes<T>> };\n\ntype ResolveTraitLikeArray<T extends Array<Trait | TypeFactory<Trait>>> = CombineClasses<{\n    [K in keyof T]: ResolveTraitLike<T[K]>;\n}>;\n\n/**\n * utility type and function: constructor (function)\n */\ntype Cons<T = any> =\n    new (...args: any[]) => T\nconst isCons =\n    <T = any>\n        (fn: unknown): fn is Cons<T> =>\n        typeof fn === 'function' && !!fn.prototype && !!fn.prototype.constructor\n\ntype ArkormModelCons<T extends ArkormModel = ArkormModel> =\n    abstract new (...args: any[]) => T\n\ntype DirectCons<T = any> =\n    Cons<T> | ArkormModelCons<ArkormModel>\n\ntype DirectBase =\n    DirectCons | ArkormModel\n\nconst isArkormModelInstance =\n    (value: unknown): value is ArkormModel =>\n        typeof value === 'object' &&\n        value !== null &&\n        typeof (value as { constructor?: unknown }).constructor === 'function' &&\n        typeof (value as { getAttribute?: unknown }).getAttribute === 'function' &&\n        typeof (value as { setAttribute?: unknown }).setAttribute === 'function'\n\n/**\n * utility type and function: constructor factory (function)\n */\ntype ConsFactory<T extends Cons = Cons, B = any> =\n    (base: B) => T\n\n/**\n * utility type and function: type factory (function)\n */\ntype TypeFactory<T = any> =\n    () => T\nconst isTypeFactory =\n    <T = any>\n        (fn: unknown): fn is TypeFactory<T> =>\n        typeof fn === 'function' && !fn.prototype && fn.length === 0\n\n/**\n * utility type: map an object type into a bare properties type\n */\ntype Explode<T = any> =\n    { [P in keyof T]: T[P] }\n\n/**\n * utility type: convert two arrays of types into an array of union types\n */\ntype MixParams<T1 extends any[], T2 extends any[]> =\n    T1 extends [] ? (\n        T2 extends [] ? [] : T2\n    ) : (\n        T2 extends [] ? T1 : (\n            T1 extends [infer H1, ...infer R1] ? (\n                T2 extends [infer H2, ...infer R2] ?\n                [H1 & H2, ...MixParams<R1, R2>]\n                : []\n            ) : []\n        )\n    )\n\n/**\n * API: trait type\n */\ntype TraitDefTypeT = ConsFactory<Cons>\ntype TraitDefTypeST = (Trait | TypeFactory<Trait>)[] | undefined\nexport type Trait<\n    T extends TraitDefTypeT = TraitDefTypeT,\n    ST extends TraitDefTypeST = TraitDefTypeST\n> = {\n    id: number  /* unique id (primary,   for hasTrait)      */\n    symbol: symbol  /* unique id (secondary, currently unused)  */\n    factory: T\n    superTraits: ST\n}\n\n/**\n * API: generate trait (regular variant)\n * \n * @param factory \n */\nexport function trait<\n    T extends ConsFactory<Cons>\n> (factory: T): Trait<T, undefined>\n\n/**\n * API: generate trait (super-trait variant)\n * \n * @param superTraits \n * @param factory \n */\nexport function trait<\n    const ST extends (Trait | TypeFactory<Trait>)[],\n    T extends ConsFactory<Cons, ResolveTraitLikeArray<ST>>\n> (superTraits: ST, factory: T): Trait<T, ST>\n\n/**\n * API: generate trait (technical implementation)\n * \n * @param args \n */\nexport function trait (...args: any[]): Trait<any, any> {\n    const factory: ConsFactory<any, any> = (args.length === 2 ? args[1] : args[0])\n    const superTraits: (Trait | TypeFactory<Trait>)[] = (args.length === 2 ? args[0] : undefined)\n\n    return {\n        id: crc32(factory.toString()),\n        symbol: Symbol('trait'),\n        factory,\n        superTraits\n    }\n}\n\n/**\n * utility types: extract factory from a trait\n */\ntype ExtractFactory<\n    T extends Trait\n> =\n    T extends Trait<\n        ConsFactory<infer C>,\n        TraitDefTypeST\n    > ? C : never\n\n/**\n * utility types: extract supertraits from a trait\n */\ntype ExtractSuperTrait<\n    T extends Trait\n> =\n    T extends Trait<\n        TraitDefTypeT,\n        infer ST extends TraitDefTypeST\n    > ? ST : never\n\n/**\n * utility type: derive type constructor: merge two constructors\n */\ntype DeriveTraitsConsConsMerge<\n    A extends Cons,\n    B extends Cons\n> =\n    A extends (new (...args: infer ArgsA) => infer RetA) ? (\n        B extends (new (...args: infer ArgsB) => infer RetB) ? (\n            new (...args: MixParams<ArgsA, ArgsB>) => RetA & RetB\n        ) : never\n    ) : never\n\n/**\n * utility type: derive type constructor: extract plain constructor\n */\ntype DeriveTraitsConsCons<\n    T extends DirectCons\n> =\n    new (...args: ConstructorParameters<T>) => InstanceType<T>\n\ntype DeriveTraitsConsDirectBase<\n    T extends DirectBase\n> =\n    T extends ArkormModel ? new (...args: any[]) => T :\n    T extends DirectCons ? DeriveTraitsConsCons<T> :\n    never\n\n/**\n * utility type: derive type constructor: from trait parts\n */\ntype DeriveTraitsConsTraitParts<\n    C extends Cons,\n    ST extends ((Trait | TypeFactory<Trait>)[] | undefined)\n> =\n    ST extends undefined ? DeriveTraitsConsCons<C> :\n    ST extends [] ? DeriveTraitsConsCons<C> :\n    DeriveTraitsConsConsMerge<\n        DeriveTraitsConsCons<C>,\n        DeriveTraitsConsAll<ST>> /* RECURSION */\n\n/**\n * utility type: derive type constructor: from single trait\n */\ntype DeriveTraitsConsTrait<\n    T extends Trait\n> =\n    DeriveTraitsConsTraitParts<\n        ExtractFactory<T>,\n        ExtractSuperTrait<T>>\n\n/**\n * utility type: derive type constructor: from single trait or trait factory\n */\ntype DeriveTraitsConsOne<\n    T extends (Trait | TypeFactory<Trait>)\n> =\n    T extends Trait ? DeriveTraitsConsTrait<T> :\n    T extends TypeFactory<Trait> ? DeriveTraitsConsTrait<ReturnType<T>> :\n    never\n\n/**\n * utility type: derive type constructor: from one or more traits or trait factories\n */\ntype DeriveTraitsConsAll<\n    T extends (((Trait | TypeFactory<Trait>)[] | [...(Trait | TypeFactory<Trait>)[], DirectBase]) | undefined)\n> =\n    T extends [infer Only extends DirectBase] ? DeriveTraitsConsDirectBase<Only> :\n    T extends [...infer Others extends (Trait | TypeFactory<Trait>)[], infer Last extends DirectBase] ? (\n        Others extends [] ? DeriveTraitsConsDirectBase<Last> :\n        DeriveTraitsConsConsMerge<\n            DeriveTraitsConsAll<Others>, /* RECURSION */\n            DeriveTraitsConsDirectBase<Last>>\n    ) :\n    T extends (Trait | TypeFactory<Trait>)[] ? (\n        T extends [infer First extends (Trait | TypeFactory<Trait>)] ? (\n            DeriveTraitsConsOne<First>\n        ) : (\n            T extends [\n                infer First extends (Trait | TypeFactory<Trait>),\n                ...infer Rest extends (Trait | TypeFactory<Trait>)[]] ? (\n                DeriveTraitsConsConsMerge<\n                    DeriveTraitsConsOne<First>,\n                    DeriveTraitsConsAll<Rest>> /* RECURSION */\n            ) : never\n        )\n    ) : never\n\n/**\n * utility type: derive type constructor\n */\ntype DeriveTraitsCons<\n    T extends ((Trait | TypeFactory<Trait>)[] | [...(Trait | TypeFactory<Trait>)[], DirectBase])\n> =\n    DeriveTraitsConsAll<T>\n\n/**\n * utility type: derive type statics: merge two objects with statics\n */\ntype DeriveTraitsStatsConsMerge<\n    T1 extends object,\n    T2 extends object\n> =\n    T1 & T2\n\n/**\n * utility type: derive type statics: extract plain statics\n */\ntype DeriveTraitsStatsCons<\n    T extends DirectCons\n> =\n    Explode<T>\n\ntype DeriveTraitsStatsDirectBase<\n    T extends DirectBase\n> =\n    T extends ArkormModel ? object :\n    T extends DirectCons ? DeriveTraitsStatsCons<T> :\n    never\n\n/**\n * utility type: derive type statics: from trait parts\n */\ntype DeriveTraitsStatsTraitParts<\n    C extends Cons,\n    ST extends ((Trait | TypeFactory<Trait>)[] | undefined)\n> =\n    ST extends undefined ? DeriveTraitsStatsCons<C> :\n    ST extends [] ? DeriveTraitsStatsCons<C> :\n    DeriveTraitsStatsConsMerge<\n        DeriveTraitsStatsCons<C>,\n        DeriveTraitsStatsAll<ST>> /* RECURSION */\n\n/**\n * utility type: derive type statics: from single trait\n */\ntype DeriveTraitsStatsTrait<\n    T extends Trait\n> =\n    DeriveTraitsStatsTraitParts<\n        ExtractFactory<T>,\n        ExtractSuperTrait<T>>\n\n/**\n * utility type: derive type statics: from single trait or trait factory\n */\ntype DeriveTraitsStatsOne<\n    T extends (Trait | TypeFactory<Trait>)\n> =\n    T extends Trait ? DeriveTraitsStatsTrait<T> :\n    T extends TypeFactory<Trait> ? DeriveTraitsStatsTrait<ReturnType<T>> :\n    never\n\n/**\n * utility type: derive type statics: from one or more traits or trait factories\n */\ntype DeriveTraitsStatsAll<\n    T extends (((Trait | TypeFactory<Trait>)[] | [...(Trait | TypeFactory<Trait>)[], DirectBase]) | undefined)\n> =\n    T extends [infer Only extends DirectBase] ? DeriveTraitsStatsDirectBase<Only> :\n    T extends [...infer Others extends (Trait | TypeFactory<Trait>)[], infer Last extends DirectBase] ? (\n        Others extends [] ? DeriveTraitsStatsDirectBase<Last> :\n        DeriveTraitsStatsConsMerge<\n            DeriveTraitsStatsAll<Others>, /* RECURSION */\n            DeriveTraitsStatsDirectBase<Last>>\n    ) :\n    T extends (Trait | TypeFactory<Trait>)[] ? (\n        T extends [infer First extends (Trait | TypeFactory<Trait>)] ? (\n            DeriveTraitsStatsOne<First>\n        ) : (\n            T extends [\n                infer First extends (Trait | TypeFactory<Trait>),\n                ...infer Rest extends (Trait | TypeFactory<Trait>)[]] ? (\n                DeriveTraitsStatsConsMerge<\n                    DeriveTraitsStatsOne<First>,\n                    DeriveTraitsStatsAll<Rest>> /* RECURSION */\n            ) : never\n        )\n    ) : never\n\n/**\n * utility type: derive type statics\n */\ntype DeriveTraitsStats<\n    T extends ((Trait | TypeFactory<Trait>)[] | [...(Trait | TypeFactory<Trait>)[], DirectBase])\n> =\n    DeriveTraitsStatsAll<T>\n\n/**\n * utility type: derive type from one or more traits or trait type factories\n */\ntype DeriveTraits<\n    T extends ((Trait | TypeFactory<Trait>)[] | [...(Trait | TypeFactory<Trait>)[], DirectBase])\n> =\n    DeriveTraitsCons<T> &\n    DeriveTraitsStats<T>\n\n/**\n * utility function: add an additional invisible property to an object\n * \n * @param cons \n * @param field \n * @param value \n * @returns \n */\nconst extendProperties =\n    (cons: Cons, field: string | symbol, value: any) =>\n        Object.defineProperty(cons, field, { value, enumerable: false, writable: false })\n\n/**\n * utility function: get raw trait\n * \n * @param x \n * @returns \n */\nconst rawTrait = (x: (Trait | TypeFactory<Trait>)) =>\n    isTypeFactory(x) ? x() : x\n\n/**\n * utility function: derive a trait\n * \n * @param trait$ \n * @param baseClz \n * @param derived \n * @returns \n */\nconst deriveTrait = (\n    trait$: Trait | TypeFactory<Trait>,\n    baseClz: Cons<any>,\n    derived: Map<number, boolean>\n) => {\n    /*  get real trait  */\n    const trait = rawTrait(trait$)\n\n    /*  start with base class  */\n    let clz = baseClz\n\n    /*  in case we still have not derived this trait...  */\n    if (!derived.has(trait.id)) {\n        derived.set(trait.id, true)\n\n        /*  iterate over all of its super traits  */\n        if (trait.superTraits !== undefined)\n            for (const superTrait of reverseTraitList(trait.superTraits))\n                clz = deriveTrait(superTrait, clz, derived) /*  RECURSION  */\n\n        /*  derive this trait  */\n        clz = trait.factory(clz)\n        extendProperties(clz, 'id', crc32(trait.factory.toString()))\n        extendProperties(clz, trait.symbol, true)\n    }\n\n    return clz\n}\n\n/**\n * utility function: get reversed trait list\n * \n * @param traits \n * @returns \n */\nconst reverseTraitList = (traits: (Trait | TypeFactory<Trait>)[]) =>\n    traits.slice().reverse() as (Trait | TypeFactory<Trait>)[]\n\n/**\n * API: derive a class from one or more traits or trait type factories\n * \n * @param traits \n * @returns \n */\nexport function use\n    <T extends (\n        [Trait | TypeFactory<Trait>, ...(Trait | TypeFactory<Trait>)[]] |\n        [...(Trait | TypeFactory<Trait>)[], DirectBase]\n    )>\n    (...traits: T): DeriveTraits<T> {\n    /*  run-time sanity check  */\n    if (traits.length === 0)\n        throw new Error('invalid number of parameters (expected one or more traits)')\n\n    /*  determine the base class (clz) and the list of traits (lot)  */\n    let clz: Cons<any>\n    let lot: (Trait | TypeFactory<Trait>)[]\n    const last = traits[traits.length - 1]\n    if (isCons(last) && !isTypeFactory(last)) {\n        /*  case 1: with trailing regular class  */\n        clz = last\n        lot = traits.slice(0, -1) as (Trait | TypeFactory<Trait>)[]\n    } else if (isArkormModelInstance(last)) {\n        /*  case 2: with trailing Arkorm model instance  */\n        clz = last.constructor as Cons<any>\n        lot = traits.slice(0, -1) as (Trait | TypeFactory<Trait>)[]\n    } else {\n        /*  case 3: just regular traits or trait type factories  */\n        clz = class ROOT { }\n        lot = traits as (Trait | TypeFactory<Trait>)[]\n    }\n\n    /*  track already derived traits  */\n    const derived = new Map<number, boolean>()\n\n    /*  iterate over all traits  */\n    for (const trait of reverseTraitList(lot))\n        clz = deriveTrait(trait, clz, derived)\n\n    return clz as DeriveTraits<T>\n}\n\n/**\n * internal type: implements trait type\n */\ntype DerivedType<T extends Trait> =\n    InstanceType<ExtractFactory<T>>\n\n/**\n * internal type: implements trait type or trait type factory\n */\nexport type Derived<T extends (Trait | TypeFactory<Trait> | Cons)> =\n    T extends TypeFactory<Trait> ? DerivedType<ReturnType<T>> :\n    T extends Trait ? DerivedType<T> :\n    T extends Cons ? T :\n    never\n\n/**\n * API: type guard for checking whether class instance is derived from a trait\n * \n * @param instance \n * @param trait \n * @returns \n */\nexport function uses\n    <T extends (Trait | TypeFactory<Trait> | Cons)>\n    (instance: unknown, trait: T): instance is Derived<T> {\n    /*  ensure the class instance is really an object  */\n    if (typeof instance !== 'object' || instance === null)\n        return false\n    let obj = instance\n\n    /*  special case: regular class  */\n    if (isCons(trait) && !isTypeFactory(trait))\n        return (instance instanceof trait)\n\n    /*  regular case: trait or trait type factory...  */\n    const t = (isTypeFactory(trait) ? trait() : trait) as Trait\n    const idTrait = t['id']\n    while (obj) {\n        if (Object.hasOwn(obj, 'constructor')) {\n            const id = ((obj.constructor as any)['id'] as number) ?? 0\n            if (id === idTrait)\n                return true\n        }\n        obj = Object.getPrototypeOf(obj)\n    }\n\n    return false\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkstack/common",
-  "version": "0.12.0",
+  "version": "0.12.2",
   "type": "module",
   "description": "Core utilities, primitives, and shared infrastructure for the Arkstack ecosystem.",
   "homepage": "https://arkstack.toneflix.net",
@@ -42,11 +42,12 @@
   "peerDependencies": {
     "@h3ravel/support": "^0.15.11",
     "arkormx": "^ 2.4.1",
-    "@arkstack/foundry": "^0.12.0",
-    "@arkstack/contract": "^0.12.0"
+    "@arkstack/foundry": "^0.12.2",
+    "@arkstack/contract": "^0.12.2"
   },
   "scripts": {
     "build": "tsdown --config-loader unrun",
+    "test": "vitest",
     "version:patch": "pnpm version patch"
   }
 }

package/dist/utils-C6d-ohT-.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils-C6d-ohT-.js","names":[],"sources":["../src/system.ts","../src/utils/encryption.ts","../src/utils/hash.ts","../src/Exceptions/Exception.ts","../src/Exceptions/AppException.ts","../src/Exceptions/RequestException.ts","../src/utils/helpers.ts","../src/utils/traits.ts"],"sourcesContent":["import { ConfigRegistry, DotPath, FileImporter, GlobalConfig, GlobalEnv } from './types'\nimport { JitiOptions, JitiResolveOptions, createJiti } from 'jiti'\n\nimport { Arkstack } from '@arkstack/contract'\nimport { Dirent } from 'node:fs'\nimport { Obj } from '@h3ravel/support'\nimport { createRequire } from 'module'\nimport path from 'node:path'\nimport { pathToFileURL } from 'node:url'\nimport { readdirSync } from 'fs'\nimport { resolve } from 'node:path'\n\n/**\n * Read the .env file\n *\n * @param env\n * @param def\n * @returns\n */\nexport const env: GlobalEnv = <X = string, Y = undefined | X> (\n    env: string,\n    defaultValue?: Y,\n) => {\n    let val: string | number | boolean | undefined | null =\n        process.env[env] ?? ''\n\n    if ([true, 'true', 'on', false, 'false', 'off'].includes(val)) {\n        val = [true, 'true', 'on'].includes(val)\n    }\n\n    if (\n        !isNaN(Number(val)) &&\n        typeof val !== 'boolean' &&\n        typeof val !== 'undefined' &&\n        val !== ''\n    ) {\n        val = Number(val)\n    }\n\n    if (val === '') {\n        val = undefined\n    }\n\n    if (val === 'null') {\n        val = null\n    }\n\n    val ??= defaultValue as typeof val\n\n    return val as Y extends undefined ? X : Y\n}\n\n/**\n * Build the app url\n *\n * @param link\n * @returns\n */\nexport const appUrl = (link?: string): string => {\n    const port = env('PORT') || '3000'\n    const defaultUrl = `http://localhost:${port}`\n    const appUrl = env('APP_URL') ?? defaultUrl\n\n    try {\n        const url = new URL(appUrl)\n        // Append port only if APP_URL has a port or is localhost\n        if (url.port || url.hostname === 'localhost') {\n            url.port = port\n        }\n        // Remove trailing slash from base URL\n        const baseUrl = url.toString().replace(/\\/$/, '')\n        // Append link with proper path separator\n        if (link) {\n            // Ensure link starts with '/' and remove duplicate slashes\n            const normalizedLink = `/${link.replace(/^\\/+/, '')}`\n\n            return `${baseUrl}${normalizedLink}`\n        }\n\n        return baseUrl\n    } catch {\n        // Return default URL with link if provided\n        return link ? `${defaultUrl}/${link.replace(/^\\/+/, '')}` : defaultUrl\n    }\n}\n\n/**\n * Gets the application configuration.\n *\n * @param key             The configuration key to retrieve.\n * @param defaultValue    The default value to return if the key is not found.\n * @returns               The configuration value.\n */\nexport const config: GlobalConfig = <\n    X extends ConfigRegistry,\n    P extends DotPath<X> | undefined = undefined,\n> (\n    key?: P,\n    defaultValue?: any,\n) => {\n    if (typeof globalThis.env === 'undefined') {\n        globalThis.env = (key?: string, def?: any): any => key\n            ? process.env[key] ?? def\n            : process.env\n    }\n\n    let files: Dirent<string>[]\n    const dist = path.relative(Arkstack.rootDir(), outputDir())\n    const require = createRequire(import.meta.url)\n\n    try {\n        files = readdirSync(path.join(Arkstack.rootDir(), `${dist}/config`), {\n            withFileTypes: true,\n        }).filter((file) => {\n            if (file.name.includes('middleware') && globalThis.arkctx?.runtime === 'CLI')\n                return false\n\n            return (\n                file.isFile() && (file.name.endsWith('.js') || file.name.endsWith('.ts'))\n            )\n        })\n    } catch {\n        files = [] as Dirent<string>[]\n    }\n\n    const config = files.reduce(\n        (configs, file) => {\n            const configName = path.basename(file.name, path.extname(file.name))\n\n            configs[configName] = require(\n                path.join(file.parentPath, file.name),\n            ).default(typeof globalThis.app === 'function' ? globalThis.app() : {})\n\n            return configs\n        },\n        {} as Record<string, any>,\n    ) as X\n\n    if (key) {\n        return Obj.get(config, key as never, defaultValue)\n    }\n\n    return config\n}\n\n/**\n * Gets the current Node environment (development or production).\n *\n * @returns\n */\nexport const nodeEnv = () => {\n    let envValue = env<'development' | 'production'>('NODE_ENV', 'development')\n\n    if (envValue !== 'development' && envValue !== 'production') {\n        envValue = 'development'\n    }\n\n    return envValue === 'production' ? 'prod' : 'dev'\n}\n\n/**\n * Gets the output directory for the application based on the current environment.\n *\n * @param cwd  The current working directory (optional, defaults to Arkstack.rootDir()).\n * @returns\n */\nexport const outputDir = (cwd?: string) => {\n    cwd ??= Arkstack.rootDir()\n\n    const NODE_ENV = nodeEnv()\n\n    const output = {\n        dev: env('OUTPUT_DIR_DEV', '.arkstack/build'),\n        prod: env('OUTPUT_DIR', 'dist'),\n    }\n\n    return path.isAbsolute(output[NODE_ENV] ?? output.dev)\n        ? (output[NODE_ENV] ?? output.dev)\n        : path.join(cwd, output[NODE_ENV] ?? output.dev)\n}\n/**\n * \n * Dynamically imports a file at the given path with full TypeScript support,\n * including `tsconfig.json` path aliases. \n *\n * @param filePath - The path to the file to import. \n * @returns The imported module typed as `T`.\n *\n * @example\n * const config = await importFile<AppConfig>('./config/app.ts')\n */\nexport const importFile: FileImporter = async <T = unknown> (\n    filePath: string,\n    userOptions?: JitiOptions | undefined,\n    resolveOptions?: (JitiResolveOptions & { default?: true })\n): Promise<T> => {\n    const resolvedPath = resolve(filePath)\n    const jiti = createJiti(pathToFileURL(resolvedPath).href, {\n        ...userOptions,\n        interopDefault: false,\n        tsconfigPaths: true,\n    })\n\n    return await jiti.import<T>(resolvedPath, resolveOptions)\n}\n\n/**\n * Resolves the default export from a module, handling both CJS and ESM interop.\n * In CJS modules, the default export is often the module itself (a function or object),\n * while in ESM the default is nested under the `default` property.\n *\n * @param imp - The imported module\n * @returns The resolved default export\n */\nexport const interopDefault = <T> (imp: T | { default: T }): T => {\n    return typeof imp === 'function'\n        ? imp as T\n        : (imp as { default: T }).default\n}","import { createCipheriv, createDecipheriv, createHash, randomBytes } from 'node:crypto'\n\nimport { env } from '../system'\n\nexport class Encryption {\n    private static readonly algorithm = 'aes-256-gcm'\n\n    private static getKey () {\n        const secret = env('TWO_FACTOR_ENCRYPTION_KEY')\n\n        if (!secret) {\n            throw new Error('TWO_FACTOR_ENCRYPTION_KEY is required to use two-factor authentication')\n        }\n\n        return createHash('sha256').update(secret).digest()\n    }\n\n    static encrypt (value: string) {\n        const iv = randomBytes(12)\n        const cipher = createCipheriv(this.algorithm, this.getKey(), iv)\n        const ciphertext = Buffer.concat([\n            cipher.update(value, 'utf8'),\n            cipher.final(),\n        ])\n        const authTag = cipher.getAuthTag()\n\n        return [iv, authTag, ciphertext].map((part) => part.toString('base64url')).join(':')\n    }\n\n    static decrypt (payload: string) {\n        const [iv, authTag, ciphertext] = payload.split(':')\n\n        if (!iv || !authTag || !ciphertext) {\n            throw new Error('Invalid encrypted payload format')\n        }\n\n        const decipher = createDecipheriv(\n            this.algorithm,\n            this.getKey(),\n            Buffer.from(iv, 'base64url'),\n        )\n\n        decipher.setAuthTag(Buffer.from(authTag, 'base64url'))\n\n        const plaintext = Buffer.concat([\n            decipher.update(Buffer.from(ciphertext, 'base64url')),\n            decipher.final(),\n        ])\n\n        return plaintext.toString('utf8')\n    }\n}","import { Secret, TOTP } from 'otpauth'\nimport { compare, genSalt, hash } from 'bcryptjs'\n\nimport { env } from '../system'\n\nexport class Hash {\n  /**\n   * Hash a value using bcrypt\n   * \n   * @param value \n   * @returns \n   */\n  static async make (value: string): Promise<string> {\n    const salt = await genSalt(10)\n\n    return await hash(value, salt)\n  }\n\n  /**\n   * Verify a value against a hashed value\n   * \n   * @param value \n   * @param hashedValue \n   * @returns \n   */\n  static async verify (value: string, hashedValue: string): Promise<boolean> {\n    return await compare(value, hashedValue)\n  }\n\n  /**\n   * Generate a one-time password (OTP) using TOTP algorithm\n   * \n   * @param digits    The number of digits for the OTP, default is 6.\n   * @param label     A label to identify the OTP, can be an email or phone number.\n   * @param period    Interval of time for which a token is valid, in seconds.\n   * @returns \n   */\n  static otp (digits: number = 6, label: string = 'Alice', period: number = 30) {\n    return new TOTP({\n      label,\n      digits,\n      issuer: env('APP_NAME', 'Roseed'),\n      algorithm: 'SHA1',\n      period, // in seconds.\n      secret: 'US3WHSG7X5KAPV27VANWKQHF3SH3HULL',\n    })\n  }\n\n  static totp (secret: string, label: string, issuer: string = env('APP_NAME', 'Roseed'), period: number = 30) {\n    return new TOTP({\n      issuer,\n      label,\n      algorithm: 'SHA1',\n      digits: 6,\n      period,\n      secret: Secret.fromBase32(secret),\n    })\n  }\n}","export class Exception extends Error {\n    name: string\n\n    constructor(message?: string, options?: ErrorOptions) {\n        super(message, options)\n        this.name = 'Exception'\n    }\n}","import { Exception } from './Exception'\n\nexport class AppException extends Exception {\n    errors?: { [key: string]: string[] | string } | undefined = undefined\n\n    statusCode: number\n\n    constructor(message?: string, statusCode: number = 400, options?: ErrorOptions) {\n        super(message, options)\n        this.statusCode = statusCode\n    }\n}","import { AppException } from './AppException'\n\nexport class RequestException extends AppException {\n    statusCode: number\n\n    constructor(message?: string, statusCode: number = 400, options?: ErrorOptions) {\n        super(message, statusCode, options)\n        this.statusCode = statusCode\n    }\n\n    /**\n     * Asserts that a value is not null or undefined. \n     * \n     * @param value \n     * @param message \n     * @param code \n     * @throws {RequestException} Throws if the value is null or undefined.\n     */\n    static assertFound<T> (\n        value: T | null | undefined,\n        message: string,\n        code: number = 404,\n    ): asserts value is T {\n        if (!value) {\n            throw new RequestException(message, code)\n        }\n    }\n\n    /**\n     * Asserts that a value is not null or undefined. \n     * \n     * @param value \n     * @param message \n     * @param code \n     * @throws {RequestException} Throws if the value is null or undefined.\n     * @deprecated Use assertFound instead\n     */\n    static assertNotEmpty<T> (\n        value: T | null | undefined,\n        message: string,\n        code: number = 404,\n    ): asserts value is T {\n        return this.assertFound(value, message, code)\n    }\n\n    /**\n     * Asserts that a boolean condition is true. \n     * \n     * @param boolean \n     * @param message \n     * @param code \n     * @throws {RequestException} Throws if the boolean condition is true.\n     */\n    static abortIf<T> (\n        boolean: T,\n        message: string,\n        code?: number,\n    ): asserts  boolean is T {\n        if (boolean) {\n            throw new RequestException(message, code)\n        }\n    }\n}","import { getUserConfig, type Model, type ModelStatic } from 'arkormx'\nimport { importFile } from '../system'\nimport path from 'node:path'\nimport { Arkstack } from '@arkstack/contract'\nimport { RequestException } from '../Exceptions/RequestException'\n\nexport type AbstractModelConstructor<TModel = unknown> =\n    abstract new (attributes?: Record<string, unknown>) => TModel\n\nexport type ModelConstructor<TModel extends Model = Model> =\n    AbstractModelConstructor<TModel> &\n    Pick<ModelStatic<TModel>, keyof ModelStatic<TModel>>\n\n\nexport interface ModelRegistry { }\n\ntype ModelName = Extract<keyof ModelRegistry, string>\ntype ModelModule = Record<string, unknown> & {\n    default?: unknown;\n}\n\n/**\n * Determine the number of items to return per page based on the provided query parameters.\n * \n * @param query \n * @returns \n */\nexport const perPage = (query: { limit?: number; perPage?: number }) => {\n\n    const requestedPerPage = Number(query.limit ?? query.perPage ?? 15)\n\n    return Number.isFinite(requestedPerPage) && requestedPerPage > 0\n        ? Math.min(requestedPerPage, 50)\n        : 15\n}\n\n/**\n * Import an application model by name.\n *\n * Apps can augment `ModelRegistry` to make `getModel('User')` return `typeof User`.\n * Without a registry entry, pass the class type explicitly: `getModel<typeof User>('User')`.\n * \n * @param modelName \n */\nexport async function getModel<TName extends ModelName> (\n    modelName: TName\n): Promise<ModelRegistry[TName]>\nexport async function getModel<TModel extends AbstractModelConstructor = ModelConstructor> (\n    modelName: string\n): Promise<TModel>\nexport async function getModel (modelName: string) {\n    const resolveModelExport = (module: ModelModule | unknown, modelName: string) => {\n        if (!isModelModule(module)) {\n            return module\n        }\n\n        return module.default ?? module[modelName] ?? module\n    }\n\n    const isModelModule = (value: unknown): value is ModelModule => (\n        typeof value === 'object' && value !== null\n    )\n\n    const modelPath = getUserConfig().paths?.models || './src/models'\n    const modulePath = path.join(\n        path.isAbsolute(modelPath) ? modelPath : path.join(Arkstack.rootDir(), modelPath),\n        modelName\n    )\n    const module = await importFile<ModelModule | unknown>(modulePath)\n    const exportName = path.basename(modelName, path.extname(modelName))\n    const model = resolveModelExport(module, exportName)\n\n    if (typeof model !== 'function') {\n        throw new Error(`Model \"${modelName}\" not found`)\n    }\n\n    return model\n}\n\nexport const initializeGlobalContext = async (\n    { Request, Response, Session }: { Request?: any, Response?: any, Session?: any } = {}\n) => {\n    try {\n        const { Request: Req, Response: Res, Session: Ses } = await import('@arkstack/http')\n        Session ??= new Ses()\n        Request ??= new Req()\n        Response ??= new Res()\n    } catch {\n        Session ??= new class { }\n        Request ??= new class { }\n        Response ??= new class { }\n    }\n\n    globalThis.session ??= () => Session\n    globalThis.request ??= () => Request\n    globalThis.response ??= () => Response\n}\n\n/**\n * Thows to abort the current request\n * \n * @param message \n * @param code \n * @throws {RequestException}\n */\nexport const abort = (\n    message: string = 'Request Aborted',\n    code: number = 404,\n): void => {\n    RequestException.abortIf(true, message, code)\n}\n\n/**\n * Asserts that a boolean condition is true. \n * \n * @param boolean \n * @param message \n * @param code \n * @throws {RequestException} Throws if the boolean condition is true.\n */\nexport const abortIf = <T> (\n    boolean: T,\n    message: string = 'Request Aborted',\n    code: number = 404,\n): asserts  boolean is T => {\n    RequestException.abortIf(boolean, message, code)\n}\n\n/**\n * Asserts that a value is not null or undefined. \n * \n * @param value \n * @param message \n * @param code \n * @throws {RequestException} Throws if the value is null or undefined.\n */\nexport const assertFound = <T> (\n    value: T | null | undefined,\n    message: string,\n    code: number = 404,\n): asserts value is T => {\n    if (!value) {\n        throw new RequestException(message, code)\n    }\n}","/*\n**  Extracted from @traits-ts/core - Traits for TypeScript Classes\n**  Copyright (c) 2025 Dr. Ralf S. Engelschall <rse@engelschall.com>\n**  Licensed under MIT license <https://spdx.org/licenses/MIT>\n*/\n\nimport type { Model as ArkormModel } from 'arkormx'\n\n/**\n * CRC32 implementation in TypeScript, adapted from https://stackoverflow.com/a/18639999\n * Note: This implementation is not cryptographically secure and is only used for generating \n * unique identifiers for traits based on their factory function's string representation. \n */\nconst crcTable = [] as number[]\nfor (let n = 0; n < 256; n++) {\n    let c = n\n    for (let k = 0; k < 8; k++)\n        c = ((c & 1) ? (0xEDB88320 ^ (c >>> 1)) : (c >>> 1))\n    crcTable[n] = c\n}\nexport const crc32 = (str: string) => {\n    let crc = 0 ^ (-1)\n    for (let i = 0; i < str.length; i++)\n        crc = (crc >>> 8) ^ crcTable[(crc ^ str.charCodeAt(i)) & 0xFF]\n\n    return (crc ^ (-1)) >>> 0\n}\n\ntype ResolveTraitLike<T extends Trait | TypeFactory<Trait>> =\n    T extends TypeFactory<Trait>\n    ? ExtractFactory<ReturnType<T>>\n    : T extends Trait\n    ? ExtractFactory<T>\n    : unknown;\n\ntype Combine<T extends any[]> =\n    T extends [infer Head, ...infer Tail]\n    ? Head & Combine<Tail>\n    : object;\n\ntype MapClassesToPrototypes<T extends Array<(new () => any) & { prototype: any }>> = {\n    [K in keyof T]: T[K]['prototype'];\n}\n\ntype MapClassesToInstances<T extends Array<(new () => any) & { prototype: any }>> = {\n    [K in keyof T]: InstanceType<T[K]>;\n}\n\ntype CombineClasses<T extends Array<(new () => any) & { prototype: any }>> =\n    (new () => Combine<MapClassesToInstances<T>>) & { prototype: Combine<MapClassesToPrototypes<T>> };\n\ntype ResolveTraitLikeArray<T extends Array<Trait | TypeFactory<Trait>>> = CombineClasses<{\n    [K in keyof T]: ResolveTraitLike<T[K]>;\n}>;\n\n/**\n * utility type and function: constructor (function)\n */\ntype Cons<T = any> =\n    new (...args: any[]) => T\nconst isCons =\n    <T = any>\n        (fn: unknown): fn is Cons<T> =>\n        typeof fn === 'function' && !!fn.prototype && !!fn.prototype.constructor\n\ntype ArkormModelCons<T extends ArkormModel = ArkormModel> =\n    abstract new (...args: any[]) => T\n\ntype DirectCons<T = any> =\n    Cons<T> | ArkormModelCons<ArkormModel>\n\ntype DirectBase =\n    DirectCons | ArkormModel\n\nconst isArkormModelInstance =\n    (value: unknown): value is ArkormModel =>\n        typeof value === 'object' &&\n        value !== null &&\n        typeof (value as { constructor?: unknown }).constructor === 'function' &&\n        typeof (value as { getAttribute?: unknown }).getAttribute === 'function' &&\n        typeof (value as { setAttribute?: unknown }).setAttribute === 'function'\n\n/**\n * utility type and function: constructor factory (function)\n */\ntype ConsFactory<T extends Cons = Cons, B = any> =\n    (base: B) => T\n\n/**\n * utility type and function: type factory (function)\n */\ntype TypeFactory<T = any> =\n    () => T\nconst isTypeFactory =\n    <T = any>\n        (fn: unknown): fn is TypeFactory<T> =>\n        typeof fn === 'function' && !fn.prototype && fn.length === 0\n\n/**\n * utility type: map an object type into a bare properties type\n */\ntype Explode<T = any> =\n    { [P in keyof T]: T[P] }\n\n/**\n * utility type: convert two arrays of types into an array of union types\n */\ntype MixParams<T1 extends any[], T2 extends any[]> =\n    T1 extends [] ? (\n        T2 extends [] ? [] : T2\n    ) : (\n        T2 extends [] ? T1 : (\n            T1 extends [infer H1, ...infer R1] ? (\n                T2 extends [infer H2, ...infer R2] ?\n                [H1 & H2, ...MixParams<R1, R2>]\n                : []\n            ) : []\n        )\n    )\n\n/**\n * API: trait type\n */\ntype TraitDefTypeT = ConsFactory<Cons>\ntype TraitDefTypeST = (Trait | TypeFactory<Trait>)[] | undefined\nexport type Trait<\n    T extends TraitDefTypeT = TraitDefTypeT,\n    ST extends TraitDefTypeST = TraitDefTypeST\n> = {\n    id: number  /* unique id (primary,   for hasTrait)      */\n    symbol: symbol  /* unique id (secondary, currently unused)  */\n    factory: T\n    superTraits: ST\n}\n\n/**\n * API: generate trait (regular variant)\n * \n * @param factory \n */\nexport function trait<\n    T extends ConsFactory<Cons>\n> (factory: T): Trait<T, undefined>\n\n/**\n * API: generate trait (super-trait variant)\n * \n * @param superTraits \n * @param factory \n */\nexport function trait<\n    const ST extends (Trait | TypeFactory<Trait>)[],\n    T extends ConsFactory<Cons, ResolveTraitLikeArray<ST>>\n> (superTraits: ST, factory: T): Trait<T, ST>\n\n/**\n * API: generate trait (technical implementation)\n * \n * @param args \n */\nexport function trait (...args: any[]): Trait<any, any> {\n    const factory: ConsFactory<any, any> = (args.length === 2 ? args[1] : args[0])\n    const superTraits: (Trait | TypeFactory<Trait>)[] = (args.length === 2 ? args[0] : undefined)\n\n    return {\n        id: crc32(factory.toString()),\n        symbol: Symbol('trait'),\n        factory,\n        superTraits\n    }\n}\n\n/**\n * utility types: extract factory from a trait\n */\ntype ExtractFactory<\n    T extends Trait\n> =\n    T extends Trait<\n        ConsFactory<infer C>,\n        TraitDefTypeST\n    > ? C : never\n\n/**\n * utility types: extract supertraits from a trait\n */\ntype ExtractSuperTrait<\n    T extends Trait\n> =\n    T extends Trait<\n        TraitDefTypeT,\n        infer ST extends TraitDefTypeST\n    > ? ST : never\n\n/**\n * utility type: derive type constructor: merge two constructors\n */\ntype DeriveTraitsConsConsMerge<\n    A extends Cons,\n    B extends Cons\n> =\n    A extends (new (...args: infer ArgsA) => infer RetA) ? (\n        B extends (new (...args: infer ArgsB) => infer RetB) ? (\n            new (...args: MixParams<ArgsA, ArgsB>) => RetA & RetB\n        ) : never\n    ) : never\n\n/**\n * utility type: derive type constructor: extract plain constructor\n */\ntype DeriveTraitsConsCons<\n    T extends DirectCons\n> =\n    new (...args: ConstructorParameters<T>) => InstanceType<T>\n\ntype DeriveTraitsConsDirectBase<\n    T extends DirectBase\n> =\n    T extends ArkormModel ? new (...args: any[]) => T :\n    T extends DirectCons ? DeriveTraitsConsCons<T> :\n    never\n\n/**\n * utility type: derive type constructor: from trait parts\n */\ntype DeriveTraitsConsTraitParts<\n    C extends Cons,\n    ST extends ((Trait | TypeFactory<Trait>)[] | undefined)\n> =\n    ST extends undefined ? DeriveTraitsConsCons<C> :\n    ST extends [] ? DeriveTraitsConsCons<C> :\n    DeriveTraitsConsConsMerge<\n        DeriveTraitsConsCons<C>,\n        DeriveTraitsConsAll<ST>> /* RECURSION */\n\n/**\n * utility type: derive type constructor: from single trait\n */\ntype DeriveTraitsConsTrait<\n    T extends Trait\n> =\n    DeriveTraitsConsTraitParts<\n        ExtractFactory<T>,\n        ExtractSuperTrait<T>>\n\n/**\n * utility type: derive type constructor: from single trait or trait factory\n */\ntype DeriveTraitsConsOne<\n    T extends (Trait | TypeFactory<Trait>)\n> =\n    T extends Trait ? DeriveTraitsConsTrait<T> :\n    T extends TypeFactory<Trait> ? DeriveTraitsConsTrait<ReturnType<T>> :\n    never\n\n/**\n * utility type: derive type constructor: from one or more traits or trait factories\n */\ntype DeriveTraitsConsAll<\n    T extends (((Trait | TypeFactory<Trait>)[] | [...(Trait | TypeFactory<Trait>)[], DirectBase]) | undefined)\n> =\n    T extends [infer Only extends DirectBase] ? DeriveTraitsConsDirectBase<Only> :\n    T extends [...infer Others extends (Trait | TypeFactory<Trait>)[], infer Last extends DirectBase] ? (\n        Others extends [] ? DeriveTraitsConsDirectBase<Last> :\n        DeriveTraitsConsConsMerge<\n            DeriveTraitsConsAll<Others>, /* RECURSION */\n            DeriveTraitsConsDirectBase<Last>>\n    ) :\n    T extends (Trait | TypeFactory<Trait>)[] ? (\n        T extends [infer First extends (Trait | TypeFactory<Trait>)] ? (\n            DeriveTraitsConsOne<First>\n        ) : (\n            T extends [\n                infer First extends (Trait | TypeFactory<Trait>),\n                ...infer Rest extends (Trait | TypeFactory<Trait>)[]] ? (\n                DeriveTraitsConsConsMerge<\n                    DeriveTraitsConsOne<First>,\n                    DeriveTraitsConsAll<Rest>> /* RECURSION */\n            ) : never\n        )\n    ) : never\n\n/**\n * utility type: derive type constructor\n */\ntype DeriveTraitsCons<\n    T extends ((Trait | TypeFactory<Trait>)[] | [...(Trait | TypeFactory<Trait>)[], DirectBase])\n> =\n    DeriveTraitsConsAll<T>\n\n/**\n * utility type: derive type statics: merge two objects with statics\n */\ntype DeriveTraitsStatsConsMerge<\n    T1 extends object,\n    T2 extends object\n> =\n    T1 & T2\n\n/**\n * utility type: derive type statics: extract plain statics\n */\ntype DeriveTraitsStatsCons<\n    T extends DirectCons\n> =\n    Explode<T>\n\ntype DeriveTraitsStatsDirectBase<\n    T extends DirectBase\n> =\n    T extends ArkormModel ? object :\n    T extends DirectCons ? DeriveTraitsStatsCons<T> :\n    never\n\n/**\n * utility type: derive type statics: from trait parts\n */\ntype DeriveTraitsStatsTraitParts<\n    C extends Cons,\n    ST extends ((Trait | TypeFactory<Trait>)[] | undefined)\n> =\n    ST extends undefined ? DeriveTraitsStatsCons<C> :\n    ST extends [] ? DeriveTraitsStatsCons<C> :\n    DeriveTraitsStatsConsMerge<\n        DeriveTraitsStatsCons<C>,\n        DeriveTraitsStatsAll<ST>> /* RECURSION */\n\n/**\n * utility type: derive type statics: from single trait\n */\ntype DeriveTraitsStatsTrait<\n    T extends Trait\n> =\n    DeriveTraitsStatsTraitParts<\n        ExtractFactory<T>,\n        ExtractSuperTrait<T>>\n\n/**\n * utility type: derive type statics: from single trait or trait factory\n */\ntype DeriveTraitsStatsOne<\n    T extends (Trait | TypeFactory<Trait>)\n> =\n    T extends Trait ? DeriveTraitsStatsTrait<T> :\n    T extends TypeFactory<Trait> ? DeriveTraitsStatsTrait<ReturnType<T>> :\n    never\n\n/**\n * utility type: derive type statics: from one or more traits or trait factories\n */\ntype DeriveTraitsStatsAll<\n    T extends (((Trait | TypeFactory<Trait>)[] | [...(Trait | TypeFactory<Trait>)[], DirectBase]) | undefined)\n> =\n    T extends [infer Only extends DirectBase] ? DeriveTraitsStatsDirectBase<Only> :\n    T extends [...infer Others extends (Trait | TypeFactory<Trait>)[], infer Last extends DirectBase] ? (\n        Others extends [] ? DeriveTraitsStatsDirectBase<Last> :\n        DeriveTraitsStatsConsMerge<\n            DeriveTraitsStatsAll<Others>, /* RECURSION */\n            DeriveTraitsStatsDirectBase<Last>>\n    ) :\n    T extends (Trait | TypeFactory<Trait>)[] ? (\n        T extends [infer First extends (Trait | TypeFactory<Trait>)] ? (\n            DeriveTraitsStatsOne<First>\n        ) : (\n            T extends [\n                infer First extends (Trait | TypeFactory<Trait>),\n                ...infer Rest extends (Trait | TypeFactory<Trait>)[]] ? (\n                DeriveTraitsStatsConsMerge<\n                    DeriveTraitsStatsOne<First>,\n                    DeriveTraitsStatsAll<Rest>> /* RECURSION */\n            ) : never\n        )\n    ) : never\n\n/**\n * utility type: derive type statics\n */\ntype DeriveTraitsStats<\n    T extends ((Trait | TypeFactory<Trait>)[] | [...(Trait | TypeFactory<Trait>)[], DirectBase])\n> =\n    DeriveTraitsStatsAll<T>\n\n/**\n * utility type: derive type from one or more traits or trait type factories\n */\ntype DeriveTraits<\n    T extends ((Trait | TypeFactory<Trait>)[] | [...(Trait | TypeFactory<Trait>)[], DirectBase])\n> =\n    DeriveTraitsCons<T> &\n    DeriveTraitsStats<T>\n\n/**\n * utility function: add an additional invisible property to an object\n * \n * @param cons \n * @param field \n * @param value \n * @returns \n */\nconst extendProperties =\n    (cons: Cons, field: string | symbol, value: any) =>\n        Object.defineProperty(cons, field, { value, enumerable: false, writable: false })\n\n/**\n * utility function: get raw trait\n * \n * @param x \n * @returns \n */\nconst rawTrait = (x: (Trait | TypeFactory<Trait>)) =>\n    isTypeFactory(x) ? x() : x\n\n/**\n * utility function: derive a trait\n * \n * @param trait$ \n * @param baseClz \n * @param derived \n * @returns \n */\nconst deriveTrait = (\n    trait$: Trait | TypeFactory<Trait>,\n    baseClz: Cons<any>,\n    derived: Map<number, boolean>\n) => {\n    /*  get real trait  */\n    const trait = rawTrait(trait$)\n\n    /*  start with base class  */\n    let clz = baseClz\n\n    /*  in case we still have not derived this trait...  */\n    if (!derived.has(trait.id)) {\n        derived.set(trait.id, true)\n\n        /*  iterate over all of its super traits  */\n        if (trait.superTraits !== undefined)\n            for (const superTrait of reverseTraitList(trait.superTraits))\n                clz = deriveTrait(superTrait, clz, derived) /*  RECURSION  */\n\n        /*  derive this trait  */\n        clz = trait.factory(clz)\n        extendProperties(clz, 'id', crc32(trait.factory.toString()))\n        extendProperties(clz, trait.symbol, true)\n    }\n\n    return clz\n}\n\n/**\n * utility function: get reversed trait list\n * \n * @param traits \n * @returns \n */\nconst reverseTraitList = (traits: (Trait | TypeFactory<Trait>)[]) =>\n    traits.slice().reverse() as (Trait | TypeFactory<Trait>)[]\n\n/**\n * API: derive a class from one or more traits or trait type factories\n * \n * @param traits \n * @returns \n */\nexport function use\n    <T extends (\n        [Trait | TypeFactory<Trait>, ...(Trait | TypeFactory<Trait>)[]] |\n        [...(Trait | TypeFactory<Trait>)[], DirectBase]\n    )>\n    (...traits: T): DeriveTraits<T> {\n    /*  run-time sanity check  */\n    if (traits.length === 0)\n        throw new Error('invalid number of parameters (expected one or more traits)')\n\n    /*  determine the base class (clz) and the list of traits (lot)  */\n    let clz: Cons<any>\n    let lot: (Trait | TypeFactory<Trait>)[]\n    const last = traits[traits.length - 1]\n    if (isCons(last) && !isTypeFactory(last)) {\n        /*  case 1: with trailing regular class  */\n        clz = last\n        lot = traits.slice(0, -1) as (Trait | TypeFactory<Trait>)[]\n    } else if (isArkormModelInstance(last)) {\n        /*  case 2: with trailing Arkorm model instance  */\n        clz = last.constructor as Cons<any>\n        lot = traits.slice(0, -1) as (Trait | TypeFactory<Trait>)[]\n    } else {\n        /*  case 3: just regular traits or trait type factories  */\n        clz = class ROOT { }\n        lot = traits as (Trait | TypeFactory<Trait>)[]\n    }\n\n    /*  track already derived traits  */\n    const derived = new Map<number, boolean>()\n\n    /*  iterate over all traits  */\n    for (const trait of reverseTraitList(lot))\n        clz = deriveTrait(trait, clz, derived)\n\n    return clz as DeriveTraits<T>\n}\n\n/**\n * internal type: implements trait type\n */\ntype DerivedType<T extends Trait> =\n    InstanceType<ExtractFactory<T>>\n\n/**\n * internal type: implements trait type or trait type factory\n */\nexport type Derived<T extends (Trait | TypeFactory<Trait> | Cons)> =\n    T extends TypeFactory<Trait> ? DerivedType<ReturnType<T>> :\n    T extends Trait ? DerivedType<T> :\n    T extends Cons ? T :\n    never\n\n/**\n * API: type guard for checking whether class instance is derived from a trait\n * \n * @param instance \n * @param trait \n * @returns \n */\nexport function uses\n    <T extends (Trait | TypeFactory<Trait> | Cons)>\n    (instance: unknown, trait: T): instance is Derived<T> {\n    /*  ensure the class instance is really an object  */\n    if (typeof instance !== 'object' || instance === null)\n        return false\n    let obj = instance\n\n    /*  special case: regular class  */\n    if (isCons(trait) && !isTypeFactory(trait))\n        return (instance instanceof trait)\n\n    /*  regular case: trait or trait type factory...  */\n    const t = (isTypeFactory(trait) ? trait() : trait) as Trait\n    const idTrait = t['id']\n    while (obj) {\n        if (Object.hasOwn(obj, 'constructor')) {\n            const id = ((obj.constructor as any)['id'] as number) ?? 0\n            if (id === idTrait)\n                return true\n        }\n        obj = Object.getPrototypeOf(obj)\n    }\n\n    return false\n}\n"],"mappings":"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"}