@fade_networker/vono 0.1.0

package/dist/server/storage/use-storage.d.ts

@@ -0,0 +1,54 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import type { Context } from 'hono';
+import type { AppVariables } from '../../types/index.js';
+import type { StorageDriver, StorageConfig, UploadOptions, UploadResult } from './types.js';
+/**
+ * StorageClient — wraps a StorageDriver with validation (size + MIME type).
+ */
+declare class StorageClient {
+    private readonly driver;
+    private readonly config;
+    constructor(driver: StorageDriver, config: StorageConfig);
+    /**
+     * Upload a file with size and MIME type validation.
+     *
+     * @throws HTTPException 413 if file exceeds maxSize
+     * @throws HTTPException 415 if MIME type is not allowed
+     */
+    upload(file: File, options?: UploadOptions): Promise<UploadResult>;
+    /** Delete a file by key */
+    delete(key: string): Promise<void>;
+    /** Get the public URL for a stored file */
+    url(key: string): string;
+}
+/**
+ * `useStorage(c)` — returns a storage client for the configured driver.
+ *
+ * Driver selection is based on environment variables:
+ * - `R2_BUCKET_NAME` → R2
+ * - `S3_BUCKET` → S3
+ * - `CLOUDINARY_URL` → Cloudinary
+ * - `BUNNY_STORAGE_ZONE` → Bunny.net
+ * - Fallback → Local
+ *
+ * @example
+ * ```ts
+ * const storage = useStorage(c)
+ * const file = await c.req.parseBody()['file'] as File
+ * const result = await storage.upload(file, { key: `avatars/${userId}.jpg` })
+ * return c.json({ url: result.url })
+ * ```
+ */
+export declare function useStorage(c: Context<{
+    Variables: AppVariables;
+}>, overrideConfig?: Partial<StorageConfig>): Promise<StorageClient>;
+export {};
+//# sourceMappingURL=use-storage.d.ts.map

package/dist/server/storage/use-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-storage.d.ts","sourceRoot":"","sources":["../../../src/server/storage/use-storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAExD,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAS3F;;GAEG;AACH,cAAM,aAAa;IAEf,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,aAAa;IAGxC;;;;;OAKG;IACG,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IA+BxE,2BAA2B;IACrB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,2CAA2C;IAC3C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAGzB;AAID;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,UAAU,CAC9B,CAAC,EAAE,OAAO,CAAC;IAAE,SAAS,EAAE,YAAY,CAAA;CAAE,CAAC,EACvC,cAAc,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GACtC,OAAO,CAAC,aAAa,CAAC,CAmExB"}

package/dist/server/storage/use-storage.js

