resend-cli 1.1.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (205) hide show
  1. package/.claude/settings.local.json +1 -10
  2. package/.claude/worktrees/emails-list/.claude/settings.local.json +5 -0
  3. package/.claude/worktrees/emails-list/.github/scripts/pr-title-check.js +34 -0
  4. package/.claude/worktrees/emails-list/.github/workflows/ci.yml +32 -0
  5. package/.claude/worktrees/emails-list/.github/workflows/pr-title-check.yml +13 -0
  6. package/.claude/worktrees/emails-list/.github/workflows/release.yml +93 -0
  7. package/.claude/worktrees/emails-list/CHANGELOG.md +31 -0
  8. package/.claude/worktrees/emails-list/LICENSE +21 -0
  9. package/.claude/worktrees/emails-list/README.md +424 -0
  10. package/.claude/worktrees/emails-list/biome.json +36 -0
  11. package/.claude/worktrees/emails-list/bun.lock +76 -0
  12. package/.claude/worktrees/emails-list/bunfig.toml +2 -0
  13. package/.claude/worktrees/emails-list/install.ps1 +140 -0
  14. package/.claude/worktrees/emails-list/install.sh +301 -0
  15. package/.claude/worktrees/emails-list/package.json +43 -0
  16. package/.claude/worktrees/emails-list/renovate.json +6 -0
  17. package/.claude/worktrees/emails-list/src/cli.ts +74 -0
  18. package/.claude/worktrees/emails-list/src/commands/api-keys/create.ts +114 -0
  19. package/.claude/worktrees/emails-list/src/commands/api-keys/delete.ts +47 -0
  20. package/.claude/worktrees/emails-list/src/commands/api-keys/index.ts +26 -0
  21. package/.claude/worktrees/emails-list/src/commands/api-keys/list.ts +35 -0
  22. package/.claude/worktrees/emails-list/src/commands/api-keys/utils.ts +8 -0
  23. package/.claude/worktrees/emails-list/src/commands/auth/index.ts +20 -0
  24. package/.claude/worktrees/emails-list/src/commands/auth/login.ts +207 -0
  25. package/.claude/worktrees/emails-list/src/commands/auth/logout.ts +105 -0
  26. package/.claude/worktrees/emails-list/src/commands/broadcasts/create.ts +196 -0
  27. package/.claude/worktrees/emails-list/src/commands/broadcasts/delete.ts +46 -0
  28. package/.claude/worktrees/emails-list/src/commands/broadcasts/get.ts +59 -0
  29. package/.claude/worktrees/emails-list/src/commands/broadcasts/index.ts +43 -0
  30. package/.claude/worktrees/emails-list/src/commands/broadcasts/list.ts +60 -0
  31. package/.claude/worktrees/emails-list/src/commands/broadcasts/send.ts +56 -0
  32. package/.claude/worktrees/emails-list/src/commands/broadcasts/update.ts +95 -0
  33. package/.claude/worktrees/emails-list/src/commands/broadcasts/utils.ts +35 -0
  34. package/.claude/worktrees/emails-list/src/commands/contact-properties/create.ts +118 -0
  35. package/.claude/worktrees/emails-list/src/commands/contact-properties/delete.ts +48 -0
  36. package/.claude/worktrees/emails-list/src/commands/contact-properties/get.ts +46 -0
  37. package/.claude/worktrees/emails-list/src/commands/contact-properties/index.ts +48 -0
  38. package/.claude/worktrees/emails-list/src/commands/contact-properties/list.ts +68 -0
  39. package/.claude/worktrees/emails-list/src/commands/contact-properties/update.ts +88 -0
  40. package/.claude/worktrees/emails-list/src/commands/contact-properties/utils.ts +17 -0
  41. package/.claude/worktrees/emails-list/src/commands/contacts/add-segment.ts +78 -0
  42. package/.claude/worktrees/emails-list/src/commands/contacts/create.ts +122 -0
  43. package/.claude/worktrees/emails-list/src/commands/contacts/delete.ts +49 -0
  44. package/.claude/worktrees/emails-list/src/commands/contacts/get.ts +53 -0
  45. package/.claude/worktrees/emails-list/src/commands/contacts/index.ts +58 -0
  46. package/.claude/worktrees/emails-list/src/commands/contacts/list.ts +57 -0
  47. package/.claude/worktrees/emails-list/src/commands/contacts/remove-segment.ts +48 -0
  48. package/.claude/worktrees/emails-list/src/commands/contacts/segments.ts +39 -0
  49. package/.claude/worktrees/emails-list/src/commands/contacts/topics.ts +45 -0
  50. package/.claude/worktrees/emails-list/src/commands/contacts/update-topics.ts +90 -0
  51. package/.claude/worktrees/emails-list/src/commands/contacts/update.ts +77 -0
  52. package/.claude/worktrees/emails-list/src/commands/contacts/utils.ts +119 -0
  53. package/.claude/worktrees/emails-list/src/commands/doctor.ts +298 -0
  54. package/.claude/worktrees/emails-list/src/commands/domains/create.ts +83 -0
  55. package/.claude/worktrees/emails-list/src/commands/domains/delete.ts +42 -0
  56. package/.claude/worktrees/emails-list/src/commands/domains/get.ts +47 -0
  57. package/.claude/worktrees/emails-list/src/commands/domains/index.ts +35 -0
  58. package/.claude/worktrees/emails-list/src/commands/domains/list.ts +53 -0
  59. package/.claude/worktrees/emails-list/src/commands/domains/update.ts +75 -0
  60. package/.claude/worktrees/emails-list/src/commands/domains/utils.ts +44 -0
  61. package/.claude/worktrees/emails-list/src/commands/domains/verify.ts +38 -0
  62. package/.claude/worktrees/emails-list/src/commands/emails/batch.ts +140 -0
  63. package/.claude/worktrees/emails-list/src/commands/emails/index.ts +28 -0
  64. package/.claude/worktrees/emails-list/src/commands/emails/list.ts +73 -0
  65. package/.claude/worktrees/emails-list/src/commands/emails/receiving/attachment.ts +55 -0
  66. package/.claude/worktrees/emails-list/src/commands/emails/receiving/attachments.ts +68 -0
  67. package/.claude/worktrees/emails-list/src/commands/emails/receiving/get.ts +58 -0
  68. package/.claude/worktrees/emails-list/src/commands/emails/receiving/index.ts +28 -0
  69. package/.claude/worktrees/emails-list/src/commands/emails/receiving/list.ts +59 -0
  70. package/.claude/worktrees/emails-list/src/commands/emails/receiving/utils.ts +38 -0
  71. package/.claude/worktrees/emails-list/src/commands/emails/send.ts +189 -0
  72. package/.claude/worktrees/emails-list/src/commands/open.ts +24 -0
  73. package/.claude/worktrees/emails-list/src/commands/segments/create.ts +50 -0
  74. package/.claude/worktrees/emails-list/src/commands/segments/delete.ts +47 -0
  75. package/.claude/worktrees/emails-list/src/commands/segments/get.ts +38 -0
  76. package/.claude/worktrees/emails-list/src/commands/segments/index.ts +36 -0
  77. package/.claude/worktrees/emails-list/src/commands/segments/list.ts +58 -0
  78. package/.claude/worktrees/emails-list/src/commands/segments/utils.ts +7 -0
  79. package/.claude/worktrees/emails-list/src/commands/teams/index.ts +10 -0
  80. package/.claude/worktrees/emails-list/src/commands/teams/list.ts +35 -0
  81. package/.claude/worktrees/emails-list/src/commands/teams/remove.ts +83 -0
  82. package/.claude/worktrees/emails-list/src/commands/teams/switch.ts +73 -0
  83. package/.claude/worktrees/emails-list/src/commands/topics/create.ts +73 -0
  84. package/.claude/worktrees/emails-list/src/commands/topics/delete.ts +47 -0
  85. package/.claude/worktrees/emails-list/src/commands/topics/get.ts +42 -0
  86. package/.claude/worktrees/emails-list/src/commands/topics/index.ts +42 -0
  87. package/.claude/worktrees/emails-list/src/commands/topics/list.ts +34 -0
  88. package/.claude/worktrees/emails-list/src/commands/topics/update.ts +59 -0
  89. package/.claude/worktrees/emails-list/src/commands/topics/utils.ts +16 -0
  90. package/.claude/worktrees/emails-list/src/commands/webhooks/create.ts +128 -0
  91. package/.claude/worktrees/emails-list/src/commands/webhooks/delete.ts +49 -0
  92. package/.claude/worktrees/emails-list/src/commands/webhooks/get.ts +42 -0
  93. package/.claude/worktrees/emails-list/src/commands/webhooks/index.ts +44 -0
  94. package/.claude/worktrees/emails-list/src/commands/webhooks/list.ts +55 -0
  95. package/.claude/worktrees/emails-list/src/commands/webhooks/update.ts +83 -0
  96. package/.claude/worktrees/emails-list/src/commands/webhooks/utils.ts +36 -0
  97. package/.claude/worktrees/emails-list/src/commands/whoami.ts +71 -0
  98. package/.claude/worktrees/emails-list/src/lib/actions.ts +157 -0
  99. package/.claude/worktrees/emails-list/src/lib/client.ts +34 -0
  100. package/.claude/worktrees/emails-list/src/lib/config.ts +211 -0
  101. package/.claude/worktrees/emails-list/src/lib/files.ts +15 -0
  102. package/.claude/worktrees/emails-list/src/lib/help-text.ts +38 -0
  103. package/.claude/worktrees/emails-list/src/lib/output.ts +54 -0
  104. package/.claude/worktrees/emails-list/src/lib/pagination.ts +36 -0
  105. package/.claude/worktrees/emails-list/src/lib/prompts.ts +149 -0
  106. package/.claude/worktrees/emails-list/src/lib/spinner.ts +93 -0
  107. package/.claude/worktrees/emails-list/src/lib/table.ts +57 -0
  108. package/.claude/worktrees/emails-list/src/lib/tty.ts +28 -0
  109. package/.claude/worktrees/emails-list/src/lib/version.ts +4 -0
  110. package/.claude/worktrees/emails-list/tests/commands/api-keys/create.test.ts +195 -0
  111. package/.claude/worktrees/emails-list/tests/commands/api-keys/delete.test.ts +156 -0
  112. package/.claude/worktrees/emails-list/tests/commands/api-keys/list.test.ts +133 -0
  113. package/.claude/worktrees/emails-list/tests/commands/auth/login.test.ts +119 -0
  114. package/.claude/worktrees/emails-list/tests/commands/auth/logout.test.ts +146 -0
  115. package/.claude/worktrees/emails-list/tests/commands/broadcasts/create.test.ts +447 -0
  116. package/.claude/worktrees/emails-list/tests/commands/broadcasts/delete.test.ts +182 -0
  117. package/.claude/worktrees/emails-list/tests/commands/broadcasts/get.test.ts +146 -0
  118. package/.claude/worktrees/emails-list/tests/commands/broadcasts/list.test.ts +196 -0
  119. package/.claude/worktrees/emails-list/tests/commands/broadcasts/send.test.ts +161 -0
  120. package/.claude/worktrees/emails-list/tests/commands/broadcasts/update.test.ts +283 -0
  121. package/.claude/worktrees/emails-list/tests/commands/contact-properties/create.test.ts +250 -0
  122. package/.claude/worktrees/emails-list/tests/commands/contact-properties/delete.test.ts +183 -0
  123. package/.claude/worktrees/emails-list/tests/commands/contact-properties/get.test.ts +144 -0
  124. package/.claude/worktrees/emails-list/tests/commands/contact-properties/list.test.ts +180 -0
  125. package/.claude/worktrees/emails-list/tests/commands/contact-properties/update.test.ts +216 -0
  126. package/.claude/worktrees/emails-list/tests/commands/contacts/add-segment.test.ts +188 -0
  127. package/.claude/worktrees/emails-list/tests/commands/contacts/create.test.ts +270 -0
  128. package/.claude/worktrees/emails-list/tests/commands/contacts/delete.test.ts +192 -0
  129. package/.claude/worktrees/emails-list/tests/commands/contacts/get.test.ts +148 -0
  130. package/.claude/worktrees/emails-list/tests/commands/contacts/list.test.ts +175 -0
  131. package/.claude/worktrees/emails-list/tests/commands/contacts/remove-segment.test.ts +166 -0
  132. package/.claude/worktrees/emails-list/tests/commands/contacts/segments.test.ts +167 -0
  133. package/.claude/worktrees/emails-list/tests/commands/contacts/topics.test.ts +163 -0
  134. package/.claude/worktrees/emails-list/tests/commands/contacts/update-topics.test.ts +247 -0
  135. package/.claude/worktrees/emails-list/tests/commands/contacts/update.test.ts +205 -0
  136. package/.claude/worktrees/emails-list/tests/commands/doctor.test.ts +165 -0
  137. package/.claude/worktrees/emails-list/tests/commands/domains/create.test.ts +192 -0
  138. package/.claude/worktrees/emails-list/tests/commands/domains/delete.test.ts +156 -0
  139. package/.claude/worktrees/emails-list/tests/commands/domains/get.test.ts +137 -0
  140. package/.claude/worktrees/emails-list/tests/commands/domains/list.test.ts +164 -0
  141. package/.claude/worktrees/emails-list/tests/commands/domains/update.test.ts +223 -0
  142. package/.claude/worktrees/emails-list/tests/commands/domains/verify.test.ts +117 -0
  143. package/.claude/worktrees/emails-list/tests/commands/emails/batch.test.ts +313 -0
  144. package/.claude/worktrees/emails-list/tests/commands/emails/list.test.ts +196 -0
  145. package/.claude/worktrees/emails-list/tests/commands/emails/receiving/attachment.test.ts +140 -0
  146. package/.claude/worktrees/emails-list/tests/commands/emails/receiving/attachments.test.ts +168 -0
  147. package/.claude/worktrees/emails-list/tests/commands/emails/receiving/get.test.ts +140 -0
  148. package/.claude/worktrees/emails-list/tests/commands/emails/receiving/list.test.ts +181 -0
  149. package/.claude/worktrees/emails-list/tests/commands/emails/send.test.ts +309 -0
  150. package/.claude/worktrees/emails-list/tests/commands/segments/create.test.ts +163 -0
  151. package/.claude/worktrees/emails-list/tests/commands/segments/delete.test.ts +182 -0
  152. package/.claude/worktrees/emails-list/tests/commands/segments/get.test.ts +137 -0
  153. package/.claude/worktrees/emails-list/tests/commands/segments/list.test.ts +173 -0
  154. package/.claude/worktrees/emails-list/tests/commands/teams/list.test.ts +63 -0
  155. package/.claude/worktrees/emails-list/tests/commands/teams/remove.test.ts +103 -0
  156. package/.claude/worktrees/emails-list/tests/commands/teams/switch.test.ts +96 -0
  157. package/.claude/worktrees/emails-list/tests/commands/topics/create.test.ts +191 -0
  158. package/.claude/worktrees/emails-list/tests/commands/topics/delete.test.ts +156 -0
  159. package/.claude/worktrees/emails-list/tests/commands/topics/get.test.ts +125 -0
  160. package/.claude/worktrees/emails-list/tests/commands/topics/list.test.ts +124 -0
  161. package/.claude/worktrees/emails-list/tests/commands/topics/update.test.ts +177 -0
  162. package/.claude/worktrees/emails-list/tests/commands/webhooks/create.test.ts +224 -0
  163. package/.claude/worktrees/emails-list/tests/commands/webhooks/delete.test.ts +156 -0
  164. package/.claude/worktrees/emails-list/tests/commands/webhooks/get.test.ts +125 -0
  165. package/.claude/worktrees/emails-list/tests/commands/webhooks/list.test.ts +177 -0
  166. package/.claude/worktrees/emails-list/tests/commands/webhooks/update.test.ts +206 -0
  167. package/.claude/worktrees/emails-list/tests/commands/whoami.test.ts +99 -0
  168. package/.claude/worktrees/emails-list/tests/helpers.ts +93 -0
  169. package/.claude/worktrees/emails-list/tests/lib/client.test.ts +71 -0
  170. package/.claude/worktrees/emails-list/tests/lib/config.test.ts +414 -0
  171. package/.claude/worktrees/emails-list/tests/lib/files.test.ts +65 -0
  172. package/.claude/worktrees/emails-list/tests/lib/help-text.test.ts +97 -0
  173. package/.claude/worktrees/emails-list/tests/lib/output.test.ts +127 -0
  174. package/.claude/worktrees/emails-list/tests/lib/prompts.test.ts +178 -0
  175. package/.claude/worktrees/emails-list/tests/lib/spinner.test.ts +146 -0
  176. package/.claude/worktrees/emails-list/tests/lib/table.test.ts +63 -0
  177. package/.claude/worktrees/emails-list/tests/lib/tty.test.ts +85 -0
  178. package/.claude/worktrees/emails-list/tsconfig.json +14 -0
  179. package/.github/workflows/ci.yml +3 -3
  180. package/.github/workflows/pr-title-check.yml +1 -1
  181. package/.github/workflows/release.yml +2 -2
  182. package/.github/workflows/test-build-windows.yml +44 -0
  183. package/.github/workflows/test-install-windows.yml +48 -0
  184. package/README.md +8 -0
  185. package/docs/agent-dx-gaps.md +167 -0
  186. package/docs/missing-commands.md +58 -0
  187. package/docs/production-readiness.md +99 -0
  188. package/docs/secure-key-storage.md +174 -0
  189. package/install.ps1 +1 -0
  190. package/install.sh +11 -4
  191. package/package.json +1 -1
  192. package/renovate.json +4 -0
  193. package/src/cli.ts +9 -0
  194. package/src/commands/auth/login.ts +34 -13
  195. package/src/commands/doctor.ts +3 -3
  196. package/src/commands/open.ts +24 -0
  197. package/src/commands/teams/remove.ts +5 -2
  198. package/src/commands/teams/switch.ts +3 -0
  199. package/src/lib/client.ts +6 -1
  200. package/src/lib/config.ts +37 -30
  201. package/src/lib/help-text.ts +4 -2
  202. package/src/lib/spinner.ts +7 -3
  203. package/tests/commands/auth/login.test.ts +35 -0
  204. package/tests/lib/config.test.ts +40 -7
  205. package/tests/lib/help-text.test.ts +2 -1
