homura-runtime 0.2.27 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 17f9647265dd18252adf1bcfc4f73951db2b8c3300bf8e8fceb2e4a28d18ddd0
-  data.tar.gz: 0af103cb85483f3d2ecc3164579c0d8b784c2c0ece8cc8d584dd50735796cbb2
+  metadata.gz: 8add04211534a53fdb39d920d9b6dc143005acabe260f15d45c3b3a54b95dc9a
+  data.tar.gz: ab5115722674df8f52a7839a7b80f135f84f3e686988b85e1649d1785009ce0d
 SHA512:
-  metadata.gz: 911fee8fad91bdf26588b4f926c2edcae0d6f523dd43dfc571c8767a53acfc9b03214041e8f840d248072e16888cf3841dcb6ab67ae1d10d10b7d6f31772219d
-  data.tar.gz: 6c39b38063e532c3206ab0ebe027c234654908161d7e25934f618e26ebcd3efacd4b15a5baf2642e9f7d11cfec50d2e9ad40979c9b5ea0a89511d88547cb341e
+  metadata.gz: 3147e261629b3ba277fce2729dcf4deb47dbea060db34111d716e36d188b4dc15f6f3e0a88186c774a9d9884d70f289ac8bfb03cd57b6c6d4d517018d9ca88cf
+  data.tar.gz: d5304208f712e6b4ac7f609489558b28e1609927180ae7e5387423363f9d536cbbb31730667d7084d903fecf9c63bc9bebb4cd558bf2acbdef911807042f2a31

data/CHANGELOG.md

@@ -1,5 +1,44 @@
 # Changelog
 
