@fade_networker/vono 0.1.0

package/dist/server/dto/query.dto.d.ts

@@ -0,0 +1,44 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import { z } from 'zod';
+/**
+ * QuerySchema — standard query parameter schema for list/collection endpoints.
+ *
+ * All fields are optional with sensible defaults. Query params arrive as
+ * strings from the URL, so coercion is applied where needed.
+ *
+ * Usage with zodValidator:
+ * ```ts
+ * import { zodValidator, QuerySchema } from 'vono/server'
+ *
+ * router.get('/users',
+ *   zodValidator('query', QuerySchema),
+ *   async (c) => {
+ *     const query = c.var.query as QueryDto
+ *     const { page, limit, q, sortBy, sortOrder } = query
+ *   }
+ * )
+ * ```
+ */
+export declare const QuerySchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+    q: z.ZodOptional<z.ZodString>;
+    sortBy: z.ZodOptional<z.ZodString>;
+    sortOrder: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        desc: "desc";
+        asc: "asc";
+    }>>>;
+    category: z.ZodOptional<z.ZodString>;
+    fields: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string[] | undefined, string | undefined>>;
+}, z.core.$strip>;
+/** Inferred TypeScript type for QuerySchema */
+export type QueryDto = z.infer<typeof QuerySchema>;
+//# sourceMappingURL=query.dto.d.ts.map

package/dist/server/dto/query.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.dto.d.ts","sourceRoot":"","sources":["../../../src/server/dto/query.dto.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;iBA+DtB,CAAA;AAEF,+CAA+C;AAC/C,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAA"}

package/dist/server/dto/query.dto.js

@@ -0,0 +1,86 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import { z } from 'zod';
+/**
+ * QuerySchema — standard query parameter schema for list/collection endpoints.
+ *
+ * All fields are optional with sensible defaults. Query params arrive as
+ * strings from the URL, so coercion is applied where needed.
+ *
+ * Usage with zodValidator:
+ * ```ts
+ * import { zodValidator, QuerySchema } from 'vono/server'
+ *
+ * router.get('/users',
+ *   zodValidator('query', QuerySchema),
+ *   async (c) => {
+ *     const query = c.var.query as QueryDto
+ *     const { page, limit, q, sortBy, sortOrder } = query
+ *   }
+ * )
+ * ```
+ */
+export const QuerySchema = z.object({
+    /**
+     * Current page number (1-indexed).
+     * Coerced from string → number. Defaults to 1.
+     */
+    page: z.coerce
+        .number({ invalid_type_error: 'page must be a number' })
+        .int('page must be an integer')
+        .min(1, 'page must be at least 1')
+        .optional()
+        .default(1),
+    /**
+     * Number of items per page.
+     * Coerced from string → number. Defaults to 20. Max 100.
+     */
+    limit: z.coerce
+        .number({ invalid_type_error: 'limit must be a number' })
+        .int('limit must be an integer')
+        .min(1, 'limit must be at least 1')
+        .max(100, 'limit cannot exceed 100')
+        .optional()
+        .default(20),
+    /**
+     * Full-text search query string.
+     * Case-insensitive search applied by the service layer.
+     */
+    q: z.string().trim().optional(),
+    /**
+     * Column/field name to sort by.
+     * The service layer validates this against allowed columns.
+     */
+    sortBy: z.string().trim().optional(),
+    /**
+     * Sort direction.
+     */
+    sortOrder: z.enum(['asc', 'desc']).optional().default('asc'),
+    /**
+     * Category filter — single category slug or ID.
+     */
+    category: z.string().trim().optional(),
+    /**
+     * Comma-separated list of fields to include in the response.
+     * Enables sparse fieldsets (e.g. ?fields=id,email,name).
+     * The service/resource layer applies the projection.
+     */
+    fields: z
+        .string()
+        .trim()
+        .optional()
+        .transform((val) => val
+        ? val
+            .split(',')
+            .map((f) => f.trim())
+            .filter(Boolean)
+        : undefined),
+});
+//# sourceMappingURL=query.dto.js.map

