npm - @gravito/signal - Versions diffs - 1.0.0-alpha.2 - Mend

@gravito/signal 1.0.0-alpha.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (50) hide show

package/README.md +129 -0
package/dist/OrbitMail-2Z7ZTKYA.mjs +7 -0
package/dist/OrbitMail-BGV32HWN.mjs +7 -0
package/dist/OrbitMail-FUYZQSAV.mjs +7 -0
package/dist/OrbitMail-NAPCRK7B.mjs +7 -0
package/dist/OrbitMail-REGJ276B.mjs +7 -0
package/dist/OrbitMail-TCFBJWDT.mjs +7 -0
package/dist/OrbitMail-XZZW6U4N.mjs +7 -0
package/dist/OrbitSignal-ZKKMEC27.mjs +7 -0
package/dist/ReactRenderer-L5INVYKT.mjs +27 -0
package/dist/VueRenderer-S65ZARRI.mjs +37129 -0
package/dist/VueRenderer-Z5PRVBNH.mjs +37298 -0
package/dist/chunk-3U2CYJO5.mjs +367 -0
package/dist/chunk-3XFC4T6M.mjs +392 -0
package/dist/chunk-6DZX6EAA.mjs +37 -0
package/dist/chunk-DT3R2TNV.mjs +367 -0
package/dist/chunk-GADWIVC4.mjs +400 -0
package/dist/chunk-HHKFAMSE.mjs +380 -0
package/dist/chunk-OKRNL6PN.mjs +400 -0
package/dist/chunk-ULN3GMY2.mjs +367 -0
package/dist/chunk-XAWO7RSP.mjs +398 -0
package/dist/index.d.mts +278 -0
package/dist/index.d.ts +278 -0
package/dist/index.js +38150 -0
package/dist/index.mjs +316 -0
package/package.json +73 -0
package/src/Mailable.ts +245 -0
package/src/OrbitSignal.ts +158 -0
package/src/Queueable.ts +9 -0
package/src/dev/DevMailbox.ts +64 -0
package/src/dev/DevServer.ts +89 -0
package/src/dev/ui/mailbox.ts +68 -0
package/src/dev/ui/preview.ts +59 -0
package/src/dev/ui/shared.ts +46 -0
package/src/index.ts +20 -0
package/src/renderers/HtmlRenderer.ts +22 -0
package/src/renderers/ReactRenderer.ts +35 -0
package/src/renderers/Renderer.ts +11 -0
package/src/renderers/TemplateRenderer.ts +34 -0
package/src/renderers/VueRenderer.ts +37 -0
package/src/transports/LogTransport.ts +17 -0
package/src/transports/MemoryTransport.ts +11 -0
package/src/transports/SesTransport.ts +56 -0
package/src/transports/SmtpTransport.ts +50 -0
package/src/transports/Transport.ts +8 -0
package/src/types.ts +71 -0
package/tests/mailable.test.ts +77 -0
package/tests/renderers.test.ts +56 -0
package/tests/transports.test.ts +52 -0
package/tsconfig.json +19 -0

package/dist/chunk-XAWO7RSP.mjs ADDED Viewed

