stratal 0.0.17 → 0.0.19

package/dist/macroable-BmufBshB.mjs

@@ -0,0 +1,122 @@
+//#region src/macroable/macroable.ts
+/**
+* Abstract base class for adding macros, instance properties, and getters
+* to classes at runtime.
+*
+* Inspired by [@poppinss/macroable](https://github.com/poppinss/macroable)
+* and Laravel's Macroable trait.
+*
+* @example
+* ```typescript
+* // Register a macro
+* RouterContext.macro('flash', function (this: RouterContext, key: string, value: unknown) {
+*   const session = this.getContainer().resolve(SessionService)
+*   session.flash(key, value)
+* })
+*
+* // Register a getter
+* RouterContext.getter('requestId', function (this: RouterContext) {
+*   return this.header('x-request-id') ?? crypto.randomUUID()
+* }, true)
+*
+* // Register a per-instance property (safe for destructuring)
+* RouterContext.instanceProperty('getUser', function (this: RouterContext) {
+*   return this.getContainer().resolve(AuthContext).user
+* })
+* ```
+*/
+var Macroable = class {
+	/**
+	* Per-instance properties. Each entry is applied and bound
+	* to `this` inside the constructor so destructuring stays safe.
+	*/
+	static instanceMacros = /* @__PURE__ */ new Set();
+	/**
+	* Names registered via macro() — used by hasMacro() and flushMacros().
+	*/
+	static macroNames = /* @__PURE__ */ new Set();
+	/**
+	* Names registered via getter() — used by hasMacro() and flushMacros().
+	*/
+	static getterNames = /* @__PURE__ */ new Set();
+	/**
+	* Original prototype values saved before macro() overrides them.
+	* Used by flushMacros() to restore native methods.
+	*/
+	static _originals = /* @__PURE__ */ new Map();
+	static macro(name, value) {
+		if (!Object.prototype.hasOwnProperty.call(this, "macroNames")) this.macroNames = new Set(this.macroNames);
+		if (!Object.prototype.hasOwnProperty.call(this, "_originals")) this._originals = new Map(this._originals);
+		if (!this._originals.has(name)) {
+			const existed = Object.prototype.hasOwnProperty.call(this.prototype, name);
+			this._originals.set(name, {
+				existed,
+				value: existed ? this.prototype[name] : void 0
+			});
+		}
+		this.macroNames.add(name);
+		this.prototype[name] = value;
+	}
+	static instanceProperty(name, value) {
+		if (!Object.prototype.hasOwnProperty.call(this, "instanceMacros")) this.instanceMacros = new Set(this.instanceMacros);
+		this.instanceMacros.add({
+			key: name,
+			value
+		});
+	}
+	static getter(name, accumulator, singleton = false) {
+		if (!Object.prototype.hasOwnProperty.call(this, "getterNames")) this.getterNames = new Set(this.getterNames);
+		this.getterNames.add(name);
+		Object.defineProperty(this.prototype, name, {
+			get() {
+				const value = accumulator.call(this);
+				if (singleton) Object.defineProperty(this, name, {
+					value,
+					configurable: false,
+					enumerable: false,
+					writable: false
+				});
+				return value;
+			},
+			configurable: true,
+			enumerable: false
+		});
+	}
+	/**
+	* Check if a macro, instance property, or getter is registered.
+	*
+	* @param name - Name to check
+	*/
+	static hasMacro(name) {
+		return this.macroNames.has(name) || [...this.instanceMacros].some((m) => m.key === name) || this.getterNames.has(name);
+	}
+	/**
+	* Remove all macros, instance properties, and getters
+	* registered on this class. Does not affect parent classes.
+	*/
+	static flushMacros() {
+		const proto = this.prototype;
+		for (const name of this.macroNames) {
+			const original = this._originals.get(name);
+			if (original?.existed) proto[name] = original.value;
+			else Reflect.deleteProperty(proto, name);
+		}
+		for (const name of this.getterNames) Reflect.deleteProperty(proto, name);
+		if (Object.prototype.hasOwnProperty.call(this, "macroNames")) this.macroNames.clear();
+		if (Object.prototype.hasOwnProperty.call(this, "instanceMacros")) this.instanceMacros.clear();
+		if (Object.prototype.hasOwnProperty.call(this, "getterNames")) this.getterNames.clear();
+		if (Object.prototype.hasOwnProperty.call(this, "_originals")) this._originals.clear();
+	}
+	constructor() {
+		const Constructor = this.constructor;
+		const self = this;
+		Constructor.instanceMacros.forEach(({ key, value }) => {
+			if (typeof value === "function") self[key] = value.bind(this);
+			else self[key] = value;
+		});
+	}
+};
+//#endregion
+export { Macroable as t };
+
+//# sourceMappingURL=macroable-BmufBshB.mjs.map

