kuwan-expresspack-core 0.1.15 → 0.1.17

package/dist/chunk-55RBYZEZ.mjs

@@ -0,0 +1,5 @@
+import { AsyncLocalStorage } from 'async_hooks';
+
+var a=new AsyncLocalStorage;function n(e){return {get(t){return e.data.get(t)},set(t,o){e.data.set(t,o);},has(t){return e.data.has(t)},delete(t){return e.data.delete(t)},clear(){e.data.clear();}}}function c(){let e=a.getStore();if(!e)throw new Error("No context available. Ensure context middleware is registered before accessing context.");return n(e)}function i(){let e=a.getStore();return e?n(e):void 0}function y(e){let t={data:new Map};return a.run(t,e)}
+
+export { a, n as b, c, i as d, y as e };

package/dist/chunk-CZGPAGDK.mjs

@@ -0,0 +1,12 @@
+import { z as z$1 } from 'zod';
+import { config } from '@dotenvx/dotenvx';
+import { colorize } from 'consola/utils';
+import L from 'consola';
+
+var m=colorize;function N(r){switch(typeof r){case "number":case "bigint":return colorize("cyan",r.toString());case "boolean":return colorize(r?"green":"red",String(r));case "symbol":return colorize("magenta",r.toString());case "string":return isNaN(Number(r))?colorize("whiteBright",`${r}`):colorize("yellow",`'${r}'`);case "undefined":return colorize("gray","undefined")}return r===null?colorize("dim","null"):String(r)}var P=L.create({level:Number.isNaN(Number(process.env.EXPRESSPACK_LOG_LEVEL))?3:Number(process.env.EXPRESSPACK_LOG_LEVEL)});function b(){let r=Number(process.env.EXPRESSPACK_LOG_LEVEL);P.level=Number.isNaN(r)?3:r;}var s=P;var c,l=null,v=null,y={},E=[];function z(r,n){let o=r.safeParse(n);if(o.success)return o.data;console.error("\u274C Invalid environment variables:"),console.error(z$1.prettifyError(o.error));}function I(r,n,o={fatal:false,immediate_log_error:true,log_error_after_graceful_start:true}){if(b(),y=o,o.fatal)try{let t=r.parse(n);return {...c,...t}}catch(t){throw t instanceof z$1.ZodError?(l=z$1.prettifyError(t),v=t,s.error("\u274C Invalid environment variables:"),s.error("\u274C",l),new Error("Invalid environment variables. The environment variable did not pass the schema validation. Check if you have set all required environment variables correctly.")):t}let i=r.safeParse(n);if(!i.success){let t=r.partial().safeParse(n);if(!t.success)return l=z$1.prettifyError(i.error),v=i.error,o.immediate_log_error&&(s.error("\u274C Invalid environment variables:"),s.error("\u274C",l)),c||{};l=z$1.prettifyError(i.error),v=i.error,o.immediate_log_error&&(s.error("\u274C Invalid environment variables:"),s.error("\u274C",l));let d=r.keyof();E=d.options;for(let p of d.options)p in t.data||(t.data[p]=void 0);return {...c,...t.data}}let g=r.keyof();E=g.options;for(let t of g.options)t in i.data||(i.data[t]=void 0);return {...c,...i.data}}function R(){return v}function S(){return l}function T(r){if(!r||Object.keys(r).length===0){s.warn("No environment variables to print. Make sure the env is complete and valid.");return}let n=e=>e.startsWith("* ")?m("dim",e):e,o=e=>E.includes(e)?e:`* ${e}`,i=e=>e.startsWith("! ")?m("dim",m("yellow",`${e}`)):e,g=e=>E.includes(e)&&r[e]===void 0?`! ${e}`:e,t=Object.entries(r).sort(([e],[u])=>e.localeCompare(u)).map(([e,u])=>[o(e),u]).map(([e,u])=>[g(e),u]),d=Math.max(...t.map(([e])=>e.length))+2,p=t.map(([e,u])=>`${e.padEnd(d," ").replace(e,n(e)).replace(e,i(e))} ${N(u)}`),_=`KEY${" ".repeat(d-3)} VALUE`,h=" ".repeat(_.length);return [h,_,h,...p].join(`
+`)}function C(){if(y){let{log_error_after_graceful_start:r}=y;if(r){let n=S();n&&s.error("Invalid Environment Variable Value",`
+-----
+${n}
+-----`);}}}function K(r){c={};let n=config(r);return b(),c=n.parsed?n.parsed:void 0,n}function $(r){return new Proxy(r,{get(n,o){return o in n?n[o]:process.env[o]}})}function j(r,n,o){let i=I(r,n,o);return $(i)}var Y={create:j,parseEnv:z,prettifyEnv:T,getEnvErrorRaw:R,getEnvErrorString:S,logEnvErrors:C,config:K};
+
+export { s as a, I as b, R as c, S as d, T as e, C as f, K as g, Y as h };

