ugly-app 0.1.0

package/dist/server/Redis.d.ts

@@ -0,0 +1,61 @@
+import type { Redis } from 'ioredis';
+/**
+ * Initialize Redis. Falls back to in-memory if REDIS_URL not set.
+ * Call once at server startup.
+ */
+export declare function connectRedis(url?: string): Promise<void>;
+/**
+ * Get the raw ioredis client. Returns null if Redis is not connected.
+ *
+ * Prefer the higher-level redisGet/Set/Del/Publish/Subscribe functions.
+ * Use this only when you need direct ioredis access (e.g., for rate-limiter-flexible's RateLimiterRedis).
+ */
+export declare function getRedisClient(): Redis | null;
+/**
+ * Get a cached value. Returns null if not found or expired.
+ */
+export declare function redisGet(key: string): Promise<string | null>;
+/**
+ * Set a cached value with optional TTL in seconds.
+ */
+export declare function redisSet(key: string, value: string, ttlSeconds?: number): Promise<void>;
+/**
+ * Delete a cached value.
+ */
+export declare function redisDel(key: string): Promise<void>;
+/**
+ * Publish a message to a Redis channel.
+ * Used for cross-server WebSocket push routing.
+ *
+ * @example
+ * // Server B pushes notification to user on Server A
+ * await redisPublish(`push:${userId}`, JSON.stringify(notification));
+ */
+export declare function redisPublish(channel: string, message: string): Promise<void>;
+/**
+ * Subscribe to a Redis channel.
+ * Returns an unsubscribe function.
+ *
+ * Multiple calls for the same channel share a single Redis SUBSCRIBE command;
+ * all handlers are dispatched via a single 'message' listener on the
+ * subscriber client, avoiding the multi-listener dispatch bug.
+ *
+ * @example
+ * const unsub = await redisSubscribe(`push:${userId}`, (message) => {
+ *   const notification = JSON.parse(message);
+ *   sendToWebSocket(userId, notification);
+ * });
+ * // Later when user disconnects:
+ * unsub();
+ */
+export declare function redisSubscribe(channel: string, handler: (message: string) => void): Promise<() => void>;
+/**
+ * Check if Redis is available (connected, not in-memory fallback).
+ */
+export declare function isRedisConnected(): boolean;
+/**
+ * Gracefully close Redis connections.
+ * Call during server shutdown.
+ */
+export declare function closeRedis(): Promise<void>;
+//# sourceMappingURL=Redis.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Redis.d.ts","sourceRoot":"","sources":["../../src/server/Redis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AA6BrC;;;GAGG;AACH,wBAAsB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkD9D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,KAAK,GAAG,IAAI,CAE7C;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYlE;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMzD;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACjC,OAAO,CAAC,MAAM,IAAI,CAAC,CAqCrB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED;;;GAGG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAWhD"}

package/dist/server/Redis.js

