Skip to content

Building 70 Projects ranging from beginner to advanced so anyone can — learn from, build upon, use as a reference, or even copy directly. Owned by my cybersecurity company 👇

1.6 KB
Raw Blame
# ===================
# ©AngelaMos | 2026
# engine.cr
# ===================

require "log"
require "./event_bus"
require "./subscribers/audit_subscriber"
require "../audit/audit_log"
require "../persistence/persistence"

module CRE::Engine
  class Engine
    Log = ::Log.for("cre.engine")

    getter bus : EventBus
    getter persistence : Persistence::Persistence
    getter audit_log : Audit::AuditLog

    @audit_subscriber : Subscribers::AuditSubscriber
    @started : Bool

    def initialize(@persistence : Persistence::Persistence, hmac_key : Bytes, hmac_version : Int32 = 1, ratchet_every : Int32 = 1024)
      @bus = EventBus.new
      @audit_log = Audit::AuditLog.new(@persistence, hmac_key, hmac_version, ratchet_every)
      @audit_subscriber = Subscribers::AuditSubscriber.new(@bus, @audit_log)
      @started = false
    end

    def start : Nil
      raise "engine already started" if @started
      @started = true
      @audit_subscriber.start
      @bus.run
      Log.info { "engine started" }
    end

    def stop : Nil
      return unless @started
      Log.info { "engine stopping" }
      @bus.publish(Events::ShutdownRequested.new) rescue nil

      # Wait until the audit subscriber has drained everything queued
      # before ShutdownRequested. Bounded so a stuck subscriber can't
      # hang shutdown forever.
      drained = @audit_subscriber.await_drain(2.seconds)
      Log.warn { "audit subscriber did not drain in time during shutdown" } unless drained

      @audit_subscriber.stop
      @bus.stop
      @started = false
      Log.info { "engine stopped" }
    end
  end
end