stigg 0.1.0.pre.alpha.2 → 0.1.0.pre.alpha.3

data/lib/stigg/resources/v1/customers.rb

@@ -7,42 +7,8 @@ module Stigg
         # @return [Stigg::Resources::V1::Customers::PaymentMethod]
         attr_reader :payment_method
 
-        # @return [Stigg::Resources::V1::Customers::Usage]
-        attr_reader :usage
-
-        # Provision customer
-        #
-        # @overload create(id:, coupon_id: nil, default_payment_method: nil, email: nil, integrations: nil, metadata: nil, name: nil, request_options: {})
-        #
-        # @param id [String] Customer slug
-        #
-        # @param coupon_id [String, nil] Customer level coupon
-        #
-        # @param default_payment_method [Stigg::Models::V1::CustomerCreateParams::DefaultPaymentMethod, nil] The default payment method details
-        #
-        # @param email [String, nil] The email of the customer
-        #
-        # @param integrations [Array<Stigg::Models::V1::CustomerCreateParams::Integration>] List of integrations
-        #
-        # @param metadata [Hash{Symbol=>String}] Additional metadata
-        #
-        # @param name [String, nil] The name of the customer
-        #
-        # @param request_options [Stigg::RequestOptions, Hash{Symbol=>Object}, nil]
-        #
-        # @return [Stigg::Models::V1::CustomerResponse]
-        #
-        # @see Stigg::Models::V1::CustomerCreateParams
-        def create(params)
-          parsed, options = Stigg::V1::CustomerCreateParams.dump_request(params)
-          @client.request(
-            method: :post,
-            path: "api/v1/customers",
-            body: parsed,
-            model: Stigg::V1::CustomerResponse,
-            options: options
-          )
-        end
+        # @return [Stigg::Resources::V1::Customers::PromotionalEntitlements]
+        attr_reader :promotional_entitlements
 
         # Get a single customer by ID
         #
@@ -143,6 +109,62 @@ module Stigg
           )
         end
 
+        # Bulk import customers
+        #
+        # @overload import(customers:, request_options: {})
+        #
+        # @param customers [Array<Stigg::Models::V1::CustomerImportParams::Customer>] List of customer objects to import
+        #
+        # @param request_options [Stigg::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Stigg::Models::V1::CustomerImportResponse]
+        #
+        # @see Stigg::Models::V1::CustomerImportParams
+        def import(params)
+          parsed, options = Stigg::V1::CustomerImportParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: "api/v1/customers/import",
+            body: parsed,
+            model: Stigg::Models::V1::CustomerImportResponse,
+            options: options
+          )
+        end
+
+        # Provision customer
+        #
+        # @overload provision(id:, coupon_id: nil, default_payment_method: nil, email: nil, integrations: nil, metadata: nil, name: nil, request_options: {})
+        #
+        # @param id [String] Customer slug
+        #
+        # @param coupon_id [String, nil] Customer level coupon
+        #
+        # @param default_payment_method [Stigg::Models::V1::CustomerProvisionParams::DefaultPaymentMethod, nil] The default payment method details
+        #
+        # @param email [String, nil] The email of the customer
+        #
+        # @param integrations [Array<Stigg::Models::V1::CustomerProvisionParams::Integration>] List of integrations
+        #
+        # @param metadata [Hash{Symbol=>String}] Additional metadata
+        #
+        # @param name [String, nil] The name of the customer
+        #
+        # @param request_options [Stigg::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Stigg::Models::V1::CustomerResponse]
+        #
+        # @see Stigg::Models::V1::CustomerProvisionParams
+        def provision(params)
+          parsed, options = Stigg::V1::CustomerProvisionParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: "api/v1/customers",
+            body: parsed,
+            model: Stigg::V1::CustomerResponse,
+            options: options
+          )
+        end
+
         # Unarchive customer
         #
         # @overload unarchive(id, request_options: {})
@@ -169,7 +191,7 @@ module Stigg
         def initialize(client:)
           @client = client
           @payment_method = Stigg::Resources::V1::Customers::PaymentMethod.new(client: client)
-          @usage = Stigg::Resources::V1::Customers::Usage.new(client: client)
+          @promotional_entitlements = Stigg::Resources::V1::Customers::PromotionalEntitlements.new(client: client)
         end
       end
     end

