kaal 0.5.0 → 0.6.0

data/sig/kaal/runtime/scheduler_boot_loader.rbs

@@ -0,0 +1,23 @@
+module Kaal
+  class SchedulerBootLoader
+    @configuration_provider: Kaal::rbs_any
+
+    @logger: Kaal::rbs_any
+
+    @runtime_context: Kaal::rbs_any
+
+    @load_scheduler_file: Kaal::rbs_any
+
+    def initialize: (configuration_provider: Kaal::rbs_any, logger: Kaal::rbs_any, runtime_context: Kaal::rbs_any, load_scheduler_file: Kaal::rbs_any) -> void
+
+    def load_on_boot: () -> Kaal::rbs_any
+
+    def load_on_boot!: () -> (nil | Kaal::rbs_any)
+
+    private
+
+    def load_scheduler_file: () -> Kaal::rbs_any
+
+    def fetch_configuration: () -> Kaal::rbs_any
+  end
+end

data/sig/kaal/runtime/signal_handler_chain.rbs

@@ -0,0 +1,19 @@
+module Kaal
+  class SignalHandlerChain
+    @signal: Kaal::rbs_any
+
+    @previous_handler: Kaal::rbs_any
+
+    @logger: Kaal::rbs_any
+
+    RESERVED_COMMAND_HANDLERS: ::Array["DEFAULT" | "IGNORE"]
+
+    def initialize: (signal: Kaal::rbs_any, previous_handler: Kaal::rbs_any, logger: Kaal::rbs_any) -> void
+
+    def call: (*Kaal::rbs_any, **Kaal::rbs_any) ?{ (Kaal::rbs_any) -> Kaal::rbs_any } -> (nil | Kaal::rbs_any)
+
+    private
+
+    def invoke_callable: (*Kaal::rbs_any args) -> Kaal::rbs_any
+  end
+end

data/sig/kaal/runtime/signal_handler_installer.rbs

@@ -0,0 +1,19 @@
+module Kaal
+  class SignalHandlerInstaller
+    @signal_module: Kaal::rbs_any
+
+    SIGNALS: ::Array["TERM" | "INT"]
+
+    IGNORE_HANDLER: "IGNORE"
+
+    def initialize: (?signal_module: Kaal::rbs_any) -> void
+
+    def install: (?signals: Kaal::rbs_any) { (Kaal::rbs_any, Kaal::rbs_any) -> Kaal::rbs_any } -> Kaal::rbs_any
+
+    private
+
+    def capture_previous_handler: (Kaal::rbs_any signal) -> Kaal::rbs_any
+
+    def restore_previous_handler: (Kaal::rbs_any signal, Kaal::rbs_any previous_handler) -> (nil | Kaal::rbs_any)
+  end
+end

data/sig/kaal/runtime.rbs

@@ -0,0 +1,11 @@
+module Kaal
+  module Runtime
+    RuntimeContext: Kaal::rbs_any
+
+    SchedulerBootLoader: Kaal::rbs_any
+
+    SignalHandlerChain: Kaal::rbs_any
+
+    SignalHandlerInstaller: Kaal::rbs_any
+  end
+end

data/sig/kaal/scheduler_file/hash_transform.rbs

@@ -0,0 +1,9 @@
+module Kaal
+  module SchedulerHashTransform
+    private
+
+    def stringify_keys: (Kaal::rbs_any object) -> Kaal::rbs_any
+
+    def symbolize_keys_deep: (Kaal::rbs_any object) -> Kaal::rbs_any
+  end
+end

data/sig/kaal/scheduler_file/helper_bundle.rbs

@@ -0,0 +1,15 @@
+module Kaal
+  class SchedulerFileLoader
+    class HelperBundle
+      @loader: Kaal::rbs_any
+
+      def initialize: (loader: Kaal::rbs_any) -> void
+
+      def stringify_keys: (Kaal::rbs_any payload) -> Kaal::rbs_any
+
+      def resolve_placeholders: (Kaal::rbs_any value, Kaal::rbs_any context) -> Kaal::rbs_any
+
+      def validate_placeholders: (Kaal::rbs_any value, key: Kaal::rbs_any) -> Kaal::rbs_any
+    end
+  end
+end

data/sig/kaal/scheduler_file/job_applier.rbs

