The Open Standard for Generative UI
Show hosted demo credits popup (#576)
Visharad Kashyap0e2631d13be5
diff --git a/docs/app/api/chat/route.ts b/docs/app/api/chat/route.tsindex ff42bac34..d5517c1b5 100644--- a/docs/app/api/chat/route.ts+++ b/docs/app/api/chat/route.ts@@ -280,8 +280,16 @@ export async function POST(req: NextRequest) {const lastUserMsg = (messages as any[]).filter((m: any) => m.role === "user").pop();if (lastUserMsg) conversationLog.push({ role: "user", content: extractText(lastUserMsg) });+ const apiKey = process.env.OPENROUTER_API_KEY;+ if (!apiKey) {+ return Response.json(+ { error: { message: "OPENROUTER_API_KEY not configured" } },+ { status: 500 },+ );+ }+const client = new OpenAI({- apiKey: process.env.OPENROUTER_API_KEY,+ apiKey,baseURL: "https://openrouter.ai/api/v1",});const MODEL = "openai/gpt-5.4";@@ -363,6 +371,9 @@ export async function POST(req: NextRequest) {// eslint-disable-next-line @typescript-eslint/no-explicit-anyrunner.on("chunk", (chunk: any) => {+ // Keep credit handling to non-2xx responses. Provider-specific mid-stream+ // chunks are intentionally ignored because they are harder to maintain+ // across OpenRouter/OpenAI streaming shape changes.const choice = chunk.choices?.[0];const delta = choice?.delta;if (!delta) return;@@ -376,6 +387,8 @@ export async function POST(req: NextRequest) {});runner.on("end", () => {+ if (controllerClosed) return;+conversationLog.push({ role: "assistant", content: fullResponse });console.info("[OpenUI Lang] Conversation:\n",@@ -391,6 +404,8 @@ export async function POST(req: NextRequest) {// eslint-disable-next-line @typescript-eslint/no-explicit-anyrunner.on("error", (err: any) => {+ if (controllerClosed) return;+const msg = err instanceof Error ? err.message : "Stream error";console.error("Chat route error:", msg);enqueue(encoder.encode(`data: ${JSON.stringify({ error: msg })}\n\n`));diff --git a/docs/app/api/demo/github/stream/route.ts b/docs/app/api/demo/github/stream/route.tsindex fd3648177..e5f96bd52 100644--- a/docs/app/api/demo/github/stream/route.ts+++ b/docs/app/api/demo/github/stream/route.ts@@ -1,3 +1,7 @@+import {+ createDemoCreditsExhaustedResponse,+ isDemoCreditsExhaustedError,+} from "@/lib/demo-credits";import { BASE_URL } from "@/lib/source";import { generatePrompt, type PromptSpec } from "@openuidev/lang-core";import { readFileSync } from "fs";@@ -82,6 +86,10 @@ export async function POST(req: NextRequest) {if (!res.ok) {const err = await res.json().catch(() => ({}));+ if (isDemoCreditsExhaustedError(err, res.status)) {+ return createDemoCreditsExhaustedResponse();+ }+return Response.json({error: (err as { error?: { message?: string } }).error ?? {@@ -92,6 +100,9 @@ export async function POST(req: NextRequest) {);}+ // Keep credit handling to provider 4xx responses. Provider-specific mid-stream+ // error chunks are intentionally passed through because they are harder to+ // maintain across OpenRouter/OpenAI streaming shape changes.return new Response(res.body, {headers: {"Content-Type": "text/event-stream",diff --git a/docs/app/api/playground/stream/route.ts b/docs/app/api/playground/stream/route.tsindex 59d8b31c5..132003e54 100644--- a/docs/app/api/playground/stream/route.ts+++ b/docs/app/api/playground/stream/route.ts@@ -1,3 +1,7 @@+import {+ createDemoCreditsExhaustedResponse,+ isDemoCreditsExhaustedError,+} from "@/lib/demo-credits";import { BASE_URL } from "@/lib/source";import { readFileSync } from "fs";import { type NextRequest } from "next/server";@@ -36,6 +40,10 @@ export async function POST(req: NextRequest) {if (!res.ok) {const err = await res.json().catch(() => ({}));+ if (isDemoCreditsExhaustedError(err, res.status)) {+ return createDemoCreditsExhaustedResponse();+ }+return Response.json({error: (err as { error?: { message?: string } }).error ?? {@@ -46,6 +54,9 @@ export async function POST(req: NextRequest) {);}+ // Keep credit handling to provider 4xx responses. Provider-specific mid-stream+ // error chunks are intentionally passed through because they are harder to+ // maintain across OpenRouter/OpenAI streaming shape changes.const [streamForClient, streamForLog] = res.body!.tee();const reader = streamForLog.getReader();diff --git a/docs/app/demo/github/constants.ts b/docs/app/demo/github/constants.tsindex f9f6faab9..da0823b2b 100644--- a/docs/app/demo/github/constants.ts+++ b/docs/app/demo/github/constants.ts@@ -1,6 +1,12 @@export type Theme = "system" | "light" | "dark";export type Status = "idle" | "streaming" | "done" | "error";+export const STREAM_RESULT = {+ Done: "done",+ CreditsExhausted: "credits-exhausted",+} as const;+export type StreamResult = (typeof STREAM_RESULT)[keyof typeof STREAM_RESULT];+export const GITHUB_DEMO_MODEL = "anthropic/claude-sonnet-4-6";export const GITHUB_DEMO_MODEL_LABEL = "Claude Sonnet 4.6";diff --git a/docs/app/demo/github/page.tsx b/docs/app/demo/github/page.tsxindex 5afec7f00..64ead5709 100644--- a/docs/app/demo/github/page.tsx+++ b/docs/app/demo/github/page.tsx@@ -1,5 +1,7 @@"use client";+import { DemoCreditsDialog } from "@/components/DemoCreditsDialog";+import { isDemoCreditsErrorPayload } from "@/lib/demo-credits";import { mergeStatements } from "@openuidev/react-lang";import { Button } from "@openuidev/react-ui";import { encode } from "gpt-tokenizer";@@ -25,9 +27,11 @@ import { PreviewPanel } from "./components/PreviewPanel/PreviewPanel";import {GITHUB_DEMO_MODEL_LABEL,GITHUB_STARTERS,+ STREAM_RESULT,type ChatMessage,type GitHubStarterIconKey,type Status,+ type StreamResult,type Theme,type ToolCallEntry,} from "./constants";@@ -137,7 +141,7 @@ async function streamChat(onDone: () => void,signal?: AbortSignal,onFirstChunk?: () => void,-) {+): Promise<StreamResult> {const res = await fetch("/api/demo/github/stream", {method: "POST",headers: { "Content-Type": "application/json" },@@ -147,11 +151,15 @@ async function streamChat(if (!res.ok) {const err = await res.json().catch(() => ({}));+ if (isDemoCreditsErrorPayload((err as { error?: unknown }).error)) {+ return STREAM_RESULT.CreditsExhausted;+ }+onChunk(`Error: ${(err as { error?: { message?: string } }).error?.message ?? `Server error ${res.status}`}`,);onDone();- return;+ return STREAM_RESULT.Done;}const reader = res.body!.getReader();@@ -169,26 +177,31 @@ async function streamChat(const data = trimmed.slice(5).trim();if (data === "[DONE]") {onDone();- return;+ return STREAM_RESULT.Done;}+ let parsed: {+ error?: unknown;+ choices?: Array<{ delta?: { content?: string }; finish_reason?: string }>;+ };try {- const parsed = JSON.parse(data) as {- choices: Array<{ delta: { content?: string } }>;- };- const content = parsed.choices[0]?.delta?.content;- if (content) {- if (!firstChunkFired) {- firstChunkFired = true;- onFirstChunk?.();- }- onChunk(content);- }+ parsed = JSON.parse(data);} catch {// skip malformed chunks+ continue;+ }++ const content = parsed.choices?.[0]?.delta?.content;+ if (content) {+ if (!firstChunkFired) {+ firstChunkFired = true;+ onFirstChunk?.();+ }+ onChunk(content);}}}onDone();+ return STREAM_RESULT.Done;}// ── Main Page ────────────────────────────────────────────────────────────@@ -222,6 +235,7 @@ export default function GitHubDemoPage() {const [startTime, setStartTime] = useState<number | null>(null);const [elapsed, setElapsed] = useState<number | null>(null);const [errorMsg, setErrorMsg] = useState("");+ const [showGitHubCreditsDialog, setShowGitHubCreditsDialog] = useState(false);const abortRef = useRef<AbortController | null>(null);const responseRef = useRef("");@@ -298,6 +312,7 @@ export default function GitHubDemoPage() {setShowSource(false);setParsedJson(null);setErrorMsg("");+ setShowGitHubCreditsDialog(false);};// ── Send message ─────────────────────────────────────────────────────@@ -311,6 +326,7 @@ export default function GitHubDemoPage() {setStartTime(null);setElapsed(null);setErrorMsg("");+ setShowGitHubCreditsDialog(false);responseRef.current = "";setStreamingText("");setToolCalls([]);@@ -353,7 +369,7 @@ export default function GitHubDemoPage() {abortRef.current = controller;try {- await streamChat(+ const streamResult = await streamChat({prompt: githubContext ? `${githubContext}\n\n${trimmed}` : trimmed,messages: apiMessages.slice(0, -1),@@ -403,6 +419,13 @@ export default function GitHubDemoPage() {setStartTime(streamStartTime);},);++ if (streamResult === STREAM_RESULT.CreditsExhausted) {+ abortRef.current = null;+ setStatus("idle");+ setStreamResponseHasCode(false);+ setShowGitHubCreditsDialog(true);+ }} catch (err: unknown) {if (err instanceof Error && err.name === "AbortError") {setStreamResponseHasCode(false);@@ -707,6 +730,10 @@ export default function GitHubDemoPage() {{/* Error banner */}{status === "error" && errorMsg && <div className="error-banner">{errorMsg}</div>}+ <DemoCreditsDialog+ open={showGitHubCreditsDialog}+ onClose={() => setShowGitHubCreditsDialog(false)}+ /></div>);}diff --git a/docs/app/playground/page.tsx b/docs/app/playground/page.tsxindex 5d65ea64c..587ba56f3 100644--- a/docs/app/playground/page.tsx+++ b/docs/app/playground/page.tsx@@ -1,5 +1,7 @@"use client";+import { DemoCreditsDialog } from "@/components/DemoCreditsDialog";+import { isDemoCreditsErrorPayload } from "@/lib/demo-credits";import { Send, Square } from "lucide-react";import { useTheme } from "next-themes";import { useCallback, useRef, useState } from "react";@@ -16,6 +18,7 @@ export default function PlaygroundPage() {const [parsedJson, setParsedJson] = useState<string | null>(null);const [status, setStatus] = useState<Status>("idle");const [errorMsg, setErrorMsg] = useState("");+ const [showPlaygroundCreditsDialog, setShowPlaygroundCreditsDialog] = useState(false);const textareaRef = useRef<HTMLTextAreaElement>(null);const abortRef = useRef<AbortController | null>(null);@@ -48,6 +51,7 @@ export default function PlaygroundPage() {setCode("");setParsedJson(null);setErrorMsg("");+ setShowPlaygroundCreditsDialog(false);setStatus("streaming");try {@@ -60,6 +64,12 @@ export default function PlaygroundPage() {if (!res.ok) {const err = await res.json().catch(() => ({}));+ if (isDemoCreditsErrorPayload((err as { error?: unknown }).error)) {+ setShowPlaygroundCreditsDialog(true);+ setStatus("idle");+ return;+ }+throw new Error((err as { error?: { message?: string } }).error?.message ?? `Server error ${res.status}`,);@@ -81,15 +91,19 @@ export default function PlaygroundPage() {setStatus("done");return;}+ let parsed: {+ error?: unknown;+ choices?: Array<{ delta?: { content?: string }; finish_reason?: string }>;+ };try {- const parsed = JSON.parse(data) as {- choices: Array<{ delta: { content?: string } }>;- };- const content = parsed.choices[0]?.delta?.content;- if (content) setCode((prev) => prev + content);+ parsed = JSON.parse(data);} catch {// skip malformed chunks+ continue;}++ const content = parsed.choices?.[0]?.delta?.content;+ if (content) setCode((prev) => prev + content);}}setStatus("done");@@ -197,6 +211,10 @@ export default function PlaygroundPage() {</div></div></div>+ <DemoCreditsDialog+ open={showPlaygroundCreditsDialog}+ onClose={() => setShowPlaygroundCreditsDialog(false)}+ /></div>);}diff --git a/docs/components/DemoCreditsDialog.css b/docs/components/DemoCreditsDialog.cssnew file mode 100644index 000000000..4c73e8a53--- /dev/null+++ b/docs/components/DemoCreditsDialog.css@@ -0,0 +1,141 @@+.demo-credits-dialog-overlay {+ position: fixed;+ inset: 0;+ z-index: 1000;+ display: flex;+ align-items: center;+ justify-content: center;+ padding: 24px;+ background: var(--openui-overlay, rgb(0 0 0 / 40%));+ backdrop-filter: blur(4px);+}++.demo-credits-dialog {+ position: relative;+ width: min(520px, 100%);+ border: 1px solid var(--openui-border-default, rgb(0 0 0 / 12%));+ border-radius: 8px;+ background: var(--openui-foreground, #fff);+ box-shadow: var(--openui-shadow-2xl, 0 24px 80px rgb(0 0 0 / 24%));+ color: var(--openui-text-neutral-primary, #111);+ padding: 24px;+}++.demo-credits-dialog-close {+ position: absolute;+ top: 12px;+ right: 12px;+ display: inline-flex;+ align-items: center;+ justify-content: center;+ width: 28px;+ height: 28px;+ border: 0;+ border-radius: 6px;+ background: transparent;+ color: var(--openui-text-neutral-tertiary, #666);+ cursor: pointer;+}++.demo-credits-dialog-close:hover {+ background: var(--openui-highlight, rgb(0 0 0 / 6%));+ color: var(--openui-text-neutral-primary, #111);+}++.demo-credits-dialog-icon {+ display: inline-flex;+ align-items: center;+ justify-content: center;+ width: 36px;+ height: 36px;+ margin-bottom: 16px;+ border-radius: 8px;+ background: var(--openui-highlight-subtle, rgb(0 0 0 / 4%));+ color: var(--openui-text-neutral-primary, #111);+}++.demo-credits-dialog h2 {+ margin: 0;+ color: var(--openui-text-neutral-primary, #111);+ font-size: 18px;+ font-weight: 650;+ line-height: 1.3;+}++.demo-credits-dialog p {+ margin: 8px 0 0;+ color: var(--openui-text-neutral-secondary, #555);+ font-size: 14px;+ line-height: 1.55;+}++.demo-credits-dialog-commands {+ margin: 18px 0 0;+ padding: 14px;+ overflow-x: auto;+ border: 1px solid var(--openui-border-default, rgb(0 0 0 / 12%));+ border-radius: 8px;+ background: var(--openui-inverted-background, #101010);+ color: var(--openui-text-accent-primary, #f8f8f8);+ font-size: 12px;+ line-height: 1.6;+}++.demo-credits-dialog-actions {+ display: flex;+ align-items: center;+ justify-content: flex-end;+ gap: 8px;+ margin-top: 18px;+}++.demo-credits-dialog-primary,+.demo-credits-dialog-secondary {+ display: inline-flex;+ align-items: center;+ justify-content: center;+ gap: 6px;+ min-height: 34px;+ padding: 0 12px;+ border-radius: 8px;+ font-size: 13px;+ font-weight: 550;+ text-decoration: none;+ cursor: pointer;+}++.demo-credits-dialog-primary {+ border: 1px solid var(--openui-interactive-accent-default, #111);+ background: var(--openui-interactive-accent-default, #111);+ color: var(--openui-text-accent-primary, #fff);+}++.demo-credits-dialog-secondary {+ border: 1px solid var(--openui-border-interactive, rgb(0 0 0 / 16%));+ background: transparent;+ color: var(--openui-text-neutral-primary, #111);+}++.demo-credits-dialog-primary:hover {+ background: var(--openui-interactive-accent-hover, #2a2a2a);+}++.demo-credits-dialog-secondary:hover {+ background: var(--openui-highlight, rgb(0 0 0 / 6%));+}++@media (max-width: 540px) {+ .demo-credits-dialog-overlay {+ align-items: flex-end;+ padding: 12px;+ }++ .demo-credits-dialog {+ padding: 20px;+ }++ .demo-credits-dialog-actions {+ align-items: stretch;+ flex-direction: column;+ }+}diff --git a/docs/components/DemoCreditsDialog.tsx b/docs/components/DemoCreditsDialog.tsxnew file mode 100644index 000000000..1f928df81--- /dev/null+++ b/docs/components/DemoCreditsDialog.tsx@@ -0,0 +1,82 @@+"use client";++import { Download, X } from "lucide-react";+import { useCallback, useEffect, useRef } from "react";+import {+ DEMO_CREDITS_EXHAUSTED_MESSAGE,+ DEMO_CREDITS_LOCAL_COMMANDS,+} from "@/lib/demo-credits";+import "./DemoCreditsDialog.css";++type DemoCreditsDialogProps = {+ open: boolean;+ onClose: () => void;+};++export function DemoCreditsDialog({ open, onClose }: DemoCreditsDialogProps) {+ const closeButtonRef = useRef<HTMLButtonElement>(null);++ const handleKeyDown = useCallback(+ (event: KeyboardEvent) => {+ if (event.key === "Escape") onClose();+ },+ [onClose],+ );++ useEffect(() => {+ if (!open) return;++ closeButtonRef.current?.focus();+ document.addEventListener("keydown", handleKeyDown);+ return () => document.removeEventListener("keydown", handleKeyDown);+ }, [handleKeyDown, open]);++ if (!open) return null;++ return (+ <div className="demo-credits-dialog-overlay" onClick={onClose}>+ <section+ className="demo-credits-dialog"+ role="dialog"+ aria-modal="true"+ aria-labelledby="demo-credits-dialog-title"+ onClick={(event) => event.stopPropagation()}+ >+ <button+ ref={closeButtonRef}+ className="demo-credits-dialog-close"+ onClick={onClose}+ aria-label="Close dialog"+ >+ <X size={16} />+ </button>++ <div className="demo-credits-dialog-icon">+ <Download size={18} />+ </div>++ <h2 id="demo-credits-dialog-title">Hosted demo credits are recharging</h2>+ <p>{DEMO_CREDITS_EXHAUSTED_MESSAGE}</p>++ <pre className="demo-credits-dialog-commands">+ <code>{DEMO_CREDITS_LOCAL_COMMANDS.join("\n")}</code>+ </pre>++ <div className="demo-credits-dialog-actions">+ <a+ className="demo-credits-dialog-primary"+ href="https://github.com/thesysdev/openui"+ target="_blank"+ rel="noreferrer"+ >+ <Download size={14} />+ Download repo+ </a>+ <button className="demo-credits-dialog-secondary" onClick={onClose}>+ Close+ </button>+ </div>+ </section>+ </div>+ );+}diff --git a/docs/components/overview-components/chat-modal.tsx b/docs/components/overview-components/chat-modal.tsxindex 5c382f65a..99003eab9 100644--- a/docs/components/overview-components/chat-modal.tsx+++ b/docs/components/overview-components/chat-modal.tsx@@ -3,12 +3,14 @@import "@openuidev/react-ui/components.css";import "./chat-modal.css";+import { DemoCreditsDialog } from "@/components/DemoCreditsDialog";+import { isDemoCreditsErrorPayload } from "@/lib/demo-credits";import { openAIAdapter, openAIMessageFormat } from "@openuidev/react-headless";import { FullScreen } from "@openuidev/react-ui";import { openuiChatLibrary } from "@openuidev/react-ui/genui-lib";import { X } from "lucide-react";import { useTheme } from "next-themes";-import { useCallback, useEffect } from "react";+import { useCallback, useEffect, useState } from "react";import { createPortal } from "react-dom";interface ChatModalProps {@@ -17,6 +19,7 @@ interface ChatModalProps {export function ChatModal({ onClose }: ChatModalProps) {const { resolvedTheme } = useTheme();+ const [showOverviewCreditsDialog, setShowOverviewCreditsDialog] = useState(false);const handleKey = useCallback((e: KeyboardEvent) => {@@ -44,7 +47,7 @@ export function ChatModal({ onClose }: ChatModalProps) {<FullScreenwelcomeMessage={{ title: "Hello, how can I help you today?" }}processMessage={async ({ messages, abortController }) => {- return fetch("/api/chat", {+ const response = await fetch("/api/chat", {method: "POST",headers: { "Content-Type": "application/json" },body: JSON.stringify({@@ -52,6 +55,21 @@ export function ChatModal({ onClose }: ChatModalProps) {}),signal: abortController.signal,});++ if (!response.ok) {+ const err = await response+ .clone()+ .json()+ .catch(() => ({}));+ if (isDemoCreditsErrorPayload((err as { error?: unknown }).error)) {+ setShowOverviewCreditsDialog(true);+ return new Response("data: [DONE]\n\n", {+ headers: { "Content-Type": "text/event-stream" },+ });+ }+ }++ return response;}}streamProtocol={openAIAdapter()}componentLibrary={openuiChatLibrary}@@ -84,6 +102,10 @@ export function ChatModal({ onClose }: ChatModalProps) {}}/></div>+ <DemoCreditsDialog+ open={showOverviewCreditsDialog}+ onClose={() => setShowOverviewCreditsDialog(false)}+ /></div></div>,document.body,diff --git a/docs/lib/demo-credits.ts b/docs/lib/demo-credits.tsnew file mode 100644index 000000000..5f0aee505--- /dev/null+++ b/docs/lib/demo-credits.ts@@ -0,0 +1,60 @@+export const DEMO_CREDITS_EXHAUSTED_CODE = "demo_credits_exhausted";++export const DEMO_CREDITS_EXHAUSTED_MESSAGE =+ "We're recharging the hosted demo credits. Until then, please download the repo and run it locally to see the live demo.";++export const DEMO_CREDITS_LOCAL_COMMANDS = [+ "git clone https://github.com/thesysdev/openui.git",+ "cd openui",+ "pnpm install",+ 'echo "OPENAI_API_KEY=sk-your-key-here" > examples/openui-chat/.env.local',+ "pnpm --filter openui-chat dev",+] as const;++export type DemoCreditsErrorPayload = {+ code: typeof DEMO_CREDITS_EXHAUSTED_CODE;+ message: string;+ instructions: readonly string[];+};++export function createDemoCreditsErrorPayload(): DemoCreditsErrorPayload {+ return {+ code: DEMO_CREDITS_EXHAUSTED_CODE,+ message: DEMO_CREDITS_EXHAUSTED_MESSAGE,+ instructions: DEMO_CREDITS_LOCAL_COMMANDS,+ };+}++export function isDemoCreditsErrorPayload(value: unknown): value is DemoCreditsErrorPayload {+ return (+ typeof value === "object" &&+ value !== null &&+ "code" in value &&+ (value as { code?: unknown }).code === DEMO_CREDITS_EXHAUSTED_CODE+ );+}++function hasPaymentRequiredCode(value: unknown, depth = 0): boolean {+ if (depth > 4 || typeof value !== "object" || value === null) return false;++ for (const [key, child] of Object.entries(value)) {+ if (["code", "status", "statusCode"].includes(key) && (child === 402 || child === "402")) {+ return true;+ }++ if (hasPaymentRequiredCode(child, depth + 1)) {+ return true;+ }+ }++ return false;+}++export function isDemoCreditsExhaustedError(error: unknown, status?: number): boolean {+ if (status === 402) return true;+ return hasPaymentRequiredCode(error);+}++export function createDemoCreditsExhaustedResponse(): Response {+ return Response.json({ error: createDemoCreditsErrorPayload() }, { status: 402 });+}