ugly-app 0.1.0

package/dist/server/Auth.js

@@ -0,0 +1,171 @@
+import express from 'express';
+import { SignJWT, jwtVerify } from 'jose';
+import { nanoid } from 'nanoid';
+import { BUILTIN_DEFS, dbDefaults } from '../shared/DB.js';
+import { AuthError } from '../shared/Errors.js';
+import { writeClientLogEntry } from './Logging.js';
+function getJwtSecret() {
+    const secret = process.env.JWT_SECRET;
+    if (!secret)
+        throw new Error('[Auth] JWT_SECRET env var is required');
+    return new TextEncoder().encode(secret);
+}
+export function getExpirySeconds() {
+    const raw = process.env.JWT_EXPIRY_SECONDS ?? '2592000';
+    const seconds = parseInt(raw, 10);
+    if (!Number.isInteger(seconds) || seconds <= 0) {
+        throw new Error(`[Auth] JWT_EXPIRY_SECONDS must be a positive integer, got "${raw}"`);
+    }
+    return seconds;
+}
+export async function signToken(userId) {
+    return new SignJWT({ sub: userId })
+        .setProtectedHeader({ alg: 'HS256' })
+        .setExpirationTime(`${getExpirySeconds()}s`)
+        .setIssuedAt()
+        .sign(getJwtSecret());
+}
+export async function verifyToken(token) {
+    const { payload } = await jwtVerify(token, getJwtSecret());
+    if (!payload.sub)
+        throw new AuthError('Invalid token');
+    return payload.sub;
+}
+export const uglyBotAuthProvider = {
+    authUrl: (origin) => `https://ugly.bot/oauth?origin=${encodeURIComponent(origin)}`,
+    verify: async (code) => {
+        const response = await fetch(`https://ugly.bot/oauth/verify?code=${encodeURIComponent(code)}`);
+        if (!response.ok) {
+            const err = new Error('[Auth] ugly.bot OAuth verify failed');
+            console.error('[Auth] ugly.bot OAuth verify failed', {
+                status: response.status,
+            });
+            throw err;
+        }
+        const data = (await response.json());
+        return {
+            userId: data.user_id,
+            email: data.email,
+            phone: data.phone,
+        };
+    },
+};
+export function createAuthRoutes(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+db, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+userHelper, onUserCreate, provider = uglyBotAuthProvider) {
+    const router = express.Router();
+    // POST /auth/verify — client sends OAuth code, server verifies and returns JWT
+    router.post('/auth/verify', async (req, res) => {
+        try {
+            const { code } = req.body;
+            if (!code) {
+                res.status(400).json({ error: 'Missing code' });
+                return;
+            }
+            const { userId, email, phone } = await provider.verify(code);
+            // Find or create user — app is responsible for the full user record
+            const existing = await userHelper.get(db, userId);
+            if (!existing) {
+                await onUserCreate(userId, { email, phone }, db);
+            }
+            const token = await signToken(userId);
+            res.cookie('auth_token', token, {
+                httpOnly: true,
+                secure: process.env.NODE_ENV === 'production',
+                sameSite: 'lax',
+                maxAge: getExpirySeconds() * 1000,
+                path: '/',
+            });
+            res.json({ token });
+        }
+        catch (err) {
+            console.error('[Auth] OAuth verify failed', err);
+            res.status(401).json({ error: 'Authentication failed' });
+        }
+    });
+    // GET /auth/token — exchange a valid auth_token cookie for a fresh JWT
+    router.get('/auth/token', async (req, res) => {
+        const token = req.cookies?.auth_token;
+        if (!token) {
+            res.status(401).json({ error: 'No session' });
+            return;
+        }
+        try {
+            const userId = await verifyToken(token);
+            const fresh = await signToken(userId);
+            res.cookie('auth_token', fresh, {
+                httpOnly: true,
+                secure: process.env.NODE_ENV === 'production',
+                sameSite: 'lax',
+                maxAge: getExpirySeconds() * 1000,
+                path: '/',
+            });
+            res.json({ token: fresh });
+        }
+        catch {
+            res.clearCookie('auth_token');
+            res.status(401).json({ error: 'Session expired' });
+        }
+    });
+    // POST /auth/logout — clears the auth cookie
+    router.post('/auth/logout', (_req, res) => {
+        res.clearCookie('auth_token', { path: '/' });
+        res.json({ ok: true });
+    });
+    // GET /auth/url — returns the auth popup URL for this origin
+    router.get('/auth/url', (req, res) => {
+        const origin = req.query['origin'];
+        if (!origin) {
+            res.status(400).json({ error: 'Missing origin' });
+            return;
+        }
+        res.json({ url: provider.authUrl(origin) });
+    });
+    const MAX_LOG_ENTRIES = 100;
+    const MAX_FIELD_LENGTH = 10_000; // ~10 KB per field — rejects BASE64 blobs
+    // POST /logs/client — client-side error log ingestion
+    router.post('/logs/client', async (req, res) => {
+        try {
+            const { entries } = req.body;
+            if (Array.isArray(entries) && entries.length > MAX_LOG_ENTRIES) {
+                res.status(400).json({ error: 'Too many log entries' });
+                return;
+            }
+            for (const entry of entries ?? []) {
+                if ((typeof entry.message === 'string' &&
+                    entry.message.length > MAX_FIELD_LENGTH) ||
+                    (typeof entry.stack === 'string' &&
+                        entry.stack.length > MAX_FIELD_LENGTH)) {
+                    res.status(400).json({ error: 'Log entry field too large' });
+                    return;
+                }
+                await db.setDoc(BUILTIN_DEFS.errorLog, {
+                    ...dbDefaults(),
+                    id: nanoid(),
+                    source: 'browser',
+                    level: entry.level,
+                    message: entry.message,
+                    stack: entry.stack ?? null,
+                    url: entry.url,
+                    userId: null,
+                    created: new Date(entry.timestamp),
+                    updated: new Date(),
+                });
+                writeClientLogEntry({ level: entry.level, message: entry.message });
+            }
+            res.json({ ok: true });
+        }
+        catch (err) {
+            console.error('[Auth] Client log ingestion failed', err);
+            res.status(500).json({ error: 'failed' });
+        }
+    });
+    // Register any provider-specific routes
+    if (provider.registerRoutes) {
+        provider.registerRoutes(router);
+    }
+    return router;
+}
+//# sourceMappingURL=Auth.js.map

