bidi2pdf-rails 0.0.1.pre.alpha → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7316e5fbdad14a0d1e622e7ee89955f20657cdbfced7f79e2c1b2861a9d93c1e
-  data.tar.gz: c889dae22e63576bdc3bd9cd7e9bae199bb6da39b92819fc817d3811453be663
+  metadata.gz: 9d0aa5d0b7d83ed5324b0a8669672f08d7a3e7b22dc7f9d51994f59e4d503df5
+  data.tar.gz: 928af8b8e8646b13c027cf2fb88ca216f53d37abc808c325733e18ee1011e1b8
 SHA512:
-  metadata.gz: c740e93dfcf86b054f7d1ecc2e503f2d676c02748c8c9bd1cc8dc38fba927b8ad9710407504875f2d610c2e1494b6e5200e940310fc6a338c2bea9e4d4029eb7
-  data.tar.gz: 8283d5241822de3278fa9916c6be0b6842621368c1695ad3139cef86a8c6cc40c8e65d21a9eacb30805bcef99a87b72a6faa45d308ccb08682f793cf9ecb5490
+  metadata.gz: 01abea76bf14ed10a93abe22394621df080e864024ad828de8a7edcf36eed62b12f008e02db06cf6e0b2449408132467df90415918473eabb55bbeb1ca6c91f8
+  data.tar.gz: 0b99cbcb01e48f2577e0da652b5a20f6720bbd11feb6e0dc06bea684e4d5c40e8d94b4c72c83862e498ade59050c1ef72bb28902f1f334c0f250821854391fd3

data/.idea/bidi2pdf-rails.iml

@@ -102,6 +102,7 @@
         </excluded>
       </library>
     </orderEntry>
