Merge pull request #2622 from stripe/jar/merge-node-beta

Merge to beta

Author: jar-stripe

src/Decimal.ts

@@ -1,5 +1,4 @@
 import {
-  getAPIMode,
   getDataFromArgs,
   getOptionsFromArgs,
   makeURLInterpolator,
@@ -17,7 +16,7 @@ import {
   UrlInterpolator,
 } from './Types.js';
 import {HttpClientResponseInterface} from './net/HttpClient.js';
-import {coerceV2RequestData, coerceV2ResponseData} from './V2Int64.js';
+import {coerceV2RequestData, coerceV2ResponseData} from './V2Coercion.js';
 
 // Provide extension mechanism for Stripe Resource Sub-Classes
 StripeResource.extend = protoExtend;
@@ -211,9 +210,8 @@ StripeResource.prototype = {
         return;
       }
 
-      // Coerce int64_string fields in request body: number → string
-      const apiMode = getAPIMode(spec.fullPath || spec.path);
-      if (apiMode === 'v2' && spec.requestSchema && opts.bodyData) {
+      // Coerce int64_string/decimal_string fields in request body: number/Decimal → string
+      if (spec.requestSchema && opts.bodyData) {
         opts.bodyData = coerceV2RequestData(
           opts.bodyData,
           spec.requestSchema
@@ -227,9 +225,9 @@ StripeResource.prototype = {
         if (err) {
           reject(err);
         } else {
-          // Coerce int64_string fields in response: string → bigint
+          // Coerce int64_string/decimal_string fields in response: string → bigint/Decimal
           try {
-            if (apiMode === 'v2' && spec.responseSchema) {
+            if (spec.responseSchema) {
               coerceV2ResponseData(response, spec.responseSchema);
             }
             resolve(

src/StripeResource.ts

@@ -18,6 +18,7 @@ export type BufferedFile = {
 };
 export type V2RuntimeSchema =
   | {kind: 'int64_string'}
+  | {kind: 'decimal_string'}
   | {kind: 'object'; fields: Record<string, V2RuntimeSchema>}
   | {kind: 'array'; element: V2RuntimeSchema}
   | {kind: 'nullable'; inner: V2RuntimeSchema};

src/Types.d.ts

@@ -1,3 +1,4 @@
+import {Decimal} from './Decimal.js';
 import {V2RuntimeSchema} from './Types.js';
 
 /**
@@ -21,6 +22,13 @@ export const coerceV2RequestData = (
         ? String(data)
         : data;
 
+    case 'decimal_string':
+      // Duck-type check: Decimal instances have toFixed() and isZero() methods.
+      return typeof (data as any).toFixed === 'function' &&
+        typeof (data as any).isZero === 'function'
+        ? (data as Decimal).toString()
+        : data;
+
     case 'object': {
       if (typeof data !== 'object' || Array.isArray(data)) {
         return data;
@@ -78,6 +86,18 @@ export const coerceV2ResponseData = (
       }
       return data;
 
+    case 'decimal_string':
+      if (typeof data === 'string') {
+        try {
+          return Decimal.from(data);
+        } catch {
+          throw new Error(
+            `Failed to coerce decimal_string value: expected a decimal string, got '${data}'`
+          );
+        }
+      }
+      return data;
+
     case 'object': {
       if (typeof data !== 'object' || Array.isArray(data)) {
         return data;