@fade_networker/vono 0.1.0

package/dist/server/env-validation/define-env.d.ts

@@ -0,0 +1,45 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 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 interface DefineEnvOptions<T> {
+    /**
+     * Optional cross-field validation function.
+     * Return true to pass, or a string error message to fail.
+     */
+    refine?: (env: T) => boolean | string;
+}
+/**
+ * defineEnv — wraps Zod validation for environment variables.
+ *
+ * Validates `process.env` against the provided schema at call time.
+ * On failure: prints a formatted error listing each failing variable
+ * with its Zod message, then calls `process.exit(1)`.
+ *
+ * @example
+ * ```ts
+ * // src/env.ts
+ * import { defineEnv } from 'vono/server'
+ * import { z } from 'zod'
+ *
+ * export const env = defineEnv(
+ *   z.object({
+ *     DATABASE_URL: z.string().url(),
+ *     JWT_SECRET: z.string().min(32),
+ *     PORT: z.coerce.number().default(4000),
+ *   }),
+ *   {
+ *     refine: (e) =>
+ *       e.JWT_SECRET !== 'change-me' || 'JWT_SECRET must not be the default value',
+ *   },
+ * )
+ * ```
+ */
+export declare function defineEnv<T>(schema: ZodSchema<T>, options?: DefineEnvOptions<T>): T;
+//# sourceMappingURL=define-env.d.ts.map

package/dist/server/env-validation/define-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-env.d.ts","sourceRoot":"","sources":["../../../src/server/env-validation/define-env.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AAKpC,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,GAAG,MAAM,CAAA;CACtC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,SAAS,CAAC,CAAC,EACzB,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC5B,CAAC,CAGH"}

package/dist/server/env-validation/define-env.js

@@ -0,0 +1,41 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import { validateEnvAtStartup } from './validate-at-startup.js';
+/**
+ * defineEnv — wraps Zod validation for environment variables.
+ *
+ * Validates `process.env` against the provided schema at call time.
+ * On failure: prints a formatted error listing each failing variable
+ * with its Zod message, then calls `process.exit(1)`.
+ *
+ * @example
+ * ```ts
+ * // src/env.ts
+ * import { defineEnv } from 'vono/server'
+ * import { z } from 'zod'
+ *
+ * export const env = defineEnv(
+ *   z.object({
+ *     DATABASE_URL: z.string().url(),
+ *     JWT_SECRET: z.string().min(32),
+ *     PORT: z.coerce.number().default(4000),
+ *   }),
+ *   {
+ *     refine: (e) =>
+ *       e.JWT_SECRET !== 'change-me' || 'JWT_SECRET must not be the default value',
+ *   },
+ * )
+ * ```
+ */
+export function defineEnv(schema, options) {
+    const rawEnv = typeof process !== 'undefined' ? process.env : {};
+    return validateEnvAtStartup(schema, rawEnv, options?.refine);
+}
+//# sourceMappingURL=define-env.js.map

package/dist/server/env-validation/define-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-env.js","sourceRoot":"","sources":["../../../src/server/env-validation/define-env.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAY/D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,SAAS,CACvB,MAAoB,EACpB,OAA6B;IAE7B,MAAM,MAAM,GAAG,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;IAChE,OAAO,oBAAoB,CAAC,MAAM,EAAE,MAAgC,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;AACxF,CAAC"}

package/dist/server/env-validation/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+export { defineEnv } from './define-env.js';
+export { validateEnvAtStartup } from './validate-at-startup.js';
+export type { DefineEnvOptions } from './define-env.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/env-validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/env-validation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAC/D,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/server/env-validation/index.js

@@ -0,0 +1,12 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+export { defineEnv } from './define-env.js';
+export { validateEnvAtStartup } from './validate-at-startup.js';
+//# sourceMappingURL=index.js.map

package/dist/server/env-validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/env-validation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA"}

package/dist/server/env-validation/validate-at-startup.d.ts

@@ -0,0 +1,29 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import type { ZodSchema } from 'zod';
+/**
+ * validateEnvAtStartup — validates env vars before accepting requests.
+ *
+ * On failure: prints a formatted error message and calls process.exit(1).
+ * On success: returns the typed, validated config object.
+ *
+ * Error format:
+ * ```
+ * [vono] Missing/invalid env vars:
+ *   ❌ DATABASE_URL: Invalid url
+ *   ❌ JWT_SECRET: String must contain at least 32 character(s)
+ * ```
+ *
+ * @param schema — Zod schema to validate against
+ * @param env    — raw environment variables map
+ * @param refine — optional cross-field validation function
+ */
+export declare function validateEnvAtStartup<T>(schema: ZodSchema<T>, env: Record<string, string | undefined>, refine?: (env: T) => boolean | string): T;
+//# sourceMappingURL=validate-at-startup.d.ts.map

