@stripe/extensibility-sdk 0.22.4 → 0.23.0

package/dist/stdlib/decimal.d.ts

@@ -29,7 +29,7 @@ declare const __decimalBrand: unique symbol;
  *
  * @public
  */
-export type RoundDirection = 'ceil' | 'floor' | 'round-down' | 'round-up' | 'half-up' | 'half-down' | 'half-even';
+export type RoundDirection = 'ceil' | 'floor' | 'half-down' | 'half-even' | 'half-up' | 'round-down' | 'round-up';
 /**
  * Precision specification for `Decimal.round()`.
  *
@@ -225,7 +225,7 @@ export interface Decimal {
      * Round this value to the specified precision.
      * @public
      */
-    round(direction: RoundDirection, options: keyof typeof DecimalRoundingPresets | DecimalRoundingOptions): Decimal;
+    round(direction: RoundDirection, options: DecimalRoundingOptions | keyof typeof DecimalRoundingPresets): Decimal;
     /**
      * Return the canonical string representation.
      * @public
@@ -250,7 +250,7 @@ export interface Decimal {
      * Rejects implicit coercion; explicit `String(d)` and template literals still work.
      * @public
      */
-    [Symbol.toPrimitive](hint: 'string' | 'number' | 'default'): string;
+    [Symbol.toPrimitive](hint: 'default' | 'number' | 'string'): string;
     /**
      * Returns the string representation; invoked by the JavaScript engine as a fallback coercion path.
      * @public
@@ -281,43 +281,7 @@ export declare function isDecimal(value: unknown): value is Decimal;
  * @public
  */
 export declare const Decimal: {
-    /**
-     * Create a `Decimal` from a string, number, or bigint.
-     *
-     * @remarks
-     * - **string**: Parsed as a decimal literal. Accepts an optional sign,
-     *   integer digits, an optional fractional part, and an optional `e`/`E`
-     *   exponent. Leading/trailing whitespace is trimmed.
-     * - **number**: Must be finite. Converted via `Number.prototype.toString()`
-     *   then parsed, so `Decimal.from(0.1)` produces `"0.1"` (not the
-     *   53-bit binary approximation).
-     * - **bigint**: Treated as an integer with exponent 0.
-     *
-     * @example
-     * ```ts
-     * Decimal.from('1.23');   // string
-     * Decimal.from(42);       // number
-     * Decimal.from(100n);     // bigint
-     * Decimal.from('1.5e3');  // scientific notation → 1500
-     * ```
-     *
-     * @param value - The value to convert.
-     * @returns A new frozen `Decimal` instance.
-     * @throws Error if `value` is a non-finite number, an empty
-     *   string, or a string that does not match the decimal literal grammar.
-     *
-     * @public
-     */
-    from(value: string | number | bigint): Decimal;
-    /**
-     * The `Decimal` value representing zero.
-     *
-     * @remarks
-     * Pre-allocated singleton — prefer `Decimal.zero` over
-     * `Decimal.from(0)` to avoid an unnecessary allocation.
-     *
-     * @public
-     */
+    from(value: bigint | number | string): Decimal;
     zero: Decimal;
 };
 export {};

package/dist/stdlib/refs.d.ts

@@ -20,23 +20,15 @@ export type Ref<T extends {
 } = {
     readonly object: string;
 }> = {
-    /** The object tag of the referenced resource (e.g., "v2.core.customer"). */
-    type: ExtractObjectTag<T>;
-    /** The ID of the referenced resource. */
     id: string;
+    type: ExtractObjectTag<T>;
 } & {
-    readonly [__brand]: 'Ref';
     readonly __type?: T;
+    readonly [__brand]: 'Ref';
     readonly [__stripeType]: 'string';
 };
 /** Factory for creating {@link (Ref:type)} values from an object with `object` and `id` fields. @public */
