ugly-app 0.1.43 → 0.1.45

package/README.md

@@ -33,41 +33,39 @@ import {
   createApp,
   createUserHelper,
   getFeedbackHandlers,
-  type CallHandlers,
+  type AppConfigurator,
   type RequestHandlers,
-  type HandlerContext,
 } from 'ugly-app';
 import { dbDefaults } from 'ugly-app/shared';
-import { functions, requests } from '../shared/api';
+import { requests } from '../shared/api';
 import { collections } from '../shared/collections';
 import { pages } from '../shared/pages';
-import type { User } from '../shared/types';
+import type { User } from '../shared/collections';
 
 const userHelper = createUserHelper<User>(collections.user);
-
-const calls = {
-  ...getFeedbackHandlers(maintainBotUserId),
-  myFunction: async (ctx: HandlerContext, input) => {
-    return { greeting: `Hello, ${input.name}` };
-  },
-} satisfies CallHandlers<typeof functions>;
-
-const reqs = {
-  getMe: async (ctx: HandlerContext) => {
-    const user = await userHelper.get(ctx.db, ctx.userId);
-    return { userId: ctx.userId, email: user?.email };
+const maintainBotUserId = process.env.MAINTAIN_BOT_USER_ID ?? '';
+
+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 };
+    },
+  } satisfies RequestHandlers<typeof requests>,
+  collections,
+  (configurator: AppConfigurator) => {
+    configurator.setPages({ pages });
+    configurator.setUserHelper(userHelper);
+    configurator.setOnUserCreate(async (userId, info, db) => {
+      await userHelper.set(db, { id: userId, ...dbDefaults(), ...info });
+    });
   },
-} satisfies RequestHandlers<typeof requests>;
-
-const app = createApp({ functions, requests }, calls, reqs, collections, (configurator) => {
-  configurator.setPages({ pages });
-  configurator.setUserHelper(userHelper);
-  configurator.setOnUserCreate(async (userId, info, db) => {
-    await userHelper.set(db, { id: userId, ...dbDefaults(), ...info });
-  });
-});
+);
 