@@ -0,0 +1,226 @@
+import IORedis from 'ioredis';
+let redisClient = null;
+let subscriberClient = null;
+// In-memory fallback for single-server dev (no REDIS_URL)
+const inMemoryCache = new Map();
+const inMemorySubscribers = new Map();
+// Per-channel handler tracking for the real Redis subscriber client.
+// Maps channel -> Set of handlers. We use a single 'message' listener on the
+// subscriberClient that dispatches to all per-channel handlers. This avoids the
+// bug where multiple per-channel event listeners each fire for every message.
+const redisChannelHandlers = new Map();
+function onRedisMessage(channel, message) {
+    const handlers = redisChannelHandlers.get(channel);
+    if (handlers) {
+        for (const handler of handlers) {
+            try {
+                handler(message);
+            }
+            catch (err) {
+                console.error('[Redis] Channel handler error', { channel, err });
+            }
+        }
+    }
+}
+/**
+ * Initialize Redis. Falls back to in-memory if REDIS_URL not set.
+ * Call once at server startup.
+ */
+export async function connectRedis(url) {
+    const redisUrl = url ?? process.env['REDIS_URL'];
+    if (!redisUrl) {
+        console.log('[Redis] No REDIS_URL set, using in-memory fallback (single-server only)');
+        return;
+    }
+    redisClient = new IORedis.Redis(redisUrl, {
+        maxRetriesPerRequest: 3,
+        lazyConnect: false,
+    });
+    // Subscriber client must be a separate connection (Redis subscribe blocks)
+    subscriberClient = new IORedis.Redis(redisUrl, {
+        maxRetriesPerRequest: 3,
+        lazyConnect: false,
+    });
+    // Attach the single shared dispatcher
+    subscriberClient.on('message', onRedisMessage);
+    try {
+        await Promise.all([
+            new Promise((resolve, reject) => {
+                redisClient.on('ready', resolve);
+                redisClient.on('error', reject);
+            }),
+            new Promise((resolve, reject) => {
+                subscriberClient.on('ready', resolve);
+                subscriberClient.on('error', reject);
+            }),
+        ]);
+    }
+    catch (err) {
+        // Clean up partial connections
+        await closeRedis();
+        throw err;
+    }
+    // Persistent error handlers to prevent unhandled error events
+    redisClient.on('error', (err) => {
+        console.error('[Redis] Client error', err);
+    });
+    subscriberClient.on('error', (err) => {
+        console.error('[Redis] Subscriber error', err);
+    });
+    console.log('[Redis] Connected', { url: redisUrl });
+}
+/**
+ * Get the raw ioredis client. Returns null if Redis is not connected.
+ *
+ * Prefer the higher-level redisGet/Set/Del/Publish/Subscribe functions.
+ * Use this only when you need direct ioredis access (e.g., for rate-limiter-flexible's RateLimiterRedis).
+ */
+export function getRedisClient() {
+    return redisClient;
+}
+/**
+ * Get a cached value. Returns null if not found or expired.
+ */
+export async function redisGet(key) {
+    if (redisClient) {
+        return redisClient.get(key);
+    }
+    // In-memory fallback
+    const entry = inMemoryCache.get(key);
+    if (!entry)
+        return null;
+    if (entry.expiresAt !== undefined && Date.now() > entry.expiresAt) {
+        inMemoryCache.delete(key);
+        return null;
+    }
+    return entry.value;
+}
+/**
+ * Set a cached value with optional TTL in seconds.
+ */
+export async function redisSet(key, value, ttlSeconds) {
+    if (redisClient) {
+        if (ttlSeconds !== undefined) {
+            await redisClient.setex(key, ttlSeconds, value);
+        }
+        else {
+            await redisClient.set(key, value);
+        }
+        return;
+    }
+    // In-memory fallback
+    inMemoryCache.set(key, {
+        value,
+        expiresAt: ttlSeconds !== undefined ? Date.now() + ttlSeconds * 1000 : undefined,
+    });
+}
+/**
+ * Delete a cached value.
+ */
+export async function redisDel(key) {
+    if (redisClient) {
+        await redisClient.del(key);
+        return;
+    }
+    inMemoryCache.delete(key);
+}
+/**
+ * Publish a message to a Redis channel.
+ * Used for cross-server WebSocket push routing.
+ *
+ * @example
+ * // Server B pushes notification to user on Server A
+ * await redisPublish(`push:${userId}`, JSON.stringify(notification));
+ */
+export async function redisPublish(channel, message) {
+    if (redisClient) {
+        await redisClient.publish(channel, message);
+        return;
+    }
+    // In-memory fallback: deliver to local subscribers only
+    const subscribers = inMemorySubscribers.get(channel);
+    if (subscribers) {
+        for (const handler of subscribers) {
+            try {
+                handler(message);
+            }
+            catch (err) {
+                console.error('[Redis] In-memory subscriber error', { channel, err });
+            }
+        }
+    }
+}
+/**
+ * Subscribe to a Redis channel.
+ * Returns an unsubscribe function.
+ *
+ * Multiple calls for the same channel share a single Redis SUBSCRIBE command;
+ * all handlers are dispatched via a single 'message' listener on the
+ * subscriber client, avoiding the multi-listener dispatch bug.
+ *
+ * @example
+ * const unsub = await redisSubscribe(`push:${userId}`, (message) => {
+ *   const notification = JSON.parse(message);
+ *   sendToWebSocket(userId, notification);
+ * });
+ * // Later when user disconnects:
+ * unsub();
+ */
+export async function redisSubscribe(channel, handler) {
+    if (subscriberClient) {
+        // Add handler to per-channel tracking
+        if (!redisChannelHandlers.has(channel)) {
+            redisChannelHandlers.set(channel, new Set());
+        }
+        const handlers = redisChannelHandlers.get(channel);
+        const isFirstHandler = handlers.size === 0;
+        handlers.add(handler);
+        // Only send SUBSCRIBE to Redis when adding the first handler for this channel
+        if (isFirstHandler) {
+            await subscriberClient.subscribe(channel);
+        }
+        return () => {
+            const channelHandlers = redisChannelHandlers.get(channel);
+            if (channelHandlers) {
+                channelHandlers.delete(handler);
+                if (channelHandlers.size === 0) {
+                    redisChannelHandlers.delete(channel);
+                    subscriberClient.unsubscribe(channel).catch((err) => {
+                        console.error('[Redis] Unsubscribe error', { channel, err });
+                    });
+                }
+            }
+        };
+    }
+    // In-memory fallback
+    if (!inMemorySubscribers.has(channel)) {
+        inMemorySubscribers.set(channel, new Set());
+    }
+    inMemorySubscribers.get(channel).add(handler);
+    return () => {
+        inMemorySubscribers.get(channel)?.delete(handler);
+    };
+}
+/**
+ * Check if Redis is available (connected, not in-memory fallback).
+ */
+export function isRedisConnected() {
+    return redisClient !== null;
+}
+/**
+ * Gracefully close Redis connections.
+ * Call during server shutdown.
+ */
+export async function closeRedis() {
+    redisChannelHandlers.clear();
+    if (redisClient) {
+        await redisClient.quit();
+        redisClient = null;
+    }
+    if (subscriberClient) {
+        subscriberClient.removeListener('message', onRedisMessage);
+        await subscriberClient.quit();
+        subscriberClient = null;
+    }
+}
+//# sourceMappingURL=Redis.js.map

