wacrawl-dashboard 0.1.2 → 0.2.0

package/apps/api/dist/routes/sync.js

@@ -0,0 +1,60 @@
+import { Router } from 'express';
+import { readArchiveSyncInfo, startSync, syncEnabled, syncJobStatus, } from '../lib/archiveSync.js';
+import { getResolvedPaths } from '../runtimePaths.js';
+export const syncRouter = Router();
+/**
+ * Every other route here is a readonly GET, so CORS hiding the response body is
+ * protection enough. This one spawns a process, and CORS does not stop the
+ * request from arriving — a page on any origin can fire a "simple" cross-origin
+ * POST at 127.0.0.1 and never read the reply.
+ *
+ * Requiring a header the browser does not consider simple forces a preflight,
+ * which the origin check in `createApp` rejects for anything but loopback.
+ */
+export const SYNC_REQUEST_HEADER = 'x-wacrawl-request';
+const requireDashboardOrigin = (req, res, next) => {
+    if (req.headers[SYNC_REQUEST_HEADER] !== '1') {
+        res.status(403).json({
+            error: {
+                code: 'MISSING_REQUEST_HEADER',
+                message: `Sync requests must send ${SYNC_REQUEST_HEADER}: 1.`,
+            },
+        });
+        return;
+    }
+    next();
+};
+syncRouter.get('/status', (_req, res) => {
+    // Job state changes second to second while an import runs; a cached poll
+    // response would report a finished sync as still running.
+    res.setHeader('Cache-Control', 'no-store');
+    res.json({
+        enabled: syncEnabled(),
+        job: syncJobStatus(),
+        archive: readArchiveSyncInfo(),
+    });
+});
+syncRouter.post('/', requireDashboardOrigin, (_req, res) => {
+    if (!syncEnabled()) {
+        res.status(403).json({
+            error: {
+                code: 'SYNC_DISABLED',
+                message: 'Archive sync is disabled by WACRAWL_DISABLE_SYNC.',
+            },
+        });
+        return;
+    }
+    const { primaryDb } = getResolvedPaths();
+    const { started, job } = startSync(primaryDb);
+    if (!started) {
+        res.status(409).json({
+            error: {
+                code: 'SYNC_ALREADY_RUNNING',
+                message: 'An archive sync is already running.',
+            },
+            job,
+        });
+        return;
+    }
+    res.status(202).json({ job });
+});

package/apps/api/dist/scripts/generateDemoArchive.js

@@ -0,0 +1,24 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { parseArgs } from 'node:util';
+import { DEFAULT_DEMO_SEED, generateDemoArchive } from '../demo/demoArchive.js';
+const { values } = parseArgs({
+    options: {
+        out: { type: 'string' },
+        seed: { type: 'string', default: String(DEFAULT_DEMO_SEED) },
+        now: { type: 'string' },
+    },
+});
+const seed = Number(values.seed);
+const now = values.now ? new Date(values.now) : new Date();
+if (!Number.isInteger(seed) || Number.isNaN(now.getTime())) {
+    console.error('Usage: generateDemoArchive [--out <dir>] [--seed <integer>] [--now <ISO date>]');
+    process.exit(1);
+}
+const dir = values.out ? path.resolve(values.out) : fs.mkdtempSync(path.join(os.tmpdir(), 'wacrawl-demo-'));
+const startedAt = Date.now();
+const archive = generateDemoArchive({ dir, seed, now });
+console.log(`Wrote ${archive.messages} messages across ${archive.chats} chats in ${Date.now() - startedAt}ms.`);
+console.log(`WACRAWL_DB=${archive.dbPath}`);
+console.log(`WACRAWL_MEDIA_ROOT=${archive.mediaRoot}`);

package/apps/api/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@wacrawl/api",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc -p tsconfig.json",
+    "start": "node dist/index.js",
+    "optimize-db": "tsx src/scripts/optimizeDb.ts",
+    "demo:generate": "tsx src/scripts/generateDemoArchive.ts",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "better-sqlite3": "^12.4.6",
+    "cors": "^2.8.5",
+    "date-fns": "^4.1.0",
+    "dotenv": "^17.2.3",
+    "express": "^5.2.1",
+    "stopword": "^3.1.5"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/cors": "^2.8.19",
+    "@types/express": "^5.0.6",
+    "@types/node": "^25.0.3",
+    "tsx": "^4.21.0",
+    "vitest": "^4.0.15"
+  }
+}