@amboras-dev/authorize-net 1.0.0

package/dist/index.d.mts

@@ -0,0 +1,101 @@
+import { ComponentType } from 'react';
+
+/**
+ * Session data returned by Amboras' multi-tenant Authorize.Net Accept Hosted
+ * provider. Authorize.Net hosts the card form, but unlike iyzico it does not
+ * hand back a navigable URL: `getHostedPaymentPageRequest` returns a token
+ * that has to be form-POSTed as `token` to the environment's Accept Hosted
+ * endpoint. Storefront adapters therefore auto-submit a hidden form instead
+ * of assigning `window.location`, and the token is minted at redirect time
+ * because it expires 15 minutes after it is issued.
+ */
+interface AuthorizeNetSessionData {
+    authorize_net_environment_id: string;
+    /** Accept Hosted form target for the selected environment. */
+    post_url?: AuthorizeNetPostUrl;
+    /** Accept Hosted token. Valid 15 minutes from mint; minted at redirect time. */
+    token?: string;
+    /** Only 'redirect' in T1. 'lightbox' and 'iframe' are T2. */
+    mode: AuthorizeNetHostedMode;
+    environment: AuthorizeNetEnvironment;
+    currency_code: AuthorizeNetCurrency;
+    /** Two-decimal string, already converted out of Amboras minor units. */
+    amount: string;
+    ref_id?: string;
+    trans_id?: string;
+    /** Masked account number from transactionResponse.accountNumber, e.g. 'XXXX0015'. */
+    account_number_masked?: string;
+    transaction_status?: AuthorizeNetTransactionStatus;
+    payment_status?: AuthorizeNetPaymentStatus;
+}
+/**
+ * Single-member union on purpose: adding Accept Hosted's lightbox and iframe
+ * modes in T2 is then a compile-visible widening rather than a silent string
+ * change.
+ */
+type AuthorizeNetHostedMode = 'redirect';
+type AuthorizeNetEnvironment = 'sandbox' | 'production';
+/**
+ * Accept Hosted form targets. The pair is fixed by Authorize.Net and is
+ * selected by `environment`, so it is spelled as a literal union to keep a
+ * sandbox token from ever being posted at the production host.
+ */
+type AuthorizeNetPostUrl = 'https://test.authorize.net/payment/payment' | 'https://accept.authorize.net/payment/payment';
+/**
+ * The eleven currencies Authorize.Net settles. An account is denominated in
+ * exactly one of them, so this is an allowlist for the merchant's account,
+ * not a per-cart choice.
+ */
+type AuthorizeNetCurrency = 'USD' | 'CAD' | 'GBP' | 'EUR' | 'AUD' | 'NZD' | 'CHF' | 'DKK' | 'NOK' | 'SEK' | 'PLN';
+/** `transactionStatus` from getTransactionDetailsRequest, which drives the void-vs-refund branch. */
+type AuthorizeNetTransactionStatus = 'authorizedPendingCapture' | 'capturedPendingSettlement' | 'authorizedPendingRelease' | 'settledSuccessfully' | 'declined' | 'voided' | 'refundSettledSuccessfully' | 'refundPendingSettlement' | 'FDSPendingReview' | 'FDSAuthorizedPendingReview';
+/** Collapsed outcome for the storefront. 'held' means the transaction is sitting in Fraud Detection Suite review. */
+type AuthorizeNetPaymentStatus = 'approved' | 'declined' | 'error' | 'held';
+/** Prefix every Medusa payment provider id in the Authorize.Net family carries. */
+type AuthorizeNetProviderIdPrefix = 'pp_authorize-net_';
+/** Canonical id is `pp_authorize-net_authorize-net`; the template matches the whole family by prefix. */
+type AuthorizeNetProviderId = `${AuthorizeNetProviderIdPrefix}${string}`;
+/**
+ * Props the payment-adapter component receives from the storefront checkout.
+ * Field-for-field mirror of the starter-template storefront's
+ * `PaymentProviderComponentProps`. `cart` is `unknown` so this package keeps
+ * zero dependency on the storefront's path aliases.
+ */
+interface AuthorizeNetAdapterProps {
+    /** Active cart, for currency and total. Storefront's `Cart` shape. */
+    cart: unknown;
+    /** Raw `data` field from the initialized payment session, or null while loading. */
+    sessionData: Record<string, unknown> | null;
+    /** True while a network request (e.g. cart.complete()) is in flight. */
+    isCompleting: boolean;
+    /** Called after the buyer authorizes payment. */
+    onApproved: () => Promise<void>;
+    /** Called on provider-side error or buyer cancellation. */
+    onError: (msg: string) => void;
+    /**
+     * One-page checkout hook. When provided, the adapter must not render its
+     * own submit button and instead registers a confirm function with the outer
+     * "Pay now" bar. Call `registerConfirm(null)` on unmount.
+     */
+    registerConfirm?: (fn: (() => Promise<void>) | null) => void;
+}
+/**
+ * Shape of the provider object the orchestrator-owned adapter template
+ * exports into `lib/payment-providers/authorize-net.tsx`. Mirrors the
+ * storefront's `PaymentProviderConfig` and is kept local for the same
+ * zero-storefront-dependency reason as `AuthorizeNetAdapterProps`.
+ */
+interface AuthorizeNetProviderRegistryEntry {
+    /** Canonical Medusa payment provider id, `pp_authorize-net_authorize-net`. */
+    id: AuthorizeNetProviderId;
+    /** Short human label for the picker button. */
+    label: string;
+    /** Layout hint for the stacked checkout. Accept Hosted leaves our origin, so it is 'redirect'. */
+    kind: 'express' | 'form' | 'redirect';
+    /** Matches every provider id in the family: `(id) => id.startsWith('pp_authorize-net_')`. */
+    matches?: (providerId: string) => boolean;
+    /** React component that mints the token and auto-submits the Accept Hosted form. */
+    Component: ComponentType<AuthorizeNetAdapterProps>;
+}
+
+export type { AuthorizeNetAdapterProps, AuthorizeNetCurrency, AuthorizeNetEnvironment, AuthorizeNetHostedMode, AuthorizeNetPaymentStatus, AuthorizeNetPostUrl, AuthorizeNetProviderId, AuthorizeNetProviderIdPrefix, AuthorizeNetProviderRegistryEntry, AuthorizeNetSessionData, AuthorizeNetTransactionStatus };

