@easypayment/medusa-paypal 0.4.6 → 0.4.8

package/README.md

@@ -1,142 +1,142 @@
-# @easypayment/medusa-paypal
-
-Production-ready PayPal integration for **Medusa v2** with:
-
-- PayPal Wallet provider
-- PayPal Advanced Card provider
-- Admin settings pages (connection, wallet settings, advanced card settings, additional checkout behavior)
-- Store API routes used by storefront integrations
-
----
-
-## Compatibility
-
-- Medusa: `^2.12.0`
-- Node.js: `>=20`
-
----
-
-## Step-by-step setup (GitHub style)
-
-### 1) Install the package
-
-```bash
-npm install @easypayment/medusa-paypal
-# or
-pnpm add @easypayment/medusa-paypal
-# or
-yarn add @easypayment/medusa-paypal
-```
-
-### 2) Register plugin + providers in `medusa-config.ts`
-
-Add the plugin and both payment providers:
-
-```ts
-module.exports = defineConfig({
-  plugins: [
-    {
-      resolve: "@easypayment/medusa-paypal",
-      options: {},
-    },
-  ],
-
-  modules: [
-    {
-      resolve: "@medusajs/medusa/payment",
-      options: {
-        providers: [
-          {
-            resolve: "@easypayment/medusa-paypal/providers/paypal",
-            id: "paypal",
-          },
-          {
-            resolve: "@easypayment/medusa-paypal/providers/paypal_card",
-            id: "paypal_card",
-          },
-        ],
-      },
-    },
-  ],
-})
-```
-
-### 3) Add backend environment variables
-
-Set these in your backend `.env`:
-
-```bash
-# required for API + onboarding defaults
-PAYPAL_ENV=sandbox
-PAYPAL_CURRENCY=EUR
-
-# optional but recommended
-STOREFRONT_URL=https://your-storefront.example.com
-PAYPAL_CREDENTIALS_ENCRYPTION_KEY=your-32-byte-or-strong-secret
-```
-
-> Tip: PayPal API credentials are managed from the Medusa Admin PayPal settings UI.
-
-### 4) Start backend and open Admin
-
-- Run your Medusa backend.
-- Open Medusa Admin.
-- Go to the PayPal settings pages.
-
-### 5) Connect PayPal and configure checkout behavior
-
-Use the Admin UI to set credentials and runtime behavior.
-
-Runtime-relevant settings include:
-
-- **PayPal Settings**
-  - `enabled`
-  - `title`
-  - `disableButtons`
-  - `buttonColor`, `buttonShape`, `buttonWidth`, `buttonHeight`, `buttonLabel`
-- **Advanced Card Payments**
-  - `enabled`
-  - `title`
-  - `threeDS`
-- **Additional Settings**
-  - `paymentAction` (`capture` or `authorize`)
-  - `brandName`
-  - `landingPage`
-  - `requireInstantPayment`
-  - `sendItemDetails`
-  - `invoicePrefix`
-  - `creditCardStatementName`
-
-### 6) Use the generated provider IDs in your storefront
-
-With the sample config above, Medusa provider IDs are:
-
-- `pp_paypal_paypal`
-- `pp_paypal_card_paypal_card`
-
-Your storefront package should use these exact IDs unless you customize provider IDs.
-
----
-
-## Quick checklist
-
-- [ ] Package installed
-- [ ] `medusa-config.ts` updated (plugin + both providers)
-- [ ] Required env vars set
-- [ ] PayPal credentials configured in Admin
-- [ ] Storefront uses correct provider IDs
-
----
-
-## Build and publish
-
-```bash
-npm run build
-npm publish --access public
-```
-
----
-
-## License
-
-MIT
+# @easypayment/medusa-paypal
+
+Production-ready PayPal integration for **Medusa v2** with:
+
+- PayPal Wallet provider
+- PayPal Advanced Card provider
+- Admin settings pages (connection, wallet settings, advanced card settings, additional checkout behavior)
+- Store API routes used by storefront integrations
+
+---
+
+## Compatibility
+
+- Medusa: `^2.12.0`
+- Node.js: `>=20`
+
+---
+
+## Step-by-step setup (GitHub style)
+
+### 1) Install the package
+
+```bash
+npm install @easypayment/medusa-paypal
+# or
+pnpm add @easypayment/medusa-paypal
+# or
+yarn add @easypayment/medusa-paypal
+```
+
+### 2) Register plugin + providers in `medusa-config.ts`
+
+Add the plugin and both payment providers:
+
+```ts
+module.exports = defineConfig({
+  plugins: [
+    {
+      resolve: "@easypayment/medusa-paypal",
+      options: {},
+    },
+  ],
+
+  modules: [
+    {
+      resolve: "@medusajs/medusa/payment",
+      options: {
+        providers: [
+          {
+            resolve: "@easypayment/medusa-paypal/providers/paypal",
+            id: "paypal",
+          },
+          {
+            resolve: "@easypayment/medusa-paypal/providers/paypal_card",
+            id: "paypal_card",
+          },
+        ],
+      },
+    },
+  ],
+})
+```
+
+### 3) Add backend environment variables
+
+Set these in your backend `.env`:
+
+```bash
+# required for API + onboarding defaults
+PAYPAL_ENV=sandbox
+PAYPAL_CURRENCY=EUR
+
+# optional but recommended
+STOREFRONT_URL=https://your-storefront.example.com
+PAYPAL_CREDENTIALS_ENCRYPTION_KEY=your-32-byte-or-strong-secret
+```
+
+> Tip: PayPal API credentials are managed from the Medusa Admin PayPal settings UI.
+
+### 4) Start backend and open Admin
+
+- Run your Medusa backend.
+- Open Medusa Admin.
+- Go to the PayPal settings pages.
+
+### 5) Connect PayPal and configure checkout behavior
+
+Use the Admin UI to set credentials and runtime behavior.
+
+Runtime-relevant settings include:
+
+- **PayPal Settings**
+  - `enabled`
+  - `title`
+  - `disableButtons`
+  - `buttonColor`, `buttonShape`, `buttonWidth`, `buttonHeight`, `buttonLabel`
+- **Advanced Card Payments**
+  - `enabled`
+  - `title`
+  - `threeDS`
+- **Additional Settings**
+  - `paymentAction` (`capture` or `authorize`)
+  - `brandName`
+  - `landingPage`
+  - `requireInstantPayment`
+  - `sendItemDetails`
+  - `invoicePrefix`
+  - `creditCardStatementName`
+
+### 6) Use the generated provider IDs in your storefront
+
+With the sample config above, Medusa provider IDs are:
+
+- `pp_paypal_paypal`
+- `pp_paypal_card_paypal_card`
+
+Your storefront package should use these exact IDs unless you customize provider IDs.
+
+---
+
+## Quick checklist
+
+- [ ] Package installed
+- [ ] `medusa-config.ts` updated (plugin + both providers)
+- [ ] Required env vars set
+- [ ] PayPal credentials configured in Admin
+- [ ] Storefront uses correct provider IDs
+
+---
+
+## Build and publish
+
+```bash
+npm run build
+npm publish --access public
+```
+
+---
+
+## License
+
+MIT

