bidi2pdf 0.1.6 → 0.1.8

data/lib/bidi2pdf.rb

@@ -1,14 +1,31 @@
 # frozen_string_literal: true
 
-require_relative "bidi2pdf/utils"
+require "concurrent-ruby"
+require "logger"
+
 require_relative "bidi2pdf/process_tree"
 require_relative "bidi2pdf/launcher"
 require_relative "bidi2pdf/bidi/session"
 require_relative "bidi2pdf/dsl"
-
-require "logger"
+require_relative "bidi2pdf/notifications"
+require_relative "bidi2pdf/notifications/logging_subscriber"
+require_relative "bidi2pdf/verbose_logger"
 
 module Bidi2pdf
+  PAPER_FORMATS_CM = {
+    letter: { width: 21.59, height: 27.94 },
+    legal: { width: 21.59, height: 35.56 },
+    tabloid: { width: 27.94, height: 43.18 },
+    ledger: { width: 43.18, height: 27.94 },
+    a0: { width: 84.1, height: 118.9 },
+    a1: { width: 59.4, height: 84.1 },
+    a2: { width: 42.0, height: 59.4 },
+    a3: { width: 29.7, height: 42.0 },
+    a4: { width: 21.0, height: 29.7 },
+    a5: { width: 14.8, height: 21.0 },
+    a6: { width: 10.5, height: 14.8 }
+  }.freeze
+
   class Error < StandardError; end
 
   class SessionNotStartedError < Error; end
@@ -17,7 +34,16 @@ module Bidi2pdf
 
   class ClientError < WebsocketError; end
 
-  class CmdError < ClientError; end
+  class CmdError < ClientError
+    attr_reader :cmd, :response
+
+    def initialize(cmd, response)
+      @cmd = cmd
+      @response = response
+
+      super("Error response: #{response["error"]} #{cmd.inspect}")
+    end
+  end
 
   class CmdResponseNotStoredError < ClientError; end
 
@@ -25,19 +51,114 @@ module Bidi2pdf
 
   class PrintError < Error; end
 
-  @logger = Logger.new($stdout)
-  @network_events_logger = Logger.new($stdout)
-  @logger.level = Logger::INFO
-  @network_events_logger.level = Logger::FATAL
+  class ScriptInjectionError < Error; end
+
+  class StyleInjectionError < Error; end
+
+  class NotificationsError < Error
+    attr_reader :causes
+
+    def initialize(causes)
+      @causes = causes
+      exception_class_names = causes.map { |e| e.class.name }
+      super("Notifications errors: #{exception_class_names.join(", ")}")
+    end
+  end
+
+  class NavigationError < Error; end
+
+  class NavigationAuthError < NavigationError
+    attr_reader :url
+
+    def initialize(url, message = nil)
+      @url = url
+      super("Navigation to #{url} failed due to authentication error. #{message}")
+    end
+  end
+
+  class NavigationTimeoutError < NavigationError; end
 
-  @default_timeout = 60
+  class NavigationNotFoundError < NavigationError; end
+
+  class NavigationDNSError < NavigationError; end
+
+  # Global configuration for Bidi2pdf
 
   class << self
-    attr_accessor :logger, :default_timeout, :network_events_logger
+    attr_accessor :default_timeout, :enable_default_logging_subscriber
+    attr_reader :logging_subscriber, :logger, :network_events_logger, :browser_console_logger, :notification_service
 
     # Allow configuration through a block
     def configure
       yield self if block_given?
+
+      init
     end
+
+    def init
+      self.logging_subscriber = (Notifications::LoggingSubscriber.new(logger: logger) if enable_default_logging_subscriber)
+      begin
+        require "websocket-native"
+
+        logger.debug "websocket-native available; use enhance performance."
+      rescue LoadError => e
+        raise unless e.message =~ /websocket-native/
+
+        logger.warn "websocket-native not available; installing it may enhance performance."
+      end
+    end
+
+    def translate_paper_format(format)
+      format = format.to_s.downcase.to_sym
+
+      dim = PAPER_FORMATS_CM[format]
+
+      raise ArgumentError, "Invalid paper format: #{format}" unless dim
+
+      width = dim[:width] || 0
+      height = dim[:height] || 0
+
+      { width: width, height: height }
+    end
+
+    def logger=(new_logger)
+      @logger = Bidi2pdf::VerboseLogger.new new_logger
+    end
+
+    def network_events_logger=(new_network_events_logger)
+      @network_events_logger = Bidi2pdf::VerboseLogger.new(new_network_events_logger)
+    end
+
+    def browser_console_logger=(new_browser_console_logger)
+      @browser_console_logger = Bidi2pdf::VerboseLogger.new(new_browser_console_logger)
+    end
+
+    def logging_subscriber=(new_logging_subscriber)
+      @logging_subscriber&.unsubscribe
+      @logging_subscriber = new_logging_subscriber
+    end
+
+    def notification_service=(new_notification_service)
+      @logging_subscriber&.unsubscribe
+
+      @notification_service = new_notification_service
+    end
+  end
+
+  configure do |config|
+    config.logger = Logger.new($stdout)
+    config.logger.level = Logger::INFO
+
+    config.network_events_logger = Logger.new($stdout)
+    config.network_events_logger.level = Logger::FATAL
+
+    config.browser_console_logger = Logger.new($stdout)
+    config.browser_console_logger.level = Logger::WARN
+
+    config.enable_default_logging_subscriber = true
+
+    config.default_timeout = 60
+
+    config.notification_service = Notifications
   end
 end