package/dist/server/Redis.js.map

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

package/dist/server/Router.d.ts

@@ -0,0 +1,27 @@
+import { AppRegistryBase, FunctionDef, RequestDef } from '../shared/Api.js';
+import { DBObject, TypedDB } from '../shared/DB.js';
+import { createImageGen } from './ImageGen.js';
+import { createLogger } from './Logging.js';
+import { RateLimiter } from './RateLimit.js';
+import { createStorageClient } from './Storage.js';
+import { createTextGen } from './TextGen.js';
+export declare class RouterNotFoundError extends Error {
+    constructor(name: string);
+}
+export type HandlerFn = (ctx: HandlerContext, input: unknown) => Promise<unknown>;
+export interface HandlerContext {
+    userId: string;
+    db: TypedDB<Record<string, DBObject>>;
+    storage: ReturnType<typeof createStorageClient>;
+    textGen: ReturnType<typeof createTextGen>;
+    imageGen: ReturnType<typeof createImageGen>;
+    log: ReturnType<typeof createLogger>;
+    rateLimit: RateLimiter;
+}
+export interface AppRouter {
+    registerFunction<K extends string>(name: K, handler: HandlerFn, def?: FunctionDef<unknown, unknown>): void;
+    registerRequest<K extends string>(name: K, handler: HandlerFn, def?: RequestDef<unknown, unknown>): void;
+    dispatch(type: 'function' | 'request', name: string, input: unknown, userId: string): Promise<unknown>;
+}
+export declare function createRouter(_registry: AppRegistryBase, db: TypedDB<Record<string, DBObject>>, contextExtension?: (base: HandlerContext) => Promise<Record<string, unknown>>, rateLimiter?: RateLimiter): AppRouter;
+//# sourceMappingURL=Router.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Router.d.ts","sourceRoot":"","sources":["../../src/server/Router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAqB,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,IAAI,EAAE,MAAM;CAIzB;AAED,MAAM,MAAM,SAAS,GAAG,CACtB,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,OAAO,KACX,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IACtC,OAAO,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;IAChD,OAAO,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;IAC1C,QAAQ,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;IAC5C,GAAG,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;IACrC,SAAS,EAAE,WAAW,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAC/B,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,SAAS,EAClB,GAAG,CAAC,EAAE,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,GAClC,IAAI,CAAC;IACR,eAAe,CAAC,CAAC,SAAS,MAAM,EAC9B,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,SAAS,EAClB,GAAG,CAAC,EAAE,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,GACjC,IAAI,CAAC;IACR,QAAQ,CACN,IAAI,EAAE,UAAU,GAAG,SAAS,EAC5B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB;AAED,wBAAgB,YAAY,CAC1B,SAAS,EAAE,eAAe,EAC1B,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,EACrC,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC7E,WAAW,CAAC,EAAE,WAAW,GACxB,SAAS,CAkEX"}