package/package.json

@@ -1,75 +1,75 @@
-{
-  "name": "@easypayment/medusa-paypal",
-  "version": "0.4.6",
-  "description": "Industry-standard PayPal integration for Medusa v2",
-  "license": "MIT",
-  "main": "./.medusa/server/src/index.js",
-  "types": "./.medusa/server/src/index.d.ts",
-  "files": [
-    ".medusa/server",
-    "src",
-    "scripts",
-    "package.json",
-    "README.md",
-    "LICENSE",
-    "tsconfig.json"
-  ],
-  "exports": {
-    "./package.json": "./package.json",
-    "./admin": "./.medusa/server/src/admin/index.mjs",
-    "./workflows": "./.medusa/server/src/workflows/index.js",
-    "./providers/paypal": "./.medusa/server/src/providers/paypal/index.js",
-    "./providers/paypal_card": "./.medusa/server/src/providers/paypal_card/index.js",
-    "./modules/paypal": "./.medusa/server/src/modules/paypal/index.js",
-    ".": "./.medusa/server/src/index.js",
-    "./.medusa/server/src/modules/*": "./.medusa/server/src/modules/*/index.js",
-    "./.medusa/server/src/modules/paypal": "./.medusa/server/src/modules/paypal/index.js",
-    "./.medusa/server/src/providers/*": "./.medusa/server/src/providers/*/index.js",
-    "./.medusa/server/src/providers/paypal": "./.medusa/server/src/providers/paypal/index.js",
-    "./.medusa/server/src/providers/paypal_card": "./.medusa/server/src/providers/paypal_card/index.js",
-    "./.medusa/server/src/admin": "./.medusa/server/src/admin/index.mjs",
-    "./.medusa/server/src/workflows": "./.medusa/server/src/workflows/index.js",
-    "./.medusa/server/src/*": "./.medusa/server/src/*.js",
-    "./.medusa/*": "./.medusa/*"
-  },
-  "scripts": {
-    "build": "medusa plugin:build",
-    "develop": "medusa plugin:develop",
-    "prepublishOnly": "npm run build"
-  },
-  "devDependencies": {
-    "@medusajs/admin-sdk": "2.12.5",
-    "@medusajs/cli": "2.12.5",
-    "@medusajs/framework": "2.12.5",
-    "@medusajs/medusa": "2.12.5",
-    "@medusajs/test-utils": "2.12.5",
-    "@medusajs/ui": "^4.0.0",
-    "@medusajs/icons": "2.12.5",
-    "@swc/core": "^1.5.7",
-    "typescript": "^5.6.2"
-  },
-  "peerDependencies": {
-    "@medusajs/admin-sdk": "^2.12.0",
-    "@medusajs/framework": "^2.12.0",
-    "@medusajs/medusa": "^2.12.0",
-    "@medusajs/ui": "^4.0.0",
-    "@medusajs/icons": "^2.12.0"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "engines": {
-    "node": ">=20"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/easypayment/medusa-paypal.git"
-  },
-  "keywords": [
-    "medusa",
-    "paypal",
-    "payment",
-    "ecommerce",
-    "plugin"
-  ]
-}
+{
+  "name": "@easypayment/medusa-paypal",
+  "version": "0.4.8",
+  "description": "Industry-standard PayPal integration for Medusa v2",
+  "license": "MIT",
+  "main": "./.medusa/server/src/index.js",
+  "types": "./.medusa/server/src/index.d.ts",
+  "files": [
+    ".medusa/server",
+    "src",
+    "scripts",
+    "package.json",
+    "README.md",
+    "LICENSE",
+    "tsconfig.json"
+  ],
+  "exports": {
+    "./package.json": "./package.json",
+    "./admin": "./.medusa/server/src/admin/index.mjs",
+    "./workflows": "./.medusa/server/src/workflows/index.js",
+    "./providers/paypal": "./.medusa/server/src/providers/paypal/index.js",
+    "./providers/paypal_card": "./.medusa/server/src/providers/paypal_card/index.js",
+    "./modules/paypal": "./.medusa/server/src/modules/paypal/index.js",
+    ".": "./.medusa/server/src/index.js",
+    "./.medusa/server/src/modules/*": "./.medusa/server/src/modules/*/index.js",
+    "./.medusa/server/src/modules/paypal": "./.medusa/server/src/modules/paypal/index.js",
+    "./.medusa/server/src/providers/*": "./.medusa/server/src/providers/*/index.js",
+    "./.medusa/server/src/providers/paypal": "./.medusa/server/src/providers/paypal/index.js",
+    "./.medusa/server/src/providers/paypal_card": "./.medusa/server/src/providers/paypal_card/index.js",
+    "./.medusa/server/src/admin": "./.medusa/server/src/admin/index.mjs",
+    "./.medusa/server/src/workflows": "./.medusa/server/src/workflows/index.js",
+    "./.medusa/server/src/*": "./.medusa/server/src/*.js",
+    "./.medusa/*": "./.medusa/*"
+  },
+  "scripts": {
+    "build": "medusa plugin:build",
+    "develop": "medusa plugin:develop",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@medusajs/admin-sdk": "2.12.5",
+    "@medusajs/cli": "2.12.5",
+    "@medusajs/framework": "2.12.5",
+    "@medusajs/medusa": "2.12.5",
+    "@medusajs/test-utils": "2.12.5",
+    "@medusajs/ui": "^4.0.0",
+    "@medusajs/icons": "2.12.5",
+    "@swc/core": "^1.5.7",
+    "typescript": "^5.6.2"
+  },
+  "peerDependencies": {
+    "@medusajs/admin-sdk": "^2.12.0",
+    "@medusajs/framework": "^2.12.0",
+    "@medusajs/medusa": "^2.12.0",
+    "@medusajs/ui": "^4.0.0",
+    "@medusajs/icons": "^2.12.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/easypayment/medusa-paypal.git"
+  },
+  "keywords": [
+    "medusa",
+    "paypal",
+    "payment",
+    "ecommerce",
+    "plugin"
+  ]
+}

package/src/admin/index.ts

@@ -1,7 +1,7 @@
-import { definePlugin } from "@medusajs/admin-sdk"
-import paypalRoute from "./routes/settings/paypal/page"
-
-export default definePlugin({
-  id: "paypal-backend",
-  routes: [paypalRoute],
-})
+import { definePlugin } from "@medusajs/admin-sdk"
+import paypalRoute from "./routes/settings/paypal/page"
+
+export default definePlugin({
+  id: "paypal-backend",
+  routes: [paypalRoute],
+})

package/src/admin/routes/settings/paypal/_components/Tabs.tsx

@@ -1,52 +1,52 @@
-import React from "react"
-import { Link, useLocation } from "react-router-dom"
-
-type Tab = {
-  label: string
-  to: string
-}
-
-const BASE = "/settings/paypal"
-
-const TABS: Tab[] = [
-  { label: "PayPal Connection", to: `${BASE}/connection` },
-  { label: "PayPal Settings", to: `${BASE}/paypal-settings` },
-  { label: "Advanced Card Payments", to: `${BASE}/advanced-card-payments` },
-/*  { label: "Google Pay", to: `${BASE}/google-pay` },
-  { label: "Apple Pay", to: `${BASE}/apple-pay` },
-  { label: "Pay Later Messaging", to: `${BASE}/pay-later-messaging` }, */
-  { label: "Additional Settings", to: `${BASE}/additional-settings` },
-]
-
-function isActive(pathname: string, to: string) {
-  // exact match OR nested route under same tab
-  return pathname === to || pathname.startsWith(to + "/")
-}
-
-export default function PayPalTabs() {
-  const { pathname } = useLocation()
-
-  return (
-    <div className="border-b border-ui-border-base">
-      <div className="flex flex-wrap gap-6 text-sm">
-        {TABS.map((t) => {
-          const active = isActive(pathname, t.to)
-
-          return (
-            <Link
-              key={t.to}
-              to={t.to}
-              className={
-                active
-                  ? "border-b-2 border-ui-fg-base pb-2 font-medium text-ui-fg-base"
-                  : "pb-2 text-ui-fg-subtle hover:text-ui-fg-base"
-              }
-            >
-              {t.label}
-            </Link>
-          )
-        })}
-      </div>
-    </div>
-  )
-}
+import React from "react"
+import { Link, useLocation } from "react-router-dom"
+
+type Tab = {
+  label: string
+  to: string
+}
+
+const BASE = "/settings/paypal"
+
+const TABS: Tab[] = [
+  { label: "PayPal Connection", to: `${BASE}/connection` },
+  { label: "PayPal Settings", to: `${BASE}/paypal-settings` },
+  { label: "Advanced Card Payments", to: `${BASE}/advanced-card-payments` },
+/*  { label: "Google Pay", to: `${BASE}/google-pay` },
+  { label: "Apple Pay", to: `${BASE}/apple-pay` },
+  { label: "Pay Later Messaging", to: `${BASE}/pay-later-messaging` }, */
+  { label: "Additional Settings", to: `${BASE}/additional-settings` },
+]
+
+function isActive(pathname: string, to: string) {
+  // exact match OR nested route under same tab
+  return pathname === to || pathname.startsWith(to + "/")
+}
+
+export default function PayPalTabs() {
+  const { pathname } = useLocation()
+
+  return (
+    <div className="border-b border-ui-border-base">
+      <div className="flex flex-wrap gap-6 text-sm">
+        {TABS.map((t) => {
+          const active = isActive(pathname, t.to)
+
+          return (
+            <Link
+              key={t.to}
+              to={t.to}
+              className={
+                active
+                  ? "border-b-2 border-ui-fg-base pb-2 font-medium text-ui-fg-base"
+                  : "pb-2 text-ui-fg-subtle hover:text-ui-fg-base"
+              }
+            >
+              {t.label}
+            </Link>
+          )
+        })}
+      </div>
+    </div>
+  )
+}

package/src/admin/routes/settings/paypal/_components/Toast.tsx

@@ -1,51 +1,51 @@
-import React, { useEffect } from "react"
-
-export type ToastKind = "success" | "error"
-
-export type ToastState = {
-  kind: ToastKind
-  message: string
-} | null
-
-type Props = {
-  toast: ToastState
-  onClose: () => void
-}
-
-export default function Toast({ toast, onClose }: Props) {
-  useEffect(() => {
-    if (!toast) return
-    const t = setTimeout(() => onClose(), 2500)
-    return () => clearTimeout(t)
-  }, [toast, onClose])
-
-  if (!toast) return null
-
-  const isSuccess = toast.kind === "success"
-
-  return (
-    <div className="fixed right-6 top-6 z-[9999]">
-      <div
-        className={[
-          "min-w-[280px] max-w-[420px] rounded-lg border px-4 py-3 shadow-md",
-          isSuccess ? "border-emerald-500/30 bg-emerald-500/10" : "border-rose-500/30 bg-rose-500/10",
-        ].join(" ")}
-        role="status"
-        aria-live="polite"
-      >
-        <div className="flex items-start gap-3">
-          <div className={["mt-0.5 h-2.5 w-2.5 rounded-full", isSuccess ? "bg-emerald-500" : "bg-rose-500"].join(" ")} />
-          <div className="flex-1 text-sm text-ui-fg-base">{toast.message}</div>
-          <button
-            type="button"
-            onClick={onClose}
-            className="text-ui-fg-subtle hover:text-ui-fg-base"
-            aria-label="Close"
-          >
-            ×
-          </button>
-        </div>
-      </div>
-    </div>
-  )
-}
+import React, { useEffect } from "react"
+
+export type ToastKind = "success" | "error"
+
+export type ToastState = {
+  kind: ToastKind
+  message: string
+} | null
+
+type Props = {
+  toast: ToastState
+  onClose: () => void
+}
+
+export default function Toast({ toast, onClose }: Props) {
+  useEffect(() => {
+    if (!toast) return
+    const t = setTimeout(() => onClose(), 2500)
+    return () => clearTimeout(t)
+  }, [toast, onClose])
+
+  if (!toast) return null
+
+  const isSuccess = toast.kind === "success"
+
+  return (
+    <div className="fixed right-6 top-6 z-[9999]">
+      <div
+        className={[
+          "min-w-[280px] max-w-[420px] rounded-lg border px-4 py-3 shadow-md",
+          isSuccess ? "border-emerald-500/30 bg-emerald-500/10" : "border-rose-500/30 bg-rose-500/10",
+        ].join(" ")}
+        role="status"
+        aria-live="polite"
+      >
+        <div className="flex items-start gap-3">
+          <div className={["mt-0.5 h-2.5 w-2.5 rounded-full", isSuccess ? "bg-emerald-500" : "bg-rose-500"].join(" ")} />
+          <div className="flex-1 text-sm text-ui-fg-base">{toast.message}</div>
+          <button
+            type="button"
+            onClick={onClose}
+            className="text-ui-fg-subtle hover:text-ui-fg-base"
+            aria-label="Close"
+          >
+            ×
+          </button>
+        </div>
+      </div>
+    </div>
+  )
+}