@stripe/extensibility-sdk 0.24.1 → 0.25.0

package/dist/stdlib/brand.d.ts

@@ -1,27 +1,33 @@
 /**
- * Opaque brand symbol used as a property key in SDK branded types.
+ * Opaque brand key used as a property key in SDK branded types.
  *
  * @remarks
  * You do not need to use this directly — it is already embedded in
- * branded values returned by factory functions like {@link (Integer:type)}.create().
- * The `unique symbol` key makes the brand non-enumerable and impossible
- * to forge without access to this symbol.
+ * branded values returned by factory functions like {@link (Integer:type)}.from().
+ *
+ * String-literal const (not `unique symbol`) so that independent
+ * declaration rollups (root vs subpath) produce structurally compatible
+ * branded types.
  *
  * @public
  */
-export declare const __brand: unique symbol;
+export declare const __brand: '__brand';
 /**
- * Opaque type-tag symbol used by SDK scalar types to carry Stripe type metadata.
+ * Opaque type-tag key used by SDK scalar types to carry Stripe type metadata.
  *
  * @remarks
  * You do not need to use this directly — it is already embedded in
- * branded values returned by factory functions like {@link (Integer:type)}.create().
+ * branded values returned by factory functions like {@link (Integer:type)}.from().
+ *
+ * String-literal const (not `unique symbol`) so that independent
+ * declaration rollups (root vs subpath) produce structurally compatible
+ * branded types.
  *
  * @public
  */
-export declare const __stripeType: unique symbol;
-/** The type of the opaque brand symbol used as a property key in SDK branded types. @public */
+export declare const __stripeType: '__stripeType';
+/** The type of the opaque brand key used as a property key in SDK branded types. @public */
 export type BrandSymbol = typeof __brand;
-/** The type of the opaque Stripe type-tag symbol used in SDK scalar types. @public */
+/** The type of the opaque Stripe type-tag key used in SDK scalar types. @public */
 export type StripeTypeSymbol = typeof __stripeType;
 //# sourceMappingURL=brand.d.ts.map

