ugly-app 0.1.78 → 0.1.80

package/README.md

@@ -8,8 +8,7 @@ A full-stack TypeScript framework for building production-ready web applications
 - **Client**: React + Vite with typed routing, lazy pages, and popup management
 - **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, Kie) + image generation (Together, FAL, Google, Wavespeed, Kie) + embeddings + STT/TTS
-- **Analytics**: EventCounter (high-throughput counters), EventLog (event capture), A/B experiments
+- **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
 
@@ -32,22 +31,16 @@ Entry point for the server. Creates an Express + WebSocket server with typed RPC
 ```typescript
 import {
   createApp,
-  createImageGen,
-  createTextGen,
   createUserHelper,
-  eventLogCapture,
-  eventLogServerCapture,
   getFeedbackHandlers,
-  getExperimentAssignments,
   type AppConfigurator,
   type RequestHandlers,
 } from 'ugly-app';
 import { dbDefaults } from 'ugly-app/shared';
 import { requests } from '../shared/api';
-import type { User } from '../shared/collections';
 import { collections } from '../shared/collections';
-import { experiments } from '../shared/experiments';
 import { pages } from '../shared/pages';
+import type { User } from '../shared/collections';
 
 const userHelper = createUserHelper<User>(collections.user);
 const maintainBotUserId = process.env.MAINTAIN_BOT_USER_ID ?? '';
@@ -56,38 +49,10 @@ const app = createApp(
   { requests },
   {
     ...getFeedbackHandlers(maintainBotUserId),
-
     getMe: async (userId: string) => {
       const user = await userHelper.get(app.db, userId);
       return { userId, email: user?.email, phone: user?.phone };
     },
-
-    // Experiment bucketing + session start event
-    initSession: async (userId, { sessionId }) => {
-      const branches = getExperimentAssignments(userId, sessionId, experiments);
-      await eventLogServerCapture('SESSION_START', {}, sessionId, userId, branches);
-      return { branches };
-    },
-
-    // Generic event capture with experiment branch tagging
-    captureEvent: async (userId, { eventName, sessionId, properties }) => {
-      const branches = getExperimentAssignments(userId, sessionId, experiments);
-      const { eventId } = await eventLogCapture(
-        { eventName, sessionId, userId, properties: properties ?? {}, experimentBranches: branches },
-        userId,
-      );
-      return { eventId };
-    },
-
-    textGen: async (userId, { model, messages }) => {
-      const text = await createTextGen(userId).generate(messages, { model });
-      return { text };
-    },
-
-    imageGen: async (userId, { model, prompt }) => {
-      const url = await createImageGen(userId).generate(prompt, { model });
-      return { url };
-    },
   } satisfies RequestHandlers<typeof requests>,
   collections,
   (configurator: AppConfigurator) => {
@@ -672,16 +637,14 @@ Run `npm run db:init` to create/update indexes.
 ### Text generation
 
 ```typescript
-import { createTextGen } from 'ugly-app';
-const textGen = createTextGen(userId);
+import { createTextGenClient } from 'ugly-app';
+const textGen = createTextGenClient();
 
 const text   = await textGen.generate(messages);
 const json   = await textGen.generateJson(schema, messages);   // Zod schema, retries on parse failure
 const result = await textGen.generateWithTools(messages, tools); // automatic tool-call loop
 ```
 
-`createTextGen(userId, defaults?)` creates a client scoped to a user (for rate limiting and billing). Optional `defaults` set provider, model, temperature, etc.
-
 | Provider | `provider` value | Default model | JSON | Tools | Vision |
 |----------|-----------------|---------------|------|-------|--------|
 | Together AI | `'together'` | Llama-4-Maverick-17B-128E | yes | yes | yes |
@@ -697,14 +660,12 @@ Use `provider: 'auto'` (default) to let the system pick based on requirements.
 ### Image generation
 
 ```typescript
