stigg 0.1.0.pre.alpha.1 → 0.1.0.pre.alpha.2

data/rbi/stigg/resources/v1/subscriptions.rbi

@@ -7,22 +7,53 @@ module Stigg
         sig { returns(Stigg::Resources::V1::Subscriptions::FutureUpdate) }
         attr_reader :future_update
 
-        # Create a new Subscription
+        # Provision subscription
         sig do
           params(
             customer_id: String,
             plan_id: String,
-            id: T.nilable(String),
+            id: String,
+            addons:
+              T::Array[Stigg::V1::SubscriptionCreateParams::Addon::OrHash],
+            applied_coupon:
+              Stigg::V1::SubscriptionCreateParams::AppliedCoupon::OrHash,
             await_payment_confirmation: T::Boolean,
+            billing_country_code: T.nilable(String),
+            billing_id: T.nilable(String),
+            billing_information:
+              Stigg::V1::SubscriptionCreateParams::BillingInformation::OrHash,
             billing_period:
               Stigg::V1::SubscriptionCreateParams::BillingPeriod::OrSymbol,
+            budget:
+              T.nilable(Stigg::V1::SubscriptionCreateParams::Budget::OrHash),
+            charges:
+              T::Array[Stigg::V1::SubscriptionCreateParams::Charge::OrHash],
             checkout_options:
               Stigg::V1::SubscriptionCreateParams::CheckoutOptions::OrHash,
             metadata: T::Hash[Symbol, String],
+            minimum_spend:
+              T.nilable(
+                Stigg::V1::SubscriptionCreateParams::MinimumSpend::OrHash
+              ),
             paying_customer_id: T.nilable(String),
+            payment_collection_method:
+              Stigg::V1::SubscriptionCreateParams::PaymentCollectionMethod::OrSymbol,
+            price_overrides:
+              T::Array[
+                Stigg::V1::SubscriptionCreateParams::PriceOverride::OrHash
+              ],
             resource_id: T.nilable(String),
+            salesforce_id: T.nilable(String),
+            schedule_strategy:
+              Stigg::V1::SubscriptionCreateParams::ScheduleStrategy::OrSymbol,
+            start_date: Time,
+            subscription_entitlements:
+              T::Array[
+                Stigg::V1::SubscriptionCreateParams::SubscriptionEntitlement::OrHash
+              ],
             trial_override_configuration:
               Stigg::V1::SubscriptionCreateParams::TrialOverrideConfiguration::OrHash,
+            unit_quantity: Float,
             request_options: Stigg::RequestOptions::OrHash
           ).returns(Stigg::Models::V1::SubscriptionCreateResponse)
         end
@@ -33,59 +64,91 @@ module Stigg
           plan_id:,
           # Unique identifier for the subscription
           id: nil,
+          addons: nil,
+          # Coupon configuration
+          applied_coupon: nil,
           # Whether to wait for payment confirmation before returning the subscription
           await_payment_confirmation: nil,
+          # The ISO 3166-1 alpha-2 country code for billing
+          billing_country_code: nil,
+          # External billing system identifier
+          billing_id: nil,
+          billing_information: nil,
+          # Billing period (MONTHLY or ANNUALLY)
           billing_period: nil,
+          budget: nil,
+          charges: nil,
+          # Checkout page configuration for payment collection
           checkout_options: nil,
           # Additional metadata for the subscription
           metadata: nil,
+          minimum_spend: nil,
           # Optional paying customer ID for split billing scenarios
           paying_customer_id: nil,
+          # How payments should be collected for this subscription
+          payment_collection_method: nil,
+          price_overrides: nil,
           # Optional resource ID for multi-instance subscriptions
           resource_id: nil,
+          # Salesforce ID
+          salesforce_id: nil,
+          # Strategy for scheduling subscription changes
+          schedule_strategy: nil,
+          # Subscription start date
+          start_date: nil,
+          subscription_entitlements: nil,
+          # Trial period override settings
           trial_override_configuration: nil,
+          unit_quantity: nil,
           request_options: {}
         )
         end
 