package/dist/macroable-BmufBshB.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"macroable-BmufBshB.mjs","names":[],"sources":["../src/macroable/macroable.ts"],"sourcesContent":["import type { MacroFunction } from './types'\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype Constructor = abstract new (...args: any[]) => any\n\n/**\n * Abstract base class for adding macros, instance properties, and getters\n * to classes at runtime.\n *\n * Inspired by [@poppinss/macroable](https://github.com/poppinss/macroable)\n * and Laravel's Macroable trait.\n *\n * @example\n * ```typescript\n * // Register a macro\n * RouterContext.macro('flash', function (this: RouterContext, key: string, value: unknown) {\n *   const session = this.getContainer().resolve(SessionService)\n *   session.flash(key, value)\n * })\n *\n * // Register a getter\n * RouterContext.getter('requestId', function (this: RouterContext) {\n *   return this.header('x-request-id') ?? crypto.randomUUID()\n * }, true)\n *\n * // Register a per-instance property (safe for destructuring)\n * RouterContext.instanceProperty('getUser', function (this: RouterContext) {\n *   return this.getContainer().resolve(AuthContext).user\n * })\n * ```\n */\nexport abstract class Macroable {\n  [key: string | symbol]: unknown\n  /**\n   * Per-instance properties. Each entry is applied and bound\n   * to `this` inside the constructor so destructuring stays safe.\n   */\n  protected static instanceMacros = new Set<{ key: string | symbol; value: unknown }>()\n\n  /**\n   * Names registered via macro() — used by hasMacro() and flushMacros().\n   */\n  protected static macroNames = new Set<string | symbol>()\n\n  /**\n   * Names registered via getter() — used by hasMacro() and flushMacros().\n   */\n  protected static getterNames = new Set<string | symbol>()\n\n  /**\n   * Original prototype values saved before macro() overrides them.\n   * Used by flushMacros() to restore native methods.\n   */\n  private static _originals = new Map<string | symbol, { existed: boolean; value: unknown }>()\n\n  // ── Macros (prototype-level) ──────────────────────────────\n\n  /**\n   * Register a macro on the class prototype.\n   * Can override existing methods.\n   *\n   * When the name matches an existing property, the value type is auto-derived.\n   *\n   * @param name - Method or property name\n   * @param value - Function or value to assign\n   */\n  static macro<T extends Constructor, K extends keyof InstanceType<T>>(\n    this: T,\n    name: K,\n    value: InstanceType<T>[K],\n  ): void\n  static macro(name: string | symbol, value: unknown): void\n  static macro(name: string | symbol, value: unknown): void {\n    if (!Object.prototype.hasOwnProperty.call(this, 'macroNames')) {\n      this.macroNames = new Set(this.macroNames)\n    }\n    if (!Object.prototype.hasOwnProperty.call(this, '_originals')) {\n      this._originals = new Map(this._originals)\n    }\n\n    // Save the original value before first override so flushMacros() can restore it\n    if (!this._originals.has(name)) {\n      const existed = Object.prototype.hasOwnProperty.call(this.prototype, name)\n      this._originals.set(name, {\n        existed,\n        value: existed ? (this.prototype as Record<string | symbol, unknown>)[name] : undefined,\n      })\n    }\n\n    this.macroNames.add(name);\n    (this.prototype as Record<string | symbol, unknown>)[name] = value\n  }\n\n  // ── Instance properties (bound per-instance) ─────────────\n\n  /**\n   * Register a per-instance property that is bound to `this`\n   * in the constructor. Safe for destructuring.\n   *\n   * When the name matches an existing property, the value type is auto-derived.\n   *\n   * @param name - Property name\n   * @param value - Function (will be bound) or value\n   */\n  static instanceProperty<T extends Constructor, K extends keyof InstanceType<T>>(\n    this: T,\n    name: K,\n    value: InstanceType<T>[K],\n  ): void\n  static instanceProperty(name: string | symbol, value: unknown): void\n  static instanceProperty(name: string | symbol, value: unknown): void {\n    if (!Object.prototype.hasOwnProperty.call(this, 'instanceMacros')) {\n      this.instanceMacros = new Set(this.instanceMacros)\n    }\n    this.instanceMacros.add({ key: name, value })\n  }\n\n  // ── Getters (Object.defineProperty on prototype) ──────────\n\n  /**\n   * Register a computed getter on the class prototype.\n   *\n   * @param name - Property name\n   * @param accumulator - Function that computes the value (called with instance as `this`)\n   * @param singleton - If true, cache the value after first access\n   */\n  static getter<T extends Constructor, K extends keyof InstanceType<T>>(\n    this: T,\n    name: K,\n    accumulator: (this: InstanceType<T>) => InstanceType<T>[K],\n    singleton?: boolean,\n  ): void\n  static getter(name: string | symbol, accumulator: MacroFunction, singleton?: boolean): void\n  static getter(\n    name: string | symbol,\n    accumulator: MacroFunction,\n    singleton = false,\n  ): void {\n    if (!Object.prototype.hasOwnProperty.call(this, 'getterNames')) {\n      this.getterNames = new Set(this.getterNames)\n    }\n    this.getterNames.add(name)\n\n    Object.defineProperty(this.prototype, name, {\n      get(): unknown {\n        const value: unknown = accumulator.call(this)\n        if (singleton) {\n          Object.defineProperty(this, name, {\n            value,\n            configurable: false,\n            enumerable: false,\n            writable: false,\n          })\n        }\n        return value\n      },\n      configurable: true,\n      enumerable: false,\n    })\n  }\n\n  // ── Introspection ─────────────────────────────────────────\n\n  /**\n   * Check if a macro, instance property, or getter is registered.\n   *\n   * @param name - Name to check\n   */\n  static hasMacro(name: string | symbol): boolean {\n    return (\n      this.macroNames.has(name) ||\n      [...this.instanceMacros].some((m) => m.key === name) ||\n      this.getterNames.has(name)\n    )\n  }\n\n  // ── Cleanup ───────────────────────────────────────────────\n\n  /**\n   * Remove all macros, instance properties, and getters\n   * registered on this class. Does not affect parent classes.\n   */\n  static flushMacros(): void {\n    const proto = this.prototype as Record<string | symbol, unknown>\n\n    // Restore original prototype values or delete if they didn't exist before\n    for (const name of this.macroNames) {\n      const original = this._originals.get(name)\n      if (original?.existed) {\n        proto[name] = original.value\n      } else {\n        Reflect.deleteProperty(proto, name)\n      }\n    }\n    for (const name of this.getterNames) {\n      Reflect.deleteProperty(proto, name)\n    }\n\n    if (Object.prototype.hasOwnProperty.call(this, 'macroNames')) {\n      this.macroNames.clear()\n    }\n    if (Object.prototype.hasOwnProperty.call(this, 'instanceMacros')) {\n      this.instanceMacros.clear()\n    }\n    if (Object.prototype.hasOwnProperty.call(this, 'getterNames')) {\n      this.getterNames.clear()\n    }\n    if (Object.prototype.hasOwnProperty.call(this, '_originals')) {\n      this._originals.clear()\n    }\n  }\n\n  // ── Constructor (applies instance properties) ─────────────\n\n  constructor() {\n    const Constructor = this.constructor as typeof Macroable\n    const self = this as Record<string | symbol, unknown>\n    Constructor.instanceMacros.forEach(({ key, value }) => {\n      if (typeof value === 'function') {\n        self[key] = value.bind(this)\n      } else {\n        self[key] = value\n      }\n    })\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,IAAsB,YAAtB,MAAgC;;;;;CAM9B,OAAiB,iCAAiB,IAAI,KAA+C;;;;CAKrF,OAAiB,6BAAa,IAAI,KAAsB;;;;CAKxD,OAAiB,8BAAc,IAAI,KAAsB;;;;;CAMzD,OAAe,6BAAa,IAAI,KAA4D;CAmB5F,OAAO,MAAM,MAAuB,OAAsB;AACxD,MAAI,CAAC,OAAO,UAAU,eAAe,KAAK,MAAM,aAAa,CAC3D,MAAK,aAAa,IAAI,IAAI,KAAK,WAAW;AAE5C,MAAI,CAAC,OAAO,UAAU,eAAe,KAAK,MAAM,aAAa,CAC3D,MAAK,aAAa,IAAI,IAAI,KAAK,WAAW;AAI5C,MAAI,CAAC,KAAK,WAAW,IAAI,KAAK,EAAE;GAC9B,MAAM,UAAU,OAAO,UAAU,eAAe,KAAK,KAAK,WAAW,KAAK;AAC1E,QAAK,WAAW,IAAI,MAAM;IACxB;IACA,OAAO,UAAW,KAAK,UAA+C,QAAQ,KAAA;IAC/E,CAAC;;AAGJ,OAAK,WAAW,IAAI,KAAK;AACxB,OAAK,UAA+C,QAAQ;;CAoB/D,OAAO,iBAAiB,MAAuB,OAAsB;AACnE,MAAI,CAAC,OAAO,UAAU,eAAe,KAAK,MAAM,iBAAiB,CAC/D,MAAK,iBAAiB,IAAI,IAAI,KAAK,eAAe;AAEpD,OAAK,eAAe,IAAI;GAAE,KAAK;GAAM;GAAO,CAAC;;CAmB/C,OAAO,OACL,MACA,aACA,YAAY,OACN;AACN,MAAI,CAAC,OAAO,UAAU,eAAe,KAAK,MAAM,cAAc,CAC5D,MAAK,cAAc,IAAI,IAAI,KAAK,YAAY;AAE9C,OAAK,YAAY,IAAI,KAAK;AAE1B,SAAO,eAAe,KAAK,WAAW,MAAM;GAC1C,MAAe;IACb,MAAM,QAAiB,YAAY,KAAK,KAAK;AAC7C,QAAI,UACF,QAAO,eAAe,MAAM,MAAM;KAChC;KACA,cAAc;KACd,YAAY;KACZ,UAAU;KACX,CAAC;AAEJ,WAAO;;GAET,cAAc;GACd,YAAY;GACb,CAAC;;;;;;;CAUJ,OAAO,SAAS,MAAgC;AAC9C,SACE,KAAK,WAAW,IAAI,KAAK,IACzB,CAAC,GAAG,KAAK,eAAe,CAAC,MAAM,MAAM,EAAE,QAAQ,KAAK,IACpD,KAAK,YAAY,IAAI,KAAK;;;;;;CAU9B,OAAO,cAAoB;EACzB,MAAM,QAAQ,KAAK;AAGnB,OAAK,MAAM,QAAQ,KAAK,YAAY;GAClC,MAAM,WAAW,KAAK,WAAW,IAAI,KAAK;AAC1C,OAAI,UAAU,QACZ,OAAM,QAAQ,SAAS;OAEvB,SAAQ,eAAe,OAAO,KAAK;;AAGvC,OAAK,MAAM,QAAQ,KAAK,YACtB,SAAQ,eAAe,OAAO,KAAK;AAGrC,MAAI,OAAO,UAAU,eAAe,KAAK,MAAM,aAAa,CAC1D,MAAK,WAAW,OAAO;AAEzB,MAAI,OAAO,UAAU,eAAe,KAAK,MAAM,iBAAiB,CAC9D,MAAK,eAAe,OAAO;AAE7B,MAAI,OAAO,UAAU,eAAe,KAAK,MAAM,cAAc,CAC3D,MAAK,YAAY,OAAO;AAE1B,MAAI,OAAO,UAAU,eAAe,KAAK,MAAM,aAAa,CAC1D,MAAK,WAAW,OAAO;;CAM3B,cAAc;EACZ,MAAM,cAAc,KAAK;EACzB,MAAM,OAAO;AACb,cAAY,eAAe,SAAS,EAAE,KAAK,YAAY;AACrD,OAAI,OAAO,UAAU,WACnB,MAAK,OAAO,MAAM,KAAK,KAAK;OAE5B,MAAK,OAAO;IAEd"}