data/lib/stigg/resources/v1/events.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Stigg
+  module Resources
+    class V1
+      class Events
+        # Report usage events
+        #
+        # @overload report(events:, request_options: {})
+        #
+        # @param events [Array<Stigg::Models::V1::EventReportParams::Event>] A list of usage events to report
+        #
+        # @param request_options [Stigg::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Stigg::Models::V1::EventReportResponse]
+        #
+        # @see Stigg::Models::V1::EventReportParams
+        def report(params)
+          parsed, options = Stigg::V1::EventReportParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: "api/v1/events",
+            body: parsed,
+            model: Stigg::Models::V1::EventReportResponse,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Stigg::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/stigg/resources/v1/subscriptions/future_update.rb

@@ -13,14 +13,14 @@ module Stigg
           #
           # @param request_options [Stigg::RequestOptions, Hash{Symbol=>Object}, nil]
           #
-          # @return [Stigg::Models::V1::Subscriptions::FutureUpdateCancelPendingPaymentResponse]
+          # @return [Stigg::Models::V1::Subscriptions::CancelSubscription]
           #
           # @see Stigg::Models::V1::Subscriptions::FutureUpdateCancelPendingPaymentParams
           def cancel_pending_payment(id, params = {})
             @client.request(
               method: :delete,
               path: ["api/v1/subscriptions/%1$s/future-update/pending-payment", id],
-              model: Stigg::Models::V1::Subscriptions::FutureUpdateCancelPendingPaymentResponse,
+              model: Stigg::V1::Subscriptions::CancelSubscription,
               options: params[:request_options]
             )
           end
@@ -33,14 +33,14 @@ module Stigg
           #
           # @param request_options [Stigg::RequestOptions, Hash{Symbol=>Object}, nil]
           #
-          # @return [Stigg::Models::V1::Subscriptions::FutureUpdateCancelScheduleResponse]
+          # @return [Stigg::Models::V1::Subscriptions::CancelSubscription]
           #
           # @see Stigg::Models::V1::Subscriptions::FutureUpdateCancelScheduleParams
           def cancel_schedule(id, params = {})
             @client.request(
               method: :delete,
               path: ["api/v1/subscriptions/%1$s/future-update/schedule", id],
-              model: Stigg::Models::V1::Subscriptions::FutureUpdateCancelScheduleResponse,
+              model: Stigg::V1::Subscriptions::CancelSubscription,
               options: params[:request_options]
             )
           end

data/lib/stigg/resources/v1/subscriptions.rb

@@ -7,96 +7,76 @@ module Stigg
         # @return [Stigg::Resources::V1::Subscriptions::FutureUpdate]
         attr_reader :future_update
 
-        # Provision subscription
+        # Get a single subscription by ID
         #
-        # @overload create(customer_id:, plan_id:, id: nil, addons: nil, applied_coupon: nil, await_payment_confirmation: nil, billing_country_code: nil, billing_id: nil, billing_information: nil, billing_period: nil, budget: nil, charges: nil, checkout_options: nil, metadata: nil, minimum_spend: nil, paying_customer_id: nil, payment_collection_method: nil, price_overrides: nil, resource_id: nil, salesforce_id: nil, schedule_strategy: nil, start_date: nil, subscription_entitlements: nil, trial_override_configuration: nil, unit_quantity: nil, request_options: {})
+        # @overload retrieve(id, request_options: {})
         #
-        # @param customer_id [String] Customer ID to provision the subscription for
+        # @param id [String] The unique identifier of the entity
         #
-        # @param plan_id [String] Plan ID to provision
+        # @param request_options [Stigg::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @param id [String] Unique identifier for the subscription
+        # @return [Stigg::Models::V1::Subscription]
         #
-        # @param addons [Array<Stigg::Models::V1::SubscriptionCreateParams::Addon>]
+        # @see Stigg::Models::V1::SubscriptionRetrieveParams
+        def retrieve(id, params = {})
+          @client.request(
+            method: :get,
+            path: ["api/v1/subscriptions/%1$s", id],
+            model: Stigg::V1::Subscription,
+            options: params[:request_options]
+          )
+        end
+
+        # Update a subscription
         #
-        # @param applied_coupon [Stigg::Models::V1::SubscriptionCreateParams::AppliedCoupon] Coupon configuration
+        # @overload update(id, addons: nil, applied_coupon: nil, await_payment_confirmation: nil, billing_information: nil, billing_period: nil, budget: nil, charges: nil, metadata: nil, minimum_spend: nil, price_overrides: nil, promotion_code: nil, schedule_strategy: nil, subscription_entitlements: nil, trial_end_date: nil, request_options: {})
         #
