fluxmail 0.0.1 → 0.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 (92) hide show
  1. package/README.md +37 -10
  2. package/dist/accounts/googleAuth.d.ts +31 -0
  3. package/dist/accounts/googleAuth.d.ts.map +1 -0
  4. package/dist/accounts/googleAuth.js +147 -0
  5. package/dist/accounts/googleAuth.js.map +1 -0
  6. package/dist/accounts/registry.d.ts +37 -0
  7. package/dist/accounts/registry.d.ts.map +1 -0
  8. package/dist/accounts/registry.js +278 -0
  9. package/dist/accounts/registry.js.map +1 -0
  10. package/dist/cli.d.ts +3 -0
  11. package/dist/cli.d.ts.map +1 -0
  12. package/dist/cli.js +629 -0
  13. package/dist/cli.js.map +1 -0
  14. package/dist/config.d.ts +40 -0
  15. package/dist/config.d.ts.map +1 -0
  16. package/dist/config.js +216 -0
  17. package/dist/config.js.map +1 -0
  18. package/dist/context.d.ts +15 -0
  19. package/dist/context.d.ts.map +1 -0
  20. package/dist/context.js +15 -0
  21. package/dist/context.js.map +1 -0
  22. package/dist/http/app.d.ts +16 -0
  23. package/dist/http/app.d.ts.map +1 -0
  24. package/dist/http/app.js +118 -0
  25. package/dist/http/app.js.map +1 -0
  26. package/dist/index.d.ts +14 -0
  27. package/dist/index.d.ts.map +1 -0
  28. package/dist/index.js +14 -0
  29. package/dist/index.js.map +1 -0
  30. package/dist/licensing/activation.d.ts +5 -0
  31. package/dist/licensing/activation.d.ts.map +1 -0
  32. package/dist/licensing/activation.js +11 -0
  33. package/dist/licensing/activation.js.map +1 -0
  34. package/dist/licensing/client.d.ts +52 -0
  35. package/dist/licensing/client.d.ts.map +1 -0
  36. package/dist/licensing/client.js +75 -0
  37. package/dist/licensing/client.js.map +1 -0
  38. package/dist/licensing/entitlements.d.ts +55 -0
  39. package/dist/licensing/entitlements.d.ts.map +1 -0
  40. package/dist/licensing/entitlements.js +116 -0
  41. package/dist/licensing/entitlements.js.map +1 -0
  42. package/dist/licensing/lease.d.ts +47 -0
  43. package/dist/licensing/lease.d.ts.map +1 -0
  44. package/dist/licensing/lease.js +103 -0
  45. package/dist/licensing/lease.js.map +1 -0
  46. package/dist/licensing/refresher.d.ts +46 -0
  47. package/dist/licensing/refresher.d.ts.map +1 -0
  48. package/dist/licensing/refresher.js +150 -0
  49. package/dist/licensing/refresher.js.map +1 -0
  50. package/dist/mcp/buildServer.d.ts +28 -0
  51. package/dist/mcp/buildServer.d.ts.map +1 -0
  52. package/dist/mcp/buildServer.js +414 -0
  53. package/dist/mcp/buildServer.js.map +1 -0
  54. package/dist/scheduler/sendScheduler.d.ts +38 -0
  55. package/dist/scheduler/sendScheduler.d.ts.map +1 -0
  56. package/dist/scheduler/sendScheduler.js +128 -0
  57. package/dist/scheduler/sendScheduler.js.map +1 -0
  58. package/dist/service/emailService.d.ts +139 -0
  59. package/dist/service/emailService.d.ts.map +1 -0
  60. package/dist/service/emailService.js +380 -0
  61. package/dist/service/emailService.js.map +1 -0
  62. package/dist/storage/apiKeys.d.ts +27 -0
  63. package/dist/storage/apiKeys.d.ts.map +1 -0
  64. package/dist/storage/apiKeys.js +49 -0
  65. package/dist/storage/apiKeys.js.map +1 -0
  66. package/dist/storage/crypto.d.ts +4 -0
  67. package/dist/storage/crypto.d.ts.map +1 -0
  68. package/dist/storage/crypto.js +21 -0
  69. package/dist/storage/crypto.js.map +1 -0
  70. package/dist/storage/db.d.ts +1041 -0
  71. package/dist/storage/db.d.ts.map +1 -0
  72. package/dist/storage/db.js +211 -0
  73. package/dist/storage/db.js.map +1 -0
  74. package/dist/storage/imapState.d.ts +15 -0
  75. package/dist/storage/imapState.d.ts.map +1 -0
  76. package/dist/storage/imapState.js +89 -0
  77. package/dist/storage/imapState.js.map +1 -0
  78. package/dist/storage/members.d.ts +29 -0
  79. package/dist/storage/members.d.ts.map +1 -0
  80. package/dist/storage/members.js +67 -0
  81. package/dist/storage/members.js.map +1 -0
  82. package/dist/storage/scheduledSends.d.ts +60 -0
  83. package/dist/storage/scheduledSends.d.ts.map +1 -0
  84. package/dist/storage/scheduledSends.js +169 -0
  85. package/dist/storage/scheduledSends.js.map +1 -0
  86. package/dist/version.d.ts +2 -0
  87. package/dist/version.d.ts.map +1 -0
  88. package/dist/version.js +7 -0
  89. package/dist/version.js.map +1 -0
  90. package/package.json +49 -15
  91. package/bin/fluxmail.js +0 -4
  92. package/src/cli.js +0 -36