-export declare const Ref: {
-    create: <T extends {
-        readonly object: string;
-    }>(step: T & {
-        readonly id: string;
-    }) => Ref<T>;
-};
+export declare const Ref: { create: <T extends { readonly object: string }>(step: { readonly id: string } & T) => Ref<T> };
 /**
  * A paginated list of references to objects of type T.
  *
@@ -46,17 +38,11 @@ export type PaginatedRefList<T extends {
     readonly object: string;
 } = {
     readonly object: string;
-}> = Ref<T>[] & {
-    readonly [__brand]: 'PaginatedRefList';
+}> = {
     readonly __type?: T;
+    readonly [__brand]: 'PaginatedRefList';
     readonly [__stripeType]: `list<${Ref<T>[StripeTypeSymbol]}>`;
-};
+} & Ref<T>[];
 /** Factory for creating {@link PaginatedRefList} values from an array of {@link Ref} items. @public */
-export declare const PaginatedRefList: {
-    create: <T extends {
-        readonly object: string;
-    } = {
-        readonly object: string;
-    }>(items?: Ref<T>[]) => PaginatedRefList<T>;
-};
+export declare const PaginatedRefList: { create: <T extends { readonly object: string } = { readonly object: string }>(items?: Ref<T>[]) => PaginatedRefList<T> };
 //# sourceMappingURL=refs.d.ts.map

package/dist/stdlib/scalars.d.ts

@@ -1,19 +1,17 @@
 import { type __integerBrand } from '@formspec/core';
 import { type __brand, type __stripeType } from './brand.js';
 /** A branded object type representing a JSON map (`map<string>`) in the Stripe type system. @public */
-export type JsonObject = object & {
+export type JsonObject = {
     readonly [__brand]: 'JsonObject';
     readonly [__stripeType]: 'map<string>';
-};
+} & object;
 /** Factory for creating {@link JsonObject} branded values. @public */
-export declare const JsonObject: {
-    create: (value: object) => JsonObject;
-};
+export declare const JsonObject: { create: (value: object) => JsonObject };
 /** A branded integer — a `number` guaranteed to satisfy `Number.isInteger`. @public */
-export type Integer = number & {
+export type Integer = {
     readonly [__integerBrand]: true;
     readonly [__stripeType]: 'int';
-};
+} & number;
 /**
  * Distinct brand for PositiveInteger so an Integer is not assignable to
  * PositiveInteger without going through the guard. PositiveInteger is a
@@ -39,11 +37,11 @@ declare const __positiveIntegerBrand: unique symbol;
  *
  * @public
  */
-export type PositiveInteger = number & {
+export type PositiveInteger = {
     readonly [__integerBrand]: true;
     readonly [__positiveIntegerBrand]: true;
     readonly [__stripeType]: 'int';
-};
+} & number;
 /**
  * Rounding directions for coercing a number to an integer.
  *
@@ -59,83 +57,30 @@ export type PositiveInteger = number & {
  *
  * @public
  */
-export type IntegerRoundDirection = 'ceil' | 'floor' | 'round-down' | 'round-up' | 'half-up';
+export type IntegerRoundDirection = 'ceil' | 'floor' | 'half-up' | 'round-down' | 'round-up';
 /** Factory and type guard for {@link (Integer:type)} branded values. @public */
 export declare const Integer: {
-    /**
-     * Type guard that narrows a `number` to {@link (Integer:type)}.
-     *
-     * @example
-     * ```ts
-     * const n: number = getCount();
-     * if (Integer.is(n)) {
-     *   // n is Integer here
-     *   config.retryCount = n;
-     * }
-     * ```
-     * @public
-     */
-    is: (value: number) => value is Integer;
-    /**
-     * Coerces a number to an {@link (Integer:type)} by rounding.
-     * Throws if the value is not finite.
-     *
-     * @example
-     * ```ts
-     * const price = 9.99;
-     * const rounded = Integer.from(price, 'floor'); // 9
-     * const ceiled = Integer.from(price, 'ceil');   // 10
-     * ```
-     * @public
-     */
     from: (value: number, rounding: IntegerRoundDirection) => Integer;
+    is: (value: number) => value is Integer;
 };
 /** Factory and type guard for {@link (PositiveInteger:type)} branded values. @public */
 export declare const PositiveInteger: {
-    /**
-     * Type guard that narrows a `number` to {@link (PositiveInteger:type)}.
-     *
-     * @example
-     * ```ts
-     * const n: number = getRetryCount();
-     * if (PositiveInteger.is(n)) {
-     *   // n is PositiveInteger here
-     *   config.maxRetries = n;
-     * }
-     * ```
-     * @public
-     */
-    is: (value: number) => value is PositiveInteger;
-    /**
-     * Coerces a number to a {@link (PositiveInteger:type)} by rounding.
-     * Throws if the value is not finite or the rounded result is negative.
-     *
-     * @example
-     * ```ts
-     * const ratio = 2.7;
-     * const count = PositiveInteger.from(ratio, 'floor'); // 2
-     * ```
-     * @public
-     */
     from: (value: number, rounding: IntegerRoundDirection) => PositiveInteger;
+    is: (value: number) => value is PositiveInteger;
 };
 /** A branded string representing a street address. @public */
