@couch-kit/cli 0.3.4 → 0.3.6

package/README.md

@@ -14,7 +14,7 @@ bun add -d @couch-kit/cli
 
 ### `init`
 
-Scaffolds a new web controller project (Vite + React + TypeScript) configured to work with Couch Kit.
+Scaffolds a web controller project (Vite + React + TypeScript) to add to an existing host app. This creates only the phone/tablet side — for a full game project (host + client + shared), clone the [Buzz starter](https://github.com/faluciano/buzz-tv-party-game).
 
 ```bash
 bunx couch-kit init web-controller
@@ -22,7 +22,7 @@ bunx couch-kit init web-controller
 
 ### `bundle`
 
-Builds the web controller and copies the assets into your Android project's `assets/www` folder. This is used when preparing your TV app for release.
+Builds the web controller and copies the assets into your Android project's `assets/www` folder, along with a `manifest.json` listing all files. This manifest is used by `useExtractAssets()` on the host to extract assets at runtime.
 
 ```bash
 # Default (looks for ./web-controller and copies to android/app/src/main/assets/www)
@@ -32,6 +32,16 @@ bunx couch-kit bundle
 bunx couch-kit bundle --source ./my-web-app --output ./android/app/src/main/assets/www
 ```
 
+Output structure:
+
+```
+android/app/src/main/assets/www/
+├── manifest.json       ← import this in your host app
+├── index.html
+├── assets/
+│   └── ...
+```
+
 ### `simulate`
 
 Spawns headless WebSocket bots to simulate players (useful for load testing and quick iteration).
@@ -46,3 +56,39 @@ bunx couch-kit simulate --url ws://192.168.1.99:8082 --count 8
 # Action interval (ms)
 bunx couch-kit simulate --interval 250
 ```
+
+### `replay`
+
+Replays a recorded game session against a reducer, validating state transitions. Useful for debugging, regression testing, and reproducing bugs from recordings captured with `useActionRecorder`.
+
+```bash
+# Replay a recording against your reducer
+bunx couch-kit replay ./session.json ./shared/reducer.ts
+
+# With intermediate state snapshots
+bunx couch-kit replay ./session.json ./shared/reducer.ts --snapshots
+
+# JSON output (for piping to other tools)
+bunx couch-kit replay ./session.json ./shared/reducer.ts --json
+```
+
+The reducer module must export a `default` or a named `reducer` function. If your shared file exports `gameReducer`, add a re-export:
+
+```ts
+// shared/reducer.ts (or any entry point for replay)
+export { gameReducer as default } from "./types";
+```
+
+### `dev`
+
+Starts a Vite dev server on the LAN so phones can load the controller from your laptop during development.
+
+```bash
+# Default: port 5173, exposed to LAN
+bunx couch-kit dev
+
+# Custom port
+bunx couch-kit dev --port 3000
+```
+
+Prints the LAN URL (e.g., `http://192.168.1.50:5173`) so you can pass it as `devServerUrl` to `GameHostProvider`. Requires `vite` as a dev dependency in your web controller project.

package/dist/index.js

@@ -1887,11 +1887,14 @@ var init_esm = __esm(() => {
   } = import__.default);
 });
 
+// ../core/src/types.ts
+var init_types = () => {};
+
 // ../core/src/middleware.ts
 var init_middleware = () => {};
 
-// ../core/src/types.ts
-var init_types = () => {};
+// ../core/src/reducer.ts
+var init_reducer = () => {};
 
 // ../core/src/protocol.ts
 var MessageTypes;
