stripe-decline-codes 0.1.0 → 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018-2026 Hidetaka Okamoto
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -9,13 +9,15 @@ A lightweight, zero-dependency TypeScript library providing human-readable descr
 
 ## Features
 
-- 🎯 **Complete Coverage** - All 44 Stripe decline codes included
+- 🎯 **Complete Coverage** - All 43 Stripe decline codes included
 - 🌐 **Localization** - Built-in English and Japanese translations
 - 📘 **TypeScript Support** - Full type definitions included
 - 🪶 **Zero Dependencies** - Lightweight and fast
 - 🔄 **Up-to-date** - Based on Stripe API documentation (2024-12-18)
 - ✅ **Well Tested** - Comprehensive test coverage
 - 🎨 **Message Formatting** - Customizable message templates with variable substitution
+- 🔍 **Decline Categorization** - Soft/Hard decline classification based on Stripe guidelines
+- ⚡ **Stripe SDK Integration** - Direct error object support for seamless integration
 
 ## About This Project
 
@@ -87,7 +89,7 @@ isValidDeclineCode('invalid_code'); // => false
 import { getAllDeclineCodes } from 'stripe-decline-codes';
 
 const codes = getAllDeclineCodes();
-console.log(codes.length); // => 44
+console.log(codes.length); // => 43
 console.log(codes);
 // => ['approve_with_id', 'call_issuer', 'card_not_supported', ...]
 ```
@@ -108,16 +110,100 @@ try {
     currency: 'usd',
     source: 'tok_chargeDeclined',
   });
-} catch (error) {
-  if (error.type === 'StripeCardError') {
-    const declineCode = error.decline_code;
-    const userMessage = getDeclineMessage(declineCode, 'en');
+} catch (err) {
+  const error = err as Stripe.StripeCardError;
+  if (error.type === 'card_error' && error.decline_code) {
+    const userMessage = getDeclineMessage(error.decline_code, 'en');
     console.log(userMessage);
     // Display this message to your user
   }
 }
 ```
 
+### Decline Code Categorization
+
+Understand whether a decline is temporary (soft) or permanent (hard):
+
+```typescript
+import { getDeclineCategory, isSoftDecline, isHardDecline } from 'stripe-decline-codes';
+
+// Get the category
+const category = getDeclineCategory('insufficient_funds');
+console.log(category); // => 'SOFT_DECLINE'
+
+// Check if it's a soft decline (temporary, can retry)
+if (isSoftDecline('insufficient_funds')) {
+  console.log('This is a temporary issue, you can retry the payment');
+}
+
+// Check if it's a hard decline (permanent, should not retry)
+if (isHardDecline('fraudulent')) {
+  console.log('This is a permanent decline, do not retry');
+}
+```
+
+### Extract Message from Stripe Error
+
+Directly extract user-facing messages from Stripe error objects:
+
+```typescript
+import Stripe from 'stripe';
+import { getMessageFromStripeError, isHardDecline } from 'stripe-decline-codes';
+
+const stripe = new Stripe(process.env.STRIPE_SECRET_KEY);
+
+try {
+  const charge = await stripe.charges.create({
+    amount: 2000,
+    currency: 'usd',
+    source: 'tok_chargeDeclined',
+  });
+} catch (err) {
+  const error = err as Stripe.StripeCardError;
+  if (error.type === 'card_error' && error.decline_code) {
+    // Get localized message directly from error object
+    const userMessage = getMessageFromStripeError(error, 'ja');
+
+    // Check if retry is recommended
+    if (isHardDecline(error.decline_code)) {
+      // Ask for a different payment method
+      console.log('Please use a different card');
+    } else {
+      // Retry is possible
+      console.log('You may retry this payment');
+    }
+  }
+}
+```
+
+### Typed Error Narrowing
+
+Narrow an unknown caught error to one carrying a known `DeclineCode`:
+
+```typescript
+import { isStripeDeclineError, getDeclineCodeFromError, isSoftDecline } from 'stripe-decline-codes';
+
+try {
+  const charge = await stripe.charges.create({ ... });
+} catch (err) {
+  // Type guard — inside this block err.decline_code is typed as DeclineCode
+  if (isStripeDeclineError(err)) {
+    console.log(err.decline_code); // DeclineCode (not just string)
+  }
+
+  // Or extract the validated code directly from any caught value
+  const code = getDeclineCodeFromError(err); // DeclineCode | undefined
+  if (code && isSoftDecline(code)) {
+    // safe to retry
+  }
+}
+```
+
+The narrowing assumes the `stripe-node` >= 18 error shape, where
+`StripeCardError.decline_code` is a required `string`. Errors from
+`stripe-node` <= 17 or plain objects fall back to the same runtime check, so
+they work identically — only `decline_code` may be absent.
+
 ## API Reference
 
 ### Core Functions
@@ -180,9 +266,56 @@ const message = formatDeclineMessage('insufficient_funds', 'en', {
 });
 ```
 
+### Decline Categorization Functions
+
+#### `getDeclineCategory(code: string): DeclineCategory | undefined`
+
+Returns the category of a decline code ('SOFT_DECLINE' or 'HARD_DECLINE').
+
+**Parameters:**
+- `code` - The Stripe decline code
+
+**Returns:** `'SOFT_DECLINE' | 'HARD_DECLINE' | undefined`
+
+#### `isHardDecline(code: string): boolean`
+
+Checks if a decline code is a hard decline (permanent, should not retry).
+
+**Returns:** `true` if the code is a hard decline, `false` otherwise
+
+#### `isSoftDecline(code: string): boolean`
+
+Checks if a decline code is a soft decline (temporary, can retry).
+
+**Returns:** `true` if the code is a soft decline, `false` otherwise
+
+### Stripe Error Integration
+
+#### `getMessageFromStripeError(error: unknown, locale?: Locale): string | undefined`
+
+Extracts a localized user-facing message directly from a Stripe error object. Accepts any caught value; returns `undefined` for non-object inputs or missing/unknown decline codes.
+
+**Parameters:**
+- `error` - The Stripe error object (or any caught value)
+- `locale` - The locale to use (`'en'` or `'ja'`, default: `'en'`)
+
+**Returns:** User-facing message in the specified locale, or undefined if no decline code is present
+
+#### `isStripeDeclineError(error: unknown): error is StripeDeclineError`
+
+Type guard that checks whether an unknown value is an object carrying a known decline code. Inside the guarded block, `error.decline_code` is typed as `DeclineCode`.
+
+**Returns:** `true` if the value has a `decline_code` matching a known `DeclineCode`, `false` otherwise
+
+#### `getDeclineCodeFromError(error: unknown): DeclineCode | undefined`
+
+Extracts a validated decline code from any caught value. Returns `undefined` when the value has no decline code or an unrecognized one (e.g. a code newly added by Stripe).
+
+**Returns:** The decline code typed as `DeclineCode`, or `undefined`
+
 ## Supported Decline Codes
 
-This library includes all 44 Stripe decline codes:
+This library includes all 43 Stripe decline codes:
 
 - `approve_with_id` - Payment cannot be authorized
 - `call_issuer` - Card declined for unknown reason
@@ -228,6 +361,29 @@ This library includes all 44 Stripe decline codes:
 - `try_again_later` - Card declined, try again later
 - `withdrawal_count_limit_exceeded` - Credit limit exceeded
 
+## Compatibility
+
+| Environment | Support |
+| --- | --- |
+| Node.js | >= 18 (tested on 18.x / 20.x / 22.x in CI) |
+| Cloudflare Workers (workerd) | Verified via [@cloudflare/vitest-plugin](https://developers.cloudflare.com/workers/testing/vitest-integration/) runtime tests |
+| Other edge runtimes (Deno, Bun) | Should work (pure TypeScript, zero dependencies) but not CI-verified |
+| Module formats | ESM (`index.mjs`), CJS (`index.cjs`), TypeScript types (`index.d.ts`) |
+
+### Stripe SDK compatibility
+
+This package has **no dependency** on the `stripe` package. The `StripeError`
+type accepted by `getMessageFromStripeError` is a structural interface, so it
+works with error objects from any `stripe-node` version — and with plain
+objects such as `JSON.parse`d API responses.
+
+The helpers are designed against the `stripe-node` **>= 18** error shape, in
+which `StripeCardError.decline_code` is a required `string`. On `stripe-node`
+**<= 17** (where `decline_code` is optional) errors still type-check and run
+correctly via the structural fallback — the only difference is that
+`decline_code` may be `undefined`, which the helpers already handle by
+returning `undefined`.
+
 ## TypeScript
 
 This library is written in TypeScript and includes full type definitions:
@@ -239,41 +395,54 @@ import type {
   DeclineCodeResult,
   Locale,
   Translation,
+  DeclineCategory,
+  StripeError,
+  StripeDeclineError,
 } from 'stripe-decline-codes';
 ```
 
 ## Development
 
