stripe-decline-codes 0.2.0 → 0.3.0

package/README.md

@@ -9,7 +9,7 @@ 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
@@ -89,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', ...]
 ```
@@ -176,6 +176,34 @@ try {
 }
 ```
 
+### 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
@@ -263,19 +291,31 @@ Checks if a decline code is a soft decline (temporary, can retry).
 
 ### Stripe Error Integration
 
-#### `getMessageFromStripeError(error: StripeError, locale?: Locale): string | undefined`
+#### `getMessageFromStripeError(error: unknown, locale?: Locale): string | undefined`
 
-Extracts a localized user-facing message directly from a Stripe error object.
+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
+- `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
@@ -321,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:
@@ -334,6 +397,7 @@ import type {
   Translation,
   DeclineCategory,
   StripeError,
+  StripeDeclineError,
 } from 'stripe-decline-codes';
 ```
 

package/dist/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o="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 m(e){if(!e||!s(e))return{docVersion:o,code:{}};const t=r[e];return{docVersion:o,code:t}}function c(e,t="en"){if(!s(e))return;const n=r[e];return t==="en"?n.nextUserAction:n.translations?.[t]?.nextUserAction}function y(){return Object.keys(r)}function s(e){return Object.hasOwn(r,e)}function f(){return o}function x(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[u,l]of Object.entries(n)){const p=u.replace(/[.*+?^${}()|[\]\\]/g,"\\$&"),h=new RegExp(`\\{\\{${p}\\}\\}`,"g");a=a.replace(h,l)}return a}function d(e){if(s(e))return r[e].category}function g(e){return d(e)==="HARD_DECLINE"}function A(e){return d(e)==="SOFT_DECLINE"}function _(e,t="en"){if(e.decline_code)return c(e.decline_code,t)}exports.DECLINE_CODES=r;exports.DOC_VERSION=o;exports.formatDeclineMessage=x;exports.getAllDeclineCodes=y;exports.getDeclineCategory=d;exports.getDeclineDescription=m;exports.getDeclineMessage=c;exports.getDocVersion=f;exports.getMessageFromStripeError=_;exports.isHardDecline=g;exports.isSoftDecline=A;exports.isValidDeclineCode=s;
+"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

