resend 1.1.0 → 2.0.0-canary.0

package/build/package.json

@@ -1,6 +1,6 @@
 {
     "name": "resend",
-    "version": "1.1.0",
+    "version": "2.0.0-canary.0",
     "description": "Node.js library for the Resend API",
     "main": "build/src/index.js",
     "typings": "build/src/index.d.ts",
@@ -10,7 +10,7 @@
     "engines": {
         "node": ">=18"
     },
-    "packageManager": "yarn@3.6.3",
+    "packageManager": "yarn@3.6.4",
     "scripts": {
         "build": "tsc -p .",
         "test": "jest",
@@ -31,23 +31,20 @@
     },
     "homepage": "https://github.com/resendlabs/resend-node#readme",
     "dependencies": {
-        "@react-email/render": "0.0.7",
-        "type-fest": "3.13.0"
+        "@react-email/render": "0.0.8"
     },
     "devDependencies": {
-        "@types/jest": "29.5.3",
-        "@types/node": "18.17.5",
-        "@types/react": "18.2.20",
-        "@typescript-eslint/eslint-plugin": "6.4.0",
-        "@typescript-eslint/parser": "6.4.0",
-        "eslint": "8.47.0",
-        "fetch-mock": "9.11.0",
-        "jest": "29.6.2",
+        "@types/jest": "29.5.6",
+        "@types/node": "18.18.7",
+        "@types/react": "18.2.33",
+        "@typescript-eslint/eslint-plugin": "6.9.0",
+        "@typescript-eslint/parser": "6.9.0",
+        "eslint": "8.52.0",
+        "jest": "29.7.0",
         "jest-fetch-mock": "3.0.3",
-        "prettier": "3.0.2",
-        "prettier-2": "npm:prettier@2",
-        "supertest": "6.3.3",
+        "prettier": "3.0.3",
         "ts-jest": "29.1.1",
-        "typescript": "5.1.6"
+        "ts-node": "10.9.1",
+        "typescript": "5.2.2"
     }
 }

package/build/src/__snapshots__/resend.spec.js.snap

@@ -0,0 +1,3 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`Resend throws API key error 1`] = `"Missing API key. Pass it to the constructor \`new Resend("re_123")\`"`;

package/build/src/api-keys/api-keys.d.ts

@@ -3,7 +3,7 @@ import { CreateApiKeyOptions, CreateApiKeyRequestOptions, CreateApiKeyResponse,
 export declare class ApiKeys {
     private readonly resend;
     constructor(resend: Resend);
-    create(payload: CreateApiKeyOptions, options?: CreateApiKeyRequestOptions): Promise<CreateApiKeyResponse>;
-    list(): Promise<ListApiKeysResponse>;
+    create(payload: CreateApiKeyOptions, options?: CreateApiKeyRequestOptions): Promise<import("..").ErrorResponse | CreateApiKeyResponse>;
+    list(): Promise<import("..").ErrorResponse | ListApiKeysResponse>;
     remove(id: string): Promise<void>;
 }

package/build/src/api-keys/api-keys.spec.js

@@ -36,11 +36,14 @@ describe('API Keys', () => {
       `);
         }));
         it('throws error when missing name', () => __awaiter(void 0, void 0, void 0, function* () {
-            fetchMock.mockOnce(JSON.stringify({
-                statusCode: 422,
-                name: 'missing_required_field',
-                message: 'Missing "name" field',
-            }), {
+            const errorResponse = {
+                error: {
+                    statusCode: 422,
+                    name: 'missing_required_field',
+                    message: 'Missing "name" field',
+                },
+            };
+            fetchMock.mockOnce(JSON.stringify(errorResponse), {
                 status: 422,
                 headers: {
                     'content-type': 'application/json',
@@ -48,12 +51,14 @@ describe('API Keys', () => {
                 },
             });
             const resend = new resend_1.Resend('re_zKa4RCko_Lhm9ost2YjNCctnPjbLw8Nop');
-            yield expect(resend.apiKeys.create({ name: '' })).resolves
-                .toMatchInlineSnapshot(`
+            const result = resend.apiKeys.create({ name: '' });
+            yield expect(result).resolves.toMatchInlineSnapshot(`
         {
-          "message": "Missing "name" field",
-          "name": "missing_required_field",
-          "statusCode": 422,
+          "error": {
+            "message": "Missing "name" field",
+            "name": "missing_required_field",
+            "statusCode": 422,
+          },
         }
       `);
         }));
