ruact 0.0.6 → 0.0.8

data/vendor/javascript/vite-plugin-ruact/index.js

@@ -171,6 +171,26 @@ export default function ruact(options = {}) {
     configureServer(server) {
       const dir = path.resolve(root, componentsDir);
       server.watcher.add(dir);
+
+      // Serve the LIVE in-memory manifest over HTTP so the Rails gem can
+      // resolve components in dev without depending on the on-disk
+      // public/react-client-manifest.json — whose first write races Rails's
+      // boot-time read (Rails can boot, and config.to_prepare read the file,
+      // BEFORE Vite writes it → Ruact.manifest nil → 500 on the first request).
+      // This endpoint always reflects the current `manifest` (rebuilt by the
+      // watcher below + buildStart), and omits the internal `_sourceFile` field
+      // so the wire shape matches the file the gem already knows how to parse.
+      server.middlewares.use("/__ruact/manifest", (req, res, next) => {
+        if (req.method !== "GET") return next();
+        const out = {};
+        for (const [name, entry] of Object.entries(manifest)) {
+          const { _sourceFile, ...rest } = entry;
+          out[name] = rest;
+        }
+        res.setHeader("Content-Type", "application/json");
+        res.end(JSON.stringify(out));
+      });
+
       const rebuild = (file) => {
         if (!file.startsWith(dir)) return;
         manifest = buildManifest(dir);

data/vendor/javascript/vite-plugin-ruact/manifest-http.test.mjs

@@ -0,0 +1,125 @@
+// Fix (manifest-over-HTTP) — the dev server exposes the live in-memory manifest
+// at GET /__ruact/manifest so the Rails gem can resolve components without
+// racing the on-disk react-client-manifest.json write at boot. This file
+// covers the configureServer middleware:
+//
+//   1. responds with the current manifest (no internal `_sourceFile` field);
+//   2. reflects a rebuild when a "use client" component is added/changed.
+
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import ruact from "./index.js";
+
+let dir;
+beforeEach(() => {
+  dir = fs.realpathSync(fs.mkdtempSync(path.join(os.tmpdir(), "ruact-manifest-http-")));
+});
+afterEach(() => {
+  fs.rmSync(dir, { recursive: true, force: true });
+});
+
+function write(rel, body) {
+  const full = path.join(dir, rel);
+  fs.mkdirSync(path.dirname(full), { recursive: true });
+  fs.writeFileSync(full, body);
+  return full;
+}
+
+const COMPONENT = (name) =>
+  `"use client";\nexport function ${name}() { return null; }\n`;
+
+// A minimal connect-style server harness: captures the path-mounted middleware
+// and the watcher callbacks the plugin registers in configureServer.
+function makeServer() {
+  const middlewares = new Map();
+  const watcherHandlers = { change: [], add: [], unlink: [] };
+  return {
+    middlewares: { use: (route, fn) => middlewares.set(route, fn) },
+    moduleGraph: { getModuleById: () => null, invalidateModule: () => {} },
+    ws: { send: () => {} },
+    watcher: {
+      add: () => {},
+      on: (event, fn) => {
+        (watcherHandlers[event] ||= []).push(fn);
+      },
+    },
+    _invokeMiddleware(route, method = "GET") {
+      const fn = middlewares.get(route);
+      let body = "";
+      let nextCalled = false;
+      const headers = {};
+      const res = {
+        setHeader: (k, v) => {
+          headers[k] = v;
+        },
+        end: (chunk) => {
+          body = chunk;
+        },
+      };
+      fn({ url: route, method }, res, () => {
+        nextCalled = true;
+      });
+      return { body, headers, nextCalled };
+    },
+    _fireChange(file) {
+      for (const fn of watcherHandlers.change) fn(file);
+    },
+  };
+}
+
+async function bootPlugin() {
+  const plugin = ruact();
+  await plugin.configResolved({ root: dir });
+  await plugin.buildStart({});
+  const server = makeServer();
+  await plugin.configureServer(server);
+  return server;
+}
+
+describe("GET /__ruact/manifest (dev server middleware)", () => {
+  it("serves the current manifest as JSON without the internal _sourceFile field", async () => {
+    write("app/javascript/components/LikeButton.jsx", COMPONENT("LikeButton"));
+    const server = await bootPlugin();
+
+    const { body, headers } = server._invokeMiddleware("/__ruact/manifest");
+    expect(headers["Content-Type"]).toBe("application/json");
+
+    const manifest = JSON.parse(body);
+    expect(manifest).toHaveProperty("LikeButton");
+    expect(manifest.LikeButton).toMatchObject({
+      id: "/LikeButton.jsx",
+      name: "LikeButton",
+      chunks: ["/LikeButton.jsx"],
+    });
+    // The internal field used only during the prod build must never go on the wire.
+    expect(manifest.LikeButton).not.toHaveProperty("_sourceFile");
+  });
+
+  it("reflects a rebuild when a new component is added", async () => {
+    write("app/javascript/components/LikeButton.jsx", COMPONENT("LikeButton"));
+    const server = await bootPlugin();
+
+    expect(JSON.parse(server._invokeMiddleware("/__ruact/manifest").body)).not.toHaveProperty(
+      "CommentBox"
+    );
+
+    const added = write("app/javascript/components/CommentBox.jsx", COMPONENT("CommentBox"));
+    server._fireChange(added);
+
+    const manifest = JSON.parse(server._invokeMiddleware("/__ruact/manifest").body);
+    expect(manifest).toHaveProperty("LikeButton");
+    expect(manifest).toHaveProperty("CommentBox");
+    expect(manifest.CommentBox).not.toHaveProperty("_sourceFile");
+  });
+
+  it("falls through (calls next) for non-GET methods", async () => {
+    write("app/javascript/components/LikeButton.jsx", COMPONENT("LikeButton"));
+    const server = await bootPlugin();
+
+    const { body, nextCalled } = server._invokeMiddleware("/__ruact/manifest", "POST");
+    expect(nextCalled).toBe(true);
+    expect(body).toBe("");
+  });
+});

data/vendor/javascript/vite-plugin-ruact/type-tests/auto-revalidate.test-d.ts

@@ -0,0 +1,25 @@
+// Story 15.6 (FR110) — type-level test for the auto-revalidate opt-in surface.
+// Proves (a) `configureRuactRuntime` accepts the new `autoRevalidate?: boolean`
+// key alongside `defaultHeaders`, and (b) `withRefresh` preserves the wrapped
+// accessor's call signature (so `withRefresh(createPost)` is callable exactly
+// like `createPost`). Runtime-only: this surface is NOT emitted by the codegen,
+// so there is no byte-parity fixture to regenerate.
+
+import { _makeServerFunction, configureRuactRuntime, withRefresh } from "ruact/server-functions-runtime";
+
+// (a) the app-wide default key type-checks (and stays optional).
+configureRuactRuntime({ autoRevalidate: true });
+configureRuactRuntime({ autoRevalidate: false, defaultHeaders: { Authorization: "Bearer x" } });
+configureRuactRuntime({ defaultHeaders: null });
+
+// A non-boolean autoRevalidate is a type error.
+// @ts-expect-error autoRevalidate must be a boolean
+configureRuactRuntime({ autoRevalidate: "yes" });
+
+// (b) withRefresh preserves the accessor call signature.
+const createPost = _makeServerFunction({ method: "POST", path: "/posts", segments: [] });
+const createPostRefreshing = withRefresh(createPost);
+
+// Callable at the same shapes as the underlying accessor.
+void createPostRefreshing({ title: "x" });
+void createPostRefreshing();

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ruact
 version: !ruby/object:Gem::Version
-  version: 0.0.6
+  version: 0.0.8
 platform: ruby
 authors:
 - Luiz Garcia
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-06-30 00:00:00.000000000 Z
+date: 2026-07-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
@@ -46,6 +46,7 @@ files:
 - docs/internal/README.md
 - docs/internal/decisions/server-functions-api.md
 - lib/generators/ruact/install/install_generator.rb
+- lib/generators/ruact/install/templates/AGENTS.md.tt
 - lib/generators/ruact/install/templates/Procfile.dev.tt
 - lib/generators/ruact/install/templates/dev.tt
 - lib/generators/ruact/install/templates/initializer.rb.tt
@@ -85,6 +86,7 @@ files:
 - lib/ruact/flight/row_emitter.rb
 - lib/ruact/flight/serializer.rb
 - lib/ruact/html_converter.rb
+- lib/ruact/manifest_resolver.rb
 - lib/ruact/query.rb
 - lib/ruact/railtie.rb
 - lib/ruact/render_context.rb
@@ -101,6 +103,7 @@ files:
 - lib/ruact/server_functions/error_payload.rb
 - lib/ruact/server_functions/error_rendering.rb
 - lib/ruact/server_functions/error_suggestion.rb
+- lib/ruact/server_functions/introspection.rb
 - lib/ruact/server_functions/name_bridge.rb
 - lib/ruact/server_functions/query_context.rb
 - lib/ruact/server_functions/query_dispatch.rb
@@ -111,6 +114,11 @@ files:
 - lib/ruact/server_functions/validation_errors.rb
 - lib/ruact/signed_references.rb
 - lib/ruact/string_distance.rb
+- lib/ruact/testing.rb
+- lib/ruact/testing/component_query.rb
+- lib/ruact/testing/flight_extractor.rb
+- lib/ruact/testing/flight_structure_diff.rb
+- lib/ruact/testing/flight_wire_parser.rb
 - lib/ruact/validation_errors_collector.rb
 - lib/ruact/version.rb
 - lib/ruact/view_helper.rb
@@ -159,6 +167,7 @@ files:
 - spec/ruact/flight/serializer_spec.rb
 - spec/ruact/html_converter_spec.rb
 - spec/ruact/install_generator_spec.rb
+- spec/ruact/manifest_resolver_spec.rb
 - spec/ruact/query_request_spec.rb
 - spec/ruact/query_spec.rb
 - spec/ruact/railtie_spec.rb
@@ -174,6 +183,7 @@ files:
 - spec/ruact/server_functions/codegen_spec.rb
 - spec/ruact/server_functions/error_payload_spec.rb
 - spec/ruact/server_functions/error_suggestion_spec.rb
+- spec/ruact/server_functions/introspection_spec.rb
 - spec/ruact/server_functions/name_bridge_spec.rb
 - spec/ruact/server_functions/query_context_spec.rb
 - spec/ruact/server_functions/query_source_spec.rb
@@ -187,6 +197,9 @@ files:
 - spec/ruact/server_upload_request_spec.rb
 - spec/ruact/signed_references_spec.rb
 - spec/ruact/string_distance_spec.rb
+- spec/ruact/tasks_json_introspection_spec.rb
+- spec/ruact/testing/have_ruact_component_spec.rb
+- spec/ruact/testing/no_production_load_spec.rb
 - spec/ruact/validation_errors_spec.rb
 - spec/ruact/view_helper_spec.rb
 - spec/spec_helper.rb
@@ -204,6 +217,7 @@ files:
 - vendor/javascript/vite-plugin-ruact/bootstrap.test.mjs
 - vendor/javascript/vite-plugin-ruact/index.js
 - vendor/javascript/vite-plugin-ruact/manifest-contract.test.mjs
+- vendor/javascript/vite-plugin-ruact/manifest-http.test.mjs
 - vendor/javascript/vite-plugin-ruact/package-lock.json
 - vendor/javascript/vite-plugin-ruact/package.json
 - vendor/javascript/vite-plugin-ruact/registry.test.mjs
@@ -215,6 +229,7 @@ files:
 - vendor/javascript/vite-plugin-ruact/tsconfig.json
 - vendor/javascript/vite-plugin-ruact/tsconfig.scaffold-agnostic.json
 - vendor/javascript/vite-plugin-ruact/tsconfig.scaffold.json
+- vendor/javascript/vite-plugin-ruact/type-tests/auto-revalidate.test-d.ts
 - vendor/javascript/vite-plugin-ruact/type-tests/emitted-module.test-d.ts
 - vendor/javascript/vite-plugin-ruact/type-tests/scaffold/PostDeleteDialog.tsx
 - vendor/javascript/vite-plugin-ruact/type-tests/scaffold/PostForm.tsx