stretchy-model 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dd18b424c18bda352233d72af113e9bbc944277e03a02cfb950780f0fab9a405
-  data.tar.gz: 6eb86522e7bc91012cc4c743d0a9fccc54c7e75b14ff4d6f4fca5bdb9fa31626
+  metadata.gz: f23580fe0c8761ced02da75cbc44f16ab7893a559d30d9a5e0de23aa96ed790a
+  data.tar.gz: 821381d3e9e92822d71aac637d98f8b04a76736a80e421ca7d2c4fd05fd108d8
 SHA512:
-  metadata.gz: 0fd2a0fb25439d79c799f43f43bb01df7c4dfe0ce9eb577d445b6d415eb9c38ecdc0f45c73d8255d2e079ff502e943f6491b874e3bb9c41fc9c853efed84d252
-  data.tar.gz: 8ea4cfa584ec825ac30aa4aa5dea88b04c709cbf7cc75089e28cd1e850318f150f1f68ead89bc571535739aa8ff8db777102d5dd05173087d4af499bac8d8bbb
+  metadata.gz: 99dc36ee6cce021e869a8e1f3e2f005f546b1c50bf973434c624574c1dd601757baf4a1d39562f7ddd05bf4a1e640512111b821d8a70b8d5416bf73701b38f03
+  data.tar.gz: 4a58307bd7ae5a5781e7462df9c95438f66eecab5d0ae43238878d228e2ca6939a8a7643b70ac3c2586dcae537935206bfb15339415f6b3c3a70ef2518e401b4

data/lib/rails/instrumentation/railtie.rb

@@ -4,6 +4,8 @@ module Stretchy
     class Railtie < ::Rails::Railtie
 
       require 'rails/instrumentation/publishers'