@@ -0,0 +1,150 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import { HTTPException } from 'hono/http-exception';
+import { Logger } from '../../shared/utils/logger.js';
+import { LocalDriver } from './drivers/local.js';
+// ─── Default limits ───────────────────────────────────────────────────────────
+const DEFAULT_MAX_SIZE = 10 * 1024 * 1024; // 10 MB
+// ─── StorageClient ────────────────────────────────────────────────────────────
+/**
+ * StorageClient — wraps a StorageDriver with validation (size + MIME type).
+ */
+class StorageClient {
+    driver;
+    config;
+    constructor(driver, config) {
+        this.driver = driver;
+        this.config = config;
+    }
+    /**
+     * Upload a file with size and MIME type validation.
+     *
+     * @throws HTTPException 413 if file exceeds maxSize
+     * @throws HTTPException 415 if MIME type is not allowed
+     */
+    async upload(file, options) {
+        const maxSize = this.config.maxSize ?? DEFAULT_MAX_SIZE;
+        if (file.size > maxSize) {
+            Logger.warn('[storage] File too large', { size: file.size, maxSize });
+            throw new HTTPException(413, {
+                message: `File too large. Maximum allowed size is ${Math.round(maxSize / 1024 / 1024)}MB`,
+            });
+        }
+        const allowedMimeTypes = this.config.allowedMimeTypes;
+        if (allowedMimeTypes && allowedMimeTypes.length > 0) {
+            const mimeType = file.type || 'application/octet-stream';
+            const allowed = allowedMimeTypes.some((pattern) => {
+                if (pattern.endsWith('/*')) {
+                    return mimeType.startsWith(pattern.slice(0, -1));
+                }
+                return mimeType === pattern;
+            });
+            if (!allowed) {
+                Logger.warn('[storage] MIME type not allowed', { mimeType, allowedMimeTypes });
+                throw new HTTPException(415, {
+                    message: `File type "${mimeType}" is not allowed`,
+                });
+            }
+        }
+        return this.driver.upload(file, options);
+    }
+    /** Delete a file by key */
+    async delete(key) {
+        return this.driver.delete(key);
+    }
+    /** Get the public URL for a stored file */
+    url(key) {
+        return this.driver.url(key);
+    }
+}
+// ─── useStorage ───────────────────────────────────────────────────────────────
+/**
+ * `useStorage(c)` — returns a storage client for the configured driver.
+ *
+ * Driver selection is based on environment variables:
+ * - `R2_BUCKET_NAME` → R2
+ * - `S3_BUCKET` → S3
+ * - `CLOUDINARY_URL` → Cloudinary
+ * - `BUNNY_STORAGE_ZONE` → Bunny.net
+ * - Fallback → Local
+ *
+ * @example
+ * ```ts
+ * const storage = useStorage(c)
+ * const file = await c.req.parseBody()['file'] as File
+ * const result = await storage.upload(file, { key: `avatars/${userId}.jpg` })
+ * return c.json({ url: result.url })
+ * ```
+ */
+export async function useStorage(c, overrideConfig) {
+    const config = c.var.config;
+    const storageConfig = {
+        driver: 'local',
+        maxSize: DEFAULT_MAX_SIZE,
+        ...overrideConfig,
+    };
+    let driver;
+    // R2
+    if (config['R2_BUCKET_NAME'] && config['CLOUDFLARE_ACCOUNT_ID']) {
+        storageConfig.driver = 'r2';
+        const { R2Driver } = await import('./drivers/r2.js');
+        driver = new R2Driver({
+            accountId: config['CLOUDFLARE_ACCOUNT_ID'],
+            accessKeyId: config['R2_ACCESS_KEY_ID'] ?? '',
+            secretAccessKey: config['R2_SECRET_ACCESS_KEY'] ?? '',
+            bucketName: config['R2_BUCKET_NAME'],
+            baseUrl: overrideConfig?.baseUrl ?? config['R2_PUBLIC_URL'] ?? '',
+        });
+    }
+    // S3
+    else if (config['S3_BUCKET']) {
+        storageConfig.driver = 's3';
+        const { S3Driver } = await import('./drivers/s3.js');
+        driver = new S3Driver({
+            bucket: config['S3_BUCKET'],
+            region: config['S3_REGION'] ?? 'us-east-1',
+            accessKeyId: config['S3_ACCESS_KEY'] ?? '',
+            secretAccessKey: config['S3_SECRET_KEY'] ?? '',
+            baseUrl: overrideConfig?.baseUrl,
+        });
+    }
+    // Cloudinary
+    else if (config['CLOUDINARY_URL']) {
+        storageConfig.driver = 'cloudinary';
+        // Parse CLOUDINARY_URL: cloudinary://api_key:api_secret@cloud_name
+        const url = new URL(config['CLOUDINARY_URL']);
+        const { CloudinaryDriver } = await import('./drivers/cloudinary.js');
+        driver = new CloudinaryDriver({
+            cloudName: url.hostname,
+            apiKey: url.username,
+            apiSecret: url.password,
+        });
+    }
+    // Bunny.net
+    else if (config['BUNNY_STORAGE_ZONE']) {
+        storageConfig.driver = 'bunny';
+        const { BunnyDriver } = await import('./drivers/bunny.js');
+        driver = new BunnyDriver({
+            storageZone: config['BUNNY_STORAGE_ZONE'],
+            accessKey: config['BUNNY_ACCESS_KEY'] ?? '',
+            cdnUrl: overrideConfig?.baseUrl ?? config['BUNNY_CDN_URL'] ?? '',
+        });
+    }
+    // Local fallback
+    else {
+        storageConfig.driver = 'local';
+        driver = new LocalDriver({
+            uploadDir: overrideConfig?.uploadDir,
+            baseUrl: overrideConfig?.baseUrl,
+        });
+    }
+    return new StorageClient(driver, storageConfig);
+}
+//# sourceMappingURL=use-storage.js.map

