react-email-rails 0.12.0 → 0.12.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e2dc04e0c361e5517d66cf3a60a274b090bc5978b82ee4a77c07758ac8ca82e7
-  data.tar.gz: 027c7e6c6e4510621b6738c271f273a1a89a248e6de59772bc0af6fec7eebe4d
+  metadata.gz: 281158df961cccec48c34e03628715fda9a9c9cf16bbda4cae3097f380498a48
+  data.tar.gz: 68d882e14c9a5ed7281b5e1bb39a046e7ecb77314b25667cb27a289509aac319
 SHA512:
-  metadata.gz: b044fc510c92a914031d4932586b12f2a16c306fee35f4cb4088f22093910456b3a8e3fe4a1909d1e8a67ba10a6235462f4531858a6f575e3516ef8bea20e260
-  data.tar.gz: d30686390cf1c1d435a24ec640d3a5873cf7137e211c67e6e316a660c3ffa67ae6c78787b90075676ddab90ded4282b2db6730195120ff954c919fd58a3610f3
+  metadata.gz: 7a679b532deae816d2337e38810077045b85a38d0e0e86089d516ba70d8e9060a06b4c9e9af5a8fa4a7aaa310f101c2817c0f246e559f97c1baaf829f19db91c
+  data.tar.gz: 7117f2c68aacaa3a4683d2272384a8ee5171d3684c3ad2a7b809bb833e7b85b4a19df738de66de3c45ce234d7e87a78537db3d1c8b24c733fcb25b26b8fa3d60

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.12.1
+
+- Export `CamelMailer` and `CamelMessage` TypeScript types, plus a `Register` module augmentation (`propKeys: "camel"`) so apps that camelize props can type the injected `mailer` / `message` shapes without a local mapped type. Default `Mailer` / `Message` stay snake_case.
+- Timeouts that already received a partial response line no longer suggest a gem/npm version mismatch. The renderer drains stdout before deciding the process was silent.
+
 ## 0.12.0
 
 - **Breaking:** Remove `config.render_mode`. There is one renderer: a long-lived Node child per Ruby process, speaking newline-delimited JSON. Delete `config.render_mode = :persistent` from initializers. Set `config.render_process_max_requests = 1` to recycle the child after every email.

data/README.md

@@ -334,6 +334,8 @@ type WelcomeProps = {
 }
 ```
 
+The table shows the default snake_case keys. Keys follow `config.prop_transformer` just like your own props, so a camelize transformer yields `mailerName` / `replyTo` at runtime. Augment `Register` once so `Mailer` / `Message` match, or alias `CamelMailer` / `CamelMessage` — see [Prop Transformation](#prop-transformation).
+
 | Prop | Example |
 |------|---------|
 | `mailer.mailer_name` | `"account_mailer"` |
@@ -343,9 +345,7 @@ type WelcomeProps = {
 | `message.cc`, `message.bcc` | `["…"]` or `null` |
 | `message.from`, `message.reply_to` | `["app@example.com"]` |
 
-Context is merged before prop serialization, so keys follow `config.prop_transformer` just like your own props. The exported TypeScript types describe the default (untransformed) shape.
-
-Per-mail and shared props win on conflict, so a prop named `mailer` or `message` overrides the injected context. When props come from a serializer, the context is merged in as long as `as_json` returns a hash; collections, arrays, and other non-object values pass through unchanged so their top-level shape is preserved.
+Context is merged before prop serialization. Per-mail and shared props win on conflict, so a prop named `mailer` or `message` overrides the injected context. When props come from a serializer, the context is merged in as long as `as_json` returns a hash; collections, arrays, and other non-object values pass through unchanged so their top-level shape is preserved.
 
 ### Prop Serialization
 
@@ -435,9 +435,7 @@ end
 
 ### Prop Transformation
 
-Use `prop_transformer` to change props after `as_json` and before they reach React. The default is a no-op, matching [inertia-rails](https://inertia-rails.dev/guide/configuration#prop_transformer).
-
-To work with `snake_case` in Ruby and `camelCase` in components:
+Use `prop_transformer` to change props after `as_json` and before they reach React. To work with `snake_case` in Ruby and `camelCase` in components:
 
 ```ruby
 ReactEmailRails.configure do |config|
@@ -447,6 +445,29 @@ ReactEmailRails.configure do |config|
 end
 ```
 
+The transformer is arbitrary, so TypeScript cannot infer it. The default `Mailer` and `Message` types stay snake_case (`mailer_name`, `reply_to`). App-authored props (`expiresMinutes`, and so on) stay hand-typed in the app.
+
+If you camelize in Ruby, augment `Register` once so `import type { Mailer, Message }` matches runtime — the same "configure once" idea as the initializer:
+
+```ts
+// e.g. react-email-rails.d.ts
+import "react-email-rails"
+
+declare module "react-email-rails" {
+  interface Register {
+    propKeys: "camel"
+  }
+}
+```
+
+The `import "react-email-rails"` (or an `export {}`) makes the file a module so TypeScript *augments* the package. Without it, a script-style `.d.ts` replaces the module and you lose the rest of the package's types.
+
+If you do not want a `.d.ts`, alias the camel types at the import. `CamelMailer` and `CamelMessage` are always camel, regardless of `Register`:
+
+```ts
+import type { CamelMailer as Mailer, CamelMessage as Message } from "react-email-rails"
+```
+
 The transformer receives one hash at a time: the root props object, or each object in a top-level collection. Nested hashes inside a single object are left to the transformer — `deep_transform_keys` walks those.
 
 ### Render Process

data/lib/react_email_rails/renderer/child.rb

@@ -112,9 +112,16 @@ class ReactEmailRails::Renderer::Child
 
       remaining = deadline - monotonic_time
       if remaining <= 0 || IO.select([@stdout], nil, nil, remaining).nil?
-        silent = line.empty? && @stdout_buffer.empty?
+        drain_stdout_nonblock
+        if (buffered_line = consume_buffered_response_line)
+          line << buffered_line
+          return line
+        end
+
+        line << @stdout_buffer
+        @stdout_buffer.clear
         stop
-        raise(Timeout::Error, unmatched_package_message) if silent
+        raise(Timeout::Error, unmatched_package_message) if line.empty?
 
         raise(Timeout::Error)
       end
@@ -134,6 +141,12 @@ class ReactEmailRails::Renderer::Child
     "no response received; gem and npm package react-email-rails must both be #{ReactEmailRails::VERSION}"
   end
 
+  def drain_stdout_nonblock
+    loop { @stdout_buffer << @stdout.read_nonblock(16 * 1024) }
+  rescue IO::WaitReadable, IOError, Errno::EAGAIN, Errno::EINTR
+    nil
+  end
+
   def consume_buffered_response_line
     separator = @stdout_buffer.index("\n")
     return unless separator

data/lib/react_email_rails/version.rb

@@ -1,3 +1,3 @@
 module ReactEmailRails
-  VERSION = "0.12.0"
+  VERSION = "0.12.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: react-email-rails
 version: !ruby/object:Gem::Version
-  version: 0.12.0
+  version: 0.12.1
 platform: ruby
 authors:
 - Supertape