logstruct 0.0.2 → 0.1.1

data/lib/log_struct/integrations.rb

@@ -14,11 +14,30 @@ require_relative "integrations/good_job"
 require_relative "integrations/active_storage"
 require_relative "integrations/carrierwave"
 require_relative "integrations/sorbet"
+require_relative "integrations/ahoy"
+require_relative "integrations/active_model_serializers"
+require_relative "integrations/dotenv"
+require_relative "integrations/puma"
 
 module LogStruct
   module Integrations
     extend T::Sig
 
+    # Register generic initializers on the Railtie to keep integration
+    # wiring centralized (boot replay interception and resolution).
+    sig { params(railtie: T.untyped).void }
+    def self.setup_initializers(railtie)
+      # Intercept any boot-time replays (e.g., dotenv) before those railties run
+      railtie.initializer "logstruct.intercept_boot_replays", before: "dotenv" do
+        LogStruct::Integrations::Dotenv.intercept_logger_setter!
+      end
+
+      # Decide which set of boot logs to emit after user initializers
+      railtie.initializer "logstruct.resolve_boot_logs", after: :load_config_initializers do
+        LogStruct::Integrations::Dotenv.resolve_boot_logs!
+      end
+    end
+
     sig { void }
     def self.setup_integrations
       config = LogStruct.config
@@ -30,12 +49,18 @@ module LogStruct
       Integrations::ActiveRecord.setup(config) if config.integrations.enable_sql_logging
       Integrations::Sidekiq.setup(config) if config.integrations.enable_sidekiq
       Integrations::GoodJob.setup(config) if config.integrations.enable_goodjob
+      Integrations::Ahoy.setup(config) if config.integrations.enable_ahoy
+      Integrations::ActiveModelSerializers.setup(config) if config.integrations.enable_active_model_serializers
       Integrations::HostAuthorization.setup(config) if config.integrations.enable_host_authorization
       Integrations::RackErrorHandler.setup(config) if config.integrations.enable_rack_error_handler
       Integrations::Shrine.setup(config) if config.integrations.enable_shrine
       Integrations::ActiveStorage.setup(config) if config.integrations.enable_activestorage
       Integrations::CarrierWave.setup(config) if config.integrations.enable_carrierwave
       Integrations::Sorbet.setup(config) if config.integrations.enable_sorbet_error_handlers
+      if config.enabled && config.integrations.enable_dotenv
+        Integrations::Dotenv.setup(config)
+      end
+      Integrations::Puma.setup(config) if config.integrations.enable_puma
     end
   end
 end

data/lib/log_struct/log/action_mailer/delivered.rb