package/dist/module/index.d.mts

@@ -1,6 +1,5 @@
-import { at as DynamicModule, ct as InjectionToken, dt as ModuleOptions, ft as OnInitialize, gt as ValueProvider, ht as RegistryEntry, it as ClassProvider, lt as ModuleClass, mt as Provider, ot as ExistingProvider, pt as OnShutdown, rt as AsyncModuleOptions, st as FactoryProvider, ut as ModuleContext } from "../index-BFCxSp_f.mjs";
-import { t as Constructor } from "../types-DahElfUw.mjs";
-import { t as ModuleRegistry } from "../module-registry-CmjBX6ol.mjs";
+import { $t as ModuleRegistry, Cn as OnInitialize, Dn as ValueProvider, En as RegistryEntry, Sn as OnException, Tn as Provider, _n as FactoryProvider, bn as ModuleContext, gn as ExistingProvider, hn as DynamicModule, mn as ClassProvider, pn as AsyncModuleOptions, vn as InjectionToken, wn as OnShutdown, xn as ModuleOptions, yn as ModuleClass } from "../index-DPFqRs8L.mjs";
+import { t as Constructor } from "../types-DIWemRad.mjs";
 
 //#region src/module/module.decorator.d.ts
 declare const MODULE_OPTIONS_KEY: unique symbol;
