@arkstack/common 0.19.2 → 0.19.3

package/dist/utils/index.js

@@ -1,2 +1,2 @@
-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-CvlK2sYM.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, 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-DwfM0lt4.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-CvlK2sYM.js → utils-DwfM0lt4.js}

@@ -1,4 +1,4 @@
-import { a as env, t as appKey } from "./system-BH1phDBR.js";
+import { a as env, t as appKey } from "./system-DzAzwH__.js";
 import { Cipher, Codec, EncryptionKey, KeyPair, Keys, SealedBox, SecureChannel } from "@arkstack/encryption";
 import { NodeCipher } from "@arkstack/encryption/node";
 import { Secret, TOTP } from "otpauth";
@@ -202,9 +202,9 @@ var Encryption = class {
 var Hash = class {
 	/**
 	* Hash a value using bcrypt
-	* 
-	* @param value 
-	* @returns 
+	*
+	* @param value
+	* @returns
 	*/
 	static async make(value) {
 		const salt = await genSalt(10);
@@ -212,21 +212,21 @@ var Hash = class {
 	}
 	/**
 	* Verify a value against a hashed value
-	* 
-	* @param value 
-	* @param hashedValue 
-	* @returns 
+	*
+	* @param value
+	* @param hashedValue
+	* @returns
 	*/
 	static async verify(value, hashedValue) {
 		return await compare(value, hashedValue);
 	}
 	/**
 	* Generate a one-time password (OTP) using TOTP algorithm
-	* 
+	*
 	* @param digits    The number of digits for the OTP, default is 6.
 	* @param label     A label to identify the OTP, can be an email or phone number.
 	* @param period    Interval of time for which a token is valid, in seconds.
-	* @returns 
+	* @returns
 	*/
 	static otp(digits = 6, label = "Alice", period = 30) {
 		return new TOTP({
@@ -292,22 +292,22 @@ var RequestException = class RequestException extends AppException {
 		this.statusCode = statusCode;
 	}
 	/**
-	* Asserts that a value is not null or undefined. 
-	* 
-	* @param value 
-	* @param message 
-	* @param code 
+	* Asserts that a value is not null or undefined.
+	*
+	* @param value
+	* @param message
+	* @param code
 	* @throws {RequestException} Throws if the value is null or undefined.
 	*/
 	static assertFound(value, message, code = 404) {
 		if (!value) throw new RequestException(message, code);
 	}
 	/**
-	* Asserts that a value is not null or undefined. 
-	* 
-	* @param value 
-	* @param message 
-	* @param code 
+	* Asserts that a value is not null or undefined.
+	*
+	* @param value
+	* @param message
+	* @param code
 	* @throws {RequestException} Throws if the value is null or undefined.
 	* @deprecated Use assertFound instead
 	*/
@@ -315,11 +315,11 @@ var RequestException = class RequestException extends AppException {
 		return this.assertFound(value, message, code);
 	}
 	/**
-	* Asserts that a boolean condition is true. 
-	* 
-	* @param boolean 
-	* @param message 
-	* @param code 
+	* Asserts that a boolean condition is true.
+	*
+	* @param boolean
+	* @param message
+	* @param code
 	* @throws {RequestException} Throws if the boolean condition is true.
 	*/
 	static abortIf(boolean, message, code) {
@@ -341,9 +341,9 @@ const setModelResolver = (resolver) => {
 };
 /**
 * Checks and asserts if target is a class
-* 
-* @param target 
-* @returns 
+*
+* @param target
+* @returns
 */
 const isClass = (target) => {
 	return typeof target === "function" && /^class\s/.test(Function.prototype.toString.call(target));
@@ -355,11 +355,11 @@ const normalizePositiveInteger = (value, fallback) => {
 };
 /**
 * Extracts a safe pagination limit from a query object.
-* 
-* @param query 
-* @param defaults 
+*
+* @param query
+* @param defaults
 * @default const defaults = { pageSize: 25, maxPageSize: 50 }
-* @returns 
+* @returns
 */
 const perPage = (query, defaults) => {
 	const requestedPerPage = normalizePositiveInteger(query.limit ?? query.perPage ?? query["per-page"] ?? query.per_page, defaults?.perPage ?? 25);
@@ -367,11 +367,11 @@ const perPage = (query, defaults) => {
 };
 /**
 * Extracts the current page and a safe pagination limit from a query object.
-* 
-* @param query 
-* @param defaults 
+*
+* @param query
+* @param defaults
 * @default const defaults = { currentPage: 1, pageSize: 25, maxPageSize: 50 }
-* @returns 
+* @returns
 */
 const resolvePagination = (query, defaults) => {
 	return {
@@ -388,7 +388,7 @@ function getModelSync(modelName) {
 }
 const initializeGlobalContext = async ({ Request, Response, Session } = {}) => {
 	try {
-		const { Request: Req, Response: Res, Session: Ses } = await import("./dist-DwGScrDq.js");
+		const { Request: Req, Response: Res, Session: Ses } = await import("./dist-kNVDZ1C_.js");
 		Session ??= new Ses();
 		Request ??= new Req();
 		Response ??= new Res();
@@ -403,31 +403,31 @@ const initializeGlobalContext = async ({ Request, Response, Session } = {}) => {
 };
 /**
 * Thows to abort the current request
-* 
-* @param message 
-* @param code 
+*
+* @param message
+* @param code
 * @throws {RequestException}
 */
 const abort = (message = "Request Aborted", code = 404) => {
 	RequestException.abortIf(true, message, code);
 };
 /**
-* Asserts that a boolean condition is true. 
-* 
-* @param boolean 
-* @param message 
-* @param code 
+* Asserts that a boolean condition is true.
+*
+* @param boolean
+* @param message
+* @param code
 * @throws {RequestException} Throws if the boolean condition is true.
 */
 const abortIf = (boolean, message = "Request Aborted", code = 404) => {
 	RequestException.abortIf(boolean, message, code);
 };
 /**
-* Asserts that a value is not null or undefined. 
-* 
-* @param value 
-* @param message 
-* @param code 
+* Asserts that a value is not null or undefined.
+*
+* @param value
+* @param message
+* @param code
 * @throws {RequestException} Throws if the value is null or undefined.
 */
 const assertFound = (value, message, code = 404) => {
@@ -437,8 +437,8 @@ const assertFound = (value, message, code = 404) => {
 //#region src/utils/traits.ts
 /**
 * CRC32 implementation in TypeScript, adapted from https://stackoverflow.com/a/18639999
-* Note: This implementation is not cryptographically secure and is only used for generating 
-* unique identifiers for traits based on their factory function's string representation. 
+* Note: This implementation is not cryptographically secure and is only used for generating
+* unique identifiers for traits based on their factory function's string representation.
 */
 const crcTable = [];
 for (let n = 0; n < 256; n++) {
@@ -456,8 +456,8 @@ const isArkormModelInstance = (value) => typeof value === "object" && value !==
 const isTypeFactory = (fn) => typeof fn === "function" && !fn.prototype && fn.length === 0;
 /**
 * API: generate trait (technical implementation)
-* 
-* @param args 
+*
+* @param args
 */
 function trait(...args) {
 	const factory = args.length === 2 ? args[1] : args[0];
@@ -471,11 +471,11 @@ function trait(...args) {
 }
 /**
 * utility function: add an additional invisible property to an object
-* 
-* @param cons 
-* @param field 
-* @param value 
-* @returns 
+*
+* @param cons
+* @param field
+* @param value
+* @returns
 */
 const extendProperties = (cons, field, value) => Object.defineProperty(cons, field, {
 	value,
@@ -509,9 +509,9 @@ const registerMethodScope = (target, base, ignored) => {
 };
 /**
 * Registers conflicting trait methods
-* 
-* @param classInstance 
-* @param baseClass 
+*
+* @param classInstance
+* @param baseClass
 */
 const registerTraitMethods = (classInstance, baseClass) => {
 	registerMethodScope(classInstance.prototype, baseClass.prototype, /* @__PURE__ */ new Set(["constructor"]));
@@ -527,21 +527,21 @@ const registerTraitMethods = (classInstance, baseClass) => {
 * Return every trait implementation for a method, bound to the supplied
 * instance or class. Methods are ordered from the base implementation to the
 * currently active trait implementation.
-* 
-* @param target 
-* @param name 
-* @returns 
+*
+* @param target
+* @param name
+* @returns
 */
 const getTraitMethods = (target, name) => {
 	return (((typeof target === "function" ? target : Object.getPrototypeOf(target))?.[traitMethodRegistry])?.get(name) ?? []).map((method) => method.bind(target));
 };
 /**
 * Invoke every trait implementation for a method in registration order.
-* 
-* @param target 
-* @param name 
-* @param args 
-* @returns 
+*
+* @param target
+* @param name
+* @param args
+* @returns
 */
 const callTraitMethods = (target, name, ...args) => {
 	const methods = getTraitMethods(target, name);
@@ -553,18 +553,18 @@ const callTraitMethods = (target, name, ...args) => {
 };
 /**
 * utility function: get raw trait
-* 
-* @param x 
-* @returns 
+*
+* @param x
+* @returns
 */
 const rawTrait = (x) => isTypeFactory(x) ? x() : x;
 /**
 * utility function: derive a trait
-* 
-* @param trait$ 
-* @param baseClass 
-* @param derived 
-* @returns 
+*
+* @param trait$
+* @param baseClass
+* @param derived
+* @returns
 */
 const deriveTrait = (trait$, baseClass, derived) => {
 	const trait = rawTrait(trait$);
@@ -583,9 +583,9 @@ const deriveTrait = (trait$, baseClass, derived) => {
 };
 /**
 * utility function: get reversed trait list
-* 
-* @param traits 
-* @returns 
+*
+* @param traits
+* @returns
 */
 const reverseTraitList = (traits) => traits.slice().reverse();
 function use(...args) {
@@ -625,10 +625,10 @@ function use(...args) {
 }
 /**
 * API: type guard for checking whether class instance is derived from a trait
-* 
-* @param instance 
-* @param trait 
-* @returns 
+*
+* @param instance
+* @param trait
+* @returns
 */
 function uses(instance, trait) {
 	if (typeof instance !== "object" || instance === null) return false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkstack/common",
-  "version": "0.19.2",
+  "version": "0.19.3",
   "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.19.2"
+    "@arkstack/encryption": "^0.19.3"
   },
   "peerDependencies": {
     "@h3ravel/support": "^2.2.7",
     "arkormx": "^2.12.8",
-    "@arkstack/contract": "^0.19.2",
-    "@arkstack/foundry": "^0.19.2"
+    "@arkstack/contract": "^0.19.3",
+    "@arkstack/foundry": "^0.19.3"
   },
   "optionalDependencies": {
     "@faker-js/faker": "^10.4.0"