better_auth 0.7.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b62f1d0f1e0fc4c774ab2d4907f9229f4cbcae46599cf8b72c03a4d5984aafcf
-  data.tar.gz: a02c36229e3d829a1d3c24d64e9e560fc9f592e9ad4ad915bcd6a962fd0f633a
+  metadata.gz: 98014e245459f3b5a7de74fbd1e41ac5449ff223e20e5f9c8ef9500e15c55d9f
+  data.tar.gz: 28252ead0ea2f370233bcc73bcc41568604608ff2d4d891a66abf71f49e01497
 SHA512:
-  metadata.gz: 50d18b3901b1e7292b3b4089e1eb388dadb16836d88a6d8af35ecb8061005dc062712010865b0f131b768538fbc2e64042edfb5b652feaad979f93d03f6ca7fa
-  data.tar.gz: ce679e88e9e12dd1d36aab49a20bb6d2a8e55e95de6eeccbdc3b4bd3736924d9496fb5148e874132f6f07efb914035ed6ce0cd200216355390bfe86b016c6ff8
+  metadata.gz: 22e4e6488cebfdc63f77d68747df4283ccf27c82381ab6bb7e372485f0c2d93cb4e37dce4748e75020f6556ff08a675ba42d47cf39a57f90c86f2d4a396c09b4
+  data.tar.gz: a05af007c3dcd034bc035a37e825991ce76ff8af9199ae33f4a3ecf2250718ac848ae52baa84d2d60c7b5eace5d7f2750de2d40dde779b182640184b50d1a765

data/CHANGELOG.md

@@ -50,7 +50,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 
-- Extracted MongoDB adapter support behind the external `better_auth-mongo-adapter` shim while preserving compatibility for existing adapter configuration.
+- Extracted MongoDB adapter support behind the external `better_auth-mongodb` package while preserving compatibility for existing adapter configuration.
 - Updated auth routes, router behavior, rate limiting, password and email-verification flows, and schema metadata to match upstream semantics more closely.
 
 ### Fixed

data/README.md