+## 0.3.1 (2026-04-29)
+
+- Fix `release-gems.yml` `Resolve gem target` step: now reads
+  `gems/homura-runtime/lib/homura/runtime/version.rb` (was the
+  pre-rename `gems/homura-runtime/lib/cloudflare_workers/version.rb`,
+  which 0.3.0's tag-push publish failed on).
+- No code changes since 0.3.0; this version exists only because
+  re-tagging a published version is forbidden by the project's
+  release rules. 0.3.0 was never published to RubyGems.
+
+## 0.3.0 (2026-04-29) — BREAKING: cloudflare_workers naming eliminated
+
+The "cloudflare_workers" branding everywhere inside the gem is gone.
+gem name is `homura-runtime`, the module is now `HomuraRuntime`, the
+require path is `require 'homura/runtime'`, and the Rack handler is
+`Rack::Handler::Homura`. Apps that pinned ≤ 0.2.x and referenced
+either `CloudflareWorkers::*` or `require 'cloudflare_workers'`
+must update.
+
+Renames:
+
+| was | now |
+|---|---|
+| `module CloudflareWorkers` | `module HomuraRuntime` |
+| `CloudflareWorkersIO` (stdout/stderr replacement class) | `HomuraRuntimeIO` |
+| `Rack::Handler::CloudflareWorkers` | `Rack::Handler::Homura` |
+| `require 'cloudflare_workers'` | `require 'homura/runtime'` |
+| `lib/cloudflare_workers.rb` | `lib/homura/runtime.rb` |
+| `lib/cloudflare_workers/*.rb` | `lib/homura/runtime/*.rb` |
+
+`Cloudflare` namespace (binding wrappers like `Cloudflare::HTTP`,
+`Cloudflare::D1Error`, `Cloudflare.js_promise?`) and Cloudflare-
+specific Rack env keys (`env['cloudflare.DB']`, `env['cloudflare.KV']`,
+…) are unchanged — those are factual descriptions of the underlying
+Cloudflare Workers bindings, not branding.
+
+No backward-compat shim. Per the project's `v1未満は破壊的に置き換え`
+rule, old constant aliases are not preserved.
+
 ## 0.2.27 (2026-04-29)
 
 - `Rack::Handler::CloudflareWorkers.run` now goes through

data/exe/auto-await

@@ -15,18 +15,18 @@
 
 require 'fileutils'
 require 'pathname'
-require_relative '../lib/cloudflare_workers/build_support'
+require_relative '../lib/homura/runtime/build_support'
 
 # homura-runtime lib path resolution (with legacy alias fallback)
 runtime_lib = ENV['CFW_RUNTIME_LIB']
 unless runtime_lib
-  runtime_lib = CloudflareWorkers::BuildSupport.runtime_root(current_file: __FILE__).join('lib').to_s
+  runtime_lib = HomuraRuntime::BuildSupport.runtime_root(current_file: __FILE__).join('lib').to_s
 end
 $LOAD_PATH.unshift(runtime_lib) unless $LOAD_PATH.include?(runtime_lib)
 
-require 'cloudflare_workers/async_registry'
-require 'cloudflare_workers/auto_await/analyzer'
-require 'cloudflare_workers/auto_await/transformer'
+require 'homura/runtime/async_registry'
+require 'homura/runtime/auto_await/analyzer'
+require 'homura/runtime/auto_await/transformer'
 
 options = { input: nil, output: nil, debug: ENV['CLOUDFLARE_WORKERS_AUTO_AWAIT_DEBUG'] == '1' }
 
@@ -43,10 +43,10 @@ abort('Usage: auto-await --input DIR --output DIR [--debug]') unless options[:in
 input_root  = Pathname(options[:input]).expand_path
 output_root = Pathname(options[:output]).expand_path
 
-registry = CloudflareWorkers::AsyncRegistry.instance
+registry = HomuraRuntime::AsyncRegistry.instance
 
 # Auto-load async source registrations from all loaded gems.
-CloudflareWorkers::AsyncRegistry.auto_load_gem_async_sources(debug: options[:debug])
+HomuraRuntime::AsyncRegistry.auto_load_gem_async_sources(debug: options[:debug])
 
 # Load project-specific async source registrations if present.
 project_async = File.join(Dir.pwd, 'lib', 'homura_async_sources.rb')
@@ -75,7 +75,7 @@ paths.each do |path|
   has_existing_await = source.include?('.__await__')
 
   begin
-    analyzer = CloudflareWorkers::AutoAwait::Analyzer.new(registry, debug: options[:debug])
+    analyzer = HomuraRuntime::AutoAwait::Analyzer.new(registry, debug: options[:debug])
     buffer, nodes = analyzer.process(source, path)
     needs_magic_only_output = has_existing_await && !has_magic
 
@@ -89,7 +89,7 @@ paths.each do |path|
       if nodes.empty?
         source
       else
-        CloudflareWorkers::AutoAwait::Transformer.transform(source, nodes, buffer)
+        HomuraRuntime::AutoAwait::Transformer.transform(source, nodes, buffer)
       end
     unless has_magic
       transformed = "# await: true\n" + transformed

data/exe/homura-build

@@ -8,12 +8,12 @@ require 'fileutils'
 require 'open3'
 require 'optparse'
 require 'pathname'
-require_relative '../lib/cloudflare_workers/build_support'
+require_relative '../lib/homura/runtime/build_support'
 
-module CloudflareWorkersBuild
+module HomuraRuntimeBuild
   class << self
     def gem_root
-      CloudflareWorkers::BuildSupport.runtime_root(current_file: __FILE__)
+      HomuraRuntime::BuildSupport.runtime_root(current_file: __FILE__)
     end
 
     def runtime_dir
@@ -25,11 +25,11 @@ module CloudflareWorkersBuild
     end
 
     def gem_lib(*names)
-      CloudflareWorkers::BuildSupport.gem_lib(*names)
+      HomuraRuntime::BuildSupport.gem_lib(*names)
     end
 
     def gem_vendor(*names)
-      CloudflareWorkers::BuildSupport.gem_vendor(*names)
+      HomuraRuntime::BuildSupport.gem_vendor(*names)
     end
   end
 end
@@ -72,8 +72,8 @@ 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]
+options[:templates_namespace] ||= HomuraRuntime::BuildSupport.standalone_namespace(root, 'Templates') if options[:standalone]
+options[:assets_namespace] ||= HomuraRuntime::BuildSupport.standalone_namespace(root, 'Assets') if options[:standalone]
 
 if options[:standalone]
   Dir.chdir(root) { require 'bundler/setup' }
@@ -109,7 +109,7 @@ def run_opal_homura!(root, opal_input, opal_output)
     '-I', 'gems/sinatra-homura/lib',
     '-I', 'gems/sequel-d1/lib',
     '-I', 'lib', '-I', 'vendor', '-I', 'build',
-    '-r', 'opal_patches', '-r', 'cloudflare_workers',
+    '-r', 'opal_patches', '-r', 'homura/runtime',
     '-r', 'homura_templates', '-r', 'homura_assets',
     '-o', opal_output,
     opal_input
@@ -123,15 +123,15 @@ def run_opal_homura!(root, opal_input, opal_output)
 end
 
 def homura_vendor_from_gemfile(project_root)
-  CloudflareWorkers::BuildSupport.vendor_from_gemfile(project_root)
+  HomuraRuntime::BuildSupport.vendor_from_gemfile(project_root)
 end
 
 def run_opal_standalone!(root, opal_input, opal_output, with_db:)
-  load_paths = CloudflareWorkers::BuildSupport.standalone_load_paths(root, with_db: with_db)
+  load_paths = HomuraRuntime::BuildSupport.standalone_load_paths(root, with_db: with_db)
 
   argv = ['bundle', 'exec', 'opal', '-c', '-E', '--esm', '--no-source-map']
   load_paths.each { |p| argv.push('-I', p) }
-  argv += %w[-r opal_patches -r cloudflare_workers -r app_templates -r app_assets -o] + [opal_output, opal_input]
+  argv += %w[-r opal_patches -r homura/runtime -r app_templates -r app_assets -o] + [opal_output, opal_input]
 
   stderr_log = root.join('build/opal.stderr.log')
   FileUtils.mkdir_p(root.join('build'))
@@ -185,7 +185,7 @@ unless options[:standalone]
   run!(['ruby', 'bin/inline-routes-for-opal'], chdir: root)
   run!(
     [
-      'ruby', CloudflareWorkersBuild.exe_path('auto-await').to_s,
+      'ruby', HomuraRuntimeBuild.exe_path('auto-await').to_s,
       '--input', 'app',
       '--output', 'build/auto_await/app'
     ],
@@ -193,7 +193,7 @@ unless options[:standalone]
   )
   run!(
     [
-      'ruby', CloudflareWorkersBuild.exe_path('auto-await').to_s,
+      'ruby', HomuraRuntimeBuild.exe_path('auto-await').to_s,
       '--input', 'build/routes_app_class_eval.rb',
       '--output', 'build/auto_await/routes_app_class_eval.rb'
     ],
@@ -201,7 +201,7 @@ unless options[:standalone]
   )
   run!(
     [
-      'ruby', CloudflareWorkersBuild.exe_path('compile-erb').to_s,
+      'ruby', HomuraRuntimeBuild.exe_path('compile-erb').to_s,
       '--input', 'views',
       '--output', 'build/homura_templates.rb',
       '--namespace', 'HomuraTemplates'
@@ -210,7 +210,7 @@ unless options[:standalone]
   )
   run!(
     [
-      'ruby', CloudflareWorkersBuild.exe_path('compile-assets').to_s,
+      'ruby', HomuraRuntimeBuild.exe_path('compile-assets').to_s,
       '--input', 'public',
       '--output', 'build/homura_assets.rb',
       '--namespace', 'HomuraAssets'
@@ -229,10 +229,10 @@ unless options[:standalone]
     FileUtils.rm_f(temp_input) if temp_input
   end
 else
-  CloudflareWorkers::BuildSupport.ensure_standalone_runtime(root, current_file: __FILE__)
+  HomuraRuntime::BuildSupport.ensure_standalone_runtime(root, current_file: __FILE__)
   run!(
     [
-      'ruby', CloudflareWorkersBuild.exe_path('compile-erb').to_s,
+      'ruby', HomuraRuntimeBuild.exe_path('compile-erb').to_s,
       '--input', 'views',
       '--output', 'build/app_templates.rb',
       '--namespace', options[:templates_namespace]
@@ -241,7 +241,7 @@ else
   )
   run!(
     [
-      'ruby', CloudflareWorkersBuild.exe_path('compile-assets').to_s,
+      'ruby', HomuraRuntimeBuild.exe_path('compile-assets').to_s,
       '--input', 'public',
       '--output', 'build/app_assets.rb',
       '--namespace', options[:assets_namespace]
@@ -256,7 +256,7 @@ else
   if root.join('app').directory?
     run!(
       [
-        'ruby', CloudflareWorkersBuild.exe_path('auto-await').to_s,
+        'ruby', HomuraRuntimeBuild.exe_path('auto-await').to_s,
         '--input', 'app',
         '--output', 'build/auto_await/app'
       ],
@@ -265,7 +265,7 @@ else
   elsif root.join('app.rb').file?
     run!(
       [
-        'ruby', CloudflareWorkersBuild.exe_path('auto-await').to_s,
+        'ruby', HomuraRuntimeBuild.exe_path('auto-await').to_s,
         '--input', 'app.rb',
         '--output', 'build/auto_await/app.rb'
       ],
@@ -282,7 +282,7 @@ else
   # `build/auto_await/gem_<basename>/<sub>` and
   # `standalone_load_paths` puts those rewritten copies ahead of the
   # gem's untransformed `lib/`.
-  CloudflareWorkers::BuildSupport.opal_gem_paths(root).each do |gem_path|
+  HomuraRuntime::BuildSupport.opal_gem_paths(root).each do |gem_path|
     %w[lib].each do |sub|
       src = gem_path.join(sub)
       next unless src.directory?
@@ -290,7 +290,7 @@ else
       FileUtils.mkdir_p(out)
       run!(
         [
-          'ruby', CloudflareWorkersBuild.exe_path('auto-await').to_s,
+          'ruby', HomuraRuntimeBuild.exe_path('auto-await').to_s,
           '--input', src.to_s,
           '--output', out.to_s
         ],
@@ -317,7 +317,7 @@ patch_rel = root.join(patch_rel) unless patch_rel.absolute?
 run!(
   [
     'node',
-    CloudflareWorkersBuild.runtime_dir.join('patch-opal-evals.mjs').to_s,
+    HomuraRuntimeBuild.runtime_dir.join('patch-opal-evals.mjs').to_s,
     patch_rel.relative_path_from(root).to_s
   ],
   chdir: root

data/lib/{cloudflare_workers → homura/runtime}/ai.rb

@@ -21,7 +21,7 @@
 #
 # Streaming (`stream: true`) returns the raw JS ReadableStream wrapped
 # in `Cloudflare::AI::Stream` so a route can hand it to a Server-Sent
-# Events response. See `lib/cloudflare_workers.rb#build_js_response`
+# Events response. See `lib/homura/runtime.rb#build_js_response`
 # for the SSE / ReadableStream pass-through.
 
 require 'json'
@@ -71,7 +71,7 @@ module Cloudflare
       # keeps the returned value alive through the local). Do NOT
       # refactor this so the backtick is the method's last expression
       # or the Promise will be silently dropped (same pitfall
-      # documented in lib/cloudflare_workers/{cache,queue}.rb —
+      # documented in lib/homura/runtime/{cache,queue}.rb —
       # Phase 11B audit).
       js_promise = `
         (async function() {

data/lib/{cloudflare_workers → homura/runtime}/async_registry.rb

@@ -2,7 +2,7 @@
 
 require 'set'
 
-module CloudflareWorkers
+module HomuraRuntime
   class AsyncRegistry
     class Builder
       def initialize(registry)
@@ -137,7 +137,7 @@ end
 # Phase 17.5 — Auto-Await: register runtime gem async sources.
 # Each binding declares which methods return Promises so the
 # build-time analyzer can insert .__await__ automatically.
-CloudflareWorkers::AsyncRegistry.register_async_source do
+HomuraRuntime::AsyncRegistry.register_async_source do
   async_method 'Cloudflare::D1Database', :execute
   async_method 'Cloudflare::D1Database', :get_first_row
   async_method 'Cloudflare::D1Database', :execute_insert

data/lib/{cloudflare_workers → homura/runtime}/auto_await/analyzer.rb

@@ -4,7 +4,7 @@ require 'parser/current'
 require 'parser/source/tree_rewriter'
 require 'set'
 
-module CloudflareWorkers
+module HomuraRuntime
   module AutoAwait
     class Analyzer
       def initialize(registry, debug: false)

data/lib/{cloudflare_workers → homura/runtime}/auto_await/transformer.rb

@@ -2,7 +2,7 @@
 
 require 'parser/source/tree_rewriter'
 
-module CloudflareWorkers
+module HomuraRuntime
   module AutoAwait
     class Transformer
       def self.transform(source, await_nodes, buffer)

data/lib/{cloudflare_workers → homura/runtime}/build_support.rb

@@ -3,7 +3,7 @@
 require 'fileutils'
 require 'pathname'
 
-module CloudflareWorkers
+module HomuraRuntime
   module BuildSupport
     RUNTIME_GEM_NAME = 'homura-runtime'
     SINATRA_GEM_NAME = 'sinatra-homura'

data/lib/{cloudflare_workers → homura/runtime}/cache.rb

@@ -165,7 +165,7 @@ module Cloudflare
       # gets dropped and the caller's `__await__` receives `undefined`
       # instead of waiting for `cache.put` to resolve. That was the
       # silent bug: the inner `await` ran, but the outer await had
-      # already proceeded. See lib/cloudflare_workers/scheduled.rb for
+      # already proceeded. See lib/homura/runtime/scheduled.rb for
       # the same Opal multi-line x-string constraint.
       # Warn ONCE per isolate on a nil cache. Non-Workers runtimes
       # hit `Cache.new(nil, ...)` intentionally (tests, safe fall-back

data/lib/{cloudflare_workers → homura/runtime}/durable_object.rb

@@ -11,7 +11,7 @@
 # session servers, and collaborative state machines without any external
 # store.
 #
-# Three responsibilities here, analogous to `cloudflare_workers.rb`'s
+# Three responsibilities here, analogous to `homura/runtime.rb`'s
 # D1 / KV / R2 section:
 #
 #   1. `Cloudflare::DurableObjectNamespace`  — wraps the binding JS object
@@ -163,7 +163,7 @@ module Cloudflare
       response_klass = Cloudflare::HTTPResponse
       do_class_label = 'DurableObjectStub'
 
-      # Single-line IIFE — see `lib/cloudflare_workers/cache.rb#put`
+      # Single-line IIFE — see `lib/homura/runtime/cache.rb#put`
       # for why Opal can silently drop a multi-line x-string Promise.
       js_promise = `(async function(stub, url_str, method_str, js_headers, js_body, Kernel, err_klass, do_class_label) { var init = { method: method_str, headers: js_headers }; if (js_body !== null && js_body !== undefined && js_body !== Opal.nil) { init.body = js_body; } var resp; try { resp = await stub.fetch(url_str, init); } catch (e) { Kernel.$raise(err_klass.$new(e && e.message ? e.message : String(e), Opal.hash({ operation: 'stub.fetch', do_class: do_class_label }))); } var text = ''; try { text = await resp.text(); } catch (_) { text = ''; } var hk = []; var hv = []; if (resp.headers && typeof resp.headers.forEach === 'function') { resp.headers.forEach(function(v, k) { hk.push(String(k).toLowerCase()); hv.push(String(v)); }); } return { status: resp.status|0, text: text, hkeys: hk, hvals: hv }; })(#{js_stub}, #{url_str}, #{method_str}, #{js_headers}, #{js_body}, #{Kernel}, #{err_klass}, #{do_class_label})`
 
@@ -357,7 +357,7 @@ module Cloudflare
     #
     # Kept as a single-line backtick x-string — Opal's compiler refuses
     # multi-line backticks as expressions (same constraint documented
-    # in `lib/cloudflare_workers/scheduled.rb#install_dispatcher`).
+    # in `lib/homura/runtime/scheduled.rb#install_dispatcher`).
     # Installs FOUR hooks: fetch dispatcher + 3 websocket event
     # dispatchers. Each wraps Ruby exceptions in a console.error so a
     # bad handler doesn't crash the DO.
@@ -516,7 +516,7 @@ module Cloudflare
 
   # The incoming `request` argument passed to DO handlers. `body_text`
   # is pre-awaited by the JS dispatcher because Ruby runs synchronously
-  # under Opal (same pattern as `Rack::Handler::CloudflareWorkers.call`).
+  # under Opal (same pattern as `Rack::Handler::Homura.call`).
   class DurableObjectRequest
     attr_reader :js_request, :body
 

data/lib/{cloudflare_workers → homura/runtime}/http.rb

@@ -85,7 +85,7 @@ module Cloudflare
       # at end-of-method silently drops the Promise. Do NOT refactor
       # this into `def fetch ... end` with the backtick as the last
       # expression. See the single-line IIFE pattern used in
-      # lib/cloudflare_workers/{cache,queue,durable_object}.rb#put for
+      # lib/homura/runtime/{cache,queue,durable_object}.rb#put for
       # the alternative that survives either position. (Phase 11B audit.)
       js_promise = `
         (async function() {

data/lib/{cloudflare_workers → homura/runtime}/multipart.rb

@@ -83,7 +83,7 @@ module Cloudflare
     # NOTE: single-line backtick x-string so Opal emits it as an
     # expression (multi-line x-strings compile to raw statements and
     # would silently return `undefined`). Same gotcha documented
-    # elsewhere in this codebase (see lib/cloudflare_workers.rb).
+    # elsewhere in this codebase (see lib/homura/runtime.rb).
     def to_uint8_array
       `(function(s) { var len = s.length; var out = new Uint8Array(len); for (var i = 0; i < len; i++) { out[i] = s.charCodeAt(i) & 0xff; } return out; })(#{@bytes_binstr})`
     end

data/lib/{cloudflare_workers → homura/runtime}/queue.rb

@@ -63,7 +63,7 @@ module Cloudflare
     def available?
       js = @js
       # Opal's Ruby nil is a runtime sentinel (Opal.nil), not JS null.
-      # See `lib/cloudflare_workers/cache.rb#available?` for the same
+      # See `lib/homura/runtime/cache.rb#available?` for the same
       # pattern and rationale.
       !!`(#{js} !== null && #{js} !== undefined && #{js} !== Opal.nil)`
     end
@@ -86,7 +86,7 @@ module Cloudflare
       `#{js_opts}.delaySeconds = #{delay_seconds.to_i}` if delay_seconds
       `#{js_opts}.contentType  = #{content_type.to_s}`  if content_type
 
-      # Single-line IIFE — see `lib/cloudflare_workers/cache.rb#put`
+      # Single-line IIFE — see `lib/homura/runtime/cache.rb#put`
       # for the Opal multi-line x-string quirk. Passing arguments in
       # explicitly (rather than interpolating inside the template)
       # keeps the Promise a first-class expression.

data/lib/{cloudflare_workers → homura/runtime}/scheduled.rb

@@ -23,7 +23,7 @@
 #
 #   3. Exposes `Cloudflare::Scheduled.app=` so non-Sinatra Rack apps
 #      can hook the dispatcher too. By default, `Rack::Handler::
-#      CloudflareWorkers.app` (set by `run app` in user code) is used.
+#      HomuraRuntime.app` (set by `run app` in user code) is used.
 #
 # Test entry point: `Cloudflare::Scheduled.dispatch(cron, scheduled_time, js_env, js_ctx)`
 # — used by `test/scheduled_smoke.rb` so the same code path that the
@@ -91,7 +91,7 @@ module Cloudflare
 
     class << self
       # Override the dispatch target. By default the dispatcher uses
-      # `Rack::Handler::CloudflareWorkers.app`, which is whatever the
+      # `Rack::Handler::Homura.app`, which is whatever the
       # user passed to top-level `run app`. Tests use this to plug
       # a fake Sinatra subclass without booting the full handler.
       attr_accessor :app
@@ -154,13 +154,13 @@ module Cloudflare
 
     # Resolve which app class should receive the dispatch. Priority:
     #   1. `Cloudflare::Scheduled.app = SomeApp`     (explicit override)
-    #   2. `Rack::Handler::CloudflareWorkers.app`    (set by `run app`)
+    #   2. `Rack::Handler::Homura.app`    (set by `run app`)
     # Returns the class itself (not an instance), because
     # `dispatch_scheduled` is a class method on Sinatra apps.
     def self.resolve_app
       candidate = @app
-      if candidate.nil? && defined?(::Rack::Handler::CloudflareWorkers)
-        candidate = ::Rack::Handler::CloudflareWorkers.app
+      if candidate.nil? && defined?(::Rack::Handler::Homura)
+        candidate = ::Rack::Handler::Homura.app
       end
       return nil if candidate.nil?
       # Sinatra app classes respond to `dispatch_scheduled` (added by

data/lib/{cloudflare_workers → homura/runtime}/stream.rb

@@ -48,7 +48,7 @@ module Cloudflare
       @js_stream = nil
     end
 
-    # Duck-typed marker consumed by Rack::Handler::CloudflareWorkers.
+    # Duck-typed marker consumed by Rack::Handler::Homura.
     def sse_stream?
       true
     end

data/lib/homura/runtime/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module HomuraRuntime
+  VERSION = '0.3.1'
+end

data/lib/{cloudflare_workers.rb → homura/runtime.rb}

@@ -10,11 +10,11 @@
 #
 # Three responsibilities, modelled after existing Ruby conventions:
 #
-#   1. CloudflareWorkersIO — replaces nodejs.rb's $stdout / $stderr (which
+#   1. HomuraRuntimeIO — replaces nodejs.rb's $stdout / $stderr (which
 #      try to write to a closed Socket on Workers) with shims that route
 #      Ruby `puts` / `print` to V8's globalThis.console.log/error.
 #
-#   2. Rack::Handler::CloudflareWorkers — a standard Rack handler. Same
+#   2. Rack::Handler::Homura — a standard Rack handler. Same
 #      shape as Rack::Handler::Puma, Rack::Handler::WEBrick, etc. User
 #      code uses the conventional top-level `run app` from a config.ru-
 #      style entry point and never sees a Cloudflare-specific symbol.
@@ -35,7 +35,7 @@ require 'await'
 # 1. stdout / stderr → console.log / console.error
 # ---------------------------------------------------------------------------
 
-class CloudflareWorkersIO
+class HomuraRuntimeIO
   def initialize(channel)
     @channel = channel  # 'log' or 'error'
     @buffer = ''
@@ -105,13 +105,13 @@ class CloudflareWorkersIO
   end
 end
 
-$stdout = CloudflareWorkersIO.new('log')
-$stderr = CloudflareWorkersIO.new('error')
-Object.const_set(:STDOUT, $stdout) unless Object.const_defined?(:STDOUT) && STDOUT.is_a?(CloudflareWorkersIO)
-Object.const_set(:STDERR, $stderr) unless Object.const_defined?(:STDERR) && STDERR.is_a?(CloudflareWorkersIO)
+$stdout = HomuraRuntimeIO.new('log')
+$stderr = HomuraRuntimeIO.new('error')
+Object.const_set(:STDOUT, $stdout) unless Object.const_defined?(:STDOUT) && STDOUT.is_a?(HomuraRuntimeIO)
+Object.const_set(:STDERR, $stderr) unless Object.const_defined?(:STDERR) && STDERR.is_a?(HomuraRuntimeIO)
 
 # ---------------------------------------------------------------------------
-# 2. Rack::Handler::CloudflareWorkers
+# 2. Rack::Handler::Homura
 # ---------------------------------------------------------------------------
 #
 # Conforms to the Rack handler convention: a module with a `run` class
@@ -121,7 +121,7 @@ Object.const_set(:STDERR, $stderr) unless Object.const_defined?(:STDERR) && STDE
 
 module Rack
   module Handler
-    module CloudflareWorkers
+    module Homura
       EMPTY_STRING_IO = StringIO.new('').freeze
 
       def self.run(app, **_options)
@@ -142,7 +142,7 @@ module Rack
       # before `run` was called (e.g. classic-style apps that omit the
       # trailing `run Sinatra::Application`) still gets routed into our
       # `call` method, which can then discover the user's Sinatra app
-      # lazily via `Sinatra::CloudflareWorkers.ensure_rack_app!`. This
+      # lazily via `Sinatra::Homura.ensure_rack_app!`. This
       # is what makes the canonical sinatrarb.com snippet work
       # verbatim on Workers — `at_exit` is unreliable here because the
       # isolate never actually exits between fetches.
@@ -170,9 +170,9 @@ module Rack
       # handing control to Ruby because Opal runs synchronously).
       def self.call(js_req, js_env, js_ctx, body_text = '')
         if @app.nil?
-          if defined?(::Sinatra::CloudflareWorkers) &&
-             ::Sinatra::CloudflareWorkers.respond_to?(:ensure_rack_app!)
-            ::Sinatra::CloudflareWorkers.ensure_rack_app!
+          if defined?(::Sinatra::Homura) &&
+             ::Sinatra::Homura.respond_to?(:ensure_rack_app!)
+            ::Sinatra::Homura.ensure_rack_app!
           end
           raise '`run app` was never called from user code, and no Sinatra app was discoverable (define `class App < Sinatra::Base` or use top-level classic Sinatra routes)' if @app.nil?
         end
@@ -191,7 +191,7 @@ module Rack
         private
 
         # Legacy alias, kept so out-of-tree code calling
-        # `Rack::Handler::CloudflareWorkers.send(:install_dispatcher)`
+        # `Rack::Handler::Homura.send(:install_dispatcher)`
         # keeps working. New code should go through
         # `ensure_dispatcher_installed!` (it's idempotent and tracks
         # state via `@dispatcher_installed`).
@@ -504,7 +504,7 @@ module Kernel
   private
 
   def run(app, **options)
-    Rack::Handler::CloudflareWorkers.run(app, **options)
+    Rack::Handler::Homura.run(app, **options)
   end
 end
 
@@ -950,7 +950,7 @@ end
 # Phase 6 — HTTP client foundation. Loaded as part of the Cloudflare
 # Workers adapter so user code can simply `require 'sinatra/base'`
 # and use Net::HTTP / Cloudflare::HTTP.fetch without an extra require.
-require 'cloudflare_workers/http'
+require 'homura/runtime/http'
 
 # Phase 9 — Scheduled (Cron Triggers) dispatcher. Installs the JS
 # `globalThis.__HOMURA_SCHEDULED_DISPATCH__` hook that
@@ -958,11 +958,11 @@ require 'cloudflare_workers/http'
 # Must be loaded after the Cloudflare::* binding wrappers above
 # because it constructs D1Database/KVNamespace/R2Bucket instances
 # inside the dispatcher's per-job env.
-require 'cloudflare_workers/scheduled'
+require 'homura/runtime/scheduled'
 
 # Phase 10 — Workers AI binding wrapper. Loaded here so any Sinatra
 # route can call Cloudflare::AI.run(...) without an extra require.
-require 'cloudflare_workers/ai'
+require 'homura/runtime/ai'
 
 # Phase 11A — HTTP foundations.
 #
@@ -971,17 +971,17 @@ require 'cloudflare_workers/ai'
 # `stream`    adds `Cloudflare::SSEStream` + `Sinatra::Streaming#sse`
 #             so a route can `sse do |out| ... end` and flush chunks
 #             through a Workers ReadableStream.
-require 'cloudflare_workers/multipart'
-require 'cloudflare_workers/stream'
+require 'homura/runtime/multipart'
+require 'homura/runtime/stream'
 
 # Phase 11B — Cloudflare native bindings (Durable Objects / Cache /
 # Queues). Each file registers its own globalThis dispatcher hook
 # where applicable (DO / Queue consumer). Loaded here so user code
 # just needs `require 'sinatra/base'` — no extra `require` per
 # binding.
-require 'cloudflare_workers/cache'
-require 'cloudflare_workers/queue'
-require 'cloudflare_workers/email'
-require 'cloudflare_workers/durable_object'
+require 'homura/runtime/cache'
+require 'homura/runtime/queue'
+require 'homura/runtime/email'
+require 'homura/runtime/durable_object'
 
-require 'cloudflare_workers/async_registry'
+require 'homura/runtime/async_registry'

data/runtime/worker_module.mjs

@@ -156,7 +156,7 @@ export default {
     const dispatch = rackDispatch();
     if (typeof dispatch !== "function") {
       return new Response(
-        "homura: Rack dispatcher not installed (Rack::Handler::CloudflareWorkers.run never called)\n",
+        "homura: Rack dispatcher not installed (Rack::Handler::Homura.run never called)\n",
         { status: 500, headers: { "content-type": "text/plain; charset=utf-8" } },
       );
     }
@@ -180,7 +180,7 @@ export default {
   // The Workers runtime invokes this `scheduled` export once per
   // matching `[triggers] crons` entry in wrangler.toml. We forward
   // the (event, env, ctx) triple to the Ruby-side dispatcher
-  // installed by `lib/cloudflare_workers/scheduled.rb`
+  // installed by `lib/homura/runtime/scheduled.rb`
   // (which registers `globalThis.__HOMURA_SCHEDULED_DISPATCH__`).
   //
   // The Ruby dispatcher walks every job registered via the
@@ -199,12 +199,12 @@ export default {
     const dispatch = scheduledDispatch();
     if (typeof dispatch !== "function") {
       // No Ruby dispatcher installed — the Opal bundle didn't
-      // require 'cloudflare_workers/scheduled'. Log loudly so this
+      // require 'homura/runtime/scheduled'. Log loudly so this
       // misconfiguration surfaces instead of silently dropping
       // every cron firing.
       try {
         globalThis.console.error(
-          "homura: scheduled dispatcher not installed (require 'cloudflare_workers/scheduled' missing)",
+          "homura: scheduled dispatcher not installed (require 'homura/runtime/scheduled' missing)",
         );
       } catch (e) {
         // ignore — console may itself be broken in pathological cases
@@ -246,7 +246,7 @@ export default {
     if (typeof dispatch !== "function") {
       try {
         globalThis.console.error(
-          "homura: queue dispatcher not installed (require 'cloudflare_workers/queue' missing)",
+          "homura: queue dispatcher not installed (require 'homura/runtime/queue' missing)",
         );
       } catch (e) {}
       return;
@@ -272,7 +272,7 @@ export default {
 // must be a named export on this module. We export ONE generic class
 // (`HomuraCounterDO`) that forwards every `fetch(req)` it receives
 // to the Ruby-side dispatcher installed by
-// `lib/cloudflare_workers/durable_object.rb`
+// `lib/homura/runtime/durable_object.rb`
 // (`globalThis.__HOMURA_DO_DISPATCH__`).
 //
 // The Ruby handler is registered via:
@@ -361,7 +361,7 @@ export class HomuraCounterDO {
   }
 
   // Hibernation API callbacks — routed into Ruby via the hooks
-  // installed by `lib/cloudflare_workers/durable_object.rb`. Each
+  // installed by `lib/homura/runtime/durable_object.rb`. Each
   // hook is optional on the Ruby side; missing hooks are a no-op.
   async webSocketMessage(ws, message) {
     const fn = durableObjectWsMessage();

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: homura-runtime
 version: !ruby/object:Gem::Version
-  version: 0.2.27
+  version: 0.3.1
 platform: ruby
 authors:
 - Kazuhiro Homma
@@ -53,21 +53,21 @@ files:
 - exe/compile-assets
 - exe/compile-erb
 - exe/homura-build
-- lib/cloudflare_workers.rb
-- lib/cloudflare_workers/ai.rb
-- lib/cloudflare_workers/async_registry.rb
-- lib/cloudflare_workers/auto_await/analyzer.rb
-- lib/cloudflare_workers/auto_await/transformer.rb
-- lib/cloudflare_workers/build_support.rb
-- lib/cloudflare_workers/cache.rb
-- lib/cloudflare_workers/durable_object.rb
-- lib/cloudflare_workers/email.rb
-- lib/cloudflare_workers/http.rb
-- lib/cloudflare_workers/multipart.rb
-- lib/cloudflare_workers/queue.rb
-- lib/cloudflare_workers/scheduled.rb
-- lib/cloudflare_workers/stream.rb
-- lib/cloudflare_workers/version.rb
+- lib/homura/runtime.rb
+- lib/homura/runtime/ai.rb
+- lib/homura/runtime/async_registry.rb
+- lib/homura/runtime/auto_await/analyzer.rb
+- lib/homura/runtime/auto_await/transformer.rb
+- lib/homura/runtime/build_support.rb
+- lib/homura/runtime/cache.rb
+- lib/homura/runtime/durable_object.rb
+- lib/homura/runtime/email.rb
+- lib/homura/runtime/http.rb
+- lib/homura/runtime/multipart.rb
+- lib/homura/runtime/queue.rb
+- lib/homura/runtime/scheduled.rb
+- lib/homura/runtime/stream.rb
+- lib/homura/runtime/version.rb
 - lib/homura_vendor_tempfile.rb
 - lib/homura_vendor_tilt.rb
 - lib/homura_vendor_zlib.rb

data/lib/cloudflare_workers/version.rb

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