@@ -29,5 +28,5 @@ declare function getModuleOptions(target: Constructor): ModuleOptions | undefine
  */
 declare function isModuleClass(target: unknown): target is Constructor;
 //#endregion
-export { AsyncModuleOptions, ClassProvider, DynamicModule, ExistingProvider, FactoryProvider, InjectionToken, MODULE_OPTIONS_KEY, Module, ModuleClass, ModuleContext, ModuleOptions, ModuleRegistry, OnInitialize, OnShutdown, Provider, RegistryEntry, ValueProvider, getModuleOptions, isModuleClass };
+export { AsyncModuleOptions, ClassProvider, DynamicModule, ExistingProvider, FactoryProvider, InjectionToken, MODULE_OPTIONS_KEY, Module, ModuleClass, ModuleContext, ModuleOptions, ModuleRegistry, OnException, OnInitialize, OnShutdown, Provider, RegistryEntry, ValueProvider, getModuleOptions, isModuleClass };
 //# sourceMappingURL=index.d.mts.map

package/dist/module/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/module/module.decorator.ts"],"mappings":";;;;;cAea,kBAAA;;;AAyBb;;;;;;;;;;;;;iBAAgB,MAAA,CAAO,OAAA,EAAS,aAAA,uCACa,IAAA,uBAA2B,MAAA,EAAQ,SAAA,KAAY,SAAA;;;;iBAmB5E,gBAAA,CAAiB,MAAA,EAAQ,WAAA,GAAc,aAAA;;;;iBAOvC,aAAA,CAAc,MAAA,YAAkB,MAAA,IAAU,WAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/module/module.decorator.ts"],"mappings":";;;;cAea,kBAAA;AAyBb;;;;;;;;;;;;;;;AAAA,iBAAgB,MAAA,CAAO,OAAA,EAAS,aAAA,uCACa,IAAA,uBAA2B,MAAA,EAAQ,SAAA,KAAY,SAAA;;AAmB5F;;iBAAgB,gBAAA,CAAiB,MAAA,EAAQ,WAAA,GAAc,aAAA;;;;iBAOvC,aAAA,CAAc,MAAA,YAAkB,MAAA,IAAU,WAAA"}

package/dist/module/index.mjs

@@ -1,11 +1,2 @@
-import "../errors-DSKapqD8.mjs";
-import "../logger-CGT91VY6.mjs";
-import { a as isModuleClass, i as getModuleOptions, n as MODULE_OPTIONS_KEY, r as Module, t as ModuleRegistry } from "../module-tUtyVJ5E.mjs";
-import "../events-CvUSgEuN.mjs";
-import "../middleware-Bl-b5pkt.mjs";
-import "../router-context-D9R1v2Ac.mjs";
-import "../colors-Y7WIFXs7.mjs";
-import "../command-B1CPgsrU.mjs";
-import "../is-command-DJVI6wEJ.mjs";
-import "../is-seeder-D5MIEcdz.mjs";
+import { C as Module, S as MODULE_OPTIONS_KEY, T as isModuleClass, t as ModuleRegistry, w as getModuleOptions } from "../module-qGE_1duv.mjs";
 export { MODULE_OPTIONS_KEY, Module, ModuleRegistry, getModuleOptions, isModuleClass };