@stripe/extensibility-sdk 0.27.1 → 1.0.1

package/dist/extensibility-sdk-alpha.d.ts

@@ -1054,13 +1054,13 @@ declare namespace InvoiceCollectionOptions {
     } | {
         otherPayer: string;
         payer: 'other';
-    }) & ({
+    } | { payer?: never }) & ({
         invoiceParentType: 'other';
         otherInvoiceParentType: string;
     } | {
         invoiceParentType: 'subscription';
         subscription: SubscriptionParent;
-    } | { invoiceParentType: 'cadence' } | { invoiceParentType: 'contract' } | { invoiceParentType: 'quote' } | { invoiceParentType: 'schedule' }) & { collectionOptions: CollectionOptions };
+    } | { invoiceParentType: 'cadence' } | { invoiceParentType: 'contract' } | { invoiceParentType: 'quote' } | { invoiceParentType: 'schedule' } | { invoiceParentType?: never }) & { collectionOptions: CollectionOptions };
     /** @public */
     interface Customer {
         id: string;
@@ -1124,7 +1124,29 @@ declare namespace InvoiceCollectionOptions {
     type OverrideOptionsFunction<Config> = (request: InvoiceCollectionOptionsInput, config: Config, context: Context) => InvoiceCollectionOptionsResult;
 }
 
-/** @public */
+/**
+ * @example
+ * ```ts
+ * import type { Billing, Context } from '@stripe/extensibility-sdk';
+ *
+ * // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ * interface MyInvoiceCollectionOptionsConfig {}
+ *
+ * export default class MyInvoiceCollectionOptions implements Billing.InvoiceCollectionOptions<MyInvoiceCollectionOptionsConfig> {
+ *   overrideOptions(
+ *     _request: Billing.InvoiceCollectionOptions.InvoiceCollectionOptionsInput,
+ *     _config: MyInvoiceCollectionOptionsConfig,
+ *     _context: Context
+ *   ) {
+ *     // TODO: implement your collection setting logic here
+ *
+ *     return {};
+ *   }
+ * }
+ *
+ * ```
+ * @public
+ */
 declare interface InvoiceCollectionOptions<Config> {
     overrideOptions: InvoiceCollectionOptions.OverrideOptionsFunction<Config>;
 }
@@ -1264,7 +1286,7 @@ declare namespace Prorations {
     } | {
         priceKind: 'rateCardRate';
         rateCardRate: RateCardRate;
-    }) & {
+    } | { priceKind?: never }) & {
         correspondingDebit?: PreviousDebit;
         currentProrationFactor: Decimal;
         isProration: boolean;
@@ -1480,7 +1502,7 @@ declare namespace RecurringBillingItemHandling {
     } | {
         creditedItems: 'other';
         otherCreditedItems: string;
-    }) & ({
+    } | { creditedItems?: never }) & ({
         customPricingUnitOverageRate: CustomPricingUnitOverageRate;
         priceKind: 'customPricingUnitOverageRate';
     } | {
@@ -1495,7 +1517,7 @@ declare namespace RecurringBillingItemHandling {
     } | {
         priceKind: 'rateCardRate';
         rateCardRate: RateCardRate;
-    }) & {
+    } | { priceKind?: never }) & {
         isProration: boolean;
         key: string;
         prorationFactor: Decimal;
@@ -1650,7 +1672,7 @@ declare namespace RecurringBillingItemHandling {
     type ItemWithCreationStrategy = ({
         creationStrategy: 'other';
         otherCreationStrategy: string;
-    } | { creationStrategy: 'doNotCreate' } | { creationStrategy: 'invoice' }) & { key: string };
+    } | { creationStrategy: 'doNotCreate' } | { creationStrategy: 'invoice' } | { creationStrategy?: never }) & { key: string };
     /** @public */
     type Invoice = Record<string, never>;
     /** @public */

package/dist/extensibility-sdk-beta.d.ts

