tungo-sdk 0.2.0

data/lib/tungo/internal/util.rb

@@ -0,0 +1,223 @@
+# frozen_string_literal: true
+
+# The official Ruby SDK for the Tungo Platform API. Start with {Tungo::Client}.
+module Tungo
+  # Marks a keyword argument that was not given. It differs from +nil+, which is sent as JSON
+  # +null+ wherever the API accepts it.
+  OMIT = Object.new
+  def OMIT.inspect
+    "Tungo::OMIT"
+  end
+  OMIT.freeze
+
+  # @api private
+  module Internal
+    # Holds a secret so that it never shows up in +inspect+, +pp+ or an exception message.
+    class Secret
+      def initialize(value)
+        @reveal = -> { value }
+        freeze
+      end
+
+      # @return [String] the secret itself
+      def reveal
+        @reveal.call
+      end
+
+      def inspect
+        "[REDACTED]"
+      end
+      alias to_s inspect
+
+      def pretty_print(printer)
+        printer.text(inspect)
+      end
+    end
+
+    # Request-building and retry helpers shared by the client, the transport and the tests.
+    # A BigDecimal on its way into JSON: written as a plain decimal number, digit for digit.
+    class DecimalNumber
+      def initialize(value)
+        raise ValidationError, "a JSON number must be finite, got #{value}" unless value.finite?
+
+        @value = value
+      end
+
+      def to_json(*)
+        @value.frac.zero? ? @value.to_i.to_s : @value.to_s("F")
+      end
+    end
+
+    # Pure helpers shared by the client, the transport and the webhook code.
+    module Util
+      RETRY_BASE_SECONDS = 0.5
+      RETRY_MAX_SECONDS = 8.0
+      RETRY_JITTER = (0.75..1.0)
+      # A server-requested delay above this is not slept: the error is raised instead.
+      MAX_RETRY_AFTER_SECONDS = 60
+      SAFE_METHODS = %w[GET HEAD PUT DELETE].freeze
+      NUMBER = /\A[0-9]+(\.[0-9]+)?\z/
+      UNRESERVED = /[^A-Za-z0-9\-._~]/n
+
+      module_function
+
+      # @return [Float] monotonic clock reading in seconds
+      def monotonic
+        Process.clock_gettime(Process::CLOCK_MONOTONIC)
+      end
+
+      # Percent-encodes every byte outside the RFC 3986 unreserved set.
+      def percent_encode(text)
+        text.to_s.b.gsub(UNRESERVED) { |byte| format("%%%02X", byte.ord) }.force_encoding(Encoding::US_ASCII)
+      end
+
+      # Encodes one path parameter as a single path segment. An empty value, "." and ".." are
+      # rejected because they would change which resource the request addresses.
+      def encode_path_segment(value, name = "path parameter")
+        text = value.is_a?(Symbol) || value.is_a?(Integer) ? value.to_s : value
+        raise ValidationError, "#{name} must be a String, got #{value.class}" unless text.is_a?(String)
+        raise ValidationError, "#{name} must not be empty" if text.empty?
+        raise ValidationError, "#{name} must not be #{text.inspect}" if [".", ".."].include?(text)
+
+        percent_encode(text)
+      end
+
+      # Fills a path template such as "/v1/companies/{co}/chat/{id}".
+      def build_path(template, params)
+        template.gsub(/\{(\w+)\}/) do
+          name = Regexp.last_match(1)
+          encode_path_segment(params.fetch(name.to_sym), name)
+        end
+      end
+
+      # Renders one query or header value as text.
+      def scalar_text(value)
+        case value
+        when String then value
+        when Symbol, Integer, true, false then value.to_s
+        when Time then value.nsec.zero? ? value.iso8601 : value.iso8601(6)
+        when Date then value.iso8601
+        when Float
+          raise ValidationError, "a query value must be a finite number" unless value.finite?
+
+          value.to_s
+        when BigDecimal then value.to_s("F")
+        else raise ValidationError, "unsupported query value of type #{value.class}"
+        end
+      end
+
+      # Builds a query string. +nil+ and omitted values are left out, arrays repeat the key,
+      # booleans are true/false and times are RFC 3339.
+      #
+      # @param params [Hash, Array<Array>] name/value pairs in order
+      # @return [String] the query string without the leading "?"
+      def encode_query(params)
+        pairs = []
+        params.each do |name, value|
+          next if value.nil? || OMIT.equal?(value)
+
+          (value.is_a?(Array) ? value : [value]).each do |item|
+            next if item.nil?
+
+            pairs << "#{percent_encode(name)}=#{percent_encode(scalar_text(item))}"
+          end
+        end
+        pairs.join("&")
+      end
+
+      # Marks bytes received from the network as UTF-8 when they are valid UTF-8.
+      def text(bytes)
+        return bytes unless bytes.is_a?(String) && bytes.encoding == Encoding::BINARY
+
+        utf8 = bytes.dup.force_encoding(Encoding::UTF_8)
+        utf8.valid_encoding? ? utf8 : bytes
+      end
+
+      # Parses JSON received from the API. A number with a fraction or an exponent becomes a
+      # BigDecimal, so that no amount of money ever passes through a binary float.
+      def parse_json(text)
+        JSON.parse(text, decimal_class: BigDecimal)
+      end
+
+      # Replaces every BigDecimal with an object that prints its exact decimal digits as a JSON number.
+      def exact_numbers(value)
+        case value
+        when BigDecimal then DecimalNumber.new(value)
+        when Hash then value.transform_values { |item| exact_numbers(item) }
+        when Array then value.map { |item| exact_numbers(item) }
+        else value
+        end
+      end
+
+      # Lower-cases header names and joins repeated values.
+      def normalize_headers(headers)
+        result = {}
+        (headers || {}).each do |name, value|
+          value = value.join(", ") if value.is_a?(Array)
+          result[name.to_s.downcase] = text(value.to_s) unless value.nil?
+        end
+        result
+      end
+
+      # Parses +retry-after-ms+ (wins) and +Retry-After+ (seconds or an HTTP-date).
+      #
+      # @return [Float, nil] seconds to wait, or nil when the headers carry no usable value
+      def parse_retry_after(headers, now: Time.now)
+        headers = normalize_headers(headers)
+        millis = headers["retry-after-ms"]&.strip
+        return millis.to_f / 1000 if millis && NUMBER.match?(millis)
+
+        value = headers["retry-after"]&.strip
+        return nil if value.nil? || value.empty?
+        return value.to_f if NUMBER.match?(value)
+
+        [Time.httpdate(value) - now, 0.0].max.to_f
+      rescue ArgumentError
+        nil
+      end
+
+      # Delay before retry number +attempt+ (0-based): min(0.5 s * 2^attempt, 8 s) with jitter.
+      def backoff_delay(attempt, jitter: rand(RETRY_JITTER))
+        [RETRY_BASE_SECONDS * (2**attempt), RETRY_MAX_SECONDS].min * jitter
+      end
+
+      # Decides whether a failed request may be repeated.
+      #
+      # @param method [String, Symbol] HTTP method
+      # @param idempotency_key [Boolean] whether the request carries an Idempotency-Key
+      # @param cause [Integer, Symbol, String] HTTP status, :connection_error or :timeout
+      def retryable?(method, idempotency_key, cause)
+        return false unless SAFE_METHODS.include?(method.to_s.upcase) || idempotency_key
+
+        if cause.is_a?(Integer)
+          APIError::RETRYABLE_STATUSES.include?(cause)
+        else
+          %w[connection_error
+             timeout].include?(cause.to_s)
+        end
+      end
+
+      # A secret that is sent as a header value (the API key) must be printable ASCII without
+      # spaces. A trailing line break from a file or a secret store is the usual mistake; it is
+      # refused here, by name only: the secret itself is never printed.
+      def check_header_secret(value, name)
+        return if value.valid_encoding? && value.match?(/\A[\x21-\x7E]+\z/)
+
+        raise ConfigError, "api_key (#{name}) must be printable ASCII without spaces, line breaks or control " \
+                           "characters; check it for a trailing newline. The key itself is not shown"
+      end
+
+      # Compares two strings in constant time; strings of different length are never equal.
+      def secure_compare(left, right)
+        left.bytesize == right.bytesize && OpenSSL.fixed_length_secure_compare(left, right)
+      end
+
+      # Serialises a value as JSON, reporting values JSON cannot express as a validation error.
+      def generate_json(value)
+        JSON.generate(exact_numbers(value))
+      rescue JSON::GeneratorError, EncodingError => e
+        raise ValidationError, "the request body cannot be encoded as JSON: #{e.message}"
+      end
+    end
+  end
+end

