cloudinary-account-provisioning 0.1.0

data/lib/cld_provisioning/billingusage.rb

@@ -0,0 +1,231 @@
+# Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+# @generated-id: 7c99219d7600
+
+# typed: true
+# frozen_string_literal: true
+
+require "faraday"
+require "faraday/multipart"
+require "faraday/retry"
+require "sorbet-runtime"
+
+require_relative "sdk_hooks/hooks"
+require_relative "utils/retries"
+
+module CldProvisioning
+  extend T::Sig
+
+  class BillingUsage
+    extend T::Sig
+
+    sig { params(sdk_config: SDKConfiguration).void }
+    def initialize(sdk_config)
+      @sdk_configuration = sdk_config
+    end
+
+    sig { params(base_url: String, url_variables: T.nilable(T::Hash[Symbol, T.any(String, T::Enum)])).returns(String) }
+    def get_url(base_url:, url_variables: nil)
+      sd_base_url, sd_options = @sdk_configuration.get_server_details
+
+      if base_url.nil?
+        base_url = sd_base_url
+      end
+
+      if url_variables.nil?
+        url_variables = sd_options
+      end
+
+      return Utils.template_url(base_url, url_variables)
+    end
+
+    sig {
+      params(
+        account_id: T.nilable(::String),
+        year: T.nilable(::Integer),
+        include_prodenv_breakdown: T.nilable(T::Boolean),
+        timeout_ms: T.nilable(Integer),
+        http_headers: T.nilable(T::Hash[T.any(String, Symbol), String])
+      )
+        .returns(T::Array[Models::Shared::BillingUsageResponse])
+    }
+    def get(account_id: nil, year: nil, include_prodenv_breakdown: nil, timeout_ms: nil, http_headers: nil)
+      # get - Get billing usage information
+      # Retrieve billing usage metrics for your account and product environments,
+      # including storage, bandwidth, impressions, and transformations.
+      #
+      # If `year` is provided:
+      #   - **Annual subscription**: Returns the single annual usage cycle that began in the specified year (if any).
+      #   - **Monthly subscription**: Returns all monthly usage cycles that began in the specified year.
+      #
+      # If `year` is not provided:
+      #   - Returns usage for the year in which the current active subscription period began.
+      #   - If no active subscription exists, an empty list is returned.
+      #
+      # **Note**: Usage metrics are updated daily, so calling this endpoint once per day gives you the latest data.
+      #
+      request = Models::Operations::GetBillingUsageRequest.new(
+        account_id: account_id,
+        year: year,
+        include_prodenv_breakdown: include_prodenv_breakdown
+      )
+      url, params = @sdk_configuration.get_server_details
+      base_url = Utils.template_url(url, params)
+      url = Utils.generate_url(
+        Models::Operations::GetBillingUsageRequest,
+        base_url,
+        "/v1_1/provisioning/accounts/{account_id}/billing_usage",
+        request,
+        @sdk_configuration.globals
+      )
+      headers = {}
+      headers = T.cast(headers, T::Hash[String, String])
+      query_params = Utils.get_query_params(
+        Models::Operations::GetBillingUsageRequest,
+        request,
+        nil,
+        @sdk_configuration.globals
+      )
+      headers["Accept"] = "application/json"
+      headers["user-agent"] = @sdk_configuration.user_agent
+
+      security = @sdk_configuration.security_source&.call
+
+      timeout = (timeout_ms.to_f / 1000) unless timeout_ms.nil?
+      timeout ||= @sdk_configuration.timeout
+
+      connection = @sdk_configuration.client
+
+      hook_ctx = SDKHooks::HookContext.new(
+        config: @sdk_configuration,
+        base_url: base_url,
+        oauth2_scopes: nil,
+        operation_id: "getBillingUsage",
+        security_source: @sdk_configuration.security_source
+      )
+
+      error = T.let(nil, T.nilable(StandardError))
+      http_response = T.let(nil, T.nilable(Faraday::Response))
+
+      begin
+        http_response = T.must(connection).get(url) do |req|
+          req.headers.merge!(headers)
+          req.options.timeout = timeout unless timeout.nil?
+          req.params = query_params
+          Utils.configure_request_security(req, security)
+          http_headers&.each do |key, value|
+            req.headers[key.to_s] = value
+          end
+
+          @sdk_configuration.hooks.before_request(
+            hook_ctx: SDKHooks::BeforeRequestHookContext.new(
+              hook_ctx: hook_ctx
+            ),
+            request: req
+          )
+        end
+
+      rescue StandardError => e
+        error = e
+      ensure
+        if http_response.nil? || Utils.error_status?(http_response.status)
+          http_response = @sdk_configuration.hooks.after_error(
+            error: error,
+            hook_ctx: SDKHooks::AfterErrorHookContext.new(
+              hook_ctx: hook_ctx
+            ),
+            response: http_response
+          )
+        else
+          http_response = @sdk_configuration.hooks.after_success(
+            hook_ctx: SDKHooks::AfterSuccessHookContext.new(
+              hook_ctx: hook_ctx
+            ),
+            response: http_response
+          )
+        end
+
+        if http_response.nil?
+          raise error if !error.nil?
+          raise "no response"
+        end
+      end
+
+      content_type = http_response.headers.fetch("Content-Type", "application/octet-stream")
+      if Utils.match_status_code(http_response.status, ["200"])
+        if Utils.match_content_type(content_type, "application/json")
+          @sdk_configuration.hooks.after_success(
+            hook_ctx: SDKHooks::AfterSuccessHookContext.new(
+              hook_ctx: hook_ctx
+            ),
+            response: http_response
+          )
+          response_data = http_response.env.response_body
+          obj = Crystalline.unmarshal_json(
+            JSON.parse(response_data),
+            Crystalline::Array.new(Models::Shared::BillingUsageResponse)
+          )
+
+          return obj
+        else
+          raise(
+            ::CldProvisioning::Models::Errors::APIError.new(
+              status_code: http_response.status,
+              body: http_response.env.response_body,
+              raw_response: http_response
+            ),
+            "Unknown content type received"
+          )
+        end
+      elsif Utils.match_status_code(http_response.status, ["400", "401", "403", "404", "429"])
+        if Utils.match_content_type(content_type, "application/json")
+          @sdk_configuration.hooks.after_success(
+            hook_ctx: SDKHooks::AfterSuccessHookContext.new(
+              hook_ctx: hook_ctx
+            ),
+            response: http_response
+          )
+          response_data = http_response.env.response_body
+          obj = Crystalline.unmarshal_json(JSON.parse(response_data), Models::Errors::ErrorResponse)
+          raise obj
+        else
+          raise(
+            ::CldProvisioning::Models::Errors::APIError.new(
+              status_code: http_response.status,
+              body: http_response.env.response_body,
+              raw_response: http_response
+            ),
+            "Unknown content type received"
+          )
+        end
+      elsif Utils.match_status_code(http_response.status, ["4XX"])
+        raise(
+          ::CldProvisioning::Models::Errors::APIError.new(
+            status_code: http_response.status,
+            body: http_response.env.response_body,
+            raw_response: http_response
+          ),
+          "API error occurred"
+        )
+      elsif Utils.match_status_code(http_response.status, ["5XX"])
+        raise(
+          ::CldProvisioning::Models::Errors::APIError.new(
+            status_code: http_response.status,
+            body: http_response.env.response_body,
+            raw_response: http_response
+          ),
+          "API error occurred"
+        )
+      else
+        raise(
+          ::CldProvisioning::Models::Errors::APIError.new(
+            status_code: http_response.status,
+            body: http_response.env.response_body,
+            raw_response: http_response
+          ),
+          "Unknown status code received"
+        )
+
+      end
+    end
+  end
+end