@@ -100,11 +105,14 @@ describe('API Keys', () => {
         `);
             }));
             it('throws error with wrong access', () => __awaiter(void 0, void 0, void 0, function* () {
-                fetchMock.mockOnce(JSON.stringify({
-                    statusCode: 422,
-                    name: 'invalid_access',
-                    message: 'Access must be "full_access" | "sending_access"',
-                }), {
+                const errorResponse = {
+                    error: {
+                        statusCode: 422,
+                        name: 'invalid_access',
+                        message: 'Access must be "full_access" | "sending_access"',
+                    },
+                };
+                fetchMock.mockOnce(JSON.stringify(errorResponse), {
                     status: 422,
                     headers: {
                         'content-type': 'application/json',
@@ -115,7 +123,15 @@ describe('API Keys', () => {
                 yield expect(resend.apiKeys.create({
                     name: 'Test',
                     permission: 'wrong_access',
-                })).resolves.toThrowErrorMatchingInlineSnapshot('"Access must be "full_access" | "sending_access""');
+                })).resolves.toMatchInlineSnapshot(`
+          {
+            "error": {
+              "message": "Access must be "full_access" | "sending_access"",
+              "name": "invalid_access",
+              "statusCode": 422,
+            },
+          }
+        `);
             }));
         });
         describe('restricted by domain', () => {
@@ -143,11 +159,14 @@ describe('API Keys', () => {
         `);
             }));
             it('throws error with wrong access', () => __awaiter(void 0, void 0, void 0, function* () {
-                fetchMock.mockOnce(JSON.stringify({
-                    name: 'application_error',
-                    message: 'Something went wrong',
-                    statusCode: 500,
-                }), {
+                const errorResponse = {
+                    error: {
+                        name: 'application_error',
+                        message: 'Something went wrong',
+                        statusCode: 500,
+                    },
+                };
+                fetchMock.mockOnce(JSON.stringify(errorResponse), {
                     status: 500,
                     headers: {
                         'content-type': 'application/json',
@@ -159,7 +178,15 @@ describe('API Keys', () => {
                     name: 'Test',
                     permission: 'sending_access',
                     domain_id: '1234',
-                })).resolves.toThrowErrorMatchingInlineSnapshot('"Something went wrong"');
+                })).resolves.toMatchInlineSnapshot(`
+          {
+            "error": {
+              "message": "Something went wrong",
+              "name": "application_error",
+              "statusCode": 500,
+            },
+          }
+        `);
             }));
         });
     });
