swal_rails 0.5.3 → 0.5.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6c49b9704c1487d09b19e033865c58f90d7f81e65e56767eabc0a33e26a8be31
-  data.tar.gz: a583b4d1b8a3fe9419a76e8f1fbb3e858f966f3fcab706acdf292811f547ad5d
+  metadata.gz: ce37abdde2118615b9dfd19d6b842f4746b72f3114b768836e1bd9505aa6deb4
+  data.tar.gz: e4005e48265167c93acb12966c8c90dd3adc066f3bad03746a891379edeb1327
 SHA512:
-  metadata.gz: 7c09d7396ccb260faa867e40a4b343140b3940e4318c36a8183a1c60536afa397c8a440ad2e937b8e22dc2950c5cddc316c2afe4dd25fab97386c4fdb28248db
-  data.tar.gz: 1234f7dfb92d65280097a09ad29af3b562dc379c76178c61710d8990b88b7a1478fd2239c75ade797d42d1dd24637d3ebefcda0f0e6f376ce89d64c8b8c31aad
+  metadata.gz: 6e464440f41eb284dbde8ebd70f093030fe46bc01edf03489d6a6b2bc9efa35e6ce98e1e6e85c7272061e3bba225de6668753ac4141025dd1b412ebb9293090b
+  data.tar.gz: 4d65e1922c6eae44d2213a75c3074e965b5d52aa51f1c9198e3da29ebf4c8e2761c34aea1f54b5d11390a73f7cf9e66a5252cc922111101b22f6ce8ca01d7005

data/CHANGELOG.md