-        # Get a single Subscription by id
+        # Get a single subscription by ID
         sig do
           params(
             id: String,
             request_options: Stigg::RequestOptions::OrHash
           ).returns(Stigg::Models::V1::SubscriptionRetrieveResponse)
         end
-        def retrieve(id, request_options: {})
+        def retrieve(
+          # The unique identifier of the entity
+          id,
+          request_options: {}
+        )
         end
 
-        # Get a list of Subscriptions
+        # Get a list of subscriptions
         sig do
           params(
+            after: String,
+            before: String,
             customer_id: String,
-            ending_before: String,
             limit: Integer,
-            starting_after: String,
             status: String,
             request_options: Stigg::RequestOptions::OrHash
-          ).returns(Stigg::Models::V1::SubscriptionListResponse)
+          ).returns(
+            Stigg::Internal::MyCursorIDPage[
+              Stigg::Models::V1::SubscriptionListResponse
+            ]
+          )
         end
         def list(
+          # Return items that come after this cursor
+          after: nil,
+          # Return items that come before this cursor
+          before: nil,
           # Filter by customer ID
           customer_id: nil,
-          # Ending before this UUID for pagination
-          ending_before: nil,
-          # Items per page
+          # Maximum number of items to return
           limit: nil,
-          # Starting after this UUID for pagination
-          starting_after: nil,
-          # Filter by subscription status (comma-separated for multiple statuses, e.g.,
-          # ACTIVE,IN_TRIAL)
+          # Filter by status (comma-separated)
           status: nil,
           request_options: {}
         )
         end
 
-        # Perform delegate on a Subscription
+        # Delegate subscription payment to customer
         sig do
           params(
             id: String,
@@ -94,14 +157,17 @@ module Stigg
           ).returns(Stigg::Models::V1::SubscriptionDelegateResponse)
         end
         def delegate(
+          # The unique identifier of the entity
           id,
-          # The customer ID to delegate the subscription to
+          # The unique identifier of the customer who will assume payment responsibility for
+          # this subscription. This customer must already exist in your Stigg account and
+          # have a valid payment method if the subscription requires payment.
           target_customer_id:,
           request_options: {}
         )
         end
 
-        # Perform migrate to latest plan version on a Subscription
+        # Migrate subscription to latest plan version
         sig do
           params(
             id: String,
@@ -111,14 +177,15 @@ module Stigg
           ).returns(Stigg::Models::V1::SubscriptionMigrateResponse)
         end
         def migrate(
+          # The unique identifier of the entity
           id,
-          # When to migrate the subscription: IMMEDIATE or END_OF_BILLING_PERIOD
+          # When to migrate (immediate or period end)
           subscription_migration_time: nil,
           request_options: {}
         )
         end
 
-        # Create a new Subscription Preview
+        # Preview subscription
         sig do
           params(
             customer_id: String,
@@ -154,25 +221,37 @@ module Stigg
           customer_id:,
           # Plan ID
           plan_id:,
+          # Addons to include
           addons: nil,
+          # Coupon or discount to apply
           applied_coupon: nil,
+          # Billable features with quantities
           billable_features: nil,
+          # ISO 3166-1 country code for localization
           billing_country_code: nil,
+          # Billing and tax configuration
           billing_information: nil,
+          # Billing period (MONTHLY or ANNUALLY)
           billing_period: nil,
+          # One-time or recurring charges
           charges: nil,
+          # Paying customer ID for delegated billing
           paying_customer_id: nil,
+          # Resource ID for multi-instance subscriptions
           resource_id: nil,
+          # When to apply subscription changes
           schedule_strategy: nil,
           # Subscription start date
           start_date: nil,
+          # Trial period override settings
           trial_override_configuration: nil,
+          # Unit quantity for per-unit pricing
           unit_quantity: nil,
           request_options: {}
         )
         end
 
-        # Perform transfer to resource on a Subscription
+        # Transfer subscription to resource
         sig do
           params(
             id: String,
@@ -181,9 +260,9 @@ module Stigg
           ).returns(Stigg::Models::V1::SubscriptionTransferResponse)
         end
         def transfer(
+          # The unique identifier of the entity
           id,
-          # The resource ID to transfer the subscription to. The destination resource must
-          # belong to the same customer.
+          # Resource ID to transfer the subscription to
           destination_resource_id:,
           request_options: {}
         )

