bidi2pdf 0.1.1 → 0.1.2

data/sig/bidi2pdf/bidi/network_event.rbs

@@ -0,0 +1,51 @@
+module Bidi2pdf
+  module Bidi
+    class NetworkEvent
+      # Request data
+      @request_id: String
+      @url: String
+      @method: String
+      @headers: Hash[String, String]
+      @post_data: String?
+
+      # Response data
+      @response_status: Integer?
+      @response_headers: Hash[String, String]?
+      @response_body: String?
+
+      # Timing information
+      @timestamp: Float
+      @timing: Hash[Symbol, Float]?
+
+      attr_reader request_id: String
+      attr_reader url: String
+      attr_reader method: String
+      attr_reader headers: Hash[String, String]
+      attr_reader post_data: String?
+      attr_reader response_status: Integer?
+      attr_reader response_headers: Hash[String, String]?
+      attr_reader response_body: String?
+      attr_reader timestamp: Float
+      attr_reader timing: Hash[Symbol, Float]?
+
+      def initialize: (
+          request_id: String,
+          url: String,
+          method: String,
+          headers: Hash[String, String],
+          ?post_data: String?,
+          ?timestamp: Float?
+        ) -> void
+
+      def add_response: (
+          status: Integer,
+          headers: Hash[String, String],
+          ?body: String?
+        ) -> void
+
+      def add_timing: (Hash[Symbol, Float] timing_data) -> void
+
+      def completed?: () -> bool
+    end
+  end
+end

data/sig/bidi2pdf/bidi/network_events.rbs

@@ -0,0 +1,55 @@
+module Bidi2pdf
+  module Bidi
+    class NetworkEvents
+      include Enumerable[NetworkEvent]
+
+      @events: Hash[String, NetworkEvent]
+      @browser: Bidi2pdf::Bidi::Browser?
+      @event_manager: Bidi2pdf::Bidi::EventManager?
+      @recording: bool
+      @filters: Array[Proc]
+
+      attr_reader events: Hash[String, NetworkEvent]
+      attr_reader recording: bool
+
+      def initialize: (?browser: Bidi2pdf::Bidi::Browser?) -> void
+
+      def start_recording: (?browser: Bidi2pdf::Bidi::Browser?) -> void
+
+      def stop_recording: () -> void
+
+      def add_filter: () { (NetworkEvent) -> bool } -> void
+
+      def clear_filters: () -> void
+
+      def clear: () -> void
+
+      def size: () -> Integer
+
+      def []: (String request_id) -> NetworkEvent?
+
+      def each: () { (NetworkEvent) -> void } -> self
+        | () -> Enumerator[NetworkEvent, self]
+
+      def find_by_url: (String url_pattern) -> Array[NetworkEvent]
+
+      def find_by_method: (String method) -> Array[NetworkEvent]
+
+      def completed_requests: () -> Array[NetworkEvent]
+
+      def pending_requests: () -> Array[NetworkEvent]
+
+      def to_a: () -> Array[NetworkEvent]
+
+      private
+
+      def setup_event_listeners: () -> void
+
+      def handle_request_event: (Hash[String, untyped] params) -> void
+
+      def handle_response_event: (Hash[String, untyped] params) -> void
+
+      def handle_loading_finished_event: (Hash[String, untyped] params) -> void
+    end
+  end
+end

data/sig/bidi2pdf/bidi/print_parameters_validator.rbs

@@ -0,0 +1,44 @@
+module Bidi2pdf
+  module Bidi
+    class PrintParametersValidator
+      # Valid print parameter configurations
+      DEFAULT_PARAMETERS: Hash[Symbol, untyped]
+      ALLOWED_PAGE_RANGES_FORMATS: Array[String]
+      ALLOWED_MARGIN_UNITS: Array[String]
+      ALLOWED_PAPER_FORMATS: Array[String]
+      ALLOWED_ORIENTATIONS: Array[String]
+
+      @parameters: Hash[Symbol, untyped]
+      @errors: Array[String]
+
+      attr_reader errors: Array[String]
+      attr_reader parameters: Hash[Symbol, untyped]
+
+      def initialize: (Hash[Symbol, untyped] parameters) -> void
+
+      def validate: () -> bool
+
+      def valid?: () -> bool
+
+      private
+
+      def validate_boolean: (Symbol key) -> void
+
+      def validate_number: (Symbol key, ?min: Numeric?, ?max: Numeric?) -> void
+
+      def validate_string: (Symbol key) -> void
+
+      def validate_enum: (Symbol key, Array[String] allowed_values) -> void
+
+      def validate_margins: () -> void
+
+      def validate_page_ranges: () -> void
+
+      def validate_paper_size: () -> void
+
+      def normalize_parameters: () -> void
+
+      def add_error: (String message) -> void
+    end
+  end
+end