package/dist/server/storage/use-storage.js.map

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

package/dist/server/stream-renderer.d.ts

@@ -0,0 +1,49 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import type { Context } from 'hono';
+import type { RouteRules } from './route-rules.js';
+export interface StreamRenderResult {
+    vueStream: ReadableStream;
+    headTags: string;
+    bodyAttrs: string;
+    htmlAttrs: string;
+    piniaState: string;
+}
+/**
+ * Render a URL as a streaming SSR response.
+ *
+ * Sends the <head> section immediately, then streams Vue-rendered HTML
+ * in chunks, minimizing Time to First Byte (TTFB).
+ *
+ * Falls back to null for SPA routes (caller should use non-streaming path).
+ */
+export declare function renderStream(url: string, routeRules: RouteRules, createApp: (opts: {
+    isServer: boolean;
+    url: string;
+}) => {
+    app: unknown;
+    router: {
+        push: (url: string) => Promise<void>;
+        isReady: () => Promise<void>;
+    };
+    pinia: {
+        state: {
+            value: Record<string, unknown>;
+        };
+    };
+    head: unknown;
+}): Promise<StreamRenderResult | null>;
+/**
+ * Stream an SSR response using Hono's stream() helper.
+ *
+ * Writes the <head> immediately, then pipes Vue chunks, then closes.
+ */
+export declare function streamResponse(c: Context, url: string, routeRules: RouteRules, templateHtml: string, createApp: Parameters<typeof renderStream>[2]): Promise<Response>;
+//# sourceMappingURL=stream-renderer.d.ts.map

package/dist/server/stream-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-renderer.d.ts","sourceRoot":"","sources":["../../src/server/stream-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AACnC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAKlD,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,cAAc,CAAA;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,CAAC,IAAI,EAAE;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,KAAK;IACvD,GAAG,EAAE,OAAO,CAAA;IACZ,MAAM,EAAE;QAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAA;IAC9E,KAAK,EAAE;QAAE,KAAK,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;SAAE,CAAA;KAAE,CAAA;IACpD,IAAI,EAAE,OAAO,CAAA;CACd,GACA,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAwBpC;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,CAAC,EAAE,OAAO,EACV,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,UAAU,EACtB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC,GAC5C,OAAO,CAAC,QAAQ,CAAC,CAmDnB"}

package/dist/server/stream-renderer.js

