agentspay 0.1.0 → 0.2.0

package/dist/disputes/dispute.d.ts

@@ -0,0 +1,50 @@
+export interface Dispute {
+    id: string;
+    paymentId: string;
+    buyerWalletId: string;
+    providerWalletId: string;
+    reason: string;
+    evidence?: string;
+    status: 'open' | 'under_review' | 'resolved_refund' | 'resolved_release' | 'resolved_split' | 'expired';
+    resolution?: 'refund' | 'release' | 'split';
+    splitPercent?: number;
+    resolvedAt?: string;
+    createdAt: string;
+}
+export interface DisputeResolution {
+    resolution: 'refund' | 'release' | 'split';
+    splitPercent?: number;
+}
+export declare class DisputeManager {
+    /**
+     * Open a new dispute
+     * Can only be opened by buyer within the dispute window
+     */
+    create(paymentId: string, buyerWalletId: string, reason: string, evidence?: string): Dispute | null;
+    /**
+     * Resolve a dispute (admin/platform only)
+     */
+    resolve(disputeId: string, resolution: DisputeResolution): Dispute | null;
+    /**
+     * Get dispute by ID
+     */
+    getById(id: string): Dispute | null;
+    /**
+     * Get dispute by payment ID
+     */
+    getByPaymentId(paymentId: string): Dispute | null;
+    /**
+     * List disputes filtered by wallet
+     */
+    listByWallet(walletId: string, status?: Dispute['status']): Dispute[];
+    /**
+     * List all disputes (admin only)
+     */
+    listAll(status?: Dispute['status']): Dispute[];
+    /**
+     * Check and auto-resolve expired dispute windows
+     * Should be called periodically or on payment completion
+     */
+    checkExpiredWindows(): void;
+}
+//# sourceMappingURL=dispute.d.ts.map

package/dist/disputes/dispute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispute.d.ts","sourceRoot":"","sources":["../../src/disputes/dispute.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,gBAAgB,EAAE,MAAM,CAAA;IACxB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,iBAAiB,GAAG,kBAAkB,GAAG,gBAAgB,GAAG,SAAS,CAAA;IACvG,UAAU,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAA;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAA;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,qBAAa,cAAc;IACzB;;;OAGG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IA2CnG;;OAEG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,GAAG,OAAO,GAAG,IAAI;IAkDzE;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAMnC;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAMjD;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,OAAO,EAAE;IAgBrE;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,OAAO,EAAE;IAU9C;;;OAGG;IACH,mBAAmB,IAAI,IAAI;CA4B5B"}

