context.dev 0.0.2

data/rbi/context_dev/models/brand_screenshot_params.rbi

@@ -0,0 +1,225 @@
+# typed: strong
+
+module ContextDev
+  module Models
+    class BrandScreenshotParams < ContextDev::Internal::Type::BaseModel
+      extend ContextDev::Internal::Type::RequestParameters::Converter
+      include ContextDev::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            ContextDev::BrandScreenshotParams,
+            ContextDev::Internal::AnyHash
+          )
+        end
+
+      # Domain name to take screenshot of (e.g., 'example.com', 'google.com'). The
+      # domain will be automatically normalized and validated.
+      sig { returns(String) }
+      attr_accessor :domain
+
+      # Optional parameter to determine screenshot type. If 'true', takes a full page
+      # screenshot capturing all content. If 'false' or not provided, takes a viewport
+      # screenshot (standard browser view).
+      sig do
+        returns(
+          T.nilable(ContextDev::BrandScreenshotParams::FullScreenshot::OrSymbol)
+        )
+      end
+      attr_reader :full_screenshot
+
+      sig do
+        params(
+          full_screenshot:
+            ContextDev::BrandScreenshotParams::FullScreenshot::OrSymbol
+        ).void
+      end
+      attr_writer :full_screenshot
+
+      # Optional parameter to specify which page type to screenshot. If provided, the
+      # system will scrape the domain's links and use heuristics to find the most
+      # appropriate URL for the specified page type (30 supported languages). If not
+      # provided, screenshots the main domain landing page.
+      sig do
+        returns(T.nilable(ContextDev::BrandScreenshotParams::Page::OrSymbol))
+      end
+      attr_reader :page
+
+      sig do
+        params(page: ContextDev::BrandScreenshotParams::Page::OrSymbol).void
+      end
+      attr_writer :page
+
+      # Optional parameter to prioritize screenshot capture. If 'speed', optimizes for
+      # faster capture with basic quality. If 'quality', optimizes for higher quality
+      # with longer wait times. Defaults to 'quality' if not provided.
+      sig do
+        returns(
+          T.nilable(ContextDev::BrandScreenshotParams::Prioritize::OrSymbol)
+        )
+      end
+      attr_reader :prioritize
+
+      sig do
+        params(
+          prioritize: ContextDev::BrandScreenshotParams::Prioritize::OrSymbol
+        ).void
+      end
+      attr_writer :prioritize
+
+      sig do
+        params(
+          domain: String,
+          full_screenshot:
+            ContextDev::BrandScreenshotParams::FullScreenshot::OrSymbol,
+          page: ContextDev::BrandScreenshotParams::Page::OrSymbol,
+          prioritize: ContextDev::BrandScreenshotParams::Prioritize::OrSymbol,
+          request_options: ContextDev::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Domain name to take screenshot of (e.g., 'example.com', 'google.com'). The
+        # domain will be automatically normalized and validated.
+        domain:,
+        # Optional parameter to determine screenshot type. If 'true', takes a full page
+        # screenshot capturing all content. If 'false' or not provided, takes a viewport
+        # screenshot (standard browser view).
+        full_screenshot: nil,
+        # Optional parameter to specify which page type to screenshot. If provided, the
+        # system will scrape the domain's links and use heuristics to find the most
+        # appropriate URL for the specified page type (30 supported languages). If not
+        # provided, screenshots the main domain landing page.
+        page: nil,
+        # Optional parameter to prioritize screenshot capture. If 'speed', optimizes for
+        # faster capture with basic quality. If 'quality', optimizes for higher quality
+        # with longer wait times. Defaults to 'quality' if not provided.
+        prioritize: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            domain: String,
+            full_screenshot:
+              ContextDev::BrandScreenshotParams::FullScreenshot::OrSymbol,
+            page: ContextDev::BrandScreenshotParams::Page::OrSymbol,
+            prioritize: ContextDev::BrandScreenshotParams::Prioritize::OrSymbol,
+            request_options: ContextDev::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # Optional parameter to determine screenshot type. If 'true', takes a full page
+      # screenshot capturing all content. If 'false' or not provided, takes a viewport
+      # screenshot (standard browser view).
+      module FullScreenshot
+        extend ContextDev::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, ContextDev::BrandScreenshotParams::FullScreenshot)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        TRUE =
+          T.let(
+            :true,
+            ContextDev::BrandScreenshotParams::FullScreenshot::TaggedSymbol
+          )
+        FALSE =
+          T.let(
+            :false,
+            ContextDev::BrandScreenshotParams::FullScreenshot::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              ContextDev::BrandScreenshotParams::FullScreenshot::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      # Optional parameter to specify which page type to screenshot. If provided, the
+      # system will scrape the domain's links and use heuristics to find the most
+      # appropriate URL for the specified page type (30 supported languages). If not
+      # provided, screenshots the main domain landing page.
+      module Page
+        extend ContextDev::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, ContextDev::BrandScreenshotParams::Page)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        LOGIN =
+          T.let(:login, ContextDev::BrandScreenshotParams::Page::TaggedSymbol)
+        SIGNUP =
+          T.let(:signup, ContextDev::BrandScreenshotParams::Page::TaggedSymbol)
+        BLOG =
+          T.let(:blog, ContextDev::BrandScreenshotParams::Page::TaggedSymbol)
+        CAREERS =
+          T.let(:careers, ContextDev::BrandScreenshotParams::Page::TaggedSymbol)
+        PRICING =
+          T.let(:pricing, ContextDev::BrandScreenshotParams::Page::TaggedSymbol)
+        TERMS =
+          T.let(:terms, ContextDev::BrandScreenshotParams::Page::TaggedSymbol)
+        PRIVACY =
+          T.let(:privacy, ContextDev::BrandScreenshotParams::Page::TaggedSymbol)
+        CONTACT =
+          T.let(:contact, ContextDev::BrandScreenshotParams::Page::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[ContextDev::BrandScreenshotParams::Page::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+
+      # Optional parameter to prioritize screenshot capture. If 'speed', optimizes for
+      # faster capture with basic quality. If 'quality', optimizes for higher quality
+      # with longer wait times. Defaults to 'quality' if not provided.
+      module Prioritize
+        extend ContextDev::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, ContextDev::BrandScreenshotParams::Prioritize)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        SPEED =
+          T.let(
+            :speed,
+            ContextDev::BrandScreenshotParams::Prioritize::TaggedSymbol
+          )
+        QUALITY =
+          T.let(
+            :quality,
+            ContextDev::BrandScreenshotParams::Prioritize::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              ContextDev::BrandScreenshotParams::Prioritize::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/context_dev/models/brand_screenshot_response.rbi

@@ -0,0 +1,135 @@
+# typed: strong
+
+module ContextDev
+  module Models
+    class BrandScreenshotResponse < ContextDev::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            ContextDev::Models::BrandScreenshotResponse,
+            ContextDev::Internal::AnyHash
+          )
+        end
+
+      # HTTP status code
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :code
+
+      sig { params(code: Integer).void }
+      attr_writer :code
+
+      # The normalized domain that was processed
+      sig { returns(T.nilable(String)) }
+      attr_reader :domain
+
+      sig { params(domain: String).void }
+      attr_writer :domain
+
+      # Public URL of the uploaded screenshot image
+      sig { returns(T.nilable(String)) }
+      attr_reader :screenshot
+
+      sig { params(screenshot: String).void }
+      attr_writer :screenshot
+
+      # Type of screenshot that was captured
+      sig do
+        returns(
+          T.nilable(
+            ContextDev::Models::BrandScreenshotResponse::ScreenshotType::TaggedSymbol
+          )
+        )
+      end
+      attr_reader :screenshot_type
+
+      sig do
+        params(
+          screenshot_type:
+            ContextDev::Models::BrandScreenshotResponse::ScreenshotType::OrSymbol
+        ).void
+      end
+      attr_writer :screenshot_type
+
+      # Status of the response, e.g., 'ok'
+      sig { returns(T.nilable(String)) }
+      attr_reader :status
+
+      sig { params(status: String).void }
+      attr_writer :status
+
+      sig do
+        params(
+          code: Integer,
+          domain: String,
+          screenshot: String,
+          screenshot_type:
+            ContextDev::Models::BrandScreenshotResponse::ScreenshotType::OrSymbol,
+          status: String
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # HTTP status code
+        code: nil,
+        # The normalized domain that was processed
+        domain: nil,
+        # Public URL of the uploaded screenshot image
+        screenshot: nil,
+        # Type of screenshot that was captured
+        screenshot_type: nil,
+        # Status of the response, e.g., 'ok'
+        status: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            code: Integer,
+            domain: String,
+            screenshot: String,
+            screenshot_type:
+              ContextDev::Models::BrandScreenshotResponse::ScreenshotType::TaggedSymbol,
+            status: String
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # Type of screenshot that was captured
+      module ScreenshotType
+        extend ContextDev::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(
+              Symbol,
+              ContextDev::Models::BrandScreenshotResponse::ScreenshotType
+            )
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        VIEWPORT =
+          T.let(
+            :viewport,
+            ContextDev::Models::BrandScreenshotResponse::ScreenshotType::TaggedSymbol
+          )
+        FULL_PAGE =
+          T.let(
+            :fullPage,
+            ContextDev::Models::BrandScreenshotResponse::ScreenshotType::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              ContextDev::Models::BrandScreenshotResponse::ScreenshotType::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/context_dev/models/brand_styleguide_params.rbi

@@ -0,0 +1,139 @@
+# typed: strong
+
+module ContextDev
+  module Models
+    class BrandStyleguideParams < ContextDev::Internal::Type::BaseModel
+      extend ContextDev::Internal::Type::RequestParameters::Converter
+      include ContextDev::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            ContextDev::BrandStyleguideParams,
+            ContextDev::Internal::AnyHash
+          )
+        end
+
+      # A specific URL to fetch the styleguide from directly, bypassing domain
+      # resolution (e.g., 'https://example.com/design-system').
+      sig { returns(T.nilable(String)) }
+      attr_reader :direct_url
+
+      sig { params(direct_url: String).void }
+      attr_writer :direct_url
+
+      # Domain name to extract styleguide from (e.g., 'example.com', 'google.com'). The
+      # domain will be automatically normalized and validated.
+      sig { returns(T.nilable(String)) }
+      attr_reader :domain
+
+      sig { params(domain: String).void }
+      attr_writer :domain
+
+      # Optional parameter to prioritize screenshot capture for styleguide extraction.
+      # If 'speed', optimizes for faster capture with basic quality. If 'quality',
+      # optimizes for higher quality with longer wait times. Defaults to 'quality' if
+      # not provided.
+      sig do
+        returns(
+          T.nilable(ContextDev::BrandStyleguideParams::Prioritize::OrSymbol)
+        )
+      end
+      attr_reader :prioritize
+
+      sig do
+        params(
+          prioritize: ContextDev::BrandStyleguideParams::Prioritize::OrSymbol
+        ).void
+      end
+      attr_writer :prioritize
+
+      # Optional timeout in milliseconds for the request. If the request takes longer
+      # than this value, it will be aborted with a 408 status code. Maximum allowed
+      # value is 300000ms (5 minutes).
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :timeout_ms
+
+      sig { params(timeout_ms: Integer).void }
+      attr_writer :timeout_ms
+
+      sig do
+        params(
+          direct_url: String,
+          domain: String,
+          prioritize: ContextDev::BrandStyleguideParams::Prioritize::OrSymbol,
+          timeout_ms: Integer,
+          request_options: ContextDev::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # A specific URL to fetch the styleguide from directly, bypassing domain
+        # resolution (e.g., 'https://example.com/design-system').
+        direct_url: nil,
+        # Domain name to extract styleguide from (e.g., 'example.com', 'google.com'). The
+        # domain will be automatically normalized and validated.
+        domain: nil,
+        # Optional parameter to prioritize screenshot capture for styleguide extraction.
+        # If 'speed', optimizes for faster capture with basic quality. If 'quality',
+        # optimizes for higher quality with longer wait times. Defaults to 'quality' if
+        # not provided.
+        prioritize: nil,
+        # Optional timeout in milliseconds for the request. If the request takes longer
+        # than this value, it will be aborted with a 408 status code. Maximum allowed
+        # value is 300000ms (5 minutes).
+        timeout_ms: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            direct_url: String,
+            domain: String,
+            prioritize: ContextDev::BrandStyleguideParams::Prioritize::OrSymbol,
+            timeout_ms: Integer,
+            request_options: ContextDev::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # Optional parameter to prioritize screenshot capture for styleguide extraction.
+      # If 'speed', optimizes for faster capture with basic quality. If 'quality',
+      # optimizes for higher quality with longer wait times. Defaults to 'quality' if
+      # not provided.
+      module Prioritize
+        extend ContextDev::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, ContextDev::BrandStyleguideParams::Prioritize)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        SPEED =
+          T.let(
+            :speed,
+            ContextDev::BrandStyleguideParams::Prioritize::TaggedSymbol
+          )
+        QUALITY =
+          T.let(
+            :quality,
+            ContextDev::BrandStyleguideParams::Prioritize::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              ContextDev::BrandStyleguideParams::Prioritize::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end