cmdx 1.9.0 → 1.10.0

data/lib/cmdx/context.rb

@@ -11,6 +11,14 @@ module CMDx
 
     extend Forwardable
 
+    # Returns the internal hash storing context data.
+    #
+    # @return [Hash{Symbol => Object}] The internal hash table
+    #
+    # @example
+    #   context.table # => { name: "John", age: 30 }
+    #
+    # @rbs @table: Hash[Symbol, untyped]
     attr_reader :table
     alias to_h table
 
@@ -28,6 +36,8 @@ module CMDx
     # @example
     #   context = Context.new(name: "John", age: 30)
     #   context[:name] # => "John"
+    #
+    # @rbs (untyped args) -> void
     def initialize(args = {})
       @table =
         if args.respond_to?(:to_hash)
@@ -50,6 +60,8 @@ module CMDx
     #   existing = Context.new(name: "John")
     #   built = Context.build(existing) # reuses existing context
     #   built.object_id == existing.object_id # => true
+    #
+    # @rbs (untyped context) -> Context
     def self.build(context = {})
       if context.is_a?(self) && !context.frozen?
         context
@@ -70,6 +82,8 @@ module CMDx
     #   context = Context.new(name: "John")
     #   context[:name] # => "John"
     #   context["name"] # => "John" (automatically converted to symbol)
+    #
+    # @rbs ((String | Symbol) key) -> untyped
     def [](key)
       table[key.to_sym]
     end
@@ -85,6 +99,8 @@ module CMDx
     #   context = Context.new
     #   context.store(:name, "John")
     #   context[:name] # => "John"
+    #
+    # @rbs ((String | Symbol) key, untyped value) -> untyped
     def store(key, value)
       table[key.to_sym] = value
     end
@@ -104,6 +120,8 @@ module CMDx
     #   context.fetch(:name) # => "John"
     #   context.fetch(:age, 25) # => 25
     #   context.fetch(:city) { |key| "Unknown #{key}" } # => "Unknown city"
+    #
+    # @rbs ((String | Symbol) key, *untyped) ?{ ((String | Symbol)) -> untyped } -> untyped
     def fetch(key, ...)
       table.fetch(key.to_sym, ...)
     end
@@ -122,6 +140,8 @@ module CMDx
     #   context.fetch_or_store(:name, "Default") # => "John" (existing value)
     #   context.fetch_or_store(:age, 25) # => 25 (stored and returned)
     #   context.fetch_or_store(:city) { |key| "Unknown #{key}" } # => "Unknown city" (stored and returned)
+    #
+    # @rbs ((String | Symbol) key, ?untyped value) ?{ () -> untyped } -> untyped
     def fetch_or_store(key, value = nil)
       table.fetch(key.to_sym) do
         table[key.to_sym] = block_given? ? yield : value
@@ -139,6 +159,8 @@ module CMDx
     #   context = Context.new(name: "John")
     #   context.merge!(age: 30, city: "NYC")
     #   context.to_h # => {name: "John", age: 30, city: "NYC"}
+    #
+    # @rbs (?untyped args) -> self
     def merge!(args = {})
       args.to_h.each { |key, value| self[key.to_sym] = value }
       self
@@ -156,6 +178,8 @@ module CMDx
     #   context = Context.new(name: "John", age: 30)
     #   context.delete!(:age) # => 30
     #   context.delete!(:city) { |key| "Key #{key} not found" } # => "Key city not found"
+    #
+    # @rbs ((String | Symbol) key) ?{ ((String | Symbol)) -> untyped } -> untyped
     def delete!(key, &)
       table.delete(key.to_sym, &)
     end
@@ -170,6 +194,8 @@ module CMDx
     #   context1 = Context.new(name: "John")
     #   context2 = Context.new(name: "John")
     #   context1 == context2 # => true
+    #
+    # @rbs (untyped other) -> bool
     def eql?(other)
       other.is_a?(self.class) && (to_h == other.to_h)
     end
@@ -185,6 +211,8 @@ module CMDx
     #   context = Context.new(name: "John")
     #   context.key?(:name) # => true
     #   context.key?(:age) # => false
+    #
+    # @rbs ((String | Symbol) key) -> bool
     def key?(key)
       table.key?(key.to_sym)
     end
