@gravito/signal 1.0.0-alpha.2

package/dist/index.mjs

@@ -0,0 +1,316 @@
+import {
+  DevMailbox,
+  LogTransport,
+  MemoryTransport,
+  OrbitSignal
+} from "./chunk-GADWIVC4.mjs";
+import "./chunk-6DZX6EAA.mjs";
+
+// src/renderers/HtmlRenderer.ts
+var HtmlRenderer = class {
+  constructor(content) {
+    this.content = content;
+  }
+  async render() {
+    return {
+      html: this.content,
+      text: this.stripHtml(this.content)
+    };
+  }
+  stripHtml(html) {
+    return html.replace(/<style[^>]*>[\s\S]*?<\/style>/gi, "").replace(/<script[^>]*>[\s\S]*?<\/script>/gi, "").replace(/<[^>]+>/g, "").replace(/&nbsp;/g, " ").replace(/\s+/g, " ").trim();
+  }
+};
+
+// src/renderers/TemplateRenderer.ts
+import { TemplateEngine } from "@gravito/prism";
+var TemplateRenderer = class {
+  engine;
+  template;
+  constructor(templateName, viewsDir) {
+    this.template = templateName;
+    const defaultDir = viewsDir || `${process.cwd()}/src/emails`;
+    this.engine = new TemplateEngine(defaultDir);
+  }
+  async render(data) {
+    const html = this.engine.render(this.template, data, {});
+    return {
+      html,
+      text: this.stripHtml(html)
+    };
+  }
+  stripHtml(html) {
+    return html.replace(/<style[^>]*>[\s\S]*?<\/style>/gi, "").replace(/<script[^>]*>[\s\S]*?<\/script>/gi, "").replace(/<[^>]+>/g, "").replace(/&nbsp;/g, " ").replace(/\s+/g, " ").trim();
+  }
+};
+
+// src/Mailable.ts
+var Mailable = class {
+  envelope = {};
+  renderer;
+  rendererResolver;
+  renderData = {};
+  // ===== Fluent API (Envelope Construction) =====
+  from(address) {
+    this.envelope.from = typeof address === "string" ? { address } : address;
+    return this;
+  }
+  to(address) {
+    this.envelope.to = this.normalizeAddressArray(address);
+    return this;
+  }
+  cc(address) {
+    this.envelope.cc = this.normalizeAddressArray(address);
+    return this;
+  }
+  bcc(address) {
+    this.envelope.bcc = this.normalizeAddressArray(address);
+    return this;
+  }
+  replyTo(address) {
+    this.envelope.replyTo = typeof address === "string" ? { address } : address;
+    return this;
+  }
+  subject(subject) {
+    this.envelope.subject = subject;
+    return this;
+  }
+  priority(level) {
+    this.envelope.priority = level;
+    return this;
+  }
+  attach(attachment) {
+    this.envelope.attachments = this.envelope.attachments || [];
+    this.envelope.attachments.push(attachment);
+    return this;
+  }
+  // ===== Content Methods (Renderer Selection) =====
+  /**
+   * Set the content using raw HTML string.
+   */
+  html(content) {
+    this.renderer = new HtmlRenderer(content);
+    return 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, data) {
+    this.renderer = new TemplateRenderer(template, void 0);
+    this.renderData = data || {};
+    return this;
+  }
+  /**
+   * Set the content using a React component.
+   * Dynamically imports ReactRenderer to avoid hard dependency errors if React is not installed.
+   */
+  react(component, props) {
+    this.rendererResolver = async () => {
+      const { ReactRenderer } = await import("./ReactRenderer-L5INVYKT.mjs");
+      return new ReactRenderer(component, props);
+    };
+    return this;
+  }
+  /**
+   * Set the content using a Vue component.
+   * Dynamically imports VueRenderer to avoid hard dependency errors if Vue is not installed.
+   */
+  vue(component, props) {
+    this.rendererResolver = async () => {
+      const { VueRenderer } = await import("./VueRenderer-Z5PRVBNH.mjs");
+      return new VueRenderer(component, props);
+    };
+    return this;
+  }
+  // ===== Queueable Implementation =====
+  queueName;
+  connectionName;
+  delaySeconds;
+  onQueue(queue) {
+    this.queueName = queue;
+    return this;
+  }
+  onConnection(connection) {
+    this.connectionName = connection;
+    return this;
+  }
+  delay(seconds) {
+    this.delaySeconds = seconds;
+    return this;
+  }
+  /**
+   * Queue the mailable for sending.
+   */
+  async queue() {
+    const { OrbitSignal: OrbitSignal2 } = await import("./OrbitSignal-ZKKMEC27.mjs");
+    return OrbitSignal2.getInstance().queue(this);
+  }
+  // ===== I18n Support =====
+  currentLocale;
+  translator;
+  /**
+   * Set the locale for the message.
+   */
+  locale(locale) {
+    this.currentLocale = locale;
+    return this;
+  }
+  /**
+   * Internal: Set the translator function (called by OrbitSignal)
+   */
+  setTranslator(translator) {
+    this.translator = translator;
+  }
+  /**
+   * Translate a string using the configured translator.
+   */
+  t(key, replace) {
+    if (this.translator) {
+      return this.translator(key, replace, this.currentLocale);
+    }
+    return key;
+  }
+  // ===== Internal Systems =====
+  /**
+   * Compile the envelope based on config defaults and mailable settings.
+   */
+  async buildEnvelope(configPromise) {
+    const config = await Promise.resolve(configPromise);
+    if (config.translator) {
+      this.setTranslator(config.translator);
+    }
+    this.build();
+    if (this.renderer instanceof TemplateRenderer && config.viewsDir) {
+    }
+    const envelope = {
+      from: this.envelope.from || config.from,
+      to: this.envelope.to || [],
+      subject: this.envelope.subject || "(No Subject)",
+      priority: this.envelope.priority || "normal"
+    };
+    if (this.envelope.cc) {
+      envelope.cc = this.envelope.cc;
+    }
+    if (this.envelope.bcc) {
+      envelope.bcc = this.envelope.bcc;
+    }
+    if (this.envelope.replyTo) {
+      envelope.replyTo = this.envelope.replyTo;
+    }
+    if (this.envelope.attachments) {
+      envelope.attachments = this.envelope.attachments;
+    }
+    return envelope;
+  }
+  /**
+   * execute the renderer
+   */
+  async renderContent() {
+    if (!this.renderer && this.rendererResolver) {
+      this.renderer = await this.rendererResolver();
+    }
+    if (!this.renderer) {
+      throw new Error("No content renderer specified. Use html(), view(), react(), or vue().");
+    }
+    this.renderData = {
+      ...this.renderData,
+      locale: this.currentLocale,
+      t: (key, replace) => this.t(key, replace)
+    };
+    return this.renderer.render(this.renderData);
+  }
+  normalizeAddressArray(input) {
+    const arr = Array.isArray(input) ? input : [input];
+    return arr.map((item) => typeof item === "string" ? { address: item } : item);
+  }
+};
+
+// src/transports/SesTransport.ts
+import { SESClient, SendRawEmailCommand } from "@aws-sdk/client-ses";
+import nodemailer from "nodemailer";
+var SesTransport = class {
+  transporter;
+  constructor(config) {
+    const clientConfig = { region: config.region };
+    if (config.accessKeyId && config.secretAccessKey) {
+      clientConfig.credentials = {
+        accessKeyId: config.accessKeyId,
+        secretAccessKey: config.secretAccessKey
+      };
+    }
+    const ses = new SESClient(clientConfig);
+    this.transporter = nodemailer.createTransport({
+      SES: { ses, aws: { SendRawEmailCommand } }
+    });
+  }
+  async send(message) {
+    await this.transporter.sendMail({
+      from: this.formatAddress(message.from),
+      to: message.to.map(this.formatAddress),
+      cc: message.cc?.map(this.formatAddress),
+      bcc: message.bcc?.map(this.formatAddress),
+      replyTo: message.replyTo ? this.formatAddress(message.replyTo) : void 0,
+      subject: message.subject,
+      html: message.html,
+      text: message.text,
+      headers: message.headers,
+      priority: message.priority,
+      attachments: message.attachments?.map((a) => ({
+        filename: a.filename,
+        content: a.content,
+        contentType: a.contentType,
+        cid: a.cid,
+        encoding: a.encoding
+      }))
+    });
+  }
+  formatAddress(addr) {
+    return addr.name ? `"${addr.name}" <${addr.address}>` : addr.address;
+  }
+};
+
+// src/transports/SmtpTransport.ts
+import nodemailer2 from "nodemailer";
+var SmtpTransport = class {
+  transporter;
+  constructor(config) {
+    this.transporter = nodemailer2.createTransport(config);
+  }
+  async send(message) {
+    await this.transporter.sendMail({
+      from: this.formatAddress(message.from),
+      to: message.to.map(this.formatAddress),
+      cc: message.cc?.map(this.formatAddress),
+      bcc: message.bcc?.map(this.formatAddress),
+      replyTo: message.replyTo ? this.formatAddress(message.replyTo) : void 0,
+      subject: message.subject,
+      html: message.html,
+      text: message.text,
+      headers: message.headers,
+      priority: message.priority,
+      attachments: message.attachments?.map((a) => ({
+        filename: a.filename,
+        content: a.content,
+        contentType: a.contentType,
+        cid: a.cid,
+        encoding: a.encoding
+      }))
+    });
+  }
+  formatAddress(addr) {
+    return addr.name ? `"${addr.name}" <${addr.address}>` : addr.address;
+  }
+};
+export {
+  DevMailbox,
+  HtmlRenderer,
+  LogTransport,
+  Mailable,
+  MemoryTransport,
+  OrbitSignal,
+  SesTransport,
+  SmtpTransport,
+  TemplateRenderer
+};

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@gravito/signal",
+  "version": "1.0.0-alpha.2",
+  "description": "Powerful email framework for Gravito applications with Dev UI and multi-renderer support.",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "test": "bun test"
+  },
+  "keywords": [
+    "gravito",
+    "mail",
+    "smtp",
+    "mjml",
+    "email",
+    "react-email",
+    "vue-email"
+  ],
+  "author": "Carl Lee <carllee0520@gmail.com>",
+  "license": "MIT",
+  "dependencies": {
+    "@aws-sdk/client-ses": "^3.953.0",
+    "mjml": "^4.14.1",
+    "nodemailer": "^6.9.1"
+  },
+  "peerDependencies": {
+    "gravito-core": "1.0.0-beta.2",
+    "@gravito/stream": "1.0.0-alpha.2",
+    "@gravito/prism": "1.0.0-beta.2",
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0",
+    "vue": "^3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    },
+    "@gravito/prism": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@gravito/stream": "1.0.0-alpha.2",
+    "@gravito/prism": "1.0.0-beta.2",
+    "@types/mjml": "^4.7.4",
+    "@types/nodemailer": "^6.4.14",
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
+    "@vue/server-renderer": "^3.0.0",
+    "gravito-core": "1.0.0-beta.2",
+    "hono": "^4.11.1",
+    "tsup": "^8.0.2",
+    "typescript": "^5.0.0",
+    "vue": "^3.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "homepage": "https://github.com/gravito-framework/gravito#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gravito-framework/gravito.git",
+    "directory": "packages/signal"
+  }
+}