@@ -0,0 +1,89 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import { resolveRouteRule } from './route-rules.js';
+import { buildHtml, injectPiniaState, STATIC_500 } from './renderer.js';
+import { Logger } from '../shared/utils/logger.js';
+/**
+ * Render a URL as a streaming SSR response.
+ *
+ * Sends the <head> section immediately, then streams Vue-rendered HTML
+ * in chunks, minimizing Time to First Byte (TTFB).
+ *
+ * Falls back to null for SPA routes (caller should use non-streaming path).
+ */
+export async function renderStream(url, routeRules, createApp) {
+    const rule = resolveRouteRule(url, routeRules);
+    // SPA routes don't stream
+    if (rule.mode === 'spa')
+        return null;
+    const { renderToWebStream } = await import('vue/server-renderer');
+    const { renderSSRHead } = await import('@unhead/ssr');
+    const { app, router, pinia, head } = createApp({ isServer: true, url });
+    await router.push(url);
+    await router.isReady();
+    const vueStream = renderToWebStream(app);
+    const headPayload = await renderSSRHead(head);
+    return {
+        vueStream,
+        headTags: headPayload.headTags,
+        bodyAttrs: headPayload.bodyAttrs ?? '',
+        htmlAttrs: headPayload.htmlAttrs ?? '',
+        piniaState: JSON.stringify(pinia.state.value),
+    };
+}
+/**
+ * Stream an SSR response using Hono's stream() helper.
+ *
+ * Writes the <head> immediately, then pipes Vue chunks, then closes.
+ */
+export async function streamResponse(c, url, routeRules, templateHtml, createApp) {
+    const { stream } = await import('hono/streaming');
+    try {
+        const result = await renderStream(url, routeRules, createApp);
+        if (!result) {
+            // SPA fallback — non-streaming
+            const rule = resolveRouteRule(url, routeRules);
+            c.header('X-Robots-Tag', 'noindex, nofollow');
+            return c.html(buildHtml(templateHtml, {
+                html: '', head: '<title>App</title>',
+                bodyAttrs: '', htmlAttrs: '', piniaState: '', rule,
+            }));
+        }
+        const [beforeApp, afterApp] = templateHtml.split('<!--ssr-outlet-->');
+        let headSection = beforeApp.replace('<!--head-outlet-->', result.headTags);
+        if (result.htmlAttrs) {
+            headSection = headSection.replace('<html lang="en">', `<html lang="en" ${result.htmlAttrs}>`);
+        }
+        if (result.bodyAttrs) {
+            headSection = headSection.replace('<body>', `<body ${result.bodyAttrs}>`);
+        }
+        const piniaScript = result.piniaState && result.piniaState !== '{}'
+            ? injectPiniaState(result.piniaState)
+            : '';
+        const closing = afterApp.replace('<!--state-outlet-->', piniaScript);
+        return stream(c, async (s) => {
+            await s.write(headSection);
+            const reader = result.vueStream.getReader();
+            const decoder = new TextDecoder();
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                await s.write(typeof value === 'string' ? value : decoder.decode(value));
+            }
+            await s.write(closing);
+        });
+    }
+    catch (err) {
+        Logger.error('[vono] Stream render error', { url, error: String(err) });
+        return c.html(STATIC_500, 500);
+    }
+}
+//# sourceMappingURL=stream-renderer.js.map

package/dist/server/stream-renderer.js.map

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

package/dist/server/templates/health.routes.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 { Hono } from 'hono';
+/**
+ * Health check routes.
+ *
+ * Mounted at /health on the inner API router.
+ * Returns a simple { status: 'ok', timestamp } payload.
+ *
+ * Usage (auto-registered via autoRegisterRoutes):
+ *   GET /api/v1/health → { status: 'ok', timestamp: '...' }
+ */
+declare const healthRoutes: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+export default healthRoutes;
+//# sourceMappingURL=health.routes.d.ts.map

package/dist/server/templates/health.routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.routes.d.ts","sourceRoot":"","sources":["../../../src/server/templates/health.routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAE3B;;;;;;;;GAQG;AACH,QAAA,MAAM,YAAY,4EAAa,CAAA;AAS/B,eAAe,YAAY,CAAA"}

package/dist/server/templates/health.routes.js

@@ -0,0 +1,28 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import { Hono } from 'hono';
+/**
+ * Health check routes.
+ *
+ * Mounted at /health on the inner API router.
+ * Returns a simple { status: 'ok', timestamp } payload.
+ *
+ * Usage (auto-registered via autoRegisterRoutes):
+ *   GET /api/v1/health → { status: 'ok', timestamp: '...' }
+ */
+const healthRoutes = new Hono();
+healthRoutes.get('/', (c) => {
+    return c.json({
+        status: 'ok',
+        timestamp: new Date().toISOString(),
+    });
+});
+export default healthRoutes;
+//# sourceMappingURL=health.routes.js.map

