moonbase-sdk 0.1.0.pre.alpha.2 → 0.1.0.pre.alpha.3

data/lib/moonbase/models/collections/item_upsert_params.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module Moonbase
+  module Models
+    module Collections
+      # @see Moonbase::Resources::Collections::Items#upsert
+      class ItemUpsertParams < Moonbase::Internal::Type::BaseModel
+        extend Moonbase::Internal::Type::RequestParameters::Converter
+        include Moonbase::Internal::Type::RequestParameters
+
+        # @!attribute identifiers
+        #   A hash where keys are the `ref` of a `Field` and values are used to identify the
+        #   item to update. When multiple identifiers are provided, the update will find
+        #   items that match any of the identifiers.
+        #
+        #   @return [Hash{Symbol=>Moonbase::Models::SingleLineTextValue, Moonbase::Models::MultiLineTextValue, Moonbase::Models::IntegerValue, Moonbase::Models::FloatValue, Moonbase::Models::MonetaryValue, Moonbase::Models::PercentageValue, Moonbase::Models::BooleanValue, Moonbase::Models::EmailValue, Moonbase::Models::URLValue, Moonbase::Models::DomainValue, Moonbase::Models::FieldValueParam::SocialXValueParam, Moonbase::Models::FieldValueParam::SocialLinkedInValueParam, Moonbase::Models::TelephoneNumber, Moonbase::Models::GeoValue, Moonbase::Models::DateValue, Moonbase::Models::DatetimeValue, Moonbase::Models::ChoiceValueParam, Moonbase::Models::FunnelStepValueParam, Moonbase::Models::RelationValueParam, Array<Moonbase::Models::SingleLineTextValue, Moonbase::Models::MultiLineTextValue, Moonbase::Models::IntegerValue, Moonbase::Models::FloatValue, Moonbase::Models::MonetaryValue, Moonbase::Models::PercentageValue, Moonbase::Models::BooleanValue, Moonbase::Models::EmailValue, Moonbase::Models::URLValue, Moonbase::Models::DomainValue, Moonbase::Models::ValueParam::ValueUriSocialX, Moonbase::Models::ValueParam::ValueUriSocialLinkedIn, Moonbase::Models::TelephoneNumber, Moonbase::Models::GeoValue, Moonbase::Models::DateValue, Moonbase::Models::DatetimeValue, Moonbase::Models::ChoiceValueParam, Moonbase::Models::FunnelStepValueParam, Moonbase::Models::RelationValueParam>, nil}]
+        required :identifiers,
+                 -> { Moonbase::Internal::Type::HashOf[union: Moonbase::FieldValueParam, nil?: true] }
+
+        # @!attribute values
+        #   A hash where keys are the `ref` of a `Field` and values are the data to be set.
+        #
+        #   @return [Hash{Symbol=>Moonbase::Models::SingleLineTextValue, Moonbase::Models::MultiLineTextValue, Moonbase::Models::IntegerValue, Moonbase::Models::FloatValue, Moonbase::Models::MonetaryValue, Moonbase::Models::PercentageValue, Moonbase::Models::BooleanValue, Moonbase::Models::EmailValue, Moonbase::Models::URLValue, Moonbase::Models::DomainValue, Moonbase::Models::FieldValueParam::SocialXValueParam, Moonbase::Models::FieldValueParam::SocialLinkedInValueParam, Moonbase::Models::TelephoneNumber, Moonbase::Models::GeoValue, Moonbase::Models::DateValue, Moonbase::Models::DatetimeValue, Moonbase::Models::ChoiceValueParam, Moonbase::Models::FunnelStepValueParam, Moonbase::Models::RelationValueParam, Array<Moonbase::Models::SingleLineTextValue, Moonbase::Models::MultiLineTextValue, Moonbase::Models::IntegerValue, Moonbase::Models::FloatValue, Moonbase::Models::MonetaryValue, Moonbase::Models::PercentageValue, Moonbase::Models::BooleanValue, Moonbase::Models::EmailValue, Moonbase::Models::URLValue, Moonbase::Models::DomainValue, Moonbase::Models::ValueParam::ValueUriSocialX, Moonbase::Models::ValueParam::ValueUriSocialLinkedIn, Moonbase::Models::TelephoneNumber, Moonbase::Models::GeoValue, Moonbase::Models::DateValue, Moonbase::Models::DatetimeValue, Moonbase::Models::ChoiceValueParam, Moonbase::Models::FunnelStepValueParam, Moonbase::Models::RelationValueParam>, nil}]
+        required :values, -> { Moonbase::Internal::Type::HashOf[union: Moonbase::FieldValueParam, nil?: true] }
+
+        # @!attribute update_many_strategy
+        #
+        #   @return [Symbol, Moonbase::Models::Collections::ItemUpsertParams::UpdateManyStrategy, nil]
+        optional :update_many_strategy, enum: -> { Moonbase::Collections::ItemUpsertParams::UpdateManyStrategy }
+
+        # @!attribute update_one_strategy
+        #
+        #   @return [Symbol, Moonbase::Models::Collections::ItemUpsertParams::UpdateOneStrategy, nil]
+        optional :update_one_strategy, enum: -> { Moonbase::Collections::ItemUpsertParams::UpdateOneStrategy }
+
+        # @!method initialize(identifiers:, values:, update_many_strategy: nil, update_one_strategy: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Moonbase::Models::Collections::ItemUpsertParams} for more details.
+        #
+        #   @param identifiers [Hash{Symbol=>Moonbase::Models::SingleLineTextValue, Moonbase::Models::MultiLineTextValue, Moonbase::Models::IntegerValue, Moonbase::Models::FloatValue, Moonbase::Models::MonetaryValue, Moonbase::Models::PercentageValue, Moonbase::Models::BooleanValue, Moonbase::Models::EmailValue, Moonbase::Models::URLValue, Moonbase::Models::DomainValue, Moonbase::Models::FieldValueParam::SocialXValueParam, Moonbase::Models::FieldValueParam::SocialLinkedInValueParam, Moonbase::Models::TelephoneNumber, Moonbase::Models::GeoValue, Moonbase::Models::DateValue, Moonbase::Models::DatetimeValue, Moonbase::Models::ChoiceValueParam, Moonbase::Models::FunnelStepValueParam, Moonbase::Models::RelationValueParam, Array<Moonbase::Models::SingleLineTextValue, Moonbase::Models::MultiLineTextValue, Moonbase::Models::IntegerValue, Moonbase::Models::FloatValue, Moonbase::Models::MonetaryValue, Moonbase::Models::PercentageValue, Moonbase::Models::BooleanValue, Moonbase::Models::EmailValue, Moonbase::Models::URLValue, Moonbase::Models::DomainValue, Moonbase::Models::ValueParam::ValueUriSocialX, Moonbase::Models::ValueParam::ValueUriSocialLinkedIn, Moonbase::Models::TelephoneNumber, Moonbase::Models::GeoValue, Moonbase::Models::DateValue, Moonbase::Models::DatetimeValue, Moonbase::Models::ChoiceValueParam, Moonbase::Models::FunnelStepValueParam, Moonbase::Models::RelationValueParam>, nil}] A hash where keys are the `ref` of a `Field` and values are used to identify the
+        #
+        #   @param values [Hash{Symbol=>Moonbase::Models::SingleLineTextValue, Moonbase::Models::MultiLineTextValue, Moonbase::Models::IntegerValue, Moonbase::Models::FloatValue, Moonbase::Models::MonetaryValue, Moonbase::Models::PercentageValue, Moonbase::Models::BooleanValue, Moonbase::Models::EmailValue, Moonbase::Models::URLValue, Moonbase::Models::DomainValue, Moonbase::Models::FieldValueParam::SocialXValueParam, Moonbase::Models::FieldValueParam::SocialLinkedInValueParam, Moonbase::Models::TelephoneNumber, Moonbase::Models::GeoValue, Moonbase::Models::DateValue, Moonbase::Models::DatetimeValue, Moonbase::Models::ChoiceValueParam, Moonbase::Models::FunnelStepValueParam, Moonbase::Models::RelationValueParam, Array<Moonbase::Models::SingleLineTextValue, Moonbase::Models::MultiLineTextValue, Moonbase::Models::IntegerValue, Moonbase::Models::FloatValue, Moonbase::Models::MonetaryValue, Moonbase::Models::PercentageValue, Moonbase::Models::BooleanValue, Moonbase::Models::EmailValue, Moonbase::Models::URLValue, Moonbase::Models::DomainValue, Moonbase::Models::ValueParam::ValueUriSocialX, Moonbase::Models::ValueParam::ValueUriSocialLinkedIn, Moonbase::Models::TelephoneNumber, Moonbase::Models::GeoValue, Moonbase::Models::DateValue, Moonbase::Models::DatetimeValue, Moonbase::Models::ChoiceValueParam, Moonbase::Models::FunnelStepValueParam, Moonbase::Models::RelationValueParam>, nil}] A hash where keys are the `ref` of a `Field` and values are the data to be set.
+        #
+        #   @param update_many_strategy [Symbol, Moonbase::Models::Collections::ItemUpsertParams::UpdateManyStrategy]
+        #
+        #   @param update_one_strategy [Symbol, Moonbase::Models::Collections::ItemUpsertParams::UpdateOneStrategy]
+        #
+        #   @param request_options [Moonbase::RequestOptions, Hash{Symbol=>Object}]
+
+        module UpdateManyStrategy
+          extend Moonbase::Internal::Type::Enum
+
+          REPLACE = :replace
+          PRESERVE = :preserve
+          MERGE = :merge
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        module UpdateOneStrategy
+          extend Moonbase::Internal::Type::Enum
+
+          REPLACE = :replace
+          PRESERVE = :preserve
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/moonbase/models/date_field.rb

