resend-cli 1.0.2 → 1.1.0

package/tests/commands/contacts/delete.test.ts

@@ -0,0 +1,192 @@
+import {
+  afterEach,
+  beforeEach,
+  describe,
+  expect,
+  mock,
+  spyOn,
+  test,
+} from 'bun:test';
+import {
+  captureTestEnv,
+  expectExit1,
+  mockExitThrow,
+  mockSdkError,
+  setNonInteractive,
+  setupOutputSpies,
+} from '../../helpers';
+
+const mockRemove = mock(async () => ({
+  data: {
+    object: 'contact' as const,
+    deleted: true,
+    contact: 'a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6',
+  },
+  error: null,
+}));
+
+mock.module('resend', () => ({
+  Resend: class MockResend {
+    constructor(public key: string) {}
+    contacts = { remove: mockRemove };
+  },
+}));
+
+describe('contacts delete command', () => {
+  const restoreEnv = captureTestEnv();
+  let spies: ReturnType<typeof setupOutputSpies> | undefined;
+  let errorSpy: ReturnType<typeof spyOn> | undefined;
+  let stderrSpy: ReturnType<typeof spyOn> | undefined;
+  let exitSpy: ReturnType<typeof spyOn> | undefined;
+
+  beforeEach(() => {
+    process.env.RESEND_API_KEY = 're_test_key';
+    mockRemove.mockClear();
+  });
+
+  afterEach(() => {
+    restoreEnv();
+    spies?.restore();
+    errorSpy?.mockRestore();
+    stderrSpy?.mockRestore();
+    exitSpy?.mockRestore();
+    spies = undefined;
+    errorSpy = undefined;
+    stderrSpy = undefined;
+    exitSpy = undefined;
+  });
+
+  test('deletes contact by ID with --yes', async () => {
+    spies = setupOutputSpies();
+
+    const { deleteContactCommand } = await import(
+      '../../../src/commands/contacts/delete'
+    );
+    await deleteContactCommand.parseAsync(
+      ['a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6', '--yes'],
+      {
+        from: 'user',
+      },
+    );
+
+    expect(mockRemove).toHaveBeenCalledTimes(1);
+    expect(mockRemove.mock.calls[0][0]).toBe(
+      'a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6',
+    );
+  });
+
+  test('deletes contact by email with --yes', async () => {
+    spies = setupOutputSpies();
+
+    const { deleteContactCommand } = await import(
+      '../../../src/commands/contacts/delete'
+    );
+    await deleteContactCommand.parseAsync(['jane@example.com', '--yes'], {
+      from: 'user',
+    });
+
+    expect(mockRemove.mock.calls[0][0]).toBe('jane@example.com');
+  });
+
+  test('outputs synthesized JSON result when non-interactive', async () => {
+    spies = setupOutputSpies();
+
+    const { deleteContactCommand } = await import(
+      '../../../src/commands/contacts/delete'
+    );
+    await deleteContactCommand.parseAsync(
+      ['a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6', '--yes'],
+      {
+        from: 'user',
+      },
+    );
+
+    const output = spies.logSpy.mock.calls[0][0] as string;
+    const parsed = JSON.parse(output);
+    expect(parsed.object).toBe('contact');
+    expect(parsed.id).toBe('a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6');
+    expect(parsed.deleted).toBe(true);
+  });
+
+  test('errors with confirmation_required when --yes absent in non-interactive mode', async () => {
+    setNonInteractive();
+    errorSpy = spyOn(console, 'error').mockImplementation(() => {});
+    exitSpy = mockExitThrow();
+
+    const { deleteContactCommand } = await import(
+      '../../../src/commands/contacts/delete'
+    );
+    await expectExit1(() =>
+      deleteContactCommand.parseAsync(
+        ['a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6'],
+        { from: 'user' },
+      ),
+    );
+
+    const output = errorSpy.mock.calls.map((c) => c[0]).join(' ');
+    expect(output).toContain('confirmation_required');
+  });
+
+  test('does not call SDK when confirmation_required error is raised', async () => {
+    setNonInteractive();
+    errorSpy = spyOn(console, 'error').mockImplementation(() => {});
+    exitSpy = mockExitThrow();
+
+    const { deleteContactCommand } = await import(
+      '../../../src/commands/contacts/delete'
+    );
+    await expectExit1(() =>
+      deleteContactCommand.parseAsync(
+        ['a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6'],
+        { from: 'user' },
+      ),
+    );
+
+    expect(mockRemove).not.toHaveBeenCalled();
+  });
+
+  test('errors with auth_error when no API key', async () => {
+    setNonInteractive();
+    delete process.env.RESEND_API_KEY;
+    process.env.XDG_CONFIG_HOME = '/tmp/nonexistent-resend';
+    errorSpy = spyOn(console, 'error').mockImplementation(() => {});
+    exitSpy = mockExitThrow();
+
+    const { deleteContactCommand } = await import(
+      '../../../src/commands/contacts/delete'
+    );
+    await expectExit1(() =>
+      deleteContactCommand.parseAsync(
+        ['a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6', '--yes'],
+        {
+          from: 'user',
+        },
+      ),
+    );
+
+    const output = errorSpy.mock.calls.map((c) => c[0]).join(' ');
+    expect(output).toContain('auth_error');
+  });
+
+  test('errors with delete_error when SDK returns an error', async () => {
+    setNonInteractive();
+    mockRemove.mockResolvedValueOnce(
+      mockSdkError('Contact not found', 'not_found'),
+    );
+    errorSpy = spyOn(console, 'error').mockImplementation(() => {});
+    stderrSpy = spyOn(process.stderr, 'write').mockImplementation(() => true);
+    exitSpy = mockExitThrow();
+
+    const { deleteContactCommand } = await import(
+      '../../../src/commands/contacts/delete'
+    );
+    await expectExit1(() =>
+      deleteContactCommand.parseAsync(['nonexistent_id', '--yes'], {
+        from: 'user',
+      }),
+    );
+
+    const output = errorSpy.mock.calls.map((c) => c[0]).join(' ');
+    expect(output).toContain('delete_error');
+  });
+});

