@fade_networker/vono 0.1.0

package/dist/config/define-config.d.ts

@@ -0,0 +1,25 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import type { VonoConfig } from '../types/index.js';
+/**
+ * Define and validate the Vono framework configuration.
+ *
+ * Place this in `vono.config.ts` at the project root:
+ * ```ts
+ * import { defineVonoConfig } from 'vono'
+ * export default defineVonoConfig({ ... })
+ * ```
+ */
+export declare function defineVonoConfig(config: VonoConfig): VonoConfig;
+/**
+ * Get the resolved config. Throws if defineVonoConfig has not been called.
+ */
+export declare function getResolvedConfig(): VonoConfig;
+//# sourceMappingURL=define-config.d.ts.map

package/dist/config/define-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-config.d.ts","sourceRoot":"","sources":["../../src/config/define-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAKnD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAI/D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,UAAU,CAQ9C"}

package/dist/config/define-config.js

@@ -0,0 +1,63 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+// Resolved config singleton — set once at startup
+let _resolvedConfig = null;
+/**
+ * Define and validate the Vono framework configuration.
+ *
+ * Place this in `vono.config.ts` at the project root:
+ * ```ts
+ * import { defineVonoConfig } from 'vono'
+ * export default defineVonoConfig({ ... })
+ * ```
+ */
+export function defineVonoConfig(config) {
+    validateConfig(config);
+    _resolvedConfig = config;
+    return config;
+}
+/**
+ * Get the resolved config. Throws if defineVonoConfig has not been called.
+ */
+export function getResolvedConfig() {
+    if (!_resolvedConfig) {
+        throw new Error('[vono] Configuration not initialized. ' +
+            'Ensure vono.config.ts exports a defineVonoConfig() call.');
+    }
+    return _resolvedConfig;
+}
+// ─── Validation ─────────────────────────────────────────────────────
+function validateConfig(config) {
+    if (!config.app) {
+        throw new Error('[vono] defineVonoConfig: "app" section is required');
+    }
+    if (!config.app.name) {
+        throw new Error('[vono] defineVonoConfig: "app.name" is required');
+    }
+    if (!config.runtime) {
+        throw new Error('[vono] defineVonoConfig: "runtime" is required');
+    }
+    if (!config.mode) {
+        throw new Error('[vono] defineVonoConfig: "mode" is required (fullstack | api)');
+    }
+    const validRuntimes = [
+        'cloudflare-workers', 'cloudflare-pages', 'bun', 'node',
+        'deno', 'aws-lambda', 'vercel', 'netlify', 'fastly',
+    ];
+    if (!validRuntimes.includes(config.runtime)) {
+        throw new Error(`[vono] defineVonoConfig: invalid runtime "${config.runtime}". ` +
+            `Valid options: ${validRuntimes.join(', ')}`);
+    }
+    if (!['fullstack', 'api'].includes(config.mode)) {
+        throw new Error(`[vono] defineVonoConfig: invalid mode "${config.mode}". ` +
+            `Valid options: fullstack, api`);
+    }
+}
+//# sourceMappingURL=define-config.js.map

package/dist/config/define-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-config.js","sourceRoot":"","sources":["../../src/config/define-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,kDAAkD;AAClD,IAAI,eAAe,GAAsB,IAAI,CAAA;AAE7C;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAkB;IACjD,cAAc,CAAC,MAAM,CAAC,CAAA;IACtB,eAAe,GAAG,MAAM,CAAA;IACxB,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,wCAAwC;YACxC,0DAA0D,CAC3D,CAAA;IACH,CAAC;IACD,OAAO,eAAe,CAAA;AACxB,CAAC;AAED,uEAAuE;AAEvE,SAAS,cAAc,CAAC,MAAkB;IACxC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAA;IACvE,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAA;IACpE,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAA;IACnE,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAA;IAClF,CAAC;IAED,MAAM,aAAa,GAAG;QACpB,oBAAoB,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM;QACvD,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ;KACpD,CAAA;IACD,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CACb,6CAA6C,MAAM,CAAC,OAAO,KAAK;YAChE,kBAAkB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC7C,CAAA;IACH,CAAC;IAED,IAAI,CAAC,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CACb,0CAA0C,MAAM,CAAC,IAAI,KAAK;YAC1D,+BAA+B,CAChC,CAAA;IACH,CAAC;AACH,CAAC"}

