islandjs-rails 0.5.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 80cbddb05a05365fd47474178fd2fb2b403f69c597169fe16bcb93e558dbabb7
-  data.tar.gz: f342dd7687658b6c8df47cfa7566f2061517112eb248719c997b20ea2634d5bf
+  metadata.gz: dbf94679b0585877e9d92723888dc23756d797d3221b74ff06f5f54dd10dddcb
+  data.tar.gz: a07f1b4306486768fcc1060c1bcc7ebedce403c3d1e36b8193c2e0dab61c4093
 SHA512:
-  metadata.gz: 5e3ed8b8c57007f2011c9b875cef7a84b4b4f262038bc2f9c92cc7e98ebfd9ed66b73c2b0fd7e9a1da9bee499b2a036f0c9ed48dd34dd9fdc99e680d82dae908
-  data.tar.gz: ec2afebea06a97b95b7c22b71596c30b704e44bbf5c5a8b0579a497b5b44f89056efcdc5dbf2179564d74b921301740e4feef340d8257c3adbd7c72203c9b703
+  metadata.gz: e29967022d5e806b2313e67897e56f4d4a30c81e825b2fb33c1e80dce23fb213ca71a81af4a84033dc1c08db7ab4f91b7e98ed56cfca1dcd3388870f4aff8c64
+  data.tar.gz: fb5b8de3b03dc845ed4e1bb4bff6ee12c42ac1c30f0b0f2e1f4ea07340a454ea7b003e85813c6370e72b49c5698071da6262ea5e8182706f5cc62f19928b38c6

data/CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.7.0] - 2025-10-27
+
+### Added
+- **CleanIslandsPlugin**: Webpack plugin that automatically removes old island bundle files from the public directory after new builds, preventing stale file accumulation
+- Simplified build scripts by removing manual `rm -f public/islands_*` commands
+
+## [0.6.0] - 2025-10-24
+
+- **React 19 Support Added**
+- **Enhanced version parsing** in `cdn_package_name` with nil/empty string handling and exception safety
+- **SSL certificate issues** with improved fallback mechanism for CDN downloads
+
 ## [0.5.0] - 2025-09-29
 
 ### Added

data/README.md

