didit-sdk 1.0.0

data/sig/didit/authentication/types.rbs

@@ -0,0 +1,114 @@
+module Didit
+  class Authentication
+    class OrganizationClaim < Didit::Model
+      def id: () -> String?
+      def role: () -> String?
+    end
+
+    class ActorClaim < Didit::Model
+      def sub: () -> String?
+      def agent: () -> String?
+      def scopes: () -> Array[String]?
+    end
+
+    class VerifiedClaims < Didit::Model
+      def level: () -> String?
+      def over_18: () -> bool?
+      def over_21: () -> bool?
+      def given_name: () -> String?
+      def family_name: () -> String?
+      def birthdate: () -> String?
+      def nationality: () -> String?
+      def country: () -> String?
+      def document_verified: () -> bool?
+      def liveness: () -> bool?
+    end
+
+    class TokenClaims < Didit::Model
+      def iss: () -> String?
+      def sub: () -> String?
+      def aud: () -> (String | Array[String] | nil)
+      def sid: () -> String?
+      def jti: () -> String?
+      def iat: () -> (Integer | Float | nil)
+      def exp: () -> (Integer | Float | nil)
+      def nbf: () -> (Integer | Float | nil)
+      def vendor_data: () -> String?
+      def amr: () -> Array[String]?
+      def org: () -> OrganizationClaim?
+      def verified: () -> VerifiedClaims?
+      def act: () -> ActorClaim?
+    end
+
+    class AccessTokenClaims < TokenClaims
+      def client_id: () -> String?
+    end
+
+    class IdTokenClaims < TokenClaims
+      def auth_time: () -> (Integer | Float | nil)
+      def nonce: () -> String?
+      def email: () -> String?
+      def email_verified: () -> bool?
+      def name: () -> String?
+      def phone_number: () -> String?
+    end
+
+    class TokenResponse < Didit::Model
+      SECRET_FIELDS: Array[String]
+
+      def access_token: () -> String?
+      def token_type: () -> String?
+      def expires_in: () -> Integer?
+      def refresh_token: () -> String?
+      def id_token: () -> String?
+      def scope: () -> String?
+      def session_id: () -> String?
+    end
+
+    class SessionCustomRole < Didit::Model
+      def key: () -> String?
+      def permissions: () -> Array[String]?
+    end
+
+    class SessionOrganization < Didit::Model
+      def organization_id: () -> String?
+      def organization_name: () -> String?
+      def role: () -> String?
+      def custom_role: () -> SessionCustomRole?
+    end
+
+    class Session < Didit::Model
+      def sub: () -> String?
+      def sid: () -> String?
+      def application_id: () -> String?
+      def vendor_data: () -> String?
+      def amr: () -> Array[String]?
+      def mfa_verified: () -> bool?
+      def email: () -> String?
+      def email_verified: () -> bool?
+      def phone: () -> String?
+      def verified_identity: () -> Hash[String, untyped]?
+      def verified: () -> VerifiedClaims?
+      def expires_at: () -> Time?
+      def post_logout_redirect_uri: () -> String?
+      def organizations: () -> Array[SessionOrganization]?
+    end
+
+    class StepUp < Didit::Model
+      def required: () -> bool?
+      def id: () -> String?
+      def rule: () -> String?
+      def verification_method: () -> String?
+      def status: () -> String?
+      def level: () -> String?
+      def amount: () -> String?
+      def currency: () -> String?
+      def created_at: () -> Time?
+      def completed_at: () -> Time?
+      def expires_at: () -> Time?
+      def verification_url: () -> String?
+      def expires_in: () -> Integer?
+      def approved?: () -> bool
+    end
+  end
+end

data/sig/didit/authentication.rbs

