Method: EncodedToken::Decoder#decode!

Defined in:

lib/encoded_token/decoder.rb

#decode!(token) ⇒ Object

Decode a previously encoded token to return the original ID

args:

• token [String]

returns:

• a String with the original ID

on error:

• an invalid String token returns nil

• otherwise an exception will be raised

examples:

EncodedToken.decode!("KY3bnaRGmyy6yJS3imWr1dcWtzDYvZjpIAYyCUo5PEKPFvQgtTTed")
#=> "12345"

EncodedToken.decode!("3gDwO7r4UJYeBYDBLU94MqjZQm0SToSE29ACDNcw0xf4QusZKxQHJ")
#=> "12345"

EncodedToken.decode!("pAi1SmpKgFAchh76EoLbYLeXVQmLwmMlH2v1zDVeufioKGr0709Qw")
#=> "468a5eeb-0cda-4c99-8dba-6a96c33003e0"

EncodedToken.decode!("abcdefghijklmnopqrstuvwxyz")
#=> nil

EncodedToken.decode!(:test)
#=> Token is not a string. (RuntimeError)

# File 'lib/encoded_token/decoder.rb', line 45

def decode!(token)
  assert_valid_seed!

  token = sanitize_token(token)
  id    = parse_token(token)

  # is it a UUID or numeric ID
  if valid_integer?(id) || valid_uuid_format?(id)
    return id
  else
    return nil
  end
end