package/dist/stdlib/brand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brand.d.ts","sourceRoot":"","sources":["../../src/stdlib/brand.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,OAAO,CAAC,MAAM,OAAO,EAAE,OAAO,MAAM,CAAC;AAE5C;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,CAAC,MAAM,YAAY,EAAE,OAAO,MAAM,CAAC;AAEjD,+FAA+F;AAC/F,MAAM,MAAM,WAAW,GAAG,OAAO,OAAO,CAAC;AAEzC,sFAAsF;AACtF,MAAM,MAAM,gBAAgB,GAAG,OAAO,YAAY,CAAC"}
+{"version":3,"file":"brand.d.ts","sourceRoot":"","sources":["../../src/stdlib/brand.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,OAAO,CAAC,MAAM,OAAO,EAAE,SAAS,CAAC;AAExC;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,OAAO,CAAC,MAAM,YAAY,EAAE,cAAc,CAAC;AAElD,4FAA4F;AAC5F,MAAM,MAAM,WAAW,GAAG,OAAO,OAAO,CAAC;AAEzC,mFAAmF;AACnF,MAAM,MAAM,gBAAgB,GAAG,OAAO,YAAY,CAAC"}

package/dist/stdlib/decimal.d.ts

@@ -1,14 +1,19 @@
 import { type __brand, type __stripeType } from './brand.js';
+import type { Integer } from './scalars.js';
 /**
- * Unique brand symbol for the {@link Decimal} type.
+ * Unique brand key for the `Decimal` type.
  *
- * Using a dedicated symbol (rather than the shared `__brand`) lets formspec's
+ * Using a dedicated key (rather than the shared `__brand`) lets formspec's
  * structural brand-detection distinguish `Decimal` from other SDK branded
  * types (e.g., `Ref`, `StreetAddress`) that also carry `[__brand]`.
  *
+ * String-literal const (not `unique symbol`) so that independent
+ * declaration rollups (root vs subpath) produce structurally compatible
+ * branded types.
+ *
  * @internal
  */
-declare const __decimalBrand: unique symbol;
+export declare const __decimalBrand: '__decimalBrand';
 /**
  * Rounding direction for Decimal operations.
  *
@@ -29,7 +34,7 @@ declare const __decimalBrand: unique symbol;
  *
  * @public
  */
-export type RoundDirection = 'ceil' | 'floor' | 'half-down' | 'half-even' | 'half-up' | 'round-down' | 'round-up';
+export type RoundDirection = 'ceil' | 'floor' | 'round-down' | 'round-up' | 'half-up' | 'half-down' | 'half-even';
 /**
  * Precision specification for `Decimal.round()`.
  *
@@ -150,52 +155,52 @@ export interface Decimal {
      * Return the sum of this value and `other`.
      * @public
      */
-    add(other: Decimal): Decimal;
+    add(other: DecimalLike): Decimal;
     /**
      * Return the difference of this value and `other`.
      * @public
      */
-    sub(other: Decimal): Decimal;
+    sub(other: DecimalLike): Decimal;
     /**
      * Return the product of this value and `other`.
      * @public
      */
-    mul(other: Decimal): Decimal;
+    mul(other: DecimalLike): Decimal;
     /**
      * Return the quotient of this value divided by `other`.
      * @public
      */
-    div(other: Decimal, precision: number, direction: RoundDirection): Decimal;
+    div(other: DecimalLike, precision: number, direction: RoundDirection): Decimal;
     /**
      * Three-way comparison: returns `-1`, `0`, or `1`.
      * @public
      */
-    cmp(other: Decimal): -1 | 0 | 1;
+    cmp(other: DecimalLike): -1 | 0 | 1;
     /**
      * Return `true` if this value is numerically equal to `other`.
      * @public
      */
-    eq(other: Decimal): boolean;
+    eq(other: DecimalLike): boolean;
     /**
      * Return `true` if this value is strictly less than `other`.
      * @public
      */
-    lt(other: Decimal): boolean;
+    lt(other: DecimalLike): boolean;
     /**
      * Return `true` if this value is less than or equal to `other`.
      * @public
      */
-    lte(other: Decimal): boolean;
+    lte(other: DecimalLike): boolean;
     /**
      * Return `true` if this value is strictly greater than `other`.
      * @public
      */
-    gt(other: Decimal): boolean;
+    gt(other: DecimalLike): boolean;
     /**
      * Return `true` if this value is greater than or equal to `other`.
      * @public
      */
-    gte(other: Decimal): boolean;
+    gte(other: DecimalLike): boolean;
     /**
      * Return `true` if this value is exactly zero.
      * @public
@@ -225,7 +230,7 @@ export interface Decimal {
      * Round this value to the specified precision.
      * @public
      */
-    round(direction: RoundDirection, options: DecimalRoundingOptions | keyof typeof DecimalRoundingPresets): Decimal;
+    round(direction: RoundDirection, options: keyof typeof DecimalRoundingPresets | DecimalRoundingOptions): Decimal;
     /**
      * Return the canonical string representation.
      * @public
@@ -246,17 +251,33 @@ export interface Decimal {
      * @public
      */
     toFixed(decimalPlaces: number, direction: RoundDirection): string;
+    /**
+     * Convert to an {@link (Integer:type)} by rounding.
+     * @public
+     */
+    toInteger(direction: RoundDirection): Integer;
     /**
      * Rejects implicit coercion; explicit `String(d)` and template literals still work.
      * @public
      */
-    [Symbol.toPrimitive](hint: 'default' | 'number' | 'string'): string;
+    [Symbol.toPrimitive](hint: 'string' | 'number' | 'default'): string;
     /**
      * Returns the string representation; invoked by the JavaScript engine as a fallback coercion path.
      * @public
      */
     valueOf(): string;
 }
+/**
+ * Values that can be coerced to a `Decimal` via `Decimal.from()`.
+ *
+ * @remarks
+ * This union is accepted by `Decimal.from()` and by all arithmetic and
+ * comparison methods on `Decimal` instances. Non-Decimal values are
+ * coerced via `Decimal.from()` before the operation.
+ *
+ * @public
+ */
+export type DecimalLike = string | number | bigint | Decimal | Integer;
 /**
  * Check whether a value is a `Decimal` instance.
  *
@@ -275,14 +296,21 @@ export interface Decimal {
  * @public
  */
 export declare function isDecimal(value: unknown): value is Decimal;
+/** @public */
+export interface DecimalCompanion {
+    /** Type guard: narrows `unknown` to `Decimal`. @public */
+    is(value: unknown): value is Decimal;
+    /** Assertion guard: throws if not a `Decimal`. @public */
+    assert(value: unknown): asserts value is Decimal;
+    /** Create a Decimal from a {@link DecimalLike} value. @public */
+    from(value: DecimalLike): Decimal;
+    /** The Decimal value `0`. @public */
+    readonly zero: Decimal;
+}
 /**
  * Companion object for creating `Decimal` instances.
  *
  * @public
  */
-export declare const Decimal: {
-    from(value: bigint | number | string): Decimal;
-    zero: Decimal;
-};
-export {};
+export declare const Decimal: DecimalCompanion;
 //# sourceMappingURL=decimal.d.ts.map

package/dist/stdlib/decimal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decimal.d.ts","sourceRoot":"","sources":["../../src/stdlib/decimal.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"decimal.d.ts","sourceRoot":"","sources":["../../src/stdlib/decimal.ts"],"names":[],"mappings":"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"}