@lithia-js/core 1.0.0-canary.16 → 1.0.0-canary.18

package/dist/builder.d.mts

@@ -1,27 +1,21 @@
-/**
- * @fileoverview Lithia Build Orchestrator (TypeScript).
- * Coordinates scanning, SWC compilation of the entire source directory,
- * and manifest generation for framework domains.
- */
+import { FileScanner } from "./scanner.mjs";
+import { EventManifestGenerator } from "./strategy/events/manifest.mjs";
+import { FunctionManifestGenerator } from "./strategy/functions/manifest.mjs";
+import { RouteManifestGenerator } from "./strategy/routes/manifest.mjs";
 export interface BuildConfig {
-    /** Source directory (e.g., "src" or project root). */
     sourceDir: string;
-    /** Output directory (e.g., "dist"). */
     outRoot: string;
 }
 export declare class Builder {
-    private scanner;
-    private routeGenerator;
-    private eventGenerator;
-    private functionGenerator;
+    private _scanner;
+    private _routeGenerator;
+    private _eventGenerator;
+    private _functionGenerator;
     constructor();
-    /**
-     * Runs the full compilation pipeline: Scan -> Transpile (SWC) -> Manifest.
-     */
+    get scanner(): FileScanner;
+    get routeGenerator(): RouteManifestGenerator;
+    get eventGenerator(): EventManifestGenerator;
+    get functionGenerator(): FunctionManifestGenerator;
     build(config: BuildConfig): Promise<void>;
-    /**
-     * Compiles all discovered files using SWC.
-     * Processes files in parallel for maximum speed.
-     */
     private compileFiles;
 }

package/dist/builder.mjs

@@ -1,8 +1,3 @@
-/**
- * @fileoverview Lithia Build Orchestrator (TypeScript).
- * Coordinates scanning, SWC compilation of the entire source directory,
- * and manifest generation for framework domains.
- */
 import fs, { rm } from "node:fs/promises";
 import path from "node:path";
 import * as swc from "@swc/core";