package/dist/disputes/dispute.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DisputeManager = void 0;
+const uuid_1 = require("uuid");
+const db_1 = require("../registry/db");
+const delivery_1 = require("../webhooks/delivery");
+class DisputeManager {
+    /**
+     * Open a new dispute
+     * Can only be opened by buyer within the dispute window
+     */
+    create(paymentId, buyerWalletId, reason, evidence) {
+        const db = (0, db_1.getDb)();
+        // Validate payment exists and is in escrowed state
+        const payment = db.prepare('SELECT * FROM payments WHERE id = ?').get(paymentId);
+        if (!payment)
+            throw new Error('Payment not found');
+        if (payment.status !== 'escrowed')
+            throw new Error('Can only dispute escrowed payments');
+        if (payment.buyerWalletId !== buyerWalletId)
+            throw new Error('Only buyer can open dispute');
+        // Check if dispute already exists
+        const existing = db.prepare('SELECT id FROM disputes WHERE paymentId = ?').get(paymentId);
+        if (existing)
+            throw new Error('Dispute already exists for this payment');
+        // Get service to check dispute window
+        const service = db.prepare('SELECT disputeWindow FROM services WHERE id = ?').get(payment.serviceId);
+        if (!service)
+            throw new Error('Service not found');
+        const disputeWindowMinutes = service.disputeWindow || 30;
+        const disputeDeadline = new Date(new Date(payment.completedAt || payment.createdAt).getTime() + disputeWindowMinutes * 60000);
+        if (new Date() > disputeDeadline) {
+            throw new Error(`Dispute window expired. Must file within ${disputeWindowMinutes} minutes of execution`);
+        }
+        const id = (0, uuid_1.v4)();
+        const now = new Date().toISOString();
+        db.prepare(`
+      INSERT INTO disputes (id, paymentId, buyerWalletId, providerWalletId, reason, evidence, status, createdAt)
+      VALUES (?, ?, ?, ?, ?, ?, 'open', ?)
+    `).run(id, paymentId, buyerWalletId, payment.sellerWalletId, reason, evidence || null, now);
+        // Update payment status to disputed
+        db.prepare('UPDATE payments SET disputeStatus = ? WHERE id = ?').run('disputed', paymentId);
+        const dispute = this.getById(id);
+        if (dispute) {
+            delivery_1.webhookDelivery.trigger('dispute.opened', dispute).catch(console.error);
+        }
+        return dispute;
+    }
+    /**
+     * Resolve a dispute (admin/platform only)
+     */
+    resolve(disputeId, resolution) {
+        const db = (0, db_1.getDb)();
+        const dispute = this.getById(disputeId);
+        if (!dispute)
+            throw new Error('Dispute not found');
+        if (dispute.status !== 'open' && dispute.status !== 'under_review') {
+            throw new Error('Dispute already resolved');
+        }
+        if (resolution.resolution === 'split') {
+            if (resolution.splitPercent === undefined || resolution.splitPercent < 0 || resolution.splitPercent > 100) {
+                throw new Error('splitPercent required for split resolution (0-100)');
+            }
+        }
+        const now = new Date().toISOString();
+        let status;
+        switch (resolution.resolution) {
+            case 'refund':
+                status = 'resolved_refund';
+                break;
+            case 'release':
+                status = 'resolved_release';
+                break;
+            case 'split':
+                status = 'resolved_split';
+                break;
+        }
+        db.prepare(`
+      UPDATE disputes 
+      SET status = ?, resolution = ?, splitPercent = ?, resolvedAt = ?
+      WHERE id = ?
+    `).run(status, resolution.resolution, resolution.splitPercent || null, now, disputeId);
+        // Update payment status based on resolution
+        const payment = db.prepare('SELECT * FROM payments WHERE id = ?').get(dispute.paymentId);
+        if (payment) {
+            db.prepare('UPDATE payments SET disputeStatus = ? WHERE id = ?').run(status, dispute.paymentId);
+        }
+        const resolvedDispute = this.getById(disputeId);
+        if (resolvedDispute) {
+            delivery_1.webhookDelivery.trigger('dispute.resolved', resolvedDispute).catch(console.error);
+        }
+        return resolvedDispute;
+    }
+    /**
+     * Get dispute by ID
+     */
+    getById(id) {
+        const db = (0, db_1.getDb)();
+        const row = db.prepare('SELECT * FROM disputes WHERE id = ?').get(id);
+        return row || null;
+    }
+    /**
+     * Get dispute by payment ID
+     */
+    getByPaymentId(paymentId) {
+        const db = (0, db_1.getDb)();
+        const row = db.prepare('SELECT * FROM disputes WHERE paymentId = ?').get(paymentId);
+        return row || null;
+    }
+    /**
+     * List disputes filtered by wallet
+     */
+    listByWallet(walletId, status) {
+        const db = (0, db_1.getDb)();
+        let query = 'SELECT * FROM disputes WHERE (buyerWalletId = ? OR providerWalletId = ?)';
+        const params = [walletId, walletId];
+        if (status) {
+            query += ' AND status = ?';
+            params.push(status);
+        }
+        query += ' ORDER BY createdAt DESC';
+        return db.prepare(query).all(...params);
+    }
+    /**
+     * List all disputes (admin only)
+     */
+    listAll(status) {
+        const db = (0, db_1.getDb)();
+        if (status) {
+            return db.prepare('SELECT * FROM disputes WHERE status = ? ORDER BY createdAt DESC').all(status);
+        }
+        return db.prepare('SELECT * FROM disputes ORDER BY createdAt DESC').all();
+    }
+    /**
+     * Check and auto-resolve expired dispute windows
+     * Should be called periodically or on payment completion
+     */
+    checkExpiredWindows() {
+        const db = (0, db_1.getDb)();
+        // Find all escrowed payments without disputes that have passed their dispute window
+        const expiredPayments = db.prepare(`
+      SELECT p.id, p.completedAt, p.createdAt, s.disputeWindow
+      FROM payments p
+      JOIN services s ON p.serviceId = s.id
+      WHERE p.status = 'escrowed' 
+        AND p.disputeStatus IS NULL
+        AND NOT EXISTS (SELECT 1 FROM disputes WHERE paymentId = p.id)
+    `).all();
+        const now = new Date();
+        for (const payment of expiredPayments) {
+            const disputeWindowMinutes = payment.disputeWindow || 30;
+            const disputeDeadline = new Date(new Date(payment.completedAt || payment.createdAt).getTime() + disputeWindowMinutes * 60000);
+            if (now > disputeDeadline) {
+                // Auto-release payment to provider (dispute window expired)
+                db.prepare('UPDATE payments SET disputeStatus = ? WHERE id = ?').run('no_dispute', payment.id);
+                console.log(`[Disputes] Auto-release payment ${payment.id} - dispute window expired`);
+            }
+        }
+    }
+}
+exports.DisputeManager = DisputeManager;
+//# sourceMappingURL=dispute.js.map

package/dist/disputes/dispute.js.map

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