@stigg/typescript 0.1.0-alpha.3 → 0.1.0-alpha.30

package/resources/v1/plans/entitlements.d.mts

@@ -0,0 +1,888 @@
+import { APIResource } from "../../../core/resource.mjs";
+import { APIPromise } from "../../../core/api-promise.mjs";
+import { RequestOptions } from "../../../internal/request-options.mjs";
+export declare class Entitlements extends APIResource {
+    /**
+     * Creates one or more entitlements (feature or credit) on a draft plan.
+     */
+    create(planID: string, body: EntitlementCreateParams, options?: RequestOptions): APIPromise<EntitlementCreateResponse>;
+    /**
+     * Updates an existing entitlement on a draft plan.
+     */
+    update(id: string, params: EntitlementUpdateParams, options?: RequestOptions): APIPromise<PlanEntitlement>;
+    /**
+     * Retrieves a list of entitlements for a plan.
+     */
+    list(planID: string, options?: RequestOptions): APIPromise<EntitlementListResponse>;
+    /**
+     * Deletes an entitlement from a draft plan.
+     */
+    delete(id: string, params: EntitlementDeleteParams, options?: RequestOptions): APIPromise<PlanEntitlement>;
+}
+/**
+ * Response object
+ */
+export interface PlanEntitlement {
+    /**
+     * Feature entitlement response
+     */
+    data: PlanEntitlement.Feature | PlanEntitlement.Credit;
+}
+export declare namespace PlanEntitlement {
+    /**
+     * Feature entitlement response
+     */
+    interface Feature {
+        /**
+         * Unique identifier of the entitlement
+         */
+        id: string;
+        /**
+         * Entitlement behavior (Increment or Override)
+         */
+        behavior: 'Increment' | 'Override';
+        /**
+         * Timestamp of when the record was created
+         */
+        createdAt: string;
+        /**
+         * Optional description of the entitlement
+         */
+        description: string | null;
+        /**
+         * Override display name for the entitlement
+         */
+        displayNameOverride: string | null;
+        /**
+         * Allowed enum values (for feature entitlements)
+         */
+        enumValues: Array<string> | null;
+        /**
+         * Whether the usage limit is a soft limit (for feature entitlements)
+         */
+        hasSoftLimit: boolean | null;
+        /**
+         * Whether usage is unlimited (for feature entitlements)
+         */
+        hasUnlimitedUsage: boolean | null;
+        /**
+         * Widget types where this entitlement is hidden
+         */
+        hiddenFromWidgets: Array<'PAYWALL' | 'CUSTOMER_PORTAL' | 'CHECKOUT'>;
+        /**
+         * Whether this is a custom entitlement
+         */
+        isCustom: boolean | null;
+        /**
+         * Whether the entitlement is granted
+         */
+        isGranted: boolean;
+        /**
+         * Display order of the entitlement
+         */
+        order: number | null;
+        /**
+         * Usage reset period (for feature entitlements)
+         */
+        resetPeriod: 'YEAR' | 'MONTH' | 'WEEK' | 'DAY' | 'HOUR' | null;
+        /**
+         * Reset period configuration (for feature entitlements)
+         */
+        resetPeriodConfiguration: Feature.YearlyResetPeriodConfig | Feature.MonthlyResetPeriodConfig | Feature.WeeklyResetPeriodConfig | null;
+        /**
+         * Entitlement type (FEATURE or CREDIT)
+         */
+        type: 'FEATURE';
+        /**
+         * Timestamp of when the record was last updated
+         */
+        updatedAt: string;
+        /**
+         * Usage limit (for feature entitlements)
+         */
+        usageLimit: number | null;
+    }
+    namespace Feature {
+        /**
+         * Yearly reset configuration
+         */
+        interface YearlyResetPeriodConfig {
+            /**
+             * Reset anchor (SubscriptionStart)
+             */
+            accordingTo: 'SubscriptionStart';
+        }
+        /**
+         * Monthly reset configuration
+         */
+        interface MonthlyResetPeriodConfig {
+            /**
+             * Reset anchor (SubscriptionStart or StartOfTheMonth)
+             */
+            accordingTo: 'SubscriptionStart' | 'StartOfTheMonth';
+        }
+        /**
+         * Weekly reset configuration
+         */
+        interface WeeklyResetPeriodConfig {
+            /**
+             * Reset anchor (SubscriptionStart or specific day)
+             */
+            accordingTo: 'SubscriptionStart' | 'EverySunday' | 'EveryMonday' | 'EveryTuesday' | 'EveryWednesday' | 'EveryThursday' | 'EveryFriday' | 'EverySaturday';
+        }
+    }
+    /**
+     * Credit entitlement response
+     */
+    interface Credit {
+        /**
+         * Unique identifier of the entitlement
+         */
+        id: string;
+        /**
+         * Credit amount (for credit entitlements)
+         */
+        amount: number | null;
+        /**
+         * Entitlement behavior (Increment or Override)
+         */
+        behavior: 'Increment' | 'Override';
+        /**
+         * Credit grant cadence (for credit entitlements)
+         */
+        cadence: 'MONTH' | 'YEAR' | null;
+        /**
+         * Timestamp of when the record was created
+         */
+        createdAt: string;
+        /**
+         * Optional description of the entitlement
+         */
+        description: string | null;
+        /**
+         * Override display name for the entitlement
+         */
+        displayNameOverride: string | null;
+        /**
+         * Widget types where this entitlement is hidden
+         */
+        hiddenFromWidgets: Array<'PAYWALL' | 'CUSTOMER_PORTAL' | 'CHECKOUT'>;
+        /**
+         * Whether this is a custom entitlement
+         */
+        isCustom: boolean | null;
+        /**
+         * Whether the entitlement is granted
+         */
+        isGranted: boolean;
+        /**
+         * Display order of the entitlement
+         */
+        order: number | null;
+        /**
+         * Entitlement type (FEATURE or CREDIT)
+         */
+        type: 'CREDIT';
+        /**
+         * Timestamp of when the record was last updated
+         */
+        updatedAt: string;
+        /**
+         * The feature ID this entitlement depends on (for credit entitlements). The
+         * entitlement value will be calculated as: base amount × dependency feature usage
+         * limit
+         */
+        dependencyFeatureId?: string | null;
+    }
+}
+/**
+ * Response object
+ */
+export interface EntitlementCreateResponse {
+    data: Array<EntitlementCreateResponse.Feature | EntitlementCreateResponse.Credit>;
+}
+export declare namespace EntitlementCreateResponse {
+    /**
+     * Feature entitlement response
+     */
+    interface Feature {
+        /**
+         * Unique identifier of the entitlement
+         */
+        id: string;
+        /**
+         * Entitlement behavior (Increment or Override)
+         */
+        behavior: 'Increment' | 'Override';
+        /**
+         * Timestamp of when the record was created
+         */
+        createdAt: string;
+        /**
+         * Optional description of the entitlement
+         */
+        description: string | null;
+        /**
+         * Override display name for the entitlement
+         */
+        displayNameOverride: string | null;
+        /**
+         * Allowed enum values (for feature entitlements)
+         */
+        enumValues: Array<string> | null;
+        /**
+         * Whether the usage limit is a soft limit (for feature entitlements)
+         */
+        hasSoftLimit: boolean | null;
+        /**
+         * Whether usage is unlimited (for feature entitlements)
+         */
+        hasUnlimitedUsage: boolean | null;
+        /**
+         * Widget types where this entitlement is hidden
+         */
+        hiddenFromWidgets: Array<'PAYWALL' | 'CUSTOMER_PORTAL' | 'CHECKOUT'>;
+        /**
+         * Whether this is a custom entitlement
+         */
+        isCustom: boolean | null;
+        /**
+         * Whether the entitlement is granted
+         */
+        isGranted: boolean;
+        /**
+         * Display order of the entitlement
+         */
+        order: number | null;
+        /**
+         * Usage reset period (for feature entitlements)
+         */
+        resetPeriod: 'YEAR' | 'MONTH' | 'WEEK' | 'DAY' | 'HOUR' | null;
+        /**
+         * Reset period configuration (for feature entitlements)
+         */
+        resetPeriodConfiguration: Feature.YearlyResetPeriodConfig | Feature.MonthlyResetPeriodConfig | Feature.WeeklyResetPeriodConfig | null;
+        /**
+         * Entitlement type (FEATURE or CREDIT)
+         */
+        type: 'FEATURE';
+        /**
+         * Timestamp of when the record was last updated
+         */
+        updatedAt: string;
+        /**
+         * Usage limit (for feature entitlements)
+         */
+        usageLimit: number | null;
+    }
+    namespace Feature {
+        /**
+         * Yearly reset configuration
+         */
+        interface YearlyResetPeriodConfig {
+            /**
+             * Reset anchor (SubscriptionStart)
+             */
+            accordingTo: 'SubscriptionStart';
+        }
+        /**
+         * Monthly reset configuration
+         */
+        interface MonthlyResetPeriodConfig {
+            /**
+             * Reset anchor (SubscriptionStart or StartOfTheMonth)
+             */
+            accordingTo: 'SubscriptionStart' | 'StartOfTheMonth';
+        }
+        /**
+         * Weekly reset configuration
+         */
+        interface WeeklyResetPeriodConfig {
+            /**
+             * Reset anchor (SubscriptionStart or specific day)
+             */
+            accordingTo: 'SubscriptionStart' | 'EverySunday' | 'EveryMonday' | 'EveryTuesday' | 'EveryWednesday' | 'EveryThursday' | 'EveryFriday' | 'EverySaturday';
+        }
+    }
+    /**
+     * Credit entitlement response
+     */
+    interface Credit {
+        /**
+         * Unique identifier of the entitlement
+         */
+        id: string;
+        /**
+         * Credit amount (for credit entitlements)
+         */
+        amount: number | null;
+        /**
+         * Entitlement behavior (Increment or Override)
+         */
+        behavior: 'Increment' | 'Override';
+        /**
+         * Credit grant cadence (for credit entitlements)
+         */
+        cadence: 'MONTH' | 'YEAR' | null;
+        /**
+         * Timestamp of when the record was created
+         */
+        createdAt: string;
+        /**
+         * Optional description of the entitlement
+         */
+        description: string | null;
+        /**
+         * Override display name for the entitlement
+         */
+        displayNameOverride: string | null;
+        /**
+         * Widget types where this entitlement is hidden
+         */
+        hiddenFromWidgets: Array<'PAYWALL' | 'CUSTOMER_PORTAL' | 'CHECKOUT'>;
+        /**
+         * Whether this is a custom entitlement
+         */
+        isCustom: boolean | null;
+        /**
+         * Whether the entitlement is granted
+         */
+        isGranted: boolean;
+        /**
+         * Display order of the entitlement
+         */
+        order: number | null;
+        /**
+         * Entitlement type (FEATURE or CREDIT)
+         */
+        type: 'CREDIT';
+        /**
+         * Timestamp of when the record was last updated
+         */
+        updatedAt: string;
+        /**
+         * The feature ID this entitlement depends on (for credit entitlements). The
+         * entitlement value will be calculated as: base amount × dependency feature usage
+         * limit
+         */
+        dependencyFeatureId?: string | null;
+    }
+}
+/**
+ * Response list object
+ */
+export interface EntitlementListResponse {
+    data: Array<EntitlementListResponse.Feature | EntitlementListResponse.Credit>;
+    /**
+     * Pagination metadata including cursors for navigating through results
+     */
+    pagination: EntitlementListResponse.Pagination;
+}
+export declare namespace EntitlementListResponse {
+    /**
+     * Feature entitlement response
+     */
+    interface Feature {
+        /**
+         * Unique identifier of the entitlement
+         */
+        id: string;
+        /**
+         * Entitlement behavior (Increment or Override)
+         */
+        behavior: 'Increment' | 'Override';
+        /**
+         * Timestamp of when the record was created
+         */
+        createdAt: string;
+        /**
+         * Optional description of the entitlement
+         */
+        description: string | null;
+        /**
+         * Override display name for the entitlement
+         */
+        displayNameOverride: string | null;
+        /**
+         * Allowed enum values (for feature entitlements)
+         */
+        enumValues: Array<string> | null;
+        /**
+         * Whether the usage limit is a soft limit (for feature entitlements)
+         */
+        hasSoftLimit: boolean | null;
+        /**
+         * Whether usage is unlimited (for feature entitlements)
+         */
+        hasUnlimitedUsage: boolean | null;
+        /**
+         * Widget types where this entitlement is hidden
+         */
+        hiddenFromWidgets: Array<'PAYWALL' | 'CUSTOMER_PORTAL' | 'CHECKOUT'>;
+        /**
+         * Whether this is a custom entitlement
+         */
+        isCustom: boolean | null;
+        /**
+         * Whether the entitlement is granted
+         */
+        isGranted: boolean;
+        /**
+         * Display order of the entitlement
+         */
+        order: number | null;
+        /**
+         * Usage reset period (for feature entitlements)
+         */
+        resetPeriod: 'YEAR' | 'MONTH' | 'WEEK' | 'DAY' | 'HOUR' | null;
+        /**
+         * Reset period configuration (for feature entitlements)
+         */
+        resetPeriodConfiguration: Feature.YearlyResetPeriodConfig | Feature.MonthlyResetPeriodConfig | Feature.WeeklyResetPeriodConfig | null;
+        /**
+         * Entitlement type (FEATURE or CREDIT)
+         */
+        type: 'FEATURE';
+        /**
+         * Timestamp of when the record was last updated
+         */
+        updatedAt: string;
+        /**
+         * Usage limit (for feature entitlements)
+         */
+        usageLimit: number | null;
+    }
+    namespace Feature {
+        /**
+         * Yearly reset configuration
+         */
+        interface YearlyResetPeriodConfig {
+            /**
+             * Reset anchor (SubscriptionStart)
+             */
+            accordingTo: 'SubscriptionStart';
+        }
+        /**
+         * Monthly reset configuration
+         */
+        interface MonthlyResetPeriodConfig {
+            /**
+             * Reset anchor (SubscriptionStart or StartOfTheMonth)
+             */
+            accordingTo: 'SubscriptionStart' | 'StartOfTheMonth';
+        }
+        /**
+         * Weekly reset configuration
+         */
+        interface WeeklyResetPeriodConfig {
+            /**
+             * Reset anchor (SubscriptionStart or specific day)
+             */
+            accordingTo: 'SubscriptionStart' | 'EverySunday' | 'EveryMonday' | 'EveryTuesday' | 'EveryWednesday' | 'EveryThursday' | 'EveryFriday' | 'EverySaturday';
+        }
+    }
+    /**
+     * Credit entitlement response
+     */
+    interface Credit {
+        /**
+         * Unique identifier of the entitlement
+         */
+        id: string;
+        /**
+         * Credit amount (for credit entitlements)
+         */
+        amount: number | null;
+        /**
+         * Entitlement behavior (Increment or Override)
+         */
+        behavior: 'Increment' | 'Override';
+        /**
+         * Credit grant cadence (for credit entitlements)
+         */
+        cadence: 'MONTH' | 'YEAR' | null;
+        /**
+         * Timestamp of when the record was created
+         */
+        createdAt: string;
+        /**
+         * Optional description of the entitlement
+         */
+        description: string | null;
+        /**
+         * Override display name for the entitlement
+         */
+        displayNameOverride: string | null;
+        /**
+         * Widget types where this entitlement is hidden
+         */
+        hiddenFromWidgets: Array<'PAYWALL' | 'CUSTOMER_PORTAL' | 'CHECKOUT'>;
+        /**
+         * Whether this is a custom entitlement
+         */
+        isCustom: boolean | null;
+        /**
+         * Whether the entitlement is granted
+         */
+        isGranted: boolean;
+        /**
+         * Display order of the entitlement
+         */
+        order: number | null;
+        /**
+         * Entitlement type (FEATURE or CREDIT)
+         */
+        type: 'CREDIT';
+        /**
+         * Timestamp of when the record was last updated
+         */
+        updatedAt: string;
+        /**
+         * The feature ID this entitlement depends on (for credit entitlements). The
+         * entitlement value will be calculated as: base amount × dependency feature usage
+         * limit
+         */
+        dependencyFeatureId?: string | null;
+    }
+    /**
+     * Pagination metadata including cursors for navigating through results
+     */
+    interface Pagination {
+        /**
+         * Cursor for fetching the next page of results, or null if no additional pages
+         * exist
+         */
+        next: string | null;
+        /**
+         * Cursor for fetching the previous page of results, or null if at the beginning
+         */
+        prev: string | null;
+    }
+}
+export interface EntitlementCreateParams {
+    /**
+     * Entitlements to create
+     */
+    entitlements: Array<EntitlementCreateParams.Feature | EntitlementCreateParams.Credit>;
+}
+export declare namespace EntitlementCreateParams {
+    /**
+     * Request to create a feature entitlement
+     */
+    interface Feature {
+        /**
+         * The feature ID to attach the entitlement to
+         */
+        id: string;
+        /**
+         * CreateFeatureEntitlementRequest
+         */
+        type: 'FEATURE';
+        /**
+         * Entitlement behavior (Increment or Override)
+         */
+        behavior?: 'Increment' | 'Override';
+        /**
+         * Description of the entitlement
+         */
+        description?: string;
+        /**
+         * Override display name for the entitlement
+         */
+        displayNameOverride?: string;
+        /**
+         * Allowed enum values for the feature entitlement
+         */
+        enumValues?: Array<string>;
+        /**
+         * Whether the usage limit is a soft limit
+         */
+        hasSoftLimit?: boolean;
+        /**
+         * Whether usage is unlimited
+         */
+        hasUnlimitedUsage?: boolean;
+        /**
+         * Widget types where this entitlement is hidden
+         */
+        hiddenFromWidgets?: Array<'PAYWALL' | 'CUSTOMER_PORTAL' | 'CHECKOUT'>;
+        /**
+         * Whether this is a custom entitlement
+         */
+        isCustom?: boolean;
+        /**
+         * Whether the entitlement is granted
+         */
+        isGranted?: boolean;
+        /**
+         * Configuration for monthly reset period
+         */
+        monthlyResetPeriodConfiguration?: Feature.MonthlyResetPeriodConfiguration | null;
+        /**
+         * Display order of the entitlement
+         */
+        order?: number;
+        /**
+         * Period at which usage resets
+         */
+        resetPeriod?: 'YEAR' | 'MONTH' | 'WEEK' | 'DAY' | 'HOUR';
+        /**
+         * Maximum allowed usage for the feature
+         */
+        usageLimit?: number | null;
+        /**
+         * Configuration for weekly reset period
+         */
+        weeklyResetPeriodConfiguration?: Feature.WeeklyResetPeriodConfiguration | null;
+        /**
+         * Configuration for yearly reset period
+         */
+        yearlyResetPeriodConfiguration?: Feature.YearlyResetPeriodConfiguration | null;
+    }
+    namespace Feature {
+        /**
+         * Configuration for monthly reset period
+         */
+        interface MonthlyResetPeriodConfiguration {
+            /**
+             * Reset anchor (SubscriptionStart or StartOfTheMonth)
+             */
+            accordingTo: 'SubscriptionStart' | 'StartOfTheMonth';
+        }
+        /**
+         * Configuration for weekly reset period
+         */
+        interface WeeklyResetPeriodConfiguration {
+            /**
+             * Reset anchor (SubscriptionStart or specific day)
+             */
+            accordingTo: 'SubscriptionStart' | 'EverySunday' | 'EveryMonday' | 'EveryTuesday' | 'EveryWednesday' | 'EveryThursday' | 'EveryFriday' | 'EverySaturday';
+        }
+        /**
+         * Configuration for yearly reset period
+         */
+        interface YearlyResetPeriodConfiguration {
+            /**
+             * Reset anchor (SubscriptionStart)
+             */
+            accordingTo: 'SubscriptionStart';
+        }
+    }
+    /**
+     * Request to create a credit entitlement
+     */
+    interface Credit {
+        /**
+         * The custom currency ID for the credit entitlement
+         */
+        id: string;
+        /**
+         * Credit grant amount
+         */
+        amount: number | null;
+        /**
+         * Credit grant cadence (MONTH or YEAR)
+         */
+        cadence: 'MONTH' | 'YEAR';
+        /**
+         * CreateCreditEntitlementRequest
+         */
+        type: 'CREDIT';
+        /**
+         * Entitlement behavior (Increment or Override)
+         */
+        behavior?: 'Increment' | 'Override';
+        /**
+         * The feature ID this entitlement depends on. The entitlement value will be
+         * calculated as: base amount × dependency feature usage limit
+         */
+        dependencyFeatureId?: string;
+        /**
+         * Description of the entitlement
+         */
+        description?: string;
+        /**
+         * Override display name for the entitlement
+         */
+        displayNameOverride?: string;
+        /**
+         * Widget types where this entitlement is hidden
+         */
+        hiddenFromWidgets?: Array<'PAYWALL' | 'CUSTOMER_PORTAL' | 'CHECKOUT'>;
+        /**
+         * Whether this is a custom entitlement
+         */
+        isCustom?: boolean;
+        /**
+         * Whether the entitlement is granted
+         */
+        isGranted?: boolean;
+        /**
+         * Display order of the entitlement
+         */
+        order?: number;
+    }
+}
+export type EntitlementUpdateParams = EntitlementUpdateParams.UpdateFeatureEntitlementRequest | EntitlementUpdateParams.UpdateCreditEntitlementRequest;
+export declare namespace EntitlementUpdateParams {
+    interface UpdateFeatureEntitlementRequest {
+        /**
+         * Path param: The plan ID
+         */
+        planId: string;
+        /**
+         * Body param: UpdateFeatureEntitlementRequest
+         */
+        type: 'FEATURE';
+        /**
+         * Body param: Entitlement behavior (Increment or Override)
+         */
+        behavior?: 'Increment' | 'Override';
+        /**
+         * Body param: Description of the entitlement
+         */
+        description?: string;
+        /**
+         * Body param: Override display name for the entitlement
+         */
+        displayNameOverride?: string;
+        /**
+         * Body param: Allowed enum values for the feature entitlement
+         */
+        enumValues?: Array<string>;
+        /**
+         * Body param: Whether the usage limit is a soft limit
+         */
+        hasSoftLimit?: boolean;
+        /**
+         * Body param: Whether usage is unlimited
+         */
+        hasUnlimitedUsage?: boolean;
+        /**
+         * Body param: Widget types where this entitlement is hidden
+         */
+        hiddenFromWidgets?: Array<'PAYWALL' | 'CUSTOMER_PORTAL' | 'CHECKOUT'>;
+        /**
+         * Body param: Whether this is a custom entitlement
+         */
+        isCustom?: boolean;
+        /**
+         * Body param: Whether the entitlement is granted
+         */
+        isGranted?: boolean;
+        /**
+         * Body param: Configuration for monthly reset period
+         */
+        monthlyResetPeriodConfiguration?: UpdateFeatureEntitlementRequest.MonthlyResetPeriodConfiguration | null;
+        /**
+         * Body param: Display order of the entitlement
+         */
+        order?: number;
+        /**
+         * Body param: Period at which usage resets
+         */
+        resetPeriod?: 'YEAR' | 'MONTH' | 'WEEK' | 'DAY' | 'HOUR';
+        /**
+         * Body param: Maximum allowed usage for the feature
+         */
+        usageLimit?: number | null;
+        /**
+         * Body param: Configuration for weekly reset period
+         */
+        weeklyResetPeriodConfiguration?: UpdateFeatureEntitlementRequest.WeeklyResetPeriodConfiguration | null;
+        /**
+         * Body param: Configuration for yearly reset period
+         */
+        yearlyResetPeriodConfiguration?: UpdateFeatureEntitlementRequest.YearlyResetPeriodConfiguration | null;
+    }
+    namespace UpdateFeatureEntitlementRequest {
+        /**
+         * Configuration for monthly reset period
+         */
+        interface MonthlyResetPeriodConfiguration {
+            /**
+             * Reset anchor (SubscriptionStart or StartOfTheMonth)
+             */
+            accordingTo: 'SubscriptionStart' | 'StartOfTheMonth';
+        }
+        /**
+         * Configuration for weekly reset period
+         */
+        interface WeeklyResetPeriodConfiguration {
+            /**
+             * Reset anchor (SubscriptionStart or specific day)
+             */
+            accordingTo: 'SubscriptionStart' | 'EverySunday' | 'EveryMonday' | 'EveryTuesday' | 'EveryWednesday' | 'EveryThursday' | 'EveryFriday' | 'EverySaturday';
+        }
+        /**
+         * Configuration for yearly reset period
+         */
+        interface YearlyResetPeriodConfiguration {
+            /**
+             * Reset anchor (SubscriptionStart)
+             */
+            accordingTo: 'SubscriptionStart';
+        }
+    }
+    interface UpdateCreditEntitlementRequest {
+        /**
+         * Path param: The plan ID
+         */
+        planId: string;
+        /**
+         * Body param: UpdateCreditEntitlementRequest
+         */
+        type: 'CREDIT';
+        /**
+         * Body param: Credit grant amount
+         */
+        amount?: number;
+        /**
+         * Body param: Entitlement behavior (Increment or Override)
+         */
+        behavior?: 'Increment' | 'Override';
+        /**
+         * Body param: Credit grant cadence (MONTH or YEAR)
+         */
+        cadence?: 'MONTH' | 'YEAR';
+        /**
+         * Body param: The feature ID this entitlement depends on. The entitlement value
+         * will be calculated as: base amount × dependency feature usage limit
+         */
+        dependencyFeatureId?: string | null;
+        /**
+         * Body param: Description of the entitlement
+         */
+        description?: string;
+        /**
+         * Body param: Override display name for the entitlement
+         */
+        displayNameOverride?: string;
+        /**
+         * Body param: Widget types where this entitlement is hidden
+         */
+        hiddenFromWidgets?: Array<'PAYWALL' | 'CUSTOMER_PORTAL' | 'CHECKOUT'>;
+        /**
+         * Body param: Whether this is a custom entitlement
+         */
+        isCustom?: boolean;
+        /**
+         * Body param: Whether the entitlement is granted
+         */
+        isGranted?: boolean;
+        /**
+         * Body param: Display order of the entitlement
+         */
+        order?: number;
+    }
+}
+export interface EntitlementDeleteParams {
+    /**
+     * The plan ID
+     */
+    planId: string;
+}
+export declare namespace Entitlements {
+    export { type PlanEntitlement as PlanEntitlement, type EntitlementCreateResponse as EntitlementCreateResponse, type EntitlementListResponse as EntitlementListResponse, type EntitlementCreateParams as EntitlementCreateParams, type EntitlementUpdateParams as EntitlementUpdateParams, type EntitlementDeleteParams as EntitlementDeleteParams, };
+}
+//# sourceMappingURL=entitlements.d.mts.map