@@ -1054,13 +1054,13 @@ declare namespace InvoiceCollectionOptions {
     } | {
         otherPayer: string;
         payer: 'other';
-    }) & ({
+    } | { payer?: never }) & ({
         invoiceParentType: 'other';
         otherInvoiceParentType: string;
     } | {
         invoiceParentType: 'subscription';
         subscription: SubscriptionParent;
-    } | { invoiceParentType: 'cadence' } | { invoiceParentType: 'contract' } | { invoiceParentType: 'quote' } | { invoiceParentType: 'schedule' }) & { collectionOptions: CollectionOptions };
+    } | { invoiceParentType: 'cadence' } | { invoiceParentType: 'contract' } | { invoiceParentType: 'quote' } | { invoiceParentType: 'schedule' } | { invoiceParentType?: never }) & { collectionOptions: CollectionOptions };
     /** @public */
     interface Customer {
         id: string;
@@ -1124,7 +1124,29 @@ declare namespace InvoiceCollectionOptions {
     type OverrideOptionsFunction<Config> = (request: InvoiceCollectionOptionsInput, config: Config, context: Context) => InvoiceCollectionOptionsResult;
 }
 
-/** @public */
+/**
+ * @example
+ * ```ts
+ * import type { Billing, Context } from '@stripe/extensibility-sdk';
+ *
+ * // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ * interface MyInvoiceCollectionOptionsConfig {}
+ *
+ * export default class MyInvoiceCollectionOptions implements Billing.InvoiceCollectionOptions<MyInvoiceCollectionOptionsConfig> {
+ *   overrideOptions(
+ *     _request: Billing.InvoiceCollectionOptions.InvoiceCollectionOptionsInput,
+ *     _config: MyInvoiceCollectionOptionsConfig,
+ *     _context: Context
+ *   ) {
+ *     // TODO: implement your collection setting logic here
+ *
+ *     return {};
+ *   }
+ * }
+ *
+ * ```
+ * @public
+ */
 declare interface InvoiceCollectionOptions<Config> {
     overrideOptions: InvoiceCollectionOptions.OverrideOptionsFunction<Config>;
 }
@@ -1264,7 +1286,7 @@ declare namespace Prorations {
     } | {
         priceKind: 'rateCardRate';
         rateCardRate: RateCardRate;
-    }) & {
+    } | { priceKind?: never }) & {
         correspondingDebit?: PreviousDebit;
         currentProrationFactor: Decimal;
         isProration: boolean;
@@ -1480,7 +1502,7 @@ declare namespace RecurringBillingItemHandling {
     } | {
         creditedItems: 'other';
         otherCreditedItems: string;
-    }) & ({
+    } | { creditedItems?: never }) & ({
         customPricingUnitOverageRate: CustomPricingUnitOverageRate;
         priceKind: 'customPricingUnitOverageRate';
     } | {
@@ -1495,7 +1517,7 @@ declare namespace RecurringBillingItemHandling {
     } | {
         priceKind: 'rateCardRate';
         rateCardRate: RateCardRate;
-    }) & {
+    } | { priceKind?: never }) & {
         isProration: boolean;
         key: string;
         prorationFactor: Decimal;
@@ -1650,7 +1672,7 @@ declare namespace RecurringBillingItemHandling {
     type ItemWithCreationStrategy = ({
         creationStrategy: 'other';
         otherCreationStrategy: string;
-    } | { creationStrategy: 'doNotCreate' } | { creationStrategy: 'invoice' }) & { key: string };
+    } | { creationStrategy: 'doNotCreate' } | { creationStrategy: 'invoice' } | { creationStrategy?: never }) & { key: string };
     /** @public */
     type Invoice = Record<string, never>;
     /** @public */

package/dist/extensibility-sdk-extensions-alpha.d.ts