@@ -0,0 +1,81 @@
+module Didit
+  class Authentication
+    # One audience (the application id) or several, any of which is accepted.
+    type audience = String | Array[String]
+    # A money amount (String, Integer, Float or BigDecimal); sent as a decimal string.
+    type amount = String | Numeric
+
+    DEFAULT_TIMEOUT: Integer
+    DEFAULT_LEEWAY: Integer
+    DISCOVERY_PATH: String
+    JWKS_PATH: String
+    SESSION_PATH: String
+    STEP_UP_PATH: String
+    FETCH_ERRORS: Array[singleton(DiditError)]
+    UNRESERVED: Regexp
+    DECIMAL: Regexp
+    NUMBER: Regexp
+
+    def self.from_publishable_key: (String publishable_key, ?client_id: String?, ?timeout: Numeric, ?leeway: Numeric,
+                                    ?http_client: Internal::http_client?, ?clock: (^() -> (Integer | Float))?) -> Authentication
+    def self.create_pkce: () -> Pkce
+    def self.create_state: () -> String
+    def self.create_nonce: () -> String
+
+    attr_reader issuer: String
+    attr_reader client_id: String?
+    attr_reader timeout: Float
+    attr_reader leeway: Float
+
+    @clock: ^() -> (Integer | Float)
+    @cache: IssuerCache
+    @http: Http
+    @lock: Thread::Mutex
+    @token_issuer: String?
+
+    def initialize: (String issuer, ?client_id: String?, ?timeout: Numeric, ?leeway: Numeric,
+                     ?http_client: Internal::http_client?, ?clock: (^() -> (Integer | Float))?) -> void
+
+    def verify_access_token: (untyped token, ?audience: audience?) -> AccessTokenClaims
+    def verify_id_token: (untyped token, nonce: String?, ?audience: audience?) -> IdTokenClaims
+    def exchange_code: (String code, code_verifier: String, redirect_uri: String) -> TokenResponse
+    def refresh: (String refresh_token) -> TokenResponse
+    def get_session: (String access_token) -> Session
+    def revoke_session: (String access_token) -> nil
+    def create_step_up: (String access_token, action: String, ?amount: amount?, ?currency: String?,
+                         ?return_to: String?) -> StepUp
+    def retrieve_step_up: (String access_token, String step_up_id) -> StepUp
+    def discovery: () -> Hash[String, untyped]
+    def jwks: () -> Hash[String, untyped]
+    def close: () -> nil
+    def inspect: () -> String
+    def to_s: () -> String
+
+    private
+
+    def verify: (untyped token, Symbol kind, Array[String]? audience, String? nonce) -> Hash[String, untyped]
+    def token_issuer: () -> String
+    def expected_audience: (untyped audience, required: bool) -> Array[String]?
+    def current_discovery: () -> Discovery
+    def discovery_locked: () -> Discovery
+    def key_set: (String? kid) -> KeySet
+    def key_set_locked: (String? kid) -> KeySet
+    def keys_unavailable: () -> APIConnectionError
+    def parse_discovery: (Http::Call call, Internal::Transport::Response response) -> Discovery
+    def issuer_endpoint: (Http::Call call, Internal::Transport::Response response, Hash[String, untyped] data,
+                          String name) -> String
+    def endpoint_uri: (untyped value) -> URI::HTTP?
+    def token_request: (Hash[String, String] form, Array[String] secrets) -> TokenResponse
+    def bearer_call: (String http_method, URI::Generic uri, untyped access_token,
+                      ?json: Hash[String, untyped]?) -> Http::Call
+    def send_object: (Http::Call call) -> Hash[String, untyped]
+    def issuer_uri: (String path) -> URI::Generic
+    def required_text: (untyped value, String name) -> String
+    def optional_text: (untyped value, String name) -> String
+    def amount_text: (untyped amount) -> String
+    def plain_decimal: (String text) -> String?
+    def checked_client_id: (untyped client_id) -> String?
+    def checked_timeout: (untyped timeout) -> Float
+    def checked_leeway: (untyped leeway) -> Float
+  end
+end

data/sig/didit/client.rbs

