ugly-app 0.1.42 → 0.1.44

package/README.md

@@ -6,9 +6,9 @@ A full-stack TypeScript framework for building production-ready web applications
 
 - **Server**: Express + WebSocket with type-safe RPC and Zod validation
 - **Client**: React + Vite with typed routing, lazy pages, and popup management
-- **Database**: MongoDB with typed collections, indexes, migrations, and live document tracking
+- **Database**: MongoDB with typed collections, dot-notation updates, indexes, migrations, and live document tracking
 - **Auth**: JWT + HttpOnly cookies, ugly.bot OAuth out of the box, extensible via `AuthProvider`
-- **AI**: Text generation (Together, Claude, OpenAI, Google, Groq, Fireworks) + image generation (Together, FAL, Google, Wavespeed)
+- **AI**: Text generation (Together, Claude, OpenAI, Google, Groq, Fireworks) + image generation (Together, FAL, Google, Wavespeed) + embeddings + STT/TTS
 - **Storage**: Cloudflare R2 / AWS S3 with presigned uploads
 - **CLI**: `ugly-app` commands for dev, build, deploy, migrations, logs, and auth utilities
 
@@ -143,7 +143,7 @@ export const requests = defineRequests({
 
 - `fn({ input, output })` — defines a mutation (write operation). `input` and `output` are Zod schemas.
 - `req({ input, output })` — defines a query (read operation).
-- `defineFunctions()` / `defineRequests()` — identity wrappers that preserve types.
+- `defineFunctions()` / `defineRequests()` — identity wrappers that preserve types. `defineCalls` is an alias for `defineFunctions`.
 - `z` is re-exported from Zod for convenience.
 
 ### Collections (`shared/collections.ts`)
@@ -164,11 +164,14 @@ export const collections = defineCollections({
 });
 ```
 
-Collection meta fields:
-- `cache` — enable in-memory caching
-- `trackable` — allow real-time `trackDoc`/`trackDocs` subscriptions
-- `public` — accessible without auth
-- `parent` — parent collection name for cascade deletes (or `null`)
+Each collection definition has:
+- `type` — phantom field for TypeScript type inference (never read at runtime)
+- `meta` — runtime metadata:
+  - `cache` — enable in-memory caching
+  - `trackable` — allow real-time `trackDoc`/`trackDocs` subscriptions
+  - `public` — accessible without auth
+  - `parent` — parent collection name for cascade deletes (or `null`)
+- `onDelete?` — optional callback invoked on document deletion
 
 All documents extend `DBObject`: `{ id: string, version: number, created: Date, updated: Date }`.
 
@@ -282,6 +285,10 @@ Wraps your app with context for `useApp()`. Provides user info, socket access, p
 | `splashDone(step)` | Mark a splash screen step as complete |
 | `localizer(key, params?)` | Localize a string key |
 
+`useAppOptional()` returns the same context or `null` if outside `<AppProvider>`.
+
+`useLocalizer()` returns the localizer function (falls back to identity if outside provider).
+
 ### Router
 
 #### Setup (`client/router.ts`)
@@ -315,7 +322,18 @@ export const allPages = {
 ```
 
 - **`lazyPage(factory)`** — lazy-imports a default-exported React component. The component receives route params as props.
-- **`lazyPageLoader(factory)`** — lazy-imports an async loader function `(params) => Promise<ReactElement>` for routes that need data fetching before render. The loader file is the chunk boundary.
+- **`lazyPageLoader(factory)`** — lazy-imports an async loader function `(params) => Promise<ReactElement>` for routes that need data fetching before render. The loader file is the chunk boundary — it can statically import its page component.
+
+**`lazyPageLoader` example:**
+
+```typescript
+// pages/SlowPageLoader.tsx
+import SlowPage from './SlowPage'; // static import OK — same chunk
+export default async function PageLoader({ id }: { id: string }) {
+  const data = await fetchSlowData(id);
+  return <SlowPage {...data} />;
+}
+```
 
 #### Navigation with `useRouter()`
 
@@ -354,10 +372,12 @@ handle.hide(); // dismiss programmatically
 ```
 
 Popup modes:
-- **`block`** — dark backdrop (40% opacity), clicking backdrop does NOT dismiss
+- **`block`** (default) — dark backdrop (40% opacity), clicking backdrop does NOT dismiss
 - **`transient`** — light backdrop (20% opacity), clicking backdrop dismisses
 - **`contextMenu`** — same as transient, intended for menus and pickers
 
+`renderLayer` receives `{ content, spring, hide }` — `spring` is an animated value from 0 to 1, `hide` is a function to close the popup.
+
 #### `Link` component
 
 ```tsx
@@ -370,6 +390,49 @@ import { Link } from 'ugly-app/client';
 
 Renders an `<a>` tag with the correct `href`. Intercepts clicks for client-side navigation (ctrl/cmd+click opens in new tab).
 
+#### Animation system
+
+Built-in spring-like animation primitives for transitions and popups.
+
+```typescript
+import {
+  Animated,
+  createAnimatedValue,
+  useAnimatedValue,
+  easingFunctions,
+  FadeIn,
+  SlideFromBottom,
+  SlideFromRight,
+} from 'ugly-app/client';
+
+// Create an animated value (0→1 spring)
+const spring = createAnimatedValue(0);
+spring.start(1, { duration: 300, easing: easingFunctions.easeOut });
+
+// Use in components
+<Animated.div style={{ opacity: spring.to((v) => String(v)) }}>
+  Content
+</Animated.div>
+
+// Hook version — creates and manages an animated value in a component
+const anim = useAnimatedValue(0);
+
+// Pre-built entrance animations (wrap any children)
+<FadeIn>{children}</FadeIn>
+<SlideFromBottom>{children}</SlideFromBottom>
+<SlideFromRight>{children}</SlideFromRight>
+```
+
+Available easings: `easingFunctions.linear`, `easeIn`, `easeOut`, `easeInOut`.
+
+#### Screenshot capture
+
+```typescript
+import { captureScreenshot } from 'ugly-app/client';
+
+const dataUrl = await captureScreenshot(); // captures the current viewport
+```
+
 ---
 
 ## Auth
@@ -423,7 +486,7 @@ configurator.setAuth({
 await ctx.db.setDoc(collections.note, doc);
 await ctx.db.setDoc(collections.note, doc, { skipIfExists: true });
 
-// Partial update — only specified fields
+// Partial update — only specified fields (supports dot-notation paths)
 await ctx.db.setDocFields(collections.note, id, { title: 'New title' });
 
 // Partial update — returns null if document doesn't exist (no error)
@@ -447,6 +510,10 @@ const notes = await ctx.db.getDocs(collections.note, { userId }, { sort: { creat
 const results = await ctx.db.getQuery<MyResult>('note', pipeline, { skip, limit });
 const count   = await ctx.db.getQueryCount('note', pipeline);
 const raw     = await ctx.db.getQueryRaw<T>('note', pipeline);
+
+// Dynamic/untyped access (when collection name is a runtime string)
+const doc  = await ctx.db.rawGetDoc(collectionName, id);
+const docs = await ctx.db.rawGetDocs(collectionName, filter);
 ```
 
 ### Deleting
@@ -474,7 +541,7 @@ import { dbDefaults } from 'ugly-app/shared';
 // dbDefaults() returns { version: 1, created: new Date(), updated: new Date() }
 const doc = { id: newId(), ...dbDefaults(), title: 'Hello' };
 
-// createUserHelper — typed user CRUD
+// createUserHelper — typed user CRUD with get, set, update methods
 const userHelper = createUserHelper<User>(collections.user);
 const user = await userHelper.get(db, userId);
 await userHelper.set(db, { id: userId, ...dbDefaults(), email });
@@ -494,6 +561,8 @@ export const dbIndexes = defineDbIndexes({
 });
 ```
 
+Index types supported: standard (`IndexDef`), text search (`SearchIndexDef`), and vector/embedding (`VectorIndexDef` with cosine, euclidean, or dotProduct similarity).
+
 Run `npm run db:init` to create/update indexes.
 
 ---
@@ -547,13 +616,33 @@ import { createImageGenClient } from 'ugly-app';
 const imageGen = createImageGenClient();
 ```
 
+### Embeddings
+
+```typescript
+import { createEmbeddingClient, cosineSimilarity } from 'ugly-app';
+const embeddings = createEmbeddingClient();
+const similarity = cosineSimilarity(vectorA, vectorB);
+```
+
+### Speech-to-text / Text-to-speech
+
+```typescript
+// Server-side providers
+import { registerSTTProvider, groqWhisperSTTProvider, loadVADModel } from 'ugly-app';
+import { registerTTSProvider, azureTTSProvider } from 'ugly-app';
+
+// Client-side hooks
+import { useSTT, useTTS, AudioPlayer, AudioRecorder } from 'ugly-app/client';
+```
+
 ### Custom providers
 
 ```typescript
-import { registerTextGenProvider, registerImageGenProvider } from 'ugly-app';
+import { registerTextGenProvider, registerImageGenProvider, registerEmbeddingProvider } from 'ugly-app';
 
 registerTextGenProvider('myProvider', myTextGenImplementation);
 registerImageGenProvider('myProvider', myImageGenImplementation);
+registerEmbeddingProvider('myProvider', myEmbeddingImplementation);
 ```
 
 ### Client-side AI calls
@@ -588,7 +677,7 @@ const url = storage.url('public', destKey);
 const { uploadUrl, resultUrl } = await storage.presignedPut('temp', key);
 ```
 
-Buckets: `'public'` and `'temp'`.
+Buckets: `'public'` and `'temp'`. Supports Cloudflare R2 (production) or MinIO (dev).
 
 Static build-time assets go in `client/public/`. Never hardcode `/asset/...` paths — use the `buildId` from `shared/Build.ts`.
 
@@ -626,7 +715,7 @@ sub(); // unsubscribe
 ### Redis
 
 ```typescript
-import { getRedisClient } from 'ugly-app';
+import { getRedisClient, redisGet, redisSet, redisDel, redisPublish, redisSubscribe } from 'ugly-app';
 const redis = getRedisClient();
 ```
 
@@ -641,6 +730,15 @@ configurator.setWorkerQueue(queue);
 await enqueueTask('taskName', payload);
 ```
 
+### Billing
+
+```typescript
+import { initBillingGateway, getBillingGateway } from 'ugly-app';
+
+await initBillingGateway({ /* config */ });
+const billing = getBillingGateway();
+```
+
 ### Client error capture
 
 ```typescript
@@ -672,21 +770,20 @@ Server-side, `getFeedbackHandlers(maintainBotUserId)` provides the RPC handlers
 await ctx.rateLimit.check();
 ```
 
-### Embeddings
-
-```typescript
-import { createEmbeddingClient, registerEmbeddingProvider } from 'ugly-app';
-const embeddings = createEmbeddingClient();
-```
-
-### Billing
+---
 
-```typescript
-import { initBillingGateway, getBillingGateway } from 'ugly-app';
+## Built-in endpoints
 
-await initBillingGateway({ /* config */ });
-const billing = getBillingGateway();
-```
+| Endpoint | Description |
+|----------|-------------|
+| `GET /health` | Health check — returns `{ status: 'ok', timestamp }` |
+| `POST /auth/verify` | Exchange OAuth code for a session cookie |
+| `POST /auth/logout` | Clear the auth cookie |
+| `GET /auth/token` | Refresh and return the current token |
+| `GET /auth/url` | Get the OAuth popup URL |
+| `POST /ai/request` | AI proxy — forwards to ugly.bot (requires auth) |
+| `POST /api/client-error` | Client-side error capture |
+| `GET /my_feedback` | User feedback history (markdown, requires auth) |
 
 ---
 
@@ -734,6 +831,7 @@ Run with `npm run db:migrate`. Use `npm run db:migrate -- --status` to preview p
 | Variable | Description |
 |----------|-------------|
 | `JWT_SECRET` | **Required** — signs auth tokens |
+| `JWT_EXPIRY_SECONDS` | Token lifetime (optional) |
 | `MONGODB_URI` | MongoDB connection string |
 | `PORT` | Server port (default: 3000) |
 | `NODE_ENV` | `development` or `production` |
@@ -761,3 +859,37 @@ Client-side variables must be prefixed with `VITE_`.
 ## Tech stack
 
 Node.js · TypeScript · Express · React 19 · Vite · Tailwind CSS · MongoDB · NATS · Redis · Cloudflare R2 · Zod · JWT (jose) · ugly.bot OAuth
+
+---
+
+## Shared utilities
+
+`ugly-app/shared` exports common helpers used by both server and client:
+
+```typescript
+import {
+  isDefined,
+  compact,
+  debounce,
+  formatDate,
+  formatRelativeTime,
+  oneSecond,
+  oneMinute,
+  oneHour,
+  oneDay,
+  oneWeek,
+} from 'ugly-app/shared';
+
+isDefined(value);                  // type guard — true if not null/undefined
+compact([1, null, 2, undefined]);  // [1, 2] — filters out null/undefined
+const debouncedFn = debounce(fn, 300);
+formatDate(new Date());            // locale-formatted date string
+formatRelativeTime(new Date());    // "2 hours ago", "just now", etc.
+
+// Time constants (milliseconds)
+oneSecond; // 1000
+oneMinute; // 60_000
+oneHour;   // 3_600_000
+oneDay;    // 86_400_000
+oneWeek;   // 604_800_000
+```

package/dist/cli/scaffold.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/cli/scaffold.ts"],"names":[],"mappings":"AA8DA,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4DxE"}
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/cli/scaffold.ts"],"names":[],"mappings":"AAyFA,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4DxE"}

package/dist/cli/scaffold.js

@@ -38,7 +38,33 @@ function generateEnv(examplePath, projectName) {
     })
         .join('\n');
 }
+/** Locate the `code` binary — checks PATH then known macOS app bundle locations. */
+function findCodeCli() {
+    try {
+        execSync('code --version', { stdio: 'ignore' });
+        return 'code';
+    }
+    catch { /* not in PATH */ }
+    const candidates = process.platform === 'win32'
+        ? [
+            path.join(process.env['LOCALAPPDATA'] ?? '', 'Programs\\Microsoft VS Code\\bin\\code.cmd'),
+            path.join(process.env['ProgramFiles'] ?? '', 'Microsoft VS Code\\bin\\code.cmd'),
+            path.join(process.env['ProgramFiles(x86)'] ?? '', 'Microsoft VS Code\\bin\\code.cmd'),
+        ]
+        : [
+            '/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code',
+            path.join(os.homedir(), 'Applications/Visual Studio Code.app/Contents/Resources/app/bin/code'),
+        ];
+    for (const p of candidates) {
+        if (fs.existsSync(p))
+            return `"${p}"`;
+    }
+    return null;
+}
 async function installVsixExtension() {
+    const codeCli = findCodeCli();
+    if (!codeCli)
+        return; // VSCode not found — skip silently
     const url = 'https://ugly.bot/asset/ugly-bot.vsix';
     const vsixPath = path.join(os.tmpdir(), 'ugly-bot.vsix');
     try {
@@ -48,11 +74,11 @@ async function installVsixExtension() {
             throw new Error(`HTTP ${res.status}`);
         const buf = await res.arrayBuffer();
         await fs.writeFile(vsixPath, Buffer.from(buf));
-        execSync(`code --install-extension "${vsixPath}"`, { stdio: 'inherit' });
+        execSync(`${codeCli} --install-extension "${vsixPath}"`, { stdio: 'inherit' });
         console.log('[ugly-app] VSCode extension installed.');
     }
-    catch {
-        console.warn('[ugly-app] Could not install VSCode extension (skipping).');
+    catch (err) {
+        console.warn(`[ugly-app] Could not install VSCode extension (skipping): ${err.message}`);
     }
     finally {
         await fs.remove(vsixPath).catch(() => { });
@@ -77,6 +103,11 @@ export async function scaffoldProject(projectName) {
     await fs.writeFile(path.join(destDir, '.env'), envContent, 'utf-8');
     console.log('[ugly-app] Installing dependencies...');
     execSync('npm install', { cwd: destDir, stdio: 'inherit' });
+    const portStart = 3000;
+    const projectId = nanoid(10).toLowerCase();
+    writeUglyAppConfig(destDir, { projectId, portStart });
+    console.log(`\n[uglyapp] Generated .uglyapp for ${projectName}`);
+    printPortTable(portStart);
     console.log('[ugly-app] Initialising git repository...');
     execSync('git init', { cwd: destDir, stdio: 'inherit' });
     execSync('git add .', { cwd: destDir, stdio: 'inherit' });
@@ -84,11 +115,6 @@ export async function scaffoldProject(projectName) {
         cwd: destDir,
         stdio: 'inherit',
     });
-    const portStart = 3000;
-    const projectId = nanoid(10).toLowerCase();
-    writeUglyAppConfig(destDir, { projectId, portStart });
-    console.log(`\n[uglyapp] Generated .uglyapp for ${projectName}`);
-    printPortTable(portStart);
     console.log('Edit .uglyapp to change portStart if running multiple projects simultaneously.');
     const envFilePath = path.join(destDir, '.env');
     await runUglyBotSetup(projectId, envFilePath);

package/dist/cli/scaffold.js.map

@@ -1 +1 @@
-{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../../src/cli/scaffold.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../../src/cli/scaffold.ts"],"names":[],"mappings":"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"}

package/dist/client/callAI.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"callAI.d.ts","sourceRoot":"","sources":["../../src/client/callAI.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,YAAY,EACb,MAAM,oBAAoB,CAAC;AAsB5B,eAAO,MAAM,WAAW,GAAI,OAAO,YAAY,KAAG,OAAO,CAAC,MAAM,CACZ,CAAC;AAErD,eAAO,MAAM,WAAW,GAAI,CAAC,GAAG,OAAO,EAAE,OAAO,YAAY,KAAG,OAAO,CAAC,CAAC,CACzB,CAAC;AAEhD,eAAO,MAAM,YAAY,GAAI,OAAO,aAAa,KAAG,OAAO,CAAC,MAAM,CACb,CAAC"}
+{"version":3,"file":"callAI.d.ts","sourceRoot":"","sources":["../../src/client/callAI.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,YAAY,EACb,MAAM,oBAAoB,CAAC;AA0B5B,eAAO,MAAM,WAAW,GAAI,OAAO,YAAY,KAAG,OAAO,CAAC,MAAM,CACZ,CAAC;AAErD,eAAO,MAAM,WAAW,GAAI,CAAC,GAAG,OAAO,EAAE,OAAO,YAAY,KAAG,OAAO,CAAC,CAAC,CACzB,CAAC;AAEhD,eAAO,MAAM,YAAY,GAAI,OAAO,aAAa,KAAG,OAAO,CAAC,MAAM,CACb,CAAC"}

package/dist/client/callAI.js

@@ -15,7 +15,13 @@ async function callViaServer(op, input) {
         const body = await res.text().catch(() => '');
         throw new Error(`${res.status}: ${body}`);
     }
-    return (await res.json()).result;
+    const json = (await res.json());
+    console.log('[callAI]', op, json);
+    if (json.error)
+        throw new Error(json.error);
+    if (json.result === undefined)
+        throw new Error('AI request returned no result');
+    return json.result;
 }
 export const callTextGen = (input) => callViaServer('textGen', input);
 export const callJsonGen = (input) => callViaServer('jsonGen', input);

package/dist/client/callAI.js.map

@@ -1 +1 @@
-{"version":3,"file":"callAI.js","sourceRoot":"","sources":["../../src/client/callAI.ts"],"names":[],"mappings":"AAMA,2EAA2E;AAC3E,+CAA+C;AAC/C,KAAK,UAAU,aAAa,CAAC,EAAU,EAAE,KAAc;IACrD,MAAM,KAAK,GAAI,MAAiD;SAC7D,cAAc,CAAC;IAClB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,aAAa,EAAE;QACrC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,KAAK,IAAI,EAAE,EAAE;YACtC,cAAc,EAAE,kBAAkB;SACnC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;KACzD,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,OAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAyB,CAAC,MAAM,CAAC;AAC5D,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAmB,EAAmB,EAAE,CAClE,aAAa,CAAC,SAAS,EAAE,KAAK,CAAoB,CAAC;AAErD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAc,KAAmB,EAAc,EAAE,CAC1E,aAAa,CAAC,SAAS,EAAE,KAAK,CAAe,CAAC;AAEhD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAoB,EAAmB,EAAE,CACpE,aAAa,CAAC,UAAU,EAAE,KAAK,CAAoB,CAAC"}
+{"version":3,"file":"callAI.js","sourceRoot":"","sources":["../../src/client/callAI.ts"],"names":[],"mappings":"AAMA,2EAA2E;AAC3E,+CAA+C;AAC/C,KAAK,UAAU,aAAa,CAAC,EAAU,EAAE,KAAc;IACrD,MAAM,KAAK,GAAI,MAAiD;SAC7D,cAAc,CAAC;IAClB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,aAAa,EAAE;QACrC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,KAAK,IAAI,EAAE,EAAE;YACtC,cAAc,EAAE,kBAAkB;SACnC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;KACzD,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAyC,CAAC;IACxE,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IAClC,IAAI,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5C,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAChF,OAAO,IAAI,CAAC,MAAM,CAAC;AACrB,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAmB,EAAmB,EAAE,CAClE,aAAa,CAAC,SAAS,EAAE,KAAK,CAAoB,CAAC;AAErD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAc,KAAmB,EAAc,EAAE,CAC1E,aAAa,CAAC,SAAS,EAAE,KAAK,CAAe,CAAC;AAEhD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAoB,EAAmB,EAAE,CACpE,aAAa,CAAC,UAAU,EAAE,KAAK,CAAoB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ugly-app",
-  "version": "0.1.42",
+  "version": "0.1.44",
   "type": "module",
   "main": "./dist/server/index.js",
   "exports": {

package/templates/client/pages/AITestPage.tsx

@@ -11,7 +11,7 @@ import type { ImageGenModel, TextGenModel } from 'ugly-app/shared';
 import { imageGenModels, textGenModels } from 'ugly-app/shared';
 
 type Mode = 'text' | 'image';
-type LogEntry = { ts: number; msg: string; kind: 'info' | 'ok' | 'err' };
+interface LogEntry { ts: number; msg: string; kind: 'info' | 'ok' | 'err' }
 
 function fmt(ms: number): string {
   return ms < 1000 ? `${ms}ms` : `${(ms / 1000).toFixed(1)}s`;
@@ -52,8 +52,8 @@ export default function AITestPage(): React.ReactElement {
           messages: [{ role: 'user', content: prompt }],
         });
         const elapsed = Date.now() - started;
-        addLog(`Done in ${fmt(elapsed)} — ${text.length} chars`, 'ok');
-        setResult(text);
+        addLog(`Done in ${fmt(elapsed)} — ${text?.length ?? 0} chars`, 'ok');
+        setResult(text ?? '');
       } else {
         const url = await callImageGen({ model: imageModel, prompt });
         const elapsed = Date.now() - started;