data/sig/bidi2pdf/bidi/session.rbs

@@ -0,0 +1,52 @@
+module Bidi2pdf
+  module Bidi
+    class Session
+      @browser: Bidi2pdf::Bidi::Browser
+      @session_id: String?
+      @contexts: Array[String]
+      @timeout: Integer
+      @event_manager: Bidi2pdf::Bidi::EventManager?
+      @network_events: Bidi2pdf::Bidi::NetworkEvents?
+
+      attr_reader browser: Bidi2pdf::Bidi::Browser
+      attr_reader session_id: String?
+      attr_reader contexts: Array[String]
+
+      def initialize: (
+          browser: Bidi2pdf::Bidi::Browser,
+          ?session_id: String?,
+          ?timeout: Integer
+        ) -> void
+
+      def create: () -> String
+
+      def attach: (session_id: String) -> String
+
+      def detach: () -> void
+
+      def execute_command: [T] (String method, ?Hash[Symbol, untyped] params) -> T
+
+      def navigate_to: (String url) -> void
+
+      def evaluate: [T] (String script) -> T
+
+      def wait_for_load: (?timeout: Integer?) -> void
+
+      def network_events: () -> Bidi2pdf::Bidi::NetworkEvents
+
+      def capture_screenshot: (?path: String?) -> String
+
+      def print_to_pdf: (
+          ?Hash[Symbol, untyped] parameters
+        ) -> String
+
+      def close: () -> void
+
+      private
+
+      def ensure_session: () -> String
+
+      def setup_event_listeners: () -> void
+    end
+  end
+end

data/sig/bidi2pdf/bidi/user_context.rbs

@@ -0,0 +1,50 @@
+module Bidi2pdf
+  module Bidi
+    class UserContext
+      @browser: Bidi2pdf::Bidi::Browser
+      @context_id: String
+      @session_id: String?
+      @event_manager: Bidi2pdf::Bidi::EventManager?
+      @network_events: Bidi2pdf::Bidi::NetworkEvents?
+      @closed: bool
+
+      attr_reader context_id: String
+      attr_reader browser: Bidi2pdf::Bidi::Browser
+      attr_reader session_id: String?
+
+      def initialize: (
+          browser: Bidi2pdf::Bidi::Browser,
+          context_id: String,
+          ?session_id: String?
+        ) -> void
+
+      def create_session: () -> String
+
+      def attach_session: (session_id: String) -> String
+
+      def execute_command: [T] (String method, ?Hash[Symbol, untyped] params) -> T
+
+      def navigate_to: (String url) -> void
+
+      def evaluate: [T] (String script) -> T
+
+      def wait_for_load: (?timeout: Integer?) -> void
+
+      def network_events: () -> Bidi2pdf::Bidi::NetworkEvents
+
+      def capture_screenshot: (?path: String?) -> String
+
+      def print_to_pdf: (?Hash[Symbol, untyped] parameters) -> String
+
+      def close: () -> void
+
+      def closed?: () -> bool
+
+      private
+
+      def ensure_open: () -> void
+
+      def setup_event_listeners: () -> void
+    end
+  end
+end

data/sig/bidi2pdf/bidi/web_socket_dispatcher.rbs

@@ -0,0 +1,53 @@
+module Bidi2pdf
+  module Bidi
+    class WebSocketDispatcher
+      @url: String
+      @socket: WebSocket::Driver
+      @connection: TCPSocket
+      @pending_requests: Hash[Integer, Concurrent::Promises::ResolvableFuture]
+      @message_id: Integer
+      @listeners: Hash[String, Array[Proc]]
+      @thread: Thread?
+      @mutex: Mutex
+      @connected: bool
+      @logger: Logger?
+
+      attr_reader url: String
+      attr_reader connected: bool
+
+      def initialize: (String url, ?logger: Logger?) -> void
+
+      def connect: () -> bool
+
+      def disconnect: () -> void
+
+      def send_command: [T] (String method, ?Hash[Symbol, untyped] params) -> T
+
+      def send_message: (Hash[Symbol, untyped] message) -> Integer
+
+      def add_event_listener: (String event_name) { (Hash[String, untyped]) -> void } -> void
+
+      def remove_event_listener: (String event_name, ?Proc? callback) -> void
+
+      def connected?: () -> bool
+
+      private
+
+      def generate_message_id: () -> Integer
+
+      def create_socket: () -> WebSocket::Driver
+
+      def handle_open: () -> void
+
+      def handle_message: (String data) -> void
+
+      def handle_close: () -> void
+
+      def handle_error: (Exception error) -> void
+
+      def dispatch_event: (String event_name, Hash[String, untyped] params) -> void
+
+      def listen_for_messages: () -> void
+    end
+  end
+end