data/lib/cld_provisioning/cldprovisioning.rb

@@ -0,0 +1,173 @@
+# Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+# @generated-id: 83640ebe3597
+
+# typed: true
+# frozen_string_literal: true
+
+require "faraday"
+require "faraday/multipart"
+require "faraday/retry"
+require "sorbet-runtime"
+
+require_relative "sdk_hooks/hooks"
+require_relative "utils/retries"
+
+module CldProvisioning
+  extend T::Sig
+
+  class CldProvisioning
+    extend T::Sig
+
+    attr_accessor(
+      :product_environments,
+      :access_keys,
+      :users,
+      :user_groups,
+      :billing_usage,
+      :public,
+      :system_policies,
+      :custom_policies,
+      :effective_policies,
+      :roles,
+      :principals
+    )
+
+    # Instantiates the SDK, configuring it with the provided parameters.
+    #
+    # @param client [Faraday::Connection, nil] The faraday HTTP client to use for all operations
+    # @param retry_config [::CldProvisioning::Utils::RetryConfig, nil] The retry configuration to use for all operations
+    # @param timeout_ms [Integer, nil] Request timeout in milliseconds for all operations
+    # @param security [Models::Shared::Security, nil] The security details required for authentication
+    # @param security_source [Proc{|| Models::Shared::Security, nil}] A function that returns security details required for authentication
+    # @param account_id [String, nil] Configures the account_id parameter for all supported operations
+    # @param region [::CldProvisioning::Models::ServerVariables::ServerRegion, nil] Allows setting the region variable for url substitution
+    # @param host [String, nil] Allows setting the host variable for url substitution
+    # @param server_idx [Integer, nil] The index of the server to use for all operations
+    # @param server_url [String, nil] The server URL to use for all operations
+    # @param url_params [Hash{Symbol => String}, nil] Parameters to optionally template the server URL with
+    sig do
+      params(
+        client: T.nilable(Faraday::Connection),
+        retry_config: T.nilable(::CldProvisioning::Utils::RetryConfig),
+        timeout_ms: T.nilable(Integer),
+        security: T.nilable(Models::Shared::Security),
+        security_source: T.nilable(T.proc.returns(Models::Shared::Security)),
+        account_id: T.nilable(::String),
+        region: T.nilable(::CldProvisioning::Models::ServerVariables::ServerRegion),
+        host: T.nilable(::String),
+        server_idx: T.nilable(Integer),
+        server_url: T.nilable(String),
+        url_params: T.nilable(T::Hash[Symbol, String])
+      )
+        .void
+    end
+    def initialize(
+      client: nil,
+      retry_config: nil,
+      timeout_ms: nil,
+      security: nil,
+      security_source: nil,
+      account_id: nil,
+      region: nil,
+      host: nil,
+      server_idx: nil,
+      server_url: nil,
+      url_params: nil
+    )
+
+      connection_options = {
+        request: {
+          params_encoder: Faraday::FlatParamsEncoder
+        }
+      }
+      connection_options[:request][:timeout] = (timeout_ms.to_f / 1000) unless timeout_ms.nil?
+
+      client ||= Faraday.new(**connection_options) do |f|
+        f.request(:multipart, {flat_encode: true})
+        # f.response :logger, nil, { headers: true, bodies: true, errors: true }
+      end
+
+      has_custom_server_variable = !region.nil? || !host.nil?
+      region = region.nil? ? "api" : region.serialize
+      host = host.nil? ? "api.cloudinary.com" : host
+      if !server_url.nil?
+        if !url_params.nil?
+          server_url = Utils.template_url(server_url, url_params)
+        elsif has_custom_server_variable
+          url_params = {
+            region: region,
+            host: host
+          }
+          server_url = Utils.template_url(server_url, url_params)
+        end
+      end
+
+      server_idx = 0 if server_idx.nil?
+
+      server_params = [
+        {
+          region: region
+        },
+        {
+          host: host
+        }
+      ]
+
+      globals = {
+        'parameters': {
+          'queryParam': {},
+          'pathParam': {
+            'account_id': account_id
+          },
+          'header': {}
+        }
+      }
+      hooks = SDKHooks::Hooks.new
+      @sdk_configuration = SDKConfiguration.new(
+        client,
+        hooks,
+        retry_config,
+        timeout_ms,
+        security,
+        security_source,
+        server_url,
+        server_idx,
+        server_params,
+        globals
+      )
+      @sdk_configuration = hooks.sdk_init(config: @sdk_configuration)
+      init_sdks
+    end
+
+    sig { void }
+    def init_sdks
+      @product_environments = ProductEnvironments.new(@sdk_configuration)
+      @access_keys = AccessKeys.new(@sdk_configuration)
+      @users = Users.new(@sdk_configuration)
+      @user_groups = UserGroups.new(@sdk_configuration)
+      @billing_usage = BillingUsage.new(@sdk_configuration)
+      @public = Public.new(@sdk_configuration)
+      @system_policies = SystemPolicies.new(@sdk_configuration)
+      @custom_policies = CustomPolicies.new(@sdk_configuration)
+      @effective_policies = EffectivePolicies.new(@sdk_configuration)
+      @roles = Roles.new(@sdk_configuration)
+      @principals = Principals.new(@sdk_configuration)
+    end
+
+    sig { params(base_url: String, url_variables: T.nilable(T::Hash[Symbol, T.any(String, T::Enum)])).returns(String) }
+    def get_url(base_url:, url_variables: nil)
+      sd_base_url, sd_options = @sdk_configuration.get_server_details
+
+      if base_url.nil?
+        base_url = sd_base_url
+      end
+
+      if url_variables.nil?
+        url_variables = sd_options
+      end
+
+      return Utils.template_url(base_url, url_variables)
+    end
+
+  end
+end