@stripe/extensibility-sdk 0.22.4

package/dist/extensions/billing/prorations.d.ts

@@ -0,0 +1,222 @@
+import type { Context } from '../context.js';
+import type { Currency, TimeRange } from './types.js';
+import type { Decimal, _ConfigApplicationContext } from '../../stdlib/index.js';
+/** @public */
+export declare namespace Prorations {
+    /** @public */
+    type PricingTierMode = 'graduated' | 'volume';
+    /** @public */
+    type RecurringPriceInterval = 'day' | 'week' | 'month' | 'year';
+    /** @public */
+    type PriceType = 'one_time' | 'recurring';
+    /** @public */
+    type PricingScheme = 'per_unit' | 'tiered';
+    /** @public */
+    type UsageType = 'licensed' | 'metered';
+    /** @public */
+    type ItemType = 'credit' | 'debit';
+    /**
+     * The result of the prorations extension.
+     * @public
+     */
+    interface ProrateItemsResult {
+        /** The items with computed proration factors. */
+        items: ItemWithProration[];
+    }
+    /**
+     * An item with a computed proration factor.
+     * @public
+     */
+    interface ItemWithProration {
+        /** The unique identifier of the item, matching a key from the input. */
+        key: string;
+        /** The computed proration factor. Positive for charges, negative for credits. */
+        prorationFactor: Decimal;
+        /** The displayed period for the invoice line item. */
+        lineItemPeriod: TimeRange;
+    }
+    /**
+     * The input to the prorations extension.
+     * @public
+     */
+    interface ProrateItemsInput {
+        /** The list of items that can have their proration factor and line item period modified. */
+        items: ProratableItem[];
+    }
+    /** @public */
+    type ProratableItem = {
+        /** Unique identifier for the item. */
+        key: string;
+        /** Either CREDIT or DEBIT based on whether the item is a credit or debit. */
+        type: ItemType;
+        /** Whether the item was generated from a proration event. */
+        isProration: boolean;
+        /** The time period this item covers. */
+        servicePeriod: TimeRange;
+        /** The default proration factor calculated by Stripe. */
+        currentProrationFactor: Decimal;
+        /** The duration of the price interval in seconds. */
+        priceIntervalDuration: number;
+        /** Information about the corresponding debit that a CREDIT item credits against. */
+        correspondingDebit?: PreviousDebit;
+    } & ({
+        priceKind: 'price';
+        price: Price;
+    } | {
+        priceKind: 'licenseFee';
+        licenseFee: LicenseFee;
+    } | {
+        priceKind: 'rateCardRate';
+        rateCardRate: RateCardRate;
+    } | {
+        priceKind: 'customPricingUnitOverageRate';
+        customPricingUnitOverageRate: CustomPricingUnitOverageRate;
+    } | {
+        priceKind: 'other';
+        otherPriceKind: string;
+    });
+    /**
+     * Information about a previous debit that a credit item offsets.
+     * @public
+     */
+    interface PreviousDebit {
+        /** The service period of the corresponding debit. */
+        servicePeriod: TimeRange;
+    }
+    /** @public */
+    interface CustomPricingUnitOverageRate {
+        id: string;
+        metadata: Record<string, string>;
+        rateCard: RateCard;
+        customPricingUnit: string;
+        unitAmount: Decimal;
+    }
+    /** @public */
+    interface RateCard {
+        id: string;
+        currency: Currency;
+    }
+    /** @public */
+    interface RateCardRate {
+        id: string;
+        metadata: Record<string, string>;
+        rateCard: RateCard;
+        tieringMode?: PricingTierMode;
+        tiers: RateCardRateTier[];
+        unitAmount?: Decimal;
+    }
+    /** @public */
+    interface RateCardRateTier {
+        flatAmount?: Decimal;
+        unitAmount?: Decimal;
+        upTo?: Decimal;
+    }
+    /** @public */
+    interface LicenseFee {
+        id: string;
+        lookupKey?: string;
+        metadata: Record<string, string>;
+        serviceInterval: RecurringPriceInterval;
+        serviceIntervalCount: number;
+        tieringMode?: PricingTierMode;
+        tiers: LicenseFeeTier[];
+        currency: Currency;
+        unitAmount?: Decimal;
+    }
+    /** @public */
+    interface LicenseFeeTier {
+        flatAmount?: Decimal;
+        unitAmount?: Decimal;
+        upTo?: Decimal;
+    }
+    /** @public */
+    interface Price {
+        id: string;
+        product: Product;
+        recurring?: RecurringPrice;
+        billingScheme: PricingScheme;
+        tiers: PriceTier[];
+        type: PriceType;
+        tiersMode?: PricingTierMode;
+        metadata: Record<string, string>;
+        currency: Currency;
+        unitAmount?: Decimal;
+    }
+    /** @public */
+    interface PriceTier {
+        flatAmount?: Decimal;
+        unitAmount?: Decimal;
+        upTo?: number;
+    }
+    /** @public */
+    interface RecurringPrice {
+        interval: RecurringPriceInterval;
+        intervalCount: number;
+        usageType?: UsageType;
+        meter?: string;
+    }
+    /** @public */
+    interface Product {
+        id: string;
+        name: string;
+        metadata: Record<string, string>;
+    }
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    function prepareArgsProrateItems(proto: unknown): ProrateItemsInput;
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    function prepareResultProrateItems(result: ProrateItemsResult): ProrateItemsResult;
+    /** @internal */
+    function $platformWrapProrateItems(configTransformer?: (wireConfig: unknown, appCtx: _ConfigApplicationContext) => unknown): (cls: new () => {
+        prorateItems(...a: unknown[]): unknown;
+    }, wireArgs: unknown, wireConfig: unknown, ctx: unknown) => unknown;
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    const prepareArgs: typeof prepareArgsProrateItems;
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    const prepareResult: typeof prepareResultProrateItems;
+    /**
+     * Calculates prorated amounts for subscription items when changes occur mid-billing period. The script receives the invoice items, then returns computed proration factors for each item.
+     * @public
+     */
+    type ProrateItemsFunction<Config extends Record<string, unknown>> = (request: ProrateItemsInput, config: Config, context: Context) => ProrateItemsResult;
+}
+/**
+ * @example
+ * ```ts
+ * import type { Billing, Context } from '@stripe/extensibility-sdk/extensions';
+ *
+ * // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ * interface MyProrationsConfig extends Record<string, unknown> {}
+ *
+ * export default class MyProrations implements Billing.Prorations<MyProrationsConfig> {
+ *   prorateItems(
+ *     _request: Billing.Prorations.ProrateItemsInput,
+ *     _config: MyProrationsConfig,
+ *     _context: Context
+ *   ) {
+ *     // TODO: implement your proration logic here
+ *
+ *     return {
+ *       items: [],
+ *     };
+ *   }
+ * }
+ *
+ * ```
+ * @public
+ */
+export interface Prorations<Config extends Record<string, unknown>> {
+    prorateItems: Prorations.ProrateItemsFunction<Config>;
+}
+//# sourceMappingURL=prorations.d.ts.map

