@fade_networker/vono 0.1.0

package/dist/server/openapi/spec-template.js

@@ -0,0 +1,132 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+// ─── generateOpenApiSpec ─────────────────────────────────────────────
+/**
+ * generateOpenApiSpec — returns a complete OpenAPI 3.1 spec object.
+ *
+ * Includes:
+ *   - info, servers
+ *   - tags: Health, Auth
+ *   - components.securitySchemes: bearerAuth
+ *   - components.schemas: SuccessResponse, ErrorResponse, PaginationMeta
+ *
+ * @example
+ *   // src/openapi.ts
+ *   export default generateOpenApiSpec('MyApp', '1.0.0', 'https://api.example.com')
+ */
+export function generateOpenApiSpec(appName, appVersion, serverUrl) {
+    return {
+        openapi: '3.1.0',
+        info: {
+            title: appName,
+            version: appVersion,
+            description: `${appName} REST API — powered by Vono`,
+        },
+        servers: [
+            {
+                url: serverUrl,
+                description: 'Primary server',
+            },
+        ],
+        tags: [
+            {
+                name: 'Health',
+                description: 'Health check endpoints',
+            },
+            {
+                name: 'Auth',
+                description: 'Authentication and authorization endpoints',
+            },
+        ],
+        components: {
+            securitySchemes: {
+                bearerAuth: {
+                    type: 'http',
+                    scheme: 'bearer',
+                    bearerFormat: 'JWT',
+                    description: 'JWT access token. Obtain via POST /api/v1/auth/login',
+                },
+            },
+            schemas: {
+                SuccessResponse: {
+                    type: 'object',
+                    required: ['success', 'message'],
+                    properties: {
+                        success: {
+                            type: 'boolean',
+                            example: true,
+                        },
+                        message: {
+                            type: 'string',
+                            example: 'Operation successful',
+                        },
+                        data: {
+                            description: 'Response payload — shape varies by endpoint',
+                        },
+                    },
+                },
+                ErrorResponse: {
+                    type: 'object',
+                    required: ['success', 'message'],
+                    properties: {
+                        success: {
+                            type: 'boolean',
+                            example: false,
+                        },
+                        message: {
+                            type: 'string',
+                            example: 'Something went wrong',
+                        },
+                        errors: {
+                            type: 'object',
+                            additionalProperties: {
+                                type: 'string',
+                            },
+                            description: 'Field-level validation errors (422 responses)',
+                            example: { email: 'Invalid email address' },
+                        },
+                    },
+                },
+                PaginationMeta: {
+                    type: 'object',
+                    required: ['total', 'currentPage', 'totalPages', 'limit'],
+                    properties: {
+                        total: {
+                            type: 'integer',
+                            example: 100,
+                        },
+                        currentPage: {
+                            type: 'integer',
+                            example: 1,
+                        },
+                        totalPages: {
+                            type: 'integer',
+                            example: 10,
+                        },
+                        limit: {
+                            type: 'integer',
+                            example: 10,
+                        },
+                        nextPage: {
+                            type: ['integer', 'null'],
+                            example: 2,
+                        },
+                        prevPage: {
+                            type: ['integer', 'null'],
+                            example: null,
+                        },
+                    },
+                },
+            },
+        },
+        paths: {},
+    };
+}
+//# sourceMappingURL=spec-template.js.map