-        # @param await_payment_confirmation [Boolean] Whether to wait for payment confirmation before returning the subscription
+        # @param id [String] The unique identifier of the entity
         #
-        # @param billing_country_code [String, nil] The ISO 3166-1 alpha-2 country code for billing
+        # @param addons [Array<Stigg::Models::V1::SubscriptionUpdateParams::Addon>]
         #
-        # @param billing_id [String, nil] External billing system identifier
+        # @param applied_coupon [Stigg::Models::V1::SubscriptionUpdateParams::AppliedCoupon]
         #
-        # @param billing_information [Stigg::Models::V1::SubscriptionCreateParams::BillingInformation]
+        # @param await_payment_confirmation [Boolean]
         #
-        # @param billing_period [Symbol, Stigg::Models::V1::SubscriptionCreateParams::BillingPeriod] Billing period (MONTHLY or ANNUALLY)
+        # @param billing_information [Stigg::Models::V1::SubscriptionUpdateParams::BillingInformation]
         #
-        # @param budget [Stigg::Models::V1::SubscriptionCreateParams::Budget, nil]
+        # @param billing_period [Symbol, Stigg::Models::V1::SubscriptionUpdateParams::BillingPeriod]
         #
-        # @param charges [Array<Stigg::Models::V1::SubscriptionCreateParams::Charge>]
+        # @param budget [Stigg::Models::V1::SubscriptionUpdateParams::Budget, nil]
         #
-        # @param checkout_options [Stigg::Models::V1::SubscriptionCreateParams::CheckoutOptions] Checkout page configuration for payment collection
+        # @param charges [Array<Stigg::Models::V1::SubscriptionUpdateParams::Charge>]
         #
         # @param metadata [Hash{Symbol=>String}] Additional metadata for the subscription
         #
-        # @param minimum_spend [Stigg::Models::V1::SubscriptionCreateParams::MinimumSpend, nil]
+        # @param minimum_spend [Stigg::Models::V1::SubscriptionUpdateParams::MinimumSpend, nil]
         #
-        # @param paying_customer_id [String, nil] Optional paying customer ID for split billing scenarios
+        # @param price_overrides [Array<Stigg::Models::V1::SubscriptionUpdateParams::PriceOverride>]
         #
-        # @param payment_collection_method [Symbol, Stigg::Models::V1::SubscriptionCreateParams::PaymentCollectionMethod] How payments should be collected for this subscription
+        # @param promotion_code [String]
         #
-        # @param price_overrides [Array<Stigg::Models::V1::SubscriptionCreateParams::PriceOverride>]
+        # @param schedule_strategy [Symbol, Stigg::Models::V1::SubscriptionUpdateParams::ScheduleStrategy]
         #
-        # @param resource_id [String, nil] Optional resource ID for multi-instance subscriptions
-        #
-        # @param salesforce_id [String, nil] Salesforce ID
+        # @param subscription_entitlements [Array<Stigg::Models::V1::SubscriptionUpdateParams::SubscriptionEntitlement>]
         #
-        # @param schedule_strategy [Symbol, Stigg::Models::V1::SubscriptionCreateParams::ScheduleStrategy] Strategy for scheduling subscription changes
-        #
-        # @param start_date [Time] Subscription start date
-        #
-        # @param subscription_entitlements [Array<Stigg::Models::V1::SubscriptionCreateParams::SubscriptionEntitlement>]
-        #
-        # @param trial_override_configuration [Stigg::Models::V1::SubscriptionCreateParams::TrialOverrideConfiguration] Trial period override settings
-        #
-        # @param unit_quantity [Float]
+        # @param trial_end_date [Time] Subscription trial end date
         #
         # @param request_options [Stigg::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [Stigg::Models::V1::SubscriptionCreateResponse]
+        # @return [Stigg::Models::V1::Subscription]
         #
-        # @see Stigg::Models::V1::SubscriptionCreateParams
-        def create(params)
-          parsed, options = Stigg::V1::SubscriptionCreateParams.dump_request(params)
+        # @see Stigg::Models::V1::SubscriptionUpdateParams
+        def update(id, params = {})
+          parsed, options = Stigg::V1::SubscriptionUpdateParams.dump_request(params)
           @client.request(
-            method: :post,
-            path: "api/v1/subscriptions",
+            method: :patch,
+            path: ["api/v1/subscriptions/%1$s", id],
             body: parsed,
-            model: Stigg::Models::V1::SubscriptionCreateResponse,
+            model: Stigg::V1::Subscription,
             options: options
           )
         end
 
