fluyenta-ruby 0.1.14

data/lib/brainzlab/signal.rb

@@ -0,0 +1,136 @@
+# frozen_string_literal: true
+
+require_relative 'signal/client'
+require_relative 'signal/provisioner'
+
+module BrainzLab
+  module Signal
+    SEVERITIES = %i[info warning error critical].freeze
+
+    class << self
+      # Send an alert with a message
+      # @param name [String] Alert name (e.g., 'high_error_rate', 'low_disk_space')
+      # @param message [String] Alert message
+      # @param severity [Symbol] Alert severity (:info, :warning, :error, :critical)
+      # @param channels [Array<String>] Channels to send alert to (e.g., ['slack', 'email'])
+      # @param data [Hash] Additional data to include with the alert
+      def alert(name, message, severity: :warning, channels: nil, data: {})
+        return unless enabled?
+
+        ensure_provisioned!
+        return unless BrainzLab.configuration.signal_valid?
+
+        payload = {
+          type: 'alert',
+          name: name,
+          message: message,
+          severity: severity.to_s,
+          channels: channels,
+          data: data,
+          timestamp: Time.now.utc.iso8601(3),
+          environment: BrainzLab.configuration.environment,
+          service: BrainzLab.configuration.service,
+          host: BrainzLab.configuration.host,
+          context: context_data
+        }
+
+        client.send_alert(payload)
+      end
+
+      # Send a notification to specific channels
+      # @param channel [String, Array<String>] Channel(s) to send to ('slack', 'email', 'webhook')
+      # @param message [String] Notification message
+      # @param title [String] Optional notification title
+      # @param data [Hash] Additional data
+      def notify(channel, message, title: nil, data: {})
+        return unless enabled?
+
+        ensure_provisioned!
+        return unless BrainzLab.configuration.signal_valid?
+
+        channels = Array(channel)
+        payload = {
+          type: 'notification',
+          channels: channels,
+          message: message,
+          title: title,
+          data: data,
+          timestamp: Time.now.utc.iso8601(3),
+          environment: BrainzLab.configuration.environment,
+          service: BrainzLab.configuration.service
+        }
+
+        client.send_notification(payload)
+      end
+
+      # Trigger a predefined alert rule
+      # @param rule_name [String] Name of the alert rule to trigger
+      # @param context [Hash] Context data to pass to the rule
+      def trigger(rule_name, context = {})
+        return unless enabled?
+
+        ensure_provisioned!
+        return unless BrainzLab.configuration.signal_valid?
+
+        payload = {
+          type: 'trigger',
+          rule: rule_name,
+          context: context,
+          timestamp: Time.now.utc.iso8601(3),
+          environment: BrainzLab.configuration.environment,
+          service: BrainzLab.configuration.service
+        }
+
+        client.trigger_rule(payload)
+      end
+
+      # Send a test alert to verify configuration
+      def test!
+        alert(
+          'test_alert',
+          'This is a test alert from BrainzLab Signal SDK',
+          severity: :info,
+          data: { test: true, sdk_version: BrainzLab::VERSION }
+        )
+      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.signal_effectively_enabled?
+      end
+
+      def context_data
+        ctx = BrainzLab::Context.current
+        {
+          user: ctx.user,
+          tags: ctx.tags,
+          extra: ctx.extra
+        }
+      end
+    end
+  end
+end

data/lib/brainzlab/synapse/client.rb

