walla-page 1.0.0 → 1.0.1

package/README.md

@@ -10,7 +10,7 @@ This project uses `npm`.
 
 - Install dependencies with `npm install`
 - Run the CLI locally with `npm run walla -- ...`
-- Publish the package to npm as `wall-of-page`
+- Publish the package to npm as `walla-page`
 
 Keeping one lockfile is simpler for contributors, and `npm` is the most common default in open source JavaScript projects.
 
@@ -21,7 +21,7 @@ The published npm package is just the Node CLI. Installing it does not require W
 For CLI users:
 
 ```bash
-npm install -g wall-of-page
+npm install -g walla-page
 walla help
 ```
 
@@ -50,7 +50,7 @@ This keeps the hackathon surface area small and testable.
 
 ## Core Capabilities
 
-- Show fullscreen HTML now (`show`)
+- Show fullscreen HTML now (`show`, alias: `push`)
 - Schedule fullscreen HTML for later (`schedule`)
 - Generate ElevenLabs speech and schedule it (`say`)
 - Delete room state and disconnect clients (`delete`, `delete --force`)
@@ -84,6 +84,7 @@ One room contains:
 
 Displays are multi-screen by default.
 
+- Default: public display link per room
 - Default: unlimited display websocket connections per room
 - Optional cap at room creation via `displayLimit`
 - When capped and full, new display ws attempts return `429`
@@ -91,8 +92,10 @@ Displays are multi-screen by default.
 CLI flag:
 
 - `walla create --display-limit <n>`
+- `walla create --private-display`
 - `n >= 1` sets a cap
 - `0` means unlimited
+- `--private-display` requires a display token instead of a bare room link
 
 ## Alarm + Lifecycle
 
@@ -135,7 +138,7 @@ npm run walla -- help
 
 Commands:
 
-- `walla create [--display-limit <n>]`
+- `walla create [--display-limit <n>] [--private-display]`
 - `walla delete [--force]`
 - `walla display`
 - `walla config`
@@ -143,6 +146,7 @@ Commands:
 - `walla status`
 - `walla quickstart`
 - `walla show <file.html> [--title <title>] [--duration <seconds>]`
+- `walla push <file.html> [--title <title>] [--duration <seconds>]`
 - `walla schedule <file.html> --at <time> [--title <title>] [--duration <seconds>]`
 - `walla say <text> [--at <time>] [--title <title>] [--duration <seconds>] [--voice-id <id>] [--max-words <n>]`
 
@@ -172,20 +176,24 @@ Create payload:
 
 ```json
 {
-  "displayLimit": 0
+  "displayLimit": 0,
+  "publicDisplay": true
 }
 ```
 
 - `displayLimit >= 1`: cap displays
 - `displayLimit = 0` or omitted: unlimited
+- `publicDisplay = true` or omitted: bare room display link
+- `publicDisplay = false`: token-protected display link
 
 Display route:
 
-- `GET /rooms/:roomId/display?token=...`
+- Public: `GET /rooms/:roomId`
+- Private: `GET /rooms/:roomId?token=...`
 
 Built-in audio route (allow-listed asset endpoint):
 
-- `GET /audio/campfire.mp3`
+- `GET /audio/campfire-demo.mp3`
 
 ## Quickstart
 
@@ -215,6 +223,7 @@ Drive the room:
 ```bash
 npm run walla -- status
 npm run walla -- show ./examples/campfire.html --duration 120
+npm run walla -- push ./examples/campfire.html --duration 120
 npm run walla -- say "Dinner in five minutes."
 npm run walla -- delete
 # if displays are still connected:

package/bin/walla.mjs

@@ -8,7 +8,7 @@ const CONFIG_DIR = path.join(os.homedir(), ".config", "wallapage");
 const CONFIG_PATH = path.join(CONFIG_DIR, "config.json");
 const LEGACY_CONFIG_PATH = path.join(os.homedir(), ".config", "wallapalooza", "config.json");
 const DEFAULT_TTS_MAX_WORDS = 60;
-const DEFAULT_SERVER = "https://wallapage.redo-page-8fa.workers.dev";
+const DEFAULT_SERVER = "https://walla.page";
 
 async function main() {
   const args = process.argv.slice(2);
@@ -45,6 +45,9 @@ async function main() {
       case "show":
         await showOrSchedule("show", args);
         return;
+      case "push":
+        await showOrSchedule("show", args);
+        return;
       case "schedule":
         await showOrSchedule("schedule", args);
         return;
@@ -64,7 +67,7 @@ function printHelp() {
   console.log(`Walla Page CLI
 
 Usage:
