Module: Ruact::ServerFunctions

Defined in:
lib/ruact/server_functions.rb,
lib/ruact/server_functions/codegen.rb,
lib/ruact/server_functions/registry.rb,
lib/ruact/server_functions/snapshot.rb,
lib/ruact/server_functions/codegen_v2.rb,
lib/ruact/server_functions/name_bridge.rb,
lib/ruact/server_functions/route_source.rb,
lib/ruact/server_functions/error_payload.rb,
lib/ruact/server_functions/query_context.rb,
lib/ruact/server_functions/query_dispatch.rb,
lib/ruact/server_functions/registry_entry.rb,
lib/ruact/server_functions/error_rendering.rb,
lib/ruact/server_functions/snapshot_writer.rb,
lib/ruact/server_functions/error_suggestion.rb,
lib/ruact/server_functions/backtrace_cleaner.rb,
lib/ruact/server_functions/bucket_two_payload.rb,
lib/ruact/server_functions/standalone_context.rb,
lib/ruact/server_functions/endpoint_controller.rb,
lib/ruact/server_functions/standalone_dispatcher.rb

Defined Under Namespace

Modules: BacktraceCleaner, BucketTwoPayload, Codegen, ErrorPayload, ErrorRendering, ErrorSuggestion, NameBridge, QueryDispatch, RouteSource, Snapshot, SnapshotWriter Classes: EndpointController, QueryContext, Registry, RegistryEntry, StandaloneContext, StandaloneDispatcher

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Attribute Details

#block ⇒ Proc? (readonly)

Returns the implementation block supplied by the controller macro. Story 8.0a stores it untouched; Stories 8.1 / 9.1 invoke it.

Returns:

  • (Proc, nil) —

    the implementation block supplied by the controller macro. Story 8.0a stores it untouched; Stories 8.1 / 9.1 invoke it.



24
 
# File 'lib/ruact/server_functions/registry_entry.rb', line 24

RegistryEntry = Data.define(:ruby_symbol, :js_identifier, :kind, :controller, :block)

#controller ⇒ Class? (readonly)

Returns the controller class that registered the function; used for collision-error messages and downstream tooling. Nil is allowed for tests / Rails-console registrations.

Returns:

  • (Class, nil) —

    the controller class that registered the function; used for collision-error messages and downstream tooling. Nil is allowed for tests / Rails-console registrations.



24
 
# File 'lib/ruact/server_functions/registry_entry.rb', line 24

RegistryEntry = Data.define(:ruby_symbol, :js_identifier, :kind, :controller, :block)

#js_identifier ⇒ String (readonly)

Returns result of Ruact::ServerFunctions::NameBridge.to_js_identifier — cached at registration time so the snapshot writer never re-derives it.

Returns:



24
 
# File 'lib/ruact/server_functions/registry_entry.rb', line 24

RegistryEntry = Data.define(:ruby_symbol, :js_identifier, :kind, :controller, :block)

#kind ⇒ Symbol (readonly)

Returns ‘:action` or `:query`. Informational at codegen time (Story 8.0 decision 2A-i: both kinds POST through the same accessor).

Returns:

  • (Symbol) —

    ‘:action` or `:query`. Informational at codegen time (Story 8.0 decision 2A-i: both kinds POST through the same accessor).



24
 
# File 'lib/ruact/server_functions/registry_entry.rb', line 24

RegistryEntry = Data.define(:ruby_symbol, :js_identifier, :kind, :controller, :block)

#ruby_symbol ⇒ Symbol (readonly)

Returns the symbol the controller registered (e.g. ‘:create_post`).

Returns:

  • (Symbol) —

    the symbol the controller registered (e.g. ‘:create_post`).



24
 
# File 'lib/ruact/server_functions/registry_entry.rb', line 24

RegistryEntry = Data.define(:ruby_symbol, :js_identifier, :kind, :controller, :block)

Class Method Details

.default_logger ⇒ Object 



71
72
73
 
# File 'lib/ruact/server_functions.rb', line 71

def self.default_logger
  defined?(Rails) && Rails.respond_to?(:logger) ? Rails.logger : nil
end

.write_v2_snapshot!(route_set:, root:, logger: default_logger) ⇒ Array<Hash>

Story 9.3 — orchestrates the route-driven (v2) codegen target. Reads the route table via RouteSource, writes the version-2 bridge to the PARALLEL ‘.next` path (write-if-changed), and renders the inspection TS via the Ruby Codegen (Vite does not watch `.next`). Per AC5 the `.next` target is for parity tests + inspection only — never imported by application code —so the real `server-functions.ts` (v1, rendered by Vite) is untouched (AC6). The Decision-#6 ownership flip (zero v1 declarations → v2 owns the real file) is Story 9.8’s job.

AC2 — transparency over silence: the exposed names are ALWAYS logged so a routed non-GET action never becomes a callable server function silently.

Parameters:

  • route_set (#routes) —

    the Rails route set.

  • root (Pathname) —

    the app root (for ‘tmp/cache` + `app/javascript`).

  • logger (#info, nil) (defaults to: default_logger) —

    logger for the exposure line; defaults to ‘Rails.logger` when Rails is loaded, else nil.

Returns:

  • (Array<Hash>) —

    the exposed v2 entries.



53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
 
# File 'lib/ruact/server_functions.rb', line 53

def self.write_v2_snapshot!(route_set:, root:, logger: default_logger)
  entries = RouteSource.collect(route_set)

  json_path = root.join("tmp/cache/ruact/server-functions.next.json")
  ts_path   = root.join("app/javascript/.ruact/server-functions.next.ts")

  # Read back from the on-disk bridge (not a fresh dump) so a stable route
  # table never churns the timestamp baked into the rendered TS header.
  Snapshot.generate_v2!(entries: entries, path: json_path)
  Codegen.generate_ts!(snapshot: JSON.parse(File.read(json_path)), output_path: ts_path)

  # AC2 — ALWAYS log what is exposed (even "(none)"), so a routed non-GET
  # action never becomes a callable server function silently.
  names = entries.empty? ? "(none)" : entries.map { |e| e["js_identifier"] }.join(", ")
  logger&.info "[ruact] codegen: exposing #{names}"
  entries
end