package/dist/config/env-helpers.d.ts

@@ -0,0 +1,30 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+/**
+ * Read an env var with an optional fallback.
+ * Returns the fallback (or empty string) if the key is not set.
+ */
+export declare function env(key: string, fallback?: string): string;
+/**
+ * Read an env var and parse it as a number.
+ * Returns the fallback if the key is not set or not a valid number.
+ */
+export declare function envNumber(key: string, fallback: number): number;
+/**
+ * Read an env var and parse it as a boolean.
+ * "true", "1", "yes" → true. Everything else → false.
+ */
+export declare function envBool(key: string, fallback: boolean): boolean;
+/**
+ * Read a required env var. Throws at startup if missing.
+ * Use this for vars that MUST be present (e.g. JWT_SECRET).
+ */
+export declare function envRequired(key: string): string;
+//# sourceMappingURL=env-helpers.d.ts.map

package/dist/config/env-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-helpers.d.ts","sourceRoot":"","sources":["../../src/config/env-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;GAGG;AACH,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,SAAK,GAAG,MAAM,CAEtD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAK/D;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAI/D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAS/C"}

package/dist/config/env-helpers.js

@@ -0,0 +1,50 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+/**
+ * Read an env var with an optional fallback.
+ * Returns the fallback (or empty string) if the key is not set.
+ */
+export function env(key, fallback = '') {
+    return (typeof process !== 'undefined' ? process.env[key] : undefined) ?? fallback;
+}
+/**
+ * Read an env var and parse it as a number.
+ * Returns the fallback if the key is not set or not a valid number.
+ */
+export function envNumber(key, fallback) {
+    const raw = env(key);
+    if (!raw)
+        return fallback;
+    const parsed = Number(raw);
+    return Number.isNaN(parsed) ? fallback : parsed;
+}
+/**
+ * Read an env var and parse it as a boolean.
+ * "true", "1", "yes" → true. Everything else → false.
+ */
+export function envBool(key, fallback) {
+    const raw = env(key);
+    if (!raw)
+        return fallback;
+    return ['true', '1', 'yes'].includes(raw.toLowerCase());
+}
+/**
+ * Read a required env var. Throws at startup if missing.
+ * Use this for vars that MUST be present (e.g. JWT_SECRET).
+ */
+export function envRequired(key) {
+    const value = env(key);
+    if (!value) {
+        throw new Error(`[vono] Missing required environment variable: ${key}\n` +
+            `Add it to your .env file and .env.example.`);
+    }
+    return value;
+}
+//# sourceMappingURL=env-helpers.js.map

package/dist/config/env-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-helpers.js","sourceRoot":"","sources":["../../src/config/env-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;GAGG;AACH,MAAM,UAAU,GAAG,CAAC,GAAW,EAAE,QAAQ,GAAG,EAAE;IAC5C,OAAO,CAAC,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAA;AACpF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,QAAgB;IACrD,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAA;IACpB,IAAI,CAAC,GAAG;QAAE,OAAO,QAAQ,CAAA;IACzB,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;IAC1B,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAA;AACjD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,GAAW,EAAE,QAAiB;IACpD,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAA;IACpB,IAAI,CAAC,GAAG;QAAE,OAAO,QAAQ,CAAA;IACzB,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAA;AACzD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAA;IACtB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,iDAAiD,GAAG,IAAI;YACxD,4CAA4C,CAC7C,CAAA;IACH,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/config/use-config.d.ts