package/dist/extensions/billing/prorations.d.ts.map

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

package/dist/extensions/billing/recurring_billing_item_handling.d.ts

@@ -0,0 +1,326 @@
+import type { Context } from '../context.js';
+import type { AnyTimeRange, Currency } from './types.js';
+import type { Decimal, _ConfigApplicationContext } from '../../stdlib/index.js';
+/** @public */
+export declare namespace RecurringBillingItemHandling {
+    /** @public */
+    type PricingTierMode = 'graduated' | 'volume';
+    /** @public */
+    type RecurringPriceInterval = 'day' | 'week' | 'month' | 'year';
+    /** @public */
+    type PriceType = 'one_time' | 'recurring';
+    /** @public */
+    type PricingScheme = 'per_unit' | 'tiered';
+    /** @public */
+    type UsageType = 'licensed' | 'metered';
+    /** @public */
+    type ItemType = 'credit' | 'debit';
+    /**
+     * The result of the group items extension.
+     * @public
+     */
+    interface GroupItemsResult {
+        /** The groups of items, each corresponding to a separate invoice. */
+        groups: ItemGroup[];
+    }
+    /**
+     * A group of items to place on a single invoice.
+     * @public
+     */
+    interface ItemGroup {
+        /** The items in this group. */
+        items: GroupedItem[];
+        /** Whether this group sets the latest invoice reference on the subscription. */
+        setsLatestInvoice: boolean;
+    }
+    /**
+     * An item assigned to a group.
+     * @public
+     */
+    interface GroupedItem {
+        /** The unique identifier of the item, matching a key from the input. */
+        key: string;
+    }
+    /**
+     * The input to the group items extension.
+     * @public
+     */
+    interface GroupItemsInput {
+        /** The list of items to group across invoices. */
+        items: Item[];
+    }
+    /** @public */
+    type Item = {
+        /** Unique identifier for the item. */
+        key: string;
+        /** Either CREDIT or DEBIT based on whether the item is a credit or debit. */
+        type: ItemType;
+        /** Whether the item was generated from a proration event. */
+        isProration: boolean;
+        /** The time period this item covers. */
+        servicePeriod: AnyTimeRange;
+        /** The proration factor for this item. */
+        prorationFactor: Decimal;
+    } & ({
+        priceKind: 'price';
+        price: Price;
+    } | {
+        priceKind: 'licenseFee';
+        licenseFee: LicenseFee;
+    } | {
+        priceKind: 'rateCardRate';
+        rateCardRate: RateCardRate;
+    } | {
+        priceKind: 'customPricingUnitOverageRate';
+        customPricingUnitOverageRate: CustomPricingUnitOverageRate;
+    } | {
+        priceKind: 'other';
+        otherPriceKind: string;
+    });
+    /** @public */
+    interface CustomPricingUnitOverageRate {
+        id: string;
+        metadata: Record<string, string>;
+        rateCard: RateCard;
+        customPricingUnit: string;
+        unitAmount: Decimal;
+    }
+    /** @public */
+    interface RateCard {
+        id: string;
+        currency: Currency;
+    }
+    /** @public */
+    interface RateCardRate {
+        id: string;
+        metadata: Record<string, string>;
+        rateCard: RateCard;
+        tieringMode?: PricingTierMode;
+        tiers: RateCardRateTier[];
+        unitAmount?: Decimal;
+    }
+    /** @public */
+    interface RateCardRateTier {
+        flatAmount?: Decimal;
+        unitAmount?: Decimal;
+        upTo?: Decimal;
+    }
+    /** @public */
+    interface LicenseFee {
+        id: string;
+        lookupKey?: string;
+        metadata: Record<string, string>;
+        serviceInterval: RecurringPriceInterval;
+        serviceIntervalCount: number;
+        tieringMode?: PricingTierMode;
+        tiers: LicenseFeeTier[];
+        currency: Currency;
+        unitAmount?: Decimal;
+    }
+    /** @public */
+    interface LicenseFeeTier {
+        flatAmount?: Decimal;
+        unitAmount?: Decimal;
+        upTo?: Decimal;
+    }
+    /** @public */
+    interface Price {
+        id: string;
+        product: Product;
+        recurring?: RecurringPrice;
+        billingScheme: PricingScheme;
+        tiers: PriceTier[];
+        type: PriceType;
+        tiersMode?: PricingTierMode;
+        metadata: Record<string, string>;
+        currency: Currency;
+        unitAmount?: Decimal;
+    }
+    /** @public */
+    interface PriceTier {
+        flatAmount?: Decimal;
+        unitAmount?: Decimal;
+        upTo?: number;
+    }
+    /** @public */
+    interface RecurringPrice {
+        interval: RecurringPriceInterval;
+        intervalCount: number;
+        usageType?: UsageType;
+        meter?: string;
+    }
+    /** @public */
+    interface Product {
+        id: string;
+        name: string;
+        metadata: Record<string, string>;
+    }
+    /**
+     * The result of the filter items extension.
+     * @public
+     */
+    interface FilterItemsResult {
+        /** The items to include on the invoice. */
+        items: ItemToInvoice[];
+    }
+    /**
+     * An item selected for inclusion on the invoice.
+     * @public
+     */
+    interface ItemToInvoice {
+        /** The unique identifier of the item, matching a key from the input. */
+        key: string;
+    }
+    /**
+     * The input to the filter items extension.
+     * @public
+     */
+    interface FilterItemsInput {
+        /** The list of items to evaluate for inclusion on the invoice. */
+        items: Item[];
+    }
+    /**
+     * The result of the before item creation extension.
+     * @public
+     */
+    interface BeforeItemCreationResult {
+        /** The items with their creation strategies. */
+        items: ItemWithCreationStrategy[];
+    }
+    /** @public */
+    type ItemWithCreationStrategy = {
+        /** The unique identifier of the item, matching a key from the input. */
+        key: string;
+    } & ({
+        creationStrategy: 'doNotCreate';
+    } | {
+        creationStrategy: 'invoice';
+    } | {
+        creationStrategy: 'other';
+        otherCreationStrategy: string;
+    });
+    /** @public */
+    type Invoice = Record<string, never>;
+    /** @public */
+    type DoNotCreate = Record<string, never>;
+    /**
+     * The input to the before item creation extension.
+     * @public
+     */
+    interface BeforeItemCreationInput {
+        /** The list of items to evaluate for creation. */
+        items: Item[];
+    }
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    function prepareArgsBeforeItemCreation(proto: unknown): BeforeItemCreationInput;
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    function prepareResultBeforeItemCreation(result: BeforeItemCreationResult): BeforeItemCreationResult;
+    /** @internal */
+    function $platformWrapBeforeItemCreation(configTransformer?: (wireConfig: unknown, appCtx: _ConfigApplicationContext) => unknown): (cls: new () => {
+        beforeItemCreation(...a: unknown[]): unknown;
+    }, wireArgs: unknown, wireConfig: unknown, ctx: unknown) => unknown;
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    function prepareArgsFilterItems(proto: unknown): FilterItemsInput;
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    function prepareResultFilterItems(result: FilterItemsResult): FilterItemsResult;
+    /** @internal */
+    function $platformWrapFilterItems(configTransformer?: (wireConfig: unknown, appCtx: _ConfigApplicationContext) => unknown): (cls: new () => {
+        filterItems(...a: unknown[]): unknown;
+    }, wireArgs: unknown, wireConfig: unknown, ctx: unknown) => unknown;
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    function prepareArgsGroupItems(proto: unknown): GroupItemsInput;
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    function prepareResultGroupItems(result: GroupItemsResult): GroupItemsResult;
+    /** @internal */
+    function $platformWrapGroupItems(configTransformer?: (wireConfig: unknown, appCtx: _ConfigApplicationContext) => unknown): (cls: new () => {
+        groupItems(...a: unknown[]): unknown;
+    }, wireArgs: unknown, wireConfig: unknown, ctx: unknown) => unknown;
+    /**
+     * Runs before invoice items are created. Decides whether each item should be created or skipped.
+     * @public
+     */
+    type BeforeItemCreationFunction<Config extends Record<string, unknown>> = (request: BeforeItemCreationInput, config: Config, context: Context) => BeforeItemCreationResult;
+    /**
+     * Runs before invoices are created. Decides which items to include on the invoice. Items not included are deferred as pending invoice items.
+     * @public
+     */
+    type FilterItemsFunction<Config extends Record<string, unknown>> = (request: FilterItemsInput, config: Config, context: Context) => FilterItemsResult;
+    /**
+     * Runs before invoices are created. Decides how items are grouped across one or more invoices.
+     * @public
+     */
+    type GroupItemsFunction<Config extends Record<string, unknown>> = (request: GroupItemsInput, config: Config, context: Context) => GroupItemsResult;
+}
+/**
+ * @example
+ * ```ts
+ * import type { Billing, Context } from '@stripe/extensibility-sdk/extensions';
+ *
+ * // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ * interface MyRecurringBillingItemHandlingConfig extends Record<string, unknown> {}
+ *
+ * export default class MyRecurringBillingItemHandling implements Billing.RecurringBillingItemHandling<MyRecurringBillingItemHandlingConfig> {
+ *   beforeItemCreation(
+ *     _request: Billing.RecurringBillingItemHandling.BeforeItemCreationInput,
+ *     _config: MyRecurringBillingItemHandlingConfig,
+ *     _context: Context
+ *   ) {
+ *     // TODO: implement your before-item-creation logic here
+ *
+ *     return {
+ *       items: [],
+ *     };
+ *   }
+ *
+ *   filterItems(
+ *     _request: Billing.RecurringBillingItemHandling.FilterItemsInput,
+ *     _config: MyRecurringBillingItemHandlingConfig,
+ *     _context: Context
+ *   ) {
+ *     // TODO: implement your filter-items logic here
+ *
+ *     return {
+ *       items: [],
+ *     };
+ *   }
+ *
+ *   groupItems(
+ *     _request: Billing.RecurringBillingItemHandling.GroupItemsInput,
+ *     _config: MyRecurringBillingItemHandlingConfig,
+ *     _context: Context
+ *   ) {
+ *     // TODO: implement your group-items logic here
+ *
+ *     return {
+ *       groups: [],
+ *     };
+ *   }
+ * }
+ *
+ * ```
+ * @public
+ */
+export interface RecurringBillingItemHandling<Config extends Record<string, unknown>> {
+    beforeItemCreation: RecurringBillingItemHandling.BeforeItemCreationFunction<Config>;
+    filterItems: RecurringBillingItemHandling.FilterItemsFunction<Config>;
+    groupItems: RecurringBillingItemHandling.GroupItemsFunction<Config>;
+}
+//# sourceMappingURL=recurring_billing_item_handling.d.ts.map

