@gravito/signal 3.0.0 → 3.0.3

package/dist/index.js

@@ -61,7 +61,7 @@ var init_ReactRenderer = __esm({
         };
       }
       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();
+        return html.replace(/<style(?:\s[^>]*)?>[\s\S]*?<\/style>/gi, "").replace(/<script(?:\s[^>]*)?>[\s\S]*?<\/script>/gi, "").replace(/<[^>]+>/g, "").replace(/&nbsp;/g, " ").replace(/\s+/g, " ").trim();
       }
     };
   }
@@ -37322,7 +37322,7 @@ var init_VueRenderer = __esm({
         };
       }
       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();
+        return html.replace(/<style(?:\s[^>]*)?>[\s\S]*?<\/style>/gi, "").replace(/<script(?:\s[^>]*)?>[\s\S]*?<\/script>/gi, "").replace(/<[^>]+>/g, "").replace(/&nbsp;/g, " ").replace(/\s+/g, " ").trim();
       }
     };
   }
@@ -37402,7 +37402,7 @@ var HtmlRenderer = class {
     };
   }
   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();
+    return html.replace(/<style(?:\s[^>]*)?>[\s\S]*?<\/style>/gi, "").replace(/<script(?:\s[^>]*)?>[\s\S]*?<\/script>/gi, "").replace(/<[^>]+>/g, "").replace(/&nbsp;/g, " ").replace(/\s+/g, " ").trim();
   }
 };
 