@@ -0,0 +1,31 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import type { VonoConfig } from '../types/index.js';
+/**
+ * Keys that are safe to expose to the client (no secrets).
+ * Server-only keys (JWT_SECRET, DB credentials, etc.) are stripped.
+ */
+declare const PUBLIC_CONFIG_KEYS: Array<keyof VonoConfig>;
+export type PublicVonoConfig = Pick<VonoConfig, typeof PUBLIC_CONFIG_KEYS[number]>;
+/**
+ * Access the Vono config.
+ *
+ * On the server: returns the full config.
+ * On the client: returns only public-safe keys (no secrets).
+ *
+ * Usage in Vue components / composables:
+ * ```ts
+ * const config = useVonoConfig()
+ * console.log(config.app.name)
+ * ```
+ */
+export declare function useVonoConfig(): PublicVonoConfig;
+export {};
+//# sourceMappingURL=use-config.d.ts.map

package/dist/config/use-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-config.d.ts","sourceRoot":"","sources":["../../src/config/use-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAGnD;;;GAGG;AACH,QAAA,MAAM,kBAAkB,EAAE,KAAK,CAAC,MAAM,UAAU,CAM/C,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,UAAU,EAAE,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAA;AAElF;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,IAAI,gBAAgB,CAgBhD"}

package/dist/config/use-config.js

@@ -0,0 +1,49 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import { getResolvedConfig } from './define-config.js';
+/**
+ * Keys that are safe to expose to the client (no secrets).
+ * Server-only keys (JWT_SECRET, DB credentials, etc.) are stripped.
+ */
+const PUBLIC_CONFIG_KEYS = [
+    'app',
+    'mode',
+    'runtime',
+    'ui',
+    'docs',
+];
+/**
+ * Access the Vono config.
+ *
+ * On the server: returns the full config.
+ * On the client: returns only public-safe keys (no secrets).
+ *
+ * Usage in Vue components / composables:
+ * ```ts
+ * const config = useVonoConfig()
+ * console.log(config.app.name)
+ * ```
+ */
+export function useVonoConfig() {
+    const full = getResolvedConfig();
+    // On the client, only expose public keys
+    if (typeof window !== 'undefined') {
+        const publicConfig = {};
+        for (const key of PUBLIC_CONFIG_KEYS) {
+            if (key in full) {
+                publicConfig[key] = full[key];
+            }
+        }
+        return publicConfig;
+    }
+    // On the server, return the full config
+    return full;
+}
+//# sourceMappingURL=use-config.js.map

package/dist/config/use-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-config.js","sourceRoot":"","sources":["../../src/config/use-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAEtD;;;GAGG;AACH,MAAM,kBAAkB,GAA4B;IAClD,KAAK;IACL,MAAM;IACN,SAAS;IACT,IAAI;IACJ,MAAM;CACP,CAAA;AAID;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,IAAI,GAAG,iBAAiB,EAAE,CAAA;IAEhC,yCAAyC;IACzC,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,MAAM,YAAY,GAAwB,EAAE,CAAA;QAC5C,KAAK,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAC;YACrC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;gBACf,YAAwC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAA;YAC5D,CAAC;QACH,CAAC;QACD,OAAO,YAAgC,CAAA;IACzC,CAAC;IAED,wCAAwC;IACxC,OAAO,IAAwB,CAAA;AACjC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+export { defineVonoConfig, getResolvedConfig } from './config/define-config.js';
+export { useVonoConfig } from './config/use-config.js';
+export { env, envNumber, envBool, envRequired } from './config/env-helpers.js';
+export type { PublicVonoConfig } from './config/use-config.js';
+export type { VonoConfig } from './types/index.js';
+export * from './types/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AACtD,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAC9E,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,cAAc,kBAAkB,CAAA"}

package/dist/index.js

@@ -0,0 +1,15 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+// Main vono entry — config and composables
+export { defineVonoConfig, getResolvedConfig } from './config/define-config.js';
+export { useVonoConfig } from './config/use-config.js';
+export { env, envNumber, envBool, envRequired } from './config/env-helpers.js';
+export * from './types/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,2CAA2C;AAC3C,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AACtD,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAG9E,cAAc,kBAAkB,CAAA"}