@@ -985,13 +985,13 @@ declare namespace InvoiceCollectionOptions {
     } | {
         otherPayer: string;
         payer: 'other';
-    }) & ({
+    } | { payer?: never }) & ({
         invoiceParentType: 'other';
         otherInvoiceParentType: string;
     } | {
         invoiceParentType: 'subscription';
         subscription: SubscriptionParent;
-    } | { invoiceParentType: 'cadence' } | { invoiceParentType: 'contract' } | { invoiceParentType: 'quote' } | { invoiceParentType: 'schedule' }) & { collectionOptions: CollectionOptions };
+    } | { invoiceParentType: 'cadence' } | { invoiceParentType: 'contract' } | { invoiceParentType: 'quote' } | { invoiceParentType: 'schedule' } | { invoiceParentType?: never }) & { collectionOptions: CollectionOptions };
     /** @public */
     interface Customer {
         id: string;
@@ -1055,7 +1055,29 @@ declare namespace InvoiceCollectionOptions {
     type OverrideOptionsFunction<Config> = (request: InvoiceCollectionOptionsInput, config: Config, context: Context) => InvoiceCollectionOptionsResult;
 }
 
-/** @public */
+/**
+ * @example
+ * ```ts
+ * import type { Billing, Context } from '@stripe/extensibility-sdk';
+ *
+ * // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ * interface MyInvoiceCollectionOptionsConfig {}
+ *
+ * export default class MyInvoiceCollectionOptions implements Billing.InvoiceCollectionOptions<MyInvoiceCollectionOptionsConfig> {
+ *   overrideOptions(
+ *     _request: Billing.InvoiceCollectionOptions.InvoiceCollectionOptionsInput,
+ *     _config: MyInvoiceCollectionOptionsConfig,
+ *     _context: Context
+ *   ) {
+ *     // TODO: implement your collection setting logic here
+ *
+ *     return {};
+ *   }
+ * }
+ *
+ * ```
+ * @public
+ */
 declare interface InvoiceCollectionOptions<Config> {
     overrideOptions: InvoiceCollectionOptions.OverrideOptionsFunction<Config>;
 }
@@ -1185,7 +1207,7 @@ declare namespace Prorations {
     } | {
         priceKind: 'rateCardRate';
         rateCardRate: RateCardRate;
-    }) & {
+    } | { priceKind?: never }) & {
         correspondingDebit?: PreviousDebit;
         currentProrationFactor: Decimal;
         isProration: boolean;
@@ -1395,7 +1417,7 @@ declare namespace RecurringBillingItemHandling {
     } | {
         creditedItems: 'other';
         otherCreditedItems: string;
-    }) & ({
+    } | { creditedItems?: never }) & ({
         customPricingUnitOverageRate: CustomPricingUnitOverageRate;
         priceKind: 'customPricingUnitOverageRate';
     } | {
@@ -1410,7 +1432,7 @@ declare namespace RecurringBillingItemHandling {
     } | {
         priceKind: 'rateCardRate';
         rateCardRate: RateCardRate;
-    }) & {
+    } | { priceKind?: never }) & {
         isProration: boolean;
         key: string;
         prorationFactor: Decimal;
@@ -1565,7 +1587,7 @@ declare namespace RecurringBillingItemHandling {
     type ItemWithCreationStrategy = ({
         creationStrategy: 'other';
         otherCreationStrategy: string;
-    } | { creationStrategy: 'doNotCreate' } | { creationStrategy: 'invoice' }) & { key: string };
+    } | { creationStrategy: 'doNotCreate' } | { creationStrategy: 'invoice' } | { creationStrategy?: never }) & { key: string };
     /** @public */
     type Invoice = Record<string, never>;
     /** @public */

package/dist/extensibility-sdk-extensions-beta.d.ts

