homura-runtime 0.2.4 → 0.2.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a7e0278919623ca0bd4057dd685cc0a6121efa0d36e0f0a7eeb8bc9e404938a8
-  data.tar.gz: 3896ecbe9174de362fd6e9dc4d24ec015adf495bce80b045bd61d2c4a305791d
+  metadata.gz: 37cf4aa4a816991923d004144655459aef2da15445ee0c23aaf94105e36e892d
+  data.tar.gz: ceae9042b8c7613d03f12be573977846838888d74429e829c01b6328f81f2286
 SHA512:
-  metadata.gz: 2607d862746d48cad7eb8c28a8e1cb39477c95fab45c6f90ea0cc8e773dadfca54d1e2d3cb0842774cec3bddbe7216ce0efd433f147f48c86a97a2118f29edd4
-  data.tar.gz: 14a8a0faca16aa7f1f8ed9a49c2bbc194afd4417a2d4b808519d1d144a94b9ac2a75a01fbdbceb385e732228f3b0bba91667f3d17d5004cec8f3d17ccf72f380
+  metadata.gz: 96c093338500d78dde842fc48fe28807749e9ccb68e4fb3157e34fa81e95ae54e75b65b7d6708b38d60e782670553ff4b007aa40f73c8ad2fda4a2d6b9d38d91
+  data.tar.gz: 44967c5dfb3edf5b3bfbb52d4f9e8c6e996436de41121b8324f74aad07c694ef133b725906b156d35df10abf023242003236d1cd955846a8a86d3030bc0d5561

data/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 0.2.6 (2026-04-24)
+
+- Remove the shipped `cloudflare-workers-build` filename entirely and keep the
+  build implementation under `exe/homura-build`, matching the `homura build`
+  public surface.
+- Make `homura build --with-db` imply the consumer-safe standalone path so D1 /
+  Sequel apps do not need to remember both flags.
+- Let `compile-assets` succeed for an empty `public/` directory and improve the
+  auto-await analyzer so async local helper methods are awaited at their call
+  sites.
+
+## 0.2.5 (2026-04-23)
+
+- Load Workers-only `zlib`, `tempfile`, and `tilt` shims via `require_relative`
+  so plain `opal` CLI builds can require `opal_patches` without extra vendor
+  load path wiring.
+- Recursively convert nested plain JS objects in `Cloudflare.js_object_to_hash`
+  so D1 metadata behaves like Ruby `Hash` values all the way down.
+- Pin `opal-homura` to `1.8.3.rc1.3` for the restored `digest` stdlib shim.
+
 ## 0.2.4 (2026-04-23)
 
 - Guard the Rack body close hook against raw JS `undefined` so Workers request teardown
@@ -18,14 +38,14 @@
 
 ## 0.2.0 (2026-04-23)
 
-- Remove the old `cloudflare-workers-build` public executable and expose the
+- Remove the old standalone build executable and expose the
   build pipeline through `homura build`.
 - Keep the internal build implementation in the runtime gem while letting the
   single `homura` CLI dispatch to it.
 
 ## 0.1.6 (2026-04-23)
 
-- Teach `cloudflare-workers-build --standalone --with-db` to add the packaged
+- Teach `homura build --standalone --with-db` to add the packaged
   `sequel-d1` gem `vendor/` directory to the Opal load path before the gem's
   `lib/`, so `require 'sequel'` resolves to the bundled Opal-compatible Sequel
   subset instead of the CRuby gem.
@@ -34,7 +54,7 @@
 
 - Make `auto-await` emit rewritten files for existing hand-written `.__await__`
   usage when the only missing piece is `# await: true`.
-- Make `cloudflare-workers-build --standalone` restore `cf-runtime/` from the
+- Make `homura build --standalone` restore `cf-runtime/` from the
   packaged gem and derive standalone template/asset namespaces from the project
   name by default, with explicit override flags when needed.
 - Reject unsupported ERB yield forms like `<% yield %>` and `yield(arg)` with
@@ -59,12 +79,12 @@
 
 - Package the runtime's Opal compile-time vendor shims (`digest`, `zlib`,
   `tempfile`, `tilt`, `rubygems/version`) inside the gem.
-- Teach `cloudflare-workers-build --standalone` to add packaged gem `vendor/`
+- Teach `homura build --standalone` to add packaged gem `vendor/`
   directories to the Opal load path, so published gems no longer depend on the
   monorepo root `vendor/`.
 ## 0.1.1 (2026-04-23)
 