package/dist/server/openapi/spec-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-template.js","sourceRoot":"","sources":["../../../src/server/openapi/spec-template.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAoBH,wEAAwE;AAExE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAe,EACf,UAAkB,EAClB,SAAiB;IAEjB,OAAO;QACL,OAAO,EAAE,OAAO;QAEhB,IAAI,EAAE;YACJ,KAAK,EAAE,OAAO;YACd,OAAO,EAAE,UAAU;YACnB,WAAW,EAAE,GAAG,OAAO,6BAA6B;SACrD;QAED,OAAO,EAAE;YACP;gBACE,GAAG,EAAE,SAAS;gBACd,WAAW,EAAE,gBAAgB;aAC9B;SACF;QAED,IAAI,EAAE;YACJ;gBACE,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wBAAwB;aACtC;YACD;gBACE,IAAI,EAAE,MAAM;gBACZ,WAAW,EAAE,4CAA4C;aAC1D;SACF;QAED,UAAU,EAAE;YACV,eAAe,EAAE;gBACf,UAAU,EAAE;oBACV,IAAI,EAAE,MAAM;oBACZ,MAAM,EAAE,QAAQ;oBAChB,YAAY,EAAE,KAAK;oBACnB,WAAW,EAAE,sDAAsD;iBACpE;aACF;YAED,OAAO,EAAE;gBACP,eAAe,EAAE;oBACf,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;oBAChC,UAAU,EAAE;wBACV,OAAO,EAAE;4BACP,IAAI,EAAE,SAAS;4BACf,OAAO,EAAE,IAAI;yBACd;wBACD,OAAO,EAAE;4BACP,IAAI,EAAE,QAAQ;4BACd,OAAO,EAAE,sBAAsB;yBAChC;wBACD,IAAI,EAAE;4BACJ,WAAW,EAAE,6CAA6C;yBAC3D;qBACF;iBACF;gBAED,aAAa,EAAE;oBACb,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;oBAChC,UAAU,EAAE;wBACV,OAAO,EAAE;4BACP,IAAI,EAAE,SAAS;4BACf,OAAO,EAAE,KAAK;yBACf;wBACD,OAAO,EAAE;4BACP,IAAI,EAAE,QAAQ;4BACd,OAAO,EAAE,sBAAsB;yBAChC;wBACD,MAAM,EAAE;4BACN,IAAI,EAAE,QAAQ;4BACd,oBAAoB,EAAE;gCACpB,IAAI,EAAE,QAAQ;6BACf;4BACD,WAAW,EAAE,+CAA+C;4BAC5D,OAAO,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE;yBAC5C;qBACF;iBACF;gBAED,cAAc,EAAE;oBACd,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,OAAO,CAAC;oBACzD,UAAU,EAAE;wBACV,KAAK,EAAE;4BACL,IAAI,EAAE,SAAS;4BACf,OAAO,EAAE,GAAG;yBACb;wBACD,WAAW,EAAE;4BACX,IAAI,EAAE,SAAS;4BACf,OAAO,EAAE,CAAC;yBACX;wBACD,UAAU,EAAE;4BACV,IAAI,EAAE,SAAS;4BACf,OAAO,EAAE,EAAE;yBACZ;wBACD,KAAK,EAAE;4BACL,IAAI,EAAE,SAAS;4BACf,OAAO,EAAE,EAAE;yBACZ;wBACD,QAAQ,EAAE;4BACR,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC;4BACzB,OAAO,EAAE,CAAC;yBACX;wBACD,QAAQ,EAAE;4BACR,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC;4BACzB,OAAO,EAAE,IAAI;yBACd;qBACF;iBACF;aACF;SACF;QAED,KAAK,EAAE,EAAE;KACV,CAAA;AACH,CAAC"}

package/dist/server/renderer.d.ts

