@tratto/email 0.1.0 → 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tratto
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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
@@ -51,6 +67,45 @@ const tratto = new Tratto(apiKey, options?);
 
 ---
 
+## Test mode
+
+Every workspace can create **test API keys** (`tratto_test_…`) alongside live ones. A test key runs the exact same pipeline — statuses, email timeline, webhooks — but **nothing is actually delivered**: no domain verification needed, no monthly quota consumed (test sends have their own daily cap).
+
+```ts
+const tratto = new Tratto('tratto_test_...');
+
+// Works immediately, even with an unverified sender domain
+const { id, livemode } = await tratto.emails.send({
+  from: 'Acme <hello@any-domain.dev>',
+  to: 'delivered@simulator.tratto.email',
+  subject: 'Hello from test mode',
+  html: '<p>It works!</p>',
+});
+// livemode === false
+```
+
+### Simulator addresses
+
+The recipient address picks the outcome (any other address simulates a normal delivery):
+
+| Recipient | Outcome |
+|---|---|
+| `delivered@simulator.tratto.email` | `delivered` event |
+| `bounced@simulator.tratto.email` | permanent bounce → email ends `failed` |
+| `soft-bounced@simulator.tratto.email` | transient bounce |
+| `complained@simulator.tratto.email` | spam complaint event |
+
+### What to expect
+
+- Responses and webhook payloads carry `livemode: false` so your integration can tell test traffic apart.
+- A test key only ever sees test data: listing or fetching emails created with a live key returns 404/empty, and vice versa.
+- Test emails are retained for 7 days.
+- Endpoints that reach real recipients (campaign send, template test-send, flow activation) reject test keys with `403 TEST_MODE_NOT_SUPPORTED`.
+
+Switching to production is a one-line change: swap the key for a `tratto_live_…` one (verified sender domain required).
+
+---
+
 ## API Reference
 
 All methods return `Promise<T>`. Use `async/await` or `.then()`.
@@ -276,26 +331,6 @@ const { deletedAt } = await tratto.domains.delete(domain.id);
 
 ---
 
