add #timestamp to TypeID::UUID (#12)

* add `#timestamp` to `TypeID::UUID`

* bump minor version

Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
  remote: .
  specs:
- typeid (0.2.0)
+ typeid (0.2.1)
  uuid7 (~> 0.2.0)
 
 GEM

lib/typeid/uuid.rb

@@ -53,11 +53,22 @@ def initialize(bytes)
  super(string)
  end
 
+ # Returns the +UUID+ encoded as a base32 +String+.
+ #
  # @return [String]
  def base32
  TypeID::UUID::Base32.encode(bytes)
  end
 
+ # Returns the timestamp of the +UUID+ as milliseconds since the Unix epoch.
+ #
+ # @return [Integer]
+ def timestamp
+ bytes[0..5]
+ .map.with_index { |byte, index| byte << (5 - index) * 8 }
+ .inject(:|)
+ end
+
  # @return [String]
  def inspect
  "#<#{self.class.name} #{to_s}>"

lib/typeid/version.rb

@@ -1,3 +1,3 @@
 class TypeID < String
- VERSION = "0.2.0".freeze
+ VERSION = "0.2.1".freeze
 end

spec/lib/typeid/uuid_spec.rb

@@ -28,4 +28,10 @@
 
  it { is_expected.to eq base32 }
  end
+
+ describe "#timestamp" do
+ subject(:timestamp) { uuid.timestamp }
+
+ it { is_expected.to eq 1686760803066 }
+ end
 end