-- Fix `cloudflare-workers-build --standalone` and `exe/auto-await` to resolve only
+- Fix `homura build --standalone` and `exe/auto-await` to resolve only
   the published gem names `homura-runtime` / `sinatra-homura`.
 - Add regression coverage for gem name resolution and Gemfile path detection.
 

data/README.md

@@ -14,7 +14,7 @@ Core Ruby + Module Worker glue for [Opal](https://opalrb.com/) on [Cloudflare Wo
 
 ## Quick start (homura monorepo)
 
-1. `Gemfile`: `gem 'homura-runtime', path: 'gems/homura-runtime'` and `gem 'opal-homura', '= 1.8.3.rc1.2', require: 'opal'` (path or exact pin).
+1. `Gemfile`: `gem 'homura-runtime', path: 'gems/homura-runtime'` and `gem 'opal-homura', '= 1.8.3.rc1.3', require: 'opal'` (path or exact pin).
 2. `bundle exec homura build` — writes `build/hello.no-exit.mjs` and `build/worker.entrypoint.mjs`.
 3. `wrangler.toml`: `main = "build/worker.entrypoint.mjs"`, `compatibility_flags = ["nodejs_compat"]`.
 
@@ -25,7 +25,7 @@ Core Ruby + Module Worker glue for [Opal](https://opalrb.com/) on [Cloudflare Wo
 | Ruby       | 3.4.x            |
 | Node       | ≥ 20             |
 | Wrangler   | ^3.99            |
-| Opal       | = 1.8.3.rc1.2    |
+| Opal       | = 1.8.3.rc1.3    |
 
 ## Wrangler config
 

data/exe/compile-assets

@@ -82,10 +82,6 @@ end
 ns = options[:namespace]
 
 files = Dir.glob(File.join(public_dir, '**', '*')).select { |f| File.file?(f) }.sort
-if files.empty?
-  warn 'compile-assets: directory is empty'
-  exit 1
-end
 
 out_path = options[:output]
 FileUtils.mkdir_p(File.dirname(out_path))

data/{bin/cloudflare-workers-build → exe/homura-build}

@@ -69,6 +69,8 @@ OptionParser.new do |o|
   o.on('--assets-namespace NAME', 'Standalone assets module name (default: project-derived)') { |n| options[:assets_namespace] = n }
 end.parse!
 
+options[:standalone] = true if options[:with_db]
+
 root = Pathname(options[:root]).expand_path
 options[:templates_namespace] ||= CloudflareWorkers::BuildSupport.standalone_namespace(root, 'Templates') if options[:standalone]
 options[:assets_namespace] ||= CloudflareWorkers::BuildSupport.standalone_namespace(root, 'Assets') if options[:standalone]
@@ -113,7 +115,7 @@ def run_opal_homura!(root, opal_input, opal_output)
   env = { 'OPAL_PREFORK_DISABLE' => '1' }
   out_err, status = Open3.capture2e(env, *argv, chdir: root.to_s)
   File.write(stderr_log, out_err)
-  abort('homura build: opal failed') unless status.success?
+  abort("homura build: opal failed (see #{stderr_log})") unless status.success?
 end
 
 def homura_vendor_from_gemfile(project_root)
@@ -132,7 +134,7 @@ def run_opal_standalone!(root, opal_input, opal_output, with_db:)
   env = { 'OPAL_PREFORK_DISABLE' => '1' }
   out_err, status = Open3.capture2e(env, *argv, chdir: root.to_s)
   File.write(stderr_log, out_err)
-  abort('homura build: opal failed') unless status.success?
+  abort("homura build: opal failed (see #{stderr_log})") unless status.success?
 end
 
 def write_entrypoint!(root, out_path, setup:, bundle:, worker_mod:)

data/lib/cloudflare_workers/async_registry.rb

@@ -79,7 +79,7 @@ module CloudflareWorkers
           next unless Dir.exist?(lib_dir)
 
           Dir.glob(File.join(lib_dir, '**', '*.rb')).each do |path|
-            next unless File.read(path, 8192).include?('register_async_source')
+            next unless File.read(path).include?('register_async_source')
 
             require_path = path.sub(Regexp.new("^#{Regexp.escape(lib_dir)}/"), '').sub(/\.rb\z/, '')
             begin

data/lib/cloudflare_workers/auto_await/analyzer.rb

@@ -2,6 +2,7 @@
 
 require 'parser/current'
 require 'parser/source/tree_rewriter'
+require 'set'
 
 module CloudflareWorkers
   module AutoAwait
@@ -12,6 +13,7 @@ module CloudflareWorkers
         @await_nodes = []
         @env = {}
         @method_returns = {}
+        @async_local_methods = Set.new
       end
 
       def process(source, filename = '(auto-await)')
@@ -19,14 +21,22 @@ module CloudflareWorkers
         buffer.source = source
         parser = Parser::CurrentRuby.new
         ast = parser.parse(buffer)
-        @await_nodes = []
-        @env = {}
-        process_node(ast)
+        @method_returns = {}
+        @async_local_methods = Set.new
+
+        analyze_pass(ast)
+        analyze_pass(ast)
         [buffer, @await_nodes]
       end
 
       private
 
+      def analyze_pass(ast)
+        @await_nodes = []
+        @env = {}
+        process_node(ast)
+      end
+
       def process_node(node)
         return unless node.is_a?(Parser::AST::Node)
 
@@ -72,6 +82,7 @@ module CloudflareWorkers
       def process_def(node)
         method_name = node.children[0]
         saved_env = @env
+        before_awaits = @await_nodes.length
         @env = @registry.helper_factories.dup
 
         node.children[1..-1].each { |child| process_node(child) if child.is_a?(Parser::AST::Node) }
@@ -79,6 +90,10 @@ module CloudflareWorkers
         body = node.children[2]
         return_cls = infer_class(body)
         @method_returns[method_name] = return_cls if return_cls
+        body_source = node.loc.expression&.source.to_s
+        if @await_nodes.length > before_awaits || body_source.include?('.__await__')
+          @async_local_methods << method_name
+        end
 
         @env = saved_env
       end
@@ -119,6 +134,7 @@ module CloudflareWorkers
         # Receiver-less calls (implicit self) — check helpers.
         helpers = @registry.async_helpers[method_name]
         return true if helpers && !helpers.empty?
+        return true if @async_local_methods.include?(method_name)
         false
       end
 

data/lib/cloudflare_workers/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module CloudflareWorkers
-  VERSION = '0.2.4'
+  VERSION = '0.2.6'
 end

data/lib/cloudflare_workers.rb

@@ -144,7 +144,10 @@ module Rack
         raise '`run app` was never called from user code' if @app.nil?
 
         env = build_rack_env(js_req, js_env, js_ctx, body_text)
-        status, headers, body = @app.call(env)
+        result = @app.call(env)
+        result = result.__await__ if defined?(::Cloudflare) && ::Cloudflare.js_promise?(result)
+
+        status, headers, body = result
         build_js_response(status, headers, body)
       ensure
         body.close if body && body.respond_to?(:close)
@@ -484,7 +487,9 @@ module Cloudflare
     out
   end
 
-  # Shallow copy of a JS object's own enumerable string keys into a Hash.
+  # Deep copy of a JS object's own enumerable string keys into a Hash.
+  # Recursively converts nested plain objects so Opal code can call
+  # Ruby methods (e.g. #is_a?) on every value.
   def self.js_object_to_hash(js_obj)
     h = {}
     return h if `#{js_obj} == null`
@@ -494,6 +499,8 @@ module Cloudflare
     while i < len
       k = `#{keys}[#{i}]`
       v = `#{js_obj}[#{k}]`
+      # Recurse for nested plain objects (but not Arrays, Dates, etc.)
+      v = js_object_to_hash(v) if `typeof #{v} === 'object' && #{v} != null && !Array.isArray(#{v}) && !(#{v} instanceof Date)`
       h[k] = v
       i += 1
     end

data/lib/homura_vendor_tempfile.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require 'stringio'
+
+class Tempfile < StringIO
+  def initialize(*)
+    super('')
+  end
+
+  def self.open(*)
+    raise NotImplementedError, 'Tempfile is stubbed in homura (Workers have no writable FS)'
+  end
+
+  def path
+    raise NotImplementedError, 'Tempfile#path stubbed (no FS)'
+  end
+
+  def unlink
+    self
+  end
+
+  def delete
+    self
+  end
+
+  def close!
+    close
+  end
+end

data/lib/homura_vendor_tilt.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module Tilt
+  class TemplateNotFound < StandardError; end
+
+  class Cache
+    def initialize
+      @cache = {}
+    end
+
+    def fetch(*key)
+      @cache[key] ||= yield
+    end
+
+    def clear
+      @cache.clear
+    end
+  end
+
+  class Mapping
+    def initialize
+      @extensions = {}
+    end
+
+    def register(template_class, *extensions)
+      extensions.each { |ext| @extensions[ext.to_s] = template_class }
+    end
+
+    def [](name)
+      @extensions[name.to_s]
+    end
+
+    def extensions_for(engine_or_class)
+      @extensions.each_with_object([]) do |(ext, klass), out|
+        out << ext if klass == engine_or_class
+      end
+    end
+
+    def template_for(name)
+      @extensions[name.to_s]
+    end
+  end
+
+  class << self
+    def default_mapping
+      @default_mapping ||= Mapping.new
+    end
+
+    def [](name)
+      default_mapping[name]
+    end
+
+    def register(template_class, *extensions)
+      default_mapping.register(template_class, *extensions)
+    end
+
+    def new(file = nil, line = nil, options = {}, &block)
+      raise NotImplementedError,
+            'Tilt template rendering is not available in homura Phase 2 ' \
+            '(stubbed). Return Strings or arrays from your Sinatra handlers.'
+    end
+  end
+end

data/lib/homura_vendor_zlib.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Zlib
+  class Error < StandardError; end
+
+  class GzipFile
+    class Error < Zlib::Error; end
+    class CRCError < Error; end
+    class LengthError < Error; end
+    class NoFooter < Error; end
+  end
+
+  class GzipReader < GzipFile
+    def self.wrap(*)
+      raise NotImplementedError, 'Zlib stubbed'
+    end
+  end
+
+  class GzipWriter < GzipFile
+    def self.wrap(*)
+      raise NotImplementedError, 'Zlib stubbed'
+    end
+  end
+
+  class Deflate
+    def self.deflate(*)
+      raise NotImplementedError, 'Zlib stubbed'
+    end
+
+    def initialize(*); end
+
+    def deflate(*)
+      raise NotImplementedError, 'Zlib stubbed'
+    end
+
+    def finish
+      raise NotImplementedError, 'Zlib stubbed'
+    end
+
+    def close; end
+  end
+
+  class Inflate
+    def self.inflate(*)
+      raise NotImplementedError, 'Zlib stubbed'
+    end
+  end
+
+  DEFAULT_COMPRESSION = -1
+  BEST_SPEED = 1
+  BEST_COMPRESSION = 9
+end

data/lib/opal_patches.rb

@@ -396,14 +396,15 @@ end
 # same strength CRuby Sinatra gives you when SecureRandom is unavailable
 # (it falls back to `Kernel.rand`), so we are not reducing security
 # beyond upstream's own fallback path.
-# Ensure our Digest/Zlib/Tempfile/Tilt stubs from vendor/ are available
-# everywhere, even when a gem references `Digest::SHA1` at class body
-# time without explicitly `require 'digest'`-ing first.
+# Ensure our Digest/Zlib/Tempfile/Tilt shims are available when
+# `opal_patches` is loaded directly through the plain Opal CLI as well as
+# through `homura build`. Digest itself now lives in opal-homura stdlib;
+# the remaining Workers-specific shims stay local to this gem.
 require 'digest'
 require 'digest/sha2'
-require 'zlib'
-require 'tempfile'
-require 'tilt'
+require 'homura_vendor_zlib'
+require 'homura_vendor_tempfile'
+require 'homura_vendor_tilt'
 
 module ::SecureRandom
   # Raised when neither node:crypto.randomBytes nor Web Crypto

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: homura-runtime
 version: !ruby/object:Gem::Version
-  version: 0.2.4
+  version: 0.2.6
 platform: ruby
 authors:
 - Kazuhiro Homma
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.8.3.rc1.2
+        version: 1.8.3.rc1.3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.8.3.rc1.2
+        version: 1.8.3.rc1.3
 - !ruby/object:Gem::Dependency
   name: parser
   requirement: !ruby/object:Gem::Requirement
@@ -48,11 +48,11 @@ extra_rdoc_files: []
 files:
 - CHANGELOG.md
 - README.md
-- bin/cloudflare-workers-build
 - docs/ARCHITECTURE.md
 - exe/auto-await
 - exe/compile-assets
 - exe/compile-erb
+- exe/homura-build
 - lib/cloudflare_workers.rb
 - lib/cloudflare_workers/ai.rb
 - lib/cloudflare_workers/async_registry.rb
@@ -68,6 +68,9 @@ files:
 - lib/cloudflare_workers/scheduled.rb
 - lib/cloudflare_workers/stream.rb
 - lib/cloudflare_workers/version.rb
+- lib/homura_vendor_tempfile.rb
+- lib/homura_vendor_tilt.rb
+- lib/homura_vendor_zlib.rb
 - lib/opal_patches.rb
 - runtime/patch-opal-evals.mjs
 - runtime/setup-node-crypto.mjs