cloudflare-email 0.3.0 → 0.4.1

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 (71) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +63 -1
  3. data/README.md +63 -369
  4. data/SECURITY.md +1 -9
  5. data/app/controllers/cloudflare/email/ingress_controller.rb +1 -2
  6. data/app/controllers/cloudflare/email/management/mailboxes_controller.rb +2 -166
  7. data/app/controllers/cloudflare/email/management/styles_controller.rb +2 -6
  8. data/docs/activerecord-tenanted.md +0 -11
  9. data/docs/custom-ingress.md +6 -16
  10. data/docs/delivery-events.md +2 -5
  11. data/docs/features.md +49 -123
  12. data/docs/getting-started.md +91 -172
  13. data/docs/mailboxes.md +27 -56
  14. data/docs/management-engine.md +1 -3
  15. data/docs/outbox.md +5 -6
  16. data/docs/reference.md +190 -0
  17. data/docs/routing-diagnostics.md +7 -2
  18. data/docs/thread-correlation.md +2 -4
  19. data/docs/troubleshooting.md +4 -4
  20. data/lib/cloudflare/email/active_record/base.rb +3 -53
  21. data/lib/cloudflare/email/client.rb +23 -5
  22. data/lib/cloudflare/email/engine.rb +1 -13
  23. data/lib/cloudflare/email/envelope.rb +2 -12
  24. data/lib/cloudflare/email/error.rb +5 -12
  25. data/lib/cloudflare/email/ingress.rb +19 -8
  26. data/lib/cloudflare/email/mailboxes/configuration.rb +7 -15
  27. data/lib/cloudflare/email/mailboxes/inbound_retention.rb +1 -14
  28. data/lib/cloudflare/email/mailboxes/models.rb +8 -147
  29. data/lib/cloudflare/email/mailboxes/service.rb +7 -258
  30. data/lib/cloudflare/email/mailboxes.rb +1 -0
  31. data/lib/cloudflare/email/management/adapter.rb +3 -25
  32. data/lib/cloudflare/email/management/configuration.rb +4 -11
  33. data/lib/cloudflare/email/management/engine.rb +2 -0
  34. data/lib/cloudflare/email/tenancy.rb +2 -73
  35. data/lib/cloudflare/email/tenant_job_context.rb +2 -85
  36. data/lib/cloudflare/email/version.rb +1 -1
  37. data/lib/cloudflare-email.rb +6 -0
  38. data/lib/generators/cloudflare/email/mailboxes/templates/create_cloudflare_email_mailboxes.rb +1 -0
  39. data/lib/generators/cloudflare/email/mailboxes/templates/create_cloudflare_email_receiving_domains.rb +1 -1
  40. data/templates/deploy-to-cloudflare/README.md +25 -7
  41. data/templates/deploy-to-cloudflare/docs/domain-setup.md +118 -0
  42. data/templates/deploy-to-cloudflare/package.json +1 -0
  43. data/templates/deploy-to-cloudflare/scripts/check-subdomains.mjs +54 -0
  44. data/templates/deploy-to-cloudflare/test/subdomains.test.ts +51 -0
  45. data/templates/worker/README.md +11 -7
  46. data/templates/worker/docs/domain-setup.md +118 -0
  47. data/templates/worker/docs/durable-inbound.md +4 -16
  48. data/templates/worker/package.json +1 -0
  49. data/templates/worker/scripts/check-subdomains.mjs +54 -0
  50. data/templates/worker/test/subdomains.test.ts +51 -0
  51. metadata +22 -21
  52. data/app/views/cloudflare/email/management/mailboxes/index.html.erb +0 -65
  53. data/app/views/cloudflare/email/management/mailboxes/message.html.erb +0 -34
  54. data/app/views/cloudflare/email/management/mailboxes/show.html.erb +0 -86
  55. data/app/views/layouts/cloudflare/email/management.html.erb +0 -29
  56. data/docs/architecture.md +0 -105
  57. data/docs/tenant-mailboxes-plan.md +0 -149
  58. data/docs/upgrading-0.2.md +0 -101
  59. data/docs/upgrading-0.3.md +0 -55
  60. data/docs/verification/2026-09-10-followup.md +0 -49
  61. data/docs/verification/2026-09-10-install-upgrade.md +0 -86
  62. data/docs/verification/2026-09-10-live.md +0 -102
  63. data/docs/verification/2026-09-10.md +0 -175
  64. data/docs/verification/2026-09-11-custom-ingress.md +0 -49
  65. data/docs/verification/2026-09-11-extraction.md +0 -32
  66. data/docs/verification/2026-09-11-outbound-ledger.md +0 -60
  67. data/docs/verification/2026-09-11-security.md +0 -76
  68. data/docs/verification/2026-09-11-tenant-mailboxes.md +0 -75
  69. data/docs/verification/2026-09-12-destination-context.md +0 -46
  70. data/docs/verification/2026-09-13-durable-inbound-and-routing.md +0 -71
  71. data/lib/cloudflare/email/management/management.css +0 -68
