tombolo 0.9.1 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c83c9dbdab6b8ff99150d3fa57531514628e2c4c98ed68f655cd4cc557553429
-  data.tar.gz: 18ce866491063647ae333e0f4cb6e768cef06c843139f97df077d4301aebd1d4
+  metadata.gz: 873413c284aae7d6d0c85db23c2003bbd30370ccd91b37f0b48c2b67da547799
+  data.tar.gz: 035a44bd53c27c2c2175a2502f13ad70968b7203a78beb7bd175f18162d42ec4
 SHA512:
-  metadata.gz: aff5dfca04cf8bd500be3cc099b36a7a85f4d65a4b138e99f7a44ec9feb47c02ee7e65bcae57ae458ab31884d0e6ffe06eed1d6787522b54eac9a7fd248ab940
-  data.tar.gz: 16d329db50843678dacc5d8b8d50a1c20d6c453b3dec5ca5a7b98cf1058c85d3a1c1f0987c179ed22edf3d85451d52f166c881e4116a886deab1dadfb89c570c
+  metadata.gz: 5d8acbf9ebf978d082922b21d6385742307329856846e30aa2835a0cb1a8d531b5eb5346398c9dba0eb144020d979032871e9b20b9850e1ee1efef58cd86c7b5
+  data.tar.gz: d91194cfd684ac5f781ff7b692380f6fc9a2d00054517816525d6fe6f0be91696f1a933185b884b8146566e1d9f73201422875e4ee4e7cdc33a0fa9925f64dad

data/README.md

@@ -150,6 +150,28 @@ Tombolo.configure do |config|
 end
 ```
 
+#### Named render scopes
+
+If your app needs multiple SSR bundles with different sets of components, you
+can register named render scopes. Each scope gets its own isolated ExecJS
+runtime:
+
+```ruby
+Tombolo.configuration.server_bundles[:admin] = "app/assets/builds/admin/prerender.js"
+Tombolo.configuration.server_bundles[:storefront] = "app/assets/builds/storefront/prerender.js"
+```
+
+Then reference the scope by name:
+
+```erb
+<%= react_component("Dashboard", prerender: :admin, props: { ... }) %>
+<%= react_component("ProductGrid", prerender: :storefront, props: { ... }) %>
+<%= react_component("Greeting", prerender: true, props: { ... }) %>  <%# uses :default %>
+```
+
+`prerender: true` uses the `:default` bundle. `prerender: :name` uses a named
+bundle.
+
 ## Configuration
 
 ```ruby
@@ -157,9 +179,12 @@ Tombolo.configure do |config|
   # Convert snake_case prop keys to camelCase (default: false)
   config.camelize_props = true
 
-  # Path to the server-side JS bundle for SSR
+  # Path to the default server-side JS bundle for SSR
   # (default: "app/assets/builds/prerender.js")
   config.server_bundle = "app/assets/builds/prerender.js"
+
+  # Named server bundles for isolated SSR render scopes
+  # config.server_bundles[:admin] = "path/to/admin/prerender.js"
 end
 ```
 
@@ -203,9 +228,9 @@ making it callable from ExecJS. Used in server entry points for SSR.
 
 Renders a `<div>` with `data-react-component` and `data-react-props`
 attributes. When `prerender: true`, the component is rendered on the server
-via ExecJS and the HTML is placed inside the div. Pass `camelize_props: true`
-to convert snake_case prop keys to camelCase, or set it globally in the
-configuration.
+via ExecJS using the `:default` bundle. Pass a Symbol (e.g. `prerender: :admin`)
+to use a named render scope instead. Pass `camelize_props: true` to convert
+snake_case prop keys to camelCase, or set it globally in the configuration.
 
 #### `Tombolo.configure { |config| ... }`
 

data/lib/tombolo/configuration.rb

@@ -2,11 +2,16 @@
 
 module Tombolo
   class Configuration
-    attr_accessor :camelize_props, :server_bundle
+    attr_accessor :camelize_props
+    attr_reader :server_bundles
 
     def initialize
       @camelize_props = false
-      @server_bundle = "app/assets/builds/prerender.js"
+      @server_bundles = { default: "app/assets/builds/prerender.js" }
+    end
+
+    def server_bundle=(path)
+      @server_bundles[:default] = path
     end
   end
 end

data/lib/tombolo/renderer.rb

@@ -10,7 +10,8 @@ end
 
 module Tombolo
   class Renderer
-    def initialize
+    def initialize(server_bundle:)
+      @server_bundle = server_bundle
       @mutex = Mutex.new
       @context = nil
     end
@@ -28,10 +29,9 @@ module Tombolo
     end
 
     def bundle_source
-      path = Tombolo.configuration.server_bundle
-      raise "Tombolo server bundle not found: #{path}" unless File.exist?(path)
+      raise "Tombolo server bundle not found: #{@server_bundle}" unless File.exist?(@server_bundle)
 
-      console_polyfill + File.read(path)
+      console_polyfill + File.read(@server_bundle)
     end
 
     def console_polyfill

data/lib/tombolo/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Tombolo
-  VERSION = "0.9.1"
+  VERSION = "0.10.0"
 end

data/lib/tombolo/view_helper.rb

@@ -11,14 +11,19 @@ module Tombolo
 
       props_json = props.to_json
       data = { react_component: name, react_props: props_json }
-
-      content = ""
-      if prerender
-        data[:react_prerender] = ""
-        content = Tombolo.renderer.render(name, props_json).html_safe # rubocop:disable Rails/OutputSafety
-      end
+      content = prerender_content(name, props_json, prerender, data)
 
       content_tag(:div, content, data:)
     end
+
+    private
+
+    def prerender_content(name, props_json, prerender, data)
+      return "" unless prerender
+
+      data[:react_prerender] = ""
+      renderer = Tombolo.renderer(prerender == true ? :default : prerender)
+      renderer.render(name, props_json).html_safe # rubocop:disable Rails/OutputSafety
+    end
   end
 end

data/lib/tombolo.rb

@@ -15,16 +15,20 @@ module Tombolo
       yield configuration
     end
 
-    def renderer
-      @renderer ||= begin
+    def renderer(name = :default)
+      @renderers ||= {}
+      @renderers[name] ||= begin
+        path = configuration.server_bundles[name]
+        raise ArgumentError, "No server bundle configured for #{name.inspect}" unless path
+
         require "tombolo/renderer"
-        Renderer.new
+        Renderer.new(server_bundle: path)
       end
     end
 
     def reset!
       @configuration = nil
-      @renderer = nil
+      @renderers = nil
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tombolo
 version: !ruby/object:Gem::Version
-  version: 0.9.1
+  version: 0.10.0
 platform: ruby
 authors:
 - Inge Jørgensen