data/lib/tungo/models/api_key.rb

@@ -0,0 +1,132 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Ключ API организации — без секрета.
+    class ApiKey < Tungo::Model
+      # @!attribute [r] all_companies
+      #   Ключ на все компании организации, в том числе будущие: те, где создатель ключа состоит сейчас,
+      #   и в каждой — не шире его текущей роли
+      #   @return [Boolean]
+      required :all_companies, :boolean
+
+      # @!attribute [r] allowed_ips
+      #   С каких IP и подсетей CIDR ключ работает; с другого адреса — 403 ip_not_allowed. null — с
+      #   любых
+      #   @return [Array<String>, nil]
+      required :allowed_ips, array_of(:string), nullable: true
+
+      # @!attribute [r] company_ids
+      #   Компании, к которым ключ даёт доступ (co_…); пусто у ключа на все компании (all_companies)
+      #   @return [Array<String>]
+      required :company_ids, array_of(:string)
+
+      # @!attribute [r] created_at
+      #   Когда выпущен, ISO 8601 UTC
+      #   @return [String]
+      required :created_at, :string
+
+      # @!attribute [r] created_by
+      #   Кто выпустил (usr_…). Ключ действует от его имени и не шире его прав: создатель перестал быть
+      #   владельцем или админом — ключ не работает
+      #   @return [String]
+      required :created_by, :string
+
+      # @!attribute [r] disabled_at
+      #   Когда выключен, ISO 8601 UTC; null — не выключен
+      #   @return [String, nil]
+      required :disabled_at, :string, nullable: true
+
+      # @!attribute [r] expires_at
+      #   Когда ключ перестаёт действовать, ISO 8601 UTC (срок есть у каждого ключа)
+      #   @return [String]
+      required :expires_at, :string
+
+      # @!attribute [r] id
+      #   id ключа (key_…) — для адресов …/api-keys/{id}
+      #   @return [String]
+      required :id, :string
+
+      # @!attribute [r] last_used_at
+      #   Когда ключом пользовались последний раз, ISO 8601 UTC (точность — около минуты); null — ещё ни
+      #   разу
+      #   @return [String, nil]
+      required :last_used_at, :string, nullable: true
+
+      # @!attribute [r] last_used_ip
+      #   С какого IP-адреса был последний запрос; null — ещё ни разу
+      #   @return [String, nil]
+      required :last_used_ip, :string, nullable: true
+
+      # @!attribute [r] monthly_cap_tiyn
+      #   Месячный потолок расхода ИИ по ключу в тиынах (1 ₸ = 100 тиын; показывать значение / 100 ₸),
+      #   календарный месяц по Алматы; null — без потолка ключа
+      #   @return [Integer, nil]
+      required :monthly_cap_tiyn, :integer, nullable: true
+
+      # @!attribute [r] name
+      #   Название ключа для людей
+      #   @return [String]
+      required :name, :string
+
+      # @!attribute [r] permissions
+      #   Права ключа: `company.read` — читать данные компаний (есть всегда); `chat.use` — работать с
+      #   ИИ-бухгалтером; `proposals.create` — готовить документы для 1С; `proposals.approve` — одобрять
+      #   запись в 1С; `automations.read` —…
+      #   @return [Array<String>]
+      required :permissions, array_of(:ApiKeyPermissionItem)
+
+      # @!attribute [r] prefix
+      #   Открытая часть ключа для показа — узнать ключ среди других; сам ключ (tg_…_секрет) целиком не
+      #   хранится
+      #   @return [String]
+      required :prefix, :string
+
+      # @!attribute [r] previous_secret_valid_until
+      #   После смены секрета (roll): до какого времени ещё действует прежний, ISO 8601 UTC; null —
+      #   прежнего нет
+      #   @return [String, nil]
+      required :previous_secret_valid_until, :string, nullable: true
+
+      # @!attribute [r] revoked_at
+      #   Когда отозван, ISO 8601 UTC; null — не отозван
+      #   @return [String, nil]
+      required :revoked_at, :string, nullable: true
+
+      # @!attribute [r] status
+      #   Состояние: `active` — действует; `disabled` — выключен (disabled_at), не работает, можно
+      #   включить; `expired` — истёк срок (expires_at), не работает; `revoked` — отозван (revoked_at),
+      #   не работает. Неактивные показывать се…
+      #   @return [String]
+      required :status, :ApiKeyStatus
+
+      # @!attribute [r] workspace_id
+      #   Организация ключа (ws_…)
+      #   @return [String]
+      required :workspace_id, :string
+
+      # @!attribute [r] write_kinds
+      #   Предел записи в 1С по ключу: какие виды документов ключ может одобрять (как kinds правила
+      #   автоодобрения: sale, purchase, bank_receipt, bank_payment, counterparty, contract,
+      #   inventory_writeoff, cash_order_in, cash_order_o…
+      #   @return [Array<String>, nil]
+      required :write_kinds, array_of(:string), nullable: true
+
+      # @!attribute [r] write_max_amount_per_day_tiyn
+      #   Предел записи в 1С по ключу: сумма всех документов, одобренных ключом за день по Алматы, в
+      #   тиынах. Документ с неизвестным исходом записи (1С не ответила) тоже считается. null — без
+      #   предела
+      #   @return [Integer, nil]
+      required :write_max_amount_per_day_tiyn, :integer, nullable: true
+
+      # @!attribute [r] write_max_amount_per_document_tiyn
+      #   Предел записи в 1С по ключу: потолок суммы одного документа, который ключ одобряет (approve,
+      #   approve-batch), в тиынах (1 ₸ = 100 тиын). Документ дороже или без известной суммы ключ не
+      #   запишет (403, error.code key_write_l…
+      #   @return [Integer, nil]
+      required :write_max_amount_per_document_tiyn, :integer, nullable: true
+    end
+  end
+end