-        # Get a single subscription by ID
-        #
-        # @overload retrieve(id, request_options: {})
-        #
-        # @param id [String] The unique identifier of the entity
-        #
-        # @param request_options [Stigg::RequestOptions, Hash{Symbol=>Object}, nil]
-        #
-        # @return [Stigg::Models::V1::SubscriptionRetrieveResponse]
-        #
-        # @see Stigg::Models::V1::SubscriptionRetrieveParams
-        def retrieve(id, params = {})
-          @client.request(
-            method: :get,
-            path: ["api/v1/subscriptions/%1$s", id],
-            model: Stigg::Models::V1::SubscriptionRetrieveResponse,
-            options: params[:request_options]
-          )
-        end
-
         # Get a list of subscriptions
         #
         # @overload list(after: nil, before: nil, customer_id: nil, limit: nil, status: nil, request_options: {})
@@ -128,6 +108,36 @@ module Stigg
           )
         end
 
+        # Cancel subscription
+        #
+        # @overload cancel(id, cancellation_action: nil, cancellation_time: nil, end_date: nil, prorate: nil, request_options: {})
+        #
+        # @param id [String] The unique identifier of the entity
+        #
+        # @param cancellation_action [Symbol, Stigg::Models::V1::SubscriptionCancelParams::CancellationAction] Action on cancellation (downgrade or revoke)
+        #
+        # @param cancellation_time [Symbol, Stigg::Models::V1::SubscriptionCancelParams::CancellationTime] When to cancel (immediate, period end, or date)
+        #
+        # @param end_date [Time] Subscription end date
+        #
+        # @param prorate [Boolean] If set, enables or disables prorating of credits on subscription cancellation.
+        #
+        # @param request_options [Stigg::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Stigg::Models::V1::Subscription]
+        #
+        # @see Stigg::Models::V1::SubscriptionCancelParams
+        def cancel(id, params = {})
+          parsed, options = Stigg::V1::SubscriptionCancelParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: ["api/v1/subscriptions/%1$s/cancel", id],
+            body: parsed,
+            model: Stigg::V1::Subscription,
+            options: options
+          )
+        end
+
         # Some parameter documentations has been truncated, see
         # {Stigg::Models::V1::SubscriptionDelegateParams} for more details.
         #
@@ -141,7 +151,7 @@ module Stigg
         #
         # @param request_options [Stigg::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [Stigg::Models::V1::SubscriptionDelegateResponse]
+        # @return [Stigg::Models::V1::Subscription]
         #
         # @see Stigg::Models::V1::SubscriptionDelegateParams
         def delegate(id, params)
@@ -150,7 +160,29 @@ module Stigg
             method: :post,
             path: ["api/v1/subscriptions/%1$s/delegate", id],
             body: parsed,
-            model: Stigg::Models::V1::SubscriptionDelegateResponse,
+            model: Stigg::V1::Subscription,
+            options: options
+          )
+        end
+
+        # Bulk import subscriptions
+        #
+        # @overload import(subscriptions:, request_options: {})
+        #
+        # @param subscriptions [Array<Stigg::Models::V1::SubscriptionImportParams::Subscription>] List of subscription objects to import
+        #
+        # @param request_options [Stigg::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Stigg::Models::V1::SubscriptionImportResponse]
+        #
+        # @see Stigg::Models::V1::SubscriptionImportParams
+        def import(params)
+          parsed, options = Stigg::V1::SubscriptionImportParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: "api/v1/subscriptions/import",
+            body: parsed,
+            model: Stigg::Models::V1::SubscriptionImportResponse,
             options: options
           )
         end
@@ -165,7 +197,7 @@ module Stigg
         #
         # @param request_options [Stigg::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [Stigg::Models::V1::SubscriptionMigrateResponse]
+        # @return [Stigg::Models::V1::Subscription]
         #
         # @see Stigg::Models::V1::SubscriptionMigrateParams
         def migrate(id, params = {})
@@ -174,7 +206,7 @@ module Stigg
             method: :post,
             path: ["api/v1/subscriptions/%1$s/migrate", id],
             body: parsed,
-            model: Stigg::Models::V1::SubscriptionMigrateResponse,
+            model: Stigg::V1::Subscription,
             options: options
           )
         end
@@ -229,6 +261,76 @@ module Stigg
           )
         end
 