package/dist/chunk-FFCH7NYQ.mjs

@@ -0,0 +1,3 @@
+function r(e){let n=(t,o)=>{e.appContext||(e.appContext={}),e.appContext[t]=o;};function a(t){return e.appContext?.[t]}return {set:n,get:a}}
+
+export { r as a };

package/dist/chunk-JKH5TYED.mjs

@@ -0,0 +1,3 @@
+async function i(e,t){let r=await e();if(!r||!("default"in r)){let s=t?`Missing "export default" in module "${t}"`:`Missing "export default" from lazy import "${e}"`;throw new Error(s,{cause:{source:e}})}return r.default}
+
+export { i as a };

package/dist/chunk-OXUMMLIO.mjs

@@ -0,0 +1,6 @@
+import a from 'emittery';
+import { env } from 'process';
+
+function c(){return env.EXPRESSPACK_EVENT_EMITTER_DEBUG==="true"||env.EXPRESSPACK_EVENT_EMITTER_DEBUG==="1"||(typeof env.EXPRESSPACK_EVENT_EMITTER_DEBUG=="boolean"?env.EXPRESSPACK_EVENT_EMITTER_DEBUG===true:false)}var r=new a({debug:{name:"expresspack-emitter",enabled:c()}});function y(){return new a({debug:{name:"c-emitter",enabled:c()}})}function x(o){o({on:async(i,t)=>{typeof t=="function"&&t.length===0?r.on(i,async s=>{try{let e=await t();if(typeof e=="object"&&e!==null&&"default"in e){let f=e.default;if(typeof f=="function")return f(s)}if(typeof e=="function")return e(s)}catch(e){throw e instanceof Error?e:new Error(`Unknown error occurred in event handler for event "${t}"`)}}):(console.log(typeof t),r.on(i,t));},emitter:r});}function T(o,E){return E}var K=r;
+
+export { r as a, y as b, x as c, T as d, K as e };

package/dist/context/context-store/context-store-internal.d.ts

@@ -0,0 +1,140 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+
+/**
+ * Application context with typed access methods
+ */
+interface AppContext<TData extends Record<string, any> = Record<string, any>> {
+    /**
+     * Get a value from the context store
+     *
+     * @param key - The key to retrieve
+     * @returns The stored value or undefined
+     *
+     * @example
+     * ```typescript
+     * interface MyContext {
+     *     user: { id: number; name: string };
+     *     tenantId: string;
+     * }
+     *
+     * const ctx = getAppContext<MyContext>();
+     * const user = ctx.get('user'); // type is { id: number; name: string } | undefined
+     * ```
+     */
+    get<K extends keyof TData>(key: K): TData[K] | undefined;
+    /**
+     * Set a value in the context store
+     *
+     * @param key - The key to store the value under
+     * @param value - The value to store
+     *
+     * @example
+     * ```typescript
+     * const ctx = getAppContext<MyContext>();
+     * ctx.set('user', { id: 1, name: 'John' }); // fully typed
+     * ```
+     */
+    set<K extends keyof TData>(key: K, value: TData[K]): void;
+    /**
+     * Check if a key exists in the context store
+     *
+     * @param key - The key to check
+     * @returns True if the key exists
+     */
+    has<K extends keyof TData>(key: K): boolean;
+    /**
+     * Delete a value from the context store
+     *
+     * @param key - The key to delete
+     * @returns True if the key existed and was deleted
+     */
+    delete<K extends keyof TData>(key: K): boolean;
+    /**
+     * Clear all values from the context store
+     */
+    clear(): void;
+}
+/**
+ * Internal context structure
+ */
+interface InternalContext<TData extends Record<string, any> = Record<string, any>> {
+    data: Map<keyof TData, any>;
+}
+/**
+ * AsyncLocalStorage instance for managing context
+ */
+declare const asyncLocalStorage: AsyncLocalStorage<InternalContext<any>>;
+/**
+ * Create a typed context proxy from internal context
+ */
+declare function createContextProxy<TData extends Record<string, any>>(internal: InternalContext<TData>): AppContext<TData>;
+/**
+ * Get the current application context with custom type support
+ *
+ * @throws {Error} If called outside of context
+ * @returns {AppContext<TData>} The current context
+ *
+ * @example
+ * ```typescript
+ * import { getAppContext } from 'expresspack';
+ *
+ * interface MyContext {
+ *     user: { id: number; name: string };
+ *     tenantId: string;
+ * }
+ *
+ * export function someHandler(req, res) {
+ *     const ctx = getAppContext<MyContext>();
+ *
+ *     // Fully typed access
+ *     const user = ctx.get('user'); // type: { id: number; name: string } | undefined
+ *
+ *     // Fully typed set
+ *     ctx.set('user', { id: 1, name: 'John' });
+ * }
+ * ```
+ */
+declare function getAppContext<TData extends Record<string, any> = Record<string, any>>(): AppContext<TData>;
+/**
+ * Get the current application context, returns undefined if not available
+ * Useful for optional context access
+ *
+ * @returns {AppContext<TData> | undefined} The current context or undefined
+ *
+ * @example
+ * ```typescript
+ * import { tryGetAppContext } from 'expresspack';
+ *
+ * export function someUtility() {
+ *     const ctx = tryGetAppContext<MyContext>();
+ *     if (ctx) {
+ *         const user = ctx.get('user');
+ *     }
+ * }
+ * ```
+ */
+declare function tryGetAppContext<TData extends Record<string, any> = Record<string, any>>(): AppContext<TData> | undefined;
+/**
+ * Run a function within a context (useful for testing)
+ *
+ * @param fn - The function to execute
+ * @returns The result of the function
+ *
+ * @example
+ * ```typescript
+ * import { runInContext } from 'expresspack';
+ *
+ * interface MyContext {
+ *     userId: number;
+ * }
+ *
+ * const result = runInContext(() => {
+ *     const ctx = getAppContext<MyContext>();
+ *     ctx.set('userId', 123);
+ *     return someFunction();
+ * });
+ * ```
+ */
+declare function runInContext<T>(fn: () => T): T;
+
+export { type AppContext, type InternalContext, asyncLocalStorage, createContextProxy, getAppContext, runInContext, tryGetAppContext };