data/sig/bidi2pdf/chromedriver_manager.rbs

@@ -0,0 +1,42 @@
+module Bidi2pdf
+  class ChromedriverManager
+    @port: Integer
+    @headless: bool
+    @session: untyped
+    @pid: Integer?
+
+    attr_reader port: Integer
+    attr_reader pid: Integer?
+    attr_reader session: untyped
+
+    def initialize: (?port: Integer, ?headless: bool) -> void
+
+    def start: () -> self
+
+    def stop: (?timeout: Integer) -> bool
+
+    private
+
+    # rubocop:disable Metrics/AbcSize
+    def detect_zombie_processes: () -> Array[Integer]?
+
+    def debug_show_all_children: () -> void
+
+    def close_session: () -> void
+
+    def term_chromedriver: () -> bool
+
+    def kill_chromedriver: (?timeout: Integer) -> bool
+
+    def build_cmd: () -> Array[String]
+
+    def update_chromedriver: () -> void
+
+    # rubocop:disable Metrics/AbcSize
+    def parse_port_from_output: (IO io, ?timeout: Integer) -> Integer?
+
+    def process_alive?: (?pid: Integer?) -> bool
+
+    def wait_until_chromedriver_ready: (?timeout: Integer) -> bool
+  end
+end

data/sig/bidi2pdf/cli.rbs

@@ -0,0 +1,21 @@
+module Bidi2pdf
+  class CLI < Thor
+    # rubocop:disable Layout/BeginEndAlignment
+    @launcher: untyped
+
+    def render: () -> untyped
+
+    private
+
+    # rubocop:disable  Metrics/AbcSize
+    def launcher: () -> untyped
+
+    def configure: () -> untyped
+
+    def log_level: () -> untyped
+
+    def parse_key_values: (untyped pairs) -> untyped
+
+    def parse_auth: (untyped auth_string) -> ::Array[untyped]
+  end
+end

data/sig/bidi2pdf/launcher.rbs

@@ -0,0 +1,38 @@
+module Bidi2pdf
+  class Launcher
+    @url: untyped
+
+    @port: untyped
+
+    @headless: untyped
+
+    @output: untyped
+
+    @cookies: untyped
+
+    @headers: untyped
+
+    @auth: untyped
+
+    @manager: untyped
+
+    @wait_window_loaded: untyped
+
+    @wait_network_idle: untyped
+
+    @print_options: untyped
+
+    @remote_browser_url: untyped
+
+    # rubocop:disable Metrics/ParameterLists
+    def initialize: (url: untyped, output: untyped, cookies: untyped, headers: untyped, auth: untyped, ?headless: bool, ?port: ::Integer, ?wait_window_loaded: bool, ?wait_network_idle: bool, ?print_options: ::Hash[untyped, untyped], ?remote_browser_url: untyped?) -> void
+
+    def launch: () -> untyped
+
+    def stop: () -> untyped
+
+    private
+
+    def session: () -> untyped
+  end
+end

data/sig/bidi2pdf/process_tree.rbs

@@ -0,0 +1,27 @@
+module Bidi2pdf
+  class ProcessTree
+    @root_pid: untyped
+
+    @process_map: untyped
+
+    include Sys
+
+    def initialize: (?untyped? root_pid) -> void
+
+    def children: (untyped of_pid) -> (::Array[untyped] | untyped)
+
+    def traverse: () { () -> untyped } -> untyped
+
+    private
+
+    def print_handler: (untyped process, untyped level) -> untyped
+
+    def build_process_map: () -> untyped
+
+    def connect_children: () -> untyped
+
+    def root_pids: () -> (::Array[untyped] | untyped)
+
+    def traverse_branch: (untyped pid, ?::Integer level) { () -> untyped } -> (nil | untyped)
+  end
+end

data/sig/bidi2pdf/session_runner.rbs

