prefixed_ids 1.2.2 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 38b6a59341fa7c4d02fdaba7f6eb738cdb5730a9aa6caca89ffb89bfa9dc4740
-  data.tar.gz: ae7de74cf643796ce5fdafe5e0b7d0db98cf60b761a52a960ad1122c14028b0a
+  metadata.gz: e306f564334470e61f4181b498ace781d12d7d06d1763dfa72a1b8a5f464ecaf
+  data.tar.gz: 79118c8868ffd9244eccc1929aef505c73d79d85df8de9e1a3a07b07225e4c1a
 SHA512:
-  metadata.gz: 428331d371bbcc87c9d092297b315476ccd9e62548ff59efef59cb7a3574b256247f4dacf6c1edc3c2f72e553a742033493f51587af264707a77ca3d797cea9e
-  data.tar.gz: af9b8a1f596b9b6d1720e8ec71b267421d6c0df5fd661e0b3b76765d8606bb929e5bf2a2bbe81a9fd853290e4e1a844ca7d3a63ad25001da9d9eb9beb3a98c0b
+  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.2"
+  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: {}
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: prefixed_ids
 version: !ruby/object:Gem::Version
-  version: 1.2.2
+  version: 1.3.0
 platform: ruby
 authors:
 - Chris Oliver
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-05-03 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