@@ -0,0 +1,398 @@
+// src/dev/DevMailbox.ts
+import { randomUUID } from "crypto";
+var DevMailbox = class {
+  entries = [];
+  maxEntries = 50;
+  add(message) {
+    const entry = {
+      id: randomUUID(),
+      envelope: {
+        from: message.from,
+        to: message.to,
+        ...message.cc ? { cc: message.cc } : {},
+        ...message.bcc ? { bcc: message.bcc } : {},
+        ...message.replyTo ? { replyTo: message.replyTo } : {},
+        subject: message.subject,
+        ...message.priority ? { priority: message.priority } : {},
+        ...message.attachments ? { attachments: message.attachments } : {}
+      },
+      html: message.html,
+      ...message.text ? { text: message.text } : {},
+      sentAt: /* @__PURE__ */ new Date()
+    };
+    this.entries.unshift(entry);
+    if (this.entries.length > this.maxEntries) {
+      this.entries = this.entries.slice(0, this.maxEntries);
+    }
+    return entry;
+  }
+  list() {
+    return this.entries;
+  }
+  get(id) {
+    return this.entries.find((e) => e.id === id);
+  }
+  delete(id) {
+    const index = this.entries.findIndex((e) => e.id === id);
+    if (index !== -1) {
+      this.entries.splice(index, 1);
+      return true;
+    }
+    return false;
+  }
+  clear() {
+    this.entries = [];
+  }
+};
+// src/dev/ui/shared.ts
+var styles = `
+:root {
+  --primary: #6366f1;
+  --primary-dark: #4f46e5;
+  --bg-dark: #0f172a;
+  --bg-card: #1e293b;
+  --text: #f1f5f9;
+  --text-muted: #94a3b8;
+  --border: #334155;
+  --danger: #ef4444;
+}
+body { background: var(--bg-dark); color: var(--text); font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif; margin: 0; padding: 20px; }
+.container { max-width: 1000px; margin: 0 auto; }
+.header { display: flex; justify-content: space-between; align-items: center; margin-bottom: 20px; }
+.title { font-size: 24px; font-weight: bold; display: flex; align-items: center; gap: 10px; }
+.card { background: var(--bg-card); border: 1px solid var(--border); border-radius: 8px; overflow: hidden; }
+.btn { background: var(--border); color: var(--text); border: none; padding: 8px 16px; border-radius: 6px; cursor: pointer; text-decoration: none; font-size: 14px; transition: 0.2s; }
+.btn:hover { background: var(--bg-card-hover); }
+.btn-primary { background: var(--primary); color: white; }
+.btn-primary:hover { background: var(--primary-dark); }
+.btn-danger { background: var(--danger); color: white; }
+.list-item { padding: 16px; border-bottom: 1px solid var(--border); display: flex; flex-direction: column; gap: 4px; text-decoration: none; color: inherit; transition: background 0.2s; }
+.list-item:last-child { border-bottom: none; }
+.list-item:hover { background: #334155; }
+.meta { display: flex; justify-content: space-between; font-size: 14px; color: var(--text-muted); }
+.subject { font-weight: 600; font-size: 16px; }
+.from { color: #cbd5e1; }
+.badge { background: #475569; padding: 2px 6px; border-radius: 4px; font-size: 12px; }
+.badge-high { background: #dc2626; color: white; }
+.empty { padding: 40px; text-align: center; color: var(--text-muted); }
+`;
+var layout = (title, content) => `
+<!DOCTYPE html>
+<html>
+<head>
+  <title>${title} - Gravito Mailbox</title>
+  <style>${styles}</style>
+</head>
+<body>
+  <div class="container">
+    ${content}
+  </div>
+</body>
+</html>
+`;
+// src/dev/ui/mailbox.ts
+function formatAddress(addr) {
+  return addr.name ? `${addr.name} <${addr.address}>` : addr.address;
+}
+function timeAgo(date) {
+  const seconds = Math.floor((Date.now() - date.getTime()) / 1e3);
+  if (seconds < 60) {
+    return "Just now";
+  }
+  const minutes = Math.floor(seconds / 60);
+  if (minutes < 60) {
+    return `${minutes}m ago`;
+  }
+  const hours = Math.floor(minutes / 60);
+  if (hours < 24) {
+    return `${hours}h ago`;
+  }
+  return date.toLocaleDateString();
+}
+function getMailboxHtml(entries, prefix) {
+  const list = entries.length === 0 ? '<div class="empty">No emails found in mailbox.</div>' : entries.map(
+    (entry) => `
+      <a href="${prefix}/${entry.id}" class="list-item">
+        <div class="meta">
+          <span class="from">${formatAddress(entry.envelope.from || { address: "Unknown" })}</span>
+          <span>${timeAgo(entry.sentAt)}</span>
+        </div>
+        <div class="subject">
+          ${entry.envelope.priority === "high" ? '<span class="badge badge-high">High</span> ' : ""}
+          ${entry.envelope.subject || "(No Subject)"}
+        </div>
+        <div class="meta" style="margin-top: 4px;">
+           To: ${entry.envelope.to?.map((t) => t.address).join(", ")}
+        </div>
+      </a>
+    `
+  ).join("");
+  const content = `
+    <div class="header">
+      <div class="title">\u{1F4EC} Gravito Mailbox</div>
+      ${entries.length > 0 ? `<button onclick="clearAll()" class="btn btn-danger">Clear All</button>` : ""}
+    </div>
+    <div class="card">
+      ${list}
+    </div>
+    <script>
+      async function clearAll() {
+        if (!confirm('Clear all emails?')) return;
+        await fetch('${prefix}', { method: 'DELETE' });
+        window.location.reload();
+      }
+    </script>
+  `;
+  return layout("Inbox", content);
+}
+// src/dev/ui/preview.ts
+function getPreviewHtml(entry, prefix) {
+  const from = entry.envelope.from ? `${entry.envelope.from.name || ""} &lt;${entry.envelope.from.address}&gt;` : "Unknown";
+  const to = entry.envelope.to?.map((t) => t.address).join(", ") || "Unknown";
+  const content = `
+    <div class="header">
+      <div class="title">
+        <a href="${prefix}" class="btn">\u2190 Back</a>
+        <span style="margin-left: 10px">Email Preview</span>
+      </div>
+      <button onclick="deleteEmail('${entry.id}')" class="btn btn-danger">Delete</button>
+    </div>
+    <div class="card" style="margin-bottom: 20px; padding: 20px;">
+      <div style="font-size: 18px; font-weight: bold; margin-bottom: 10px;">${entry.envelope.subject || "(No Subject)"}</div>
+      <div class="meta" style="margin-bottom: 5px;">From: ${from}</div>
+      <div class="meta" style="margin-bottom: 5px;">To: ${to}</div>
+      <div class="meta">Date: ${entry.sentAt.toLocaleString()}</div>
+    </div>
+    <div style="margin-bottom: 10px;">
+      <button onclick="setView('html')" id="btn-html" class="btn btn-primary">HTML</button>
+      <button onclick="setView('text')" id="btn-text" class="btn">Text</button>
+      <button onclick="setView('raw')" id="btn-raw" class="btn">Raw JSON</button>
+      <a href="${prefix}/${entry.id}/html" target="_blank" class="btn">Open HTML \u2197</a>
+    </div>
+    <div class="card" style="height: 600px; display: flex;">
+      <iframe id="preview-frame" src="${prefix}/${entry.id}/html" style="width: 100%; height: 100%; border: none;"></iframe>
+      <pre id="raw-view" style="display: none; padding: 20px; overflow: auto; width: 100%;">${JSON.stringify(entry, null, 2)}</pre>
+      <pre id="text-view" style="display: none; padding: 20px; overflow: auto; width: 100%; white-space: pre-wrap; font-family: monospace;">${entry.text || "No text content"}</pre>
+    </div>
+    <script>
+      function setView(mode) {
+        document.getElementById('preview-frame').style.display = mode === 'html' ? 'block' : 'none';
+        document.getElementById('raw-view').style.display = mode === 'raw' ? 'block' : 'none';
+        document.getElementById('text-view').style.display = mode === 'text' ? 'block' : 'none';
+        document.getElementById('btn-html').className = mode === 'html' ? 'btn btn-primary' : 'btn';
+        document.getElementById('btn-text').className = mode === 'text' ? 'btn btn-primary' : 'btn';
+        document.getElementById('btn-raw').className = mode === 'raw' ? 'btn btn-primary' : 'btn';
+      }
+      async function deleteEmail(id) {
+        if (!confirm('Delete this email?')) return;
+        await fetch('${prefix}/' + id, { method: 'DELETE' });
+        window.location.href = '${prefix}';
+      }
+    </script>
+  `;
+  return layout(entry.envelope.subject || "Preview", content);
+}
+// src/dev/DevServer.ts
+var DevServer = class {
+  constructor(mailbox, base = "/__mail") {
+    this.mailbox = mailbox;
+    this.base = base;
+  }
+  register(core) {
+    const router = core.router;
+    const prefix = this.base.replace(/\/$/, "");
+    router.get(prefix, (ctx) => {
+      const entries = this.mailbox.list();
+      return ctx.html(getMailboxHtml(entries, prefix));
+    });
+    router.get(`${prefix}/:id`, (ctx) => {
+      const id = ctx.req.param("id");
+      const entry = this.mailbox.get(id);
+      if (!entry) {
+        return ctx.text("Email not found", 404);
+      }
+      return ctx.html(getPreviewHtml(entry, prefix));
+    });
+    router.get(`${prefix}/:id/html`, (ctx) => {
+      const id = ctx.req.param("id");
+      const entry = this.mailbox.get(id);
+      if (!entry) {
+        return ctx.text("Not found", 404);
+      }
+      return ctx.html(entry.html);
+    });
+    router.get(`${prefix}/:id/text`, (ctx) => {
+      const id = ctx.req.param("id");
+      const entry = this.mailbox.get(id);
+      if (!entry) {
+        return ctx.text("Not found", 404);
+      }
+      return ctx.text(entry.text || "No text content", 200, {
+        "Content-Type": "text/plain; charset=utf-8"
+      });
+    });
+    router.get(`${prefix}/:id/raw`, (ctx) => {
+      const id = ctx.req.param("id");
+      const entry = this.mailbox.get(id);
+      if (!entry) {
+        return ctx.json({ error: "Not found" }, 404);
+      }
+      return ctx.json(entry);
+    });
+    router.get(`${prefix}/:id/delete`, (ctx) => {
+      return ctx.text("Method not allowed", 405);
+    });
+    router.delete(`${prefix}/:id`, (ctx) => {
+      const success = this.mailbox.delete(ctx.req.param("id"));
+      return ctx.json({ success });
+    });
+    router.delete(prefix, (ctx) => {
+      this.mailbox.clear();
+      return ctx.json({ success: true });
+    });
+    core.logger.info(`[OrbitMail] Dev Mailbox available at ${prefix}`);
+  }
+};
+// src/transports/LogTransport.ts
+var LogTransport = class {
+  async send(message) {
+    console.log("\n\u{1F4E7} [OrbitMail] Email Sent (Simulated):");
+    console.log("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501");
+    console.log(
+      `From:    ${message.from.name ? `${message.from.name} <${message.from.address}>` : message.from.address}`
+    );
+    console.log(`To:      ${message.to.map((t) => t.address).join(", ")}`);
+    console.log(`Subject: ${message.subject}`);
+    console.log("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501");
+    console.log(`[Content Size]: ${message.html.length} chars (HTML)`);
+    console.log("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n");
+  }
+};
+// src/transports/MemoryTransport.ts
+var MemoryTransport = class {
+  constructor(mailbox) {
+    this.mailbox = mailbox;
+  }
+  async send(message) {
+    this.mailbox.add(message);
+  }
+};
+// src/OrbitMail.ts
+var OrbitMail = class _OrbitMail {
+  static instance;
+  config;
+  devMailbox;
+  constructor(config = {}) {
+    this.config = config;
+    _OrbitMail.instance = this;
+  }
+  /**
+   * Get the singleton instance of OrbitMail
+   */
+  static getInstance() {
+    if (!_OrbitMail.instance) {
+      throw new Error("OrbitMail has not been initialized. Call OrbitMail.configure() first.");
+    }
+    return _OrbitMail.instance;
+  }
+  /**
+   * Configure the OrbitMail instance
+   */
+  static configure(config) {
+    if (!config.transport && !config.devMode) {
+      console.warn("[OrbitMail] No transport provided, falling back to LogTransport");
+      config.transport = new LogTransport();
+    }
+    return new _OrbitMail(config);
+  }
+  /**
+   * Install the orbit into PlanetCore
+   */
+  install(core) {
+    core.logger.info("[OrbitMail] Initializing Mail Service (Exposed as: mail)");
+    if (!this.config.transport && !this.config.devMode) {
+      this.config.transport = new LogTransport();
+    }
+    if (this.config.devMode) {
+      this.devMailbox = new DevMailbox();
+      this.config.transport = new MemoryTransport(this.devMailbox);
+      core.logger.info("[OrbitMail] Dev Mode Enabled: Emails will be intercepted to Dev Mailbox");
+      const devServer = new DevServer(this.devMailbox, this.config.devUiPrefix || "/__mail");
+      devServer.register(core);
+    }
+    core.app.use("*", async (c, next) => {
+      c.set("mail", {
+        send: (mailable) => this.send(mailable),
+        queue: (mailable) => this.queue(mailable)
+      });
+      await next();
+    });
+  }
+  /**
+   * Send a mailable instance
+   */
+  async send(mailable) {
+    const envelope = await mailable.buildEnvelope(this.config);
+    if (!envelope.from) {
+      throw new Error('Message is missing "from" address');
+    }
+    if (!envelope.to || envelope.to.length === 0) {
+      throw new Error('Message is missing "to" address');
+    }
+    const content = await mailable.renderContent();
+    const message = {
+      ...envelope,
+      from: envelope.from,
+      to: envelope.to,
+      subject: envelope.subject || "(No Subject)",
+      priority: envelope.priority || "normal",
+      html: content.html
+    };
+    if (content.text) {
+      message.text = content.text;
+    }
+    if (!this.config.transport) {
+      throw new Error("[OrbitMail] No transport configured. Did you call configure() or register the orbit?");
+    }
+    await this.config.transport.send(message);
+  }
+  /**
+   * Queue a mailable instance
+   *
+   * Push a mailable into the queue for execution.
+   * Requires OrbitQueue to be installed and available in the context.
+   */
+  async queue(mailable) {
+    const queue = this.queueService;
+    if (queue) {
+      await queue.push(mailable);
+    } else {
+      console.warn(
+        "[OrbitMail] Queue service not available, sending immediately. Install OrbitQueue to enable queuing."
+      );
+      await this.send(mailable);
+    }
+  }
+};
+export {
+  DevMailbox,
+  LogTransport,
+  MemoryTransport,
+  OrbitMail
+};