data/lib/tungo/models/api_key_create.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Новый ключ API.
+    class ApiKeyCreate < Tungo::Model
+      # @!attribute [r] all_companies
+      #   Ключ на все компании организации, в том числе будущие: список company_ids не передаётся. Ключ
+      #   видит те компании, где его создатель состоит сейчас, и в каждой — не шире его текущей роли. По
+      #   умолчанию false
+      #   @return [Boolean, nil]
+      optional :all_companies, :boolean
+
+      # @!attribute [r] allowed_ips
+      #   С каких адресов ключ работает: IP или подсети CIDR (до 100), IPv4 и IPv6. С другого адреса —
+      #   403, error.code ip_not_allowed. null — с любых
+      #   @return [Array<String>, nil]
+      optional :allowed_ips, array_of(:string), nullable: true
+
+      # @!attribute [r] company_ids
+      #   Компании, к которым ключ даёт доступ (co_…), от 1 до 200; все — из этой организации, и в
+      #   каждой у создателя должны быть выдаваемые права. Для webhooks.manage — обязательно все
+      #   компании организации. Обязательно, если не a…
+      #   @return [Array<String>, nil]
+      optional :company_ids, array_of(:string)
+
+      # @!attribute [r] expires_at
+      #   Когда ключ перестанет действовать, ISO 8601; только в будущем и не дальше настройки платформы
+      #   (по умолчанию 365 дней). null или нет — через срок по умолчанию (90 дней)
+      #   @return [String, nil]
+      optional :expires_at, :string, nullable: true
+
+      # @!attribute [r] monthly_cap_tiyn
+      #   Месячный потолок расхода ИИ по ключу в тиынах (1 ₸ = 100 тиын), календарный месяц по Алматы;
+      #   дойдя до него, вызовы ИИ по ключу отклоняются до 1-го числа. null — без потолка ключа
+      #   @return [Integer, nil]
+      optional :monthly_cap_tiyn, :integer, nullable: true
+
+      # @!attribute [r] name
+      #   Название ключа для людей (1–100 знаков): где он используется
+      #   @return [String]
+      required :name, :string
+
+      # @!attribute [r] permissions
+      #   Права ключа (1–20): `company.read` — читать данные компаний (добавляется всегда, даже если не
+      #   передано); `chat.use` — работать с ИИ-бухгалтером; `proposals.create` — готовить документы для
+      #   1С; `proposals.approve` — одобр…
+      #   @return [Array<String>]
+      required :permissions, array_of(:string)
+
+      # @!attribute [r] write_kinds
+      #   Предел записи в 1С по ключу: какие виды документов ключ может одобрять (как kinds правила
+      #   автоодобрения: sale, purchase, bank_receipt, bank_payment, counterparty, contract,
+      #   inventory_writeoff, cash_order_in, cash_order_o…
+      #   @return [Array<String>, nil]
+      optional :write_kinds, array_of(:ApiKeyCreateWriteKindItem), nullable: true
+
+      # @!attribute [r] write_max_amount_per_day_tiyn
+      #   Предел записи в 1С по ключу: сумма всех документов, одобренных ключом за день по Алматы, в
+      #   тиынах. Документ с неизвестным исходом записи (1С не ответила) тоже считается. null — без
+      #   предела. При изменении: не передан — не…
+      #   @return [Integer, nil]
+      optional :write_max_amount_per_day_tiyn, :integer, nullable: true
+
+      # @!attribute [r] write_max_amount_per_document_tiyn
+      #   Предел записи в 1С по ключу: потолок суммы одного документа, который ключ одобряет (approve,
+      #   approve-batch), в тиынах (1 ₸ = 100 тиын). Документ дороже или без известной суммы ключ не
+      #   запишет (403, error.code key_write_l…
+      #   @return [Integer, nil]
+      optional :write_max_amount_per_document_tiyn, :integer, nullable: true
+    end
+  end
+end

