clodds 1.1.0

package/dist/api/index.js

@@ -0,0 +1,55 @@
+"use strict";
+/**
+ * Clodds Hosted API - x402 Pay-per-prompt API Gateway
+ *
+ * Architecture:
+ * - x402 payment verification middleware
+ * - Job queue for async prompt execution
+ * - Custody wallet system for managed accounts
+ *
+ * Usage:
+ * ```typescript
+ * import { createApiGateway } from './api';
+ *
+ * const api = createApiGateway({
+ *   port: 3000,
+ *   pricing: { basic: 0.05, standard: 0.10, complex: 0.25 },
+ *   x402: { network: 'base', privateKey: '0x...' },
+ * });
+ *
+ * await api.start();
+ * ```
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFeeCalculator = exports.parseApiKey = exports.createApiKeyManager = exports.createCustodyManager = exports.createX402Middleware = exports.createPromptHandler = exports.createJobManager = exports.createApiGateway = void 0;
+var gateway_1 = require("./gateway");
+Object.defineProperty(exports, "createApiGateway", { enumerable: true, get: function () { return gateway_1.createApiGateway; } });
+var jobs_1 = require("./jobs");
+Object.defineProperty(exports, "createJobManager", { enumerable: true, get: function () { return jobs_1.createJobManager; } });
+var prompt_1 = require("./prompt");
+Object.defineProperty(exports, "createPromptHandler", { enumerable: true, get: function () { return prompt_1.createPromptHandler; } });
+var middleware_1 = require("./middleware");
+Object.defineProperty(exports, "createX402Middleware", { enumerable: true, get: function () { return middleware_1.createX402Middleware; } });
+var custody_1 = require("./custody");
+Object.defineProperty(exports, "createCustodyManager", { enumerable: true, get: function () { return custody_1.createCustodyManager; } });
+var apikeys_1 = require("./apikeys");
+Object.defineProperty(exports, "createApiKeyManager", { enumerable: true, get: function () { return apikeys_1.createApiKeyManager; } });
+Object.defineProperty(exports, "parseApiKey", { enumerable: true, get: function () { return apikeys_1.parseApiKey; } });
+var fees_1 = require("./fees");
+Object.defineProperty(exports, "createFeeCalculator", { enumerable: true, get: function () { return fees_1.createFeeCalculator; } });
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;AAEH,qCAA8D;AAArD,2GAAA,gBAAgB,OAAA;AACzB,+BAAoF;AAA3E,wGAAA,gBAAgB,OAAA;AACzB,mCAAsF;AAA7E,6GAAA,mBAAmB,OAAA;AAC5B,2CAA+E;AAAtE,kHAAA,oBAAoB,OAAA;AAC7B,qCAA0F;AAAjF,+GAAA,oBAAoB,OAAA;AAC7B,qCAAoG;AAA3F,8GAAA,mBAAmB,OAAA;AAAyC,sGAAA,WAAW,OAAA;AAChF,+BAAoG;AAA3F,2GAAA,mBAAmB,OAAA;AAC5B,0CAAwB"}

package/dist/api/jobs.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Job Manager - Async job queue for prompt execution
+ *
+ * Features:
+ * - In-memory queue with optional persistence
+ * - Concurrency control
+ * - Timeout handling
+ * - Retry logic
+ * - Webhook callbacks
+ */
+import { EventEmitter } from 'eventemitter3';
+import type { JobQueueConfig, JobData, JobStatusType, ApiRequest, PromptResultData, PricingTier } from './types';
+export interface JobManager extends EventEmitter {
+    /** Create a new job */
+    create(request: ApiRequest, tier: PricingTier, cost: number): Job;
+    /** Get job by ID */
+    get(id: string): Job | null;
+    /** Get all jobs for a wallet */
+    getByWallet(wallet: string, limit?: number): Job[];
+    /** Cancel a job */
+    cancel(id: string): boolean;
+    /** Process next job in queue */
+    processNext(): Promise<void>;
+    /** Start job processing */
+    start(): void;
+    /** Stop job processing */
+    stop(): void;
+    /** Get queue statistics */
+    getStats(): JobStats;
+    /** Clean up old jobs */
+    cleanup(): number;
+}
+export interface Job {
+    /** Job ID */
+    id: string;
+    /** Get job data */
+    getData(): JobData;
+    /** Update status */
+    setStatus(status: JobStatusType): void;
+    /** Set result */
+    setResult(result: PromptResultData): void;
+    /** Set error */
+    setError(error: string): void;
+    /** Increment retry count */
+    retry(): boolean;
+    /** Save to disk */
+    save(): void;
+}
+export interface JobStats {
+    pending: number;
+    processing: number;
+    completed: number;
+    failed: number;
+    cancelled: number;
+    total: number;
+}
+export type JobExecutor = (job: Job) => Promise<PromptResultData>;
+export declare function createJobManager(config?: JobQueueConfig, executor?: JobExecutor): JobManager;
+export type { JobData, JobStatusType };

