@arkstack/common 0.8.0 → 0.9.0

package/dist/index.d.ts

@@ -1,6 +1,5 @@
 /// <reference path="./app.d.ts" />
 import { a as initializeGlobalContext, c as Encryption, i as getModel, n as ModelConstructor, o as perPage, r as ModelRegistry, s as Hash, t as AbstractModelConstructor } from "./helpers-CCnLLifY.js";
-import { DotPath } from "@h3ravel/support";
 import pino from "pino";
 import { ChalkInstance } from "chalk";
 
@@ -62,9 +61,15 @@ declare class Logger {
 }
 //#endregion
 //#region src/types.d.ts
+interface ConfigRegistry {}
+interface EnvRegistry {}
+type UnionToIntersection<U> = (U extends any ? (x: U) => void : never) extends ((x: infer I) => void) ? I : never;
+type MergedConfig<X> = UnionToIntersection<X>;
+type Primitive = string | number | boolean | null | undefined | ((e: any) => any);
 type LoggerChalk = keyof ChalkInstance | ChalkInstance | (keyof ChalkInstance)[];
 type LoggerParseSignature = [string, LoggerChalk][];
 type DotPathValue<T, P extends string> = P extends `${infer Head}.${infer Tail}` ? Head extends keyof T ? DotPathValue<T[Head], Tail> : never : P extends keyof T ? T[P] : never;