@@ -985,13 +985,13 @@ declare namespace InvoiceCollectionOptions {
     } | {
         otherPayer: string;
         payer: 'other';
-    }) & ({
+    } | { payer?: never }) & ({
         invoiceParentType: 'other';
         otherInvoiceParentType: string;
     } | {
         invoiceParentType: 'subscription';
         subscription: SubscriptionParent;
-    } | { invoiceParentType: 'cadence' } | { invoiceParentType: 'contract' } | { invoiceParentType: 'quote' } | { invoiceParentType: 'schedule' }) & { collectionOptions: CollectionOptions };
+    } | { invoiceParentType: 'cadence' } | { invoiceParentType: 'contract' } | { invoiceParentType: 'quote' } | { invoiceParentType: 'schedule' } | { invoiceParentType?: never }) & { collectionOptions: CollectionOptions };
     /** @public */
     interface Customer {
         id: string;
@@ -1055,7 +1055,29 @@ declare namespace InvoiceCollectionOptions {
     type OverrideOptionsFunction<Config> = (request: InvoiceCollectionOptionsInput, config: Config, context: Context) => InvoiceCollectionOptionsResult;
 }
 
-/** @public */
+/**
+ * @example
+ * ```ts
+ * import type { Billing, Context } from '@stripe/extensibility-sdk';
+ *
+ * // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ * interface MyInvoiceCollectionOptionsConfig {}
+ *
+ * export default class MyInvoiceCollectionOptions implements Billing.InvoiceCollectionOptions<MyInvoiceCollectionOptionsConfig> {
+ *   overrideOptions(
+ *     _request: Billing.InvoiceCollectionOptions.InvoiceCollectionOptionsInput,
+ *     _config: MyInvoiceCollectionOptionsConfig,
+ *     _context: Context
+ *   ) {
+ *     // TODO: implement your collection setting logic here
+ *
+ *     return {};
+ *   }
+ * }
+ *
+ * ```
+ * @public
+ */
 declare interface InvoiceCollectionOptions<Config> {
     overrideOptions: InvoiceCollectionOptions.OverrideOptionsFunction<Config>;
 }
@@ -1185,7 +1207,7 @@ declare namespace Prorations {
     } | {
         priceKind: 'rateCardRate';
         rateCardRate: RateCardRate;
-    }) & {
+    } | { priceKind?: never }) & {
         correspondingDebit?: PreviousDebit;
         currentProrationFactor: Decimal;
         isProration: boolean;
@@ -1395,7 +1417,7 @@ declare namespace RecurringBillingItemHandling {
     } | {
         creditedItems: 'other';
         otherCreditedItems: string;
-    }) & ({
+    } | { creditedItems?: never }) & ({
         customPricingUnitOverageRate: CustomPricingUnitOverageRate;
         priceKind: 'customPricingUnitOverageRate';
     } | {
@@ -1410,7 +1432,7 @@ declare namespace RecurringBillingItemHandling {
     } | {
         priceKind: 'rateCardRate';
         rateCardRate: RateCardRate;
-    }) & {
+    } | { priceKind?: never }) & {
         isProration: boolean;
         key: string;
         prorationFactor: Decimal;
@@ -1565,7 +1587,7 @@ declare namespace RecurringBillingItemHandling {
     type ItemWithCreationStrategy = ({
         creationStrategy: 'other';
         otherCreationStrategy: string;
-    } | { creationStrategy: 'doNotCreate' } | { creationStrategy: 'invoice' }) & { key: string };
+    } | { creationStrategy: 'doNotCreate' } | { creationStrategy: 'invoice' } | { creationStrategy?: never }) & { key: string };
     /** @public */
     type Invoice = Record<string, never>;
     /** @public */

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

@@ -1025,13 +1025,13 @@ declare namespace InvoiceCollectionOptions {
     } | {
         otherPayer: string;
         payer: 'other';
-    }) & ({
+    } | { payer?: never }) & ({
         invoiceParentType: 'other';
         otherInvoiceParentType: string;
     } | {
         invoiceParentType: 'subscription';
         subscription: SubscriptionParent;
-    } | { invoiceParentType: 'cadence' } | { invoiceParentType: 'contract' } | { invoiceParentType: 'quote' } | { invoiceParentType: 'schedule' }) & { collectionOptions: CollectionOptions };
+    } | { invoiceParentType: 'cadence' } | { invoiceParentType: 'contract' } | { invoiceParentType: 'quote' } | { invoiceParentType: 'schedule' } | { invoiceParentType?: never }) & { collectionOptions: CollectionOptions };
     /** @public */
     interface Customer {
         id: string;
@@ -1096,7 +1096,29 @@ declare namespace InvoiceCollectionOptions {
     type OverrideOptionsFunction<Config> = (request: InvoiceCollectionOptionsInput, config: Config, context: Context) => InvoiceCollectionOptionsResult;
 }
 
-/** @public */
+/**
+ * @example
+ * ```ts
+ * import type { Billing, Context } from '@stripe/extensibility-sdk';
+ *
+ * // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ * interface MyInvoiceCollectionOptionsConfig {}
+ *
+ * export default class MyInvoiceCollectionOptions implements Billing.InvoiceCollectionOptions<MyInvoiceCollectionOptionsConfig> {
+ *   overrideOptions(
+ *     _request: Billing.InvoiceCollectionOptions.InvoiceCollectionOptionsInput,
+ *     _config: MyInvoiceCollectionOptionsConfig,
+ *     _context: Context
+ *   ) {
+ *     // TODO: implement your collection setting logic here
+ *
+ *     return {};
+ *   }
+ * }
+ *
+ * ```
+ * @public
+ */
 declare interface InvoiceCollectionOptions<Config> {
     overrideOptions: InvoiceCollectionOptions.OverrideOptionsFunction<Config>;
 }
@@ -1226,7 +1248,7 @@ declare namespace Prorations {
     } | {
         priceKind: 'rateCardRate';
         rateCardRate: RateCardRate;
-    }) & {
+    } | { priceKind?: never }) & {
         correspondingDebit?: PreviousDebit;
         currentProrationFactor: Decimal;
         isProration: boolean;
@@ -1437,7 +1459,7 @@ declare namespace RecurringBillingItemHandling {
     } | {
         creditedItems: 'other';
         otherCreditedItems: string;
-    }) & ({
+    } | { creditedItems?: never }) & ({
         customPricingUnitOverageRate: CustomPricingUnitOverageRate;
         priceKind: 'customPricingUnitOverageRate';
     } | {
@@ -1452,7 +1474,7 @@ declare namespace RecurringBillingItemHandling {
     } | {
         priceKind: 'rateCardRate';
         rateCardRate: RateCardRate;
-    }) & {
+    } | { priceKind?: never }) & {
         isProration: boolean;
         key: string;
         prorationFactor: Decimal;
@@ -1607,7 +1629,7 @@ declare namespace RecurringBillingItemHandling {
     type ItemWithCreationStrategy = ({
         creationStrategy: 'other';
         otherCreationStrategy: string;
-    } | { creationStrategy: 'doNotCreate' } | { creationStrategy: 'invoice' }) & { key: string };
+    } | { creationStrategy: 'doNotCreate' } | { creationStrategy: 'invoice' } | { creationStrategy?: never }) & { key: string };
     /** @public */
     type Invoice = Record<string, never>;
     /** @public */

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

