@abdssamie/adyen-payments 0.1.0

package/package.json

@@ -0,0 +1,104 @@
+{
+  "name": "@abdssamie/adyen-payments",
+  "description": "A adyen payments component for Convex.",
+  "repository": "github:Abdssamie/adyen-payments",
+  "homepage": "https://github.com/Abdssamie/adyen-payments#readme",
+  "bugs": {
+    "url": "https://github.com/Abdssamie/adyen-payments/issues"
+  },
+  "version": "0.1.0",
+  "license": "Apache-2.0",
+  "keywords": [
+    "convex",
+    "component"
+  ],
+  "type": "module",
+  "scripts": {
+    "dev": "convex dev --start 'npm run dev:build'",
+    "dev:frontend": "cd example && vite",
+    "dev:build": "chokidar 'tsconfig*.json' 'src/**/*.ts' -i '**/*.test.ts' -c 'npm run build:codegen' --initial",
+    "predev": "convex init && npm run build:codegen",
+    "build": "tsc --project ./tsconfig.build.json",
+    "build:codegen": "npx convex codegen --component-dir ./src/component && npm run build",
+    "build:clean": "rm -rf dist *.tsbuildinfo && npm run build:codegen",
+    "typecheck": "tsc --noEmit && tsc -p example && tsc -p example/convex",
+    "lint": "eslint .",
+    "test": "vitest run --typecheck",
+    "test:watch": "vitest --typecheck --clearScreen false",
+    "test:debug": "vitest --inspect-brk --no-file-parallelism",
+    "test:coverage": "vitest run --coverage --coverage.reporter=text",
+    "preversion": "npm ci && npm run build:clean && npm run test && npm run lint && npm run typecheck",
+    "alpha": "npm version prerelease --preid alpha && npm publish --tag alpha && git push --follow-tags",
+    "release": "npm version patch && npm publish && git push --follow-tags",
+    "version": "(npm whoami || npm login) && vim -c 'normal o' -c 'normal o## '$npm_package_version CHANGELOG.md && prettier -w CHANGELOG.md && git add CHANGELOG.md"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/client/index.d.ts",
+      "default": "./dist/client/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "default": "./dist/react/index.js"
+    },
+    "./test": "./src/test.ts",
+    "./_generated/component.js": {
+      "types": "./dist/component/_generated/component.d.ts"
+    },
+    "./_generated/component": {
+      "types": "./dist/component/_generated/component.d.ts"
+    },
+    "./convex.config.js": {
+      "types": "./dist/component/convex.config.d.ts",
+      "default": "./dist/component/convex.config.js"
+    },
+    "./convex.config": {
+      "types": "./dist/component/convex.config.d.ts",
+      "default": "./dist/component/convex.config.js"
+    }
+  },
+  "peerDependencies": {
+    "convex": "^1.36.1",
+    "react": "^18.3.1 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@convex-dev/eslint-plugin": "^2.0.0",
+    "@edge-runtime/vm": "^5.0.0",
+    "@eslint/eslintrc": "^3.3.5",
+    "@eslint/js": "9.39.4",
+    "@types/node": "^24.12.2",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@typescript/native-preview": "7.0.0-dev.20260614.1",
+    "@vitejs/plugin-react": "^6.0.2",
+    "chokidar-cli": "3.0.0",
+    "convex": "^1.41.0",
+    "convex-test": "0.0.49",
+    "eslint": "9.39.4",
+    "eslint-plugin-react": "^7.37.5",
+    "eslint-plugin-react-hooks": "^7.1.1",
+    "eslint-plugin-react-refresh": "^0.5.2",
+    "globals": "^17.5.0",
+    "pkg-pr-new": "^0.0.66",
+    "prettier": "3.8.3",
+    "react": "^19.2.5",
+    "react-dom": "^19.2.5",
+    "typescript": "6.0.3",
+    "typescript-eslint": "8.58.2",
+    "vite": "8.0.9",
+    "vitest": "4.1.4"
+  },
+  "dependencies": {
+    "@adyen/adyen-web": "^6.39.0",
+    "@adyen/api-library": "^22.0.0",
+    "@convex-dev/better-auth": "^0.12.4",
+    "better-auth": "^1.6.20"
+  },
+  "types": "./dist/client/index.d.ts",
+  "module": "./dist/client/index.js"
+}

