resend-cli 1.2.0 → 1.2.2

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 (193) hide show
  1. package/.github/workflows/release.yml +35 -8
  2. package/README.md +12 -1
  3. package/biome.json +1 -1
  4. package/bun.lock +0 -3
  5. package/package.json +3 -4
  6. package/src/cli.ts +23 -5
  7. package/src/commands/auth/login.ts +10 -8
  8. package/src/commands/doctor.ts +30 -112
  9. package/src/lib/client.ts +3 -0
  10. package/src/lib/config.ts +2 -3
  11. package/src/lib/spinner.ts +17 -10
  12. package/src/lib/update-check.ts +172 -0
  13. package/tests/commands/auth/login.test.ts +3 -1
  14. package/tests/lib/config.test.ts +4 -6
  15. package/tests/lib/update-check.test.ts +169 -0
  16. package/.claude/worktrees/emails-list/.claude/settings.local.json +0 -5
  17. package/.claude/worktrees/emails-list/.github/scripts/pr-title-check.js +0 -34
  18. package/.claude/worktrees/emails-list/.github/workflows/ci.yml +0 -32
  19. package/.claude/worktrees/emails-list/.github/workflows/pr-title-check.yml +0 -13
  20. package/.claude/worktrees/emails-list/.github/workflows/release.yml +0 -93
  21. package/.claude/worktrees/emails-list/CHANGELOG.md +0 -31
  22. package/.claude/worktrees/emails-list/LICENSE +0 -21
  23. package/.claude/worktrees/emails-list/README.md +0 -424
  24. package/.claude/worktrees/emails-list/biome.json +0 -36
  25. package/.claude/worktrees/emails-list/bun.lock +0 -76
  26. package/.claude/worktrees/emails-list/bunfig.toml +0 -2
  27. package/.claude/worktrees/emails-list/install.ps1 +0 -140
  28. package/.claude/worktrees/emails-list/install.sh +0 -301
  29. package/.claude/worktrees/emails-list/package.json +0 -43
  30. package/.claude/worktrees/emails-list/renovate.json +0 -6
  31. package/.claude/worktrees/emails-list/src/cli.ts +0 -74
  32. package/.claude/worktrees/emails-list/src/commands/api-keys/create.ts +0 -114
  33. package/.claude/worktrees/emails-list/src/commands/api-keys/delete.ts +0 -47
  34. package/.claude/worktrees/emails-list/src/commands/api-keys/index.ts +0 -26
  35. package/.claude/worktrees/emails-list/src/commands/api-keys/list.ts +0 -35
  36. package/.claude/worktrees/emails-list/src/commands/api-keys/utils.ts +0 -8
  37. package/.claude/worktrees/emails-list/src/commands/auth/index.ts +0 -20
  38. package/.claude/worktrees/emails-list/src/commands/auth/login.ts +0 -207
  39. package/.claude/worktrees/emails-list/src/commands/auth/logout.ts +0 -105
  40. package/.claude/worktrees/emails-list/src/commands/broadcasts/create.ts +0 -196
  41. package/.claude/worktrees/emails-list/src/commands/broadcasts/delete.ts +0 -46
  42. package/.claude/worktrees/emails-list/src/commands/broadcasts/get.ts +0 -59
  43. package/.claude/worktrees/emails-list/src/commands/broadcasts/index.ts +0 -43
  44. package/.claude/worktrees/emails-list/src/commands/broadcasts/list.ts +0 -60
  45. package/.claude/worktrees/emails-list/src/commands/broadcasts/send.ts +0 -56
  46. package/.claude/worktrees/emails-list/src/commands/broadcasts/update.ts +0 -95
  47. package/.claude/worktrees/emails-list/src/commands/broadcasts/utils.ts +0 -35
  48. package/.claude/worktrees/emails-list/src/commands/contact-properties/create.ts +0 -118
  49. package/.claude/worktrees/emails-list/src/commands/contact-properties/delete.ts +0 -48
  50. package/.claude/worktrees/emails-list/src/commands/contact-properties/get.ts +0 -46
  51. package/.claude/worktrees/emails-list/src/commands/contact-properties/index.ts +0 -48
  52. package/.claude/worktrees/emails-list/src/commands/contact-properties/list.ts +0 -68
  53. package/.claude/worktrees/emails-list/src/commands/contact-properties/update.ts +0 -88
  54. package/.claude/worktrees/emails-list/src/commands/contact-properties/utils.ts +0 -17
  55. package/.claude/worktrees/emails-list/src/commands/contacts/add-segment.ts +0 -78
  56. package/.claude/worktrees/emails-list/src/commands/contacts/create.ts +0 -122
  57. package/.claude/worktrees/emails-list/src/commands/contacts/delete.ts +0 -49
  58. package/.claude/worktrees/emails-list/src/commands/contacts/get.ts +0 -53
  59. package/.claude/worktrees/emails-list/src/commands/contacts/index.ts +0 -58
  60. package/.claude/worktrees/emails-list/src/commands/contacts/list.ts +0 -57
  61. package/.claude/worktrees/emails-list/src/commands/contacts/remove-segment.ts +0 -48
  62. package/.claude/worktrees/emails-list/src/commands/contacts/segments.ts +0 -39
  63. package/.claude/worktrees/emails-list/src/commands/contacts/topics.ts +0 -45
  64. package/.claude/worktrees/emails-list/src/commands/contacts/update-topics.ts +0 -90
  65. package/.claude/worktrees/emails-list/src/commands/contacts/update.ts +0 -77
  66. package/.claude/worktrees/emails-list/src/commands/contacts/utils.ts +0 -119
  67. package/.claude/worktrees/emails-list/src/commands/doctor.ts +0 -298
  68. package/.claude/worktrees/emails-list/src/commands/domains/create.ts +0 -83
  69. package/.claude/worktrees/emails-list/src/commands/domains/delete.ts +0 -42
  70. package/.claude/worktrees/emails-list/src/commands/domains/get.ts +0 -47
  71. package/.claude/worktrees/emails-list/src/commands/domains/index.ts +0 -35
  72. package/.claude/worktrees/emails-list/src/commands/domains/list.ts +0 -53
  73. package/.claude/worktrees/emails-list/src/commands/domains/update.ts +0 -75
  74. package/.claude/worktrees/emails-list/src/commands/domains/utils.ts +0 -44
  75. package/.claude/worktrees/emails-list/src/commands/domains/verify.ts +0 -38
  76. package/.claude/worktrees/emails-list/src/commands/emails/batch.ts +0 -140
  77. package/.claude/worktrees/emails-list/src/commands/emails/index.ts +0 -28
  78. package/.claude/worktrees/emails-list/src/commands/emails/list.ts +0 -73
  79. package/.claude/worktrees/emails-list/src/commands/emails/receiving/attachment.ts +0 -55
  80. package/.claude/worktrees/emails-list/src/commands/emails/receiving/attachments.ts +0 -68
  81. package/.claude/worktrees/emails-list/src/commands/emails/receiving/get.ts +0 -58
  82. package/.claude/worktrees/emails-list/src/commands/emails/receiving/index.ts +0 -28
  83. package/.claude/worktrees/emails-list/src/commands/emails/receiving/list.ts +0 -59
  84. package/.claude/worktrees/emails-list/src/commands/emails/receiving/utils.ts +0 -38
  85. package/.claude/worktrees/emails-list/src/commands/emails/send.ts +0 -189
  86. package/.claude/worktrees/emails-list/src/commands/open.ts +0 -24
  87. package/.claude/worktrees/emails-list/src/commands/segments/create.ts +0 -50
  88. package/.claude/worktrees/emails-list/src/commands/segments/delete.ts +0 -47
  89. package/.claude/worktrees/emails-list/src/commands/segments/get.ts +0 -38
  90. package/.claude/worktrees/emails-list/src/commands/segments/index.ts +0 -36
  91. package/.claude/worktrees/emails-list/src/commands/segments/list.ts +0 -58
  92. package/.claude/worktrees/emails-list/src/commands/segments/utils.ts +0 -7
  93. package/.claude/worktrees/emails-list/src/commands/teams/index.ts +0 -10
  94. package/.claude/worktrees/emails-list/src/commands/teams/list.ts +0 -35
  95. package/.claude/worktrees/emails-list/src/commands/teams/remove.ts +0 -83
  96. package/.claude/worktrees/emails-list/src/commands/teams/switch.ts +0 -73
  97. package/.claude/worktrees/emails-list/src/commands/topics/create.ts +0 -73
  98. package/.claude/worktrees/emails-list/src/commands/topics/delete.ts +0 -47
  99. package/.claude/worktrees/emails-list/src/commands/topics/get.ts +0 -42
  100. package/.claude/worktrees/emails-list/src/commands/topics/index.ts +0 -42
  101. package/.claude/worktrees/emails-list/src/commands/topics/list.ts +0 -34
  102. package/.claude/worktrees/emails-list/src/commands/topics/update.ts +0 -59
  103. package/.claude/worktrees/emails-list/src/commands/topics/utils.ts +0 -16
  104. package/.claude/worktrees/emails-list/src/commands/webhooks/create.ts +0 -128
  105. package/.claude/worktrees/emails-list/src/commands/webhooks/delete.ts +0 -49
  106. package/.claude/worktrees/emails-list/src/commands/webhooks/get.ts +0 -42
  107. package/.claude/worktrees/emails-list/src/commands/webhooks/index.ts +0 -44
  108. package/.claude/worktrees/emails-list/src/commands/webhooks/list.ts +0 -55
  109. package/.claude/worktrees/emails-list/src/commands/webhooks/update.ts +0 -83
  110. package/.claude/worktrees/emails-list/src/commands/webhooks/utils.ts +0 -36
  111. package/.claude/worktrees/emails-list/src/commands/whoami.ts +0 -71
  112. package/.claude/worktrees/emails-list/src/lib/actions.ts +0 -157
  113. package/.claude/worktrees/emails-list/src/lib/client.ts +0 -34
  114. package/.claude/worktrees/emails-list/src/lib/config.ts +0 -211
  115. package/.claude/worktrees/emails-list/src/lib/files.ts +0 -15
  116. package/.claude/worktrees/emails-list/src/lib/help-text.ts +0 -38
  117. package/.claude/worktrees/emails-list/src/lib/output.ts +0 -54
  118. package/.claude/worktrees/emails-list/src/lib/pagination.ts +0 -36
  119. package/.claude/worktrees/emails-list/src/lib/prompts.ts +0 -149
  120. package/.claude/worktrees/emails-list/src/lib/spinner.ts +0 -93
  121. package/.claude/worktrees/emails-list/src/lib/table.ts +0 -57
  122. package/.claude/worktrees/emails-list/src/lib/tty.ts +0 -28
  123. package/.claude/worktrees/emails-list/src/lib/version.ts +0 -4
  124. package/.claude/worktrees/emails-list/tests/commands/api-keys/create.test.ts +0 -195
  125. package/.claude/worktrees/emails-list/tests/commands/api-keys/delete.test.ts +0 -156
  126. package/.claude/worktrees/emails-list/tests/commands/api-keys/list.test.ts +0 -133
  127. package/.claude/worktrees/emails-list/tests/commands/auth/login.test.ts +0 -119
  128. package/.claude/worktrees/emails-list/tests/commands/auth/logout.test.ts +0 -146
  129. package/.claude/worktrees/emails-list/tests/commands/broadcasts/create.test.ts +0 -447
  130. package/.claude/worktrees/emails-list/tests/commands/broadcasts/delete.test.ts +0 -182
  131. package/.claude/worktrees/emails-list/tests/commands/broadcasts/get.test.ts +0 -146
  132. package/.claude/worktrees/emails-list/tests/commands/broadcasts/list.test.ts +0 -196
  133. package/.claude/worktrees/emails-list/tests/commands/broadcasts/send.test.ts +0 -161
  134. package/.claude/worktrees/emails-list/tests/commands/broadcasts/update.test.ts +0 -283
  135. package/.claude/worktrees/emails-list/tests/commands/contact-properties/create.test.ts +0 -250
  136. package/.claude/worktrees/emails-list/tests/commands/contact-properties/delete.test.ts +0 -183
  137. package/.claude/worktrees/emails-list/tests/commands/contact-properties/get.test.ts +0 -144
  138. package/.claude/worktrees/emails-list/tests/commands/contact-properties/list.test.ts +0 -180
  139. package/.claude/worktrees/emails-list/tests/commands/contact-properties/update.test.ts +0 -216
  140. package/.claude/worktrees/emails-list/tests/commands/contacts/add-segment.test.ts +0 -188
  141. package/.claude/worktrees/emails-list/tests/commands/contacts/create.test.ts +0 -270
  142. package/.claude/worktrees/emails-list/tests/commands/contacts/delete.test.ts +0 -192
  143. package/.claude/worktrees/emails-list/tests/commands/contacts/get.test.ts +0 -148
  144. package/.claude/worktrees/emails-list/tests/commands/contacts/list.test.ts +0 -175
  145. package/.claude/worktrees/emails-list/tests/commands/contacts/remove-segment.test.ts +0 -166
  146. package/.claude/worktrees/emails-list/tests/commands/contacts/segments.test.ts +0 -167
  147. package/.claude/worktrees/emails-list/tests/commands/contacts/topics.test.ts +0 -163
  148. package/.claude/worktrees/emails-list/tests/commands/contacts/update-topics.test.ts +0 -247
  149. package/.claude/worktrees/emails-list/tests/commands/contacts/update.test.ts +0 -205
  150. package/.claude/worktrees/emails-list/tests/commands/doctor.test.ts +0 -165
  151. package/.claude/worktrees/emails-list/tests/commands/domains/create.test.ts +0 -192
  152. package/.claude/worktrees/emails-list/tests/commands/domains/delete.test.ts +0 -156
  153. package/.claude/worktrees/emails-list/tests/commands/domains/get.test.ts +0 -137
  154. package/.claude/worktrees/emails-list/tests/commands/domains/list.test.ts +0 -164
  155. package/.claude/worktrees/emails-list/tests/commands/domains/update.test.ts +0 -223
  156. package/.claude/worktrees/emails-list/tests/commands/domains/verify.test.ts +0 -117
  157. package/.claude/worktrees/emails-list/tests/commands/emails/batch.test.ts +0 -313
  158. package/.claude/worktrees/emails-list/tests/commands/emails/list.test.ts +0 -196
  159. package/.claude/worktrees/emails-list/tests/commands/emails/receiving/attachment.test.ts +0 -140
  160. package/.claude/worktrees/emails-list/tests/commands/emails/receiving/attachments.test.ts +0 -168
  161. package/.claude/worktrees/emails-list/tests/commands/emails/receiving/get.test.ts +0 -140
  162. package/.claude/worktrees/emails-list/tests/commands/emails/receiving/list.test.ts +0 -181
  163. package/.claude/worktrees/emails-list/tests/commands/emails/send.test.ts +0 -309
  164. package/.claude/worktrees/emails-list/tests/commands/segments/create.test.ts +0 -163
  165. package/.claude/worktrees/emails-list/tests/commands/segments/delete.test.ts +0 -182
  166. package/.claude/worktrees/emails-list/tests/commands/segments/get.test.ts +0 -137
  167. package/.claude/worktrees/emails-list/tests/commands/segments/list.test.ts +0 -173
  168. package/.claude/worktrees/emails-list/tests/commands/teams/list.test.ts +0 -63
  169. package/.claude/worktrees/emails-list/tests/commands/teams/remove.test.ts +0 -103
  170. package/.claude/worktrees/emails-list/tests/commands/teams/switch.test.ts +0 -96
  171. package/.claude/worktrees/emails-list/tests/commands/topics/create.test.ts +0 -191
  172. package/.claude/worktrees/emails-list/tests/commands/topics/delete.test.ts +0 -156
  173. package/.claude/worktrees/emails-list/tests/commands/topics/get.test.ts +0 -125
  174. package/.claude/worktrees/emails-list/tests/commands/topics/list.test.ts +0 -124
  175. package/.claude/worktrees/emails-list/tests/commands/topics/update.test.ts +0 -177
  176. package/.claude/worktrees/emails-list/tests/commands/webhooks/create.test.ts +0 -224
  177. package/.claude/worktrees/emails-list/tests/commands/webhooks/delete.test.ts +0 -156
  178. package/.claude/worktrees/emails-list/tests/commands/webhooks/get.test.ts +0 -125
  179. package/.claude/worktrees/emails-list/tests/commands/webhooks/list.test.ts +0 -177
  180. package/.claude/worktrees/emails-list/tests/commands/webhooks/update.test.ts +0 -206
  181. package/.claude/worktrees/emails-list/tests/commands/whoami.test.ts +0 -99
  182. package/.claude/worktrees/emails-list/tests/helpers.ts +0 -93
  183. package/.claude/worktrees/emails-list/tests/lib/client.test.ts +0 -71
  184. package/.claude/worktrees/emails-list/tests/lib/config.test.ts +0 -414
  185. package/.claude/worktrees/emails-list/tests/lib/files.test.ts +0 -65
  186. package/.claude/worktrees/emails-list/tests/lib/help-text.test.ts +0 -97
  187. package/.claude/worktrees/emails-list/tests/lib/output.test.ts +0 -127
  188. package/.claude/worktrees/emails-list/tests/lib/prompts.test.ts +0 -178
  189. package/.claude/worktrees/emails-list/tests/lib/spinner.test.ts +0 -146
  190. package/.claude/worktrees/emails-list/tests/lib/table.test.ts +0 -63
  191. package/.claude/worktrees/emails-list/tests/lib/tty.test.ts +0 -85
  192. package/.claude/worktrees/emails-list/tsconfig.json +0 -14
  193. package/.github/workflows/test-build-windows.yml +0 -44