-await app.start(3000);
+const port = parseInt(process.env['PORT'] ?? '3000');
+await app.start(port);
 ```
 
 **Signature:**
@@ -75,7 +73,6 @@ await app.start(3000);
 ```typescript
 function createApp<R extends AppRegistryBase, Defs extends CollectionDefRegistry>(
   registry: R,
-  calls: Partial<CallHandlers<R['functions']>>,
   requests: Partial<RequestHandlers<R['requests']>>,
   appDefs: Defs,
   configure?: (configurator: AppConfigurator) => void,
@@ -86,7 +83,8 @@ The returned `App` object has:
 - `start(port?)` — starts the server (default port 3000)
 - `registerRoutes(fn)` — mount additional Express routes after creation
 - `httpServer` — the underlying Node.js HTTP server
-- `dispatch(type, name, input, userId)` — invoke an RPC handler programmatically
+- `db` — the `TypedDB` instance for direct database access
+- `dispatch(name, input, userId)` — invoke an RPC handler programmatically
 
 ### `AppConfigurator`
 
@@ -96,24 +94,23 @@ The returned `App` object has:
 | `setUserHelper(helper)` | User lookup for WebSocket auth handshake |
 | `setOnUserCreate(handler)` | Called on first login — must create the user record. `(userId, { email?, phone? }, db) => Promise<void>` |
 | `setAuth(provider)` | Custom `AuthProvider` (default: ugly.bot OAuth). Provider must implement `verify(code)` and `authUrl(origin)` |
-| `setContextExtensions(fn)` | Add fields to `HandlerContext` — `(base: HandlerContext) => Promise<E>` |
 | `setOnSocketMessage(handler)` | Handle raw WebSocket messages. Return `true` to consume, `false` to let the framework handle it |
 | `registerRoutes(fn)` | Mount custom Express routes — `(router: express.Router) => void` |
 | `setWorkerQueue(queue)` | Register a background worker queue with `start()` and `stop()` |
 
-### Handler context (`ctx`)
+### Handler signatures
+
+Handlers are plain async functions — no context object, just `userId` and `input`:
 
-Every RPC handler receives a `HandlerContext`:
+```typescript
+// req() — public, userId may be null
+getPublicData: async (userId: string | null, input) => { ... }
+
+// authReq() — authenticated, 401 auto-enforced, userId always a string
+getMe: async (userId: string, input) => { ... }
+```
 
-| Field | Type | Description |
-|-------|------|-------------|
-| `ctx.userId` | `string` | Authenticated user ID (always set) |
-| `ctx.db` | `TypedDB` | MongoDB client with typed collection methods |
-| `ctx.storage` | `StorageClient` | R2/S3 presigned uploads and public URLs |
-| `ctx.textGen` | `TextGenClient` | Text generation (see AI section) |
-| `ctx.imageGen` | `ImageGenClient` | Image generation |
-| `ctx.log` | `Logger` | Structured logging to MongoDB |
-| `ctx.rateLimit` | `RateLimiter` | Token-bucket rate limiting |
+Access `app.db`, storage, and AI clients directly via imports or the `app` object — they are not injected into handlers.
 
 ---
 
@@ -121,31 +118,40 @@ Every RPC handler receives a `HandlerContext`:
 
 All type definitions live in `shared/` and are used by both server and client.
 
-### Functions and requests (`shared/api.ts`)
+### Requests (`shared/api.ts`)
 
 ```typescript
-import { defineFunctions, defineRequests, fn, req, z } from 'ugly-app/shared';
+import { authReq, defineRequests, req, z } from 'ugly-app/shared';
 
-export const functions = defineFunctions({
-  createNote: fn({
-    input: z.object({ title: z.string(), body: z.string() }),
-    output: z.object({ id: z.string() }),
+export const requests = defineRequests({
+  // Public request — handler receives (userId: string | null, input)
+  getPublicData: req({
+    input: z.object({ id: z.string() }),
+    output: z.object({ data: z.string() }),
   }),
-});
 
-export const requests = defineRequests({
-  getNotes: req({
+  // Authenticated request — handler receives (userId: string, input)
+  getMe: authReq({
     input: z.object({}),
-    output: z.array(z.object({ id: z.string(), title: z.string() })),
+    output: z.object({ userId: z.string(), email: z.string().optional() }),
+  }),
+
+  // With rate limiting
+  submitFeedback: authReq({
+    input: z.object({ type: z.enum(['bug', 'design', 'feature']), message: z.string() }),
+    output: z.object({ id: z.string() }),
+    rateLimit: { max: 20, window: 60 },
   }),
 });
 ```
 
-- `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. `defineCalls` is an alias for `defineFunctions`.
+- `req({ input, output })` — defines a public request. Handler signature: `(userId: string | null, input: I) => Promise<O>`.
+- `authReq({ input, output })` — defines an authenticated request. Handler signature: `(userId: string, input: I) => Promise<O>`. Returns 401 automatically if no token.
+- `defineRequests()` — identity wrapper that preserves types.
 - `z` is re-exported from Zod for convenience.
 
+Every endpoint is accessible via both WebSocket (`socket.request(name, input)`) and HTTP (`POST /api/:name { input }`).
+
 ### Collections (`shared/collections.ts`)
 
 ```typescript
@@ -203,11 +209,11 @@ export type AppPages = typeof pages;
 ```tsx
 import { createRoot } from 'react-dom/client';
 import { AppProvider, createSocket, LoginPopup } from 'ugly-app/client';
-import { functions, requests } from '../shared/api';
+import { requests } from '../shared/api';
 import { RouterProvider } from './router';
 import App from './App';
 
-const token = (window as any).__AUTH_TOKEN__;
+const token = (window as unknown as { __AUTH_TOKEN__?: string }).__AUTH_TOKEN__;
 const root = createRoot(document.getElementById('root')!);
 const loginPopup = <LoginPopup onSuccess={() => window.location.reload()} />;
 
@@ -219,7 +225,7 @@ if (!token) {
   );
 } else {
   const userId = JSON.parse(atob(token.split('.')[1]!)).sub as string;
-  const socket = createSocket({ functions, requests, url: '/rpc' });
+  const socket = createSocket({ requests, url: '/rpc' });
   socket.connect(token).then((user) => {
     root.render(
       <RouterProvider fallback={<div>404</div>} loginFallback={loginPopup} isAuthenticated={() => true}>
@@ -237,7 +243,7 @@ if (!token) {
 Creates a typed WebSocket client for RPC communication.
 
 ```typescript
-const socket = createSocket({ functions, requests, url: '/rpc' });
+const socket = createSocket({ requests, url: '/rpc' });
 await socket.connect(token); // returns UserBase
 ```
 
@@ -246,14 +252,30 @@ await socket.connect(token); // returns UserBase
 | Method | Description |
 |--------|-------------|
 | `connect(token)` | Authenticate and connect. Returns the user object |
-| `call(name, input)` | Invoke a function (mutation) |
-| `request(name, input)` | Invoke a request (query) |
+| `request(name, input)` | Invoke a request (query or mutation) |
 | `getDoc(collection, id)` | Fetch a single document |
 | `trackDoc(collection, id, cb)` | Subscribe to real-time doc changes. Returns unsubscribe fn |
 | `trackDocs(collection, filter, cb, opts?)` | Subscribe to query results. Returns unsubscribe fn |
 | `uploadFile(file, key)` | Upload a file via presigned URL |
 | `disconnect()` | Close the connection |
 
+### `createHttpClient()`
+
+Creates a typed HTTP client for RPC communication (no WebSocket needed).
+
+```typescript
+import { createHttpClient } from 'ugly-app/client';
+
+const client = createHttpClient({ requests, token: 'eyJ...', baseUrl: '' });
+const result = await client.request('getMe', {});
+```
+
+| Option | Description |
+|--------|-------------|
+| `requests` | The requests registry from `shared/api.ts` |
+| `token?` | Bearer token for authenticated requests |
+| `baseUrl?` | URL prefix (default: `''` — relative paths: `POST /api/:name`) |
+
 ### `AppProvider`
 
 Wraps your app with context for `useApp()`. Provides user info, socket access, popup management, async loading overlay, splash screen, and localization.
@@ -303,7 +325,7 @@ export const { RouterProvider, RouterView, useRouter } = createRouter({ pages, a
 
 `createRouter()` returns three things:
 - **`RouterProvider`** — wrap your app. Props: `children`, `fallback?` (shown before first route resolves), `loginFallback?` (shown for auth-guarded pages when unauthenticated), `isAuthenticated?` (function returning boolean)
-- **`RouterView`** — renders the active page with animated transitions. Props: `durationMs?`, `easing?`, `transitionComponent?`
+- **`RouterView`** — renders the active page with animated transitions. Props: `durationMs?`, `easing?`, `transitionComponent?`, `renderPage?`
 - **`useRouter()`** — hook returning the router context
 
 #### Page map (`client/allPages.ts`)
@@ -390,6 +412,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
@@ -436,57 +501,59 @@ configurator.setAuth({
 
 ## Database (`TypedDB`)
 
+Access via `app.db` or by importing `createTypedDB` / `getMongoClient` from `'ugly-app'`.
+
 ### Writing
 
 ```typescript
 // Insert or replace a document
-await ctx.db.setDoc(collections.note, doc);
-await ctx.db.setDoc(collections.note, doc, { skipIfExists: true });
+await db.setDoc(collections.note, doc);
+await db.setDoc(collections.note, doc, { skipIfExists: true });
 
 // Partial update — only specified fields (supports dot-notation paths)
-await ctx.db.setDocFields(collections.note, id, { title: 'New title' });
+await db.setDocFields(collections.note, id, { title: 'New title' });
 
 // Partial update — returns null if document doesn't exist (no error)
-const doc = await ctx.db.setDocFieldsOrIgnore(collections.note, id, { title });
+const doc = await db.setDocFieldsOrIgnore(collections.note, id, { title });
 
 // Partial update — creates the document if it doesn't exist (obj = default doc for insert)
-await ctx.db.setDocFieldsOrCreate(collections.note, id, { title }, defaultDoc);
+await db.setDocFieldsOrCreate(collections.note, id, { title }, defaultDoc);
 
 // MongoDB update operators ($inc, $addToSet, $pull, $unset, $set)
-await ctx.db.setDocOp(collections.note, id, { $inc: { views: 1 } });
-await ctx.db.setDocOpOrIgnore(collections.note, id, { $inc: { views: 1 } }); // no error if missing
+await db.setDocOp(collections.note, id, { $inc: { views: 1 } });
+await db.setDocOpOrIgnore(collections.note, id, { $inc: { views: 1 } }); // no error if missing
 ```
 
 ### Reading
 
 ```typescript
-const note  = await ctx.db.getDoc(collections.note, id);
-const notes = await ctx.db.getDocs(collections.note, { userId }, { sort: { created: -1 }, limit: 20 });
+const note  = await db.getDoc(collections.note, id);
+const notes = await db.getDocs(collections.note, { userId }, { sort: { created: -1 }, limit: 20 });
 
 // Aggregation pipeline
-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);
+const results = await db.getQuery<MyResult>('note', pipeline, { skip, limit });
+const count   = await db.getQueryCount('note', pipeline);
+const raw     = await 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);
+const doc  = await db.rawGetDoc(collectionName, id);
+const docs = await db.rawGetDocs(collectionName, filter);
 ```
 
 ### Deleting
 
 ```typescript
