@orchestr-sh/orchestr 1.10.0 → 1.11.1

package/dist/Support/Testing/Fakes/EventFake.d.mts

@@ -0,0 +1,294 @@
+import { Event } from "../../../Events/Event.mjs";
+import { Container } from "../../../Container/Container.mjs";
+import { EventListener } from "../../../Events/types.mjs";
+import { DispatcherContract } from "../../../Events/Contracts/Dispatcher.mjs";
+
+//#region src/Support/Testing/Fakes/EventFake.d.ts
+/**
+ * Dispatched Event Record
+ *
+ * Represents a single event dispatch with metadata
+ */
+interface DispatchedEvent {
+  /** The event instance or event name */
+  event: Event | string;
+  /** Additional payload passed to the event */
+  payload: any[];
+  /** Timestamp when the event was dispatched */
+  timestamp: number;
+}
+/**
+ * Event Fake Dispatcher
+ *
+ * A test double for the event dispatcher that records all dispatched events
+ * instead of actually calling listeners. Provides assertion methods to verify
+ * event dispatching behavior in tests.
+ *
+ * @example
+ * ```typescript
+ * // Replace the real dispatcher with a fake
+ * const fake = new EventFake(app);
+ * app.instance('events', fake);
+ *
+ * // Test code that dispatches events
+ * dispatch(new UserRegistered(user));
+ *
+ * // Assert the event was dispatched
+ * fake.assertDispatched(UserRegistered);
+ * fake.assertDispatchedTimes(UserRegistered, 1);
+ * ```
+ */
+declare class EventFake implements DispatcherContract {
+  protected container: Container;
+  /**
+   * All dispatched events organized by event name
+   */
+  protected dispatched: Map<string, DispatchedEvent[]>;
+  /**
+   * Events that should be faked (empty = fake all)
+   */
+  protected fakedEvents: string[];
+  /**
+   * Events that should NOT be faked (all others will be)
+   */
+  protected exceptedEvents: string[];
+  /**
+   * The original dispatcher (for pass-through)
+   */
+  protected originalDispatcher?: DispatcherContract;
+  /**
+   * Registered listeners (for assertListening)
+   */
+  protected listeners: Map<string, EventListener[]>;
+  constructor(container: Container);
+  /**
+   * Set which events should be faked
+   *
+   * @param events - Array of event names or classes to fake
+   */
+  setFakedEvents(events: string[]): void;
+  /**
+   * Set which events should NOT be faked (all others will be)
+   *
+   * @param events - Array of event names or classes to NOT fake
+   */
+  setExceptedEvents(events: string[]): void;
+  /**
+   * Set the original dispatcher for pass-through
+   *
+   * @param dispatcher - The real dispatcher instance
+   */
+  setOriginalDispatcher(dispatcher: DispatcherContract): void;
+  /**
+   * Check if an event should be faked
+   *
+   * @param eventName - The event name to check
+   * @returns true if the event should be faked
+   */
+  protected shouldFake(eventName: string): boolean;
+  /**
+   * Register an event listener
+   *
+   * @param events - Event name(s) to listen for
+   * @param listener - The listener to call
+   */
+  listen(events: string | string[], listener: EventListener): void;
+  /**
+   * Check if an event has listeners
+   *
+   * @param eventName - The event name to check
+   * @returns true if the event has registered listeners
+   */
+  hasListeners(eventName: string): boolean;
+  /**
+   * Register an event subscriber
+   *
+   * @param subscriber - The subscriber instance
+   */
+  subscribe(subscriber: any): void;
+  /**
+   * Dispatch an event
+   *
+   * @param event - The event instance or name
+   * @param payload - Additional arguments to pass
+   * @param halt - Stop on first non-null response
+   * @returns Array of listener results
+   */
+  dispatch(event: string | Event, payload?: any[], halt?: boolean): any[];
+  /**
+   * Dispatch an event until the first non-null response
+   *
+   * @param event - The event instance or name
+   * @param payload - Additional arguments to pass
+   * @returns The first non-null listener result
+   */
+  until(event: string | Event, payload?: any[]): any;
+  /**
+   * Push an event onto the queue for later flushing
+   *
+   * @param event - The event name
+   * @param payload - Additional arguments to pass
+   */
+  push(event: string, payload?: any[]): void;
+  /**
+   * Flush all queued events
+   *
+   * @param event - The event name to flush
+   */
+  flush(event: string): void;
+  /**
+   * Remove all listeners for an event
+   *
+   * @param event - The event name
+   */
+  forget(event: string): void;
+  /**
+   * Clear all queued events
+   */
+  forgetPushed(): void;
+  /**
+   * Get all registered listeners
+   *
+   * @returns Map of event names to listeners
+   */
+  getRawListeners(): Map<string, EventListener[]>;
+  /**
+   * Get the event name from an event instance or string
+   *
+   * @param event - The event instance or name
+   * @returns The event name
+   */
+  protected getEventName(event: string | Event): string;
+  /**
+   * Assert that an event was dispatched
+   *
+   * @param event - The event name or class
+   * @param callback - Optional callback to filter events
+   * @throws Error if the event was not dispatched
+   *
+   * @example
+   * ```typescript
+   * // Assert event was dispatched
+   * fake.assertDispatched(UserRegistered);
+   *
+   * // Assert event with specific properties
+   * fake.assertDispatched(UserRegistered, (event) => {
+   *   return event.user.email === 'test@example.com';
+   * });
+   * ```
+   */
+  assertDispatched(event: string | (new (...args: any[]) => Event), callback?: (event: Event) => boolean): void;
+  /**
+   * Assert that an event was NOT dispatched
+   *
+   * @param event - The event name or class
+   * @param callback - Optional callback to filter events
+   * @throws Error if the event was dispatched
+   *
+   * @example
+   * ```typescript
+   * // Assert event was not dispatched
+   * fake.assertNotDispatched(UserDeleted);
+   *
+   * // Assert event with specific properties was not dispatched
+   * fake.assertNotDispatched(UserRegistered, (event) => {
+   *   return event.user.email === 'admin@example.com';
+   * });
+   * ```
+   */
+  assertNotDispatched(event: string | (new (...args: any[]) => Event), callback?: (event: Event) => boolean): void;
+  /**
+   * Assert that an event was dispatched a specific number of times
+   *
+   * @param event - The event name or class
+   * @param times - Expected number of dispatches
+   * @throws Error if the dispatch count doesn't match
+   *
+   * @example
+   * ```typescript
+   * fake.assertDispatchedTimes(UserRegistered, 3);
+   * ```
+   */
+  assertDispatchedTimes(event: string | (new (...args: any[]) => Event), times: number): void;
+  /**
+   * Assert that no events were dispatched
+   *
+   * @throws Error if any events were dispatched
+   *
+   * @example
+   * ```typescript
+   * fake.assertNothingDispatched();
+   * ```
+   */
+  assertNothingDispatched(): void;
+  /**
+   * Assert that a listener is registered for an event
+   *
+   * @param event - The event name or class
+   * @param listener - Optional specific listener to check for
+   * @throws Error if the listener is not registered
+   *
+   * @example
+   * ```typescript
+   * // Assert any listener is registered
+   * fake.assertListening(UserRegistered);
+   *
+   * // Assert specific listener is registered
+   * fake.assertListening(UserRegistered, SendWelcomeEmail);
+   * ```
+   */
+  assertListening(event: string | (new (...args: any[]) => Event), listener?: string | EventListener): void;
+  /**
+   * Get the name of a listener
+   *
+   * @param listener - The listener instance or closure
+   * @returns The listener name
+   */
+  protected getListenerName(listener: EventListener): string;
+  /**
+   * Get all dispatched events for a given event name
+   *
+   * @param event - The event name or class
+   * @returns Array of dispatched event records
+   *
+   * @example
+   * ```typescript
+   * const dispatches = fake.getDispatched(UserRegistered);
+   * expect(dispatches).toHaveLength(3);
+   * ```
+   */
+  getDispatched(event: string | (new (...args: any[]) => Event)): DispatchedEvent[];
+  /**
+   * Get all dispatched event names
+   *
+   * @returns Array of event names
+   */
+  getDispatchedEventNames(): string[];
+  /**
+   * Get the total count of dispatched events
+   *
+   * @returns Total number of event dispatches
+   */
+  getDispatchedCount(): number;
+  /**
+   * Clear all recorded dispatches
+   *
+   * @example
+   * ```typescript
+   * // Clear between tests
+   * fake.clear();
+   * ```
+   */
+  clear(): void;
+  /**
+   * Clear all registered listeners
+   */
+  clearListeners(): void;
+  /**
+   * Reset the fake completely
+   */
+  reset(): void;
+}
+//#endregion
+export { EventFake };
+//# sourceMappingURL=EventFake.d.mts.map