package/dist/server/Router.js

@@ -0,0 +1,71 @@
+import { createImageGen } from './ImageGen.js';
+import { createLogger } from './Logging.js';
+import { createRateLimiter } from './RateLimit.js';
+import { createStorageClient } from './Storage.js';
+import { createTextGen } from './TextGen.js';
+export class RouterNotFoundError extends Error {
+    constructor(name) {
+        super(`[Router] '${name}' is not registered`);
+        this.name = 'RouterNotFoundError';
+    }
+}
+export function createRouter(_registry, db, contextExtension, rateLimiter) {
+    const functionHandlers = new Map();
+    const requestHandlers = new Map();
+    const functionDefs = new Map();
+    const requestDefs = new Map();
+    // S3Client is created once at router creation — not per-request
+    const storage = createStorageClient();
+    // Use provided rateLimiter or create a default one
+    const rateLimit = rateLimiter ?? createRateLimiter();
+    async function buildContext(userId) {
+        const base = {
+            userId,
+            db,
+            storage,
+            textGen: createTextGen(userId),
+            imageGen: createImageGen(userId),
+            log: createLogger(userId, storage, db),
+            rateLimit,
+        };
+        if (contextExtension) {
+            const extensions = await contextExtension(base);
+            return Object.assign(Object.create(Object.getPrototypeOf(base)), base, extensions);
+        }
+        return base;
+    }
+    return {
+        registerFunction(name, handler, def) {
+            functionHandlers.set(name, handler);
+            if (def)
+                functionDefs.set(name, def);
+        },
+        registerRequest(name, handler, def) {
+            requestHandlers.set(name, handler);
+            if (def)
+                requestDefs.set(name, def);
+        },
+        async dispatch(type, name, input, userId) {
+            const map = type === 'function' ? functionHandlers : requestHandlers;
+            const handler = map.get(name);
+            if (!handler)
+                throw new RouterNotFoundError(name);
+            // Validate input with Zod schema if present
+            const defMap = type === 'function' ? functionDefs : requestDefs;
+            const def = defMap.get(name);
+            if (def?.inputSchema) {
+                const result = def.inputSchema.safeParse(input);
+                if (!result.success) {
+                    const issues = result.error.issues
+                        .map((i) => `${i.path.map(String).join('.')}: ${i.message}`)
+                        .join(', ');
+                    throw new Error(`[Router] Invalid input for '${name}': ${issues}`);
+                }
+                input = result.data;
+            }
+            const ctx = await buildContext(userId);
+            return handler(ctx, input);
+        },
+    };
+}
+//# sourceMappingURL=Router.js.map

package/dist/server/Router.js.map

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

package/dist/server/Socket.d.ts

@@ -0,0 +1,8 @@
+import type { Server } from 'http';
+import { WebSocket, WebSocketServer } from 'ws';
+import type { CollectionRegistry, TypedDB, UserHelper } from '../shared/DB.js';
+import './audio/index.js';
+import type { AppRouter } from './Router.js';
+import type { StorageClient } from './Storage.js';
+export declare function initWebSocketServer(server: Server, router: AppRouter, collections: CollectionRegistry, storage: StorageClient, typedDb: TypedDB<any>, userHelper: UserHelper<any>, wsPath?: string, onSocketMessage?: (ws: WebSocket, userId: string, msg: unknown) => boolean): WebSocketServer;
+//# sourceMappingURL=Socket.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Socket.d.ts","sourceRoot":"","sources":["../../src/server/Socket.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,IAAI,CAAC;AAQhD,OAAO,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC/E,OAAO,kBAAkB,CAAC;AAQ1B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AA+ClD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,kBAAkB,EAC/B,OAAO,EAAE,aAAa,EAEtB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,EAErB,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,EAC3B,MAAM,SAAS,EACf,eAAe,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,OAAO,GACzE,eAAe,CAmSjB"}