package/tests/commands/contacts/get.test.ts

@@ -0,0 +1,148 @@
+import {
+  afterEach,
+  beforeEach,
+  describe,
+  expect,
+  mock,
+  spyOn,
+  test,
+} from 'bun:test';
+import {
+  captureTestEnv,
+  expectExit1,
+  mockExitThrow,
+  mockSdkError,
+  setNonInteractive,
+  setupOutputSpies,
+} from '../../helpers';
+
+const mockGet = mock(async () => ({
+  data: {
+    object: 'contact' as const,
+    id: 'a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6',
+    email: 'jane@example.com',
+    first_name: 'Jane',
+    last_name: 'Smith',
+    created_at: '2026-01-01T00:00:00.000Z',
+    unsubscribed: false,
+    properties: {},
+  },
+  error: null,
+}));
+
+mock.module('resend', () => ({
+  Resend: class MockResend {
+    constructor(public key: string) {}
+    contacts = { get: mockGet };
+  },
+}));
+
+describe('contacts get command', () => {
+  const restoreEnv = captureTestEnv();
+  let spies: ReturnType<typeof setupOutputSpies> | undefined;
+  let errorSpy: ReturnType<typeof spyOn> | undefined;
+  let stderrSpy: ReturnType<typeof spyOn> | undefined;
+  let exitSpy: ReturnType<typeof spyOn> | undefined;
+
+  beforeEach(() => {
+    process.env.RESEND_API_KEY = 're_test_key';
+    mockGet.mockClear();
+  });
+
+  afterEach(() => {
+    restoreEnv();
+    spies?.restore();
+    errorSpy?.mockRestore();
+    stderrSpy?.mockRestore();
+    exitSpy?.mockRestore();
+    spies = undefined;
+    errorSpy = undefined;
+    stderrSpy = undefined;
+    exitSpy = undefined;
+  });
+
+  test('calls SDK with contact ID', async () => {
+    spies = setupOutputSpies();
+
+    const { getContactCommand } = await import(
+      '../../../src/commands/contacts/get'
+    );
+    await getContactCommand.parseAsync(
+      ['a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6'],
+      { from: 'user' },
+    );
+
+    expect(mockGet).toHaveBeenCalledTimes(1);
+    expect(mockGet.mock.calls[0][0]).toBe(
+      'a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6',
+    );
+  });
+
+  test('calls SDK with email address', async () => {
+    spies = setupOutputSpies();
+
+    const { getContactCommand } = await import(
+      '../../../src/commands/contacts/get'
+    );
+    await getContactCommand.parseAsync(['jane@example.com'], { from: 'user' });
+
+    expect(mockGet.mock.calls[0][0]).toBe('jane@example.com');
+  });
+
+  test('outputs JSON when non-interactive', async () => {
+    spies = setupOutputSpies();
+
+    const { getContactCommand } = await import(
+      '../../../src/commands/contacts/get'
+    );
+    await getContactCommand.parseAsync(
+      ['a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6'],
+      { from: 'user' },
+    );
+
+    const output = spies.logSpy.mock.calls[0][0] as string;
+    const parsed = JSON.parse(output);
+    expect(parsed.id).toBe('a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6');
+    expect(parsed.email).toBe('jane@example.com');
+  });
+
+  test('errors with auth_error when no API key', async () => {
+    setNonInteractive();
+    delete process.env.RESEND_API_KEY;
+    process.env.XDG_CONFIG_HOME = '/tmp/nonexistent-resend';
+    errorSpy = spyOn(console, 'error').mockImplementation(() => {});
+    exitSpy = mockExitThrow();
+
+    const { getContactCommand } = await import(
+      '../../../src/commands/contacts/get'
+    );
+    await expectExit1(() =>
+      getContactCommand.parseAsync(['a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6'], {
+        from: 'user',
+      }),
+    );
+
+    const output = errorSpy.mock.calls.map((c) => c[0]).join(' ');
+    expect(output).toContain('auth_error');
+  });
+
+  test('errors with fetch_error when SDK returns an error', async () => {
+    setNonInteractive();
+    mockGet.mockResolvedValueOnce(
+      mockSdkError('Contact not found', 'not_found'),
+    );
+    errorSpy = spyOn(console, 'error').mockImplementation(() => {});
+    stderrSpy = spyOn(process.stderr, 'write').mockImplementation(() => true);
+    exitSpy = mockExitThrow();
+
+    const { getContactCommand } = await import(
+      '../../../src/commands/contacts/get'
+    );
+    await expectExit1(() =>
+      getContactCommand.parseAsync(['nonexistent_id'], { from: 'user' }),
+    );
+
+    const output = errorSpy.mock.calls.map((c) => c[0]).join(' ');
+    expect(output).toContain('fetch_error');
+  });
+});