@@ -0,0 +1,62 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import type { RouteRule, RouteRules } from './route-rules.js';
+export interface RenderResult {
+    html: string;
+    head: string;
+    bodyAttrs: string;
+    htmlAttrs: string;
+    piniaState: string;
+    rule: RouteRule;
+}
+/** Static 500 fallback — served when both SSR and error page rendering fail */
+declare const STATIC_500 = "<!DOCTYPE html>\n<html lang=\"en\">\n<head><meta charset=\"UTF-8\"/><title>500 \u2014 Server Error</title></head>\n<body><h1>500 \u2014 Internal Server Error</h1><p>Something went wrong. Please try again later.</p></body>\n</html>";
+/**
+ * Render a URL using SSR or return a bare SPA shell.
+ *
+ * This function is called by the Hono server for every page request.
+ * It delegates to the project's createApp factory (src/main.ts).
+ *
+ * @param url - The request URL path
+ * @param routeRules - The project's route rules config
+ * @param createApp - The project's createApp factory
+ * @param templateHtml - The index.html template string
+ * @param fallbackToSpa - Whether to fall back to SPA on SSR error
+ */
+export declare function render(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;
+}, fallbackToSpa?: boolean): Promise<RenderResult>;
+/**
+ * Build the final HTML string from the template and render result.
+ * Injects SSR content, head tags, Pinia state, and cache headers.
+ */
+export declare function buildHtml(template: string, result: RenderResult): string;
+/**
+ * Serialize Pinia state into a script tag with XSS escaping.
+ * Escapes < and > to prevent </script> injection attacks.
+ *
+ * Property 11: Pinia state SSR round-trip
+ */
+export declare function injectPiniaState(piniaState: string): string;
+export { STATIC_500 };
+//# sourceMappingURL=renderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../src/server/renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAI7D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,SAAS,CAAA;CAChB;AAED,+EAA+E;AAC/E,QAAA,MAAM,UAAU,2OAIR,CAAA;AAER;;;;;;;;;;;GAWG;AACH,wBAAsB,MAAM,CAC1B,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,EACD,aAAa,UAAQ,GACpB,OAAO,CAAC,YAAY,CAAC,CA4CvB;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAsBxE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAK3D;AAcD,OAAO,EAAE,UAAU,EAAE,CAAA"}

package/dist/server/renderer.js

@@ -0,0 +1,115 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 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 { Logger } from '../shared/utils/logger.js';
+/** Static 500 fallback — served when both SSR and error page rendering fail */
+const STATIC_500 = `<!DOCTYPE html>
+<html lang="en">
+<head><meta charset="UTF-8"/><title>500 — Server Error</title></head>
+<body><h1>500 — Internal Server Error</h1><p>Something went wrong. Please try again later.</p></body>
+</html>`;
+/**
+ * Render a URL using SSR or return a bare SPA shell.
+ *
+ * This function is called by the Hono server for every page request.
+ * It delegates to the project's createApp factory (src/main.ts).
+ *
+ * @param url - The request URL path
+ * @param routeRules - The project's route rules config
+ * @param createApp - The project's createApp factory
+ * @param templateHtml - The index.html template string
+ * @param fallbackToSpa - Whether to fall back to SPA on SSR error
+ */
+export async function render(url, routeRules, createApp, fallbackToSpa = false) {
+    const rule = resolveRouteRule(url, routeRules);
+    // ── SPA mode: return empty shell ──────────────────────────────────
+    if (rule.mode === 'spa') {
+        return buildSpaResult(rule);
+    }
+    // ── SSR mode: full server render ──────────────────────────────────
+    try {
+        const { renderToString } = 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 ctx = {};
+        const html = await renderToString(app, ctx);
+        const headPayload = await renderSSRHead(head);
+        // Serialize Pinia state — XSS-safe escaping handled in injectPiniaState
+        const piniaState = JSON.stringify(pinia.state.value);
+        return {
+            html,
+            head: headPayload.headTags,
+            bodyAttrs: headPayload.bodyAttrs ?? '',
+            htmlAttrs: headPayload.htmlAttrs ?? '',
+            piniaState,
+            rule,
+        };
+    }
+    catch (err) {
+        Logger.error('[vono] SSR render error', { url, error: String(err) });
+        if (fallbackToSpa) {
+            Logger.warn('[vono] Falling back to SPA shell due to SSR error', { url });
+            return buildSpaResult(rule);
+        }
+        throw err;
+    }
+}
+/**
+ * Build the final HTML string from the template and render result.
+ * Injects SSR content, head tags, Pinia state, and cache headers.
+ */
+export function buildHtml(template, result) {
+    let html = template
+        .replace('<!--ssr-outlet-->', result.html)
+        .replace('<!--head-outlet-->', result.head);
+    // Inject Pinia state for client hydration (SSR only, non-empty state)
+    if (result.rule.mode === 'ssr' && result.piniaState && result.piniaState !== '{}') {
+        const stateScript = injectPiniaState(result.piniaState);
+        html = html.replace('<!--state-outlet-->', stateScript);
+    }
+    else {
+        html = html.replace('<!--state-outlet-->', '');
+    }
+    // Apply htmlAttrs and bodyAttrs
+    if (result.htmlAttrs) {
+        html = html.replace('<html lang="en">', `<html lang="en" ${result.htmlAttrs}>`);
+    }
+    if (result.bodyAttrs) {
+        html = html.replace('<body>', `<body ${result.bodyAttrs}>`);
+    }
+    return html;
+}
+/**
+ * Serialize Pinia state into a script tag with XSS escaping.
+ * Escapes < and > to prevent </script> injection attacks.
+ *
+ * Property 11: Pinia state SSR round-trip
+ */
+export function injectPiniaState(piniaState) {
+    const escaped = piniaState
+        .replace(/</g, '\\u003c')
+        .replace(/>/g, '\\u003e');
+    return `<script id="__pinia" type="application/json">${escaped}</script>`;
+}
+/** Build a bare SPA shell result */
+function buildSpaResult(rule) {
+    return {
+        html: '',
+        head: '<title>App</title>',
+        bodyAttrs: '',
+        htmlAttrs: '',
+        piniaState: '',
+        rule,
+    };
+}
+export { STATIC_500 };
+//# sourceMappingURL=renderer.js.map

