lescopr 0.1.2 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ffab0fb6dbe1e787142136ce83288f91bd348aeac6850ea394aadcd887e4bd51
-  data.tar.gz: b88a47a85343da09d9afbc724da85e7dbe7789c4a344270d6a095f97cfd807ed
+  metadata.gz: 3efeda7d85c0e939043d1e0c9d4537977d37152832209a96e486e2abed28a2b7
+  data.tar.gz: 05310bf63b8dd2fb3c0e0da98e6c5b5181c751482c8652a647ffd2b92c6067ee
 SHA512:
-  metadata.gz: 8b85fea10925e71904e29b48eb4b895bd7c2a9a6dcf5bccf9783a705a54222e1ea2629513b8bfa3066733a1862ff81879ea16361a38200cf7c05fae78eeb9ff5
-  data.tar.gz: 0dc7402b895f673297ef5a5eb66a447e5e5aea8d371fb49f2ac7e2f8ccb7b5db446718869f3c98b072f2e0780ea72c5d7bcdc0ca9925520256cf184539847af2
+  metadata.gz: ce9a7fc494e0946721ae00bc07e4ac82ebedec432f27423f27671b773d78bd1d6f1de4ce67b5dea83559bfca210f45dd60fce4d9b190f5437555bef25ecb6440
+  data.tar.gz: 77788f5050abf55f0d5dc62dbba9a2dbe867bea75e7dc8d110841858f9bb036617d40cbb476d847144870870dd17b0782e0706b031df50d29fc035f7d1e41d1f

data/CHANGELOG.md

@@ -11,6 +11,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [1.0.0] — 2026-04-17
+
+### Added
+- **Modes** — nouveau module `lib/lescopr/modes/` pour configurer finement le comportement du SDK (silent, verbose, strict)
+- **Makefile** — workflow de release simplifié (`bump-patch`, `bump-minor`, `bump-major`, `release V=x.y.z`, `test`, `build`, `tag`, `push`)
+
+### Changed
+- `lib/lescopr.rb` — API publique alignée avec les nouvelles capacités de configuration
+- `lib/lescopr/core/client.rb` — intégration des modes
+- `lib/lescopr/transport/http_client.rb` — retry logic renforcée
+
+### Fixed
+- Script de release : vérification de l'arbre git limitée au répertoire Ruby (`git status --porcelain .`) pour éviter les faux positifs dans les setups monorepo
+
+---
+
 ## [0.1.2] — 2026-03-08
 
 ### Fixed
@@ -60,7 +76,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
-[Unreleased]: https://github.com/Lescopr/lescopr-ruby/compare/v0.1.2...HEAD
+[Unreleased]: https://github.com/Lescopr/lescopr-ruby/compare/v1.0.0...HEAD
+[1.0.0]: https://github.com/Lescopr/lescopr-ruby/releases/tag/v1.0.0
 [0.1.2]: https://github.com/Lescopr/lescopr-ruby/compare/v0.1.1...v0.1.2
 [0.1.1]: https://github.com/Lescopr/lescopr-ruby/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/Lescopr/lescopr-ruby/releases/tag/v0.1.0

data/README.md