@@ -0,0 +1,119 @@
+# frozen_string_literal: true
+
+module Moonbase
+  module Models
+    class DateField < Moonbase::Internal::Type::BaseModel
+      # @!attribute id
+      #   Unique identifier for the object.
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute cardinality
+      #   Specifies whether the field can hold a single value (`one`) or multiple values
+      #   (`many`).
+      #
+      #   @return [Symbol, Moonbase::Models::DateField::Cardinality]
+      required :cardinality, enum: -> { Moonbase::DateField::Cardinality }
+
+      # @!attribute created_at
+      #   Time at which the object was created, as an ISO 8601 timestamp in UTC.
+      #
+      #   @return [Time]
+      required :created_at, Time
+
+      # @!attribute name
+      #   The human-readable name of the field (e.g., "Due Date").
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute readonly
+      #   If `true`, the value of this field is system-managed and cannot be updated via
+      #   the API.
+      #
+      #   @return [Boolean]
+      required :readonly, Moonbase::Internal::Type::Boolean
+
+      # @!attribute ref
+      #   A unique, stable, machine-readable identifier for the field within its
+      #   collection (e.g., `due_date`).
+      #
+      #   @return [String]
+      required :ref, String
+
+      # @!attribute required
+      #   If `true`, this field must have a value.
+      #
+      #   @return [Boolean]
+      required :required, Moonbase::Internal::Type::Boolean
+
+      # @!attribute type
+      #   The data type of the field. Always `field/date` for this field.
+      #
+      #   @return [Symbol, :"field/date"]
+      required :type, const: :"field/date"
+
+      # @!attribute unique
+      #   If `true`, values for this field must be unique across all items in the
+      #   collection.
+      #
+      #   @return [Boolean]
+      required :unique, Moonbase::Internal::Type::Boolean
+
+      # @!attribute updated_at
+      #   Time at which the object was last updated, as an ISO 8601 timestamp in UTC.
+      #
+      #   @return [Time]
+      required :updated_at, Time
+
+      # @!attribute description
+      #   An optional, longer-form description of the field's purpose.
+      #
+      #   @return [String, nil]
+      optional :description, String
+
+      # @!method initialize(id:, cardinality:, created_at:, name:, readonly:, ref:, required:, unique:, updated_at:, description: nil, type: :"field/date")
+      #   Some parameter documentations has been truncated, see
+      #   {Moonbase::Models::DateField} for more details.
+      #
+      #   A field that stores dates without time information.
+      #
+      #   @param id [String] Unique identifier for the object.
+      #
+      #   @param cardinality [Symbol, Moonbase::Models::DateField::Cardinality] Specifies whether the field can hold a single value (`one`) or multiple values (
+      #
+      #   @param created_at [Time] Time at which the object was created, as an ISO 8601 timestamp in UTC.
+      #
+      #   @param name [String] The human-readable name of the field (e.g., "Due Date").
+      #
+      #   @param readonly [Boolean] If `true`, the value of this field is system-managed and cannot be updated via t
+      #
+      #   @param ref [String] A unique, stable, machine-readable identifier for the field within its collectio
+      #
+      #   @param required [Boolean] If `true`, this field must have a value.
+      #
+      #   @param unique [Boolean] If `true`, values for this field must be unique across all items in the collecti
+      #
+      #   @param updated_at [Time] Time at which the object was last updated, as an ISO 8601 timestamp in UTC.
+      #
+      #   @param description [String] An optional, longer-form description of the field's purpose.
+      #
+      #   @param type [Symbol, :"field/date"] The data type of the field. Always `field/date` for this field.
+
+      # Specifies whether the field can hold a single value (`one`) or multiple values
+      # (`many`).
+      #
+      # @see Moonbase::Models::DateField#cardinality
+      module Cardinality
+        extend Moonbase::Internal::Type::Enum
+
+        ONE = :one
+        MANY = :many
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/moonbase/models/date_value.rb