package/dist/module-system/define-module.d.ts

@@ -0,0 +1,82 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import type { ZodSchema } from 'zod';
+export type VonoLifecycleHook = 'app:created' | 'app:ready' | 'build:before' | 'build:after' | 'routes:resolved';
+export interface VonoModuleHooks {
+    'app:created'?: (...args: unknown[]) => void | Promise<void>;
+    'app:ready'?: (...args: unknown[]) => void | Promise<void>;
+    'build:before'?: (...args: unknown[]) => void | Promise<void>;
+    'build:after'?: (...args: unknown[]) => void | Promise<void>;
+    'routes:resolved'?: (...args: unknown[]) => void | Promise<void>;
+}
+export interface VonoModuleDefinition {
+    /** Unique module identifier, e.g. '@vono/auth' */
+    name: string;
+    /** Semver version string */
+    version: string;
+    /** Other module names this module depends on */
+    requires?: string[];
+    /** Hono middleware to register globally */
+    middleware?: Array<(...args: unknown[]) => unknown>;
+    /** Zod schemas exported by this module */
+    schemas?: Record<string, ZodSchema>;
+    /** Server-side auto-imports to inject */
+    serverImports?: Array<{
+        from: string;
+        imports: string[];
+    }>;
+    /** Client-side auto-imports to inject */
+    clientImports?: Array<{
+        from: string;
+        imports: string[];
+    }>;
+    /** Page components to register */
+    pages?: Array<{
+        path: string;
+        component: string;
+    }>;
+    /** Vue components to register */
+    components?: Array<{
+        name: string;
+        path: string;
+    }>;
+    /** API routes to register */
+    routes?: Array<{
+        path: string;
+        handler: string;
+    }>;
+    /** Drizzle migration files */
+    migrations?: string[];
+    /** Zod schema for module config validation */
+    configSchema?: ZodSchema;
+    /** Setup function called when the module is initialized */
+    setup?: (options?: Record<string, unknown>) => void | Promise<void>;
+    /** Lifecycle hooks */
+    hooks?: VonoModuleHooks;
+}
+/**
+ * defineVonoModule — validates and returns the module definition.
+ *
+ * Throws if required fields (name, version) are missing.
+ *
+ * @example
+ * ```ts
+ * export default defineVonoModule({
+ *   name: '@vono/auth',
+ *   version: '0.1.0',
+ *   setup: async () => { ... },
+ *   hooks: {
+ *     'app:ready': (app) => { ... },
+ *   },
+ * })
+ * ```
+ */
+export declare function defineVonoModule(definition: VonoModuleDefinition): VonoModuleDefinition;
+//# sourceMappingURL=define-module.d.ts.map

package/dist/module-system/define-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-module.d.ts","sourceRoot":"","sources":["../../src/module-system/define-module.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AAIpC,MAAM,MAAM,iBAAiB,GACzB,aAAa,GACb,WAAW,GACX,cAAc,GACd,aAAa,GACb,iBAAiB,CAAA;AAErB,MAAM,WAAW,eAAe;IAC9B,aAAa,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5D,WAAW,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1D,cAAc,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7D,aAAa,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5D,iBAAiB,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACjE;AAED,MAAM,WAAW,oBAAoB;IACnC,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAA;IAEZ,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAA;IAEf,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IAEnB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAA;IAEnD,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAEnC,yCAAyC;IACzC,aAAa,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAA;IAE1D,yCAAyC;IACzC,aAAa,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAA;IAE1D,kCAAkC;IAClC,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAElD,iCAAiC;IACjC,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAElD,6BAA6B;IAC7B,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAEjD,8BAA8B;IAC9B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IAErB,8CAA8C;IAC9C,YAAY,CAAC,EAAE,SAAS,CAAA;IAExB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEnE,sBAAsB;IACtB,KAAK,CAAC,EAAE,eAAe,CAAA;CACxB;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,oBAAoB,GAAG,oBAAoB,CAUvF"}

