@arkstack/common 0.12.17 → 0.12.19

package/dist/index.js

@@ -1,4 +1,4 @@
-import { C as importFile, E as outputDir, S as env, T as nodeEnv, _ as Hash, b as appUrl, c as abortIf, d as initializeGlobalContext, f as isClass, g as Exception, h as AppException, l as assertFound, m as RequestException, p as perPage, s as abort, u as getModel, v as Encryption, w as interopDefault, x as config, y as CONFIG_KEY } from "./utils-DVFdK8BR.js";
+import { C as importFile, E as outputDir, S as env, T as nodeEnv, _ as Hash, b as appUrl, c as abortIf, d as initializeGlobalContext, f as isClass, g as Exception, h as AppException, l as assertFound, m as RequestException, p as perPage, s as abort, u as getModel, v as Encryption, w as interopDefault, x as config, y as CONFIG_KEY } from "./utils-Y1a3rhA3.js";
 import { Hook as Hook$1 } from "@arkstack/foundry";
 import { str } from "@h3ravel/support";
 import { Arkstack } from "@arkstack/contract";

package/dist/utils/index.d.ts

@@ -134,6 +134,11 @@ type DeriveTraitsStats<T extends ((Trait | TypeFactory<Trait>)[] | [...(Trait |
  * utility type: derive type from one or more traits or trait type factories
  */
 type DeriveTraits<T extends ((Trait | TypeFactory<Trait>)[] | [...(Trait | TypeFactory<Trait>)[], DirectBase])> = DeriveTraitsCons<T> & DeriveTraitsStats<T>;
+type TraitMethodHelpers = {
+  getTraitMethods: <T extends TraitMethod = TraitMethod>(name: PropertyKey) => T[];
+  callTraitMethods: <T = any>(name: PropertyKey, ...args: any[]) => T[];
+};
+type DeriveTraitsWithMethodHelpers<T extends ((Trait | TypeFactory<Trait>)[] | [...(Trait | TypeFactory<Trait>)[], DirectBase])> = DeriveTraits<T> extends (new (...args: infer Args) => infer Instance) ? (new (...args: Args) => Instance & TraitMethodHelpers) & Omit<DeriveTraits<T>, 'prototype'> & TraitMethodHelpers : never;
 type TraitMethod = (...args: any[]) => any;
 /**
  * Return every trait implementation for a method, bound to the supplied
@@ -154,13 +159,15 @@ declare const getTraitMethods: <T extends TraitMethod = TraitMethod>(target: obj
  * @returns
  */
 declare const callTraitMethods: <T = any>(target: object | Cons, name: PropertyKey, ...args: any[]) => T[];
+type UsableTraits = ([Trait | TypeFactory<Trait>, ...(Trait | TypeFactory<Trait>)[]] | [...(Trait | TypeFactory<Trait>)[], DirectBase]);
 /**
  * API: derive a class from one or more traits or trait type factories
  *
  * @param traits
  * @returns
  */
-declare function use<T extends ([Trait | TypeFactory<Trait>, ...(Trait | TypeFactory<Trait>)[]] | [...(Trait | TypeFactory<Trait>)[], DirectBase])>(...traits: T): DeriveTraits<T>;
+declare function use<T extends UsableTraits>(withMethodHelpers: true, ...traits: T): DeriveTraitsWithMethodHelpers<T>;
+declare function use<T extends UsableTraits>(...traits: T): DeriveTraits<T>;
 /**
  * internal type: implements trait type
  */

package/dist/utils/index.js

@@ -1,2 +1,2 @@
-import { _ as Hash, a as use, c as abortIf, d as initializeGlobalContext, f as isClass, i as trait, l as assertFound, n as crc32, o as uses, p as perPage, r as getTraitMethods, s as abort, t as callTraitMethods, u as getModel, v as Encryption } from "../utils-DVFdK8BR.js";
+import { _ as Hash, a as use, c as abortIf, d as initializeGlobalContext, f as isClass, i as trait, l as assertFound, n as crc32, o as uses, p as perPage, r as getTraitMethods, s as abort, t as callTraitMethods, u as getModel, v as Encryption } from "../utils-Y1a3rhA3.js";
 export { Encryption, Hash, abort, abortIf, assertFound, callTraitMethods, crc32, getModel, getTraitMethods, initializeGlobalContext, isClass, perPage, trait, use, uses };

package/dist/{utils-DVFdK8BR.js → utils-Y1a3rhA3.js}

@@ -523,13 +523,9 @@ const deriveTrait = (trait$, baseClass, derived) => {
 * @returns 
 */
 const reverseTraitList = (traits) => traits.slice().reverse();
-/**
-* API: derive a class from one or more traits or trait type factories
-* 
-* @param traits 
-* @returns 
-*/
-function use(...traits) {
+function use(...args) {
+	const withMethodHelpers = args[0] === true;
+	const traits = withMethodHelpers ? args.slice(1) : args;
 	if (traits.length === 0) throw new Error("invalid number of parameters (expected one or more traits)");
 	let classInstance;
 	let lot;
@@ -546,6 +542,20 @@ function use(...traits) {
 	}
 	const derived = /* @__PURE__ */ new Map();
 	for (const trait of reverseTraitList(lot)) classInstance = deriveTrait(trait, classInstance, derived);
+	if (withMethodHelpers) classInstance = class TraitMethodEnabled extends classInstance {
+		getTraitMethods(name) {
+			return getTraitMethods(this, name);
+		}
+		callTraitMethods(name, ...args) {
+			return callTraitMethods(this, name, ...args);
+		}
+		static getTraitMethods(name) {
+			return getTraitMethods(this, name);
+		}
+		static callTraitMethods(name, ...args) {
+			return callTraitMethods(this, name, ...args);
+		}
+	};
 	return classInstance;
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkstack/common",
-  "version": "0.12.17",
+  "version": "0.12.19",
   "type": "module",
   "description": "Core utilities, primitives, and shared infrastructure for the Arkstack ecosystem.",
   "homepage": "https://arkstack.toneflix.net",
@@ -41,9 +41,9 @@
   },
   "peerDependencies": {
     "@h3ravel/support": "^0.15.11",
-    "arkormx": "^2.5.2",
-    "@arkstack/foundry": "^0.12.17",
-    "@arkstack/contract": "^0.12.17"
+    "arkormx": "^2.5.3",
+    "@arkstack/foundry": "^0.12.19",
+    "@arkstack/contract": "^0.12.19"
   },
   "scripts": {
     "build": "tsdown --config-loader unrun",