package/dist/server/Auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Auth.js","sourceRoot":"","sources":["../../src/server/Auth.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,SAAS,YAAY;IACnB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;IACtC,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IACtE,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,SAAS,CAAC;IACxD,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CACb,8DAA8D,GAAG,GAAG,CACrE,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAAc;IAC5C,OAAO,IAAI,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;SAChC,kBAAkB,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;SACpC,iBAAiB,CAAC,GAAG,gBAAgB,EAAE,GAAG,CAAC;SAC3C,WAAW,EAAE;SACb,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAa;IAC7C,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;IAC3D,IAAI,CAAC,OAAO,CAAC,GAAG;QAAE,MAAM,IAAI,SAAS,CAAC,eAAe,CAAC,CAAC;IACvD,OAAO,OAAO,CAAC,GAAG,CAAC;AACrB,CAAC;AAaD,MAAM,CAAC,MAAM,mBAAmB,GAAiB;IAC/C,OAAO,EAAE,CAAC,MAAc,EAAE,EAAE,CAC1B,iCAAiC,kBAAkB,CAAC,MAAM,CAAC,EAAE;IAC/D,MAAM,EAAE,KAAK,EAAE,IAAY,EAAE,EAAE;QAC7B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,sCAAsC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CACjE,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;YAC7D,OAAO,CAAC,KAAK,CAAC,qCAAqC,EAAE;gBACnD,MAAM,EAAE,QAAQ,CAAC,MAAM;aACxB,CAAC,CAAC;YACH,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAIlC,CAAC;QACF,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,OAAO;YACpB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;IACJ,CAAC;CACF,CAAC;AASF,MAAM,UAAU,gBAAgB;AAC9B,8DAA8D;AAC9D,EAAgB;AAChB,8DAA8D;AAC9D,UAA2B,EAC3B,YAA0B,EAC1B,WAAyB,mBAAmB;IAE5C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAEhC,+EAA+E;IAC/E,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QAChE,IAAI,CAAC;YACH,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC,IAAyB,CAAC;YAC/C,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC;gBAChD,OAAO;YACT,CAAC;YACD,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC7D,oEAAoE;YACpE,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YAClD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,YAAY,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;YACnD,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;YACtC,GAAG,CAAC,MAAM,CAAC,YAAY,EAAE,KAAK,EAAE;gBAC9B,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY;gBAC7C,QAAQ,EAAE,KAAK;gBACf,MAAM,EAAE,gBAAgB,EAAE,GAAG,IAAI;gBACjC,IAAI,EAAE,GAAG;aACV,CAAC,CAAC;YACH,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACtB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAC;YACjD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,uEAAuE;IACvE,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QAC9D,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,EAAE,UAAgC,CAAC;QAC5D,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;YAC9C,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,CAAC;YACxC,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;YACtC,GAAG,CAAC,MAAM,CAAC,YAAY,EAAE,KAAK,EAAE;gBAC9B,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY;gBAC7C,QAAQ,EAAE,KAAK;gBACf,MAAM,EAAE,gBAAgB,EAAE,GAAG,IAAI;gBACjC,IAAI,EAAE,GAAG;aACV,CAAC,CAAC;YACH,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,GAAG,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;YAC9B,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC,CAAC;QACrD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,6CAA6C;IAC7C,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,IAAa,EAAE,GAAa,EAAE,EAAE;QAC3D,GAAG,CAAC,WAAW,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;QAC7C,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,6DAA6D;IAC7D,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;QACtD,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAuB,CAAC;QACzD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,CAAC;YAClD,OAAO;QACT,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,MAAM,eAAe,GAAG,GAAG,CAAC;IAC5B,MAAM,gBAAgB,GAAG,MAAM,CAAC,CAAC,0CAA0C;IAE3E,sDAAsD;IACtD,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QAChE,IAAI,CAAC;YACH,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,IAQvB,CAAC;YACF,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,eAAe,EAAE,CAAC;gBAC/D,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,sBAAsB,EAAE,CAAC,CAAC;gBACxD,OAAO;YACT,CAAC;YACD,KAAK,MAAM,KAAK,IAAI,OAAO,IAAI,EAAE,EAAE,CAAC;gBAClC,IACE,CAAC,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;oBAChC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,gBAAgB,CAAC;oBAC1C,CAAC,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;wBAC9B,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,gBAAgB,CAAC,EACxC,CAAC;oBACD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,2BAA2B,EAAE,CAAC,CAAC;oBAC7D,OAAO;gBACT,CAAC;gBACD,MAAM,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE;oBACrC,GAAG,UAAU,EAAE;oBACf,EAAE,EAAE,MAAM,EAAE;oBACZ,MAAM,EAAE,SAAkB;oBAC1B,KAAK,EAAE,KAAK,CAAC,KAAoD;oBACjE,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,IAAI;oBAC1B,GAAG,EAAE,KAAK,CAAC,GAAG;oBACd,MAAM,EAAE,IAAI;oBACZ,OAAO,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;oBAClC,OAAO,EAAE,IAAI,IAAI,EAAE;iBACpB,CAAC,CAAC;gBACH,mBAAmB,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACtE,CAAC;YACD,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACzB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,oCAAoC,EAAE,GAAG,CAAC,CAAC;YACzD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,wCAAwC;IACxC,IAAI,QAAQ,CAAC,cAAc,EAAE,CAAC;QAC5B,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/server/Cache.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Initialize LRU cache and subscribe to 'cache.invalidate' NATS subject
+ * for multi-server invalidation.
+ */
+export declare function initCache(options?: {
+    maxItems?: number;
+    ttlMs?: number;
+}): void;
+/**
+ * Generate a deterministic cache key.
+ * Format: "collection/parent1Key:parent1Val/.../id"
+ * Slashes within segment values are percent-encoded to avoid key collisions.
+ */
+export declare function cacheKey(collection: string, id: string, parents?: [string, string][]): string;
+/**
+ * Get a cached value. Returns undefined if not found or expired.
+ */
+export declare function cacheGet<T>(key: string): T | undefined;
+/**
+ * Set a cached value with optional TTL override (in ms).
+ */
+export declare function cacheSet<T>(key: string, value: T, ttlMs?: number): void;
+/**
+ * Delete locally and publish invalidation to NATS so all servers remove it.
+ */
+export declare function cacheDelete(key: string): void;
+/**
+ * Convenience: build key and delete (with NATS invalidation).
+ */
+export declare function cacheInvalidate(collection: string, id: string, parents?: [string, string][]): void;
+/**
+ * Stats for monitoring.
+ */
+export declare function getCacheStats(): {
+    size: number;
+    maxSize: number;
+};
+//# sourceMappingURL=Cache.d.ts.map

