kaal 0.4.0 → 0.6.0

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kaal
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Nitesh Purohit
@@ -79,9 +79,9 @@ files:
 - LICENSE
 - README.md
 - Rakefile
-- config/kaal.rb
+- config/kaal-scheduler.yml
+- config/kaal.yml
 - config/locales/en.yml
-- config/scheduler.yml
 - exe/kaal
 - lib/kaal.rb
 - lib/kaal/active_record_support.rb
@@ -96,7 +96,10 @@ files:
 - lib/kaal/backend/sqlite.rb
 - lib/kaal/cli.rb
 - lib/kaal/config.rb
+- lib/kaal/config/backend_factory.rb
 - lib/kaal/config/configuration.rb
+- lib/kaal/config/delayed_job_security_policy.rb
+- lib/kaal/config/file_loader.rb
 - lib/kaal/config/scheduler_config_error.rb
 - lib/kaal/config/scheduler_time_zone_resolver.rb
 - lib/kaal/core.rb
@@ -110,6 +113,12 @@ files:
 - lib/kaal/definition/registry.rb
 - lib/kaal/definitions/registration_service.rb
 - lib/kaal/definitions/registry_accessor.rb
+- lib/kaal/delayed_job/database_engine.rb
+- lib/kaal/delayed_job/dispatch_failure_logger.rb
+- lib/kaal/delayed_job/memory_engine.rb
+- lib/kaal/delayed_job/mysql_version_support.rb
+- lib/kaal/delayed_job/redis_engine.rb
+- lib/kaal/delayed_job/registry.rb
 - lib/kaal/dispatch/database_engine.rb
 - lib/kaal/dispatch/memory_engine.rb
 - lib/kaal/dispatch/redis_engine.rb
@@ -120,6 +129,8 @@ files:
 - lib/kaal/internal/active_record/database_backend.rb
 - lib/kaal/internal/active_record/definition_record.rb
 - lib/kaal/internal/active_record/definition_registry.rb
+- lib/kaal/internal/active_record/delayed_job_record.rb
+- lib/kaal/internal/active_record/delayed_job_registry.rb
 - lib/kaal/internal/active_record/dispatch_record.rb
 - lib/kaal/internal/active_record/dispatch_registry.rb
 - lib/kaal/internal/active_record/lock_record.rb
@@ -130,6 +141,7 @@ files:
 - lib/kaal/internal/sequel/database_backend.rb
 - lib/kaal/internal/sequel/mysql_backend.rb
 - lib/kaal/internal/sequel/postgres_backend.rb
+- lib/kaal/job_dispatcher.rb
 - lib/kaal/persistence/database.rb
 - lib/kaal/persistence/migration_templates.rb
 - lib/kaal/register_conflict_support.rb
@@ -154,6 +166,91 @@ files:
 - lib/kaal/utils/cron_utils.rb
 - lib/kaal/utils/idempotency_key_generator.rb
 - lib/kaal/version.rb