@@ -0,0 +1,99 @@
+# typed: strict
+# frozen_string_literal: true
+
+# AUTO-GENERATED: DO NOT EDIT
+# Generated by scripts/generate_structs.rb
+# Schemas dir: schemas/log_sources/
+# Template: tools/codegen/templates/sorbet/event.rb.erb
+
+require "log_struct/shared/interfaces/common_fields"
+require "log_struct/shared/interfaces/additional_data_field"
+require "log_struct/shared/interfaces/request_fields"
+require "log_struct/shared/shared/serialize_common"
+require "log_struct/shared/shared/merge_additional_data_fields"
+require "log_struct/shared/shared/add_request_fields"
+require_relative "../../enums/source"
+require_relative "../../enums/event"
+require_relative "../../enums/level"
+require_relative "../../enums/log_field"
+
+module LogStruct
+  module Log
+    class ActionMailer
+      class Delivered < T::Struct
+        # typed: strict
+        # frozen_string_literal: true
+
+        extend T::Sig
+
+        extend T::Sig
+
+        # Shared/common fields
+        const :source, Source::Mailer, default: Source::Mailer
+        const :event, Event, default: Event::Delivered
+        const :timestamp, Time, factory: -> { Time.now }
+        const :level, Level, default: Level::Info
+
+        const :to, T.nilable(T::Array[String]), default: nil
+        const :from, T.nilable(String), default: nil
+        const :subject, T.nilable(String), default: nil
+
+        # Event-specific fields
+
+        # Additional data
+        include LogStruct::Log::Interfaces::AdditionalDataField
+        const :additional_data, T.nilable(T::Hash[T.any(String, Symbol), T.untyped]), default: nil
+        include LogStruct::Log::Shared::MergeAdditionalDataFields
+
+        # Request fields (optional)
+
+        # Serialize shared fields
+        include LogStruct::Log::Interfaces::CommonFields
+        include LogStruct::Log::Shared::SerializeCommon
+
+        sig {
+          params(to: T.untyped,
+            from: T.untyped,
+            subject: T.untyped).returns(T::Hash[LogStruct::LogField, T.untyped])
+        }
+        def self.base_hash(to: nil,
+          from: nil,
+          subject: nil)
+          h = {}
+          h[LogField::To] = to unless to.nil?
+          h[LogField::From] = from unless from.nil?
+          h[LogField::Subject] = subject unless subject.nil?
+          h
+        end
+
+        sig {
+          params(to: T.untyped,
+            from: T.untyped,
+            subject: T.untyped,
+            additional_data: T.untyped,
+            timestamp: T.untyped).returns(T::Hash[LogStruct::LogField, T.untyped])
+        }
+        def self.build(to: nil,
+          from: nil,
+          subject: nil,
+          additional_data: nil,
+          timestamp: Time.now)
+          base_hash(to: to,
+            from: from,
+            subject: subject)
+        end
+
+        sig { returns(T::Hash[LogStruct::LogField, T.untyped]) }
+        def to_h
+          self.class.build(
+            to: to,
+            from: from,
+            subject: subject,
+            additional_data: additional_data,
+            timestamp: timestamp
+          )
+        end
+      end
+    end
+  end
+end

data/lib/log_struct/log/action_mailer/delivery.rb

@@ -0,0 +1,99 @@
+# typed: strict
+# frozen_string_literal: true
+
+# AUTO-GENERATED: DO NOT EDIT
+# Generated by scripts/generate_structs.rb
+# Schemas dir: schemas/log_sources/
+# Template: tools/codegen/templates/sorbet/event.rb.erb
+
+require "log_struct/shared/interfaces/common_fields"
+require "log_struct/shared/interfaces/additional_data_field"
+require "log_struct/shared/interfaces/request_fields"
+require "log_struct/shared/shared/serialize_common"
+require "log_struct/shared/shared/merge_additional_data_fields"
+require "log_struct/shared/shared/add_request_fields"
+require_relative "../../enums/source"
+require_relative "../../enums/event"
+require_relative "../../enums/level"
+require_relative "../../enums/log_field"
+
+module LogStruct
+  module Log
+    class ActionMailer
+      class Delivery < T::Struct
+        # typed: strict
+        # frozen_string_literal: true
+
+        extend T::Sig
+
+        extend T::Sig
+
+        # Shared/common fields
+        const :source, Source::Mailer, default: Source::Mailer
+        const :event, Event, default: Event::Delivery
+        const :timestamp, Time, factory: -> { Time.now }
+        const :level, Level, default: Level::Info
+
+        const :to, T.nilable(T::Array[String]), default: nil
+        const :from, T.nilable(String), default: nil
+        const :subject, T.nilable(String), default: nil
+
+        # Event-specific fields
+
+        # Additional data
+        include LogStruct::Log::Interfaces::AdditionalDataField
+        const :additional_data, T.nilable(T::Hash[T.any(String, Symbol), T.untyped]), default: nil
+        include LogStruct::Log::Shared::MergeAdditionalDataFields
+
+        # Request fields (optional)
+
+        # Serialize shared fields
+        include LogStruct::Log::Interfaces::CommonFields
+        include LogStruct::Log::Shared::SerializeCommon
+
+        sig {
+          params(to: T.untyped,
+            from: T.untyped,
+            subject: T.untyped).returns(T::Hash[LogStruct::LogField, T.untyped])
+        }
+        def self.base_hash(to: nil,
+          from: nil,
+          subject: nil)
+          h = {}
+          h[LogField::To] = to unless to.nil?
+          h[LogField::From] = from unless from.nil?
+          h[LogField::Subject] = subject unless subject.nil?
+          h
+        end
+
+        sig {
+          params(to: T.untyped,
+            from: T.untyped,
+            subject: T.untyped,
+            additional_data: T.untyped,
+            timestamp: T.untyped).returns(T::Hash[LogStruct::LogField, T.untyped])
+        }
+        def self.build(to: nil,
+          from: nil,
+          subject: nil,
+          additional_data: nil,
+          timestamp: Time.now)
+          base_hash(to: to,
+            from: from,
+            subject: subject)
+        end
+
+        sig { returns(T::Hash[LogStruct::LogField, T.untyped]) }
+        def to_h
+          self.class.build(
+            to: to,
+            from: from,
+            subject: subject,
+            additional_data: additional_data,
+            timestamp: timestamp
+          )
+        end
+      end
+    end
+  end
+end