package/dist/server/Cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Cache.d.ts","sourceRoot":"","sources":["../../src/server/Cache.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,CAAC,EAAE;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,IAAI,CAiCP;AAmBD;;;;GAIG;AACH,wBAAgB,QAAQ,CACtB,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAC3B,MAAM,CASR;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAEtD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAMvE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAO7C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAC3B,IAAI,CAGN;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAGjE"}

package/dist/server/Cache.js

@@ -0,0 +1,113 @@
+import { LRUCache } from 'lru-cache';
+import { natsPublish, natsSubscribe } from './Nats.js';
+const DEFAULT_MAX_ITEMS = 2000;
+const DEFAULT_TTL_MS = 60 * 60 * 1000; // 1 hour
+const CACHE_INVALIDATE_SUBJECT = 'cache.invalidate';
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+let lruCache = null;
+let initialized = false;
+/**
+ * Initialize LRU cache and subscribe to 'cache.invalidate' NATS subject
+ * for multi-server invalidation.
+ */
+export function initCache(options) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    lruCache = new LRUCache({
+        max: options?.maxItems ?? DEFAULT_MAX_ITEMS,
+        ttl: options?.ttlMs ?? DEFAULT_TTL_MS,
+        updateAgeOnGet: true,
+        allowStale: false,
+    });
+    if (initialized)
+        return;
+    initialized = true;
+    try {
+        natsSubscribe(CACHE_INVALIDATE_SUBJECT, (msg) => {
+            const { key } = msg.data;
+            lruCache?.delete(key);
+        }).catch((err) => {
+            console.error('[Cache] Failed to subscribe to invalidation subject', err);
+        });
+    }
+    catch (err) {
+        console.error('[Cache] NATS not available, skipping invalidation subscription', err);
+    }
+    console.log('[Cache] Initialized', {
+        maxItems: options?.maxItems ?? DEFAULT_MAX_ITEMS,
+        ttlMs: options?.ttlMs ?? DEFAULT_TTL_MS,
+    });
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function getCache() {
+    if (!lruCache) {
+        // Auto-initialize with defaults if not explicitly initialized
+        initCache();
+    }
+    return lruCache;
+}
+/**
+ * Encode a key segment so that the '/' separator is unambiguous.
+ * '/' → '%2F', '%' → '%25' (so encoding is reversible).
+ */
+function encodeSegment(s) {
+    return s.replace(/%/g, '%25').replace(/\//g, '%2F');
+}
+/**
+ * Generate a deterministic cache key.
+ * Format: "collection/parent1Key:parent1Val/.../id"
+ * Slashes within segment values are percent-encoded to avoid key collisions.
+ */
+export function cacheKey(collection, id, parents) {
+    const parts = [encodeSegment(collection)];
+    if (parents) {
+        for (const [key, value] of parents) {
+            parts.push(`${encodeSegment(key)}:${encodeSegment(value)}`);
+        }
+    }
+    parts.push(encodeSegment(id));
+    return parts.join('/');
+}
+/**
+ * Get a cached value. Returns undefined if not found or expired.
+ */
+export function cacheGet(key) {
+    return getCache().get(key);
+}
+/**
+ * Set a cached value with optional TTL override (in ms).
+ */
+export function cacheSet(key, value, ttlMs) {
+    if (ttlMs !== undefined) {
+        getCache().set(key, value, { ttl: ttlMs });
+    }
+    else {
+        getCache().set(key, value);
+    }
+}
+/**
+ * Delete locally and publish invalidation to NATS so all servers remove it.
+ */
+export function cacheDelete(key) {
+    getCache().delete(key);
+    try {
+        natsPublish(CACHE_INVALIDATE_SUBJECT, { key });
+    }
+    catch (err) {
+        console.error('[Cache] Failed to publish cache invalidation', err);
+    }
+}
+/**
+ * Convenience: build key and delete (with NATS invalidation).
+ */
+export function cacheInvalidate(collection, id, parents) {
+    const key = cacheKey(collection, id, parents);
+    cacheDelete(key);
+}
+/**
+ * Stats for monitoring.
+ */
+export function getCacheStats() {
+    const cache = getCache();
+    return { size: cache.size, maxSize: cache.max };
+}
+//# sourceMappingURL=Cache.js.map

package/dist/server/Cache.js.map

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

package/dist/server/ChangeStream.d.ts

@@ -0,0 +1,22 @@
+import { Document } from 'mongodb';
+export type ChangeType = 'update' | 'delete';
+export type DocChange =
+  | {
+      type: 'update';
+      collection: string;
+      id: string;
+      doc: Document;
+    }
+  | {
+      type: 'delete';
+      collection: string;
+      id: string;
+    };
+type ChangeListener = (change: DocChange) => void;
+export declare function subscribeCollection(
+  collection: string,
+  listener: ChangeListener,
+): Promise<() => void>;
+export declare function closeAllStreams(): Promise<void>;
+export {};
+//# sourceMappingURL=ChangeStream.d.ts.map

package/dist/server/ChangeStream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChangeStream.d.ts","sourceRoot":"","sources":["../../src/server/ChangeStream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGjD,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE7C,MAAM,MAAM,SAAS,GACjB;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,QAAQ,CAAC;CACf,GACD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEN,KAAK,cAAc,GAAG,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,CAAC;AA8FlD,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,IAAI,CAAC,CAQrB;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAKrD"}

package/dist/server/ChangeStream.js

@@ -0,0 +1,93 @@
+import { getDbName, getMongoClient } from './DB.js';
+// Per-collection: open stream + all listeners
+const streams = new Map();
+// Debounce: collapse rapid updates per document
+const DEBOUNCE_MS = 100;
+const MAX_WAIT_MS = 500;
+const pending = new Map();
+function flush(collection, id) {
+  const key = `${collection}/${id}`;
+  const p = pending.get(key);
+  if (!p) return;
+  clearTimeout(p.timer);
+  pending.delete(key);
+  fanOut({ type: 'update', collection, id, doc: p.doc });
+}
+function fanOut(change) {
+  const entry = streams.get(change.collection);
+  if (!entry) return;
+  for (const listener of entry.listeners) {
+    try {
+      listener(change);
+    } catch {}
+  }
+}
+async function openStream(collection) {
+  const client = await getMongoClient();
+  const stream = client
+    .db(getDbName())
+    .collection(collection)
+    .watch([], { fullDocument: 'updateLookup' });
+  stream.on('change', (event) => {
+    if (event.operationType === 'delete') {
+      const id = String(event.documentKey._id);
+      const key = `${collection}/${id}`;
+      const p = pending.get(key);
+      if (p) {
+        clearTimeout(p.timer);
+        pending.delete(key);
+      }
+      fanOut({ type: 'delete', collection, id });
+      return;
+    }
+    if (
+      event.operationType === 'insert' ||
+      event.operationType === 'replace' ||
+      event.operationType === 'update'
+    ) {
+      const id = String(event.documentKey._id);
+      const doc = event.fullDocument ?? {};
+      const key = `${collection}/${id}`;
+      const now = Date.now();
+      const existing = pending.get(key);
+      if (existing) {
+        existing.doc = doc;
+        if (now - existing.firstAt >= MAX_WAIT_MS) {
+          flush(collection, id);
+          return;
+        }
+        clearTimeout(existing.timer);
+        existing.timer = setTimeout(() => flush(collection, id), DEBOUNCE_MS);
+      } else {
+        const timer = setTimeout(() => flush(collection, id), DEBOUNCE_MS);
+        pending.set(key, { doc, firstAt: now, timer });
+      }
+    }
+  });
+  stream.on('error', (err) => {
+    console.error(`[ChangeStream] Error on ${collection}:`, err);
+    streams.delete(collection);
+  });
+  const existing = streams.get(collection);
+  if (existing) {
+    existing.stream = stream;
+  } else {
+    streams.set(collection, { stream, listeners: new Set() });
+  }
+}
+export async function subscribeCollection(collection, listener) {
+  if (!streams.has(collection)) {
+    await openStream(collection);
+  }
+  streams.get(collection).listeners.add(listener);
+  return () => {
+    streams.get(collection)?.listeners.delete(listener);
+  };
+}
+export async function closeAllStreams() {
+  for (const { stream } of streams.values()) {
+    await stream.close();
+  }
+  streams.clear();
+}
+//# sourceMappingURL=ChangeStream.js.map

package/dist/server/ChangeStream.js.map

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

package/dist/server/DB.d.ts

@@ -0,0 +1,17 @@
+import { MongoClient } from 'mongodb';
+import { CollectionDefRegistry, TypedDB } from '../shared/DB.js';
+/**
+ * Validate that a raw leaf id does not contain ':'.
+ * Compound ids (parentId) legitimately contain ':' and are NOT validated here.
+ */
+export declare function assertValidId(id: string): void;
+export declare function initMongoClient(uri: string, dbName?: string): Promise<void>;
+export declare function getMongoClient(): Promise<MongoClient>;
+export declare function getDbName(): string;
+export declare function stopMongo(): Promise<void>;
+type CollectionMap<Defs extends CollectionDefRegistry> = {
+    [K in keyof Defs]: Defs[K]['type'];
+};
+export declare function createTypedDB<Defs extends CollectionDefRegistry>(defs: Defs): TypedDB<CollectionMap<Defs>>;
+export {};
+//# sourceMappingURL=DB.d.ts.map

package/dist/server/DB.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DB.d.ts","sourceRoot":"","sources":["../../src/server/DB.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,WAAW,EAAoB,MAAM,SAAS,CAAC;AAC1E,OAAO,EAEL,qBAAqB,EAIrB,OAAO,EACR,MAAM,iBAAiB,CAAC;AAczB;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAI9C;AAyDD,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,MAAM,SAAS,GACd,OAAO,CAAC,IAAI,CAAC,CAGf;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,CAM3D;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAG/C;AAqQD,KAAK,aAAa,CAAC,IAAI,SAAS,qBAAqB,IAAI;KACtD,CAAC,IAAI,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;CACnC,CAAC;AAEF,wBAAgB,aAAa,CAAC,IAAI,SAAS,qBAAqB,EAC9D,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAwT9B"}