better_auth-redis-storage 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: fec3e6f91d2678257084d87d27d230b401dde8dc9c4d852e47d5a0bc5c910de8
+  data.tar.gz: 5eee5736114ba877ba5e7308ba5da7d400a08686b9b46d01a98e57fda4bb24cc
+SHA512:
+  metadata.gz: 3890b8e529be3471125825d684da70a0280988c6c554683bfbabba6cc26612ca0d3508377ae49592c323101b2f52feb363807e996236b2c2a76640a949253226
+  data.tar.gz: bf77b96b0f29ad9c86a4ae11fc00c92a6a6a9f28aa8e02d233c4ae38a39285a63bd126b90c1b41dadc4490f993fdc88f1d0829e8b5af8fa27cff157d5f8e56fe

data/CHANGELOG.md

@@ -0,0 +1,6 @@
+# Changelog
+
+## 0.1.0
+
+- Initial Redis secondary storage package for Better Auth Ruby.
+

data/README.md

@@ -0,0 +1,31 @@
+# better_auth-redis-storage
+
+Redis secondary storage package for Better Auth Ruby.
+
+## Installation
+
+Add the gem and require the package before configuring auth:
+
+```ruby
+gem "better_auth-redis-storage"
+```
+
+```ruby
+require "redis"
+require "better_auth/redis_storage"
+
+redis = Redis.new(url: ENV.fetch("REDIS_URL"))
+
+auth = BetterAuth.auth(
+  secret: ENV.fetch("BETTER_AUTH_SECRET"),
+  database: :memory,
+  secondary_storage: BetterAuth::RedisStorage.new(client: redis)
+)
+```
+
+## Notes
+
+This package depends on the official `redis` gem. Keeping Redis storage outside `better_auth` avoids installing Redis client dependencies for applications that do not use secondary storage.
+
+`secondary_storage` is used by Better Auth for session payload storage, active-session indexes, and rate limiting when `rate_limit: { storage: "secondary-storage" }` is configured.
+

data/lib/better_auth/redis_storage/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module BetterAuth
+  class RedisStorage
+    VERSION = "0.1.0"
+  end
+end

data/lib/better_auth/redis_storage.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require "better_auth"
+require_relative "redis_storage/version"
+
+module BetterAuth
+  class RedisStorage
+    DEFAULT_KEY_PREFIX = "better-auth:"
+
+    attr_reader :client, :key_prefix
+
+    def self.build(client:, key_prefix: DEFAULT_KEY_PREFIX)
+      new(client: client, key_prefix: key_prefix)
+    end
+
+    def initialize(client:, key_prefix: DEFAULT_KEY_PREFIX)
+      @client = client
+      @key_prefix = key_prefix.to_s
+    end
+
+    def get(key)
+      client.get(prefix_key(key))
+    end
+
+    def set(key, value, ttl = nil)
+      prefixed_key = prefix_key(key)
+      if ttl&.to_i&.positive?
+        client.setex(prefixed_key, ttl.to_i, value)
+      else
+        client.set(prefixed_key, value)
+      end
+    end
+
+    def delete(key)
+      client.del(prefix_key(key))
+    end
+
+    def list_keys
+      client.keys("#{key_prefix}*").map { |key| unprefix_key(key) }
+    end
+
+    def clear
+      keys = client.keys("#{key_prefix}*")
+      client.del(*keys) unless keys.empty?
+    end
+
+    alias_method :listKeys, :list_keys
+
+    private
+
+    def prefix_key(key)
+      "#{key_prefix}#{key}"
+    end
+
+    def unprefix_key(key)
+      key.sub(/\A#{Regexp.escape(key_prefix)}/, "")
+    end
+  end
+end

metadata

@@ -0,0 +1,139 @@
+--- !ruby/object:Gem::Specification
+name: better_auth-redis-storage
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Sebastian Sala
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: better_auth
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: redis
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '6'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.25'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.25'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.2'
+- !ruby/object:Gem::Dependency
+  name: standardrb
+  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: Adds a Redis-backed secondary storage adapter for Better Auth Ruby sessions
+  and rate limiting.
+email:
+- sebastian.sala.tech@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- README.md
+- lib/better_auth/redis_storage.rb
+- lib/better_auth/redis_storage/version.rb
+homepage: https://github.com/sebasxsala/better-auth
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/sebasxsala/better-auth
+  source_code_uri: https://github.com/sebasxsala/better-auth
+  changelog_uri: https://github.com/sebasxsala/better-auth/blob/main/packages/better_auth-redis-storage/CHANGELOG.md
+  bug_tracker_uri: https://github.com/sebasxsala/better-auth/issues
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Redis secondary storage package for Better Auth Ruby
+test_files: []