+    <orderEntry type="library" scope="PROVIDED" name="Ascii85 (v2.0.1, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="actioncable (v7.2.2.1, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="actionmailbox (v7.2.2.1, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="actionmailer (v7.2.2.1, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
@@ -113,6 +114,8 @@
     <orderEntry type="library" scope="PROVIDED" name="activerecord (v7.2.2.1, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="activestorage (v7.2.2.1, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="activesupport (v7.2.2.1, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="afm (v0.2.2, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="ammeter (v1.1.7, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="ast (v2.4.3, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="benchmark (v0.4.0, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="bigdecimal (v3.1.9, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
@@ -128,8 +131,9 @@
     <orderEntry type="library" scope="PROVIDED" name="drb (v2.2.1, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="erubi (v1.13.1, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="event_emitter (v0.2.6, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="ffi (v1.17.1, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="ffi (v1.17.2, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="globalid (v1.2.1, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="hashery (v2.1.2, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="i18n (v1.14.7, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="io-console (v0.8.0, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="irb (v1.15.2, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
@@ -148,8 +152,9 @@
     <orderEntry type="library" scope="PROVIDED" name="net-smtp (v0.5.1, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="nio4r (v2.7.4, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="nokogiri (v1.18.7, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="parallel (v1.26.3, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="parallel (v1.27.0, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="parser (v3.3.8.0, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="pdf-reader (v2.14.1, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="pp (v0.6.2, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="prism (v1.4.0, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="propshaft (v1.1.0, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
@@ -181,8 +186,9 @@
     <orderEntry type="library" scope="PROVIDED" name="rubocop-rails (v2.31.0, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="rubocop-rails-omakase (v1.1.0, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="rubocop-rake (v0.7.1, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="rubocop-rspec (v3.5.0, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rubocop-rspec (v3.6.0, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="ruby-progressbar (v1.13.0, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="ruby-rc4 (v0.1.5, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="rubyzip (v2.4.1, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="securerandom (v0.4.1, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="simplecov (v0.22.0, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
@@ -192,14 +198,17 @@
     <orderEntry type="library" scope="PROVIDED" name="sys-proctable (v1.3.0, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="thor (v1.3.2, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="timeout (v0.4.3, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="ttfunk (v1.8.0, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="tzinfo (v2.0.6, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="unicode-display_width (v3.1.4, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="unicode-emoji (v4.0.4, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="unicode_utils (v1.4.0, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="useragent (v0.16.11, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="websocket (v1.2.11, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="websocket-client-simple (v0.9.0, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="websocket-driver (v0.7.7, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="websocket-extensions (v0.1.5, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="websocket-native (v1.0.0, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="zeitwerk (v2.7.2, RVM: ruby-3.3.4 [bidi2pdf-rails]) [gem]" level="application" />
   </component>
   <component name="RailsGeneratorsCache">
@@ -338,9 +347,6 @@
     <entry key="config">
       <value>file://$MODULE_DIR$/config</value>
     </entry>
-    <entry key="config/cable">
-      <value>file://$MODULE_DIR$/config/cable.yml</value>
-    </entry>
     <entry key="config/database">
       <value>file://$MODULE_DIR$/config/database.yml</value>
     </entry>
@@ -362,9 +368,6 @@
     <entry key="config/routes.rb">
       <value>file://$MODULE_DIR$/config/routes.rb</value>
     </entry>
-    <entry key="config/secrets">
-      <value>file://$MODULE_DIR$/config</value>
-    </entry>
     <entry key="db">
       <value>file://$MODULE_DIR$/db</value>
     </entry>
@@ -398,6 +401,9 @@
     <entry key="public/stylesheets">
       <value>file://$MODULE_DIR$/public/stylesheets</value>
     </entry>
+    <entry key="test/mailers/previews">
+      <value>file://$MODULE_DIR$/test/mailers/previews</value>
+    </entry>
     <entry key="tmp">
       <value>file://$MODULE_DIR$/tmp</value>
     </entry>
@@ -408,4 +414,44 @@
       <value>file://$MODULE_DIR$/vendor/assets</value>
     </entry>
   </component>
+  <component name="RakeTasksCache-v2">
+    <option name="myRootTask">
+      <RakeTaskImpl id="rake">
+        <subtasks>
+          <RakeTaskImpl description="Build bidi2pdf-rails-0.0.1.alpha.1.gem into the pkg directory" fullCommand="build" id="build" />
+          <RakeTaskImpl id="build">
+            <subtasks>
+              <RakeTaskImpl description="Generate SHA512 checksum of bidi2pdf-rails-0.0.1.alpha.1.gem into the checksums directory" fullCommand="build:checksum" id="checksum" />
+            </subtasks>
+          </RakeTaskImpl>
+          <RakeTaskImpl description="Remove any temporary products" fullCommand="clean" id="clean" />
+          <RakeTaskImpl description="Remove any generated files" fullCommand="clobber" id="clobber" />
+          <RakeTaskImpl description="Build and install bidi2pdf-rails-0.0.1.alpha.1.gem into system gems" fullCommand="install" id="install" />
+          <RakeTaskImpl id="install">
+            <subtasks>
+              <RakeTaskImpl description="Build and install bidi2pdf-rails-0.0.1.alpha.1.gem into system gems without network access" fullCommand="install:local" id="local" />
+            </subtasks>
+          </RakeTaskImpl>
+          <RakeTaskImpl description="Create tag v0.0.1.alpha.1 and build and push bidi2pdf-rails-0.0.1.alpha.1.gem to https://rubygems.org" fullCommand="release[remote]" id="release[remote]" />
+          <RakeTaskImpl description="Run RuboCop" fullCommand="rubocop" id="rubocop" />
+          <RakeTaskImpl id="rubocop">
+            <subtasks>
+              <RakeTaskImpl description="Autocorrect RuboCop offenses (only when it's safe)" fullCommand="rubocop:autocorrect" id="autocorrect" />
+              <RakeTaskImpl description="Autocorrect RuboCop offenses (safe and unsafe)" fullCommand="rubocop:autocorrect_all" id="autocorrect_all" />
+              <RakeTaskImpl description="" fullCommand="rubocop:auto_correct" id="auto_correct" />
+            </subtasks>
+          </RakeTaskImpl>
+          <RakeTaskImpl description="Run RSpec code examples" fullCommand="spec" id="spec" />
+          <RakeTaskImpl description="" fullCommand="release" id="release" />
+          <RakeTaskImpl id="release">
+            <subtasks>
+              <RakeTaskImpl description="" fullCommand="release:guard_clean" id="guard_clean" />
+              <RakeTaskImpl description="" fullCommand="release:rubygem_push" id="rubygem_push" />
+              <RakeTaskImpl description="" fullCommand="release:source_control_push" id="source_control_push" />
+            </subtasks>
+          </RakeTaskImpl>
+        </subtasks>
+      </RakeTaskImpl>
+    </option>
+  </component>
 </module>

data/.rubocop.yml

@@ -50,9 +50,18 @@ Layout/BeginEndAlignment:
 Layout/ArrayAlignment:
   Enabled: false
 
+Layout/ElseAlignment:
+  Enabled: false
+
+Layout/EndAlignment:
+  Enabled: false
+
 Layout/LineLength:
   Enabled: false
 
+Layout/SpaceInsideArrayLiteralBrackets:
+  EnforcedStyle: no_space
+
 RSpec/MultipleMemoizedHelpers:
   Max: 10
 
@@ -85,6 +94,11 @@ RSpec/DescribeClass:
   Exclude:
     - 'spec/acceptance/**/*_spec.rb'
 
+RSpec/MultipleExpectations:
+  Enabled: true
+  Exclude:
+    - 'spec/acceptance/**/*_spec.rb'
+
 plugins:
   - rubocop-rake
   - rubocop-rspec

data/CHANGELOG.md

@@ -0,0 +1,33 @@
+<!-- generated by git-cliff start -->
+
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+<!-- generated by git-cliff end -->
+
+## [0.1.0] - 2025-04-21
+
+### 🐛 Fixed
+
+- Add PDF rendering from protected remote URLs by @dieter-medium
+- Add acceptance tests for PDF generation with bidi2pdf-rails by @dieter-medium
+- Allow forcing chromedriver manager initialization by @dieter-medium
+- Add unit tests for BaseNestedConfig behavior by @dieter-medium
+
+### 📝 Docs
+
+- Enhance README with usage and config examples by @dieter-medium
+- Add CORS configuration details for asset access by @dieter-medium
+
+### 🚀 Added
+
+- Enhance configuration and logging for Bidi2pdfRails by @dieter-medium
+- Ensure custom HTML can be used in PDF rendering by @dieter-medium
+
+[unreleased](https://github.com/dieter-medium/bidi2pdf-rails/compare/v0.1.0..HEAD)
+[0.1.0](https://github.com/dieter-medium/bidi2pdf-rails/compare/v0.0.1.alpha.1..v0.1.0)
+

data/README.md

@@ -1,75 +1,165 @@
 [![Build Status](https://github.com/dieter-medium/bidi2pdf-rails/actions/workflows/ruby.yml/badge.svg)](https://github.com/dieter-medium/bidi2pdf-rails/blob/main/.github/workflows/ruby.yml)
 [![Maintainability](https://api.codeclimate.com/v1/badges/6425d9893aa3a9ca243e/maintainability)](https://codeclimate.com/github/dieter-medium/bidi2pdf-rails/maintainability)
-[![Gem Version](https://badge.fury.io/rb/bidi2pdf-rails.svg)](https://badge.fury.io/rb/bidi2pdf-rails)
 [![Test Coverage](https://api.codeclimate.com/v1/badges/6425d9893aa3a9ca243e/test_coverage)](https://codeclimate.com/github/dieter-medium/bidi2pdf-rails/test_coverage)
+[![Gem Version](https://badge.fury.io/rb/bidi2pdf-rails.svg)](https://badge.fury.io/rb/bidi2pdf-rails)
 [![Open Source Helpers](https://www.codetriage.com/dieter-medium/bidi2pdf-rails/badges/users.svg)](https://www.codetriage.com/dieter-medium/bidi2pdf-rails)
 
-
 # 📄 Bidi2pdfRails
 
-**Bidi2pdfRails** is the official Rails integration for [Bidi2pdf](https://github.com/dieter-medium/bidi2pdf) – a modern, browser-based solution for converting HTML to high-quality PDFs.  
-It leverages headless browsing and offers a simple, flexible interface for PDF generation directly from your Rails application.
+**Bidi2pdfRails** is the official Rails integration for [Bidi2pdf](https://github.com/dieter-medium/bidi2pdf) — a
+modern, headless-browser-based PDF rendering engine.  
+Generate high-fidelity PDFs directly from your Rails views or external URLs with minimal setup.
 
-> **⚠️ Note:** This project is currently **under development** and **not yet recommended for production use**.
+> ⚠️ **Project status:** _Under active development_. Not yet recommended for production use.
 
 ---
 
-## 🚀 Why Bidi2pdfRails?
+## ✨ Features
 
-- Utilizes modern browser technologies for accurate rendering (similar to `grover` or `wicked_pdf`)
-- Easy to integrate into existing Rails projects
-- Configurable options: URL, output path, rendering settings
+- 🔍 Accurate PDF rendering using a real browser engine
+- 💾 Supports both HTML string rendering and remote URL conversion
+- 🔐 Built-in support for authentication (Basic Auth, cookies, headers)
+- 🧰 Full test suite with examples for Rails controller integration
+- 🧠 Sensible defaults, yet fully configurable
 
 ---
 
 ## 🔧 Installation
 
-Add the following lines to your `Gemfile`:
+Add to your Gemfile:
 
 ```ruby
-gem "bidi2pdf-rails"
-# As long as the gem is not published, use:
-gem "bidi2pdf-rails", github: "dieter-medium/bidi2pdf", branch: "main"
+# Until released, use the GitHub repo
+gem "bidi2pdf-rails", github: "dieter-medium/bidi2pdf-rails", branch: "main"
 gem "bidi2pdf", github: "dieter-medium/bidi2pdf", branch: "main"
+
+# Optional for performance:
+# gem "websocket-native"
 ```
 
-Then install the dependencies:
+Install it:
 
 ```bash
-bundle
+bundle install
 ```
 
-Generate the initializer:
+Generate the config initializer:
 
 ```bash
 bin/rails generate bidi2pdf_rails:initializer
 ```
 
-Alternatively, install it manually:
+---
 
-```bash
-gem install bidi2pdf-rails
+## 📦 Usage Examples
+
+### 📄 Rendering a Rails View as PDF
+
+```ruby
+# app/controllers/invoices_controller.rb
+
+def show
+  render pdf: "invoice",
+         template: "invoices/show",
+         layout: "pdf",
+         locals: { invoice: @invoice },
+         print_options: { landscape: true },
+         wait_for_network_idle: true
+end
+```
+
+### 🌐 Rendering a Remote URL to PDF
+
+```ruby
+
+def convert
+  render pdf: "external-report",
+         url: "https://example.com/dashboard",
+         wait_for_page_loaded: false,
+         print_options: { page: { format: :A4 } }
+end
 ```
 
 ---
 
-## 🧪 Example & Getting Started
+## 🛡️ Authentication Support
+
+Need to convert pages that require authentication? No problem. Use:
+
+- `auth: { username:, password: }`
+- `cookies: { session_key: value }`
+- `headers: { "Authorization" => "Bearer ..." }`
+
+Example:
+
+```ruby
+render pdf: "secure",
+       url: secure_report_url,
+       auth: { username: "admin", password: "secret" }
+```
+
+Or use global config in `bidi2pdf_rails.rb` initializer:
+
+```ruby
+config.render_remote_settings.basic_auth_user = ->(_) { "admin" }
+config.render_remote_settings.basic_auth_pass = ->(_) { Rails.application.credentials.dig(:pdf, :auth_pass) }
+```
+
+---
+
+## 📂 Asset Access via CORS
+
+When rendering HTML with `render_to_string`, Chromium needs access to your assets (CSS, images, fonts).  
+Enable CORS for `/assets` using `rack-cors`:
+
+```ruby
+# Gemfile
+gem 'rack-cors'
+
+# config/initializers/cors.rb
+Rails.application.config.middleware.insert_before 0, Rack::Cors do
+  allow do
+    origins '*'
+    resource '/assets/*', headers: :any, methods: [:get, :options]
+  end
+end
+```
+
+---
+
+## 🧪 Acceptance Examples
+
+This repo includes **real integration tests** that serve as usage documentation:
+
+- [Download PDF with `.pdf` format](spec/acceptance/user_can_download_report_pdf_spec.rb)
+- [Render protected remote URLs using Basic Auth, cookies, and headers](spec/acceptance/user_can_generate_pdf_from_protected_remote_url_spec.rb)
+
+---
+
+## 🧠 Configuration
+
+Bidi2pdfRails is highly configurable.
+
+See full config options in:
+
+```bash
+bin/rails generate bidi2pdf_rails:initializer
+```
 
-You can find a full example inside the [`spec/dummy`](spec/dummy) directory of this repository.  
-This demonstrates how to use `Bidi2pdfRails` in a realistic mini Rails application setup.
+Or explore `Bidi2pdfRails::Configuration` in the source.
 
 ---
 
 ## 🙌 Contributing
 
-Want to contribute?  
-Pull requests, bug reports, and ideas are warmly welcome!
+Pull requests, issues, and ideas are all welcome 🙏  
+Want to contribute? Just fork, branch, and PR like a boss.
 
-*Contribution guidelines will be added soon.*
+> Contribution guide coming soon!
 
 ---
 
 ## 📄 License
 
-This gem is open-source and available under the terms of the [MIT License](https://opensource.org/licenses/MIT).  
-Free to use – with responsibility.
+This gem is released under the [MIT License](https://opensource.org/licenses/MIT).  
+Use freely — and responsibly.

data/Rakefile

@@ -9,3 +9,5 @@ RSpec::Core::RakeTask.new(:spec)
 require "rubocop/rake_task"
 
 RuboCop::RakeTask.new
+
+Dir.glob("tasks/*.rake").each { |r| load r }

data/cliff.toml

@@ -0,0 +1,126 @@
+# git-cliff ~ configuration file
+# https://git-cliff.org/docs/configuration
+
+[changelog]
+# template for the changelog header
+header = """
+<!-- generated by git-cliff start -->
+# Changelog\n
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).\n
+"""
+# template for the changelog body
+# https://keats.github.io/tera/docs/#introduction
+body = """
+{%- macro remote_url() -%}
+  https://github.com/{{ remote.github.owner }}/{{ remote.github.repo }}
+{%- endmacro -%}
+
+{% if version -%}
+    ## [{{ version | trim_start_matches(pat="v") }}] - {{ timestamp | date(format="%Y-%m-%d") }}
+{% else -%}
+    ## [Unreleased]
+{% endif -%}
+
+{% for group, commits in commits | group_by(attribute="group") %}
+    ### {{ group | upper_first }}
+    {%- for commit in commits %}
+        - {{ commit.message | split(pat="\n") | first | upper_first | trim }}\
+            {% if commit.remote.username %} by @{{ commit.remote.username }}{%- endif -%}
+            {% if commit.remote.pr_number %} in \
+            [#{{ commit.remote.pr_number }}]({{ self::remote_url() }}/pull/{{ commit.remote.pr_number }}) \
+            {%- endif -%}
+    {% endfor %}
+{% endfor %}
+
+{%- if github.contributors | filter(attribute="is_first_time", value=true) | length != 0 %}
+  ## New Contributors
+{%- endif -%}
+
+{% for contributor in github.contributors | filter(attribute="is_first_time", value=true) %}
+  * @{{ contributor.username }} made their first contribution
+    {%- if contributor.pr_number %} in \
+      [#{{ contributor.pr_number }}]({{ self::remote_url() }}/pull/{{ contributor.pr_number }}) \
+    {%- endif %}
+{%- endfor %}\n
+"""
+# template for the changelog footer
+footer = """
+{%- macro remote_url() -%}
+  https://github.com/{{ remote.github.owner }}/{{ remote.github.repo }}
+{%- endmacro -%}
+
+{% for release in releases -%}
+    {% if release.version -%}
+        {% if release.previous.version -%}
+            [{{ release.version | trim_start_matches(pat="v") }}]: \
+                {{ self::remote_url() }}/compare/{{ release.previous.version }}..{{ release.version }}
+        {% endif -%}
+    {% else -%}
+        [unreleased]: {{ self::remote_url() }}/compare/{{ release.previous.version }}..HEAD
+    {% endif -%}
+{% endfor %}
+<!-- generated by git-cliff end -->
+"""
+# remove the leading and trailing whitespace from the templates
+trim = true
+
+[git]
+# parse the commits based on https://www.conventionalcommits.org
+conventional_commits = true
+# filter out the commits that are not conventional
+filter_unconventional = false
+# regex for preprocessing the commit messages
+commit_preprocessors = [
+    # remove issue numbers from commits
+    { pattern = '\((\w+\s)?#([0-9]+)\)', replace = "" },
+]
+# regex for parsing and grouping commits
+commit_parsers = [
+    # ✅ Features (additions)
+    { message = "^feat(?:\\([^)]+\\))?!?:", group = "🚀 Added" },
+    { message = "^[aA]dd", group = "🚀 Added" },
+    { message = "^[sS]upport", group = "🚀 Added" },
+    # ❌ Removals
+    { message = "^[rR]emove", group = "🗑️ Removed" },
+    { message = "^[dD]elete", group = "🗑️ Removed" },
+    # 🐛 Fixes
+    { message = "^fix(?:\\([^)]+\\))?!?:", group = "🐛 Fixed" },
+    { message = "^[tT]est", group = "🐛 Fixed" },
+    { message = "^[fF]ix", group = "🐛 Fixed" },
+    # 🎨 Refactors
+    { message = "^refactor(?:\\([^)]+\\))?!?:", group = "🎨 Refactored" },
+    # ⚡️ Performance
+    { message = "^perf(?:\\([^)]+\\))?!?:", group = "⚡️ Performance" },
+    # 📝 Docs
+    { message = "^docs(?:\\([^)]+\\))?!?:", group = "📝 Docs" },
+    # 💄 Style (formatting, whitespace, etc.)
+    { message = "^style(?:\\([^)]+\\))?!?:", group = "💄 Style" },
+    # 🧪 Tests
+    { message = "^test(?:\\([^)]+\\))?!?:", group = "🧪 Tests" },
+    # 🔧 Build
+    { message = "^build(?:\\([^)]+\\))?!?:", group = "🔧 Build" },
+    # 🛠️ CI
+    { message = "^ci(?:\\([^)]+\\))?!?:", skip = true },
+    # 🧹 Chores (skip)
+    { message = "^chore\\(release\\): prepare for", skip = true },
+    { message = "^chore\\(deps.*\\)", skip = true },
+    { message = "^chore\\(pr\\)", skip = true },
+    { message = "^chore\\(pull\\)", skip = true },
+    { message = "^chore(?:\\([^)]+\\))?!?:", skip = true },
+    { message = "^\\s*chore", skip = true },
+    # ⏪ Reverts
+    { message = "^revert(?:\\([^)]+\\))?!?:", group = "⏪ Reverted" },
+    # 🌀 Catch-all (only if nothing else matched)
+    { message = "^.*", group = "🔄 Changed" }
+]
+
+
+# filter out the commits that are not matched by commit parsers
+filter_commits = false
+# sort the tags topologically
+topo_order = false
+# sort the commits inside sections by oldest/newest order
+sort_commits = "newest"

data/lib/bidi2pdf_rails/browser_console_log_subscriber.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require "bidi2pdf/bidi/browser_console_logger"
+
+module Bidi2pdfRails
+  class BrowserConsoleLogSubscriber < ActiveSupport::LogSubscriber
+    def browser_console_log_received(event)
+      payload = event.payload
+      timestamp = Bidi2pdf::Bidi::BrowserConsoleLogger.format_timestamp(payload[:timestamp])
+
+      logger.tagged("bidi2pdf_rails", "browser_console", timestamp) do |tagged_logger|
+        verbose_logger = Bidi2pdf::VerboseLogger.new(tagged_logger, Bidi2pdfRails.config.general_options.verbosity_value)
+        Bidi2pdf::Bidi::BrowserConsoleLogger.new(verbose_logger)
+                                            .builder
+                                            .with_level(payload[:level])
+                                            .with_prefix("")
+                                            .with_text(payload[:text])
+                                            .with_args(payload[:args])
+                                            .with_stack_trace(payload[:stack_trace])
+                                            .log_event
+      end
+    end
+  end
+end

data/lib/bidi2pdf_rails/chromedriver_manager_singleton.rb

@@ -5,28 +5,28 @@ module Bidi2pdfRails
     class << self
       attr_reader :manager, :session
 
-      def initialize_manager
-        return unless running_as_server?
+      def initialize_manager(force: false)
+        return unless running_as_server? || force
 
         @mutex ||= Mutex.new
         @mutex.synchronize do
           return if @manager && @session
 
-          msg = Bidi2pdfRails.remote_browser_url ? "Remote session" : "ChromeDriver manager"
+          msg = Bidi2pdfRails.use_remote_browser? ? "Remote session" : "ChromeDriver manager"
 
           Bidi2pdfRails.logger.info "Initializing Bidi2pdf #{msg}"
 
-          if Bidi2pdfRails.remote_browser_url
+          if Bidi2pdfRails.use_remote_browser?
             @session = Bidi::Session.new(
-              session_url: Bidi2pdfRails.remote_browser_url,
-              headless: Bidi2pdfRails.headless,
-              chrome_args: Bidi2pdfRails.chrome_session_args
+              session_url: Bidi2pdfRails.config.render_remote_settings.browser_url_value,
+              headless: Bidi2pdfRails.config.general_options.headless_value,
+              chrome_args: Bidi2pdfRails.config.general_options.chrome_session_args_value
             )
           else
             @manager = Bidi2pdf::ChromedriverManager.new(
-              port: Bidi2pdfRails.chromedriver_port,
-              headless: Bidi2pdfRails.headless,
-              chrome_args: Bidi2pdfRails.chrome_session_args
+              port: Bidi2pdfRails.config.chromedriver_settings.port_value,
+              headless: Bidi2pdfRails.config.general_options.headless_value,
+              chrome_args: Bidi2pdfRails.config.general_options.chrome_session_args_value
             )
             @manager.start
             @session = @manager.session
@@ -42,7 +42,7 @@ module Bidi2pdfRails
 
         @mutex ||= Mutex.new
         @mutex.synchronize do
-          msg = Bidi2pdfRails.remote_browser_url ? "Remote session" : "ChromeDriver manager"
+          msg = Bidi2pdfRails.use_remote_browser? ? "Remote session" : "ChromeDriver manager"
           Bidi2pdfRails.logger.info "Shutting down Bidi2pdf #{msg}"
           @session&.close
           @manager&.stop