@@ -37436,34 +37436,74 @@ var Mailable = class {
   renderData = {};
   config;
   // ===== Fluent API (Envelope Construction) =====
+  /**
+   * Set the sender address for the email.
+   *
+   * @param address - Email address or Address object.
+   */
   from(address) {
     this.envelope.from = typeof address === "string" ? { address } : address;
     return this;
   }
+  /**
+   * Set the primary recipient(s) for the email.
+   *
+   * @param address - Single address, address object, or array of either.
+   */
   to(address) {
     this.envelope.to = this.normalizeAddressArray(address);
     return this;
   }
+  /**
+   * Set the carbon copy (CC) recipient(s).
+   *
+   * @param address - Single address, address object, or array of either.
+   */
   cc(address) {
     this.envelope.cc = this.normalizeAddressArray(address);
     return this;
   }
+  /**
+   * Set the blind carbon copy (BCC) recipient(s).
+   *
+   * @param address - Single address, address object, or array of either.
+   */
   bcc(address) {
     this.envelope.bcc = this.normalizeAddressArray(address);
     return this;
   }
+  /**
+   * Set the reply-to address.
+   *
+   * @param address - Email address or Address object.
+   */
   replyTo(address) {
     this.envelope.replyTo = typeof address === "string" ? { address } : address;
     return this;
   }
+  /**
+   * Set the subject line for the email.
+   *
+   * @param subject - The email subject.
+   */
   subject(subject) {
     this.envelope.subject = subject;
     return this;
   }
+  /**
+   * Set the email priority.
+   *
+   * @param level - Priority level ('high', 'normal', or 'low').
+   */
   emailPriority(level) {
     this.envelope.priority = level;
     return this;
   }
+  /**
+   * Attach a file to the email.
+   *
+   * @param attachment - Attachment configuration object.
+   */
   attach(attachment) {
     this.envelope.attachments = this.envelope.attachments || [];
     this.envelope.attachments.push(attachment);
@@ -37472,6 +37512,8 @@ var Mailable = class {
   // ===== Content Methods (Renderer Selection) =====
   /**
    * Set the content using raw HTML string.
+   *
+   * @param content - The HTML content string.
    */
   html(content) {
     this.renderer = new HtmlRenderer(content);
@@ -37479,8 +37521,9 @@ var Mailable = class {
   }
   /**
    * Set the content using an OrbitPrism template.
-   * @param template Template name (relative to viewsDir/emails)
-   * @param data Data to pass to the template
+   *
+   * @param template - Template name (relative to viewsDir/emails).
+   * @param data - Optional data to pass to the template.
    */
   view(template, data) {
     this.renderer = new TemplateRenderer(template, void 0);
@@ -37490,6 +37533,10 @@ var Mailable = class {
   /**
    * Set the content using a React component.
    * Dynamically imports ReactRenderer to avoid hard dependency errors if React is not installed.
+   *
+   * @param component - The React component to render.
+   * @param props - Optional props for the component.
+   * @param deps - Optional dependencies (React, ReactDOMServer) if not globally available.
    */
   react(component, props, deps) {
     this.rendererResolver = async () => {
@@ -37501,6 +37548,10 @@ var Mailable = class {
   /**
    * Set the content using a Vue component.
    * Dynamically imports VueRenderer to avoid hard dependency errors if Vue is not installed.
+   *
+   * @param component - The Vue component to render.
+   * @param props - Optional props for the component.
+   * @param deps - Optional dependencies (Vue, VueServerRenderer) if not globally available.
    */
   vue(component, props, deps) {
     this.rendererResolver = async () => {
@@ -37510,28 +37561,45 @@ var Mailable = class {
     return this;
   }
   // ===== Queueable Implementation =====
+  /** The name of the queue to push this mailable to. */
   queueName;
+  /** The connection name for the queue. */
   connectionName;
+  /** Delay in seconds before the message is sent. */
   delaySeconds;
+  /** Priority of the message in the queue. */
   priority;
+  /**
+   * Set the queue name for this mailable.
+   */
   onQueue(queue) {
     this.queueName = queue;
     return this;
   }
+  /**
+   * Set the connection name for this mailable.
+   */
   onConnection(connection) {
     this.connectionName = connection;
     return this;
   }
+  /**
+   * Set a delay for the queued mailable.
+   */
   delay(seconds) {
     this.delaySeconds = seconds;
     return this;
   }
+  /**
+   * Set the priority for the queued mailable.
+   */
   withPriority(priority) {
     this.priority = priority;
     return this;
   }
   /**
    * Queue the mailable for sending.
+   * Attempts to resolve the mail service from the PlanetCore container.
    */
   async queue() {
     try {
@@ -37549,6 +37617,8 @@ var Mailable = class {
   translator;
   /**
    * Set the locale for the message.
+   *
+   * @param locale - Valid locale string (e.g., 'en', 'zh-TW').
    */
   locale(locale) {
     this.currentLocale = locale;
@@ -37556,12 +37626,17 @@ var Mailable = class {
   }
   /**
    * Internal: Set the translator function (called by OrbitSignal)
+   * @internal
    */
   setTranslator(translator) {
     this.translator = translator;
   }
   /**
    * Translate a string using the configured translator.
+   *
+   * @param key - Translation key.
+   * @param replace - Interpolation variables.
+   * @returns Translated string or the key if translator is missing.
    */
   t(key, replace) {
     if (this.translator) {
@@ -37572,6 +37647,7 @@ var Mailable = class {
   // ===== Internal Systems =====
   /**
    * Compile the envelope based on config defaults and mailable settings.
+   * Called by OrbitSignal before rendering/sending.
    */
   async buildEnvelope(configPromise) {
     const config = await Promise.resolve(configPromise);
@@ -37604,7 +37680,8 @@ var Mailable = class {
     return envelope;
   }
   /**
-   * execute the renderer
+   * Execute the renderer and produce HTML/Text content.
+   * @returns Object containing rendered html and optional text content.
    */
   async renderContent() {
     if (!this.renderer && this.rendererResolver) {
@@ -37993,7 +38070,7 @@ var OrbitSignal = class {
       });
       devServer.register(core);
     }
-    core.container.singleton("mail", () => this);
+    core.container.instance("mail", this);
     core.adapter.use("*", async (c, next) => {
       c.set("mail", this);
       return await next();
@@ -38001,10 +38078,6 @@ var OrbitSignal = class {
   }
   /**
    * Send a mailable instance
-   *
-   * @param mailable - The mailable object to send.
-   * @returns A promise that resolves when the email is sent.
-   * @throws {Error} If the message is missing "from" or "to" addresses, or if no transport is configured.
    */
   async send(mailable) {
     const envelope = await mailable.buildEnvelope(this.config);

package/dist/index.mjs

@@ -59,7 +59,7 @@ var HtmlRenderer = class {
     };
   }
   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();
+    return html.replace(/<style(?:\s[^>]*)?>[\s\S]*?<\/style>/gi, "").replace(/<script(?:\s[^>]*)?>[\s\S]*?<\/script>/gi, "").replace(/<[^>]+>/g, "").replace(/&nbsp;/g, " ").replace(/\s+/g, " ").trim();
   }
 };
 
@@ -93,34 +93,74 @@ var Mailable = class {
   renderData = {};
   config;
   // ===== Fluent API (Envelope Construction) =====
+  /**
+   * Set the sender address for the email.
+   *
+   * @param address - Email address or Address object.
+   */
   from(address) {
     this.envelope.from = typeof address === "string" ? { address } : address;
     return this;
   }
+  /**
+   * Set the primary recipient(s) for the email.
+   *
+   * @param address - Single address, address object, or array of either.
+   */
   to(address) {
     this.envelope.to = this.normalizeAddressArray(address);
     return this;
   }
+  /**
+   * Set the carbon copy (CC) recipient(s).
+   *
+   * @param address - Single address, address object, or array of either.
+   */
   cc(address) {
     this.envelope.cc = this.normalizeAddressArray(address);
     return this;
   }
+  /**
+   * Set the blind carbon copy (BCC) recipient(s).
+   *
+   * @param address - Single address, address object, or array of either.
+   */
   bcc(address) {
     this.envelope.bcc = this.normalizeAddressArray(address);
     return this;
   }
+  /**
+   * Set the reply-to address.
+   *
+   * @param address - Email address or Address object.
+   */
   replyTo(address) {
     this.envelope.replyTo = typeof address === "string" ? { address } : address;
     return this;
   }
+  /**
+   * Set the subject line for the email.
+   *
+   * @param subject - The email subject.
+   */
   subject(subject) {
     this.envelope.subject = subject;
     return this;
   }
+  /**
+   * Set the email priority.
+   *
+   * @param level - Priority level ('high', 'normal', or 'low').
+   */
   emailPriority(level) {
     this.envelope.priority = level;
     return this;
   }
+  /**
+   * Attach a file to the email.
+   *
+   * @param attachment - Attachment configuration object.
+   */
   attach(attachment) {
     this.envelope.attachments = this.envelope.attachments || [];
     this.envelope.attachments.push(attachment);
@@ -129,6 +169,8 @@ var Mailable = class {
   // ===== Content Methods (Renderer Selection) =====
   /**
    * Set the content using raw HTML string.
+   *
+   * @param content - The HTML content string.
    */
   html(content) {
     this.renderer = new HtmlRenderer(content);
@@ -136,8 +178,9 @@ var Mailable = class {
   }
   /**
    * Set the content using an OrbitPrism template.
-   * @param template Template name (relative to viewsDir/emails)
-   * @param data Data to pass to the template
+   *
+   * @param template - Template name (relative to viewsDir/emails).
+   * @param data - Optional data to pass to the template.
    */
   view(template, data) {
     this.renderer = new TemplateRenderer(template, void 0);
@@ -147,10 +190,14 @@ var Mailable = class {
   /**
    * Set the content using a React component.
    * Dynamically imports ReactRenderer to avoid hard dependency errors if React is not installed.
+   *
+   * @param component - The React component to render.
+   * @param props - Optional props for the component.
+   * @param deps - Optional dependencies (React, ReactDOMServer) if not globally available.
    */
   react(component, props, deps) {
     this.rendererResolver = async () => {
-      const { ReactRenderer } = await import("./ReactRenderer-CMCAOEPH.mjs");
+      const { ReactRenderer } = await import("./ReactRenderer-KYNA4WKE.mjs");
       return new ReactRenderer(component, props, deps);
     };
     return this;
@@ -158,37 +205,58 @@ var Mailable = class {
   /**
    * Set the content using a Vue component.
    * Dynamically imports VueRenderer to avoid hard dependency errors if Vue is not installed.
+   *
+   * @param component - The Vue component to render.
+   * @param props - Optional props for the component.
+   * @param deps - Optional dependencies (Vue, VueServerRenderer) if not globally available.
    */
   vue(component, props, deps) {
     this.rendererResolver = async () => {
-      const { VueRenderer } = await import("./VueRenderer-DWTCD2RF.mjs");
+      const { VueRenderer } = await import("./VueRenderer-IIR5SYTM.mjs");
       return new VueRenderer(component, props, deps);
     };
     return this;
   }
   // ===== Queueable Implementation =====
+  /** The name of the queue to push this mailable to. */
   queueName;
+  /** The connection name for the queue. */
   connectionName;
+  /** Delay in seconds before the message is sent. */
   delaySeconds;
+  /** Priority of the message in the queue. */
   priority;
+  /**
+   * Set the queue name for this mailable.
+   */
   onQueue(queue) {
     this.queueName = queue;
     return this;
   }
+  /**
+   * Set the connection name for this mailable.
+   */
   onConnection(connection) {
     this.connectionName = connection;
     return this;
   }
+  /**
+   * Set a delay for the queued mailable.
+   */
   delay(seconds) {
     this.delaySeconds = seconds;
     return this;
   }
+  /**
+   * Set the priority for the queued mailable.
+   */
   withPriority(priority) {
     this.priority = priority;
     return this;
   }
   /**
    * Queue the mailable for sending.
+   * Attempts to resolve the mail service from the PlanetCore container.
    */
   async queue() {
     try {
@@ -206,6 +274,8 @@ var Mailable = class {
   translator;
   /**
    * Set the locale for the message.
+   *
+   * @param locale - Valid locale string (e.g., 'en', 'zh-TW').
    */
   locale(locale) {
     this.currentLocale = locale;
@@ -213,12 +283,17 @@ var Mailable = class {
   }
   /**
    * Internal: Set the translator function (called by OrbitSignal)
+   * @internal
    */
   setTranslator(translator) {
     this.translator = translator;
   }
   /**
    * Translate a string using the configured translator.
+   *
+   * @param key - Translation key.
+   * @param replace - Interpolation variables.
+   * @returns Translated string or the key if translator is missing.
    */
   t(key, replace) {
     if (this.translator) {
@@ -229,6 +304,7 @@ var Mailable = class {
   // ===== Internal Systems =====
   /**
    * Compile the envelope based on config defaults and mailable settings.
+   * Called by OrbitSignal before rendering/sending.
    */
   async buildEnvelope(configPromise) {
     const config = await Promise.resolve(configPromise);
@@ -261,7 +337,8 @@ var Mailable = class {
     return envelope;
   }
   /**
-   * execute the renderer
+   * Execute the renderer and produce HTML/Text content.
+   * @returns Object containing rendered html and optional text content.
    */
   async renderContent() {
     if (!this.renderer && this.rendererResolver) {
@@ -650,7 +727,7 @@ var OrbitSignal = class {
       });
       devServer.register(core);
     }
-    core.container.singleton("mail", () => this);
+    core.container.instance("mail", this);
     core.adapter.use("*", async (c, next) => {
       c.set("mail", this);
       return await next();
@@ -658,10 +735,6 @@ var OrbitSignal = class {
   }
   /**
    * Send a mailable instance
-   *
-   * @param mailable - The mailable object to send.
-   * @returns A promise that resolves when the email is sent.
-   * @throws {Error} If the message is missing "from" or "to" addresses, or if no transport is configured.
    */
   async send(mailable) {
     const envelope = await mailable.buildEnvelope(this.config);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gravito/signal",
-  "version": "3.0.0",
+  "version": "3.0.3",
   "description": "Powerful email framework for Gravito applications with Dev UI and multi-renderer support.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",