@tratto/email 1.1.0 → 1.1.1

package/README.md

@@ -281,6 +281,16 @@ await tratto.templates.testSend(tpl.id, 'me@example.com', { name: 'Alice' });
 await tratto.templates.delete(tpl.id);
 ```
 
+Templates created from `markdown` come back with `format: 'emailmd'`, the
+markdown in `source`, the rendered HTML in `html`, and — when part of the
+markdown could not be rendered — a `renderWarnings: string[]` array on the
+template object. The field is absent when there is nothing to report:
+
+```ts
+const tpl = await tratto.templates.create({ name: 'Welcome', markdown: '# Hi {{name}}' });
+if (tpl.renderWarnings?.length) console.warn(tpl.renderWarnings);
+```
+
 ---
 
 ### Webhooks
@@ -342,7 +352,9 @@ console.log('Open rate:', summary.openRate);
 const points = await tratto.analytics.getTimeseries('7d');
 ```
 
-Supported periods: `'7d'` | `'30d'` | `'90d'`. Results are cached server-side for 1 hour.
+Supported periods: `'7d'` | `'30d'` | `'90d'` | `'180d'` | `'1y'` (default `'30d'`).
+`'180d'` and `'1y'` read the long-term aggregate, which holds live data only:
+they are rejected for test-mode keys. Results are cached server-side for 1 hour.
 
 ---
 
@@ -434,8 +446,6 @@ import type {
   Template,
   Webhook,
   Domain,
-  ApiKey,
-  ApiKeyCreated,
   AnalyticsSummary,
   TimeseriesPoint,
   Flow,

package/dist/index.d.mts

@@ -176,6 +176,14 @@ interface Campaign {
     sentAt: string | null;
     stats: CampaignStats;
     createdAt: string;
+    /**
+     * The editable markdown of an emailmd campaign (its own copy — editing it
+     * never touches the template). Returned by `get()` only: `list()` omits
+     * `source` and `renderWarnings` to keep the payload small.
+     */
+    source?: string;
+    /** Markdown that could not be rendered. Returned by `get()` only, absent when empty. */
+    renderWarnings?: string[];
 }
 interface CampaignStatsDetail {
     campaignId: string;
@@ -306,7 +314,8 @@ interface ListDomainsParams {
     after?: string;
     limit?: number;
 }
-type AnalyticsPeriod = '7d' | '30d' | '90d';
+/** `'180d'` and `'1y'` read the long-term aggregate (live data only) and are rejected for test-mode keys. */
+type AnalyticsPeriod = '7d' | '30d' | '90d' | '180d' | '1y';
 interface AnalyticsSummary {
     period: AnalyticsPeriod;
     totalSent: number;

package/dist/index.d.ts

@@ -176,6 +176,14 @@ interface Campaign {
     sentAt: string | null;
     stats: CampaignStats;
     createdAt: string;
+    /**
+     * The editable markdown of an emailmd campaign (its own copy — editing it
+     * never touches the template). Returned by `get()` only: `list()` omits
+     * `source` and `renderWarnings` to keep the payload small.
+     */
+    source?: string;
+    /** Markdown that could not be rendered. Returned by `get()` only, absent when empty. */
+    renderWarnings?: string[];
 }
 interface CampaignStatsDetail {
     campaignId: string;
@@ -306,7 +314,8 @@ interface ListDomainsParams {
     after?: string;
     limit?: number;
 }
-type AnalyticsPeriod = '7d' | '30d' | '90d';
+/** `'180d'` and `'1y'` read the long-term aggregate (live data only) and are rejected for test-mode keys. */
+type AnalyticsPeriod = '7d' | '30d' | '90d' | '180d' | '1y';
 interface AnalyticsSummary {
     period: AnalyticsPeriod;
     totalSent: number;

package/dist/index.js

@@ -36,6 +36,9 @@ var TrattoError = class extends Error {
   }
 };
 
+// package.json
+var version = "1.1.1";
+
 // src/resources/base.ts
 var BaseResource = class {
   constructor(apiKey, baseUrl) {
@@ -47,7 +50,7 @@ var BaseResource = class {
     const contentType = options?.contentType ?? (hasBody ? "application/json" : void 0);
     const headers = {
       Authorization: `Bearer ${this.apiKey}`,
-      "User-Agent": "@tratto/email/0.1.0",
+      "User-Agent": `@tratto/email/${version}`,
       ...contentType ? { "Content-Type": contentType } : {},
       ...options?.headers
     };
@@ -227,8 +230,8 @@ var TemplatesResource = class extends BaseResource {
   listVersions(id) {
     return this.fetchData("GET", `/v1/templates/${id}/versions`);
   }
-  getVersion(id, version) {
-    return this.fetchData("GET", `/v1/templates/${id}/versions/${version}`);
+  getVersion(id, version2) {
+    return this.fetchData("GET", `/v1/templates/${id}/versions/${version2}`);
   }
   testSend(id, to, variables = {}) {
     return this.fetchData(

package/dist/index.mjs

@@ -9,6 +9,9 @@ var TrattoError = class extends Error {
   }
 };
 
+// package.json
+var version = "1.1.1";
+
 // src/resources/base.ts
 var BaseResource = class {
   constructor(apiKey, baseUrl) {
@@ -20,7 +23,7 @@ var BaseResource = class {
     const contentType = options?.contentType ?? (hasBody ? "application/json" : void 0);
     const headers = {
       Authorization: `Bearer ${this.apiKey}`,
-      "User-Agent": "@tratto/email/0.1.0",
+      "User-Agent": `@tratto/email/${version}`,
       ...contentType ? { "Content-Type": contentType } : {},
       ...options?.headers
     };
@@ -200,8 +203,8 @@ var TemplatesResource = class extends BaseResource {
   listVersions(id) {
     return this.fetchData("GET", `/v1/templates/${id}/versions`);
   }
-  getVersion(id, version) {
-    return this.fetchData("GET", `/v1/templates/${id}/versions/${version}`);
+  getVersion(id, version2) {
+    return this.fetchData("GET", `/v1/templates/${id}/versions/${version2}`);
   }
   testSend(id, to, variables = {}) {
     return this.fetchData(

package/package.json

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