pot-api 0.1.0 → 0.2.0

package/dist/index.js

@@ -2,13 +2,13 @@
 import express from 'express';
 import { verify } from 'pot-sdk';
 import { resolveKeys, buildApiKeyRecord, validateConfig } from './config.js';
-import { createJob, getJob, updateJob } from './jobs.js';
+import { createJob, getJob, updateJob } from './queue.js';
 const app = express();
 app.use(express.json({ limit: '1mb' }));
 const PORT = parseInt(process.env.PORT ?? '3141', 10);
 // ─── Health ───────────────────────────────────────────────
 app.get('/', (_req, res) => {
-    res.json({ name: 'pot-api', version: '0.1.0', status: 'ok' });
+    res.json({ name: 'pot-api', version: '0.2.0', status: 'ok', queue: process.env.REDIS_URL ? 'redis' : 'memory' });
 });
 // ─── Sync verify ──────────────────────────────────────────
 app.post('/verify', async (req, res) => {
@@ -36,7 +36,7 @@ app.post('/verify', async (req, res) => {
     }
 });
 // ─── Async verify ─────────────────────────────────────────
-app.post('/verify/async', (req, res) => {
+app.post('/verify/async', async (req, res) => {
     const { output, question, tier = 'basic', callbackUrl, apiKeys } = req.body;
     if (!output || !question) {
         res.status(400).json({ error: 'output and question are required' });
@@ -48,14 +48,14 @@ app.post('/verify/async', (req, res) => {
         res.status(400).json({ error: configError });
         return;
     }
-    const job = createJob({ output, question, tier, callbackUrl });
+    const job = await createJob({ output, question, tier, callbackUrl });
     res.status(202).json({ jobId: job.id, status: 'pending', pollUrl: `/jobs/${job.id}` });
-    // Run in background
+    // Run in background (no await — fire and forget)
     runJob(job.id, output, question, tier, buildApiKeyRecord(keys), callbackUrl);
 });
 // ─── Poll job status ───────────────────────────────────────
-app.get('/jobs/:id', (req, res) => {
-    const job = getJob(req.params.id);
+app.get('/jobs/:id', async (req, res) => {
+    const job = await getJob(req.params.id);
     if (!job) {
         res.status(404).json({ error: 'Job not found' });
         return;
@@ -64,17 +64,17 @@ app.get('/jobs/:id', (req, res) => {
 });
 // ─── Background runner + webhook push ────────────────────
 async function runJob(jobId, output, question, tier, apiKeys, callbackUrl) {
-    updateJob(jobId, { status: 'running' });
+    await updateJob(jobId, { status: 'running' });
     try {
         const result = await verify(output, { tier, apiKeys, question });
-        updateJob(jobId, { status: 'done', result });
+        await updateJob(jobId, { status: 'done', result });
         if (callbackUrl) {
             await pushWebhook(callbackUrl, { jobId, status: 'done', result });
         }
     }
     catch (err) {
         const error = err instanceof Error ? err.message : String(err);
-        updateJob(jobId, { status: 'error', error });
+        await updateJob(jobId, { status: 'error', error });
         if (callbackUrl) {
             await pushWebhook(callbackUrl, { jobId, status: 'error', error });
         }

package/dist/queue.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Queue abstraction for pot-api.
+ *
+ * Auto-selects backend based on REDIS_URL env var:
+ *   - REDIS_URL set → BullMQ (persistent, survives restarts)
+ *   - REDIS_URL unset → In-Memory Map (default, zero dependencies)
+ *
+ * No breaking changes to the API surface.
+ */
+import type { Job } from './jobs.js';
+export interface QueueBackend {
+    createJob(input: Job['input']): Promise<Job> | Job;
+    getJob(id: string): Promise<Job | undefined> | Job | undefined;
+    updateJob(id: string, patch: Partial<Job>): Promise<void> | void;
+}
+export declare function getQueue(): QueueBackend;
+export declare function createJob(input: Job['input']): Promise<Job>;
+export declare function getJob(id: string): Promise<Job | undefined>;
+export declare function updateJob(id: string, patch: Partial<Job>): Promise<void>;

package/dist/queue.js

@@ -0,0 +1,125 @@
+/**
+ * Queue abstraction for pot-api.
+ *
+ * Auto-selects backend based on REDIS_URL env var:
+ *   - REDIS_URL set → BullMQ (persistent, survives restarts)
+ *   - REDIS_URL unset → In-Memory Map (default, zero dependencies)
+ *
+ * No breaking changes to the API surface.
+ */
+import { randomUUID } from 'crypto';
+// ─── In-Memory Backend (default) ─────────────────────────────────────────────
+class InMemoryBackend {
+    store = new Map();
+    constructor() {
+        // Auto-cleanup jobs older than 1h
+        setInterval(() => {
+            const cutoff = Date.now() - 60 * 60 * 1000;
+            for (const [id, job] of this.store.entries()) {
+                if (new Date(job.createdAt).getTime() < cutoff) {
+                    this.store.delete(id);
+                }
+            }
+        }, 10 * 60 * 1000).unref();
+    }
+    createJob(input) {
+        const job = {
+            id: randomUUID(),
+            status: 'pending',
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+            input,
+        };
+        this.store.set(job.id, job);
+        return job;
+    }
+    getJob(id) {
+        return this.store.get(id);
+    }
+    updateJob(id, patch) {
+        const job = this.store.get(id);
+        if (job) {
+            Object.assign(job, patch, { updatedAt: new Date().toISOString() });
+        }
+    }
+}
+// ─── BullMQ Backend (optional, requires REDIS_URL) ───────────────────────────
+class BullMQBackend {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    client;
+    prefix = 'pot-api:jobs';
+    ready;
+    constructor(redisUrl) {
+        // eslint-disable-next-line @typescript-eslint/no-implied-eval
+        this.ready = (new Function('m', 'return import(m)'))('ioredis').then(({ default: Redis }) => {
+            this.client = new Redis(redisUrl, {
+                maxRetriesPerRequest: 3,
+                lazyConnect: false,
+            });
+            this.client.on('error', (err) => {
+                console.error('[pot-api] Redis error:', err.message);
+            });
+        });
+    }
+    key(id) {
+        return `${this.prefix}:${id}`;
+    }
+    async createJob(input) {
+        await this.ready;
+        const job = {
+            id: randomUUID(),
+            status: 'pending',
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+            input,
+        };
+        // Store as JSON string, TTL = 24h
+        await this.client.set(this.key(job.id), JSON.stringify(job), 'EX', 86400);
+        return job;
+    }
+    async getJob(id) {
+        await this.ready;
+        const raw = await this.client.get(this.key(id));
+        if (!raw)
+            return undefined;
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async updateJob(id, patch) {
+        await this.ready;
+        const job = await this.getJob(id);
+        if (!job)
+            return;
+        const updated = { ...job, ...patch, updatedAt: new Date().toISOString() };
+        await this.client.set(this.key(job.id), JSON.stringify(updated), 'EX', 86400);
+    }
+}
+// ─── Factory ─────────────────────────────────────────────────────────────────
+let _backend = null;
+export function getQueue() {
+    if (_backend)
+        return _backend;
+    const redisUrl = process.env.REDIS_URL;
+    if (redisUrl) {
+        _backend = new BullMQBackend(redisUrl);
+        console.log('[pot-api] Using Redis backend:', redisUrl.replace(/:\/\/.*@/, '://***@'));
+    }
+    else {
+        _backend = new InMemoryBackend();
+    }
+    return _backend;
+}
+// ─── Convenience wrappers (same API as jobs.ts) ───────────────────────────────
+export async function createJob(input) {
+    return getQueue().createJob(input);
+}
+export async function getJob(id) {
+    return getQueue().getJob(id);
+}
+export async function updateJob(id, patch) {
+    return getQueue().updateJob(id, patch);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pot-api",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "REST API server for pot-sdk — sync and async AI output verification with webhook callbacks",
   "type": "module",
   "license": "MIT",
@@ -8,7 +8,10 @@
     "pot-api": "dist/index.js"
   },
   "main": "./dist/index.js",
-  "files": ["dist", "README.md"],
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "scripts": {
     "build": "tsc",
     "prepare": "npm run build && chmod +x dist/index.js",
@@ -17,11 +20,12 @@
   },
   "dependencies": {
     "express": "^4.18.0",
-    "pot-sdk": "^0.1.0"
+    "pot-sdk": "^0.1.0",
+    "ioredis": "^5.3.2"
   },
   "devDependencies": {
     "@types/express": "^4.17.0",
     "@types/node": "^25.3.0",
     "typescript": "^5.3.0"
   }
-}
+}