-await ctx.db.deleteDoc(collections.note, id);        // single doc (cascades via parent)
-await ctx.db.deleteQuery(collections.note, { userId }); // bulk delete by filter
+await db.deleteDoc(collections.note, id);        // single doc (cascades via parent)
+await db.deleteQuery(collections.note, { userId }); // bulk delete by filter
 ```
 
 ### Caching
 
 ```typescript
-const cached = await ctx.db.cacheGet<MyType>(key);
-await ctx.db.cacheSet(key, value, ttlMs);
-await ctx.db.cacheDelete(key);
-const key = ctx.db.cacheKey('prefix', id); // generate a cache key
+const cached = db.cacheGet<MyType>(key);
+db.cacheSet(key, value, ttlMs);
+db.cacheDelete(key);
+const key = db.cacheKey('prefix', id); // generate a cache key
 ```
 
 ### Helpers
@@ -511,15 +578,21 @@ await userHelper.set(db, { id: userId, ...dbDefaults(), email });
 import { defineDbIndexes } from 'ugly-app/shared';
 
 export const dbIndexes = defineDbIndexes({
-  note: [
-    { key: { userId: 1, created: -1 } },
-    { key: { title: 'text' }, type: 'search' },
-  ],
+  note: {
+    indexes: [
+      { fields: { userId: 1, created: -1 } },
+      { fields: { title: 1 }, unique: true },
+    ],
+    searchIndexes: [
+      { name: 'note_search', fields: { title: 'string', body: 'string' } },
+    ],
+    vectorIndexes: [
+      { name: 'note_embedding', field: 'embedding', dimensions: 1536, similarity: 'cosine' },
+    ],
+  },
 });
 ```
 