package/dist/cli.js ADDED
@@ -0,0 +1,629 @@
1
+ #!/usr/bin/env node
2
+ import { emitKeypressEvents } from 'node:readline';
3
+ import { Command } from 'commander';
4
+ import { serve } from '@hono/node-server';
5
+ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
6
+ import { EmailError } from '@fluxmail/core';
7
+ import { createContext } from './context.js';
8
+ import { configFilePath, maskStoredConfigValue, readStoredConfig, resolveDataDir, setStoredConfig, unsetStoredConfig, } from './config.js';
9
+ import { createApp } from './http/app.js';
10
+ import { buildMcpServer } from './mcp/buildServer.js';
11
+ import { runLoopbackFlow } from './accounts/googleAuth.js';
12
+ import { createApiKey, listApiKeys, revokeApiKey } from './storage/apiKeys.js';
13
+ import { addMember, findMember, listMembers, removeMember } from './storage/members.js';
14
+ import { activateLicense } from './licensing/activation.js';
15
+ import { LICENSE_KEY_PATTERN, releaseLicense } from './licensing/client.js';
16
+ import { licensePublicKeys, verifyLease } from './licensing/lease.js';
17
+ import { checkLicenseState, clearLease, getEntitlements, readLeaseRow, } from './licensing/entitlements.js';
18
+ import { loadInstanceId, startLicenseRefresher } from './licensing/refresher.js';
19
+ import { VERSION } from './version.js';
20
+ import { countPending } from './storage/scheduledSends.js';
21
+ function connectionPort(value, option) {
22
+ const port = Number(value);
23
+ if (!Number.isInteger(port) || port < 1 || port > 65_535) {
24
+ throw new EmailError('invalid_request', `${option} must be an integer between 1 and 65535.`);
25
+ }
26
+ return port;
27
+ }
28
+ function connectionSecurity(value, option) {
29
+ if (value !== 'tls' && value !== 'starttls') {
30
+ throw new EmailError('invalid_request', `${option} must be "tls" or "starttls".`);
31
+ }
32
+ return value;
33
+ }
34
+ async function hiddenPrompt(label) {
35
+ if (!process.stdin.isTTY || !process.stdin.setRawMode) {
36
+ throw new EmailError('invalid_request', `${label} must be supplied through a password environment variable.`);
37
+ }
38
+ emitKeypressEvents(process.stdin);
39
+ const wasRaw = process.stdin.isRaw;
40
+ const wasPaused = process.stdin.isPaused();
41
+ process.stdout.write(`${label}: `);
42
+ process.stdin.setRawMode(true);
43
+ process.stdin.resume();
44
+ return new Promise((resolve, reject) => {
45
+ let value = '';
46
+ const finish = (error) => {
47
+ process.stdin.off('keypress', onKeypress);
48
+ process.stdin.setRawMode(wasRaw);
49
+ if (wasPaused)
50
+ process.stdin.pause();
51
+ process.stdout.write('\n');
52
+ if (error)
53
+ reject(error);
54
+ else
55
+ resolve(value);
56
+ };
57
+ const onKeypress = (input, key) => {
58
+ if (key.ctrl && key.name === 'c')
59
+ return finish(new Error('Canceled'));
60
+ if (key.name === 'return' || key.name === 'enter')
61
+ return finish();
62
+ if (key.name === 'backspace') {
63
+ if (value) {
64
+ value = value.slice(0, -1);
65
+ process.stdout.write('\b \b');
66
+ }
67
+ return;
68
+ }
69
+ if (key.ctrl || !input)
70
+ return;
71
+ value += input;
72
+ process.stdout.write('*'.repeat([...input].length));
73
+ };
74
+ process.stdin.on('keypress', onKeypress);
75
+ });
76
+ }
77
+ async function accountSecret(envName, label) {
78
+ if (!envName)
79
+ return hiddenPrompt(label);
80
+ const value = process.env[envName];
81
+ if (!value)
82
+ throw new EmailError('invalid_request', `${envName} is not set or is empty.`);
83
+ return value;
84
+ }
85
+ function planLine(ent) {
86
+ const members = `${ent.maxMembers} member${ent.maxMembers === 1 ? '' : 's'}`;
87
+ return `${ent.plan} (up to ${ent.maxAccounts} mailboxes, ${members})`;
88
+ }
89
+ /** Renewal warning for an expiring or lapsed license; printed by every command that opens the db. */
90
+ function warnLicense(db, log = console.error) {
91
+ const { warning } = checkLicenseState(db);
92
+ if (warning)
93
+ log(`Warning: ${warning}`);
94
+ }
95
+ const program = new Command();
96
+ program.name('fluxmail').description('Fluxmail, a self-hosted MCP server for your email').version(VERSION);
97
+ program
98
+ .command('serve')
99
+ .description('Run the HTTP server (Streamable HTTP MCP at /mcp)')
100
+ .action(() => {
101
+ const ctx = createContext();
102
+ const app = createApp(ctx);
103
+ ctx.scheduler.start();
104
+ serve({ fetch: app.fetch, port: ctx.config.port }, () => {
105
+ console.log(`Fluxmail listening on ${ctx.config.publicUrl}`);
106
+ console.log(` MCP endpoint: ${ctx.config.publicUrl}/mcp`);
107
+ console.log(` Auth mode: ${ctx.config.authMode}`);
108
+ if (ctx.config.authMode === 'apikey' && listApiKeys(ctx.db).length === 0) {
109
+ console.log(' Note: no API keys exist yet. Run "fluxmail apikey create --name <name>" to create one.');
110
+ }
111
+ const accounts = ctx.registry.listAccounts();
112
+ console.log(accounts.length
113
+ ? ` Accounts: ${accounts.map((a) => `${a.email} (${a.status})`).join(', ')}`
114
+ : ' Accounts: none (run "fluxmail accounts add gmail" or "fluxmail accounts add imap")');
115
+ console.log(` Plan: ${planLine(getEntitlements(ctx.db))}`);
116
+ warnLicense(ctx.db, console.log);
117
+ startLicenseRefresher({
118
+ db: ctx.db,
119
+ config: ctx.config,
120
+ log: console.log,
121
+ onRefreshed: () => ctx.scheduler.wake(),
122
+ });
123
+ });
124
+ });
125
+ program
126
+ .command('stdio')
127
+ .description('Run as a stdio MCP server (for Claude Desktop / Claude Code local config)')
128
+ .action(async () => {
129
+ const ctx = createContext();
130
+ const server = buildMcpServer(ctx.service);
131
+ ctx.scheduler.start();
132
+ await server.connect(new StdioServerTransport());
133
+ // stdout belongs to the MCP protocol; log to stderr only.
134
+ startLicenseRefresher({
135
+ db: ctx.db,
136
+ config: ctx.config,
137
+ log: console.error,
138
+ onRefreshed: () => ctx.scheduler.wake(),
139
+ });
140
+ console.error('Fluxmail MCP server running on stdio');
141
+ warnLicense(ctx.db);
142
+ const { pending } = countPending(ctx.db);
143
+ if (pending > 0)
144
+ console.error(`Scheduled sends pending: ${pending}`);
145
+ });
146
+ const accounts = program.command('accounts').description('Manage connected email accounts');
147
+ accounts
148
+ .command('add')
149
+ .argument('<provider>', 'Email provider: gmail or imap')
150
+ .option('--reauthorize <account-id>', 'Reconnect an existing account')
151
+ .option('--member <member>', 'Member (id or email) who owns the new mailbox; omit for a shared mailbox')
152
+ .option('--email <address>', 'Mailbox address (required for IMAP)')
153
+ .option('--display-name <name>', 'Sender name for IMAP messages')
154
+ .option('--imap-host <host>', 'IMAP server hostname')
155
+ .option('--imap-port <port>', 'IMAP server port', '993')
156
+ .option('--imap-security <mode>', 'IMAP security: tls or starttls', 'tls')
157
+ .option('--imap-user <user>', 'IMAP username; defaults to the mailbox address')
158
+ .option('--imap-password-env <name>', 'Read the IMAP password from this environment variable')
159
+ .option('--smtp-host <host>', 'SMTP server hostname')
160
+ .option('--smtp-port <port>', 'SMTP server port', '587')
161
+ .option('--smtp-security <mode>', 'SMTP security: tls or starttls', 'starttls')
162
+ .option('--smtp-user <user>', 'SMTP username; defaults to the IMAP username')
163
+ .option('--smtp-password-env <name>', 'Read a separate SMTP password from this environment variable')
164
+ .option('--sent-folder <path>', 'Sent mailbox path')
165
+ .option('--drafts-folder <path>', 'Drafts mailbox path')
166
+ .option('--trash-folder <path>', 'Trash mailbox path')
167
+ .option('--archive-folder <path>', 'Archive mailbox path')
168
+ .option('--spam-folder <path>', 'Spam mailbox path')
169
+ .option('--no-save-sent', 'Do not append SMTP submissions to the Sent folder')
170
+ .description('Connect a Gmail or IMAP account')
171
+ .action(async (provider, opts, command) => {
172
+ if (provider !== 'gmail' && provider !== 'imap') {
173
+ console.error(`Provider "${provider}" is not supported. Available: gmail, imap`);
174
+ process.exitCode = 1;
175
+ return;
176
+ }
177
+ const ctx = createContext();
178
+ warnLicense(ctx.db);
179
+ try {
180
+ if (opts.reauthorize && opts.member) {
181
+ throw new EmailError('invalid_request', '--member cannot be combined with --reauthorize; use "fluxmail accounts assign" to change ownership.');
182
+ }
183
+ // Resolve before the OAuth flow so a typo fails fast.
184
+ const member = opts.member ? findMember(ctx.db, opts.member) : undefined;
185
+ const existing = opts.reauthorize ? ctx.registry.getAccount(opts.reauthorize) : undefined;
186
+ if (existing && existing.provider !== provider) {
187
+ throw new EmailError('invalid_request', `Account ${existing.id} uses ${existing.provider}, not ${provider}.`);
188
+ }
189
+ if (!existing)
190
+ ctx.registry.assertCanAddAccount();
191
+ if (provider === 'imap') {
192
+ const previousCredentials = existing ? ctx.registry.loadImapCredentials(existing.id) : undefined;
193
+ const email = opts.email?.trim();
194
+ if (!email || !email.includes('@'))
195
+ throw new EmailError('invalid_request', '--email must be a mailbox address.');
196
+ if (!opts.imapHost)
197
+ throw new EmailError('invalid_request', '--imap-host is required for IMAP accounts.');
198
+ if (!opts.smtpHost)
199
+ throw new EmailError('invalid_request', '--smtp-host is required for IMAP accounts.');
200
+ if (existing && existing.email !== email) {
201
+ throw new EmailError('invalid_request', `Account ${existing.id} belongs to ${existing.email}, not ${email}.`);
202
+ }
203
+ const imapPassword = await accountSecret(opts.imapPasswordEnv, 'IMAP password');
204
+ const smtpPassword = opts.smtpPasswordEnv
205
+ ? await accountSecret(opts.smtpPasswordEnv, 'SMTP password')
206
+ : imapPassword;
207
+ const imapUser = opts.imapUser ?? email;
208
+ const credentials = {
209
+ imap: {
210
+ host: opts.imapHost,
211
+ port: connectionPort(opts.imapPort, '--imap-port'),
212
+ security: connectionSecurity(opts.imapSecurity, '--imap-security'),
213
+ user: imapUser,
214
+ password: imapPassword,
215
+ },
216
+ smtp: {
217
+ host: opts.smtpHost,
218
+ port: connectionPort(opts.smtpPort, '--smtp-port'),
219
+ security: connectionSecurity(opts.smtpSecurity, '--smtp-security'),
220
+ user: opts.smtpUser ?? imapUser,
221
+ password: smtpPassword,
222
+ },
223
+ saveSent: previousCredentials && command.getOptionValueSource('saveSent') === 'default'
224
+ ? previousCredentials.saveSent
225
+ : opts.saveSent,
226
+ folderOverrides: {
227
+ ...previousCredentials?.folderOverrides,
228
+ ...(opts.sentFolder ? { sent: opts.sentFolder } : {}),
229
+ ...(opts.draftsFolder ? { drafts: opts.draftsFolder } : {}),
230
+ ...(opts.trashFolder ? { trash: opts.trashFolder } : {}),
231
+ ...(opts.archiveFolder ? { archive: opts.archiveFolder } : {}),
232
+ ...(opts.spamFolder ? { spam: opts.spamFolder } : {}),
233
+ },
234
+ };
235
+ console.log('Checking IMAP and SMTP settings...');
236
+ const warnings = await ctx.registry.testImapCredentials(email, credentials, opts.displayName);
237
+ const account = ctx.registry.addImapAccount(email, credentials, opts.displayName, member?.id, opts.reauthorize);
238
+ console.log(`Connected ${account.email} (account id: ${account.id})`);
239
+ for (const warning of warnings)
240
+ console.log(`Warning: ${warning.message}.`);
241
+ return;
242
+ }
243
+ const account = await runLoopbackFlow(ctx.config, (url) => {
244
+ console.log('\nOpen this URL in your browser to authorize Gmail access:\n');
245
+ console.log(` ${url}\n`);
246
+ console.log('Waiting for Google to redirect back…');
247
+ }, (result) => {
248
+ if (existing && result.email !== existing.email) {
249
+ throw new EmailError('invalid_request', `Google authorized ${result.email}, but account ${existing.id} belongs to ${existing.email}. ` +
250
+ 'Try again and choose the matching Google account.');
251
+ }
252
+ return ctx.registry.addGmailAccount(result.email, result.tokens, result.displayName, member?.id);
253
+ });
254
+ console.log(`\nConnected ${account.email} (account id: ${account.id})` +
255
+ (member && account.memberId === member.id ? ` for member ${member.name}` : ''));
256
+ if (member && account.memberId !== member.id) {
257
+ // The mailbox was already connected; re-auth keeps its existing owner.
258
+ console.log(`${account.email} was already connected, so its ownership is unchanged. ` +
259
+ `To assign it to ${member.name}, run "fluxmail accounts assign ${account.id} --member ${member.id}".`);
260
+ }
261
+ }
262
+ catch (err) {
263
+ console.error(`\nError: ${err instanceof Error ? err.message : String(err)}`);
264
+ process.exitCode = 1;
265
+ }
266
+ });
267
+ accounts
268
+ .command('configure')
269
+ .argument('<accountId>')
270
+ .option('--sent-folder <path>', 'Sent path, or auto to clear the override')
271
+ .option('--drafts-folder <path>', 'Drafts path, or auto to clear the override')
272
+ .option('--trash-folder <path>', 'Trash path, or auto to clear the override')
273
+ .option('--archive-folder <path>', 'Archive path, or auto to clear the override')
274
+ .option('--spam-folder <path>', 'Spam path, or auto to clear the override')
275
+ .description('Set special folder paths for an IMAP account')
276
+ .action(async (accountId, opts) => {
277
+ const ctx = createContext();
278
+ warnLicense(ctx.db);
279
+ try {
280
+ const changes = [
281
+ ['sent', opts.sentFolder],
282
+ ['drafts', opts.draftsFolder],
283
+ ['trash', opts.trashFolder],
284
+ ['archive', opts.archiveFolder],
285
+ ['spam', opts.spamFolder],
286
+ ];
287
+ if (!changes.some(([, value]) => value !== undefined)) {
288
+ throw new EmailError('invalid_request', 'Pass at least one folder option.');
289
+ }
290
+ const credentials = ctx.registry.loadImapCredentials(accountId);
291
+ const provider = ctx.registry.getProvider(accountId);
292
+ try {
293
+ const existingPaths = new Set((await provider.listFolders()).map((folder) => folder.id));
294
+ const overrides = { ...credentials.folderOverrides };
295
+ for (const [role, value] of changes) {
296
+ if (value === undefined)
297
+ continue;
298
+ if (value === 'auto')
299
+ delete overrides[role];
300
+ else {
301
+ if (!existingPaths.has(value)) {
302
+ throw new EmailError('not_found', `No selectable mailbox named "${value}".`);
303
+ }
304
+ overrides[role] = value;
305
+ }
306
+ }
307
+ credentials.folderOverrides = overrides;
308
+ ctx.registry.saveImapCredentials(accountId, credentials);
309
+ const checked = ctx.registry.getProvider(accountId);
310
+ try {
311
+ console.log(`Updated folder settings for ${accountId}.`);
312
+ for (const warning of (await checked.getFolderWarnings?.()) ?? []) {
313
+ console.log(`Warning: ${warning.message}.`);
314
+ }
315
+ }
316
+ finally {
317
+ await checked.close?.();
318
+ }
319
+ }
320
+ finally {
321
+ await provider.close?.();
322
+ }
323
+ }
324
+ catch (err) {
325
+ console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
326
+ process.exitCode = 1;
327
+ }
328
+ });
329
+ accounts
330
+ .command('list')
331
+ .description('List connected accounts')
332
+ .action(() => {
333
+ const ctx = createContext();
334
+ warnLicense(ctx.db);
335
+ const all = ctx.registry.listAccounts();
336
+ if (!all.length) {
337
+ console.log('No accounts connected. Run "fluxmail accounts add gmail" or "fluxmail accounts add imap".');
338
+ return;
339
+ }
340
+ const memberNames = new Map(listMembers(ctx.db).map((m) => [m.id, m.name]));
341
+ for (const a of all) {
342
+ const owner = a.memberId ? (memberNames.get(a.memberId) ?? a.memberId) : 'shared';
343
+ console.log(`${a.id} ${a.provider} ${a.email} [${a.status}] owner=${owner}`);
344
+ }
345
+ });
346
+ accounts
347
+ .command('remove')
348
+ .argument('<accountId>')
349
+ .description('Disconnect an account and delete its stored tokens')
350
+ .action((accountId) => {
351
+ const ctx = createContext();
352
+ warnLicense(ctx.db);
353
+ ctx.registry.removeAccount(accountId);
354
+ console.log(`Removed ${accountId}`);
355
+ });
356
+ accounts
357
+ .command('assign')
358
+ .argument('<accountId>')
359
+ .option('--member <member>', 'Member (id or email) to own the mailbox')
360
+ .option('--shared', 'Make the mailbox shared across the instance')
361
+ .description('Assign a mailbox to a member, or make it shared')
362
+ .action((accountId, opts) => {
363
+ const ctx = createContext();
364
+ warnLicense(ctx.db);
365
+ try {
366
+ if (!opts.member === !opts.shared) {
367
+ throw new EmailError('invalid_request', 'Pass exactly one of --member <member> or --shared.');
368
+ }
369
+ const member = opts.member ? findMember(ctx.db, opts.member) : undefined;
370
+ const account = ctx.registry.assignAccountMember(accountId, member?.id ?? null);
371
+ console.log(member ? `${account.email} is now owned by ${member.name}` : `${account.email} is now shared`);
372
+ }
373
+ catch (err) {
374
+ console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
375
+ process.exitCode = 1;
376
+ }
377
+ });
378
+ const membersCmd = program.command('members').description('Manage members (people using this instance)');
379
+ membersCmd
380
+ .command('add')
381
+ .requiredOption('--name <name>', 'Member name')
382
+ .option('--email <email>', 'Member email, usable as a shorthand in --member flags')
383
+ .description('Add a member (subject to the plan seat limit)')
384
+ .action((opts) => {
385
+ const ctx = createContext();
386
+ warnLicense(ctx.db);
387
+ try {
388
+ const member = addMember(ctx.db, { name: opts.name, ...(opts.email ? { email: opts.email } : {}) });
389
+ console.log(`Added member ${member.name} (id: ${member.id})`);
390
+ }
391
+ catch (err) {
392
+ console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
393
+ process.exitCode = 1;
394
+ }
395
+ });
396
+ membersCmd
397
+ .command('list')
398
+ .description('List members with their mailbox and API key counts')
399
+ .action(() => {
400
+ const ctx = createContext();
401
+ warnLicense(ctx.db);
402
+ const all = listMembers(ctx.db);
403
+ if (!all.length) {
404
+ console.log('No members. Run "fluxmail members add --name <name>".');
405
+ return;
406
+ }
407
+ for (const m of all) {
408
+ console.log(`${m.id} ${m.name} email=${m.email ?? '-'} mailboxes=${m.accountCount} keys=${m.apiKeyCount}`);
409
+ }
410
+ });
411
+ membersCmd
412
+ .command('remove')
413
+ .argument('<memberId>')
414
+ .description('Remove a member; their mailboxes become shared and their API keys are revoked')
415
+ .action((memberId) => {
416
+ const ctx = createContext();
417
+ warnLicense(ctx.db);
418
+ try {
419
+ const { name, freedAccounts, revokedApiKeys } = removeMember(ctx.db, memberId);
420
+ console.log(`Removed ${name}. ${freedAccounts} mailbox(es) are now shared and ${revokedApiKeys} API key(s) revoked.`);
421
+ }
422
+ catch (err) {
423
+ console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
424
+ process.exitCode = 1;
425
+ }
426
+ });
427
+ const apikey = program.command('apikey').description('Manage API keys for the HTTP MCP endpoint');
428
+ apikey
429
+ .command('create')
430
+ .requiredOption('--name <name>', 'Human-readable key name')
431
+ .option('--member <member>', 'Member (id or email) the key is issued to')
432
+ .description('Create an API key (shown once)')
433
+ .action((opts) => {
434
+ const ctx = createContext();
435
+ warnLicense(ctx.db);
436
+ try {
437
+ const member = opts.member ? findMember(ctx.db, opts.member) : undefined;
438
+ const { key, info } = createApiKey(ctx.db, opts.name, member?.id);
439
+ console.log(`Created API key "${info.name}" (id: ${info.id})` + (member ? ` for member ${member.name}` : '') + '\n');
440
+ console.log(` ${key}\n`);
441
+ console.log('Store it now; it cannot be shown again.');
442
+ }
443
+ catch (err) {
444
+ console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
445
+ process.exitCode = 1;
446
+ }
447
+ });
448
+ apikey
449
+ .command('list')
450
+ .description('List API keys')
451
+ .action(() => {
452
+ const ctx = createContext();
453
+ warnLicense(ctx.db);
454
+ const keys = listApiKeys(ctx.db);
455
+ if (!keys.length) {
456
+ console.log('No API keys. Run "fluxmail apikey create --name <name>".');
457
+ return;
458
+ }
459
+ const memberNames = new Map(listMembers(ctx.db).map((m) => [m.id, m.name]));
460
+ for (const k of keys) {
461
+ const lastUsed = k.lastUsedAt ? new Date(k.lastUsedAt).toISOString() : 'never';
462
+ const member = k.memberId ? (memberNames.get(k.memberId) ?? k.memberId) : '-';
463
+ console.log(`${k.id} ${k.name} member=${member} created=${new Date(k.createdAt).toISOString()} lastUsed=${lastUsed}`);
464
+ }
465
+ });
466
+ apikey
467
+ .command('revoke')
468
+ .argument('<keyId>')
469
+ .description('Revoke an API key')
470
+ .action((keyId) => {
471
+ const ctx = createContext();
472
+ warnLicense(ctx.db);
473
+ console.log(revokeApiKey(ctx.db, keyId) ? `Revoked ${keyId}` : `No key with id ${keyId}`);
474
+ });
475
+ const license = program.command('license').description('Manage the paid-tier license');
476
+ license
477
+ .command('activate')
478
+ .argument('<key>', 'License key (fluxmail_lic_…), shown once at purchase')
479
+ .description('Store a license key and validate it with the license server')
480
+ .action(async (key) => {
481
+ if (!LICENSE_KEY_PATTERN.test(key)) {
482
+ console.error('That does not look like a Fluxmail license key (expected "fluxmail_lic_" followed by 40 hex characters).');
483
+ process.exitCode = 1;
484
+ return;
485
+ }
486
+ const dataDir = resolveDataDir();
487
+ const overridingKey = process.env.FLUXMAIL_LICENSE_KEY?.trim();
488
+ if (overridingKey && overridingKey !== key) {
489
+ console.error('FLUXMAIL_LICENSE_KEY is already set by the shell or a .env file, which takes precedence over stored settings. Remove it before activating a different key.');
490
+ process.exitCode = 1;
491
+ return;
492
+ }
493
+ const ctx = createContext();
494
+ const result = await activateLicense(ctx.db, {
495
+ licenseKey: key,
496
+ serverUrl: ctx.config.licenseServerUrl,
497
+ dataDir,
498
+ });
499
+ if (result.outcome === 'refreshed') {
500
+ const { lease } = result;
501
+ console.log(`License activated: ${lease.plan} plan, up to ${lease.maxAccounts} mailboxes and ` +
502
+ `${lease.maxMembers} member${lease.maxMembers === 1 ? '' : 's'}.`);
503
+ console.log(`The lease is valid until ${lease.expiresAt} and renews automatically while the server runs.`);
504
+ return;
505
+ }
506
+ console.error(result.message);
507
+ if (result.outcome === 'outage') {
508
+ console.error('The key is saved; validation will be retried automatically once the server can reach it.');
509
+ }
510
+ else {
511
+ process.exitCode = 1;
512
+ }
513
+ });
514
+ license
515
+ .command('status')
516
+ .description('Show the configured license and cached lease')
517
+ .action(() => {
518
+ const ctx = createContext();
519
+ if (ctx.config.licenseKey) {
520
+ console.log(`License key: ${maskStoredConfigValue('FLUXMAIL_LICENSE_KEY', ctx.config.licenseKey)}`);
521
+ }
522
+ else {
523
+ console.log('No license key configured. Run "fluxmail license activate <key>" after purchasing one.');
524
+ }
525
+ const row = readLeaseRow(ctx.db);
526
+ if (row) {
527
+ console.log(`Last validated: ${new Date(row.updatedAt).toISOString()}`);
528
+ try {
529
+ const lease = verifyLease(row.token, licensePublicKeys(), new Date(), { allowExpired: true });
530
+ const expired = Date.parse(lease.expiresAt) <= Date.now();
531
+ console.log(`Lease ${expired ? 'expired' : 'valid until'} ${lease.expiresAt}: ${lease.plan} plan, ` +
532
+ `up to ${lease.maxAccounts} mailboxes and ${lease.maxMembers} member${lease.maxMembers === 1 ? '' : 's'}.`);
533
+ }
534
+ catch (err) {
535
+ console.log(`Cached lease is not usable (${err instanceof Error ? err.message : String(err)}).`);
536
+ }
537
+ }
538
+ else {
539
+ console.log('No cached lease.');
540
+ }
541
+ console.log(`Current plan: ${planLine(getEntitlements(ctx.db))}`);
542
+ warnLicense(ctx.db, console.log);
543
+ });
544
+ license
545
+ .command('deactivate')
546
+ .description('Release the license from this instance and remove the stored key and cached lease')
547
+ .action(async () => {
548
+ const dataDir = resolveDataDir();
549
+ // Captured before createContext() merges the stored config into the
550
+ // environment: truthy only when the key comes from the shell or a .env file.
551
+ const envLicenseKey = process.env.FLUXMAIL_LICENSE_KEY?.trim();
552
+ const ctx = createContext();
553
+ // Best effort: free the server-side instance binding so the key can be
554
+ // activated elsewhere. Local deactivation proceeds either way.
555
+ if (ctx.config.licenseKey) {
556
+ const released = await releaseLicense({
557
+ serverUrl: ctx.config.licenseServerUrl,
558
+ licenseKey: ctx.config.licenseKey,
559
+ instanceId: loadInstanceId(dataDir),
560
+ });
561
+ console.log(released
562
+ ? 'Released the license from this instance; it can now be activated elsewhere.'
563
+ : 'Could not reach the license server to release this instance; unused bindings are released automatically after a while.');
564
+ }
565
+ const removed = unsetStoredConfig(dataDir, 'FLUXMAIL_LICENSE_KEY');
566
+ clearLease(ctx.db);
567
+ console.log(removed
568
+ ? 'License removed; this instance is back to Personal-plan limits.'
569
+ : 'No stored license key; cleared any cached lease.');
570
+ if (envLicenseKey) {
571
+ console.log('Note: FLUXMAIL_LICENSE_KEY is still set in the environment or a .env file.');
572
+ }
573
+ });
574
+ const configCmd = program
575
+ .command('config')
576
+ .description('Persistent settings stored in the data dir, usable from any directory');
577
+ configCmd
578
+ .command('set')
579
+ .argument('<key>', 'Setting name, e.g. GOOGLE_CLIENT_ID')
580
+ .argument('<value>')
581
+ .description('Store a setting (shell env vars and local .env files still take precedence)')
582
+ .action((key, value) => {
583
+ try {
584
+ const dataDir = resolveDataDir();
585
+ setStoredConfig(dataDir, key, value);
586
+ console.log(`Set ${key} in ${configFilePath(dataDir)}`);
587
+ }
588
+ catch (err) {
589
+ console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
590
+ process.exitCode = 1;
591
+ }
592
+ });
593
+ configCmd
594
+ .command('unset')
595
+ .argument('<key>')
596
+ .description('Remove a stored setting')
597
+ .action((key) => {
598
+ const dataDir = resolveDataDir();
599
+ console.log(unsetStoredConfig(dataDir, key) ? `Removed ${key}` : `${key} is not set`);
600
+ });
601
+ configCmd
602
+ .command('list')
603
+ .description('Show stored settings (secret values are masked)')
604
+ .action(() => {
605
+ const dataDir = resolveDataDir();
606
+ const stored = readStoredConfig(dataDir);
607
+ const keys = Object.keys(stored);
608
+ if (!keys.length) {
609
+ console.log(`No stored settings. Run "fluxmail config set <KEY> <value>" (file: ${configFilePath(dataDir)}).`);
610
+ return;
611
+ }
612
+ for (const key of keys) {
613
+ const value = stored[key] ?? '';
614
+ console.log(`${key}=${maskStoredConfigValue(key, value)}`);
615
+ }
616
+ });
617
+ program
618
+ .command('status')
619
+ .description('Show accounts, members, entitlements, and provider availability')
620
+ .action(async () => {
621
+ const ctx = createContext();
622
+ warnLicense(ctx.db);
623
+ console.log(JSON.stringify(await ctx.service.status(), null, 2));
624
+ });
625
+ program.parseAsync(process.argv).catch((err) => {
626
+ console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
627
+ process.exitCode = 1;
628
+ });
629
+ //# sourceMappingURL=cli.js.map