@@ -217,11 +244,14 @@ describe('API Keys', () => {
             yield expect(resend.apiKeys.remove('5262504e-8ed7-4fac-bd16-0d4be94bc9f2')).resolves.toMatchInlineSnapshot('undefined');
         }));
         it('throws error when missing id', () => __awaiter(void 0, void 0, void 0, function* () {
-            fetchMock.mockOnce(JSON.stringify({
-                name: 'application_error',
-                message: 'Something went wrong',
-                statusCode: 500,
-            }), {
+            const errorResponse = {
+                error: {
+                    name: 'application_error',
+                    message: 'Something went wrong',
+                    statusCode: 500,
+                },
+            };
+            fetchMock.mockOnce(JSON.stringify(errorResponse), {
                 status: 500,
                 headers: {
                     'content-type': 'application/json',
@@ -229,14 +259,18 @@ describe('API Keys', () => {
                 },
             });
             const resend = new resend_1.Resend('re_zKa4RCko_Lhm9ost2YjNCctnPjbLw8Nop');
-            yield expect(resend.apiKeys.remove('')).resolves.toMatchInlineSnapshot('undefined');
+            const result = resend.apiKeys.remove('');
+            yield expect(result).resolves.toMatchInlineSnapshot('undefined');
         }));
         it('throws error when wrong id', () => __awaiter(void 0, void 0, void 0, function* () {
-            fetchMock.mockOnce(JSON.stringify({
-                name: 'not_found',
-                message: 'API key not found',
-                statusCode: 404,
-            }), {
+            const errorResponse = {
+                error: {
+                    name: 'not_found',
+                    message: 'API key not found',
+                    statusCode: 404,
+                },
+            };
+            fetchMock.mockOnce(JSON.stringify(errorResponse), {
                 status: 404,
                 headers: {
                     'content-type': 'application/json',
@@ -244,7 +278,8 @@ describe('API Keys', () => {
                 },
             });
             const resend = new resend_1.Resend('re_zKa4RCko_Lhm9ost2YjNCctnPjbLw8Nop');
-            yield expect(resend.apiKeys.remove('34bd250e-615a-400c-be11-5912572ee15b')).resolves.toMatchInlineSnapshot('undefined');
+            const result = resend.apiKeys.remove('34bd250e-615a-400c-be11-5912572ee15b');
+            yield expect(result).resolves.toMatchInlineSnapshot('undefined');
         }));
     });
 });

package/build/src/batch/batch.d.ts

@@ -0,0 +1,8 @@
+import { Resend } from '../resend';
+import { CreateBatchOptions, CreateBatchRequestOptions, CreateBatchResponse } from './interfaces';
+export declare class Batch {
+    private readonly resend;
+    constructor(resend: Resend);
+    send(payload: CreateBatchOptions, options?: CreateBatchRequestOptions): Promise<CreateBatchResponse>;
+    create(payload: CreateBatchOptions, options?: CreateBatchRequestOptions): Promise<CreateBatchResponse>;
+}

package/build/src/batch/batch.js

@@ -0,0 +1,36 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Batch = void 0;
+const render_1 = require("@react-email/render");
+class Batch {
+    constructor(resend) {
+        this.resend = resend;
+    }
+    send(payload, options = {}) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.create(payload, options);
+        });
+    }
+    create(payload, options = {}) {
+        return __awaiter(this, void 0, void 0, function* () {
+            for (const email of payload) {
+                if (email.react) {
+                    email.html = (0, render_1.render)(email.react);
+                    delete email.react;
+                }
+            }
+            const data = yield this.resend.post('/emails/batch', payload, options);
+            return data;
+        });
+    }
+}
+exports.Batch = Batch;

package/build/src/batch/batch.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/build/src/batch/batch.spec.js

@@ -0,0 +1,92 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const jest_fetch_mock_1 = require("jest-fetch-mock");
+const resend_1 = require("../resend");
+(0, jest_fetch_mock_1.enableFetchMocks)();
+const resend = new resend_1.Resend('re_zKa4RCko_Lhm9ost2YjNCctnPjbLw8Nop');
+describe('Batch', () => {
+    afterEach(() => fetchMock.resetMocks());
+    describe('create', () => {
+        it('sends multiple emails', () => __awaiter(void 0, void 0, void 0, function* () {
+            const payload = [
+                {
+                    from: 'bu@resend.com',
+                    to: 'zeno@resend.com',
+                    subject: 'Hello World',
+                    html: '<h1>Hello world</h1>',
+                },
+                {
+                    from: 'vitor@resend.com',
+                    to: 'zeno@resend.com',
+                    subject: 'Olá mundo',
+                    html: '<h1>olá mundo</h1>',
+                },
+                {
+                    from: 'bu@resend.com',
+                    to: 'vitor@resend.com',
+                    subject: 'Hi there',
+                    html: '<h1>Hi there</h1>',
+                },
+            ];
+            fetchMock.mockOnce(JSON.stringify({
+                data: [{ id: '1234' }, { id: '4567' }, { id: '4242' }],
+            }), {
+                status: 200,
+                headers: {
+                    'content-type': 'application/json',
+                    Authorization: 'Bearer re_zKa4RCko_Lhm9ost2YjNCctnPjbLw8Nop',
+                },
+            });
+            const data = yield resend.batch.create(payload);
+            expect(data).toMatchObject({
+                data: [{ id: '1234' }, { id: '4567' }, { id: '4242' }],
+            });
+        }));
+    });
+    describe('send', () => {
+        it('sends multiple emails', () => __awaiter(void 0, void 0, void 0, function* () {
+            const payload = [
+                {
+                    from: 'bu@resend.com',
+                    to: 'zeno@resend.com',
+                    subject: 'Hello World',
+                    html: '<h1>Hello world</h1>',
+                },
+                {
+                    from: 'vitor@resend.com',
+                    to: 'zeno@resend.com',
+                    subject: 'Olá mundo',
+                    html: '<h1>olá mundo</h1>',
+                },
+                {
+                    from: 'bu@resend.com',
+                    to: 'vitor@resend.com',
+                    subject: 'Hi there',
+                    html: '<h1>Hi there</h1>',
+                },
+            ];
+            fetchMock.mockOnce(JSON.stringify({
+                data: [{ id: '1234' }, { id: '4567' }, { id: '4242' }],
+            }), {
+                status: 200,
+                headers: {
+                    'content-type': 'application/json',
+                    Authorization: 'Bearer re_zKa4RCko_Lhm9ost2YjNCctnPjbLw8Nop',
+                },
+            });
+            const data = yield resend.batch.send(payload);
+            expect(data).toMatchObject({
+                data: [{ id: '1234' }, { id: '4567' }, { id: '4242' }],
+            });
+        }));
+    });
+});

package/build/src/batch/interfaces/create-batch-options.interface.d.ts

@@ -0,0 +1,14 @@
+import { PostOptions } from '../../common/interfaces';
+import { CreateEmailOptions } from '../../emails/interfaces/create-email-options.interface';
+import { ErrorResponse } from '../../interfaces';
+export type CreateBatchOptions = CreateEmailOptions[];
+export interface CreateBatchRequestOptions extends PostOptions {
+}
+interface CreateBatchSuccessResponse {
+    data: {
+        /** The ID of the newly created email. */
+        id: string;
+    }[];
+}
+export type CreateBatchResponse = CreateBatchSuccessResponse | ErrorResponse;
+export {};

package/build/src/batch/interfaces/create-batch-options.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/src/batch/interfaces/index.d.ts

@@ -0,0 +1 @@
+export * from './create-batch-options.interface';

package/build/src/batch/interfaces/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./create-batch-options.interface"), exports);

package/build/src/domains/domains.d.ts

@@ -4,7 +4,7 @@ export declare class Domains {
     private readonly resend;
     constructor(resend: Resend);
     create(payload: CreateDomainOptions, options?: CreateDomainRequestOptions): Promise<CreateDomainResponse>;
-    list(): Promise<ListDomainsResponse>;
+    list(): Promise<import("..").ErrorResponse | ListDomainsResponse>;
     get(id: string): Promise<GetDomainResponse>;
     remove(id: string): Promise<void>;
     verify(id: string): Promise<void>;

package/build/src/domains/domains.spec.js

@@ -128,11 +128,14 @@ describe('Domains', () => {
       `);
         }));
         it('throws error when missing name', () => __awaiter(void 0, void 0, void 0, function* () {
-            fetchMock.mockOnce(JSON.stringify({
-                statusCode: 422,
-                name: 'missing_required_field',
-                message: 'Missing "name" field',
-            }), {
+            const errorResponse = {
+                error: {
+                    statusCode: 422,
+                    name: 'missing_required_field',
+                    message: 'Missing "name" field',
+                },
+            };
+            fetchMock.mockOnce(JSON.stringify(errorResponse), {
                 status: 422,
                 headers: {
                     'content-type': 'application/json',
@@ -140,14 +143,16 @@ describe('Domains', () => {
                 },
             });
             const resend = new resend_1.Resend('re_zKa4RCko_Lhm9ost2YjNCctnPjbLw8Nop');
-            yield expect(resend.domains.create({ name: '' })).resolves
-                .toMatchInlineSnapshot(`
-          {
+            const result = resend.domains.create({ name: '' });
+            yield expect(result).resolves.toMatchInlineSnapshot(`
+        {
+          "error": {
             "message": "Missing "name" field",
             "name": "missing_required_field",
             "statusCode": 422,
-          }
-        `);
+          },
+        }
+      `);
         }));
         describe('with region', () => {
             it('creates a domain with region', () => __awaiter(void 0, void 0, void 0, function* () {
@@ -256,11 +261,14 @@ describe('Domains', () => {
               `);
             }));
             it('throws error with wrong region', () => __awaiter(void 0, void 0, void 0, function* () {
-                fetchMock.mockOnce(JSON.stringify({
-                    statusCode: 422,
-                    name: 'invalid_region',
-                    message: 'Region must be "us-east-1" | "eu-west-1" | "sa-east-1"',
-                }), {
+                const errorResponse = {
+                    error: {
+                        statusCode: 422,
+                        name: 'invalid_region',
+                        message: 'Region must be "us-east-1" | "eu-west-1" | "sa-east-1"',
+                    },
+                };
+                fetchMock.mockOnce(JSON.stringify(errorResponse), {
                     status: 422,
                     headers: {
                         'content-type': 'application/json',
@@ -268,14 +276,17 @@ describe('Domains', () => {
                     },
                 });
                 const resend = new resend_1.Resend('re_zKa4RCko_Lhm9ost2YjNCctnPjbLw8Nop');
-                yield expect(resend.domains.create({
+                const result = resend.domains.create({
                     name: 'resend.com',
                     region: 'remote',
-                })).resolves.toMatchInlineSnapshot(`
+                });
+                yield expect(result).resolves.toMatchInlineSnapshot(`
           {
-            "message": "Region must be "us-east-1" | "eu-west-1" | "sa-east-1"",
-            "name": "invalid_region",
-            "statusCode": 422,
+            "error": {
+              "message": "Region must be "us-east-1" | "eu-west-1" | "sa-east-1"",
+              "name": "invalid_region",
+              "statusCode": 422,
+            },
           }
         `);
             }));
@@ -333,11 +344,14 @@ describe('Domains', () => {
     describe('get', () => {
         describe('when domain not found', () => {
             it('returns error', () => __awaiter(void 0, void 0, void 0, function* () {
-                fetchMock.mockOnce(JSON.stringify({
-                    name: 'not_found',
-                    message: 'Domain not found',
-                    statusCode: 404,
-                }), {
+                const errorResponse = {
+                    error: {
+                        name: 'not_found',
+                        message: 'Domain not found',
+                        statusCode: 404,
+                    },
+                };
+                fetchMock.mockOnce(JSON.stringify(errorResponse), {
                     status: 404,
                     headers: {
                         'content-type': 'application/json',
@@ -345,12 +359,14 @@ describe('Domains', () => {
                     },
                 });
                 const resend = new resend_1.Resend('re_zKa4RCko_Lhm9ost2YjNCctnPjbLw8Nop');
-                yield expect(resend.domains.get('1234')).resolves
-                    .toMatchInlineSnapshot(`
+                const result = resend.domains.get('1234');
+                yield expect(result).resolves.toMatchInlineSnapshot(`
           {
-            "message": "Domain not found",
-            "name": "not_found",
-            "statusCode": 404,
+            "error": {
+              "message": "Domain not found",
+              "name": "not_found",
+              "statusCode": 404,
+            },
           }
         `);
             }));

package/build/src/domains/interfaces/create-domain-options.interface.d.ts

@@ -1,4 +1,5 @@
 import { PostOptions } from '../../common/interfaces';
+import { ErrorResponse } from '../../interfaces';
 import { DomainRegion, DomainStatus } from './domain';
 export interface CreateDomainOptions {
     name: string;
@@ -28,11 +29,13 @@ export interface DomainDkimRecord {
     priority?: number;
     proxy_status?: 'enable' | 'disable';
 }
-export type CreateDomainResponse = {
+interface CreateDomainResponseSuccess {
     name: string;
     id: string;
     status: DomainStatus;
     created_at: string;
     records: (DomainSpfRecord | DomainDkimRecord)[];
     region: DomainRegion;
-};
+}
+export type CreateDomainResponse = CreateDomainResponseSuccess | ErrorResponse;
+export {};

package/build/src/domains/interfaces/get-domain.interface.d.ts

@@ -1,5 +1,6 @@
+import { ErrorResponse } from '../../interfaces';
 import { DomainRecords, DomainRegion, DomainStatus } from './domain';
-export type GetDomainResponse = {
+interface GetDomainResponseSuccess {
     object: 'domain';
     id: string;
     name: string;
@@ -7,4 +8,6 @@ export type GetDomainResponse = {
     region: DomainRegion;
     status: DomainStatus;
     records: DomainRecords[];
-};
+}
+export type GetDomainResponse = GetDomainResponseSuccess | ErrorResponse;
+export {};

package/build/src/emails/emails.d.ts

@@ -5,5 +5,5 @@ export declare class Emails {
     constructor(resend: Resend);
     send(payload: CreateEmailOptions, options?: CreateEmailRequestOptions): Promise<CreateEmailResponse>;
     create(payload: CreateEmailOptions, options?: CreateEmailRequestOptions): Promise<CreateEmailResponse>;
-    get(id: string): Promise<GetEmailResponse>;
+    get(id: string): Promise<import("..").ErrorResponse | GetEmailResponse>;
 }

package/build/src/emails/emails.spec.js

@@ -68,22 +68,28 @@ describe('Emails', () => {
     describe('get', () => {
         describe('when email not found', () => {
             it('returns error', () => __awaiter(void 0, void 0, void 0, function* () {
-                fetchMock.mockOnce(JSON.stringify({
-                    name: 'not_found',
-                    message: 'Email not found',
-                    statusCode: 404,
-                }), {
+                const errorResponse = {
+                    error: {
+                        name: 'not_found',
+                        message: 'Email not found',
+                        statusCode: 404,
+                    },
+                };
+                fetchMock.mockOnce(JSON.stringify(errorResponse), {
                     status: 404,
                     headers: {
                         'content-type': 'application/json',
                         Authorization: 'Bearer re_zKa4RCko_Lhm9ost2YjNCctnPjbLw8Nop',
                     },
                 });
-                yield expect(resend.emails.get('1234')).resolves.toMatchInlineSnapshot(`
+                const result = resend.emails.get('1234');
+                yield expect(result).resolves.toMatchInlineSnapshot(`
           {
-            "message": "Email not found",
-            "name": "not_found",
-            "statusCode": 404,
+            "error": {
+              "message": "Email not found",
+              "name": "not_found",
+              "statusCode": 404,
+            },
           }
         `);
             }));

package/build/src/emails/interfaces/create-email-options.interface.d.ts

@@ -1,8 +1,31 @@
 /// <reference types="node" />
 import * as React from 'react';
 import { PostOptions } from '../../common/interfaces';
-import { RequireAtLeastOne } from 'type-fest';
-interface CreateEmailBaseOptions {
+import { ErrorResponse } from '../../interfaces';
+type RequireAtLeastOne<T> = {
+    [K in keyof T]-?: Required<Pick<T, K>> & Partial<Pick<T, Exclude<keyof T, K>>>;
+}[keyof T];
+interface EmailRenderOptions {
+    /**
+     * The React component used to write the message.
+     *
+     * @link https://resend.com/api-reference/emails/send-email#body-parameters
+     */
+    react?: React.ReactElement | React.ReactNode | null;
+    /**
+     * The HTML version of the message.
+     *
+     * @link https://resend.com/api-reference/emails/send-email#body-parameters
+     */
+    html?: string;
+    /**
+     * The plain text version of the message.
+     *
+     * @link https://resend.com/api-reference/emails/send-email#body-parameters
+     */
+    text?: string;
+}
+interface CreateEmailBaseOptions extends EmailRenderOptions {
     /**
      * Filename and content of attachments (max 40mb per email)
      *
@@ -33,24 +56,6 @@ interface CreateEmailBaseOptions {
      * @link https://resend.com/docs/api-reference/emails/send-email#body-parameters
      */
     headers?: Record<string, string>;
-    /**
-     * The React component used to write the message.
-     *
-     * @link https://resend.com/docs/api-reference/emails/send-email#body-parameters
-     */
-    react?: React.ReactElement | React.ReactNode | null;
-    /**
-     * The HTML version of the message.
-     *
-     * @link https://resend.com/docs/api-reference/emails/send-email#body-parameters
-     */
-    html?: string;
-    /**
-     * The plain text version of the message.
-     *
-     * @link https://resend.com/docs/api-reference/emails/send-email#body-parameters
-     */
-    text?: string;
     /**
      * Reply-to email address. For multiple addresses, send as an array of strings.
      *
@@ -76,13 +81,14 @@ interface CreateEmailBaseOptions {
      */
     to: string | string[];
 }
-export type CreateEmailOptions = RequireAtLeastOne<CreateEmailBaseOptions, 'react' | 'html' | 'text'>;
+export type CreateEmailOptions = RequireAtLeastOne<EmailRenderOptions> & CreateEmailBaseOptions;
 export interface CreateEmailRequestOptions extends PostOptions {
 }
-export interface CreateEmailResponse {
+interface CreateEmailSuccessResponse {
     /** The ID of the newly created email. */
     id: string;
 }
+export type CreateEmailResponse = CreateEmailSuccessResponse | ErrorResponse;
 interface Attachment {
     /** Content of an attached file. */
     content?: string | Buffer;

package/build/src/error.d.ts

@@ -0,0 +1,8 @@
+import { ErrorResponse, RESEND_ERROR_CODE_KEY, RESEND_ERROR_CODE_NUMBER } from './interfaces';
+export declare class ResendError extends Error {
+    readonly statusCode: RESEND_ERROR_CODE_NUMBER | number;
+    readonly name: RESEND_ERROR_CODE_KEY;
+    constructor(message: string, name: RESEND_ERROR_CODE_KEY, statusCode: RESEND_ERROR_CODE_NUMBER | number);
+    static fromResponse(response: ErrorResponse): ResendError;
+    toString(): string;
+}

package/build/src/error.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResendError = void 0;
+class ResendError extends Error {
+    constructor(message, name, statusCode) {
+        super();
+        this.message = message;
+        this.name = name;
+        this.statusCode = statusCode;
+    }
+    static fromResponse(response) {
+        const { error } = response;
+        return new ResendError(error.message, error.name, error.statusCode);
+    }
+    toString() {
+        return JSON.stringify({
+            message: this.message,
+            name: this.name,
+            statusCode: this.statusCode,
+        }, null, 2);
+    }
+}
+exports.ResendError = ResendError;

package/build/src/guards.d.ts

@@ -0,0 +1,9 @@
+import { ErrorResponse } from './interfaces';
+export declare const isResendErrorResponse: (response: unknown) => response is ErrorResponse;
+/**
+ * Consider whether to use this stricter version of the type guard.
+ *
+ * Right now, it's not used as there is a risk that an API error will not be
+ * caught due to the API being ahead of the current types.
+ */
+export declare const isResendErrorResponseStrict: (response: unknown) => response is ErrorResponse;

package/build/src/guards.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isResendErrorResponseStrict = exports.isResendErrorResponse = void 0;
+const interfaces_1 = require("./interfaces");
+const isResendErrorResponse = (response) => {
+    if (typeof response !== 'object' || response === null) {
+        return false;
+    }
+    const { error } = response;
+    if (typeof error !== 'object' || error === null) {
+        return false;
+    }
+    const { message, statusCode, name } = error;
+    return (typeof message === 'string' &&
+        typeof statusCode === 'number' &&
+        typeof name === 'string');
+};
+exports.isResendErrorResponse = isResendErrorResponse;
+/**
+ * Consider whether to use this stricter version of the type guard.
+ *
+ * Right now, it's not used as there is a risk that an API error will not be
+ * caught due to the API being ahead of the current types.
+ */
+const isResendErrorResponseStrict = (response) => {
+    if (typeof response !== 'object' || response === null) {
+        return false;
+    }
+    const { error } = response;
+    if (typeof error !== 'object' || error === null) {
+        return false;
+    }
+    const { message, statusCode, name } = error;
+    return (typeof message === 'string' &&
+        typeof statusCode === 'number' &&
+        typeof name === 'string' &&
+        name in interfaces_1.RESEND_ERROR_CODES_BY_KEY);
+};
+exports.isResendErrorResponseStrict = isResendErrorResponseStrict;

package/build/src/interfaces.d.ts

@@ -1,25 +1,30 @@
 export declare const RESEND_ERROR_CODES_BY_KEY: {
-    readonly missing_required_fields: 422;
+    readonly missing_required_field: 422;
+    readonly invalid_access: 422;
+    readonly invalid_parameter: 422;
+    readonly invalid_region: 422;
     readonly rate_limit_exceeded: 429;
     readonly missing_api_key: 401;
     readonly invalid_api_Key: 403;
     readonly invalid_from_address: 403;
+    readonly validation_error: 403;
     readonly not_found: 404;
     readonly method_not_allowed: 405;
+    readonly application_error: 500;
     readonly internal_server_error: 500;
 };
 type ValueOf<TObj> = TObj[keyof TObj];
 export type RESEND_ERROR_CODE_NUMBER = ValueOf<typeof RESEND_ERROR_CODES_BY_KEY>;
 export type RESEND_ERROR_CODE_KEY = keyof typeof RESEND_ERROR_CODES_BY_KEY;
-interface ErrorResponse {
+export interface ErrorResponse {
     error: {
         message: string;
-        status: RESEND_ERROR_CODE_NUMBER;
-        type: RESEND_ERROR_CODE_KEY;
+        statusCode: RESEND_ERROR_CODE_NUMBER | number;
+        name: RESEND_ERROR_CODE_KEY;
     };
 }
-export { ErrorResponse };
 export type Tag = {
     name: string;
     value: string;
 };
+export {};

package/build/src/interfaces.js

@@ -2,12 +2,17 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RESEND_ERROR_CODES_BY_KEY = void 0;
 exports.RESEND_ERROR_CODES_BY_KEY = {
-    missing_required_fields: 422,
+    missing_required_field: 422,
+    invalid_access: 422,
+    invalid_parameter: 422,
+    invalid_region: 422,
     rate_limit_exceeded: 429,
     missing_api_key: 401,
     invalid_api_Key: 403,
     invalid_from_address: 403,
+    validation_error: 403,
     not_found: 404,
     method_not_allowed: 405,
+    application_error: 500,
     internal_server_error: 500,
 };

package/build/src/resend.d.ts

@@ -1,19 +1,22 @@
-import { GetOptions, PostOptions, PutOptions } from './common/interfaces';
 import { ApiKeys } from './api-keys/api-keys';
+import { Batch } from './batch/batch';
+import { GetOptions, PostOptions, PutOptions } from './common/interfaces';
 import { Domains } from './domains/domains';
 import { Emails } from './emails/emails';
 import { CreateEmailOptions, CreateEmailResponse } from './emails/interfaces';
+import { ErrorResponse } from './interfaces';
 export declare class Resend {
     readonly key?: string | undefined;
     private readonly headers;
     readonly apiKeys: ApiKeys;
     readonly domains: Domains;
     readonly emails: Emails;
+    readonly batch: Batch;
     constructor(key?: string | undefined);
-    fetchRequest(path: string, options?: {}): Promise<any>;
-    post<T>(path: string, entity?: any, options?: PostOptions): Promise<T>;
-    get<T>(path: string, options?: GetOptions): Promise<T>;
-    put<T>(path: string, entity: any, options?: PutOptions): Promise<T>;
-    delete<T>(path: string, query?: any): Promise<T>;
+    fetchRequest<T>(path: string, options?: {}): Promise<T | ErrorResponse>;
+    post<T>(path: string, entity?: any, options?: PostOptions): Promise<ErrorResponse | T>;
+    get<T>(path: string, options?: GetOptions): Promise<ErrorResponse | T>;
+    put<T>(path: string, entity: any, options?: PutOptions): Promise<ErrorResponse | T>;
+    delete<T>(path: string, query?: any): Promise<ErrorResponse | T>;
     sendEmail(data: CreateEmailOptions): Promise<CreateEmailResponse>;
 }

package/build/src/resend.js

@@ -10,11 +10,12 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Resend = void 0;
-const render_1 = require("@react-email/render");
 const package_json_1 = require("../package.json");
 const api_keys_1 = require("./api-keys/api-keys");
+const batch_1 = require("./batch/batch");
 const domains_1 = require("./domains/domains");
 const emails_1 = require("./emails/emails");
+const guards_1 = require("./guards");
 const baseUrl = process.env.RESEND_BASE_URL || 'https://api.resend.com';
 const userAgent = process.env.RESEND_USER_AGENT || `resend-node:${package_json_1.version}`;
 class Resend {
@@ -23,6 +24,7 @@ class Resend {
         this.apiKeys = new api_keys_1.ApiKeys(this);
         this.domains = new domains_1.Domains(this);
         this.emails = new emails_1.Emails(this);
+        this.batch = new batch_1.Batch(this);
         if (!key) {
             this.key = process.env.RESEND_API_KEY;
             if (!this.key) {
@@ -40,7 +42,12 @@ class Resend {
             const response = yield fetch(`${baseUrl}${path}`, options);
             if (!response.ok) {
                 const error = yield response.json();
-                return error;
+                if ((0, guards_1.isResendErrorResponse)(error)) {
+                    return error;
+                }
+                return {
+                    error,
+                };
             }
             return yield response.json();
         });
@@ -75,24 +82,7 @@ class Resend {
     }
     sendEmail(data) {
         return __awaiter(this, void 0, void 0, function* () {
-            const path = '/email';
-            if (data.react) {
-                data.html = (0, render_1.render)(data.react);
-                delete data.react;
-            }
-            const response = yield this.post(path, {
-                from: data.from,
-                to: data.to,
-                bcc: data.bcc,
-                cc: data.cc,
-                reply_to: data.reply_to,
-                subject: data.subject,
-                text: data.text,
-                html: data.html,
-                attachments: data.attachments,
-                tags: data.tags,
-            });
-            return response;
+            return this.emails.create(data);
         });
     }
 }

package/build/src/resend.spec.js

@@ -216,4 +216,37 @@ describe('Resend', () => {
       }
     `);
     }));
+    it('throws an error when an ErrorResponse is returned', () => __awaiter(void 0, void 0, void 0, function* () {
+        const payload = {
+            from: 'resend.com',
+            to: 'bu@resend.com',
+            reply_to: ['foo@resend.com', 'bar@resend.com'],
+            subject: 'Hello World',
+            text: 'Hello world',
+        };
+        const errorResponse = {
+            error: {
+                statusCode: 422,
+                name: 'invalid_parameter',
+                message: 'Invalid `from` field. The email address needs to follow the `email@example.com` or `Name <email@example.com>` format',
+            },
+        };
+        fetchMock.mockOnce(JSON.stringify(errorResponse), {
+            status: 422,
+            headers: {
+                'content-type': 'application/json',
+                Authorization: 'Bearer re_924b3rjh2387fbewf823',
+            },
+        });
+        const result = resend.emails.send(payload);
+        yield expect(result).resolves.toMatchInlineSnapshot(`
+      {
+        "error": {
+          "message": "Invalid \`from\` field. The email address needs to follow the \`email@example.com\` or \`Name <email@example.com>\` format",
+          "name": "invalid_parameter",
+          "statusCode": 422,
+        },
+      }
+    `);
+    }));
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "resend",
-  "version": "1.1.0",
+  "version": "2.0.0-canary.0",
   "description": "Node.js library for the Resend API",
   "main": "build/src/index.js",
   "typings": "build/src/index.d.ts",
@@ -10,7 +10,7 @@
   "engines": {
     "node": ">=18"
   },
-  "packageManager": "yarn@3.6.3",
+  "packageManager": "yarn@3.6.4",
   "scripts": {
     "build": "tsc -p .",
     "test": "jest",
@@ -31,23 +31,20 @@
   },
   "homepage": "https://github.com/resendlabs/resend-node#readme",
   "dependencies": {
-    "@react-email/render": "0.0.7",
-    "type-fest": "3.13.0"
+    "@react-email/render": "0.0.8"
   },
   "devDependencies": {
-    "@types/jest": "29.5.3",
-    "@types/node": "18.17.5",
-    "@types/react": "18.2.20",
-    "@typescript-eslint/eslint-plugin": "6.4.0",
-    "@typescript-eslint/parser": "6.4.0",
-    "eslint": "8.47.0",
-    "fetch-mock": "9.11.0",
-    "jest": "29.6.2",
+    "@types/jest": "29.5.6",
+    "@types/node": "18.18.7",
+    "@types/react": "18.2.33",
+    "@typescript-eslint/eslint-plugin": "6.9.0",
+    "@typescript-eslint/parser": "6.9.0",
+    "eslint": "8.52.0",
+    "jest": "29.7.0",
     "jest-fetch-mock": "3.0.3",
-    "prettier": "3.0.2",
-    "prettier-2": "npm:prettier@2",
-    "supertest": "6.3.3",
+    "prettier": "3.0.3",
     "ts-jest": "29.1.1",
-    "typescript": "5.1.6"
+    "ts-node": "10.9.1",
+    "typescript": "5.2.2"
   }
 }