hailer 0.6.0-aarch64-linux-gnu → 0.7.1-aarch64-linux-gnu

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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 4307945cab5e51b724f5131474287273bb59ace9d853d86b749b5c0ae243a5fb
4
- data.tar.gz: 1e6c48de1c1a800cb813961a51aa272efdba2ac7b8a149dda17bef6e0282e88e
3
+ metadata.gz: 422792d6aedbb1104221f99651bc85522d79183815bd47b035a32b3bb4e120a9
4
+ data.tar.gz: fb447f7a606e70c7e0df1657f5659b9f8d838ac7201193c4cc3883344a7f05cb
5
5
  SHA512:
6
- metadata.gz: c3b67e5330b8b4dd24a0ac4c6d55f3a9ad63d0600f1f4db5ca02c7a620c81258ee5038fbfaf4dccd4bee2457ad0e57dc99d03d2d6b85947462cecb32c68d76e5
7
- data.tar.gz: ba3945486118352d668f8d441753152ae99d215801c689cdfe5f5d39a892a39d97a693608d0abdf26820e150888ef5edbe0f221e495b28262f8c2c3a75b25bc4
6
+ metadata.gz: 16d8fab1fad90d444570691be22837afed8a4f72004de5fc152f28f3153155a06febbc3e4e9a9f884009c983a89c9f457fad70bc5c65b7286f4e2615dbe06b58
7
+ data.tar.gz: b5a329dc149a5c419c73ec0e03e851088c686ec14a1eb70e3d018edf7fac8bad67b0b0a3ce6e5b9b37fed670d9f6f1d74140c26c81f93f287849098482f55436
data/CHANGELOG.md CHANGED
@@ -1,5 +1,17 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.7.1
4
+
5
+ - `AWS_ENDPOINT_URL`, and `AWS_ENDPOINT_URL_SESV2`/`_SQS`/`_STS` before it, replace the AWS hosts again, as they did under the AWS SDK; `AWS_IGNORE_CONFIGURED_ENDPOINT_URLS=true` turns them off. 0.7.0 ignored them, so LocalStack and endpoint fixtures reached real AWS.
6
+
7
+ ## 0.7.0
8
+
9
+ - Postmark provider (`provider = "postmark"`, `[postmark] message_stream`, `POSTMARK_SERVER_TOKEN`): Rails MIME parsed into Postmark's JSON, sync and queued sends, correlation as Metadata, `hailer postmark-server` token check. SES-only settings are refused with it.
10
+ - **Breaking for source builds:** providers are cargo features, `ses` and `postmark`; a build needs at least one, and platform gems carry both. A binary without the configured provider refuses to start and names the feature.
11
+ - The AWS SDK is gone: SESv2, SQS and STS go through hailer's own SigV4 client (verified against AWS's signing test suite) with env, shared-file, web identity, container and IMDSv2 credentials. The platform binary drops from 17 MiB to 9 MiB.
12
+ - HTTP clients (Postmark, Emailable, RDAP) moved from reqwest to rama, with rustls on ring; every request sends `user-agent: hailer/<version>`.
13
+ - Dependency requirements loosened to their compatibility boundary and upgraded (behavior-machines-circuit 0.3, base64 0.23, sha2 0.11).
14
+
3
15
  ## Working tree — durable delivery (unreleased)
4
16
 
5
17
  - Opt-in `:hailer_queued` Rails adapter with stable job keys and frozen intake retries.
data/README.md CHANGED
@@ -7,7 +7,7 @@ This repository is two things:
7
7
  - **`hailer` gem** — an ActionMailer adapter, feedback client, and executable
8
8
  launcher. Platform gems bundle the Rust binary. No Ruby AWS SDK or native extension.
9
9
  - **`hailer` crate** — a standalone Rust mail ship, supervised by Mothership.
10
- SESv2 is the first provider.
10
+ Sends through SESv2 or Postmark.
11
11
 
12
12
  ```mermaid
13
13
  flowchart LR
@@ -78,10 +78,22 @@ The source (`ruby`) gem has the same Rails client and launcher, but no binary.
78
78
  For source development or an unsupported platform:
79
79
 
80
80
  ```sh
81
- cargo install --path . --locked
81
+ cargo install --path . --locked --features ses,postmark
82
82
  export HAILER_BINARY=/absolute/path/to/hailer