@@ -3,20 +3,20 @@
 module Moonbase
   module Models
     class DateValue < Moonbase::Internal::Type::BaseModel
-      # @!attribute date
+      # @!attribute data
       #
       #   @return [Date]
-      required :date, Date
+      required :data, Date
 
       # @!attribute type
       #
       #   @return [Symbol, :"value/date"]
       required :type, const: :"value/date"
 
-      # @!method initialize(date:, type: :"value/date")
+      # @!method initialize(data:, type: :"value/date")
       #   Date without time
       #
-      #   @param date [Date]
+      #   @param data [Date]
       #   @param type [Symbol, :"value/date"]
     end
   end

data/lib/moonbase/models/datetime_field.rb

@@ -0,0 +1,119 @@
+# frozen_string_literal: true
+
+module Moonbase
+  module Models
+    class DatetimeField < Moonbase::Internal::Type::BaseModel
+      # @!attribute id
+      #   Unique identifier for the object.
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute cardinality
+      #   Specifies whether the field can hold a single value (`one`) or multiple values
+      #   (`many`).
+      #
+      #   @return [Symbol, Moonbase::Models::DatetimeField::Cardinality]
+      required :cardinality, enum: -> { Moonbase::DatetimeField::Cardinality }
+
+      # @!attribute created_at
+      #   Time at which the object was created, as an ISO 8601 timestamp in UTC.
+      #
+      #   @return [Time]
+      required :created_at, Time
+
+      # @!attribute name
+      #   The human-readable name of the field (e.g., "Meeting Time").
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute readonly
+      #   If `true`, the value of this field is system-managed and cannot be updated via
+      #   the API.
+      #
+      #   @return [Boolean]
+      required :readonly, Moonbase::Internal::Type::Boolean
+
+      # @!attribute ref
+      #   A unique, stable, machine-readable identifier for the field within its
+      #   collection (e.g., `meeting_time`).
+      #
+      #   @return [String]
+      required :ref, String
+
+      # @!attribute required
+      #   If `true`, this field must have a value.
+      #
+      #   @return [Boolean]
+      required :required, Moonbase::Internal::Type::Boolean
+
+      # @!attribute type
+      #   The data type of the field. Always `field/datetime` for this field.
+      #
+      #   @return [Symbol, :"field/datetime"]
+      required :type, const: :"field/datetime"
+
+      # @!attribute unique
+      #   If `true`, values for this field must be unique across all items in the
+      #   collection.
+      #
+      #   @return [Boolean]
+      required :unique, Moonbase::Internal::Type::Boolean
+
+      # @!attribute updated_at
+      #   Time at which the object was last updated, as an ISO 8601 timestamp in UTC.
+      #
+      #   @return [Time]
+      required :updated_at, Time
+
+      # @!attribute description
+      #   An optional, longer-form description of the field's purpose.
+      #
+      #   @return [String, nil]
+      optional :description, String
+
+      # @!method initialize(id:, cardinality:, created_at:, name:, readonly:, ref:, required:, unique:, updated_at:, description: nil, type: :"field/datetime")
+      #   Some parameter documentations has been truncated, see
+      #   {Moonbase::Models::DatetimeField} for more details.
+      #
+      #   A field that stores dates with time information.
+      #
+      #   @param id [String] Unique identifier for the object.
+      #
+      #   @param cardinality [Symbol, Moonbase::Models::DatetimeField::Cardinality] Specifies whether the field can hold a single value (`one`) or multiple values (
+      #
+      #   @param created_at [Time] Time at which the object was created, as an ISO 8601 timestamp in UTC.
+      #
+      #   @param name [String] The human-readable name of the field (e.g., "Meeting Time").
+      #
+      #   @param readonly [Boolean] If `true`, the value of this field is system-managed and cannot be updated via t
+      #
+      #   @param ref [String] A unique, stable, machine-readable identifier for the field within its collectio
+      #
+      #   @param required [Boolean] If `true`, this field must have a value.
+      #
+      #   @param unique [Boolean] If `true`, values for this field must be unique across all items in the collecti
+      #
+      #   @param updated_at [Time] Time at which the object was last updated, as an ISO 8601 timestamp in UTC.
+      #
+      #   @param description [String] An optional, longer-form description of the field's purpose.
+      #
+      #   @param type [Symbol, :"field/datetime"] The data type of the field. Always `field/datetime` for this field.
+
+      # Specifies whether the field can hold a single value (`one`) or multiple values
+      # (`many`).
+      #
+      # @see Moonbase::Models::DatetimeField#cardinality
+      module Cardinality
+        extend Moonbase::Internal::Type::Enum
+
+        ONE = :one
+        MANY = :many
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/moonbase/models/datetime_value.rb

