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 +4 -4
- data/CHANGELOG.md +12 -0
- data/README.md +58 -6
- data/hailer.example.toml +6 -0
- data/lib/hailer/version.rb +1 -1
- data/vendor/aarch64-linux-gnu/bin/hailer +0 -0
- data/vendor/aarch64-linux-gnu/manifest.json +2 -2
- metadata +1 -1
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 422792d6aedbb1104221f99651bc85522d79183815bd47b035a32b3bb4e120a9
|
|
4
|
+
data.tar.gz: fb447f7a606e70c7e0df1657f5659b9f8d838ac7201193c4cc3883344a7f05cb
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
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
|
-
|
|
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
|
|
106
|
-
the
|
|
107
|
-
|
|
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.
|
data/lib/hailer/version.rb
CHANGED
|
Binary file
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "0.
|
|
2
|
+
"version": "0.7.1",
|
|
3
3
|
"platform": "aarch64-linux-gnu",
|
|
4
4
|
"target": "aarch64-unknown-linux-gnu",
|
|
5
|
-
"sha256": "
|
|
5
|
+
"sha256": "cc197634757007a40fc75b4b7a14ac196bdb85fc3fe719bf1530c2535bb220c5"
|
|
6
6
|
}
|