@@ -0,0 +1,61 @@
+module Didit
+  class Client
+    include Resources::ClientMethods
+
+    DEFAULT_BASE_URL: String
+    DEFAULT_ACCOUNT_BASE_URL: String
+    DEFAULT_TIMEOUT: Float
+    DEFAULT_MAX_RETRIES: Integer
+
+    self.@deprecation_lock: Thread::Mutex
+    self.@deprecation_warned: Set[String]
+
+    def self.deprecation_lock: () -> Thread::Mutex
+    def self.deprecation_warned: () -> Set[String]
+
+    @config: Internal::Config
+    @transport: Internal::Transport
+    @raw: bool
+
+    def initialize: (?api_key: String?, ?organization_id: String?, ?application_id: String?, ?base_url: String?,
+                     ?account_base_url: String?, ?account_token: String?, ?timeout: Numeric, ?max_retries: Integer,
+                     ?default_headers: Hash[String, String], ?logger: untyped, ?http_client: Internal::http_client?) -> void
+
+    def base_url: () -> String
+    def account_base_url: () -> String
+    def organization_id: () -> String?
+    def application_id: () -> String?
+    def timeout: () -> Float
+    def max_retries: () -> Integer
+
+    def with_options: (?api_key: String?, ?account_token: String?, ?organization_id: String?,
+                       ?application_id: String?, ?base_url: String?, ?account_base_url: String?,
+                       ?timeout: Numeric, ?max_retries: Integer, ?default_headers: Hash[String, String],
+                       ?logger: untyped) -> Client
+    def with_raw_response: () -> Client
+    def raw_response?: () -> bool
+    def close: () -> nil
+    def inspect: () -> String
+    def to_s: () -> String
+
+    def request: (Symbol http_method, String path, ?path_params: Hash[String, untyped], ?query: Hash[String, untyped]?,
+                  ?body: untyped, ?encoding: Symbol, ?file_fields: Array[String], ?headers: Hash[String, untyped],
+                  ?auth: Symbol, ?api: Symbol, ?scope: Symbol?, ?response: Didit::type_spec?, ?page: Didit::type_spec?,
+                  ?accept: String, ?request_options: Didit::request_options?) ?{ (String chunk) -> void } -> untyped
+
+    def fetch_page: (Internal::Request::Prepared prepared, URI::Generic uri, Didit::type_spec item, Array[untyped] seen) -> Page[untyped]
+    def deprecated: (String name, String note) -> nil
+
+    attr_reader config: Internal::Config
+    attr_reader transport: Internal::Transport
+
+    def setup: (Internal::Config config, Internal::Transport transport, raw: bool) -> self
+
+    private
+
+    def copy: (Internal::Config config, raw: bool) -> Client
+    def parse: (Internal::Request::Prepared prepared, Internal::Transport::Response response, untyped type, untyped page) -> untyped
+    def check_status: (Internal::Request::Prepared prepared, Internal::Transport::Response response) -> Internal::Transport::Response
+    def parse_json: (Internal::Request::Prepared prepared, Internal::Transport::Response response) -> untyped
+  end
+end

data/sig/didit/errors.rbs