@@ -3,20 +3,20 @@
 module Moonbase
   module Models
     class DatetimeValue < Moonbase::Internal::Type::BaseModel
-      # @!attribute datetime
+      # @!attribute data
       #
       #   @return [Time]
-      required :datetime, Time
+      required :data, Time
 
       # @!attribute type
       #
       #   @return [Symbol, :"value/datetime"]
       required :type, const: :"value/datetime"
 
-      # @!method initialize(datetime:, type: :"value/datetime")
+      # @!method initialize(data:, type: :"value/datetime")
       #   Date and time value
       #
-      #   @param datetime [Time]
+      #   @param data [Time]
       #   @param type [Symbol, :"value/datetime"]
     end
   end

data/lib/moonbase/models/domain_field.rb

@@ -0,0 +1,119 @@
+# frozen_string_literal: true
+
+module Moonbase
+  module Models
+    class DomainField < Moonbase::Internal::Type::BaseModel
+      # @!attribute id
+      #   Unique identifier for the object.
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute cardinality
+      #   Specifies whether the field can hold a single value (`one`) or multiple values
+      #   (`many`).
+      #
+      #   @return [Symbol, Moonbase::Models::DomainField::Cardinality]
+      required :cardinality, enum: -> { Moonbase::DomainField::Cardinality }
+
+      # @!attribute created_at
+      #   Time at which the object was created, as an ISO 8601 timestamp in UTC.
+      #
+      #   @return [Time]
+      required :created_at, Time
+
+      # @!attribute name
+      #   The human-readable name of the field (e.g., "Company Domain").
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute readonly
+      #   If `true`, the value of this field is system-managed and cannot be updated via
+      #   the API.
+      #
+      #   @return [Boolean]
+      required :readonly, Moonbase::Internal::Type::Boolean
+
+      # @!attribute ref
+      #   A unique, stable, machine-readable identifier for the field within its
+      #   collection (e.g., `company_domain`).
+      #
+      #   @return [String]
+      required :ref, String
+
+      # @!attribute required
+      #   If `true`, this field must have a value.
+      #
+      #   @return [Boolean]
+      required :required, Moonbase::Internal::Type::Boolean
+
+      # @!attribute type
+      #   The data type of the field. Always `field/uri/domain` for this field.
+      #
+      #   @return [Symbol, :"field/uri/domain"]
+      required :type, const: :"field/uri/domain"
+
+      # @!attribute unique
+      #   If `true`, values for this field must be unique across all items in the
+      #   collection.
+      #
+      #   @return [Boolean]
+      required :unique, Moonbase::Internal::Type::Boolean
+
+      # @!attribute updated_at
+      #   Time at which the object was last updated, as an ISO 8601 timestamp in UTC.
+      #
+      #   @return [Time]
+      required :updated_at, Time
+
+      # @!attribute description
+      #   An optional, longer-form description of the field's purpose.
+      #
+      #   @return [String, nil]
+      optional :description, String
+
+      # @!method initialize(id:, cardinality:, created_at:, name:, readonly:, ref:, required:, unique:, updated_at:, description: nil, type: :"field/uri/domain")
+      #   Some parameter documentations has been truncated, see
+      #   {Moonbase::Models::DomainField} for more details.
+      #
+      #   A field that stores internet domain names.
+      #
+      #   @param id [String] Unique identifier for the object.
+      #
+      #   @param cardinality [Symbol, Moonbase::Models::DomainField::Cardinality] Specifies whether the field can hold a single value (`one`) or multiple values (
+      #
+      #   @param created_at [Time] Time at which the object was created, as an ISO 8601 timestamp in UTC.
+      #
+      #   @param name [String] The human-readable name of the field (e.g., "Company Domain").
+      #
+      #   @param readonly [Boolean] If `true`, the value of this field is system-managed and cannot be updated via t
+      #
+      #   @param ref [String] A unique, stable, machine-readable identifier for the field within its collectio
+      #
+      #   @param required [Boolean] If `true`, this field must have a value.
+      #
+      #   @param unique [Boolean] If `true`, values for this field must be unique across all items in the collecti
+      #
+      #   @param updated_at [Time] Time at which the object was last updated, as an ISO 8601 timestamp in UTC.
+      #
+      #   @param description [String] An optional, longer-form description of the field's purpose.
+      #
+      #   @param type [Symbol, :"field/uri/domain"] The data type of the field. Always `field/uri/domain` for this field.
+
+      # Specifies whether the field can hold a single value (`one`) or multiple values
+      # (`many`).
+      #
+      # @see Moonbase::Models::DomainField#cardinality
+      module Cardinality
+        extend Moonbase::Internal::Type::Enum
+
+        ONE = :one
+        MANY = :many
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/moonbase/models/domain_value.rb