@@ -200,6 +228,8 @@ module CMDx
     #   context = Context.new(user: {profile: {name: "John"}})
     #   context.dig(:user, :profile, :name) # => "John"
     #   context.dig(:user, :profile, :age) # => nil
+    #
+    # @rbs ((String | Symbol) key, *(String | Symbol) keys) -> untyped
     def dig(key, *keys)
       table.dig(key.to_sym, *keys)
     end
@@ -211,6 +241,8 @@ module CMDx
     # @example
     #   context = Context.new(name: "John", age: 30)
     #   context.to_s # => "name: John, age: 30"
+    #
+    # @rbs () -> String
     def to_s
       Utils::Format.to_str(to_h)
     end
@@ -227,6 +259,8 @@ module CMDx
     # @yield [Object] optional block
     #
     # @return [Object] the result of the method call
+    #
+    # @rbs (Symbol method_name, *untyped args, **untyped _kwargs) ?{ () -> untyped } -> untyped
     def method_missing(method_name, *args, **_kwargs, &)
       fetch(method_name) do
         store(method_name[0..-2], args.first) if method_name.end_with?("=")
@@ -244,6 +278,8 @@ module CMDx
     #   context = Context.new(name: "John")
     #   context.respond_to?(:name) # => true
     #   context.respond_to?(:age) # => false
+    #
+    # @rbs (Symbol method_name, ?bool include_private) -> bool
     def respond_to_missing?(method_name, include_private = false)
       key?(method_name) || super
     end

data/lib/cmdx/deprecator.rb

@@ -10,6 +10,7 @@ module CMDx
 
     extend self
 
+    # @rbs EVAL: Proc
     EVAL = proc do |target, callable|
       case callable
       when /raise|log|warn/ then callable
@@ -45,6 +46,8 @@ module CMDx
     #   end
     #
     #   MyTask.new # => [MyTask] DEPRECATED: migrate to a replacement or discontinue use
+    #
+    # @rbs (Task task) -> void
     def restrict(task)
       type = EVAL.call(task, task.class.settings[:deprecate])
 

data/lib/cmdx/errors.rb

@@ -8,11 +8,21 @@ module CMDx
 
     extend Forwardable
 
+    # Returns the internal hash of error messages by attribute.
+    #
+    # @return [Hash{Symbol => Set<String>}] Hash mapping attribute names to error message sets
+    #
+    # @example
+    #   errors.messages # => { email: #<Set: ["must be valid", "is required"]> }
+    #
+    # @rbs @messages: Hash[Symbol, Set[String]]
     attr_reader :messages
 
     def_delegators :messages, :empty?
 
     # Initialize a new error collection.
+    #
+    # @rbs () -> void
     def initialize
       @messages = {}
     end
@@ -26,6 +36,8 @@ module CMDx
     #   errors = CMDx::Errors.new
     #   errors.add(:email, "must be valid format")
     #   errors.add(:email, "cannot be blank")
+    #
+    # @rbs (Symbol attribute, String message) -> void
     def add(attribute, message)
       return if message.empty?
 
@@ -42,6 +54,8 @@ module CMDx
     # @example
     #   errors.for?(:email) # => true
     #   errors.for?(:name)  # => false
+    #
+    # @rbs (Symbol attribute) -> bool
     def for?(attribute)
       return false unless messages.key?(attribute)
 
@@ -54,6 +68,8 @@ module CMDx
     #
     # @example
     #   errors.full_messages # => { email: ["email must be valid format", "email cannot be blank"] }
+    #
+    # @rbs () -> Hash[Symbol, Array[String]]
     def full_messages
       messages.each_with_object({}) do |(attribute, messages), hash|
         hash[attribute] = messages.map { |message| "#{attribute} #{message}" }
@@ -66,6 +82,8 @@ module CMDx
     #
     # @example
     #   errors.to_h # => { email: ["must be valid format", "cannot be blank"] }
+    #
+    # @rbs () -> Hash[Symbol, Array[String]]
     def to_h
       messages.transform_values(&:to_a)
     end
@@ -78,6 +96,8 @@ module CMDx
     # @example
     #   errors.to_hash # => { email: ["must be valid format", "cannot be blank"] }
     #   errors.to_hash(true) # => { email: ["email must be valid format", "email cannot be blank"] }