@@ -0,0 +1,80 @@
+module Didit
+  class DiditError < StandardError
+  end
+
+  class ConfigurationError < DiditError
+  end
+
+  class APIConnectionError < DiditError
+    attr_reader http_method: String?
+    attr_reader url: String?
+
+    def initialize: (?String message, ?http_method: String?, ?url: String?) -> void
+  end
+
+  class APITimeoutError < APIConnectionError
+  end
+
+  module ResponseDetails
+    attr_reader status: Integer
+    attr_reader headers: Hash[String, String]
+    attr_reader body: untyped
+    attr_reader request_id: String?
+
+    def status_code: () -> Integer
+  end
+
+  class APIResponseValidationError < DiditError
+    include ResponseDetails
+
+    def initialize: (String message, status: Integer, ?headers: Hash[String, String], ?body: untyped,
+                     ?request_id: String?) -> void
+  end
+
+  class APIStatusError < DiditError
+    include ResponseDetails
+
+    def initialize: (String message, status: Integer, ?headers: Hash[String, String], ?body: untyped,
+                     ?request_id: String?) -> void
+  end
+
+  class BadRequestError < APIStatusError
+  end
+
+  class AuthenticationError < APIStatusError
+  end
+
+  class PermissionDeniedError < APIStatusError
+  end
+
+  class NotFoundError < APIStatusError
+  end
+
+  class ConflictError < APIStatusError
+  end
+
+  class UnprocessableEntityError < APIStatusError
+  end
+
+  class RateLimitError < APIStatusError
+  end
+
+  class InternalServerError < APIStatusError
+  end
+
+  class WebhookVerificationError < DiditError
+    REASONS: Array[Symbol]
+
+    attr_reader reason: Symbol
+
+    def initialize: (Symbol reason, String message) -> void
+  end
+
+  class TokenVerificationError < DiditError
+    REASONS: Array[Symbol]
+
+    attr_reader reason: Symbol
+
+    def initialize: (Symbol reason, String message) -> void
+  end
+end

data/sig/didit/file_part.rbs

@@ -0,0 +1,19 @@
+module Didit
+  class FilePart
+    CONTENT_TYPES: Hash[String, String]
+    DEFAULT_CONTENT_TYPE: String
+
+    @content_type: String?
+
+    attr_reader content: String | Pathname | IO | StringIO
+    attr_reader filename: String?
+
+    def initialize: (String | Pathname | IO | StringIO content, ?filename: String?, ?content_type: String?) -> void
+    def self.from_path: (String | Pathname path, ?filename: String?, ?content_type: String?) -> FilePart
+    def self.wrap: (untyped value, String field) -> FilePart
+    def self.default_filename: (untyped content) -> String?
+    def content_type: () -> String
+    def read: () -> String
+    def inspect: () -> String
+  end
+end

data/sig/didit/internal.rbs