@@ -0,0 +1,43 @@
+module Kaal
+  class SchedulerFileLoader
+    class JobApplier
+      @configuration: Kaal::rbs_any
+
+      @definition_registry: Kaal::rbs_any
+
+      @registry: Kaal::rbs_any
+
+      @logger: Kaal::rbs_any
+
+      @helper_bundle: Kaal::rbs_any
+
+      include Kaal::Support::HashTools
+
+      def initialize: (configuration: Kaal::rbs_any, definition_registry: Kaal::rbs_any, registry: Kaal::rbs_any, logger: Kaal::rbs_any, helper_bundle: Kaal::rbs_any) -> void
+
+      def apply: (Kaal::rbs_any job) -> (nil | { key: Kaal::rbs_any, existing_definition: Kaal::rbs_any, existing_registry_entry: Kaal::rbs_any })
+
+      def rollback_jobs: (Kaal::rbs_any applied_job_contexts) -> Kaal::rbs_any
+
+      def callback_for: (key: Kaal::rbs_any, job_class_name: Kaal::rbs_any, queue: Kaal::rbs_any, args_template: Kaal::rbs_any, kwargs_template: Kaal::rbs_any) -> Kaal::rbs_any
+
+      def resolved_job_class: (job_class_name: Kaal::rbs_any, key: Kaal::rbs_any, ?queue: Kaal::rbs_any?) -> Kaal::rbs_any
+
+      def conflict?: (key: Kaal::rbs_any, existing_definition: Kaal::rbs_any) -> (false | Kaal::rbs_any)
+
+      def rollback_job: (key: Kaal::rbs_any, existing_definition: Kaal::rbs_any, existing_registry_entry: Kaal::rbs_any) -> Kaal::rbs_any
+
+      private
+
+      def persisted_metadata: (Kaal::rbs_any job, Kaal::rbs_any job_class) -> Kaal::rbs_any
+
+      def build_callback: (Kaal::rbs_any job, Kaal::rbs_any job_class) -> Kaal::rbs_any
+
+      def validate_keyword_keys: (Kaal::rbs_any raw_kwargs, Kaal::rbs_any key) -> nil
+
+      def dispatch_job: (Kaal::rbs_any job_class, Kaal::rbs_any queue, Kaal::rbs_any args, Kaal::rbs_any kwargs, Kaal::rbs_any key) -> Kaal::rbs_any
+
+      def active_job_dispatch?: (Kaal::rbs_any job_class, Kaal::rbs_any queue) -> Kaal::rbs_any
+    end
+  end
+end

data/sig/kaal/scheduler_file/job_normalizer.rbs

@@ -0,0 +1,27 @@
+module Kaal
+  class SchedulerFileLoader
+    class JobNormalizer
+      @hash_transform: Kaal::rbs_any
+
+      @placeholder_support: Kaal::rbs_any
+
+      @cron_validator: Kaal::rbs_any
+
+      include Kaal::Support::HashTools
+
+      def initialize: (hash_transform: Kaal::rbs_any, placeholder_support: Kaal::rbs_any, cron_validator: Kaal::rbs_any) -> void
+
+      def call: (Kaal::rbs_any job_payload) -> ::Hash[:key | :cron | :job_class_name | Kaal::rbs_any, Kaal::rbs_any]
+
+      private
+
+      def required_string: (Kaal::rbs_any payload, field: Kaal::rbs_any, error_prefix: Kaal::rbs_any) -> Kaal::rbs_any
+
+      def validate_cron: (key: Kaal::rbs_any, cron: Kaal::rbs_any) -> (nil | Kaal::rbs_any)
+
+      def extract_job_options: (Kaal::rbs_any payload, key: Kaal::rbs_any) -> { queue: Kaal::rbs_any, args: Kaal::rbs_any, kwargs: Kaal::rbs_any, enabled: Kaal::rbs_any, metadata: Kaal::rbs_any }
+
+      def validate_job_option_types: (key: Kaal::rbs_any, args: Kaal::rbs_any, kwargs: Kaal::rbs_any, queue: Kaal::rbs_any) -> (nil | Kaal::rbs_any)
+    end
+  end
+end

data/sig/kaal/scheduler_file/loader.rbs