package/dist/Support/Testing/Fakes/EventFake.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventFake.d.mts","names":[],"sources":["../../../../src/Support/Testing/Fakes/EventFake.ts"],"mappings":";;;;;;;;AAGoD;;;UAO1C,eAAA;EAER;EAAA,KAAA,EAAO,KAAA;EAGP;EAAA,OAAA;EAGS;EAAT,SAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;cAwBW,SAAA,YAAqB,kBAAA;EAAA,UA0BV,SAAA,EAAW,SAAA;EA0WG;;;EAAA,UAhY1B,UAAA,EAAY,GAAA,SAAY,eAAA;EAJgB;;;EAAA,UASxC,WAAA;EAiBuB;;;EAAA,UAZvB,cAAA;EALA;;;EAAA,UAUA,kBAAA,GAAqB,kBAAA;EAKrB;;;EAAA,UAAA,SAAA,EAAW,GAAA,SAAY,aAAA;cAEX,SAAA,EAAW,SAAA;EAAX;;;;;EAOtB,cAAA,CAAe,MAAA;EAkBmB;;;;;EATlC,iBAAA,CAAkB,MAAA;EAwC0B;;;;;EA/B5C,qBAAA,CAAsB,UAAA,EAAY,kBAAA;EAwElC;;;;;;EAAA,UA9DU,UAAA,CAAW,SAAA;EA8Ff;;;;;;EAzEN,MAAA,CAAO,MAAA,qBAA2B,QAAA,EAAU,aAAA;EAqG5C;;;;;;EAlFA,YAAA,CAAa,SAAA;EA6G0B;;;;;EApGvC,SAAA,CAAU,UAAA;EA+H2E;;;;;;;;EAlHrF,QAAA,CAAS,KAAA,WAAgB,KAAA,EAAO,OAAA,UAAqB,IAAA;EA2JgB;;;;;;;EA3HrE,KAAA,CAAM,KAAA,WAAgB,KAAA,EAAO,OAAA;EA8MY;;;;;;EApMzC,IAAA,CAAK,KAAA,UAAe,OAAA;EA+NM;;;;;EAtN1B,KAAA,CAAM,KAAA;EA8PN;;;;;EArPA,MAAA,CAAO,KAAA;EAyRF;;;EAjRL,YAAA,CAAA;;;;;;EASA,eAAA,CAAA,GAAmB,GAAA,SAAY,aAAA;;;;;;;YAUrB,YAAA,CAAa,KAAA,WAAgB,KAAA;;;;;;;;;;;;;;;;;;;EA2BvC,gBAAA,CAAiB,KAAA,oBAAyB,IAAA,YAAgB,KAAA,GAAQ,QAAA,IAAY,KAAA,EAAO,KAAA;;;;;;;;;;;;;;;;;;;EAyCrF,mBAAA,CAAoB,KAAA,oBAAyB,IAAA,YAAgB,KAAA,GAAQ,QAAA,IAAY,KAAA,EAAO,KAAA;;;;;;;;;;;;;EAoCxF,qBAAA,CAAsB,KAAA,oBAAyB,IAAA,YAAgB,KAAA,GAAQ,KAAA;;;;;;;;;;;EAmBvE,uBAAA,CAAA;;;;;;;;;;;;;;;;;EA4BA,eAAA,CAAgB,KAAA,oBAAyB,IAAA,YAAgB,KAAA,GAAQ,QAAA,YAAoB,aAAA;;;;;;;YA2B3E,eAAA,CAAgB,QAAA,EAAU,aAAA;;;;;;;;;;;;;EA8BpC,aAAA,CAAc,KAAA,oBAAyB,IAAA,YAAgB,KAAA,IAAS,eAAA;;;;;;EAUhE,uBAAA,CAAA;;;;;;EASA,kBAAA,CAAA;;;;;;;;;;EAaA,KAAA,CAAA;;;;EAOA,cAAA,CAAA;;;;EAOA,KAAA,CAAA;AAAA"}

package/dist/Support/Testing/Fakes/EventFake.mjs

@@ -0,0 +1,3 @@
+var e=class{dispatched=new Map;fakedEvents=[];exceptedEvents=[];originalDispatcher;listeners=new Map;constructor(e){this.container=e}setFakedEvents(e){this.fakedEvents=e}setExceptedEvents(e){this.exceptedEvents=e}setOriginalDispatcher(e){this.originalDispatcher=e}shouldFake(e){return this.exceptedEvents.length>0?!this.exceptedEvents.includes(e):this.fakedEvents.length>0?this.fakedEvents.includes(e):!0}listen(e,t){let n=Array.isArray(e)?e:[e];for(let e of n)this.listeners.has(e)||this.listeners.set(e,[]),this.listeners.get(e).push(t)}hasListeners(e){return this.listeners.has(e)&&this.listeners.get(e).length>0}subscribe(e){}dispatch(e,t=[],n=!1){let r=this.getEventName(e);return this.shouldFake(r)?(this.dispatched.has(r)||this.dispatched.set(r,[]),this.dispatched.get(r).push({event:e,payload:t,timestamp:Date.now()}),[]):this.originalDispatcher?this.originalDispatcher.dispatch(e,t,n):[]}until(e,t=[]){return this.dispatch(e,t,!0)[0]||null}push(e,t=[]){}flush(e){}forget(e){this.dispatched.delete(e),this.listeners.delete(e)}forgetPushed(){}getRawListeners(){return this.listeners}getEventName(e){return typeof e==`string`?e:e.constructor.name}assertDispatched(e,t){let n=typeof e==`string`?e:e.name,r=this.dispatched.get(n)||[];if(r.length===0){let e=Array.from(this.dispatched.keys()).join(`, `)||`none`;throw Error(`Event [${n}] was not dispatched.\nDispatched events: ${e}`)}if(t&&r.filter(e=>{let n=typeof e.event==`string`?null:e.event;return n&&t(n)}).length===0)throw Error(`Event [${n}] was dispatched ${r.length} time(s) but none matched the provided callback.`)}assertNotDispatched(e,t){let n=typeof e==`string`?e:e.name,r=this.dispatched.get(n)||[];if(!t){if(r.length>0)throw Error(`Event [${n}] was dispatched ${r.length} time(s).`);return}let i=r.filter(e=>{let n=typeof e.event==`string`?null:e.event;return n&&t(n)});if(i.length>0)throw Error(`Event [${n}] was unexpectedly dispatched ${i.length} time(s) matching the provided callback.`)}assertDispatchedTimes(e,t){let n=typeof e==`string`?e:e.name,r=this.dispatched.get(n)||[];if(r.length!==t)throw Error(`Event [${n}] was dispatched ${r.length} time(s) instead of ${t}.`)}assertNothingDispatched(){let e=Array.from(this.dispatched.values()).reduce((e,t)=>e+t.length,0);if(e>0){let t=Array.from(this.dispatched.entries()).map(([e,t])=>`  ${e}: ${t.length}`).join(`
+`);throw Error(`Expected no events to be dispatched, but ${e} were:\n${t}`)}}assertListening(e,t){let n=typeof e==`string`?e:e.name,r=this.listeners.get(n)||[];if(r.length===0)throw Error(`No listeners are registered for event [${n}].`);if(t){let e=typeof t==`string`?t:this.getListenerName(t);if(!r.some(t=>(typeof t==`string`?t:this.getListenerName(t))===e))throw Error(`Listener [${e}] is not registered for event [${n}].`)}}getListenerName(e){return typeof e==`string`?e:typeof e==`function`?e.name||`<Closure>`:typeof e==`object`&&e.constructor?e.constructor.name:`<Unknown>`}getDispatched(e){let t=typeof e==`string`?e:e.name;return this.dispatched.get(t)||[]}getDispatchedEventNames(){return Array.from(this.dispatched.keys())}getDispatchedCount(){return Array.from(this.dispatched.values()).reduce((e,t)=>e+t.length,0)}clear(){this.dispatched.clear()}clearListeners(){this.listeners.clear()}reset(){this.clear(),this.clearListeners(),this.fakedEvents=[],this.exceptedEvents=[],this.originalDispatcher=void 0}};export{e as EventFake};
+//# sourceMappingURL=EventFake.mjs.map