@@ -6,6 +6,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.5.4] - 2026-07-15
+
+### Fixed
+- **Toast parasite `true` sur un flash non-message** — `build_flash_payload` ne
+  filtrait que sur `blank?`, or `true.blank?` est `false` : un flash booléen
+  passait le filtre et devenait `{ text: "true" }` via `to_s`. Devise
+  `:timeoutable` pose `flash[:timedout] = true` à côté du vrai `:alert` à
+  l'expiration de session, d'où un toast bleu affichant littéralement `true` sur
+  la page de login. La clé n'étant pas dans `flash_map`, le runtime JS y
+  appliquait en plus son fallback (`icon: info`, `position: top-end`) — mais la
+  chaîne était fabriquée côté serveur. Les valeurs qui ne sont ni `String` ni
+  `Hash` sont désormais ignorées : un flag technique n'est pas un message. Même
+  garde dans `swal_flash`, où une valeur non rendable devient un no-op plutôt
+  qu'un toast absurde. Aucune app n'était fautive — le bug touchait toute
+  combinaison Devise + `swal_rails`.
+  Closes [#36](https://github.com/Metalzoid/swal_rails/issues/36).
+- **Doc : `flash_map[:key] = nil` ne silence pas une clé** — l'initializer généré
+  affirmait « Set a key to nil to silence it ». C'est faux : `nil` sérialise en
+  `null`, le runtime résout le spec via une chaîne `||` et retombe donc sur son
+  fallback (`icon: info`, `position: top-end`, 3s) — la clé s'affiche, en pire.
+  `flash_map` choisit *comment* un message est rendu, jamais *s'il* est rendu.
+  Commentaire du template corrigé et fallback documenté dans le README ; le
+  comportement du code est inchangé.
+
 ## [0.5.3] - 2026-07-15
 
 ### Changed

data/README.md

@@ -582,6 +582,8 @@ SwalRails.reset_configuration!             # resets to defaults (test fixture he
 > 💡 **Prefer a modal for errors?** Override in your initializer:
 > `config.flash_map[:alert] = { icon: "error", toast: false }`.
 
+A flash key that is absent from the map — or explicitly set to `nil` — is **not** silenced: the runtime falls back to a generic info toast (`icon: "info"`, `toast: true`, `position: "top-end"`, `timer: 3000`). `flash_map` selects *how* a message renders, never *whether* it renders. What a key is never asked to render is a non-`String`/`Hash` value — see [Flash value shapes](#flash-value-shapes).
+
 #### `to_client_payload` (internal, read-only)
 
 Serialization contract consumed by the JS runtime via the
@@ -756,7 +758,7 @@ Returns `true` iff a complete path through the chain was confirmed. `steps` may
 | `swal-config` | `to_client_payload` JSON | Runtime boot — mixin, confirm handler, flash handler. Once per page. |
 | `swal-flash`  | Array of `{ key, options }` | Flash runtime — re-read on every `turbo:load`. |
 
-Flash entries are `{ key: "notice", options: { text: "..." } }` for string values, or `{ key: "notice", options: {...user hash...} }` for Hash values. Arrays in `flash[key]` are expanded into one entry per element.
+Flash entries are `{ key: "notice", options: { text: "..." } }` for string values, or `{ key: "notice", options: {...user hash...} }` for Hash values. Arrays in `flash[key]` are expanded into one entry per element. Values of any other type are omitted from the payload entirely — see [Flash value shapes](#flash-value-shapes).
 
 ---
 
@@ -795,8 +797,9 @@ No flags. Copies `config/locales/swal_rails.en.yml` and `swal_rails.fr.yml` from
 | ---------- | ----------- |
 | `String`   | `{ text: value }` — safe by default (SA2 renders via `text:`, no HTML injection). |
 | `Hash`     | Full SA2 options, **shadows** `flash_map[key]`. Any SA2 key is accepted (icon, timer, input, html, iconHtml, …). |
-| `Array`    | Expanded into one entry per element. Strings become `{ text: elem }`, Hashes pass through verbatim. |
+| `Array`    | Expanded into one entry per element. Strings become `{ text: elem }`, Hashes pass through verbatim. Non-renderable elements are dropped individually. |
 | `nil` / `""` / `blank?` | Skipped. |
+| Anything else (`true`, `Symbol`, `Integer`, arbitrary objects) | Skipped — a technical flag is not a message. Covers Devise `:timeoutable`, which writes `flash[:timedout] = true` next to the real `:alert`. |
 
 Key normalization: Hash keys are `symbolize_keys`-ed before serialization, so `flash[:notice] = { "text" => "..." }` and `flash[:notice] = { text: "..." }` are equivalent.
 

data/lib/generators/swal_rails/install/templates/initializer.rb

@@ -32,7 +32,9 @@ SwalRails.configure do |config|
   }
 
   # Map Rails flash keys to SweetAlert2 options.
-  # Set a key to nil to silence it. Customize icon/toast/position/timer per key.
+  # Customize icon/toast/position/timer per key. A key that is absent from the
+  # map — or set to nil — is not silenced: it falls back to a generic info toast
+  # (top-end, 3s). Only String/Hash flash values are rendered at all.
   config.flash_map[:notice]  = { icon: "success", toast: true, position: "top-end", timer: 3000, timerProgressBar: true, showConfirmButton: false }
   config.flash_map[:success] = { icon: "success", toast: true, position: "top-end", timer: 3000, timerProgressBar: true, showConfirmButton: false }
   config.flash_map[:alert]   = { icon: "error",   toast: true, position: "top-end", timer: 4000, timerProgressBar: true, showConfirmButton: false }

data/lib/swal_rails/helpers.rb

@@ -33,12 +33,17 @@ module SwalRails
     # Also accepts per-request option overrides:
     #   flash[:notice] = "Saved"                                       # string shortcut
     #   flash[:notice] = { text: "Saved", icon: "star", timer: 5000 }  # full SA2 options
+    #
+    # Values that are neither String nor Hash are technical flags, not messages —
+    # Devise `:timeoutable` writes `flash[:timedout] = true` — so they are skipped
+    # rather than stringified into a toast reading "true".
     def build_flash_payload
       flash.to_h.flat_map do |key, message|
         flash_messages(message).filter_map do |m|
           next if m.blank?
+          next unless m.is_a?(String) || m.is_a?(Hash)
 
-          options = m.is_a?(Hash) ? m.symbolize_keys : { text: m.to_s }
+          options = m.is_a?(Hash) ? m.symbolize_keys : { text: m }
           { key: key.to_s, options: options }
         end
       end
@@ -80,12 +85,15 @@ module SwalRails
       meta
     end
 
+    # Same String/Hash gate as build_flash_payload — a non-message value is
+    # dropped, and an all-dropped list leaves the flash key unwritten.
     def build_swal_flash_entries(messages, meta, options)
       list = messages.is_a?(Array) ? messages : [messages]
       list.filter_map do |m|
         next if m.blank?
+        next unless m.is_a?(String) || m.is_a?(Hash)
 
-        base = m.is_a?(Hash) ? m.symbolize_keys : { text: m.to_s }
+        base = m.is_a?(Hash) ? m.symbolize_keys : { text: m }
         base.merge(options).merge(meta)
       end
     end

data/lib/swal_rails/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module SwalRails
-  VERSION = "0.5.3"
+  VERSION = "0.5.4"
   SWEETALERT2_VERSION = "11.26.25"
 end

data/npm/package.json

@@ -1,6 +1,6 @@
 {
   "name": "swal_rails",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "description": "SweetAlert2 for Rails 7+ — batteries included (jsbundling companion)",
   "type": "module",
   "main": "index.js",

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: swal_rails
 version: !ruby/object:Gem::Version
-  version: 0.5.3
+  version: 0.5.4
 platform: ruby
 authors:
 - Florian Gagnaire