@@ -1,68 +0,0 @@
1
- :root { color-scheme: light; --ink: #172c35; --muted: #536871; --line: #dce4e6; --accent: #12655c; --surface: #fff; }
2
- * { box-sizing: border-box; }
3
- body { margin: 0; background: #f5f7f7; color: var(--ink); font: 16px/1.55 system-ui, sans-serif; }
4
- a { color: var(--accent); text-underline-offset: 3px; }
5
- a:hover { text-decoration-thickness: 2px; }
6
- :focus-visible { outline: 3px solid #b66a17; outline-offset: 4px; }
7
- .shell { width: min(1160px, 100% - 48px); margin: 0 auto; }
8
- .site-header { background: var(--surface); border-bottom: 1px solid var(--line); }
9
- .header-content { display: flex; justify-content: space-between; align-items: center; gap: 16px; min-height: 76px; }
10
- .brand { color: var(--ink); font-weight: 750; font-size: 18px; text-decoration: none; }
11
- .header-caption, .muted, .field-help { color: var(--muted); }
12
- main.shell { padding-top: 32px; padding-bottom: 64px; }
13
- h1, h2, h3, p { margin: 0; }
14
- h1 { font-size: clamp(26px, 4vw, 36px); line-height: 1.2; letter-spacing: -.035em; overflow-wrap: anywhere; }
15
- h2 { font-size: 17px; line-height: 1.4; }
16
- h3 { font-size: 17px; }
17
- .small, .field-help { font-size: 13px; }
18
- .eyebrow { color: var(--accent); font-size: 12px; font-weight: 750; text-transform: uppercase; letter-spacing: .1em; margin-bottom: 8px; }
19
- .page-heading { display: flex; justify-content: space-between; align-items: center; gap: 24px; margin-bottom: 28px; }
20
- .page-heading .muted { margin-top: 12px; max-width: 640px; }
21
- .workspace-grid { display: grid; grid-template-columns: minmax(0, 1.65fr) minmax(280px, 1fr); gap: 24px; align-items: start; }
22
- .panel { background: var(--surface); border: 1px solid var(--line); border-radius: 12px; overflow: hidden; min-width: 0; }
23
- .panel-heading { padding: 20px 24px; border-bottom: 1px solid var(--line); }
24
- .panel-body { padding: 24px; }
25
- .stack { display: flex; flex-direction: column; gap: 20px; }
26
- .field { display: flex; flex-direction: column; gap: 8px; }
27
- label { font-weight: 650; font-size: 14px; }
28
- input[type="text"], input[type="email"] { width: 100%; border: 1px solid #a6b7be; border-radius: 7px; padding: 11px 12px; background: #fff; color: var(--ink); font: inherit; }
29
- .button { display: inline-flex; align-items: center; justify-content: center; min-height: 42px; padding: 9px 15px; border: 1px solid var(--accent); border-radius: 7px; background: var(--accent); color: #fff; font: inherit; font-size: 14px; font-weight: 650; text-decoration: none; cursor: pointer; text-align: center; }
30
- .button:hover { filter: brightness(.93); }
31
- .button-secondary { background: #fff; color: var(--ink); border-color: #a6b7be; }
32
- .record-list { list-style: none; margin: 0; padding: 0; }
33
- .record-row { padding: 20px 24px; display: flex; align-items: center; justify-content: space-between; gap: 16px; }
34
- .record-row + .record-row { border-top: 1px solid var(--line); }
35
- .record-content { min-width: 0; }
36
- .record-title { font-weight: 650; overflow-wrap: anywhere; }
37
- .record-content p { margin-top: 4px; }
38
- .badge { display: inline-block; border: 1px solid var(--line); border-radius: 5px; background: #f3f6f6; color: #364f58; padding: 3px 8px; font-size: 12px; font-weight: 650; white-space: nowrap; }
39
- .status-list { display: flex; flex-direction: column; align-items: flex-end; gap: 6px; }
40
- .address-row { align-items: flex-start; flex-direction: column; gap: 8px; }
41
- .empty-state { padding: 48px 24px; text-align: center; }
42
- .empty-state p { color: var(--muted); max-width: 340px; margin: 8px auto 0; }
43
- .pagination { padding: 16px 24px; border-top: 1px solid var(--line); }
44
- .actions { display: flex; flex-wrap: wrap; align-items: center; gap: 10px; }
45
- .actions form { margin: 0; }
46
- .breadcrumbs { display: flex; flex-wrap: wrap; gap: 10px; color: var(--muted); font-size: 14px; margin-bottom: 28px; overflow-wrap: anywhere; }
47
- .notice { border: 1px solid #a7ccc0; border-radius: 8px; background: #edf8f2; color: #205340; padding: 14px 18px; margin-bottom: 24px; overflow-wrap: anywhere; }
48
- .notice-error { border-color: #e8b9b3; background: #fff2ef; color: #8d2a21; }
49
- .message-metadata { display: grid; grid-template-columns: 84px minmax(0, 1fr); gap: 10px 20px; margin: 0; font-size: 14px; }
50
- .message-metadata dt { color: var(--muted); }
51
- .message-metadata dd { margin: 0; overflow-wrap: anywhere; }
52
- .message-body { border-top: 1px solid var(--line); padding: 28px 24px; }
53
- .message-body pre { white-space: pre-wrap; overflow-wrap: anywhere; font: inherit; margin: 0; }
54
- .attachments { border-top: 1px solid var(--line); }
55
- .attachments p { margin-top: 8px; }
56
- .attachments li { overflow-wrap: anywhere; }
57
- .skip-link { position: absolute; left: 16px; top: -100px; background: #fff; padding: 12px; z-index: 1; }
58
- .skip-link:focus { top: 12px; }
59
- @media (max-width: 760px) {
60
- .shell { width: calc(100% - 32px); }
61
- .header-content { min-height: 64px; }
62
- .header-caption { display: none; }
63
- .workspace-grid { grid-template-columns: minmax(0, 1fr); }
64
- .page-heading { align-items: flex-start; flex-direction: column; }
65
- .panel-heading, .panel-body, .record-row, .message-body { padding: 20px; }
66
- .record-row { align-items: flex-start; }
67
- .message-metadata { grid-template-columns: 64px minmax(0, 1fr); gap: 10px; }
68
- }