paybridge 0.9.0 → 0.11.0

package/dist/cli/utils.js

@@ -70,9 +70,21 @@ COMMANDS
   webhook verify <p>      Verify webhook signature (raw body from stdin)
   webhook parse <p>       Parse webhook event (raw body from stdin)
   quote <p> [opts]        Get a crypto on/off-ramp quote
+  drift-check [opts]      Capture/compare provider response shapes (drift detection)
+  drift-watch [opts]      Run drift-check on a loop (long-running monitor)
+  reconcile [opts]        Reconcile your DB against provider state (detects missed webhooks)
   help, -h, --help        Print this help
   version, -v             Print version
 
+DRIFT DETECTION
+  drift-check [provider]           Check all/single provider for API drift
+  drift-check --capture            Capture baseline snapshots (init mode)
+  drift-check --json               Output JSON instead of human-readable
+  drift-check --baseline-dir <p>   Custom baseline location (default: .paybridge/drift-baseline)
+  drift-check --webhook-url <url>  POST drift report to URL on detection
+  drift-watch --interval <6h|1h>   Run every interval (default: 6h)
+  drift-watch --once               Alias for drift-check (don't loop)
+
 PROVIDER ENV VARS
   See SETUP.md or run 'paybridge test --all' for the full list.
 
@@ -82,6 +94,11 @@ EXAMPLES
   STRIPE_API_KEY=sk_test_... paybridge test stripe
   echo '{"id":"evt_x"}' | paybridge webhook parse paystack \\
     --header x-paystack-signature=abc
+  paybridge drift-check --capture
+  paybridge drift-check stripe
+  paybridge drift-watch --interval 1h --webhook-url https://hooks.slack.com/...
+  paybridge reconcile --input expected.jsonl
+  psql -t -c "SELECT provider, reference, status FROM payments" | paybridge reconcile
 
 Docs: https://github.com/kobie3717/paybridge
 `.trim();

package/dist/drift-detector.d.ts

@@ -0,0 +1,40 @@
+export interface ResponseShape {
+    keys: string[];
+    types: Record<string, 'string' | 'number' | 'boolean' | 'object' | 'array' | 'null'>;
+    status?: string;
+    capturedAt: string;
+}
+export interface ProviderBaseline {
+    providerName: string;
+    operation: string;
+    shape: ResponseShape;
+    libVersion: string;
+}
+export interface DriftReport {
+    providerName: string;
+    driftDetected: boolean;
+    addedKeys: string[];
+    removedKeys: string[];
+    typeChanges: Array<{
+        key: string;
+        oldType: string;
+        newType: string;
+    }>;
+    statusChanged?: {
+        old: string;
+        new: string;
+    };
+    baselineCapturedAt: string;
+    newCapturedAt: string;
+}
+export declare function captureShape(response: unknown): ResponseShape;
+export declare function compareShapes(baseline: ResponseShape, current: ResponseShape): {
+    addedKeys: string[];
+    removedKeys: string[];
+    typeChanges: Array<{
+        key: string;
+        oldType: string;
+        newType: string;
+    }>;
+};
+export declare function diffBaseline(baseline: ProviderBaseline, currentShape: ResponseShape, providerName: string): DriftReport;

package/dist/drift-detector.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.captureShape = captureShape;
+exports.compareShapes = compareShapes;
+exports.diffBaseline = diffBaseline;
+function getType(value) {
+    if (value === null)
+        return 'null';
+    if (Array.isArray(value))
+        return 'array';
+    return typeof value;
+}
+function flattenKeys(obj, prefix = '') {
+    const result = [];
+    if (obj === null || obj === undefined) {
+        return result;
+    }
+    if (Array.isArray(obj)) {
+        if (obj.length === 0) {
+            return result;
+        }
+        for (const item of obj) {
+            const nested = flattenKeys(item, `${prefix}[*]`);
+            result.push(...nested);
+        }
+    }
+    else if (typeof obj === 'object') {
+        for (const [key, value] of Object.entries(obj)) {
+            const path = prefix ? `${prefix}.${key}` : key;
+            const valueType = getType(value);
+            if (valueType === 'object' || valueType === 'array') {
+                const nested = flattenKeys(value, path);
+                result.push(...nested);
+            }
+            else {
+                result.push({ path, type: valueType });
+            }
+        }
+    }
+    return result;
+}
+function deduplicateKeys(entries) {
+    const seen = new Map();
+    for (const entry of entries) {
+        if (!seen.has(entry.path)) {
+            seen.set(entry.path, entry.type);
+        }
+    }
+    return Array.from(seen.entries()).map(([path, type]) => ({ path, type }));
+}
+function captureShape(response) {
+    const entries = flattenKeys(response);
+    const deduplicated = deduplicateKeys(entries);
+    const sorted = deduplicated.sort((a, b) => a.path.localeCompare(b.path));
+    const keys = sorted.map((e) => e.path);
+    const types = {};
+    for (const entry of sorted) {
+        types[entry.path] = entry.type;
+    }
+    return {
+        keys,
+        types,
+        capturedAt: new Date().toISOString(),
+    };
+}
+function compareShapes(baseline, current) {
+    const baselineSet = new Set(baseline.keys);
+    const currentSet = new Set(current.keys);
+    const addedKeys = current.keys.filter((k) => !baselineSet.has(k));
+    const removedKeys = baseline.keys.filter((k) => !currentSet.has(k));
+    const typeChanges = [];
+    for (const key of current.keys) {
+        if (baselineSet.has(key)) {
+            const oldType = baseline.types[key];
+            const newType = current.types[key];
+            if (oldType !== newType) {
+                typeChanges.push({ key, oldType, newType });
+            }
+        }
+    }
+    return { addedKeys, removedKeys, typeChanges };
+}
+function diffBaseline(baseline, currentShape, providerName) {
+    const diff = compareShapes(baseline.shape, currentShape);
+    let statusChanged;
+    if (baseline.shape.status && currentShape.status && baseline.shape.status !== currentShape.status) {
+        statusChanged = { old: baseline.shape.status, new: currentShape.status };
+    }
+    const driftDetected = diff.addedKeys.length > 0 ||
+        diff.removedKeys.length > 0 ||
+        diff.typeChanges.length > 0 ||
+        !!statusChanged;
+    return {
+        providerName,
+        driftDetected,
+        addedKeys: diff.addedKeys,
+        removedKeys: diff.removedKeys,
+        typeChanges: diff.typeChanges,
+        statusChanged,
+        baselineCapturedAt: baseline.shape.capturedAt,
+        newCapturedAt: currentShape.capturedAt,
+    };
+}

package/dist/index.d.ts

@@ -22,6 +22,8 @@ export * from './tracer';
 export { createRedisCircuitBreakerStore, type RedisLike, type RedisStoreOptions } from './stores/redis';
 export { createRedisIdempotencyStore, type RedisIdempotencyStoreOptions } from './stores/redis-idempotency';
 export { createRedisLedgerStore, type RedisLedgerStoreOptions } from './stores/redis-ledger';
+export { runReconcile, type ReconcileDeps } from './cli/reconcile';
+export * from './cli/reconcile-types';
 export declare class PayBridge {
     readonly provider: PaymentProvider;
     constructor(config: PayBridgeConfig);

package/dist/index.js

@@ -20,7 +20,7 @@ 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.PayBridge = exports.createRedisLedgerStore = exports.createRedisIdempotencyStore = exports.createRedisCircuitBreakerStore = void 0;
+exports.PayBridge = exports.runReconcile = exports.createRedisLedgerStore = exports.createRedisIdempotencyStore = exports.createRedisCircuitBreakerStore = void 0;
 const softycomp_1 = require("./providers/softycomp");
 const yoco_1 = require("./providers/yoco");
 const ozow_1 = require("./providers/ozow");
@@ -54,6 +54,9 @@ var redis_idempotency_1 = require("./stores/redis-idempotency");
 Object.defineProperty(exports, "createRedisIdempotencyStore", { enumerable: true, get: function () { return redis_idempotency_1.createRedisIdempotencyStore; } });
 var redis_ledger_1 = require("./stores/redis-ledger");
 Object.defineProperty(exports, "createRedisLedgerStore", { enumerable: true, get: function () { return redis_ledger_1.createRedisLedgerStore; } });
+var reconcile_1 = require("./cli/reconcile");
+Object.defineProperty(exports, "runReconcile", { enumerable: true, get: function () { return reconcile_1.runReconcile; } });
+__exportStar(require("./cli/reconcile-types"), exports);
 class PayBridge {
     constructor(config) {
         this.provider = this.createProvider(config);

package/dist/providers/square.js

@@ -91,7 +91,7 @@ class SquareProvider extends base_1.PaymentProvider {
                 buyer_email: params.customer.email,
             },
         };
-        const response = await this.apiRequest('POST', '/checkout/payment-links', requestBody);
+        const response = await this.apiRequest('POST', '/online-checkout/payment-links', requestBody);
         const link = response.payment_link;
         return {
             id: link.id,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paybridge",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "description": "One API for fiat + crypto payments. Multi-provider routing, automatic failover, MoonPay on/off-ramp. SA-first, global-ready.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -14,7 +14,7 @@
     "cli": "node dist/cli/index.js",
     "prepack": "npm run clean && npm run build:cli",
     "prepublishOnly": "npm run clean && npm run build:cli",
-    "test": "tsc && tsc --project tsconfig.test.json && node --test 'dist-test/**/*.test.js'",
+    "test": "tsc && tsc --project tsconfig.test.json && find dist-test -name '*.test.js' -exec node --test {} +",
     "test:e2e:moonpay": "tsx tests/e2e/moonpay-sandbox.ts",
     "test:e2e:yellowcard": "tsx tests/e2e/yellowcard-sandbox.ts",
     "test:e2e:sandbox": "tsx tests/e2e/sandbox-validate.ts"
@@ -46,7 +46,10 @@
     "ramp",
     "east-africa",
     "cli",
-    "command-line"
+    "command-line",
+    "drift-detection",
+    "monitoring",
+    "api-validation"
   ],
   "author": "Kobie Wentzel",
   "license": "MIT",