@@ -114,7 +114,7 @@ Custom Better Auth-style password callbacks are still supported through `email_a
 
 ### Database Adapters
 
-The core gem ships framework-agnostic adapters for memory, PostgreSQL, MySQL, SQLite, and MSSQL. Driver gems are loaded only when their adapter is instantiated. MongoDB support lives in the external `better_auth-mongo-adapter` package so apps that do not use MongoDB do not install the Mongo driver.
+The core gem ships framework-agnostic adapters for memory, PostgreSQL, MySQL, SQLite, and MSSQL. Driver gems are loaded only when their adapter is instantiated. MongoDB support lives in the external `better_auth-mongodb` package so apps that do not use MongoDB do not install the Mongo driver.
 
 ```ruby
 auth = BetterAuth.auth(
@@ -124,7 +124,7 @@ auth = BetterAuth.auth(
 ```
 
 ```ruby
-require "better_auth/mongo_adapter"
+require "better_auth/mongodb"
 
 auth = BetterAuth.auth(
   secret: ENV.fetch("BETTER_AUTH_SECRET"),

data/lib/better_auth/adapters/mongodb.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 begin
-  require "better_auth/mongo_adapter"
+  require "better_auth/mongodb"
 rescue LoadError => error
-  raise if error.path && error.path != "better_auth/mongo_adapter"
+  raise if error.path && error.path != "better_auth/mongodb"
 
-  raise LoadError, "BetterAuth::Adapters::MongoDB requires the better_auth-mongo-adapter gem. Add `gem \"better_auth-mongo-adapter\"` and `require \"better_auth/mongo_adapter\"`."
+  raise LoadError, "BetterAuth::Adapters::MongoDB requires the better_auth-mongodb gem. Add `gem \"better_auth-mongodb\"` and `require \"better_auth/mongodb\"`."
 end

data/lib/better_auth/auth.rb

@@ -2,7 +2,23 @@
 
 module BetterAuth
   class Auth
-    attr_reader :handler, :api, :options, :context, :error_codes
+    TELEMETRY_ADAPTER_IDS = {
+      "BetterAuth::Adapters::Memory" => "memory",
+      "BetterAuth::Adapters::Postgres" => "postgres",
+      "BetterAuth::Adapters::MySQL" => "mysql",
+      "BetterAuth::Adapters::SQLite" => "sqlite",
+      "BetterAuth::Adapters::MSSQL" => "mssql"
+    }.freeze
+
+    TELEMETRY_DATABASE_IDS = {
+      memory: "memory",
+      postgres: "postgres",
+      mysql: "mysql",
+      sqlite: "sqlite",
+      mssql: "mssql"
+    }.freeze
+
+    attr_reader :handler, :api, :options, :context, :error_codes, :telemetry
 
     def initialize(options = {})
       @options = Configuration.new(options)
@@ -16,6 +32,7 @@ module BetterAuth
       Router.check_endpoint_conflicts(@options, @options.logger)
       @api = API.new(@context, @endpoints)
       @handler = Router.new(@context, @endpoints)
+      @telemetry = build_telemetry_publisher
     end
 
     def call(env)
@@ -38,5 +55,55 @@ module BetterAuth
     def build_endpoints
       Core.base_endpoints.merge(@plugin_registry.endpoints)
     end
+
+    def build_telemetry_publisher
+      require "better_auth/telemetry"
+      BetterAuth::Telemetry.create(@options, telemetry_context)
+    rescue LoadError
+      noop_telemetry_publisher
+    rescue => e
+      log_telemetry_error(e)
+      noop_telemetry_publisher
+    end
+
+    def telemetry_context
+      {
+        database: telemetry_database_id,
+        adapter: telemetry_adapter_id,
+        custom_track: nil,
+        skip_test_check: false
+      }
+    end
+
+    def telemetry_database_id
+      configured = @options.database
+      return "memory" if configured.nil?
+      return TELEMETRY_DATABASE_IDS[configured] if configured.is_a?(Symbol) && TELEMETRY_DATABASE_IDS.key?(configured)
+      return "adapter" if configured.respond_to?(:call)
+
+      TELEMETRY_ADAPTER_IDS[configured.class.name] || "adapter"
+    end
+
+    def telemetry_adapter_id
+      TELEMETRY_ADAPTER_IDS[@context.adapter.class.name] || @context.adapter.class.name
+    end
+
+    def noop_telemetry_publisher
+      Class.new do
+        def publish(_event) = nil
+
+        def enabled? = false
+      end.new
+    end
+
+    def log_telemetry_error(error)
+      logger = @options.logger
+      message = "[better-auth] telemetry creation failed: #{error.class}: #{error.message}"
+      if logger.respond_to?(:error)
+        logger.error(message)
+      else
+        Kernel.warn(message)
+      end
+    end
   end
 end

data/lib/better_auth/configuration.rb

@@ -56,6 +56,7 @@ module BetterAuth
       :on_api_error,
       :disabled_paths,
       :trusted_origins_callback,
+      :telemetry,
       :logger
 
     def initialize(options = {})
@@ -73,12 +74,13 @@ module BetterAuth
       @database_hooks = options[:database_hooks]
       @hooks = options[:hooks]
       @on_api_error = symbolize_keys(options[:on_api_error] || options[:on_apierror] || {})
+      @telemetry = symbolize_keys(options[:telemetry] || {})
       @social_providers = symbolize_keys(options[:social_providers] || {})
       @trusted_origins_callbacks = []
       @trusted_origins_callbacks << options[:trusted_origins] if options[:trusted_origins].respond_to?(:call)
       @trusted_origins_callback = combined_trusted_origins_callback
       legacy_secret = resolve_secret(options, allow_test_default: false)
-      secrets = options.key?(:secrets) ? options[:secrets] : SecretConfig.parse_env(ENV["BETTER_AUTH_SECRETS"])
+      secrets = options.key?(:secrets) ? options[:secrets] : SecretConfig.parse_env(Env.get("BETTER_AUTH_SECRETS"))
       if secrets
         @secret_config = SecretConfig.build(secrets, legacy_secret, logger: logger)
         @secret = @secret_config.current_secret
@@ -153,7 +155,8 @@ module BetterAuth
         database_hooks: database_hooks,
         hooks: hooks,
         on_api_error: on_api_error,
-        disabled_paths: disabled_paths
+        disabled_paths: disabled_paths,
+        telemetry: telemetry
       }
     end
 
@@ -279,17 +282,13 @@ module BetterAuth
     def env_base_url
       base_url = ENV["BASE_URL"]
       [
-        ENV["BETTER_AUTH_URL"],
-        ENV["NEXT_PUBLIC_BETTER_AUTH_URL"],
-        ENV["PUBLIC_BETTER_AUTH_URL"],
-        ENV["NUXT_PUBLIC_BETTER_AUTH_URL"],
-        ENV["NUXT_PUBLIC_AUTH_URL"],
+        Env.get("BETTER_AUTH_URL"),
         (base_url unless base_url == "/")
       ].find { |value| value && !value.empty? }
     end
 
     def resolve_secret(options, allow_test_default: true)
-      [options[:secret], ENV["BETTER_AUTH_SECRET"], ENV["AUTH_SECRET"]].find { |value| value && !value.empty? } ||
+      [options[:secret], Env.get("BETTER_AUTH_SECRET"), ENV["AUTH_SECRET"]].find { |value| value && !value.empty? } ||
         ((allow_test_default && test_environment?) ? DEFAULT_SECRET : nil)
     end
 
@@ -408,7 +407,7 @@ module BetterAuth
     end
 
     def env_trusted_origins
-      ENV.fetch("BETTER_AUTH_TRUSTED_ORIGINS", "").split(",").map(&:strip).reject(&:empty?)
+      Env.csv("BETTER_AUTH_TRUSTED_ORIGINS")
     end
 
     def symbolize_keys(value)

data/lib/better_auth/context.rb

@@ -321,7 +321,7 @@ module BetterAuth
       if options.trusted_origins_callback
         origins.concat(Array(options.trusted_origins_callback.call(request)).compact)
       end
-      origins.concat(ENV.fetch("BETTER_AUTH_TRUSTED_ORIGINS", "").split(",").map(&:strip))
+      origins.concat(Env.csv("BETTER_AUTH_TRUSTED_ORIGINS"))
       origins.map(&:to_s).reject(&:empty?).uniq
     rescue URI::InvalidURIError
       options.trusted_origins

data/lib/better_auth/env.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module BetterAuth
+  module Env
+    module_function
+
+    def get(name)
+      open_auth_name = open_auth_name(name)
+      return nil unless open_auth_name
+
+      value = ENV[open_auth_name]
+      return value if present?(value)
+
+      value = ENV[name]
+      present?(value) ? value : nil
+    end
+
+    def fetch(name, default = nil)
+      value = get(name)
+      value.nil? ? default : value
+    end
+
+    def csv(name)
+      fetch(name, "").split(",").map(&:strip).reject(&:empty?)
+    end
+
+    def open_auth_name(name)
+      text = name.to_s
+      return nil unless text.start_with?("BETTER_AUTH_")
+
+      text.sub(/\ABETTER_AUTH_/, "OPEN_AUTH_")
+    end
+
+    def present?(value)
+      value && !value.empty?
+    end
+  end
+end

data/lib/better_auth/url_helpers.rb

@@ -178,7 +178,7 @@ module BetterAuth
     end
 
     def env_base_url(base_path)
-      url = ENV["BETTER_AUTH_URL"] || ENV["NEXT_PUBLIC_BETTER_AUTH_URL"] || ENV["PUBLIC_BETTER_AUTH_URL"] || ENV["NUXT_PUBLIC_BETTER_AUTH_URL"] || ENV["NUXT_PUBLIC_AUTH_URL"]
+      url = Env.get("BETTER_AUTH_URL")
       url ||= ENV["BASE_URL"] if ENV["BASE_URL"] && ENV["BASE_URL"] != "/"
       url ? with_path(url, base_path) : nil
     end

data/lib/better_auth/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BetterAuth
-  VERSION = "0.7.0"
+  VERSION = "0.8.0"
 end

data/lib/better_auth.rb

@@ -4,6 +4,7 @@ require_relative "better_auth/version"
 require_relative "better_auth/core"
 require_relative "better_auth/error"
 require_relative "better_auth/api_error"
+require_relative "better_auth/env"
 require_relative "better_auth/secret_config"
 require_relative "better_auth/crypto"
 require_relative "better_auth/host"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: better_auth
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Sebastian Sala
@@ -245,8 +245,10 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.1'
-description: Better Auth is a comprehensive, framework-agnostic authentication library
-  for Ruby. It provides a complete set of features out of the box with a plugin ecosystem.
+description: Better Auth Ruby is an independent, modern authentication framework for
+  Ruby, inspired by Better Auth. It is not affiliated with, maintained by, or endorsed
+  by the Better Auth project. It provides a framework-agnostic Rack core, auth routes,
+  sessions, adapters, and a plugin system.
 email:
 - sebastian.sala.tech@gmail.com
 executables: []
@@ -280,6 +282,7 @@ files:
 - lib/better_auth/database_hooks.rb
 - lib/better_auth/deprecate.rb
 - lib/better_auth/endpoint.rb
+- lib/better_auth/env.rb
 - lib/better_auth/error.rb
 - lib/better_auth/host.rb
 - lib/better_auth/instrumentation.rb