@@ -0,0 +1,308 @@
+# frozen_string_literal: true
+
+require 'net/http'
+require 'json'
+require 'uri'
+
+module BrainzLab
+  module Synapse
+    class Client
+      def initialize(config)
+        @config = config
+        @base_url = config.synapse_url || 'https://synapse.brainzlab.ai'
+      end
+
+      # List all projects
+      def list_projects(status: nil, page: 1, per_page: 20)
+        params = { page: page, per_page: per_page }
+        params[:status] = status if status
+
+        response = request(:get, '/api/v1/projects', params: params)
+
+        return [] unless response.is_a?(Net::HTTPSuccess)
+
+        data = JSON.parse(response.body, symbolize_names: true)
+        data[:projects] || []
+      rescue StandardError => e
+        log_error('list_projects', e)
+        []
+      end
+
+      # Get project details
+      def get_project(project_id)
+        response = request(:get, "/api/v1/projects/#{project_id}")
+
+        return nil unless response.is_a?(Net::HTTPSuccess)
+
+        JSON.parse(response.body, symbolize_names: true)
+      rescue StandardError => e
+        log_error('get_project', e)
+        nil
+      end
+
+      # Create a new project
+      def create_project(name:, repos: [], description: nil, **options)
+        response = request(
+          :post,
+          '/api/v1/projects',
+          body: {
+            name: name,
+            description: description,
+            repos: repos,
+            **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_project', e)
+        nil
+      end
+
+      # Start project containers
+      def start_project(project_id)
+        response = request(:post, "/api/v1/projects/#{project_id}/up")
+        response.is_a?(Net::HTTPSuccess) || response.is_a?(Net::HTTPAccepted)
+      rescue StandardError => e
+        log_error('start_project', e)
+        false
+      end
+
+      # Stop project containers
+      def stop_project(project_id)
+        response = request(:post, "/api/v1/projects/#{project_id}/down")
+        response.is_a?(Net::HTTPSuccess) || response.is_a?(Net::HTTPAccepted)
+      rescue StandardError => e
+        log_error('stop_project', e)
+        false
+      end
+
+      # Restart project containers
+      def restart_project(project_id)
+        response = request(:post, "/api/v1/projects/#{project_id}/restart")
+        response.is_a?(Net::HTTPSuccess) || response.is_a?(Net::HTTPAccepted)
+      rescue StandardError => e
+        log_error('restart_project', e)
+        false
+      end
+
+      # Deploy project to environment
+      def deploy(project_id, environment:, options: {})
+        response = request(
+          :post,
+          "/api/v1/projects/#{project_id}/deploy",
+          body: {
+            environment: environment,
+            **options
+          }
+        )
+
+        return nil unless response.is_a?(Net::HTTPSuccess) || response.is_a?(Net::HTTPAccepted)
+
+        JSON.parse(response.body, symbolize_names: true)
+      rescue StandardError => e
+        log_error('deploy', e)
+        nil
+      end
+
+      # Get deployment status
+      def get_deployment(deployment_id)
+        response = request(:get, "/api/v1/deployments/#{deployment_id}")
+
+        return nil unless response.is_a?(Net::HTTPSuccess)
+
+        JSON.parse(response.body, symbolize_names: true)
+      rescue StandardError => e
+        log_error('get_deployment', e)
+        nil
+      end
+
+      # Create an AI task
+      def create_task(project_id:, description:, type: nil, priority: nil, **options)
+        response = request(
+          :post,
+          '/api/v1/tasks',
+          body: {
+            project_id: project_id,
+            description: description,
+            type: type,
+            priority: priority,
+            **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_task', e)
+        nil
+      end
+
+      # Get task status
+      def get_task(task_id)
+        response = request(:get, "/api/v1/tasks/#{task_id}")
+
+        return nil unless response.is_a?(Net::HTTPSuccess)
+
+        JSON.parse(response.body, symbolize_names: true)
+      rescue StandardError => e
+        log_error('get_task', e)
+        nil
+      end
+
+      # Get task status and progress
+      def get_task_status(task_id)
+        response = request(:get, "/api/v1/tasks/#{task_id}/status")
+
+        return nil unless response.is_a?(Net::HTTPSuccess)
+
+        JSON.parse(response.body, symbolize_names: true)
+      rescue StandardError => e
+        log_error('get_task_status', e)
+        nil
+      end
+
+      # List tasks for a project
+      def list_tasks(project_id: nil, status: nil, page: 1, per_page: 20)
+        params = { page: page, per_page: per_page }
+        params[:project_id] = project_id if project_id
+        params[:status] = status if status
+
+        response = request(:get, '/api/v1/tasks', params: params)
+
+        return [] unless response.is_a?(Net::HTTPSuccess)
+
+        data = JSON.parse(response.body, symbolize_names: true)
+        data[:tasks] || []
+      rescue StandardError => e
+        log_error('list_tasks', e)
+        []
+      end
+
+      # Cancel a running task
+      def cancel_task(task_id)
+        response = request(:post, "/api/v1/tasks/#{task_id}/cancel")
+        response.is_a?(Net::HTTPSuccess) || response.is_a?(Net::HTTPAccepted)
+      rescue StandardError => e
+        log_error('cancel_task', e)
+        false
+      end
+
+      # Get container logs
+      def get_logs(project_id, container: nil, lines: 100, since: nil)
+        params = { lines: lines }
+        params[:container] = container if container
+        params[:since] = since if since
+
+        response = request(:get, "/api/v1/projects/#{project_id}/logs", params: params)
+
+        return nil unless response.is_a?(Net::HTTPSuccess)
+
+        JSON.parse(response.body, symbolize_names: true)
+      rescue StandardError => e
+        log_error('get_logs', e)
+        nil
+      end
+
+      # Execute command in container
+      def exec(project_id, command:, container: nil, timeout: 30)
+        response = request(
+          :post,
+          "/api/v1/projects/#{project_id}/exec",
+          body: {
+            command: command,
+            container: container,
+            timeout: timeout
+          }
+        )
+
+        return nil unless response.is_a?(Net::HTTPSuccess)
+
+        JSON.parse(response.body, symbolize_names: true)
+      rescue StandardError => e
+        log_error('exec', e)
+        nil
+      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}")
+
+        uri.query = URI.encode_www_form(params) if params
+
+        http = Net::HTTP.new(uri.host, uri.port)
+        http.use_ssl = uri.scheme == 'https'
+        http.open_timeout = 10
+        http.read_timeout = 120 # Longer timeout for AI tasks
+
+        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.synapse_master_key || @config.secret_key
+        else
+          auth_key = @config.synapse_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)
+        structured_error = ErrorHandler.wrap(error, service: 'Synapse', operation: operation)
+        BrainzLab.debug_log("[Synapse::Client] #{operation} failed: #{structured_error.message}")
+
+        # Call on_error callback if configured
+        if @config.on_error
+          @config.on_error.call(structured_error, { service: 'Synapse', operation: operation })
+        end
+      end
+
+      def handle_response_error(response, operation)
+        return if response.is_a?(Net::HTTPSuccess) || response.is_a?(Net::HTTPCreated) || response.is_a?(Net::HTTPNoContent) || response.is_a?(Net::HTTPAccepted)
+
+        structured_error = ErrorHandler.from_response(response, service: 'Synapse', operation: operation)
+        BrainzLab.debug_log("[Synapse::Client] #{operation} failed: #{structured_error.message}")
+
+        # Call on_error callback if configured
+        if @config.on_error
+          @config.on_error.call(structured_error, { service: 'Synapse', operation: operation })
+        end
+
+        structured_error
+      end
+    end
+  end
+end

data/lib/brainzlab/synapse/provisioner.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module BrainzLab
+  module Synapse
+    class Provisioner
+      def initialize(config)
+        @config = config
+        @provisioned = false
+      end
+
+      def ensure_project!
+        return if @provisioned
+        return unless @config.synapse_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("[Synapse::Provisioner] Project provisioned: #{project_id}")
+      rescue StandardError => e
+        BrainzLab.debug_log("[Synapse::Provisioner] Provisioning failed: #{e.message}")
+      end
+
+      private
+
+      def valid_auth?
+        key = @config.synapse_api_key || @config.synapse_master_key || @config.secret_key
+        !key.nil? && !key.empty?
+      end
+
+      def detect_project_id
+        ENV.fetch('BRAINZLAB_PROJECT_ID', nil)
+      end
+    end
+  end
+end