-import { createImageGen } from 'ugly-app';
-const imageGen = createImageGen(userId);
+import { createImageGenClient } from 'ugly-app';
+const imageGen = createImageGenClient();
 
 const url = await imageGen.generate(prompt, { width: 1024, height: 1024 });
 ```
 
-`createImageGen(userId, defaults?)` works the same way — user-scoped with optional defaults.
-
 | Provider | `provider` value |
 |----------|-----------------|
 | Together AI (FLUX schnell) | `'together'` |
@@ -885,104 +846,6 @@ submitFeedback: authReq({
 
 The framework enforces rate limits automatically before calling the handler.
 
-### EventCounter
-
-High-throughput counters aggregated into hourly buckets in MongoDB. Increments are instant (in-memory) and flushed every 60 seconds.
-
-```typescript
-import {
-  eventCounterIncrement,
-  startEventCounterFlush,
-  flushCountersToMongo,
-  eventCounterGetCounts,
-  eventCounterGetTopTypes,
-} from 'ugly-app';
-
-// Increment a counter (instant, no DB write)
-eventCounterIncrement('api_getMe');
-
-// Start periodic flush — call once at server startup
-startEventCounterFlush();
-
-// Manually flush (e.g. on graceful shutdown)
-await flushCountersToMongo();
-
-// Query counts (admin only)
-const { counts } = await eventCounterGetCounts(
-  { granularity: 'hours', intervals: 24, category: 'api' },
-  isAdmin,
-);
-
-// Query top counter types (admin only)
-const { types } = await eventCounterGetTopTypes(
-  { limit: 10, category: 'api' },
-  isAdmin,
-);
-```
-
-Counter type names use a `category_name` convention (e.g. `api_getMe`, `ai_textGen`). Data is auto-expired after 30 days via MongoDB TTL.
-
-### EventLog
-
-Structured event capture for analytics. Events are stored in MongoDB with session, user, and experiment branch associations.
-
-```typescript
-import { eventLogCapture, eventLogServerCapture } from 'ugly-app';
-
-// Capture an event (returns eventId)
-const { eventId } = await eventLogCapture(
-  {
-    eventName: 'BUTTON_CLICK',
-    sessionId,
-    userId,
-    properties: { page: 'home', target: 'cta' },
-    experimentBranches: branches,
-  },
-  userId,
-);
-
-// Server-side shorthand (fire-and-forget, no eventId returned)
-await eventLogServerCapture('SESSION_START', { source: 'web' }, sessionId, userId, branches);
-```
-
-Admin query functions: `eventLogGetList`, `eventLogGetCounts`, `eventLogGetTopEvents`, `eventLogGetTopUsers`, `eventLogGetTopSessions`, `eventLogGetUniqueUsersCounts`, `eventLogGetUniqueSessionsCounts`.
-
-### Experiments (A/B testing)
-
-Define experiments in `shared/experiments.ts` and use deterministic bucketing to assign users to branches.
-
-```typescript
-// shared/experiments.ts
-import type { Experiment } from 'ugly-app/shared';
-
-export const experiments: Experiment[] = [
-  {
-    id: 'onboarding-v2',
-    name: 'Onboarding V2',
-    description: 'Test new onboarding flow',
-    branches: [
-      { id: 'control', name: 'Control', weight: 1 },
-      { id: 'variant', name: 'Variant', weight: 1 },
-    ],
-    events: ['ONBOARDING_COMPLETE', 'SIGNUP'],
-    active: true,
-  },
-];
-```
-
-```typescript
-// Server-side assignment
-import { getExperimentAssignments, getExperimentBranch } from 'ugly-app';
-
-// Get all branch assignments for a user/session (deterministic hash)
-const branches = getExperimentAssignments(userId, sessionId, experiments);
-
-// Get a single experiment branch
-const branch = getExperimentBranch(userId, sessionId, experiment);
-```
-
-Shared helpers: `getActiveExperiments`, `getExperimentById`, `getExperimentBranch`, `getExperimentAssignments`. Server admin: `experimentGetMetrics` for per-branch analytics.
-
 ---
 
 ## Built-in endpoints