@dbx-tools/email 0.1.18 → 0.1.20

package/README.md

@@ -1,4 +1,4 @@
-# @dbx-tools/node-email
+# @dbx-tools/email
 
 Server-side email runtime, Mastra tool, and AppKit plugin.
 
@@ -24,8 +24,8 @@ Key features:
 
 ```ts
 import { createApp, lakebase, server } from "@databricks/appkit";
-import { plugin as emailPlugin, tool as emailTool } from "@dbx-tools/node-email";
-import { agents, plugin as mastraPlugin } from "@dbx-tools/node-appkit-mastra";
+import { plugin as emailPlugin, tool as emailTool } from "@dbx-tools/email";
+import { agents, plugin as mastraPlugin } from "@dbx-tools/appkit-mastra";
 
 const support = agents.createAgent({
   instructions: "Draft emails, but wait for approval before sending.",
@@ -56,7 +56,7 @@ approval card and compose components.
 ## Send Without An Agent
 
 ```ts
-import { transport } from "@dbx-tools/node-email";
+import { transport } from "@dbx-tools/email";
 
 const result = await transport.sendEmail(
   {
@@ -76,7 +76,7 @@ involved. The same resolved runtime is used by the AppKit plugin and tool.
 ## Resolve SMTP Or Outbox Mode
 
 ```ts
-import { config, transport } from "@dbx-tools/node-email";
+import { config, transport } from "@dbx-tools/email";
 
 const resolved = config.resolveEmailConfig({
   smtp: { host: "smtp.example.com", user: "apikey", password: secret },
@@ -115,7 +115,7 @@ shown, the server can still derive the sender from the active user and config.
 ## Derive And Restrict Senders
 
 ```ts
-import { sender } from "@dbx-tools/node-email";
+import { sender } from "@dbx-tools/email";
 
 const from = sender.resolveSenderAddress({
   userEmail: "alice@databricks.com",
@@ -132,7 +132,7 @@ current user, which is what the AppKit plugin exposes to clients.
 ## Render Markdown Email
 
 ```ts
-import { emailHtml, markdown } from "@dbx-tools/node-email";
+import { emailHtml, markdown } from "@dbx-tools/email";
 
 const html = emailHtml.renderEmailHtml({
   subject: "Incident update",
@@ -147,7 +147,7 @@ the rendered body in the package layout and inlines CSS for mail clients.
 ## Use The Outbox In Tests
 
 ```ts
-import { outbox } from "@dbx-tools/node-email";
+import { outbox } from "@dbx-tools/email";
 
 await outbox.writeOutboxEmail({
   dir: "tmp/email-outbox",

package/package.json

@@ -19,15 +19,15 @@
     "juice": "^12.1.1",
     "marked": "^18.0.5",
     "nodemailer": "^7.0.13",
-    "@dbx-tools/shared-core": "0.1.18",
-    "@dbx-tools/shared-email": "0.1.18"
+    "@dbx-tools/shared-core": "0.1.20",
+    "@dbx-tools/shared-email": "0.1.20"
   },
   "main": "index.ts",
   "license": "UNLICENSED",
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.1.18",
+  "version": "0.1.20",
   "types": "index.ts",
   "type": "module",
   "exports": {

package/src/config.ts

@@ -22,6 +22,7 @@
  */
 import type { BasePluginConfig } from "@databricks/appkit";
 import type { JSONSchema7 } from "json-schema";
+import { object } from "@dbx-tools/shared-core";
 import { resolve } from "node:path";
 import { parseAllowedSenders } from "./sender";
 
@@ -149,15 +150,12 @@ export const EMAIL_CONFIG_SCHEMA: JSONSchema7 = {
 /** Parse the `SMTP_SECURE` env / config flag, defaulting to `port === 465`. */
 function resolveSecure(flag: boolean | undefined, port: number): boolean {
   if (typeof flag === "boolean") return flag;
-  const env = process.env["SMTP_SECURE"];
-  if (env !== undefined) return /^(1|true|yes)$/i.test(env.trim());
-  return port === 465;
+  return object.toBoolean(process.env["SMTP_SECURE"]) ?? port === 465;
 }
 
 /** Whether `EMAIL_OUTBOX_MODE` explicitly opts into the file/outbox fallback. */
 function isOutboxModeEnabled(): boolean {
-  const env = process.env["EMAIL_OUTBOX_MODE"];
-  return env !== undefined && /^(1|true|yes)$/i.test(env.trim());
+  return object.toBoolean(process.env["EMAIL_OUTBOX_MODE"]) ?? false;
 }
 
 const SMTP_REQUIRED_FIELDS = ["SMTP_HOST", "SMTP_USER", "SMTP_PASSWORD"] as const;

package/src/outbox.ts

@@ -12,18 +12,14 @@
  */
 
 import type { EmailMessage } from "@dbx-tools/shared-email";
+import { string } from "@dbx-tools/shared-core";
 import { mkdir, writeFile } from "node:fs/promises";
 import { join, resolve } from "node:path";
 import { renderEmailHtml } from "./email-html";
 
 /** Filesystem-safe slug of the subject for the file name. */
 function subjectSlug(subject: string): string {
-  const slug = subject
-    .trim()
-    .toLowerCase()
-    .replace(/[^a-z0-9]+/g, "-")
-    .replace(/^-+|-+$/g, "");
-  return (slug || "email").slice(0, 48);
+  return string.toSlugWithOptions({ maxLength: 48 }, subject) || "email";
 }
 
 /** The envelope rows shown above the body in the preview file. */

package/src/tool.ts

@@ -36,7 +36,7 @@ export interface EmailToolOptions {
  *
  * @example
  * ```ts
- * import { emailTool } from "@dbx-tools/appkit-email";
+ * import { emailTool } from "@dbx-tools/email";
  * import { createAgent } from "@dbx-tools/appkit-mastra";
  *
  * const support = createAgent({