@@ -985,13 +985,13 @@ declare namespace InvoiceCollectionOptions {
     } | {
         otherPayer: string;
         payer: 'other';
-    }) & ({
+    } | { payer?: never }) & ({
         invoiceParentType: 'other';
         otherInvoiceParentType: string;
     } | {
         invoiceParentType: 'subscription';
         subscription: SubscriptionParent;
-    } | { invoiceParentType: 'cadence' } | { invoiceParentType: 'contract' } | { invoiceParentType: 'quote' } | { invoiceParentType: 'schedule' }) & { collectionOptions: CollectionOptions };
+    } | { invoiceParentType: 'cadence' } | { invoiceParentType: 'contract' } | { invoiceParentType: 'quote' } | { invoiceParentType: 'schedule' } | { invoiceParentType?: never }) & { collectionOptions: CollectionOptions };
     /** @public */
     interface Customer {
         id: string;
@@ -1055,7 +1055,29 @@ declare namespace InvoiceCollectionOptions {
     type OverrideOptionsFunction<Config> = (request: InvoiceCollectionOptionsInput, config: Config, context: Context) => InvoiceCollectionOptionsResult;
 }
 
-/** @public */
+/**
+ * @example
+ * ```ts
+ * import type { Billing, Context } from '@stripe/extensibility-sdk';
+ *
+ * // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ * interface MyInvoiceCollectionOptionsConfig {}
+ *
+ * export default class MyInvoiceCollectionOptions implements Billing.InvoiceCollectionOptions<MyInvoiceCollectionOptionsConfig> {
+ *   overrideOptions(
+ *     _request: Billing.InvoiceCollectionOptions.InvoiceCollectionOptionsInput,
+ *     _config: MyInvoiceCollectionOptionsConfig,
+ *     _context: Context
+ *   ) {
+ *     // TODO: implement your collection setting logic here
+ *
+ *     return {};
+ *   }
+ * }
+ *
+ * ```
+ * @public
+ */
 declare interface InvoiceCollectionOptions<Config> {
     overrideOptions: InvoiceCollectionOptions.OverrideOptionsFunction<Config>;
 }
@@ -1185,7 +1207,7 @@ declare namespace Prorations {
     } | {
         priceKind: 'rateCardRate';
         rateCardRate: RateCardRate;
-    }) & {
+    } | { priceKind?: never }) & {
         correspondingDebit?: PreviousDebit;
         currentProrationFactor: Decimal;
         isProration: boolean;
@@ -1395,7 +1417,7 @@ declare namespace RecurringBillingItemHandling {
     } | {
         creditedItems: 'other';
         otherCreditedItems: string;
-    }) & ({
+    } | { creditedItems?: never }) & ({
         customPricingUnitOverageRate: CustomPricingUnitOverageRate;
         priceKind: 'customPricingUnitOverageRate';
     } | {
@@ -1410,7 +1432,7 @@ declare namespace RecurringBillingItemHandling {
     } | {
         priceKind: 'rateCardRate';
         rateCardRate: RateCardRate;
-    }) & {
+    } | { priceKind?: never }) & {
         isProration: boolean;
         key: string;
         prorationFactor: Decimal;
@@ -1565,7 +1587,7 @@ declare namespace RecurringBillingItemHandling {
     type ItemWithCreationStrategy = ({
         creationStrategy: 'other';
         otherCreationStrategy: string;
-    } | { creationStrategy: 'doNotCreate' } | { creationStrategy: 'invoice' }) & { key: string };
+    } | { creationStrategy: 'doNotCreate' } | { creationStrategy: 'invoice' } | { creationStrategy?: never }) & { key: string };
     /** @public */
     type Invoice = Record<string, never>;
     /** @public */

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