package/tests/commands/contacts/list.test.ts

@@ -0,0 +1,175 @@
+import {
+  afterEach,
+  beforeEach,
+  describe,
+  expect,
+  mock,
+  spyOn,
+  test,
+} from 'bun:test';
+import {
+  captureTestEnv,
+  expectExit1,
+  mockExitThrow,
+  mockSdkError,
+  setNonInteractive,
+  setupOutputSpies,
+} from '../../helpers';
+
+const mockList = mock(async () => ({
+  data: {
+    object: 'list' as const,
+    data: [
+      {
+        id: 'c1',
+        email: 'jane@example.com',
+        first_name: 'Jane',
+        last_name: 'Smith',
+        unsubscribed: false,
+        created_at: '2026-01-01T00:00:00.000Z',
+      },
+    ],
+    has_more: false,
+  },
+  error: null,
+}));
+
+mock.module('resend', () => ({
+  Resend: class MockResend {
+    constructor(public key: string) {}
+    contacts = { list: mockList };
+  },
+}));
+
+describe('contacts list command', () => {
+  const restoreEnv = captureTestEnv();
+  let spies: ReturnType<typeof setupOutputSpies> | undefined;
+  let errorSpy: ReturnType<typeof spyOn> | undefined;
+  let stderrSpy: ReturnType<typeof spyOn> | undefined;
+  let exitSpy: ReturnType<typeof spyOn> | undefined;
+
+  beforeEach(() => {
+    process.env.RESEND_API_KEY = 're_test_key';
+    mockList.mockClear();
+  });
+
+  afterEach(() => {
+    restoreEnv();
+    spies?.restore();
+    errorSpy?.mockRestore();
+    stderrSpy?.mockRestore();
+    exitSpy?.mockRestore();
+    spies = undefined;
+    errorSpy = undefined;
+    stderrSpy = undefined;
+    exitSpy = undefined;
+  });
+
+  test('calls SDK with default limit of 10', async () => {
+    spies = setupOutputSpies();
+
+    const { listContactsCommand } = await import(
+      '../../../src/commands/contacts/list'
+    );
+    await listContactsCommand.parseAsync([], { from: 'user' });
+
+    expect(mockList).toHaveBeenCalledTimes(1);
+    const args = mockList.mock.calls[0][0] as Record<string, unknown>;
+    expect(args.limit).toBe(10);
+  });
+
+  test('calls SDK with custom --limit', async () => {
+    spies = setupOutputSpies();
+
+    const { listContactsCommand } = await import(
+      '../../../src/commands/contacts/list'
+    );
+    await listContactsCommand.parseAsync(['--limit', '25'], { from: 'user' });
+
+    const args = mockList.mock.calls[0][0] as Record<string, unknown>;
+    expect(args.limit).toBe(25);
+  });
+
+  test('calls SDK with --after cursor', async () => {
+    spies = setupOutputSpies();
+
+    const { listContactsCommand } = await import(
+      '../../../src/commands/contacts/list'
+    );
+    await listContactsCommand.parseAsync(['--after', 'cursor_xyz'], {
+      from: 'user',
+    });
+
+    const args = mockList.mock.calls[0][0] as Record<string, unknown>;
+    expect(args.after).toBe('cursor_xyz');
+  });
+
+  test('outputs JSON list when non-interactive', async () => {
+    spies = setupOutputSpies();
+
+    const { listContactsCommand } = await import(
+      '../../../src/commands/contacts/list'
+    );
+    await listContactsCommand.parseAsync([], { from: 'user' });
+
+    const output = spies.logSpy.mock.calls[0][0] as string;
+    const parsed = JSON.parse(output);
+    expect(parsed.object).toBe('list');
+    expect(Array.isArray(parsed.data)).toBe(true);
+    expect(parsed.data[0].email).toBe('jane@example.com');
+  });
+
+  test('errors with invalid_limit when --limit is out of range', async () => {
+    setNonInteractive();
+    errorSpy = spyOn(console, 'error').mockImplementation(() => {});
+    exitSpy = mockExitThrow();
+
+    const { listContactsCommand } = await import(
+      '../../../src/commands/contacts/list'
+    );
+    await expectExit1(() =>
+      listContactsCommand.parseAsync(['--limit', '0'], { from: 'user' }),
+    );
+
+    const output = errorSpy.mock.calls.map((c) => c[0]).join(' ');
+    expect(output).toContain('invalid_limit');
+  });
+
+  test('errors with auth_error when no API key', async () => {
+    setNonInteractive();
+    delete process.env.RESEND_API_KEY;
+    process.env.XDG_CONFIG_HOME = '/tmp/nonexistent-resend';
+    errorSpy = spyOn(console, 'error').mockImplementation(() => {});
+    exitSpy = mockExitThrow();
+
+    const { listContactsCommand } = await import(
+      '../../../src/commands/contacts/list'
+    );
+    await expectExit1(() =>
+      listContactsCommand.parseAsync([], { from: 'user' }),
+    );
+
+    const output = errorSpy.mock.calls.map((c) => c[0]).join(' ');
+    expect(output).toContain('auth_error');
+  });
+
+  test('errors with list_error when SDK returns an error', async () => {
+    setNonInteractive();
+    mockList.mockResolvedValueOnce(
+      mockSdkError('Server error', 'server_error'),
+    );
+    errorSpy = spyOn(console, 'error').mockImplementation(() => {});
+    stderrSpy = spyOn(process.stderr, 'write').mockImplementation(() => true);
+    exitSpy = mockExitThrow();
+
+    const { listContactsCommand } = await import(
+      '../../../src/commands/contacts/list'
+    );
+    await expectExit1(() =>
+      listContactsCommand.parseAsync([], { from: 'user' }),
+    );
+
+    const output = errorSpy.mock.calls.map((c) => c[0]).join(' ');
+    expect(output).toContain('list_error');
+  });
+});