@@ -0,0 +1,69 @@
+module Kaal
+  class SchedulerFileLoader
+    @configuration: Kaal::rbs_any
+
+    @definition_registry: Kaal::rbs_any
+
+    @registry: Kaal::rbs_any
+
+    @logger: Kaal::rbs_any
+
+    @runtime_context: Kaal::rbs_any
+
+    @placeholder_resolvers: Kaal::rbs_any
+
+    @payload_loader: Kaal::rbs_any
+
+    @job_normalizer: Kaal::rbs_any
+
+    @job_applier: Kaal::rbs_any
+
+    @helper_bundle: Kaal::rbs_any
+
+    include SchedulerHashTransform
+
+    include SchedulerPlaceholderSupport
+
+    include Kaal::Support::HashTools
+
+    PLACEHOLDER_PATTERN: ::Regexp
+
+    ALLOWED_PLACEHOLDERS: ::Hash[::String, Kaal::rbs_any]
+
+    def initialize: (configuration: Kaal::rbs_any, definition_registry: Kaal::rbs_any, registry: Kaal::rbs_any, logger: Kaal::rbs_any, ?runtime_context: Kaal::rbs_any) -> void
+
+    def load: () -> Kaal::rbs_any
+
+    private
+
+    def handle_missing_file: (Kaal::rbs_any path) -> Kaal::rbs_any
+
+    def extract_jobs: (Kaal::rbs_any payload) -> Kaal::rbs_any
+
+    def validate_unique_keys: (Kaal::rbs_any jobs) -> Kaal::rbs_any
+
+    def normalize_job: (Kaal::rbs_any job_payload) -> Kaal::rbs_any
+
+    def extract_job_options: (Kaal::rbs_any payload, key: Kaal::rbs_any) -> Kaal::rbs_any
+
+    def apply_job: (Kaal::rbs_any job) -> Kaal::rbs_any
+
+    def rollback_applied_jobs: (?Kaal::rbs_any applied_job_contexts) -> Kaal::rbs_any
+
+    def rollback_applied_job: (key: Kaal::rbs_any, existing_definition: Kaal::rbs_any, existing_registry_entry: Kaal::rbs_any) -> Kaal::rbs_any
+
+    def skip_due_to_conflict?: (key: Kaal::rbs_any, existing_definition: Kaal::rbs_any) -> Kaal::rbs_any
+
+    def build_callback: (key: Kaal::rbs_any, job_class_name: Kaal::rbs_any, queue: Kaal::rbs_any, args_template: Kaal::rbs_any, kwargs_template: Kaal::rbs_any) -> Kaal::rbs_any
+
+    def resolve_job_class: (job_class_name: Kaal::rbs_any, key: Kaal::rbs_any, ?queue: Kaal::rbs_any?) -> Kaal::rbs_any
+
+    def payload_loader: () -> Kaal::rbs_any
+
+    def job_normalizer: () -> Kaal::rbs_any
+
+    def job_applier: () -> Kaal::rbs_any
+
+    def helper_bundle: () -> Kaal::rbs_any
+  end
+end

data/sig/kaal/scheduler_file/payload_loader.rbs

@@ -0,0 +1,33 @@
+module Kaal
+  class SchedulerFileLoader
+    class PayloadLoader
+      @configuration: Kaal::rbs_any
+
+      @runtime_context: Kaal::rbs_any
+
+      @logger: Kaal::rbs_any
+
+      @hash_transform: Kaal::rbs_any
+
+      def initialize: (configuration: Kaal::rbs_any, runtime_context: Kaal::rbs_any, logger: Kaal::rbs_any, hash_transform: Kaal::rbs_any) -> void
+
+      def load: () -> (::Array[Kaal::rbs_any | nil] | ::Array[Kaal::rbs_any])
+
+      def handle_missing_file: (Kaal::rbs_any path) -> ::Array[Kaal::rbs_any]
+
+      def extract_jobs: (Kaal::rbs_any payload) -> Kaal::rbs_any
+
+      def validate_unique_keys: (Kaal::rbs_any jobs) -> (nil | Kaal::rbs_any)
+
+      private
+
+      def scheduler_file_path: () -> Kaal::rbs_any
+
+      def parse_yaml: (Kaal::rbs_any path) -> Kaal::rbs_any
+
+      def render_yaml_erb: (Kaal::rbs_any path) -> Kaal::rbs_any
+
+      def fetch_hash: (Kaal::rbs_any payload, Kaal::rbs_any key) -> Kaal::rbs_any
+    end
+  end
+end

