kuwan-expresspack-core 0.1.17 → 0.1.19

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/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.d.ts

@@ -67,12 +67,35 @@ declare function loadKernel({ app }: {
 
 declare function createRouter(options?: RouterOptions): Router;
 
+interface DefineRouteMiddlewareContext {
+    app?: Express;
+    router: Router;
+}
+interface DefineRouterMiddlewareReturn {
+    (app?: Express): Router;
+}
 /**
  * Utility to define a router middleware using a callback.
  * @param fn Callback to register routes on the router
  * @returns Express Router instance
+ *
+ * @example
+ *
+ * ```ts
+ * const routerMiddleware =  defineRouterMiddleware(({ router, app }) => {
+ *  router.get('/hello', (req, res) => {
+ *    res.send('Hello from router middleware!');
+ *  });
+ *
+ *  app.use(controller);
+ * });
+ *
+ * // In your main app file
+ * const app = express();
+ * app.use(middlewares);
+ * routerMiddleware(app);
  */
-declare function defineRouterMiddleware(fn: (r: Router) => void, options?: RouterOptions): Router;
+declare function defineRouterMiddleware(fn: (context: DefineRouteMiddlewareContext) => void, options?: RouterOptions): DefineRouterMiddlewareReturn;
 
 /**
  * Load all configurations from the config directory

package/dist/index.mjs

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kuwan-expresspack-core",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "description": "",
   "type": "module",
   "main": "./dist/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 };