data/sig/bidi2pdf/bidi/client.rbs

@@ -34,7 +34,7 @@ module Bidi2pdf
 
       def wait_until_open: (?timeout: untyped) -> untyped
 
-      def send_cmd: (untyped method, ?::Hash[untyped, untyped] params) -> untyped
+      def send_cmd: (Bidi2pdf::Bidi::Commands::Base cmd) -> untyped
 
       # rubocop:disable Metrics/AbcSize
       def send_cmd_and_wait: (untyped method, ?::Hash[untyped, untyped] params, ?timeout: untyped) ?{ (untyped) -> untyped } -> untyped

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bidi2pdf
 version: !ruby/object:Gem::Version
-  version: 0.1.6
+  version: 0.1.8
 platform: ruby
 authors:
 - Dieter S.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-04-12 00:00:00.000000000 Z
+date: 2025-04-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -38,6 +38,26 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: concurrent-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.1
 - !ruby/object:Gem::Dependency
   name: json
   requirement: !ruby/object:Gem::Requirement
@@ -178,6 +198,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rspec-benchmark
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
@@ -276,6 +310,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.4'
+- !ruby/object:Gem::Dependency
+  name: websocket-native
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
 description: |
   Bidi2pdf is a powerful PDF generation tool that uses Chrome's BiDirectional Protocol
   to render web pages as high-quality PDF documents. It offers:
@@ -320,6 +368,7 @@ files:
 - lib/bidi2pdf/bidi/add_headers_interceptor.rb
 - lib/bidi2pdf/bidi/auth_interceptor.rb
 - lib/bidi2pdf/bidi/browser.rb
+- lib/bidi2pdf/bidi/browser_console_logger.rb
 - lib/bidi2pdf/bidi/browser_tab.rb
 - lib/bidi2pdf/bidi/client.rb
 - lib/bidi2pdf/bidi/command_manager.rb
@@ -328,6 +377,7 @@ files:
 - lib/bidi2pdf/bidi/commands/base.rb
 - lib/bidi2pdf/bidi/commands/browser_close.rb
 - lib/bidi2pdf/bidi/commands/browser_create_user_context.rb
+- lib/bidi2pdf/bidi/commands/browser_remove_user_context.rb
 - lib/bidi2pdf/bidi/commands/browsing_context_close.rb
 - lib/bidi2pdf/bidi/commands/browsing_context_navigate.rb
 - lib/bidi2pdf/bidi/commands/browsing_context_print.rb
@@ -347,7 +397,9 @@ files:
 - lib/bidi2pdf/bidi/connection_manager.rb
 - lib/bidi2pdf/bidi/event_manager.rb
 - lib/bidi2pdf/bidi/interceptor.rb
+- lib/bidi2pdf/bidi/js_logger_helper.rb
 - lib/bidi2pdf/bidi/logger_events.rb
+- lib/bidi2pdf/bidi/navigation_failed_events.rb
 - lib/bidi2pdf/bidi/network_event.rb
 - lib/bidi2pdf/bidi/network_event_formatters.rb
 - lib/bidi2pdf/bidi/network_event_formatters/network_event_console_formatter.rb
@@ -361,9 +413,20 @@ files:
 - lib/bidi2pdf/cli.rb
 - lib/bidi2pdf/dsl.rb
 - lib/bidi2pdf/launcher.rb
+- lib/bidi2pdf/notifications.rb
+- lib/bidi2pdf/notifications/event.rb
+- lib/bidi2pdf/notifications/instrumenter.rb
+- lib/bidi2pdf/notifications/logging_subscriber.rb
 - lib/bidi2pdf/process_tree.rb
 - lib/bidi2pdf/session_runner.rb
-- lib/bidi2pdf/utils.rb
+- lib/bidi2pdf/test_helpers.rb
+- lib/bidi2pdf/test_helpers/matchers/contains_pdf_text.rb
+- lib/bidi2pdf/test_helpers/matchers/have_pdf_page_count.rb
+- lib/bidi2pdf/test_helpers/matchers/match_pdf_text.rb
+- lib/bidi2pdf/test_helpers/pdf_reader_utils.rb
+- lib/bidi2pdf/test_helpers/pdf_text_sanitizer.rb
+- lib/bidi2pdf/test_helpers/testcontainers/chromedriver_container.rb
+- lib/bidi2pdf/verbose_logger.rb
 - lib/bidi2pdf/version.rb
 - sig/bidi2pdf.rbs
 - sig/bidi2pdf/bidi/add_headers_interceptor.rbs
@@ -429,7 +492,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.0.0
+      version: 3.3.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="

data/lib/bidi2pdf/utils.rb

@@ -1,15 +0,0 @@
-# frozen_string_literal: true
-
-module Bidi2pdf
-  module Utils
-    def timed(operation_name)
-      start_time = Time.now
-      result = yield
-      elapsed = Time.now - start_time
-      Bidi2pdf.logger.debug "#{operation_name} completed in #{elapsed.round(3)}s"
-      result
-    end
-
-    module_function :timed
-  end
-end