resend-cli 1.0.3 → 1.1.0

package/tests/commands/contact-properties/update.test.ts

@@ -0,0 +1,216 @@
+import {
+  afterEach,
+  beforeEach,
+  describe,
+  expect,
+  mock,
+  spyOn,
+  test,
+} from 'bun:test';
+import {
+  captureTestEnv,
+  expectExit1,
+  mockExitThrow,
+  mockSdkError,
+  setNonInteractive,
+  setupOutputSpies,
+} from '../../helpers';
+
+const mockUpdate = mock(async () => ({
+  data: {
+    object: 'contact_property' as const,
+    id: 'b4a3c2d1-6e5f-8a7b-0c9d-2e1f4a3b6c5d',
+  },
+  error: null,
+}));
+
+mock.module('resend', () => ({
+  Resend: class MockResend {
+    constructor(public key: string) {}
+    contactProperties = { update: mockUpdate };
+  },
+}));
+
+describe('contact-properties update 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';
+    mockUpdate.mockClear();
+  });
+
+  afterEach(() => {
+    restoreEnv();
+    spies?.restore();
+    errorSpy?.mockRestore();
+    stderrSpy?.mockRestore();
+    exitSpy?.mockRestore();
+    spies = undefined;
+    errorSpy = undefined;
+    stderrSpy = undefined;
+    exitSpy = undefined;
+  });
+
+  test('updates property fallback value', async () => {
+    spies = setupOutputSpies();
+
+    const { updateContactPropertyCommand } = await import(
+      '../../../src/commands/contact-properties/update'
+    );
+    await updateContactPropertyCommand.parseAsync(
+      ['b4a3c2d1-6e5f-8a7b-0c9d-2e1f4a3b6c5d', '--fallback-value', 'Acme Corp'],
+      { from: 'user' },
+    );
+
+    expect(mockUpdate).toHaveBeenCalledTimes(1);
+    const args = mockUpdate.mock.calls[0][0] as Record<string, unknown>;
+    expect(args.id).toBe('b4a3c2d1-6e5f-8a7b-0c9d-2e1f4a3b6c5d');
+    expect(args.fallbackValue).toBe('Acme Corp');
+  });
+
+  test('clears fallback value with --clear-fallback-value', async () => {
+    spies = setupOutputSpies();
+
+    const { updateContactPropertyCommand } = await import(
+      '../../../src/commands/contact-properties/update'
+    );
+    await updateContactPropertyCommand.parseAsync(
+      ['b4a3c2d1-6e5f-8a7b-0c9d-2e1f4a3b6c5d', '--clear-fallback-value'],
+      { from: 'user' },
+    );
+
+    const args = mockUpdate.mock.calls[0][0] as Record<string, unknown>;
+    expect(args.id).toBe('b4a3c2d1-6e5f-8a7b-0c9d-2e1f4a3b6c5d');
+    expect(args.fallbackValue).toBeNull();
+  });
+
+  test('errors with conflicting_flags when both --fallback-value and --clear-fallback-value are given', async () => {
+    setNonInteractive();
+    errorSpy = spyOn(console, 'error').mockImplementation(() => {});
+    exitSpy = mockExitThrow();
+
+    const { updateContactPropertyCommand } = await import(
+      '../../../src/commands/contact-properties/update'
+    );
+    await expectExit1(() =>
+      updateContactPropertyCommand.parseAsync(
+        [
+          'b4a3c2d1-6e5f-8a7b-0c9d-2e1f4a3b6c5d',
+          '--fallback-value',
+          'Acme',
+          '--clear-fallback-value',
+        ],
+        { from: 'user' },
+      ),
+    );
+
+    const output = errorSpy.mock.calls.map((c) => c[0]).join(' ');
+    expect(output).toContain('conflicting_flags');
+  });
+
+  test('outputs JSON result when non-interactive', async () => {
+    spies = setupOutputSpies();
+
+    const { updateContactPropertyCommand } = await import(
+      '../../../src/commands/contact-properties/update'
+    );
+    await updateContactPropertyCommand.parseAsync(
+      ['b4a3c2d1-6e5f-8a7b-0c9d-2e1f4a3b6c5d', '--fallback-value', 'Test'],
+      { from: 'user' },
+    );
+
+    const output = spies.logSpy.mock.calls[0][0] as string;
+    const parsed = JSON.parse(output);
+    expect(parsed.object).toBe('contact_property');
+    expect(parsed.id).toBe('b4a3c2d1-6e5f-8a7b-0c9d-2e1f4a3b6c5d');
+  });
+
+  test('errors with no_changes when no flags are provided', async () => {
+    setNonInteractive();
+    errorSpy = spyOn(console, 'error').mockImplementation(() => {});
+    exitSpy = mockExitThrow();
+
+    const { updateContactPropertyCommand } = await import(
+      '../../../src/commands/contact-properties/update'
+    );
+    await expectExit1(() =>
+      updateContactPropertyCommand.parseAsync(
+        ['b4a3c2d1-6e5f-8a7b-0c9d-2e1f4a3b6c5d'],
+        {
+          from: 'user',
+        },
+      ),
+    );
+
+    const output = errorSpy.mock.calls.map((c) => c[0]).join(' ');
+    expect(output).toContain('no_changes');
+  });
+
+  test('does not call SDK when no_changes error is raised', async () => {
+    setNonInteractive();
+    errorSpy = spyOn(console, 'error').mockImplementation(() => {});
+    exitSpy = mockExitThrow();
+
+    const { updateContactPropertyCommand } = await import(
+      '../../../src/commands/contact-properties/update'
+    );
+    await expectExit1(() =>
+      updateContactPropertyCommand.parseAsync(
+        ['b4a3c2d1-6e5f-8a7b-0c9d-2e1f4a3b6c5d'],
+        {
+          from: 'user',
+        },
+      ),
+    );
+
+    expect(mockUpdate).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 { updateContactPropertyCommand } = await import(
+      '../../../src/commands/contact-properties/update'
+    );
+    await expectExit1(() =>
+      updateContactPropertyCommand.parseAsync(
+        ['b4a3c2d1-6e5f-8a7b-0c9d-2e1f4a3b6c5d', '--fallback-value', 'Test'],
+        { from: 'user' },
+      ),
+    );
+
+    const output = errorSpy.mock.calls.map((c) => c[0]).join(' ');
+    expect(output).toContain('auth_error');
+  });
+
+  test('errors with update_error when SDK returns an error', async () => {
+    setNonInteractive();
+    mockUpdate.mockResolvedValueOnce(
+      mockSdkError('Property not found', 'not_found'),
+    );
+    errorSpy = spyOn(console, 'error').mockImplementation(() => {});
+    stderrSpy = spyOn(process.stderr, 'write').mockImplementation(() => true);
+    exitSpy = mockExitThrow();
+
+    const { updateContactPropertyCommand } = await import(
+      '../../../src/commands/contact-properties/update'
+    );
+    await expectExit1(() =>
+      updateContactPropertyCommand.parseAsync(
+        ['nonexistent_id', '--fallback-value', 'Test'],
+        { from: 'user' },
+      ),
+    );
+
+    const output = errorSpy.mock.calls.map((c) => c[0]).join(' ');
+    expect(output).toContain('update_error');
+  });
+});

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