-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.
 
 ---
@@ -529,10 +602,12 @@ Run `npm run db:init` to create/update indexes.
 ### Text generation
 
 ```typescript
-// In a handler via ctx.textGen:
-const text   = await ctx.textGen.generate(messages);
-const json   = await ctx.textGen.generateJson(schema, messages);   // Zod schema, retries on parse failure
-const result = await ctx.textGen.generateWithTools(messages, tools); // automatic tool-call loop
+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
 ```
 
 | Provider | `provider` value | JSON | Tools | Vision |
@@ -546,17 +621,13 @@ const result = await ctx.textGen.generateWithTools(messages, tools); // automati
 
 Use `provider: 'auto'` (default) to let the system pick based on requirements.
 
-**Standalone client (outside handlers):**
-
-```typescript
-import { createTextGenClient } from 'ugly-app';
-const textGen = createTextGenClient();
-```
-
 ### Image generation
 
 ```typescript
-const url = await ctx.imageGen.generate(prompt, { width: 1024, height: 1024 });
+import { createImageGenClient } from 'ugly-app';
+const imageGen = createImageGenClient();
+
+const url = await imageGen.generate(prompt, { width: 1024, height: 1024 });
 ```
 
 | Provider | `provider` value |
@@ -566,13 +637,6 @@ const url = await ctx.imageGen.generate(prompt, { width: 1024, height: 1024 });
 | Google (Imagen 3) | `'google'` |
 | Wavespeed | `'wavespeed'` |
 
-**Standalone client:**
-
-```typescript
-import { createImageGenClient } from 'ugly-app';
-const imageGen = createImageGenClient();
-```
-
 ### Embeddings
 
 ```typescript
@@ -609,9 +673,9 @@ The client can call AI through the server proxy without managing tokens directly
 ```typescript
 import { callTextGen, callJsonGen, callImageGen } from 'ugly-app/client';
 