data/lib/tungo/models/api_key_create_write_kind_item.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # The values of +ApiKeyCreateWriteKindItem+.
+    #
+    # A value this SDK version does not know is passed through unchanged.
+    module ApiKeyCreateWriteKindItem
+      extend Tungo::Internal::Enum
+
+      SALE = "sale"
+      PURCHASE = "purchase"
+      BANK_RECEIPT = "bank_receipt"
+      BANK_PAYMENT = "bank_payment"
+      COUNTERPARTY = "counterparty"
+      CONTRACT = "contract"
+      INVENTORY_WRITEOFF = "inventory_writeoff"
+      CASH_ORDER_IN = "cash_order_in"
+      CASH_ORDER_OUT = "cash_order_out"
+      ADVANCE_REPORT = "advance_report"
+      REVERT = "revert"
+    end
+  end
+end

data/lib/tungo/models/api_key_created.rb

@@ -0,0 +1,154 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Выпущенный ключ — с секретом один раз.
+    class ApiKeyCreated < Tungo::Model
+      # @!attribute [r] all_companies
+      #   Ключ на все компании организации, в том числе будущие: те, где создатель ключа состоит сейчас,
+      #   и в каждой — не шире его текущей роли
+      #   @return [Boolean]
+      required :all_companies, :boolean
+
+      # @!attribute [r] allowed_ips
+      #   С каких IP и подсетей CIDR ключ работает; с другого адреса — 403 ip_not_allowed. null — с
+      #   любых
+      #   @return [Array<String>, nil]
+      required :allowed_ips, array_of(:string), nullable: true
+
+      # @!attribute [r] company_ids
+      #   Компании, к которым ключ даёт доступ (co_…); пусто у ключа на все компании (all_companies)
+      #   @return [Array<String>]
+      required :company_ids, array_of(:string)
+
+      # @!attribute [r] created_at
+      #   Когда выпущен, ISO 8601 UTC
+      #   @return [String]
+      required :created_at, :string
+
+      # @!attribute [r] created_by
+      #   Кто выпустил (usr_…). Ключ действует от его имени и не шире его прав: создатель перестал быть
+      #   владельцем или админом — ключ не работает
+      #   @return [String]
+      required :created_by, :string
+
+      # @!attribute [r] disabled_at
+      #   Когда выключен, ISO 8601 UTC; null — не выключен
+      #   @return [String, nil]
+      required :disabled_at, :string, nullable: true
+
+      # @!attribute [r] expires_at
+      #   Когда ключ перестаёт действовать, ISO 8601 UTC (срок есть у каждого ключа)
+      #   @return [String]
+      required :expires_at, :string
+
+      # @!attribute [r] id
+      #   id ключа (key_…) — для адресов …/api-keys/{id}
+      #   @return [String]
+      required :id, :string
+
+      # @!attribute [r] key
+      #   Ключ целиком (tg_…) — только в этом ответе: показать один раз с кнопкой «Скопировать» и
+      #   предупреждением, что больше его не увидеть. В повторе по Idempotency-Key — null
+      #   @return [String, nil]
+      required :key, :string, nullable: true
+
+      # @!attribute [r] key_note
+      #   Только в повторе по Idempotency-Key: почему key = null и что делать, если ключ потерян
+      #   (отозвать и выпустить новый)
+      #   @return [String, nil]
+      optional :key_note, :string
+
+      # @!attribute [r] last_used_at
+      #   Когда ключом пользовались последний раз, ISO 8601 UTC (точность — около минуты); null — ещё ни
+      #   разу
+      #   @return [String, nil]
+      required :last_used_at, :string, nullable: true
+
+      # @!attribute [r] last_used_ip
+      #   С какого IP-адреса был последний запрос; null — ещё ни разу
+      #   @return [String, nil]
+      required :last_used_ip, :string, nullable: true
+
+      # @!attribute [r] monthly_cap_tiyn
+      #   Месячный потолок расхода ИИ по ключу в тиынах (1 ₸ = 100 тиын; показывать значение / 100 ₸),
+      #   календарный месяц по Алматы; null — без потолка ключа
+      #   @return [Integer, nil]
+      required :monthly_cap_tiyn, :integer, nullable: true
+
+      # @!attribute [r] name
+      #   Название ключа для людей
+      #   @return [String]
+      required :name, :string
+
+      # @!attribute [r] permissions
+      #   Права ключа: `company.read` — читать данные компаний (есть всегда); `chat.use` — работать с
+      #   ИИ-бухгалтером; `proposals.create` — готовить документы для 1С; `proposals.approve` — одобрять
+      #   запись в 1С; `automations.read` —…
+      #   @return [Array<String>]
+      required :permissions, array_of(:ApiKeyCreatedPermissionItem)
+
+      # @!attribute [r] prefix
+      #   Открытая часть ключа для показа — узнать ключ среди других; сам ключ (tg_…_секрет) целиком не
+      #   хранится
+      #   @return [String]
+      required :prefix, :string
+
+      # @!attribute [r] previous_secret_valid_until
+      #   После смены секрета (roll): до какого времени ещё действует прежний, ISO 8601 UTC; null —
+      #   прежнего нет
+      #   @return [String, nil]
+      required :previous_secret_valid_until, :string, nullable: true
+
+      # @!attribute [r] revoked_at
+      #   Когда отозван, ISO 8601 UTC; null — не отозван
+      #   @return [String, nil]
+      required :revoked_at, :string, nullable: true
+
+      # @!attribute [r] status
+      #   Состояние: `active` — действует; `disabled` — выключен (disabled_at), не работает, можно
+      #   включить; `expired` — истёк срок (expires_at), не работает; `revoked` — отозван (revoked_at),
+      #   не работает. Неактивные показывать се…
+      #   @return [String]
+      required :status, :ApiKeyCreatedStatus
+
+      # @!attribute [r] warnings
+      #   Ключ сохранён, но вызовы ИИ по нему сейчас не пройдут или он пишет в 1С без пределов: баланс
+      #   платформы пуст (402 platform_balance_exhausted), подключение компании не оплачено (402
+      #   onboarding_unpaid), потолок ключа меньше…
+      #   @return [Array<Tungo::Models::ApiKeyWarning>]
+      required :warnings, array_of(:ApiKeyWarning)
+
+      # @!attribute [r] workspace_id
+      #   Организация ключа (ws_…)
+      #   @return [String]
+      required :workspace_id, :string
+
+      # @!attribute [r] write_kinds
+      #   Предел записи в 1С по ключу: какие виды документов ключ может одобрять (как kinds правила
+      #   автоодобрения: sale, purchase, bank_receipt, bank_payment, counterparty, contract,
+      #   inventory_writeoff, cash_order_in, cash_order_o…
+      #   @return [Array<String>, nil]
+      required :write_kinds, array_of(:string), nullable: true
+
+      # @!attribute [r] write_max_amount_per_day_tiyn
+      #   Предел записи в 1С по ключу: сумма всех документов, одобренных ключом за день по Алматы, в
+      #   тиынах. Документ с неизвестным исходом записи (1С не ответила) тоже считается. null — без
+      #   предела
+      #   @return [Integer, nil]
+      required :write_max_amount_per_day_tiyn, :integer, nullable: true
+
+      # @!attribute [r] write_max_amount_per_document_tiyn
+      #   Предел записи в 1С по ключу: потолок суммы одного документа, который ключ одобряет (approve,
+      #   approve-batch), в тиынах (1 ₸ = 100 тиын). Документ дороже или без известной суммы ключ не
+      #   запишет (403, error.code key_write_l…
+      #   @return [Integer, nil]
+      required :write_max_amount_per_document_tiyn, :integer, nullable: true
+
+      # Credentials: #inspect shows [REDACTED] instead of their values.
+      sensitive "key"
+    end
+  end
+end

