ugly-app 0.1.0

package/dist/cli/serverLogQuery.js

@@ -0,0 +1,76 @@
+import { MongoClient } from 'mongodb';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+async function getMongoUri() {
+    // Try environment variable first
+    if (process.env['MONGODB_URI'])
+        return process.env['MONGODB_URI'];
+    // Try to read from .env file in cwd
+    const envPath = path.join(process.cwd(), '.env');
+    try {
+        const content = await fs.readFile(envPath, 'utf-8');
+        for (const line of content.split('\n')) {
+            const match = /^MONGODB_URI\s*=\s*(.+)$/.exec(line.trim());
+            if (match)
+                return match[1].replace(/^['"]|['"]$/g, '');
+        }
+    }
+    catch {
+        // No .env file
+    }
+    return 'mongodb://localhost:27017/website-core';
+}
+function formatDoc(doc) {
+    const ts = doc['created'] instanceof Date
+        ? doc['created'].toISOString().replace('T', ' ').replace('Z', '')
+        : String(doc['created'] ?? '');
+    const level = String(doc['level'] ?? '')
+        .toUpperCase()
+        .padEnd(5);
+    const message = String(doc['message'] ?? '');
+    const meta = doc['meta'] ? ` ${JSON.stringify(doc['meta'])}` : '';
+    const stack = doc['stack']
+        ? `\n  ${String(doc['stack']).split('\n').slice(0, 3).join('\n  ')}`
+        : '';
+    return `${ts} ${level} ${message}${meta}${stack}`;
+}
+export async function queryServerLogs(collection, options = {}) {
+    const limit = options.limit ?? 50;
+    const uri = await getMongoUri();
+    let client = null;
+    try {
+        client = new MongoClient(uri);
+        await client.connect();
+        // Extract database name from URI or use default
+        const dbName = uri.split('/').pop()?.split('?')[0] ?? 'website-core';
+        const db = client.db(dbName);
+        const col = db.collection(collection);
+        const query = {};
+        if (options.level)
+            query['level'] = options.level;
+        const docs = await col
+            .find(query)
+            .sort({ created: -1 })
+            .limit(limit)
+            .toArray();
+        // Reverse to show oldest first
+        docs.reverse();
+        if (docs.length === 0) {
+            console.log(`No entries found in ${collection}.`);
+            return;
+        }
+        for (const doc of docs) {
+            if (options.json) {
+                console.log(JSON.stringify(doc));
+            }
+            else {
+                console.log(formatDoc(doc));
+            }
+        }
+    }
+    finally {
+        if (client)
+            await client.close();
+    }
+}
+//# sourceMappingURL=serverLogQuery.js.map

package/dist/cli/serverLogQuery.js.map

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

package/dist/cli/storageClient.d.ts

@@ -0,0 +1,3 @@
+import { S3Client } from '@aws-sdk/client-s3';
+export declare function createStorageClient(): S3Client;
+//# sourceMappingURL=storageClient.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storageClient.d.ts","sourceRoot":"","sources":["../../src/cli/storageClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,wBAAgB,mBAAmB,IAAI,QAAQ,CAqB9C"}

package/dist/cli/storageClient.js

@@ -0,0 +1,22 @@
+import { S3Client } from '@aws-sdk/client-s3';
+export function createStorageClient() {
+    const accountId = process.env['STORAGE_ACCOUNT_ID'];
+    const accessKeyId = process.env['STORAGE_ACCESS_KEY_ID'];
+    const secretAccessKey = process.env['STORAGE_SECRET_ACCESS_KEY'];
+    if (accountId && accessKeyId && secretAccessKey) {
+        // Cloudflare R2
+        return new S3Client({
+            region: 'auto',
+            endpoint: `https://${accountId}.r2.cloudflarestorage.com`,
+            credentials: { accessKeyId, secretAccessKey },
+        });
+    }
+    // Local MinIO fallback
+    return new S3Client({
+        region: 'us-east-1',
+        endpoint: 'http://localhost:9000',
+        credentials: { accessKeyId: 'minioadmin', secretAccessKey: 'minioadmin' },
+        forcePathStyle: true,
+    });
+}
+//# sourceMappingURL=storageClient.js.map

package/dist/cli/storageClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storageClient.js","sourceRoot":"","sources":["../../src/cli/storageClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,MAAM,UAAU,mBAAmB;IACjC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACpD,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IACzD,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IAEjE,IAAI,SAAS,IAAI,WAAW,IAAI,eAAe,EAAE,CAAC;QAChD,gBAAgB;QAChB,OAAO,IAAI,QAAQ,CAAC;YAClB,MAAM,EAAE,MAAM;YACd,QAAQ,EAAE,WAAW,SAAS,2BAA2B;YACzD,WAAW,EAAE,EAAE,WAAW,EAAE,eAAe,EAAE;SAC9C,CAAC,CAAC;IACL,CAAC;IAED,uBAAuB;IACvB,OAAO,IAAI,QAAQ,CAAC;QAClB,MAAM,EAAE,WAAW;QACnB,QAAQ,EAAE,uBAAuB;QACjC,WAAW,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE;QACzE,cAAc,EAAE,IAAI;KACrB,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/uglyappConfig.d.ts

@@ -0,0 +1,29 @@
+export interface UglyAppConfig {
+    projectId: string;
+    portStart: number;
+}
+export interface ComputedPorts {
+    PORT: number;
+    PORT_NODE: number;
+    PORT_TEST: number;
+    PORT_PYTHON: number;
+    PORT_MONGO: number;
+    PORT_REDIS: number;
+    PORT_NATS: number;
+    PORT_MINIO: number;
+    PORT_MINIO_CONSOLE: number;
+    PORT_VITE_HMR: number;
+}
+export declare const KNOWN_CONFLICTING_PORTS: Map<number, string>;
+export declare function validatePortStart(portStart: number): void;
+export declare function computePorts(portStart: number): ComputedPorts;
+export declare function computeEnvVars(config: UglyAppConfig): Record<string, string>;
+/**
+ * Read `.uglyapp` from the project root.
+ * Returns null if the file does not exist (caller applies defaults).
+ * Throws if the file exists but is malformed or has invalid portStart.
+ */
+export declare function readUglyAppConfig(cwd: string): UglyAppConfig | null;
+export declare function writeUglyAppConfig(cwd: string, config: UglyAppConfig): void;
+export declare function printPortTable(portStart: number): void;
+//# sourceMappingURL=uglyappConfig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"uglyappConfig.d.ts","sourceRoot":"","sources":["../../src/cli/uglyappConfig.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;CACvB;AAGD,eAAO,MAAM,uBAAuB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAUtD,CAAC;AAEH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CA6BzD;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,CAa7D;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkB5E;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAyCnE;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAG3E;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAatD"}

package/dist/cli/uglyappConfig.js

@@ -0,0 +1,125 @@
+import fs from 'fs';
+import path from 'path';
+// Ports that conflict with well-known services or OS reservations
+export const KNOWN_CONFLICTING_PORTS = new Map([
+    [5000, 'macOS AirPlay Receiver (Monterey+)'],
+    [7000, 'macOS AirPlay'],
+    [4222, 'NATS default port'],
+    [5432, 'PostgreSQL default port'],
+    [6379, 'Redis default port'],
+    [9000, 'MinIO default port'],
+    [9001, 'MinIO console default port'],
+    [27017, 'MongoDB default port'],
+    [3306, 'MySQL default port'],
+]);
+export function validatePortStart(portStart) {
+    if (!Number.isInteger(portStart) || portStart <= 0) {
+        throw new Error(`Invalid portStart: ${portStart}. Must be a positive integer.`);
+    }
+    if (portStart < 1024) {
+        console.warn(`[uglyapp] Warning: portStart ${portStart} is a privileged port (< 1024). Root access may be required.`);
+        return;
+    }
+    if (portStart + 8 > 65535) {
+        throw new Error(`Invalid portStart: ${portStart}. portStart + 8 (${portStart + 8}) exceeds the maximum valid port (65535).`);
+    }
+    // Check all 10 slots in the block for conflicts (slots 0–9; +9 is the spare slot)
+    for (let i = 0; i < 10; i++) {
+        const port = portStart + i;
+        const conflict = KNOWN_CONFLICTING_PORTS.get(port);
+        if (conflict) {
+            console.warn(`[uglyapp] Warning: portStart ${portStart} assigns port ${port} (slot +${i}) which conflicts with ${conflict}.`);
+        }
+    }
+}
+export function computePorts(portStart) {
+    return {
+        PORT: portStart,
+        PORT_NODE: portStart,
+        PORT_TEST: portStart + 1,
+        PORT_PYTHON: portStart + 2,
+        PORT_MONGO: portStart + 3,
+        PORT_REDIS: portStart + 4,
+        PORT_NATS: portStart + 5,
+        PORT_MINIO: portStart + 6,
+        PORT_MINIO_CONSOLE: portStart + 7,
+        PORT_VITE_HMR: portStart + 8,
+    };
+}
+export function computeEnvVars(config) {
+    const ports = computePorts(config.portStart);
+    return {
+        COMPOSE_PROJECT_NAME: config.projectId,
+        PORT: String(ports.PORT),
+        PORT_NODE: String(ports.PORT_NODE),
+        PORT_TEST: String(ports.PORT_TEST),
+        PORT_PYTHON: String(ports.PORT_PYTHON),
+        PORT_MONGO: String(ports.PORT_MONGO),
+        PORT_REDIS: String(ports.PORT_REDIS),
+        PORT_NATS: String(ports.PORT_NATS),
+        PORT_MINIO: String(ports.PORT_MINIO),
+        PORT_MINIO_CONSOLE: String(ports.PORT_MINIO_CONSOLE),
+        PORT_VITE_HMR: String(ports.PORT_VITE_HMR),
+        MONGODB_URI: `mongodb://localhost:${ports.PORT_MONGO}/?directConnection=true`,
+        REDIS_URL: `redis://localhost:${ports.PORT_REDIS}`,
+        NATS_URL: `nats://localhost:${ports.PORT_NATS}`,
+    };
+}
+/**
+ * Read `.uglyapp` from the project root.
+ * Returns null if the file does not exist (caller applies defaults).
+ * Throws if the file exists but is malformed or has invalid portStart.
+ */
+export function readUglyAppConfig(cwd) {
+    const configPath = path.join(cwd, '.uglyapp');
+    if (!fs.existsSync(configPath))
+        return null;
+    let raw;
+    try {
+        raw = fs.readFileSync(configPath, 'utf-8');
+    }
+    catch (e) {
+        throw new Error(`[uglyapp] Failed to read .uglyapp: ${e.message}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new Error('[uglyapp] .uglyapp is not valid JSON.');
+    }
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+        throw new Error('[uglyapp] .uglyapp must be a JSON object.');
+    }
+    const config = parsed;
+    if (typeof config.projectId !== 'string' || !config.projectId) {
+        throw new Error('[uglyapp] .uglyapp missing required field: projectId (string)');
+    }
+    if (typeof config.portStart !== 'number') {
+        throw new Error('[uglyapp] .uglyapp missing required field: portStart (number)');
+    }
+    validatePortStart(config.portStart);
+    return {
+        projectId: config.projectId,
+        portStart: config.portStart,
+    };
+}
+export function writeUglyAppConfig(cwd, config) {
+    const configPath = path.join(cwd, '.uglyapp');
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+}
+export function printPortTable(portStart) {
+    const ports = computePorts(portStart);
+    console.log('\nPort assignments:');
+    console.log(`  Node server:     ${ports.PORT_NODE}`);
+    console.log(`  Test server:     ${ports.PORT_TEST}`);
+    console.log(`  Python bot:      ${ports.PORT_PYTHON}`);
+    console.log(`  MongoDB:         ${ports.PORT_MONGO}`);
+    console.log(`  Redis:           ${ports.PORT_REDIS}`);
+    console.log(`  NATS:            ${ports.PORT_NATS}`);
+    console.log(`  MinIO API:       ${ports.PORT_MINIO}`);
+    console.log(`  MinIO Console:   ${ports.PORT_MINIO_CONSOLE}`);
+    console.log(`  Vite HMR:        ${ports.PORT_VITE_HMR}`);
+    console.log(`  (spare):         ${portStart + 9}\n`);
+}
+//# sourceMappingURL=uglyappConfig.js.map

package/dist/cli/uglyappConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uglyappConfig.js","sourceRoot":"","sources":["../../src/cli/uglyappConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAoBxB,kEAAkE;AAClE,MAAM,CAAC,MAAM,uBAAuB,GAAwB,IAAI,GAAG,CAAC;IAClE,CAAC,IAAI,EAAE,oCAAoC,CAAC;IAC5C,CAAC,IAAI,EAAE,eAAe,CAAC;IACvB,CAAC,IAAI,EAAE,mBAAmB,CAAC;IAC3B,CAAC,IAAI,EAAE,yBAAyB,CAAC;IACjC,CAAC,IAAI,EAAE,oBAAoB,CAAC;IAC5B,CAAC,IAAI,EAAE,oBAAoB,CAAC;IAC5B,CAAC,IAAI,EAAE,4BAA4B,CAAC;IACpC,CAAC,KAAK,EAAE,sBAAsB,CAAC;IAC/B,CAAC,IAAI,EAAE,oBAAoB,CAAC;CAC7B,CAAC,CAAC;AAEH,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CACb,sBAAsB,SAAS,+BAA+B,CAC/D,CAAC;IACJ,CAAC;IACD,IAAI,SAAS,GAAG,IAAI,EAAE,CAAC;QACrB,OAAO,CAAC,IAAI,CACV,gCAAgC,SAAS,8DAA8D,CACxG,CAAC;QACF,OAAO;IACT,CAAC;IACD,IAAI,SAAS,GAAG,CAAC,GAAG,KAAK,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,sBAAsB,SAAS,oBAC7B,SAAS,GAAG,CACd,2CAA2C,CAC5C,CAAC;IACJ,CAAC;IACD,kFAAkF;IAClF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,SAAS,GAAG,CAAC,CAAC;QAC3B,MAAM,QAAQ,GAAG,uBAAuB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CACV,gCAAgC,SAAS,iBAAiB,IAAI,WAAW,CAAC,0BAA0B,QAAQ,GAAG,CAChH,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,SAAiB;IAC5C,OAAO;QACL,IAAI,EAAE,SAAS;QACf,SAAS,EAAE,SAAS;QACpB,SAAS,EAAE,SAAS,GAAG,CAAC;QACxB,WAAW,EAAE,SAAS,GAAG,CAAC;QAC1B,UAAU,EAAE,SAAS,GAAG,CAAC;QACzB,UAAU,EAAE,SAAS,GAAG,CAAC;QACzB,SAAS,EAAE,SAAS,GAAG,CAAC;QACxB,UAAU,EAAE,SAAS,GAAG,CAAC;QACzB,kBAAkB,EAAE,SAAS,GAAG,CAAC;QACjC,aAAa,EAAE,SAAS,GAAG,CAAC;KAC7B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAqB;IAClD,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC7C,OAAO;QACL,oBAAoB,EAAE,MAAM,CAAC,SAAS;QACtC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC;QAClC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC;QAClC,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC;QACtC,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC;QACpC,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC;QACpC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC;QAClC,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC;QACpC,kBAAkB,EAAE,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC;QACpD,aAAa,EAAE,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC;QAC1C,WAAW,EAAE,uBAAuB,KAAK,CAAC,UAAU,yBAAyB;QAC7E,SAAS,EAAE,qBAAqB,KAAK,CAAC,UAAU,EAAE;QAClD,QAAQ,EAAE,oBAAoB,KAAK,CAAC,SAAS,EAAE;KAChD,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAC9C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAE5C,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,sCAAuC,CAAW,CAAC,OAAO,EAAE,CAC7D,CAAC;IACJ,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,MAAM,GAAG,MAAiC,CAAC;IACjD,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CACb,+DAA+D,CAChE,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CACb,+DAA+D,CAChE,CAAC;IACJ,CAAC;IACD,iBAAiB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAEpC,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAW,EAAE,MAAqB;IACnE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAC9C,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,MAAM,KAAK,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,sBAAsB,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,sBAAsB,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,sBAAsB,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IACvD,OAAO,CAAC,GAAG,CAAC,sBAAsB,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;IACtD,OAAO,CAAC,GAAG,CAAC,sBAAsB,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;IACtD,OAAO,CAAC,GAAG,CAAC,sBAAsB,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,sBAAsB,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;IACtD,OAAO,CAAC,GAAG,CAAC,sBAAsB,KAAK,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAC9D,OAAO,CAAC,GAAG,CAAC,sBAAsB,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC;IACzD,OAAO,CAAC,GAAG,CAAC,sBAAsB,SAAS,GAAG,CAAC,IAAI,CAAC,CAAC;AACvD,CAAC"}

package/dist/client/AppProvider.d.ts

@@ -0,0 +1,32 @@
+import { ReactElement, ReactNode } from 'react';
+import type { AppRegistryBase } from '../shared/Api.js';
+import type { UserBase } from '../shared/DB.js';
+import type { AppSocket } from './createSocket.js';
+export interface AppContextValue<TAsyncOptions = unknown> {
+    userId: string;
+    user: UserBase;
+    socket: AppSocket<AppRegistryBase>;
+    showPopup(content: ReactElement): string;
+    hidePopup(id: string): void;
+    hideAllPopups(): void;
+    runAsync(label: string, fn: () => Promise<void>, options?: TAsyncOptions): Promise<void>;
+    splashDone(step: string): void;
+    localizer: (key: string, params?: unknown[]) => string;
+}
+export declare function useApp<TAsyncOptions = unknown>(): AppContextValue<TAsyncOptions>;
+interface AppProviderProps<TAsyncOptions = unknown> {
+    socket: AppSocket<AppRegistryBase>;
+    userId: string;
+    user: UserBase;
+    children: ReactNode;
+    splashScreen?: ReactElement;
+    loadingOverlay?: ReactElement<{
+        label: string;
+        asyncOptions?: TAsyncOptions;
+    }>;
+    localizer?: (key: string, params?: unknown[]) => string;
+}
+export declare function AppProvider<TAsyncOptions = unknown>({ socket, userId, user, children, splashScreen, loadingOverlay, localizer: localizerProp, }: AppProviderProps<TAsyncOptions>): import("react/jsx-runtime").JSX.Element;
+export declare function useLocalizer(): (key: string, params?: unknown[]) => string;
+export {};
+//# sourceMappingURL=AppProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AppProvider.d.ts","sourceRoot":"","sources":["../../src/client/AppProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAGL,YAAY,EACZ,SAAS,EAOV,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAYnD,MAAM,WAAW,eAAe,CAAC,aAAa,GAAG,OAAO;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,SAAS,CAAC,eAAe,CAAC,CAAC;IACnC,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAAC;IACzC,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,IAAI,IAAI,CAAC;IACtB,QAAQ,CACN,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EACvB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,MAAM,CAAC;CACxD;AAID,wBAAgB,MAAM,CACpB,aAAa,GAAG,OAAO,KACpB,eAAe,CAAC,aAAa,CAAC,CAIlC;AAKD,UAAU,gBAAgB,CAAC,aAAa,GAAG,OAAO;IAChD,MAAM,EAAE,SAAS,CAAC,eAAe,CAAC,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,SAAS,CAAC;IACpB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,cAAc,CAAC,EAAE,YAAY,CAAC;QAC5B,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,CAAC,EAAE,aAAa,CAAC;KAC9B,CAAC,CAAC;IACH,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,MAAM,CAAC;CACzD;AAED,wBAAgB,WAAW,CAAC,aAAa,GAAG,OAAO,EAAE,EACnD,MAAM,EACN,MAAM,EACN,IAAI,EACJ,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,SAAS,EAAE,aAAa,GACzB,EAAE,gBAAgB,CAAC,aAAa,CAAC,2CAsIjC;AAED,wBAAgB,YAAY,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,MAAM,CAE1E"}

package/dist/client/AppProvider.js

@@ -0,0 +1,126 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cloneElement, createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, } from 'react';
+const AppContext = createContext(null);
+export function useApp() {
+    const ctx = useContext(AppContext);
+    if (!ctx)
+        throw new Error('useApp() must be used inside <AppProvider>');
+    return ctx;
+}
+const REQUIRED_STEPS = ['fonts', 'auth'];
+const SPLASH_TIMEOUT_MS = 3000;
+export function AppProvider({ socket, userId, user, children, splashScreen, loadingOverlay, localizer: localizerProp, }) {
+    const [popups, setPopups] = useState([]);
+    const [asyncLabel, setAsyncLabel] = useState(null);
+    const asyncOptions = useRef(undefined);
+    const asyncCount = useRef(0);
+    const popupCounter = useRef(0);
+    // Splash state — use ref to avoid re-renders during step completion
+    const splashRef = useRef({
+        steps: new Set(REQUIRED_STEPS),
+        done: false,
+    });
+    const [splashVisible, setSplashVisible] = useState(true);
+    // Hard timeout — useEffect so cleanup runs on unmount
+    useEffect(() => {
+        const t = setTimeout(() => {
+            splashRef.current.done = true;
+            setSplashVisible(false);
+        }, SPLASH_TIMEOUT_MS);
+        return () => clearTimeout(t);
+    }, []);
+    const splashDone = useCallback((step) => {
+        splashRef.current.steps.delete(step);
+        if (splashRef.current.steps.size === 0 && !splashRef.current.done) {
+            splashRef.current.done = true;
+            setSplashVisible(false);
+        }
+    }, []);
+    const showPopup = useCallback((content) => {
+        const id = String(++popupCounter.current);
+        setPopups((prev) => [...prev, { id, content }]);
+        return id;
+    }, []);
+    const hidePopup = useCallback((id) => {
+        setPopups((prev) => prev.filter((p) => p.id !== id));
+    }, []);
+    const hideAllPopups = useCallback(() => setPopups([]), []);
+    const runAsync = useCallback(async (label, fn, options) => {
+        asyncCount.current++;
+        asyncOptions.current = options;
+        setAsyncLabel(label);
+        try {
+            await fn();
+        }
+        finally {
+            asyncCount.current--;
+            if (asyncCount.current === 0) {
+                asyncOptions.current = undefined;
+                setAsyncLabel(null);
+            }
+        }
+    }, []);
+    const resolvedLocalizer = localizerProp ?? ((key) => key);
+    const ctx = useMemo(() => ({
+        userId,
+        user,
+        socket,
+        showPopup,
+        hidePopup,
+        hideAllPopups,
+        runAsync,
+        splashDone,
+        localizer: resolvedLocalizer,
+    }), 
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [
+        userId,
+        user,
+        socket,
+        showPopup,
+        hidePopup,
+        hideAllPopups,
+        runAsync,
+        splashDone,
+        localizerProp,
+    ]);
+    const defaultLoadingOverlay = (_jsx("div", { style: {
+            position: 'fixed',
+            inset: 0,
+            background: 'rgba(0,0,0,0.4)',
+            display: 'flex',
+            alignItems: 'center',
+            justifyContent: 'center',
+            zIndex: 9999,
+        }, children: _jsx("span", { children: "Loading\u2026" }) }));
+    const defaultSplash = (_jsx("div", { style: {
+            position: 'fixed',
+            inset: 0,
+            background: '#fff',
+            display: 'flex',
+            alignItems: 'center',
+            justifyContent: 'center',
+            zIndex: 99999,
+        }, children: _jsx("span", { children: "Loading\u2026" }) }));
+    return (_jsxs(AppContext.Provider, { value: ctx, children: [children, _jsx(PopupLayer, { popups: popups }), asyncLabel !== null &&
+                (loadingOverlay
+                    ? cloneElement(loadingOverlay, {
+                        label: asyncLabel,
+                        asyncOptions: asyncOptions.current,
+                    })
+                    : defaultLoadingOverlay), splashVisible && (splashScreen ?? defaultSplash)] }));
+}
+export function useLocalizer() {
+    return useApp().localizer;
+}
+function PopupLayer({ popups }) {
+    if (popups.length === 0)
+        return null;
+    return (_jsx("div", { style: {
+            position: 'fixed',
+            inset: 0,
+            pointerEvents: 'none',
+            zIndex: 9000,
+        }, children: popups.map((p) => (_jsx("div", { style: { position: 'absolute', inset: 0, pointerEvents: 'all' }, children: p.content }, p.id))) }));
+}
+//# sourceMappingURL=AppProvider.js.map

package/dist/client/AppProvider.js.map

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

package/dist/client/ErrorLog.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Client-side error capture.
+ *
+ * Classifies the error, logs it to the console, and POSTs it to
+ * /api/client-error using a fire-and-forget fetch so callers never block
+ * on network I/O and a failed request never propagates.
+ */
+/**
+ * Capture a client-side error: log to console and POST to /api/client-error.
+ *
+ * @param message  A const string following the pattern '[Area] Description of cause'
+ * @param error    The caught value (typically an Error instance)
+ * @param context  Optional key/value pairs for structured diagnostics
+ */
+export declare function captureClientError(message: string, error: unknown, context?: Record<string, unknown>): void;
+//# sourceMappingURL=ErrorLog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorLog.d.ts","sourceRoot":"","sources":["../../src/client/ErrorLog.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CAcN"}

package/dist/client/ErrorLog.js

@@ -0,0 +1,28 @@
+/**
+ * Client-side error capture.
+ *
+ * Classifies the error, logs it to the console, and POSTs it to
+ * /api/client-error using a fire-and-forget fetch so callers never block
+ * on network I/O and a failed request never propagates.
+ */
+/**
+ * Capture a client-side error: log to console and POST to /api/client-error.
+ *
+ * @param message  A const string following the pattern '[Area] Description of cause'
+ * @param error    The caught value (typically an Error instance)
+ * @param context  Optional key/value pairs for structured diagnostics
+ */
+export function captureClientError(message, error, context) {
+    const stack = error instanceof Error ? error.stack : undefined;
+    // Log locally so developers see it in the browser console immediately.
+    console.error(message, error, context);
+    // Fire-and-forget POST — never await, never throw.
+    fetch('/api/client-error', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ message, stack, context }),
+    }).catch(() => {
+        // Intentionally swallowed — logging failures must never cause further errors.
+    });
+}
+//# sourceMappingURL=ErrorLog.js.map

package/dist/client/ErrorLog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorLog.js","sourceRoot":"","sources":["../../src/client/ErrorLog.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAe,EACf,KAAc,EACd,OAAiC;IAEjC,MAAM,KAAK,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAE/D,uEAAuE;IACvE,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAEvC,mDAAmD;IACnD,KAAK,CAAC,mBAAmB,EAAE;QACzB,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;KAClD,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;QACZ,8EAA8E;IAChF,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/client/FeedbackContext.d.ts

@@ -0,0 +1,7 @@
+/** Set a context value to include with the next feedback submission. */
+export declare function setFeedbackContext(key: string, value: string): void;
+/** Get all current context values. */
+export declare function getFeedbackContext(): Record<string, string>;
+/** Clear all context — Call this on navigation to reset context between pages. */
+export declare function clearFeedbackContext(): void;
+//# sourceMappingURL=FeedbackContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FeedbackContext.d.ts","sourceRoot":"","sources":["../../src/client/FeedbackContext.ts"],"names":[],"mappings":"AAEA,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAEnE;AAED,sCAAsC;AACtC,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE3D;AAED,kFAAkF;AAClF,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}

package/dist/client/FeedbackContext.js

@@ -0,0 +1,15 @@
+const context = {};
+/** Set a context value to include with the next feedback submission. */
+export function setFeedbackContext(key, value) {
+    context[key] = value;
+}
+/** Get all current context values. */
+export function getFeedbackContext() {
+    return { ...context };
+}
+/** Clear all context — Call this on navigation to reset context between pages. */
+export function clearFeedbackContext() {
+    for (const key of Object.keys(context))
+        delete context[key];
+}
+//# sourceMappingURL=FeedbackContext.js.map

package/dist/client/FeedbackContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeedbackContext.js","sourceRoot":"","sources":["../../src/client/FeedbackContext.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,GAA2B,EAAE,CAAC;AAE3C,wEAAwE;AACxE,MAAM,UAAU,kBAAkB,CAAC,GAAW,EAAE,KAAa;IAC3D,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AACvB,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,kBAAkB;IAChC,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;AACxB,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,oBAAoB;IAClC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;AAC9D,CAAC"}

package/dist/client/Logger.d.ts

@@ -0,0 +1,2 @@
+export declare function initClientLogger(serverUrl?: string): void;
+//# sourceMappingURL=Logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../src/client/Logger.ts"],"names":[],"mappings":"AAgDA,wBAAgB,gBAAgB,CAAC,SAAS,SAAK,GAAG,IAAI,CAqCrD"}

package/dist/client/Logger.js

@@ -0,0 +1,72 @@
+const buffer = [];
+let flushTimer = null;
+function flush(serverUrl) {
+    if (buffer.length === 0)
+        return;
+    const entries = buffer.splice(0);
+    // Fire-and-forget — never throw from logging
+    fetch(`${serverUrl}/logs/client`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ entries }),
+    }).catch(() => { });
+}
+function schedule(serverUrl) {
+    if (flushTimer)
+        return;
+    flushTimer = setTimeout(() => {
+        flushTimer = null;
+        flush(serverUrl);
+    }, 2000);
+}
+function capture(level, args, serverUrl) {
+    const message = args
+        .map((a) => (a instanceof Error ? a.message : String(a)))
+        .join(' ');
+    const stack = args.find((a) => a instanceof Error) instanceof Error
+        ? args.find((a) => a instanceof Error).stack
+        : undefined;
+    buffer.push({
+        level,
+        message,
+        stack,
+        url: window.location.href,
+        timestamp: Date.now(),
+    });
+    schedule(serverUrl);
+}
+export function initClientLogger(serverUrl = '') {
+    const origError = console.error.bind(console);
+    const origWarn = console.warn.bind(console);
+    console.error = (...args) => {
+        origError(...args);
+        capture('error', args, serverUrl);
+    };
+    console.warn = (...args) => {
+        origWarn(...args);
+        capture('warn', args, serverUrl);
+    };
+    window.addEventListener('error', (e) => {
+        buffer.push({
+            level: 'error',
+            message: e.message,
+            stack: e.error?.stack,
+            url: window.location.href,
+            timestamp: Date.now(),
+        });
+        schedule(serverUrl);
+    });
+    window.addEventListener('unhandledrejection', (e) => {
+        const message = e.reason instanceof Error ? e.reason.message : String(e.reason);
+        const stack = e.reason instanceof Error ? e.reason.stack : undefined;
+        buffer.push({
+            level: 'error',
+            message,
+            stack,
+            url: window.location.href,
+            timestamp: Date.now(),
+        });
+        schedule(serverUrl);
+    });
+}
+//# sourceMappingURL=Logger.js.map

package/dist/client/Logger.js.map

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