package/tests/commands/contacts/remove-segment.test.ts

@@ -0,0 +1,166 @@
+import {
+  afterEach,
+  beforeEach,
+  describe,
+  expect,
+  mock,
+  spyOn,
+  test,
+} from 'bun:test';
+import {
+  captureTestEnv,
+  expectExit1,
+  mockExitThrow,
+  mockSdkError,
+  setNonInteractive,
+  setupOutputSpies,
+} from '../../helpers';
+
+const mockRemoveSegment = mock(async () => ({
+  data: { id: '7b1e0a3d-4c5f-4e8a-9b2d-1a3c5e7f9b2d', deleted: true },
+  error: null,
+}));
+
+mock.module('resend', () => ({
+  Resend: class MockResend {
+    constructor(public key: string) {}
+    contacts = {
+      segments: { remove: mockRemoveSegment },
+    };
+  },
+}));
+
+describe('contacts remove-segment command', () => {
+  const restoreEnv = captureTestEnv();
+  let spies: ReturnType<typeof setupOutputSpies> | undefined;
+  let errorSpy: ReturnType<typeof spyOn> | undefined;
+  let stderrSpy: ReturnType<typeof spyOn> | undefined;
+  let exitSpy: ReturnType<typeof spyOn> | undefined;
+
+  beforeEach(() => {
+    process.env.RESEND_API_KEY = 're_test_key';
+    mockRemoveSegment.mockClear();
+  });
+
+  afterEach(() => {
+    restoreEnv();
+    spies?.restore();
+    errorSpy?.mockRestore();
+    stderrSpy?.mockRestore();
+    exitSpy?.mockRestore();
+    spies = undefined;
+    errorSpy = undefined;
+    stderrSpy = undefined;
+    exitSpy = undefined;
+  });
+
+  test('removes contact from segment by contact ID', async () => {
+    spies = setupOutputSpies();
+
+    const { removeContactSegmentCommand } = await import(
+      '../../../src/commands/contacts/remove-segment'
+    );
+    await removeContactSegmentCommand.parseAsync(
+      [
+        'a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6',
+        '7b1e0a3d-4c5f-4e8a-9b2d-1a3c5e7f9b2d',
+      ],
+      { from: 'user' },
+    );
+
+    expect(mockRemoveSegment).toHaveBeenCalledTimes(1);
+    const args = mockRemoveSegment.mock.calls[0][0] as Record<string, unknown>;
+    expect(args.contactId).toBe('a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6');
+    expect(args.segmentId).toBe('7b1e0a3d-4c5f-4e8a-9b2d-1a3c5e7f9b2d');
+  });
+
+  test('removes contact from segment by email', async () => {
+    spies = setupOutputSpies();
+
+    const { removeContactSegmentCommand } = await import(
+      '../../../src/commands/contacts/remove-segment'
+    );
+    await removeContactSegmentCommand.parseAsync(
+      ['jane@example.com', '7b1e0a3d-4c5f-4e8a-9b2d-1a3c5e7f9b2d'],
+      { from: 'user' },
+    );
+
+    const args = mockRemoveSegment.mock.calls[0][0] as Record<string, unknown>;
+    expect(args.email).toBe('jane@example.com');
+    expect(args.segmentId).toBe('7b1e0a3d-4c5f-4e8a-9b2d-1a3c5e7f9b2d');
+  });
+
+  test('outputs JSON result when non-interactive', async () => {
+    spies = setupOutputSpies();
+
+    const { removeContactSegmentCommand } = await import(
+      '../../../src/commands/contacts/remove-segment'
+    );
+    await removeContactSegmentCommand.parseAsync(
+      [
+        'a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6',
+        '7b1e0a3d-4c5f-4e8a-9b2d-1a3c5e7f9b2d',
+      ],
+      { from: 'user' },
+    );
+
+    const output = spies.logSpy.mock.calls[0][0] as string;
+    const parsed = JSON.parse(output);
+    expect(parsed.id).toBe('7b1e0a3d-4c5f-4e8a-9b2d-1a3c5e7f9b2d');
+    expect(parsed.deleted).toBe(true);
+  });
+
+  test('errors with auth_error when no API key', async () => {
+    setNonInteractive();
+    delete process.env.RESEND_API_KEY;
+    process.env.XDG_CONFIG_HOME = '/tmp/nonexistent-resend';
+    errorSpy = spyOn(console, 'error').mockImplementation(() => {});
+    exitSpy = mockExitThrow();
+
+    const { removeContactSegmentCommand } = await import(
+      '../../../src/commands/contacts/remove-segment'
+    );
+    await expectExit1(() =>
+      removeContactSegmentCommand.parseAsync(
+        [
+          'a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6',
+          '7b1e0a3d-4c5f-4e8a-9b2d-1a3c5e7f9b2d',
+        ],
+        {
+          from: 'user',
+        },
+      ),
+    );
+
+    const output = errorSpy.mock.calls.map((c) => c[0]).join(' ');
+    expect(output).toContain('auth_error');
+  });
+
+  test('errors with remove_segment_error when SDK returns an error', async () => {
+    setNonInteractive();
+    mockRemoveSegment.mockResolvedValueOnce(
+      mockSdkError('Not found', 'not_found'),
+    );
+    errorSpy = spyOn(console, 'error').mockImplementation(() => {});
+    stderrSpy = spyOn(process.stderr, 'write').mockImplementation(() => true);
+    exitSpy = mockExitThrow();
+
+    const { removeContactSegmentCommand } = await import(
+      '../../../src/commands/contacts/remove-segment'
+    );
+    await expectExit1(() =>
+      removeContactSegmentCommand.parseAsync(
+        [
+          'a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6',
+          '00000000-0000-0000-0000-00000bad0seg',
+        ],
+        {
+          from: 'user',
+        },
+      ),
+    );
+
+    const output = errorSpy.mock.calls.map((c) => c[0]).join(' ');
+    expect(output).toContain('remove_segment_error');
+  });
+});