@@ -3,8 +3,8 @@
 **Launch quickly:** *upgrade with vite only if necessary (MYAGNI).*
 
 [![CI](https://github.com/praxis-emergent/islandjs-rails/actions/workflows/github-actions-demo.yml/badge.svg)](https://github.com/praxis-emergent/islandjs-rails/actions/workflows/github-actions-demo.yml)
-[![Test Coverage](https://img.shields.io/badge/coverage-89.09%25-brightgreen.svg)](coverage/index.html)
-[![RSpec Tests](https://img.shields.io/badge/tests-162%20passing-brightgreen.svg)](spec/)
+[![Test Coverage](https://img.shields.io/badge/coverage-86.63%25-brightgreen.svg)](coverage/index.html)
+[![RSpec Tests](https://img.shields.io/badge/tests-367%20passing-brightgreen.svg)](spec/)
 [![Rails 8 Ready](https://img.shields.io/badge/Rails%208-Ready-brightgreen.svg)](#rails-8-ready)
 
 IslandJS Rails supports the development of React islands in Rails apps by synchronizing `package.json` dependencies with UMD libraries served in `public/islands/vendor`.
@@ -31,8 +31,8 @@ rails islandjs:init
 
 ### Install React
 ```bash
-rails "islandjs:install[react,18.3.1]"
-rails "islandjs:install[react-dom,18.3.1]"
+rails "islandjs:install[react,19.2.0]"
+rails "islandjs:install[react-dom,19.2.0]"
 ```
 
 ### Run Yarn In Development
@@ -115,7 +115,7 @@ Modern Rails developers face a painful choice:
 ### The IslandJS Rails Solution
 ```bash
 # Instead of complex vite/webpack configuration:
-rails "islandjs:install[react,18.3.1]"
+rails "islandjs:install[react,19.2.0]"
 rails "islandjs:install[react-beautiful-dnd]"
 rails "islandjs:install[quill]"
 rails "islandjs:install[recharts]"
@@ -132,7 +132,7 @@ const quill = new window.Quill("#editor", {
 });
 ```
 
-**Important Note:** IslandJS Rails works with packages that ship UMD builds. Many popular packages have UMD builds, but some modern packages do not — React 19+ removed UMD builds entirely. Future versions of IslandJS Rails will support local UMD generation for some packages (such as [React 19+](https://github.com/lofcz/umd-react)).
+**Important Note:** IslandJS Rails works with packages that ship UMD builds. Many popular packages have UMD builds, but some modern packages do not. Starting with **React 19**, official UMD builds were removed, but IslandJS Rails now automatically fetches React 19+ UMD builds from the community-maintained [`umd-react`](https://github.com/lofcz/umd-react) package. No manual setup needed.
 
 If you absolutely need a package that doesn't ship UMD builds, you have a few options:
 
@@ -170,12 +170,12 @@ rails islandjs:init
 
 # Install packages (adds to package.json + saves to vendor directory)
 rails "islandjs:install[react]"
-rails "islandjs:install[react,18.3.1]"       # With specific version
+rails "islandjs:install[react,19.2.0]"       # With specific version
 rails "islandjs:install[lodash]"
 
 # Update packages (updates package.json + refreshes vendor files)
 rails "islandjs:update[react]"
-rails "islandjs:update[react,18.3.1]"       # To specific version
+rails "islandjs:update[react,19.2.0]"       # To specific version
 
 # Remove packages (removes from package.json + deletes vendor files)
 rails "islandjs:remove[react]"
@@ -354,7 +354,7 @@ rails "islandjs:install[@solana/web3]"     # ❌ Wrong
 | Command | What it does | Example |
 |---------|--------------|---------|
 | `install` | Adds package via yarn + downloads UMD + saves to vendor | `rails islandjs:install[react]` |
-| `update` | Updates package version + refreshes UMD | `rails islandjs:update[react,18.3.1]` |
+| `update` | Updates package version + refreshes UMD | `rails islandjs:update[react,19.2.0]` |
 | `remove` | Removes package via yarn + deletes vendor files | `rails islandjs:remove[react]` |
 | `clean` | Removes ALL vendor files (destructive!) | `rails islandjs:clean` |
 

data/lib/islandjs_rails/configuration.rb

@@ -27,6 +27,20 @@ module IslandjsRails
       '@babel/preset-env' => 'babel-preset-env',
       '@babel/preset-react' => 'babel-preset-react'
     }.freeze
+    
+    # Maps packages to alternate CDN names (e.g., React 19+ → umd-react).
+    def cdn_package_name(package_name, version)
+      # Handle nil or empty version strings
+      return package_name if version.nil? || version.empty?
+      
+      # Check if React 19+ to use community-maintained umd-react package
+      if ['react', 'react-dom'].include?(package_name)
+        major_version = version.split('.').first.to_i rescue 0
+        return 'umd-react' if major_version >= 19
+      end
+      
+      package_name
+    end
 
     # Vendor file helper methods
     def vendor_manifest_path

data/lib/islandjs_rails/core.rb

@@ -63,8 +63,8 @@ module IslandjsRails
       
       puts "\n🎉 IslandjsRails initialized successfully!"
       puts "\n📋 Next steps:"
-      puts "1. Install libraries:  rails \"islandjs:install[react,18.3.1]\""
-      puts "                       rails \"islandjs:install[react-dom,18.3.1]\"  "
+      puts "1. Install libraries:  rails \"islandjs:install[react,19.2.0]\""
+      puts "                       rails \"islandjs:install[react-dom,19.2.0]\"  "
       puts "2. Start dev:          yarn watch"
       puts "3. Use components:     <%= react_component('HelloWorld') %>"
       puts "4. Build for prod:     yarn build"
@@ -281,6 +281,9 @@ module IslandjsRails
       version ||= version_for(package_name)
       return nil unless version
       
+      # Use cdn_package_name to handle React 19+ mapping to umd-react
+      cdn_package = configuration.cdn_package_name(package_name, version)
+      
       # Use original package name for URL, but get clean name for {name} substitution
       clean_name = (Configuration::SCOPED_PACKAGE_MAPPINGS[package_name] || package_name).split('/').last
       
@@ -292,8 +295,7 @@ module IslandjsRails
                  else
                    pattern  # Use pattern as-is for fixed filenames like IIFE
                  end
-          url = "#{cdn_base}/#{package_name}@#{version}/#{path}"
-
+          url = "#{cdn_base}/#{cdn_package}@#{version}/#{path}"
           
           if url_accessible?(url)
             puts "✓ Found island: #{url}"
@@ -306,20 +308,6 @@ module IslandjsRails
       nil
     end
 
-    def download_umd_content(url)
-      require 'net/http'
-      require 'uri'
-      
-      uri = URI(url)
-      response = Net::HTTP.get_response(uri)
-      
-      unless response.code == '200'
-        raise IslandjsRails::Error, "Failed to download UMD from #{url}: #{response.code}"
-      end
-      
-      response.body
-    end
-
     def find_working_umd_url(package_name, version)
       puts "  🔍 Searching for UMD build..."
       
@@ -334,7 +322,7 @@ module IslandjsRails
                  else
                    pattern  # Use pattern as-is for fixed filenames like IIFE
                  end
-          url = "#{cdn_base}/#{package_name}@#{version}/#{path}"
+          url = "#{cdn_base}/#{configuration.cdn_package_name(package_name, version)}@#{version}/#{path}"
 
           
           if url_accessible?(url)
@@ -353,18 +341,6 @@ module IslandjsRails
     end
 
     private
-
-    # Check if a URL is accessible (returns 200 status)
-    def url_accessible?(url)
-      require 'net/http'
-      require 'uri'
-      
-      uri = URI(url)
-      response = Net::HTTP.get_response(uri)
-      response.code == '200'
-    rescue => e
-      false
-    end
     
     # Check if a package has a partial file
     def has_partial?(package_name)

data/lib/islandjs_rails/core_methods.rb

@@ -37,8 +37,16 @@ module IslandjsRails
         return
       end
       
+      # Skip prompt in non-interactive mode
+      unless STDIN.tty?
+        puts "\n💡 To render your HelloWorld component:"
+        puts "   In any view: <%= react_component('HelloWorld') %>"
+        puts "   Don't forget to: yarn build && rails server"
+        return
+      end
+      
       print "\n❓ Would you like to create a demo route at /islandjs/react to showcase your HelloWorld component? (y/n): "
-      answer = STDIN.gets.chomp.downcase
+      answer = STDIN.gets&.chomp&.downcase
       
       if answer == 'y' || answer == 'yes'
         create_demo_route!
@@ -393,15 +401,36 @@ module IslandjsRails
       create_partial_file(package_name, umd_content, global_name)
     end
 
-    def download_umd_content(url)
+    def download_umd_content(url, use_ssl_verification = true)
+      require 'openssl'
       uri = URI(url)
-      response = Net::HTTP.get_response(uri)
       
-      if response.code == '200'
+      http_options = {
+        use_ssl: uri.scheme == 'https',
+        verify_mode: use_ssl_verification ? OpenSSL::SSL::VERIFY_PEER : OpenSSL::SSL::VERIFY_NONE
+      }
+      
+      begin
+        body = Net::HTTP.start(uri.host, uri.port, **http_options) do |http|
+          request = Net::HTTP::Get.new(uri.request_uri)
+          response = http.request(request)
+          
+          if response.code == '200'
+            response.body
+          else
+            raise IslandjsRails::Error, "Failed to download UMD from #{url}: #{response.code}"
+          end
+        end
+        
         # Force UTF-8 encoding to avoid encoding errors when writing to file
-        response.body.force_encoding('UTF-8')
-      else
-        raise IslandjsRails::Error, "Failed to download UMD from #{url}: #{response.code}"
+        body.force_encoding('UTF-8')
+      rescue OpenSSL::SSL::SSLError => ssl_error
+        if use_ssl_verification
+          $stderr.puts "⚠️  SSL verification failed, retrying without verification: #{ssl_error.message}"
+          return download_umd_content(url, false)
+        else
+          raise IslandjsRails::Error, "Failed to download UMD from #{url}: #{ssl_error.message}"
+        end
       end
     end
 
@@ -536,10 +565,45 @@ module IslandjsRails
       copy_template_file('webpack.config.js', configuration.webpack_config_path)
     end
 
-    def url_accessible?(url)
+    def url_accessible?(url, limit = 5, use_ssl_verification = true)
+      require 'openssl'
+      return false if limit == 0
+      
       uri = URI(url)
-      response = Net::HTTP.get_response(uri)
-      response.code == '200'
+      
+      # Use proper SSL verification by default, but allow fallback for certificate issues
+      http_options = {
+        use_ssl: uri.scheme == 'https',
+        verify_mode: use_ssl_verification ? OpenSSL::SSL::VERIFY_PEER : OpenSSL::SSL::VERIFY_NONE
+      }
+      
+      begin
+        Net::HTTP.start(uri.host, uri.port, **http_options) do |http|
+          request = Net::HTTP::Get.new(uri.request_uri)
+          response = http.request(request)
+          
+          case response
+          when Net::HTTPSuccess
+            return true
+          when Net::HTTPRedirection
+            # Follow redirects
+            location = response['location']
+            return url_accessible?(location, limit - 1, use_ssl_verification)
+          else
+            return false
+          end
+        end
+      rescue OpenSSL::SSL::SSLError => ssl_error
+        # If SSL verification fails and we're using verification, try once without it
+        # This handles local certificate store issues while still attempting security first
+        if use_ssl_verification
+          $stderr.puts "⚠️  SSL verification failed, retrying without verification: #{ssl_error.message}"
+          return url_accessible?(url, limit, false)
+        else
+          # Already tried without verification, give up
+          false
+        end
+      end
     rescue => e
       false
     end

data/lib/islandjs_rails/rails_helpers.rb

@@ -354,13 +354,13 @@ module IslandjsRails
               const element = React.createElement(#{namespace_with_optional}.#{component_name}, props);
               
               try {
-                // Use React 18 createRoot if available, fallback to React 17 render
+                // Use React 19 createRoot if available, fallback to React 17 render
                 if (window.ReactDOM.createRoot) {
                   if (!container._reactRoot) {
                     container._reactRoot = window.ReactDOM.createRoot(container);
                   }
                   container._reactRoot.render(element);
-                  // React 18 automatically clears container - no manual cleanup needed
+                  // React 19 automatically clears container - no manual cleanup needed
                 } else {
                   // React 17 - render is synchronous and clears container automatically
                   window.ReactDOM.render(element, container);
@@ -375,7 +375,7 @@ module IslandjsRails
               const container = document.getElementById('#{component_id}');
               if (!container) return;
               
-              // React 18 unmount
+              // React 19 unmount
               if (container._reactRoot) {
                 container._reactRoot.unmount();
                 container._reactRoot = null;

data/lib/islandjs_rails/tasks.rb

@@ -13,7 +13,7 @@ namespace :islandjs do
     
     if package_name.nil?
       puts "❌ Package name is required"
-      puts "Usage: rails \"islandjs:install[react,18.3.1]\""
+      puts "Usage: rails \"islandjs:install[react,19.2.0]\""
       exit 1
     end
     
@@ -27,7 +27,7 @@ namespace :islandjs do
     
     if package_name.nil?
       puts "❌ Package name is required"
-      puts "Usage: rails \"islandjs:update[react,18.3.1]\""
+      puts "Usage: rails \"islandjs:update[react,19.2.0]\""
       exit 1
     end
     

data/lib/islandjs_rails/version.rb

@@ -1,3 +1,3 @@
 module IslandjsRails
-  VERSION = "0.5.0"
+  VERSION = "0.7.0"
 end

data/lib/islandjs_rails.rb

@@ -22,6 +22,8 @@ module IslandjsRails
     'umd/{name}.production.min.js',
     'umd/{name}.development.js',
     'umd/{name}.min.js',
+    'umd/{name}.js',
+    'dist/{name}.production.min.js',
     'umd/{name}.js', 
     'dist/{name}.min.js',
     'dist/{name}.js',

data/lib/templates/package.json

@@ -3,8 +3,8 @@
   "version": "1.0.0",
   "private": true,
   "scripts": {
-    "build": "rm -f public/islands_* && NODE_ENV=production webpack",
-    "build:dev": "rm -f public/islands_* && NODE_ENV=production webpack",
+    "build": "NODE_ENV=production webpack",
+    "build:dev": "NODE_ENV=production webpack",
     "watch": "NODE_ENV=development webpack --watch"
   },
   "dependencies": {},

data/lib/templates/webpack.config.js

@@ -1,9 +1,44 @@
 const path = require('path');
 const TerserPlugin = require('terser-webpack-plugin');
 const { WebpackManifestPlugin } = require('webpack-manifest-plugin');
+const fs = require('fs');
 
 const isProduction = process.env.NODE_ENV === 'production';
 
+// Custom plugin to clean old island bundle files
+class CleanIslandsPlugin {
+  apply(compiler) {
+    compiler.hooks.afterEmit.tap('CleanIslandsPlugin', (compilation) => {
+      const publicDir = path.resolve(__dirname, 'public');
+      if (!fs.existsSync(publicDir)) return;
+      
+      // Get the newly emitted files
+      const emittedFiles = Object.keys(compilation.assets).map(
+        filename => filename.split('/').pop() // Get just the filename
+      );
+      
+      const files = fs.readdirSync(publicDir);
+      files.forEach(file => {
+        // Clean old islands files, but keep the newly emitted ones
+        // Also include .map and .LICENSE.txt files
+        const isEmitted = emittedFiles.includes(file) || 
+                         emittedFiles.some(ef => file.startsWith(ef) && (
+                           file.endsWith('.map') || file.endsWith('.LICENSE.txt')
+                         ));
+        
+        if (file.startsWith('islands_') && !isEmitted) {
+          const filePath = path.join(publicDir, file);
+          try {
+            fs.unlinkSync(filePath);
+          } catch (err) {
+            // Ignore errors
+          }
+        }
+      });
+    });
+  }
+}
+
 module.exports = {
   mode: isProduction ? 'production' : 'development',
   entry: {
@@ -40,6 +75,7 @@ module.exports = {
     minimizer: [new TerserPlugin()]
   },
   plugins: [
+    new CleanIslandsPlugin(),
     new WebpackManifestPlugin({
       fileName: 'islands_manifest.json',
       publicPath: '/'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: islandjs-rails
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Eric Arnold