@@ -0,0 +1,51 @@
+module Bidi2pdf
+  class SessionRunner
+    @session: untyped
+
+    @url: untyped
+
+    @output: untyped
+
+    @cookies: untyped
+
+    @headers: untyped
+
+    @auth: untyped
+
+    @wait_window_loaded: untyped
+
+    @wait_network_idle: untyped
+
+    @print_options: untyped
+
+    @window: untyped
+
+    @tab: untyped
+
+    @uri: untyped
+
+    def initialize: (session: untyped, url: untyped, output: untyped, ?cookies: ::Hash[untyped, untyped], ?headers: ::Hash[untyped, untyped], ?auth: ::Hash[untyped, untyped], ?wait_window_loaded: bool, ?wait_network_idle: bool, ?print_options: ::Hash[untyped, untyped]) -> void
+
+    def run: () -> untyped
+
+    private
+
+    def setup_browser: () -> untyped
+
+    def add_cookies: (untyped tab) -> untyped
+
+    def add_headers: () -> untyped
+
+    def add_basic_auth: () -> (nil | untyped)
+
+    def run_flow: () -> untyped
+
+    def uri: () -> untyped
+
+    def domain: () -> untyped
+
+    def source_origin: () -> untyped
+
+    def url_patterns: () -> ::Array[{ type: "pattern", protocol: untyped, hostname: untyped, port: untyped }]
+  end
+end

data/sig/bidi2pdf/utils.rbs

@@ -0,0 +1,5 @@
+module Bidi2pdf
+  module Utils
+    def self?.timed: (untyped operation_name) { () -> untyped } -> untyped
+  end
+end

data/sig/vendor/thor.rbs

@@ -0,0 +1,13 @@
+class Thor
+  def self.desc: (String name, String description) -> void
+
+  def self.option: (Symbol name, ?Hash[Symbol, untyped] options) -> void
+
+  def self.long_desc: (String description, ?Hash[Symbol, untyped] options) -> void
+
+  interface _Command
+    def execute: (*untyped) -> untyped
+  end
+
+  def initialize: (?Hash[Symbol, untyped] options) -> void
+end

data/tasks/changelog.rake

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+def cliff_installed?
+  system("which git-cliff > /dev/null 2>&1")
+end
+
+namespace :changelog do
+  desc "Generate unreleased section in CHANGELOG.md (requires git-cliff)"
+  task :update_unreleased do
+    unless cliff_installed?
+      puts "🚫 git-cliff is not installed!"
+      puts "👉 Install it here: https://git-cliff.org/docs/installation/"
+      exit 1
+    end
+
+    generated = `git cliff --unreleased`
+
+    changelog_path = "CHANGELOG.md"
+    changelog = File.read(changelog_path)
+
+    updated = changelog.sub(
+      /<!--.*generated\s+by\s+git-cliff\s+start\s+-->(.*?)<!--\s+generated\s+by\s+git-cliff\s+end\s+-->/m,
+      generated.strip
+    )
+
+    File.write(changelog_path, updated)
+    puts "✅ Replaced generated section in CHANGELOG.md"
+  end
+end

data/tasks/generate_rbs.rake

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+require "fileutils"
+require "rbs"
+
+SOURCE_DIR = "lib"
+OUTPUT_DIR = "sig"
+
+# rubocop:disable  Metrics/BlockLength
+namespace :rbs do
+  file_list = FileList["#{SOURCE_DIR}/**/*.rb"]
+
+  desc "Generate all RBS files"
+  task generate_rbs: :rbs_targets
+
+  rbs_map = file_list.to_h do |rb|
+    relative = rb.sub(%r{^#{SOURCE_DIR}/}, "")
+    rbs = File.join(OUTPUT_DIR, relative.sub(/\.rb$/, ".rbs"))
+    [rbs, rb]
+  end
+
+  rbs_map.each do |rbs_path, rb_path|
+    file rbs_path => rb_path do
+      puts "🔧 Generating: #{rbs_path} (from #{rb_path})"
+
+      FileUtils.mkdir_p(File.dirname(rbs_path))
+
+      begin
+        input = Pathname(rb_path)
+        output = Pathname(rbs_path)
+
+        parser = RBS::Prototype::RB.new
+        parser.parse input.read
+
+        if output.file?
+          puts "⚠️  RBS file already exists: #{rbs_path}"
+        else
+          puts "📝 Writing RBS file: #{rbs_path}"
+
+          output.open("w") do |io|
+            writer = RBS::Writer.new(out: io)
+            writer.write(parser.decls)
+          end
+        end
+      rescue StandardError => e
+        puts "❌ Error generating RBS for #{rb_path}: #{e.message}"
+      end
+    end
+  end
+
+  desc "Generate RBS files for all Ruby files"
+  task rbs_targets: rbs_map.keys do
+    puts "✅ RBS generation complete!"
+  end
+
+  desc "Clean all generated RBS files"
+  task :clean_rbs do
+    FileList["#{OUTPUT_DIR}/**/*.rbs"].each do |file|
+      FileUtils.rm_f(file)
+    end
+    puts "🧹 Cleaned up all RBS files"
+  end
+end
+# rubocop:enable Metrics/BlockLength