@@ -1223,13 +1223,13 @@ declare namespace InvoiceCollectionOptions {
     } | {
         otherPayer: string;
         payer: 'other';
-    }) & ({
+    } | { payer?: never }) & ({
         invoiceParentType: 'other';
         otherInvoiceParentType: string;
     } | {
         invoiceParentType: 'subscription';
         subscription: SubscriptionParent;
-    } | { invoiceParentType: 'cadence' } | { invoiceParentType: 'contract' } | { invoiceParentType: 'quote' } | { invoiceParentType: 'schedule' }) & { collectionOptions: CollectionOptions };
+    } | { invoiceParentType: 'cadence' } | { invoiceParentType: 'contract' } | { invoiceParentType: 'quote' } | { invoiceParentType: 'schedule' } | { invoiceParentType?: never }) & { collectionOptions: CollectionOptions };
     /** @public */
     interface Customer {
         id: string;
@@ -1294,7 +1294,29 @@ declare namespace InvoiceCollectionOptions {
     type OverrideOptionsFunction<Config> = (request: InvoiceCollectionOptionsInput, config: Config, context: Context) => InvoiceCollectionOptionsResult;
 }
 
-/** @public */
+/**
+ * @example
+ * ```ts
+ * import type { Billing, Context } from '@stripe/extensibility-sdk';
+ *
+ * // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ * interface MyInvoiceCollectionOptionsConfig {}
+ *
+ * export default class MyInvoiceCollectionOptions implements Billing.InvoiceCollectionOptions<MyInvoiceCollectionOptionsConfig> {
+ *   overrideOptions(
+ *     _request: Billing.InvoiceCollectionOptions.InvoiceCollectionOptionsInput,
+ *     _config: MyInvoiceCollectionOptionsConfig,
+ *     _context: Context
+ *   ) {
+ *     // TODO: implement your collection setting logic here
+ *
+ *     return {};
+ *   }
+ * }
+ *
+ * ```
+ * @public
+ */
 declare interface InvoiceCollectionOptions<Config> {
     overrideOptions: InvoiceCollectionOptions.OverrideOptionsFunction<Config>;
 }
@@ -1481,7 +1503,7 @@ declare namespace Prorations {
     } | {
         priceKind: 'rateCardRate';
         rateCardRate: RateCardRate;
-    }) & {
+    } | { priceKind?: never }) & {
         correspondingDebit?: PreviousDebit;
         currentProrationFactor: Decimal;
         isProration: boolean;
@@ -1735,7 +1757,7 @@ declare namespace RecurringBillingItemHandling {
     } | {
         creditedItems: 'other';
         otherCreditedItems: string;
-    }) & ({
+    } | { creditedItems?: never }) & ({
         customPricingUnitOverageRate: CustomPricingUnitOverageRate;
         priceKind: 'customPricingUnitOverageRate';
     } | {
@@ -1750,7 +1772,7 @@ declare namespace RecurringBillingItemHandling {
     } | {
         priceKind: 'rateCardRate';
         rateCardRate: RateCardRate;
-    }) & {
+    } | { priceKind?: never }) & {
         isProration: boolean;
         key: string;
         prorationFactor: Decimal;
@@ -1905,7 +1927,7 @@ declare namespace RecurringBillingItemHandling {
     type ItemWithCreationStrategy = ({
         creationStrategy: 'other';
         otherCreationStrategy: string;
-    } | { creationStrategy: 'doNotCreate' } | { creationStrategy: 'invoice' }) & { key: string };
+    } | { creationStrategy: 'doNotCreate' } | { creationStrategy: 'invoice' } | { creationStrategy?: never }) & { key: string };
     /** @public */
     type Invoice = Record<string, never>;
     /** @public */

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

