Export Decimal as a type in the Stripe namespace

src/Decimal.ts

@@ -67,19 +67,6 @@ export interface DecimalRoundingOptions {
 /**
  * Built-in rounding presets keyed by semantic name.
  *
- * @remarks
- * This is an **open interface** — consumers can extend it via declaration
- * merging to register custom presets that are accepted by
- * {@link DecimalImpl.round}:
- *
- * ```ts
- * declare module '@stripe/apps-extensibility-sdk/stdlib' {
- *   interface DecimalRoundingPresets {
- *     'my-custom-preset': DecimalRoundingOptions;
- *   }
- * }
- * ```
- *
  * Built-in presets:
  *
  * | Preset              | Equivalent DecimalRoundingOptions                      |
@@ -1011,21 +998,6 @@ class DecimalImpl {
  * prevents accidental assignment from plain `number`, `string`, or
  * `bigint`.
  *
- * Create values via the companion object:
- *
- * @example
- * ```ts
- * import { Decimal, RoundDirection } from '@stripe/apps-extensibility-sdk/stdlib';
- *
- * const price = Decimal.from('19.99');
- * const tax   = price.mul(Decimal.from('0.0825'));
- * const total = price.add(tax);
- *
- * console.log(total.toFixed(2, 'half-up'));   // "21.64"
- * console.log(JSON.stringify({ total }));          // '{"total":"21.639175"}'
- * console.log(total.toFixed(2, 'half-even')); // "21.64"
- * ```
- *
  * @public
  */
 export type Decimal = DecimalImpl & {

src/stripe.cjs.node.ts

@@ -7,7 +7,7 @@
 // Create a callable wrapper for backward compatibility
 // eslint-disable-next-line func-style
 const StripeConstructor = function(
   this: any,
   key: string,
   config?: Record<string, unknown>
 ): Stripe {
@@ -34,4 +34,11 @@
     });
   }
 }
+// Re-export the Decimal type so that CJS consumers can use
+// Stripe.Decimal as a type (e.g., `const d: Stripe.Decimal`).
+// Without this, `export =` only carries the function signature, not the
+// merged namespace from stripe.core.ts.
+declare namespace StripeConstructor {
+  export type Decimal = import('./shared.js').Decimal;
+}
 export = StripeConstructor;

src/stripe.core.ts

@@ -2453,6 +2453,8 @@ export declare namespace Stripe {
     Emptyable,
   };
 
+  export type Decimal = import('./shared.js').Decimal;
+
   export {StripeContext as StripeContextType};
   export {StripeRawError};
   export import ErrorType = _Error;

src/stripe.esm.node.ts

@@ -2453,6 +2453,8 @@ export declare namespace Stripe {
     Emptyable,
   };
 
+  export type Decimal = import('./shared.js').Decimal;
+
   export {StripeContext as StripeContextType};
   export {StripeRawError};
   export import ErrorType = _Error;
@@ -2461,4 +2463,5 @@ export declare namespace Stripe {
 
 Stripe.initialize(new NodePlatformFunctions());
 
+export {Decimal} from './shared.js';
 export default Stripe;

testProjects/mjs-ts/index.ts

@@ -1,4 +1,4 @@
-import DefaultStripe, {Stripe} from 'stripe';
+import DefaultStripe, {Stripe, type Decimal} from 'stripe';
 
 const stripe = new Stripe(process.argv[2], {
   // if we specify a version, then our smoke tests fail every time there's a new API version being prepped
@@ -48,4 +48,8 @@ exampleFunction({
   payment_method: 'pm_card_visa',
 });
 
-Stripe.Decimal.from('1.0');
+// Verify Stripe.Decimal works as both a runtime call and a type annotation.
+const decimalInstance: Stripe.Decimal = Stripe.Decimal.from('1.0');
+// Verify named type import works: import type { Decimal } from 'stripe'
+const decimalViaNamedImport: Decimal = Stripe.Decimal.from('2.0');
+console.log('Decimal:', decimalInstance.toString(), decimalViaNamedImport.toString());

testProjects/types/typescriptTest.ts

@@ -343,4 +343,5 @@ async (): Promise<void> => {
   let g: Stripe.V2.Core.Event;
 }
 
-Stripe.Decimal.from('1.0');
+// Verify Stripe.Decimal works as both a runtime call and a type annotation.
+const decimalInstance: Stripe.Decimal = Stripe.Decimal.from('1.0');