@@ -1,35 +0,0 @@
1
- import { Command } from '@commander-js/extra-typings';
2
- import { buildHelpText } from '../../lib/help-text';
3
- import { createDomainCommand } from './create';
4
- import { deleteDomainCommand } from './delete';
5
- import { getDomainCommand } from './get';
6
- import { listDomainsCommand } from './list';
7
- import { updateDomainCommand } from './update';
8
- import { verifyDomainCommand } from './verify';
9
-
10
- export const domainsCommand = new Command('domains')
11
- .description('Manage verified sending and receiving domains')
12
- .addHelpText(
13
- 'after',
14
- buildHelpText({
15
- context: `Domain lifecycle:
16
- 1. resend domains create --name example.com (get DNS records)
17
- 2. Configure DNS records at your DNS provider
18
- 3. resend domains verify <id> (trigger verification)
19
- 4. resend domains get <id> (poll until "verified")`,
20
- examples: [
21
- 'resend domains list',
22
- 'resend domains create --name example.com --region us-east-1',
23
- 'resend domains verify 4dd369bc-aa82-4ff3-97de-514ae3000ee0',
24
- 'resend domains get 4dd369bc-aa82-4ff3-97de-514ae3000ee0',
25
- 'resend domains update <id> --tls enforced --open-tracking',
26
- 'resend domains delete <id> --yes',
27
- ],
28
- }),
29
- )
30
- .addCommand(createDomainCommand)
31
- .addCommand(verifyDomainCommand)
32
- .addCommand(getDomainCommand)
33
- .addCommand(listDomainsCommand, { isDefault: true })
34
- .addCommand(updateDomainCommand)
35
- .addCommand(deleteDomainCommand);
@@ -1,53 +0,0 @@
1
- import { Command } from '@commander-js/extra-typings';
2
- import { runList } from '../../lib/actions';
3
- import type { GlobalOpts } from '../../lib/client';
4
- import { buildHelpText } from '../../lib/help-text';
5
- import {
6
- buildPaginationOpts,
7
- parseLimitOpt,
8
- printPaginationHint,
9
- } from '../../lib/pagination';
10
- import { renderDomainsTable } from './utils';
11
-
12
- export const listDomainsCommand = new Command('list')
13
- .alias('ls')
14
- .description('List all domains')
15
- .option('--limit <n>', 'Maximum number of domains to return (1-100)', '10')
16
- .option('--after <cursor>', 'Return domains after this cursor (next page)')
17
- .option(
18
- '--before <cursor>',
19
- 'Return domains before this cursor (previous page)',
20
- )
21
- .addHelpText(
22
- 'after',
23
- buildHelpText({
24
- output:
25
- ' {"object":"list","data":[...],"has_more":true}\n The list response does not include DNS records — use "resend domains get <id>" for that.',
26
- errorCodes: ['auth_error', 'invalid_limit', 'list_error'],
27
- examples: [
28
- 'resend domains list',
29
- 'resend domains list --limit 25 --json',
30
- 'resend domains list --after <cursor> --json',
31
- ],
32
- }),
33
- )
34
- .action(async (opts, cmd) => {
35
- const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
36
- const limit = parseLimitOpt(opts.limit, globalOpts);
37
- const paginationOpts = buildPaginationOpts(limit, opts.after, opts.before);
38
- await runList(
39
- {
40
- spinner: {
41
- loading: 'Fetching domains...',
42
- success: 'Domains fetched',
43
- fail: 'Failed to list domains',
44
- },
45
- sdkCall: (resend) => resend.domains.list(paginationOpts),
46
- onInteractive: (list) => {
47
- console.log(renderDomainsTable(list.data));
48
- printPaginationHint(list);
49
- },
50
- },
51
- globalOpts,
52
- );
53
- });
@@ -1,75 +0,0 @@
1
- import { Command, Option } from '@commander-js/extra-typings';
2
- import type { UpdateDomainsOptions } from 'resend';
3
- import { runWrite } from '../../lib/actions';
4
- import type { GlobalOpts } from '../../lib/client';
5
- import { buildHelpText } from '../../lib/help-text';
6
- import { outputError } from '../../lib/output';
7
-
8
- export const updateDomainCommand = new Command('update')
9
- .description(
10
- 'Update domain settings: TLS mode, open tracking, and click tracking',
11
- )
12
- .argument('<id>', 'Domain ID')
13
- .addOption(
14
- new Option('--tls <mode>', 'TLS mode').choices([
15
- 'opportunistic',
16
- 'enforced',
17
- ] as const),
18
- )
19
- .option('--open-tracking', 'Enable open tracking')
20
- .option('--no-open-tracking', 'Disable open tracking')
21
- .option('--click-tracking', 'Enable click tracking')
22
- .option('--no-click-tracking', 'Disable click tracking')
23
- .addHelpText(
24
- 'after',
25
- buildHelpText({
26
- output: ' {"object":"domain","id":"<id>"}',
27
- errorCodes: ['auth_error', 'no_changes', 'update_error'],
28
- examples: [
29
- 'resend domains update <id> --tls enforced',
30
- 'resend domains update <id> --open-tracking --click-tracking',
31
- 'resend domains update <id> --no-open-tracking --json',
32
- ],
33
- }),
34
- )
35
- .action(async (id, opts, cmd) => {
36
- const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
37
-
38
- const { tls, openTracking, clickTracking } = opts;
39
-
40
- if (!tls && openTracking === undefined && clickTracking === undefined) {
41
- outputError(
42
- {
43
- message:
44
- 'Provide at least one option to update: --tls, --open-tracking, or --click-tracking.',
45
- code: 'no_changes',
46
- },
47
- { json: globalOpts.json },
48
- );
49
- }
50
-
51
- const payload: UpdateDomainsOptions = { id };
52
- if (tls) {
53
- payload.tls = tls;
54
- }
55
- if (openTracking !== undefined) {
56
- payload.openTracking = openTracking;
57
- }
58
- if (clickTracking !== undefined) {
59
- payload.clickTracking = clickTracking;
60
- }
61
-
62
- await runWrite(
63
- {
64
- spinner: {
65
- loading: 'Updating domain...',
66
- success: 'Domain updated',
67
- fail: 'Failed to update domain',
68
- },
69
- sdkCall: (resend) => resend.domains.update(payload),
70
- errorCode: 'update_error',
71
- successMsg: `Domain updated: ${id}`,
72
- },
73
- globalOpts,
74
- );
75
- });
@@ -1,44 +0,0 @@
1
- import type { DomainRecords } from 'resend';
2
- import { renderTable } from '../../lib/table';
3
-
4
- export function renderDnsRecordsTable(
5
- records: DomainRecords[],
6
- domainName: string,
7
- ): string {
8
- const rows = records.map((r) => {
9
- const displayName = r.name
10
- ? r.name.includes('.')
11
- ? r.name
12
- : `${r.name}.${domainName}`
13
- : domainName;
14
- return [r.type, displayName, r.ttl, r.value];
15
- });
16
- return renderTable(
17
- ['Type', 'Name', 'TTL', 'Value'],
18
- rows,
19
- '(no DNS records)',
20
- );
21
- }
22
-
23
- export function renderDomainsTable(
24
- domains: Array<{ id: string; name: string; status: string; region: string }>,
25
- ): string {
26
- const rows = domains.map((d) => [d.name, d.status, d.region, d.id]);
27
- return renderTable(['Name', 'Status', 'Region', 'ID'], rows, '(no domains)');
28
- }
29
-
30
- export function statusIndicator(status: string): string {
31
- switch (status) {
32
- case 'verified':
33
- return '✓ Verified';
34
- case 'pending':
35
- return '⏳ Pending';
36
- case 'not_started':
37
- return '○ Not started';
38
- case 'failed':
39
- case 'temporary_failure':
40
- return '✗ Failed';
41
- default:
42
- return status;
43
- }
44
- }
@@ -1,38 +0,0 @@
1
- import { Command } from '@commander-js/extra-typings';
2
- import { runWrite } from '../../lib/actions';
3
- import type { GlobalOpts } from '../../lib/client';
4
- import { buildHelpText } from '../../lib/help-text';
5
-
6
- export const verifyDomainCommand = new Command('verify')
7
- .description('Trigger async DNS verification for a domain')
8
- .argument('<id>', 'Domain ID')
9
- .addHelpText(
10
- 'after',
11
- buildHelpText({
12
- context: `Verification is async — the domain enters "pending" status while DNS records are checked.
13
- Poll the status with: resend domains get <id>`,
14
- output: ' {"object":"domain","id":"<id>"}',
15
- errorCodes: ['auth_error', 'verify_error'],
16
- examples: [
17
- 'resend domains verify 4dd369bc-aa82-4ff3-97de-514ae3000ee0',
18
- 'resend domains verify 4dd369bc-aa82-4ff3-97de-514ae3000ee0 --json',
19
- ],
20
- }),
21
- )
22
- .action(async (id, _opts, cmd) => {
23
- const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
24
-
25
- await runWrite(
26
- {
27
- spinner: {
28
- loading: 'Verifying domain...',
29
- success: 'Verification started',
30
- fail: 'Failed to verify domain',
31
- },
32
- sdkCall: (resend) => resend.domains.verify(id),
33
- errorCode: 'verify_error',
34
- successMsg: `Domain verification started. Check status with resend domains get ${id}.`,
35
- },
36
- globalOpts,
37
- );
38
- });
@@ -1,140 +0,0 @@
1
- import { Command } from '@commander-js/extra-typings';
2
- import type { CreateBatchOptions } from 'resend';
3
- import type { GlobalOpts } from '../../lib/client';
4
- import { requireClient } from '../../lib/client';
5
- import { readFile } from '../../lib/files';
6
- import { buildHelpText } from '../../lib/help-text';
7
- import { outputError, outputResult } from '../../lib/output';
8
- import { requireText } from '../../lib/prompts';
9
- import { withSpinner } from '../../lib/spinner';
10
- import { isInteractive } from '../../lib/tty';
11
-
12
- export const batchCommand = new Command('batch')
13
- .description('Send up to 100 emails in a single API request from a JSON file')
14
- .option(
15
- '--file <path>',
16
- 'Path to a JSON file containing an array of email objects (required in non-interactive mode)',
17
- )
18
- .option(
19
- '--idempotency-key <key>',
20
- 'Deduplicate this batch request using this key',
21
- )
22
- .addHelpText(
23
- 'after',
24
- buildHelpText({
25
- context:
26
- 'Non-interactive: --file\nLimit: 100 emails per request (API hard limit — warned if exceeded)\nUnsupported per-email fields: attachments, scheduled_at\n\nFile format (--file path):\n [\n {"from":"you@domain.com","to":["user@example.com"],"subject":"Hello","text":"Hi"},\n {"from":"you@domain.com","to":["other@example.com"],"subject":"Hello","html":"<b>Hi</b>"}\n ]',
27
- output: ' [{"id":"<email-id>"},{"id":"<email-id>"}]',
28
- errorCodes: [
29
- 'auth_error',
30
- 'missing_file',
31
- 'file_read_error',
32
- 'invalid_json',
33
- 'invalid_format',
34
- 'batch_error',
35
- ],
36
- examples: [
37
- 'resend emails batch --file ./emails.json',
38
- 'resend emails batch --file ./emails.json --json',
39
- 'resend emails batch --file ./emails.json --idempotency-key my-batch-2026-02-18',
40
- 'RESEND_API_KEY=re_123 resend emails batch --file ./emails.json --json',
41
- ],
42
- }),
43
- )
44
- .action(async (opts, cmd) => {
45
- const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
46
-
47
- const resend = requireClient(globalOpts);
48
-
49
- const filePath = await requireText(
50
- opts.file,
51
- { message: 'Path to JSON file', placeholder: './emails.json' },
52
- {
53
- message:
54
- 'Missing --file flag. Provide a JSON file with an array of email objects.',
55
- code: 'missing_file',
56
- },
57
- globalOpts,
58
- );
59
-
60
- const raw = readFile(filePath, globalOpts);
61
-
62
- let parsed: unknown;
63
- try {
64
- parsed = JSON.parse(raw);
65
- } catch {
66
- outputError(
67
- { message: 'File content is not valid JSON.', code: 'invalid_json' },
68
- { json: globalOpts.json },
69
- );
70
- }
71
-
72
- if (!Array.isArray(parsed)) {
73
- outputError(
74
- {
75
- message: 'File content must be a JSON array of email objects.',
76
- code: 'invalid_format',
77
- },
78
- { json: globalOpts.json },
79
- );
80
- }
81
-
82
- const emails = parsed as unknown[];
83
-
84
- if (emails.length > 100) {
85
- console.warn(
86
- `Warning: ${emails.length} emails exceeds the 100-email limit. The API may reject this request.`,
87
- );
88
- }
89
-
90
- for (let i = 0; i < emails.length; i++) {
91
- const email = emails[i] as Record<string, unknown>;
92
- if ('attachments' in email) {
93
- outputError(
94
- {
95
- message: `Email at index ${i} contains "attachments", which is not supported in batch sends.`,
96
- code: 'batch_error',
97
- },
98
- { json: globalOpts.json },
99
- );
100
- }
101
- if ('scheduled_at' in email) {
102
- outputError(
103
- {
104
- message: `Email at index ${i} contains "scheduled_at", which is not supported in batch sends.`,
105
- code: 'batch_error',
106
- },
107
- { json: globalOpts.json },
108
- );
109
- }
110
- }
111
-
112
- const batchData = await withSpinner(
113
- {
114
- loading: 'Sending batch...',
115
- success: 'Batch sent',
116
- fail: 'Failed to send batch',
117
- },
118
- () =>
119
- resend.batch.send(
120
- emails as CreateBatchOptions,
121
- opts.idempotencyKey
122
- ? { idempotencyKey: opts.idempotencyKey }
123
- : undefined,
124
- ),
125
- 'batch_error',
126
- globalOpts,
127
- );
128
-
129
- const emailIds = batchData.data;
130
- if (!globalOpts.json && isInteractive()) {
131
- console.log(
132
- `Sent ${emailIds.length} email${emailIds.length === 1 ? '' : 's'}`,
133
- );
134
- for (const email of emailIds) {
135
- console.log(` ${email.id}`);
136
- }
137
- } else {
138
- outputResult(emailIds, { json: globalOpts.json });
139
- }
140
- });
@@ -1,28 +0,0 @@
1
- import { Command } from '@commander-js/extra-typings';
2
- import { buildHelpText } from '../../lib/help-text';
3
- import { batchCommand } from './batch';
4
- import { listCommand } from './list';
5
- import { receivingCommand } from './receiving/index';
6
- import { sendCommand } from './send';
7
-
8
- export const emailsCommand = new Command('emails')
9
- .description('Send and manage emails')
10
- .addHelpText(
11
- 'after',
12
- buildHelpText({
13
- examples: [
14
- 'resend emails send --from you@domain.com --to user@example.com --subject "Hello" --text "Hi"',
15
- 'resend emails list',
16
- 'resend emails list --limit 25 --json',
17
- 'resend emails batch --file ./emails.json',
18
- 'resend emails receiving list',
19
- 'resend emails receiving get <email-id>',
20
- 'resend emails receiving attachments <email-id>',
21
- 'resend emails receiving attachment <email-id> <attachment-id>',
22
- ],
23
- }),
24
- )
25
- .addCommand(sendCommand)
26
- .addCommand(listCommand)
27
- .addCommand(batchCommand)
28
- .addCommand(receivingCommand);
@@ -1,73 +0,0 @@
1
- import { Command } from '@commander-js/extra-typings';
2
- import type { ListEmail } from 'resend';
3
- import { runList } from '../../lib/actions';
4
- import type { GlobalOpts } from '../../lib/client';
5
- import { buildHelpText } from '../../lib/help-text';
6
- import {
7
- buildPaginationOpts,
8
- parseLimitOpt,
9
- printPaginationHint,
10
- } from '../../lib/pagination';
11
- import { renderTable } from '../../lib/table';
12
-
13
- function renderEmailsTable(emails: ListEmail[]): string {
14
- const rows = emails.map((e) => {
15
- const to = e.to.join(', ');
16
- const toStr = to.length > 40 ? `${to.slice(0, 37)}...` : to;
17
- const subject =
18
- e.subject.length > 50 ? `${e.subject.slice(0, 47)}...` : e.subject;
19
- return [e.from, toStr, subject, e.last_event, e.created_at, e.id];
20
- });
21
- return renderTable(
22
- ['From', 'To', 'Subject', 'Last Event', 'Created At', 'ID'],
23
- rows,
24
- '(no emails)',
25
- );
26
- }
27
-
28
- export const listCommand = new Command('list')
29
- .alias('ls')
30
- .description('List sent emails')
31
- .option('--limit <n>', 'Maximum number of emails to return (1-100)', '10')
32
- .option('--after <cursor>', 'Return emails after this cursor (next page)')
33
- .option(
34
- '--before <cursor>',
35
- 'Return emails before this cursor (previous page)',
36
- )
37
- .addHelpText(
38
- 'after',
39
- buildHelpText({
40
- context:
41
- 'Pagination: use --after or --before with an email ID as the cursor.\nOnly one of --after or --before may be used at a time.\nThe response includes has_more: true when additional pages exist.',
42
- output:
43
- ' {"object":"list","has_more":false,"data":[{"id":"<uuid>","from":"you@domain.com","to":["user@example.com"],"subject":"Hello","created_at":"<iso-date>","last_event":"delivered","bcc":null,"cc":null,"reply_to":null}]}',
44
- errorCodes: ['auth_error', 'invalid_limit', 'list_error'],
45
- examples: [
46
- 'resend emails list',
47
- 'resend emails list --limit 25 --json',
48
- 'resend emails list --after <email-id> --json',
49
- ],
50
- }),
51
- )
52
- .action(async (opts, cmd) => {
53
- const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
54
-
55
- const limit = parseLimitOpt(opts.limit, globalOpts);
56
- const paginationOpts = buildPaginationOpts(limit, opts.after, opts.before);
57
-
58
- await runList(
59
- {
60
- spinner: {
61
- loading: 'Fetching emails...',
62
- success: 'Emails fetched',
63
- fail: 'Failed to list emails',
64
- },
65
- sdkCall: (resend) => resend.emails.list(paginationOpts),
66
- onInteractive: (list) => {
67
- console.log(renderEmailsTable(list.data));
68
- printPaginationHint(list);
69
- },
70
- },
71
- globalOpts,
72
- );
73
- });
@@ -1,55 +0,0 @@
1
- import { Command } from '@commander-js/extra-typings';
2
- import type { GlobalOpts } from '../../../lib/client';
3
- import { requireClient } from '../../../lib/client';
4
- import { buildHelpText } from '../../../lib/help-text';
5
- import { outputResult } from '../../../lib/output';
6
- import { withSpinner } from '../../../lib/spinner';
7
- import { isInteractive } from '../../../lib/tty';
8
-
9
- export const getAttachmentCommand = new Command('attachment')
10
- .description('Retrieve a single attachment from a received (inbound) email')
11
- .argument('<emailId>', 'Received email UUID')
12
- .argument('<attachmentId>', 'Attachment UUID')
13
- .addHelpText(
14
- 'after',
15
- buildHelpText({
16
- context:
17
- 'The download_url is a signed URL that expires in ~1 hour. Download the file directly:\n resend emails receiving attachment <emailId> <attachmentId> --json | jq -r .download_url | xargs curl -O',
18
- output:
19
- ' {"object":"attachment","id":"<uuid>","filename":"invoice.pdf","size":51200,"content_type":"application/pdf","content_disposition":"attachment","content_id":null,"download_url":"<signed-url>","expires_at":"<iso-date>"}',
20
- errorCodes: ['auth_error', 'fetch_error'],
21
- examples: [
22
- 'resend emails receiving attachment <email-id> <attachment-id>',
23
- 'resend emails receiving attachment <email-id> <attachment-id> --json',
24
- ],
25
- }),
26
- )
27
- .action(async (emailId, attachmentId, _opts, cmd) => {
28
- const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
29
- const resend = requireClient(globalOpts);
30
-
31
- const data = await withSpinner(
32
- {
33
- loading: 'Fetching attachment...',
34
- success: 'Attachment fetched',
35
- fail: 'Failed to fetch attachment',
36
- },
37
- () =>
38
- resend.emails.receiving.attachments.get({ emailId, id: attachmentId }),
39
- 'fetch_error',
40
- globalOpts,
41
- );
42
-
43
- if (!globalOpts.json && isInteractive()) {
44
- const d = data;
45
- console.log(`\n${d.filename ?? '(unnamed)'}`);
46
- console.log(`ID: ${d.id}`);
47
- console.log(`Content-Type: ${d.content_type}`);
48
- console.log(`Size: ${d.size} bytes`);
49
- console.log(`Disposition: ${d.content_disposition}`);
50
- console.log(`Download URL: ${d.download_url}`);
51
- console.log(`Expires: ${d.expires_at}`);
52
- } else {
53
- outputResult(data, { json: globalOpts.json });
54
- }
55
- });
@@ -1,68 +0,0 @@
1
- import { Command } from '@commander-js/extra-typings';
2
- import { runList } from '../../../lib/actions';
3
- import type { GlobalOpts } from '../../../lib/client';
4
- import { buildHelpText } from '../../../lib/help-text';
5
- import {
6
- buildPaginationOpts,
7
- parseLimitOpt,
8
- printPaginationHint,
9
- } from '../../../lib/pagination';
10
- import { renderAttachmentsTable } from './utils';
11
-
12
- export const listAttachmentsCommand = new Command('attachments')
13
- .description('List attachments on a received (inbound) email')
14
- .argument('<emailId>', 'Received email UUID')
15
- .option(
16
- '--limit <n>',
17
- 'Maximum number of attachments to return (1-100)',
18
- '10',
19
- )
20
- .option(
21
- '--after <cursor>',
22
- 'Return attachments after this cursor (next page)',
23
- )
24
- .option(
25
- '--before <cursor>',
26
- 'Return attachments before this cursor (previous page)',
27
- )
28
- .addHelpText(
29
- 'after',
30
- buildHelpText({
31
- context:
32
- 'Each attachment has a download_url (signed, expires ~1 hour).\nUse the attachment sub-command to retrieve a single attachment with its download URL:\n resend emails receiving attachment <emailId> <attachmentId>\n\ncontent_disposition: "inline" means the attachment is embedded in the HTML body (e.g. an image).\ncontent_disposition: "attachment" means it is a standalone file download.',
33
- output:
34
- ' {"object":"list","has_more":false,"data":[{"id":"<uuid>","filename":"invoice.pdf","size":51200,"content_type":"application/pdf","content_disposition":"attachment","content_id":null,"download_url":"<url>","expires_at":"<iso-date>"}]}',
35
- errorCodes: ['auth_error', 'invalid_limit', 'list_error'],
36
- examples: [
37
- 'resend emails receiving attachments <email-id>',
38
- 'resend emails receiving attachments <email-id> --json',
39
- 'resend emails receiving attachments <email-id> --limit 25 --json',
40
- ],
41
- }),
42
- )
43
- .action(async (emailId, opts, cmd) => {
44
- const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
45
-
46
- const limit = parseLimitOpt(opts.limit, globalOpts);
47
- const paginationOpts = buildPaginationOpts(limit, opts.after, opts.before);
48
-
49
- await runList(
50
- {
51
- spinner: {
52
- loading: 'Fetching attachments...',
53
- success: 'Attachments fetched',
54
- fail: 'Failed to list attachments',
55
- },
56
- sdkCall: (resend) =>
57
- resend.emails.receiving.attachments.list({
58
- emailId,
59
- ...paginationOpts,
60
- }),
61
- onInteractive: (list) => {
62
- console.log(renderAttachmentsTable(list.data));
63
- printPaginationHint(list);
64
- },
65
- },
66
- globalOpts,
67
- );
68
- });
@@ -1,58 +0,0 @@
1
- import { Command } from '@commander-js/extra-typings';
2
- import { runGet } from '../../../lib/actions';
3
- import type { GlobalOpts } from '../../../lib/client';
4
- import { buildHelpText } from '../../../lib/help-text';
5
-
6
- export const getReceivingCommand = new Command('get')
7
- .description(
8
- 'Retrieve a single received (inbound) email with full details including HTML, text, and headers',
9
- )
10
- .argument('<id>', 'Received email UUID')
11
- .addHelpText(
12
- 'after',
13
- buildHelpText({
14
- context:
15
- 'The raw.download_url field is a signed URL (expires ~1 hour) containing the full RFC 2822\nMIME message. Pipe it to curl to save the original email:\n resend emails receiving get <id> --json | jq -r .raw.download_url | xargs curl > email.eml\n\nAttachments are listed in the attachments array. Use the attachments sub-command to get\ndownload URLs:\n resend emails receiving attachments <id>',
16
- output:
17
- ' {"object":"email","id":"<uuid>","to":["inbox@yourdomain.com"],"from":"sender@external.com","subject":"Hello","html":"<p>Hello!</p>","text":"Hello!","headers":{"x-mailer":"..."},"message_id":"<str>","bcc":[],"cc":[],"reply_to":[],"raw":{"download_url":"<url>","expires_at":"<iso-date>"},"attachments":[]}',
18
- errorCodes: ['auth_error', 'fetch_error'],
19
- examples: [
20
- 'resend emails receiving get <email-id>',
21
- 'resend emails receiving get <email-id> --json',
22
- ],
23
- }),
24
- )
25
- .action(async (id, _opts, cmd) => {
26
- const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
27
- await runGet(
28
- {
29
- spinner: {
30
- loading: 'Fetching received email...',
31
- success: 'Received email fetched',
32
- fail: 'Failed to fetch received email',
33
- },
34
- sdkCall: (resend) => resend.emails.receiving.get(id),
35
- onInteractive: (data) => {
36
- console.log(`\nFrom: ${data.from}`);
37
- console.log(`To: ${data.to.join(', ')}`);
38
- console.log(`Subject: ${data.subject}`);
39
- console.log(`Date: ${data.created_at}`);
40
- if (data.attachments.length > 0) {
41
- console.log(`Files: ${data.attachments.length} attachment(s)`);
42
- }
43
- if (data.text) {
44
- const snippet =
45
- data.text.length > 200
46
- ? `${data.text.slice(0, 197)}...`
47
- : data.text;
48
- console.log(`\n${snippet}`);
49
- } else if (data.html) {
50
- console.log(
51
- '\n(HTML body only — use --json to view or pipe to a browser)',
52
- );
53
- }
54
- },
55
- },
56
- globalOpts,
57
- );
58
- });