+        # Provision subscription
+        #
+        # @overload provision(customer_id:, plan_id:, id: nil, addons: nil, applied_coupon: nil, await_payment_confirmation: nil, billing_country_code: nil, billing_id: nil, billing_information: nil, billing_period: nil, budget: nil, charges: nil, checkout_options: nil, metadata: nil, minimum_spend: nil, paying_customer_id: nil, payment_collection_method: nil, price_overrides: nil, resource_id: nil, salesforce_id: nil, schedule_strategy: nil, start_date: nil, subscription_entitlements: nil, trial_override_configuration: nil, unit_quantity: nil, request_options: {})
+        #
+        # @param customer_id [String] Customer ID to provision the subscription for
+        #
+        # @param plan_id [String] Plan ID to provision
+        #
+        # @param id [String] Unique identifier for the subscription
+        #
+        # @param addons [Array<Stigg::Models::V1::SubscriptionProvisionParams::Addon>]
+        #
+        # @param applied_coupon [Stigg::Models::V1::SubscriptionProvisionParams::AppliedCoupon] Coupon configuration
+        #
+        # @param await_payment_confirmation [Boolean] Whether to wait for payment confirmation before returning the subscription
+        #
+        # @param billing_country_code [String, nil] The ISO 3166-1 alpha-2 country code for billing
+        #
+        # @param billing_id [String, nil] External billing system identifier
+        #
+        # @param billing_information [Stigg::Models::V1::SubscriptionProvisionParams::BillingInformation]
+        #
+        # @param billing_period [Symbol, Stigg::Models::V1::SubscriptionProvisionParams::BillingPeriod] Billing period (MONTHLY or ANNUALLY)
+        #
+        # @param budget [Stigg::Models::V1::SubscriptionProvisionParams::Budget, nil]
+        #
+        # @param charges [Array<Stigg::Models::V1::SubscriptionProvisionParams::Charge>]
+        #
+        # @param checkout_options [Stigg::Models::V1::SubscriptionProvisionParams::CheckoutOptions] Checkout page configuration for payment collection
+        #
+        # @param metadata [Hash{Symbol=>String}] Additional metadata for the subscription
+        #
+        # @param minimum_spend [Stigg::Models::V1::SubscriptionProvisionParams::MinimumSpend, nil]
+        #
+        # @param paying_customer_id [String, nil] Optional paying customer ID for split billing scenarios
+        #
+        # @param payment_collection_method [Symbol, Stigg::Models::V1::SubscriptionProvisionParams::PaymentCollectionMethod] How payments should be collected for this subscription
+        #
+        # @param price_overrides [Array<Stigg::Models::V1::SubscriptionProvisionParams::PriceOverride>]
+        #
+        # @param resource_id [String, nil] Optional resource ID for multi-instance subscriptions
+        #
+        # @param salesforce_id [String, nil] Salesforce ID
+        #
+        # @param schedule_strategy [Symbol, Stigg::Models::V1::SubscriptionProvisionParams::ScheduleStrategy] Strategy for scheduling subscription changes
+        #
+        # @param start_date [Time] Subscription start date
+        #
+        # @param subscription_entitlements [Array<Stigg::Models::V1::SubscriptionProvisionParams::SubscriptionEntitlement>]
+        #
+        # @param trial_override_configuration [Stigg::Models::V1::SubscriptionProvisionParams::TrialOverrideConfiguration] Trial period override settings
+        #
+        # @param unit_quantity [Float]
+        #
+        # @param request_options [Stigg::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Stigg::Models::V1::SubscriptionProvisionResponse]
+        #
+        # @see Stigg::Models::V1::SubscriptionProvisionParams
+        def provision(params)
+          parsed, options = Stigg::V1::SubscriptionProvisionParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: "api/v1/subscriptions",
+            body: parsed,
+            model: Stigg::Models::V1::SubscriptionProvisionResponse,
+            options: options
+          )
+        end
+
         # Transfer subscription to resource
         #
         # @overload transfer(id, destination_resource_id:, request_options: {})
@@ -239,7 +341,7 @@ module Stigg
         #
         # @param request_options [Stigg::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [Stigg::Models::V1::SubscriptionTransferResponse]
+        # @return [Stigg::Models::V1::Subscription]
         #
         # @see Stigg::Models::V1::SubscriptionTransferParams
         def transfer(id, params)
@@ -248,7 +350,7 @@ module Stigg
             method: :post,
             path: ["api/v1/subscriptions/%1$s/transfer", id],
             body: parsed,
-            model: Stigg::Models::V1::SubscriptionTransferResponse,
+            model: Stigg::V1::Subscription,
             options: options
           )
         end