@@ -1 +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  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\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: StripeError,\n  locale: Locale = 'en',\n): string | undefined {\n  if (!error.decline_code) {\n    return undefined;\n  }\n\n  return getDeclineMessage(error.decline_code, locale);\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  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"],"mappings":"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"}
+{"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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"}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import type { DeclineCategory, DeclineCode, DeclineCodeResult, Locale, StripeError } from './types.js';
+import type { DeclineCategory, DeclineCode, DeclineCodeResult, Locale, StripeDeclineError } from './types.js';
 /**
  * Get decline code information with description and recommended actions
  *
@@ -129,7 +129,7 @@ export declare function isSoftDecline(code: string): boolean;
 /**
  * Extract localized message from a Stripe error object
  *
- * @param error - The Stripe error object
+ * @param error - The Stripe error object (or any caught value)
  * @param locale - The locale to use (default: 'en')
  * @returns User-facing message in the specified locale, or undefined if not found
  *
@@ -145,7 +145,55 @@ export declare function isSoftDecline(code: string): boolean;
  * // => "別のお支払い方法を使用してもう一度お試しください。"
  * ```
  */
-export declare function getMessageFromStripeError(error: StripeError, locale?: Locale): string | undefined;
+export declare function getMessageFromStripeError(error: unknown, locale?: Locale): string | undefined;
+/**
+ * Type guard that narrows an unknown error to one carrying a known Stripe decline code
+ *
+ * Returns true when `error` is an object whose `decline_code` is a valid
+ * {@link DeclineCode}. Designed for `catch` blocks: a `StripeCardError` from
+ * stripe-node >= 18 (where `decline_code` is a required `string`) narrows
+ * straight to {@link StripeDeclineError}; errors from stripe-node <= 17 or
+ * plain objects fall back through the same runtime check.
+ *
+ * @param error - The value to check (e.g. a caught Stripe error)
+ * @returns True if the error carries a known decline code
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await stripe.charges.create({ ... });
+ * } catch (err) {
+ *   if (isStripeDeclineError(err)) {
+ *     // err.decline_code is typed as DeclineCode here
+ *     console.log(getDeclineMessage(err.decline_code, 'ja'));
+ *   }
+ * }
+ * ```
+ */
+export declare function isStripeDeclineError(error: unknown): error is StripeDeclineError;
+/**
+ * Extract a validated decline code from a Stripe error object
+ *
+ * Unlike `getMessageFromStripeError`, this returns the decline code itself
+ * (typed as {@link DeclineCode}) so it can be passed to any other helper in
+ * this library. Accepts `unknown` so caught errors can be passed directly.
+ *
+ * @param error - The Stripe error object (or any caught value)
+ * @returns The decline code, or undefined if absent or unknown
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await stripe.charges.create({ ... });
+ * } catch (err) {
+ *   const code = getDeclineCodeFromError(err);
+ *   if (code && isSoftDecline(code)) {
+ *     // safe to retry
+ *   }
+ * }
+ * ```
+ */
+export declare function getDeclineCodeFromError(error: unknown): DeclineCode | undefined;
 export { DECLINE_CODES, DOC_VERSION } from './data/decline-codes.js';
-export type { DeclineCategory, DeclineCode, DeclineCodeInfo, DeclineCodeResult, Locale, StripeError, Translation, } from './types.js';
+export type { DeclineCategory, DeclineCode, DeclineCodeInfo, DeclineCodeResult, Locale, StripeDeclineError, StripeError, Translation, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,MAAM,EACN,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAa7E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,GAAE,MAAa,GAAG,MAAM,GAAG,SAAS,CAYhG;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,IAAI,WAAW,EAAE,CAElD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,WAAW,CAEpE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,MAAa,EACrB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,MAAM,GAAG,SAAS,CAqBpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAM5E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,WAAW,EAClB,MAAM,GAAE,MAAa,GACpB,MAAM,GAAG,SAAS,CAMpB;AAGD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAErE,YAAY,EACV,eAAe,EACf,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,MAAM,EACN,WAAW,EACX,WAAW,GACZ,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,MAAM,EACN,kBAAkB,EAEnB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAa7E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,GAAE,MAAa,GAAG,MAAM,GAAG,SAAS,CAYhG;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,IAAI,WAAW,EAAE,CAElD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,WAAW,CAEpE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,MAAa,EACrB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,MAAM,GAAG,SAAS,CAqBpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAM5E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,EACd,MAAM,GAAE,MAAa,GACpB,MAAM,GAAG,SAAS,CAMpB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAQhF;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CAE/E;AAGD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAErE,YAAY,EACV,eAAe,EACf,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,MAAM,EACN,kBAAkB,EAClB,WAAW,EACX,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/index.mjs

@@ -1,4 +1,4 @@
-const i = "2024-12-18", r = {
+const a = "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.",
@@ -516,72 +516,80 @@ const i = "2024-12-18", r = {
     }
   }
 };
-function m(e) {
-  if (!e || !a(e))
+function y(e) {
+  if (!e || !o(e))
     return {
-      docVersion: i,
+      docVersion: a,
       code: {}
     };
   const t = r[e];
   return {
-    docVersion: i,
+    docVersion: a,
     code: t
   };
 }
 function c(e, t = "en") {
-  if (!a(e))
+  if (!o(e))
     return;
   const n = r[e];
   return t === "en" ? n.nextUserAction : n.translations?.[t]?.nextUserAction;
 }
-function y() {
+function f() {
   return Object.keys(r);
 }
-function a(e) {
+function o(e) {
   return Object.hasOwn(r, e);
 }
-function f() {
-  return i;
+function x() {
+  return a;
 }
-function x(e, t = "en", n) {
-  const o = c(e, t);
-  if (!o)
+function A(e, t = "en", n) {
+  const s = c(e, t);
+  if (!s)
     return;
   if (!n || Object.keys(n).length === 0)
-    return o;
-  let s = o;
-  for (const [u, l] of Object.entries(n)) {
-    const p = u.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), h = new RegExp(`\\{\\{${p}\\}\\}`, "g");
-    s = s.replace(h, l);
+    return s;
+  let i = s;
+  for (const [l, p] of Object.entries(n)) {
+    const h = l.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), m = new RegExp(`\\{\\{${h}\\}\\}`, "g");
+    i = i.replace(m, p);
   }
-  return s;
+  return i;
 }
 function d(e) {
-  if (a(e))
+  if (o(e))
     return r[e].category;
 }
-function A(e) {
+function _(e) {
   return d(e) === "HARD_DECLINE";
 }
 function g(e) {
   return d(e) === "SOFT_DECLINE";
 }
-function _(e, t = "en") {
-  if (e.decline_code)
+function E(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 T(e) {
+  return u(e) ? e.decline_code : void 0;
+}
 export {
   r as DECLINE_CODES,
-  i as DOC_VERSION,
-  x as formatDeclineMessage,
-  y as getAllDeclineCodes,
+  a as DOC_VERSION,
+  A as formatDeclineMessage,
+  f as getAllDeclineCodes,
   d as getDeclineCategory,
-  m as getDeclineDescription,
+  T as getDeclineCodeFromError,
+  y as getDeclineDescription,
   c as getDeclineMessage,
-  f as getDocVersion,
-  _ as getMessageFromStripeError,
-  A as isHardDecline,
+  x as getDocVersion,
+  E as getMessageFromStripeError,
+  _ as isHardDecline,
   g as isSoftDecline,
-  a as isValidDeclineCode
+  u as isStripeDeclineError,
+  o as isValidDeclineCode
 };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","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  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\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: StripeError,\n  locale: Locale = 'en',\n): string | undefined {\n  if (!error.decline_code) {\n    return undefined;\n  }\n\n  return getDeclineMessage(error.decline_code, locale);\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  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"],"mappings":"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"}
+{"version":3,"file":"index.mjs","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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"}

package/dist/types.d.ts

@@ -46,6 +46,17 @@ export interface StripeError {
     message?: string;
     [key: string]: unknown;
 }
+/**
+ * A Stripe error known to carry a valid decline code.
+ *
+ * Matches the stripe-node >= 18 `StripeCardError` shape, where `decline_code`
+ * is a required string, narrowed further to the {@link DeclineCode} union.
+ * Errors from stripe-node <= 17 (where `decline_code` is optional) or plain
+ * objects can be narrowed to this type with `isStripeDeclineError`.
+ */
+export interface StripeDeclineError extends StripeError {
+    decline_code: DeclineCode;
+}
 /**
  * All supported Stripe decline codes
  */

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;AAEjC;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG,cAAc,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,cAAc,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,QAAQ,EAAE,eAAe,CAAC;IAC1B,yCAAyC;IACzC,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,IAAI,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,iBAAiB,GACjB,aAAa,GACb,oBAAoB,GACpB,wBAAwB,GACxB,wBAAwB,GACxB,cAAc,GACd,kBAAkB,GAClB,uBAAuB,GACvB,cAAc,GACd,YAAY,GACZ,iBAAiB,GACjB,kBAAkB,GAClB,eAAe,GACf,eAAe,GACf,eAAe,GACf,oBAAoB,GACpB,iBAAiB,GACjB,gBAAgB,GAChB,aAAa,GACb,qBAAqB,GACrB,gBAAgB,GAChB,aAAa,GACb,sBAAsB,GACtB,WAAW,GACX,oBAAoB,GACpB,mCAAmC,GACnC,iBAAiB,GACjB,eAAe,GACf,aAAa,GACb,kBAAkB,GAClB,kBAAkB,GAClB,qBAAqB,GACrB,iBAAiB,GACjB,kCAAkC,GAClC,6BAA6B,GAC7B,oBAAoB,GACpB,qBAAqB,GACrB,aAAa,GACb,oBAAoB,GACpB,kBAAkB,GAClB,yBAAyB,GACzB,iBAAiB,GACjB,iCAAiC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;AAEjC;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG,cAAc,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,cAAc,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,QAAQ,EAAE,eAAe,CAAC;IAC1B,yCAAyC;IACzC,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,IAAI,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACrD,YAAY,EAAE,WAAW,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,iBAAiB,GACjB,aAAa,GACb,oBAAoB,GACpB,wBAAwB,GACxB,wBAAwB,GACxB,cAAc,GACd,kBAAkB,GAClB,uBAAuB,GACvB,cAAc,GACd,YAAY,GACZ,iBAAiB,GACjB,kBAAkB,GAClB,eAAe,GACf,eAAe,GACf,eAAe,GACf,oBAAoB,GACpB,iBAAiB,GACjB,gBAAgB,GAChB,aAAa,GACb,qBAAqB,GACrB,gBAAgB,GAChB,aAAa,GACb,sBAAsB,GACtB,WAAW,GACX,oBAAoB,GACpB,mCAAmC,GACnC,iBAAiB,GACjB,eAAe,GACf,aAAa,GACb,kBAAkB,GAClB,kBAAkB,GAClB,qBAAqB,GACrB,iBAAiB,GACjB,kCAAkC,GAClC,6BAA6B,GAC7B,oBAAoB,GACpB,qBAAqB,GACrB,aAAa,GACb,oBAAoB,GACpB,kBAAkB,GAClB,yBAAyB,GACzB,iBAAiB,GACjB,iCAAiC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stripe-decline-codes",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Complete database of Stripe decline codes with descriptions and localized messages",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -28,15 +28,17 @@
     "build": "vite build && tsc -p tsconfig.build.json",
     "test": "vitest run",
     "test:watch": "vitest",
+    "test:workers": "vitest run --config vitest.workers.config.ts",
     "test:coverage": "vitest run --coverage",
     "lint": "biome check .",
     "lint:fix": "biome check --write .",
     "format": "biome format --write .",
-    "typecheck": "tsc --noEmit",
+    "typecheck": "tsc --noEmit && tsc -p tests/workers/tsconfig.json",
     "prepublishOnly": "npm run lint && npm run typecheck && npm run test && npm run build",
     "docs:generate": "tsx scripts/generate-docs.ts",
     "docs:api": "typedoc",
-    "docs": "npm run docs:generate && npm run docs:api"
+    "docs": "npm run docs:generate && npm run docs:api",
+    "prepare": "husky"
   },
   "repository": {
     "type": "git",
@@ -62,13 +64,19 @@
   },
   "devDependencies": {
     "@biomejs/biome": "^2.3.6",
+    "@cloudflare/vitest-plugin": "^1.3.6",
+    "@commitlint/cli": "^21.2.3",
+    "@commitlint/config-conventional": "^21.2.3",
     "@types/node": "^24.10.1",
+    "@vitest/runner": "^4.1.11",
+    "@vitest/snapshot": "^4.1.11",
     "fast-check": "^4.5.2",
+    "husky": "^9.1.7",
     "tsx": "^4.19.0",
     "typedoc": "^0.28.20",
     "typescript": "^5.9.3",
     "vite": "^7.2.2",
-    "vitest": "^4.0.10"
+    "vitest": "^4.1.0"
   },
   "packageManager": "pnpm@10.34.5",
   "publishConfig": {