-const text  = await callTextGen(messages, options);
-const json  = await callJsonGen(schema, messages);
-const image = await callImageGen(prompt, options);
+const text  = await callTextGen(input);
+const json  = await callJsonGen(input);
+const image = await callImageGen(input);
 ```
 
 These call `POST /ai/request` (same-origin, avoids CORS). The server verifies the user JWT and forwards to `https://ugly.bot` using the `UGLY_BOT_TOKEN` env var.
@@ -722,11 +786,18 @@ Server-side, `getFeedbackHandlers(maintainBotUserId)` provides the RPC handlers
 
 ### Rate limiting
 
+Rate limiting is configured per-endpoint in the request definition:
+
 ```typescript
-// Inside a handler — always call before expensive operations
-await ctx.rateLimit.check();
+submitFeedback: authReq({
+  input: z.object({ ... }),
+  output: z.object({ ... }),
+  rateLimit: { max: 20, window: 60 },  // 20 requests per 60 seconds
+})
 ```
 
+The framework enforces rate limits automatically before calling the handler.
+
 ---
 
 ## Built-in endpoints
@@ -738,8 +809,10 @@ await ctx.rateLimit.check();
 | `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 /api/:name` | RPC endpoint — dispatches any registered request handler |
 | `POST /ai/request` | AI proxy — forwards to ugly.bot (requires auth) |
 | `POST /api/client-error` | Client-side error capture |
+| `POST /logs/client` | Client-side log ingestion |
 | `GET /my_feedback` | User feedback history (markdown, requires auth) |
 
 ---
@@ -788,7 +861,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) |
+| `JWT_EXPIRY_SECONDS` | Token lifetime (optional, default: 2592000 = 30 days) |
 | `MONGODB_URI` | MongoDB connection string |
 | `PORT` | Server port (default: 3000) |
 | `NODE_ENV` | `development` or `production` |
@@ -816,3 +889,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/initDb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"initDb.d.ts","sourceRoot":"","sources":["../../src/cli/initDb.ts"],"names":[],"mappings":"AAgCA,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAiG/C"}
+{"version":3,"file":"initDb.d.ts","sourceRoot":"","sources":["../../src/cli/initDb.ts"],"names":[],"mappings":"AAuCA,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CA6H/C"}

package/dist/cli/initDb.js

@@ -16,7 +16,14 @@ async function loadDbIndexes() {
 // Built-in indexes always applied
 const BUILTIN_INDEXES = {
     user: { indexes: [{ fields: { email: 1 }, unique: true }] },
-    errorLog: { indexes: [{ fields: { created: 1 }, ttl: 7 * 86400 }] },
+    errorLog: {
+        timeseries: {
+            timeField: 'created',
+            metaField: 'meta',
+            granularity: 'seconds',
+            expireAfterSeconds: 7 * 24 * 60 * 60, // 7 days
+        },
+    },
     consoleLog: { indexes: [{ fields: { created: 1 }, ttl: 7 * 86400 }] },
     perfLog: { indexes: [{ fields: { created: 1 }, ttl: 7 * 86400 }] },
     feedbackLog: { indexes: [{ fields: { created: 1 }, ttl: 7 * 86400 }] },
@@ -38,6 +45,31 @@ export async function runInitDb() {
         }
         for (const [collection, config] of Object.entries(allIndexes)) {
             const col = db.collection(collection);
+            if (config.timeseries) {
+                try {
+                    await db.createCollection(collection, {
+                        timeseries: {
+                            timeField: config.timeseries.timeField,
+                            ...(config.timeseries.metaField
+                                ? { metaField: config.timeseries.metaField }
+                                : {}),
+                            ...(config.timeseries.granularity
+                                ? { granularity: config.timeseries.granularity }
+                                : {}),
+                        },
+                        ...(config.timeseries.expireAfterSeconds !== undefined
+                            ? { expireAfterSeconds: config.timeseries.expireAfterSeconds }
+                            : {}),
+                    });
+                    console.log(`[init-db] Time-series collection created: ${collection}`);
+                }
+                catch (e) {
+                    const err = e;
+                    if (err.code !== 48)
+                        throw e; // 48 = NamespaceExists (already exists)
+                    console.log(`[init-db] Time-series collection already exists: ${collection}`);
+                }
+            }
             for (const idx of config.indexes ?? []) {
                 const opts = {};
                 if (idx.unique)

package/dist/cli/initDb.js.map

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

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

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/cli/scaffold.ts"],"names":[],"mappings":"AA6GA,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4DxE"}