package/dist/server/renderer.js.map

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

package/dist/server/resolvers/cache-driver.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
+ * ──────────────────────────────────────────────────────────────────
+ */
+export type CacheDriver = 'kv' | 'upstash';
+/**
+ * resolveCacheDriver — returns the appropriate cache driver.
+ *
+ * | Runtime                    | Driver  |
+ * |----------------------------|---------|
+ * | cloudflare-workers / pages | kv      |
+ * | everything else            | upstash |
+ *
+ * @param runtime — detected runtime string
+ */
+export declare function resolveCacheDriver(runtime: string): CacheDriver;
+//# sourceMappingURL=cache-driver.d.ts.map

package/dist/server/resolvers/cache-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-driver.d.ts","sourceRoot":"","sources":["../../../src/server/resolvers/cache-driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,CAAA;AAE1C;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAS/D"}

package/dist/server/resolvers/cache-driver.js

@@ -0,0 +1,29 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+/**
+ * resolveCacheDriver — returns the appropriate cache driver.
+ *
+ * | Runtime                    | Driver  |
+ * |----------------------------|---------|
+ * | cloudflare-workers / pages | kv      |
+ * | everything else            | upstash |
+ *
+ * @param runtime — detected runtime string
+ */
+export function resolveCacheDriver(runtime) {
+    switch (runtime) {
+        case 'cloudflare-workers':
+        case 'cloudflare-pages':
+            return 'kv';
+        default:
+            return 'upstash';
+    }
+}
+//# sourceMappingURL=cache-driver.js.map

package/dist/server/resolvers/cache-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-driver.js","sourceRoot":"","sources":["../../../src/server/resolvers/cache-driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,oBAAoB,CAAC;QAC1B,KAAK,kBAAkB;YACrB,OAAO,IAAI,CAAA;QAEb;YACE,OAAO,SAAS,CAAA;IACpB,CAAC;AACH,CAAC"}