package/dist/index.d.mts ADDED Viewed

@@ -0,0 +1,278 @@
+import { Queueable } from '@gravito/stream';
+export { Queueable } from '@gravito/stream';
+import { GravitoOrbit, PlanetCore } from 'gravito-core';
+interface Transport {
+    /**
+     * Send the given message
+     */
+    send(message: Message): Promise<void>;
+}
+interface Address {
+    name?: string;
+    address: string;
+}
+interface Attachment {
+    filename: string;
+    content: string | Buffer;
+    contentType?: string;
+    cid?: string;
+    encoding?: string;
+}
+interface Envelope {
+    from?: Address | undefined;
+    to?: Address[] | undefined;
+    cc?: Address[] | undefined;
+    bcc?: Address[] | undefined;
+    replyTo?: Address | undefined;
+    subject?: string | undefined;
+    priority?: 'high' | 'normal' | 'low' | undefined;
+    attachments?: Attachment[] | undefined;
+}
+interface Message extends Envelope {
+    from: Address;
+    to: Address[];
+    subject: string;
+    html: string;
+    text?: string;
+    headers?: Record<string, string>;
+}
+interface MailConfig {
+    /**
+     * Default sender address
+     */
+    from?: Address;
+    /**
+     * The transport mechanism used to send emails
+     */
+    transport?: Transport;
+    /**
+     * Enable development mode (intercepts emails)
+     */
+    devMode?: boolean | undefined;
+    /**
+     * Directory where email templates are located (for OrbitPrism)
+     * Default: src/emails
+     */
+    viewsDir?: string | undefined;
+    /**
+     * URL prefix for Dev UI
+     * Default: /__mail
+     */
+    devUiPrefix?: string | undefined;
+    /**
+     * Translation function for i18n support
+     */
+    translator?: ((key: string, replace?: Record<string, unknown>, locale?: string) => string) | undefined;
+}
+interface MailboxEntry {
+    id: string;
+    envelope: Envelope;
+    html: string;
+    text?: string;
+    sentAt: Date;
+}
+declare class DevMailbox {
+    private entries;
+    private maxEntries;
+    add(message: Message): MailboxEntry;
+    list(): MailboxEntry[];
+    get(id: string): MailboxEntry | undefined;
+    delete(id: string): boolean;
+    clear(): void;
+}
+interface RenderResult {
+    html: string;
+    text?: string;
+}
+interface Renderer {
+    /**
+     * Render the content into HTML and optionally plain text
+     */
+    render(data: Record<string, unknown>): Promise<RenderResult>;
+}
+type ComponentType = any;
+declare abstract class Mailable implements Queueable {
+    protected envelope: Partial<Envelope>;
+    protected renderer?: Renderer;
+    private rendererResolver?;
+    protected renderData: Record<string, unknown>;
+    from(address: string | Address): this;
+    to(address: string | Address | (string | Address)[]): this;
+    cc(address: string | Address | (string | Address)[]): this;
+    bcc(address: string | Address | (string | Address)[]): this;
+    replyTo(address: string | Address): this;
+    subject(subject: string): this;
+    priority(level: 'high' | 'normal' | 'low'): this;
+    attach(attachment: Attachment): this;
+    /**
+     * Set the content using raw HTML string.
+     */
+    html(content: string): this;
+    /**
+     * Set the content using an OrbitPrism template.
+     * @param template Template name (relative to viewsDir/emails)
+     * @param data Data to pass to the template
+     */
+    view(template: string, data?: Record<string, unknown>): this;
+    /**
+     * Set the content using a React component.
+     * Dynamically imports ReactRenderer to avoid hard dependency errors if React is not installed.
+     */
+    react<P extends object>(component: ComponentType, props?: P): this;
+    /**
+     * Set the content using a Vue component.
+     * Dynamically imports VueRenderer to avoid hard dependency errors if Vue is not installed.
+     */
+    vue<P extends object>(component: ComponentType, props?: P): this;
+    /**
+     * Setup the mailable. This is where you call from(), to(), view(), etc.
+     */
+    abstract build(): this;
+    queueName?: string;
+    connectionName?: string;
+    delaySeconds?: number;
+    onQueue(queue: string): this;
+    onConnection(connection: string): this;
+    delay(seconds: number): this;
+    /**
+     * Queue the mailable for sending.
+     */
+    queue(): Promise<void>;
+    protected currentLocale?: string;
+    protected translator?: (key: string, replace?: Record<string, unknown>, locale?: string) => string;
+    /**
+     * Set the locale for the message.
+     */
+    locale(locale: string): this;
+    /**
+     * Internal: Set the translator function (called by OrbitSignal)
+     */
+    setTranslator(translator: (key: string, replace?: Record<string, unknown>, locale?: string) => string): void;
+    /**
+     * Translate a string using the configured translator.
+     */
+    t(key: string, replace?: Record<string, unknown>): string;
+    /**
+     * Compile the envelope based on config defaults and mailable settings.
+     */
+    buildEnvelope(configPromise: MailConfig | Promise<MailConfig>): Promise<Envelope>;
+    /**
+     * execute the renderer
+     */
+    renderContent(): Promise<{
+        html: string;
+        text?: string;
+    }>;
+    private normalizeAddressArray;
+}
+declare class OrbitSignal implements GravitoOrbit {
+    private static instance?;
+    private config;
+    private devMailbox?;
+    constructor(config?: MailConfig);
+    /**
+     * Get the singleton instance of OrbitSignal
+     */
+    static getInstance(): OrbitSignal;
+    /**
+     * Configure the OrbitSignal instance
+     */
+    static configure(config: MailConfig): OrbitSignal;
+    /**
+     * Install the orbit into PlanetCore
+     */
+    install(core: PlanetCore): void;
+    /**
+     * Send a mailable instance
+     */
+    send(mailable: Mailable): Promise<void>;
+    /**
+     * Queue a mailable instance
+     *
+     * Push a mailable into the queue for execution.
+     * Requires OrbitStream to be installed and available in the context.
+     */
+    queue(mailable: Mailable): Promise<void>;
+}
+declare module 'hono' {
+    interface ContextVariableMap {
+        mail: {
+            send: (mailable: Mailable) => Promise<void>;
+            queue: (mailable: Mailable) => Promise<void>;
+        };
+    }
+}
+declare module 'gravito-core' {
+    interface GravitoVariables {
+        /** Mail service for sending emails */
+        mail?: {
+            send: (mailable: Mailable) => Promise<void>;
+            queue: (mailable: Mailable) => Promise<void>;
+        };
+    }
+}
+declare class HtmlRenderer implements Renderer {
+    private content;
+    constructor(content: string);
+    render(): Promise<RenderResult>;
+    private stripHtml;
+}
+declare class TemplateRenderer implements Renderer {
+    private engine;
+    private template;
+    constructor(templateName: string, viewsDir?: string);
+    render(data: Record<string, unknown>): Promise<RenderResult>;
+    private stripHtml;
+}
+declare class LogTransport implements Transport {
+    send(message: Message): Promise<void>;
+}
+declare class MemoryTransport implements Transport {
+    private mailbox;
+    constructor(mailbox: DevMailbox);
+    send(message: Message): Promise<void>;
+}
+interface SesConfig {
+    region: string;
+    accessKeyId?: string;
+    secretAccessKey?: string;
+}
+declare class SesTransport implements Transport {
+    private transporter;
+    constructor(config: SesConfig);
+    send(message: Message): Promise<void>;
+    private formatAddress;
+}
+interface SmtpConfig {
+    host: string;
+    port: number;
+    secure?: boolean;
+    auth?: {
+        user: string;
+        pass: string;
+    };
+    tls?: {
+        rejectUnauthorized?: boolean;
+        ciphers?: string;
+    };
+}
+declare class SmtpTransport implements Transport {
+    private transporter;
+    constructor(config: SmtpConfig);
+    send(message: Message): Promise<void>;
+    private formatAddress;
+}
+export { type Address, type Attachment, DevMailbox, type Envelope, HtmlRenderer, LogTransport, type MailConfig, Mailable, type MailboxEntry, MemoryTransport, type Message, OrbitSignal, type RenderResult, type Renderer, SesTransport, SmtpTransport, TemplateRenderer, type Transport };