data/sig/kaal/scheduler_file/placeholder_support.rbs

@@ -0,0 +1,19 @@
+module Kaal
+  module SchedulerPlaceholderSupport
+    @placeholder_token_anchors: Kaal::rbs_any
+
+    private
+
+    def validate_placeholders: (Kaal::rbs_any input, key: Kaal::rbs_any) -> Kaal::rbs_any
+
+    def resolve_placeholders: (Kaal::rbs_any template, Kaal::rbs_any context) -> Kaal::rbs_any
+
+    def replace_placeholders: (Kaal::rbs_any text, Kaal::rbs_any context) -> Kaal::rbs_any
+
+    def validate_placeholder_key: (Kaal::rbs_any hash_key, key: Kaal::rbs_any) -> (nil | Kaal::rbs_any)
+
+    def validate_placeholder_syntax: (Kaal::rbs_any input, key: Kaal::rbs_any) -> Kaal::rbs_any
+
+    def placeholder_token_anchors: () -> Kaal::rbs_any
+  end
+end

data/sig/kaal/scheduler_file.rbs

@@ -0,0 +1,9 @@
+module Kaal
+  module SchedulerFile
+    Loader: Kaal::rbs_any
+
+    HashTransform: Kaal::rbs_any
+
+    PlaceholderSupport: Kaal::rbs_any
+  end
+end

data/sig/kaal/sequel_support.rbs

@@ -0,0 +1,25 @@
+module Kaal
+  module Sequel
+    def self.install_postgres_migration: (target_dir: Kaal::rbs_any, ?migration_name: ::String) -> Kaal::rbs_any
+
+    def self.install_mysql_migration: (target_dir: Kaal::rbs_any, ?migration_name: ::String) -> Kaal::rbs_any
+
+    def self.install_sqlite_migration: (target_dir: Kaal::rbs_any, ?migration_name: ::String) -> Kaal::rbs_any
+
+    def self.install_migrations: (target_dir: Kaal::rbs_any, backend: Kaal::rbs_any, ?migration_name: Kaal::rbs_any?) -> Kaal::rbs_any
+
+    def self.require_sequel!: () -> Kaal::rbs_any
+
+    def self.normalize_migration_name: (Kaal::rbs_any name, fallback: Kaal::rbs_any) -> Kaal::rbs_any
+
+    def self.default_migration_name_for: (Kaal::rbs_any backend) -> ::String
+
+    def self.migration_suffixes_for: (Kaal::rbs_any backend) -> (::Array["dispatches" | "locks" | "definitions" | "delayed_jobs"] | ::Array["dispatches" | "definitions" | "delayed_jobs"])
+
+    def self.timestamp: (?::Integer offset) -> Kaal::rbs_any
+
+    def self.letter?: (Kaal::rbs_any char) -> Kaal::rbs_any
+
+    def self.digit?: (Kaal::rbs_any char) -> Kaal::rbs_any
+  end
+end

data/sig/kaal/support/hash_tools.rbs

@@ -0,0 +1,27 @@
+module Kaal
+  module Support
+    module HashTools
+      def self.deep_dup: (Kaal::rbs_any value) -> Kaal::rbs_any
+
+      def self.stringify_keys: (Kaal::rbs_any value) -> Kaal::rbs_any
+
+      def self.symbolize_keys: (Kaal::rbs_any value) -> Kaal::rbs_any
+
+      def self.deep_merge: (Kaal::rbs_any left, Kaal::rbs_any right) -> Kaal::rbs_any
+
+      def self.constantize: (Kaal::rbs_any name) -> Kaal::rbs_any
+
+      def self.duplicable?: (Kaal::rbs_any value) -> Kaal::rbs_any
+
+      def self.transform_keys: (Kaal::rbs_any value) { (Kaal::rbs_any) -> Kaal::rbs_any } -> Kaal::rbs_any
+
+      def self.duplicate_child: (Kaal::rbs_any child) -> Kaal::rbs_any
+
+      def self.transform_child_keys: (Kaal::rbs_any child) { (Kaal::rbs_any) -> Kaal::rbs_any } -> Kaal::rbs_any
+
+      def self.transform_hash_keys: (Kaal::rbs_any value) { (Kaal::rbs_any) -> Kaal::rbs_any } -> Kaal::rbs_any
+
+      def self.transform_array_keys: (Kaal::rbs_any value) { (Kaal::rbs_any) -> Kaal::rbs_any } -> Kaal::rbs_any
+    end
+  end
+end