@@ -5,7 +5,7 @@
 [![Ruby versions](https://img.shields.io/badge/ruby-2.7%20%7C%203.0%20%7C%203.1%20%7C%203.2%20%7C%203.3-ruby?cacheSeconds=300)](https://rubygems.org/gems/lescopr)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
-**Lescopr** is a zero-configuration Ruby monitoring SDK that automatically captures logs, errors, and exceptions from any Ruby project and streams them in real-time to the [Lescopr dashboard](https://app.lescopr.com).
+**Lescopr** is a zero-configuration Ruby monitoring SDK that automatically captures logs, errors, and exceptions from any Ruby project and streams them in real-time to the [Lescopr app](https://app.lescopr.com).
 
 Works out of the box with **Rails**, **Sinatra**, **Rack**, **Hanami**, **Grape**, and **plain Ruby**.
 
@@ -87,7 +87,7 @@ This detects your framework, registers the project with the Lescopr API, and wri
 
 **Step 2 — Integrate into your application** (see [Framework Integration](#framework-integration) below).
 
-**That's it.** All logs and exceptions are forwarded to the Lescopr dashboard automatically.
+**That's it.** All logs and exceptions are forwarded to the Lescopr app automatically.
 
 ---
 
@@ -195,7 +195,7 @@ Your Ruby Application
      https://api.lescopr.com
                │
                ▼
-     Lescopr Dashboard
+     Lescopr App
   https://app.lescopr.com
 ```
 
@@ -276,8 +276,8 @@ To publish a new release:
 
 | Channel | Link |
 |---|---|
-| 📖 Documentation | <https://docs.lescopr.com> |
-| 🌐 Dashboard | <https://app.lescopr.com> |
+| 📖 Documentation | <https://lescopr.com/docs> |
+| 🌐 App | <https://app.lescopr.com> |
 | 📧 Email | <support@lescopr.com> |
 | 🐛 Bug reports | <https://github.com/Lescopr/lescopr-ruby/issues> |
 

data/lib/lescopr/core/client.rb

@@ -5,13 +5,16 @@ module Lescopr
     # Central SDK client — manages configuration, log queue, daemon lifecycle
     # and the Ruby logger hook.
     class Client
-      attr_reader :configuration, :sdk_id, :log_queue, :http_client, :sdk_logger
+      attr_reader :configuration, :sdk_id, :log_queue, :http_client, :sdk_logger,
+                  :mode, :direct_mode
 
       def initialize(configuration)
         @configuration = configuration
         @sdk_id        = nil
         @ready         = false
         @mutex         = Mutex.new
+        @mode          = nil   # 'daemon' | 'embedded' | 'direct'
+        @direct_mode   = nil   # DirectMode or EmbeddedMode instance
 
         @sdk_logger  = Monitoring::Logger.new(debug: configuration.debug)
         @log_queue   = LogQueue.new
@@ -60,7 +63,20 @@ module Lescopr
         @daemon.start
         @ready = true
 
-        sdk_logger.info("SDK initialised — project: #{payload[:project_name]}, sdk_id: #{@sdk_id}")
+        # Determine and start mode after being ready
+        @mode = Modes::Detector.detect
+        sdk_logger.info("SDK initialised — mode: #{@mode}, project: #{payload[:project_name]}, sdk_id: #{@sdk_id}")
+
+        case @mode
+        when 'direct'
+          @direct_mode = Modes::DirectMode.new(http_client)
+          @direct_mode.start
+        when 'embedded'
+          @direct_mode = Modes::EmbeddedMode.new(http_client)
+          @direct_mode.start
+        end
+        # 'daemon' uses existing DaemonRunner — no extra setup needed
+
         true
       rescue StandardError => e
         sdk_logger.error("setup! failed: #{e.message}")
@@ -87,12 +103,22 @@ module Lescopr
           environment: configuration.environment,
           metadata:    metadata
         }
-        log_queue.push(entry)
+
+        # Route to mode-specific transport
+        if @direct_mode
+          @direct_mode.add_log(entry)
+        else
+          log_queue.push(entry)
+        end
       end
 
       # Graceful shutdown — flush queue then stop daemon.
       def shutdown!
-        @daemon.stop
+        if @direct_mode
+          @direct_mode.stop
+        else
+          @daemon.stop
+        end
         @ready = false
         sdk_logger.info("SDK shut down")
       end

data/lib/lescopr/modes/detector.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module Lescopr
+  module Modes
+    ##
+    # Auto-detect the optimal transport mode.
+    #
+    # Priority:
+    #  1. LESCOPR_MODE env var (daemon | embedded | direct)
+    #  2. Serverless / short-lived signals → direct
+    #  3. Multi-worker forked process      → embedded
+    #  4. Container (Docker / K8s)         → embedded
+    #  5. Daemon local active (checked by caller) → daemon
+    #  6. Fallback                         → embedded
+    #
+    # @return ['daemon', 'embedded', 'direct']
+    module Detector
+      SERVERLESS_SIGNALS = %w[
+        AWS_LAMBDA_FUNCTION_NAME
+        AWS_LAMBDA_RUNTIME_API
+        LAMBDA_TASK_ROOT
+        VERCEL
+        VERCEL_ENV
+        NETLIFY
+        NETLIFY_DEV
+        K_SERVICE
+        FUNCTION_NAME
+        FUNCTIONS_WORKER_RUNTIME
+        AZURE_FUNCTIONS_ENVIRONMENT
+      ].freeze
+
+      def self.detect
+        forced = ENV.fetch("LESCOPR_MODE", "").downcase
+        return forced if %w[daemon embedded direct].include?(forced)
+
+        return "direct"   if serverless?
+        return "embedded" if multiworker_child?
+        return "embedded" if container?
+
+        # Caller checks whether the daemon is actually running
+        "daemon"
+      end
+
+      def self.serverless?
+        SERVERLESS_SIGNALS.any? { |s| ENV.key?(s) }
+      end
+
+      def self.multiworker_child?
+        # Unicorn / Puma forked workers expose the master PID
+        return true if ENV["UNICORN_FD"] || ($0 && $0.include?("unicorn"))
+        return true if ENV["PUMA_WORKER"] || (defined?(Puma) && Puma.respond_to?(:cli_config))
+        return true if ENV["SIDEKIQ_WORKERS"] || (defined?(Sidekiq) && Sidekiq.server?)
+        false
+      end
+
+      def self.container?
+        return true if File.exist?("/.dockerenv")
+        return true if ENV["KUBERNETES_SERVICE_HOST"]
+
+        begin
+          content = File.read("/proc/1/cgroup")
+          return true if content.include?("docker") || content.include?("kubepods")
+        rescue Errno::ENOENT, Errno::EACCES
+          # Not Linux or no access — not a container
+        end
+
+        false
+      end
+    end
+  end
+end

data/lib/lescopr/modes/direct.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+require "thread"
+
+module Lescopr
+  module Modes
+    ##
+    # DirectMode — in-memory queue + HTTPS batch flush to /logs/ingest.
+    #
+    # Designed for serverless / ephemeral Ruby processes:
+    #  - AWS Lambda (ruby runtime)
+    #  - Heroku one-off dynos
+    #  - Short-lived Rake tasks or scripts
+    #
+    # Guarantees:
+    #  - Periodic flush every FLUSH_INTERVAL seconds (background thread)
+    #  - Guaranteed flush on process exit via at_exit hook
+    #  - Re-queue on network error (up to MAX_QUEUE entries)
+    class DirectMode
+      FLUSH_INTERVAL = 15    # seconds
+      BATCH_SIZE     = 100
+      MAX_QUEUE      = 500
+
+      def initialize(http_client)
+        @http_client = http_client
+        @queue       = []
+        @mutex       = Mutex.new
+        @stop_event  = false
+        @thread      = nil
+      end
+
+      # ── Lifecycle ──────────────────────────────────────────────────────────
+
+      def start
+        install_exit_hook!
+        start_flush_thread!
+
+        Lescopr::Monitoring::Logger.new.info("[DIRECT] Mode direct actif (HTTPS batch)")
+        self
+      end
+
+      def stop
+        @stop_event = true
+        @thread&.kill
+        flush_sync
+      end
+
+      # ── Public API ─────────────────────────────────────────────────────────
+
+      def add_log(entry)
+        @mutex.synchronize do
+          @queue << entry
+          if @queue.size > MAX_QUEUE
+            @queue = @queue.last(MAX_QUEUE / 2)
+          end
+        end
+      end
+
+      # ── Flush ──────────────────────────────────────────────────────────────
+
+      def flush_sync
+        loop do
+          batch = @mutex.synchronize { @queue.shift(BATCH_SIZE) }
+          break if batch.empty?
+
+          send_batch(batch)
+        end
+      end
+
+      private
+
+      def start_flush_thread!
+        @thread = Thread.new do
+          Thread.current.name = "lescopr-direct" rescue nil
+          until @stop_event
+            sleep(FLUSH_INTERVAL)
+            flush_sync
+          end
+        end
+        @thread.abort_on_exception = false
+      end
+
+      def install_exit_hook!
+        at_exit { flush_sync }
+      end
+
+      def send_batch(batch)
+        return if batch.empty?
+
+        result = @http_client.ingest_logs(batch)
+
+        if result
+          Lescopr::Monitoring::Logger.new.debug("[DIRECT] #{batch.size} log(s) envoyé(s)")
+        else
+          Lescopr::Monitoring::Logger.new.warn("[DIRECT] Flush échoué — remis en queue")
+          @mutex.synchronize do
+            @queue = batch + @queue
+            if @queue.size > MAX_QUEUE
+              @queue = @queue.last(MAX_QUEUE / 2)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/lescopr/modes/embedded.rb

@@ -0,0 +1,137 @@
+# frozen_string_literal: true
+
+require "thread"
+
+module Lescopr
+  module Modes
+    ##
+    # EmbeddedMode — gRPC-less in-process transport for long-running Ruby apps.
+    #
+    # Designed for:
+    #  - Docker / Kubernetes containers (no sidecar daemon)
+    #  - Gunicorn-style forked multi-worker apps (Puma, Unicorn)
+    #  - Any environment where running a separate daemon is impractical
+    #
+    # Behaviour:
+    #  - Reuses the existing HTTP transport (no gRPC required)
+    #  - Background thread flushes queue via HTTPS batch every FLUSH_INTERVAL s
+    #  - Exponential backoff on connection errors (up to 12 attempts)
+    #  - Exits cleanly via at_exit hook
+    class EmbeddedMode
+      FLUSH_INTERVAL  = 30   # seconds between normal flushes
+      BATCH_SIZE      = 100
+      MAX_QUEUE       = 500
+      MAX_CONNECT_ATTEMPTS = 12
+
+      def initialize(http_client)
+        @http_client   = http_client
+        @queue         = []
+        @mutex         = Mutex.new
+        @stop_event    = false
+        @thread        = nil
+        @connected     = false
+        @logger        = Lescopr::Monitoring::Logger.new
+      end
+
+      # ── Lifecycle ──────────────────────────────────────────────────────────
+
+      def start
+        install_exit_hook!
+        start_worker_thread!
+
+        @logger.info("[EMBEDDED] Mode embedded actif (thread HTTP)")
+        self
+      end
+
+      def stop
+        @stop_event = true
+        @thread&.join(5)
+        flush_sync
+      end
+
+      # ── Public API ─────────────────────────────────────────────────────────
+
+      def add_log(entry)
+        @mutex.synchronize do
+          @queue << entry
+          if @queue.size > MAX_QUEUE
+            @queue = @queue.last(MAX_QUEUE / 2)
+          end
+        end
+      end
+
+      # ── Flush ──────────────────────────────────────────────────────────────
+
+      def flush_sync
+        loop do
+          batch = @mutex.synchronize { @queue.shift(BATCH_SIZE) }
+          break if batch.empty?
+
+          send_batch(batch)
+        end
+      end
+
+      private
+
+      def start_worker_thread!
+        @thread = Thread.new do
+          Thread.current.name = "lescopr-embedded" rescue nil
+          _connect_with_backoff
+        end
+        @thread.abort_on_exception = false
+      end
+
+      def _connect_with_backoff
+        delay    = 2
+        attempts = 0
+
+        until @stop_event
+          sleep(FLUSH_INTERVAL) unless attempts.zero?
+
+          begin
+            flush_sync
+            @connected = true
+            @logger.info("[EMBEDDED] ✅ Flush réussi (tentative #{attempts + 1})") if attempts > 0
+            attempts = 0
+            delay    = 2
+          rescue StandardError => e
+            attempts += 1
+            @logger.debug("[EMBEDDED] Tentative #{attempts} échouée: #{e.message}")
+
+            if attempts >= MAX_CONNECT_ATTEMPTS
+              @logger.warn("[EMBEDDED] Trop d'échecs — pause de 60s avant retry")
+              sleep(60)
+              attempts = 0
+              delay    = 2
+            else
+              sleep(delay)
+              delay = [delay * 2, 60].min
+            end
+          end
+        end
+      end
+
+      def install_exit_hook!
+        at_exit { flush_sync }
+      end
+
+      def send_batch(batch)
+        return if batch.empty?
+
+        result = @http_client.ingest_logs(batch)
+
+        unless result
+          @mutex.synchronize do
+            @queue = batch + @queue
+            if @queue.size > MAX_QUEUE
+              @queue = @queue.last(MAX_QUEUE / 2)
+            end
+          end
+          raise "ingest_logs returned nil"
+        end
+
+        @logger.debug("[EMBEDDED] #{batch.size} log(s) envoyé(s)")
+      end
+    end
+  end
+end

data/lib/lescopr/transport/http_client.rb

@@ -34,6 +34,18 @@ module Lescopr
         !result.nil?
       end
 
+      # Batch ingest via the new /logs/ingest endpoint (Direct / Embedded mode).
+      # Authenticated by X-SDK-Key header — no user session required.
+      #
+      # @param logs [Array<Hash>]
+      # @return [Boolean]
+      def ingest_logs(logs)
+        return true if logs.empty?
+
+        result = post("/logs/ingest", { logs: logs })
+        !result.nil?
+      end
+
       # Send a single heartbeat.
       def send_heartbeat(sdk_id)
         post("/sdk/heartbeat/", { sdk_id: sdk_id })

data/lib/lescopr/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module Lescopr
-  VERSION = "0.1.2"
+  VERSION = "1.0.0"
 end
 

data/lib/lescopr.rb

@@ -19,6 +19,11 @@ require_relative "lescopr/core/daemon_runner"
 require_relative "lescopr/integrations/rack/middleware"
 require_relative "lescopr/integrations/sinatra/extension"
 
+# Modes package
+require_relative "lescopr/modes/detector"
+require_relative "lescopr/modes/direct"
+require_relative "lescopr/modes/embedded"
+
 # Rails Railtie is auto-loaded when Rails is present
 if defined?(Rails)
   require_relative "lescopr/integrations/rails/railtie"
@@ -56,6 +61,29 @@ module Lescopr
       @client
     end
 
+    # Zero-config init — loads SDK keys from .lescopr/config.json and
+    # auto-detects the best transport mode (daemon / embedded / direct).
+    #
+    # Usage (e.g. config/initializers/lescopr.rb or top of application.rb):
+    #   Lescopr.logs
+    #
+    # @return [Lescopr::Core::Client, nil]
+    def logs
+      return @client if @client
+
+      config_mgr = Filesystem::ConfigManager.new
+      saved      = config_mgr.load
+      return nil unless saved && saved[:sdk_key]
+
+      configuration.sdk_key     = saved[:sdk_key]
+      configuration.api_key     = saved[:api_key]
+      configuration.environment = saved[:environment] || "development"
+
+      @client = Core::Client.new(configuration)
+      @client.setup_auto_logging!
+      @client
+    end
+
     # Shorthand initialiser — accepts a hash or keyword args.
     #
     # @param opts [Hash]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lescopr
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 1.0.0
 platform: ruby
 authors:
 - SonnaLab
-autorequire:
+autorequire: 
 bindir: exe
 cert_chain: []
-date: 2026-03-07 00:00:00.000000000 Z
+date: 2026-04-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json
@@ -117,6 +117,9 @@ files:
 - lib/lescopr/integrations/rack/middleware.rb
 - lib/lescopr/integrations/rails/railtie.rb
 - lib/lescopr/integrations/sinatra/extension.rb
+- lib/lescopr/modes/detector.rb
+- lib/lescopr/modes/direct.rb
+- lib/lescopr/modes/embedded.rb
 - lib/lescopr/monitoring/logger.rb
 - lib/lescopr/transport/http_client.rb
 - lib/lescopr/version.rb
@@ -130,7 +133,7 @@ metadata:
   documentation_uri: https://docs.lescopr.com
   bug_tracker_uri: https://github.com/Lescopr/lescopr-ruby/issues
   rubygems_mfa_required: 'true'
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -145,8 +148,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
-signing_key:
+rubygems_version: 3.0.3.1
+signing_key: 
 specification_version: 4
 summary: Zero-configuration Ruby monitoring SDK
 test_files: []