package/dist/server/env-validation/validate-at-startup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-at-startup.d.ts","sourceRoot":"","sources":["../../../src/server/env-validation/validate-at-startup.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAY,MAAM,KAAK,CAAA;AAI9C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EACpB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EACvC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,GAAG,MAAM,GACpC,CAAC,CA2BH"}

package/dist/server/env-validation/validate-at-startup.js

@@ -0,0 +1,61 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+// ─── validateEnvAtStartup ────────────────────────────────────────────
+/**
+ * validateEnvAtStartup — validates env vars before accepting requests.
+ *
+ * On failure: prints a formatted error message and calls process.exit(1).
+ * On success: returns the typed, validated config object.
+ *
+ * Error format:
+ * ```
+ * [vono] Missing/invalid env vars:
+ *   ❌ DATABASE_URL: Invalid url
+ *   ❌ JWT_SECRET: String must contain at least 32 character(s)
+ * ```
+ *
+ * @param schema — Zod schema to validate against
+ * @param env    — raw environment variables map
+ * @param refine — optional cross-field validation function
+ */
+export function validateEnvAtStartup(schema, env, refine) {
+    const result = schema.safeParse(env);
+    if (!result.success) {
+        const errors = formatZodErrors(result.error);
+        const message = `[vono] Missing/invalid env vars:\n${errors}`;
+        process.stderr.write(message + '\n');
+        process.exit(1);
+    }
+    // Cross-field validation
+    if (refine) {
+        const refineResult = refine(result.data);
+        if (refineResult !== true) {
+            const message = typeof refineResult === 'string'
+                ? `[vono] Env validation failed:\n  ❌ ${refineResult}`
+                : `[vono] Env validation failed: refine() returned false`;
+            process.stderr.write(message + '\n');
+            process.exit(1);
+        }
+    }
+    return result.data;
+}
+// ─── Helpers ─────────────────────────────────────────────────────────
+/**
+ * Format Zod errors into the standard Vono error format.
+ */
+function formatZodErrors(error) {
+    const lines = [];
+    for (const issue of error.issues) {
+        const key = issue.path.join('.') || '_root';
+        lines.push(`  ❌ ${key}: ${issue.message}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=validate-at-startup.js.map

package/dist/server/env-validation/validate-at-startup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-at-startup.js","sourceRoot":"","sources":["../../../src/server/env-validation/validate-at-startup.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,wEAAwE;AAExE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAoB,EACpB,GAAuC,EACvC,MAAqC;IAErC,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;IAEpC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAC5C,MAAM,OAAO,GAAG,qCAAqC,MAAM,EAAE,CAAA;QAE7D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;QACpC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IAED,yBAAyB;IACzB,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAExC,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;YAC1B,MAAM,OAAO,GACX,OAAO,YAAY,KAAK,QAAQ;gBAC9B,CAAC,CAAC,sCAAsC,YAAY,EAAE;gBACtD,CAAC,CAAC,uDAAuD,CAAA;YAE7D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;YACpC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAA;AACpB,CAAC;AAED,wEAAwE;AAExE;;GAEG;AACH,SAAS,eAAe,CAAC,KAAe;IACtC,MAAM,KAAK,GAAa,EAAE,CAAA;IAE1B,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,OAAO,CAAA;QAC3C,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;IAC5C,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC"}

package/dist/server/i18n/composables/useI18n.d.ts

@@ -0,0 +1,39 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import { ref, computed } from 'vue';
+export interface UseI18nReturn {
+    /** Translate a key with optional interpolation params */
+    t: (key: string, params?: Record<string, string>) => string;
+    /** Reactive current locale */
+    locale: ReturnType<typeof ref<string>>;
+    /** Set the active locale */
+    setLocale: (newLocale: string) => void;
+    /** All available locale codes */
+    availableLocales: ReturnType<typeof computed<string[]>>;
+}
+/**
+ * Client-side i18n composable.
+ *
+ * Usage:
+ * ```vue
+ * <script setup>
+ * const { t, locale, setLocale } = useI18n()
+ * </script>
+ * <template>
+ *   <p>{{ t('greeting', { name: 'Alice' }) }}</p>
+ * </template>
+ * ```
+ */
+export declare function useI18n(): UseI18nReturn;
+/**
+ * Seed initial translations (called during SSR hydration).
+ */
+export declare function seedTranslations(locale: string, dict: Record<string, string>, available?: string[]): void;
+//# sourceMappingURL=useI18n.d.ts.map

package/dist/server/i18n/composables/useI18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useI18n.d.ts","sourceRoot":"","sources":["../../../../src/server/i18n/composables/useI18n.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAA;AAInC,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,CAAA;IAC3D,8BAA8B;IAC9B,MAAM,EAAE,UAAU,CAAC,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;IACtC,4BAA4B;IAC5B,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;IACtC,iCAAiC;IACjC,gBAAgB,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;CACxD;AAeD;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,IAAI,aAAa,CAsDvC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,SAAS,GAAE,MAAM,EAAO,GACvB,IAAI,CAQN"}

package/dist/server/i18n/composables/useI18n.js

@@ -0,0 +1,93 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import { ref, computed } from 'vue';
+// ─── Shared reactive state ───────────────────────────────────────────
+const currentLocale = ref(typeof window !== 'undefined'
+    ? (document.documentElement.lang || 'en')
+    : 'en');
+const translations = ref({});
+const _availableLocales = ref([]);
+// ─── useI18n ─────────────────────────────────────────────────────────
+/**
+ * Client-side i18n composable.
+ *
+ * Usage:
+ * ```vue
+ * <script setup>
+ * const { t, locale, setLocale } = useI18n()
+ * </script>
+ * <template>
+ *   <p>{{ t('greeting', { name: 'Alice' }) }}</p>
+ * </template>
+ * ```
+ */
+export function useI18n() {
+    /**
+     * Translate a key for the current locale.
+     * Falls back to the key itself if not found.
+     */
+    function t(key, params) {
+        const dict = translations.value[currentLocale.value] ?? {};
+        let value = dict[key] ?? key;
+        if (params) {
+            for (const [k, v] of Object.entries(params)) {
+                value = value.replaceAll(`{{${k}}}`, v);
+            }
+        }
+        return value;
+    }
+    /**
+     * Switch the active locale and optionally load its translations.
+     */
+    async function setLocale(newLocale) {
+        currentLocale.value = newLocale;
+        // Update <html lang="..."> for accessibility
+        if (typeof document !== 'undefined') {
+            document.documentElement.lang = newLocale;
+        }
+        // Lazy-load translations if not already cached
+        if (!translations.value[newLocale]) {
+            try {
+                const mod = await import(/* @vite-ignore */ `/locales/${newLocale}.json`);
+                translations.value = {
+                    ...translations.value,
+                    [newLocale]: mod.default ?? mod,
+                };
+                if (!_availableLocales.value.includes(newLocale)) {
+                    _availableLocales.value = [..._availableLocales.value, newLocale];
+                }
+            }
+            catch {
+                // Translation file not found — silently continue
+            }
+        }
+    }
+    const availableLocales = computed(() => _availableLocales.value);
+    return {
+        t,
+        locale: currentLocale,
+        setLocale,
+        availableLocales,
+    };
+}
+/**
+ * Seed initial translations (called during SSR hydration).
+ */
+export function seedTranslations(locale, dict, available = []) {
+    currentLocale.value = locale;
+    translations.value = { ...translations.value, [locale]: dict };
+    if (available.length) {
+        _availableLocales.value = available;
+    }
+    else if (!_availableLocales.value.includes(locale)) {
+        _availableLocales.value = [..._availableLocales.value, locale];
+    }
+}
+//# sourceMappingURL=useI18n.js.map

package/dist/server/i18n/composables/useI18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useI18n.js","sourceRoot":"","sources":["../../../../src/server/i18n/composables/useI18n.ts"],"names":[],"mappings":"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"}

package/dist/server/i18n/detect-locale.d.ts

@@ -0,0 +1,22 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import type { Context } from 'hono';
+/**
+ * detectLocale — resolves the current locale from the request.
+ *
+ * Strategies:
+ *   'prefix'  — reads the first path segment, e.g. /en/about → 'en'
+ *   'cookie'  — reads the `locale` cookie
+ *   'header'  — parses the Accept-Language header (first tag only)
+ *
+ * Falls back to `defaultLocale` when nothing is found.
+ */
+export declare function detectLocale(c: Context, strategy: 'prefix' | 'cookie' | 'header', defaultLocale: string): string;
+//# sourceMappingURL=detect-locale.d.ts.map

package/dist/server/i18n/detect-locale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-locale.d.ts","sourceRoot":"","sources":["../../../src/server/i18n/detect-locale.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,CAAC,EAAE,OAAO,EACV,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,EACxC,aAAa,EAAE,MAAM,GACpB,MAAM,CAwBR"}

package/dist/server/i18n/detect-locale.js

@@ -0,0 +1,42 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+/**
+ * detectLocale — resolves the current locale from the request.
+ *
+ * Strategies:
+ *   'prefix'  — reads the first path segment, e.g. /en/about → 'en'
+ *   'cookie'  — reads the `locale` cookie
+ *   'header'  — parses the Accept-Language header (first tag only)
+ *
+ * Falls back to `defaultLocale` when nothing is found.
+ */
+export function detectLocale(c, strategy, defaultLocale) {
+    switch (strategy) {
+        case 'prefix': {
+            const path = new URL(c.req.url).pathname;
+            const segment = path.split('/').filter(Boolean)[0];
+            return segment ?? defaultLocale;
+        }
+        case 'cookie': {
+            const cookie = c.req.header('cookie') ?? '';
+            const match = cookie.match(/(?:^|;\s*)locale=([^;]+)/);
+            return match?.[1] ?? defaultLocale;
+        }
+        case 'header': {
+            const acceptLanguage = c.req.header('accept-language') ?? '';
+            // e.g. "en-US,en;q=0.9,fr;q=0.8" → "en"
+            const first = acceptLanguage.split(',')[0]?.split(';')[0]?.split('-')[0]?.trim();
+            return first || defaultLocale;
+        }
+        default:
+            return defaultLocale;
+    }
+}
+//# sourceMappingURL=detect-locale.js.map

package/dist/server/i18n/detect-locale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-locale.js","sourceRoot":"","sources":["../../../src/server/i18n/detect-locale.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAC1B,CAAU,EACV,QAAwC,EACxC,aAAqB;IAErB,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAA;YACxC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;YAClD,OAAO,OAAO,IAAI,aAAa,CAAA;QACjC,CAAC;QAED,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAA;YAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAA;YACtD,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,aAAa,CAAA;QACpC,CAAC;QAED,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,cAAc,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAA;YAC5D,wCAAwC;YACxC,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAA;YAChF,OAAO,KAAK,IAAI,aAAa,CAAA;QAC/B,CAAC;QAED;YACE,OAAO,aAAa,CAAA;IACxB,CAAC;AACH,CAAC"}

package/dist/server/i18n/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 { detectLocale } from './detect-locale.js';
+export { loadTranslations, t, getLocale, setLocale } from './translate.js';
+export { useI18n, seedTranslations } from './composables/useI18n.js';
+export type { UseI18nReturn } from './composables/useI18n.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/i18n/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/i18n/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,gBAAgB,EAAE,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1E,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AACpE,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA"}

package/dist/server/i18n/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 { detectLocale } from './detect-locale.js';
+export { loadTranslations, t, getLocale, setLocale } from './translate.js';
+export { useI18n, seedTranslations } from './composables/useI18n.js';
+//# sourceMappingURL=index.js.map

package/dist/server/i18n/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/i18n/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,gBAAgB,EAAE,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1E,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA"}

package/dist/server/i18n/translate.d.ts

@@ -0,0 +1,38 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import type { Context } from 'hono';
+/**
+ * Lazy-loads `src/locales/<locale>.json` from disk.
+ * Results are cached in memory after the first load.
+ *
+ * @param locale     — locale code, e.g. 'en', 'fr'
+ * @param localesDir — absolute path to the locales directory
+ */
+export declare function loadTranslations(locale: string, localesDir: string): Record<string, string>;
+/**
+ * Translate a key for the given locale.
+ * Supports `{{param}}` interpolation.
+ *
+ * @example
+ *   t('en', 'greeting', { name: 'Alice' })
+ *   // "Hello, Alice!" (if en.json has { "greeting": "Hello, {{name}}!" })
+ */
+export declare function t(locale: string, key: string, params?: Record<string, string>): string;
+/**
+ * Gets the current locale stored on the Hono context.
+ * Set by `detectLocale` + `c.set(LOCALE_KEY, locale)` in middleware.
+ */
+export declare function getLocale(c: Context): string;
+/**
+ * Sets the current locale on the Hono context.
+ * Call this in your i18n middleware after detecting the locale.
+ */
+export declare function setLocale(c: Context, locale: string): void;
+//# sourceMappingURL=translate.d.ts.map

package/dist/server/i18n/translate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translate.d.ts","sourceRoot":"","sources":["../../../src/server/i18n/translate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAanC;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAyBxB;AAID;;;;;;;GAOG;AACH,wBAAgB,CAAC,CACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,MAAM,CAWR;AAID;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAE5C;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAE1D"}

package/dist/server/i18n/translate.js

@@ -0,0 +1,83 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { Logger } from '../../shared/utils/logger.js';
+// ─── In-memory translation cache ────────────────────────────────────
+const translationCache = new Map();
+// ─── Locale context key ──────────────────────────────────────────────
+const LOCALE_KEY = '__vono_locale__';
+// ─── loadTranslations ────────────────────────────────────────────────
+/**
+ * Lazy-loads `src/locales/<locale>.json` from disk.
+ * Results are cached in memory after the first load.
+ *
+ * @param locale     — locale code, e.g. 'en', 'fr'
+ * @param localesDir — absolute path to the locales directory
+ */
+export function loadTranslations(locale, localesDir) {
+    if (translationCache.has(locale)) {
+        return translationCache.get(locale);
+    }
+    const filePath = join(localesDir, `${locale}.json`);
+    if (!existsSync(filePath)) {
+        Logger.warn(`[i18n] Translation file not found: ${filePath}`);
+        translationCache.set(locale, {});
+        return {};
+    }
+    try {
+        const raw = readFileSync(filePath, 'utf8');
+        const translations = JSON.parse(raw);
+        translationCache.set(locale, translations);
+        return translations;
+    }
+    catch (err) {
+        Logger.error(`[i18n] Failed to parse translation file: ${filePath}`, {
+            error: String(err),
+        });
+        translationCache.set(locale, {});
+        return {};
+    }
+}
+// ─── t ───────────────────────────────────────────────────────────────
+/**
+ * Translate a key for the given locale.
+ * Supports `{{param}}` interpolation.
+ *
+ * @example
+ *   t('en', 'greeting', { name: 'Alice' })
+ *   // "Hello, Alice!" (if en.json has { "greeting": "Hello, {{name}}!" })
+ */
+export function t(locale, key, params) {
+    const translations = translationCache.get(locale) ?? {};
+    let value = translations[key] ?? key;
+    if (params) {
+        for (const [k, v] of Object.entries(params)) {
+            value = value.replaceAll(`{{${k}}}`, v);
+        }
+    }
+    return value;
+}
+// ─── getLocale ───────────────────────────────────────────────────────
+/**
+ * Gets the current locale stored on the Hono context.
+ * Set by `detectLocale` + `c.set(LOCALE_KEY, locale)` in middleware.
+ */
+export function getLocale(c) {
+    return c.get(LOCALE_KEY) ?? 'en';
+}
+/**
+ * Sets the current locale on the Hono context.
+ * Call this in your i18n middleware after detecting the locale.
+ */
+export function setLocale(c, locale) {
+    c.set(LOCALE_KEY, locale);
+}
+//# sourceMappingURL=translate.js.map

package/dist/server/i18n/translate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translate.js","sourceRoot":"","sources":["../../../src/server/i18n/translate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAA;AAErD,uEAAuE;AAEvE,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAkC,CAAA;AAElE,wEAAwE;AAExE,MAAM,UAAU,GAAG,iBAAiB,CAAA;AAEpC,wEAAwE;AAExE;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAc,EACd,UAAkB;IAElB,IAAI,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACjC,OAAO,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAE,CAAA;IACtC,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,GAAG,MAAM,OAAO,CAAC,CAAA;IAEnD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,MAAM,CAAC,IAAI,CAAC,sCAAsC,QAAQ,EAAE,CAAC,CAAA;QAC7D,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;QAChC,OAAO,EAAE,CAAA;IACX,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QAC1C,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA2B,CAAA;QAC9D,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;QAC1C,OAAO,YAAY,CAAA;IACrB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,4CAA4C,QAAQ,EAAE,EAAE;YACnE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC;SACnB,CAAC,CAAA;QACF,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;QAChC,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC;AAED,wEAAwE;AAExE;;;;;;;GAOG;AACH,MAAM,UAAU,CAAC,CACf,MAAc,EACd,GAAW,EACX,MAA+B;IAE/B,MAAM,YAAY,GAAG,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAA;IACvD,IAAI,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,GAAG,CAAA;IAEpC,IAAI,MAAM,EAAE,CAAC;QACX,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5C,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QACzC,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC;AAED,wEAAwE;AAExE;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,CAAU;IAClC,OAAQ,CAAC,CAAC,GAAG,CAAC,UAAoB,CAAwB,IAAI,IAAI,CAAA;AACpE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,CAAU,EAAE,MAAc;IAClD,CAAC,CAAC,GAAG,CAAC,UAAoB,EAAE,MAAM,CAAC,CAAA;AACrC,CAAC"}