@@ -0,0 +1,167 @@
1
+ import {
2
+ afterEach,
3
+ beforeEach,
4
+ describe,
5
+ expect,
6
+ mock,
7
+ spyOn,
8
+ test,
9
+ } from 'bun:test';
10
+ import {
11
+ captureTestEnv,
12
+ expectExit1,
13
+ mockExitThrow,
14
+ mockSdkError,
15
+ setNonInteractive,
16
+ setupOutputSpies,
17
+ } from '../../helpers';
18
+
19
+ const mockListSegments = mock(async () => ({
20
+ data: {
21
+ object: 'list' as const,
22
+ data: [
23
+ {
24
+ id: '7b1e0a3d-4c5f-4e8a-9b2d-1a3c5e7f9b2d',
25
+ name: 'Newsletter',
26
+ created_at: '2026-01-01T00:00:00.000Z',
27
+ },
28
+ ],
29
+ has_more: false,
30
+ },
31
+ error: null,
32
+ }));
33
+
34
+ mock.module('resend', () => ({
35
+ Resend: class MockResend {
36
+ constructor(public key: string) {}
37
+ contacts = {
38
+ segments: { list: mockListSegments },
39
+ };
40
+ },
41
+ }));
42
+
43
+ describe('contacts segments command', () => {
44
+ const restoreEnv = captureTestEnv();
45
+ let spies: ReturnType<typeof setupOutputSpies> | undefined;
46
+ let errorSpy: ReturnType<typeof spyOn> | undefined;
47
+ let stderrSpy: ReturnType<typeof spyOn> | undefined;
48
+ let exitSpy: ReturnType<typeof spyOn> | undefined;
49
+
50
+ beforeEach(() => {
51
+ process.env.RESEND_API_KEY = 're_test_key';
52
+ mockListSegments.mockClear();
53
+ });
54
+
55
+ afterEach(() => {
56
+ restoreEnv();
57
+ spies?.restore();
58
+ errorSpy?.mockRestore();
59
+ stderrSpy?.mockRestore();
60
+ exitSpy?.mockRestore();
61
+ spies = undefined;
62
+ errorSpy = undefined;
63
+ stderrSpy = undefined;
64
+ exitSpy = undefined;
65
+ });
66
+
67
+ test('lists segments by contact ID', async () => {
68
+ spies = setupOutputSpies();
69
+
70
+ const { listContactSegmentsCommand } = await import(
71
+ '../../../src/commands/contacts/segments'
72
+ );
73
+ await listContactSegmentsCommand.parseAsync(
74
+ ['a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6'],
75
+ {
76
+ from: 'user',
77
+ },
78
+ );
79
+
80
+ expect(mockListSegments).toHaveBeenCalledTimes(1);
81
+ const args = mockListSegments.mock.calls[0][0] as Record<string, unknown>;
82
+ expect(args.contactId).toBe('a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6');
83
+ expect(args.email).toBeUndefined();
84
+ });
85
+
86
+ test('lists segments by contact email', async () => {
87
+ spies = setupOutputSpies();
88
+
89
+ const { listContactSegmentsCommand } = await import(
90
+ '../../../src/commands/contacts/segments'
91
+ );
92
+ await listContactSegmentsCommand.parseAsync(['jane@example.com'], {
93
+ from: 'user',
94
+ });
95
+
96
+ const args = mockListSegments.mock.calls[0][0] as Record<string, unknown>;
97
+ expect(args.email).toBe('jane@example.com');
98
+ expect(args.contactId).toBeUndefined();
99
+ });
100
+
101
+ test('outputs JSON list when non-interactive', async () => {
102
+ spies = setupOutputSpies();
103
+
104
+ const { listContactSegmentsCommand } = await import(
105
+ '../../../src/commands/contacts/segments'
106
+ );
107
+ await listContactSegmentsCommand.parseAsync(
108
+ ['a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6'],
109
+ {
110
+ from: 'user',
111
+ },
112
+ );
113
+
114
+ const output = spies.logSpy.mock.calls[0][0] as string;
115
+ const parsed = JSON.parse(output);
116
+ expect(parsed.object).toBe('list');
117
+ expect(parsed.data[0].name).toBe('Newsletter');
118
+ });
119
+
120
+ test('errors with auth_error when no API key', async () => {
121
+ setNonInteractive();
122
+ delete process.env.RESEND_API_KEY;
123
+ process.env.XDG_CONFIG_HOME = '/tmp/nonexistent-resend';
124
+ errorSpy = spyOn(console, 'error').mockImplementation(() => {});
125
+ exitSpy = mockExitThrow();
126
+
127
+ const { listContactSegmentsCommand } = await import(
128
+ '../../../src/commands/contacts/segments'
129
+ );
130
+ await expectExit1(() =>
131
+ listContactSegmentsCommand.parseAsync(
132
+ ['a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6'],
133
+ {
134
+ from: 'user',
135
+ },
136
+ ),
137
+ );
138
+
139
+ const output = errorSpy.mock.calls.map((c) => c[0]).join(' ');
140
+ expect(output).toContain('auth_error');
141
+ });
142
+
143
+ test('errors with list_error when SDK returns an error', async () => {
144
+ setNonInteractive();
145
+ mockListSegments.mockResolvedValueOnce(
146
+ mockSdkError('Not found', 'not_found'),
147
+ );
148
+ errorSpy = spyOn(console, 'error').mockImplementation(() => {});
149
+ stderrSpy = spyOn(process.stderr, 'write').mockImplementation(() => true);
150
+ exitSpy = mockExitThrow();
151
+
152
+ const { listContactSegmentsCommand } = await import(
153
+ '../../../src/commands/contacts/segments'
154
+ );
155
+ await expectExit1(() =>
156
+ listContactSegmentsCommand.parseAsync(
157
+ ['a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6'],
158
+ {
159
+ from: 'user',
160
+ },
161
+ ),
162
+ );
163
+
164
+ const output = errorSpy.mock.calls.map((c) => c[0]).join(' ');
165
+ expect(output).toContain('list_error');
166
+ });
167
+ });
@@ -0,0 +1,163 @@
1
+ import {
2
+ afterEach,
3
+ beforeEach,
4
+ describe,
5
+ expect,
6
+ mock,
7
+ spyOn,
8
+ test,
9
+ } from 'bun:test';
10
+ import {
11
+ captureTestEnv,
12
+ expectExit1,
13
+ mockExitThrow,
14
+ mockSdkError,
15
+ setNonInteractive,
16
+ setupOutputSpies,
17
+ } from '../../helpers';
18
+
19
+ const mockListTopics = mock(async () => ({
20
+ data: {
21
+ object: 'list' as const,
22
+ data: [
23
+ {
24
+ id: 'topic_abc',
25
+ name: 'Product Updates',
26
+ description: 'Updates about the product',
27
+ subscription: 'opt_in' as const,
28
+ },
29
+ ],
30
+ has_more: false,
31
+ },
32
+ error: null,
33
+ }));
34
+
35
+ mock.module('resend', () => ({
36
+ Resend: class MockResend {
37
+ constructor(public key: string) {}
38
+ contacts = {
39
+ topics: { list: mockListTopics },
40
+ };
41
+ },
42
+ }));
43
+
44
+ describe('contacts topics command', () => {
45
+ const restoreEnv = captureTestEnv();
46
+ let spies: ReturnType<typeof setupOutputSpies> | undefined;
47
+ let errorSpy: ReturnType<typeof spyOn> | undefined;
48
+ let stderrSpy: ReturnType<typeof spyOn> | undefined;
49
+ let exitSpy: ReturnType<typeof spyOn> | undefined;
50
+
51
+ beforeEach(() => {
52
+ process.env.RESEND_API_KEY = 're_test_key';
53
+ mockListTopics.mockClear();
54
+ });
55
+
56
+ afterEach(() => {
57
+ restoreEnv();
58
+ spies?.restore();
59
+ errorSpy?.mockRestore();
60
+ stderrSpy?.mockRestore();
61
+ exitSpy?.mockRestore();
62
+ spies = undefined;
63
+ errorSpy = undefined;
64
+ stderrSpy = undefined;
65
+ exitSpy = undefined;
66
+ });
67
+
68
+ test('lists topics by contact ID', async () => {
69
+ spies = setupOutputSpies();
70
+
71
+ const { listContactTopicsCommand } = await import(
72
+ '../../../src/commands/contacts/topics'
73
+ );
74
+ await listContactTopicsCommand.parseAsync(
75
+ ['a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6'],
76
+ {
77
+ from: 'user',
78
+ },
79
+ );
80
+
81
+ expect(mockListTopics).toHaveBeenCalledTimes(1);
82
+ const args = mockListTopics.mock.calls[0][0] as Record<string, unknown>;
83
+ expect(args.id).toBe('a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6');
84
+ });
85
+
86
+ test('lists topics by contact email', async () => {
87
+ spies = setupOutputSpies();
88
+
89
+ const { listContactTopicsCommand } = await import(
90
+ '../../../src/commands/contacts/topics'
91
+ );
92
+ await listContactTopicsCommand.parseAsync(['jane@example.com'], {
93
+ from: 'user',
94
+ });
95
+
96
+ const args = mockListTopics.mock.calls[0][0] as Record<string, unknown>;
97
+ expect(args.email).toBe('jane@example.com');
98
+ });
99
+
100
+ test('outputs JSON list when non-interactive', async () => {
101
+ spies = setupOutputSpies();
102
+
103
+ const { listContactTopicsCommand } = await import(
104
+ '../../../src/commands/contacts/topics'
105
+ );
106
+ await listContactTopicsCommand.parseAsync(
107
+ ['a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6'],
108
+ {
109
+ from: 'user',
110
+ },
111
+ );
112
+
113
+ const output = spies.logSpy.mock.calls[0][0] as string;
114
+ const parsed = JSON.parse(output);
115
+ expect(parsed.object).toBe('list');
116
+ expect(parsed.data[0].name).toBe('Product Updates');
117
+ expect(parsed.data[0].subscription).toBe('opt_in');
118
+ });
119
+
120
+ test('errors with auth_error when no API key', async () => {
121
+ setNonInteractive();
122
+ delete process.env.RESEND_API_KEY;
123
+ process.env.XDG_CONFIG_HOME = '/tmp/nonexistent-resend';
124
+ errorSpy = spyOn(console, 'error').mockImplementation(() => {});
125
+ exitSpy = mockExitThrow();
126
+
127
+ const { listContactTopicsCommand } = await import(
128
+ '../../../src/commands/contacts/topics'
129
+ );
130
+ await expectExit1(() =>
131
+ listContactTopicsCommand.parseAsync(
132
+ ['a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6'],
133
+ { from: 'user' },
134
+ ),
135
+ );
136
+
137
+ const output = errorSpy.mock.calls.map((c) => c[0]).join(' ');
138
+ expect(output).toContain('auth_error');
139
+ });
140
+
141
+ test('errors with list_error when SDK returns an error', async () => {
142
+ setNonInteractive();
143
+ mockListTopics.mockResolvedValueOnce(
144
+ mockSdkError('Not found', 'not_found'),
145
+ );
146
+ errorSpy = spyOn(console, 'error').mockImplementation(() => {});
147
+ stderrSpy = spyOn(process.stderr, 'write').mockImplementation(() => true);
148
+ exitSpy = mockExitThrow();
149
+
150
+ const { listContactTopicsCommand } = await import(
151
+ '../../../src/commands/contacts/topics'
152
+ );
153
+ await expectExit1(() =>
154
+ listContactTopicsCommand.parseAsync(
155
+ ['a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6'],
156
+ { from: 'user' },
157
+ ),
158
+ );
159
+
160
+ const output = errorSpy.mock.calls.map((c) => c[0]).join(' ');
161
+ expect(output).toContain('list_error');
162
+ });
163
+ });
@@ -0,0 +1,247 @@
1
+ import {
2
+ afterEach,
3
+ beforeEach,
4
+ describe,
5
+ expect,
6
+ mock,
7
+ spyOn,
8
+ test,
9
+ } from 'bun:test';
10
+ import {
11
+ captureTestEnv,
12
+ expectExit1,
13
+ mockExitThrow,
14
+ mockSdkError,
15
+ setNonInteractive,
16
+ setupOutputSpies,
17
+ } from '../../helpers';
18
+
19
+ const mockUpdateTopics = mock(async () => ({
20
+ data: { id: 'a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6' },
21
+ error: null,
22
+ }));
23
+
24
+ mock.module('resend', () => ({
25
+ Resend: class MockResend {
26
+ constructor(public key: string) {}
27
+ contacts = {
28
+ topics: { update: mockUpdateTopics },
29
+ };
30
+ },
31
+ }));
32
+
33
+ describe('contacts update-topics command', () => {
34
+ const restoreEnv = captureTestEnv();
35
+ let spies: ReturnType<typeof setupOutputSpies> | undefined;
36
+ let errorSpy: ReturnType<typeof spyOn> | undefined;
37
+ let stderrSpy: ReturnType<typeof spyOn> | undefined;
38
+ let exitSpy: ReturnType<typeof spyOn> | undefined;
39
+
40
+ beforeEach(() => {
41
+ process.env.RESEND_API_KEY = 're_test_key';
42
+ mockUpdateTopics.mockClear();
43
+ });
44
+
45
+ afterEach(() => {
46
+ restoreEnv();
47
+ spies?.restore();
48
+ errorSpy?.mockRestore();
49
+ stderrSpy?.mockRestore();
50
+ exitSpy?.mockRestore();
51
+ spies = undefined;
52
+ errorSpy = undefined;
53
+ stderrSpy = undefined;
54
+ exitSpy = undefined;
55
+ });
56
+
57
+ test('updates topics by contact ID', async () => {
58
+ spies = setupOutputSpies();
59
+
60
+ const { updateContactTopicsCommand } = await import(
61
+ '../../../src/commands/contacts/update-topics'
62
+ );
63
+ await updateContactTopicsCommand.parseAsync(
64
+ [
65
+ 'a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6',
66
+ '--topics',
67
+ '[{"id":"topic_abc","subscription":"opt_in"}]',
68
+ ],
69
+ { from: 'user' },
70
+ );
71
+
72
+ expect(mockUpdateTopics).toHaveBeenCalledTimes(1);
73
+ const args = mockUpdateTopics.mock.calls[0][0] as Record<string, unknown>;
74
+ expect(args.id).toBe('a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6');
75
+ expect(args.topics).toEqual([{ id: 'topic_abc', subscription: 'opt_in' }]);
76
+ });
77
+
78
+ test('updates topics by contact email', async () => {
79
+ spies = setupOutputSpies();
80
+
81
+ const { updateContactTopicsCommand } = await import(
82
+ '../../../src/commands/contacts/update-topics'
83
+ );
84
+ await updateContactTopicsCommand.parseAsync(
85
+ [
86
+ 'jane@example.com',
87
+ '--topics',
88
+ '[{"id":"topic_abc","subscription":"opt_out"}]',
89
+ ],
90
+ { from: 'user' },
91
+ );
92
+
93
+ const args = mockUpdateTopics.mock.calls[0][0] as Record<string, unknown>;
94
+ expect(args.email).toBe('jane@example.com');
95
+ expect(args.topics[0].subscription).toBe('opt_out');
96
+ });
97
+
98
+ test('passes multiple topics in array', async () => {
99
+ spies = setupOutputSpies();
100
+
101
+ const { updateContactTopicsCommand } = await import(
102
+ '../../../src/commands/contacts/update-topics'
103
+ );
104
+ await updateContactTopicsCommand.parseAsync(
105
+ [
106
+ 'a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6',
107
+ '--topics',
108
+ '[{"id":"t1","subscription":"opt_in"},{"id":"t2","subscription":"opt_out"}]',
109
+ ],
110
+ { from: 'user' },
111
+ );
112
+
113
+ const args = mockUpdateTopics.mock.calls[0][0] as Record<string, unknown>;
114
+ expect(args.topics).toHaveLength(2);
115
+ });
116
+
117
+ test('outputs JSON result when non-interactive', async () => {
118
+ spies = setupOutputSpies();
119
+
120
+ const { updateContactTopicsCommand } = await import(
121
+ '../../../src/commands/contacts/update-topics'
122
+ );
123
+ await updateContactTopicsCommand.parseAsync(
124
+ [
125
+ 'a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6',
126
+ '--topics',
127
+ '[{"id":"topic_abc","subscription":"opt_in"}]',
128
+ ],
129
+ { from: 'user' },
130
+ );
131
+
132
+ const output = spies.logSpy.mock.calls[0][0] as string;
133
+ const parsed = JSON.parse(output);
134
+ expect(parsed.id).toBe('a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6');
135
+ });
136
+
137
+ test('errors with missing_topics when --topics absent in non-interactive mode', async () => {
138
+ setNonInteractive();
139
+ errorSpy = spyOn(console, 'error').mockImplementation(() => {});
140
+ exitSpy = mockExitThrow();
141
+
142
+ const { updateContactTopicsCommand } = await import(
143
+ '../../../src/commands/contacts/update-topics'
144
+ );
145
+ await expectExit1(() =>
146
+ updateContactTopicsCommand.parseAsync(
147
+ ['a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6'],
148
+ {
149
+ from: 'user',
150
+ },
151
+ ),
152
+ );
153
+
154
+ const output = errorSpy.mock.calls.map((c) => c[0]).join(' ');
155
+ expect(output).toContain('missing_topics');
156
+ });
157
+
158
+ test('errors with invalid_topics when --topics is not valid JSON', async () => {
159
+ setNonInteractive();
160
+ errorSpy = spyOn(console, 'error').mockImplementation(() => {});
161
+ exitSpy = mockExitThrow();
162
+
163
+ const { updateContactTopicsCommand } = await import(
164
+ '../../../src/commands/contacts/update-topics'
165
+ );
166
+ await expectExit1(() =>
167
+ updateContactTopicsCommand.parseAsync(
168
+ ['a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6', '--topics', 'not-json'],
169
+ { from: 'user' },
170
+ ),
171
+ );
172
+
173
+ const output = errorSpy.mock.calls.map((c) => c[0]).join(' ');
174
+ expect(output).toContain('invalid_topics');
175
+ });
176
+
177
+ test('errors with invalid_topics when --topics is not an array', async () => {
178
+ setNonInteractive();
179
+ errorSpy = spyOn(console, 'error').mockImplementation(() => {});
180
+ exitSpy = mockExitThrow();
181
+
182
+ const { updateContactTopicsCommand } = await import(
183
+ '../../../src/commands/contacts/update-topics'
184
+ );
185
+ await expectExit1(() =>
186
+ updateContactTopicsCommand.parseAsync(
187
+ ['a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6', '--topics', '{"id":"t1"}'],
188
+ { from: 'user' },
189
+ ),
190
+ );
191
+
192
+ const output = errorSpy.mock.calls.map((c) => c[0]).join(' ');
193
+ expect(output).toContain('invalid_topics');
194
+ });
195
+
196
+ test('errors with auth_error when no API key', async () => {
197
+ setNonInteractive();
198
+ delete process.env.RESEND_API_KEY;
199
+ process.env.XDG_CONFIG_HOME = '/tmp/nonexistent-resend';
200
+ errorSpy = spyOn(console, 'error').mockImplementation(() => {});
201
+ exitSpy = mockExitThrow();
202
+
203
+ const { updateContactTopicsCommand } = await import(
204
+ '../../../src/commands/contacts/update-topics'
205
+ );
206
+ await expectExit1(() =>
207
+ updateContactTopicsCommand.parseAsync(
208
+ [
209
+ 'a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6',
210
+ '--topics',
211
+ '[{"id":"t1","subscription":"opt_in"}]',
212
+ ],
213
+ { from: 'user' },
214
+ ),
215
+ );
216
+
217
+ const output = errorSpy.mock.calls.map((c) => c[0]).join(' ');
218
+ expect(output).toContain('auth_error');
219
+ });
220
+
221
+ test('errors with update_topics_error when SDK returns an error', async () => {
222
+ setNonInteractive();
223
+ mockUpdateTopics.mockResolvedValueOnce(
224
+ mockSdkError('Topic not found', 'not_found'),
225
+ );
226
+ errorSpy = spyOn(console, 'error').mockImplementation(() => {});
227
+ stderrSpy = spyOn(process.stderr, 'write').mockImplementation(() => true);
228
+ exitSpy = mockExitThrow();
229
+
230
+ const { updateContactTopicsCommand } = await import(
231
+ '../../../src/commands/contacts/update-topics'
232
+ );
233
+ await expectExit1(() =>
234
+ updateContactTopicsCommand.parseAsync(
235
+ [
236
+ 'a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6',
237
+ '--topics',
238
+ '[{"id":"bad_topic","subscription":"opt_in"}]',
239
+ ],
240
+ { from: 'user' },
241
+ ),
242
+ );
243
+
244
+ const output = errorSpy.mock.calls.map((c) => c[0]).join(' ');
245
+ expect(output).toContain('update_topics_error');
246
+ });
247
+ });