data/rbi/stigg/resources/v1.rbi

@@ -12,7 +12,7 @@ module Stigg
       sig { returns(Stigg::Resources::V1::Coupons) }
       attr_reader :coupons
 
-      # Create events
+      # Report usage events
       sig do
         params(
           events: T::Array[Stigg::V1CreateEventParams::Event::OrHash],
@@ -26,7 +26,7 @@ module Stigg
       )
       end
 
-      # Create a new Usage
+      # Report usage measurements
       sig do
         params(
           usages: T::Array[Stigg::V1CreateUsageParams::Usage::OrHash],

data/sig/stigg/internal/my_cursor_id_page.rbs

@@ -5,7 +5,24 @@ module Stigg
 
       attr_accessor data: ::Array[Elem]?
 
+      attr_accessor pagination: Pagination
+
       def inspect: -> String
+
+      type pagination = { next_: String, prev: String }
+      class Pagination < Stigg::Internal::Type::BaseModel
+        attr_reader next_: String?
+
+        def next_=: (String) -> String
+
+        attr_reader prev: String?
+
+        def prev=: (String) -> String
+
+        def initialize: (?next_: String, ?prev: String) -> void
+
+        def to_hash: -> { next_: String, prev: String }
+      end
     end
   end
 end

data/sig/stigg/models/v1/coupon_create_response.rbs

@@ -92,22 +92,22 @@ module Stigg
           type amounts_off =
             {
               amount: Float,
-              currency: Stigg::Models::V1::CouponCreateResponse::Data::AmountsOff::currency?
+              currency: Stigg::Models::V1::CouponCreateResponse::Data::AmountsOff::currency
             }
 
           class AmountsOff < Stigg::Internal::Type::BaseModel
             attr_accessor amount: Float
 
-            attr_accessor currency: Stigg::Models::V1::CouponCreateResponse::Data::AmountsOff::currency?
+            attr_accessor currency: Stigg::Models::V1::CouponCreateResponse::Data::AmountsOff::currency
 
             def initialize: (
               amount: Float,
-              currency: Stigg::Models::V1::CouponCreateResponse::Data::AmountsOff::currency?
+              currency: Stigg::Models::V1::CouponCreateResponse::Data::AmountsOff::currency
             ) -> void
 
             def to_hash: -> {
               amount: Float,
-              currency: Stigg::Models::V1::CouponCreateResponse::Data::AmountsOff::currency?
+              currency: Stigg::Models::V1::CouponCreateResponse::Data::AmountsOff::currency
             }
 
             type currency =

data/sig/stigg/models/v1/coupon_list_params.rbs

@@ -2,36 +2,36 @@ module Stigg
   module Models
     module V1
       type coupon_list_params =
-        { ending_before: String, limit: Integer, starting_after: String }
+        { after: String, before: String, limit: Integer }
         & Stigg::Internal::Type::request_parameters
 
       class CouponListParams < Stigg::Internal::Type::BaseModel
         extend Stigg::Internal::Type::RequestParameters::Converter
         include Stigg::Internal::Type::RequestParameters
 
-        attr_reader ending_before: String?
+        attr_reader after: String?
 
-        def ending_before=: (String) -> String
+        def after=: (String) -> String
 
-        attr_reader limit: Integer?
+        attr_reader before: String?
 
-        def limit=: (Integer) -> Integer
+        def before=: (String) -> String
 
-        attr_reader starting_after: String?
+        attr_reader limit: Integer?
 
-        def starting_after=: (String) -> String
+        def limit=: (Integer) -> Integer
 
         def initialize: (
-          ?ending_before: String,
+          ?after: String,
+          ?before: String,
           ?limit: Integer,
-          ?starting_after: String,
           ?request_options: Stigg::request_opts
         ) -> void
 
         def to_hash: -> {
-          ending_before: String,
+          after: String,
+          before: String,
           limit: Integer,
-          starting_after: String,
           request_options: Stigg::RequestOptions
         }
       end