package/dist/Support/Testing/Fakes/EventFake.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventFake.mjs","names":[],"sources":["../../../../src/Support/Testing/Fakes/EventFake.ts"],"sourcesContent":["import type { Container } from '@/Container/Container';\nimport type { DispatcherContract } from '@/Events/Contracts/Dispatcher';\nimport type { Event } from '@/Events/Event';\nimport type { EventListener } from '@/Events/types';\n\n/**\n * Dispatched Event Record\n *\n * Represents a single event dispatch with metadata\n */\ninterface DispatchedEvent {\n  /** The event instance or event name */\n  event: Event | string;\n\n  /** Additional payload passed to the event */\n  payload: any[];\n\n  /** Timestamp when the event was dispatched */\n  timestamp: number;\n}\n\n/**\n * Event Fake Dispatcher\n *\n * A test double for the event dispatcher that records all dispatched events\n * instead of actually calling listeners. Provides assertion methods to verify\n * event dispatching behavior in tests.\n *\n * @example\n * ```typescript\n * // Replace the real dispatcher with a fake\n * const fake = new EventFake(app);\n * app.instance('events', fake);\n *\n * // Test code that dispatches events\n * dispatch(new UserRegistered(user));\n *\n * // Assert the event was dispatched\n * fake.assertDispatched(UserRegistered);\n * fake.assertDispatchedTimes(UserRegistered, 1);\n * ```\n */\nexport class EventFake implements DispatcherContract {\n  /**\n   * All dispatched events organized by event name\n   */\n  protected dispatched: Map<string, DispatchedEvent[]> = new Map();\n\n  /**\n   * Events that should be faked (empty = fake all)\n   */\n  protected fakedEvents: string[] = [];\n\n  /**\n   * Events that should NOT be faked (all others will be)\n   */\n  protected exceptedEvents: string[] = [];\n\n  /**\n   * The original dispatcher (for pass-through)\n   */\n  protected originalDispatcher?: DispatcherContract;\n\n  /**\n   * Registered listeners (for assertListening)\n   */\n  protected listeners: Map<string, EventListener[]> = new Map();\n\n  constructor(protected container: Container) {}\n\n  /**\n   * Set which events should be faked\n   *\n   * @param events - Array of event names or classes to fake\n   */\n  setFakedEvents(events: string[]): void {\n    this.fakedEvents = events;\n  }\n\n  /**\n   * Set which events should NOT be faked (all others will be)\n   *\n   * @param events - Array of event names or classes to NOT fake\n   */\n  setExceptedEvents(events: string[]): void {\n    this.exceptedEvents = events;\n  }\n\n  /**\n   * Set the original dispatcher for pass-through\n   *\n   * @param dispatcher - The real dispatcher instance\n   */\n  setOriginalDispatcher(dispatcher: DispatcherContract): void {\n    this.originalDispatcher = dispatcher;\n  }\n\n  /**\n   * Check if an event should be faked\n   *\n   * @param eventName - The event name to check\n   * @returns true if the event should be faked\n   */\n  protected shouldFake(eventName: string): boolean {\n    // If excepted events are set, fake everything except those\n    if (this.exceptedEvents.length > 0) {\n      return !this.exceptedEvents.includes(eventName);\n    }\n\n    // If faked events are set, only fake those\n    if (this.fakedEvents.length > 0) {\n      return this.fakedEvents.includes(eventName);\n    }\n\n    // Otherwise fake everything\n    return true;\n  }\n\n  /**\n   * Register an event listener\n   *\n   * @param events - Event name(s) to listen for\n   * @param listener - The listener to call\n   */\n  listen(events: string | string[], listener: EventListener): void {\n    // Store listeners for assertListening\n    const eventArray = Array.isArray(events) ? events : [events];\n\n    for (const event of eventArray) {\n      if (!this.listeners.has(event)) {\n        this.listeners.set(event, []);\n      }\n\n      this.listeners.get(event)!.push(listener);\n    }\n  }\n\n  /**\n   * Check if an event has listeners\n   *\n   * @param eventName - The event name to check\n   * @returns true if the event has registered listeners\n   */\n  hasListeners(eventName: string): boolean {\n    return this.listeners.has(eventName) && this.listeners.get(eventName)!.length > 0;\n  }\n\n  /**\n   * Register an event subscriber\n   *\n   * @param subscriber - The subscriber instance\n   */\n  subscribe(subscriber: any): void {\n    // Faked dispatcher doesn't actually register subscribers\n    // but stores them for assertListening\n  }\n\n  /**\n   * Dispatch an event\n   *\n   * @param event - The event instance or name\n   * @param payload - Additional arguments to pass\n   * @param halt - Stop on first non-null response\n   * @returns Array of listener results\n   */\n  dispatch(event: string | Event, payload: any[] = [], halt: boolean = false): any[] {\n    const eventName = this.getEventName(event);\n\n    if (!this.shouldFake(eventName)) {\n      // Pass through to original dispatcher if it exists\n      if (this.originalDispatcher) {\n        return this.originalDispatcher.dispatch(event, payload, halt);\n      }\n      return [];\n    }\n\n    // Record the dispatch\n    if (!this.dispatched.has(eventName)) {\n      this.dispatched.set(eventName, []);\n    }\n\n    this.dispatched.get(eventName)!.push({\n      event,\n      payload,\n      timestamp: Date.now(),\n    });\n\n    return [];\n  }\n\n  /**\n   * Dispatch an event until the first non-null response\n   *\n   * @param event - The event instance or name\n   * @param payload - Additional arguments to pass\n   * @returns The first non-null listener result\n   */\n  until(event: string | Event, payload: any[] = []): any {\n    return this.dispatch(event, payload, true)[0] || null;\n  }\n\n  /**\n   * Push an event onto the queue for later flushing\n   *\n   * @param event - The event name\n   * @param payload - Additional arguments to pass\n   */\n  push(event: string, payload: any[] = []): void {\n    // Not implemented for faked dispatcher\n  }\n\n  /**\n   * Flush all queued events\n   *\n   * @param event - The event name to flush\n   */\n  flush(event: string): void {\n    // Not implemented for faked dispatcher\n  }\n\n  /**\n   * Remove all listeners for an event\n   *\n   * @param event - The event name\n   */\n  forget(event: string): void {\n    this.dispatched.delete(event);\n    this.listeners.delete(event);\n  }\n\n  /**\n   * Clear all queued events\n   */\n  forgetPushed(): void {\n    // Not implemented for faked dispatcher\n  }\n\n  /**\n   * Get all registered listeners\n   *\n   * @returns Map of event names to listeners\n   */\n  getRawListeners(): Map<string, EventListener[]> {\n    return this.listeners;\n  }\n\n  /**\n   * Get the event name from an event instance or string\n   *\n   * @param event - The event instance or name\n   * @returns The event name\n   */\n  protected getEventName(event: string | Event): string {\n    if (typeof event === 'string') {\n      return event;\n    }\n    return event.constructor.name;\n  }\n\n  // ==================== Assertion Methods ====================\n\n  /**\n   * Assert that an event was dispatched\n   *\n   * @param event - The event name or class\n   * @param callback - Optional callback to filter events\n   * @throws Error if the event was not dispatched\n   *\n   * @example\n   * ```typescript\n   * // Assert event was dispatched\n   * fake.assertDispatched(UserRegistered);\n   *\n   * // Assert event with specific properties\n   * fake.assertDispatched(UserRegistered, (event) => {\n   *   return event.user.email === 'test@example.com';\n   * });\n   * ```\n   */\n  assertDispatched(event: string | (new (...args: any[]) => Event), callback?: (event: Event) => boolean): void {\n    const eventName = typeof event === 'string' ? event : event.name;\n    const events = this.dispatched.get(eventName) || [];\n\n    if (events.length === 0) {\n      const dispatchedList = Array.from(this.dispatched.keys()).join(', ') || 'none';\n      throw new Error(`Event [${eventName}] was not dispatched.\\n` + `Dispatched events: ${dispatchedList}`);\n    }\n\n    if (callback) {\n      const matching = events.filter((e) => {\n        const eventObj = typeof e.event === 'string' ? null : e.event;\n        return eventObj && callback(eventObj);\n      });\n\n      if (matching.length === 0) {\n        throw new Error(\n          `Event [${eventName}] was dispatched ${events.length} time(s) ` + `but none matched the provided callback.`\n        );\n      }\n    }\n  }\n\n  /**\n   * Assert that an event was NOT dispatched\n   *\n   * @param event - The event name or class\n   * @param callback - Optional callback to filter events\n   * @throws Error if the event was dispatched\n   *\n   * @example\n   * ```typescript\n   * // Assert event was not dispatched\n   * fake.assertNotDispatched(UserDeleted);\n   *\n   * // Assert event with specific properties was not dispatched\n   * fake.assertNotDispatched(UserRegistered, (event) => {\n   *   return event.user.email === 'admin@example.com';\n   * });\n   * ```\n   */\n  assertNotDispatched(event: string | (new (...args: any[]) => Event), callback?: (event: Event) => boolean): void {\n    const eventName = typeof event === 'string' ? event : event.name;\n    const events = this.dispatched.get(eventName) || [];\n\n    if (!callback) {\n      if (events.length > 0) {\n        throw new Error(`Event [${eventName}] was dispatched ${events.length} time(s).`);\n      }\n      return;\n    }\n\n    const matching = events.filter((e) => {\n      const eventObj = typeof e.event === 'string' ? null : e.event;\n      return eventObj && callback(eventObj);\n    });\n\n    if (matching.length > 0) {\n      throw new Error(\n        `Event [${eventName}] was unexpectedly dispatched ${matching.length} time(s) ` +\n          `matching the provided callback.`\n      );\n    }\n  }\n\n  /**\n   * Assert that an event was dispatched a specific number of times\n   *\n   * @param event - The event name or class\n   * @param times - Expected number of dispatches\n   * @throws Error if the dispatch count doesn't match\n   *\n   * @example\n   * ```typescript\n   * fake.assertDispatchedTimes(UserRegistered, 3);\n   * ```\n   */\n  assertDispatchedTimes(event: string | (new (...args: any[]) => Event), times: number): void {\n    const eventName = typeof event === 'string' ? event : event.name;\n    const events = this.dispatched.get(eventName) || [];\n\n    if (events.length !== times) {\n      throw new Error(`Event [${eventName}] was dispatched ${events.length} time(s) instead of ${times}.`);\n    }\n  }\n\n  /**\n   * Assert that no events were dispatched\n   *\n   * @throws Error if any events were dispatched\n   *\n   * @example\n   * ```typescript\n   * fake.assertNothingDispatched();\n   * ```\n   */\n  assertNothingDispatched(): void {\n    const totalEvents = Array.from(this.dispatched.values()).reduce((sum, events) => sum + events.length, 0);\n\n    if (totalEvents > 0) {\n      const dispatched = Array.from(this.dispatched.entries())\n        .map(([name, events]) => `  ${name}: ${events.length}`)\n        .join('\\n');\n\n      throw new Error(`Expected no events to be dispatched, but ${totalEvents} were:\\n${dispatched}`);\n    }\n  }\n\n  /**\n   * Assert that a listener is registered for an event\n   *\n   * @param event - The event name or class\n   * @param listener - Optional specific listener to check for\n   * @throws Error if the listener is not registered\n   *\n   * @example\n   * ```typescript\n   * // Assert any listener is registered\n   * fake.assertListening(UserRegistered);\n   *\n   * // Assert specific listener is registered\n   * fake.assertListening(UserRegistered, SendWelcomeEmail);\n   * ```\n   */\n  assertListening(event: string | (new (...args: any[]) => Event), listener?: string | EventListener): void {\n    const eventName = typeof event === 'string' ? event : event.name;\n    const eventListeners = this.listeners.get(eventName) || [];\n\n    if (eventListeners.length === 0) {\n      throw new Error(`No listeners are registered for event [${eventName}].`);\n    }\n\n    if (listener) {\n      const listenerName = typeof listener === 'string' ? listener : this.getListenerName(listener);\n      const hasListener = eventListeners.some((l) => {\n        const lName = typeof l === 'string' ? l : this.getListenerName(l);\n        return lName === listenerName;\n      });\n\n      if (!hasListener) {\n        throw new Error(`Listener [${listenerName}] is not registered for event [${eventName}].`);\n      }\n    }\n  }\n\n  /**\n   * Get the name of a listener\n   *\n   * @param listener - The listener instance or closure\n   * @returns The listener name\n   */\n  protected getListenerName(listener: EventListener): string {\n    if (typeof listener === 'string') {\n      return listener;\n    }\n\n    if (typeof listener === 'function') {\n      return listener.name || '<Closure>';\n    }\n\n    if (typeof listener === 'object' && listener.constructor) {\n      return listener.constructor.name;\n    }\n\n    return '<Unknown>';\n  }\n\n  // ==================== Helper Methods ====================\n\n  /**\n   * Get all dispatched events for a given event name\n   *\n   * @param event - The event name or class\n   * @returns Array of dispatched event records\n   *\n   * @example\n   * ```typescript\n   * const dispatches = fake.getDispatched(UserRegistered);\n   * expect(dispatches).toHaveLength(3);\n   * ```\n   */\n  getDispatched(event: string | (new (...args: any[]) => Event)): DispatchedEvent[] {\n    const eventName = typeof event === 'string' ? event : event.name;\n    return this.dispatched.get(eventName) || [];\n  }\n\n  /**\n   * Get all dispatched event names\n   *\n   * @returns Array of event names\n   */\n  getDispatchedEventNames(): string[] {\n    return Array.from(this.dispatched.keys());\n  }\n\n  /**\n   * Get the total count of dispatched events\n   *\n   * @returns Total number of event dispatches\n   */\n  getDispatchedCount(): number {\n    return Array.from(this.dispatched.values()).reduce((sum, events) => sum + events.length, 0);\n  }\n\n  /**\n   * Clear all recorded dispatches\n   *\n   * @example\n   * ```typescript\n   * // Clear between tests\n   * fake.clear();\n   * ```\n   */\n  clear(): void {\n    this.dispatched.clear();\n  }\n\n  /**\n   * Clear all registered listeners\n   */\n  clearListeners(): void {\n    this.listeners.clear();\n  }\n\n  /**\n   * Reset the fake completely\n   */\n  reset(): void {\n    this.clear();\n    this.clearListeners();\n    this.fakedEvents = [];\n    this.exceptedEvents = [];\n    this.originalDispatcher = undefined;\n  }\n}\n"],"mappings":"AA0CA,IAAa,EAAb,KAAqD,CAInD,WAAuD,IAAI,IAK3D,YAAkC,EAAE,CAKpC,eAAqC,EAAE,CAKvC,mBAKA,UAAoD,IAAI,IAExD,YAAY,EAAgC,CAAtB,KAAA,UAAA,EAOtB,eAAe,EAAwB,CACrC,KAAK,YAAc,EAQrB,kBAAkB,EAAwB,CACxC,KAAK,eAAiB,EAQxB,sBAAsB,EAAsC,CAC1D,KAAK,mBAAqB,EAS5B,WAAqB,EAA4B,CAY/C,OAVI,KAAK,eAAe,OAAS,EACxB,CAAC,KAAK,eAAe,SAAS,EAAU,CAI7C,KAAK,YAAY,OAAS,EACrB,KAAK,YAAY,SAAS,EAAU,CAItC,GAST,OAAO,EAA2B,EAA+B,CAE/D,IAAM,EAAa,MAAM,QAAQ,EAAO,CAAG,EAAS,CAAC,EAAO,CAE5D,IAAK,IAAM,KAAS,EACb,KAAK,UAAU,IAAI,EAAM,EAC5B,KAAK,UAAU,IAAI,EAAO,EAAE,CAAC,CAG/B,KAAK,UAAU,IAAI,EAAM,CAAE,KAAK,EAAS,CAU7C,aAAa,EAA4B,CACvC,OAAO,KAAK,UAAU,IAAI,EAAU,EAAI,KAAK,UAAU,IAAI,EAAU,CAAE,OAAS,EAQlF,UAAU,EAAuB,EAajC,SAAS,EAAuB,EAAiB,EAAE,CAAE,EAAgB,GAAc,CACjF,IAAM,EAAY,KAAK,aAAa,EAAM,CAqB1C,OAnBK,KAAK,WAAW,EAAU,EAS1B,KAAK,WAAW,IAAI,EAAU,EACjC,KAAK,WAAW,IAAI,EAAW,EAAE,CAAC,CAGpC,KAAK,WAAW,IAAI,EAAU,CAAE,KAAK,CACnC,QACA,UACA,UAAW,KAAK,KAAK,CACtB,CAAC,CAEK,EAAE,EAjBH,KAAK,mBACA,KAAK,mBAAmB,SAAS,EAAO,EAAS,EAAK,CAExD,EAAE,CAwBb,MAAM,EAAuB,EAAiB,EAAE,CAAO,CACrD,OAAO,KAAK,SAAS,EAAO,EAAS,GAAK,CAAC,IAAM,KASnD,KAAK,EAAe,EAAiB,EAAE,CAAQ,EAS/C,MAAM,EAAqB,EAS3B,OAAO,EAAqB,CAC1B,KAAK,WAAW,OAAO,EAAM,CAC7B,KAAK,UAAU,OAAO,EAAM,CAM9B,cAAqB,EASrB,iBAAgD,CAC9C,OAAO,KAAK,UASd,aAAuB,EAA+B,CAIpD,OAHI,OAAO,GAAU,SACZ,EAEF,EAAM,YAAY,KAuB3B,iBAAiB,EAAiD,EAA4C,CAC5G,IAAM,EAAY,OAAO,GAAU,SAAW,EAAQ,EAAM,KACtD,EAAS,KAAK,WAAW,IAAI,EAAU,EAAI,EAAE,CAEnD,GAAI,EAAO,SAAW,EAAG,CACvB,IAAM,EAAiB,MAAM,KAAK,KAAK,WAAW,MAAM,CAAC,CAAC,KAAK,KAAK,EAAI,OACxE,MAAU,MAAM,UAAU,EAAU,4CAAiD,IAAiB,CAGxG,GAAI,GACe,EAAO,OAAQ,GAAM,CACpC,IAAM,EAAW,OAAO,EAAE,OAAU,SAAW,KAAO,EAAE,MACxD,OAAO,GAAY,EAAS,EAAS,EACrC,CAEW,SAAW,EACtB,MAAU,MACR,UAAU,EAAU,mBAAmB,EAAO,OAAO,kDACtD,CAuBP,oBAAoB,EAAiD,EAA4C,CAC/G,IAAM,EAAY,OAAO,GAAU,SAAW,EAAQ,EAAM,KACtD,EAAS,KAAK,WAAW,IAAI,EAAU,EAAI,EAAE,CAEnD,GAAI,CAAC,EAAU,CACb,GAAI,EAAO,OAAS,EAClB,MAAU,MAAM,UAAU,EAAU,mBAAmB,EAAO,OAAO,WAAW,CAElF,OAGF,IAAM,EAAW,EAAO,OAAQ,GAAM,CACpC,IAAM,EAAW,OAAO,EAAE,OAAU,SAAW,KAAO,EAAE,MACxD,OAAO,GAAY,EAAS,EAAS,EACrC,CAEF,GAAI,EAAS,OAAS,EACpB,MAAU,MACR,UAAU,EAAU,gCAAgC,EAAS,OAAO,0CAErE,CAgBL,sBAAsB,EAAiD,EAAqB,CAC1F,IAAM,EAAY,OAAO,GAAU,SAAW,EAAQ,EAAM,KACtD,EAAS,KAAK,WAAW,IAAI,EAAU,EAAI,EAAE,CAEnD,GAAI,EAAO,SAAW,EACpB,MAAU,MAAM,UAAU,EAAU,mBAAmB,EAAO,OAAO,sBAAsB,EAAM,GAAG,CAcxG,yBAAgC,CAC9B,IAAM,EAAc,MAAM,KAAK,KAAK,WAAW,QAAQ,CAAC,CAAC,QAAQ,EAAK,IAAW,EAAM,EAAO,OAAQ,EAAE,CAExG,GAAI,EAAc,EAAG,CACnB,IAAM,EAAa,MAAM,KAAK,KAAK,WAAW,SAAS,CAAC,CACrD,KAAK,CAAC,EAAM,KAAY,KAAK,EAAK,IAAI,EAAO,SAAS,CACtD,KAAK;EAAK,CAEb,MAAU,MAAM,4CAA4C,EAAY,UAAU,IAAa,EAoBnG,gBAAgB,EAAiD,EAAyC,CACxG,IAAM,EAAY,OAAO,GAAU,SAAW,EAAQ,EAAM,KACtD,EAAiB,KAAK,UAAU,IAAI,EAAU,EAAI,EAAE,CAE1D,GAAI,EAAe,SAAW,EAC5B,MAAU,MAAM,0CAA0C,EAAU,IAAI,CAG1E,GAAI,EAAU,CACZ,IAAM,EAAe,OAAO,GAAa,SAAW,EAAW,KAAK,gBAAgB,EAAS,CAM7F,GAAI,CALgB,EAAe,KAAM,IACzB,OAAO,GAAM,SAAW,EAAI,KAAK,gBAAgB,EAAE,IAChD,EACjB,CAGA,MAAU,MAAM,aAAa,EAAa,iCAAiC,EAAU,IAAI,EAW/F,gBAA0B,EAAiC,CAazD,OAZI,OAAO,GAAa,SACf,EAGL,OAAO,GAAa,WACf,EAAS,MAAQ,YAGtB,OAAO,GAAa,UAAY,EAAS,YACpC,EAAS,YAAY,KAGvB,YAiBT,cAAc,EAAoE,CAChF,IAAM,EAAY,OAAO,GAAU,SAAW,EAAQ,EAAM,KAC5D,OAAO,KAAK,WAAW,IAAI,EAAU,EAAI,EAAE,CAQ7C,yBAAoC,CAClC,OAAO,MAAM,KAAK,KAAK,WAAW,MAAM,CAAC,CAQ3C,oBAA6B,CAC3B,OAAO,MAAM,KAAK,KAAK,WAAW,QAAQ,CAAC,CAAC,QAAQ,EAAK,IAAW,EAAM,EAAO,OAAQ,EAAE,CAY7F,OAAc,CACZ,KAAK,WAAW,OAAO,CAMzB,gBAAuB,CACrB,KAAK,UAAU,OAAO,CAMxB,OAAc,CACZ,KAAK,OAAO,CACZ,KAAK,gBAAgB,CACrB,KAAK,YAAc,EAAE,CACrB,KAAK,eAAiB,EAAE,CACxB,KAAK,mBAAqB,IAAA"}

package/dist/Support/ValidateRequest.cjs

@@ -0,0 +1 @@
+require(`../_virtual/_rolldown/runtime.cjs`);function e(){return(e,t,n)=>{}}exports.ValidateRequest=e;

package/dist/Support/ValidateRequest.d.cts

@@ -0,0 +1,22 @@
+//#region src/Support/ValidateRequest.d.ts
+/**
+ * ValidateRequest Decorator
+ *
+ * Marks a controller method to enable automatic FormRequest validation.
+ * This decorator triggers TypeScript to emit parameter metadata for the method.
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * export class UserController extends Controller {
+ *   @ValidateRequest()
+ *   async store(request: StoreUserRequest, res: Response) {
+ *     // request is automatically validated
+ *   }
+ * }
+ * ```
+ */
+declare function ValidateRequest(): MethodDecorator;
+//#endregion
+export { ValidateRequest };
+//# sourceMappingURL=ValidateRequest.d.cts.map

package/dist/Support/ValidateRequest.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidateRequest.d.cts","names":[],"sources":["../../src/Support/ValidateRequest.ts"],"mappings":";;AAiBA;;;;;;;;;;;;;;;;iBAAgB,eAAA,CAAA,GAAmB,eAAA"}

package/dist/Support/ValidateRequest.d.mts

@@ -0,0 +1,22 @@
+//#region src/Support/ValidateRequest.d.ts
+/**
+ * ValidateRequest Decorator
+ *
+ * Marks a controller method to enable automatic FormRequest validation.
+ * This decorator triggers TypeScript to emit parameter metadata for the method.
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * export class UserController extends Controller {
+ *   @ValidateRequest()
+ *   async store(request: StoreUserRequest, res: Response) {
+ *     // request is automatically validated
+ *   }
+ * }
+ * ```
+ */
+declare function ValidateRequest(): MethodDecorator;
+//#endregion
+export { ValidateRequest };
+//# sourceMappingURL=ValidateRequest.d.mts.map

package/dist/Support/ValidateRequest.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidateRequest.d.mts","names":[],"sources":["../../src/Support/ValidateRequest.ts"],"mappings":";;AAiBA;;;;;;;;;;;;;;;;iBAAgB,eAAA,CAAA,GAAmB,eAAA"}

package/dist/Support/ValidateRequest.mjs

@@ -0,0 +1,2 @@
+function e(){return(e,t,n)=>{}}export{e as ValidateRequest};
+//# sourceMappingURL=ValidateRequest.mjs.map

package/dist/Support/ValidateRequest.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidateRequest.mjs","names":[],"sources":["../../src/Support/ValidateRequest.ts"],"sourcesContent":["/**\n * ValidateRequest Decorator\n *\n * Marks a controller method to enable automatic FormRequest validation.\n * This decorator triggers TypeScript to emit parameter metadata for the method.\n *\n * @example\n * ```typescript\n * @Injectable()\n * export class UserController extends Controller {\n *   @ValidateRequest()\n *   async store(request: StoreUserRequest, res: Response) {\n *     // request is automatically validated\n *   }\n * }\n * ```\n */\nexport function ValidateRequest(): MethodDecorator {\n  return (target: any, propertyKey: string | symbol, descriptor: PropertyDescriptor) => {\n    // This decorator is intentionally empty.\n    // Its sole purpose is to trigger TypeScript's emitDecoratorMetadata\n    // feature, which adds reflection metadata about method parameters.\n  };\n}\n"],"mappings":"AAiBA,SAAgB,GAAmC,CACjD,OAAQ,EAAa,EAA8B,IAAmC"}

package/dist/Support/helpers.cjs

@@ -0,0 +1 @@
+require(`../_virtual/_rolldown/runtime.cjs`);let e=null;function t(t){e=t}function n(){return e}function r(t,n){if(!e)throw Error(`Application not initialized. Call setGlobalApp() first.`);let r=e.make(`config`);return t===void 0?r:r.get(t,n)}async function i(e){try{await import(e)}catch(t){throw Error(`Failed to load routes from ${e}: ${t}`,{cause:t})}}function a(e=``){return`${process.cwd()}${e?`/`+e:``}`}function o(e=``){return a(`routes${e?`/`+e:``}`)}function s(e=``){return a(`resources${e?`/`+e:``}`)}function c(t,n={}){if(!e)throw Error(`Application not initialized. Call setGlobalApp() first.`);return e.make(`view`).make(t,n)}exports.base_path=a,exports.config=r,exports.getGlobalApp=n,exports.loadRoutes=i,exports.resource_path=s,exports.routes_path=o,exports.setGlobalApp=t,exports.view=c;

package/dist/Support/helpers.d.cts

@@ -0,0 +1,42 @@
+import { Config } from "../Foundation/Config/Config.cjs";
+import { View } from "../View/View.cjs";
+
+//#region src/Support/helpers.d.ts
+/**
+ * Get a configuration value
+ * Laravel: config('app.name') or config('app.name', 'default')
+ *
+ * @param {string} key
+ * @param {any} defaultValue
+ * @returns {any}
+ */
+declare function config<T = any>(key?: string, defaultValue?: T): T | Config;
+/**
+ * Load routes from a directory
+ * This helper allows you to dynamically import route files
+ */
+declare function loadRoutes(routePath: string): Promise<void>;
+/**
+ * Resolve a path relative to the base path
+ */
+declare function base_path(path?: string): string;
+/**
+ * Get the routes directory path
+ */
+declare function routes_path(path?: string): string;
+/**
+ * Get the resources/views directory path
+ */
+declare function resource_path(path?: string): string;
+/**
+ * Create a new view instance.
+ * Laravel: view('welcome', ['name' => 'John'])
+ *
+ * @param {string} name   - Dot-notation view name (e.g. 'welcome', 'layouts.app')
+ * @param {Record<string, any>} data - Data to pass to the view
+ * @returns {View}
+ */
+declare function view(name: string, data?: Record<string, any>): View;
+//#endregion
+export { base_path, config, loadRoutes, resource_path, routes_path, view };
+//# sourceMappingURL=helpers.d.cts.map

package/dist/Support/helpers.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.cts","names":[],"sources":["../../src/Support/helpers.ts"],"mappings":";;;;;;;;;AAuDA;;;iBAnBgB,MAAA,SAAA,CAAgB,GAAA,WAAc,YAAA,GAAe,CAAA,GAAI,CAAA,GAAI,MAAA;;AA8BrE;;;iBAXsB,UAAA,CAAW,SAAA,WAAoB,OAAA;;AAkBrD;;iBAPgB,SAAA,CAAU,IAAA;;;AAc1B;iBAPgB,WAAA,CAAY,IAAA;;;;iBAOZ,aAAA,CAAc,IAAA;;;;;;;;;iBAYd,IAAA,CAAK,IAAA,UAAc,IAAA,GAAM,MAAA,gBAA2B,IAAA"}

package/dist/Support/helpers.d.mts

@@ -0,0 +1,42 @@
+import { Config } from "../Foundation/Config/Config.mjs";
+import { View } from "../View/View.mjs";
+
+//#region src/Support/helpers.d.ts
+/**
+ * Get a configuration value
+ * Laravel: config('app.name') or config('app.name', 'default')
+ *
+ * @param {string} key
+ * @param {any} defaultValue
+ * @returns {any}
+ */
+declare function config<T = any>(key?: string, defaultValue?: T): T | Config;
+/**
+ * Load routes from a directory
+ * This helper allows you to dynamically import route files
+ */
+declare function loadRoutes(routePath: string): Promise<void>;
+/**
+ * Resolve a path relative to the base path
+ */
+declare function base_path(path?: string): string;
+/**
+ * Get the routes directory path
+ */
+declare function routes_path(path?: string): string;
+/**
+ * Get the resources/views directory path
+ */
+declare function resource_path(path?: string): string;
+/**
+ * Create a new view instance.
+ * Laravel: view('welcome', ['name' => 'John'])
+ *
+ * @param {string} name   - Dot-notation view name (e.g. 'welcome', 'layouts.app')
+ * @param {Record<string, any>} data - Data to pass to the view
+ * @returns {View}
+ */
+declare function view(name: string, data?: Record<string, any>): View;
+//#endregion
+export { base_path, config, loadRoutes, resource_path, routes_path, view };
+//# sourceMappingURL=helpers.d.mts.map

package/dist/Support/helpers.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.mts","names":[],"sources":["../../src/Support/helpers.ts"],"mappings":";;;;;;;;;AAuDA;;;iBAnBgB,MAAA,SAAA,CAAgB,GAAA,WAAc,YAAA,GAAe,CAAA,GAAI,CAAA,GAAI,MAAA;;AA8BrE;;;iBAXsB,UAAA,CAAW,SAAA,WAAoB,OAAA;;AAkBrD;;iBAPgB,SAAA,CAAU,IAAA;;;AAc1B;iBAPgB,WAAA,CAAY,IAAA;;;;iBAOZ,aAAA,CAAc,IAAA;;;;;;;;;iBAYd,IAAA,CAAK,IAAA,UAAc,IAAA,GAAM,MAAA,gBAA2B,IAAA"}

package/dist/Support/helpers.mjs

@@ -0,0 +1,2 @@
+let e=null;function t(t){e=t}function n(){return e}function r(t,n){if(!e)throw Error(`Application not initialized. Call setGlobalApp() first.`);let r=e.make(`config`);return t===void 0?r:r.get(t,n)}async function i(e){try{await import(e)}catch(t){throw Error(`Failed to load routes from ${e}: ${t}`,{cause:t})}}function a(e=``){return`${process.cwd()}${e?`/`+e:``}`}function o(e=``){return a(`routes${e?`/`+e:``}`)}function s(e=``){return a(`resources${e?`/`+e:``}`)}function c(t,n={}){if(!e)throw Error(`Application not initialized. Call setGlobalApp() first.`);return e.make(`view`).make(t,n)}export{a as base_path,r as config,n as getGlobalApp,i as loadRoutes,s as resource_path,o as routes_path,t as setGlobalApp,c as view};
+//# sourceMappingURL=helpers.mjs.map

package/dist/Support/helpers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.mjs","names":[],"sources":["../../src/Support/helpers.ts"],"sourcesContent":["/**\n * Helper functions - Laravel-style global helpers\n */\n\nimport type { Config as ConfigClass } from '@/Foundation/Config/Config';\nimport type { View } from '@/View/View';\nimport type { ViewFactory } from '@/View/ViewFactory';\nimport { Application } from '@/Foundation/Application';\n\n// Global application instance for helpers\nlet globalApp: Application | null = null;\n\n/**\n * Set the global application instance\n * @internal\n */\nexport function setGlobalApp(app: Application): void {\n  globalApp = app;\n}\n\n/**\n * Get the global application instance\n * @internal\n */\nexport function getGlobalApp(): Application | null {\n  return globalApp;\n}\n\n/**\n * Get a configuration value\n * Laravel: config('app.name') or config('app.name', 'default')\n *\n * @param {string} key\n * @param {any} defaultValue\n * @returns {any}\n */\nexport function config<T = any>(key?: string, defaultValue?: T): T | ConfigClass {\n  if (!globalApp) {\n    throw new Error('Application not initialized. Call setGlobalApp() first.');\n  }\n\n  const configInstance = globalApp.make<ConfigClass>('config');\n\n  // If no key provided, return the config instance\n  if (key === undefined) {\n    return configInstance as any;\n  }\n\n  return configInstance.get(key, defaultValue);\n}\n\n/**\n * Load routes from a directory\n * This helper allows you to dynamically import route files\n */\nexport async function loadRoutes(routePath: string): Promise<void> {\n  try {\n    await import(routePath);\n  } catch (error) {\n    throw new Error(`Failed to load routes from ${routePath}: ${error}`, { cause: error });\n  }\n}\n\n/**\n * Resolve a path relative to the base path\n */\nexport function base_path(path: string = ''): string {\n  return `${process.cwd()}${path ? '/' + path : ''}`;\n}\n\n/**\n * Get the routes directory path\n */\nexport function routes_path(path: string = ''): string {\n  return base_path(`routes${path ? '/' + path : ''}`);\n}\n\n/**\n * Get the resources/views directory path\n */\nexport function resource_path(path: string = ''): string {\n  return base_path(`resources${path ? '/' + path : ''}`);\n}\n\n/**\n * Create a new view instance.\n * Laravel: view('welcome', ['name' => 'John'])\n *\n * @param {string} name   - Dot-notation view name (e.g. 'welcome', 'layouts.app')\n * @param {Record<string, any>} data - Data to pass to the view\n * @returns {View}\n */\nexport function view(name: string, data: Record<string, any> = {}): View {\n  if (!globalApp) {\n    throw new Error('Application not initialized. Call setGlobalApp() first.');\n  }\n\n  const factory = globalApp.make<ViewFactory>('view');\n  return factory.make(name, data);\n}\n"],"mappings":"AAUA,IAAI,EAAgC,KAMpC,SAAgB,EAAa,EAAwB,CACnD,EAAY,EAOd,SAAgB,GAAmC,CACjD,OAAO,EAWT,SAAgB,EAAgB,EAAc,EAAmC,CAC/E,GAAI,CAAC,EACH,MAAU,MAAM,0DAA0D,CAG5E,IAAM,EAAiB,EAAU,KAAkB,SAAS,CAO5D,OAJI,IAAQ,IAAA,GACH,EAGF,EAAe,IAAI,EAAK,EAAa,CAO9C,eAAsB,EAAW,EAAkC,CACjE,GAAI,CACF,MAAM,OAAO,SACN,EAAO,CACd,MAAU,MAAM,8BAA8B,EAAU,IAAI,IAAS,CAAE,MAAO,EAAO,CAAC,EAO1F,SAAgB,EAAU,EAAe,GAAY,CACnD,MAAO,GAAG,QAAQ,KAAK,GAAG,EAAO,IAAM,EAAO,KAMhD,SAAgB,EAAY,EAAe,GAAY,CACrD,OAAO,EAAU,SAAS,EAAO,IAAM,EAAO,KAAK,CAMrD,SAAgB,EAAc,EAAe,GAAY,CACvD,OAAO,EAAU,YAAY,EAAO,IAAM,EAAO,KAAK,CAWxD,SAAgB,EAAK,EAAc,EAA4B,EAAE,CAAQ,CACvE,GAAI,CAAC,EACH,MAAU,MAAM,0DAA0D,CAI5E,OADgB,EAAU,KAAkB,OAAO,CACpC,KAAK,EAAM,EAAK"}

package/dist/View/Engines/FileEngine.cjs

@@ -0,0 +1 @@
+require(`../../_virtual/_rolldown/runtime.cjs`);let e=require(`fs`);var t=class{async get(t,n){return(0,e.readFileSync)(t,`utf8`)}};exports.FileEngine=t;

package/dist/View/Engines/FileEngine.d.cts

@@ -0,0 +1,13 @@
+import { ViewEngine } from "./ViewEngine.cjs";
+
+//#region src/View/Engines/FileEngine.d.ts
+declare class FileEngine implements ViewEngine {
+  /**
+   * Get the evaluated contents of the view.
+   * Returns the raw file content without any processing.
+   */
+  get(path: string, _data: Record<string, any>): Promise<string>;
+}
+//#endregion
+export { FileEngine };
+//# sourceMappingURL=FileEngine.d.cts.map

package/dist/View/Engines/FileEngine.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileEngine.d.cts","names":[],"sources":["../../../src/View/Engines/FileEngine.ts"],"mappings":";;;cAUa,UAAA,YAAsB,UAAA;EAAA;;;;EAK3B,GAAA,CAAI,IAAA,UAAc,KAAA,EAAO,MAAA,gBAAsB,OAAA;AAAA"}

package/dist/View/Engines/FileEngine.d.mts

@@ -0,0 +1,13 @@
+import { ViewEngine } from "./ViewEngine.mjs";
+
+//#region src/View/Engines/FileEngine.d.ts
+declare class FileEngine implements ViewEngine {
+  /**
+   * Get the evaluated contents of the view.
+   * Returns the raw file content without any processing.
+   */
+  get(path: string, _data: Record<string, any>): Promise<string>;
+}
+//#endregion
+export { FileEngine };
+//# sourceMappingURL=FileEngine.d.mts.map

package/dist/View/Engines/FileEngine.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileEngine.d.mts","names":[],"sources":["../../../src/View/Engines/FileEngine.ts"],"mappings":";;;cAUa,UAAA,YAAsB,UAAA;EAAA;;;;EAK3B,GAAA,CAAI,IAAA,UAAc,KAAA,EAAO,MAAA,gBAAsB,OAAA;AAAA"}

package/dist/View/Engines/FileEngine.mjs

@@ -0,0 +1,2 @@
+import{readFileSync as e}from"fs";var t=class{async get(t,n){return e(t,`utf8`)}};export{t as FileEngine};
+//# sourceMappingURL=FileEngine.mjs.map

package/dist/View/Engines/FileEngine.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileEngine.mjs","names":[],"sources":["../../../src/View/Engines/FileEngine.ts"],"sourcesContent":["/**\n * FileEngine - Raw file engine (no template processing)\n *\n * Reads the file from disk and returns its contents as-is.\n * Mirrors Laravel's Illuminate\\View\\Engines\\FileEngine\n */\n\nimport { readFileSync } from 'fs';\nimport type { ViewEngine } from './ViewEngine';\n\nexport class FileEngine implements ViewEngine {\n  /**\n   * Get the evaluated contents of the view.\n   * Returns the raw file content without any processing.\n   */\n  async get(path: string, _data: Record<string, any>): Promise<string> {\n    return readFileSync(path, 'utf8');\n  }\n}\n"],"mappings":"kCAUA,IAAa,EAAb,KAA8C,CAK5C,MAAM,IAAI,EAAc,EAA6C,CACnE,OAAO,EAAa,EAAM,OAAO"}

package/dist/View/Engines/TemplateEngine.cjs

@@ -0,0 +1 @@
+require(`../../_virtual/_rolldown/runtime.cjs`);let e=require(`fs`);var t=class{resolver=null;setResolver(e){this.resolver=e}async get(t,n){let r=(0,e.readFileSync)(t,`utf8`);return this.compile(r,n)}async compile(e,t){let n=e.match(/@extends\(\s*['"]([^'"]+)['"]\s*\)/),r;r=n?await this.compileWithLayout(e,n[1],t):e;let i=await this.processIncludes(r,t);return this.processSync(i,t)}processSync(e,t){let n=e;return n=this.processIf(n,t),n=this.processForeach(n,t),n=this.processEscapedOutput(n,t),n=this.processRawOutput(n,t),n}async compileWithLayout(t,n,r){let i=this.extractSections(t);return(0,e.readFileSync)(this.resolveName(n),`utf8`).replace(/@yield\(\s*['"]([^'"]+)['"]\s*(?:,\s*['"]([^'"]*)['"]\s*)?\)/g,(e,t,n=``)=>i[t]===void 0?n:i[t])}extractSections(e){let t={},n=/@section\(\s*['"]([^'"]+)['"]\s*\)([\s\S]*?)@endsection/g,r;for(;(r=n.exec(e))!==null;)t[r[1]]=r[2].trim();return t}async processIncludes(t,n){let r=/@include\(\s*['"]([^'"]+)['"]\s*(?:,\s*(\{[^}]*\}))?\s*\)/g,i=[],a;for(;(a=r.exec(t))!==null;)i.push({full:a[0],name:a[1],extraData:a[2]});let o=t;for(let{full:t,name:r,extraData:a}of i){let i={...n};if(a)try{let e=this.parseSimpleObject(a);i={...i,...e}}catch{}let s=(0,e.readFileSync)(this.resolveName(r),`utf8`),c=await this.compile(s,i);o=o.replace(t,c)}return o}processIf(e,t){let n=e.indexOf(`@if(`);if(n===-1)return e;let r=n+4,i=1,a=r;for(;a<e.length&&i>0;)e[a]===`(`?i++:e[a]===`)`&&i--,i>0&&a++;let o=e.slice(r,a),s=1,c=a+1,l=[],u=a+1,d=o;for(;c<e.length&&s>0;)if(e.startsWith(`@if(`,c))s++,c+=4;else if(e.startsWith(`@endif`,c)&&s===1){l.push({condition:d,body:e.slice(u,c)}),c+=6;break}else if(e.startsWith(`@endif`,c))s--,c++;else if(s===1&&e.startsWith(`@elseif(`,c)){l.push({condition:d,body:e.slice(u,c)});let t=c+8,n=1,r=t;for(;r<e.length&&n>0;)e[r]===`(`?n++:e[r]===`)`&&n--,n>0&&r++;d=e.slice(t,r),u=r+1,c=r+1}else s===1&&e.startsWith(`@else`,c)&&!e.startsWith(`@elseif(`,c)?(l.push({condition:d,body:e.slice(u,c)}),d=`__else__`,u=c+5,c+=5):c++;let f=``;for(let e of l){if(e.condition===`__else__`){f=e.body;break}try{if(this.evaluate(e.condition,t)){f=e.body;break}}catch{}}let p=e.slice(0,n),m=e.slice(c),h=p+f+m;return this.processIf(h,t)}processForeach(e,t){return e.replace(/@foreach\(([^)]+)\s+as\s+(\w+)(?:\s*,\s*(\w+))?\)([\s\S]*?)@endforeach/g,(e,n,r,i,a)=>{let o;try{o=this.evaluate(n.trim(),t)}catch{return``}return!o||typeof o!=`object`?``:(Array.isArray(o)?o.map((e,t)=>[t,e]):Object.entries(o)).map(([e,n])=>{let o={...t,[r]:n};return i&&(o[i]=e),this.processSync(a,o)}).join(``)})}processEscapedOutput(e,t){return e.replace(/\{\{\s*([\s\S]+?)\s*\}\}/g,(e,n)=>{try{let e=this.evaluate(n.trim(),t);return this.escapeHtml(String(e??``))}catch{return``}})}processRawOutput(e,t){return e.replace(/\{!!\s*([\s\S]+?)\s*!!\}/g,(e,n)=>{try{let e=this.evaluate(n.trim(),t);return String(e??``)}catch{return``}})}evaluate(e,t){let n=Object.keys(t),r=Object.values(t);return Function(...n,`return (${e});`)(...r)}escapeHtml(e){return e.replace(/&/g,`&amp;`).replace(/</g,`&lt;`).replace(/>/g,`&gt;`).replace(/"/g,`&quot;`).replace(/'/g,`&#039;`)}resolveName(e){if(!this.resolver)throw Error(`TemplateEngine: No resolver set. Cannot resolve view "${e}". Call setResolver() before using @include or @extends.`);return this.resolver.findView(e)}parseSimpleObject(e){let t=e.trim().replace(/^\{/,``).replace(/\}$/,``).trim(),n={},r=/(\w+)\s*:\s*(?:'([^']*)'|"([^"]*)"|(true|false|\d+(?:\.\d+)?))/g,i;for(;(i=r.exec(t))!==null;){let e=i[1],t=i[2]??i[3],r=i[4];t===void 0?r===`true`?n[e]=!0:r===`false`?n[e]=!1:r!==void 0&&(n[e]=Number(r)):n[e]=t}return n}};exports.TemplateEngine=t;