brainzlab 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a23ea95f03ef25ac3386a0fbf07ea352a01440afc23ec340625f9932bc1cf6a6
-  data.tar.gz: c6f73bc4d7c99a1c4eae51dd34a525e8e3d48b4d0ad4a5502a96baf931f5e44a
+  metadata.gz: 243321421ac058cfe6ae6c11dc69c2c5d527ff6b3a3ee2095da72953b1f343d8
+  data.tar.gz: d1a93e801d19c363305114e3d9a25f441a4983dbc8ef478dca4ed104821a8450
 SHA512:
-  metadata.gz: abf6406497997a9de152038c1f7764ba66165681091ce9f2c91fe3414097beb2599976bcd0ffb0f5bd175cf2fc8d1909a8931cd50794f7a049569a6fa3914140
-  data.tar.gz: 5dde805af2709726635c798aec9029dff143ffd63ca1de0166328d7ab68c892ab507a02b9127e6d1af3abd89d18774cf4f4d197dfd7656ae474d493821a54433
+  metadata.gz: 2b2a91631a4595d11d106bcb44c0fb7341a43b79f481566ffaf8879458f976a98e5cd3a1d99556f7533bb32d18a9d8c9046bcbb1fddd1b62b3100ea08afb3ce5
+  data.tar.gz: 285c523bc3e26fa846783e853d1878211999ed6d9b0fcdc4cd8a177272dffe71f7a303544bf371fda71c7ecfffb0681abc6388049f740c11c72d7a79559bfb35

data/README.md