package/dist/context/context-store/context-store-internal.mjs

@@ -0,0 +1 @@
+export { a as asyncLocalStorage, b as createContextProxy, c as getAppContext, e as runInContext, d as tryGetAppContext } from '../../chunk-55RBYZEZ.mjs';

package/dist/context/context-store/index.d.ts

@@ -0,0 +1,2 @@
+export { getAppContext, tryGetAppContext } from './context-store-internal.js';
+import 'node:async_hooks';

package/dist/context/context-store/index.mjs

@@ -0,0 +1 @@
+export { c as getAppContext, d as tryGetAppContext } from '../../chunk-55RBYZEZ.mjs';

package/dist/context/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/context/index.mjs

@@ -0,0 +1 @@
+

package/dist/context/simple-context.d.ts

@@ -0,0 +1,16 @@
+import { Request } from 'express';
+
+/**
+ * Simple Context - Use when AsyncLocalStorage is not needed or not available.
+ *
+ */
+
+/**
+ * Helper function to set/get values in Request.
+ */
+declare function useAppContext<TData extends Record<never, never> = Record<never, never>>(req: Request): {
+    set: (key: string, value: any) => void;
+    get: <K extends keyof TData>(key: K) => TData[K] | undefined;
+};
+
+export { useAppContext };

package/dist/context/simple-context.mjs

@@ -0,0 +1 @@
+export { a as useAppContext } from '../chunk-FFCH7NYQ.mjs';

package/dist/env-config.d.ts

@@ -0,0 +1 @@
+import '@antfu/eslint-config';

package/dist/env-config.mjs

@@ -0,0 +1,3 @@
+import { g } from './chunk-CZGPAGDK.mjs';
+
+g();

package/dist/env.d.ts

@@ -56,8 +56,9 @@ declare function prettifyEnv(env: Record<string, any>): string | undefined;
  */
 declare function logEnvErrors(): void;
 declare function config(options?: DotenvConfigOptions | undefined): DotenvConfigOutput;