package/src/client/_generated/_ignore.ts

@@ -0,0 +1 @@
+// This is only here so convex-test can detect a _generated folder

package/src/client/index.test.ts

@@ -0,0 +1,196 @@
+import { describe, expect, test, vi, beforeEach } from "vitest";
+import { AdyenPayments, type ActionCtx } from "./index.js";
+import { components, initConvexTest } from "./setup.test.js";
+
+// Mock the Adyen SDK API calls
+vi.mock("@adyen/api-library", () => {
+  const sessionsMock = vi.fn().mockResolvedValue({
+    id: "sess_123",
+    sessionData: "data_blob_123",
+    url: "https://checkout.adyen.com/pay/123",
+  });
+
+  const paymentMethodsMock = vi.fn().mockResolvedValue({
+    storedPaymentMethods: [
+      { id: "token_123", brand: "visa", lastFour: "1111", expiryMonth: "12", expiryYear: "2030" }
+    ]
+  });
+
+  const deleteStoredPaymentMethodMock = vi.fn().mockResolvedValue({});
+
+  const paymentsMock = vi.fn().mockResolvedValue({
+    pspReference: "psp_123",
+    resultCode: "Authorised",
+    paymentMethod: { type: "visa" }
+  });
+
+  const captureMock = vi.fn().mockResolvedValue({ pspReference: "psp_cap_123", status: "received" });
+  const refundMock = vi.fn().mockResolvedValue({ pspReference: "psp_ref_123", status: "received" });
+  const cancelMock = vi.fn().mockResolvedValue({ pspReference: "psp_can_123", status: "received" });
+
+  class CheckoutAPIMock {
+    PaymentsApi = {
+      sessions: sessionsMock,
+      payments: paymentsMock,
+      paymentMethods: paymentMethodsMock,
+    };
+    RecurringApi = {
+      deleteTokenForStoredPaymentDetails: deleteStoredPaymentMethodMock,
+    };
+    ModificationsApi = {
+      captureAuthorisedPayment: captureMock,
+      refundCapturedPayment: refundMock,
+      cancelAuthorisedPaymentByPspReference: cancelMock,
+    };
+  }
+
+  class HmacValidatorMock {
+    validateHMAC = vi.fn().mockReturnValue(true);
+    validateBankingHMAC = vi.fn().mockReturnValue(true);
+  }
+
+  return {
+    Client: vi.fn(),
+    CheckoutAPI: CheckoutAPIMock,
+    hmacValidator: HmacValidatorMock,
+  };
+});
+
+describe("AdyenPayments client class tests", () => {
+  beforeEach(() => {
+    process.env.ADYEN_API_KEY = "test_key";
+    process.env.ADYEN_MERCHANT_ACCOUNT = "test_merchant";
+    process.env.APP_URL = "https://example.com";
+  });
+
+  test("constructor configuration", () => {
+    const client = new AdyenPayments(components.adyenPayments);
+    expect(client.apiKey).toBe("test_key");
+    expect(client.merchantAccount).toBe("test_merchant");
+    expect(client.environment).toBe("TEST");
+  });
+
+  test("shopper operations in client context", async () => {
+    const t = initConvexTest();
+    const payments = new AdyenPayments(components.adyenPayments);
+
+    const shopperRef = await payments.createShopper(t as unknown as ActionCtx, {
+      shopperReference: "shopper_1",
+      email: "shopper1@example.com",
+    });
+    expect(shopperRef).toBe("shopper_1");
+  });
+
+  test("checkout session creation", async () => {
+    const t = initConvexTest();
+    const payments = new AdyenPayments(components.adyenPayments);
+
+    const session = await payments.createCheckoutSession(t as unknown as ActionCtx, {
+      amount: 1500,
+      currency: "USD",
+      successUrl: "https://example.com/success",
+      cancelUrl: "https://example.com/cancel",
+    });
+
+    expect(session.sessionId).toBe("sess_123");
+    expect(session.url).toBe("https://checkout.adyen.com/pay/123");
+  });
+
+  test("charging stored payment method", async () => {
+    const t = initConvexTest();
+    const payments = new AdyenPayments(components.adyenPayments);
+
+    const chargeResult = await payments.chargeStoredCard(t as unknown as ActionCtx, {
+      shopperReference: "shopper_1",
+      recurringDetailReference: "token_123",
+      amount: 5000,
+      currency: "EUR",
+      autoCapture: false,
+    });
+
+    expect(chargeResult.pspReference).toBe("psp_123");
+    expect(chargeResult.status).toBe("authorised");
+  });
+
+  test("autoCapture and captureDelayHours configuration logic", async () => {
+    // 1. Default constructor options
+    const clientDefault = new AdyenPayments(components.adyenPayments);
+    expect(clientDefault.captureDelayHours).toBe(0);
+
+    // 2. autoCapture: false -> captureDelayHours = -1
+    const clientManual = new AdyenPayments(components.adyenPayments, { autoCapture: false });
+    expect(clientManual.captureDelayHours).toBe(-1);
+
+    // 3. autoCapture: true -> captureDelayHours = 0
+    const clientAuto = new AdyenPayments(components.adyenPayments, { autoCapture: true });
+    expect(clientAuto.captureDelayHours).toBe(0);
+
+    // 4. autoCapture: true and captureDelayHours: -1 -> captureDelayHours = 0 (resolved conflict)
+    const clientConflict1 = new AdyenPayments(components.adyenPayments, { autoCapture: true, captureDelayHours: -1 });
+    expect(clientConflict1.captureDelayHours).toBe(0);
+
+    // 5. autoCapture: true and captureDelayHours: 24 -> captureDelayHours = 24
+    const clientConflict2 = new AdyenPayments(components.adyenPayments, { autoCapture: true, captureDelayHours: 24 });
+    expect(clientConflict2.captureDelayHours).toBe(24);
+  });
+
+  test("createCheckoutSession and chargeStoredCard autoCapture parameters mapping", async () => {
+    const t = initConvexTest();
+    const payments = new AdyenPayments(components.adyenPayments, { autoCapture: false });
+
+    const { CheckoutAPI } = await import("@adyen/api-library");
+    const checkoutInstance = new CheckoutAPI(null as any);
+    const sessionsSpy = vi.mocked(checkoutInstance.PaymentsApi.sessions);
+    const paymentsSpy = vi.mocked(checkoutInstance.PaymentsApi.payments);
+
+    sessionsSpy.mockClear();
+    paymentsSpy.mockClear();
+
+    // 1. Client configured with autoCapture: false, method called without override
+    await payments.createCheckoutSession(t as unknown as ActionCtx, {
+      amount: 1500,
+      currency: "USD",
+      successUrl: "https://example.com/success",
+      cancelUrl: "https://example.com/cancel",
+    });
+    expect(sessionsSpy).toHaveBeenCalledWith(expect.objectContaining({
+      captureDelayHours: -1,
+    }));
+
+    // 2. Client configured with autoCapture: false, method called with override autoCapture: true
+    sessionsSpy.mockClear();
+    await payments.createCheckoutSession(t as unknown as ActionCtx, {
+      amount: 1500,
+      currency: "USD",
+      successUrl: "https://example.com/success",
+      cancelUrl: "https://example.com/cancel",
+      autoCapture: true,
+    });
+    expect(sessionsSpy).toHaveBeenCalledWith(expect.objectContaining({
+      captureDelayHours: 0,
+    }));
+
+    // 3. chargeStoredCard client default vs override
+    await payments.chargeStoredCard(t as unknown as ActionCtx, {
+      shopperReference: "shopper_1",
+      recurringDetailReference: "token_123",
+      amount: 5000,
+      currency: "EUR",
+    });
+    expect(paymentsSpy).toHaveBeenCalledWith(expect.objectContaining({
+      captureDelayHours: -1,
+    }));
+
+    paymentsSpy.mockClear();
+    await payments.chargeStoredCard(t as unknown as ActionCtx, {
+      shopperReference: "shopper_1",
+      recurringDetailReference: "token_123",
+      amount: 5000,
+      currency: "EUR",
+      autoCapture: true,
+    });
+    expect(paymentsSpy).toHaveBeenCalledWith(expect.objectContaining({
+      captureDelayHours: 0,
+    }));
+  });
+});