data/lib/stigg/resources/v1/usage.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+module Stigg
+  module Resources
+    class V1
+      class Usage
+        # Get usage history
+        #
+        # @overload history(feature_id, customer_id:, start_date:, end_date: nil, group_by: nil, resource_id: nil, request_options: {})
+        #
+        # @param feature_id [String] Path param: Feature id
+        #
+        # @param customer_id [String] Path param: Customer id
+        #
+        # @param start_date [Time] Query param: The start date of the range
+        #
+        # @param end_date [Time] Query param: The end date of the range
+        #
+        # @param group_by [String] Query param
+        #
+        # @param resource_id [String, nil] Query param: Resource id
+        #
+        # @param request_options [Stigg::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Stigg::Models::V1::UsageHistoryResponse]
+        #
+        # @see Stigg::Models::V1::UsageHistoryParams
+        def history(feature_id, params)
+          parsed, options = Stigg::V1::UsageHistoryParams.dump_request(params)
+          customer_id =
+            parsed.delete(:customer_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :get,
+            path: ["api/v1/usage/%1$s/history/%2$s", customer_id, feature_id],
+            query: parsed.transform_keys(
+              start_date: "startDate",
+              end_date: "endDate",
+              group_by: "groupBy",
+              resource_id: "resourceId"
+            ),
+            model: Stigg::Models::V1::UsageHistoryResponse,
+            options: options
+          )
+        end
+
+        # Report usage measurements
+        #
+        # @overload report(usages:, request_options: {})
+        #
+        # @param usages [Array<Stigg::Models::V1::UsageReportParams::Usage>] A list of usage reports to be submitted in bulk
+        #
+        # @param request_options [Stigg::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Stigg::Models::V1::UsageReportResponse]
+        #
+        # @see Stigg::Models::V1::UsageReportParams
+        def report(params)
+          parsed, options = Stigg::V1::UsageReportParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: "api/v1/usage",
+            body: parsed,
+            model: Stigg::Models::V1::UsageReportResponse,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Stigg::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/stigg/resources/v1.rb

@@ -12,49 +12,11 @@ module Stigg
       # @return [Stigg::Resources::V1::Coupons]
       attr_reader :coupons
 
-      # Report usage events
-      #
-      # @overload create_event(events:, request_options: {})
-      #
-      # @param events [Array<Stigg::Models::V1CreateEventParams::Event>] A list of usage events to report
-      #
-      # @param request_options [Stigg::RequestOptions, Hash{Symbol=>Object}, nil]
-      #
-      # @return [Stigg::Models::V1CreateEventResponse]
-      #
-      # @see Stigg::Models::V1CreateEventParams
-      def create_event(params)
-        parsed, options = Stigg::V1CreateEventParams.dump_request(params)
-        @client.request(
-          method: :post,
-          path: "api/v1/events",
-          body: parsed,
-          model: Stigg::Models::V1CreateEventResponse,
-          options: options
-        )
-      end
+      # @return [Stigg::Resources::V1::Events]
+      attr_reader :events
 
-      # Report usage measurements
-      #
-      # @overload create_usage(usages:, request_options: {})
-      #
-      # @param usages [Array<Stigg::Models::V1CreateUsageParams::Usage>] A list of usage reports to be submitted in bulk
-      #
-      # @param request_options [Stigg::RequestOptions, Hash{Symbol=>Object}, nil]
-      #
-      # @return [Stigg::Models::V1CreateUsageResponse]
-      #
-      # @see Stigg::Models::V1CreateUsageParams
-      def create_usage(params)
-        parsed, options = Stigg::V1CreateUsageParams.dump_request(params)
-        @client.request(
-          method: :post,
-          path: "api/v1/usage",
-          body: parsed,
-          model: Stigg::Models::V1CreateUsageResponse,
-          options: options
-        )
-      end
+      # @return [Stigg::Resources::V1::Usage]
+      attr_reader :usage
 
       # @api private
       #
@@ -64,6 +26,8 @@ module Stigg
         @customers = Stigg::Resources::V1::Customers.new(client: client)
         @subscriptions = Stigg::Resources::V1::Subscriptions.new(client: client)
         @coupons = Stigg::Resources::V1::Coupons.new(client: client)
+        @events = Stigg::Resources::V1::Events.new(client: client)
+        @usage = Stigg::Resources::V1::Usage.new(client: client)
       end
     end
   end

data/lib/stigg/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Stigg
-  VERSION = "0.1.0.pre.alpha.2"
+  VERSION = "0.1.0.pre.alpha.3"
 end