+    #
+    # @rbs (?bool full) -> Hash[Symbol, Array[String]]
     def to_hash(full = false)
       full ? full_messages : to_h
     end
@@ -88,6 +108,8 @@ module CMDx
     #
     # @example
     #   errors.to_s # => "email must be valid format. email cannot be blank"
+    #
+    # @rbs () -> String
     def to_s
       full_messages.values.flatten.join(". ")
     end

data/lib/cmdx/executor.rb

@@ -8,6 +8,14 @@ module CMDx
   # and proper error handling for different types of failures.
   class Executor
 
+    # Returns the task being executed.
+    #
+    # @return [Task] The task instance
+    #
+    # @example
+    #   executor.task.id # => "abc123"
+    #
+    # @rbs @task: Task
     attr_reader :task
 
     # @param task [CMDx::Task] The task to execute
@@ -16,6 +24,8 @@ module CMDx
     #
     # @example
     #   executor = CMDx::Executor.new(my_task)
+    #
+    # @rbs (Task task) -> void
     def initialize(task)
       @task = task
     end
@@ -32,6 +42,8 @@ module CMDx
     # @example
     #   CMDx::Executor.execute(my_task)
     #   CMDx::Executor.execute(my_task, raise: true)
+    #
+    # @rbs (Task task, raise: bool) -> Result
     def self.execute(task, raise: false)
       instance = new(task)
       raise ? instance.execute! : instance.execute
@@ -44,6 +56,8 @@ module CMDx
     # @example
     #   executor = CMDx::Executor.new(my_task)
     #   result = executor.execute
+    #
+    # @rbs () -> Result
     def execute
       task.class.settings[:middlewares].call!(task) do
         pre_execution! unless @pre_execution
@@ -73,6 +87,8 @@ module CMDx
     # @example
     #   executor = CMDx::Executor.new(my_task)
     #   result = executor.execute!
+    #
+    # @rbs () -> Result
     def execute!
       task.class.settings[:middlewares].call!(task) do
         pre_execution! unless @pre_execution
@@ -102,13 +118,12 @@ module CMDx
     #
     # @return [Boolean] Whether execution should halt
     #
-    # @example
-    #   halt_execution?(fault_exception)
+    # @rbs (Exception exception) -> bool
     def halt_execution?(exception)
-      breakpoints = task.class.settings[:breakpoints] || task.class.settings[:task_breakpoints]
-      breakpoints = Array(breakpoints).map(&:to_s).uniq
+      statuses = task.class.settings[:breakpoints] || task.class.settings[:task_breakpoints]
+      statuses = Array(statuses).map(&:to_s).uniq
 
-      breakpoints.include?(exception.result.status)
+      statuses.include?(exception.result.status)
     end
 
     # Determines if execution should be retried based on retry configuration.
@@ -117,8 +132,7 @@ module CMDx
     #
     # @return [Boolean] Whether execution should be retried
     #
-    # @example
-    #   retry_execution?(standard_error)
+    # @rbs (Exception exception) -> bool
     def retry_execution?(exception)
       available_retries = (task.class.settings[:retries] || 0).to_i
       return false unless available_retries.positive?
@@ -137,7 +151,18 @@ module CMDx
         task.to_h.merge!(reason:, remaining_retries:)
       end
 
-      jitter = task.class.settings[:retry_jitter].to_f * current_retries
+      jitter = task.class.settings[:retry_jitter]
+      jitter =
+        if jitter.is_a?(Symbol)
+          task.send(jitter, current_retries)
+        elsif jitter.is_a?(Proc)
+          task.instance_exec(current_retries, &jitter)
+        elsif jitter.respond_to?(:call)
+          jitter.call(task, current_retries)
+        else
+          jitter.to_f * current_retries
+        end
+
       sleep(jitter) if jitter.positive?
 
       true
@@ -149,8 +174,7 @@ module CMDx
     #
     # @raise [Exception] The provided exception
     #
-    # @example
-    #   raise_exception(standard_error)
+    # @rbs (Exception exception) -> void
     def raise_exception(exception)
       Chain.clear
 
@@ -165,6 +189,8 @@ module CMDx
     #
     # @example
     #   invoke_callbacks(:before_execution)
+    #
+    # @rbs (Symbol type) -> void
     def invoke_callbacks(type)
       task.class.settings[:callbacks].invoke(type, task)
     end