+This project uses [pnpm](https://pnpm.io/) (`packageManager` is pinned in `package.json`).
+
 ```bash
 # Install dependencies
-npm install
+pnpm install
 
 # Run tests
-npm test
+pnpm test
 
 # Run tests in watch mode
-npm run test:watch
+pnpm run test:watch
 
 # Build
-npm run build
+pnpm run build
 
 # Lint
-npm run lint
+pnpm run lint
 
 # Format code
-npm run format
+pnpm run format
 
 # Type check
-npm run typecheck
+pnpm run typecheck
 ```
 
-## Publishing
+The `docs/` directory is a separate npm project (Starlight site) and keeps using `npm`.
 
-This package uses [`np`](https://github.com/sindresorhus/np) for releases:
+## Publishing
 
-```bash
-npm run release
-```
+Releases are automated by CircleCI. Merge a PR whose commits follow
+[Conventional Commits](https://www.conventionalcommits.org/) (`feat:`, `fix:`, …)
+into `main`, and [semantic-release](https://github.com/semantic-release/semantic-release)
+pushes the git tag, publishes to npm via Trusted Publishing (OIDC), and creates the
+GitHub Release. Release notes are published on
+[GitHub Releases](https://github.com/hideokamoto/stripe-decline-codes/releases).
+Do not bump `version`, create tags, or run `npm publish` / `np` manually.
+
+The pipeline definition is shared via
+[`circleci-configurations`](https://github.com/hideokamoto/circleci-configurations)
+(`workflows/publish/npm-polyrepo-semantic-release.yaml`).
 
 ## Contributing
 

package/dist/data/decline-codes.d.ts

@@ -0,0 +1,13 @@
+import type { DeclineCode, DeclineCodeInfo } from '../types.js';
+/**
+ * Stripe API documentation version for decline codes
+ * Last updated: 2024-12
+ * Reference: https://docs.stripe.com/declines/codes
+ */
+export declare const DOC_VERSION = "2024-12-18";
+/**
+ * Complete database of Stripe decline codes with descriptions and recommended actions
+ * Includes English and Japanese translations
+ */
+export declare const DECLINE_CODES: Record<DeclineCode, DeclineCodeInfo>;
+//# sourceMappingURL=decline-codes.d.ts.map

package/dist/data/decline-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decline-codes.d.ts","sourceRoot":"","sources":["../../src/data/decline-codes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEhE;;;;GAIG;AACH,eAAO,MAAM,WAAW,eAAe,CAAC;AAExC;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE,eAAe,CA8iB9D,CAAC"}

package/dist/index.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s="2024-12-18",r={approve_with_id:{description:"The payment cannot be authorized.",nextSteps:"The payment should be attempted again. If it still cannot be processed, the customer needs to contact their card issuer.",nextUserAction:"Please try again. If it still cannot be processed, the please contact your card issuer.",category:"SOFT_DECLINE",translations:{ja:{description:"支払いは承認できません。",nextUserAction:"もう一度やり直してください。それでも処理できない場合は、カード発行会社にお問い合わせください。"}}},call_issuer:{description:"The card has been declined for an unknown reason.",nextSteps:"The customer needs to contact their card issuer for more information.",nextUserAction:"Please contact your card issuer for more information.",category:"SOFT_DECLINE",translations:{ja:{description:"カードは未知の理由で拒否されました。",nextUserAction:"詳しくはカード発行会社にお問い合わせください。"}}},card_not_supported:{description:"The card does not support this type of purchase.",nextSteps:"The customer needs to contact their card issuer to make sure their card can be used to make this type of purchase.",nextUserAction:"Your card issuer may not support this type of purchase, please contact your card issuer for more information.",category:"HARD_DECLINE",translations:{ja:{description:"カードはこのタイプの購入をサポートしません。",nextUserAction:"カード発行者はこのタイプの購入をサポートしていない可能性があります。詳細については、カード発行会社にお問い合わせください。"}}},card_velocity_exceeded:{description:"The customer has exceeded the balance or credit limit available on their card.",nextSteps:"The customer should contact their card issuer for more information.",nextUserAction:"Please contact your card issuer for more information.",category:"SOFT_DECLINE",translations:{ja:{description:"このカードの残高またはクレジット制限を超えました。",nextUserAction:"詳しくはカード発行会社にお問い合わせください。"}}},currency_not_supported:{description:"The card does not support the specified currency.",nextSteps:"The customer needs to check with the issuer whether the card can be used for the type of currency specified.",nextUserAction:"Please contact your card issuer to verify this type of currency can be used for this payment.",category:"HARD_DECLINE",translations:{ja:{description:"カードは指定された通貨をサポートしていません。",nextUserAction:"この支払いにこのタイプの通貨が使用できることを確認するには、カード発行会社に連絡してください。"}}},do_not_honor:{description:"The card has been declined for an unknown reason.",nextSteps:"The customer needs to contact their card issuer for more information.",nextUserAction:"Please contact your card issuer for more information.",category:"SOFT_DECLINE",translations:{ja:{description:"カードは未知の理由で拒否されました。",nextUserAction:"詳しくはカード発行会社にお問い合わせください。"}}},do_not_try_again:{description:"The card has been declined for an unknown reason.",nextSteps:"The customer should contact their card issuer for more information.",nextUserAction:"Please contact your card issuer for more information.",category:"HARD_DECLINE",translations:{ja:{description:"カードは未知の理由で拒否されました。",nextUserAction:"詳しくはカード発行会社にお問い合わせください。"}}},duplicate_transaction:{description:"A transaction with identical amount and credit card information was submitted very recently.",nextSteps:"Check to see if a recent payment already exists.",nextUserAction:"Check to see if a recent payment already exists.",category:"SOFT_DECLINE",translations:{ja:{description:"ごく最近、同一の金額とクレジットカード情報を使用した取引が送信されました。",nextUserAction:"最近の支払いが既に存在するかどうかを確認してください。"}}},expired_card:{description:"The card has expired.",nextSteps:"The customer should use another card.",nextUserAction:"Please use another card.",category:"HARD_DECLINE",translations:{ja:{description:"カードは期限切れです。",nextUserAction:"別のカードを使用してください。"}}},fraudulent:{description:"The payment has been declined as Stripe suspects it is fraudulent.",nextSteps:"Do not report more detailed information to your customer. Instead, present as you would the generic_decline described below.",nextUserAction:"Please contact your card issuer for more information.",category:"HARD_DECLINE",translations:{ja:{description:"不正と思われるため、支払いは拒否されました。",nextUserAction:"詳しくはカード発行会社にお問い合わせください。"}}},generic_decline:{description:"The card has been declined for an unknown reason.",nextSteps:"The customer needs to contact their card issuer for more information.",nextUserAction:"Please contact your card issuer for more information.",category:"SOFT_DECLINE",translations:{ja:{description:"カードは未知の理由で拒否されました。",nextUserAction:"詳しくはカード発行会社にお問い合わせください。"}}},incorrect_number:{description:"The card number is incorrect.",nextSteps:"The customer should try again using the correct card number.",nextUserAction:"Please check your card numbers and try again. If it still cannot be processed, the please contact your card issuer.",category:"HARD_DECLINE",translations:{ja:{description:"カード番号が正しくありません。",nextUserAction:"カード番号を確認してもう一度やり直してください。それでも処理できない場合は、カード発行会社にお問い合わせください。"}}},incorrect_cvc:{description:"The CVC number is incorrect.",nextSteps:"The customer should try again using the correct CVC.",nextUserAction:"Please check your card numbers and try again. If it still cannot be processed, the please contact your card issuer.",category:"HARD_DECLINE",translations:{ja:{description:"CVC番号が正しくありません。",nextUserAction:"CSC番号を確認してもう一度やり直してください。それでも処理できない場合は、カード発行会社にお問い合わせください。"}}},incorrect_pin:{description:"The PIN entered is incorrect. This decline code only applies to payments made with a card reader.",nextSteps:"The customer should try again using the correct PIN.",nextUserAction:"Please check your PIN and try again. If it still cannot be processed, the please contact your card issuer.",category:"HARD_DECLINE",translations:{ja:{description:"PINコードが正しくありません。",nextUserAction:"PINコードを確認してもう一度やり直してください。それでも処理できない場合は、カード発行会社にお問い合わせください。"}}},incorrect_zip:{description:"The ZIP/postal code is incorrect.",nextSteps:"The customer should try again using the correct billing ZIP/postal code.",nextUserAction:"Please try again using the correct ZIP/postal code.",category:"HARD_DECLINE",translations:{ja:{description:"郵便番号が正しくありません。",nextUserAction:"正しい郵便番号を使用してもう一度お試しください。"}}},insufficient_funds:{description:"The card has insufficient funds to complete the purchase.",nextSteps:"The customer should use an alternative payment method.",nextUserAction:"Please try again using an alternative payment method.",category:"SOFT_DECLINE",translations:{ja:{description:"カードの購入に必要な資金が不足しています。",nextUserAction:"別のお支払い方法を使用してもう一度お試しください。"}}},invalid_account:{description:"The card, or account the card is connected to, is invalid.",nextSteps:"The customer needs to contact their card issuer to check that the card is working correctly.",nextUserAction:"Please contact your card issuer for more information.",category:"HARD_DECLINE",translations:{ja:{description:"カード、またはカードが接続されているアカウントが無効です。",nextUserAction:"詳しくはカード発行会社にお問い合わせください。"}}},invalid_amount:{description:"The payment amount is invalid, or exceeds the amount that is allowed.",nextSteps:"If the amount appears to be correct, the customer needs to check with their card issuer that they can make purchases of that amount.",nextUserAction:"Please contact your card issuer for more information.",category:"SOFT_DECLINE",translations:{ja:{description:"支払い金額が無効であるか、許可されている金額を超えています。",nextUserAction:"詳しくはカード発行会社にお問い合わせください。"}}},invalid_cvc:{description:"The CVC number is incorrect.",nextSteps:"The customer should try again using the correct CVC.",nextUserAction:"Please try again using the correct CVC.",category:"HARD_DECLINE",translations:{ja:{description:"CVC番号が正しくありません。",nextUserAction:"正しいCVCを使用してもう一度やり直してください。"}}},invalid_expiry_year:{description:"The expiration year invalid.",nextSteps:"The customer should try again using the correct expiration date.",nextUserAction:"Please try again using the correct expiration date.",category:"HARD_DECLINE",translations:{ja:{description:"有効期限が無効です。",nextUserAction:"正しい有効期限を入力してもう一度お試しください。"}}},invalid_number:{description:"The card number is incorrect.",nextSteps:"The customer should try again using the correct card number.",nextUserAction:"Please try again using the correct card number.",category:"HARD_DECLINE",translations:{ja:{description:"カード番号が正しくありません。",nextUserAction:"正しいカード番号を使用してもう一度やり直してください。"}}},invalid_pin:{description:"The PIN entered is incorrect. This decline code only applies to payments made with a card reader.",nextSteps:"The customer should try again using the correct PIN.",nextUserAction:"Please try again using the correct card PIN.",category:"HARD_DECLINE",translations:{ja:{description:"PINコードが正しくありません。",nextUserAction:"正しいPINコードを使用してもう一度やり直してください。"}}},issuer_not_available:{description:"The card issuer could not be reached, so the payment could not be authorized.",nextSteps:"The payment should be attempted again. If it still cannot be processed, the customer needs to contact their card issuer.",nextUserAction:"Please try again. If it still cannot be processed, the please contact your card issuer.",category:"SOFT_DECLINE",translations:{ja:{description:"カード発行者に連絡できなかったため、支払いを承認できませんでした。",nextUserAction:"もう一度やり直してください。それでも処理できない場合は、カード発行会社にお問い合わせください。"}}},lost_card:{description:"The payment has been declined because the card is reported lost.",nextSteps:"The specific reason for the decline should not be reported to the customer. Instead, it needs to be presented as a generic decline.",nextUserAction:"Please contact your card issuer for more information.",category:"HARD_DECLINE",translations:{ja:{description:"カードは未知の理由で拒否されました。",nextUserAction:"詳しくはカード発行会社にお問い合わせください。"}}},merchant_blacklist:{description:"The payment has been declined because it matches a value on the Stripe user's blocklist.",nextSteps:"Do not report more detailed information to your customer. Instead, present as you would the generic_decline described above.",nextUserAction:"Please contact your card issuer for more information.",category:"HARD_DECLINE",translations:{ja:{description:"カードは未知の理由で拒否されました。",nextUserAction:"詳しくはカード発行会社にお問い合わせください。"}}},new_account_information_available:{description:"The card, or account the card is connected to, is invalid.",nextSteps:"The customer needs to contact their card issuer for more information.",nextUserAction:"Please contact your card issuer for more information.",category:"SOFT_DECLINE",translations:{ja:{description:"カード、またはカードが接続されているアカウントが無効です。",nextUserAction:"詳しくはカード発行会社にお問い合わせください。"}}},no_action_taken:{description:"The card has been declined for an unknown reason.",nextSteps:"The customer should contact their card issuer for more information.",nextUserAction:"Please contact your card issuer for more information.",category:"SOFT_DECLINE",translations:{ja:{description:"カードは未知の理由で拒否されました。",nextUserAction:"詳しくはカード発行会社にお問い合わせください。"}}},not_permitted:{description:"The payment is not permitted.",nextSteps:"The customer needs to contact their card issuer for more information.",nextUserAction:"Please contact your card issuer for more information.",category:"HARD_DECLINE",translations:{ja:{description:"支払いは許可されていません。",nextUserAction:"詳しくはカード発行会社にお問い合わせください。"}}},pickup_card:{description:"The card cannot be used to make this payment (it is possible it has been reported lost or stolen).",nextSteps:"The customer needs to contact their card issuer for more information.",nextUserAction:"Please contact your card issuer for more information.",category:"HARD_DECLINE",translations:{ja:{description:"カードでこの支払いを行うことはできません（紛失または盗難にあったと報告されている可能性があります）。",nextUserAction:"詳しくはカード発行会社にお問い合わせください。"}}},pin_try_exceeded:{description:"The allowable number of PIN tries has been exceeded.",nextSteps:"The customer must use another card or method of payment.",nextUserAction:"Please use another card or method of payment.",category:"SOFT_DECLINE",translations:{ja:{description:"PIN試行回数の上限を超えました。",nextUserAction:"別のカードまたはお支払い方法をご利用ください。"}}},processing_error:{description:"An error occurred while processing the card.",nextSteps:"The payment should be attempted again. If it still cannot be processed, try again later.",nextUserAction:"Please try again. If it still cannot be processed, the please contact your card issuer.",category:"SOFT_DECLINE",translations:{ja:{description:"カードの処理中にエラーが発生しました。",nextUserAction:"もう一度やり直してください。それでも処理できない場合は、カード発行会社にお問い合わせください。"}}},reenter_transaction:{description:"The payment could not be processed by the issuer for an unknown reason.",nextSteps:"The payment should be attempted again. If it still cannot be processed, the customer needs to contact their card issuer.",nextUserAction:"Please try again. If it still cannot be processed, the please contact your card issuer.",category:"SOFT_DECLINE",translations:{ja:{description:"原因不明のため、発行者が支払いを処理できませんでした。",nextUserAction:"もう一度やり直してください。それでも処理できない場合は、カード発行会社にお問い合わせください。"}}},restricted_card:{description:"The card cannot be used to make this payment (it is possible it has been reported lost or stolen).",nextSteps:"The customer needs to contact their card issuer for more information.",nextUserAction:"Please contact your card issuer for more information.",category:"HARD_DECLINE",translations:{ja:{description:"カードでこの支払いを行うことはできません（紛失または盗難にあったと報告されている可能性があります）。",nextUserAction:"詳しくはカード発行会社にお問い合わせください。"}}},revocation_of_all_authorizations:{description:"The card has been declined for an unknown reason.",nextSteps:"The customer should contact their card issuer for more information.",nextUserAction:"Please contact your card issuer for more information.",category:"HARD_DECLINE",translations:{ja:{description:"カードは未知の理由で拒否されました。",nextUserAction:"詳しくはカード発行会社にお問い合わせください。"}}},revocation_of_authorization:{description:"The card has been declined for an unknown reason.",nextSteps:"The customer should contact their card issuer for more information.",nextUserAction:"Please contact your card issuer for more information.",category:"HARD_DECLINE",translations:{ja:{description:"カードは未知の理由で拒否されました。",nextUserAction:"詳しくはカード発行会社にお問い合わせください。"}}},security_violation:{description:"The card has been declined for an unknown reason.",nextSteps:"The customer needs to contact their card issuer for more information.",nextUserAction:"Please contact your card issuer for more information.",category:"HARD_DECLINE",translations:{ja:{description:"カードは未知の理由で拒否されました。",nextUserAction:"詳しくはカード発行会社にお問い合わせください。"}}},service_not_allowed:{description:"The card has been declined for an unknown reason.",nextSteps:"The customer should contact their card issuer for more information.",nextUserAction:"Please contact your card issuer for more information.",category:"HARD_DECLINE",translations:{ja:{description:"カードは未知の理由で拒否されました。",nextUserAction:"詳しくはカード発行会社にお問い合わせください。"}}},stolen_card:{description:"The payment has been declined because the card is reported stolen.",nextSteps:"The specific reason for the decline should not be reported to the customer. Instead, it needs to be presented as a generic decline.",nextUserAction:"Please contact your card issuer for more information.",category:"HARD_DECLINE",translations:{ja:{description:"カードは未知の理由で拒否されました。",nextUserAction:"詳しくはカード発行会社にお問い合わせください。"}}},stop_payment_order:{description:"The card has been declined for an unknown reason.",nextSteps:"The customer should contact their card issuer for more information.",nextUserAction:"Please contact your card issuer for more information.",category:"HARD_DECLINE",translations:{ja:{description:"カードは未知の理由で拒否されました。",nextUserAction:"詳しくはカード発行会社にお問い合わせください。"}}},testmode_decline:{description:"A Stripe test card number was used.",nextSteps:"A genuine card must be used to make a payment.",nextUserAction:"A genuine card must be used to make a payment.",category:"HARD_DECLINE",translations:{ja:{description:"Stripeテストカード番号を使用しました。",nextUserAction:"支払いには本物のカードを使用する必要があります。"}}},transaction_not_allowed:{description:"The card has been declined for an unknown reason.",nextSteps:"The customer needs to contact their card issuer for more information.",nextUserAction:"Please contact your card issuer for more information.",category:"HARD_DECLINE",translations:{ja:{description:"カードは未知の理由で拒否されました。",nextUserAction:"詳しくはカード発行会社にお問い合わせください。"}}},try_again_later:{description:"The card has been declined for an unknown reason.",nextSteps:"Ask the customer to attempt the payment again. If subsequent payments are declined, the customer should contact their card issuer for more information.",nextUserAction:"Please try again. If it still cannot be processed, the please contact your card issuer.",category:"SOFT_DECLINE",translations:{ja:{description:"カードは未知の理由で拒否されました。",nextUserAction:"もう一度やり直してください。それでも処理できない場合は、カード発行会社にお問い合わせください。"}}},withdrawal_count_limit_exceeded:{description:"The customer has exceeded the balance or credit limit available on their card.",nextSteps:"The customer should use an alternative payment method.",nextUserAction:"Please use another card or contact your card issuer for more information.",category:"SOFT_DECLINE",translations:{ja:{description:"このカードの残高またはクレジット制限を超えました。",nextUserAction:"別のカードを使用するか、カード発行会社にお問い合わせください。"}}}};function y(e){if(!e||!o(e))return{docVersion:s,code:{}};const t=r[e];return{docVersion:s,code:t}}function c(e,t="en"){if(!o(e))return;const n=r[e];return t==="en"?n.nextUserAction:n.translations?.[t]?.nextUserAction}function f(){return Object.keys(r)}function o(e){return Object.hasOwn(r,e)}function x(){return s}function g(e,t="en",n){const i=c(e,t);if(!i)return;if(!n||Object.keys(n).length===0)return i;let a=i;for(const[l,p]of Object.entries(n)){const h=l.replace(/[.*+?^${}()|[\]\\]/g,"\\$&"),m=new RegExp(`\\{\\{${h}\\}\\}`,"g");a=a.replace(m,p)}return a}function d(e){if(o(e))return r[e].category}function A(e){return d(e)==="HARD_DECLINE"}function _(e){return d(e)==="SOFT_DECLINE"}function D(e,t="en"){if(u(e))return c(e.decline_code,t)}function u(e){return typeof e=="object"&&e!==null&&"decline_code"in e&&typeof e.decline_code=="string"&&o(e.decline_code)}function E(e){return u(e)?e.decline_code:void 0}exports.DECLINE_CODES=r;exports.DOC_VERSION=s;exports.formatDeclineMessage=g;exports.getAllDeclineCodes=f;exports.getDeclineCategory=d;exports.getDeclineCodeFromError=E;exports.getDeclineDescription=y;exports.getDeclineMessage=c;exports.getDocVersion=x;exports.getMessageFromStripeError=D;exports.isHardDecline=A;exports.isSoftDecline=_;exports.isStripeDeclineError=u;exports.isValidDeclineCode=o;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../src/data/decline-codes.ts","../src/index.ts"],"sourcesContent":["import type { DeclineCode, DeclineCodeInfo } from '../types.js';\n\n/**\n * Stripe API documentation version for decline codes\n * Last updated: 2024-12\n * Reference: https://docs.stripe.com/declines/codes\n */\nexport const DOC_VERSION = '2024-12-18';\n\n/**\n * Complete database of Stripe decline codes with descriptions and recommended actions\n * Includes English and Japanese translations\n */\nexport const DECLINE_CODES: Record<DeclineCode, DeclineCodeInfo> = {\n  approve_with_id: {\n    description: 'The payment cannot be authorized.',\n    nextSteps:\n      'The payment should be attempted again. If it still cannot be processed, the customer needs to contact their card issuer.',\n    nextUserAction:\n      'Please try again. If it still cannot be processed, the please contact your card issuer.',\n    category: 'SOFT_DECLINE',\n    translations: {\n      ja: {\n        description: '支払いは承認できません。',\n        nextUserAction:\n          'もう一度やり直してください。それでも処理できない場合は、カード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  call_issuer: {\n    description: 'The card has been declined for an unknown reason.',\n    nextSteps: 'The customer needs to contact their card issuer for more information.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'SOFT_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードは未知の理由で拒否されました。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  card_not_supported: {\n    description: 'The card does not support this type of purchase.',\n    nextSteps:\n      'The customer needs to contact their card issuer to make sure their card can be used to make this type of purchase.',\n    nextUserAction:\n      'Your card issuer may not support this type of purchase, please contact your card issuer for more information.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードはこのタイプの購入をサポートしません。',\n        nextUserAction:\n          'カード発行者はこのタイプの購入をサポートしていない可能性があります。詳細については、カード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  card_velocity_exceeded: {\n    description: 'The customer has exceeded the balance or credit limit available on their card.',\n    nextSteps: 'The customer should contact their card issuer for more information.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'SOFT_DECLINE',\n    translations: {\n      ja: {\n        description: 'このカードの残高またはクレジット制限を超えました。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  currency_not_supported: {\n    description: 'The card does not support the specified currency.',\n    nextSteps:\n      'The customer needs to check with the issuer whether the card can be used for the type of currency specified.',\n    nextUserAction:\n      'Please contact your card issuer to verify this type of currency can be used for this payment.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードは指定された通貨をサポートしていません。',\n        nextUserAction:\n          'この支払いにこのタイプの通貨が使用できることを確認するには、カード発行会社に連絡してください。',\n      },\n    },\n  },\n  do_not_honor: {\n    description: 'The card has been declined for an unknown reason.',\n    nextSteps: 'The customer needs to contact their card issuer for more information.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'SOFT_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードは未知の理由で拒否されました。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  do_not_try_again: {\n    description: 'The card has been declined for an unknown reason.',\n    nextSteps: 'The customer should contact their card issuer for more information.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードは未知の理由で拒否されました。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  duplicate_transaction: {\n    description:\n      'A transaction with identical amount and credit card information was submitted very recently.',\n    nextSteps: 'Check to see if a recent payment already exists.',\n    nextUserAction: 'Check to see if a recent payment already exists.',\n    category: 'SOFT_DECLINE',\n    translations: {\n      ja: {\n        description: 'ごく最近、同一の金額とクレジットカード情報を使用した取引が送信されました。',\n        nextUserAction: '最近の支払いが既に存在するかどうかを確認してください。',\n      },\n    },\n  },\n  expired_card: {\n    description: 'The card has expired.',\n    nextSteps: 'The customer should use another card.',\n    nextUserAction: 'Please use another card.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードは期限切れです。',\n        nextUserAction: '別のカードを使用してください。',\n      },\n    },\n  },\n  fraudulent: {\n    description: 'The payment has been declined as Stripe suspects it is fraudulent.',\n    nextSteps:\n      'Do not report more detailed information to your customer. Instead, present as you would the generic_decline described below.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: '不正と思われるため、支払いは拒否されました。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  generic_decline: {\n    description: 'The card has been declined for an unknown reason.',\n    nextSteps: 'The customer needs to contact their card issuer for more information.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'SOFT_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードは未知の理由で拒否されました。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  incorrect_number: {\n    description: 'The card number is incorrect.',\n    nextSteps: 'The customer should try again using the correct card number.',\n    nextUserAction:\n      'Please check your card numbers and try again. If it still cannot be processed, the please contact your card issuer.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'カード番号が正しくありません。',\n        nextUserAction:\n          'カード番号を確認してもう一度やり直してください。それでも処理できない場合は、カード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  incorrect_cvc: {\n    description: 'The CVC number is incorrect.',\n    nextSteps: 'The customer should try again using the correct CVC.',\n    nextUserAction:\n      'Please check your card numbers and try again. If it still cannot be processed, the please contact your card issuer.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'CVC番号が正しくありません。',\n        nextUserAction:\n          'CSC番号を確認してもう一度やり直してください。それでも処理できない場合は、カード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  incorrect_pin: {\n    description:\n      'The PIN entered is incorrect. This decline code only applies to payments made with a card reader.',\n    nextSteps: 'The customer should try again using the correct PIN.',\n    nextUserAction:\n      'Please check your PIN and try again. If it still cannot be processed, the please contact your card issuer.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'PINコードが正しくありません。',\n        nextUserAction:\n          'PINコードを確認してもう一度やり直してください。それでも処理できない場合は、カード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  incorrect_zip: {\n    description: 'The ZIP/postal code is incorrect.',\n    nextSteps: 'The customer should try again using the correct billing ZIP/postal code.',\n    nextUserAction: 'Please try again using the correct ZIP/postal code.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: '郵便番号が正しくありません。',\n        nextUserAction: '正しい郵便番号を使用してもう一度お試しください。',\n      },\n    },\n  },\n  insufficient_funds: {\n    description: 'The card has insufficient funds to complete the purchase.',\n    nextSteps: 'The customer should use an alternative payment method.',\n    nextUserAction: 'Please try again using an alternative payment method.',\n    category: 'SOFT_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードの購入に必要な資金が不足しています。',\n        nextUserAction: '別のお支払い方法を使用してもう一度お試しください。',\n      },\n    },\n  },\n  invalid_account: {\n    description: 'The card, or account the card is connected to, is invalid.',\n    nextSteps:\n      'The customer needs to contact their card issuer to check that the card is working correctly.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'カード、またはカードが接続されているアカウントが無効です。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  invalid_amount: {\n    description: 'The payment amount is invalid, or exceeds the amount that is allowed.',\n    nextSteps:\n      'If the amount appears to be correct, the customer needs to check with their card issuer that they can make purchases of that amount.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'SOFT_DECLINE',\n    translations: {\n      ja: {\n        description: '支払い金額が無効であるか、許可されている金額を超えています。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  invalid_cvc: {\n    description: 'The CVC number is incorrect.',\n    nextSteps: 'The customer should try again using the correct CVC.',\n    nextUserAction: 'Please try again using the correct CVC.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'CVC番号が正しくありません。',\n        nextUserAction: '正しいCVCを使用してもう一度やり直してください。',\n      },\n    },\n  },\n  invalid_expiry_year: {\n    description: 'The expiration year invalid.',\n    nextSteps: 'The customer should try again using the correct expiration date.',\n    nextUserAction: 'Please try again using the correct expiration date.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: '有効期限が無効です。',\n        nextUserAction: '正しい有効期限を入力してもう一度お試しください。',\n      },\n    },\n  },\n  invalid_number: {\n    description: 'The card number is incorrect.',\n    nextSteps: 'The customer should try again using the correct card number.',\n    nextUserAction: 'Please try again using the correct card number.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'カード番号が正しくありません。',\n        nextUserAction: '正しいカード番号を使用してもう一度やり直してください。',\n      },\n    },\n  },\n  invalid_pin: {\n    description:\n      'The PIN entered is incorrect. This decline code only applies to payments made with a card reader.',\n    nextSteps: 'The customer should try again using the correct PIN.',\n    nextUserAction: 'Please try again using the correct card PIN.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'PINコードが正しくありません。',\n        nextUserAction: '正しいPINコードを使用してもう一度やり直してください。',\n      },\n    },\n  },\n  issuer_not_available: {\n    description: 'The card issuer could not be reached, so the payment could not be authorized.',\n    nextSteps:\n      'The payment should be attempted again. If it still cannot be processed, the customer needs to contact their card issuer.',\n    nextUserAction:\n      'Please try again. If it still cannot be processed, the please contact your card issuer.',\n    category: 'SOFT_DECLINE',\n    translations: {\n      ja: {\n        description: 'カード発行者に連絡できなかったため、支払いを承認できませんでした。',\n        nextUserAction:\n          'もう一度やり直してください。それでも処理できない場合は、カード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  lost_card: {\n    description: 'The payment has been declined because the card is reported lost.',\n    nextSteps:\n      'The specific reason for the decline should not be reported to the customer. Instead, it needs to be presented as a generic decline.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードは未知の理由で拒否されました。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  merchant_blacklist: {\n    description:\n      \"The payment has been declined because it matches a value on the Stripe user's blocklist.\",\n    nextSteps:\n      'Do not report more detailed information to your customer. Instead, present as you would the generic_decline described above.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードは未知の理由で拒否されました。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  new_account_information_available: {\n    description: 'The card, or account the card is connected to, is invalid.',\n    nextSteps: 'The customer needs to contact their card issuer for more information.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'SOFT_DECLINE',\n    translations: {\n      ja: {\n        description: 'カード、またはカードが接続されているアカウントが無効です。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  no_action_taken: {\n    description: 'The card has been declined for an unknown reason.',\n    nextSteps: 'The customer should contact their card issuer for more information.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'SOFT_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードは未知の理由で拒否されました。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  not_permitted: {\n    description: 'The payment is not permitted.',\n    nextSteps: 'The customer needs to contact their card issuer for more information.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: '支払いは許可されていません。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  pickup_card: {\n    description:\n      'The card cannot be used to make this payment (it is possible it has been reported lost or stolen).',\n    nextSteps: 'The customer needs to contact their card issuer for more information.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description:\n          'カードでこの支払いを行うことはできません（紛失または盗難にあったと報告されている可能性があります）。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  pin_try_exceeded: {\n    description: 'The allowable number of PIN tries has been exceeded.',\n    nextSteps: 'The customer must use another card or method of payment.',\n    nextUserAction: 'Please use another card or method of payment.',\n    category: 'SOFT_DECLINE',\n    translations: {\n      ja: {\n        description: 'PIN試行回数の上限を超えました。',\n        nextUserAction: '別のカードまたはお支払い方法をご利用ください。',\n      },\n    },\n  },\n  processing_error: {\n    description: 'An error occurred while processing the card.',\n    nextSteps:\n      'The payment should be attempted again. If it still cannot be processed, try again later.',\n    nextUserAction:\n      'Please try again. If it still cannot be processed, the please contact your card issuer.',\n    category: 'SOFT_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードの処理中にエラーが発生しました。',\n        nextUserAction:\n          'もう一度やり直してください。それでも処理できない場合は、カード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  reenter_transaction: {\n    description: 'The payment could not be processed by the issuer for an unknown reason.',\n    nextSteps:\n      'The payment should be attempted again. If it still cannot be processed, the customer needs to contact their card issuer.',\n    nextUserAction:\n      'Please try again. If it still cannot be processed, the please contact your card issuer.',\n    category: 'SOFT_DECLINE',\n    translations: {\n      ja: {\n        description: '原因不明のため、発行者が支払いを処理できませんでした。',\n        nextUserAction:\n          'もう一度やり直してください。それでも処理できない場合は、カード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  restricted_card: {\n    description:\n      'The card cannot be used to make this payment (it is possible it has been reported lost or stolen).',\n    nextSteps: 'The customer needs to contact their card issuer for more information.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description:\n          'カードでこの支払いを行うことはできません（紛失または盗難にあったと報告されている可能性があります）。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  revocation_of_all_authorizations: {\n    description: 'The card has been declined for an unknown reason.',\n    nextSteps: 'The customer should contact their card issuer for more information.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードは未知の理由で拒否されました。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  revocation_of_authorization: {\n    description: 'The card has been declined for an unknown reason.',\n    nextSteps: 'The customer should contact their card issuer for more information.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードは未知の理由で拒否されました。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  security_violation: {\n    description: 'The card has been declined for an unknown reason.',\n    nextSteps: 'The customer needs to contact their card issuer for more information.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードは未知の理由で拒否されました。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  service_not_allowed: {\n    description: 'The card has been declined for an unknown reason.',\n    nextSteps: 'The customer should contact their card issuer for more information.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードは未知の理由で拒否されました。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  stolen_card: {\n    description: 'The payment has been declined because the card is reported stolen.',\n    nextSteps:\n      'The specific reason for the decline should not be reported to the customer. Instead, it needs to be presented as a generic decline.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードは未知の理由で拒否されました。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  stop_payment_order: {\n    description: 'The card has been declined for an unknown reason.',\n    nextSteps: 'The customer should contact their card issuer for more information.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードは未知の理由で拒否されました。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  testmode_decline: {\n    description: 'A Stripe test card number was used.',\n    nextSteps: 'A genuine card must be used to make a payment.',\n    nextUserAction: 'A genuine card must be used to make a payment.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'Stripeテストカード番号を使用しました。',\n        nextUserAction: '支払いには本物のカードを使用する必要があります。',\n      },\n    },\n  },\n  transaction_not_allowed: {\n    description: 'The card has been declined for an unknown reason.',\n    nextSteps: 'The customer needs to contact their card issuer for more information.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードは未知の理由で拒否されました。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  try_again_later: {\n    description: 'The card has been declined for an unknown reason.',\n    nextSteps:\n      'Ask the customer to attempt the payment again. If subsequent payments are declined, the customer should contact their card issuer for more information.',\n    nextUserAction:\n      'Please try again. If it still cannot be processed, the please contact your card issuer.',\n    category: 'SOFT_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードは未知の理由で拒否されました。',\n        nextUserAction:\n          'もう一度やり直してください。それでも処理できない場合は、カード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  withdrawal_count_limit_exceeded: {\n    description: 'The customer has exceeded the balance or credit limit available on their card.',\n    nextSteps: 'The customer should use an alternative payment method.',\n    nextUserAction: 'Please use another card or contact your card issuer for more information.',\n    category: 'SOFT_DECLINE',\n    translations: {\n      ja: {\n        description: 'このカードの残高またはクレジット制限を超えました。',\n        nextUserAction: '別のカードを使用するか、カード発行会社にお問い合わせください。',\n      },\n    },\n  },\n};\n","import { DECLINE_CODES, DOC_VERSION } from './data/decline-codes.js';\nimport type {\n  DeclineCategory,\n  DeclineCode,\n  DeclineCodeResult,\n  Locale,\n  StripeDeclineError,\n  StripeError,\n} from './types.js';\n\n/**\n * Get decline code information with description and recommended actions\n *\n * @param declineCode - The Stripe decline code to look up\n * @returns Object containing the decline code information and documentation version\n *\n * @example\n * ```ts\n * const result = getDeclineDescription('insufficient_funds');\n * console.log(result.code.description);\n * // => \"The card has insufficient funds to complete the purchase.\"\n * console.log(result.code.nextUserAction);\n * // => \"Please try again using an alternative payment method.\"\n * ```\n */\nexport function getDeclineDescription(declineCode?: string): DeclineCodeResult {\n  if (!declineCode || !isValidDeclineCode(declineCode)) {\n    return {\n      docVersion: DOC_VERSION,\n      code: {},\n    };\n  }\n\n  const code = DECLINE_CODES[declineCode];\n  return {\n    docVersion: DOC_VERSION,\n    code,\n  };\n}\n\n/**\n * Get localized decline code message for end users\n *\n * @param declineCode - The Stripe decline code\n * @param locale - The locale to use (default: 'en')\n * @returns User-facing message in the specified locale, or undefined if not found\n *\n * @example\n * ```ts\n * const message = getDeclineMessage('insufficient_funds', 'ja');\n * console.log(message);\n * // => \"別のお支払い方法を使用してもう一度お試しください。\"\n * ```\n */\nexport function getDeclineMessage(declineCode: string, locale: Locale = 'en'): string | undefined {\n  if (!isValidDeclineCode(declineCode)) {\n    return undefined;\n  }\n\n  const codeInfo = DECLINE_CODES[declineCode];\n\n  if (locale === 'en') {\n    return codeInfo.nextUserAction;\n  }\n\n  return codeInfo.translations?.[locale]?.nextUserAction;\n}\n\n/**\n * Get all available decline codes\n *\n * @returns Array of all supported decline code strings\n *\n * @example\n * ```ts\n * const codes = getAllDeclineCodes();\n * console.log(codes.length); // => 44\n * console.log(codes.includes('insufficient_funds')); // => true\n * ```\n */\nexport function getAllDeclineCodes(): DeclineCode[] {\n  return Object.keys(DECLINE_CODES) as DeclineCode[];\n}\n\n/**\n * Check if a decline code is valid\n *\n * @param code - The code to validate\n * @returns True if the code exists in the database\n *\n * @example\n * ```ts\n * isValidDeclineCode('insufficient_funds'); // => true\n * isValidDeclineCode('invalid_code'); // => false\n * ```\n */\nexport function isValidDeclineCode(code: string): code is DeclineCode {\n  return Object.hasOwn(DECLINE_CODES, code);\n}\n\n/**\n * Get the documentation version for the decline codes data\n *\n * @returns The Stripe API documentation version string\n *\n * @example\n * ```ts\n * const version = getDocVersion();\n * console.log(version); // => \"2024-12-18\"\n * ```\n */\nexport function getDocVersion(): string {\n  return DOC_VERSION;\n}\n\n/**\n * Format a decline message with custom template variables\n *\n * @param declineCode - The Stripe decline code\n * @param locale - The locale to use (default: 'en')\n * @param variables - Optional variables to replace in the message template\n * @returns Formatted user-facing message with variables replaced\n *\n * @example\n * ```ts\n * const message = formatDeclineMessage('insufficient_funds', 'en', {\n *   merchantName: 'Acme Store',\n *   supportEmail: 'support@acme.com'\n * });\n * console.log(message);\n * // => \"Please try again using an alternative payment method.\"\n * ```\n */\nexport function formatDeclineMessage(\n  declineCode: string,\n  locale: Locale = 'en',\n  variables?: Record<string, string>,\n): string | undefined {\n  const baseMessage = getDeclineMessage(declineCode, locale);\n\n  if (!baseMessage) {\n    return undefined;\n  }\n\n  if (!variables || Object.keys(variables).length === 0) {\n    return baseMessage;\n  }\n\n  // Replace variables in the format {{variableName}}\n  let formattedMessage = baseMessage;\n  for (const [key, value] of Object.entries(variables)) {\n    // Escape special regex characters in the key\n    const escapedKey = key.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n    const placeholder = new RegExp(`\\\\{\\\\{${escapedKey}\\\\}\\\\}`, 'g');\n    formattedMessage = formattedMessage.replace(placeholder, value);\n  }\n\n  return formattedMessage;\n}\n\n/**\n * Get the category of a decline code (SOFT_DECLINE or HARD_DECLINE)\n *\n * @param code - The decline code to categorize\n * @returns The category of the decline code, or undefined if invalid\n *\n * @example\n * ```ts\n * getDeclineCategory('insufficient_funds'); // => 'SOFT_DECLINE'\n * getDeclineCategory('fraudulent'); // => 'HARD_DECLINE'\n * ```\n */\nexport function getDeclineCategory(code: string): DeclineCategory | undefined {\n  if (!isValidDeclineCode(code)) {\n    return undefined;\n  }\n\n  return DECLINE_CODES[code].category;\n}\n\n/**\n * Check if a decline code is a hard decline (permanent, should not retry)\n *\n * @param code - The decline code to check\n * @returns True if the code is a hard decline\n *\n * @example\n * ```ts\n * isHardDecline('fraudulent'); // => true\n * isHardDecline('insufficient_funds'); // => false\n * ```\n */\nexport function isHardDecline(code: string): boolean {\n  return getDeclineCategory(code) === 'HARD_DECLINE';\n}\n\n/**\n * Check if a decline code is a soft decline (temporary, can retry)\n *\n * @param code - The decline code to check\n * @returns True if the code is a soft decline\n *\n * @example\n * ```ts\n * isSoftDecline('insufficient_funds'); // => true\n * isSoftDecline('fraudulent'); // => false\n * ```\n */\nexport function isSoftDecline(code: string): boolean {\n  return getDeclineCategory(code) === 'SOFT_DECLINE';\n}\n\n/**\n * Extract localized message from a Stripe error object\n *\n * @param error - The Stripe error object (or any caught value)\n * @param locale - The locale to use (default: 'en')\n * @returns User-facing message in the specified locale, or undefined if not found\n *\n * @example\n * ```ts\n * const stripeError = {\n *   type: 'StripeCardError',\n *   decline_code: 'insufficient_funds',\n *   message: 'Your card has insufficient funds.'\n * };\n * const message = getMessageFromStripeError(stripeError, 'ja');\n * console.log(message);\n * // => \"別のお支払い方法を使用してもう一度お試しください。\"\n * ```\n */\nexport function getMessageFromStripeError(\n  error: unknown,\n  locale: Locale = 'en',\n): string | undefined {\n  if (!isStripeDeclineError(error)) {\n    return undefined;\n  }\n\n  return getDeclineMessage(error.decline_code, locale);\n}\n\n/**\n * Type guard that narrows an unknown error to one carrying a known Stripe decline code\n *\n * Returns true when `error` is an object whose `decline_code` is a valid\n * {@link DeclineCode}. Designed for `catch` blocks: a `StripeCardError` from\n * stripe-node >= 18 (where `decline_code` is a required `string`) narrows\n * straight to {@link StripeDeclineError}; errors from stripe-node <= 17 or\n * plain objects fall back through the same runtime check.\n *\n * @param error - The value to check (e.g. a caught Stripe error)\n * @returns True if the error carries a known decline code\n *\n * @example\n * ```ts\n * try {\n *   await stripe.charges.create({ ... });\n * } catch (err) {\n *   if (isStripeDeclineError(err)) {\n *     // err.decline_code is typed as DeclineCode here\n *     console.log(getDeclineMessage(err.decline_code, 'ja'));\n *   }\n * }\n * ```\n */\nexport function isStripeDeclineError(error: unknown): error is StripeDeclineError {\n  return (\n    typeof error === 'object' &&\n    error !== null &&\n    'decline_code' in error &&\n    typeof (error as StripeError).decline_code === 'string' &&\n    isValidDeclineCode((error as StripeDeclineError).decline_code)\n  );\n}\n\n/**\n * Extract a validated decline code from a Stripe error object\n *\n * Unlike `getMessageFromStripeError`, this returns the decline code itself\n * (typed as {@link DeclineCode}) so it can be passed to any other helper in\n * this library. Accepts `unknown` so caught errors can be passed directly.\n *\n * @param error - The Stripe error object (or any caught value)\n * @returns The decline code, or undefined if absent or unknown\n *\n * @example\n * ```ts\n * try {\n *   await stripe.charges.create({ ... });\n * } catch (err) {\n *   const code = getDeclineCodeFromError(err);\n *   if (code && isSoftDecline(code)) {\n *     // safe to retry\n *   }\n * }\n * ```\n */\nexport function getDeclineCodeFromError(error: unknown): DeclineCode | undefined {\n  return isStripeDeclineError(error) ? error.decline_code : undefined;\n}\n\n// Export data for advanced use cases\nexport { DECLINE_CODES, DOC_VERSION } from './data/decline-codes.js';\n// Export types\nexport type {\n  DeclineCategory,\n  DeclineCode,\n  DeclineCodeInfo,\n  DeclineCodeResult,\n  Locale,\n  StripeDeclineError,\n  StripeError,\n  Translation,\n} from './types.js';\n"],"names":["DOC_VERSION","DECLINE_CODES","getDeclineDescription","declineCode","isValidDeclineCode","code","getDeclineMessage","locale","codeInfo","getAllDeclineCodes","getDocVersion","formatDeclineMessage","variables","baseMessage","formattedMessage","key","value","escapedKey","placeholder","getDeclineCategory","isHardDecline","isSoftDecline","getMessageFromStripeError","error","isStripeDeclineError","getDeclineCodeFromError"],"mappings":"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"}