@@ -0,0 +1,199 @@
+module Didit
+  module Internal
+    # Builds the Net::HTTP for an origin (the +http_client:+ option).
+    type http_client = ^(URI::Generic uri) -> Net::HTTP
+
+    module Util
+      REQUEST_ID_HEADERS: Array[String]
+      REDACTED: String
+
+      def self?.user_agent: () -> String
+      def self?.client_header: () -> String
+      def self?.request_id: (Hash[String, String] headers) -> String?
+      def self?.redact: [T] (T value, Array[String?] secrets) -> T
+      def self?.redact_value: (untyped value, Array[String] secrets) -> untyped
+      def self?.origin: (URI::Generic | String uri) -> String
+      def self?.display_url: (URI::Generic | String uri) -> String
+      def self?.pause: (Float seconds) -> void
+      def self?.debug_from_env?: () -> bool
+    end
+
+    module Errors
+      STATUS_ERRORS: Hash[Integer, singleton(APIStatusError)]
+      DETAIL_KEYS: Array[String]
+
+      def self?.status_error: (status: Integer, headers: Hash[String, String], raw_body: String?, ?redact: Array[String?]) -> APIStatusError
+      def self?.parse_body: (String? raw_body) -> untyped
+      def self?.message_for: (Integer status, untyped body) -> String
+      def self?.detail_of: (untyped body) -> String?
+      def self?.hash_detail: (Hash[String, untyped] body) -> String?
+      def self?.present?: (untyped value) -> bool
+    end
+
+    class Config
+      DEFAULT_BASE_URL: String
+      DEFAULT_ACCOUNT_BASE_URL: String
+      DEFAULT_TIMEOUT: Float
+      DEFAULT_MAX_RETRIES: Integer
+      FIELDS: Array[Symbol]
+
+      attr_reader api_key: String?
+      attr_reader account_token: String?
+      attr_reader organization_id: String?
+      attr_reader application_id: String?
+      attr_reader base_url: String
+      attr_reader account_base_url: String
+      attr_reader timeout: Float
+      attr_reader max_retries: Integer
+      attr_reader default_headers: Hash[String, String?]
+      attr_reader logger: untyped
+      attr_reader http_client: http_client?
+
+      def initialize: (**untyped options) -> void
+      def merge: (Hash[Symbol, untyped] changes) -> Config
+      def self.check_url: (Symbol name, untyped url) -> String
+      def self.check_timeout: (untyped value) -> Float
+      def self.check_max_retries: (untyped value) -> Integer
+
+      private
+
+      def present: (untyped value) -> String?
+      def check_headers: (untyped headers) -> Hash[String, String?]
+      def check_http_client: (untyped value) -> http_client?
+    end
+
+    module Log
+      def self?.response: (Config config, Request::Prepared prepared, Transport::Response response, Float elapsed) -> void
+      def self?.retry: (Config config, Request::Prepared prepared, String reason, Numeric delay, Integer retries_left) -> void
+      def self?.enabled?: (Config config) -> bool
+      def self?.write: (Config config, String message) -> void
+    end
+
+    module Multipart
+      def self?.encode: (Hash[String, untyped] fields, Array[String] file_fields) -> [String, String]
+      def self?.text: (untyped value) -> String
+      def self?.field_part: (String body, String boundary, String name, String value) -> void
+      def self?.file_part: (String body, String boundary, String name, FilePart part) -> void
+      def self?.quote: (untyped value) -> String
+    end
+
+    module Request
+      class Prepared < Struct[untyped]
+        attr_accessor http_method: Symbol
+        attr_accessor uri: URI::Generic
+        attr_accessor headers: Hash[String, String]
+        attr_accessor body: String?
+        attr_accessor timeout: Float
+        attr_accessor max_retries: Integer
+        attr_accessor origin: String
+        attr_accessor redact: Array[String]
+
+        def self?.new: (http_method: Symbol, uri: URI::Generic, headers: Hash[String, String], body: String?,
+                       timeout: Float, max_retries: Integer, origin: String, redact: Array[String]) -> Prepared
+      end
+
+      class Result < Struct[untyped]
+        attr_accessor response: Transport::Response
+        attr_accessor retries_taken: Integer
+        attr_accessor elapsed: Float
+
+        def self?.new: (response: Transport::Response, retries_taken: Integer, elapsed: Float) -> Result
+      end
+
+      type options = { timeout: Float, max_retries: Integer, extra_headers: Hash[untyped, untyped],
+                       extra_query: Hash[untyped, untyped], extra_body: Hash[untyped, untyped] }
+
+      IDEMPOTENT: Array[Symbol]
+      INITIAL_RETRY_DELAY: Float
+      MAX_RETRY_DELAY: Float
+      MAX_RETRY_AFTER: Float
+      OPTION_KEYS: Array[Symbol]
+      UNRESERVED: Regexp
+
+      def self?.options: (Config config, untyped raw) -> options
+      def self?.prepare: (Config config, Symbol http_method, String path, options opts, ?path_params: Hash[String, untyped],
+                         ?query: Hash[String, untyped]?, ?body: untyped, ?encoding: Symbol, ?file_fields: Array[String],
+                         ?headers: Hash[String, untyped], ?auth: Symbol, ?api: Symbol, ?scope: Symbol?,
+                         ?accept: String) -> Prepared
+      def self?.scoped: (Config config, Hash[String, untyped] path_params) -> Hash[String, untyped]
+      def self?.check_credentials: (Config config, Symbol auth) -> void
+      def self?.encode_path: (String path, Hash[String, untyped] params) -> String
+      def self?.path_segment: (String name, untyped value) -> String
+      def self?.merge: (untyped values, untyped extra) -> Hash[String, untyped]
+      def self?.encode_query: (Hash[String, untyped] values) -> String
+      def self?.query_value: (untyped value) -> String
+      def self?.encode_body: (untyped body, untyped extra_body, Symbol encoding, Array[String] file_fields) -> [String?, String?]
+      def self?.json_value: (untyped value) -> untyped
+      def self?.build_headers: (Config config, Symbol auth, accept: String, content_type: String?,
+                                op_headers: Hash[String, untyped], extra_headers: Hash[untyped, untyped]) -> Hash[String, String]
+      def self?.merge_headers: (Array[[untyped, untyped]] pairs) -> Hash[String, String]
+      def self?.credential_header: (Config config, Symbol auth) -> [String, String]?
+      class Attempt < Struct[untyped]
+        attr_accessor response: Transport::Response?
+        attr_accessor failure: Transport::Failure?
+        attr_accessor streamed: bool
+        attr_accessor elapsed: Float
+
+        def self.new: (?response: Transport::Response?, ?failure: Transport::Failure?, ?streamed: bool, ?elapsed: Float) -> Attempt
+      end
+
+      def self?.perform: (Config config, Transport transport, Prepared prepared) ?{ (String chunk) -> void } -> Result
+      def self?.attempt: (Transport transport, Prepared prepared) ?{ (String chunk) -> void } -> Attempt
+      def self?.retry_delay: (Config config, Prepared prepared, Attempt attempt, Integer retries) -> Float?
+      def self?.retry_status?: (Symbol http_method, Integer status) -> bool
+      def self?.retry_failure?: (Symbol http_method, Transport::Failure failure) -> bool
+      def self?.backoff: (Integer retries_taken) -> Float
+      def self?.retry_after: (String? value, ?now: Time) -> Float?
+      def self?.http_date_seconds: (String text, Time now) -> Float?
+      def self?.connection_error: (Prepared prepared, Transport::Failure failure) -> APIConnectionError
+    end
+
+    class Transport
+      class Response < Struct[untyped]
+        attr_accessor status: Integer
+        attr_accessor headers: Hash[String, String]
+        attr_accessor body: String?
+
+        def self?.new: (status: Integer, headers: Hash[String, String], body: String?) -> Response
+      end
+
+      class Failure < StandardError
+        attr_reader error: Exception
+        attr_reader sent: bool
+
+        def initialize: (Exception error, sent: bool) -> void
+        def timeout?: () -> bool
+      end
+
+      NOT_SENT_ERRORS: Array[singleton(Exception)]
+      TRANSPORT_ERRORS: Array[singleton(Exception)]
+      TIMEOUT_ERRORS: Array[singleton(Exception)]
+      MAX_IDLE: Integer
+      METHODS: Hash[Symbol, singleton(Net::HTTPRequest)]
+
+      @mutex: Thread::Mutex
+      @idle: Hash[String, Array[Net::HTTP]]
+      @pid: Integer
+
+      attr_reader http_client: http_client?
+
+      def initialize: (?http_client: http_client?) -> void
+      def execute: (Symbol http_method, URI::Generic uri, Hash[String, String] headers, String? body, Float timeout) ?{ (String chunk) -> void } -> Response
+      def close: () -> nil
+
+      private
+
+      def perform: (Net::HTTP http, Net::HTTPRequest request) ?{ (String chunk) -> void } -> Response
+      def build: (Symbol http_method, URI::Generic uri, Hash[String, String] headers, String? body) -> Net::HTTPRequest
+      def target: (URI::Generic uri) -> String
+      def checkout: (URI::Generic uri, Float timeout) -> Net::HTTP
+      def start: (Net::HTTP http) -> void
+      def checkin: (URI::Generic uri, Net::HTTP http) -> void
+      def discard: (Net::HTTP http) -> void
+      def reset_after_fork: () -> void
+      def new_session: (URI::Generic uri) -> Net::HTTP
+      def configure: (Net::HTTP http, Float timeout) -> void
+      def pool_key: (URI::Generic uri) -> String
+    end
+  end
+end