@@ -172,11 +198,15 @@ module CMDx
     private
 
     # Lazy loaded repeator instance to handle retries.
+    #
+    # @rbs () -> untyped
     def repeator
       @repeator ||= Repeator.new(task)
     end
 
     # Performs pre-execution tasks including validation and attribute verification.
+    #
+    # @rbs () -> void
     def pre_execution!
       @pre_execution = true
 
@@ -195,6 +225,8 @@ module CMDx
     end
 
     # Executes the main task logic.
+    #
+    # @rbs () -> void
     def execution!
       invoke_callbacks(:before_execution)
 
@@ -203,6 +235,8 @@ module CMDx
     end
 
     # Performs post-execution tasks including callback invocation.
+    #
+    # @rbs () -> void
     def post_execution!
       invoke_callbacks(:"on_#{task.result.state}")
       invoke_callbacks(:on_executed) if task.result.executed?
@@ -212,21 +246,29 @@ module CMDx
       invoke_callbacks(:on_bad) if task.result.bad?
     end
 
-    # Finalizes execution by freezing the task and logging results.
+    # Finalizes execution by freezing the task, logging results, and rolling back work.
+    #
+    # @rbs () -> Result
     def finalize_execution!
       log_execution!
       log_backtrace! if task.class.settings[:backtrace]
 
       freeze_execution!
       clear_chain!
+
+      rollback_execution!
     end
 
     # Logs the execution result at the configured log level.
+    #
+    # @rbs () -> void
     def log_execution!
       task.logger.info { task.result.to_h }
     end
 
     # Logs the backtrace of the exception if the task failed.
+    #
+    # @rbs () -> void
     def log_backtrace!
       return unless task.result.failed?
 
@@ -244,6 +286,8 @@ module CMDx
     end
 
     # Freezes the task and its associated objects to prevent modifications.
+    #
+    # @rbs () -> void
     def freeze_execution!
       # Stubbing on frozen objects is not allowed in most test environments.
       skip_freezing = ENV.fetch("SKIP_CMDX_FREEZING", false)
@@ -260,11 +304,27 @@ module CMDx
       task.chain.freeze
     end
 
+    # Clears the chain if the task is the outermost (top-level) task.
+    #
+    # @rbs () -> void
     def clear_chain!
       return unless task.result.index.zero?
 
       Chain.clear
     end
 
+    # Rolls back the work of a task.
+    #
+    # @rbs () -> void
+    def rollback_execution!
+      return unless task.respond_to?(:rollback)
+
+      statuses = task.class.settings[:rollback_on]
+      statuses = Array(statuses).map(&:to_s).uniq
+      return unless statuses.include?(task.result.status)
+
+      task.rollback
+    end
+
   end
 end

data/lib/cmdx/faults.rb

@@ -11,6 +11,14 @@ module CMDx
 
     extend Forwardable
 
+    # Returns the result that caused this fault.
+    #
+    # @return [Result] The result instance
+    #
+    # @example
+    #   fault.result.reason # => "Validation failed"
+    #
+    # @rbs @result: Result
     attr_reader :result
 
     def_delegators :result, :task, :context, :chain
@@ -24,6 +32,8 @@ module CMDx
     # @example
     #   fault = Fault.new(task_result)
     #   fault.result.reason # => "Task validation failed"
+    #
+    # @rbs (Result result) -> void
     def initialize(result)
       @result = result
 
@@ -41,6 +51,8 @@ module CMDx
       # @example
       #   Fault.for?(UserTask, AdminUserTask)
       #   # => true if fault.task is a UserTask or AdminUserTask
+      #
+      # @rbs (*Class tasks) -> Class
       def for?(*tasks)
         temp_fault = Class.new(self) do
           def self.===(other)
@@ -62,6 +74,8 @@ module CMDx
       # @example
       #   Fault.matches? { |fault| fault.result.metadata[:critical] }
       #   # => true if fault has critical metadata
+      #
+      # @rbs () { (Fault) -> bool } -> Class
       def matches?(&block)
         raise ArgumentError, "block required" unless block_given?
 

data/lib/cmdx/identifier.rb

@@ -18,6 +18,8 @@ module CMDx
     # @example Generate a unique identifier
     #   CMDx::Identifier.generate
     #   # => "01890b2c-1234-5678-9abc-def123456789"
