kaal 0.2.1 → 0.3.0

data/lib/kaal/{cron_humanizer.rb → utils/cron_humanizer.rb}

@@ -4,14 +4,15 @@
 #
 # This source code is licensed under the MIT license found in the
 # LICENSE file in the root directory of this source tree.
-
 require 'fugit'
 require 'i18n'
+require 'yaml'
 
 module Kaal
   ##
   # Human-friendly cron phrase generation with i18n support.
   module CronHumanizer
+    I18N_LOAD_MUTEX = Mutex.new
     MACRO_PHRASES = {
       '@yearly' => 'phrases.yearly',
       '@monthly' => 'phrases.monthly',
@@ -23,6 +24,8 @@ module Kaal
     module_function
 
     def to_human(expression, locale: nil)
+      ensure_i18n_loaded!
+
       normalized = CronUtils.safe_normalize_expression(expression)
       raise ArgumentError, CronUtils.invalid_expression_error_message('') unless normalized
       raise ArgumentError, CronUtils.invalid_expression_error_message(normalized) if normalized.empty?
@@ -178,5 +181,20 @@ module Kaal
       I18n.t("kaal.#{key}", **)
     end
     private_class_method :translate_phrase
+
+    def ensure_i18n_loaded!
+      locale_file = File.expand_path('../../../config/locales/en.yml', __dir__)
+      return if I18n.load_path.include?(locale_file)
+
+      I18N_LOAD_MUTEX.synchronize do
+        return if I18n.load_path.include?(locale_file)
+
+        I18n.load_path << locale_file
+        locales = YAML.safe_load_file(locale_file, aliases: true) || {}
+        I18n.available_locales = Array(I18n.available_locales) | locales.keys.map(&:to_sym)
+        I18n.backend.load_translations
+      end
+    end
+    private_class_method :ensure_i18n_loaded!
   end
 end

data/lib/kaal/{cron_utils.rb → utils/cron_utils.rb}

@@ -4,7 +4,6 @@
 #
 # This source code is licensed under the MIT license found in the
 # LICENSE file in the root directory of this source tree.
-
 require 'fugit'
 
 module Kaal

data/lib/kaal/{idempotency_key_generator.rb → utils/idempotency_key_generator.rb}

@@ -4,7 +4,6 @@
 #
 # This source code is licensed under the MIT license found in the
 # LICENSE file in the root directory of this source tree.
-
 module Kaal
   ##
   # Utility class for generating idempotency keys.
@@ -13,7 +12,7 @@ module Kaal
   # Format: {namespace}-{cron_key}-{fire_time_unix}
   #
   # @example Generate a key
-  #   key = Kaal::IdempotencyKeyGenerator.call('reports:daily', Time.current, configuration: config)
+  #   key = Kaal::IdempotencyKeyGenerator.call('reports:daily', Time.now.utc, configuration: config)
   #   # => "kaal-reports:daily-1708283400"
   class IdempotencyKeyGenerator
     ##
@@ -24,7 +23,8 @@ module Kaal
     # @param configuration [Configuration] the Kaal configuration instance
     # @return [String] the formatted idempotency key
     def self.call(cron_key, fire_time, configuration:)
-      namespace = configuration.namespace || 'kaal'
+      namespace = configuration.namespace.to_s.strip
+      namespace = 'kaal' if namespace.empty?
       "#{namespace}-#{cron_key}-#{fire_time.to_i}"
     end
   end

data/lib/kaal/utils.rb

@@ -0,0 +1,18 @@
+# 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/utils/cron_utils'
+require 'kaal/utils/cron_humanizer'
+require 'kaal/utils/idempotency_key_generator'
+
+module Kaal
+  # Utility functions and pure helpers.
+  module Utils
+    CronUtils = ::Kaal::CronUtils
+    CronHumanizer = ::Kaal::CronHumanizer
+    IdempotencyKeyGenerator = ::Kaal::IdempotencyKeyGenerator
+  end
+end

data/lib/kaal/version.rb

@@ -4,7 +4,6 @@
 #
 # This source code is licensed under the MIT license found in the
 # LICENSE file in the root directory of this source tree.
-
 module Kaal
-  VERSION = '0.2.1'
+  VERSION = '0.3.0'
 end