package/dist/server/resolvers/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+export { resolveQueueDriver } from './queue-driver.js';
+export { resolveStorageDriver } from './storage-driver.js';
+export { resolveCacheDriver } from './cache-driver.js';
+export { validateDriverCompatibility } from './validate-compatibility.js';
+export type { QueueDriver } from './queue-driver.js';
+export type { StorageDriver } from './storage-driver.js';
+export type { CacheDriver } from './cache-driver.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/resolvers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAA;AACzE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/server/resolvers/index.js

@@ -0,0 +1,14 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+export { resolveQueueDriver } from './queue-driver.js';
+export { resolveStorageDriver } from './storage-driver.js';
+export { resolveCacheDriver } from './cache-driver.js';
+export { validateDriverCompatibility } from './validate-compatibility.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/resolvers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAA"}

package/dist/server/resolvers/queue-driver.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
+ * ──────────────────────────────────────────────────────────────────
+ */
+export type QueueDriver = 'bullmq' | 'cloudflare-queues' | 'sqs' | 'upstash';
+/**
+ * resolveQueueDriver — returns the appropriate queue driver for the runtime.
+ *
+ * | Runtime                          | Driver             |
+ * |----------------------------------|--------------------|
+ * | bun / node                       | bullmq             |
+ * | cloudflare-workers / pages       | cloudflare-queues  |
+ * | aws-lambda                       | sqs                |
+ * | vercel / netlify / deno / fastly | upstash            |
+ *
+ * @param runtime  — detected runtime string
+ * @param explicit — optional override from vono.config.ts
+ */
+export declare function resolveQueueDriver(runtime: string, explicit?: string): QueueDriver;
+//# sourceMappingURL=queue-driver.d.ts.map

package/dist/server/resolvers/queue-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-driver.d.ts","sourceRoot":"","sources":["../../../src/server/resolvers/queue-driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,mBAAmB,GAAG,KAAK,GAAG,SAAS,CAAA;AAE5E;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,CAwBlF"}

package/dist/server/resolvers/queue-driver.js

@@ -0,0 +1,44 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+/**
+ * resolveQueueDriver — returns the appropriate queue driver for the runtime.
+ *
+ * | Runtime                          | Driver             |
+ * |----------------------------------|--------------------|
+ * | bun / node                       | bullmq             |
+ * | cloudflare-workers / pages       | cloudflare-queues  |
+ * | aws-lambda                       | sqs                |
+ * | vercel / netlify / deno / fastly | upstash            |
+ *
+ * @param runtime  — detected runtime string
+ * @param explicit — optional override from vono.config.ts
+ */
+export function resolveQueueDriver(runtime, explicit) {
+    if (explicit)
+        return explicit;
+    switch (runtime) {
+        case 'bun':
+        case 'node':
+            return 'bullmq';
+        case 'cloudflare-workers':
+        case 'cloudflare-pages':
+            return 'cloudflare-queues';
+        case 'aws-lambda':
+            return 'sqs';
+        case 'vercel':
+        case 'netlify':
+        case 'deno':
+        case 'fastly':
+            return 'upstash';
+        default:
+            return 'bullmq';
+    }
+}
+//# sourceMappingURL=queue-driver.js.map

package/dist/server/resolvers/queue-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-driver.js","sourceRoot":"","sources":["../../../src/server/resolvers/queue-driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe,EAAE,QAAiB;IACnE,IAAI,QAAQ;QAAE,OAAO,QAAuB,CAAA;IAE5C,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,KAAK,CAAC;QACX,KAAK,MAAM;YACT,OAAO,QAAQ,CAAA;QAEjB,KAAK,oBAAoB,CAAC;QAC1B,KAAK,kBAAkB;YACrB,OAAO,mBAAmB,CAAA;QAE5B,KAAK,YAAY;YACf,OAAO,KAAK,CAAA;QAEd,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS,CAAC;QACf,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ;YACX,OAAO,SAAS,CAAA;QAElB;YACE,OAAO,QAAQ,CAAA;IACnB,CAAC;AACH,CAAC"}