data/sig/didit/model.rbs

@@ -0,0 +1,42 @@
+module Didit
+  class Model
+    @data: Hash[String, untyped]
+    @cache: Hash[Symbol, untyped]
+    self.@fields: Hash[Symbol, [String, Didit::type_spec]]?
+
+    def self.fields: () -> Hash[Symbol, [String, Didit::type_spec]]
+    def self.field: (Symbol name, String wire, ?Didit::type_spec type) -> void
+    def self.from_json: (untyped value) -> untyped
+    def self.coerce: (untyped value, Didit::type_spec? type) -> untyped
+    def self.symbolize: (untyped value) -> untyped
+    def self.fields_of: (singleton(Model) klass) -> Hash[Symbol, [String, Didit::type_spec]]
+
+    private
+
+    def self.coerce_container: (untyped value, Array[untyped] type) -> untyped
+    def self.fits?: (untyped value, untyped type) -> bool
+    def self.coerce_model: (untyped value, untyped type) -> untyped
+    def self.parse_time: (untyped value) -> untyped
+    def self.parse_date: (untyped value) -> untyped
+
+    public
+
+    def initialize: (?Hash[String | Symbol, untyped] data) -> void
+    def []: (String | Symbol key) -> untyped
+    def key?: (String | Symbol key) -> bool
+    def to_h: () -> Hash[Symbol, untyped]
+    def to_json: (*untyped args) -> String
+    def deconstruct_keys: (Array[Symbol]? keys) -> Hash[Symbol, untyped]
+    def ==: (untyped other) -> bool
+    def eql?: (untyped other) -> bool
+    def hash: () -> Integer
+    def inspect: () -> String
+    def to_s: () -> String
+
+    def raw_data: () -> Hash[String, untyped]
+
+    private
+
+    def read_field: (Symbol name) -> untyped
+  end
+end