package/dist/server/templates/health.routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.routes.js","sourceRoot":"","sources":["../../../src/server/templates/health.routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAE3B;;;;;;;;GAQG;AACH,MAAM,YAAY,GAAG,IAAI,IAAI,EAAE,CAAA;AAE/B,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE;IAC1B,OAAO,CAAC,CAAC,IAAI,CAAC;QACZ,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,eAAe,YAAY,CAAA"}

package/dist/server/utils/storage-url.d.ts

@@ -0,0 +1,36 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+export interface StorageUrlConfig {
+    /** Storage driver — determines URL resolution strategy */
+    driver?: 'local' | 'r2' | 's3' | 'cloudinary' | 'bunny';
+    /** Base URL for CDN drivers (e.g. https://cdn.example.com) */
+    baseUrl?: string;
+}
+/**
+ * `resolveStorageUrl(path, config?)` — converts a stored file path to a full
+ * public URL based on the configured storage driver.
+ *
+ * | Driver     | Result                                  |
+ * |------------|-----------------------------------------|
+ * | local      | `/uploads/<path>`                       |
+ * | r2         | `<baseUrl>/<path>`                      |
+ * | s3         | `<baseUrl>/<path>`                      |
+ * | cloudinary | `<baseUrl>/<path>`                      |
+ * | bunny      | `<baseUrl>/<path>`                      |
+ *
+ * @example
+ * resolveStorageUrl('avatars/user-123.jpg', { driver: 'r2', baseUrl: 'https://cdn.example.com' })
+ * // → 'https://cdn.example.com/avatars/user-123.jpg'
+ *
+ * resolveStorageUrl('avatars/user-123.jpg')
+ * // → '/uploads/avatars/user-123.jpg'
+ */
+export declare function resolveStorageUrl(path: string, config?: StorageUrlConfig): string;
+//# sourceMappingURL=storage-url.d.ts.map

package/dist/server/utils/storage-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-url.d.ts","sourceRoot":"","sources":["../../../src/server/utils/storage-url.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,YAAY,GAAG,OAAO,CAAA;IACvD,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAID;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,MAAM,CA0BjF"}

package/dist/server/utils/storage-url.js

@@ -0,0 +1,53 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+// ─── resolveStorageUrl ────────────────────────────────────────────────────────
+/**
+ * `resolveStorageUrl(path, config?)` — converts a stored file path to a full
+ * public URL based on the configured storage driver.
+ *
+ * | Driver     | Result                                  |
+ * |------------|-----------------------------------------|
+ * | local      | `/uploads/<path>`                       |
+ * | r2         | `<baseUrl>/<path>`                      |
+ * | s3         | `<baseUrl>/<path>`                      |
+ * | cloudinary | `<baseUrl>/<path>`                      |
+ * | bunny      | `<baseUrl>/<path>`                      |
+ *
+ * @example
+ * resolveStorageUrl('avatars/user-123.jpg', { driver: 'r2', baseUrl: 'https://cdn.example.com' })
+ * // → 'https://cdn.example.com/avatars/user-123.jpg'
+ *
+ * resolveStorageUrl('avatars/user-123.jpg')
+ * // → '/uploads/avatars/user-123.jpg'
+ */
+export function resolveStorageUrl(path, config) {
+    const driver = config?.driver ?? 'local';
+    const baseUrl = config?.baseUrl ?? '';
+    // Normalise path — strip leading slash to avoid double slashes
+    const normalised = path.startsWith('/') ? path.slice(1) : path;
+    switch (driver) {
+        case 'local':
+            return `/uploads/${normalised}`;
+        case 'r2':
+        case 's3':
+        case 'cloudinary':
+        case 'bunny': {
+            if (!baseUrl) {
+                // Fallback to local-style path when no baseUrl is configured
+                return `/uploads/${normalised}`;
+            }
+            const base = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl;
+            return `${base}/${normalised}`;
+        }
+        default:
+            return `/uploads/${normalised}`;
+    }
+}
+//# sourceMappingURL=storage-url.js.map