@@ -3,20 +3,22 @@
 module Moonbase
   module Models
     class DomainValue < Moonbase::Internal::Type::BaseModel
-      # @!attribute domain
+      # @!attribute data
+      #   A valid internet domain name, without protocol (e.g., 'https://') or path.
       #
       #   @return [String]
-      required :domain, String
+      required :data, String
 
       # @!attribute type
       #
       #   @return [Symbol, :"value/uri/domain"]
       required :type, const: :"value/uri/domain"
 
-      # @!method initialize(domain:, type: :"value/uri/domain")
+      # @!method initialize(data:, type: :"value/uri/domain")
       #   Internet domain name
       #
-      #   @param domain [String]
+      #   @param data [String] A valid internet domain name, without protocol (e.g., 'https://') or path.
+      #
       #   @param type [Symbol, :"value/uri/domain"]
     end
   end

data/lib/moonbase/models/email_field.rb

@@ -0,0 +1,119 @@
+# frozen_string_literal: true
+
+module Moonbase
+  module Models
+    class EmailField < Moonbase::Internal::Type::BaseModel
+      # @!attribute id
+      #   Unique identifier for the object.
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute cardinality
+      #   Specifies whether the field can hold a single value (`one`) or multiple values
+      #   (`many`).
+      #
+      #   @return [Symbol, Moonbase::Models::EmailField::Cardinality]
+      required :cardinality, enum: -> { Moonbase::EmailField::Cardinality }
+
+      # @!attribute created_at
+      #   Time at which the object was created, as an ISO 8601 timestamp in UTC.
+      #
+      #   @return [Time]
+      required :created_at, Time
+
+      # @!attribute name
+      #   The human-readable name of the field (e.g., "Work Email").
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute readonly
+      #   If `true`, the value of this field is system-managed and cannot be updated via
+      #   the API.
+      #
+      #   @return [Boolean]
+      required :readonly, Moonbase::Internal::Type::Boolean
+
+      # @!attribute ref
+      #   A unique, stable, machine-readable identifier for the field within its
+      #   collection (e.g., `work_email`).
+      #
+      #   @return [String]
+      required :ref, String
+
+      # @!attribute required
+      #   If `true`, this field must have a value.
+      #
+      #   @return [Boolean]
+      required :required, Moonbase::Internal::Type::Boolean
+
+      # @!attribute type
+      #   The data type of the field. Always `field/email` for this field.
+      #
+      #   @return [Symbol, :"field/email"]
+      required :type, const: :"field/email"
+
+      # @!attribute unique
+      #   If `true`, values for this field must be unique across all items in the
+      #   collection.
+      #
+      #   @return [Boolean]
+      required :unique, Moonbase::Internal::Type::Boolean
+
+      # @!attribute updated_at
+      #   Time at which the object was last updated, as an ISO 8601 timestamp in UTC.
+      #
+      #   @return [Time]
+      required :updated_at, Time
+
+      # @!attribute description
+      #   An optional, longer-form description of the field's purpose.
+      #
+      #   @return [String, nil]
+      optional :description, String
+
+      # @!method initialize(id:, cardinality:, created_at:, name:, readonly:, ref:, required:, unique:, updated_at:, description: nil, type: :"field/email")
+      #   Some parameter documentations has been truncated, see
+      #   {Moonbase::Models::EmailField} for more details.
+      #
+      #   A field that stores and validates email addresses.
+      #
+      #   @param id [String] Unique identifier for the object.
+      #
+      #   @param cardinality [Symbol, Moonbase::Models::EmailField::Cardinality] Specifies whether the field can hold a single value (`one`) or multiple values (
+      #
+      #   @param created_at [Time] Time at which the object was created, as an ISO 8601 timestamp in UTC.
+      #
+      #   @param name [String] The human-readable name of the field (e.g., "Work Email").
+      #
+      #   @param readonly [Boolean] If `true`, the value of this field is system-managed and cannot be updated via t
+      #
+      #   @param ref [String] A unique, stable, machine-readable identifier for the field within its collectio
+      #
+      #   @param required [Boolean] If `true`, this field must have a value.
+      #
+      #   @param unique [Boolean] If `true`, values for this field must be unique across all items in the collecti
+      #
+      #   @param updated_at [Time] Time at which the object was last updated, as an ISO 8601 timestamp in UTC.
+      #
+      #   @param description [String] An optional, longer-form description of the field's purpose.
+      #
+      #   @param type [Symbol, :"field/email"] The data type of the field. Always `field/email` for this field.
+
+      # Specifies whether the field can hold a single value (`one`) or multiple values
+      # (`many`).
+      #
+      # @see Moonbase::Models::EmailField#cardinality
+      module Cardinality
+        extend Moonbase::Internal::Type::Enum
+
+        ONE = :one
+        MANY = :many
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end