+    #
+    # @rbs () -> String
     def generate
       if SecureRandom.respond_to?(:uuid_v7)
         SecureRandom.uuid_v7

data/lib/cmdx/locale.rb

@@ -8,6 +8,7 @@ module CMDx
 
     extend self
 
+    # @rbs EN: Hash[String, untyped]
     EN = YAML.load_file(CMDx.gem_path.join("lib/locales/en.yml")).freeze
     private_constant :EN
 
@@ -34,6 +35,8 @@ module CMDx
     # @example With fallback
     #   Locale.translate("missing.key", default: "Custom fallback message")
     #   # => "Custom fallback message"
+    #
+    # @rbs ((String | Symbol) key, **untyped options) -> String
     def translate(key, **options)
       options[:default] ||= EN.dig("en", *key.to_s.split("."))
       return ::I18n.t(key, **options) if defined?(::I18n)

data/lib/cmdx/log_formatters/json.rb

@@ -21,6 +21,8 @@ module CMDx
       # @example Basic usage
       #   logger_formatter.call("INFO", Time.now, "MyApp", "User logged in")
       #   # => '{"severity":"INFO","timestamp":"2024-01-15T10:30:45.123456Z","progname":"MyApp","pid":12345,"message":"User logged in"}\n'
+      #
+      # @rbs (String severity, Time time, String? progname, String message) -> String
       def call(severity, time, progname, message)
         hash = {
           severity:,

data/lib/cmdx/log_formatters/key_value.rb

@@ -21,6 +21,8 @@ module CMDx
       # @example Basic usage
       #   logger_formatter.call("INFO", Time.now, "MyApp", "User logged in")
       #   # => "severity=INFO timestamp=2024-01-15T10:30:45.123456Z progname=MyApp pid=12345 message=User logged in\n"
+      #
+      # @rbs (String severity, Time time, String? progname, String message) -> String
       def call(severity, time, progname, message)
         hash = {
           severity:,

data/lib/cmdx/log_formatters/line.rb

@@ -21,6 +21,8 @@ module CMDx
       # @example Basic usage
       #   logger_formatter.call("INFO", Time.now, "MyApp", "User logged in")
       #   # => "I, [2024-01-15T10:30:45.123456Z #12345] INFO -- MyApp: User logged in\n"
+      #
+      # @rbs (String severity, Time time, String? progname, String message) -> String
       def call(severity, time, progname, message)
         "#{severity[0]}, [#{time.utc.iso8601(6)} ##{Process.pid}] #{severity} -- #{progname}: #{message}\n"
       end

data/lib/cmdx/log_formatters/logstash.rb

@@ -22,6 +22,8 @@ module CMDx
       # @example Basic usage
       #   logger_formatter.call("INFO", Time.now, "MyApp", "User logged in")
       #   # => '{"severity":"INFO","progname":"MyApp","pid":12345,"message":"User logged in","@version":"1","@timestamp":"2024-01-15T10:30:45.123456Z"}\n'
+      #
+      # @rbs (String severity, Time time, String? progname, String message) -> String
       def call(severity, time, progname, message)
         hash = {
           severity:,

data/lib/cmdx/log_formatters/raw.rb

@@ -22,6 +22,8 @@ module CMDx
       # @example Basic usage
       #   logger_formatter.call("INFO", Time.now, "MyApp", "User logged in")
       #   # => "User logged in\n"
+      #
+      # @rbs (String severity, Time time, String? progname, String message) -> String
       def call(severity, time, progname, message)
         "#{message}\n"
       end

data/lib/cmdx/middleware_registry.rb

@@ -9,6 +9,14 @@ module CMDx
   # they were registered.
   class MiddlewareRegistry
 
+    # Returns the ordered collection of middleware entries.
+    #
+    # @return [Array<Array>] Array of middleware-options pairs
+    #
+    # @example
+    #   registry.registry # => [[LoggingMiddleware, {level: :debug}], [AuthMiddleware, {}]]
+    #
+    # @rbs @registry: Array[Array[untyped]]
     attr_reader :registry
     alias to_a registry
 
@@ -19,6 +27,8 @@ module CMDx
     # @example
     #   registry = MiddlewareRegistry.new
     #   registry = MiddlewareRegistry.new([[MyMiddleware, {option: 'value'}]])
+    #
+    # @rbs (?Array[Array[untyped]] registry) -> void
     def initialize(registry = [])
       @registry = registry
     end
@@ -29,6 +39,8 @@ module CMDx
     #
     # @example
     #   new_registry = registry.dup
+    #
+    # @rbs () -> MiddlewareRegistry
     def dup
       self.class.new(registry.map(&:dup))
     end
@@ -46,6 +58,8 @@ module CMDx
     # @example
     #   registry.register(LoggingMiddleware, at: 0, log_level: :debug)
     #   registry.register(AuthMiddleware, at: -1, timeout: 30)
+    #
+    # @rbs (untyped middleware, ?at: Integer, **untyped options) -> self
     def register(middleware, at: -1, **options)
       registry.insert(at, [middleware, options])
       self
@@ -59,6 +73,8 @@ module CMDx
     #
     # @example
     #   registry.deregister(LoggingMiddleware)
+    #
+    # @rbs (untyped middleware) -> self
     def deregister(middleware)
       registry.reject! { |mw, _opts| mw == middleware }
       self
@@ -79,6 +95,8 @@ module CMDx
     #   result = registry.call!(my_task) do |processed_task|
     #     processed_task.execute
     #   end
+    #
+    # @rbs (untyped task) { (untyped) -> untyped } -> untyped
     def call!(task, &)
       raise ArgumentError, "block required" unless block_given?
 
@@ -96,6 +114,8 @@ module CMDx
     # @yieldparam task [Object] The processed task object
     #
     # @return [Object] Result of the block execution or next middleware call
+    #
+    # @rbs (Integer index, untyped task) { (untyped) -> untyped } -> untyped
     def recursively_call_middleware(index, task, &block)
       return yield(task) if index >= registry.size
 

data/lib/cmdx/middlewares/correlate.rb

@@ -12,6 +12,7 @@ module CMDx
 
       extend self
 
+      # @rbs THREAD_KEY: Symbol
       THREAD_KEY = :cmdx_correlate
 
       # Retrieves the current correlation ID from thread-local storage.
@@ -20,6 +21,8 @@ module CMDx
       #
       # @example Get current correlation ID
       #   Correlate.id # => "550e8400-e29b-41d4-a716-446655440000"
+      #
+      # @rbs () -> String?
       def id
         Thread.current[THREAD_KEY]
       end
@@ -31,6 +34,8 @@ module CMDx
       #
       # @example Set correlation ID
       #   Correlate.id = "abc-123-def"
+      #
+      # @rbs (String id) -> String
       def id=(id)
         Thread.current[THREAD_KEY] = id
       end
@@ -41,6 +46,8 @@ module CMDx
       #
       # @example Clear correlation ID
       #   Correlate.clear
+      #
+      # @rbs () -> nil
       def clear
         Thread.current[THREAD_KEY] = nil
       end
@@ -58,6 +65,8 @@ module CMDx
       #     perform_operation
       #   end
       #   # Previous ID is restored
+      #
+      # @rbs (String new_id) { () -> untyped } -> untyped
       def use(new_id)
         old_id = id
         self.id = new_id
@@ -92,6 +101,8 @@ module CMDx
       #   Correlate.call(task, id: -> { "dynamic-#{Time.now.to_i}" }, &block)
       # @example Conditional correlation
       #   Correlate.call(task, if: :enable_correlation, &block)
+      #
+      # @rbs (Task task, **untyped options) { () -> untyped } -> untyped
       def call(task, **options, &)
         return yield unless Utils::Condition.evaluate(task, options)
 

data/lib/cmdx/middlewares/runtime.rb

@@ -32,6 +32,8 @@ module CMDx
       #   Runtime.call(task, if: :enable_profiling, &block)
       # @example Disable runtime measurement
       #   Runtime.call(task, unless: :skip_profiling, &block)
+      #
+      # @rbs (Task task, **untyped options) { () -> untyped } -> untyped
       def call(task, **options)
         return yield unless Utils::Condition.evaluate(task, options)
 
@@ -49,6 +51,8 @@ module CMDx
       # timing measurements that are not affected by system clock changes.
       #
       # @return [Integer] Current monotonic time in milliseconds
+      #
+      # @rbs () -> Integer
       def monotonic_time
         Process.clock_gettime(Process::CLOCK_MONOTONIC, :millisecond)
       end