@@ -2,6 +2,7 @@
 
 [![Gem Version](https://badge.fury.io/rb/brainzlab.svg)](https://rubygems.org/gems/brainzlab)
 [![CI](https://github.com/brainz-lab/brainzlab-ruby/actions/workflows/ci.yml/badge.svg)](https://github.com/brainz-lab/brainzlab-ruby/actions/workflows/ci.yml)
+[![Docs](https://img.shields.io/badge/docs-brainzlab.ai-orange)](https://docs.brainzlab.ai/sdk/ruby/installation)
 [![License](https://img.shields.io/badge/license-Ossassy-blue.svg)](LICENSE)
 
 Official Ruby SDK for [BrainzLab](https://brainzlab.ai) - the complete observability platform.
@@ -328,6 +329,13 @@ Full documentation: [docs.brainzlab.ai](https://docs.brainzlab.ai)
 - [Reflex (Errors)](https://docs.brainzlab.ai/sdk/ruby/reflex)
 - [Pulse (APM)](https://docs.brainzlab.ai/sdk/ruby/pulse)
 
+## Related
+
+- [Recall](https://github.com/brainz-lab/recall) - Logging service
+- [Reflex](https://github.com/brainz-lab/reflex) - Error tracking service
+- [Pulse](https://github.com/brainz-lab/pulse) - APM service
+- [Stack](https://github.com/brainz-lab/stack) - Self-hosted deployment
+
 ## License
 
 Ossassy License - see [LICENSE](LICENSE) for details.

data/lib/brainzlab/beacon/client.rb

@@ -0,0 +1,209 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "json"
+require "uri"
+require "cgi"
+
+module BrainzLab
+  module Beacon
+    class Client
+      def initialize(config)
+        @config = config
+        @base_url = config.beacon_url || "https://beacon.brainzlab.ai"
+      end
+
+      # Create a new monitor
+      def create_monitor(name:, url:, type: "http", interval: 60, **options)
+        response = request(
+          :post,
+          "/api/v1/monitors",
+          body: {
+            name: name,
+            url: url,
+            monitor_type: type,
+            interval: interval,
+            **options
+          }
+        )
+
+        return nil unless response.is_a?(Net::HTTPSuccess) || response.is_a?(Net::HTTPCreated)
+
+        JSON.parse(response.body, symbolize_names: true)
+      rescue StandardError => e
+        log_error("create_monitor", e)
+        nil
+      end
+
+      # Get monitor status
+      def get_monitor(id)
+        response = request(:get, "/api/v1/monitors/#{id}")
+
+        return nil unless response.is_a?(Net::HTTPSuccess)
+
+        JSON.parse(response.body, symbolize_names: true)
+      rescue StandardError => e
+        log_error("get_monitor", e)
+        nil
+      end
+
+      # List all monitors
+      def list_monitors
+        response = request(:get, "/api/v1/monitors")
+
+        return [] unless response.is_a?(Net::HTTPSuccess)
+
+        data = JSON.parse(response.body, symbolize_names: true)
+        data[:monitors] || []
+      rescue StandardError => e
+        log_error("list_monitors", e)
+        []
+      end
+
+      # Update a monitor
+      def update_monitor(id, **attributes)
+        response = request(
+          :put,
+          "/api/v1/monitors/#{id}",
+          body: attributes
+        )
+
+        response.is_a?(Net::HTTPSuccess)
+      rescue StandardError => e
+        log_error("update_monitor", e)
+        false
+      end
+
+      # Delete a monitor
+      def delete_monitor(id)
+        response = request(:delete, "/api/v1/monitors/#{id}")
+        response.is_a?(Net::HTTPSuccess) || response.is_a?(Net::HTTPNoContent)
+      rescue StandardError => e
+        log_error("delete_monitor", e)
+        false
+      end
+
+      # Pause a monitor
+      def pause_monitor(id)
+        response = request(:post, "/api/v1/monitors/#{id}/pause")
+        response.is_a?(Net::HTTPSuccess)
+      rescue StandardError => e
+        log_error("pause_monitor", e)
+        false
+      end
+
+      # Resume a monitor
+      def resume_monitor(id)
+        response = request(:post, "/api/v1/monitors/#{id}/resume")
+        response.is_a?(Net::HTTPSuccess)
+      rescue StandardError => e
+        log_error("resume_monitor", e)
+        false
+      end
+
+      # Get check history
+      def check_history(monitor_id, limit: 100)
+        response = request(
+          :get,
+          "/api/v1/monitors/#{monitor_id}/checks",
+          params: { limit: limit }
+        )
+
+        return [] unless response.is_a?(Net::HTTPSuccess)
+
+        data = JSON.parse(response.body, symbolize_names: true)
+        data[:checks] || []
+      rescue StandardError => e
+        log_error("check_history", e)
+        []
+      end
+
+      # Get current status summary
+      def status_summary
+        response = request(:get, "/api/v1/status")
+
+        return nil unless response.is_a?(Net::HTTPSuccess)
+
+        JSON.parse(response.body, symbolize_names: true)
+      rescue StandardError => e
+        log_error("status_summary", e)
+        nil
+      end
+
+      # List active incidents
+      def list_incidents(status: nil)
+        params = {}
+        params[:status] = status if status
+
+        response = request(:get, "/api/v1/incidents", params: params)
+
+        return [] unless response.is_a?(Net::HTTPSuccess)
+
+        data = JSON.parse(response.body, symbolize_names: true)
+        data[:incidents] || []
+      rescue StandardError => e
+        log_error("list_incidents", e)
+        []
+      end
+
+      def provision(project_id:, app_name:)
+        response = request(
+          :post,
+          "/api/v1/projects/provision",
+          body: { project_id: project_id, app_name: app_name },
+          use_service_key: true
+        )
+
+        response.is_a?(Net::HTTPSuccess) || response.is_a?(Net::HTTPCreated)
+      rescue StandardError => e
+        log_error("provision", e)
+        false
+      end
+
+      private
+
+      def request(method, path, headers: {}, body: nil, params: nil, use_service_key: false)
+        uri = URI.parse("#{@base_url}#{path}")
+
+        if params
+          uri.query = URI.encode_www_form(params)
+        end
+
+        http = Net::HTTP.new(uri.host, uri.port)
+        http.use_ssl = uri.scheme == "https"
+        http.open_timeout = 10
+        http.read_timeout = 30
+
+        request = case method
+        when :get
+          Net::HTTP::Get.new(uri)
+        when :post
+          Net::HTTP::Post.new(uri)
+        when :put
+          Net::HTTP::Put.new(uri)
+        when :delete
+          Net::HTTP::Delete.new(uri)
+        end
+
+        request["Content-Type"] = "application/json"
+        request["Accept"] = "application/json"
+
+        if use_service_key
+          request["X-Service-Key"] = @config.beacon_master_key || @config.secret_key
+        else
+          auth_key = @config.beacon_api_key || @config.secret_key
+          request["Authorization"] = "Bearer #{auth_key}" if auth_key
+        end
+
+        headers.each { |k, v| request[k] = v }
+        request.body = body.to_json if body
+
+        http.request(request)
+      end
+
+      def log_error(operation, error)
+        BrainzLab.debug_log("[Beacon::Client] #{operation} failed: #{error.message}")
+      end
+    end
+  end
+end

data/lib/brainzlab/beacon/provisioner.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module BrainzLab
+  module Beacon
+    class Provisioner
+      def initialize(config)
+        @config = config
+        @provisioned = false
+      end
+
+      def ensure_project!
+        return if @provisioned
+        return unless @config.beacon_auto_provision
+        return unless valid_auth?
+
+        @provisioned = true
+
+        project_id = detect_project_id
+        return unless project_id
+
+        client = Client.new(@config)
+        client.provision(
+          project_id: project_id,
+          app_name: @config.app_name || @config.service
+        )
+
+        BrainzLab.debug_log("[Beacon::Provisioner] Project provisioned: #{project_id}")
+      rescue StandardError => e
+        BrainzLab.debug_log("[Beacon::Provisioner] Provisioning failed: #{e.message}")
+      end
+
+      private
+
+      def valid_auth?
+        key = @config.beacon_api_key || @config.beacon_master_key || @config.secret_key
+        !key.nil? && !key.empty?
+      end
+
+      def detect_project_id
+        ENV["BRAINZLAB_PROJECT_ID"]
+      end
+    end
+  end
+end

data/lib/brainzlab/beacon.rb

@@ -0,0 +1,215 @@
+# frozen_string_literal: true
+
+require_relative "beacon/client"
+require_relative "beacon/provisioner"
+
+module BrainzLab
+  module Beacon
+    class << self
+      # Create an HTTP monitor
+      # @param name [String] Monitor name
+      # @param url [String] URL to monitor
+      # @param interval [Integer] Check interval in seconds (default: 60)
+      # @param options [Hash] Additional options
+      # @return [Hash, nil] Created monitor or nil
+      #
+      # @example
+      #   BrainzLab::Beacon.create_http_monitor(
+      #     "Production API",
+      #     "https://api.example.com/health",
+      #     interval: 30,
+      #     expected_status: 200,
+      #     timeout: 5
+      #   )
+      #
+      def create_http_monitor(name, url, interval: 60, **options)
+        return nil unless enabled?
+
+        ensure_provisioned!
+        return nil unless BrainzLab.configuration.beacon_valid?
+
+        client.create_monitor(
+          name: name,
+          url: url,
+          type: "http",
+          interval: interval,
+          **options
+        )
+      end
+
+      # Create an SSL certificate monitor
+      def create_ssl_monitor(name, domain, warn_days: 30, **options)
+        return nil unless enabled?
+
+        ensure_provisioned!
+        return nil unless BrainzLab.configuration.beacon_valid?
+
+        client.create_monitor(
+          name: name,
+          url: "https://#{domain}",
+          type: "ssl",
+          ssl_warn_days: warn_days,
+          **options
+        )
+      end
+
+      # Create a TCP port monitor
+      def create_tcp_monitor(name, host, port, **options)
+        return nil unless enabled?
+
+        ensure_provisioned!
+        return nil unless BrainzLab.configuration.beacon_valid?
+
+        client.create_monitor(
+          name: name,
+          url: "#{host}:#{port}",
+          type: "tcp",
+          **options
+        )
+      end
+
+      # Create a DNS monitor
+      def create_dns_monitor(name, domain, expected_record: nil, **options)
+        return nil unless enabled?
+
+        ensure_provisioned!
+        return nil unless BrainzLab.configuration.beacon_valid?
+
+        client.create_monitor(
+          name: name,
+          url: domain,
+          type: "dns",
+          expected_record: expected_record,
+          **options
+        )
+      end
+
+      # Get monitor by ID
+      def get(id)
+        return nil unless enabled?
+
+        ensure_provisioned!
+        return nil unless BrainzLab.configuration.beacon_valid?
+
+        client.get_monitor(id)
+      end
+
+      # List all monitors
+      def list
+        return [] unless enabled?
+
+        ensure_provisioned!
+        return [] unless BrainzLab.configuration.beacon_valid?
+
+        client.list_monitors
+      end
+
+      # Update a monitor
+      def update(id, **attributes)
+        return false unless enabled?
+
+        ensure_provisioned!
+        return false unless BrainzLab.configuration.beacon_valid?
+
+        client.update_monitor(id, **attributes)
+      end
+
+      # Delete a monitor
+      def delete(id)
+        return false unless enabled?
+
+        ensure_provisioned!
+        return false unless BrainzLab.configuration.beacon_valid?
+
+        client.delete_monitor(id)
+      end
+
+      # Pause a monitor
+      def pause(id)
+        return false unless enabled?
+
+        ensure_provisioned!
+        return false unless BrainzLab.configuration.beacon_valid?
+
+        client.pause_monitor(id)
+      end
+
+      # Resume a paused monitor
+      def resume(id)
+        return false unless enabled?
+
+        ensure_provisioned!
+        return false unless BrainzLab.configuration.beacon_valid?
+
+        client.resume_monitor(id)
+      end
+
+      # Get check history for a monitor
+      def history(monitor_id, limit: 100)
+        return [] unless enabled?
+
+        ensure_provisioned!
+        return [] unless BrainzLab.configuration.beacon_valid?
+
+        client.check_history(monitor_id, limit: limit)
+      end
+
+      # Get overall status summary
+      def status
+        return nil unless enabled?
+
+        ensure_provisioned!
+        return nil unless BrainzLab.configuration.beacon_valid?
+
+        client.status_summary
+      end
+
+      # Check if all monitors are up
+      def all_up?
+        summary = status
+        return false unless summary
+
+        summary[:status] == "up" || summary[:status] == "operational"
+      end
+
+      # List active incidents
+      def incidents(status: nil)
+        return [] unless enabled?
+
+        ensure_provisioned!
+        return [] unless BrainzLab.configuration.beacon_valid?
+
+        client.list_incidents(status: status)
+      end
+
+      # === INTERNAL ===
+
+      def ensure_provisioned!
+        return if @provisioned
+
+        @provisioned = true
+        provisioner.ensure_project!
+      end
+
+      def provisioner
+        @provisioner ||= Provisioner.new(BrainzLab.configuration)
+      end
+
+      def client
+        @client ||= Client.new(BrainzLab.configuration)
+      end
+
+      def reset!
+        @client = nil
+        @provisioner = nil
+        @provisioned = false
+      end
+
+      private
+
+      def enabled?
+        BrainzLab.configuration.beacon_enabled
+      end
+    end
+  end
+end