83
83
  ```
84
84
 
85
+ Each provider is a cargo feature, and a build needs at least one. Platform
86
+ gems carry both. On glibc Linux the build needs libclang (`libclang-dev`):
87
+ rama generates its libresolv bindings with bindgen.
88
+
89
+ | Feature | Adds |
90
+ | --- | --- |
91
+ | `ses` | SES sending, SQS feedback, suppression sync, rate discovery, `ses-*` and `sync-suppressions` commands (hailer's own SigV4 client, no AWS SDK) |
92
+ | `postmark` | MIME parsing for Postmark's JSON API, `postmark-server` command |
93
+
94
+ A binary without the configured provider refuses to start and names the
95
+ feature to rebuild with.
96
+
85
97
  Run it as a Mothership HTTP bay. Merge this example into your fleet manifest;
86
98
  the bind must stay private and must not be routed on a public listener:
87
99
 
@@ -102,9 +114,46 @@ docking Unix socket; it does **not** run another HTTP server. For containers,
102
114
  use a private network listener with network policy instead of a loopback address
103
115
  if Rails runs in a different network namespace.
104
116
 
105
- Give the **service**, not the Rails adapter, AWS region and credentials through
106
- the standard AWS credential chain. Its identity needs `ses:SendEmail`, and the
107
- SES account/identities must be configured for sending.
117
+ Give the **service**, not the Rails adapter, AWS region and credentials. Hailer
118
+ looks where the AWS SDKs do, in this order: `AWS_ACCESS_KEY_ID` /
119
+ `AWS_SECRET_ACCESS_KEY` (+ `AWS_SESSION_TOKEN`); the shared `~/.aws/credentials`
120
+ and `~/.aws/config` files (`AWS_PROFILE`, static keys); an EKS web identity
121
+ (`AWS_WEB_IDENTITY_TOKEN_FILE` + `AWS_ROLE_ARN`); an ECS or EKS Pod Identity
122
+ container role; the EC2 instance role over IMDSv2. A profile that needs SSO,
123
+ `credential_process` or role chaining is refused with the key it uses. The
124
+ region comes from `AWS_REGION`, `AWS_DEFAULT_REGION`, the profile, or IMDS.
125
+ `AWS_ENDPOINT_URL_SESV2`, `_SQS` and `_STS`, else `AWS_ENDPOINT_URL`, point
126
+ those calls elsewhere (LocalStack, a test fixture) unless
127
+ `AWS_IGNORE_CONFIGURED_ENDPOINT_URLS=true`.
128
+ Its identity needs `ses:SendEmail`, and the SES account/identities must be
129
+ configured for sending.
130
+
131
+ ### Postmark
132
+
133
+ ```toml
134
+ provider = "postmark"
135
+
136
+ [postmark]
137
+ message_stream = "outbound" # the default
138
+ ```
139
+
140
+ Set `POSTMARK_SERVER_TOKEN` in the service's environment, never in
141
+ `hailer.toml`. `hailer postmark-server` checks the token and names its server.
142
+
143
+ Postmark's API takes JSON, not raw MIME, so Hailer parses the Rails message
144
+ and Postmark rebuilds it. Recipients, subject, text/HTML bodies, attachments
145
+ (inline images by `cid:`), Reply-To, `Message-ID` and other custom headers
146
+ carry over; the MIME structure itself does not. Recipients come from the
147
+ envelope, as with SES. An explicit `smtp_envelope_from` only stands in for a
148
+ missing From header: Postmark owns the bounce address.
149
+
150
+ The SES-only settings (`ses_configuration_set`, `[feedback]`,
151
+ `[suppression_sync]`, `rate_limit.discover_from_aws`) are refused with
152
+ `provider = "postmark"`. Postmark bounces and suppressions are not read yet,
153
+ so a queued unknown outcome waits for `hailer resolve-message`. Postmark
154
+ refuses a message (406, suppressed) only when every recipient is inactive in
155
+ its suppression list; otherwise it accepts and skips the inactive ones, which
156
+ Hailer logs as a warning with the count, never the addresses.
108
157
 
109
158
  ### PostgreSQL
110
159
 
@@ -410,6 +459,9 @@ The SES SDK makes **one send attempt**. AWS throttling/transient failures return
410
459
  503, permanent service rejections 502, and disconnects/timeouts/missing message
411
460
  IDs carry the explicit unknown-outcome code. None of these responses authorizes
412
461
  an automatic retry of an ambiguous send.
462
+ Postmark sends are single-attempt too: throttling, a refused token and 5xx
463
+ return 503, other refusals 502, and lost or unreadable answers the
464
+ unknown-outcome code.
413
465
 
414
466
  ## Status
415
467
 
@@ -425,7 +477,7 @@ missing code.
425
477
  ```sh
426
478
  bundle install
427
479
  bundle exec rake
428
- HAILER_TEST_DATABASE_URL=postgres://test_user:password@127.0.0.1/hailer_test cargo test --locked
480
+ HAILER_TEST_DATABASE_URL=postgres://test_user:password@127.0.0.1/hailer_test cargo test --locked --features ses,postmark
429
481
  cargo fmt --all -- --check
430
482
  ```
431
483
 
data/hailer.example.toml CHANGED
@@ -3,6 +3,12 @@ threads = 2
3
3
  database_pool_size = 5
4
4
  shutdown_timeout_seconds = 30
5
5
 
6
+ # "ses" (default) or "postmark". Postmark reads POSTMARK_SERVER_TOKEN from the
7
+ # environment and refuses the SES-only settings below.
8
+ # provider = "postmark"
9
+ # [postmark]
10
+ # message_stream = "outbound"
11
+
6
12
  # Optional SES event-publishing configuration set. Its events must include mail
7
13
  # tags and reach the dedicated SNS/SQS feedback route to resolve unknown sends.
8
14
  # Otherwise configure an appropriate default set on the sending identity.
@@ -1,5 +1,5 @@
1
1
  # frozen_string_literal: true
2
2
 
3
3
  module Hailer
4
- VERSION = '0.6.0'
4
+ VERSION = '0.7.1'
5
5
  end
Binary file
@@ -1,6 +1,6 @@
1
1
  {
2
- "version": "0.6.0",
2
+ "version": "0.7.1",
3
3
  "platform": "aarch64-linux-gnu",
4
4
  "target": "aarch64-unknown-linux-gnu",
5
- "sha256": "a6b40de1ddff29d72add5b474a47b971e82d401d954dc3eb4a208c073e214dac"
5
+ "sha256": "cc197634757007a40fc75b4b7a14ac196bdb85fc3fe719bf1530c2535bb220c5"
6
6
  }
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: hailer
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.6.0
4
+ version: 0.7.1
5
5
  platform: aarch64-linux-gnu
6
6
  authors:
7
7
  - Abdelkader Boudih