package/dist/module-system/define-module.js

@@ -0,0 +1,37 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+// ─── defineVonoModule ────────────────────────────────────────────────
+/**
+ * defineVonoModule — validates and returns the module definition.
+ *
+ * Throws if required fields (name, version) are missing.
+ *
+ * @example
+ * ```ts
+ * export default defineVonoModule({
+ *   name: '@vono/auth',
+ *   version: '0.1.0',
+ *   setup: async () => { ... },
+ *   hooks: {
+ *     'app:ready': (app) => { ... },
+ *   },
+ * })
+ * ```
+ */
+export function defineVonoModule(definition) {
+    if (!definition.name) {
+        throw new Error('[vono] defineVonoModule: "name" is required');
+    }
+    if (!definition.version) {
+        throw new Error(`[vono] defineVonoModule: "version" is required for module "${definition.name}"`);
+    }
+    return definition;
+}
+//# sourceMappingURL=define-module.js.map

package/dist/module-system/define-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-module.js","sourceRoot":"","sources":["../../src/module-system/define-module.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAiEH,wEAAwE;AAExE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAgC;IAC/D,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;IAChE,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,8DAA8D,UAAU,CAAC,IAAI,GAAG,CAAC,CAAA;IACnG,CAAC;IAED,OAAO,UAAU,CAAA;AACnB,CAAC"}

package/dist/module-system/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+export { defineVonoModule } from './define-module.js';
+export { registerModule, getModules, runHook, clearRegistry } from './module-registry.js';
+export { applyModulesToViteConfig } from './vite-integration.js';
+export type { VonoModuleDefinition, VonoModuleHooks, VonoLifecycleHook } from './define-module.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/module-system/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/module-system/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzF,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAA;AAChE,YAAY,EAAE,oBAAoB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/module-system/index.js

@@ -0,0 +1,13 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+export { defineVonoModule } from './define-module.js';
+export { registerModule, getModules, runHook, clearRegistry } from './module-registry.js';
+export { applyModulesToViteConfig } from './vite-integration.js';
+//# sourceMappingURL=index.js.map

package/dist/module-system/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/module-system/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzF,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/module-system/module-registry.d.ts

@@ -0,0 +1,37 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import type { VonoModuleDefinition, VonoLifecycleHook } from './define-module.js';
+/**
+ * registerModule — adds a module to the global registry.
+ *
+ * Throws if a module with the same name is already registered.
+ */
+export declare function registerModule(module: VonoModuleDefinition): void;
+/**
+ * getModules — returns all registered modules.
+ */
+export declare function getModules(): VonoModuleDefinition[];
+/**
+ * runHook — runs all registered hooks for a lifecycle event.
+ *
+ * Hooks are called in registration order.
+ * Errors in individual hooks are caught and logged — they do not
+ * prevent other hooks from running.
+ *
+ * @param hookName — lifecycle event name
+ * @param args     — arguments passed to each hook handler
+ */
+export declare function runHook(hookName: VonoLifecycleHook, ...args: unknown[]): Promise<void>;
+/**
+ * clearRegistry — resets the module registry.
+ * Intended for use in tests only.
+ */
+export declare function clearRegistry(): void;
+//# sourceMappingURL=module-registry.d.ts.map

package/dist/module-system/module-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-registry.d.ts","sourceRoot":"","sources":["../../src/module-system/module-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AASjF;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAYjE;AAID;;GAEG;AACH,wBAAgB,UAAU,IAAI,oBAAoB,EAAE,CAEnD;AAID;;;;;;;;;GASG;AACH,wBAAsB,OAAO,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAc5F;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAEpC"}

package/dist/module-system/module-registry.js

