@arkstack/common 0.18.9 → 0.18.11

package/dist/{helpers-DgIgQLDu.d.ts → helpers-CWLBYxS-.d.ts}

@@ -2,8 +2,8 @@ import { ChannelOptions, Cipher, CipherOptions, Codec, DeriveOptions, DerivedKey
 import { NodeCipher } from "@arkstack/encryption/node";
 import { JitiOptions, JitiResolveOptions } from "jiti";
 import { TOTP } from "otpauth";
-import { Model, ModelStatic, RegisteredModelClass, RegisteredModelName, RelatedModelClass } from "arkormx";
 import { ChalkInstance } from "chalk";
+import { Model, ModelStatic, RegisteredModelClass, RegisteredModelName, RelatedModelClass } from "arkormx";
 //#region src/Logger.d.ts
 declare class Console {
   static log: (...args: any[]) => string | void;
@@ -41,6 +41,22 @@ declare class Logger {
    */
   static twoColumnDetail(name: string, value: string, log?: true, spacer?: string): void;
   static twoColumnDetail(name: string, value: string, log?: false, spacer?: string): [string, string, string];
+  /**
+   * Convert absolute paths under current working directory into relative display paths.
+   *
+   * @param filePath
+   * @returns
+   */
+  static formatPathForLog(filePath: string): string;
+  /**
+   * Utility to format a value for logging, converting absolute paths under current
+   * working directory into relative display paths.
+   *
+   * @param name
+   * @param value
+   * @returns
+   */
+  static splitLogger(name: string, value: string): string;
   /**
    * Logs the message in two columns
    *
@@ -583,6 +599,15 @@ declare class Hash {
 type AbstractModelConstructor<TModel = unknown> = abstract new (attributes?: Record<string, unknown>) => TModel;
 type ModelConstructor<TModel extends Model = Model> = AbstractModelConstructor<TModel> & Pick<ModelStatic<TModel>, keyof ModelStatic<TModel>>;
 interface ModelRegistry {}
+type ModelResolver = (modelName: string) => RelatedModelClass;
+/**
+ * Configure the synchronous model resolver used by {@link getModel}.
+ *
+ * Database integrations should call this during module initialization. Keeping
+ * the resolver injectable lets `@arkstack/common` remain usable without loading
+ * a specific ORM at runtime.
+ */
+declare const setModelResolver: (resolver: ModelResolver) => void;
 /**
  * Checks and asserts if target is a class
  *
@@ -630,16 +655,14 @@ declare const resolvePagination: (query: {
 /**
  * Synchronously resolve an application model by name.
  *
- * Registered models are returned first. If a model has not been registered yet,
- * ArkORM loads it from the configured models paths, registers it, and returns
- * the matching constructor.
+ * The configured database integration resolves and, when supported, loads the
+ * requested model.
  *
  * @param modelName
- * @alias {@link getArkormxModel}
  * @returns
  */
-declare function getModel$1<TName extends RegisteredModelName>(modelName: TName): RegisteredModelClass<TName>;
-declare function getModel$1<TModel extends RelatedModelClass = RelatedModelClass>(modelName: string): TModel;
+declare function getModel<TName extends RegisteredModelName>(modelName: TName): RegisteredModelClass<TName>;
+declare function getModel<TModel extends RelatedModelClass = RelatedModelClass>(modelName: string): TModel;
 /**
  * Synchronously import an application model by name.
  *
@@ -647,8 +670,7 @@ declare function getModel$1<TModel extends RelatedModelClass = RelatedModelClass
  * Without a registry entry, pass the class type explicitly: `getModel<typeof User>('User')`.
  *
  * @param modelName
- * @alias {@link getArkormxModel}
- * @deprecated 0.17.27 - Use {@link getModel} or {@link getArkormxModel}
+ * @deprecated 0.17.27 - Use {@link getModel}
  */
 declare function getModelSync<TName extends RegisteredModelName>(modelName: TName): RegisteredModelClass<TName>;
 declare function getModelSync<TModel extends RelatedModelClass = RelatedModelClass>(modelName: string): TModel;
@@ -684,4 +706,4 @@ declare const abortIf: <T>(boolean: T, message?: string, code?: number) => asser
  */
 declare const assertFound: <T>(value: T | null | undefined, message: string, code?: number) => asserts value is T;
 //#endregion
-export { HookRegistry as $, SerializedKeyPair as A, DotPathValue as B, FingerprintOptions as C, NodeCipher as D, Keys as E, Choices as F, FileImporter as G, EnvLookup as H, Concrete as I, HookArgs as J, GlobalConfig as K, ConfigRegistry as L, ArkstackErrorPayload as M, ArkstackErrorShape as N, SealedBox as O, Choice as P, HookPositions as Q, ConfigShape as R, EncryptionKey as S, KeyPair as T, EnvRegistry as U, EnvKey as V, EnvReturn as W, HookName as X, HookFor as Y, HookPos as Z, CipherOptions as _, abortIf as a, PaginationOptions as at, DerivedKey as b, getModelSync as c, PublishEntry as ct, normalizePositiveInteger as d, UnionToIntersection as dt, IHook as et, perPage as f, Logger as ft, Cipher as g, ChannelOptions as h, abort as i, MergedConfig as it, AppConfig as j, SecureChannel as k, initializeGlobalContext as l, PublishFilter as lt, Hash as m, ModelConstructor as n, LoggerLog as nt, assertFound as o, Primitive as ot, resolvePagination as p, GlobalEnv as q, ModelRegistry as r, LoggerParseSignature as rt, getModel$1 as s, PublishConfirmation as st, AbstractModelConstructor as t, LoggerChalk as tt, isClass as u, PublishGroup as ut, Codec as v, KeyInput as w, Encryption as x, DeriveOptions as y, DotPath as z };
+export { HookPos as $, SealedBox as A, ConfigShape as B, Encryption as C, KeyPair as D, KeyInput as E, ArkstackErrorShape as F, EnvRegistry as G, DotPathValue as H, Choice as I, GlobalConfig as J, EnvReturn as K, Choices as L, SerializedKeyPair as M, AppConfig as N, Keys as O, ArkstackErrorPayload as P, HookName as Q, Concrete as R, DerivedKey as S, FingerprintOptions as T, EnvKey as U, DotPath as V, EnvLookup as W, HookArgs as X, GlobalEnv as Y, HookFor as Z, ChannelOptions as _, abort as a, LoggerParseSignature as at, Codec as b, getModel as c, Primitive as ct, isClass as d, PublishFilter as dt, HookPositions as et, normalizePositiveInteger as f, PublishGroup as ft, Hash as g, setModelResolver as h, ModelResolver as i, LoggerLog as it, SecureChannel as j, NodeCipher as k, getModelSync as l, PublishConfirmation as lt, resolvePagination as m, Logger as mt, ModelConstructor as n, IHook as nt, abortIf as o, MergedConfig as ot, perPage as p, UnionToIntersection as pt, FileImporter as q, ModelRegistry as r, LoggerChalk as rt, assertFound as s, PaginationOptions as st, AbstractModelConstructor as t, HookRegistry as tt, initializeGlobalContext as u, PublishEntry as ut, Cipher as v, EncryptionKey as w, DeriveOptions as x, CipherOptions as y, ConfigRegistry as z };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /// <reference path="./app.d.ts" />
-import { $ as HookRegistry, A as SerializedKeyPair, B as DotPathValue, C as FingerprintOptions, D as NodeCipher, E as Keys, F as Choices, G as FileImporter, H as EnvLookup, I as Concrete, J as HookArgs, K as GlobalConfig, L as ConfigRegistry, M as ArkstackErrorPayload, N as ArkstackErrorShape, O as SealedBox, P as Choice, Q as HookPositions, R as ConfigShape, S as EncryptionKey, T as KeyPair, U as EnvRegistry, V as EnvKey, W as EnvReturn, X as HookName, Y as HookFor, Z as HookPos, _ as CipherOptions, a as abortIf, at as PaginationOptions, b as DerivedKey, c as getModelSync, ct as PublishEntry, d as normalizePositiveInteger, dt as UnionToIntersection, et as IHook, f as perPage, ft as Logger, g as Cipher, h as ChannelOptions, i as abort, it as MergedConfig, j as AppConfig, k as SecureChannel, l as initializeGlobalContext, lt as PublishFilter, m as Hash, n as ModelConstructor, nt as LoggerLog, o as assertFound, ot as Primitive, p as resolvePagination, q as GlobalEnv, r as ModelRegistry, rt as LoggerParseSignature, s as getModel, st as PublishConfirmation, t as AbstractModelConstructor, tt as LoggerChalk, u as isClass, ut as PublishGroup, v as Codec, w as KeyInput, x as Encryption, y as DeriveOptions, z as DotPath } from "./helpers-DgIgQLDu.js";
+import { $ as HookPos, A as SealedBox, B as ConfigShape, C as Encryption, D as KeyPair, E as KeyInput, F as ArkstackErrorShape, G as EnvRegistry, H as DotPathValue, I as Choice, J as GlobalConfig, K as EnvReturn, L as Choices, M as SerializedKeyPair, N as AppConfig, O as Keys, P as ArkstackErrorPayload, Q as HookName, R as Concrete, S as DerivedKey, T as FingerprintOptions, U as EnvKey, V as DotPath, W as EnvLookup, X as HookArgs, Y as GlobalEnv, Z as HookFor, _ as ChannelOptions, a as abort, at as LoggerParseSignature, b as Codec, c as getModel, ct as Primitive, d as isClass, dt as PublishFilter, et as HookPositions, f as normalizePositiveInteger, ft as PublishGroup, g as Hash, h as setModelResolver, i as ModelResolver, it as LoggerLog, j as SecureChannel, k as NodeCipher, l as getModelSync, lt as PublishConfirmation, m as resolvePagination, mt as Logger, n as ModelConstructor, nt as IHook, o as abortIf, ot as MergedConfig, p as perPage, pt as UnionToIntersection, q as FileImporter, r as ModelRegistry, rt as LoggerChalk, s as assertFound, st as PaginationOptions, t as AbstractModelConstructor, tt as HookRegistry, u as initializeGlobalContext, ut as PublishEntry, v as Cipher, w as EncryptionKey, x as DeriveOptions, y as CipherOptions, z as ConfigRegistry } from "./helpers-CWLBYxS-.js";
 import { Arkstack } from "@arkstack/contract";
 import { ForkOptions } from "node:child_process";
 import pino from "pino";
@@ -533,4 +533,4 @@ declare const devServer: (options: DevServerRunnerOptions) => {
   closeWatcher(): Promise<void>;
 };
 //#endregion
-export { AbstractModelConstructor, AppConfig, AppException, ArkstackErrorPayload, ArkstackErrorShape, CONFIG_KEY, type ChannelOptions, Choice, Choices, Cipher, type CipherOptions, Codec, Concrete, ConfigLoader, ConfigRegistry, ConfigShape, type DeriveOptions, type DerivedKey, DevServerRunnerOptions, DotPath, DotPathValue, Encryption, EncryptionKey, EnvKey, EnvLoader, EnvLookup, EnvRegistry, EnvReturn, ErrorHandler, Exception, FileImporter, type FingerprintOptions, GlobalConfig, GlobalEnv, Hash, Hook, HookArgs, HookFor, HookName, HookPos, HookPositions, HookRegistry, IHook, type KeyInput, KeyPair, Keys, Logger, LoggerChalk, LoggerLog, LoggerParseSignature, MergedConfig, ModelConstructor, ModelRegistry, NodeCipher, PaginationOptions, Primitive, PublishConfirmation, PublishEntry, PublishFilter, PublishGroup, Publisher, RequestException, SealedBox, SecureChannel, type SerializedKeyPair, TlsCredentials, UnionToIntersection, abort, abortIf, appKey, appUrl, assertFound, bindGracefulShutdown, bootWithDetectedPort, config, configLoader, createErrorPayload, devServer, devTlsCredentials, discoverCommands, env, envLoader, getErrorLogger, getModel, getModelSync, getPrimaryError, getValidationErrors, importFile, initializeGlobalContext, interopDefault, isClass, isModelNotFoundError, isValidationError, loadPrototypes, localNetworkAddress, logUnhandledError, nodeEnv, normalizePositiveInteger, normalizeStatusCode, outputDir, perPage, rebuildOutput, renderError, resolvePagination, resolveRuntimeDir, resolveRuntimeModule, serializeError, shouldHideStack, shouldLogError, toErrorShape, toOutputPath };
+export { AbstractModelConstructor, AppConfig, AppException, ArkstackErrorPayload, ArkstackErrorShape, CONFIG_KEY, type ChannelOptions, Choice, Choices, Cipher, type CipherOptions, Codec, Concrete, ConfigLoader, ConfigRegistry, ConfigShape, type DeriveOptions, type DerivedKey, DevServerRunnerOptions, DotPath, DotPathValue, Encryption, EncryptionKey, EnvKey, EnvLoader, EnvLookup, EnvRegistry, EnvReturn, ErrorHandler, Exception, FileImporter, type FingerprintOptions, GlobalConfig, GlobalEnv, Hash, Hook, HookArgs, HookFor, HookName, HookPos, HookPositions, HookRegistry, IHook, type KeyInput, KeyPair, Keys, Logger, LoggerChalk, LoggerLog, LoggerParseSignature, MergedConfig, ModelConstructor, ModelRegistry, ModelResolver, NodeCipher, PaginationOptions, Primitive, PublishConfirmation, PublishEntry, PublishFilter, PublishGroup, Publisher, RequestException, SealedBox, SecureChannel, type SerializedKeyPair, TlsCredentials, UnionToIntersection, abort, abortIf, appKey, appUrl, assertFound, bindGracefulShutdown, bootWithDetectedPort, config, configLoader, createErrorPayload, devServer, devTlsCredentials, discoverCommands, env, envLoader, getErrorLogger, getModel, getModelSync, getPrimaryError, getValidationErrors, importFile, initializeGlobalContext, interopDefault, isClass, isModelNotFoundError, isValidationError, loadPrototypes, localNetworkAddress, logUnhandledError, nodeEnv, normalizePositiveInteger, normalizeStatusCode, outputDir, perPage, rebuildOutput, renderError, resolvePagination, resolveRuntimeDir, resolveRuntimeModule, serializeError, setModelResolver, shouldHideStack, shouldLogError, toErrorShape, toOutputPath };

package/dist/index.js

@@ -1,5 +1,5 @@
 import { _ as EnvLoader, a as env, c as nodeEnv, d as resolveRuntimeDir, f as resolveRuntimeModule, g as configLoader, h as ConfigLoader, i as discoverCommands, l as outputDir, m as CONFIG_KEY, n as appUrl, o as importFile, p as toOutputPath, r as config, s as interopDefault, t as appKey, u as rebuildOutput, v as envLoader } from "./system-BH1phDBR.js";
-import { C as Encryption, D as NodeCipher, E as Keys, O as SealedBox, S as Codec, T as KeyPair, _ as RequestException, b as Hash, c as abortIf, d as getModelSync, f as initializeGlobalContext, g as resolvePagination, h as perPage, k as SecureChannel, l as assertFound, m as normalizePositiveInteger, p as isClass, s as abort, u as getModel, v as AppException, w as EncryptionKey, x as Cipher, y as Exception } from "./utils-4xEVrT0Z.js";
+import { A as SecureChannel, C as Codec, D as Keys, E as KeyPair, O as NodeCipher, S as Cipher, T as EncryptionKey, _ as setModelResolver, b as Exception, c as abortIf, d as getModelSync, f as initializeGlobalContext, g as resolvePagination, h as perPage, k as SealedBox, l as assertFound, m as normalizePositiveInteger, p as isClass, s as abort, u as getModel, v as RequestException, w as Encryption, x as Hash, y as AppException } from "./utils-DbBtlcTv.js";
 import { Hook as Hook$1 } from "@arkstack/foundry";
 import { Arkstack } from "@arkstack/contract";
 import { str } from "@h3ravel/support";
@@ -336,6 +336,30 @@ var Logger = class Logger {
 			value
 		];
 	}
+	/**
+	* Convert absolute paths under current working directory into relative display paths.
+	*
+	* @param filePath
+	* @returns
+	*/
+	static formatPathForLog(filePath) {
+		const relPath = path.relative(process.cwd(), filePath);
+		if (!relPath) return ".";
+		if (relPath.startsWith("..")) return filePath;
+		return relPath;
+	}
+	/**
+	* Utility to format a value for logging, converting absolute paths under current
+	* working directory into relative display paths.
+	*
+	* @param name
+	* @param value
+	* @returns
+	*/
+	static splitLogger(name, value) {
+		value = value.includes(process.cwd()) ? this.formatPathForLog(value) : value;
+		return this.twoColumnDetail(name + " ", " " + value, false).join("");
+	}
 	static describe(name, desc, width = 50, log = true) {
 		width = Math.max(width, 30);
 		const dots = Math.max(width - name.replace(/\x1b\[\d+m/g, "").length, 0);
@@ -660,4 +684,4 @@ const devServer = (options) => {
 	};
 };
 //#endregion
-export { AppException, CONFIG_KEY, Cipher, Codec, ConfigLoader, Encryption, EncryptionKey, EnvLoader, ErrorHandler, Exception, Hash, Hook, KeyPair, Keys, Logger, NodeCipher, Publisher, RequestException, SealedBox, SecureChannel, abort, abortIf, appKey, appUrl, assertFound, bindGracefulShutdown, bootWithDetectedPort, config, configLoader, createErrorPayload, devServer, devTlsCredentials, discoverCommands, env, envLoader, getErrorLogger, getModel, getModelSync, getPrimaryError, getValidationErrors, importFile, initializeGlobalContext, interopDefault, isClass, isModelNotFoundError, isValidationError, loadPrototypes, localNetworkAddress, logUnhandledError, nodeEnv, normalizePositiveInteger, normalizeStatusCode, outputDir, perPage, rebuildOutput, renderError, resolvePagination, resolveRuntimeDir, resolveRuntimeModule, serializeError, shouldHideStack, shouldLogError, toErrorShape, toOutputPath };
+export { AppException, CONFIG_KEY, Cipher, Codec, ConfigLoader, Encryption, EncryptionKey, EnvLoader, ErrorHandler, Exception, Hash, Hook, KeyPair, Keys, Logger, NodeCipher, Publisher, RequestException, SealedBox, SecureChannel, abort, abortIf, appKey, appUrl, assertFound, bindGracefulShutdown, bootWithDetectedPort, config, configLoader, createErrorPayload, devServer, devTlsCredentials, discoverCommands, env, envLoader, getErrorLogger, getModel, getModelSync, getPrimaryError, getValidationErrors, importFile, initializeGlobalContext, interopDefault, isClass, isModelNotFoundError, isValidationError, loadPrototypes, localNetworkAddress, logUnhandledError, nodeEnv, normalizePositiveInteger, normalizeStatusCode, outputDir, perPage, rebuildOutput, renderError, resolvePagination, resolveRuntimeDir, resolveRuntimeModule, serializeError, setModelResolver, shouldHideStack, shouldLogError, toErrorShape, toOutputPath };

package/dist/utils/index.d.ts

@@ -1,4 +1,4 @@
-import { A as SerializedKeyPair, C as FingerprintOptions, D as NodeCipher, E as Keys, O as SealedBox, S as EncryptionKey, T as KeyPair, _ as CipherOptions, a as abortIf, b as DerivedKey, c as getModelSync, d as normalizePositiveInteger, f as perPage, g as Cipher, h as ChannelOptions, i as abort, k as SecureChannel, l as initializeGlobalContext, m as Hash, n as ModelConstructor, o as assertFound, p as resolvePagination, r as ModelRegistry, s as getModel, t as AbstractModelConstructor, u as isClass, v as Codec, w as KeyInput, x as Encryption, y as DeriveOptions } from "../helpers-DgIgQLDu.js";
+import { A as SealedBox, C as Encryption, D as KeyPair, E as KeyInput, M as SerializedKeyPair, O as Keys, S as DerivedKey, T as FingerprintOptions, _ as ChannelOptions, a as abort, b as Codec, c as getModel, d as isClass, f as normalizePositiveInteger, g as Hash, h as setModelResolver, i as ModelResolver, j as SecureChannel, k as NodeCipher, l as getModelSync, m as resolvePagination, n as ModelConstructor, o as abortIf, p as perPage, r as ModelRegistry, s as assertFound, t as AbstractModelConstructor, u as initializeGlobalContext, v as Cipher, w as EncryptionKey, x as DeriveOptions, y as CipherOptions } from "../helpers-CWLBYxS-.js";
 import { Model } from "arkormx";
 //#region src/utils/traits.d.ts
 declare const crc32: (str: string) => number;
@@ -184,4 +184,4 @@ type Derived<T extends (Trait | TypeFactory<Trait> | Cons)> = T extends TypeFact
  */
 declare function uses<T extends (Trait | TypeFactory<Trait> | Cons)>(instance: unknown, trait: T): instance is Derived<T>;
 //#endregion
-export { AbstractModelConstructor, type ChannelOptions, Cipher, type CipherOptions, Codec, type DeriveOptions, Derived, type DerivedKey, Encryption, EncryptionKey, type FingerprintOptions, Hash, type KeyInput, KeyPair, Keys, ModelConstructor, ModelRegistry, NodeCipher, SealedBox, SecureChannel, type SerializedKeyPair, Trait, abort, abortIf, assertFound, callTraitMethods, crc32, getModel, getModelSync, getTraitMethods, initializeGlobalContext, isClass, normalizePositiveInteger, perPage, resolvePagination, trait, use, uses };
+export { AbstractModelConstructor, type ChannelOptions, Cipher, type CipherOptions, Codec, type DeriveOptions, Derived, type DerivedKey, Encryption, EncryptionKey, type FingerprintOptions, Hash, type KeyInput, KeyPair, Keys, ModelConstructor, ModelRegistry, ModelResolver, NodeCipher, SealedBox, SecureChannel, type SerializedKeyPair, Trait, abort, abortIf, assertFound, callTraitMethods, crc32, getModel, getModelSync, getTraitMethods, initializeGlobalContext, isClass, normalizePositiveInteger, perPage, resolvePagination, setModelResolver, trait, use, uses };

package/dist/utils/index.js

@@ -1,2 +1,2 @@
-import { C as Encryption, D as NodeCipher, E as Keys, O as SealedBox, S as Codec, T as KeyPair, a as use, b as Hash, c as abortIf, d as getModelSync, f as initializeGlobalContext, g as resolvePagination, h as perPage, i as trait, k as SecureChannel, l as assertFound, m as normalizePositiveInteger, n as crc32, o as uses, p as isClass, r as getTraitMethods, s as abort, t as callTraitMethods, u as getModel, w as EncryptionKey, x as Cipher } from "../utils-4xEVrT0Z.js";
-export { Cipher, Codec, Encryption, EncryptionKey, Hash, KeyPair, Keys, NodeCipher, SealedBox, SecureChannel, abort, abortIf, assertFound, callTraitMethods, crc32, getModel, getModelSync, getTraitMethods, initializeGlobalContext, isClass, normalizePositiveInteger, perPage, resolvePagination, trait, use, uses };
+import { A as SecureChannel, C as Codec, D as Keys, E as KeyPair, O as NodeCipher, S as Cipher, T as EncryptionKey, _ as setModelResolver, a as use, c as abortIf, d as getModelSync, f as initializeGlobalContext, g as resolvePagination, h as perPage, i as trait, k as SealedBox, l as assertFound, m as normalizePositiveInteger, n as crc32, o as uses, p as isClass, r as getTraitMethods, s as abort, t as callTraitMethods, u as getModel, w as Encryption, x as Hash } from "../utils-DbBtlcTv.js";
+export { Cipher, Codec, Encryption, EncryptionKey, Hash, KeyPair, Keys, NodeCipher, SealedBox, SecureChannel, abort, abortIf, assertFound, callTraitMethods, crc32, getModel, getModelSync, getTraitMethods, initializeGlobalContext, isClass, normalizePositiveInteger, perPage, resolvePagination, setModelResolver, trait, use, uses };

package/dist/{utils-4xEVrT0Z.js → utils-DbBtlcTv.js}

@@ -3,7 +3,6 @@ import { Cipher, Codec, EncryptionKey, KeyPair, Keys, SealedBox, SecureChannel }
 import { NodeCipher } from "@arkstack/encryption/node";
 import { Secret, TOTP } from "otpauth";
 import { compare, genSalt, hash } from "bcryptjs";
-import { getModel } from "arkormx";
 //#region src/utils/encryption.ts
 /**
 * Application facing encryption, bound to the app key.
@@ -329,6 +328,17 @@ var RequestException = class RequestException extends AppException {
 };
 //#endregion
 //#region src/utils/helpers.ts
+let modelResolver;
+/**
+* Configure the synchronous model resolver used by {@link getModel}.
+*
+* Database integrations should call this during module initialization. Keeping
+* the resolver injectable lets `@arkstack/common` remain usable without loading
+* a specific ORM at runtime.
+*/
+const setModelResolver = (resolver) => {
+	modelResolver = resolver;
+};
 /**
 * Checks and asserts if target is a class
 * 
@@ -369,8 +379,9 @@ const resolvePagination = (query, defaults) => {
 		perPage: perPage(query, defaults)
 	};
 };
-function getModel$1(modelName) {
-	return getModel(modelName);
+function getModel(modelName) {
+	if (!modelResolver) throw new Error(`No model resolver has been configured. Load your database integration before resolving "${modelName}".`);
+	return modelResolver(modelName);
 }
 function getModelSync(modelName) {
 	return getModel(modelName);
@@ -633,4 +644,4 @@ function uses(instance, trait) {
 	return false;
 }
 //#endregion
-export { Encryption as C, NodeCipher as D, Keys as E, SealedBox as O, Codec as S, KeyPair as T, RequestException as _, use as a, Hash as b, abortIf as c, getModelSync as d, initializeGlobalContext as f, resolvePagination as g, perPage as h, trait as i, SecureChannel as k, assertFound as l, normalizePositiveInteger as m, crc32 as n, uses as o, isClass as p, getTraitMethods as r, abort as s, callTraitMethods as t, getModel$1 as u, AppException as v, EncryptionKey as w, Cipher as x, Exception as y };
+export { SecureChannel as A, Codec as C, Keys as D, KeyPair as E, NodeCipher as O, Cipher as S, EncryptionKey as T, setModelResolver as _, use as a, Exception as b, abortIf as c, getModelSync as d, initializeGlobalContext as f, resolvePagination as g, perPage as h, trait as i, SealedBox as k, assertFound as l, normalizePositiveInteger as m, crc32 as n, uses as o, isClass as p, getTraitMethods as r, abort as s, callTraitMethods as t, getModel as u, RequestException as v, Encryption as w, Hash as x, AppException as y };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkstack/common",
-  "version": "0.18.9",
+  "version": "0.18.11",
   "type": "module",
   "description": "Core utilities, primitives, and shared infrastructure for the Arkstack ecosystem.",
   "homepage": "https://arkstack.toneflix.net",
@@ -43,13 +43,13 @@
     "otpauth": "^9.5.1",
     "pino": "^10.3.1",
     "selfsigned": "^2.4.1",
-    "@arkstack/encryption": "^0.18.9"
+    "@arkstack/encryption": "^0.18.11"
   },
   "peerDependencies": {
     "@h3ravel/support": "^2.2.7",
     "arkormx": "^2.12.8",
-    "@arkstack/contract": "^0.18.9",
-    "@arkstack/foundry": "^0.18.9"
+    "@arkstack/contract": "^0.18.11",
+    "@arkstack/foundry": "^0.18.11"
   },
   "optionalDependencies": {
     "@faker-js/faker": "^10.4.0"