+type DotPath<T> = T extends Primitive ? never : T extends any[] ? never : { [K in keyof T & string]: T[K] extends Primitive ? `${K}` : T[K] extends any[] ? `${K}` : `${K}` | `${K}.${DotPath<T[K]>}` }[keyof T & string];
 interface LoggerLog {
   (): typeof Logger;
   <L extends boolean>(config: string, joiner: LoggerChalk, log?: L, sc?: LoggerChalk): L extends true ? void : string;
@@ -74,10 +79,11 @@ interface LoggerLog {
 interface GlobalEnv {
   <X = string, Y = undefined | X>(env: string, defaultValue?: Y): Y extends undefined ? X : Y;
 }
+type ConfigShape = keyof ConfigRegistry extends never ? Record<string, any> : ConfigRegistry;
 interface GlobalConfig {
-  <X extends Record<string, any>>(): X;
-  <X extends Record<string, any>, P extends DotPath<X>>(key: P): DotPathValue<X, P>;
-  <X extends Record<string, any>, P extends DotPath<X>, D>(key: P, defaultValue: D): DotPathValue<X, P> | D;
+  <X extends ConfigShape>(): X;
+  <X extends ConfigShape, P extends DotPath<X>>(key: P): DotPathValue<X, P>;
+  <X extends ConfigShape, P extends DotPath<X>, D>(key: P, defaultValue: D): DotPathValue<X, P> | D;
 }
 type ArkstackErrorShape = Error & {
   cause?: unknown;
@@ -170,5 +176,5 @@ declare class Hook {
   static clear: () => void;
 }
 //#endregion
-export { AbstractModelConstructor, AppException, ArkstackErrorPayload, ArkstackErrorShape, DotPathValue, Encryption, ErrorHandler, Exception, GlobalConfig, GlobalEnv, Hash, Hook, IHook, Logger, LoggerChalk, LoggerLog, LoggerParseSignature, ModelConstructor, ModelRegistry, RequestException, appUrl, bindGracefulShutdown, bootWithDetectedPort, config, createErrorPayload, env, getErrorLogger, getModel, getPrimaryError, getValidationErrors, importFile, initializeGlobalContext, isModelNotFoundError, isValidationError, loadPrototypes, logUnhandledError, nodeEnv, normalizeStatusCode, outputDir, perPage, renderError, serializeError, shouldHideStack, shouldLogError, toErrorShape };
+export { AbstractModelConstructor, AppException, ArkstackErrorPayload, ArkstackErrorShape, ConfigRegistry, ConfigShape, DotPath, DotPathValue, Encryption, EnvRegistry, ErrorHandler, Exception, GlobalConfig, GlobalEnv, Hash, Hook, IHook, Logger, LoggerChalk, LoggerLog, LoggerParseSignature, MergedConfig, ModelConstructor, ModelRegistry, Primitive, RequestException, UnionToIntersection, appUrl, bindGracefulShutdown, bootWithDetectedPort, config, createErrorPayload, env, getErrorLogger, getModel, getPrimaryError, getValidationErrors, importFile, initializeGlobalContext, isModelNotFoundError, isValidationError, loadPrototypes, logUnhandledError, nodeEnv, normalizeStatusCode, outputDir, perPage, renderError, serializeError, shouldHideStack, shouldLogError, toErrorShape };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,4 +1,4 @@
-import { a as getModel, c as Hash, d as config, f as env, h as outputDir, l as Encryption, m as nodeEnv, o as initializeGlobalContext, p as importFile, s as perPage, u as appUrl } from "./utils-L4cz5fWz.js";
+import { a as getModel, c as Hash, d as config, f as env, h as outputDir, l as Encryption, m as nodeEnv, o as initializeGlobalContext, p as importFile, s as perPage, u as appUrl } from "./utils-WvvQWSar.js";
 import { str } from "@h3ravel/support";
 import path from "node:path";
 import { detect } from "detect-port";

package/dist/utils/index.js

@@ -1,2 +1,2 @@
-import { a as getModel, c as Hash, i as uses, l as Encryption, n as trait, o as initializeGlobalContext, r as use, s as perPage, t as crc32 } from "../utils-L4cz5fWz.js";
+import { a as getModel, c as Hash, i as uses, l as Encryption, n as trait, o as initializeGlobalContext, r as use, s as perPage, t as crc32 } from "../utils-WvvQWSar.js";
 export { Encryption, Hash, crc32, getModel, initializeGlobalContext, perPage, trait, use, uses };

package/dist/{utils-L4cz5fWz.js → utils-WvvQWSar.js}

@@ -58,20 +58,21 @@ const appUrl = (link) => {
 };
 /**
 * Gets the application configuration.
-* 
+*
 * @param key             The configuration key to retrieve.
 * @param defaultValue    The default value to return if the key is not found.
 * @returns               The configuration value.
 */
 const config = (key, defaultValue) => {
+	if (typeof globalThis.env === "undefined") globalThis.env = (key, def) => key ? process.env[key] ?? def : process.env;
 	const dist = path.relative(process.cwd(), outputDir());
 	const require = createRequire(import.meta.url);
 	const config = readdirSync(path.join(process.cwd(), `${dist}/config`), { withFileTypes: true }).filter((file) => {
-		if (file.name.includes("middleware") && globalThis.arkctx.runtime === "CLI") return false;
+		if (file.name.includes("middleware") && globalThis.arkctx?.runtime === "CLI") return false;
 		return file.isFile() && (file.name.endsWith(".js") || file.name.endsWith(".ts"));
 	}).reduce((configs, file) => {
 		const configName = path.basename(file.name, path.extname(file.name));
-		configs[configName] = require(path.join(file.parentPath, file.name)).default(globalThis.app());
+		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);
@@ -79,8 +80,8 @@ const config = (key, defaultValue) => {
 };
 /**
 * Gets the current Node environment (development or production).
-* 
-* @returns 
+*
+* @returns
 */
 const nodeEnv = () => {
 	let envValue = env("NODE_ENV", "development");
@@ -89,9 +90,9 @@ const nodeEnv = () => {
 };
 /**
 * Gets the output directory for the application based on the current environment.
-* 
+*
 * @param cwd  The current working directory (optional, defaults to process.cwd()).
-* @returns 
+* @returns
 */
 const outputDir = (cwd = process.cwd()) => {
 	const NODE_ENV = nodeEnv();
@@ -355,4 +356,4 @@ function uses(instance, trait) {
 //#endregion
 export { getModel as a, Hash as c, config as d, env as f, outputDir as h, uses as i, Encryption as l, nodeEnv as m, trait as n, initializeGlobalContext as o, importFile as p, use as r, perPage as s, crc32 as t, appUrl as u };
 
-//# sourceMappingURL=utils-L4cz5fWz.js.map
+//# sourceMappingURL=utils-WvvQWSar.js.map

package/dist/utils-WvvQWSar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils-WvvQWSar.js","names":[],"sources":["../src/system.ts","../src/utils/encryption.ts","../src/utils/hash.ts","../src/utils/helpers.ts","../src/utils/traits.ts"],"sourcesContent":["import { ConfigRegistry, DotPath, GlobalConfig, GlobalEnv } from './types'\n\nimport { Obj } from '@h3ravel/support'\nimport { createJiti } from 'jiti'\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    const dist = path.relative(process.cwd(), outputDir())\n    const require = createRequire(import.meta.url)\n\n    const files = readdirSync(path.join(process.cwd(), `${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\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 process.cwd()).\n * @returns\n */\nexport const outputDir = (cwd = process.cwd()) => {\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\nexport const importFile = async <T = unknown> (filePath: string): Promise<T> => {\n    const resolvedPath = resolve(filePath)\n    const jiti = createJiti(pathToFileURL(resolvedPath).href, {\n        interopDefault: false,\n        tsconfigPaths: true,\n    })\n\n    return await jiti.import<T>(resolvedPath)\n}\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}","import { getUserConfig, type Model, type ModelStatic } from 'arkormx'\nimport { importFile } from '../system'\nimport path from 'node:path'\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// eslint-disable-next-line @typescript-eslint/no-empty-object-type\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(process.cwd(), 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**  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.8.0",
+  "version": "0.9.0",
   "type": "module",
   "description": "Core utilities, primitives, and shared infrastructure for the Arkstack ecosystem.",
   "homepage": "https://arkstack.toneflix.net",

package/dist/utils-L4cz5fWz.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils-L4cz5fWz.js","names":[],"sources":["../src/system.ts","../src/utils/encryption.ts","../src/utils/hash.ts","../src/utils/helpers.ts","../src/utils/traits.ts"],"sourcesContent":["import { DotPath, Obj } from '@h3ravel/support'\nimport { GlobalConfig, GlobalEnv } from './types'\n\nimport { createJiti } from 'jiti'\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 = 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 (!isNaN(Number(val)) && typeof val !== 'boolean' && typeof val !== 'undefined' && val !== '') {\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 = <X extends Record<string, any>, P extends DotPath<X> | undefined = undefined> (\n    key?: P,\n    defaultValue?: any\n) => {\n    const dist = path.relative(process.cwd(), outputDir())\n    const require = createRequire(import.meta.url)\n\n    const files = readdirSync(path.join(process.cwd(), `${dist}/config`), { withFileTypes: true })\n        .filter(file => {\n            if (file.name.includes('middleware') && globalThis.arkctx.runtime === 'CLI') return false\n\n            return file.isFile() && (file.name.endsWith('.js') || file.name.endsWith('.ts'))\n        })\n\n    const config = files.reduce((configs, file) => {\n        const configName = path.basename(file.name, path.extname(file.name))\n\n        configs[configName] = require(path.join(file.parentPath, file.name))\n            .default((globalThis as any).app())\n\n        return configs\n    }, {} as Record<string, any>) as X\n\n\n    if (key) {\n        return Obj.get(config, key, 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 process.cwd()).\n * @returns \n */\nexport const outputDir = (cwd = process.cwd()) => {\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\nexport const importFile = async <T = unknown> (filePath: string): Promise<T> => {\n    const resolvedPath = resolve(filePath)\n    const jiti = createJiti(pathToFileURL(resolvedPath).href, {\n        interopDefault: false,\n        tsconfigPaths: true,\n    })\n\n    return await jiti.import<T>(resolvedPath)\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}","import { getUserConfig, type Model, type ModelStatic } from 'arkormx'\nimport { importFile } from '../system'\nimport path from 'node:path'\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// eslint-disable-next-line @typescript-eslint/no-empty-object-type\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(process.cwd(), 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**  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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"}