@fluxy-chat/create-fluxy-chat 0.3.0 → 0.4.0

package/dist/index.js

@@ -30,7 +30,7 @@ function isPackageManager(value) {
   return PACKAGE_MANAGERS.has(value);
 }
 function isAdapterType(value) {
-  return ["basic", "slack", "telegram", "discord", "web", "react"].includes(value);
+  return ["basic", "slack", "telegram", "discord", "web", "react", "hr-feedback"].includes(value);
 }
 function detectPackageManagerFromLockfiles(cwd) {
   if (fs.existsSync(path.join(cwd, "pnpm-lock.yaml"))) {
@@ -131,6 +131,7 @@ async function runPrompts(inputs) {
         options: [
           { label: "Minimal chat widget (ui-kit, recommended)", value: "minimal" },
           { label: "React chat app (Vite + useChat)", value: "react" },
+          { label: "HR anonymous feedback (compliance starter)", value: "hr-feedback" },
           { label: "Basic (Cloudflare Workers bot)", value: "basic" },
           { label: "Slack", value: "slack" },
           { label: "Telegram", value: "telegram" },
@@ -825,8 +826,10 @@ function parseArgs(argv) {
         args.adapter = value;
       } else if (value === "react") {
         args.adapter = "react";
+      } else if (value === "hr-feedback") {
+        args.adapter = "hr-feedback";
       } else {
-        console.error(`Invalid template: ${value}. Choose: react, basic, slack, telegram, discord, web`);
+        console.error(`Invalid template: ${value}. Choose: react, basic, slack, telegram, discord, web, hr-feedback`);
         process.exit(1);
       }
     } else if (arg === "--adapter" || arg === "-a") {
@@ -834,7 +837,7 @@ function parseArgs(argv) {
       if (value && isAdapterType(value)) {
         args.adapter = value;
       } else {
-        console.error(`Invalid adapter: ${value}. Choose: react, basic, slack, telegram, discord, web`);
+        console.error(`Invalid adapter: ${value}. Choose: react, basic, slack, telegram, discord, web, hr-feedback`);
         process.exit(1);
       }
     } else if (arg === "--pm" || arg === "--package-manager") {
@@ -872,8 +875,8 @@ ${pc.bold("Usage:")}
   npx create-fluxy-chat [project-name] [options]
 
 ${pc.bold("Options:")}
-  -a, --adapter <type>       Adapter: react, basic, slack, telegram, discord, web
-  -t, --template <type>      Alias for --adapter (e.g. react)
+  -a, --adapter <type>       Adapter: react, basic, slack, telegram, discord, web, hr-feedback
+  -t, --template <type>      Alias for --adapter (e.g. react, hr-feedback)
   --pm <manager>             Package manager: npm, pnpm, yarn
   -l, --language <lang>      Language: typescript (default) or javascript
   -y, --yes                  Skip prompts and accept defaults
@@ -884,6 +887,7 @@ ${pc.bold("Options:")}
 
 ${pc.bold("Examples:")}
   ${pc.cyan("npx create-fluxy-chat my-chat --minimal")}
+  ${pc.cyan("npx create-fluxy-chat my-hr-bot --template hr-feedback")}
   ${pc.cyan("npx create-fluxy-chat my-chat --template react")}
   ${pc.cyan("npx create-fluxy-chat my-bot --adapter basic")}
   ${pc.cyan("npx create-fluxy-chat my-bot --adapter slack")}
@@ -942,6 +946,14 @@ async function main() {
       pkg.name = config.name;
       writeJson(projectDir, "package.json", pkg);
       s.stop("React chat app created.");
+    } else if (config.adapter === "hr-feedback") {
+      const templateRoot = path2.join(templatesDir(), "hr-feedback");
+      copyDir(templateRoot, projectDir);
+      const pkgPath = path2.join(projectDir, "package.json");
+      const pkg = JSON.parse(fs2.readFileSync(pkgPath, "utf8"));
+      pkg.name = config.name;
+      writeJson(projectDir, "package.json", pkg);
+      s.stop("HR feedback starter created.");
     } else {
       writeJson(projectDir, "package.json", generatePackageJson(config));
       if (config.language === "typescript") {
@@ -993,6 +1005,7 @@ async function main() {
     config.adapter === "react" ? [
       `cd ${config.name}`,
       "cp .env.example .env",
+      "# Set VITE_FLUXYCHAT_WORKER_URL + VITE_FLUXYCHAT_PUBLIC_ROOM_ID (guest) or MEMBER_JWT",
       `${config.packageManager === "npm" ? "npm run" : config.packageManager} dev`
     ].join("\n") : [
       `cd ${config.name}`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fluxy-chat/create-fluxy-chat",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Scaffold a new FluxyChat bot project with a single command",
   "type": "module",
   "main": "./dist/index.js",
@@ -38,7 +38,7 @@
   },
   "license": "MIT",
   "scripts": {
-    "build": "tsup src/index.ts --format esm --dts",
+    "build": "tsup src/index.ts --format esm",
     "dev": "tsup src/index.ts --format esm --watch",
     "typecheck": "tsc --noEmit"
   }

package/readme.md

@@ -5,10 +5,10 @@ Scaffold a new [FluxyChat](https://github.com/AlessandroFare/fluxychat) bot proj
 ## Quick start
 
 ```bash
-# Minimal chat widget (recommended — 3 lines in App.tsx)
+# Minimal chat widget (recommended: 3 lines in App.tsx)
 npx create-fluxy-chat my-chat --minimal
 
-# React + useChat (more control)
+# React + useChat (guest room ~60s or member JWT)
 npx create-fluxy-chat my-chat --template react
 ```
 
@@ -42,7 +42,7 @@ npx create-fluxy-chat my-bot --adapter basic
 | `--pm <manager>` | | Package manager: `npm`, `pnpm`, `yarn` |
 | `--language <lang>` | `-l` | Language: `typescript` (default) or `javascript` |
 | `--yes` | `-y` | Skip prompts and accept defaults |
-| `--minimal` | | Chat-only widget (`@fluxy-chat/ui-kit`) — no platform modules |
+| `--minimal` | | Chat-only widget (`@fluxy-chat/ui-kit`), no platform modules |
 | `--skip-install` | | Skip dependency installation |
 | `--no-git` | | Skip git repository initialization |
 | `--help` | `-h` | Show help |
@@ -62,14 +62,14 @@ npx create-fluxy-chat my-bot --adapter basic
 
 Each generated project includes:
 
-- **`src/index.ts`** — Cloudflare Workers entry point with route handling
-- **`src/bot.ts`** — Bot handler using `@fluxy-chat/sdk`
-- **`fluxy.config.ts`** — Room authz and publish middleware (basic template)
-- **`wrangler.toml`** — Cloudflare Workers deployment config
-- **`.dev.vars`** — Local development environment variables
-- **`.env.example`** — Example environment variables for your adapter
-- **`tsconfig.json`** — TypeScript configuration (for TS projects)
-- **`README.md`** — Project-specific setup instructions
+- **`src/index.ts`**: Cloudflare Workers entry point with route handling
+- **`src/bot.ts`**: Bot handler using `@fluxy-chat/sdk`
+- **`fluxy.config.ts`**: Room authz and publish middleware (basic template)
+- **`wrangler.toml`**: Cloudflare Workers deployment config
+- **`.dev.vars`**: Local development environment variables
+- **`.env.example`**: Example environment variables for your adapter
+- **`tsconfig.json`**: TypeScript configuration (for TS projects)
+- **`README.md`**: Project-specific setup instructions
 
 ## Package manager detection
 

package/templates/hr-feedback/.env.example

@@ -0,0 +1,9 @@
+# FluxyChat worker URL + service API key (server-side only)
+FLUXY_BASE_URL=https://your-fluxychat-worker.example.com
+FLUXY_API_KEY=your-api-key-here
+
+# Optional dedicated room for aggregated summaries
+HR_FEEDBACK_ROOM_ID=hr-anonymous-feedback
+
+# Optional webhook for Path B HR escalation (de-identified payload only)
+HR_ESCALATION_WEBHOOK_URL=

package/templates/hr-feedback/README.md

@@ -0,0 +1,45 @@
+# HR Anonymous Feedback Starter
+
+Production starter for anonymous employee feedback with sensitive classification and privacy-safe audit.
+
+## Features
+
+- **Path A** — routine feedback → aggregated anonymous summary room
+- **Path B** — sensitive categories → HR escalation hook (category + confidence only, no identity)
+- Reuses FluxyChat `approvalChain` + room timeline audit when wired to agent tools
+- Classification runs on the worker via `POST /anonymous-feedback`
+
+## Quick start
+
+```bash
+cp .env.example .dev.vars
+# fill FLUXY_BASE_URL + FLUXY_API_KEY
+npm install
+npm run dev
+```
+
+Submit feedback:
+
+```bash
+curl -X POST http://localhost:8787/feedback \
+  -H "Content-Type: application/json" \
+  -d '{"content":"My manager makes hostile comments in meetings"}'
+```
+
+## Endpoints
+
+| Route | Description |
+| --- | --- |
+| `GET /` | Health check |
+| `POST /feedback` | Anonymous submission (no user id stored) |
+
+## Privacy
+
+- Raw message content is **not** persisted by this template
+- Worker audit stores **category + timestamp + path** only
+- Configure `HR_ESCALATION_WEBHOOK_URL` for your HRIS / ticketing integration
+
+## Learn more
+
+- [FluxyChat docs](https://github.com/AlessandroFare/fluxychat)
+- Worker route: `POST /anonymous-feedback` (JWT) for in-app widgets

package/templates/hr-feedback/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "hr-feedback-bot",
+  "version": "1.0.0",
+  "type": "module",
+  "private": true,
+  "scripts": {
+    "dev": "wrangler dev",
+    "deploy": "wrangler deploy",
+    "type-check": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@fluxy-chat/sdk": "latest"
+  },
+  "devDependencies": {
+    "@cloudflare/workers-types": "^4.0.0",
+    "typescript": "^5.6.0",
+    "wrangler": "^3.0.0"
+  }
+}

package/templates/hr-feedback/src/feedback.ts

@@ -0,0 +1,71 @@
+interface FeedbackEnv {
+  FLUXY_BASE_URL: string;
+  FLUXY_API_KEY: string;
+  HR_FEEDBACK_ROOM_ID?: string;
+  HR_ESCALATION_WEBHOOK_URL?: string;
+}
+
+interface FeedbackBody {
+  content?: string;
+  roomId?: string;
+}
+
+export interface FeedbackResult {
+  ok: boolean;
+  path?: string;
+  category?: string;
+  confidence?: number;
+  message?: string;
+  error?: string;
+}
+
+/**
+ * Submit anonymous feedback through the FluxyChat worker classifier.
+ * Content is classified server-side; only metadata is returned.
+ */
+export async function submitHrFeedback(
+  env: FeedbackEnv,
+  body: FeedbackBody,
+): Promise<FeedbackResult> {
+  const content = String(body.content ?? "").trim();
+  if (!content) return { ok: false, error: "content required" };
+  if (content.length > 8000) return { ok: false, error: "content_too_long" };
+
+  const baseUrl = env.FLUXY_BASE_URL.replace(/\/$/, "");
+  const res = await fetch(`${baseUrl}/anonymous-feedback`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${env.FLUXY_API_KEY}`,
+    },
+    body: JSON.stringify({
+      content,
+      roomId: body.roomId ?? env.HR_FEEDBACK_ROOM_ID ?? null,
+    }),
+  });
+
+  const data = (await res.json().catch(() => ({}))) as FeedbackResult;
+  if (!res.ok) {
+    return { ok: false, error: data.error ?? `worker_${res.status}` };
+  }
+
+  if (data.path === "hr_escalation" && env.HR_ESCALATION_WEBHOOK_URL) {
+    await fetch(env.HR_ESCALATION_WEBHOOK_URL, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        category: data.category,
+        confidence: data.confidence,
+        at: new Date().toISOString(),
+      }),
+    }).catch(() => undefined);
+  }
+
+  return {
+    ok: true,
+    path: data.path,
+    category: data.category,
+    confidence: data.confidence,
+    message: data.message,
+  };
+}

package/templates/hr-feedback/src/index.ts

@@ -0,0 +1,22 @@
+import { submitHrFeedback } from "./feedback.js";
+
+export default {
+  async fetch(request: Request, env: Record<string, string>): Promise<Response> {
+    const url = new URL(request.url);
+
+    if (url.pathname === "/" && request.method === "GET") {
+      return new Response("HR anonymous feedback bot is running.", { status: 200 });
+    }
+
+    if (url.pathname === "/feedback" && request.method === "POST") {
+      const body = (await request.json().catch(() => ({}))) as {
+        content?: string;
+        roomId?: string;
+      };
+      const result = await submitHrFeedback(env, body);
+      return Response.json(result, { status: result.ok ? 200 : 400 });
+    }
+
+    return new Response("Not Found", { status: 404 });
+  },
+};

package/templates/hr-feedback/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "lib": ["ES2022"],
+    "types": ["@cloudflare/workers-types"],
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "allowSyntheticDefaultImports": true,
+    "noEmit": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/templates/hr-feedback/wrangler.toml

@@ -0,0 +1,7 @@
+name = "hr-feedback-bot"
+main = "src/index.ts"
+compatibility_date = "2024-12-01"
+
+[vars]
+FLUXY_BASE_URL = "https://your-fluxychat-worker.example.com"
+HR_FEEDBACK_ROOM_ID = "hr-anonymous-feedback"

package/templates/minimal/README.md

@@ -1,6 +1,6 @@
 # FluxyChat minimal starter
 
-Three-line chat widget — no platform modules in the generated project.
+Three-line chat widget with no platform modules in the generated project.
 
 ```bash
 cp .env.example .env

package/templates/react/.env.example

@@ -1,8 +1,9 @@
 # FluxyChat worker URL (hosted or self-hosted)
 VITE_FLUXYCHAT_WORKER_URL=https://your-worker.example.workers.dev
 
-# Member JWT from POST /auth/token or onboarding wizard
+# Option A — member JWT (~2 min via onboarding)
 VITE_FLUXYCHAT_MEMBER_JWT=eyJ...
-
-# Demo room — create in console or onboarding
 VITE_FLUXYCHAT_ROOM_ID=demo
+
+# Option B — public guest room (~60s, no signup)
+# VITE_FLUXYCHAT_PUBLIC_ROOM_ID=your-public-room-id

package/templates/react/README.md

@@ -1,22 +1,32 @@
 # FluxyChat React starter
 
-Minimal Vite + React app with `useChat` — first message in minutes.
+Minimal Vite + React app with `useChat`. First message in about 60 seconds via the public guest room.
 
-## Quick start
+## Quick start (guest, fastest)
 
 ```bash
 cp .env.example .env
-# Edit .env with your Worker URL + member JWT
+# Set VITE_FLUXYCHAT_WORKER_URL + VITE_FLUXYCHAT_PUBLIC_ROOM_ID (public room from console)
 npm install
 npm run dev
 ```
 
-Open http://localhost:5173 and send a message.
+Open http://localhost:5173. A guest JWT is minted automatically via `joinPublicRoomAsGuest`.
+
+## Quick start (member JWT)
+
+```bash
+cp .env.example .env
+# Set VITE_FLUXYCHAT_WORKER_URL + VITE_FLUXYCHAT_MEMBER_JWT + VITE_FLUXYCHAT_ROOM_ID
+npm install
+npm run dev
+```
 
 ## Get credentials
 
-1. **Hosted:** [fluxychat.com/onboarding](https://fluxychat.com/onboarding) → copy Worker URL + JWT
-2. **Local monorepo:** `pnpm run first-message` from the FluxyChat repo
+1. **Guest:** create a **public** room in console, copy room ID, set `VITE_FLUXYCHAT_PUBLIC_ROOM_ID`
+2. **Member:** [fluxychat.com/onboarding](https://fluxychat.com/onboarding) for Worker URL and JWT
+3. **Local monorepo:** `pnpm run first-message` from the FluxyChat repo
 
 ## Scripts
 
@@ -28,6 +38,6 @@ Open http://localhost:5173 and send a message.
 
 ## Next steps
 
-- Add `@fluxy-chat/ui` for polished message bubbles
+- Add `@fluxy-chat/ui` themes (`default`, `dark`, `minimal`, `brand`)
 - Use `useInbox` for unified feed
 - See [chat-only quickstart](https://docs.fluxychat.com/docs/getting-started/chat-only-quickstart)

package/templates/react/src/App.tsx

@@ -1,10 +1,82 @@
-import { useMemo, useState } from "react";
+import { useEffect, useMemo, useState } from "react";
 import { FluxyChatClient } from "@fluxy-chat/sdk";
 import { FluxyRealtimeProvider, useChat } from "@fluxy-chat/react";
 
-const workerUrl = import.meta.env.VITE_FLUXYCHAT_WORKER_URL;
-const memberJwt = import.meta.env.VITE_FLUXYCHAT_MEMBER_JWT;
-const defaultRoomId = import.meta.env.VITE_FLUXYCHAT_ROOM_ID || "demo";
+const workerUrl = import.meta.env.VITE_FLUXYCHAT_WORKER_URL?.trim();
+const memberJwt = import.meta.env.VITE_FLUXYCHAT_MEMBER_JWT?.trim();
+const publicRoomId = import.meta.env.VITE_FLUXYCHAT_PUBLIC_ROOM_ID?.trim();
+const configuredRoomId = import.meta.env.VITE_FLUXYCHAT_ROOM_ID?.trim() || "demo";
+
+interface FluxySession {
+  client: FluxyChatClient;
+  roomId: string;
+  mode: "member" | "guest";
+}
+
+function useFluxySession(): {
+  session: FluxySession | null;
+  loading: boolean;
+  error: string | null;
+} {
+  const [session, setSession] = useState<FluxySession | null>(null);
+  const [loading, setLoading] = useState(Boolean(workerUrl));
+  const [error, setError] = useState<string | null>(null);
+
+  useEffect(() => {
+    if (!workerUrl) {
+      setLoading(false);
+      return;
+    }
+
+    if (memberJwt) {
+      setSession({
+        client: new FluxyChatClient({
+          baseUrl: workerUrl,
+          userId: "demo-user",
+          token: memberJwt,
+        }),
+        roomId: configuredRoomId,
+        mode: "member",
+      });
+      setLoading(false);
+      return;
+    }
+
+    if (publicRoomId) {
+      let cancelled = false;
+      void FluxyChatClient.joinPublicRoomAsGuest(workerUrl, publicRoomId, {
+        displayName: "Guest",
+      })
+        .then((guest) => {
+          if (cancelled) return;
+          setSession({
+            client: new FluxyChatClient({
+              baseUrl: workerUrl,
+              userId: guest.userId,
+              token: guest.token,
+            }),
+            roomId: guest.roomId,
+            mode: "guest",
+          });
+        })
+        .catch((err) => {
+          if (!cancelled) {
+            setError(err instanceof Error ? err.message : "Guest session failed");
+          }
+        })
+        .finally(() => {
+          if (!cancelled) setLoading(false);
+        });
+      return () => {
+        cancelled = true;
+      };
+    }
+
+    setLoading(false);
+  }, []);
+
+  return { session, loading, error };
+}
 
 function ChatPanel({ roomId }: { roomId: string }) {
   const { messages, sendMessage, connectionState } = useChat({
@@ -50,31 +122,49 @@ function ChatPanel({ roomId }: { roomId: string }) {
 }
 
 export function App() {
-  const [roomId, setRoomId] = useState(defaultRoomId);
-
-  const client = useMemo(() => {
-    if (!workerUrl?.trim() || !memberJwt?.trim()) return null;
-    return new FluxyChatClient({
-      baseUrl: workerUrl.trim(),
-      userId: "demo-user",
-      token: memberJwt.trim(),
-    });
-  }, []);
+  const { session, loading, error } = useFluxySession();
+  const [roomId, setRoomId] = useState(configuredRoomId);
+
+  const activeRoomId = useMemo(() => {
+    if (session?.mode === "guest") return session.roomId;
+    return roomId.trim() || configuredRoomId;
+  }, [session, roomId]);
 
-  if (!client) {
+  if (!workerUrl) {
     return (
       <main className="shell">
         <h1>FluxyChat — chat-only starter</h1>
         <p>
           Copy <code>.env.example</code> to <code>.env</code> and set{" "}
-          <code>VITE_FLUXYCHAT_WORKER_URL</code> and <code>VITE_FLUXYCHAT_MEMBER_JWT</code>.
+          <code>VITE_FLUXYCHAT_WORKER_URL</code>.
+        </p>
+        <p>
+          Then either <code>VITE_FLUXYCHAT_MEMBER_JWT</code> (member) or{" "}
+          <code>VITE_FLUXYCHAT_PUBLIC_ROOM_ID</code> (guest, ~60s to first message).
         </p>
+      </main>
+    );
+  }
+
+  if (loading) {
+    return (
+      <main className="shell">
+        <p>Connecting…</p>
+      </main>
+    );
+  }
+
+  if (error || !session) {
+    return (
+      <main className="shell">
+        <h1>FluxyChat</h1>
+        <p className="error">{error ?? "Set JWT or public room ID in .env"}</p>
         <p>
           Get credentials from{" "}
           <a href="https://fluxychat.com/onboarding" target="_blank" rel="noreferrer">
             onboarding
           </a>{" "}
-          or <code>pnpm run first-message</code> in the monorepo.
+          or use a public room ID for guest mode.
         </p>
       </main>
     );
@@ -83,12 +173,15 @@ export function App() {
   return (
     <main className="shell">
       <h1>FluxyChat</h1>
-      <label className="room-picker">
-        Room
-        <input value={roomId} onChange={(e) => setRoomId(e.target.value)} />
-      </label>
-      <FluxyRealtimeProvider client={client}>
-        <ChatPanel roomId={roomId.trim() || defaultRoomId} />
+      <p className="mode-badge">{session.mode === "guest" ? "Guest session" : "Member JWT"}</p>
+      {session.mode === "member" ? (
+        <label className="room-picker">
+          Room
+          <input value={roomId} onChange={(e) => setRoomId(e.target.value)} />
+        </label>
+      ) : null}
+      <FluxyRealtimeProvider client={session.client}>
+        <ChatPanel roomId={activeRoomId} />
       </FluxyRealtimeProvider>
     </main>
   );

package/templates/react/src/index.css

@@ -91,6 +91,16 @@ body {
   cursor: pointer;
 }
 
+.mode-badge {
+  font-size: 0.75rem;
+  color: #64748b;
+  margin: 0 0 0.75rem;
+}
+
+.error {
+  color: #b91c1c;
+}
+
 .room-picker {
   display: flex;
   flex-direction: column;

package/templates/react/src/vite-env.d.ts

@@ -2,8 +2,9 @@
 
 interface ImportMetaEnv {
   readonly VITE_FLUXYCHAT_WORKER_URL: string;
-  readonly VITE_FLUXYCHAT_MEMBER_JWT: string;
-  readonly VITE_FLUXYCHAT_ROOM_ID: string;
+  readonly VITE_FLUXYCHAT_MEMBER_JWT?: string;
+  readonly VITE_FLUXYCHAT_ROOM_ID?: string;
+  readonly VITE_FLUXYCHAT_PUBLIC_ROOM_ID?: string;
 }
 
 interface ImportMeta {