ask-tokens-rails 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9f36ea3ade0e11cbb7a52d00ae56f1168574ce7a559ce8995cc6ca43d6716de8
-  data.tar.gz: c5b9d81ebc12fe4a51080cd773d8728dad5eb75ffbd50f15329623083ba8dcf9
+  metadata.gz: fdcad46d2110412eb3a63e42de467fe7b2017dd0bcf84e821376889ce211fc2f
+  data.tar.gz: 5b2e076d4a745e5f142596c7176f5a7018d4d0a4992535bca90854dab00ee8fd
 SHA512:
-  metadata.gz: 48e3aaefc5ac428854b2c998fe9f4c66f9bd0b78483184ef17ac43494ddd52c77f0dc2939c4bdab114f14222bc208a5174536212c027b90417d3d77f8373e3a4
-  data.tar.gz: 29dff0d60146f50f546f20be6643e8c8bd938c671a9d74f238c84f030af048ca07558fd5154e63d44641111352496382f7db00ea379554d29ecf5e1baafb8bb5
+  metadata.gz: 766ea99978a9c0349aa14d1a43862207524c1d3e1283aaad37bc5763b675513949b0944d3ba477a84b07ff72cedd28a3cb231a9856e6cf0671203527e586806b
+  data.tar.gz: fc318decca8131817e478b3f6ff0f7773d7c7e6bb6ad08f2ac3f356da265a671f12d090c3d646a68795f9afb7fa7cfb73136d033dcf92ca6be3096edb3985545

data/CHANGELOG.md

@@ -1,3 +1,51 @@
+## [0.3.0] — 2026-09-14
+
+### Changed
+
+
+
+- **Default table names are now gem-prefixed: `ask_tokens_wallets` and
+
+  `ask_tokens_transactions`.** They can no longer collide with an app's own
+
+  ledger, so no app configuration is needed. To keep the old names (or adopt
+
+  existing tables), configure them:
+
+
+
+  ```ruby
+
+  Ask::Tokens::Rails.configure do |config|
+
+    config.wallets_table = "token_wallets"
+
+    config.transactions_table = "token_transactions"
+
+  end
+
+  ```
+
+
+
+  Existing installs must either set the configuration above or rename their
+
+  tables in a migration.
+
+
+
+### Added
+
+
+
+- `Ask::Tokens::Rails.configure` and `reset_config!` — configurable wallet
+
+  and transaction table names, honoured by the models and the install
+
+  generator.
+
+
+
 # Changelog
 
 ## [0.1.0] - 2026-08-19

data/lib/ask/tokens/rails/configuration.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Ask
+  module Tokens
+    module Rails
+      # Table names are prefixed with the gem's name by default, so they can
+      # never collide with an app's own ledger — no configuration needed.
+      # Override only to adopt existing tables:
+      #
+      #   Ask::Tokens::Rails.configure do |config|
+      #     config.wallets_table = "token_wallets"
+      #     config.transactions_table = "token_transactions"
+      #   end
+      class Configuration
+        attr_accessor :wallets_table, :transactions_table
+
+        def initialize
+          @wallets_table = "ask_tokens_wallets"
+          @transactions_table = "ask_tokens_transactions"
+        end
+      end
+
+      class << self
+        def config
+          @config ||= Configuration.new
+        end
+
+        def configure
+          yield config
+        end
+
+        def reset_config!
+          @config = Configuration.new
+        end
+      end
+    end
+  end
+end

data/lib/ask/tokens/rails/models/token_transaction.rb

@@ -1,13 +1,16 @@
 # frozen_string_literal: true
 
 require "active_record"
+require_relative "../configuration"
 
 module Ask
   module Tokens
     # Append-only ledger row. Every grant, debit, adjustment, or expiry is
     # written here as an immutable record. Never updated or deleted.
     class TokenTransaction < ::ActiveRecord::Base