data/lib/log_struct/log/action_mailer.rb

@@ -1,54 +1,39 @@
 # typed: strict
 # frozen_string_literal: true
 
-require_relative "interfaces/common_fields"
-require_relative "interfaces/additional_data_field"
-require_relative "shared/serialize_common"
-require_relative "shared/merge_additional_data_fields"
-require_relative "../enums/source"
-require_relative "../enums/event"
-require_relative "../enums/level"
-require_relative "../log_keys"
+# AUTO-GENERATED: DO NOT EDIT
+# Generated by scripts/generate_structs.rb
+# Schemas dir: schemas/log_sources/
+# Template: tools/codegen/templates/sorbet/source_parent.rb.erb
+
+require_relative "action_mailer/delivery"
+require_relative "action_mailer/delivered"
 
 module LogStruct
   module Log
-    # Email log entry for structured logging
-    class ActionMailer < T::Struct
-      extend T::Sig
-
-      include Interfaces::CommonFields
-      include Interfaces::AdditionalDataField
-      include SerializeCommon
-      include MergeAdditionalDataFields
-
-      ActionMailerEvent = T.type_alias {
-        T.any(Event::Delivery, Event::Delivered)
-      }
-
-      # Common fields
-      const :source, Source::Mailer, default: T.let(Source::Mailer, Source::Mailer)
-      const :event, ActionMailerEvent
-      const :timestamp, Time, factory: -> { Time.now }
-      const :level, Level, default: T.let(Level::Info, Level)
-
-      # Email-specific fields
-      const :to, T.nilable(T.any(String, T::Array[String])), default: nil
-      const :from, T.nilable(String), default: nil
-      const :subject, T.nilable(String), default: nil
-      const :additional_data, T::Hash[Symbol, T.untyped], default: {}
-
-      # Convert the log entry to a hash for serialization
-      sig { override.params(strict: T::Boolean).returns(T::Hash[Symbol, T.untyped]) }
-      def serialize(strict = true)
-        hash = serialize_common(strict)
-        merge_additional_data_fields(hash)
-
-        # Add email-specific fields if they're present
-        hash[LOG_KEYS.fetch(:to)] = to if to
-        hash[LOG_KEYS.fetch(:from)] = from if from
-        hash[LOG_KEYS.fetch(:subject)] = subject if subject
-
-        hash
+    class ActionMailer
+      class BaseFields < T::Struct
+        extend T::Sig
+        const :to, T.nilable(T::Array[String]), default: nil
+        const :from, T.nilable(String), default: nil
+        const :subject, T.nilable(String), default: nil
+
+        Kwargs = T.type_alias do
+          {
+            to: T.nilable(T::Array[String]),
+            from: T.nilable(String),
+            subject: T.nilable(String)
+          }
+        end
+
+        sig { returns(Kwargs) }
+        def to_kwargs
+          {
+            to: to,
+            from: from,
+            subject: subject
+          }
+        end
       end
     end
   end

data/lib/log_struct/log/active_job/enqueue.rb