+      Stretchy.instrument!
+
       ActiveSupport::Notifications.subscribe 'search.stretchy' do |name, start, finish, id, payload|
         message = [
            Rainbow("  #{payload[:klass]}").bright, 

data/lib/stretchy/associations.rb

@@ -38,7 +38,7 @@ module Stretchy
     end
 
     def association_reflection(association)
-      Stretchy::Relation.new @@_associations[association], (dirty[association.to_sym] || [])
+      Stretchy::Relation.new @@_associations[association], (dirty[association.to_sym] || {})
     end
 
     def _destroy=(bool)

data/lib/stretchy/attributes/type/array.rb

@@ -1,15 +1,20 @@
-module Stretchy
-    module Attributes
-        module Type
-
-            class Array < ActiveModel::Type::Value # :nodoc:
-
-                def type
-                    :array
-                end
+module Stretchy::Attributes::Type
+  class Array < Stretchy::Attributes::Type::Base # :nodoc:
+    OPTIONS = [:data_type, :fields]
+    def type
+      :array
+    end
 
-            end
+    def type_for_database
+      data_type || :text
+    end
 
-        end
+    def mappings(name)
+      options = {type: type_for_database}
+      self.class::OPTIONS.each { |option| options[option] = send(option) unless send(option).nil? }
+      options.delete(:fields) if fields == false
+      options[:fields] = {keyword: {type: :keyword, ignore_above: 256}} if type_for_database == :text && fields.nil?
+      { name => options }.as_json
     end
+  end
 end

data/lib/stretchy/attributes/type/base.rb

@@ -0,0 +1,42 @@
+module Stretchy
+    module Attributes
+        module Type
+            class Base < ActiveModel::Type::Value
+
+              OPTIONS = []
+
+      
+              def initialize(**args)
+
+                define_option_methods!
+
+                args.each do |k, v|
+                  if self.class::OPTIONS.include?(k)
+                    instance_variable_set("@#{k}", v) 
+                    args.delete(k)
+                  end
+                end
+                super
+              end
+      
+              def mappings(name)
+                options = {type: type_for_database}
+                self.class::OPTIONS.each { |option| options[option] = send(option) unless send(option).nil? }
+                { name => options }.as_json
+              end
+
+              def type_for_database
+                type
+              end
+
+              private
+
+              def define_option_methods!
+                self.class::OPTIONS.each do |option|
+                  define_singleton_method(option.to_sym) { instance_variable_get("@#{option}") }
+                end
+              end
+            end
+        end
+    end
+end

data/lib/stretchy/attributes/type/binary.rb

@@ -0,0 +1,45 @@
+# Public: Defines a binary attribute for the model.
+#
+# name - The Symbol name of the attribute.
+# opts - The Hash options used to refine the attribute (default: {}):
+#        :doc_values - The Boolean indicating if the field should be stored on disk in a column-stride fashion.
+#                      This allows it to be used later for sorting, aggregations, or scripting. Defaults to false.
+#        :store - The Boolean indicating if the field value should be stored and retrievable separately from the _source field. Defaults to false.
+#
+# Examples
+#
+#   class MyModel
+#     include StretchyModel
+#     attribute :name, :binary, doc_values: true, store: true
+#   end
+#
+# Returns nothing.
+module Stretchy
+    module Attributes
+        module Type
+            class Binary < ActiveModel::Type::Value
+                OPTIONS = [:doc_values, :store]
+                attr_reader *OPTIONS 
+
+                def initialize(**args)  
+                  args.each do |k, v|
+                    instance_variable_set("@#{k}", v) if OPTIONS.include?(k)
+                    args.delete(k)
+                  end
+                  super
+                end
+
+                def type
+                    :binary
+                end
+
+
+                def mappings(name) 
+                  options = {type: type}
+                  OPTIONS.each { |_| options[_] = self.send(_) }
+                  { name => options }.as_json
+                end
+            end
+        end
+    end
+end

data/lib/stretchy/attributes/type/boolean.rb

@@ -0,0 +1,48 @@
+# Public: Defines a boolean attribute for the model.
+#
+# name - The Symbol name of the attribute.
+# opts - The Hash options used to refine the attribute (default: {}):
+#        :doc_values - The Boolean indicating if the field should be stored on disk in a column-stride fashion.
+#                      This allows it to be used later for sorting, aggregations, or scripting. Defaults to true.
+#        :index - The Boolean indicating if the field should be quickly searchable. Defaults to true.
+#        :ignore_malformed - The Boolean indicating if exceptions thrown when trying to index the wrong data type into a field should be ignored. Defaults to false.
+#        :null_value - The Boolean value to be substituted for any explicit null values. Defaults to null.
+#        :on_script_error - The String defining what to do if the script defined by the :script parameter throws an error at indexing time. Can be 'fail' or 'continue'.
+#        :script - The String script that will index values generated by this script, rather than reading the values directly from the source.
+#        :store - The Boolean indicating if the field value should be stored and retrievable separately from the _source field. Defaults to false.
+#        :meta - The Hash metadata about the field.
+#
+# Examples
+#
+#   class MyModel
+#     include StretchyModel
+#     attribute :name, :boolean, doc_values: true, store: true
+#   end
+#
+# Returns nothing.
+module Stretchy
+  module Attributes
+    module Type
+      class Boolean < Stretchy::Attributes::Type::Base
+
+        OPTIONS = [:doc_values, :index, :ignore_malformed, :null_value, :on_script_error, :script, :store, :meta]
+        attr_reader *OPTIONS 
+
+        def initialize(**args)  
+          args.each do |k, v|
+            instance_variable_set("@#{k}", v) if OPTIONS.include?(k)
+            args.delete(k)
+          end
+          super
+        end
+
+        def type
+          :boolean
+        end
+
+
+
+      end
+    end
+  end
+end

data/lib/stretchy/attributes/type/completion.rb

@@ -0,0 +1,25 @@
+module Stretchy::Attributes::Type
+  # Public: Defines a completion attribute for the model.
+  #
+  # opts - The Hash options used to refine the attribute (default: {}):
+  #        :analyzer - The String index analyzer to use. Defaults to 'simple'.
+  #        :search_analyzer - The String search analyzer to use. Defaults to the value of :analyzer.
+  #        :preserve_separators - The Boolean indicating if separators should be preserved. Defaults to true.
+  #        :preserve_position_increments - The Boolean indicating if position increments should be enabled. Defaults to true.
+  #        :max_input_length - The Integer limit for the length of a single input. Defaults to 50.
+  #
+  # Examples
+  #
+  #   class MyModel < Stretchy::Record
+  #     attribute :name, :completion, analyzer: 'simple', max_input_length: 100
+  #   end
+  #
+  # Returns nothing.
+  class Completion < Stretchy::Attributes::Type::Base
+    OPTIONS = [:analyzer, :search_analyzer, :preserve_separators, :preserve_position_increments, :max_input_length]
+    attr_reader *OPTIONS
+    def type
+      :completion
+    end
+  end
+end

data/lib/stretchy/attributes/type/constant_keyword.rb

@@ -0,0 +1,38 @@
+module Stretchy::Attributes::Type
+  # Public: Defines a constant_keyword attribute for the model. This field type is a specialization of the keyword field, but it only accepts a single value.
+  #
+  # opts - The Hash options used to refine the attribute (default: {}):
+  #        :doc_values - The Boolean indicating if the field should be stored on disk in a column-stride fashion. Defaults to true.
+  #        :eager_global_ordinals - The Boolean indicating if global ordinals should be loaded eagerly on refresh. Defaults to false.
+  #        :fields - The Hash of multi-fields for the same string value to be indexed in multiple ways.
+  #        :ignore_above - The Integer limit for the length of the string. Strings longer than this limit will not be indexed. Defaults to 2147483647.
+  #        :index - The Boolean indicating if the field should be quickly searchable. Defaults to true.
+  #        :index_options - The String indicating what information should be stored in the index for scoring purposes. Defaults to 'docs'.
+  #        :meta - The Hash metadata about the field.
+  #        :norms - The Boolean indicating if field-length should be taken into account when scoring queries. Defaults to false.
+  #        :null_value - The String value to be substituted for any explicit null values. Defaults to null.
+  #        :on_script_error - The String defining what to do if the script defined by the :script parameter throws an error at indexing time. Can be 'fail' or 'continue'.
+  #        :script - The String script that will index values generated by this script, rather than reading the values directly from the source.
+  #        :store - The Boolean indicating if the field value should be stored and retrievable separately from the _source field. Defaults to false.
+  #        :similarity - The String scoring algorithm or similarity to be used. Defaults to 'BM25'.
+  #        :normalizer - The String pre-processor for the keyword prior to indexing. Defaults to null.
+  #        :split_queries_on_whitespace - The Boolean indicating if full text queries should split the input on whitespace. Defaults to false.
+  #        :time_series_dimension - The Boolean indicating if the field is a time series dimension. Defaults to false.
+  #        :value - The String value to associate with all documents in the index.
+  #
+  # Examples
+  #
+  #   class MyModel
+  #     include StretchyModel
+  #     attribute :status, :constant_keyword, value: 'active'
+  #   end
+  #
+  # Returns nothing.
+  class ConstantKeyword < Stretchy::Attributes::Type::Keyword
+    OPTIONS = OPTIONS + [:value]
+    attr_reader *OPTIONS
+    def type
+      :constant_keyword
+    end
+  end
+end

data/lib/stretchy/attributes/type/date_time.rb

@@ -0,0 +1,35 @@
+module Stretchy::Attributes::Type
+  # Public: Defines a datetime attribute for the model.
+  #
+  # opts - The Hash options used to refine the attribute (default: {}):
+  #        :doc_values - The Boolean indicating if the field should be stored on disk in a column-stride fashion.
+  #                      This allows it to be used later for sorting, aggregations, or scripting. Defaults to true.
+  #        :format - The String date format(s) that can be parsed. Defaults to 'strict_date_optional_time||epoch_millis'.
+  #        :locale - The String locale to use when parsing dates. Defaults to the ROOT locale.
+  #        :ignore_malformed - The Boolean indicating if malformed numbers should be ignored. Defaults to false.
+  #        :index - The Boolean indicating if the field should be quickly searchable. Defaults to true.
+  #        :null_value - The Date value to be substituted for any explicit null values. Defaults to null.
+  #        :on_script_error - The String defining what to do if the script defined by the :script parameter throws an error at indexing time. Can be 'fail' or 'continue'.
+  #        :script - The String script that will index values generated by this script, rather than reading the values directly from the source.
+  #        :store - The Boolean indicating if the field value should be stored and retrievable separately from the _source field. Defaults to false.
+  #        :meta - The Hash metadata about the field.
+  #
+  # Examples
+  #
+  #   class MyModel < Stretchy::Record
+  #     attribute :created_at, :datetime, format: 'strict_date_optional_time||epoch_millis', locale: 'en'
+  #   end
+  #
+  # Returns nothing.
+  class DateTime < Stretchy::Attributes::Type::Base
+    OPTIONS = [:doc_values, :format, :locale, :ignore_malformed, :index, :null_value, :on_script_error, :script, :store, :meta]
+    attr_reader *OPTIONS
+    def type
+      :datetime
+    end
+
+    def type_for_database
+      :date
+    end
+  end
+end

data/lib/stretchy/attributes/type/dense_vector.rb

@@ -0,0 +1,59 @@
+# Public: Defines a dense vector attribute for the model.
+#
+# name - The Symbol name of the attribute.
+# opts - The Hash options used to refine the attribute (default: {}):
+#        :element_type - The String data type used to encode vectors. Can be 'float' or 'byte'.
+#                        'float' indexes a 4-byte floating-point value per dimension.
+#                        'byte' indexes a 1-byte integer value per dimension.
+#                        Vectors using 'byte' require dimensions with integer values between -128 to 127.
+#        :dims - The Integer number of vector dimensions. Can’t exceed 4096.
+#                If not specified, it will be set to the length of the first vector added to the field.
+#        :index - The Boolean indicating if you can search this field using the kNN search API (default: true).
+#        :similarity - The String vector similarity metric to use in kNN search. Can be 'l2_norm', 'dot_product', 'cosine', or 'max_inner_product'.
+#                      This parameter can only be specified when :index is true.
+#        :index_options - The Hash that configures the kNN indexing algorithm. Can only be specified when :index is true.
+#                         :type - The String type of kNN algorithm to use. Can be either 'hnsw' or 'int8_hnsw'.
+#                         :m - The Integer number of neighbors each node will be connected to in the HNSW graph.
+#                         :ef_construction - The Integer number of candidates to track while assembling the list of nearest neighbors for each new node.
+#                         :confidence_interval - The Float confidence interval to use when quantizing the vectors. Only applicable to 'int8_hnsw' index types.
+#
+# Examples
+#
+#   class MyModel
+#     include StretchyModel
+#     attribute :vector_embeddings, :dense_vector, element_type: 'float', dims: 3
+#   end
+#
+# Returns nothing.
+module Stretchy
+  module Attributes
+      module Type
+          class DenseVector < Stretchy::Attributes::Type::Base
+              OPTIONS = [:element_type, :dims, :index, :similarity, :index_options]
+              attr_reader *OPTIONS 
+
+              def initialize(**args)  
+                args.each do |k, v|
+                  instance_variable_set("@#{k}", v) if OPTIONS.include?(k)
+                  args.delete(k)
+                end
+                super
+              end
+
+              def type
+                :dense_vector
+              end
+
+              def mappings(name) 
+                options = {type: type}
+                OPTIONS.each { |_| options[_] = self.send(_) }
+                {
+                  properties: {
+                    "#{name}.tokens": options
+                  }
+                }.as_json
+              end
+          end
+      end
+  end
+end

data/lib/stretchy/attributes/type/flattened.rb

@@ -0,0 +1,31 @@
+module Stretchy::Attributes::Type
+  # Public: Defines a flattened attribute for the model.
+  #
+  # opts - The Hash options used to refine the attribute (default: {}):
+  #        :depth_limit - The Integer maximum allowed depth of the flattened object field. Defaults to 20.
+  #        :doc_values - The Boolean indicating if the field should be stored on disk in a column-stride fashion. Defaults to true.
+  #        :eager_global_ordinals - The Boolean indicating if global ordinals should be loaded eagerly on refresh. Defaults to false.
+  #        :ignore_above - The Integer limit for the length of leaf values. Values longer than this limit will not be indexed. By default, there is no limit.
+  #        :index - The Boolean indicating if the field should be searchable. Defaults to true.
+  #        :index_options - The String indicating what information should be stored in the index for scoring purposes. Defaults to 'docs'.
+  #        :null_value - The String value to be substituted for any explicit null values. Defaults to null.
+  #        :similarity - The String scoring algorithm or similarity to be used. Defaults to 'BM25'.
+  #        :split_queries_on_whitespace - The Boolean indicating if full text queries should split the input on whitespace. Defaults to false.
+  #        :time_series_dimensions - The Array of Strings indicating the fields inside the flattened object that are dimensions of the time series.
+  #
+  # Examples
+  #
+  #   class MyModel
+  #     include StretchyModel
+  #     attribute :metadata, :flattened, depth_limit: 10, index_options: 'freqs'
+  #   end
+  #
+  # Returns nothing.
+  class Flattened < Stretchy::Attributes::Type::Base
+    OPTIONS = [:depth_limit, :doc_values, :eager_global_ordinals, :ignore_above, :index, :index_options, :null_value, :similarity, :split_queries_on_whitespace, :time_series_dimensions]
+
+    def type
+      :flattened
+    end
+  end
+end

data/lib/stretchy/attributes/type/geo_point.rb

@@ -0,0 +1,27 @@
+module Stretchy::Attributes::Type
+  # Public: Defines a geo_point attribute for the model.
+  #
+  # opts - The Hash options used to refine the attribute (default: {}):
+  #        :ignore_malformed - The Boolean indicating if malformed geopoints should be ignored. Defaults to false.
+  #        :ignore_z_value - The Boolean indicating if three dimension points should be accepted but only latitude and longitude values should be indexed. Defaults to true.
+  #        :index - The Boolean indicating if the field should be quickly searchable. Defaults to true.
+  #        :null_value - The GeoPoint value to be substituted for any explicit null values. Defaults to null.
+  #        :on_script_error - The String defining what to do if the script defined by the :script parameter throws an error at indexing time. Can be 'fail' or 'continue'.
+  #        :script - The String script that will index values generated by this script, rather than reading the values directly from the source.
+  #
+  # Examples
+  #
+  #   class MyModel
+  #     include StretchyModel
+  #     attribute :location, :geo_point, ignore_malformed: true
+  #   end
+  #
+  # Returns nothing.
+  class GeoPoint < Stretchy::Attributes::Type::Base
+    OPTIONS = [:ignore_malformed, :ignore_z_value, :index, :null_value, :on_script_error, :script]
+
+    def type
+      :geo_point
+    end
+  end
+end

data/lib/stretchy/attributes/type/geo_shape.rb

@@ -0,0 +1,27 @@
+module Stretchy::Attributes::Type
+  # Public: Defines a geo_shape attribute for the model.
+  #
+  # opts - The Hash options used to refine the attribute (default: {}):
+  #        :orientation - The String default orientation for the field’s WKT polygons. Can be 'right', 'counterclockwise', 'ccw', 'left', 'clockwise', or 'cw'. Defaults to 'right'.
+  #        :ignore_malformed - The Boolean indicating if malformed GeoJSON or WKT shapes should be ignored. Defaults to false.
+  #        :ignore_z_value - The Boolean indicating if three dimension points should be accepted but only latitude and longitude values should be indexed. Defaults to true.
+  #        :coerce - The Boolean indicating if unclosed linear rings in polygons should be automatically closed. Defaults to false.
+  #        :index - The Boolean indicating if the field should be quickly searchable. Defaults to true.
+  #        :doc_values - The Boolean indicating if the field should be stored on disk in a column-stride fashion. Defaults to true.
+  #
+  # Examples
+  #
+  #   class MyModel
+  #     include StretchyModel
+  #     attribute :boundary, :geo_shape, orientation: 'left', coerce: true
+  #   end
+  #
+  # Returns nothing.
+  class GeoShape < Stretchy::Attributes::Type::Base
+    OPTIONS = [:orientation, :ignore_malformed, :ignore_z_value, :coerce, :index, :doc_values]
+
+    def type
+      :geo_shape
+    end
+  end
+end

data/lib/stretchy/attributes/type/hash.rb

@@ -1,17 +1,40 @@
-module Stretchy
-    module Attributes
-        module Type
-            class Hash < ActiveModel::Type::Value # :nodoc:
-                def type
-                    :hash
-                end
+module Stretchy::Attributes::Type
+  # Public: Defines a hash attribute for the model.
+  #
+  # opts - The Hash options used to refine the attribute (default: {}):
+  #        :dynamic - The String indicating if new properties should be added dynamically to an existing object. Can be 'true', 'runtime', 'false', or 'strict'. Defaults to 'true'.
+  #        :enabled - The Boolean indicating if the JSON value for the object field should be parsed and indexed. Defaults to true.
+  #        :subobjects - The Boolean indicating if the object can hold subobjects. Defaults to true.
+  #        :properties - The Hash of fields within the object, which can be of any data type, including object.
+  #
+  # Examples
+  #
+  #   class MyModel < Stretchy::Record
+  #     attribute :metadata, :hash, dynamic: 'strict', subobjects: false
+  #   end
+  #
+  # Returns nothing.
+  class Hash < Stretchy::Attributes::Type::Base
+    OPTIONS = [:dynamic, :enabled, :subobjects, :properties]
 
-                private
+    def type
+      :hash
+    end
+
+    def type_for_database
+      :object
+    end
+
+    def mappings(name)
+      options = {}
+      OPTIONS.each { |option| options[option] = send(option) unless send(option).nil? }
+      { name => options }.as_json
+    end
+
+    private
 
-                def cast_value(value)
-                    Elasticsearch::Model::HashWrapper[value]
-                end
-            end
-        end
+    def cast_value(value)
+      Elasticsearch::Model::HashWrapper[value]
     end
+  end
 end

data/lib/stretchy/attributes/type/histogram.rb

@@ -0,0 +1,7 @@
+module Stretchy::Attributes::Type
+    class Histogram < Stretchy::Attributes::Type::Base
+        def type
+            :histogram
+        end
+    end
+end

data/lib/stretchy/attributes/type/ip.rb

@@ -0,0 +1,29 @@
+module Stretchy::Attributes::Type
+  # Public: Defines an IP attribute for the model.
+  #
+  # opts - The Hash options used to refine the attribute (default: {}):
+  #        :doc_values - The Boolean indicating if the field should be stored on disk in a column-stride fashion. Defaults to true.
+  #        :ignore_malformed - The Boolean indicating if malformed IP addresses should be ignored. Defaults to false.
+  #        :index - The Boolean indicating if the field should be quickly searchable. Defaults to true.
+  #        :null_value - The String IPv4 or IPv6 value to be substituted for any explicit null values. Defaults to null.
+  #        :on_script_error - The String defining what to do if the script defined by the :script parameter throws an error at indexing time. Can be 'reject' or 'ignore'.
+  #        :script - The String script that will index values generated by this script, rather than reading the values directly from the source.
+  #        :store - The Boolean indicating if the field value should be stored and retrievable separately from the _source field. Defaults to false.
+  #        :time_series_dimension - The Boolean indicating if the field is a time series dimension. Defaults to false.
+  #
+  # Examples
+  #
+  #   class MyModel
+  #     include StretchyModel
+  #     attribute :ip_address, :ip, ignore_malformed: true, time_series_dimension: true
+  #   end
+  #
+  # Returns nothing.
+  class IP < Stretchy::Attributes::Type::Base
+    OPTIONS = [:doc_values, :ignore_malformed, :index, :null_value, :on_script_error, :script, :store, :time_series_dimension]
+
+    def type
+      :ip
+    end
+  end
+end

data/lib/stretchy/attributes/type/join.rb

@@ -0,0 +1,22 @@
+module Stretchy::Attributes::Type
+  # Public: Defines a join attribute for the model.
+  #
+  # opts - The Hash options used to define the parent/child relation within documents of the same index (default: {}):
+  #        :relations - The Hash defining a set of possible relations within the documents, each relation being a parent name and a child name.
+  #
+  # Examples
+  #
+  #   class MyModel
+  #     include StretchyModel
+  #     attribute :relation, :join, relations: { question: :answer }
+  #   end
+  #
+  # Returns nothing.
+  class Join < Stretchy::Attributes::Type::Base
+    OPTIONS = [:relations]
+
+    def type
+      :join
+    end
+  end
+end

data/lib/stretchy/attributes/type/keyword.rb

@@ -1,11 +1,37 @@
-module Stretchy
-    module Attributes
-        module Type
-            class Keyword < ActiveModel::Type::String # :nodoc:
-                def type
-                    :keyword
-                end
-            end
-        end
+module Stretchy::Attributes::Type
+    # Public: Defines a keyword attribute for the model.
+    #
+    # opts - The Hash options used to refine the attribute (default: {}):
+    #
+    #        :doc_values - The Boolean indicating if the field should be stored on disk in a column-stride fashion. Defaults to true.
+    #        :eager_global_ordinals - The Boolean indicating if global ordinals should be loaded eagerly on refresh. Defaults to false.
+    #        :fields - The Hash of multi-fields for the same string value to be indexed in multiple ways.
+    #        :ignore_above - The Integer limit for the length of the string. Strings longer than this limit will not be indexed. Defaults to 2147483647.
+    #        :index - The Boolean indicating if the field should be quickly searchable. Defaults to true.
+    #        :index_options - The String indicating what information should be stored in the index for scoring purposes. Defaults to 'docs'.
+    #        :meta - The Hash metadata about the field.
+    #        :norms - The Boolean indicating if field-length should be taken into account when scoring queries. Defaults to false.
+    #        :null_value - The String value to be substituted for any explicit null values. Defaults to null.
+    #        :on_script_error - The String defining what to do if the script defined by the :script parameter throws an error at indexing time. Can be 'fail' or 'continue'.
+    #        :script - The String script that will index values generated by this script, rather than reading the values directly from the source.
+    #        :store - The Boolean indicating if the field value should be stored and retrievable separately from the _source field. Defaults to false.
+    #        :similarity - The String scoring algorithm or similarity to be used. Defaults to 'BM25'.
+    #        :normalizer - The String pre-processor for the keyword prior to indexing. Defaults to null.
+    #        :split_queries_on_whitespace - The Boolean indicating if full text queries should split the input on whitespace. Defaults to false.
+    #        :time_series_dimension - The Boolean indicating if the field is a time series dimension. Defaults to false.
+    #
+    # Examples
+    #   class MyModel
+    #     include StretchyModel
+    #     attribute :tag, :keyword, ignore_above: 256, time_series_dimension: true
+    #   end
+    #
+    # Returns nothing.
+    class Keyword < Stretchy::Attributes::Type::Base
+      OPTIONS = [:doc_values, :eager_global_ordinals, :fields, :ignore_above, :index, :index_options, :meta, :norms, :null_value, :on_script_error, :script, :store, :similarity, :normalizer, :split_queries_on_whitespace, :time_series_dimension]
+  
+      def type
+        :keyword
+      end
     end
-end
+  end

data/lib/stretchy/attributes/type/match_only_text.rb

@@ -0,0 +1,8 @@
+# a space-optimized variant of text that disables scoring and performs slower on queries that need positions. It is best suited for indexing log messages.
+module Stretchy::Attributes::Type
+  class MatchOnlyText < Stretchy::Attributes::Type::Text
+    def type
+      :match_only_text
+    end
+  end
+end

data/lib/stretchy/attributes/type/nested.rb

@@ -0,0 +1,25 @@
+module Stretchy::Attributes::Type
+  # Public: Defines a nested attribute for the model.
+  #
+  # opts - The Hash options used to refine the attribute (default: {}):
+  #        :dynamic - The String indicating if new properties should be added dynamically to an existing nested object. Can be 'true', 'false', or 'strict'. Defaults to 'true'.
+  #        :properties - The Hash of fields within the nested object, which can be of any data type, including nested.
+  #        :include_in_parent - The Boolean indicating if all fields in the nested object are also added to the parent document as standard fields. Defaults to false.
+  #        :include_in_root - The Boolean indicating if all fields in the nested object are also added to the root document as standard fields. Defaults to false.
+  #
+  # Examples
+  #
+  #   class MyModel
+  #     include StretchyModel
+  #     attribute :metadata, :nested, dynamic: 'strict', include_in_parent: true
+  #   end
+  #
+  # Returns nothing.
+  class Nested < Stretchy::Attributes::Type::Base
+    OPTIONS = [:dynamic, :properties, :include_in_parent, :include_in_root]
+
+    def type
+      :nested
+    end
+  end
+end