@envarai/envarpay 0.2.0-alpha.5 → 0.2.0-alpha.6

package/dist/commerce/cli.js

@@ -24,9 +24,9 @@ const { values, positionals } = parseArgs({ allowPositionals: true, options: {
         config: { type: 'string' }, service: { type: 'string' }, offer: { type: 'string' }, origin: { type: 'string' },
         version: { type: 'boolean' }, help: { type: 'boolean', short: 'h' }, state: { type: 'string' }, credentials: { type: 'string' }, host: { type: 'string' },
         port: { type: 'string' }, directory: { type: 'string' }, 'envar-config': { type: 'string' }, 'envar-credentials': { type: 'string' },
-        after: { type: 'string' }, limit: { type: 'string' },
+        after: { type: 'string' }, limit: { type: 'string' }, 'refund-review': { type: 'boolean' },
     } });
-const usage = 'envarpay init --directory DIR | inspect --state DB [--after ROW --limit 100] | validate --config seller.json | card --config seller.json --service ID --offer ID --origin URL | serve/buyer-serve --config FILE --credentials FILE --state DB --origin URL';
+const usage = 'envarpay init --directory DIR | inspect --state DB [--after ROW --limit 100 --refund-review] | validate --config seller.json | card --config seller.json --service ID --offer ID --origin URL | serve/buyer-serve --config FILE --credentials FILE --state DB --origin URL';
 const closers = [];
 function privateFile(path) {
     const stat = lstatSync(path);
@@ -87,9 +87,11 @@ async function run() {
     }
     const command = positionals[0];
     if (command === 'inspect' && values.state) {
-        console.log(JSON.stringify(inspectLedger(values.state, Number(values.after ?? 0), Number(values.limit ?? 100)), null, 2));
+        console.log(JSON.stringify(inspectLedger(values.state, Number(values.after ?? 0), Number(values.limit ?? 100), values['refund-review'] ? 'refund-review' : 'attention'), null, 2));
         return;
     }
+    if (values['refund-review'])
+        throw new CommerceError('inspection_view', 'Refund review is available only for inspect');
     if ((values['envar-config'] || values['envar-credentials']) && command !== 'serve')
         throw new CommerceError('envar_role', 'Configuration synchronization is available on seller serve only');
     if (Boolean(values['envar-config']) !== Boolean(values['envar-credentials']))

package/dist/commerce/operations.d.ts

@@ -1,9 +1,13 @@
+export type InspectionView = 'attention' | 'refund-review';
 /** Local owner-only diagnostics: never opens a signer, vault, provider or network. */
-export declare function inspectLedger(path: string, after?: number, limit?: number): {
+export declare function inspectLedger(path: string, after?: number, limit?: number, view?: InspectionView): {
     role: string;
+    view: InspectionView;
     total: number;
     attentionCount: number;
+    refundReviewCount: number;
     items: {
+        reason?: "confirmed_payment_failed_execution" | undefined;
         cursor: number;
         id: string;
         paymentState: string;
@@ -13,4 +17,5 @@ export declare function inspectLedger(path: string, after?: number, limit?: numb
     nextCursor: number;
     hasMore: boolean;
     paymentPerformed: boolean;
+    refundPerformed: boolean;
 };

package/dist/commerce/operations.js

@@ -2,12 +2,14 @@ import { DatabaseSync } from 'node:sqlite';
 import { lstatSync } from 'node:fs';
 import { CommerceError } from './types.js';
 /** Local owner-only diagnostics: never opens a signer, vault, provider or network. */
-export function inspectLedger(path, after = 0, limit = 100) {
+export function inspectLedger(path, after = 0, limit = 100, view = 'attention') {
     const stat = lstatSync(path);
     if (!stat.isFile() || stat.isSymbolicLink() || (stat.mode & 0o077) !== 0 || (process.getuid && stat.uid !== process.getuid()))
         throw new CommerceError('private_file', 'Inspect an existing ledger owned only by the current user');
     if (!Number.isSafeInteger(after) || after < 0 || !Number.isSafeInteger(limit) || limit < 1 || limit > 100)
         throw new CommerceError('inspection_cursor', 'Use a nonnegative row cursor and a limit from1 to100');
+    if (!['attention', 'refund-review'].includes(view))
+        throw new CommerceError('inspection_view', 'Use attention or refund-review inspection');
     const db = new DatabaseSync(path, { readOnly: true });
     try {
         db.exec('PRAGMA query_only=ON; PRAGMA busy_timeout=1000');
@@ -20,12 +22,15 @@ export function inspectLedger(path, after = 0, limit = 100) {
             throw new CommerceError('store_version', 'Unsupported commerce ledger version');
         const table = role === 'buyer' ? 'buyer_purchases' : 'commerce_orders';
         const total = Number(db.prepare(`SELECT COUNT(*) AS n FROM ${table}`).get().n);
-        const filter = role === 'buyer' ? "json_extract(record_json,'$.state') IN ('signing','submitted','unknown') OR json_extract(record_json,'$.paymentState') IN ('reserved','unknown') OR json_extract(record_json,'$.executionState')='unknown'" : "payment_state IN ('settling','unknown') OR execution_state IN ('dispatching','unknown')";
+        const attention = role === 'buyer' ? "json_extract(record_json,'$.state') IN ('signing','submitted','unknown') OR json_extract(record_json,'$.paymentState') IN ('reserved','unknown') OR json_extract(record_json,'$.executionState')='unknown'" : "payment_state IN ('settling','unknown') OR execution_state IN ('dispatching','unknown')";
+        const refundReview = role === 'buyer' ? "json_extract(record_json,'$.paymentState')='confirmed' AND json_extract(record_json,'$.executionState')='failed'" : "payment_state='confirmed' AND execution_state='failed'";
+        const filter = view === 'refund-review' ? refundReview : attention;
         const selected = role === 'buyer' ? "rowid AS cursor,id,json_extract(record_json,'$.paymentState') AS payment_state,json_extract(record_json,'$.executionState') AS execution_state,json_extract(record_json,'$.task.id') AS task_id" : "rowid AS cursor,id,payment_state,execution_state,task_id";
         const rows = db.prepare(`SELECT ${selected} FROM ${table} WHERE rowid>? AND (${filter}) ORDER BY rowid LIMIT ?`).all(after, limit + 1);
-        const page = rows.slice(0, limit).map(row => ({ cursor: Number(row.cursor), id: String(row.id), paymentState: String(row.payment_state), executionState: String(row.execution_state), taskId: typeof row.task_id === 'string' ? row.task_id : null }));
-        const attentionCount = Number(db.prepare(`SELECT COUNT(*) AS n FROM ${table} WHERE ${filter}`).get().n);
-        return { role, total, attentionCount, items: page, nextCursor: page.at(-1)?.cursor ?? after, hasMore: rows.length > limit, paymentPerformed: false };
+        const page = rows.slice(0, limit).map(row => ({ cursor: Number(row.cursor), id: String(row.id), paymentState: String(row.payment_state), executionState: String(row.execution_state), taskId: typeof row.task_id === 'string' ? row.task_id : null, ...(view === 'refund-review' ? { reason: 'confirmed_payment_failed_execution' } : {}) }));
+        const attentionCount = Number(db.prepare(`SELECT COUNT(*) AS n FROM ${table} WHERE ${attention}`).get().n);
+        const refundReviewCount = Number(db.prepare(`SELECT COUNT(*) AS n FROM ${table} WHERE ${refundReview}`).get().n);
+        return { role, view, total, attentionCount, refundReviewCount, items: page, nextCursor: page.at(-1)?.cursor ?? after, hasMore: rows.length > limit, paymentPerformed: false, refundPerformed: false };
     }
     finally {
         db.close();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@envarai/envarpay",
-  "version": "0.2.0-alpha.5",
+  "version": "0.2.0-alpha.6",
   "description": "Independent A2A service commerce, budgeted buyers and x402/MPP payments",
   "type": "module",
   "license": "MIT",