-      self.table_name = "token_transactions"
+      def self.table_name
+        Ask::Tokens::Rails.config.transactions_table
+      end
 
       belongs_to :token_wallet, class_name: "Ask::Tokens::TokenWallet",
                                 foreign_key: :token_wallet_id,

data/lib/ask/tokens/rails/models/token_wallet.rb

@@ -1,12 +1,15 @@
 # frozen_string_literal: true
 
 require "active_record"
+require_relative "../configuration"
 
 module Ask
   module Tokens
     # Polymorphic wallet record. One per owner. Holds the cached balance.
     class TokenWallet < ::ActiveRecord::Base
-      self.table_name = "token_wallets"
+      def self.table_name
+        Ask::Tokens::Rails.config.wallets_table
+      end
 
       has_many :token_transactions, class_name: "Ask::Tokens::TokenTransaction",
                                    foreign_key: :token_wallet_id,

data/lib/ask/tokens/rails/version.rb

@@ -3,7 +3,7 @@
 module Ask
   module Tokens
     module Rails
-      VERSION = "0.2.1"
+      VERSION = "0.3.0"
     end
   end
 end

data/lib/ask-tokens-rails.rb

@@ -2,4 +2,5 @@
 
 require "ask-tokens"
 require "ask/tokens/rails/version"
+require "ask/tokens/rails/configuration"
 require "ask/tokens/rails/railtie"

data/lib/generators/ask_tokens/install/install_generator.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require "ask-tokens-rails"
 require "rails/generators"
 require "rails/generators/migration"
 

data/lib/generators/ask_tokens/install/templates/migration.rb

@@ -1,16 +1,17 @@
 # frozen_string_literal: true
 
-class CreateTokenWallets < ActiveRecord::Migration[7.0]
+class CreateAskTokensTables < ActiveRecord::Migration[7.0]
   def change
-    create_table :token_wallets do |t|
+    create_table :<%= Ask::Tokens::Rails.config.wallets_table %> do |t|
       t.references :owner, polymorphic: true, null: false
       t.bigint :balance, null: false, default: 0
       t.timestamps
     end
-    add_index :token_wallets, %i[owner_type owner_id], unique: true, name: "idx_token_wallets_owner"
+    add_index :<%= Ask::Tokens::Rails.config.wallets_table %>, %i[owner_type owner_id], unique: true,
+      name: "idx_<%= Ask::Tokens::Rails.config.wallets_table %>_owner"
 
-    create_table :token_transactions do |t|
-      t.references :token_wallet, null: false, foreign_key: true
+    create_table :<%= Ask::Tokens::Rails.config.transactions_table %> do |t|
+      t.references :token_wallet, null: false, foreign_key: {to_table: Ask::Tokens::Rails.config.wallets_table}
       t.string :entry_type, null: false
       t.bigint :amount, null: false
       t.string :reason, null: false
@@ -19,7 +20,7 @@ class CreateTokenWallets < ActiveRecord::Migration[7.0]
       t.datetime :expires_at
       t.datetime :created_at, null: false
     end
-    add_index :token_transactions, %i[token_wallet_id created_at]
-    add_index :token_transactions, :entry_type
+    add_index :<%= Ask::Tokens::Rails.config.transactions_table %>, %i[token_wallet_id created_at]
+    add_index :<%= Ask::Tokens::Rails.config.transactions_table %>, :entry_type
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ask-tokens-rails
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 platform: ruby
 authors:
 - Kaka Ruto
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.2.0
+        version: 0.2.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.2.0
+        version: 0.2.1
 - !ruby/object:Gem::Dependency
   name: rails
   requirement: !ruby/object:Gem::Requirement
@@ -93,6 +93,7 @@ files:
 - README.md
 - lib/ask-tokens-rails.rb
 - lib/ask/tokens/rails/concerns/has_token_wallet.rb
+- lib/ask/tokens/rails/configuration.rb
 - lib/ask/tokens/rails/jobs/sweep_expired_tokens_job.rb
 - lib/ask/tokens/rails/models/token_transaction.rb
 - lib/ask/tokens/rails/models/token_wallet.rb