package/dist/server/dto/query.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.dto.js","sourceRoot":"","sources":["../../../src/server/dto/query.dto.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC;;;OAGG;IACH,IAAI,EAAE,CAAC,CAAC,MAAM;SACX,MAAM,CAAC,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,CAAC;SACvD,GAAG,CAAC,yBAAyB,CAAC;SAC9B,GAAG,CAAC,CAAC,EAAE,yBAAyB,CAAC;SACjC,QAAQ,EAAE;SACV,OAAO,CAAC,CAAC,CAAC;IAEb;;;OAGG;IACH,KAAK,EAAE,CAAC,CAAC,MAAM;SACZ,MAAM,CAAC,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,CAAC;SACxD,GAAG,CAAC,0BAA0B,CAAC;SAC/B,GAAG,CAAC,CAAC,EAAE,0BAA0B,CAAC;SAClC,GAAG,CAAC,GAAG,EAAE,yBAAyB,CAAC;SACnC,QAAQ,EAAE;SACV,OAAO,CAAC,EAAE,CAAC;IAEd;;;OAGG;IACH,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IAE/B;;;OAGG;IACH,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IAEpC;;OAEG;IACH,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAE5D;;OAEG;IACH,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IAEtC;;;;OAIG;IACH,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,IAAI,EAAE;SACN,QAAQ,EAAE;SACV,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CACjB,GAAG;QACD,CAAC,CAAC,GAAG;aACA,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACpB,MAAM,CAAC,OAAO,CAAC;QACpB,CAAC,CAAC,SAAS,CACd;CACJ,CAAC,CAAA"}

package/dist/server/email/define-email.d.ts

@@ -0,0 +1,41 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+export interface EmailDefinition<T> {
+    subject: (data: T) => string;
+    html: (data: T) => string;
+    text?: (data: T) => string;
+}
+export interface RenderedEmail {
+    subject: string;
+    html: string;
+    text: string;
+}
+export interface EmailTemplate<T> {
+    render: (data: T) => RenderedEmail;
+}
+/**
+ * `defineEmail<T>({ subject, html, text })` — defines a typed email template.
+ *
+ * Returns an object with a `render(data)` method that produces the final
+ * `{ subject, html, text }` strings.
+ *
+ * @example
+ * ```ts
+ * export const welcomeEmail = defineEmail<{ name: string; url: string }>({
+ *   subject: (d) => `Welcome, ${d.name}!`,
+ *   html: (d) => `<h1>Hi ${d.name}</h1><p><a href="${d.url}">Get started</a></p>`,
+ *   text: (d) => `Hi ${d.name}. Get started: ${d.url}`,
+ * })
+ *
+ * const { subject, html, text } = welcomeEmail.render({ name: 'Alice', url: 'https://...' })
+ * ```
+ */
+export declare function defineEmail<T>(definition: EmailDefinition<T>): EmailTemplate<T>;
+//# sourceMappingURL=define-email.d.ts.map

package/dist/server/email/define-email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-email.d.ts","sourceRoot":"","sources":["../../../src/server/email/define-email.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAA;IAC5B,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAA;IACzB,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,aAAa,CAAA;CACnC;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAU/E"}

package/dist/server/email/define-email.js

