kuwan-expresspack-core 0.1.16 → 0.1.18

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-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-XWAHBJNF.mjs

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+import { config } from '@dotenvx/dotenvx';
+import { colorize } from 'consola/utils';
+import w 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=w.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 d,c=null,v=null,y={},E=[];function I(r,n){let t=r.safeParse(n);if(t.success)return t.data;console.error("\u274C Invalid environment variables:"),console.error(z.prettifyError(t.error));}function R(r,n,t={fatal:false,immediate_log_error:true,log_error_after_graceful_start:true}){if(b(),y=t,t.fatal)try{let o=r.parse(n);return {...d,...o}}catch(o){throw o instanceof z.ZodError?(c=z.prettifyError(o),v=o,s.error("\u274C Invalid environment variables:"),s.error("\u274C",c),new Error("Invalid environment variables. The environment variable did not pass the schema validation. Check if you have set all required environment variables correctly.")):o}let i=r.safeParse(n);if(!i.success){let o=r.partial().safeParse(n);if(!o.success)return c=z.prettifyError(i.error),v=i.error,t.immediate_log_error&&(s.error("\u274C Invalid environment variables:"),s.error("\u274C",c)),d||{};c=z.prettifyError(i.error),v=i.error,t.immediate_log_error&&(s.error("\u274C Invalid environment variables:"),s.error("\u274C",c));let f=r.keyof();E=f.options;for(let p of f.options)p in o.data||(o.data[p]=void 0);return {...d,...o.data}}let a=r.keyof();E=a.options;for(let o of a.options)o in i.data||(i.data[o]=void 0);return {...d,...i.data}}function T(){return v}function S(){return c}function L(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,t=e=>E.includes(e)?e:`* ${e}`,i=e=>e.startsWith("! ")?m("dim",m("yellow",`${e}`)):e,a=e=>E.includes(e)&&r[e]===void 0?`! ${e}`:e,o=Object.entries(r).sort(([e],[l])=>e.localeCompare(l)).map(([e,l])=>[t(e),l]).map(([e,l])=>[a(e),l]),f=Math.max(...o.map(([e])=>e.length))+2,p=o.map(([e,l])=>`${e.padEnd(f," ").replace(e,n(e)).replace(e,i(e))} ${N(l)}`),_=`KEY${" ".repeat(f-3)} VALUE`,h=" ".repeat(_.length);return [h,_,h,...p].join(`
+`)}function $(){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,n){s.log("[Environment Variables] on `env.ts`");let t=Object.fromEntries(Object.entries({...r}).map(([i,a])=>typeof a=="string"&&a.length>36?[i,`${a.slice(0,36)}...`]:n?n(i,a):[i,a]));s.log(`${L(t)}
+`);}function C(r){d={};let n=config(r);return b(),d=n.parsed?n.parsed:void 0,n}function K(r){return new Proxy(r,{get(n,t){return t in n?n[t]:process.env[t]}})}function j(r,n,t){let i=R(r,n,t);return K(i)}var H={create:j,parseEnv:I,prettifyEnv:L,getEnvErrorRaw:T,getEnvErrorString:S,logEnvErrors:$,config:C};
+
+export { s as a, R as b, T as c, S as d, L as e, $ as f, k as g, C as h, H as i };

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.mjs

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

package/dist/env.d.ts

@@ -55,6 +55,13 @@ declare function prettifyEnv(env: Record<string, any>): string | undefined;
  * Errors are already logged after by graceful start.
  */
 declare function logEnvErrors(): void;
+/**
+ * This will print the passed env vars regardless of the NODE_ENV,
+ * it is on your discretion on when to call this function.
+ *
+ * @param envVars The environment variables to log
+ */
+declare function debugEnvVars(envVars: Record<string, any>, redactFunction?: (key: string, value: any) => [string, any]): 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: {
@@ -67,4 +74,4 @@ declare const _default: {
     config: typeof config;
 };
 
-export { type EnvOptions, config, create, _default as default, getEnvErrorRaw, getEnvErrorString, logEnvErrors, prettifyEnv };
+export { type EnvOptions, config, create, debugEnvVars, _default as default, getEnvErrorRaw, getEnvErrorString, logEnvErrors, prettifyEnv };

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-CZGPAGDK.mjs';
+export { h as config, b as create, g as debugEnvVars, i as default, c as getEnvErrorRaw, d as getEnvErrorString, f as logEnvErrors, e as prettifyEnv } from './chunk-XWAHBJNF.mjs';

package/dist/index.mjs

@@ -1,7 +1,7 @@
-import { a as a$1 } from './chunk-JKH5TYED.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 { a, f } from './chunk-XWAHBJNF.mjs';
 import { Router } from 'express';
 import M, { relative, join } from 'path';
 import { existsSync } from 'fs';

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kuwan-expresspack-core",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "description": "",
   "type": "module",
   "main": "./dist/index.mjs",
@@ -57,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-CZGPAGDK.mjs

@@ -1,12 +0,0 @@
-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 };