-### API Keys
-
-```ts
-// Create — raw key is shown only once
-const key = await tratto.apiKeys.create({
-  name: 'CI deployment key',
-  env: 'live',
-  permissions: ['emails:send'],
-});
-console.log('Raw key (save this!):', key.key);
-
-// List (prefix only, never raw token)
-const { data } = await tratto.apiKeys.list();
-
-// Revoke
-const { revokedAt } = await tratto.apiKeys.revoke(key.id);
-```
-
----
-
 ### Analytics
 
 ```ts
@@ -422,6 +457,9 @@ See the [`examples/`](examples/) folder:
 | [`campaign.ts`](examples/campaign.ts) | Create, configure, and send a marketing campaign |
 | [`analytics.ts`](examples/analytics.ts) | Fetch delivery metrics and daily timeseries |
 | [`webhook.ts`](examples/webhook.ts) | Register a webhook and inspect delivery history |
+| [`nextjs.ts`](examples/nextjs.ts) | Next.js App Router route handler sending a welcome email |
+| [`express.ts`](examples/express.ts) | Express route sending a password-reset email |
+| [`fastify.ts`](examples/fastify.ts) | Fastify route sending an order-confirmation email via template |
 
 Run any example with [tsx](https://github.com/privatenumber/tsx):
 

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 {
@@ -285,29 +306,6 @@ interface ListDomainsParams {
     after?: string;
     limit?: number;
 }
-type ApiKeyEnv = 'live' | 'test';
-interface ApiKey {
-    id: string;
-    name: string;
-    prefix: string;
-    env: ApiKeyEnv;
-    permissions: string[];
-    createdAt: string;
-    lastUsedAt: string | null;
-    revokedAt: string | null;
-}
-interface ApiKeyCreated extends ApiKey {
-    key: string;
-}
-interface CreateApiKeyParams {
-    name: string;
-    env: ApiKeyEnv;
-    permissions: string[];
-}
-interface ListApiKeysParams {
-    after?: string;
-    limit?: number;
-}
 type AnalyticsPeriod = '7d' | '30d' | '90d';
 interface AnalyticsSummary {
     period: AnalyticsPeriod;
@@ -373,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 {
@@ -395,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;
@@ -503,15 +525,6 @@ declare class DomainsResource extends BaseResource {
     }>;
 }
 
-declare class ApiKeysResource extends BaseResource {
-    create(params: CreateApiKeyParams, idempotencyKey?: string): Promise<ApiKeyCreated>;
-    list(params?: ListApiKeysParams): Promise<PaginatedResponse<ApiKey>>;
-    revoke(id: string): Promise<{
-        id: string;
-        revokedAt: string;
-    }>;
-}
-
 declare class AnalyticsResource extends BaseResource {
     getSummary(period?: AnalyticsPeriod): Promise<AnalyticsSummary>;
     getTimeseries(period?: AnalyticsPeriod): Promise<TimeseriesPoint[]>;
@@ -552,11 +565,10 @@ declare class Tratto {
     readonly templates: TemplatesResource;
     readonly webhooks: WebhooksResource;
     readonly domains: DomainsResource;
-    readonly apiKeys: ApiKeysResource;
     readonly analytics: AnalyticsResource;
     readonly flows: FlowsResource;
     readonly workspace: WorkspaceResource;
     constructor(apiKey: string, options?: TrattoOptions);
 }
 
-export { type AddContactsToAudienceResult, type AnalyticsPeriod, type AnalyticsSummary, type ApiKey, type ApiKeyCreated, type ApiKeyEnv, type Audience, type AudienceRule, type AudienceRuleOperator, type Campaign, type CampaignStats, type CampaignStatsDetail, type CampaignStatus, type Contact, type ContactStatus, type CreateApiKeyParams, type CreateAudienceParams, type CreateCampaignParams, type CreateContactParams, type CreateFlowParams, type CreateTemplateParams, type CreateWebhookParams, type Domain, type DomainRecord, type DomainStatus, type DomainSummary, type EmailDetail, type EmailEvent, type EmailSummary, type Flow, type FlowStatus, type FlowStep, type FlowStepType, type FlowTrigger, type FlowTriggerType, type ImportJobStatus, type InviteMemberParams, type ListApiKeysParams, type ListAudiencesParams, type ListCampaignsParams, type ListContactsParams, type ListDomainsParams, type ListEmailsParams, type ListFlowsParams, type ListTemplatesParams, type ListWebhookDeliveriesParams, type PaginatedResponse, type Pagination, type SendCampaignParams, type SendEmailParams, type Template, type TemplateStatus, type TemplateSummary, type TemplateVersion, type TemplateVersionSummary, type TimeseriesPoint, Tratto, TrattoError, type TrattoOptions, type UpdateContactParams, type UpdateFlowParams, type UpdateMemberParams, type UpdateTemplateParams, type UpdateWorkspaceParams, type UpdateWorkspacePreferencesParams, type Webhook, type WebhookDelivery, type WebhookDeliveryStatus, type WebhookEventType, type WebhookStatus, type Workspace, type WorkspaceLocale, type WorkspaceMember, type WorkspaceMemberRole, type WorkspacePlan, type WorkspacePreferences };
+export { type AddContactsToAudienceResult, type AnalyticsPeriod, type AnalyticsSummary, type Audience, type AudienceRule, type AudienceRuleOperator, type Campaign, type CampaignStats, type CampaignStatsDetail, type CampaignStatus, type Contact, type ContactStatus, type CreateAudienceParams, type CreateCampaignParams, type CreateContactParams, type CreateFlowParams, type CreateTemplateParams, type CreateWebhookParams, type Domain, type DomainRecord, type DomainStatus, type DomainSummary, type EmailDetail, type EmailEvent, type EmailSummary, type Flow, type FlowStatus, type FlowStep, type FlowStepType, type FlowTrigger, type FlowTriggerType, type ImportJobStatus, type InviteMemberParams, type ListAudiencesParams, type ListCampaignsParams, type ListContactsParams, type ListDomainsParams, type ListEmailsParams, type ListFlowsParams, type ListTemplatesParams, type ListWebhookDeliveriesParams, type PaginatedResponse, type Pagination, type SendCampaignParams, type SendEmailParams, type Template, type TemplateStatus, type TemplateSummary, type TemplateVersion, type TemplateVersionSummary, type TimeseriesPoint, Tratto, TrattoError, type TrattoOptions, type UpdateContactParams, type UpdateFlowParams, type UpdateMemberParams, type UpdateTemplateParams, type UpdateWorkspaceParams, type UpdateWorkspacePreferencesParams, type Webhook, type WebhookDelivery, type WebhookDeliveryStatus, type WebhookEventType, type WebhookStatus, type Workspace, type WorkspaceLocale, type WorkspaceMember, type WorkspaceMemberRole, type WorkspacePlan, type WorkspacePreferences };

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 {
@@ -285,29 +306,6 @@ interface ListDomainsParams {
     after?: string;
     limit?: number;
 }
-type ApiKeyEnv = 'live' | 'test';
-interface ApiKey {
-    id: string;
-    name: string;
-    prefix: string;
-    env: ApiKeyEnv;
-    permissions: string[];
-    createdAt: string;
-    lastUsedAt: string | null;
-    revokedAt: string | null;
-}
-interface ApiKeyCreated extends ApiKey {
-    key: string;
-}
-interface CreateApiKeyParams {
-    name: string;
-    env: ApiKeyEnv;
-    permissions: string[];
-}
-interface ListApiKeysParams {
-    after?: string;
-    limit?: number;
-}
 type AnalyticsPeriod = '7d' | '30d' | '90d';
 interface AnalyticsSummary {
     period: AnalyticsPeriod;
@@ -373,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 {
@@ -395,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;
@@ -503,15 +525,6 @@ declare class DomainsResource extends BaseResource {
     }>;
 }
 
-declare class ApiKeysResource extends BaseResource {
-    create(params: CreateApiKeyParams, idempotencyKey?: string): Promise<ApiKeyCreated>;
-    list(params?: ListApiKeysParams): Promise<PaginatedResponse<ApiKey>>;
-    revoke(id: string): Promise<{
-        id: string;
-        revokedAt: string;
-    }>;
-}
-
 declare class AnalyticsResource extends BaseResource {
     getSummary(period?: AnalyticsPeriod): Promise<AnalyticsSummary>;
     getTimeseries(period?: AnalyticsPeriod): Promise<TimeseriesPoint[]>;
@@ -552,11 +565,10 @@ declare class Tratto {
     readonly templates: TemplatesResource;
     readonly webhooks: WebhooksResource;
     readonly domains: DomainsResource;
-    readonly apiKeys: ApiKeysResource;
     readonly analytics: AnalyticsResource;
     readonly flows: FlowsResource;
     readonly workspace: WorkspaceResource;
     constructor(apiKey: string, options?: TrattoOptions);
 }
 
-export { type AddContactsToAudienceResult, type AnalyticsPeriod, type AnalyticsSummary, type ApiKey, type ApiKeyCreated, type ApiKeyEnv, type Audience, type AudienceRule, type AudienceRuleOperator, type Campaign, type CampaignStats, type CampaignStatsDetail, type CampaignStatus, type Contact, type ContactStatus, type CreateApiKeyParams, type CreateAudienceParams, type CreateCampaignParams, type CreateContactParams, type CreateFlowParams, type CreateTemplateParams, type CreateWebhookParams, type Domain, type DomainRecord, type DomainStatus, type DomainSummary, type EmailDetail, type EmailEvent, type EmailSummary, type Flow, type FlowStatus, type FlowStep, type FlowStepType, type FlowTrigger, type FlowTriggerType, type ImportJobStatus, type InviteMemberParams, type ListApiKeysParams, type ListAudiencesParams, type ListCampaignsParams, type ListContactsParams, type ListDomainsParams, type ListEmailsParams, type ListFlowsParams, type ListTemplatesParams, type ListWebhookDeliveriesParams, type PaginatedResponse, type Pagination, type SendCampaignParams, type SendEmailParams, type Template, type TemplateStatus, type TemplateSummary, type TemplateVersion, type TemplateVersionSummary, type TimeseriesPoint, Tratto, TrattoError, type TrattoOptions, type UpdateContactParams, type UpdateFlowParams, type UpdateMemberParams, type UpdateTemplateParams, type UpdateWorkspaceParams, type UpdateWorkspacePreferencesParams, type Webhook, type WebhookDelivery, type WebhookDeliveryStatus, type WebhookEventType, type WebhookStatus, type Workspace, type WorkspaceLocale, type WorkspaceMember, type WorkspaceMemberRole, type WorkspacePlan, type WorkspacePreferences };
+export { type AddContactsToAudienceResult, type AnalyticsPeriod, type AnalyticsSummary, type Audience, type AudienceRule, type AudienceRuleOperator, type Campaign, type CampaignStats, type CampaignStatsDetail, type CampaignStatus, type Contact, type ContactStatus, type CreateAudienceParams, type CreateCampaignParams, type CreateContactParams, type CreateFlowParams, type CreateTemplateParams, type CreateWebhookParams, type Domain, type DomainRecord, type DomainStatus, type DomainSummary, type EmailDetail, type EmailEvent, type EmailSummary, type Flow, type FlowStatus, type FlowStep, type FlowStepType, type FlowTrigger, type FlowTriggerType, type ImportJobStatus, type InviteMemberParams, type ListAudiencesParams, type ListCampaignsParams, type ListContactsParams, type ListDomainsParams, type ListEmailsParams, type ListFlowsParams, type ListTemplatesParams, type ListWebhookDeliveriesParams, type PaginatedResponse, type Pagination, type SendCampaignParams, type SendEmailParams, type Template, type TemplateStatus, type TemplateSummary, type TemplateVersion, type TemplateVersionSummary, type TimeseriesPoint, Tratto, TrattoError, type TrattoOptions, type UpdateContactParams, type UpdateFlowParams, type UpdateMemberParams, type UpdateTemplateParams, type UpdateWorkspaceParams, type UpdateWorkspacePreferencesParams, type Webhook, type WebhookDelivery, type WebhookDeliveryStatus, type WebhookEventType, type WebhookStatus, type Workspace, type WorkspaceLocale, type WorkspaceMember, type WorkspaceMemberRole, type WorkspacePlan, type WorkspacePreferences };

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}`);
@@ -288,23 +289,6 @@ var DomainsResource = class extends BaseResource {
   }
 };
 