@@ -0,0 +1,50 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+// ─── defineEmail ─────────────────────────────────────────────────────────────
+/**
+ * `defineEmail<T>({ subject, html, text })` — defines a typed email template.
+ *
+ * Returns an object with a `render(data)` method that produces the final
+ * `{ subject, html, text }` strings.
+ *
+ * @example
+ * ```ts
+ * export const welcomeEmail = defineEmail<{ name: string; url: string }>({
+ *   subject: (d) => `Welcome, ${d.name}!`,
+ *   html: (d) => `<h1>Hi ${d.name}</h1><p><a href="${d.url}">Get started</a></p>`,
+ *   text: (d) => `Hi ${d.name}. Get started: ${d.url}`,
+ * })
+ *
+ * const { subject, html, text } = welcomeEmail.render({ name: 'Alice', url: 'https://...' })
+ * ```
+ */
+export function defineEmail(definition) {
+    return {
+        render(data) {
+            return {
+                subject: definition.subject(data),
+                html: definition.html(data),
+                text: definition.text ? definition.text(data) : stripHtml(definition.html(data)),
+            };
+        },
+    };
+}
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+/**
+ * Minimal HTML → plain text fallback when no `text` function is provided.
+ * Strips tags and collapses whitespace.
+ */
+function stripHtml(html) {
+    return html
+        .replace(/<[^>]+>/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+//# sourceMappingURL=define-email.js.map

package/dist/server/email/define-email.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-email.js","sourceRoot":"","sources":["../../../src/server/email/define-email.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAoBH,gFAAgF;AAEhF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,WAAW,CAAI,UAA8B;IAC3D,OAAO;QACL,MAAM,CAAC,IAAO;YACZ,OAAO;gBACL,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC;gBACjC,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC3B,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;aACjF,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC;AAED,gFAAgF;AAEhF;;;GAGG;AACH,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO,IAAI;SACR,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;SACxB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAA;AACX,CAAC"}

package/dist/server/email/drivers/console.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
+ * ──────────────────────────────────────────────────────────────────
+ */
+import type { SendEmailOptions } from '../send-email.js';
+/**
+ * Console driver — logs email to stdout instead of sending.
+ * Use in development / testing environments only.
+ */
+export declare function send(options: SendEmailOptions): Promise<void>;
+//# sourceMappingURL=console.d.ts.map

package/dist/server/email/drivers/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../../../src/server/email/drivers/console.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAExD;;;GAGG;AACH,wBAAsB,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAMnE"}

package/dist/server/email/drivers/console.js

@@ -0,0 +1,22 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 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';
+/**
+ * Console driver — logs email to stdout instead of sending.
+ * Use in development / testing environments only.
+ */
+export async function send(options) {
+    Logger.info('[email:console] Email would be sent', {
+        to: options.to,
+        subject: options.subject,
+        text: options.text?.slice(0, 200),
+    });
+}
+//# sourceMappingURL=console.js.map

package/dist/server/email/drivers/console.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.js","sourceRoot":"","sources":["../../../../src/server/email/drivers/console.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAA;AAGxD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,OAAyB;IAClD,MAAM,CAAC,IAAI,CAAC,qCAAqC,EAAE;QACjD,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;KAClC,CAAC,CAAA;AACJ,CAAC"}

package/dist/server/email/drivers/postmark.d.ts

@@ -0,0 +1,19 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import type { SendEmailOptions } from '../send-email.js';
+/**
+ * Postmark driver — sends email via the Postmark REST API.
+ * Requires `POSTMARK_API_KEY` in environment.
+ */
+export declare function send(options: SendEmailOptions & {
+    apiKey: string;
+    from: string;
+}): Promise<void>;
+//# sourceMappingURL=postmark.d.ts.map

package/dist/server/email/drivers/postmark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postmark.d.ts","sourceRoot":"","sources":["../../../../src/server/email/drivers/postmark.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAExD;;;GAGG;AACH,wBAAsB,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBtG"}

package/dist/server/email/drivers/postmark.js

@@ -0,0 +1,39 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 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';
+/**
+ * Postmark driver — sends email via the Postmark REST API.
+ * Requires `POSTMARK_API_KEY` in environment.
+ */
+export async function send(options) {
+    const res = await fetch('https://api.postmarkapp.com/email', {
+        method: 'POST',
+        headers: {
+            'X-Postmark-Server-Token': options.apiKey,
+            'Content-Type': 'application/json',
+            Accept: 'application/json',
+        },
+        body: JSON.stringify({
+            From: options.from,
+            To: options.to,
+            Subject: options.subject,
+            HtmlBody: options.html,
+            TextBody: options.text,
+            MessageStream: 'outbound',
+        }),
+    });
+    if (!res.ok) {
+        const body = await res.text();
+        Logger.error('[email:postmark] Failed to send email', { status: res.status, body });
+        throw new Error(`Postmark API error: ${res.status} ${body}`);
+    }
+    Logger.info('[email:postmark] Email sent', { to: options.to, subject: options.subject });
+}
+//# sourceMappingURL=postmark.js.map

package/dist/server/email/drivers/postmark.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postmark.js","sourceRoot":"","sources":["../../../../src/server/email/drivers/postmark.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAA;AAGxD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,OAA4D;IACrF,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,mCAAmC,EAAE;QAC3D,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,yBAAyB,EAAE,OAAO,CAAC,MAAM;YACzC,cAAc,EAAE,kBAAkB;YAClC,MAAM,EAAE,kBAAkB;SAC3B;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,QAAQ,EAAE,OAAO,CAAC,IAAI;YACtB,QAAQ,EAAE,OAAO,CAAC,IAAI;YACtB,aAAa,EAAE,UAAU;SAC1B,CAAC;KACH,CAAC,CAAA;IAEF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;QAC7B,MAAM,CAAC,KAAK,CAAC,uCAAuC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;QACnF,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC,CAAA;IAC9D,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;AAC1F,CAAC"}

package/dist/server/email/drivers/resend.d.ts

@@ -0,0 +1,19 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import type { SendEmailOptions } from '../send-email.js';
+/**
+ * Resend driver — sends email via the Resend REST API.
+ * Requires `RESEND_API_KEY` in environment.
+ */
+export declare function send(options: SendEmailOptions & {
+    apiKey: string;
+    from: string;
+}): Promise<void>;
+//# sourceMappingURL=resend.d.ts.map

package/dist/server/email/drivers/resend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resend.d.ts","sourceRoot":"","sources":["../../../../src/server/email/drivers/resend.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAExD;;;GAGG;AACH,wBAAsB,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBtG"}

package/dist/server/email/drivers/resend.js

@@ -0,0 +1,37 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 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';
+/**
+ * Resend driver — sends email via the Resend REST API.
+ * Requires `RESEND_API_KEY` in environment.
+ */
+export async function send(options) {
+    const res = await fetch('https://api.resend.com/emails', {
+        method: 'POST',
+        headers: {
+            Authorization: `Bearer ${options.apiKey}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({
+            from: options.from,
+            to: [options.to],
+            subject: options.subject,
+            html: options.html,
+            text: options.text,
+        }),
+    });
+    if (!res.ok) {
+        const body = await res.text();
+        Logger.error('[email:resend] Failed to send email', { status: res.status, body });
+        throw new Error(`Resend API error: ${res.status} ${body}`);
+    }
+    Logger.info('[email:resend] Email sent', { to: options.to, subject: options.subject });
+}
+//# sourceMappingURL=resend.js.map

package/dist/server/email/drivers/resend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resend.js","sourceRoot":"","sources":["../../../../src/server/email/drivers/resend.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAA;AAGxD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,OAA4D;IACrF,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,+BAA+B,EAAE;QACvD,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,OAAO,CAAC,MAAM,EAAE;YACzC,cAAc,EAAE,kBAAkB;SACnC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;YAChB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,IAAI,EAAE,OAAO,CAAC,IAAI;SACnB,CAAC;KACH,CAAC,CAAA;IAEF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;QAC7B,MAAM,CAAC,KAAK,CAAC,qCAAqC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;QACjF,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC,CAAA;IAC5D,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,2BAA2B,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;AACxF,CAAC"}

package/dist/server/email/drivers/smtp.d.ts

@@ -0,0 +1,26 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import type { SendEmailOptions } from '../send-email.js';
+export interface SmtpOptions {
+    host: string;
+    port: number;
+    user: string;
+    pass: string;
+    from: string;
+    secure?: boolean;
+}
+/**
+ * SMTP driver — sends email via nodemailer (Node/Bun only).
+ * Not compatible with Cloudflare Workers.
+ *
+ * Dynamically imports nodemailer to avoid bundling it in CF Workers builds.
+ */
+export declare function send(options: SendEmailOptions & SmtpOptions): Promise<void>;
+//# sourceMappingURL=smtp.d.ts.map

package/dist/server/email/drivers/smtp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smtp.d.ts","sourceRoot":"","sources":["../../../../src/server/email/drivers/smtp.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAExD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED;;;;;GAKG;AACH,wBAAsB,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBjF"}

package/dist/server/email/drivers/smtp.js

@@ -0,0 +1,37 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 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';
+/**
+ * SMTP driver — sends email via nodemailer (Node/Bun only).
+ * Not compatible with Cloudflare Workers.
+ *
+ * Dynamically imports nodemailer to avoid bundling it in CF Workers builds.
+ */
+export async function send(options) {
+    // Dynamic import — nodemailer is a Node.js-only dependency
+    const nodemailer = await import('nodemailer').catch(() => {
+        throw new Error('[email:smtp] nodemailer is not installed. Run: bun add nodemailer');
+    });
+    const transporter = nodemailer.createTransport({
+        host: options.host,
+        port: options.port,
+        secure: options.secure ?? options.port === 465,
+        auth: { user: options.user, pass: options.pass },
+    });
+    await transporter.sendMail({
+        from: options.from,
+        to: options.to,
+        subject: options.subject,
+        html: options.html,
+        text: options.text,
+    });
+    Logger.info('[email:smtp] Email sent', { to: options.to, subject: options.subject });
+}
+//# sourceMappingURL=smtp.js.map

package/dist/server/email/drivers/smtp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smtp.js","sourceRoot":"","sources":["../../../../src/server/email/drivers/smtp.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAA;AAYxD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,OAAuC;IAChE,2DAA2D;IAC3D,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;QACvD,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAA;IACtF,CAAC,CAAC,CAAA;IAEF,MAAM,WAAW,GAAG,UAAU,CAAC,eAAe,CAAC;QAC7C,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,IAAI,KAAK,GAAG;QAC9C,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE;KACjD,CAAC,CAAA;IAEF,MAAM,WAAW,CAAC,QAAQ,CAAC;QACzB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,OAAO,CAAC,IAAI;KACnB,CAAC,CAAA;IAEF,MAAM,CAAC,IAAI,CAAC,yBAAyB,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;AACtF,CAAC"}

package/dist/server/email/send-email.d.ts

@@ -0,0 +1,42 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 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';
+export interface SendEmailOptions {
+    to: string;
+    subject: string;
+    html: string;
+    text?: string;
+    /** When true, dispatches to queue instead of sending immediately */
+    queue?: boolean;
+}
+/**
+ * `sendEmail(c, options)` — sends an email via the configured driver.
+ *
+ * Driver selection (in priority order):
+ * 1. `RESEND_API_KEY` → Resend
+ * 2. `POSTMARK_API_KEY` → Postmark
+ * 3. `SMTP_HOST` → SMTP (nodemailer)
+ * 4. Fallback → Console (logs to stdout, dev-only)
+ *
+ * When `queue: true`, the email is dispatched to the queue instead of
+ * being sent immediately (requires queue to be configured).
+ *
+ * @example
+ * await sendEmail(c, {
+ *   to: 'user@example.com',
+ *   subject: 'Welcome!',
+ *   html: '<h1>Hello</h1>',
+ * })
+ */
+export declare function sendEmail(c: Context<{
+    Variables: AppVariables;
+}>, options: SendEmailOptions): Promise<void>;
+//# sourceMappingURL=send-email.d.ts.map

package/dist/server/email/send-email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-email.d.ts","sourceRoot":"","sources":["../../../src/server/email/send-email.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAKxD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,oEAAoE;IACpE,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAID;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,SAAS,CAC7B,CAAC,EAAE,OAAO,CAAC;IAAE,SAAS,EAAE,YAAY,CAAA;CAAE,CAAC,EACvC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CA2Cf"}

package/dist/server/email/send-email.js

@@ -0,0 +1,69 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 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';
+// ─── sendEmail ────────────────────────────────────────────────────────────────
+/**
+ * `sendEmail(c, options)` — sends an email via the configured driver.
+ *
+ * Driver selection (in priority order):
+ * 1. `RESEND_API_KEY` → Resend
+ * 2. `POSTMARK_API_KEY` → Postmark
+ * 3. `SMTP_HOST` → SMTP (nodemailer)
+ * 4. Fallback → Console (logs to stdout, dev-only)
+ *
+ * When `queue: true`, the email is dispatched to the queue instead of
+ * being sent immediately (requires queue to be configured).
+ *
+ * @example
+ * await sendEmail(c, {
+ *   to: 'user@example.com',
+ *   subject: 'Welcome!',
+ *   html: '<h1>Hello</h1>',
+ * })
+ */
+export async function sendEmail(c, options) {
+    const config = c.var.config;
+    // Queue dispatch — fire-and-forget when queue is configured
+    if (options.queue) {
+        Logger.info('[email] Queued email dispatch', { to: options.to, subject: options.subject });
+        // Queue integration point — when a queue driver is wired, dispatch here.
+        // For now, fall through to synchronous send.
+    }
+    const from = config['EMAIL_FROM'] ?? 'noreply@example.com';
+    // Resend
+    if (config.RESEND_API_KEY) {
+        const { send } = await import('./drivers/resend.js');
+        return send({ ...options, apiKey: config.RESEND_API_KEY, from });
+    }
+    // Postmark
+    const postmarkKey = config['POSTMARK_API_KEY'];
+    if (postmarkKey) {
+        const { send } = await import('./drivers/postmark.js');
+        return send({ ...options, apiKey: postmarkKey, from });
+    }
+    // SMTP
+    const smtpHost = config['SMTP_HOST'];
+    if (smtpHost) {
+        const { send } = await import('./drivers/smtp.js');
+        return send({
+            ...options,
+            host: smtpHost,
+            port: Number(config['SMTP_PORT'] ?? 587),
+            user: config['SMTP_USER'] ?? '',
+            pass: config['SMTP_PASS'] ?? '',
+            from,
+        });
+    }
+    // Console fallback (development)
+    Logger.warn('[email] No email driver configured — using console driver');
+    const { send } = await import('./drivers/console.js');
+    return send(options);
+}
+//# sourceMappingURL=send-email.js.map

package/dist/server/email/send-email.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-email.js","sourceRoot":"","sources":["../../../src/server/email/send-email.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAA;AAarD,iFAAiF;AAEjF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,CAAuC,EACvC,OAAyB;IAEzB,MAAM,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAA;IAE3B,4DAA4D;IAC5D,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,CAAC,IAAI,CAAC,+BAA+B,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;QAC1F,yEAAyE;QACzE,6CAA6C;IAC/C,CAAC;IAED,MAAM,IAAI,GAAI,MAAiC,CAAC,YAAY,CAAC,IAAI,qBAAqB,CAAA;IAEtF,SAAS;IACT,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;QAC1B,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAA;QACpD,OAAO,IAAI,CAAC,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,CAAA;IAClE,CAAC;IAED,WAAW;IACX,MAAM,WAAW,GAAI,MAAiC,CAAC,kBAAkB,CAAC,CAAA;IAC1E,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAA;QACtD,OAAO,IAAI,CAAC,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAA;IACxD,CAAC;IAED,OAAO;IACP,MAAM,QAAQ,GAAI,MAAiC,CAAC,WAAW,CAAC,CAAA;IAChE,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAA;QAClD,OAAO,IAAI,CAAC;YACV,GAAG,OAAO;YACV,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,MAAM,CAAE,MAAiC,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC;YACpE,IAAI,EAAG,MAAiC,CAAC,WAAW,CAAC,IAAI,EAAE;YAC3D,IAAI,EAAG,MAAiC,CAAC,WAAW,CAAC,IAAI,EAAE;YAC3D,IAAI;SACL,CAAC,CAAA;IACJ,CAAC;IAED,iCAAiC;IACjC,MAAM,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAA;IACxE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAA;IACrD,OAAO,IAAI,CAAC,OAAO,CAAC,CAAA;AACtB,CAAC"}