@@ -12,32 +7,37 @@ import { FunctionManifestGenerator } from "./strategy/functions/manifest.mjs";
 import { RouteManifestGenerator } from "./strategy/routes/manifest.mjs";
 import { generateLithiaTypes, } from "./types-generation.mjs";
 export class Builder {
-    scanner;
-    routeGenerator;
-    eventGenerator;
-    functionGenerator;
+    _scanner;
+    _routeGenerator;
+    _eventGenerator;
+    _functionGenerator;
     constructor() {
-        this.scanner = new FileScanner();
-        this.routeGenerator = new RouteManifestGenerator();
-        this.eventGenerator = new EventManifestGenerator();
-        this.functionGenerator = new FunctionManifestGenerator();
+        this._scanner = new FileScanner();
+        this._routeGenerator = new RouteManifestGenerator();
+        this._eventGenerator = new EventManifestGenerator();
+        this._functionGenerator = new FunctionManifestGenerator();
+    }
+    get scanner() {
+        return this._scanner;
+    }
+    get routeGenerator() {
+        return this._routeGenerator;
+    }
+    get eventGenerator() {
+        return this._eventGenerator;
+    }
+    get functionGenerator() {
+        return this._functionGenerator;
     }
-    /**
-     * Runs the full compilation pipeline: Scan -> Transpile (SWC) -> Manifest.
-     */
     async build(config) {
         await rm(config.outRoot, { recursive: true, force: true });
-        // 1. Full Project Scan
-        // We scan the entire sourceDir to get everything that needs compilation
         const allFiles = await this.scanner.scanDir([config.sourceDir], {
             include: ["**/*.{ts,js,mts,mjs}"],
-            ignore: ["**/node_modules/**", "**/*.test.ts", "**/.*", "dist/**"],
+            ignore: ["**/node_modules/**", "**/*.{test|spec}.ts", "**/.*", "dist/**"],
         });
         if (allFiles.length === 0) {
             throw new Error(`No source files found in ${config.sourceDir}`);
         }
-        // 2. Compilation Phase (SWC)
-        // Transpile all files to the outRoot maintaining directory structure
         await this.compileFiles(allFiles, config);
         const distFiles = allFiles.map((file) => {
             const relativeFromSrc = file.path;
@@ -46,52 +46,37 @@ export class Builder {
                 .replace(/\.mts$/, ".mjs");
             return {
                 ...file,
-                // O fullPath agora deve ser o caminho absoluto no DIST
                 fullPath: path.join(process.cwd(), config.outRoot, distRelativePath),
             };
         });
-        // 3. Manifest Phase
-        // Use the metadata from scanned files to generate manifests in the outRoot
-        // 3. Manifest Phase
         const [_, __, functions] = await Promise.all([
             this.routeGenerator.generateManifest(config.outRoot, distFiles),
             this.eventGenerator.generateManifest(config.outRoot, distFiles),
             this.functionGenerator.generateManifest(config.outRoot, distFiles),
         ]);
-        // 4. Registry Mapping (Prepara dados para o gerador de tipos)
         const registry = {};
         if (functions?.functions) {
             registry.functions = functions.functions.map((f) => ({
                 identifier: f.id,
-                // Buscamos o arquivo original (.ts) para que o "Go to Definition" funcione no VS Code
                 filePath: allFiles.find((file) => file.fullPath.includes(f.id))?.fullPath ||
                     f.filePath,
             }));
         }
-        // 5. Generate Types in .lithia/
         if (Object.keys(registry).length > 0) {
-            // Passamos o diretório atual do processo (raiz do projeto)
             await generateLithiaTypes(process.cwd(), registry);
         }
     }
-    /**
-     * Compiles all discovered files using SWC.
-     * Processes files in parallel for maximum speed.
-     */
     async compileFiles(files, config) {
         const { compilerOptions } = await fs
             .readFile(path.join(process.cwd(), "tsconfig.json"), "utf-8")
             .then((data) => JSON.parse(data));
         await Promise.all(files.map(async (file) => {
-            // Determine the target output path
             const relativeFromSrc = file.path;
             const targetPath = path
                 .join(config.outRoot, relativeFromSrc)
                 .replace(/\.ts$/, ".js")
                 .replace(/\.mts$/, ".mjs");
-            // Ensure the sub-directory exists
             await fs.mkdir(path.dirname(targetPath), { recursive: true });
-            // Transpile via SWC
             const output = await swc.transformFile(file.fullPath, {
                 jsc: {
                     parser: {
@@ -106,6 +91,7 @@ export class Builder {
                 },
                 module: {
                     type: "es6",
+                    resolveFully: true
                 },
                 sourceMaps: true,
             });

package/dist/builder.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"builder.mjs","sourceRoot":"","sources":["../src/builder.mts"],"names":[],"mappings":"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"}
+{"version":3,"file":"builder.mjs","sourceRoot":"","sources":["../src/builder.mts"],"names":[],"mappings":"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"}

package/dist/context/event-context.d.mts

@@ -6,29 +6,11 @@
 import { AsyncLocalStorage } from "node:async_hooks";
 import type { Socket } from "socket.io";
 import type { Event } from "../strategy/events/index.mjs";
-/**
- * The structure of the data stored within the Event execution context.
- */
 export interface EventContext {
-    /** The raw data payload received from the client. */
     data: any;
-    /** The active Socket.io instance for this specific connection. */
     socket: Socket;
-    /** Metadata about the event being handled. */
     event: Event;
 }
-/**
- * The internal store instance used by the framework to track event execution.
- */
 export declare const eventContextStore: AsyncLocalStorage<EventContext>;
-/**
- * Accesses the current event context.
- * * @returns The active EventContext object.
- * @throws {NotInEventContextError} If called outside of an active event execution scope.
- */
 export declare function getEventContext(): EventContext;
-/**
- * Helper to run a callback within a specific event context.
- * * @internal
- */
 export declare function runInEventContext<T>(context: EventContext, fn: () => T): T;

package/dist/context/event-context.mjs

@@ -5,14 +5,7 @@
  */
 import { AsyncLocalStorage } from "node:async_hooks";
 import { NotInEventContextError } from "../errors/internal/index.mjs";
-/**
- * Global key to ensure the AsyncLocalStorage singleton persists even if
- * the module is re-imported or bundled multiple times.
- */
 const CONTEXT_GLOBAL_KEY = Symbol.for("lithia.event_context.v1");
-/**
- * Retrieves or initializes the global AsyncLocalStorage instance.
- */
 function getGlobalStore() {
     const globalAny = globalThis;
     if (!globalAny[CONTEXT_GLOBAL_KEY]) {
@@ -20,15 +13,7 @@ function getGlobalStore() {
     }
     return globalAny[CONTEXT_GLOBAL_KEY];
 }
-/**
- * The internal store instance used by the framework to track event execution.
- */
 export const eventContextStore = getGlobalStore();
-/**
- * Accesses the current event context.
- * * @returns The active EventContext object.
- * @throws {NotInEventContextError} If called outside of an active event execution scope.
- */
 export function getEventContext() {
     const ctx = eventContextStore.getStore();
     if (!ctx) {
@@ -36,10 +21,6 @@ export function getEventContext() {
     }
     return ctx;
 }
-/**
- * Helper to run a callback within a specific event context.
- * * @internal
- */
 export function runInEventContext(context, fn) {
     return eventContextStore.run(context, fn);
 }

package/dist/context/event-context.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"event-context.mjs","sourceRoot":"","sources":["../../src/context/event-context.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAetE;;;GAGG;AACH,MAAM,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;AAEjE;;GAEG;AACH,SAAS,cAAc;IACtB,MAAM,SAAS,GAAG,UAAiB,CAAC;IACpC,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACpC,SAAS,CAAC,kBAAkB,CAAC,GAAG,IAAI,iBAAiB,EAAgB,CAAC;IACvE,CAAC;IACD,OAAO,SAAS,CAAC,kBAAkB,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,EAAE,CAAC;AAElD;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC9B,MAAM,GAAG,GAAG,iBAAiB,CAAC,QAAQ,EAAE,CAAC;IACzC,IAAI,CAAC,GAAG,EAAE,CAAC;QACV,MAAM,IAAI,sBAAsB,EAAE,CAAC;IACpC,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAI,OAAqB,EAAE,EAAW;IACtE,OAAO,iBAAiB,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAC3C,CAAC"}
+{"version":3,"file":"event-context.mjs","sourceRoot":"","sources":["../../src/context/event-context.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAStE,MAAM,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;AAEjE,SAAS,cAAc;IACtB,MAAM,SAAS,GAAG,UAAiB,CAAC;IACpC,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACpC,SAAS,CAAC,kBAAkB,CAAC,GAAG,IAAI,iBAAiB,EAAgB,CAAC;IACvE,CAAC;IACD,OAAO,SAAS,CAAC,kBAAkB,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,EAAE,CAAC;AAElD,MAAM,UAAU,eAAe;IAC9B,MAAM,GAAG,GAAG,iBAAiB,CAAC,QAAQ,EAAE,CAAC;IACzC,IAAI,CAAC,GAAG,EAAE,CAAC;QACV,MAAM,IAAI,sBAAsB,EAAE,CAAC;IACpC,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAI,OAAqB,EAAE,EAAW;IACtE,OAAO,iBAAiB,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAC3C,CAAC"}

package/dist/context/lithia-context.d.mts

@@ -1,31 +1,9 @@
-/**
- * @fileoverview Base Lithia Execution Context.
- * Provides the foundational AsyncLocalStorage layer for global framework state,
- * primarily managing the Dependency Injection container.
- */
 import { AsyncLocalStorage } from "node:async_hooks";
 import type { LithiaOptions } from "../config.mjs";
-/**
- * The core context structure for any Lithia-managed execution.
- */
 export interface LithiaContext {
-    /** The Dependency Injection container for the current execution scope. */
     container: Map<any, any>;
     config: LithiaOptions;
 }
-/**
- * The singleton store instance for the base Lithia context.
- */
 export declare const lithiaContextStore: AsyncLocalStorage<LithiaContext>;
-/**
- * Accesses the current Lithia execution context.
- * * @returns The active LithiaContext object.
- * @throws {NotInLithiaContextError} If called outside a Lithia-managed scope.
- */
 export declare function getLithiaContext(): LithiaContext;
-/**
- * Helper to execute logic within a Lithia context.
- * Useful during application bootstrap or testing.
- * * @internal
- */
 export declare function runInLithiaContext<T>(context: LithiaContext, fn: () => T): T;

package/dist/context/lithia-context.mjs

@@ -1,18 +1,6 @@
-/**
- * @fileoverview Base Lithia Execution Context.
- * Provides the foundational AsyncLocalStorage layer for global framework state,
- * primarily managing the Dependency Injection container.
- */
 import { AsyncLocalStorage } from "node:async_hooks";
 import { NotInLithiaContextError } from "../errors/internal/index.mjs";
-/**
- * Global key using a Symbol to prevent collision and ensure singleton
- * persistence across different module resolutions.
- */
 const LITHIA_CONTEXT_KEY = Symbol.for("lithia.base_context.v1");
-/**
- * Retrieves or initializes the global AsyncLocalStorage instance for the base context.
- */
 function getGlobalLithiaStore() {
     const globalAny = globalThis;
     if (!globalAny[LITHIA_CONTEXT_KEY]) {
@@ -20,15 +8,7 @@ function getGlobalLithiaStore() {
     }
     return globalAny[LITHIA_CONTEXT_KEY];
 }
-/**
- * The singleton store instance for the base Lithia context.
- */
 export const lithiaContextStore = getGlobalLithiaStore();
-/**
- * Accesses the current Lithia execution context.
- * * @returns The active LithiaContext object.
- * @throws {NotInLithiaContextError} If called outside a Lithia-managed scope.
- */
 export function getLithiaContext() {
     const ctx = lithiaContextStore.getStore();
     if (!ctx) {
@@ -36,11 +16,6 @@ export function getLithiaContext() {
     }
     return ctx;
 }
-/**
- * Helper to execute logic within a Lithia context.
- * Useful during application bootstrap or testing.
- * * @internal
- */
 export function runInLithiaContext(context, fn) {
     return lithiaContextStore.run(context, fn);
 }

package/dist/context/lithia-context.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"lithia-context.mjs","sourceRoot":"","sources":["../../src/context/lithia-context.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAYvE;;;GAGG;AACH,MAAM,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;AAEhE;;GAEG;AACH,SAAS,oBAAoB;IAC5B,MAAM,SAAS,GAAG,UAAiB,CAAC;IACpC,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACpC,SAAS,CAAC,kBAAkB,CAAC,GAAG,IAAI,iBAAiB,EAAiB,CAAC;IACxE,CAAC;IACD,OAAO,SAAS,CAAC,kBAAkB,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,oBAAoB,EAAE,CAAC;AAEzD;;;;GAIG;AACH,MAAM,UAAU,gBAAgB;IAC/B,MAAM,GAAG,GAAG,kBAAkB,CAAC,QAAQ,EAAE,CAAC;IAC1C,IAAI,CAAC,GAAG,EAAE,CAAC;QACV,MAAM,IAAI,uBAAuB,EAAE,CAAC;IACrC,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAI,OAAsB,EAAE,EAAW;IACxE,OAAO,kBAAkB,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"lithia-context.mjs","sourceRoot":"","sources":["../../src/context/lithia-context.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAOvE,MAAM,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;AAEhE,SAAS,oBAAoB;IAC5B,MAAM,SAAS,GAAG,UAAiB,CAAC;IACpC,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACpC,SAAS,CAAC,kBAAkB,CAAC,GAAG,IAAI,iBAAiB,EAAiB,CAAC;IACxE,CAAC;IACD,OAAO,SAAS,CAAC,kBAAkB,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,oBAAoB,EAAE,CAAC;AAEzD,MAAM,UAAU,gBAAgB;IAC/B,MAAM,GAAG,GAAG,kBAAkB,CAAC,QAAQ,EAAE,CAAC;IAC1C,IAAI,CAAC,GAAG,EAAE,CAAC;QACV,MAAM,IAAI,uBAAuB,EAAE,CAAC;IACrC,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAI,OAAsB,EAAE,EAAW;IACxE,OAAO,kBAAkB,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAC5C,CAAC"}

package/dist/context/request-context.d.mts

@@ -8,31 +8,12 @@ import type { Server as SocketServer } from "socket.io";
 import type { LithiaRequest } from "../server/request.mjs";
 import type { LithiaResponse } from "../server/response.mjs";
 import type { Route } from "../strategy/routes/index.mjs";
-/**
- * The execution state for a single HTTP request-response lifecycle.
- */
 export interface RouteContext {
-    /** The Lithia-wrapped Node.js request. */
     req: LithiaRequest;
-    /** The Lithia-wrapped Node.js response. */
     res: LithiaResponse;
-    /** The specific route metadata being executed. */
     route?: Route;
-    /** Access to the SocketServer for emitting events during HTTP calls. */
     socketServer: SocketServer;
 }
-/**
- * The internal store instance used by the framework to track HTTP execution.
- */
 export declare const routeContextStore: AsyncLocalStorage<RouteContext>;
-/**
- * Retrieves the current Route context.
- * * @returns The active RouteContext object.
- * @throws {NotInRequestContextError} If called outside of an HTTP handler.
- */
 export declare function getRouteContext(): RouteContext;
-/**
- * Utility to execute a function within a Route execution scope.
- * * @internal
- */
 export declare function runInRouteContext<T>(context: RouteContext, fn: () => T): T;

package/dist/context/request-context.mjs

@@ -5,14 +5,7 @@
  */
 import { AsyncLocalStorage } from "node:async_hooks";
 import { NotInRequestContextError } from "../errors/internal/index.mjs";
-/**
- * Global key using a Symbol to maintain singleton status across
- * module re-evaluations (common in dev-mode HMR).
- */
 const ROUTE_CONTEXT_KEY = Symbol.for("lithia.route_context.v1");
-/**
- * Retrieves or initializes the global AsyncLocalStorage for route execution.
- */
 function getGlobalRouteStore() {
     const globalAny = globalThis;
     if (!globalAny[ROUTE_CONTEXT_KEY]) {
@@ -20,27 +13,14 @@ function getGlobalRouteStore() {
     }
     return globalAny[ROUTE_CONTEXT_KEY];
 }
-/**
- * The internal store instance used by the framework to track HTTP execution.
- */
 export const routeContextStore = getGlobalRouteStore();
-/**
- * Retrieves the current Route context.
- * * @returns The active RouteContext object.
- * @throws {NotInRequestContextError} If called outside of an HTTP handler.
- */
 export function getRouteContext() {
     const ctx = routeContextStore.getStore();
     if (!ctx) {
-        // Corrected from NotInEventContextError to NotInRequestContextError
         throw new NotInRequestContextError();
     }
     return ctx;
 }
-/**
- * Utility to execute a function within a Route execution scope.
- * * @internal
- */
 export function runInRouteContext(context, fn) {
     return routeContextStore.run(context, fn);
 }

package/dist/context/request-context.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"request-context.mjs","sourceRoot":"","sources":["../../src/context/request-context.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAmBxE;;;GAGG;AACH,MAAM,iBAAiB,GAAG,MAAM,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;AAEhE;;GAEG;AACH,SAAS,mBAAmB;IAC3B,MAAM,SAAS,GAAG,UAAiB,CAAC;IACpC,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACnC,SAAS,CAAC,iBAAiB,CAAC,GAAG,IAAI,iBAAiB,EAAgB,CAAC;IACtE,CAAC;IACD,OAAO,SAAS,CAAC,iBAAiB,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,EAAE,CAAC;AAEvD;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC9B,MAAM,GAAG,GAAG,iBAAiB,CAAC,QAAQ,EAAE,CAAC;IACzC,IAAI,CAAC,GAAG,EAAE,CAAC;QACV,oEAAoE;QACpE,MAAM,IAAI,wBAAwB,EAAE,CAAC;IACtC,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAI,OAAqB,EAAE,EAAW;IACtE,OAAO,iBAAiB,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAC3C,CAAC"}
+{"version":3,"file":"request-context.mjs","sourceRoot":"","sources":["../../src/context/request-context.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAYxE,MAAM,iBAAiB,GAAG,MAAM,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;AAEhE,SAAS,mBAAmB;IAC3B,MAAM,SAAS,GAAG,UAAiB,CAAC;IACpC,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACnC,SAAS,CAAC,iBAAiB,CAAC,GAAG,IAAI,iBAAiB,EAAgB,CAAC;IACtE,CAAC;IACD,OAAO,SAAS,CAAC,iBAAiB,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,EAAE,CAAC;AAEvD,MAAM,UAAU,eAAe;IAC9B,MAAM,GAAG,GAAG,iBAAiB,CAAC,QAAQ,EAAE,CAAC;IACzC,IAAI,CAAC,GAAG,EAAE,CAAC;QACV,MAAM,IAAI,wBAAwB,EAAE,CAAC;IACtC,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAI,OAAqB,EAAE,EAAW;IACtE,OAAO,iBAAiB,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAC3C,CAAC"}

package/dist/hooks/event-hooks.d.mts

@@ -1,31 +1,6 @@
-/**
- * @fileoverview Event Composition Hooks for Lithia.js.
- * Provides simplified access to the current connection state and received data.
- * These must be used exclusively within functions executed by the LithiaEventProcessor.
- */
 import type { Socket } from "socket.io";
 import type { Event } from "../strategy/events/index.mjs";
-/**
- * Retrieves the payload (data) sent by the client for the current event.
- * * @template T The expected data type.
- * @returns The typed event data.
- * @example
- * const { message } = useData<{ message: string }>();
- */
 export declare function useData<T = any>(): T;
-/**
- * Retrieves the Socket.io instance that triggered the current event.
- * Useful for emitting messages back to the client or managing rooms.
- * * @returns The active Socket instance.
- */
 export declare function useSocket(): Socket;
-/**
- * Retrieves the metadata of the event currently being processed.
- * * @returns The Event object containing name, file path, and flags.
- */
 export declare function useEvent(): Event;
-/**
- * Utility hook to access the unique connection ID of the current socket.
- * * @returns The socket ID string.
- */
 export declare function useSocketId(): string;

package/dist/hooks/event-hooks.mjs

@@ -1,38 +1,13 @@
-/**
- * @fileoverview Event Composition Hooks for Lithia.js.
- * Provides simplified access to the current connection state and received data.
- * These must be used exclusively within functions executed by the LithiaEventProcessor.
- */
 import { getEventContext } from "../context/event-context.mjs";
-/**
- * Retrieves the payload (data) sent by the client for the current event.
- * * @template T The expected data type.
- * @returns The typed event data.
- * @example
- * const { message } = useData<{ message: string }>();
- */
 export function useData() {
     return getEventContext().data;
 }
-/**
- * Retrieves the Socket.io instance that triggered the current event.
- * Useful for emitting messages back to the client or managing rooms.
- * * @returns The active Socket instance.
- */
 export function useSocket() {
     return getEventContext().socket;
 }
-/**
- * Retrieves the metadata of the event currently being processed.
- * * @returns The Event object containing name, file path, and flags.
- */
 export function useEvent() {
     return getEventContext().event;
 }
-/**
- * Utility hook to access the unique connection ID of the current socket.
- * * @returns The socket ID string.
- */
 export function useSocketId() {
     return getEventContext().socket.id;
 }

package/dist/hooks/event-hooks.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"event-hooks.mjs","sourceRoot":"","sources":["../../src/hooks/event-hooks.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAG/D;;;;;;GAMG;AACH,MAAM,UAAU,OAAO;IACtB,OAAO,eAAe,EAAE,CAAC,IAAS,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS;IACxB,OAAO,eAAe,EAAE,CAAC,MAAM,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ;IACvB,OAAO,eAAe,EAAE,CAAC,KAAK,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW;IAC1B,OAAO,eAAe,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;AACpC,CAAC"}
+{"version":3,"file":"event-hooks.mjs","sourceRoot":"","sources":["../../src/hooks/event-hooks.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAG/D,MAAM,UAAU,OAAO;IACtB,OAAO,eAAe,EAAE,CAAC,IAAS,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,SAAS;IACxB,OAAO,eAAe,EAAE,CAAC,MAAM,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,QAAQ;IACvB,OAAO,eAAe,EAAE,CAAC,KAAK,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,WAAW;IAC1B,OAAO,eAAe,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;AACpC,CAAC"}

package/dist/hooks/lithia-hooks.d.mts

@@ -1,76 +1,16 @@
-/**
- * @fileoverview Dependency Injection and Cross-Thread Communication Hooks.
- * Provides a functional API for managing application dependencies and
- * executing background functions with strict type safety across worker threads.
- */
 import type { LithiaFunctions } from "@lithia-js/core";
 import type { LithiaOptions } from "../config.mjs";
 import type { InjectionKey } from "../lithia-app.mjs";
-/**
- * Global interface for Lithia functions.
- * This is augmented by the auto-generated `.lithia/lithia.d.ts` file.
- */
 declare module "@lithia-js/core" {
     interface LithiaFunctions {
     }
 }
-/**
- * Registers a dependency in the current execution container.
- * * @template T - The type of the dependency being provided.
- * @param key - The unique injection key (Symbol, Class, or String).
- * @param value - The instance or value to associate with the key.
- * @example
- * provide(DatabaseService, new DatabaseService());
- */
 export declare function provide<T>(key: InjectionKey<T>, value: T): void;
-/**
- * Retrieves a required dependency from the execution container.
- * * @template T - The expected return type of the dependency.
- * @param key - The unique injection key to look up.
- * @returns The requested dependency instance.
- * @throws {DependencyNotInitializedError} If the dependency has not been registered.
- * @example
- * const db = useDependency(DatabaseService);
- */
 export declare function useDependency<T>(key: InjectionKey<T>): T;
-/**
- * Retrieves an optional dependency from the execution container.
- * * @template T - The expected return type of the dependency.
- * @param key - The unique injection key to look up.
- * @returns The dependency instance, or undefined if not found.
- * @example
- * const logger = useOptionalDependency(CustomLogger);
- */
 export declare function useOptionalDependency<T>(key: InjectionKey<T>): T | undefined;
-/**
- * Utility type to extract the parameter list of a registered Lithia function.
- */
 type FunctionPayload<K extends keyof LithiaFunctions> = LithiaFunctions[K] extends (...args: infer P) => any ? P : never;
-/**
- * Utility type to extract the unwrapped return type of a registered Lithia function.
- */
 type FunctionReturn<K extends keyof LithiaFunctions> = LithiaFunctions[K] extends (...args: any[]) => Promise<infer R> ? R : LithiaFunctions[K] extends (...args: any[]) => infer R ? R : any;
-/**
- * Invokes a background function and waits for the result.
- * Coordinates with the LithiaHost to spawn a dedicated worker and return the data.
- * * @template K - A valid function ID from the generated LithiaFunctions interface.
- * @param functionId - The unique identifier of the function to execute.
- * @param args - The arguments required by the target function.
- * @returns A promise resolving with the function's return value.
- * @throws {Error} If the worker execution fails or the function is not found.
- * @example
- * const result = await invoke("process-image", { path: "img.png" });
- */
 export declare function invoke<K extends keyof LithiaFunctions>(functionId: K, ...args: FunctionPayload<K>): Promise<Awaited<FunctionReturn<K>>>;
-/**
- * Invokes a background function in "fire-and-forget" mode.
- * The function will be executed in a separate worker without blocking the current thread.
- * * @template K - A valid function ID from the generated LithiaFunctions interface.
- * @param functionId - The unique identifier of the function to execute.
- * @param args - The arguments required by the target function.
- * @example
- * invokeAsync("send-email", { to: "user@example.com", body: "Welcome!" });
- */
 export declare function invokeAsync<K extends keyof LithiaFunctions>(functionId: K, ...args: FunctionPayload<K>): void;
 export declare function useLithiaConfig(): LithiaOptions;
 export {};