data/sig/didit/page.rbs

@@ -0,0 +1,34 @@
+module Didit
+  class Page[unchecked out Item]
+    include Enumerable[Item]
+
+    @client: Didit::Client
+    @prepared: Didit::Internal::Request::Prepared
+    @item: Didit::type_spec
+    @data: Hash[String, untyped]
+    @seen: Array[untyped]
+
+    attr_reader results: Array[Item]
+
+    def initialize: (client: Didit::Client, prepared: Didit::Internal::Request::Prepared, item: Didit::type_spec,
+                     data: untyped, ?seen: Array[untyped]?) -> void
+    def total_count: () -> Integer?
+    def next_url: () -> String?
+    def previous_url: () -> String?
+    def each: () { (Item item) -> void } -> self
+            | () -> Enumerator[Item, self]
+    def next_page?: () -> bool
+    def next_page: () -> Page[Item]?
+    def auto_paging_each: () { (Item item) -> void } -> nil
+                        | () -> Enumerator[Item, nil]
+    def []: (String | Symbol key) -> untyped
+    def to_h: () -> Hash[Symbol, untyped]
+    def inspect: () -> String
+    def self.normalize: (URI::Generic uri) -> Array[untyped]
+
+    private
+
+    def link: (untyped value) -> String?
+    def resolve: (String url) -> URI::Generic
+  end
+end

data/sig/didit/raw_response.rbs

@@ -0,0 +1,20 @@
+module Didit
+  class RawResponse
+    @parser: ^() -> untyped
+    @parsed: bool
+    @value: untyped
+
+    attr_reader status: Integer
+    attr_reader headers: Hash[String, String]
+    attr_reader body: String?
+    attr_reader retries_taken: Integer
+    attr_reader elapsed: Float
+
+    def initialize: (status: Integer, headers: Hash[String, String], body: String?, retries_taken: Integer,
+                     elapsed: Float, parser: ^() -> untyped) -> void
+    def status_code: () -> Integer
+    def request_id: () -> String?
+    def parse: () -> untyped
+    def inspect: () -> String
+  end
+end

data/sig/didit/resource.rbs

@@ -0,0 +1,8 @@
+module Didit
+  class Resource
+    @client: Didit::Client
+
+    def initialize: (untyped client) -> void
+    def inspect: () -> String
+  end
+end