package/dist/server/resolvers/storage-driver.d.ts

@@ -0,0 +1,24 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+export type StorageDriver = 'r2' | 's3' | 'local';
+/**
+ * resolveStorageDriver — returns the appropriate storage driver.
+ *
+ * | Runtime                    | Condition              | Driver |
+ * |----------------------------|------------------------|--------|
+ * | cloudflare-workers / pages | —                      | r2     |
+ * | bun / node                 | AWS creds present      | s3     |
+ * | bun / node                 | no AWS creds           | local  |
+ *
+ * @param runtime — detected runtime string
+ * @param env     — environment variables map
+ */
+export declare function resolveStorageDriver(runtime: string, env: Record<string, string>): StorageDriver;
+//# sourceMappingURL=storage-driver.d.ts.map

package/dist/server/resolvers/storage-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-driver.d.ts","sourceRoot":"","sources":["../../../src/server/resolvers/storage-driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,IAAI,GAAG,OAAO,CAAA;AAEjD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1B,aAAa,CAkBf"}

package/dist/server/resolvers/storage-driver.js

@@ -0,0 +1,38 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+/**
+ * resolveStorageDriver — returns the appropriate storage driver.
+ *
+ * | Runtime                    | Condition              | Driver |
+ * |----------------------------|------------------------|--------|
+ * | cloudflare-workers / pages | —                      | r2     |
+ * | bun / node                 | AWS creds present      | s3     |
+ * | bun / node                 | no AWS creds           | local  |
+ *
+ * @param runtime — detected runtime string
+ * @param env     — environment variables map
+ */
+export function resolveStorageDriver(runtime, env) {
+    switch (runtime) {
+        case 'cloudflare-workers':
+        case 'cloudflare-pages':
+            return 'r2';
+        case 'bun':
+        case 'node': {
+            const hasAwsCreds = Boolean(env['S3_BUCKET']) &&
+                Boolean(env['S3_ACCESS_KEY']) &&
+                Boolean(env['S3_SECRET_KEY']);
+            return hasAwsCreds ? 's3' : 'local';
+        }
+        default:
+            return 'local';
+    }
+}
+//# sourceMappingURL=storage-driver.js.map

package/dist/server/resolvers/storage-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-driver.js","sourceRoot":"","sources":["../../../src/server/resolvers/storage-driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAe,EACf,GAA2B;IAE3B,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,oBAAoB,CAAC;QAC1B,KAAK,kBAAkB;YACrB,OAAO,IAAI,CAAA;QAEb,KAAK,KAAK,CAAC;QACX,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,WAAW,GACf,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;gBACzB,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;gBAC7B,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAA;YAC/B,OAAO,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAA;QACrC,CAAC;QAED;YACE,OAAO,OAAO,CAAA;IAClB,CAAC;AACH,CAAC"}

package/dist/server/resolvers/validate-compatibility.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 { QueueDriver } from './queue-driver.js';
+import type { StorageDriver } from './storage-driver.js';
+import type { CacheDriver } from './cache-driver.js';
+/**
+ * validateDriverCompatibility — throws a descriptive error for
+ * incompatible driver/runtime combinations.
+ *
+ * Call this at startup before accepting requests.
+ *
+ * @throws Error with a human-readable message listing all conflicts
+ */
+export declare function validateDriverCompatibility(runtime: string, queueDriver: QueueDriver, storageDriver: StorageDriver, cacheDriver: CacheDriver): void;
+//# sourceMappingURL=validate-compatibility.d.ts.map

package/dist/server/resolvers/validate-compatibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-compatibility.d.ts","sourceRoot":"","sources":["../../../src/server/resolvers/validate-compatibility.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAgEpD;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,WAAW,EACxB,aAAa,EAAE,aAAa,EAC5B,WAAW,EAAE,WAAW,GACvB,IAAI,CA2BN"}