@@ -0,0 +1,125 @@
+# typed: strict
+# frozen_string_literal: true
+
+# AUTO-GENERATED: DO NOT EDIT
+# Generated by scripts/generate_structs.rb
+# Schemas dir: schemas/log_sources/
+# Template: tools/codegen/templates/sorbet/event.rb.erb
+
+require "log_struct/shared/interfaces/common_fields"
+require "log_struct/shared/interfaces/additional_data_field"
+require "log_struct/shared/interfaces/request_fields"
+require "log_struct/shared/shared/serialize_common"
+require "log_struct/shared/shared/merge_additional_data_fields"
+require "log_struct/shared/shared/add_request_fields"
+require_relative "../../enums/source"
+require_relative "../../enums/event"
+require_relative "../../enums/level"
+require_relative "../../enums/log_field"
+
+module LogStruct
+  module Log
+    class ActiveJob
+      class Enqueue < T::Struct
+        # typed: strict
+        # frozen_string_literal: true
+
+        extend T::Sig
+
+        extend T::Sig
+
+        # Shared/common fields
+        const :source, Source::Job, default: Source::Job
+        const :event, Event, default: Event::Enqueue
+        const :timestamp, Time, factory: -> { Time.now }
+        const :level, Level, default: Level::Info
+
+        const :job_id, String
+        const :job_class, String
+        const :queue_name, T.nilable(String), default: nil
+        const :arguments, T.nilable(T::Array[T.untyped]), default: nil
+        const :executions, T.nilable(Integer), default: nil
+        const :provider_job_id, T.nilable(String), default: nil
+
+        # Event-specific fields
+        const :retries, T.nilable(Integer), default: nil
+
+        # Additional data
+
+        # Request fields (optional)
+
+        # Serialize shared fields
+        include LogStruct::Log::Interfaces::CommonFields
+        include LogStruct::Log::Shared::SerializeCommon
+
+        sig {
+          params(job_id: T.untyped,
+            job_class: T.untyped,
+            queue_name: T.untyped,
+            arguments: T.untyped,
+            executions: T.untyped,
+            provider_job_id: T.untyped).returns(T::Hash[LogStruct::LogField, T.untyped])
+        }
+        def self.base_hash(job_id: nil,
+          job_class: nil,
+          queue_name: nil,
+          arguments: nil,
+          executions: nil,
+          provider_job_id: nil)
+          h = {}
+          h[LogField::JobId] = job_id unless job_id.nil?
+          h[LogField::JobClass] = job_class unless job_class.nil?
+          h[LogField::QueueName] = queue_name unless queue_name.nil?
+          h[LogField::Arguments] = arguments unless arguments.nil?
+          h[LogField::Executions] = executions unless executions.nil?
+          h[LogField::ProviderJobId] = provider_job_id unless provider_job_id.nil?
+          h
+        end
+
+        sig {
+          params(job_id: T.untyped,
+            job_class: T.untyped,
+            queue_name: T.untyped,
+            arguments: T.untyped,
+            executions: T.untyped,
+            provider_job_id: T.untyped,
+            retries: T.untyped,
+            additional_data: T.untyped,
+            timestamp: T.untyped).returns(T::Hash[LogStruct::LogField, T.untyped])
+        }
+        def self.build(job_id:,
+          job_class:,
+          queue_name: nil,
+          arguments: nil,
+          executions: nil,
+          provider_job_id: nil,
+          retries: nil,
+          additional_data: nil,
+          timestamp: Time.now)
+          h = base_hash(job_id: job_id,
+            job_class: job_class,
+            queue_name: queue_name,
+            arguments: arguments,
+            executions: executions,
+            provider_job_id: provider_job_id)
+          h[LogField::Retries] = retries unless retries.nil?
+          h
+        end
+
+        sig { returns(T::Hash[LogStruct::LogField, T.untyped]) }
+        def to_h
+          self.class.build(
+            job_id: job_id,
+            job_class: job_class,
+            queue_name: queue_name,
+            arguments: arguments,
+            executions: executions,
+            provider_job_id: provider_job_id,
+            retries: retries,
+            timestamp: timestamp
+          )
+        end
+      end
+    end
+  end
+end

data/lib/log_struct/log/active_job/finish.rb