package/src/Mailable.ts

@@ -0,0 +1,245 @@
+import type { Queueable } from '@gravito/stream' // Import Queueable from orbit-queue
+import { HtmlRenderer } from './renderers/HtmlRenderer'
+import type { Renderer } from './renderers/Renderer'
+import { TemplateRenderer } from './renderers/TemplateRenderer'
+import type { Address, Attachment, Envelope, MailConfig } from './types'
+
+// Type placeholders for React/Vue components to avoid hard dependencies in core
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+type ComponentType = any
+
+export abstract class Mailable implements Queueable {
+  protected envelope: Partial<Envelope> = {}
+  protected renderer?: Renderer
+  private rendererResolver?: () => Promise<Renderer>
+  protected renderData: Record<string, unknown> = {}
+
+  // ===== Fluent API (Envelope Construction) =====
+
+  from(address: string | Address): this {
+    this.envelope.from = typeof address === 'string' ? { address } : address
+    return this
+  }
+
+  to(address: string | Address | (string | Address)[]): this {
+    this.envelope.to = this.normalizeAddressArray(address)
+    return this
+  }
+
+  cc(address: string | Address | (string | Address)[]): this {
+    this.envelope.cc = this.normalizeAddressArray(address)
+    return this
+  }
+
+  bcc(address: string | Address | (string | Address)[]): this {
+    this.envelope.bcc = this.normalizeAddressArray(address)
+    return this
+  }
+
+  replyTo(address: string | Address): this {
+    this.envelope.replyTo = typeof address === 'string' ? { address } : address
+    return this
+  }
+
+  subject(subject: string): this {
+    this.envelope.subject = subject
+    return this
+  }
+
+  priority(level: 'high' | 'normal' | 'low'): this {
+    this.envelope.priority = level
+    return this
+  }
+
+  attach(attachment: Attachment): this {
+    this.envelope.attachments = this.envelope.attachments || []
+    this.envelope.attachments.push(attachment)
+    return this
+  }
+
+  // ===== Content Methods (Renderer Selection) =====
+
+  /**
+   * Set the content using raw HTML string.
+   */
+  html(content: string): this {
+    this.renderer = new HtmlRenderer(content)
+    return 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 {
+    this.renderer = new TemplateRenderer(template, undefined) // Dir will be injected later if possible, or use default
+    this.renderData = data || {}
+    return 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 {
+    this.rendererResolver = async () => {
+      const { ReactRenderer } = await import('./renderers/ReactRenderer')
+      return new ReactRenderer(component, props)
+    }
+    return 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 {
+    this.rendererResolver = async () => {
+      const { VueRenderer } = await import('./renderers/VueRenderer')
+      return new VueRenderer(component, props as any)
+    }
+    return this
+  }
+
+  // ===== Life Cycle =====
+
+  /**
+   * Setup the mailable. This is where you call from(), to(), view(), etc.
+   */
+  abstract build(): this
+
+  // ===== Queueable Implementation =====
+
+  queueName?: string
+  connectionName?: string
+  delaySeconds?: number
+
+  onQueue(queue: string): this {
+    this.queueName = queue
+    return this
+  }
+
+  onConnection(connection: string): this {
+    this.connectionName = connection
+    return this
+  }
+
+  delay(seconds: number): this {
+    this.delaySeconds = seconds
+    return this
+  }
+
+  /**
+   * Queue the mailable for sending.
+   */
+  async queue(): Promise<void> {
+    // Avoid circular dependency by dynamically importing OrbitSignal
+    const { OrbitSignal } = await import('./OrbitSignal')
+    return OrbitSignal.getInstance().queue(this)
+  }
+
+  // ===== I18n Support =====
+
+  protected currentLocale?: string
+  protected translator?: (key: string, replace?: Record<string, unknown>, locale?: string) => string
+
+  /**
+   * Set the locale for the message.
+   */
+  locale(locale: string): this {
+    this.currentLocale = locale
+    return this
+  }
+
+  /**
+   * Internal: Set the translator function (called by OrbitSignal)
+   */
+  setTranslator(
+    translator: (key: string, replace?: Record<string, unknown>, locale?: string) => string
+  ): void {
+    this.translator = translator
+  }
+
+  /**
+   * Translate a string using the configured translator.
+   */
+  t(key: string, replace?: Record<string, unknown>): string {
+    if (this.translator) {
+      return this.translator(key, replace, this.currentLocale)
+    }
+    return key // Fallback: just return the key if no translator
+  }
+
+  // ===== Internal Systems =====
+
+  /**
+   * Compile the envelope based on config defaults and mailable settings.
+   */
+  async buildEnvelope(configPromise: MailConfig | Promise<MailConfig>): Promise<Envelope> {
+    const config = await Promise.resolve(configPromise)
+
+    // Inject translator from config if available
+    if (config.translator) {
+      this.setTranslator(config.translator)
+    }
+
+    this.build() // User logic executes here
+
+    // Ensure Renderer is initialized if using TemplateRenderer with config path
+    if (this.renderer instanceof TemplateRenderer && config.viewsDir) {
+      // Here we could re-initialize TemplateRenderer if we had a setter for viewsDir
+      // For now, it defaults to process.cwd()/src/emails which is standard
+    }
+
+    const envelope: Envelope = {
+      from: this.envelope.from || config.from,
+      to: this.envelope.to || [],
+      subject: this.envelope.subject || '(No Subject)',
+      priority: this.envelope.priority || 'normal',
+    }
+
+    if (this.envelope.cc) {
+      envelope.cc = this.envelope.cc
+    }
+    if (this.envelope.bcc) {
+      envelope.bcc = this.envelope.bcc
+    }
+    if (this.envelope.replyTo) {
+      envelope.replyTo = this.envelope.replyTo
+    }
+    if (this.envelope.attachments) {
+      envelope.attachments = this.envelope.attachments
+    }
+
+    return envelope
+  }
+
+  /**
+   * execute the renderer
+   */
+  async renderContent(): Promise<{ html: string; text?: string }> {
+    // Resolve lazy renderer if needed
+    if (!this.renderer && this.rendererResolver) {
+      this.renderer = await this.rendererResolver()
+    }
+
+    if (!this.renderer) {
+      throw new Error('No content renderer specified. Use html(), view(), react(), or vue().')
+    }
+
+    // Inject i18n helpers into renderData
+    this.renderData = {
+      ...this.renderData,
+      locale: this.currentLocale,
+      t: (key: string, replace?: Record<string, unknown>) => this.t(key, replace),
+    }
+
+    return this.renderer.render(this.renderData)
+  }
+
+  private normalizeAddressArray(input: string | Address | (string | Address)[]): Address[] {
+    const arr = Array.isArray(input) ? input : [input]
+    return arr.map((item) => (typeof item === 'string' ? { address: item } : item))
+  }
+}