stripe-decline-codes 0.1.0 → 0.2.0

package/LICENSE

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

package/README.md

@@ -16,6 +16,8 @@ A lightweight, zero-dependency TypeScript library providing human-readable descr
 - 🔄 **Up-to-date** - Based on Stripe API documentation (2024-12-18)
 - ✅ **Well Tested** - Comprehensive test coverage
 - 🎨 **Message Formatting** - Customizable message templates with variable substitution
+- 🔍 **Decline Categorization** - Soft/Hard decline classification based on Stripe guidelines
+- ⚡ **Stripe SDK Integration** - Direct error object support for seamless integration
 
 ## About This Project
 
@@ -108,16 +110,72 @@ try {
     currency: 'usd',
     source: 'tok_chargeDeclined',
   });
-} catch (error) {
-  if (error.type === 'StripeCardError') {
-    const declineCode = error.decline_code;
-    const userMessage = getDeclineMessage(declineCode, 'en');
+} catch (err) {
+  const error = err as Stripe.StripeCardError;
+  if (error.type === 'card_error' && error.decline_code) {
+    const userMessage = getDeclineMessage(error.decline_code, 'en');
     console.log(userMessage);
     // Display this message to your user
   }
 }
 ```
 
+### Decline Code Categorization
+
+Understand whether a decline is temporary (soft) or permanent (hard):
+
+```typescript
+import { getDeclineCategory, isSoftDecline, isHardDecline } from 'stripe-decline-codes';
+
+// Get the category
+const category = getDeclineCategory('insufficient_funds');
+console.log(category); // => 'SOFT_DECLINE'
+
+// Check if it's a soft decline (temporary, can retry)
+if (isSoftDecline('insufficient_funds')) {
+  console.log('This is a temporary issue, you can retry the payment');
+}
+
+// Check if it's a hard decline (permanent, should not retry)
+if (isHardDecline('fraudulent')) {
+  console.log('This is a permanent decline, do not retry');
+}
+```
+
+### Extract Message from Stripe Error
+
+Directly extract user-facing messages from Stripe error objects:
+
+```typescript
+import Stripe from 'stripe';
+import { getMessageFromStripeError, isHardDecline } from 'stripe-decline-codes';
+
+const stripe = new Stripe(process.env.STRIPE_SECRET_KEY);
+
+try {
+  const charge = await stripe.charges.create({
+    amount: 2000,
+    currency: 'usd',
+    source: 'tok_chargeDeclined',
+  });
+} catch (err) {
+  const error = err as Stripe.StripeCardError;
+  if (error.type === 'card_error' && error.decline_code) {
+    // Get localized message directly from error object
+    const userMessage = getMessageFromStripeError(error, 'ja');
+
+    // Check if retry is recommended
+    if (isHardDecline(error.decline_code)) {
+      // Ask for a different payment method
+      console.log('Please use a different card');
+    } else {
+      // Retry is possible
+      console.log('You may retry this payment');
+    }
+  }
+}
+```
+
 ## API Reference
 
 ### Core Functions
@@ -180,6 +238,41 @@ const message = formatDeclineMessage('insufficient_funds', 'en', {
 });
 ```
 
+### Decline Categorization Functions
+
+#### `getDeclineCategory(code: string): DeclineCategory | undefined`
+
+Returns the category of a decline code ('SOFT_DECLINE' or 'HARD_DECLINE').
+
+**Parameters:**
+- `code` - The Stripe decline code
+
+**Returns:** `'SOFT_DECLINE' | 'HARD_DECLINE' | undefined`
+
+#### `isHardDecline(code: string): boolean`
+
+Checks if a decline code is a hard decline (permanent, should not retry).
+
+**Returns:** `true` if the code is a hard decline, `false` otherwise
+
+#### `isSoftDecline(code: string): boolean`
+
+Checks if a decline code is a soft decline (temporary, can retry).
+
+**Returns:** `true` if the code is a soft decline, `false` otherwise
+
+### Stripe Error Integration
+
+#### `getMessageFromStripeError(error: StripeError, locale?: Locale): string | undefined`
+
+Extracts a localized user-facing message directly from a Stripe error object.
+
+**Parameters:**
+- `error` - The Stripe error object
+- `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
+
 ## Supported Decline Codes
 
 This library includes all 44 Stripe decline codes:
@@ -239,41 +332,53 @@ import type {
   DeclineCodeResult,
   Locale,
   Translation,
+  DeclineCategory,
+  StripeError,
 } from 'stripe-decline-codes';
 ```
 
 ## Development
 
+This project uses [pnpm](https://pnpm.io/) (`packageManager` is pinned in `package.json`).
+
 ```bash
 # Install dependencies
-npm install
+pnpm install
 
 # Run tests
-npm test
+pnpm test
 
 # Run tests in watch mode
-npm run test:watch
+pnpm run test:watch
 
 # Build
-npm run build
+pnpm run build
 
 # Lint
-npm run lint
+pnpm run lint
 
 # Format code
-npm run format
+pnpm run format
 
 # Type check
-npm run typecheck
+pnpm run typecheck
 ```
 
-## Publishing
+The `docs/` directory is a separate npm project (Starlight site) and keeps using `npm`.
 
-This package uses [`np`](https://github.com/sindresorhus/np) for releases:
+## Publishing
 
-```bash
-npm run release
-```
+Releases are automated by CircleCI. Merge a PR whose commits follow
+[Conventional Commits](https://www.conventionalcommits.org/) (`feat:`, `fix:`, …)
+into `main`, and [semantic-release](https://github.com/semantic-release/semantic-release)
+pushes the git tag, publishes to npm via Trusted Publishing (OIDC), and creates the
+GitHub Release. Release notes are published on
+[GitHub Releases](https://github.com/hideokamoto/stripe-decline-codes/releases).
+Do not bump `version`, create tags, or run `npm publish` / `np` manually.
+
+The pipeline definition is shared via
+[`circleci-configurations`](https://github.com/hideokamoto/circleci-configurations)
+(`workflows/publish/npm-polyrepo-semantic-release.yaml`).
 
 ## Contributing
 

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

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

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

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

package/dist/index.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const 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;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../src/data/decline-codes.ts","../src/index.ts"],"sourcesContent":["import type { DeclineCode, DeclineCodeInfo } from '../types.js';\n\n/**\n * Stripe API documentation version for decline codes\n * Last updated: 2024-12\n * Reference: https://docs.stripe.com/declines/codes\n */\nexport const DOC_VERSION = '2024-12-18';\n\n/**\n * Complete database of Stripe decline codes with descriptions and recommended actions\n * Includes English and Japanese translations\n */\nexport const DECLINE_CODES: Record<DeclineCode, DeclineCodeInfo> = {\n  approve_with_id: {\n    description: 'The payment cannot be authorized.',\n    nextSteps:\n      'The payment should be attempted again. If it still cannot be processed, the customer needs to contact their card issuer.',\n    nextUserAction:\n      'Please try again. If it still cannot be processed, the please contact your card issuer.',\n    category: 'SOFT_DECLINE',\n    translations: {\n      ja: {\n        description: '支払いは承認できません。',\n        nextUserAction:\n          'もう一度やり直してください。それでも処理できない場合は、カード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  call_issuer: {\n    description: 'The card has been declined for an unknown reason.',\n    nextSteps: 'The customer needs to contact their card issuer for more information.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'SOFT_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードは未知の理由で拒否されました。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  card_not_supported: {\n    description: 'The card does not support this type of purchase.',\n    nextSteps:\n      'The customer needs to contact their card issuer to make sure their card can be used to make this type of purchase.',\n    nextUserAction:\n      'Your card issuer may not support this type of purchase, please contact your card issuer for more information.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードはこのタイプの購入をサポートしません。',\n        nextUserAction:\n          'カード発行者はこのタイプの購入をサポートしていない可能性があります。詳細については、カード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  card_velocity_exceeded: {\n    description: 'The customer has exceeded the balance or credit limit available on their card.',\n    nextSteps: 'The customer should contact their card issuer for more information.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'SOFT_DECLINE',\n    translations: {\n      ja: {\n        description: 'このカードの残高またはクレジット制限を超えました。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  currency_not_supported: {\n    description: 'The card does not support the specified currency.',\n    nextSteps:\n      'The customer needs to check with the issuer whether the card can be used for the type of currency specified.',\n    nextUserAction:\n      'Please contact your card issuer to verify this type of currency can be used for this payment.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードは指定された通貨をサポートしていません。',\n        nextUserAction:\n          'この支払いにこのタイプの通貨が使用できることを確認するには、カード発行会社に連絡してください。',\n      },\n    },\n  },\n  do_not_honor: {\n    description: 'The card has been declined for an unknown reason.',\n    nextSteps: 'The customer needs to contact their card issuer for more information.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'SOFT_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードは未知の理由で拒否されました。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  do_not_try_again: {\n    description: 'The card has been declined for an unknown reason.',\n    nextSteps: 'The customer should contact their card issuer for more information.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードは未知の理由で拒否されました。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  duplicate_transaction: {\n    description:\n      'A transaction with identical amount and credit card information was submitted very recently.',\n    nextSteps: 'Check to see if a recent payment already exists.',\n    nextUserAction: 'Check to see if a recent payment already exists.',\n    category: 'SOFT_DECLINE',\n    translations: {\n      ja: {\n        description: 'ごく最近、同一の金額とクレジットカード情報を使用した取引が送信されました。',\n        nextUserAction: '最近の支払いが既に存在するかどうかを確認してください。',\n      },\n    },\n  },\n  expired_card: {\n    description: 'The card has expired.',\n    nextSteps: 'The customer should use another card.',\n    nextUserAction: 'Please use another card.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードは期限切れです。',\n        nextUserAction: '別のカードを使用してください。',\n      },\n    },\n  },\n  fraudulent: {\n    description: 'The payment has been declined as Stripe suspects it is fraudulent.',\n    nextSteps:\n      'Do not report more detailed information to your customer. Instead, present as you would the generic_decline described below.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: '不正と思われるため、支払いは拒否されました。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  generic_decline: {\n    description: 'The card has been declined for an unknown reason.',\n    nextSteps: 'The customer needs to contact their card issuer for more information.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'SOFT_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードは未知の理由で拒否されました。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  incorrect_number: {\n    description: 'The card number is incorrect.',\n    nextSteps: 'The customer should try again using the correct card number.',\n    nextUserAction:\n      'Please check your card numbers and try again. If it still cannot be processed, the please contact your card issuer.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'カード番号が正しくありません。',\n        nextUserAction:\n          'カード番号を確認してもう一度やり直してください。それでも処理できない場合は、カード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  incorrect_cvc: {\n    description: 'The CVC number is incorrect.',\n    nextSteps: 'The customer should try again using the correct CVC.',\n    nextUserAction:\n      'Please check your card numbers and try again. If it still cannot be processed, the please contact your card issuer.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'CVC番号が正しくありません。',\n        nextUserAction:\n          'CSC番号を確認してもう一度やり直してください。それでも処理できない場合は、カード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  incorrect_pin: {\n    description:\n      'The PIN entered is incorrect. This decline code only applies to payments made with a card reader.',\n    nextSteps: 'The customer should try again using the correct PIN.',\n    nextUserAction:\n      'Please check your PIN and try again. If it still cannot be processed, the please contact your card issuer.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'PINコードが正しくありません。',\n        nextUserAction:\n          'PINコードを確認してもう一度やり直してください。それでも処理できない場合は、カード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  incorrect_zip: {\n    description: 'The ZIP/postal code is incorrect.',\n    nextSteps: 'The customer should try again using the correct billing ZIP/postal code.',\n    nextUserAction: 'Please try again using the correct ZIP/postal code.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: '郵便番号が正しくありません。',\n        nextUserAction: '正しい郵便番号を使用してもう一度お試しください。',\n      },\n    },\n  },\n  insufficient_funds: {\n    description: 'The card has insufficient funds to complete the purchase.',\n    nextSteps: 'The customer should use an alternative payment method.',\n    nextUserAction: 'Please try again using an alternative payment method.',\n    category: 'SOFT_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードの購入に必要な資金が不足しています。',\n        nextUserAction: '別のお支払い方法を使用してもう一度お試しください。',\n      },\n    },\n  },\n  invalid_account: {\n    description: 'The card, or account the card is connected to, is invalid.',\n    nextSteps:\n      'The customer needs to contact their card issuer to check that the card is working correctly.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'カード、またはカードが接続されているアカウントが無効です。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  invalid_amount: {\n    description: 'The payment amount is invalid, or exceeds the amount that is allowed.',\n    nextSteps:\n      'If the amount appears to be correct, the customer needs to check with their card issuer that they can make purchases of that amount.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'SOFT_DECLINE',\n    translations: {\n      ja: {\n        description: '支払い金額が無効であるか、許可されている金額を超えています。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  invalid_cvc: {\n    description: 'The CVC number is incorrect.',\n    nextSteps: 'The customer should try again using the correct CVC.',\n    nextUserAction: 'Please try again using the correct CVC.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'CVC番号が正しくありません。',\n        nextUserAction: '正しいCVCを使用してもう一度やり直してください。',\n      },\n    },\n  },\n  invalid_expiry_year: {\n    description: 'The expiration year invalid.',\n    nextSteps: 'The customer should try again using the correct expiration date.',\n    nextUserAction: 'Please try again using the correct expiration date.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: '有効期限が無効です。',\n        nextUserAction: '正しい有効期限を入力してもう一度お試しください。',\n      },\n    },\n  },\n  invalid_number: {\n    description: 'The card number is incorrect.',\n    nextSteps: 'The customer should try again using the correct card number.',\n    nextUserAction: 'Please try again using the correct card number.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'カード番号が正しくありません。',\n        nextUserAction: '正しいカード番号を使用してもう一度やり直してください。',\n      },\n    },\n  },\n  invalid_pin: {\n    description:\n      'The PIN entered is incorrect. This decline code only applies to payments made with a card reader.',\n    nextSteps: 'The customer should try again using the correct PIN.',\n    nextUserAction: 'Please try again using the correct card PIN.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'PINコードが正しくありません。',\n        nextUserAction: '正しいPINコードを使用してもう一度やり直してください。',\n      },\n    },\n  },\n  issuer_not_available: {\n    description: 'The card issuer could not be reached, so the payment could not be authorized.',\n    nextSteps:\n      'The payment should be attempted again. If it still cannot be processed, the customer needs to contact their card issuer.',\n    nextUserAction:\n      'Please try again. If it still cannot be processed, the please contact your card issuer.',\n    category: 'SOFT_DECLINE',\n    translations: {\n      ja: {\n        description: 'カード発行者に連絡できなかったため、支払いを承認できませんでした。',\n        nextUserAction:\n          'もう一度やり直してください。それでも処理できない場合は、カード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  lost_card: {\n    description: 'The payment has been declined because the card is reported lost.',\n    nextSteps:\n      'The specific reason for the decline should not be reported to the customer. Instead, it needs to be presented as a generic decline.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードは未知の理由で拒否されました。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  merchant_blacklist: {\n    description:\n      \"The payment has been declined because it matches a value on the Stripe user's blocklist.\",\n    nextSteps:\n      'Do not report more detailed information to your customer. Instead, present as you would the generic_decline described above.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードは未知の理由で拒否されました。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  new_account_information_available: {\n    description: 'The card, or account the card is connected to, is invalid.',\n    nextSteps: 'The customer needs to contact their card issuer for more information.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'SOFT_DECLINE',\n    translations: {\n      ja: {\n        description: 'カード、またはカードが接続されているアカウントが無効です。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  no_action_taken: {\n    description: 'The card has been declined for an unknown reason.',\n    nextSteps: 'The customer should contact their card issuer for more information.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'SOFT_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードは未知の理由で拒否されました。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  not_permitted: {\n    description: 'The payment is not permitted.',\n    nextSteps: 'The customer needs to contact their card issuer for more information.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: '支払いは許可されていません。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  pickup_card: {\n    description:\n      'The card cannot be used to make this payment (it is possible it has been reported lost or stolen).',\n    nextSteps: 'The customer needs to contact their card issuer for more information.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description:\n          'カードでこの支払いを行うことはできません（紛失または盗難にあったと報告されている可能性があります）。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  pin_try_exceeded: {\n    description: 'The allowable number of PIN tries has been exceeded.',\n    nextSteps: 'The customer must use another card or method of payment.',\n    nextUserAction: 'Please use another card or method of payment.',\n    category: 'SOFT_DECLINE',\n    translations: {\n      ja: {\n        description: 'PIN試行回数の上限を超えました。',\n        nextUserAction: '別のカードまたはお支払い方法をご利用ください。',\n      },\n    },\n  },\n  processing_error: {\n    description: 'An error occurred while processing the card.',\n    nextSteps:\n      'The payment should be attempted again. If it still cannot be processed, try again later.',\n    nextUserAction:\n      'Please try again. If it still cannot be processed, the please contact your card issuer.',\n    category: 'SOFT_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードの処理中にエラーが発生しました。',\n        nextUserAction:\n          'もう一度やり直してください。それでも処理できない場合は、カード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  reenter_transaction: {\n    description: 'The payment could not be processed by the issuer for an unknown reason.',\n    nextSteps:\n      'The payment should be attempted again. If it still cannot be processed, the customer needs to contact their card issuer.',\n    nextUserAction:\n      'Please try again. If it still cannot be processed, the please contact your card issuer.',\n    category: 'SOFT_DECLINE',\n    translations: {\n      ja: {\n        description: '原因不明のため、発行者が支払いを処理できませんでした。',\n        nextUserAction:\n          'もう一度やり直してください。それでも処理できない場合は、カード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  restricted_card: {\n    description:\n      'The card cannot be used to make this payment (it is possible it has been reported lost or stolen).',\n    nextSteps: 'The customer needs to contact their card issuer for more information.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description:\n          'カードでこの支払いを行うことはできません（紛失または盗難にあったと報告されている可能性があります）。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  revocation_of_all_authorizations: {\n    description: 'The card has been declined for an unknown reason.',\n    nextSteps: 'The customer should contact their card issuer for more information.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードは未知の理由で拒否されました。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  revocation_of_authorization: {\n    description: 'The card has been declined for an unknown reason.',\n    nextSteps: 'The customer should contact their card issuer for more information.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードは未知の理由で拒否されました。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  security_violation: {\n    description: 'The card has been declined for an unknown reason.',\n    nextSteps: 'The customer needs to contact their card issuer for more information.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードは未知の理由で拒否されました。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  service_not_allowed: {\n    description: 'The card has been declined for an unknown reason.',\n    nextSteps: 'The customer should contact their card issuer for more information.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードは未知の理由で拒否されました。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  stolen_card: {\n    description: 'The payment has been declined because the card is reported stolen.',\n    nextSteps:\n      'The specific reason for the decline should not be reported to the customer. Instead, it needs to be presented as a generic decline.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードは未知の理由で拒否されました。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  stop_payment_order: {\n    description: 'The card has been declined for an unknown reason.',\n    nextSteps: 'The customer should contact their card issuer for more information.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードは未知の理由で拒否されました。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  testmode_decline: {\n    description: 'A Stripe test card number was used.',\n    nextSteps: 'A genuine card must be used to make a payment.',\n    nextUserAction: 'A genuine card must be used to make a payment.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'Stripeテストカード番号を使用しました。',\n        nextUserAction: '支払いには本物のカードを使用する必要があります。',\n      },\n    },\n  },\n  transaction_not_allowed: {\n    description: 'The card has been declined for an unknown reason.',\n    nextSteps: 'The customer needs to contact their card issuer for more information.',\n    nextUserAction: 'Please contact your card issuer for more information.',\n    category: 'HARD_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードは未知の理由で拒否されました。',\n        nextUserAction: '詳しくはカード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  try_again_later: {\n    description: 'The card has been declined for an unknown reason.',\n    nextSteps:\n      'Ask the customer to attempt the payment again. If subsequent payments are declined, the customer should contact their card issuer for more information.',\n    nextUserAction:\n      'Please try again. If it still cannot be processed, the please contact your card issuer.',\n    category: 'SOFT_DECLINE',\n    translations: {\n      ja: {\n        description: 'カードは未知の理由で拒否されました。',\n        nextUserAction:\n          'もう一度やり直してください。それでも処理できない場合は、カード発行会社にお問い合わせください。',\n      },\n    },\n  },\n  withdrawal_count_limit_exceeded: {\n    description: 'The customer has exceeded the balance or credit limit available on their card.',\n    nextSteps: 'The customer should use an alternative payment method.',\n    nextUserAction: 'Please use another card or contact your card issuer for more information.',\n    category: 'SOFT_DECLINE',\n    translations: {\n      ja: {\n        description: 'このカードの残高またはクレジット制限を超えました。',\n        nextUserAction: '別のカードを使用するか、カード発行会社にお問い合わせください。',\n      },\n    },\n  },\n};\n","import { DECLINE_CODES, DOC_VERSION } from './data/decline-codes.js';\nimport type {\n  DeclineCategory,\n  DeclineCode,\n  DeclineCodeResult,\n  Locale,\n  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":"gFAOO,MAAMA,EAAc,aAMdC,EAAsD,CACjE,gBAAiB,CACf,YAAa,oCACb,UACE,2HACF,eACE,0FACF,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,eACb,eACE,iDAAA,CACJ,CACF,EAEF,YAAa,CACX,YAAa,oDACb,UAAW,wEACX,eAAgB,wDAChB,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,qBACb,eAAgB,yBAAA,CAClB,CACF,EAEF,mBAAoB,CAClB,YAAa,mDACb,UACE,qHACF,eACE,gHACF,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,yBACb,eACE,+DAAA,CACJ,CACF,EAEF,uBAAwB,CACtB,YAAa,iFACb,UAAW,sEACX,eAAgB,wDAChB,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,4BACb,eAAgB,yBAAA,CAClB,CACF,EAEF,uBAAwB,CACtB,YAAa,oDACb,UACE,+GACF,eACE,gGACF,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,0BACb,eACE,iDAAA,CACJ,CACF,EAEF,aAAc,CACZ,YAAa,oDACb,UAAW,wEACX,eAAgB,wDAChB,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,qBACb,eAAgB,yBAAA,CAClB,CACF,EAEF,iBAAkB,CAChB,YAAa,oDACb,UAAW,sEACX,eAAgB,wDAChB,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,qBACb,eAAgB,yBAAA,CAClB,CACF,EAEF,sBAAuB,CACrB,YACE,+FACF,UAAW,mDACX,eAAgB,mDAChB,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,wCACb,eAAgB,6BAAA,CAClB,CACF,EAEF,aAAc,CACZ,YAAa,wBACb,UAAW,wCACX,eAAgB,2BAChB,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,cACb,eAAgB,iBAAA,CAClB,CACF,EAEF,WAAY,CACV,YAAa,qEACb,UACE,+HACF,eAAgB,wDAChB,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,yBACb,eAAgB,yBAAA,CAClB,CACF,EAEF,gBAAiB,CACf,YAAa,oDACb,UAAW,wEACX,eAAgB,wDAChB,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,qBACb,eAAgB,yBAAA,CAClB,CACF,EAEF,iBAAkB,CAChB,YAAa,gCACb,UAAW,+DACX,eACE,sHACF,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,kBACb,eACE,2DAAA,CACJ,CACF,EAEF,cAAe,CACb,YAAa,+BACb,UAAW,uDACX,eACE,sHACF,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,kBACb,eACE,2DAAA,CACJ,CACF,EAEF,cAAe,CACb,YACE,oGACF,UAAW,uDACX,eACE,6GACF,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,mBACb,eACE,4DAAA,CACJ,CACF,EAEF,cAAe,CACb,YAAa,oCACb,UAAW,2EACX,eAAgB,sDAChB,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,iBACb,eAAgB,0BAAA,CAClB,CACF,EAEF,mBAAoB,CAClB,YAAa,4DACb,UAAW,yDACX,eAAgB,wDAChB,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,wBACb,eAAgB,2BAAA,CAClB,CACF,EAEF,gBAAiB,CACf,YAAa,6DACb,UACE,+FACF,eAAgB,wDAChB,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,gCACb,eAAgB,yBAAA,CAClB,CACF,EAEF,eAAgB,CACd,YAAa,wEACb,UACE,uIACF,eAAgB,wDAChB,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,iCACb,eAAgB,yBAAA,CAClB,CACF,EAEF,YAAa,CACX,YAAa,+BACb,UAAW,uDACX,eAAgB,0CAChB,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,kBACb,eAAgB,2BAAA,CAClB,CACF,EAEF,oBAAqB,CACnB,YAAa,+BACb,UAAW,mEACX,eAAgB,sDAChB,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,aACb,eAAgB,0BAAA,CAClB,CACF,EAEF,eAAgB,CACd,YAAa,gCACb,UAAW,+DACX,eAAgB,kDAChB,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,kBACb,eAAgB,6BAAA,CAClB,CACF,EAEF,YAAa,CACX,YACE,oGACF,UAAW,uDACX,eAAgB,+CAChB,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,mBACb,eAAgB,8BAAA,CAClB,CACF,EAEF,qBAAsB,CACpB,YAAa,gFACb,UACE,2HACF,eACE,0FACF,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,oCACb,eACE,iDAAA,CACJ,CACF,EAEF,UAAW,CACT,YAAa,mEACb,UACE,sIACF,eAAgB,wDAChB,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,qBACb,eAAgB,yBAAA,CAClB,CACF,EAEF,mBAAoB,CAClB,YACE,2FACF,UACE,+HACF,eAAgB,wDAChB,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,qBACb,eAAgB,yBAAA,CAClB,CACF,EAEF,kCAAmC,CACjC,YAAa,6DACb,UAAW,wEACX,eAAgB,wDAChB,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,gCACb,eAAgB,yBAAA,CAClB,CACF,EAEF,gBAAiB,CACf,YAAa,oDACb,UAAW,sEACX,eAAgB,wDAChB,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,qBACb,eAAgB,yBAAA,CAClB,CACF,EAEF,cAAe,CACb,YAAa,gCACb,UAAW,wEACX,eAAgB,wDAChB,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,iBACb,eAAgB,yBAAA,CAClB,CACF,EAEF,YAAa,CACX,YACE,qGACF,UAAW,wEACX,eAAgB,wDAChB,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YACE,qDACF,eAAgB,yBAAA,CAClB,CACF,EAEF,iBAAkB,CAChB,YAAa,uDACb,UAAW,2DACX,eAAgB,gDAChB,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,oBACb,eAAgB,yBAAA,CAClB,CACF,EAEF,iBAAkB,CAChB,YAAa,+CACb,UACE,2FACF,eACE,0FACF,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,sBACb,eACE,iDAAA,CACJ,CACF,EAEF,oBAAqB,CACnB,YAAa,0EACb,UACE,2HACF,eACE,0FACF,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,8BACb,eACE,iDAAA,CACJ,CACF,EAEF,gBAAiB,CACf,YACE,qGACF,UAAW,wEACX,eAAgB,wDAChB,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YACE,qDACF,eAAgB,yBAAA,CAClB,CACF,EAEF,iCAAkC,CAChC,YAAa,oDACb,UAAW,sEACX,eAAgB,wDAChB,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,qBACb,eAAgB,yBAAA,CAClB,CACF,EAEF,4BAA6B,CAC3B,YAAa,oDACb,UAAW,sEACX,eAAgB,wDAChB,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,qBACb,eAAgB,yBAAA,CAClB,CACF,EAEF,mBAAoB,CAClB,YAAa,oDACb,UAAW,wEACX,eAAgB,wDAChB,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,qBACb,eAAgB,yBAAA,CAClB,CACF,EAEF,oBAAqB,CACnB,YAAa,oDACb,UAAW,sEACX,eAAgB,wDAChB,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,qBACb,eAAgB,yBAAA,CAClB,CACF,EAEF,YAAa,CACX,YAAa,qEACb,UACE,sIACF,eAAgB,wDAChB,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,qBACb,eAAgB,yBAAA,CAClB,CACF,EAEF,mBAAoB,CAClB,YAAa,oDACb,UAAW,sEACX,eAAgB,wDAChB,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,qBACb,eAAgB,yBAAA,CAClB,CACF,EAEF,iBAAkB,CAChB,YAAa,sCACb,UAAW,iDACX,eAAgB,iDAChB,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,yBACb,eAAgB,0BAAA,CAClB,CACF,EAEF,wBAAyB,CACvB,YAAa,oDACb,UAAW,wEACX,eAAgB,wDAChB,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,qBACb,eAAgB,yBAAA,CAClB,CACF,EAEF,gBAAiB,CACf,YAAa,oDACb,UACE,0JACF,eACE,0FACF,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,qBACb,eACE,iDAAA,CACJ,CACF,EAEF,gCAAiC,CAC/B,YAAa,iFACb,UAAW,yDACX,eAAgB,4EAChB,SAAU,eACV,aAAc,CACZ,GAAI,CACF,YAAa,4BACb,eAAgB,iCAAA,CAClB,CACF,CAEJ,ECniBO,SAASC,EAAsBC,EAAyC,CAC7E,GAAI,CAACA,GAAe,CAACC,EAAmBD,CAAW,EACjD,MAAO,CACL,WAAYH,EACZ,KAAM,CAAA,CAAC,EAIX,MAAMK,EAAOJ,EAAcE,CAAW,EACtC,MAAO,CACL,WAAYH,EACZ,KAAAK,CAAA,CAEJ,CAgBO,SAASC,EAAkBH,EAAqBI,EAAiB,KAA0B,CAChG,GAAI,CAACH,EAAmBD,CAAW,EACjC,OAGF,MAAMK,EAAWP,EAAcE,CAAW,EAE1C,OAAII,IAAW,KACNC,EAAS,eAGXA,EAAS,eAAeD,CAAM,GAAG,cAC1C,CAcO,SAASE,GAAoC,CAClD,OAAO,OAAO,KAAKR,CAAa,CAClC,CAcO,SAASG,EAAmBC,EAAmC,CACpE,OAAO,OAAO,OAAOJ,EAAeI,CAAI,CAC1C,CAaO,SAASK,GAAwB,CACtC,OAAOV,CACT,CAoBO,SAASW,EACdR,EACAI,EAAiB,KACjBK,EACoB,CACpB,MAAMC,EAAcP,EAAkBH,EAAaI,CAAM,EAEzD,GAAI,CAACM,EACH,OAGF,GAAI,CAACD,GAAa,OAAO,KAAKA,CAAS,EAAE,SAAW,EAClD,OAAOC,EAIT,IAAIC,EAAmBD,EACvB,SAAW,CAACE,EAAKC,CAAK,IAAK,OAAO,QAAQJ,CAAS,EAAG,CAEpD,MAAMK,EAAaF,EAAI,QAAQ,sBAAuB,MAAM,EACtDG,EAAc,IAAI,OAAO,SAASD,CAAU,SAAU,GAAG,EAC/DH,EAAmBA,EAAiB,QAAQI,EAAaF,CAAK,CAChE,CAEA,OAAOF,CACT,CAcO,SAASK,EAAmBd,EAA2C,CAC5E,GAAKD,EAAmBC,CAAI,EAI5B,OAAOJ,EAAcI,CAAI,EAAE,QAC7B,CAcO,SAASe,EAAcf,EAAuB,CACnD,OAAOc,EAAmBd,CAAI,IAAM,cACtC,CAcO,SAASgB,EAAchB,EAAuB,CACnD,OAAOc,EAAmBd,CAAI,IAAM,cACtC,CAqBO,SAASiB,EACdC,EACAhB,EAAiB,KACG,CACpB,GAAKgB,EAAM,aAIX,OAAOjB,EAAkBiB,EAAM,aAAchB,CAAM,CACrD"}

package/dist/index.d.ts

@@ -0,0 +1,151 @@
+import type { DeclineCategory, DeclineCode, DeclineCodeResult, Locale, StripeError } from './types.js';
+/**
+ * Get decline code information with description and recommended actions
+ *
+ * @param declineCode - The Stripe decline code to look up
+ * @returns Object containing the decline code information and documentation version
+ *
+ * @example
+ * ```ts
+ * const result = getDeclineDescription('insufficient_funds');
+ * console.log(result.code.description);
+ * // => "The card has insufficient funds to complete the purchase."
+ * console.log(result.code.nextUserAction);
+ * // => "Please try again using an alternative payment method."
+ * ```
+ */
+export declare function getDeclineDescription(declineCode?: string): DeclineCodeResult;
+/**
+ * Get localized decline code message for end users
+ *
+ * @param declineCode - The Stripe decline code
+ * @param locale - The locale to use (default: 'en')
+ * @returns User-facing message in the specified locale, or undefined if not found
+ *
+ * @example
+ * ```ts
+ * const message = getDeclineMessage('insufficient_funds', 'ja');
+ * console.log(message);
+ * // => "別のお支払い方法を使用してもう一度お試しください。"
+ * ```
+ */
+export declare function getDeclineMessage(declineCode: string, locale?: Locale): string | undefined;
+/**
+ * Get all available decline codes
+ *
+ * @returns Array of all supported decline code strings
+ *
+ * @example
+ * ```ts
+ * const codes = getAllDeclineCodes();
+ * console.log(codes.length); // => 44
+ * console.log(codes.includes('insufficient_funds')); // => true
+ * ```
+ */
+export declare function getAllDeclineCodes(): DeclineCode[];
+/**
+ * Check if a decline code is valid
+ *
+ * @param code - The code to validate
+ * @returns True if the code exists in the database
+ *
+ * @example
+ * ```ts
+ * isValidDeclineCode('insufficient_funds'); // => true
+ * isValidDeclineCode('invalid_code'); // => false
+ * ```
+ */
+export declare function isValidDeclineCode(code: string): code is DeclineCode;
+/**
+ * Get the documentation version for the decline codes data
+ *
+ * @returns The Stripe API documentation version string
+ *
+ * @example
+ * ```ts
+ * const version = getDocVersion();
+ * console.log(version); // => "2024-12-18"
+ * ```
+ */
+export declare function getDocVersion(): string;
+/**
+ * Format a decline message with custom template variables
+ *
+ * @param declineCode - The Stripe decline code
+ * @param locale - The locale to use (default: 'en')
+ * @param variables - Optional variables to replace in the message template
+ * @returns Formatted user-facing message with variables replaced
+ *
+ * @example
+ * ```ts
+ * const message = formatDeclineMessage('insufficient_funds', 'en', {
+ *   merchantName: 'Acme Store',
+ *   supportEmail: 'support@acme.com'
+ * });
+ * console.log(message);
+ * // => "Please try again using an alternative payment method."
+ * ```
+ */
+export declare function formatDeclineMessage(declineCode: string, locale?: Locale, variables?: Record<string, string>): string | undefined;
+/**
+ * Get the category of a decline code (SOFT_DECLINE or HARD_DECLINE)
+ *
+ * @param code - The decline code to categorize
+ * @returns The category of the decline code, or undefined if invalid
+ *
+ * @example
+ * ```ts
+ * getDeclineCategory('insufficient_funds'); // => 'SOFT_DECLINE'
+ * getDeclineCategory('fraudulent'); // => 'HARD_DECLINE'
+ * ```
+ */
+export declare function getDeclineCategory(code: string): DeclineCategory | undefined;
+/**
+ * Check if a decline code is a hard decline (permanent, should not retry)
+ *
+ * @param code - The decline code to check
+ * @returns True if the code is a hard decline
+ *
+ * @example
+ * ```ts
+ * isHardDecline('fraudulent'); // => true
+ * isHardDecline('insufficient_funds'); // => false
+ * ```
+ */
+export declare function isHardDecline(code: string): boolean;
+/**
+ * Check if a decline code is a soft decline (temporary, can retry)
+ *
+ * @param code - The decline code to check
+ * @returns True if the code is a soft decline
+ *
+ * @example
+ * ```ts
+ * isSoftDecline('insufficient_funds'); // => true
+ * isSoftDecline('fraudulent'); // => false
+ * ```
+ */
+export declare function isSoftDecline(code: string): boolean;
+/**
+ * Extract localized message from a Stripe error object
+ *
+ * @param error - The Stripe error object
+ * @param locale - The locale to use (default: 'en')
+ * @returns User-facing message in the specified locale, or undefined if not found
+ *
+ * @example
+ * ```ts
+ * const stripeError = {
+ *   type: 'StripeCardError',
+ *   decline_code: 'insufficient_funds',
+ *   message: 'Your card has insufficient funds.'
+ * };
+ * const message = getMessageFromStripeError(stripeError, 'ja');
+ * console.log(message);
+ * // => "別のお支払い方法を使用してもう一度お試しください。"
+ * ```
+ */
+export declare function getMessageFromStripeError(error: StripeError, locale?: Locale): string | undefined;
+export { DECLINE_CODES, DOC_VERSION } from './data/decline-codes.js';
+export type { DeclineCategory, DeclineCode, DeclineCodeInfo, DeclineCodeResult, Locale, StripeError, Translation, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}