package/dist/api/jobs.js

@@ -0,0 +1,362 @@
+"use strict";
+/**
+ * Job Manager - Async job queue for prompt execution
+ *
+ * Features:
+ * - In-memory queue with optional persistence
+ * - Concurrency control
+ * - Timeout handling
+ * - Retry logic
+ * - Webhook callbacks
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createJobManager = createJobManager;
+const eventemitter3_1 = require("eventemitter3");
+const crypto_1 = require("crypto");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const os_1 = require("os");
+const logger_1 = require("../utils/logger");
+// =============================================================================
+// CONSTANTS
+// =============================================================================
+const DEFAULT_CONFIG = {
+    concurrency: 10,
+    timeout: 120000,
+    retention: 86400000, // 24 hours
+    persist: true,
+    storageDir: (0, path_1.join)((0, os_1.homedir)(), '.clodds', 'api', 'jobs'),
+};
+const MAX_RETRIES = 3;
+// =============================================================================
+// IMPLEMENTATION
+// =============================================================================
+function createJobManager(config = {}, executor) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    const emitter = new eventemitter3_1.EventEmitter();
+    // Job storage
+    const jobs = new Map();
+    const queue = []; // Job IDs in order
+    let processing = 0;
+    let isRunning = false;
+    let processInterval = null;
+    // Ensure storage directory exists
+    if (cfg.persist) {
+        (0, fs_1.mkdirSync)(cfg.storageDir, { recursive: true });
+        loadPersistedJobs();
+    }
+    function generateId() {
+        return `job_${Date.now().toString(36)}_${(0, crypto_1.randomBytes)(4).toString('hex')}`;
+    }
+    function loadPersistedJobs() {
+        try {
+            const files = (0, fs_1.readdirSync)(cfg.storageDir).filter(f => f.endsWith('.json'));
+            for (const file of files) {
+                try {
+                    const data = JSON.parse((0, fs_1.readFileSync)((0, path_1.join)(cfg.storageDir, file), 'utf-8'));
+                    jobs.set(data.id, data);
+                    // Re-queue pending jobs
+                    if (data.status === 'pending' || data.status === 'processing') {
+                        data.status = 'pending';
+                        queue.push(data.id);
+                    }
+                }
+                catch (e) {
+                    logger_1.logger.warn({ file }, 'Failed to load persisted job');
+                }
+            }
+            logger_1.logger.info({ count: jobs.size, queued: queue.length }, 'Loaded persisted jobs');
+        }
+        catch (e) {
+            logger_1.logger.debug('No persisted jobs found');
+        }
+    }
+    function persistJob(data) {
+        if (!cfg.persist)
+            return;
+        try {
+            const filePath = (0, path_1.join)(cfg.storageDir, `${data.id}.json`);
+            (0, fs_1.writeFileSync)(filePath, JSON.stringify(data, null, 2));
+        }
+        catch (e) {
+            logger_1.logger.error({ jobId: data.id, error: e }, 'Failed to persist job');
+        }
+    }
+    function deletePersistedJob(id) {
+        if (!cfg.persist)
+            return;
+        try {
+            const filePath = (0, path_1.join)(cfg.storageDir, `${id}.json`);
+            if ((0, fs_1.existsSync)(filePath)) {
+                (0, fs_1.unlinkSync)(filePath);
+            }
+        }
+        catch (e) {
+            logger_1.logger.debug({ jobId: id }, 'Failed to delete persisted job');
+        }
+    }
+    function createJobWrapper(data) {
+        return {
+            id: data.id,
+            getData: () => ({ ...data }),
+            setStatus: (status) => {
+                data.status = status;
+                data.updatedAt = Date.now();
+                if (status === 'processing') {
+                    data.startedAt = Date.now();
+                }
+                else if (status === 'completed' || status === 'failed' || status === 'cancelled') {
+                    data.completedAt = Date.now();
+                }
+                persistJob(data);
+                emitter.emit('job:status', { id: data.id, status });
+            },
+            setResult: (result) => {
+                data.result = result;
+                data.status = 'completed';
+                data.completedAt = Date.now();
+                data.updatedAt = Date.now();
+                persistJob(data);
+                emitter.emit('job:completed', { id: data.id, result });
+                sendWebhook(data);
+            },
+            setError: (error) => {
+                data.error = error;
+                data.status = 'failed';
+                data.completedAt = Date.now();
+                data.updatedAt = Date.now();
+                persistJob(data);
+                emitter.emit('job:failed', { id: data.id, error });
+                sendWebhook(data);
+            },
+            retry: () => {
+                if (data.retries >= MAX_RETRIES) {
+                    return false;
+                }
+                data.retries++;
+                data.status = 'pending';
+                data.updatedAt = Date.now();
+                queue.push(data.id);
+                persistJob(data);
+                return true;
+            },
+            save: () => persistJob(data),
+        };
+    }
+    async function sendWebhook(data) {
+        const callbackUrl = data.request.callbackUrl;
+        if (!callbackUrl)
+            return;
+        try {
+            const timestamp = Date.now();
+            const bodyStr = JSON.stringify({
+                event: data.status === 'completed' ? 'job.completed' : data.status === 'failed' ? 'job.failed' : 'job.cancelled',
+                job: data,
+                timestamp,
+            });
+            // Create HMAC signature using job ID + wallet as secret
+            // Client can verify: HMAC-SHA256(jobId + wallet, body) === X-Clodds-Signature
+            const secret = `${data.id}:${data.request.wallet}`;
+            const signature = (0, crypto_1.createHmac)('sha256', secret).update(bodyStr).digest('hex');
+            const payload = {
+                ...JSON.parse(bodyStr),
+                signature,
+            };
+            await fetch(callbackUrl, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-Clodds-Signature': signature,
+                    'X-Clodds-Timestamp': timestamp.toString(),
+                    'X-Clodds-Version': '1.0.0',
+                    'User-Agent': 'Clodds-Webhook/1.0',
+                },
+                body: JSON.stringify(payload),
+            });
+            logger_1.logger.debug({ jobId: data.id, callbackUrl }, 'Webhook sent');
+        }
+        catch (e) {
+            logger_1.logger.warn({ jobId: data.id, callbackUrl, error: e }, 'Webhook delivery failed');
+        }
+    }
+    function create(request, tier, cost) {
+        const id = generateId();
+        const now = Date.now();
+        const data = {
+            id,
+            request,
+            status: 'pending',
+            createdAt: now,
+            updatedAt: now,
+            retries: 0,
+            cost,
+            tier,
+        };
+        jobs.set(id, data);
+        queue.push(id);
+        persistJob(data);
+        emitter.emit('job:created', { id, request });
+        logger_1.logger.info({ jobId: id, wallet: request.wallet, tier, cost }, 'Job created');
+        // Trigger processing
+        if (isRunning) {
+            setImmediate(() => processNext());
+        }
+        return createJobWrapper(data);
+    }
+    function get(id) {
+        const data = jobs.get(id);
+        if (!data)
+            return null;
+        return createJobWrapper(data);
+    }
+    function getByWallet(wallet, limit = 10) {
+        const results = [];
+        const walletLower = wallet.toLowerCase();
+        for (const data of jobs.values()) {
+            if (data.request.wallet.toLowerCase() === walletLower) {
+                results.push(createJobWrapper(data));
+                if (results.length >= limit)
+                    break;
+            }
+        }
+        // Sort by created time descending
+        return results.sort((a, b) => b.getData().createdAt - a.getData().createdAt);
+    }
+    function cancel(id) {
+        const data = jobs.get(id);
+        if (!data)
+            return false;
+        if (data.status !== 'pending' && data.status !== 'processing') {
+            return false;
+        }
+        data.status = 'cancelled';
+        data.completedAt = Date.now();
+        data.updatedAt = Date.now();
+        persistJob(data);
+        // Remove from queue
+        const idx = queue.indexOf(id);
+        if (idx !== -1) {
+            queue.splice(idx, 1);
+        }
+        emitter.emit('job:cancelled', { id });
+        sendWebhook(data);
+        logger_1.logger.info({ jobId: id }, 'Job cancelled');
+        return true;
+    }
+    async function processNext() {
+        if (!isRunning)
+            return;
+        if (processing >= cfg.concurrency)
+            return;
+        if (queue.length === 0)
+            return;
+        const jobId = queue.shift();
+        if (!jobId)
+            return;
+        const data = jobs.get(jobId);
+        if (!data || data.status !== 'pending') {
+            // Job was cancelled or already processed
+            return processNext();
+        }
+        const job = createJobWrapper(data);
+        processing++;
+        try {
+            job.setStatus('processing');
+            logger_1.logger.debug({ jobId }, 'Processing job');
+            if (!executor) {
+                throw new Error('No job executor configured');
+            }
+            // Execute with timeout
+            const result = await Promise.race([
+                executor(job),
+                new Promise((_, reject) => setTimeout(() => reject(new Error('Job timeout')), cfg.timeout)),
+            ]);
+            job.setResult(result);
+            logger_1.logger.info({ jobId, executionTime: result.executionTime }, 'Job completed');
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            logger_1.logger.error({ jobId, error: errorMsg }, 'Job failed');
+            // Retry logic
+            if (job.retry()) {
+                logger_1.logger.info({ jobId, retries: data.retries }, 'Job queued for retry');
+            }
+            else {
+                job.setError(errorMsg);
+            }
+        }
+        finally {
+            processing--;
+            // Process next job
+            setImmediate(() => processNext());
+        }
+    }
+    function start() {
+        if (isRunning)
+            return;
+        isRunning = true;
+        // Process queue
+        processNext();
+        // Periodic queue check
+        processInterval = setInterval(() => {
+            if (queue.length > 0 && processing < cfg.concurrency) {
+                processNext();
+            }
+        }, 1000);
+        logger_1.logger.info({ concurrency: cfg.concurrency }, 'Job manager started');
+    }
+    function stop() {
+        isRunning = false;
+        if (processInterval) {
+            clearInterval(processInterval);
+            processInterval = null;
+        }
+        logger_1.logger.info('Job manager stopped');
+    }
+    function getStats() {
+        const stats = {
+            pending: 0,
+            processing: 0,
+            completed: 0,
+            failed: 0,
+            cancelled: 0,
+            total: 0,
+        };
+        for (const data of jobs.values()) {
+            stats.total++;
+            stats[data.status]++;
+        }
+        return stats;
+    }
+    function cleanup() {
+        const cutoff = Date.now() - cfg.retention;
+        let removed = 0;
+        for (const [id, data] of jobs) {
+            if (data.completedAt && data.completedAt < cutoff) {
+                jobs.delete(id);
+                deletePersistedJob(id);
+                removed++;
+            }
+        }
+        if (removed > 0) {
+            logger_1.logger.info({ removed }, 'Cleaned up old jobs');
+        }
+        return removed;
+    }
+    // Periodic cleanup
+    setInterval(cleanup, 3600000); // Every hour
+    // Attach methods to emitter
+    Object.assign(emitter, {
+        create,
+        get,
+        getByWallet,
+        cancel,
+        processNext,
+        start,
+        stop,
+        getStats,
+        cleanup,
+    });
+    return emitter;
+}
+//# sourceMappingURL=jobs.js.map

package/dist/api/jobs.js.map

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

package/dist/api/middleware.d.ts

@@ -0,0 +1,60 @@
+/**
+ * x402 Payment Middleware
+ *
+ * Handles HTTP 402 Payment Required flow:
+ * 1. Request arrives without payment
+ * 2. Return 402 with payment details
+ * 3. Client pays via x402 protocol
+ * 4. Client retries with payment proof
+ * 5. Verify payment and proceed
+ */
+import type { X402PaymentConfig, PaymentProof, PricingTier, PricingConfig } from './types';
+export interface X402MiddlewareConfig extends X402PaymentConfig {
+    /** Pricing configuration */
+    pricing?: PricingConfig;
+    /** Payment verification timeout (default: 30000ms) */
+    verificationTimeout?: number;
+    /** Cache verified payments (default: true) */
+    cachePayments?: boolean;
+    /** Payment cache TTL (default: 300000ms = 5min) */
+    cacheTtl?: number;
+}
+export interface X402Middleware {
+    /** Check if request has valid payment */
+    hasValidPayment(proof?: PaymentProof, requiredAmount?: number): Promise<boolean>;
+    /** Generate 402 response headers */
+    getPaymentRequiredHeaders(amount: number, tier: PricingTier): Record<string, string>;
+    /** Verify payment proof */
+    verifyPayment(proof: PaymentProof): Promise<PaymentVerificationResult>;
+    /** Get payment address */
+    getPaymentAddress(): string;
+    /** Calculate price for tier */
+    getPrice(tier: PricingTier): number;
+    /** Classify prompt to pricing tier */
+    classifyPrompt(prompt: string): PricingTier;
+    /** Get cached payment by hash */
+    getCachedPayment(txHash: string): PaymentProof | null;
+    /** Clear payment cache */
+    clearCache(): void;
+    /** Get statistics */
+    getStats(): PaymentStats;
+}
+export interface PaymentVerificationResult {
+    valid: boolean;
+    error?: string;
+    amount?: number;
+    token?: string;
+    network?: string;
+}
+export interface PaymentStats {
+    totalVerified: number;
+    totalRevenue: number;
+    cacheHits: number;
+    cacheMisses: number;
+    failedVerifications: number;
+}
+export declare function createX402Middleware(config?: X402MiddlewareConfig): X402Middleware;
+/**
+ * Create Express-compatible middleware
+ */
+export declare function createExpressX402Middleware(config?: X402MiddlewareConfig): (req: any, res: any, next: any) => Promise<any>;