data/lib/tungo/models/api_key_created_permission_item.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # The values of +ApiKeyCreatedPermissionItem+.
+    #
+    # A value this SDK version does not know is passed through unchanged.
+    module ApiKeyCreatedPermissionItem
+      extend Tungo::Internal::Enum
+
+      COMPANY_READ = "company.read"
+      CHAT_USE = "chat.use"
+      PROPOSALS_CREATE = "proposals.create"
+      PROPOSALS_APPROVE = "proposals.approve"
+      AUTOMATIONS_MANAGE = "automations.manage"
+      AUTOMATIONS_READ = "automations.read"
+      WEBHOOKS_MANAGE = "webhooks.manage"
+    end
+  end
+end

data/lib/tungo/models/api_key_created_status.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Состояние: `active` — действует; `disabled` — выключен (disabled_at), не работает, можно включить;
+    # `expired` — истёк срок (expires_at), не работает; `revoked` — отозван (revoked_at), не работает.
+    # Неактивные показывать се…
+    #
+    # A value this SDK version does not know is passed through unchanged.
+    module ApiKeyCreatedStatus
+      extend Tungo::Internal::Enum
+
+      ACTIVE = "active"
+      DISABLED = "disabled"
+      EXPIRED = "expired"
+      REVOKED = "revoked"
+    end
+  end
+end