+- sig/00_types.rbs
+- sig/dependencies.rbs
+- sig/kaal.rbs
+- sig/kaal/active_record_support.rbs
+- sig/kaal/backend/adapter.rbs
+- sig/kaal/backend/dispatch_attempt_logger.rbs
+- sig/kaal/backend/dispatch_logging.rbs
+- sig/kaal/backend/dispatch_registry_accessor.rbs
+- sig/kaal/backend/memory_adapter.rbs
+- sig/kaal/backend/mysql.rbs
+- sig/kaal/backend/postgres.rbs
+- sig/kaal/backend/redis_adapter.rbs
+- sig/kaal/backend/sqlite.rbs
+- sig/kaal/cli.rbs
+- sig/kaal/config.rbs
+- sig/kaal/config/backend_factory.rbs
+- sig/kaal/config/configuration.rbs
+- sig/kaal/config/delayed_job_security_policy.rbs
+- sig/kaal/config/file_loader.rbs
+- sig/kaal/config/scheduler_config_error.rbs
+- sig/kaal/config/scheduler_time_zone_resolver.rbs
+- sig/kaal/core.rbs
+- sig/kaal/core/coordinator.rbs
+- sig/kaal/core/enabled_entry_enumerator.rbs
+- sig/kaal/core/occurrence_finder.rbs
+- sig/kaal/definition/database_engine.rbs
+- sig/kaal/definition/memory_engine.rbs
+- sig/kaal/definition/persistence_helpers.rbs
+- sig/kaal/definition/redis_engine.rbs
+- sig/kaal/definition/registry.rbs
+- sig/kaal/definitions/registration_service.rbs
+- sig/kaal/definitions/registry_accessor.rbs
+- sig/kaal/delayed_job/database_engine.rbs
+- sig/kaal/delayed_job/dispatch_failure_logger.rbs
+- sig/kaal/delayed_job/memory_engine.rbs
+- sig/kaal/delayed_job/mysql_version_support.rbs
+- sig/kaal/delayed_job/redis_engine.rbs
+- sig/kaal/delayed_job/registry.rbs
+- sig/kaal/dispatch/database_engine.rbs
+- sig/kaal/dispatch/memory_engine.rbs
+- sig/kaal/dispatch/redis_engine.rbs
+- sig/kaal/dispatch/registry.rbs
+- sig/kaal/internal/active_record.rbs
+- sig/kaal/internal/active_record/base_record.rbs
+- sig/kaal/internal/active_record/connection_support.rbs
+- sig/kaal/internal/active_record/database_backend.rbs
+- sig/kaal/internal/active_record/definition_record.rbs
+- sig/kaal/internal/active_record/definition_registry.rbs
+- sig/kaal/internal/active_record/delayed_job_record.rbs
+- sig/kaal/internal/active_record/delayed_job_registry.rbs
+- sig/kaal/internal/active_record/dispatch_record.rbs
+- sig/kaal/internal/active_record/dispatch_registry.rbs
+- sig/kaal/internal/active_record/lock_record.rbs
+- sig/kaal/internal/active_record/migration_templates.rbs
+- sig/kaal/internal/active_record/mysql_backend.rbs
+- sig/kaal/internal/active_record/postgres_backend.rbs
+- sig/kaal/internal/sequel.rbs
+- sig/kaal/internal/sequel/database_backend.rbs
+- sig/kaal/internal/sequel/mysql_backend.rbs
+- sig/kaal/internal/sequel/postgres_backend.rbs
+- sig/kaal/job_dispatcher.rbs
+- sig/kaal/persistence/database.rbs
+- sig/kaal/persistence/migration_templates.rbs
+- sig/kaal/register_conflict_support.rbs
+- sig/kaal/registry.rbs
+- sig/kaal/runtime.rbs
+- sig/kaal/runtime/runtime_context.rbs
+- sig/kaal/runtime/scheduler_boot_loader.rbs
+- sig/kaal/runtime/signal_handler_chain.rbs
+- sig/kaal/runtime/signal_handler_installer.rbs
+- sig/kaal/scheduler_file.rbs
+- sig/kaal/scheduler_file/hash_transform.rbs
+- sig/kaal/scheduler_file/helper_bundle.rbs
+- sig/kaal/scheduler_file/job_applier.rbs
+- sig/kaal/scheduler_file/job_normalizer.rbs
+- sig/kaal/scheduler_file/loader.rbs
+- sig/kaal/scheduler_file/payload_loader.rbs
+- sig/kaal/scheduler_file/placeholder_support.rbs
+- sig/kaal/sequel_support.rbs
+- sig/kaal/support/hash_tools.rbs
+- sig/kaal/utils.rbs
+- sig/kaal/utils/cron_humanizer.rbs
+- sig/kaal/utils/cron_utils.rbs
+- sig/kaal/utils/idempotency_key_generator.rbs
+- sig/kaal/version.rbs
 homepage: https://github.com/Code-Vedas/kaal
 licenses:
 - MIT

data/config/kaal.rb

@@ -1,15 +0,0 @@
-# frozen_string_literal: true
-
-# Copyright Codevedas Inc. 2025-present
-#
-# This source code is licensed under the MIT license found in the
-# LICENSE file in the root directory of this source tree.
-require 'kaal'
-
-Kaal.configure do |config|
-  config.backend = Kaal::Backend::MemoryAdapter.new
-  config.tick_interval = 5
-  config.window_lookback = 120
-  config.lease_ttl = 125
-  config.scheduler_config_path = 'config/scheduler.yml'
-end