-export type StreetAddress = string & {
+export type StreetAddress = {
     readonly [__brand]: 'StreetAddress';
     readonly [__stripeType]: 'string';
-};
+} & string;
 /** Factory for creating {@link (StreetAddress:type)} branded values. @public */
-export declare const StreetAddress: {
-    create: (address: string) => StreetAddress;
-};
+export declare const StreetAddress: { create: (address: string) => StreetAddress };
 /** A branded string representing an ISO 8601 datetime. @public */
-export type Timestamp = string & {
+export type Timestamp = {
     readonly [__brand]: 'Timestamp';
     readonly [__stripeType]: 'string';
-};
+} & string;
 /** Factory for creating {@link (Timestamp:type)} branded values. @public */
-export declare const Timestamp: {
-    create: (value: string) => Timestamp;
-};
+export declare const Timestamp: { create: (value: string) => Timestamp };
 export {};
 //# sourceMappingURL=scalars.d.ts.map

package/dist/stdlib/type-utils.d.ts

@@ -3,7 +3,5 @@
  *
  * @public
  */
-export type ExtractObjectTag<T> = T extends {
-    readonly object: infer O;
-} ? O extends string ? O : never : never;
+export type ExtractObjectTag<T> = T extends { readonly object: infer O } ? O extends string ? O : never : never;
 //# sourceMappingURL=type-utils.d.ts.map

package/dist/stdlib/types.d.ts

@@ -52,12 +52,12 @@ export interface _EnumSpec {
      * Convert a wire value to an SDK value, or `null` if unknown.
      * @internal
      */
-    fromWire(value: string): string | null;
+    fromWire(value: string): null | string;
     /**
      * Convert an SDK value to a wire value, or `null` if unknown.
      * @internal
      */
-    toWire(value: string): string | null;
+    toWire(value: string): null | string;
 }
 /**
  * Bidirectional enum spec for proto-backed enums. Accepts a single
@@ -74,12 +74,12 @@ export declare class _ProtoEnum implements _EnumSpec {
      * Convert a proto wire value to an SDK value, or `null` if unknown.
      * @internal
      */
-    fromWire(value: string): string | null;
+    fromWire(value: string): null | string;
     /**
      * Convert an SDK value to a proto wire value, or `null` if unknown.
      * @internal
      */
-    toWire(value: string): string | null;
+    toWire(value: string): null | string;
 }
 /**
  * Validation-only enum spec for config values. Accepts a set of known
@@ -95,12 +95,12 @@ export declare class _ConfigEnum implements _EnumSpec {
      * Validate and return the wire value unchanged, or `null` if unknown.
      * @internal
      */
-    fromWire(value: string): string | null;
+    fromWire(value: string): null | string;
     /**
      * Validate and return the SDK value unchanged, or `null` if unknown.
      * @internal
      */
-    toWire(value: string): string | null;
+    toWire(value: string): null | string;
 }
 /**
  * A field transformer with the strategy threaded through so transforms can