-// src/resources/api-keys.ts
-var ApiKeysResource = class extends BaseResource {
-  create(params, idempotencyKey) {
-    return this.fetchData("POST", "/v1/api-keys", {
-      body: params,
-      headers: idempotencyKey ? { "Idempotency-Key": idempotencyKey } : void 0
-    });
-  }
-  list(params) {
-    const qs = this.buildQuery({ after: params?.after, limit: params?.limit });
-    return this.fetch("GET", `/v1/api-keys${qs}`);
-  }
-  revoke(id) {
-    return this.fetchData("DELETE", `/v1/api-keys/${id}`);
-  }
-};
-
 // src/resources/analytics.ts
 var AnalyticsResource = class extends BaseResource {
   getSummary(period = "30d") {
@@ -390,7 +374,6 @@ var Tratto = class {
     this.templates = new TemplatesResource(apiKey, baseUrl);
     this.webhooks = new WebhooksResource(apiKey, baseUrl);
     this.domains = new DomainsResource(apiKey, baseUrl);
-    this.apiKeys = new ApiKeysResource(apiKey, baseUrl);
     this.analytics = new AnalyticsResource(apiKey, baseUrl);
     this.flows = new FlowsResource(apiKey, baseUrl);
     this.workspace = new WorkspaceResource(apiKey, baseUrl);

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}`);
@@ -261,23 +262,6 @@ var DomainsResource = class extends BaseResource {
   }
 };
 
-// src/resources/api-keys.ts
-var ApiKeysResource = class extends BaseResource {
-  create(params, idempotencyKey) {
-    return this.fetchData("POST", "/v1/api-keys", {
-      body: params,
-      headers: idempotencyKey ? { "Idempotency-Key": idempotencyKey } : void 0
-    });
-  }
-  list(params) {
-    const qs = this.buildQuery({ after: params?.after, limit: params?.limit });
-    return this.fetch("GET", `/v1/api-keys${qs}`);
-  }
-  revoke(id) {
-    return this.fetchData("DELETE", `/v1/api-keys/${id}`);
-  }
-};
-
 // src/resources/analytics.ts
 var AnalyticsResource = class extends BaseResource {
   getSummary(period = "30d") {
@@ -363,7 +347,6 @@ var Tratto = class {
     this.templates = new TemplatesResource(apiKey, baseUrl);
     this.webhooks = new WebhooksResource(apiKey, baseUrl);
     this.domains = new DomainsResource(apiKey, baseUrl);
-    this.apiKeys = new ApiKeysResource(apiKey, baseUrl);
     this.analytics = new AnalyticsResource(apiKey, baseUrl);
     this.flows = new FlowsResource(apiKey, baseUrl);
     this.workspace = new WorkspaceResource(apiKey, baseUrl);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tratto/email",
-  "version": "0.1.0",
-  "description": "Tratto Node.js SDK — send transactional and marketing email",
+  "version": "1.1.0",
+  "description": "Tratto Node.js SDK \u2014 send transactional and marketing email",
   "author": "Tratto <hello@tratto.email>",
   "license": "MIT",
   "homepage": "https://tratto.email",
@@ -22,7 +22,9 @@
       "require": "./dist/index.js"
     }
   },
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "sideEffects": false,
   "scripts": {
     "build": "tsup src/index.ts --format cjs,esm --dts --clean",
@@ -30,12 +32,17 @@
     "lint": "eslint src --ext .ts",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
-    "test:watch": "vitest"
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
   },
   "devDependencies": {
+    "@types/express": "^5.0.0",
     "@typescript-eslint/eslint-plugin": "^8.0.0",
     "@typescript-eslint/parser": "^8.0.0",
+    "@vitest/coverage-v8": "^2.0.0",
     "eslint": "^9.0.0",
+    "express": "^5.0.0",
+    "fastify": "^5.0.0",
     "tsup": "^8.0.0",
     "typescript": "^5.5.0",
     "vitest": "^2.0.0"