package/dist/index.d.ts

@@ -0,0 +1,101 @@
+import { ComponentType } from 'react';
+
+/**
+ * Session data returned by Amboras' multi-tenant Authorize.Net Accept Hosted
+ * provider. Authorize.Net hosts the card form, but unlike iyzico it does not
+ * hand back a navigable URL: `getHostedPaymentPageRequest` returns a token
+ * that has to be form-POSTed as `token` to the environment's Accept Hosted
+ * endpoint. Storefront adapters therefore auto-submit a hidden form instead
+ * of assigning `window.location`, and the token is minted at redirect time
+ * because it expires 15 minutes after it is issued.
+ */
+interface AuthorizeNetSessionData {
+    authorize_net_environment_id: string;
+    /** Accept Hosted form target for the selected environment. */
+    post_url?: AuthorizeNetPostUrl;
+    /** Accept Hosted token. Valid 15 minutes from mint; minted at redirect time. */
+    token?: string;
+    /** Only 'redirect' in T1. 'lightbox' and 'iframe' are T2. */
+    mode: AuthorizeNetHostedMode;
+    environment: AuthorizeNetEnvironment;
+    currency_code: AuthorizeNetCurrency;
+    /** Two-decimal string, already converted out of Amboras minor units. */
+    amount: string;
+    ref_id?: string;
+    trans_id?: string;
+    /** Masked account number from transactionResponse.accountNumber, e.g. 'XXXX0015'. */
+    account_number_masked?: string;
+    transaction_status?: AuthorizeNetTransactionStatus;
+    payment_status?: AuthorizeNetPaymentStatus;
+}
+/**
+ * Single-member union on purpose: adding Accept Hosted's lightbox and iframe
+ * modes in T2 is then a compile-visible widening rather than a silent string
+ * change.
+ */
+type AuthorizeNetHostedMode = 'redirect';
+type AuthorizeNetEnvironment = 'sandbox' | 'production';
+/**
+ * Accept Hosted form targets. The pair is fixed by Authorize.Net and is
+ * selected by `environment`, so it is spelled as a literal union to keep a
+ * sandbox token from ever being posted at the production host.
+ */
+type AuthorizeNetPostUrl = 'https://test.authorize.net/payment/payment' | 'https://accept.authorize.net/payment/payment';
+/**
+ * The eleven currencies Authorize.Net settles. An account is denominated in
+ * exactly one of them, so this is an allowlist for the merchant's account,
+ * not a per-cart choice.
+ */
+type AuthorizeNetCurrency = 'USD' | 'CAD' | 'GBP' | 'EUR' | 'AUD' | 'NZD' | 'CHF' | 'DKK' | 'NOK' | 'SEK' | 'PLN';
+/** `transactionStatus` from getTransactionDetailsRequest, which drives the void-vs-refund branch. */
+type AuthorizeNetTransactionStatus = 'authorizedPendingCapture' | 'capturedPendingSettlement' | 'authorizedPendingRelease' | 'settledSuccessfully' | 'declined' | 'voided' | 'refundSettledSuccessfully' | 'refundPendingSettlement' | 'FDSPendingReview' | 'FDSAuthorizedPendingReview';
+/** Collapsed outcome for the storefront. 'held' means the transaction is sitting in Fraud Detection Suite review. */
+type AuthorizeNetPaymentStatus = 'approved' | 'declined' | 'error' | 'held';
+/** Prefix every Medusa payment provider id in the Authorize.Net family carries. */
+type AuthorizeNetProviderIdPrefix = 'pp_authorize-net_';
+/** Canonical id is `pp_authorize-net_authorize-net`; the template matches the whole family by prefix. */
+type AuthorizeNetProviderId = `${AuthorizeNetProviderIdPrefix}${string}`;
+/**
+ * Props the payment-adapter component receives from the storefront checkout.
+ * Field-for-field mirror of the starter-template storefront's
+ * `PaymentProviderComponentProps`. `cart` is `unknown` so this package keeps
+ * zero dependency on the storefront's path aliases.
+ */
+interface AuthorizeNetAdapterProps {
+    /** Active cart, for currency and total. Storefront's `Cart` shape. */
+    cart: unknown;
+    /** Raw `data` field from the initialized payment session, or null while loading. */
+    sessionData: Record<string, unknown> | null;
+    /** True while a network request (e.g. cart.complete()) is in flight. */
+    isCompleting: boolean;
+    /** Called after the buyer authorizes payment. */
+    onApproved: () => Promise<void>;
+    /** Called on provider-side error or buyer cancellation. */
+    onError: (msg: string) => void;
+    /**
+     * One-page checkout hook. When provided, the adapter must not render its
+     * own submit button and instead registers a confirm function with the outer
+     * "Pay now" bar. Call `registerConfirm(null)` on unmount.
+     */
+    registerConfirm?: (fn: (() => Promise<void>) | null) => void;
+}
+/**
+ * Shape of the provider object the orchestrator-owned adapter template
+ * exports into `lib/payment-providers/authorize-net.tsx`. Mirrors the
+ * storefront's `PaymentProviderConfig` and is kept local for the same
+ * zero-storefront-dependency reason as `AuthorizeNetAdapterProps`.
+ */
+interface AuthorizeNetProviderRegistryEntry {
+    /** Canonical Medusa payment provider id, `pp_authorize-net_authorize-net`. */
+    id: AuthorizeNetProviderId;
+    /** Short human label for the picker button. */
+    label: string;
+    /** Layout hint for the stacked checkout. Accept Hosted leaves our origin, so it is 'redirect'. */
+    kind: 'express' | 'form' | 'redirect';
+    /** Matches every provider id in the family: `(id) => id.startsWith('pp_authorize-net_')`. */
+    matches?: (providerId: string) => boolean;
+    /** React component that mints the token and auto-submits the Accept Hosted form. */
+    Component: ComponentType<AuthorizeNetAdapterProps>;
+}
+
+export type { AuthorizeNetAdapterProps, AuthorizeNetCurrency, AuthorizeNetEnvironment, AuthorizeNetHostedMode, AuthorizeNetPaymentStatus, AuthorizeNetPostUrl, AuthorizeNetProviderId, AuthorizeNetProviderIdPrefix, AuthorizeNetProviderRegistryEntry, AuthorizeNetSessionData, AuthorizeNetTransactionStatus };

package/dist/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+module.exports = __toCommonJS(src_exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export type {\n  AuthorizeNetSessionData,\n  AuthorizeNetHostedMode,\n  AuthorizeNetEnvironment,\n  AuthorizeNetPostUrl,\n  AuthorizeNetCurrency,\n  AuthorizeNetTransactionStatus,\n  AuthorizeNetPaymentStatus,\n  AuthorizeNetProviderIdPrefix,\n  AuthorizeNetProviderId,\n  AuthorizeNetAdapterProps,\n  AuthorizeNetProviderRegistryEntry,\n} from './types'\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/index.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@amboras-dev/authorize-net",
+  "version": "1.0.0",
+  "description": "Authorize.Net Accept Hosted payment provider types for Amboras storefronts",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/react": "^18.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit"
+  }
+}