package/dist/server/utils/storage-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-url.js","sourceRoot":"","sources":["../../../src/server/utils/storage-url.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH,iFAAiF;AAEjF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,MAAyB;IACvE,MAAM,MAAM,GAAG,MAAM,EAAE,MAAM,IAAI,OAAO,CAAA;IACxC,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,IAAI,EAAE,CAAA;IAErC,+DAA+D;IAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAE9D,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,OAAO;YACV,OAAO,YAAY,UAAU,EAAE,CAAA;QAEjC,KAAK,IAAI,CAAC;QACV,KAAK,IAAI,CAAC;QACV,KAAK,YAAY,CAAC;QAClB,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,6DAA6D;gBAC7D,OAAO,YAAY,UAAU,EAAE,CAAA;YACjC,CAAC;YACD,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAA;YACnE,OAAO,GAAG,IAAI,IAAI,UAAU,EAAE,CAAA;QAChC,CAAC;QAED;YACE,OAAO,YAAY,UAAU,EAAE,CAAA;IACnC,CAAC;AACH,CAAC"}

package/dist/shared/utils/autoRoutes.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 { Hono } from 'hono';
+/**
+ * Auto-discovers and mounts all routes.ts files from src/modules.
+ *
+ * Pass the result of import.meta.glob from your Vite project:
+ *
+ *   const mods = import.meta.glob('/src/modules/' + '*' + '/' + '*.routes.ts', { eager: true })
+ *   await autoRegisterRoutes(api, mods)
+ */
+export declare function autoRegisterRoutes(app: Hono, modules: Record<string, {
+    default?: Hono;
+}>): Promise<void>;
+//# sourceMappingURL=autoRoutes.d.ts.map

package/dist/shared/utils/autoRoutes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoRoutes.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/autoRoutes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAEhC;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,IAAI,EACT,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,OAAO,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC,GAC1C,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/dist/shared/utils/autoRoutes.js

@@ -0,0 +1,29 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+/**
+ * Auto-discovers and mounts all routes.ts files from src/modules.
+ *
+ * Pass the result of import.meta.glob from your Vite project:
+ *
+ *   const mods = import.meta.glob('/src/modules/' + '*' + '/' + '*.routes.ts', { eager: true })
+ *   await autoRegisterRoutes(api, mods)
+ */
+export async function autoRegisterRoutes(app, modules) {
+    for (const [path, mod] of Object.entries(modules)) {
+        const match = path.match(/\/modules\/([^/]+)\//);
+        if (!match)
+            continue;
+        const prefix = `/${match[1]}`;
+        if (!mod.default)
+            continue;
+        app.route(prefix, mod.default);
+    }
+}
+//# sourceMappingURL=autoRoutes.js.map

package/dist/shared/utils/autoRoutes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoRoutes.js","sourceRoot":"","sources":["../../../src/shared/utils/autoRoutes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,GAAS,EACT,OAA2C;IAE3C,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAClD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAA;QAChD,IAAI,CAAC,KAAK;YAAE,SAAQ;QAEpB,MAAM,MAAM,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;QAC7B,IAAI,CAAC,GAAG,CAAC,OAAO;YAAE,SAAQ;QAE1B,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;IAChC,CAAC;AACH,CAAC"}

package/dist/shared/utils/id.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
+ * ──────────────────────────────────────────────────────────────────
+ */
+/**
+ * Generate a UUID v4 string using the Web Crypto API.
+ * Works on all runtimes: Node.js, Bun, Deno, Cloudflare Workers.
+ *
+ * Property 14: returned value matches UUID v4 pattern
+ * xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx
+ */
+export declare function generateId(): string;
+/**
+ * Generate a prefixed ID in the format `<prefix>_<uuid>`.
+ * e.g. prefixedId('usr') → 'usr_550e8400-e29b-41d4-a716-446655440000'
+ *
+ * Property 15: prefixedId(prefix).split('_')[0] === prefix
+ */
+export declare function prefixedId(prefix: string): string;
+//# sourceMappingURL=id.d.ts.map

package/dist/shared/utils/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/id.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;GAMG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjD"}