@@ -0,0 +1,68 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import { Logger } from '../shared/utils/logger.js';
+// ─── Registry state ──────────────────────────────────────────────────
+const registry = [];
+// ─── registerModule ──────────────────────────────────────────────────
+/**
+ * registerModule — adds a module to the global registry.
+ *
+ * Throws if a module with the same name is already registered.
+ */
+export function registerModule(module) {
+    const existing = registry.find((m) => m.name === module.name);
+    if (existing) {
+        throw new Error(`[vono] Module "${module.name}" is already registered. ` +
+            `Each module can only be registered once.`);
+    }
+    registry.push(module);
+    Logger.info(`[vono] Module registered: ${module.name}@${module.version}`);
+}
+// ─── getModules ──────────────────────────────────────────────────────
+/**
+ * getModules — returns all registered modules.
+ */
+export function getModules() {
+    return [...registry];
+}
+// ─── runHook ─────────────────────────────────────────────────────────
+/**
+ * runHook — runs all registered hooks for a lifecycle event.
+ *
+ * Hooks are called in registration order.
+ * Errors in individual hooks are caught and logged — they do not
+ * prevent other hooks from running.
+ *
+ * @param hookName — lifecycle event name
+ * @param args     — arguments passed to each hook handler
+ */
+export async function runHook(hookName, ...args) {
+    for (const module of registry) {
+        const hook = module.hooks?.[hookName];
+        if (!hook)
+            continue;
+        try {
+            await hook(...args);
+        }
+        catch (err) {
+            Logger.error(`[vono] Hook "${hookName}" failed in module "${module.name}"`, {
+                error: String(err),
+            });
+        }
+    }
+}
+/**
+ * clearRegistry — resets the module registry.
+ * Intended for use in tests only.
+ */
+export function clearRegistry() {
+    registry.length = 0;
+}
+//# sourceMappingURL=module-registry.js.map

package/dist/module-system/module-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-registry.js","sourceRoot":"","sources":["../../src/module-system/module-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AAElD,wEAAwE;AAExE,MAAM,QAAQ,GAA2B,EAAE,CAAA;AAE3C,wEAAwE;AAExE;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,MAA4B;IACzD,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,CAAA;IAE7D,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,kBAAkB,MAAM,CAAC,IAAI,2BAA2B;YACtD,0CAA0C,CAC7C,CAAA;IACH,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACrB,MAAM,CAAC,IAAI,CAAC,6BAA6B,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC,CAAA;AAC3E,CAAC;AAED,wEAAwE;AAExE;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAA;AACtB,CAAC;AAED,wEAAwE;AAExE;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,QAA2B,EAAE,GAAG,IAAe;IAC3E,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,QAAQ,CAAC,CAAA;QAErC,IAAI,CAAC,IAAI;YAAE,SAAQ;QAEnB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC,CAAA;QACrB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,gBAAgB,QAAQ,uBAAuB,MAAM,CAAC,IAAI,GAAG,EAAE;gBAC1E,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC;aACnB,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAA;AACrB,CAAC"}

package/dist/module-system/vite-integration.d.ts

@@ -0,0 +1,23 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import type { UserConfig } from 'vite';
+import type { VonoModuleDefinition } from './define-module.js';
+/**
+ * applyModulesToViteConfig — merges module schemas, routes,
+ * auto-imports, and pages into the Vite config at build time.
+ *
+ * Called by the Vono Vite plugin when building the project.
+ *
+ * @param modules — registered VonoModuleDefinition array
+ * @param config  — existing Vite UserConfig to merge into
+ * @returns merged Vite config
+ */
+export declare function applyModulesToViteConfig(modules: VonoModuleDefinition[], config: UserConfig): UserConfig;
+//# sourceMappingURL=vite-integration.d.ts.map

package/dist/module-system/vite-integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-integration.d.ts","sourceRoot":"","sources":["../../src/module-system/vite-integration.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAA;AACtC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAK9D;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,oBAAoB,EAAE,EAC/B,MAAM,EAAE,UAAU,GACjB,UAAU,CAmDZ"}