data/sig/kaal/utils/cron_humanizer.rbs

@@ -0,0 +1,39 @@
+module Kaal
+  module CronHumanizer
+    I18N_LOAD_MUTEX: Kaal::rbs_any
+
+    MACRO_PHRASES: ::Hash[::String, ::String]
+
+    def self.to_human: (Kaal::rbs_any expression, ?locale: Kaal::rbs_any?) -> Kaal::rbs_any
+
+    def self.humanize_expression: (Kaal::rbs_any normalized) -> Kaal::rbs_any
+
+    def self.humanize_macro: (Kaal::rbs_any expression) -> Kaal::rbs_any
+
+    def self.humanize_cron: (Kaal::rbs_any cron) -> Kaal::rbs_any
+
+    def self.every_minute_interval_phrase: (Kaal::rbs_any cron) -> (nil | Kaal::rbs_any)
+
+    def self.derive_interval: (Kaal::rbs_any minutes) -> (nil | Kaal::rbs_any)
+
+    def self.at_time_weekday_phrase: (Kaal::rbs_any cron) -> (nil | ::String)
+
+    def self.at_time_daily_phrase: (Kaal::rbs_any cron) -> (nil | ::String)
+
+    def self.single_time?: (Kaal::rbs_any cron) -> Kaal::rbs_any
+
+    def self.extract_weekday: (Kaal::rbs_any weekdays) -> (nil | Kaal::rbs_any)
+
+    def self.weekday_name: (Kaal::rbs_any day) -> Kaal::rbs_any
+
+    def self.format_time: (Kaal::rbs_any hour, Kaal::rbs_any minute) -> Kaal::rbs_any
+
+    def self.interval_unit: (Kaal::rbs_any count, singular: Kaal::rbs_any, plural: Kaal::rbs_any) -> Kaal::rbs_any
+
+    def self.macro?: (Kaal::rbs_any expression) -> Kaal::rbs_any
+
+    def self.translate_phrase: (Kaal::rbs_any key, **Kaal::rbs_any) -> Kaal::rbs_any
+
+    def self.ensure_i18n_loaded!: () -> (nil | Kaal::rbs_any)
+  end
+end

data/sig/kaal/utils/cron_utils.rbs

@@ -0,0 +1,43 @@
+module Kaal
+  module CronUtils
+    MACRO_MAP: ::Hash[::String, ::String]
+
+    CANONICAL_MACROS: ::Hash[::String, ::String]
+
+    FIELD_SPECS: ::Array[Kaal::rbs_any]
+
+    def self.normalize_expression: (Kaal::rbs_any expression) -> Kaal::rbs_any
+
+    def self.safe_normalize_expression: (Kaal::rbs_any expression) -> Kaal::rbs_any
+
+    def self.unsupported_macro_error_message: (Kaal::rbs_any expression) -> ::String
+
+    def self.invalid_expression_error_message: (Kaal::rbs_any expression) -> ::String
+
+    def self.valid?: (Kaal::rbs_any expression) -> Kaal::rbs_any
+
+    def self.simplify: (Kaal::rbs_any expression) -> Kaal::rbs_any
+
+    def self.lint: (Kaal::rbs_any expression) -> (::Array[Kaal::rbs_any] | Kaal::rbs_any)
+
+    def self.lint_field: (Kaal::rbs_any field, Kaal::rbs_any spec) -> Kaal::rbs_any
+
+    def self.lint_segment: (Kaal::rbs_any segment, Kaal::rbs_any spec) -> (::Array[Kaal::rbs_any] | Kaal::rbs_any | ::Array[::String])
+
+    def self.lint_step_only: (Kaal::rbs_any step, Kaal::rbs_any spec) -> (::Array[Kaal::rbs_any] | ::Array[::String])
+
+    def self.lint_range_segment: (Kaal::rbs_any segment, Kaal::rbs_any start_value, Kaal::rbs_any end_value, Kaal::rbs_any step, Kaal::rbs_any spec) -> (::Array[::String] | ::Array[Kaal::rbs_any])
+
+    def self.lint_base_step_segment: (Kaal::rbs_any segment, Kaal::rbs_any base, Kaal::rbs_any step, Kaal::rbs_any spec) -> (::Array[::String] | ::Array[Kaal::rbs_any])
+
+    def self.parse_value: (Kaal::rbs_any token, Kaal::rbs_any spec) -> (Kaal::rbs_any | nil)
+
+    def self.macro?: (Kaal::rbs_any expression) -> Kaal::rbs_any
+
+    def self.five_fields?: (Kaal::rbs_any expression) -> Kaal::rbs_any
+
+    def self.canonical_macro_for: (Kaal::rbs_any macro) -> Kaal::rbs_any
+
+    def self.field_count_message: (Kaal::rbs_any expression) -> ::String
+  end
+end