package/dist/extensions/billing/recurring_billing_item_handling.d.ts.map

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

package/dist/extensions/billing/types.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Represents a one-time event occurring at a specific date.
+ * @public
+ */
+export interface OneTime {
+    /** The date and time of the event. */
+    at: Date;
+}
+/**
+ * Represents a time period with start and end dates.
+ * @public
+ */
+export interface TimeRange {
+    /** The beginning date of the range. */
+    startDate: Date;
+    /** The ending date of the range. */
+    endDate: Date;
+}
+/** @public */
+export type AnyTimeRange = {
+    value: 'oneTime';
+    at: Date;
+} | {
+    value: 'timeRange';
+    startDate: Date;
+    endDate: Date;
+} | {
+    value: 'other';
+    otherValue: string;
+};
+/** @internal */
+export type { Currency, MonetaryAmount } from '../../stdlib/generated.js';
+//# sourceMappingURL=types.d.ts.map

package/dist/extensions/billing/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/extensions/billing/types.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,sCAAsC;IACtC,EAAE,EAAE,IAAI,CAAC;CACV;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,uCAAuC;IACvC,SAAS,EAAE,IAAI,CAAC;IAChB,oCAAoC;IACpC,OAAO,EAAE,IAAI,CAAC;CACf;AAED,cAAc;AACd,MAAM,MAAM,YAAY,GACpB;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,IAAI,CAAA;CAAE,GAC9B;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,GACtD;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3C,gBAAgB;AAChB,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/extensions/context.d.ts

@@ -0,0 +1,9 @@
+/** @public */
+export interface Context {
+    type: string;
+    id: string;
+    livemode: boolean;
+    stripeContext?: string;
+    clockTime?: string;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/extensions/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/extensions/context.ts"],"names":[],"mappings":"AAEA,cAAc;AACd,MAAM,WAAW,OAAO;IAEtB,IAAI,EAAE,MAAM,CAAC;IAEb,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,OAAO,CAAC;IAElB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/extensions/core/index.d.ts

@@ -0,0 +1,3 @@
+import * as Workflows from './workflows/index.js';
+export { Workflows };
+//# sourceMappingURL=index.d.ts.map

package/dist/extensions/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extensions/core/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,CAAC"}