@stripe/extensibility-sdk 0.25.0 → 0.26.0

package/dist/extensibility-sdk-stdlib-internal.d.ts

@@ -25,7 +25,7 @@ export declare const __brand: '__brand';
  *
  * 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]`.
+ * types (e.g., `Ref`) that also carry `[__brand]`.
  *
  * String-literal const (not `unique symbol`) so that independent
  * declaration rollups (root vs subpath) produce structurally compatible
@@ -567,25 +567,6 @@ export declare interface IntegerCompanion {
  */
 export declare type IntegerRoundDirection = 'ceil' | 'floor' | 'half-up' | 'round-down' | 'round-up';
 
-/**
- * Check whether a value is a `Decimal` instance.
- *
- * @remarks
- * Use this instead of `instanceof` — the underlying class is not
- * publicly exported, so `instanceof` checks are not available to
- * consumers.
- *
- * @example
- * ```ts
- * if (isDecimal(value)) {
- *   value.add(Decimal.from('1')); // value is Decimal
- * }
- * ```
- *
- * @public
- */
-export declare function isDecimal(value: unknown): value is Decimal;
-
 /**
  * Returns `true` if `value` conforms to the `PromiseLike` contract:
  * a non-null object or function with a callable `then` method.
@@ -768,7 +749,7 @@ export declare const Ref: { create: <T extends { readonly object: string }>(step
 /**
  * Wraps a transformer so that a `null` / `undefined` result throws
  * `WireParseError('Required field is missing')`, which `strategy.applyField`
- * will catch and re-throw as WireReadError / WireWriteError with field context.
+ * will catch and re-throw as _WireReadError / _WireWriteError with field context.
  *
  * The inner transformer runs first, so strategies that backfill absent values
  * (e.g. clock-aware `translateDateTime`) can satisfy the requirement.
@@ -815,27 +796,9 @@ export declare class _ShapeDescriptor<_S extends _ApplyStrategy = _ApplyStrategy
     constructor(typeName: string, fields: _FieldDescriptor[], oneofFields?: _OneofFieldDescriptor[]);
 }
 
-/** A branded string representing a street address. @public */
-export declare 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 };
-
 /** The type of the opaque Stripe type-tag key used in SDK scalar types. @public */
 export declare type StripeTypeSymbol = typeof __stripeType;
 
-/** A branded string representing an ISO 8601 datetime. @public */
-export declare 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 };
-
 /**
  * Deep-freezes `value` and returns it typed as {@link DeepReadonly}`<T>`.
  *
@@ -980,9 +943,9 @@ export declare class _UnionDescriptor<_S extends _ApplyStrategy = _ApplyStrategy
  * Indicates malformed or unexpected data from the proto infrastructure —
  * not a bug in the user's code.
  *
- * @public
+ * @internal
  */
-export declare class WireReadError extends Error {
+export declare class _WireReadError extends Error {
     /**
      * Error class name for `instanceof`-free identification.
      * @internal
@@ -995,9 +958,9 @@ export declare class WireReadError extends Error {
  * Indicates that the user's code returned a value that cannot be translated
  * back to wire format.
  *
- * @public
+ * @internal
  */
-export declare class WireWriteError extends Error {
+export declare class _WireWriteError extends Error {
     /**
      * Error class name for `instanceof`-free identification.
      * @internal

package/dist/extensibility-sdk-stdlib-public.d.ts

@@ -404,25 +404,6 @@ export declare interface IntegerCompanion {
  */
 export declare type IntegerRoundDirection = 'ceil' | 'floor' | 'half-up' | 'round-down' | 'round-up';
 
-/**
- * Check whether a value is a `Decimal` instance.
- *
- * @remarks
- * Use this instead of `instanceof` — the underlying class is not
- * publicly exported, so `instanceof` checks are not available to
- * consumers.
- *
- * @example
- * ```ts
- * if (isDecimal(value)) {
- *   value.add(Decimal.from('1')); // value is Decimal
- * }
- * ```
- *
- * @public
- */
-export declare function isDecimal(value: unknown): value is Decimal;
-
 /* Excluded from this release type: _isPromiseLike */
 
 /* Excluded from this release type: _JsonWireToType */
@@ -544,27 +525,9 @@ export declare type RoundDirection = 'ceil' | 'floor' | 'half-down' | 'half-even
 
 /* Excluded from this release type: _ShapeDescriptor */
 
-/** A branded string representing a street address. @public */
-export declare 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 };
-
 /** The type of the opaque Stripe type-tag key used in SDK scalar types. @public */
 export declare type StripeTypeSymbol = typeof __stripeType;
 
-/** A branded string representing an ISO 8601 datetime. @public */
-export declare 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 };
-
 /**
  * Deep-freezes `value` and returns it typed as {@link DeepReadonly}`<T>`.
  *
@@ -609,30 +572,8 @@ export declare function toConst<T>(value: T): DeepReadonly<T>;
 
 /* Excluded from this release type: _UnionDescriptor */
 
-/**
- * Shared types and error classes for the transform pipeline.
- * See transforms.ts for the module overview.
- */
-/**
- * Thrown when incoming wire data (proto → SDK) cannot be parsed.
- * Indicates malformed or unexpected data from the proto infrastructure —
- * not a bug in the user's code.
- *
- * @public
- */
-export declare class WireReadError extends Error {
-    /* Excluded from this release type: name */
-}
+/* Excluded from this release type: _WireReadError */
 
-/**
- * Thrown when outgoing SDK data (SDK → proto) cannot be serialized.
- * Indicates that the user's code returned a value that cannot be translated
- * back to wire format.
- *
- * @public
- */
-export declare class WireWriteError extends Error {
-    /* Excluded from this release type: name */
-}
+/* Excluded from this release type: _WireWriteError */
 
 export { }

package/dist/index.cjs

@@ -29,10 +29,6 @@ __export(src_exports, {
   Integer: () => Integer,
   PositiveInteger: () => PositiveInteger,
   Ref: () => Ref,
-  StreetAddress: () => StreetAddress,
-  Timestamp: () => Timestamp,
-  WireReadError: () => WireReadError,
-  WireWriteError: () => WireWriteError,
   _ConfigEnum: () => _ConfigEnum,
   _JsonWireToType: () => _JsonWireToType,
   _ProtoEnum: () => _ProtoEnum,
@@ -40,6 +36,8 @@ __export(src_exports, {
   _ShapeDescriptor: () => _ShapeDescriptor,
   _TypeToProtoWire: () => _TypeToProtoWire,
   _UnionDescriptor: () => _UnionDescriptor,
+  _WireReadError: () => _WireReadError,
+  _WireWriteError: () => _WireWriteError,
   _apply: () => _apply,
   _applyConfig: () => _applyConfig,
   _applyIncoming: () => _applyIncoming,
@@ -55,7 +53,6 @@ __export(src_exports, {
   _translateMap: () => _translateMap,
   _translateShape: () => _translateShape,
   _translateUnion: () => _translateUnion,
-  isDecimal: () => isDecimal,
   toConst: () => toConst
 });
 module.exports = __toCommonJS(src_exports);
@@ -1164,16 +1161,6 @@ var PositiveInteger = {
     return normalized;
   }
 };
-var StreetAddress = {
-  create: (address) => {
-    return address;
-  }
-};
-var Timestamp = {
-  create: (value) => {
-    return value;
-  }
-};
 
 // src/stdlib/refs.ts
 var Ref = {
@@ -1186,19 +1173,19 @@ var Ref = {
 };
 
 // src/stdlib/types.ts
-var WireReadError = class extends Error {
+var _WireReadError = class extends Error {
   /**
    * Error class name for `instanceof`-free identification.
    * @internal
    */
-  name = "WireReadError";
+  name = "_WireReadError";
 };
-var WireWriteError = class extends Error {
+var _WireWriteError = class extends Error {
   /**
    * Error class name for `instanceof`-free identification.
    * @internal
    */
-  name = "WireWriteError";
+  name = "_WireWriteError";
 };
 var WireParseError = class extends Error {
   name = "WireParseError";
@@ -1405,7 +1392,7 @@ function enumLookup(spec, value, direction) {
 var _ProtoWireToType = {
   _brand: "ProtoWireToType",
   createNotObjectError(loc, received) {
-    return new WireReadError(`${loc}: Expected an object but received ${received}`);
+    return new _WireReadError(`${loc}: Expected an object but received ${received}`);
   },
   applyField(typeName, desc, input, strategy) {
     const from = desc.wire ?? desc.type;
@@ -1415,7 +1402,7 @@ var _ProtoWireToType = {
       return [to, (desc.transform ?? _identity)(strategy, raw)];
     } catch (e) {
       if (e instanceof WireParseError)
-        throw new WireReadError(`${typeName}.${desc.type}: ${e.message}`);
+        throw new _WireReadError(`${typeName}.${desc.type}: ${e.message}`);
       throw e;
     }
   },
@@ -1470,7 +1457,7 @@ var _ProtoWireToType = {
       }
     }
     const loc = descriptor.typeName || "union";
-    throw new WireReadError(`${loc}: No variant set`);
+    throw new _WireReadError(`${loc}: No variant set`);
   },
   applyOneofField(typeName, oneof, input, strategy, result, excludeWireKeys) {
     applyOneofFieldIncoming(typeName, oneof, input, strategy, result, excludeWireKeys);
@@ -1479,7 +1466,7 @@ var _ProtoWireToType = {
 var _TypeToProtoWire = {
   _brand: "TypeToProtoWire",
   createNotObjectError(loc, received) {
-    return new WireWriteError(`${loc}: Expected an object but received ${received}`);
+    return new _WireWriteError(`${loc}: Expected an object but received ${received}`);
   },
   applyField(typeName, desc, input, strategy) {
     const from = desc.type;
@@ -1489,7 +1476,7 @@ var _TypeToProtoWire = {
       return [to, (desc.transform ?? _identity)(strategy, raw)];
     } catch (e) {
       if (e instanceof WireParseError)
-        throw new WireWriteError(`${typeName}.${desc.type}: ${e.message}`);
+        throw new _WireWriteError(`${typeName}.${desc.type}: ${e.message}`);
       throw e;
     }
   },
@@ -1529,20 +1516,20 @@ var _TypeToProtoWire = {
     const discriminant = sdk[descriptor.discriminantFieldName];
     if (typeof discriminant !== "string") {
       const loc = descriptor.typeName || "union";
-      throw new WireWriteError(
+      throw new _WireWriteError(
         `${loc}: Expected a string '${descriptor.discriminantFieldName}' discriminant but received ${discriminant === void 0 ? "undefined" : typeof discriminant}`
       );
     }
     if (discriminant === "other") {
       const loc = descriptor.typeName || "union";
-      throw new WireWriteError(
+      throw new _WireWriteError(
         `${loc}: Cannot serialize 'other' variant back to wire format`
       );
     }
     const branch = descriptor.branches.find((b) => b.typeKey === discriminant);
     if (!branch) {
       const loc = descriptor.typeName || "union";
-      throw new WireWriteError(`${loc}: Unknown variant '${discriminant}'`);
+      throw new _WireWriteError(`${loc}: Unknown variant '${discriminant}'`);
     }
     const branchData = _apply(
       new _ShapeDescriptor(descriptor.typeName, branch.shape),
@@ -1571,7 +1558,7 @@ function _configAppContextFromContext(ctx) {
 var _JsonWireToType = {
   _brand: "JsonWireToType",
   createNotObjectError(loc, received) {
-    return new WireReadError(`${loc}: Expected an object but received ${received}`);
+    return new _WireReadError(`${loc}: Expected an object but received ${received}`);
   },
   applyField(typeName, desc, input, strategy) {
     const key = desc.type;
@@ -1580,7 +1567,7 @@ var _JsonWireToType = {
       return [key, (desc.transform ?? _identity)(strategy, raw)];
     } catch (e) {
       if (e instanceof WireParseError)
-        throw new WireReadError(`${typeName}.${desc.type}: ${e.message}`);
+        throw new _WireReadError(`${typeName}.${desc.type}: ${e.message}`);
       throw e;
     }
   },
@@ -1635,7 +1622,7 @@ function applyOneofFieldIncoming(typeName, oneof, input, strategy, result, exclu
         }
       } catch (e) {
         if (e instanceof WireParseError) {
-          throw new WireReadError(
+          throw new _WireReadError(
             `${typeName}.${oneof.discriminant}(${branch.typeKey}): ${e.message}`
           );
         }
@@ -1653,30 +1640,30 @@ function applyOneofFieldIncoming(typeName, oneof, input, strategy, result, exclu
     }
   }
   if (!oneof.optional) {
-    throw new WireReadError(`${typeName}.${oneof.discriminant}: no variant set`);
+    throw new _WireReadError(`${typeName}.${oneof.discriminant}: no variant set`);
   }
 }
 function applyOneofFieldOutgoing(typeName, oneof, input, strategy, result) {
   const discriminant = Object.hasOwn(input, oneof.discriminant) ? input[oneof.discriminant] : void 0;
   if (discriminant === void 0 || discriminant === null) {
     if (!oneof.optional) {
-      throw new WireWriteError(`${typeName}.${oneof.discriminant}: no variant set`);
+      throw new _WireWriteError(`${typeName}.${oneof.discriminant}: no variant set`);
     }
     return;
   }
   if (typeof discriminant !== "string") {
-    throw new WireWriteError(
+    throw new _WireWriteError(
       `${typeName}.${oneof.discriminant}: expected string discriminant but received ${typeof discriminant}`
     );
   }
   if (discriminant === "other") {
-    throw new WireWriteError(
+    throw new _WireWriteError(
       `${typeName}.${oneof.discriminant}: cannot serialize 'other' variant back to wire format`
     );
   }
   const branch = oneof.branches.find((b) => b.typeKey === discriminant);
   if (!branch) {
-    throw new WireWriteError(
+    throw new _WireWriteError(
       `${typeName}.${oneof.discriminant}: unknown variant '${discriminant}'`
     );
   }
@@ -1686,7 +1673,7 @@ function applyOneofFieldOutgoing(typeName, oneof, input, strategy, result) {
     result[branch.wireKey] = transformed ?? {};
   } catch (e) {
     if (e instanceof WireParseError) {
-      throw new WireWriteError(
+      throw new _WireWriteError(
         `${typeName}.${oneof.discriminant}(${branch.typeKey}): ${e.message}`
       );
     }
@@ -4056,10 +4043,6 @@ var CustomAction2;
   Integer,
   PositiveInteger,
   Ref,
-  StreetAddress,
-  Timestamp,
-  WireReadError,
-  WireWriteError,
   _ConfigEnum,
   _JsonWireToType,
   _ProtoEnum,
@@ -4067,6 +4050,8 @@ var CustomAction2;
   _ShapeDescriptor,
   _TypeToProtoWire,
   _UnionDescriptor,
+  _WireReadError,
+  _WireWriteError,
   _apply,
   _applyConfig,
   _applyIncoming,
@@ -4082,6 +4067,5 @@ var CustomAction2;
   _translateMap,
   _translateShape,
   _translateUnion,
-  isDecimal,
   toConst
 });

package/dist/index.js

@@ -1108,16 +1108,6 @@ var PositiveInteger = {
     return normalized;
   }
 };
-var StreetAddress = {
-  create: (address) => {
-    return address;
-  }
-};
-var Timestamp = {
-  create: (value) => {
-    return value;
-  }
-};
 
 // src/stdlib/refs.ts
 var Ref = {
@@ -1130,19 +1120,19 @@ var Ref = {
 };
 
 // src/stdlib/types.ts
-var WireReadError = class extends Error {
+var _WireReadError = class extends Error {
   /**
    * Error class name for `instanceof`-free identification.
    * @internal
    */
-  name = "WireReadError";
+  name = "_WireReadError";
 };
-var WireWriteError = class extends Error {
+var _WireWriteError = class extends Error {
   /**
    * Error class name for `instanceof`-free identification.
    * @internal
    */
-  name = "WireWriteError";
+  name = "_WireWriteError";
 };
 var WireParseError = class extends Error {
   name = "WireParseError";
@@ -1349,7 +1339,7 @@ function enumLookup(spec, value, direction) {
 var _ProtoWireToType = {
   _brand: "ProtoWireToType",
   createNotObjectError(loc, received) {
-    return new WireReadError(`${loc}: Expected an object but received ${received}`);
+    return new _WireReadError(`${loc}: Expected an object but received ${received}`);
   },
   applyField(typeName, desc, input, strategy) {
     const from = desc.wire ?? desc.type;
@@ -1359,7 +1349,7 @@ var _ProtoWireToType = {
       return [to, (desc.transform ?? _identity)(strategy, raw)];
     } catch (e) {
       if (e instanceof WireParseError)
-        throw new WireReadError(`${typeName}.${desc.type}: ${e.message}`);
+        throw new _WireReadError(`${typeName}.${desc.type}: ${e.message}`);
       throw e;
     }
   },
@@ -1414,7 +1404,7 @@ var _ProtoWireToType = {
       }
     }
     const loc = descriptor.typeName || "union";
-    throw new WireReadError(`${loc}: No variant set`);
+    throw new _WireReadError(`${loc}: No variant set`);
   },
   applyOneofField(typeName, oneof, input, strategy, result, excludeWireKeys) {
     applyOneofFieldIncoming(typeName, oneof, input, strategy, result, excludeWireKeys);
@@ -1423,7 +1413,7 @@ var _ProtoWireToType = {
 var _TypeToProtoWire = {
   _brand: "TypeToProtoWire",
   createNotObjectError(loc, received) {
-    return new WireWriteError(`${loc}: Expected an object but received ${received}`);
+    return new _WireWriteError(`${loc}: Expected an object but received ${received}`);
   },
   applyField(typeName, desc, input, strategy) {
     const from = desc.type;
@@ -1433,7 +1423,7 @@ var _TypeToProtoWire = {
       return [to, (desc.transform ?? _identity)(strategy, raw)];
     } catch (e) {
       if (e instanceof WireParseError)
-        throw new WireWriteError(`${typeName}.${desc.type}: ${e.message}`);
+        throw new _WireWriteError(`${typeName}.${desc.type}: ${e.message}`);
       throw e;
     }
   },
@@ -1473,20 +1463,20 @@ var _TypeToProtoWire = {
     const discriminant = sdk[descriptor.discriminantFieldName];
     if (typeof discriminant !== "string") {
       const loc = descriptor.typeName || "union";
-      throw new WireWriteError(
+      throw new _WireWriteError(
         `${loc}: Expected a string '${descriptor.discriminantFieldName}' discriminant but received ${discriminant === void 0 ? "undefined" : typeof discriminant}`
       );
     }
     if (discriminant === "other") {
       const loc = descriptor.typeName || "union";
-      throw new WireWriteError(
+      throw new _WireWriteError(
         `${loc}: Cannot serialize 'other' variant back to wire format`
       );
     }
     const branch = descriptor.branches.find((b) => b.typeKey === discriminant);
     if (!branch) {
       const loc = descriptor.typeName || "union";
-      throw new WireWriteError(`${loc}: Unknown variant '${discriminant}'`);
+      throw new _WireWriteError(`${loc}: Unknown variant '${discriminant}'`);
     }
     const branchData = _apply(
       new _ShapeDescriptor(descriptor.typeName, branch.shape),
@@ -1515,7 +1505,7 @@ function _configAppContextFromContext(ctx) {
 var _JsonWireToType = {
   _brand: "JsonWireToType",
   createNotObjectError(loc, received) {
-    return new WireReadError(`${loc}: Expected an object but received ${received}`);
+    return new _WireReadError(`${loc}: Expected an object but received ${received}`);
   },
   applyField(typeName, desc, input, strategy) {
     const key = desc.type;
@@ -1524,7 +1514,7 @@ var _JsonWireToType = {
       return [key, (desc.transform ?? _identity)(strategy, raw)];
     } catch (e) {
       if (e instanceof WireParseError)
-        throw new WireReadError(`${typeName}.${desc.type}: ${e.message}`);
+        throw new _WireReadError(`${typeName}.${desc.type}: ${e.message}`);
       throw e;
     }
   },
@@ -1579,7 +1569,7 @@ function applyOneofFieldIncoming(typeName, oneof, input, strategy, result, exclu
         }
       } catch (e) {
         if (e instanceof WireParseError) {
-          throw new WireReadError(
+          throw new _WireReadError(
             `${typeName}.${oneof.discriminant}(${branch.typeKey}): ${e.message}`
           );
         }
@@ -1597,30 +1587,30 @@ function applyOneofFieldIncoming(typeName, oneof, input, strategy, result, exclu
     }
   }
   if (!oneof.optional) {
-    throw new WireReadError(`${typeName}.${oneof.discriminant}: no variant set`);
+    throw new _WireReadError(`${typeName}.${oneof.discriminant}: no variant set`);
   }
 }
 function applyOneofFieldOutgoing(typeName, oneof, input, strategy, result) {
   const discriminant = Object.hasOwn(input, oneof.discriminant) ? input[oneof.discriminant] : void 0;
   if (discriminant === void 0 || discriminant === null) {
     if (!oneof.optional) {
-      throw new WireWriteError(`${typeName}.${oneof.discriminant}: no variant set`);
+      throw new _WireWriteError(`${typeName}.${oneof.discriminant}: no variant set`);
     }
     return;
   }
   if (typeof discriminant !== "string") {
-    throw new WireWriteError(
+    throw new _WireWriteError(
       `${typeName}.${oneof.discriminant}: expected string discriminant but received ${typeof discriminant}`
     );
   }
   if (discriminant === "other") {
-    throw new WireWriteError(
+    throw new _WireWriteError(
       `${typeName}.${oneof.discriminant}: cannot serialize 'other' variant back to wire format`
     );
   }
   const branch = oneof.branches.find((b) => b.typeKey === discriminant);
   if (!branch) {
-    throw new WireWriteError(
+    throw new _WireWriteError(
       `${typeName}.${oneof.discriminant}: unknown variant '${discriminant}'`
     );
   }
@@ -1630,7 +1620,7 @@ function applyOneofFieldOutgoing(typeName, oneof, input, strategy, result) {
     result[branch.wireKey] = transformed ?? {};
   } catch (e) {
     if (e instanceof WireParseError) {
-      throw new WireWriteError(
+      throw new _WireWriteError(
         `${typeName}.${oneof.discriminant}(${branch.typeKey}): ${e.message}`
       );
     }
@@ -3999,10 +3989,6 @@ export {
   Integer,
   PositiveInteger,
   Ref,
-  StreetAddress,
-  Timestamp,
-  WireReadError,
-  WireWriteError,
   _ConfigEnum,
   _JsonWireToType,
   _ProtoEnum,
@@ -4010,6 +3996,8 @@ export {
   _ShapeDescriptor,
   _TypeToProtoWire,
   _UnionDescriptor,
+  _WireReadError,
+  _WireWriteError,
   _apply,
   _applyConfig,
   _applyIncoming,
@@ -4025,6 +4013,5 @@ export {
   _translateMap,
   _translateShape,
   _translateUnion,
-  isDecimal,
   toConst
 };

package/dist/stdlib/decimal.d.ts

@@ -5,7 +5,7 @@ import type { Integer } from './scalars.js';
  *
  * 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]`.
+ * types (e.g., `Ref`) that also carry `[__brand]`.
  *
  * String-literal const (not `unique symbol`) so that independent
  * declaration rollups (root vs subpath) produce structurally compatible