@@ -0,0 +1,188 @@
+import {
+  afterEach,
+  beforeEach,
+  describe,
+  expect,
+  mock,
+  spyOn,
+  test,
+} from 'bun:test';
+import {
+  captureTestEnv,
+  expectExit1,
+  mockExitThrow,
+  mockSdkError,
+  setNonInteractive,
+  setupOutputSpies,
+} from '../../helpers';
+
+const mockAddSegment = mock(async () => ({
+  data: { id: '7b1e0a3d-4c5f-4e8a-9b2d-1a3c5e7f9b2d' },
+  error: null,
+}));
+
+mock.module('resend', () => ({
+  Resend: class MockResend {
+    constructor(public key: string) {}
+    contacts = {
+      segments: { add: mockAddSegment },
+    };
+  },
+}));
+
+describe('contacts add-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';
+    mockAddSegment.mockClear();
+  });
+
+  afterEach(() => {
+    restoreEnv();
+    spies?.restore();
+    errorSpy?.mockRestore();
+    stderrSpy?.mockRestore();
+    exitSpy?.mockRestore();
+    spies = undefined;
+    errorSpy = undefined;
+    stderrSpy = undefined;
+    exitSpy = undefined;
+  });
+
+  test('adds contact to segment by contact ID', async () => {
+    spies = setupOutputSpies();
+
+    const { addContactSegmentCommand } = await import(
+      '../../../src/commands/contacts/add-segment'
+    );
+    await addContactSegmentCommand.parseAsync(
+      [
+        'a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6',
+        '--segment-id',
+        '7b1e0a3d-4c5f-4e8a-9b2d-1a3c5e7f9b2d',
+      ],
+      { from: 'user' },
+    );
+
+    expect(mockAddSegment).toHaveBeenCalledTimes(1);
+    const args = mockAddSegment.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('adds contact to segment by email', async () => {
+    spies = setupOutputSpies();
+
+    const { addContactSegmentCommand } = await import(
+      '../../../src/commands/contacts/add-segment'
+    );
+    await addContactSegmentCommand.parseAsync(
+      [
+        'jane@example.com',
+        '--segment-id',
+        '7b1e0a3d-4c5f-4e8a-9b2d-1a3c5e7f9b2d',
+      ],
+      { from: 'user' },
+    );
+
+    const args = mockAddSegment.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 { addContactSegmentCommand } = await import(
+      '../../../src/commands/contacts/add-segment'
+    );
+    await addContactSegmentCommand.parseAsync(
+      [
+        'a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6',
+        '--segment-id',
+        '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');
+  });
+
+  test('errors with missing_segment_id when --segment-id absent in non-interactive mode', async () => {
+    setNonInteractive();
+    errorSpy = spyOn(console, 'error').mockImplementation(() => {});
+    exitSpy = mockExitThrow();
+
+    const { addContactSegmentCommand } = await import(
+      '../../../src/commands/contacts/add-segment'
+    );
+    await expectExit1(() =>
+      addContactSegmentCommand.parseAsync(
+        ['a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6'],
+        { from: 'user' },
+      ),
+    );
+
+    const output = errorSpy.mock.calls.map((c) => c[0]).join(' ');
+    expect(output).toContain('missing_segment_id');
+  });
+
+  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 { addContactSegmentCommand } = await import(
+      '../../../src/commands/contacts/add-segment'
+    );
+    await expectExit1(() =>
+      addContactSegmentCommand.parseAsync(
+        [
+          'a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6',
+          '--segment-id',
+          '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 add_segment_error when SDK returns an error', async () => {
+    setNonInteractive();
+    mockAddSegment.mockResolvedValueOnce(
+      mockSdkError('Segment not found', 'not_found'),
+    );
+    errorSpy = spyOn(console, 'error').mockImplementation(() => {});
+    stderrSpy = spyOn(process.stderr, 'write').mockImplementation(() => true);
+    exitSpy = mockExitThrow();
+
+    const { addContactSegmentCommand } = await import(
+      '../../../src/commands/contacts/add-segment'
+    );
+    await expectExit1(() =>
+      addContactSegmentCommand.parseAsync(
+        [
+          'a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6',
+          '--segment-id',
+          '00000000-0000-0000-0000-00000bad0seg',
+        ],
+        { from: 'user' },
+      ),
+    );
+
+    const output = errorSpy.mock.calls.map((c) => c[0]).join(' ');
+    expect(output).toContain('add_segment_error');
+  });
+});

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

@@ -0,0 +1,270 @@
+import {
+  afterEach,
+  beforeEach,
+  describe,
+  expect,
+  mock,
+  spyOn,
+  test,
+} from 'bun:test';
+import {
+  captureTestEnv,
+  expectExit1,
+  mockExitThrow,
+  mockSdkError,
+  setNonInteractive,
+  setupOutputSpies,
+} from '../../helpers';
+
+const mockCreate = mock(async () => ({
+  data: {
+    object: 'contact' as const,
+    id: 'a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6',
+  },
+  error: null,
+}));
+
+mock.module('resend', () => ({
+  Resend: class MockResend {
+    constructor(public key: string) {}
+    contacts = { create: mockCreate };
+  },
+}));
+
+describe('contacts create 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';
+    mockCreate.mockClear();
+  });
+
+  afterEach(() => {
+    restoreEnv();
+    spies?.restore();
+    errorSpy?.mockRestore();
+    stderrSpy?.mockRestore();
+    exitSpy?.mockRestore();
+    spies = undefined;
+    errorSpy = undefined;
+    stderrSpy = undefined;
+    exitSpy = undefined;
+  });
+
+  test('creates contact with --email flag', async () => {
+    spies = setupOutputSpies();
+
+    const { createContactCommand } = await import(
+      '../../../src/commands/contacts/create'
+    );
+    await createContactCommand.parseAsync(['--email', 'jane@example.com'], {
+      from: 'user',
+    });
+
+    expect(mockCreate).toHaveBeenCalledTimes(1);
+    const args = mockCreate.mock.calls[0][0] as Record<string, unknown>;
+    expect(args.email).toBe('jane@example.com');
+  });
+
+  test('outputs JSON id when non-interactive', async () => {
+    spies = setupOutputSpies();
+
+    const { createContactCommand } = await import(
+      '../../../src/commands/contacts/create'
+    );
+    await createContactCommand.parseAsync(['--email', 'jane@example.com'], {
+      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.object).toBe('contact');
+  });
+
+  test('passes --first-name and --last-name to SDK', async () => {
+    spies = setupOutputSpies();
+
+    const { createContactCommand } = await import(
+      '../../../src/commands/contacts/create'
+    );
+    await createContactCommand.parseAsync(
+      [
+        '--email',
+        'jane@example.com',
+        '--first-name',
+        'Jane',
+        '--last-name',
+        'Smith',
+      ],
+      { from: 'user' },
+    );
+
+    const args = mockCreate.mock.calls[0][0] as Record<string, unknown>;
+    expect(args.firstName).toBe('Jane');
+    expect(args.lastName).toBe('Smith');
+  });
+
+  test('passes --unsubscribed flag to SDK', async () => {
+    spies = setupOutputSpies();
+
+    const { createContactCommand } = await import(
+      '../../../src/commands/contacts/create'
+    );
+    await createContactCommand.parseAsync(
+      ['--email', 'jane@example.com', '--unsubscribed'],
+      { from: 'user' },
+    );
+
+    const args = mockCreate.mock.calls[0][0] as Record<string, unknown>;
+    expect(args.unsubscribed).toBe(true);
+  });
+
+  test('parses --properties JSON and passes to SDK', async () => {
+    spies = setupOutputSpies();
+
+    const { createContactCommand } = await import(
+      '../../../src/commands/contacts/create'
+    );
+    await createContactCommand.parseAsync(
+      [
+        '--email',
+        'jane@example.com',
+        '--properties',
+        '{"company":"Acme","plan":"pro"}',
+      ],
+      { from: 'user' },
+    );
+
+    const args = mockCreate.mock.calls[0][0] as Record<string, unknown>;
+    expect(args.properties).toEqual({ company: 'Acme', plan: 'pro' });
+  });
+
+  test('passes --segment-id (single) to SDK as segments array', async () => {
+    spies = setupOutputSpies();
+
+    const { createContactCommand } = await import(
+      '../../../src/commands/contacts/create'
+    );
+    await createContactCommand.parseAsync(
+      [
+        '--email',
+        'jane@example.com',
+        '--segment-id',
+        '7b1e0a3d-4c5f-4e8a-9b2d-1a3c5e7f9b2d',
+      ],
+      { from: 'user' },
+    );
+
+    const args = mockCreate.mock.calls[0][0] as Record<string, unknown>;
+    expect(args.segments).toEqual([
+      { id: '7b1e0a3d-4c5f-4e8a-9b2d-1a3c5e7f9b2d' },
+    ]);
+  });
+
+  test('passes multiple --segment-id values to SDK', async () => {
+    spies = setupOutputSpies();
+
+    const { createContactCommand } = await import(
+      '../../../src/commands/contacts/create'
+    );
+    await createContactCommand.parseAsync(
+      [
+        '--email',
+        'jane@example.com',
+        '--segment-id',
+        '3f2a1b4c-5d6e-7f8a-9b0c-1d2e3f4a5b6c',
+        '--segment-id',
+        'e8d7c6b5-a4f3-2e1d-0c9b-8a7f6e5d4c3b',
+      ],
+      { from: 'user' },
+    );
+
+    const args = mockCreate.mock.calls[0][0] as Record<string, unknown>;
+    expect(args.segments).toEqual([
+      { id: '3f2a1b4c-5d6e-7f8a-9b0c-1d2e3f4a5b6c' },
+      { id: 'e8d7c6b5-a4f3-2e1d-0c9b-8a7f6e5d4c3b' },
+    ]);
+  });
+
+  test('errors with missing_email in non-interactive mode', async () => {
+    setNonInteractive();
+    errorSpy = spyOn(console, 'error').mockImplementation(() => {});
+    exitSpy = mockExitThrow();
+
+    const { createContactCommand } = await import(
+      '../../../src/commands/contacts/create'
+    );
+    await expectExit1(() =>
+      createContactCommand.parseAsync([], { from: 'user' }),
+    );
+
+    const output = errorSpy.mock.calls.map((c) => c[0]).join(' ');
+    expect(output).toContain('missing_email');
+  });
+
+  test('errors with invalid_properties when --properties is not valid JSON', async () => {
+    setNonInteractive();
+    errorSpy = spyOn(console, 'error').mockImplementation(() => {});
+    exitSpy = mockExitThrow();
+
+    const { createContactCommand } = await import(
+      '../../../src/commands/contacts/create'
+    );
+    await expectExit1(() =>
+      createContactCommand.parseAsync(
+        ['--email', 'jane@example.com', '--properties', 'not-json'],
+        { from: 'user' },
+      ),
+    );
+
+    const output = errorSpy.mock.calls.map((c) => c[0]).join(' ');
+    expect(output).toContain('invalid_properties');
+  });
+
+  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 { createContactCommand } = await import(
+      '../../../src/commands/contacts/create'
+    );
+    await expectExit1(() =>
+      createContactCommand.parseAsync(['--email', 'jane@example.com'], {
+        from: 'user',
+      }),
+    );
+
+    const output = errorSpy.mock.calls.map((c) => c[0]).join(' ');
+    expect(output).toContain('auth_error');
+  });
+
+  test('errors with create_error when SDK returns an error', async () => {
+    setNonInteractive();
+    mockCreate.mockResolvedValueOnce(
+      mockSdkError('Contact already exists', 'validation_error'),
+    );
+    errorSpy = spyOn(console, 'error').mockImplementation(() => {});
+    stderrSpy = spyOn(process.stderr, 'write').mockImplementation(() => true);
+    exitSpy = mockExitThrow();
+
+    const { createContactCommand } = await import(
+      '../../../src/commands/contacts/create'
+    );
+    await expectExit1(() =>
+      createContactCommand.parseAsync(['--email', 'jane@example.com'], {
+        from: 'user',
+      }),
+    );
+
+    const output = errorSpy.mock.calls.map((c) => c[0]).join(' ');
+    expect(output).toContain('create_error');
+  });
+});