@@ -0,0 +1,130 @@
+# typed: strict
+# frozen_string_literal: true
+
+# AUTO-GENERATED: DO NOT EDIT
+# Generated by scripts/generate_structs.rb
+# Schemas dir: schemas/log_sources/
+# Template: tools/codegen/templates/sorbet/event.rb.erb
+
+require "log_struct/shared/interfaces/common_fields"
+require "log_struct/shared/interfaces/additional_data_field"
+require "log_struct/shared/interfaces/request_fields"
+require "log_struct/shared/shared/serialize_common"
+require "log_struct/shared/shared/merge_additional_data_fields"
+require "log_struct/shared/shared/add_request_fields"
+require_relative "../../enums/source"
+require_relative "../../enums/event"
+require_relative "../../enums/level"
+require_relative "../../enums/log_field"
+
+module LogStruct
+  module Log
+    class ActiveJob
+      class Finish < T::Struct
+        # typed: strict
+        # frozen_string_literal: true
+
+        extend T::Sig
+
+        extend T::Sig
+
+        # Shared/common fields
+        const :source, Source::Job, default: Source::Job
+        const :event, Event, default: Event::Finish
+        const :timestamp, Time, factory: -> { Time.now }
+        const :level, Level, default: Level::Info
+
+        const :job_id, String
+        const :job_class, String
+        const :queue_name, T.nilable(String), default: nil
+        const :arguments, T.nilable(T::Array[T.untyped]), default: nil
+        const :executions, T.nilable(Integer), default: nil
+        const :provider_job_id, T.nilable(String), default: nil
+
+        # Event-specific fields
+        const :duration_ms, Float
+        const :finished_at, Time
+
+        # Additional data
+
+        # Request fields (optional)
+
+        # Serialize shared fields
+        include LogStruct::Log::Interfaces::CommonFields
+        include LogStruct::Log::Shared::SerializeCommon
+
+        sig {
+          params(job_id: T.untyped,
+            job_class: T.untyped,
+            queue_name: T.untyped,
+            arguments: T.untyped,
+            executions: T.untyped,
+            provider_job_id: T.untyped).returns(T::Hash[LogStruct::LogField, T.untyped])
+        }
+        def self.base_hash(job_id: nil,
+          job_class: nil,
+          queue_name: nil,
+          arguments: nil,
+          executions: nil,
+          provider_job_id: nil)
+          h = {}
+          h[LogField::JobId] = job_id unless job_id.nil?
+          h[LogField::JobClass] = job_class unless job_class.nil?
+          h[LogField::QueueName] = queue_name unless queue_name.nil?
+          h[LogField::Arguments] = arguments unless arguments.nil?
+          h[LogField::Executions] = executions unless executions.nil?
+          h[LogField::ProviderJobId] = provider_job_id unless provider_job_id.nil?
+          h
+        end
+
+        sig {
+          params(duration_ms: T.untyped,
+            finished_at: T.untyped,
+            job_id: T.untyped,
+            job_class: T.untyped,
+            queue_name: T.untyped,
+            arguments: T.untyped,
+            executions: T.untyped,
+            provider_job_id: T.untyped,
+            additional_data: T.untyped,
+            timestamp: T.untyped).returns(T::Hash[LogStruct::LogField, T.untyped])
+        }
+        def self.build(duration_ms:,
+          finished_at:,
+          job_id:,
+          job_class:,
+          queue_name: nil,
+          arguments: nil,
+          executions: nil,
+          provider_job_id: nil,
+          additional_data: nil,
+          timestamp: Time.now)
+          h = base_hash(job_id: job_id,
+            job_class: job_class,
+            queue_name: queue_name,
+            arguments: arguments,
+            executions: executions,
+            provider_job_id: provider_job_id)
+          h[LogField::DurationMs] = duration_ms
+          h[LogField::FinishedAt] = finished_at
+          h
+        end
+
+        sig { returns(T::Hash[LogStruct::LogField, T.untyped]) }
+        def to_h
+          self.class.build(
+            job_id: job_id,
+            job_class: job_class,
+            queue_name: queue_name,
+            arguments: arguments,
+            executions: executions,
+            provider_job_id: provider_job_id,
+            duration_ms: duration_ms,
+            finished_at: finished_at,
+            timestamp: timestamp
+          )
+        end
+      end
+    end
+  end
+end