prefixed_ids 1.2.1 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e542fdd356a7d0a1ccc8ad8ca90cc2d218dd4d22e01b2cd82c07ab9e36c52141
-  data.tar.gz: 9c788fc9bf605656ddcfc1c3c3c854eb9fbef1068b1e9b963b6dfa4f6bb72cbe
+  metadata.gz: e306f564334470e61f4181b498ace781d12d7d06d1763dfa72a1b8a5f464ecaf
+  data.tar.gz: 79118c8868ffd9244eccc1929aef505c73d79d85df8de9e1a3a07b07225e4c1a
 SHA512:
-  metadata.gz: 933bfccd3abb8e3f1c1dd4df15a4babe8e530fce7c3afab6e998db177c61e433fca20bafb8849b73795a961977e4a8e23fd9580f2aec80c8fc868e063e1275f2
-  data.tar.gz: d1c9e97f317478f2d2f2b4d63f3f5606f5d5eb9c16548d9404bd62c984c40d4bae4db6e544ac73917a8795a82f72e1625825741f5b502650f05979e406a9b3b6
+  metadata.gz: 66299e3e87f3495ddc7cb973da3cfa60104a6b1d0418f1a9c66e5ae9a2c0311689fa40aa0376e239ac8489a034a2b9fcb503e5aa11def29d818660615fbed958
+  data.tar.gz: 13f65f23972ca2a38038f00007802ce4d65b163e15b990b15d4b1fdb8f9421d032167722bf181810cfaa281527b321cd4fec0317855f68ca8726aad8461e3244

data/README.md

@@ -34,7 +34,23 @@ end
 
 This will generate a value like `user_1234abcd`.
 
-To query using the prefixed ID, simply you can use either `find` or `find_by_prefixed_id`:
+##### Prefix ID Param
+
+To retrieve the prefix ID, simply call:
+
+```ruby
+User.to_param
+```
+
+If `to_param` override is disabled:
+
+```ruby
+User.prefix_id
+```
+
+##### Query by Prefixed ID
+
+To query using the prefixed ID, you can use either `find` or `find_by_prefix_id`:
 
 ```ruby
 User.find("user_5vJjbzXq9KrLEMm32iAnOP0xGDYk6dpe")
@@ -51,7 +67,26 @@ class User < ApplicationRecord
 end
 ```
 
-### Generic lookup
+##### Salt
+
+A salt is a secret value that makes it impossible to reverse engineer IDs. We recommend adding a salt to make your Prefix IDs unguessable.
+
+###### Global Salt
+
+```ruby
+# config/initializers/prefixed_ids.rb
+PrefixID.salt = "salt"
+```
+
+###### Per Model Salt
+
+```ruby
+class User
+  has_prefix_id :user, salt: "usersalt"
+end
+```
+
+### Generic Lookup By Prefix ID
 
 Imagine you have a prefixed ID but you don't know which model it belongs to.
 
@@ -62,13 +97,13 @@ PrefixedIds.find("acct_2iAnOP0xGDYk6dpe")
 #=> #<Account>
 ```
 
-### Customizing
+### Customizing Prefix IDs
 
 You can customize the prefix, length, and attribute name for PrefixedIds.
 
 ```ruby
 class Account < ApplicationRecord
-  has_prefix_id :acct, minimum_length: 32, override_find: false, to_param: false
+  has_prefix_id :acct, minimum_length: 32, override_find: false, to_param: false, salt: ""
 end
 ```
 

data/lib/prefixed_ids/prefix_id.rb

@@ -4,10 +4,10 @@ module PrefixedIds
 
     TOKEN = 123
 
-    def initialize(model, prefix, minimum_length: PrefixedIds.minimum_length, alphabet: PrefixedIds.alphabet, delimiter: PrefixedIds.delimiter, **options)
+    def initialize(model, prefix, salt: PrefixedIds.salt, minimum_length: PrefixedIds.minimum_length, alphabet: PrefixedIds.alphabet, delimiter: PrefixedIds.delimiter, **options)
       @prefix = prefix.to_s
       @delimiter = delimiter.to_s
-      @hashids = Hashids.new(model.table_name, minimum_length, alphabet)
+      @hashids = Hashids.new("#{model.table_name}#{salt}", minimum_length, alphabet)
     end
 
     def encode(id)

data/lib/prefixed_ids/version.rb

@@ -1,3 +1,3 @@
 module PrefixedIds
-  VERSION = "1.2.1"
+  VERSION = "1.3.0"
 end

data/lib/prefixed_ids.rb

@@ -11,6 +11,7 @@ module PrefixedIds
   mattr_accessor :delimiter, default: "_"
   mattr_accessor :alphabet, default: "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890"
   mattr_accessor :minimum_length, default: 24
+  mattr_accessor :salt, default: ""
 
   mattr_accessor :models, default: {}
 
@@ -74,6 +75,16 @@ module PrefixedIds
       def find(*ids)
         super(*ids.map { |id| _prefix_id.decode(id, fallback: true) })
       end
+
+      def relation
+        super.tap { |r| r.extend ClassMethods }
+      end
+
+      def has_many(*args, &block)
+        options = args.extract_options!
+        options[:extend] = Array(options[:extend]).push(ClassMethods)
+        super(*args, **options, &block)
+      end
     end
   end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: prefixed_ids
 version: !ruby/object:Gem::Version
-  version: 1.2.1
+  version: 1.3.0
 platform: ruby
 authors:
 - Chris Oliver
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-04-23 00:00:00.000000000 Z
+date: 2022-10-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -45,7 +45,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 2.0.0
 - !ruby/object:Gem::Dependency
-  name: standardrb
+  name: standard
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -86,7 +86,6 @@ files:
 - lib/prefixed_ids/engine.rb
 - lib/prefixed_ids/prefix_id.rb
 - lib/prefixed_ids/version.rb
-- lib/tasks/prefixed_ids_tasks.rake
 homepage: https://github.com/excid3/prefixed_ids
 licenses:
 - MIT
@@ -109,7 +108,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.3
+rubygems_version: 3.3.7
 signing_key:
 specification_version: 4
 summary: Prefixed IDs generates IDs with friendly prefixes for your models

data/lib/tasks/prefixed_ids_tasks.rake

@@ -1,4 +0,0 @@
-# desc "Explaining what the task does"
-# task :prefixed_ids do
-#   # Task goes here
-# end