@tratto/email 1.0.0 → 1.1.0

package/README.md

@@ -34,6 +34,22 @@ const { id } = await tratto.emails.send({
 console.log('Sent email:', id);
 ```
 
+Or write the email in [emailmd](https://www.emailmd.dev/) markdown — the API
+renders it into responsive, email-safe HTML (plus a text part) server-side:
+
+```ts
+await tratto.emails.send({
+  from: 'Acme <hello@mail.acme.com>',
+  to: 'user@example.com',
+  subject: 'Welcome!',
+  markdown: '# Welcome, {{firstName}}\n\nGlad to have you on board.',
+});
+```
+
+`markdown` is mutually exclusive with `html`. Templates accept it too:
+`templates.create({ name, markdown })` creates a `format: 'emailmd'` template
+whose HTML is rendered and pinned at save time.
+
 ---
 
 ## Setup

package/dist/index.d.mts

@@ -32,6 +32,12 @@ interface SendEmailParams {
     to: string | string[];
     subject: string;
     html?: string;
+    /**
+     * emailmd markdown, rendered server-side into responsive email HTML
+     * (plus a text part). Mutually exclusive with `html` — the API rejects
+     * requests carrying both.
+     */
+    markdown?: string;
     text?: string;
     cc?: string[];
     bcc?: string[];
@@ -199,6 +205,7 @@ interface ListCampaignsParams {
 interface SendCampaignParams {
     scheduledAt?: Date | string;
 }
+type TemplateFormat = 'html' | 'emailmd';
 type TemplateStatus = 'draft' | 'published';
 interface TemplateSummary {
     id: string;
@@ -209,15 +216,29 @@ interface TemplateSummary {
     updatedAt: string;
 }
 interface Template extends TemplateSummary {
+    /** Always the pinned, ready-to-send HTML — for emailmd templates it is derived from `source`. */
     html: string;
+    /** 'html' for templates created before formats existed. Immutable after creation. */
+    format: TemplateFormat;
+    /** The markdown source of truth for emailmd templates. */
+    source?: string;
+    renderWarnings?: string[];
 }
 interface CreateTemplateParams {
     name: string;
     html?: string;
+    /**
+     * emailmd markdown source. Creates a `format: 'emailmd'` template whose
+     * HTML is rendered server-side at save time. Mutually exclusive with
+     * `html` — sending both (or `html` on an emailmd template) is rejected.
+     */
+    markdown?: string;
 }
 interface UpdateTemplateParams {
     name?: string;
     html?: string;
+    /** New markdown source for an emailmd template (re-rendered at save). */
+    markdown?: string;
     status?: TemplateStatus;
 }
 interface ListTemplatesParams {
@@ -350,6 +371,20 @@ interface Workspace {
     timezone: string;
     locale: WorkspaceLocale;
     plan: WorkspacePlan;
+    /** Workspace default sender, used when a send does not specify one. */
+    defaultFromName: string | null;
+    defaultFromEmail: string | null;
+    /**
+     * Tenant-hosted unsubscribe/preference page. When set, {{unsubscribe_url}}
+     * resolves here instead of the Tratto-hosted page.
+     */
+    customUnsubscribeUrl: string | null;
+    /**
+     * Keep the "Sent using Tratto" branded footer on every HTML send even on a
+     * paid plan. On the free plan the branded footer is always applied
+     * regardless of this flag.
+     */
+    keepTrattoBranding: boolean;
     createdAt: string;
 }
 interface WorkspaceMember {
@@ -372,6 +407,16 @@ interface UpdateWorkspaceParams {
     slug?: string;
     timezone?: string;
     locale?: WorkspaceLocale;
+    defaultFromName?: string;
+    defaultFromEmail?: string;
+    /** Set to null to clear and fall back to the Tratto-hosted page. */
+    customUnsubscribeUrl?: string | null;
+    /**
+     * Opt in to keep the branded footer on paid plans. Accepted on any plan
+     * (no effect on free, where branding is mandatory) and never auto-reset
+     * by plan changes.
+     */
+    keepTrattoBranding?: boolean;
 }
 interface UpdateWorkspacePreferencesParams {
     locale?: WorkspaceLocale;

package/dist/index.d.ts

@@ -32,6 +32,12 @@ interface SendEmailParams {
     to: string | string[];
     subject: string;
     html?: string;
+    /**
+     * emailmd markdown, rendered server-side into responsive email HTML
+     * (plus a text part). Mutually exclusive with `html` — the API rejects
+     * requests carrying both.
+     */
+    markdown?: string;
     text?: string;
     cc?: string[];
     bcc?: string[];
@@ -199,6 +205,7 @@ interface ListCampaignsParams {
 interface SendCampaignParams {
     scheduledAt?: Date | string;
 }
+type TemplateFormat = 'html' | 'emailmd';
 type TemplateStatus = 'draft' | 'published';
 interface TemplateSummary {
     id: string;
@@ -209,15 +216,29 @@ interface TemplateSummary {
     updatedAt: string;
 }
 interface Template extends TemplateSummary {
+    /** Always the pinned, ready-to-send HTML — for emailmd templates it is derived from `source`. */
     html: string;
+    /** 'html' for templates created before formats existed. Immutable after creation. */
+    format: TemplateFormat;
+    /** The markdown source of truth for emailmd templates. */
+    source?: string;
+    renderWarnings?: string[];
 }
 interface CreateTemplateParams {
     name: string;
     html?: string;
+    /**
+     * emailmd markdown source. Creates a `format: 'emailmd'` template whose
+     * HTML is rendered server-side at save time. Mutually exclusive with
+     * `html` — sending both (or `html` on an emailmd template) is rejected.
+     */
+    markdown?: string;
 }
 interface UpdateTemplateParams {
     name?: string;
     html?: string;
+    /** New markdown source for an emailmd template (re-rendered at save). */
+    markdown?: string;
     status?: TemplateStatus;
 }
 interface ListTemplatesParams {
@@ -350,6 +371,20 @@ interface Workspace {
     timezone: string;
     locale: WorkspaceLocale;
     plan: WorkspacePlan;
+    /** Workspace default sender, used when a send does not specify one. */
+    defaultFromName: string | null;
+    defaultFromEmail: string | null;
+    /**
+     * Tenant-hosted unsubscribe/preference page. When set, {{unsubscribe_url}}
+     * resolves here instead of the Tratto-hosted page.
+     */
+    customUnsubscribeUrl: string | null;
+    /**
+     * Keep the "Sent using Tratto" branded footer on every HTML send even on a
+     * paid plan. On the free plan the branded footer is always applied
+     * regardless of this flag.
+     */
+    keepTrattoBranding: boolean;
     createdAt: string;
 }
 interface WorkspaceMember {
@@ -372,6 +407,16 @@ interface UpdateWorkspaceParams {
     slug?: string;
     timezone?: string;
     locale?: WorkspaceLocale;
+    defaultFromName?: string;
+    defaultFromEmail?: string;
+    /** Set to null to clear and fall back to the Tratto-hosted page. */
+    customUnsubscribeUrl?: string | null;
+    /**
+     * Opt in to keep the branded footer on paid plans. Accepted on any plan
+     * (no effect on free, where branding is mandatory) and never auto-reset
+     * by plan changes.
+     */
+    keepTrattoBranding?: boolean;
 }
 interface UpdateWorkspacePreferencesParams {
     locale?: WorkspaceLocale;

package/dist/index.js

@@ -212,7 +212,8 @@ var TemplatesResource = class extends BaseResource {
     return this.fetch("GET", `/v1/templates${qs}`);
   }
   create(params) {
-    return this.fetchData("POST", "/v1/templates", { body: params });
+    const body = params.markdown !== void 0 ? { ...params, format: "emailmd" } : params;
+    return this.fetchData("POST", "/v1/templates", { body });
   }
   get(id) {
     return this.fetchData("GET", `/v1/templates/${id}`);

package/dist/index.mjs

@@ -185,7 +185,8 @@ var TemplatesResource = class extends BaseResource {
     return this.fetch("GET", `/v1/templates${qs}`);
   }
   create(params) {
-    return this.fetchData("POST", "/v1/templates", { body: params });
+    const body = params.markdown !== void 0 ? { ...params, format: "emailmd" } : params;
+    return this.fetchData("POST", "/v1/templates", { body });
   }
   get(id) {
     return this.fetchData("GET", `/v1/templates/${id}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tratto/email",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Tratto Node.js SDK \u2014 send transactional and marketing email",
   "author": "Tratto <hello@tratto.email>",
   "license": "MIT",