data/sig/kaal/utils/idempotency_key_generator.rbs

@@ -0,0 +1,5 @@
+module Kaal
+  class IdempotencyKeyGenerator
+    def self.call: (Kaal::rbs_any cron_key, Kaal::rbs_any fire_time, configuration: Kaal::rbs_any) -> ::String
+  end
+end

data/sig/kaal/utils.rbs

@@ -0,0 +1,9 @@
+module Kaal
+  module Utils
+    CronUtils: Kaal::rbs_any
+
+    CronHumanizer: Kaal::rbs_any
+
+    IdempotencyKeyGenerator: Kaal::rbs_any
+  end
+end

data/sig/kaal/version.rbs

@@ -0,0 +1,3 @@
+module Kaal
+  VERSION: String
+end

data/sig/kaal.rbs

@@ -0,0 +1,145 @@
+module Kaal
+  self.@configuration: Kaal::rbs_any
+
+  self.@registry: Kaal::rbs_any
+
+  self.@coordinator: Kaal::rbs_any
+
+  self.@definition_registry: Kaal::rbs_any
+
+  self.@definitions_registry_accessor: Kaal::rbs_any
+
+  self.@dispatch_registry_accessor: Kaal::rbs_any
+
+  self.@risky_configuration_warnings_emitted: Kaal::rbs_any
+
+  self.@registration_service: Kaal::rbs_any
+
+  extend RegisterConflictSupport
+
+  def self.configuration: () -> Kaal::rbs_any
+
+  def self.registry: () -> Kaal::rbs_any
+
+  def self.coordinator: () -> Kaal::rbs_any
+
+  def self.reset_configuration!: () -> Kaal::rbs_any
+
+  def self.reset_registry!: () -> Kaal::rbs_any
+
+  def self.reset_coordinator!: () -> Kaal::rbs_any
+
+  def self.configure: () ?{ (Kaal::rbs_any) -> Kaal::rbs_any } -> (Kaal::rbs_any | nil)
+
+  def self.load_config_file!: (?path: ::String, ?runtime_context: Kaal::rbs_any) -> Kaal::rbs_any
+
+  def self.register: (key: Kaal::rbs_any, cron: Kaal::rbs_any, enqueue: Kaal::rbs_any) -> Kaal::rbs_any
+
+  def self.load_scheduler_file!: (?runtime_context: Kaal::rbs_any) -> Kaal::rbs_any
+
+  def self.unregister: (key: Kaal::rbs_any) -> Kaal::rbs_any
+
+  def self.registered: () -> Kaal::rbs_any
+
+  def self.registered?: (key: Kaal::rbs_any) -> Kaal::rbs_any
+
+  def self.enable: (key: Kaal::rbs_any) -> Kaal::rbs_any
+
+  def self.disable: (key: Kaal::rbs_any) -> Kaal::rbs_any
+
+  def self.start!: () -> Kaal::rbs_any
+
+  def self.stop!: (?timeout: ::Integer) -> Kaal::rbs_any
+
+  def self.running?: () -> Kaal::rbs_any
+
+  def self.restart!: () -> Kaal::rbs_any
+
+  def self.tick!: () -> Kaal::rbs_any
+
+  def self.enqueue_at: (at: Kaal::rbs_any, job_class: Kaal::rbs_any, args: Kaal::rbs_any, job_id: Kaal::rbs_any, ?queue: Kaal::rbs_any?, ?connection: Kaal::rbs_any?) -> Kaal::rbs_any
+
+  def self.with_idempotency: (Kaal::rbs_any key, Kaal::rbs_any fire_time) ?{ (Kaal::rbs_any) -> Kaal::rbs_any } -> Kaal::rbs_any
+
+  def self.dispatched?: (Kaal::rbs_any key, Kaal::rbs_any fire_time) -> Kaal::rbs_any
+
+  def self.dispatch_log_registry: () -> Kaal::rbs_any
+
+  def self.tick_interval: () -> Kaal::rbs_any
+
+  def self.window_lookback: () -> Kaal::rbs_any
+
+  def self.window_lookahead: () -> Kaal::rbs_any
+
+  def self.lease_ttl: () -> Kaal::rbs_any
+
+  def self.namespace: () -> Kaal::rbs_any
+
+  def self.backend: () -> Kaal::rbs_any
+
+  def self.logger: () -> Kaal::rbs_any
+
+  def self.time_zone: () -> Kaal::rbs_any
+
+  def self.tick_interval=: (Kaal::rbs_any value) -> Kaal::rbs_any
+
+  def self.window_lookback=: (Kaal::rbs_any value) -> Kaal::rbs_any
+
+  def self.window_lookahead=: (Kaal::rbs_any value) -> Kaal::rbs_any
+
+  def self.lease_ttl=: (Kaal::rbs_any value) -> Kaal::rbs_any
+
+  def self.namespace=: (Kaal::rbs_any value) -> Kaal::rbs_any
+
+  def self.backend=: (Kaal::rbs_any value) -> Kaal::rbs_any
+
+  def self.logger=: (Kaal::rbs_any value) -> Kaal::rbs_any
+
+  def self.time_zone=: (Kaal::rbs_any value) -> Kaal::rbs_any
+
+  def self.delayed_job_allowed_class_prefixes: () -> Kaal::rbs_any
+
+  def self.delayed_job_allowed_class_prefixes=: (Kaal::rbs_any value) -> Kaal::rbs_any
+
+  def self.definition_registry: () -> Kaal::rbs_any
+
+  def self.validate: () -> Kaal::rbs_any
+
+  def self.validate!: () -> Kaal::rbs_any
+
+  def self.validation_warnings: () -> Kaal::rbs_any
+
+  def self.warn_on_risky_configuration!: (?configuration: Kaal::rbs_any, ?logger: Kaal::rbs_any) -> (::Array[Kaal::rbs_any] | Kaal::rbs_any)
+
+  def self.valid?: (Kaal::rbs_any expression) -> Kaal::rbs_any
+
+  def self.simplify: (Kaal::rbs_any expression) -> Kaal::rbs_any
+
+  def self.lint: (Kaal::rbs_any expression) -> Kaal::rbs_any
+
+  def self.to_human: (Kaal::rbs_any expression, ?locale: Kaal::rbs_any?) -> Kaal::rbs_any
+
+  private
+
+  def self.rollback_registered_definition: (Kaal::rbs_any key, Kaal::rbs_any existing_definition) -> (Kaal::rbs_any | Kaal::rbs_any | nil)
+
+  def self.registration_service: () -> Kaal::rbs_any
+
+  def self.definitions_registry_accessor: () -> Kaal::rbs_any
+
+  def self.dispatch_registry_accessor: () -> Kaal::rbs_any
+
+  def self.delayed_store!: () -> Kaal::rbs_any
+
+  def self.normalize_delayed_run_at: (Kaal::rbs_any at) -> Kaal::rbs_any
+
+  def self.normalize_delayed_args: (Kaal::rbs_any args) -> Kaal::rbs_any
+
+  def self.normalize_delayed_queue: (Kaal::rbs_any queue) -> (nil | Kaal::rbs_any)
+
+  def self.normalize_delayed_job_id: (Kaal::rbs_any job_id) -> Kaal::rbs_any
+
+  def self.invalid_delayed_time_error: () -> Kaal::rbs_any
+
+  def self.ensure_delayed_time!: (Kaal::rbs_any time) -> (Kaal::rbs_any | nil)
+end