@@ -1960,6 +1963,7 @@ function replayActions(recording, reducer) {
 // ../core/src/index.ts
 var init_src = __esm(() => {
   init_types();
+  init_reducer();
   init_protocol();
   init_constants();
   init_middleware();
@@ -2156,16 +2160,16 @@ var init_init = __esm(() => {
           preview: "vite preview"
         },
         dependencies: {
-          react: "^18.2.0",
-          "react-dom": "^18.2.0",
-          "@couch-kit/client": "^0.4.3"
+          react: "^19.0.0",
+          "react-dom": "^19.0.0",
+          "@couch-kit/client": "^0.8.0"
         },
         devDependencies: {
-          "@types/react": "^18.2.66",
-          "@types/react-dom": "^18.2.22",
-          "@vitejs/plugin-react": "^4.2.1",
-          typescript: "^5.2.2",
-          vite: "^5.2.0"
+          "@types/react": "^19.0.0",
+          "@types/react-dom": "^19.0.0",
+          "@vitejs/plugin-react": "^6.0.0",
+          typescript: "^5.7.0",
+          vite: "^6.0.0"
         }
       };
       fs2.writeFileSync(path2.join(targetDir, "package.json"), JSON.stringify(packageJson, null, 2) + `
@@ -2244,11 +2248,12 @@ ReactDOM.createRoot(document.getElementById('root')!).render(
 `);
       fs2.writeFileSync(path2.join(targetDir, "src/App.tsx"), `
 import { useGameClient } from '@couch-kit/client';
+import { gameReducer, initialState } from './reducer';
 
 function App() {
   const { status, playerId, sendAction } = useGameClient({
-    initialState: { count: 0 },
-    reducer: (state, action) => state // Dummy reducer
+    initialState,
+    reducer: gameReducer,
   });
 
   return (
@@ -2256,7 +2261,7 @@ function App() {
         <h1>Controller</h1>
         <p>Status: {status}</p>
         <p>ID: {playerId || 'Connecting...'}</p>
-        <button onClick={() => sendAction({ type: 'BUZZ' })} 
+        <button onClick={() => sendAction({ type: 'SCORE' })} 
                 style={{ fontSize: 24, padding: '20px 40px', width: '100%' }}>
             BUZZ!
         </button>
@@ -2350,12 +2355,12 @@ var init_replay = __esm(() => {
       }
       const resolvedReducerPath = resolve(reducerPath);
       const reducerModule = await import(resolvedReducerPath);
-      const reducer = reducerModule.default ?? reducerModule.reducer;
-      if (typeof reducer !== "function") {
+      const reducer2 = reducerModule.default ?? reducerModule.reducer;
+      if (typeof reducer2 !== "function") {
         console.error("Error: Reducer module must export a default function or named 'reducer' export");
         process.exit(1);
       }
-      const result = replayActions(recording, reducer);
+      const result = replayActions(recording, reducer2);
       if (options.json) {
         const output = options.snapshots ? result : {
           finalState: result.finalState,
@@ -2472,9 +2477,9 @@ program2.command("init").description("Scaffolds a new web controller project").a
   const { initCommand: initCommand2 } = await Promise.resolve().then(() => (init_init(), exports_init));
   await initCommand2.parseAsync(["init", name], { from: "user" });
 });
-program2.command("replay").description("Replay a recorded game session against a reducer").argument("<recording>", "Path to recording JSON file").argument("<reducer>", "Path to reducer module").option("--snapshots", "Output intermediate state snapshots").option("--json", "Output as formatted JSON").action(async (recording, reducer, options) => {
+program2.command("replay").description("Replay a recorded game session against a reducer").argument("<recording>", "Path to recording JSON file").argument("<reducer>", "Path to reducer module").option("--snapshots", "Output intermediate state snapshots").option("--json", "Output as formatted JSON").action(async (recording, reducer2, options) => {
   const { replay: replay3 } = await Promise.resolve().then(() => (init_replay(), exports_replay));
-  await replay3.parseAsync(["replay", recording, reducer, ...reconstructArgs(options)], { from: "user" });
+  await replay3.parseAsync(["replay", recording, reducer2, ...reconstructArgs(options)], { from: "user" });
 });
 program2.command("dev").description("Start development server with LAN access").option("-p, --port <port>", "Port number", "5173").option("--host", "Expose to LAN").option("--open", "Open browser automatically").action(async (options) => {
   const { dev: dev2 } = await Promise.resolve().then(() => (init_dev(), exports_dev));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@couch-kit/cli",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "publishConfig": {
     "access": "public",
     "provenance": true
@@ -39,10 +39,10 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@couch-kit/core": "0.9.0",
+    "@couch-kit/core": "0.9.1",
     "commander": "^12.0.0"
   },
   "devDependencies": {
-    "typescript": "^5.4.0"
+    "typescript": "^6.0.0"
   }
 }