+declare function createProxy<T extends z.ZodObject<any>>(schema: T, data: unknown, options?: Partial<EnvOptions>): z.output<T>;
 declare const _default: {
-    create: typeof create;
+    create: typeof createProxy;
     parseEnv: typeof parseEnv;
     prettifyEnv: typeof prettifyEnv;
     getEnvErrorRaw: typeof getEnvErrorRaw;

package/dist/env.mjs

@@ -1 +1 @@
-export { g as config, b as create, h as default, c as getEnvErrorRaw, d as getEnvErrorString, f as logEnvErrors, e as prettifyEnv } from './chunk-AFN6MPA7.mjs';
+export { g as config, b as create, h as default, c as getEnvErrorRaw, d as getEnvErrorString, f as logEnvErrors, e as prettifyEnv } from './chunk-CZGPAGDK.mjs';

package/dist/index.d.ts

@@ -8,14 +8,27 @@ declare function gracefulShutdown(server: Server, onShutdown: () => Promise<void
 type AppContext = {
     app: Express;
 };
-type KernelExports = ((context: AppContext) => void) | Promise<void>;
+type KernelExports = ((context: AppContext) => void) | Promise<void> | void;
 /**
  * This is mostly a plain Express middleware definition.
  *
  * We just called it "**kernel**" to avoid mixing routers
  * and main app middlewares.
+ * @deprecated
+ * This will be removed in future versions.
+ * Use `defineMiddlewareKernel` instead.
  */
 declare function defineKernel(def: KernelExports): KernelExports;
+/**
+ * Defines a middleware kernel for the framework.
+ * Accepts a setup function that receives the app context.
+ * Use for registering global middleware (e.g., app.use).
+ */
+declare function defineMiddlewareKernel(setup: (context: {
+    app: Express;
+}) => void | Promise<void>): (context: {
+    app: Express;
+}) => void | Promise<void>;
 
 interface AppBootstrapContext extends Record<string, any> {
     app: Express;
@@ -25,7 +38,10 @@ interface LoadKernelOptions {
      * Loads the main kernel (Express middlewares) of your application.
      *
      */
-    kernel: () => Promise<any>;
+    kernel?: () => Promise<any>;
+    kernel2?: () => Promise<{
+        default: (context: AppBootstrapContext) => void | Promise<void>;
+    } | ((context: AppBootstrapContext) => void | Promise<void>)>;
     /**
      * Loads the event listeners for the application.
      *
@@ -47,7 +63,7 @@ interface LoadKernelOptions {
 }
 declare function loadKernel({ app }: {
     app: any;
-}, { kernel, listener, appBootstrap, }: LoadKernelOptions): Promise<void>;
+}, options: LoadKernelOptions): Promise<void>;
 
 declare function createRouter(options?: RouterOptions): Router;
 
@@ -56,7 +72,7 @@ declare function createRouter(options?: RouterOptions): Router;
  * @param fn Callback to register routes on the router
  * @returns Express Router instance
  */
-declare function defineRouterMiddleware(fn: (router: Router) => void, options?: RouterOptions): Router;
+declare function defineRouterMiddleware(fn: (r: Router) => void, options?: RouterOptions): Router;
 
 /**
  * Load all configurations from the config directory
@@ -66,4 +82,4 @@ declare function defineRouterMiddleware(fn: (router: Router) => void, options?:
  */
 declare function configLoader(root: string): Promise<void>;
 
-export { type AppBootstrapContext, type AppContext, type KernelExports, type LoadKernelOptions, configLoader, createRouter, defineKernel, defineRouterMiddleware, gracefulHTTPStart, gracefulShutdown, loadKernel };
+export { type AppBootstrapContext, type AppContext, type KernelExports, type LoadKernelOptions, configLoader, createRouter, defineKernel, defineMiddlewareKernel, defineRouterMiddleware, gracefulHTTPStart, gracefulShutdown, loadKernel };

package/dist/index.mjs

@@ -1,14 +1,15 @@
-import { c } from './chunk-CRIPGIHI.mjs';
-import { a as a$1 } from './chunk-VSPZT4K6.mjs';
-import { a, f } from './chunk-AFN6MPA7.mjs';
+import { e } from './chunk-OXUMMLIO.mjs';
+import { a as a$1 } from './chunk-JKH5TYED.mjs';
+import { a as a$2 } from './chunk-VSPZT4K6.mjs';
+import { a, f } from './chunk-CZGPAGDK.mjs';
 import { Router } from 'express';
-import N, { relative, join } from 'path';
+import M, { relative, join } from 'path';
 import { existsSync } from 'fs';
 import { glob } from 'tinyglobby';
 import { pathToFileURL } from 'url';
 
-function T(r,n,e){return r.listen(n,async()=>{e&&(a.debug("Executing onStart hook..."),await e().catch(o=>{a.error("Error during onStart hook:",o);})),a.box({message:`Server is running at http://localhost:${n}`,style:{borderColor:"cyan"},level:"info"});try{await c.emit("app:mounted");}catch(o){a.error("Error during app:mounted event:",o);}finally{f();}})}function k(r,n){process.on("SIGINT",async()=>{a.info("Received SIGINT. Shutting down gracefully..."),await new Promise(e=>{r.close(async i=>i instanceof Error?(a.error("Error shutting down server:",i),e()):(n&&await n().catch(o=>{a.error("Error during shutdown hook:",o);}),a.info("Server has been shut down."),e()));}),process.exit(0);});}function L(r){return r}async function $({app:r},{kernel:n,listener:e,appBootstrap:i}){a.debug("Loading kernel...");try{let o=await n();await(o?.default||o)({app:r});}catch(o){throw a.error("Error loading kernel:",o),o}if(e&&typeof e=="function")try{let o=await e(),a$1=o?.default||o;a$1===void 0||typeof a$1!="function"?a.warn("No listener setup function found"):await a$1();}catch(o){throw a.error("Error loading listener:",o),o}if(i&&typeof i=="function")try{await i({app:r});}catch(o){throw a.error("Error during boot process:",o),o}a.debug("Kernel loaded.");}function g(r){return Router(r)}function K(r,n){let e=g(n);return r(e),e}function P(r){let n=join(r,"expresspack.config"),e=join(r,"app"),i=join(r,"config"),o=join(i,"app"),a=join(i,"body-parser"),f=join(e,"controllers"),l=join(e,"services"),d=join(e,"errors"),m=join(e,"middlewares"),u=join(e,"routes");return {rc:n,root:r,app:e,middlewareFilePath:m,routesFilePath:u,config:{base:i,bodyParserFile:a,appConfigFile:o},controllers:{base:f},services:{base:l},errors:{base:d}}}var b=r=>{let n=["ts","mts","js","mjs","cjs","cts"];for(let e of n){let i=`${r}.${e}`;if(existsSync(i))return i}return null},R=r=>existsSync(r)?r:null;function S(r){if(!r)return "";let n=N.sep;return r.endsWith(n)?r:r+n}var I="*.{js,ts,mjs,cjs,mts,cts}",_=["!*.d.{ts,mts,mjs,cts}","!*.map"];async function C(r){let n=await glob([I,..._],{cwd:r}),e=new Set;return n.forEach(i=>{let o=i.replace(/\.(js|ts|mjs|cjs|mts|cts)$/,"");e.add(o);}),Array.from(e)}async function U(r){let{config:n}=P(r),e=n.base;if(a.debug("Loading all configurations from: `"+S(relative(r,n.base)+"`")),!R(e)){a.debug("No config directory found. Looked for:",e);return}let o=await C(e);a.debug(`Found ${o.length} config files: %s`,`
-   ${o.join(`
-   `)}`);for(let f of o){let l=b(join(e,f));if(!l){a.warn(`No config file found for topic: ${f}`);continue}try{let m=await import(pathToFileURL(l).href),u=m.default||m;typeof u=="function"&&(u=await u());let x=f.replace(/[-_](\w)/g,(B,h)=>h?h.toUpperCase():"");a$1[x]=u;let j=relative(r,l);a.debug(`Loaded config: \`${x}\` from \`${j}\``);}catch(d){a.error(`Failed to load config ${f}:`,d);}}}
+function A(r,t,e$1){return r.listen(t,async()=>{e$1&&(a.debug("Executing onStart hook..."),await e$1().catch(i=>{a.error("Error during onStart hook:",i);})),a.box({message:`Server is running at http://localhost:${t}`,style:{borderColor:"cyan"},level:"info"});try{await e.emit("app:mounted",{app:r});}catch(i){a.error("Error during app:mounted event:",i);}finally{f();}})}function F(r,t){process.on("SIGINT",async()=>{a.info("Received SIGINT. Shutting down gracefully..."),await new Promise(e=>{r.close(async s=>s instanceof Error?(a.error("Error shutting down server:",s),e()):(t&&await t().catch(i=>{a.error("Error during shutdown hook:",i);}),a.info("Server has been shut down."),e()));}),process.exit(0);});}function T(r){return r}function $(r){return r}async function L({app:r},t){a.debug("Loading kernel...");let{kernel:e,kernel2:s,listener:i,appBootstrap:d}=t,p=s;if(e&&typeof e=="function"&&(p=e),p&&typeof p=="function")try{let n=await p(),l=typeof n=="object"&&n!==null&&"default"in n?n.default:n;typeof l=="function"?(await l({app:r}),a.debug("Middleware kernel loaded.")):a.warn("Middleware kernel setup function not found.");}catch(n){throw a.error("Error loading middleware kernel:",n),n}if(i&&typeof i=="function")try{await a$1(i);}catch(n){throw a.error("Error loading listener:",n),n}if(d&&typeof d=="function")try{await d({app:r});}catch(n){throw a.error("Error during boot process:",n),n}a.debug("Kernel loaded.");}function g(r){return Router(r)}function B(r,t){let e=g(t);return r(e),e}function b(r){let t=join(r,"expresspack.config"),e=join(r,"app"),s=join(r,"config"),i=join(s,"app"),d=join(s,"body-parser"),p=join(e,"controllers"),n=join(e,"services"),l=join(e,"errors"),u=join(e,"middlewares"),m=join(e,"routes");return {rc:t,root:r,app:e,middlewareFilePath:u,routesFilePath:m,config:{base:s,bodyParserFile:d,appConfigFile:i},controllers:{base:p},services:{base:n},errors:{base:l}}}var R=r=>{let t=["ts","mts","js","mjs","cjs","cts"];for(let e of t){let s=`${r}.${e}`;if(existsSync(s))return s}return null},k=r=>existsSync(r)?r:null;function C(r){if(!r)return "";let t=M.sep;return r.endsWith(t)?r:r+t}var D="*.{js,ts,mjs,cjs,mts,cts}",I=["!*.d.{ts,mts,mjs,cts}","!*.map"];async function S(r){let t=await glob([D,...I],{cwd:r}),e=new Set;return t.forEach(s=>{let i=s.replace(/\.(js|ts|mjs|cjs|mts|cts)$/,"");e.add(i);}),Array.from(e)}async function U(r){let{config:t}=b(r),e=t.base;if(a.debug("Loading all configurations from: `"+C(relative(r,t.base)+"`")),!k(e)){a.debug("No config directory found. Looked for:",e);return}let i=await S(e);a.debug(`Found ${i.length} config files: %s`,`
+   ${i.join(`
+   `)}`);for(let p of i){let n=R(join(e,p));if(!n){a.warn(`No config file found for topic: ${p}`);continue}try{let u=await import(pathToFileURL(n).href),m=u.default||u;typeof m=="function"&&(m=await m());let x=p.replace(/[-_](\w)/g,(H,y)=>y?y.toUpperCase():"");a$2[x]=m;let j=relative(r,n);a.debug(`Loaded config: \`${x}\` from \`${j}\``);}catch(l){a.error(`Failed to load config ${p}:`,l);}}}
 
-export { U as configLoader, g as createRouter, L as defineKernel, K as defineRouterMiddleware, T as gracefulHTTPStart, k as gracefulShutdown, $ as loadKernel };
+export { U as configLoader, g as createRouter, T as defineKernel, $ as defineMiddlewareKernel, B as defineRouterMiddleware, A as gracefulHTTPStart, F as gracefulShutdown, L as loadKernel };

package/dist/middlewares/app-context/index.d.ts

@@ -0,0 +1,48 @@
+import { Request, Response, NextFunction } from 'express';
+
+/**
+ * Configuration options for context middleware
+ */
+interface ContextStoreConfig {
+    /**
+     * Whether to enable the context middleware
+     * @default true
+     */
+    enabled?: boolean;
+}
+/**
+ * Express middleware that initializes async context for each request
+ * This middleware must be registered before any code that uses getAppContext()
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { contextStoreMiddleware } from 'expresspack';
+ *
+ * const app = express();
+ *
+ * // Register as early as possible
+ * app.use(contextStoreMiddleware());
+ * ```
+ */
+declare function contextStoreMiddleware(): (req: Request, res: Response, next: NextFunction) => void;
+/**
+ * For types you need to augment the Request type to include appContext
+ * and also include the type for appContext.
+ *
+ * @example
+ * ```ts
+ * declare global {
+ *  namespace Express {
+ *   interface Request {
+ *      appContext: {
+ *          user: User;
+ *          session: Session;
+ *      };
+ *   }
+ * }
+ * ```
+ */
+declare function simpleContextMiddleware(): (req: Request, res: Response, next: NextFunction) => void;
+
+export { type ContextStoreConfig, contextStoreMiddleware, simpleContextMiddleware };

package/dist/middlewares/app-context/index.mjs

@@ -0,0 +1,6 @@
+import { a } from '../../chunk-55RBYZEZ.mjs';
+import { a as a$1 } from '../../chunk-FFCH7NYQ.mjs';
+
+function u(){return (e,p,t)=>{let n={data:new Map};a.run(n,()=>{t();});}}function c(){return (e,p,t)=>{let n=a$1(e);e.appContext=n,t();}}
+
+export { u as contextStoreMiddleware, c as simpleContextMiddleware };

package/dist/middlewares/body-parser/index.d.ts

@@ -1,7 +1,7 @@
-import express, { Handler } from 'express';
+import express__default, { Handler } from 'express';
 
-type JSONOptions = Parameters<typeof express.json>[0];
-type URLEncodedOptions = Parameters<typeof express.urlencoded>[0];
+type JSONOptions = Parameters<typeof express__default.json>[0];
+type URLEncodedOptions = Parameters<typeof express__default.urlencoded>[0];
 type BodyParserConfig = {
     json?: JSONOptions;
     urlencoded?: URLEncodedOptions;

package/dist/services/event/index.d.ts

@@ -1,20 +1,36 @@
 import * as Emittery from 'emittery';
 import Emittery__default from 'emittery';
 export { default as Emittery } from 'emittery';
+import * as express from 'express';
 
 /**
  * Base event map that users can extend in their applications
  */
 interface EmitterEvents {
-    'app:mounted': undefined;
+    "app:mounted": {
+        app: express.Express;
+    };
 }
 /**
  * Default emitter instance for convenient access
  */
-declare const emitter: Emittery__default<EmitterEvents, EmitterEvents & Emittery.OmnipresentEventData, "app:mounted">;
+declare const emitter: Emittery__default<EmitterEvents, EmitterEvents & Emittery.OmnipresentEventData, never>;
 /**
  * Create a new emitter instance (for testing or isolated use)
  */
 declare function createEmitter<T extends EmitterEvents = EmitterEvents>(): Emittery__default<T>;
+type EventHandler<K extends keyof EmitterEvents> = (payload?: EmitterEvents[K]) => void | Promise<void>;
+type RegisterEventCallback = <K extends keyof EmitterEvents>(event: K, handler: EventHandler<K> | (() => Promise<EventHandler<K>> | Promise<{
+    default: any;
+}>)) => void;
+interface DefineEventContext {
+    /**
+     * Syntactic sugar for registering event listeners
+     */
+    on: RegisterEventCallback;
+    emitter: typeof emitter;
+}
+declare function defineEvents(setup: (context: DefineEventContext) => void): void;
+declare function defineEventHandler<K extends keyof EmitterEvents>(event: K, handler: EventHandler<K> | (() => Promise<EventHandler<K>>)): EventHandler<K> | (() => Promise<EventHandler<K>>);
 
-export { type EmitterEvents, createEmitter, emitter as default, emitter };
+export { type DefineEventContext, type EmitterEvents, type EventHandler, type RegisterEventCallback, createEmitter, emitter as default, defineEventHandler, defineEvents, emitter };

package/dist/services/event/index.mjs

@@ -1 +1 @@
-export { b as createEmitter, c as default, a as emitter } from '../../chunk-CRIPGIHI.mjs';
+export { b as createEmitter, e as default, d as defineEventHandler, c as defineEvents, a as emitter } from '../../chunk-OXUMMLIO.mjs';

package/dist/services/logger/index.mjs

@@ -1,6 +1,6 @@
-import n from 'consola';
+import r from 'consola';
 import { env } from 'process';
 
-var e=env.APP_LOG_LEVEL,l=n.create({level:Number.isNaN(Number(e))?3:Number(e)});function s(o){return l.withTag(o)}function u(o,r){return n.create({level:r.level??(Number.isNaN(Number(e))?3:Number(e))}).withTag(o)}var m=s;
+var s=r.create({level:Number.isNaN(Number(env.APP_LOG_LEVEL))?3:Number(env.APP_LOG_LEVEL)});function l(e){return s.withTag(e)}function p(e,t){let o=process.env.APP_LOG_LEVEL;return r.create({level:t.level??(Number.isNaN(Number(o))?3:Number(o))}).withTag(e)}var u=l;
 
-export { m as Logger, u as createConsoleLogger, l as println, s as useConsoleLogger };
+export { u as Logger, p as createConsoleLogger, s as println, l as useConsoleLogger };

package/dist/utils/import-default.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Dynamically import a module and ensure it has a default export
+ */
+declare function importDefault<T extends object>(importFn: () => Promise<T>, filePath?: string): Promise<T extends {
+    default: infer A;
+} ? A : never>;
+
+export { importDefault };

package/dist/utils/import-default.mjs

@@ -0,0 +1 @@
+export { a as importDefault } from '../chunk-JKH5TYED.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kuwan-expresspack-core",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "",
   "type": "module",
   "main": "./dist/index.mjs",
@@ -33,6 +33,10 @@
       "types": "./dist/env.d.ts",
       "import": "./dist/env.mjs"
     },
+    "./env-config": {
+      "types": "./dist/env-config.d.ts",
+      "import": "./dist/env-config.mjs"
+    },
     "./config": {
       "types": "./dist/config.d.ts",
       "import": "./dist/config.mjs"
@@ -53,6 +57,18 @@
       "types": "./dist/middlewares/error-handler/index.d.ts",
       "import": "./dist/middlewares/error-handler/index.mjs"
     },
+    "./middlewares/app-context": {
+      "types": "./dist/middlewares/app-context/index.d.ts",
+      "import": "./dist/middlewares/app-context/index.mjs"
+    },
+    "./context-store": {
+      "types": "./dist/context/context-store/index.d.ts",
+      "import": "./dist/context/context-store/index.mjs"
+    },
+    "./simple-context": {
+      "types": "./dist/context/simple-context.d.ts",
+      "import": "./dist/context/simple-context.mjs"
+    },
     "./services/*": {
       "types": "./dist/services/*/index.d.ts",
       "import": "./dist/services/*/index.mjs"

package/dist/chunk-AFN6MPA7.mjs

@@ -1,12 +0,0 @@
-import { z } from 'zod';
-import { config } from '@dotenvx/dotenvx';
-import O from 'consola';
-import { colorize } from 'consola/utils';
-
-var v=process.env.EXPRESSPACK_LOG_LEVEL,h=O.create({level:Number.isNaN(Number(v))?3:Number(v)});function E(r){switch(typeof r){case "number":case "bigint":return colorize("cyan",r.toString());case "boolean":return colorize(r?"green":"red",String(r));case "symbol":return colorize("magenta",r.toString());case "string":return isNaN(Number(r))?colorize("whiteBright",`${r}`):colorize("yellow",`'${r}'`);case "undefined":return colorize("gray","undefined")}return r===null?colorize("dim","null"):String(r)}var o=h;var f,s=null,c=null,m={};function w(r,e){let t=r.safeParse(e);if(t.success)return t.data;console.error("\u274C Invalid environment variables:"),console.error(z.prettifyError(t.error));}function C(r,e,t={fatal:false,immediate_log_error:true,log_error_after_graceful_start:true}){if(m=t,t.fatal)try{let n=r.parse(e);return {...f,...n}}catch(n){throw n instanceof z.ZodError?(s=z.prettifyError(n),c=n,o.error("\u274C Invalid environment variables:"),o.error("\u274C",s),new Error("Invalid environment variables. The environment variable did not pass the schema validation. Check if you have set all required environment variables correctly.")):n}let i=r.safeParse(e);if(!i.success){let n=r.partial().safeParse(e);if(!n.success)return s=z.prettifyError(i.error),c=i.error,t.immediate_log_error&&(o.error("\u274C Invalid environment variables:"),o.error("\u274C",s)),f||{};s=z.prettifyError(i.error),c=i.error,t.immediate_log_error&&(o.error("\u274C Invalid environment variables:"),o.error("\u274C",s));let d=r.keyof();for(let g of d.options)g in n.data||(n.data[g]=void 0);return {...f,...n.data}}return {...f,...i.data}}function N(){return c}function b(){return s}function P(r){if(!r||Object.keys(r).length===0){o.warn("No environment variables to print. Make sure the env is complete and valid.");return}let e=Object.entries(r).sort(([l],[p])=>l.localeCompare(p)),t=Math.max(...e.map(([l])=>l.length))+2,i=e.map(([l,p])=>`${l.padEnd(t," ")} ${E(p)}`),n=`KEY${" ".repeat(t-3)} VALUE`,d=" ".repeat(n.length);return [d,n,d,...i].join(`
-`)}function S(){if(m){let{log_error_after_graceful_start:r}=m;if(r){let e=b();e&&o.error("Invalid Environment Variable Value",`
------
-${e}
------`);}}}function k(r){let e=config(r);return f=e.parsed?e.parsed:void 0,e}var Z={create:C,parseEnv:w,prettifyEnv:P,getEnvErrorRaw:N,getEnvErrorString:b,logEnvErrors:S,config:k};
-
-export { o as a, C as b, N as c, b as d, P as e, S as f, k as g, Z as h };

package/dist/chunk-CRIPGIHI.mjs

@@ -1,6 +0,0 @@
-import t from 'emittery';
-import { env } from 'process';
-
-function E(){return env.EXPRESSPACK_EVENT_EMITTER_DEBUG==="true"||env.EXPRESSPACK_EVENT_EMITTER_DEBUG==="1"||(typeof env.EXPRESSPACK_EVENT_EMITTER_DEBUG=="boolean"?env.EXPRESSPACK_EVENT_EMITTER_DEBUG===true:false)}var r=new t({debug:{name:"expresspack-emitter",enabled:E()}});function T(){return new t({debug:{name:"c-emitter",enabled:E()}})}var a=r;
-
-export { r as a, T as b, a as c };