-  walla create [--display-limit <n>] [--server <url>]
+  walla create [--display-limit <n>] [--private-display] [--server <url>]
   walla delete [--force]
   walla display
   walla config [--server <url>]
@@ -72,6 +75,7 @@ Usage:
   walla status
   walla quickstart
   walla show <file.html> [--title <title>] [--duration <seconds>]
+  walla push <file.html> [--title <title>] [--duration <seconds>]
   walla schedule <file.html> --at <time> [--title <title>] [--duration <seconds>]
   walla say <text> [--at <time>] [--title <title>] [--duration <seconds>] [--voice-id <id>] [--max-words <n>]
 
@@ -79,7 +83,9 @@ Notes:
   - HTML scene commands send raw HTML directly to the room runtime.
   - Times can be ISO timestamps, "now", or relative values like "+5m", "+30s", "+2h".
   - Set WALLA_SERVER or use --server to point the CLI at a different backend.
-  - The default CLI flow is create -> open display -> status/show/say. Use delete to remove a room and display to rotate the wall link.`);
+  - 'push' is an alias for 'show'.
+  - Rooms default to a public display link. Pass --private-display to require a display token.
+  - The default CLI flow is create -> open display -> status/show/say. Use delete to remove a room and display to rotate the wall link for private rooms.`);
 }
 
 function quickstart() {
@@ -106,10 +112,11 @@ async function createRoom(args) {
   const existing = await maybeCurrentRoom();
   const server = resolveServer(existing, flags.server);
   const displayLimit = parseDisplayLimitFlag(flags["display-limit"]);
+  const publicDisplay = !Boolean(flags["private-display"]);
   const created = await fetchJson(`${server}/api/rooms`, {
     method: "POST",
     headers: { "content-type": "application/json" },
-    body: JSON.stringify({ displayLimit })
+    body: JSON.stringify({ displayLimit, publicDisplay })
   });
   const next = await upsertRoom({
     server,
@@ -127,12 +134,18 @@ async function createRoom(args) {
   } else {
     console.log("Display WS limit: unlimited");
   }
+  console.log(`Display access: ${publicDisplay ? "public" : "private"}`);
   console.log(`Display: ${created.display.link}`);
   await saveConfig(next);
 }
 
 async function displayLink() {
   const room = await requireCurrentRoom();
+  const snapshot = await api(room, "GET", `/api/rooms/${room.roomId}/state?token=${encodeURIComponent(room.token)}`);
+  if (snapshot.publicDisplay) {
+    console.log(`${room.server}/rooms/${room.roomId}`);
+    return;
+  }
   const pair = await api(room, "POST", `/api/rooms/${room.roomId}/pair`, { role: "display" });
   console.log(pair.link);
 }
@@ -197,6 +210,7 @@ async function status() {
   const snapshot = await api(room, "GET", `/api/rooms/${room.roomId}/state?token=${encodeURIComponent(room.token)}`);
   console.log(JSON.stringify({
     roomId: snapshot.roomId,
+    publicDisplay: snapshot.publicDisplay,
     displayWsLimit: snapshot.displayWsLimit,
     currentScene: snapshot.currentScene?.title ?? null,
     upcomingScenes: snapshot.upcomingScenes.length,

package/llms.txt

@@ -51,6 +51,7 @@ walla create
 walla display
 walla status
 walla show ./scene.html
+walla push ./scene.html
 walla schedule ./scene.html --at +10m
 walla say "Build finished."
 walla delete

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "walla-page",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "CLI for controlling Walla Page rooms from Node.",
   "type": "module",
   "files": [
@@ -18,6 +18,7 @@
     "dev": "wrangler dev",
     "deploy": "wrangler deploy",
     "check": "tsc --noEmit",
+    "generate:campfire-audio": "node ./scripts/generate-campfire-audio.mjs",
     "walla": "node ./bin/walla.mjs",
     "test:smoke": "node test/smoke.test.mjs"
   },
@@ -38,6 +39,5 @@
     "hono": "^4.10.1",
     "typescript": "^6.0.2",
     "wrangler": "^4.78.0"
-  },
-  "package-lock": "false"
+  }
 }