@@ -1054,13 +1054,13 @@ declare namespace InvoiceCollectionOptions {
     } | {
         otherPayer: string;
         payer: 'other';
-    }) & ({
+    } | { payer?: never }) & ({
         invoiceParentType: 'other';
         otherInvoiceParentType: string;
     } | {
         invoiceParentType: 'subscription';
         subscription: SubscriptionParent;
-    } | { invoiceParentType: 'cadence' } | { invoiceParentType: 'contract' } | { invoiceParentType: 'quote' } | { invoiceParentType: 'schedule' }) & { collectionOptions: CollectionOptions };
+    } | { invoiceParentType: 'cadence' } | { invoiceParentType: 'contract' } | { invoiceParentType: 'quote' } | { invoiceParentType: 'schedule' } | { invoiceParentType?: never }) & { collectionOptions: CollectionOptions };
     /** @public */
     interface Customer {
         id: string;
@@ -1124,7 +1124,29 @@ declare namespace InvoiceCollectionOptions {
     type OverrideOptionsFunction<Config> = (request: InvoiceCollectionOptionsInput, config: Config, context: Context) => InvoiceCollectionOptionsResult;
 }
 
-/** @public */
+/**
+ * @example
+ * ```ts
+ * import type { Billing, Context } from '@stripe/extensibility-sdk';
+ *
+ * // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ * interface MyInvoiceCollectionOptionsConfig {}
+ *
+ * export default class MyInvoiceCollectionOptions implements Billing.InvoiceCollectionOptions<MyInvoiceCollectionOptionsConfig> {
+ *   overrideOptions(
+ *     _request: Billing.InvoiceCollectionOptions.InvoiceCollectionOptionsInput,
+ *     _config: MyInvoiceCollectionOptionsConfig,
+ *     _context: Context
+ *   ) {
+ *     // TODO: implement your collection setting logic here
+ *
+ *     return {};
+ *   }
+ * }
+ *
+ * ```
+ * @public
+ */
 declare interface InvoiceCollectionOptions<Config> {
     overrideOptions: InvoiceCollectionOptions.OverrideOptionsFunction<Config>;
 }
@@ -1264,7 +1286,7 @@ declare namespace Prorations {
     } | {
         priceKind: 'rateCardRate';
         rateCardRate: RateCardRate;
-    }) & {
+    } | { priceKind?: never }) & {
         correspondingDebit?: PreviousDebit;
         currentProrationFactor: Decimal;
         isProration: boolean;
@@ -1480,7 +1502,7 @@ declare namespace RecurringBillingItemHandling {
     } | {
         creditedItems: 'other';
         otherCreditedItems: string;
-    }) & ({
+    } | { creditedItems?: never }) & ({
         customPricingUnitOverageRate: CustomPricingUnitOverageRate;
         priceKind: 'customPricingUnitOverageRate';
     } | {
@@ -1495,7 +1517,7 @@ declare namespace RecurringBillingItemHandling {
     } | {
         priceKind: 'rateCardRate';
         rateCardRate: RateCardRate;
-    }) & {
+    } | { priceKind?: never }) & {
         isProration: boolean;
         key: string;
         prorationFactor: Decimal;
@@ -1650,7 +1672,7 @@ declare namespace RecurringBillingItemHandling {
     type ItemWithCreationStrategy = ({
         creationStrategy: 'other';
         otherCreationStrategy: string;
-    } | { creationStrategy: 'doNotCreate' } | { creationStrategy: 'invoice' }) & { key: string };
+    } | { creationStrategy: 'doNotCreate' } | { creationStrategy: 'invoice' } | { creationStrategy?: never }) & { key: string };
     /** @public */
     type Invoice = Record<string, never>;
     /** @public */