context.dev 2.5.0 → 2.6.0

data/rbi/context_dev/models/batch_list_response.rbi

@@ -0,0 +1,738 @@
+# typed: strong
+
+module ContextDev
+  module Models
+    class BatchListResponse < ContextDev::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            ContextDev::Models::BatchListResponse,
+            ContextDev::Internal::AnyHash
+          )
+        end
+
+      # Batches on this page.
+      sig do
+        returns(
+          T.nilable(T::Array[ContextDev::Models::BatchListResponse::Data])
+        )
+      end
+      attr_reader :data
+
+      sig do
+        params(
+          data: T::Array[ContextDev::Models::BatchListResponse::Data::OrHash]
+        ).void
+      end
+      attr_writer :data
+
+      # Whether another page is available.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :has_more
+
+      sig { params(has_more: T::Boolean).void }
+      attr_writer :has_more
+
+      # Metadata about the API key used for the request. Included in every response
+      # whenever a valid API key is provided, even when the response status is not 200.
+      sig do
+        returns(T.nilable(ContextDev::Models::BatchListResponse::KeyMetadata))
+      end
+      attr_reader :key_metadata
+
+      sig do
+        params(
+          key_metadata:
+            ContextDev::Models::BatchListResponse::KeyMetadata::OrHash
+        ).void
+      end
+      attr_writer :key_metadata
+
+      # Cursor for the next page.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :next_cursor
+
+      sig do
+        params(
+          data: T::Array[ContextDev::Models::BatchListResponse::Data::OrHash],
+          has_more: T::Boolean,
+          key_metadata:
+            ContextDev::Models::BatchListResponse::KeyMetadata::OrHash,
+          next_cursor: T.nilable(String)
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Batches on this page.
+        data: nil,
+        # Whether another page is available.
+        has_more: nil,
+        # Metadata about the API key used for the request. Included in every response
+        # whenever a valid API key is provided, even when the response status is not 200.
+        key_metadata: nil,
+        # Cursor for the next page.
+        next_cursor: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            data: T::Array[ContextDev::Models::BatchListResponse::Data],
+            has_more: T::Boolean,
+            key_metadata: ContextDev::Models::BatchListResponse::KeyMetadata,
+            next_cursor: T.nilable(String)
+          }
+        )
+      end
+      def to_hash
+      end
+
+      class Data < ContextDev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              ContextDev::Models::BatchListResponse::Data,
+              ContextDev::Internal::AnyHash
+            )
+          end
+
+        # Batch ID used to retrieve or cancel the job.
+        sig { returns(String) }
+        attr_accessor :id
+
+        # Reserved and used credits.
+        sig { returns(ContextDev::Models::BatchListResponse::Data::Credits) }
+        attr_reader :credits
+
+        sig do
+          params(
+            credits:
+              ContextDev::Models::BatchListResponse::Data::Credits::OrHash
+          ).void
+        end
+        attr_writer :credits
+
+        # Why the batch failed.
+        sig { returns(T.nilable(ContextDev::Error)) }
+        attr_reader :error
+
+        sig { params(error: T.nilable(ContextDev::Error::OrHash)).void }
+        attr_writer :error
+
+        # Page failures grouped by error code.
+        sig { returns(T::Array[ContextDev::ErrorCount]) }
+        attr_accessor :errors
+
+        # Submission counts.
+        sig { returns(ContextDev::Models::BatchListResponse::Data::Input) }
+        attr_reader :input
+
+        sig do
+          params(
+            input: ContextDev::Models::BatchListResponse::Data::Input::OrHash
+          ).void
+        end
+        attr_writer :input
+
+        # How pages are selected.
+        sig do
+          returns(
+            ContextDev::Models::BatchListResponse::Data::Mode::TaggedSymbol
+          )
+        end
+        attr_accessor :mode
+
+        # Current processing counts. Use `status` to check completion.
+        sig { returns(ContextDev::Models::BatchListResponse::Data::Progress) }
+        attr_reader :progress
+
+        sig do
+          params(
+            progress:
+              ContextDev::Models::BatchListResponse::Data::Progress::OrHash
+          ).void
+        end
+        attr_writer :progress
+
+        # Download links available when the batch finishes. GET /batch/{batch_id}/results
+        # serves the same records as paginated JSON.
+        sig do
+          returns(
+            T.nilable(ContextDev::Models::BatchListResponse::Data::Results)
+          )
+        end
+        attr_reader :results
+
+        sig do
+          params(
+            results:
+              T.nilable(
+                ContextDev::Models::BatchListResponse::Data::Results::OrHash
+              )
+          ).void
+        end
+        attr_writer :results
+
+        # Current state. `completed`, `cancelled`, and `failed` are final.
+        sig do
+          returns(
+            ContextDev::Models::BatchListResponse::Data::Status::TaggedSymbol
+          )
+        end
+        attr_accessor :status
+
+        # Tags stored on the batch at submission.
+        sig { returns(T::Array[String]) }
+        attr_accessor :tags
+
+        sig { returns(ContextDev::Models::BatchListResponse::Data::Timing) }
+        attr_reader :timing
+
+        sig do
+          params(
+            timing: ContextDev::Models::BatchListResponse::Data::Timing::OrHash
+          ).void
+        end
+        attr_writer :timing
+
+        # Output format.
+        sig do
+          returns(
+            ContextDev::Models::BatchListResponse::Data::Type::TaggedSymbol
+          )
+        end
+        attr_accessor :type
+
+        # An asynchronous web scraping job.
+        sig do
+          params(
+            id: String,
+            credits:
+              ContextDev::Models::BatchListResponse::Data::Credits::OrHash,
+            error: T.nilable(ContextDev::Error::OrHash),
+            errors: T::Array[ContextDev::ErrorCount::OrHash],
+            input: ContextDev::Models::BatchListResponse::Data::Input::OrHash,
+            mode: ContextDev::Models::BatchListResponse::Data::Mode::OrSymbol,
+            progress:
+              ContextDev::Models::BatchListResponse::Data::Progress::OrHash,
+            results:
+              T.nilable(
+                ContextDev::Models::BatchListResponse::Data::Results::OrHash
+              ),
+            status:
+              ContextDev::Models::BatchListResponse::Data::Status::OrSymbol,
+            tags: T::Array[String],
+            timing: ContextDev::Models::BatchListResponse::Data::Timing::OrHash,
+            type: ContextDev::Models::BatchListResponse::Data::Type::OrSymbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Batch ID used to retrieve or cancel the job.
+          id:,
+          # Reserved and used credits.
+          credits:,
+          # Why the batch failed.
+          error:,
+          # Page failures grouped by error code.
+          errors:,
+          # Submission counts.
+          input:,
+          # How pages are selected.
+          mode:,
+          # Current processing counts. Use `status` to check completion.
+          progress:,
+          # Download links available when the batch finishes. GET /batch/{batch_id}/results
+          # serves the same records as paginated JSON.
+          results:,
+          # Current state. `completed`, `cancelled`, and `failed` are final.
+          status:,
+          # Tags stored on the batch at submission.
+          tags:,
+          timing:,
+          # Output format.
+          type:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              credits: ContextDev::Models::BatchListResponse::Data::Credits,
+              error: T.nilable(ContextDev::Error),
+              errors: T::Array[ContextDev::ErrorCount],
+              input: ContextDev::Models::BatchListResponse::Data::Input,
+              mode:
+                ContextDev::Models::BatchListResponse::Data::Mode::TaggedSymbol,
+              progress: ContextDev::Models::BatchListResponse::Data::Progress,
+              results:
+                T.nilable(ContextDev::Models::BatchListResponse::Data::Results),
+              status:
+                ContextDev::Models::BatchListResponse::Data::Status::TaggedSymbol,
+              tags: T::Array[String],
+              timing: ContextDev::Models::BatchListResponse::Data::Timing,
+              type:
+                ContextDev::Models::BatchListResponse::Data::Type::TaggedSymbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+        class Credits < ContextDev::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                ContextDev::Models::BatchListResponse::Data::Credits,
+                ContextDev::Internal::AnyHash
+              )
+            end
+
+          # Credits used by successful pages.
+          sig { returns(Integer) }
+          attr_accessor :charged
+
+          # Credits reserved when the batch was accepted.
+          sig { returns(Integer) }
+          attr_accessor :estimated
+
+          # Reserved and used credits.
+          sig do
+            params(charged: Integer, estimated: Integer).returns(
+              T.attached_class
+            )
+          end
+          def self.new(
+            # Credits used by successful pages.
+            charged:,
+            # Credits reserved when the batch was accepted.
+            estimated:
+          )
+          end
+
+          sig { override.returns({ charged: Integer, estimated: Integer }) }
+          def to_hash
+          end
+        end
+
+        class Input < ContextDev::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                ContextDev::Models::BatchListResponse::Data::Input,
+                ContextDev::Internal::AnyHash
+              )
+            end
+
+          # Pages accepted, or the crawl page limit. Credits are reserved for this count.
+          sig { returns(Integer) }
+          attr_accessor :accepted
+
+          # Duplicate URL and `itemId` pairs skipped. Always 0 for crawls.
+          sig { returns(Integer) }
+          attr_accessor :duplicates
+
+          # Pages rejected during validation.
+          sig { returns(Integer) }
+          attr_accessor :invalid
+
+          # Pages submitted before validation. For a crawl, the page limit.
+          sig { returns(Integer) }
+          attr_accessor :submitted
+
+          # Submission counts.
+          sig do
+            params(
+              accepted: Integer,
+              duplicates: Integer,
+              invalid: Integer,
+              submitted: Integer
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Pages accepted, or the crawl page limit. Credits are reserved for this count.
+            accepted:,
+            # Duplicate URL and `itemId` pairs skipped. Always 0 for crawls.
+            duplicates:,
+            # Pages rejected during validation.
+            invalid:,
+            # Pages submitted before validation. For a crawl, the page limit.
+            submitted:
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                accepted: Integer,
+                duplicates: Integer,
+                invalid: Integer,
+                submitted: Integer
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+
+        # How pages are selected.
+        module Mode
+          extend ContextDev::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, ContextDev::Models::BatchListResponse::Data::Mode)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          SCRAPE =
+            T.let(
+              :scrape,
+              ContextDev::Models::BatchListResponse::Data::Mode::TaggedSymbol
+            )
+          CRAWL =
+            T.let(
+              :crawl,
+              ContextDev::Models::BatchListResponse::Data::Mode::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                ContextDev::Models::BatchListResponse::Data::Mode::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+
+        class Progress < ContextDev::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                ContextDev::Models::BatchListResponse::Data::Progress,
+                ContextDev::Internal::AnyHash
+              )
+            end
+
+          # Pages that could not be scraped.
+          sig { returns(Integer) }
+          attr_accessor :failed
+
+          # Accepted pages not yet attempted. Always 0 once the batch completes; a crawl can
+          # finish under its page limit when the site has no more reachable pages.
+          sig { returns(Integer) }
+          attr_accessor :pending
+
+          # Pages scraped successfully.
+          sig { returns(Integer) }
+          attr_accessor :succeeded
+
+          # Current processing counts. Use `status` to check completion.
+          sig do
+            params(
+              failed: Integer,
+              pending: Integer,
+              succeeded: Integer
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Pages that could not be scraped.
+            failed:,
+            # Accepted pages not yet attempted. Always 0 once the batch completes; a crawl can
+            # finish under its page limit when the site has no more reachable pages.
+            pending:,
+            # Pages scraped successfully.
+            succeeded:
+          )
+          end
+
+          sig do
+            override.returns(
+              { failed: Integer, pending: Integer, succeeded: Integer }
+            )
+          end
+          def to_hash
+          end
+        end
+
+        class Results < ContextDev::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                ContextDev::Models::BatchListResponse::Data::Results,
+                ContextDev::Internal::AnyHash
+              )
+            end
+
+          # When the download URLs expire.
+          sig { returns(String) }
+          attr_accessor :expires_at
+
+          # Result files. Order is not guaranteed.
+          sig do
+            returns(
+              T::Array[
+                ContextDev::Models::BatchListResponse::Data::Results::File
+              ]
+            )
+          end
+          attr_accessor :files
+
+          # Download links available when the batch finishes. GET /batch/{batch_id}/results
+          # serves the same records as paginated JSON.
+          sig do
+            params(
+              expires_at: String,
+              files:
+                T::Array[
+                  ContextDev::Models::BatchListResponse::Data::Results::File::OrHash
+                ]
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # When the download URLs expire.
+            expires_at:,
+            # Result files. Order is not guaranteed.
+            files:
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                expires_at: String,
+                files:
+                  T::Array[
+                    ContextDev::Models::BatchListResponse::Data::Results::File
+                  ]
+              }
+            )
+          end
+          def to_hash
+          end
+
+          class File < ContextDev::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  ContextDev::Models::BatchListResponse::Data::Results::File,
+                  ContextDev::Internal::AnyHash
+                )
+              end
+
+            # Compressed file size in bytes.
+            sig { returns(Integer) }
+            attr_accessor :bytes
+
+            # Results in this file.
+            sig { returns(Integer) }
+            attr_accessor :items
+
+            # Temporary URL for a gzipped NDJSON file.
+            sig { returns(String) }
+            attr_accessor :url
+
+            sig do
+              params(bytes: Integer, items: Integer, url: String).returns(
+                T.attached_class
+              )
+            end
+            def self.new(
+              # Compressed file size in bytes.
+              bytes:,
+              # Results in this file.
+              items:,
+              # Temporary URL for a gzipped NDJSON file.
+              url:
+            )
+            end
+
+            sig do
+              override.returns({ bytes: Integer, items: Integer, url: String })
+            end
+            def to_hash
+            end
+          end
+        end
+
+        # Current state. `completed`, `cancelled`, and `failed` are final.
+        module Status
+          extend ContextDev::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, ContextDev::Models::BatchListResponse::Data::Status)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          QUEUED =
+            T.let(
+              :queued,
+              ContextDev::Models::BatchListResponse::Data::Status::TaggedSymbol
+            )
+          RUNNING =
+            T.let(
+              :running,
+              ContextDev::Models::BatchListResponse::Data::Status::TaggedSymbol
+            )
+          CANCELLING =
+            T.let(
+              :cancelling,
+              ContextDev::Models::BatchListResponse::Data::Status::TaggedSymbol
+            )
+          COMPLETED =
+            T.let(
+              :completed,
+              ContextDev::Models::BatchListResponse::Data::Status::TaggedSymbol
+            )
+          CANCELLED =
+            T.let(
+              :cancelled,
+              ContextDev::Models::BatchListResponse::Data::Status::TaggedSymbol
+            )
+          FAILED =
+            T.let(
+              :failed,
+              ContextDev::Models::BatchListResponse::Data::Status::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                ContextDev::Models::BatchListResponse::Data::Status::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+
+        class Timing < ContextDev::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                ContextDev::Models::BatchListResponse::Data::Timing,
+                ContextDev::Internal::AnyHash
+              )
+            end
+
+          # When processing finished. Null while active.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :completed_at
+
+          # When the batch was created.
+          sig { returns(String) }
+          attr_accessor :created_at
+
+          # When processing started. Null while queued.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :started_at
+
+          sig do
+            params(
+              completed_at: T.nilable(String),
+              created_at: String,
+              started_at: T.nilable(String)
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # When processing finished. Null while active.
+            completed_at:,
+            # When the batch was created.
+            created_at:,
+            # When processing started. Null while queued.
+            started_at:
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                completed_at: T.nilable(String),
+                created_at: String,
+                started_at: T.nilable(String)
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+
+        # Output format.
+        module Type
+          extend ContextDev::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, ContextDev::Models::BatchListResponse::Data::Type)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          MARKDOWN =
+            T.let(
+              :markdown,
+              ContextDev::Models::BatchListResponse::Data::Type::TaggedSymbol
+            )
+          HTML =
+            T.let(
+              :html,
+              ContextDev::Models::BatchListResponse::Data::Type::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                ContextDev::Models::BatchListResponse::Data::Type::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+
+      class KeyMetadata < ContextDev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              ContextDev::Models::BatchListResponse::KeyMetadata,
+              ContextDev::Internal::AnyHash
+            )
+          end
+
+        # The number of credits consumed by this request.
+        sig { returns(Integer) }
+        attr_accessor :credits_consumed
+
+        # The number of credits remaining for your organization after this request.
+        sig { returns(Integer) }
+        attr_accessor :credits_remaining
+
+        # Metadata about the API key used for the request. Included in every response
+        # whenever a valid API key is provided, even when the response status is not 200.
+        sig do
+          params(credits_consumed: Integer, credits_remaining: Integer).returns(
+            T.attached_class
+          )
+        end
+        def self.new(
+          # The number of credits consumed by this request.
+          credits_consumed:,
+          # The number of credits remaining for your organization after this request.
+          credits_remaining:
+        )
+        end
+
+        sig do
+          override.returns(
+            { credits_consumed: Integer, credits_remaining: Integer }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end