snowflaked 0.1.4-arm-linux → 0.3.0-arm-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 02505dc9096e0536b671ea27d47019678c91b8bb1a7ac41e571bb846c68e0108
-  data.tar.gz: 59e5c3bb9f89acb5e8eb4357349e664c956acdf4f43e559a3319b942f8d816e2
+  metadata.gz: ba6a514d46f61318ebb15ab41f1101e0532529da168147a822e08059c7750dca
+  data.tar.gz: 74255dfc057ab92d9b8f7173a1bcf95fedd55899343a34ba2cb9f36a0eda87b7
 SHA512:
-  metadata.gz: 589c7986aa58bba1ddc7c56e3336a4ba591d3e42aa579318381dca3a1dcfc89317f91d62a2e5e9c364e68988f8294de4ff42d362619933d10404944e518f6594
-  data.tar.gz: 277759aeef5df7954f5394b6d12e1b48b1074c1d2e63243bf7a1f3e856eb10484b548cabd4e630cadd07b7f53d8dd6552b047803ee2300e5647cde27126eec1a
+  metadata.gz: 912bab31c7cb549f1e5b159a8a6a84c063609941b3e1971a1b57cb001dbe7cb261e07d62d73b05833797daa3abe94f290b99f8ab5024d10a869d314421687296
+  data.tar.gz: ac385f10e3b951410dfd69f113c209e246019735deda89e9b198d7181f2cd2bde9eef6908a78861ca8d1aea53f58907929c788d48c6fefa8dc2c80b7b5745bee

data/README.md

@@ -83,14 +83,16 @@ end
 ```ruby
 Snowflaked.configure do |config|
   config.machine_id = 42
-  config.epoch = Time.utc(1989, 1, 3) # When not configured, the epoch is set to the Unix epoch (January 1, 1970)
+  config.epoch = Time.utc(1989, 1, 3) # Defaults to DEFAULT_EPOCH (2024-01-01) if not configured
 end
 ```
 
+Configuration is locked after `Snowflaked.configure` or the first generated/parsed ID. Set it during application boot, before request threads start.
+
 ### Machine ID
 
 > [!TIP]
-> For multi-process servers like Puma, it is recommended to **not** configure `machine_id` explicitly. The gem automatically calculates a unique machine ID using `(hostname.hash ^ pid) % 1024`, which ensures each forked worker process gets a different ID and avoids duplicate Snowflake IDs.
+> For multi-process servers like Puma, it is recommended to **not** configure `machine_id` explicitly. The gem automatically calculates a process-local machine ID using `(hostname.hash ^ pid) % 1024`, so forked workers do not reuse the parent's cached machine ID.
 
 If you must set `machine_id` explicitly, use environment variables that differ per worker process.
 
@@ -102,14 +104,12 @@ If `machine_id` is not explicitly configured, it resolves in this order:
 2. `MACHINE_ID` environment variable
 3. Auto-detected using the following formula: `(hostname.hash ^ pid) % 1024`
 
-For Kubernetes deployments, you can set the machine ID using an environment variable:
+For Kubernetes deployments, set the machine ID to a numeric value between `0` and `1023`:
 
 ```yaml
 env:
   - name: SNOWFLAKED_MACHINE_ID
-    valueFrom:
-      fieldRef:
-        fieldPath: metadata.name
+    value: "42"
 ```
 
 Or use a StatefulSet ordinal for guaranteed unique values:
@@ -145,15 +145,14 @@ Snowflaked.machine_id(id)
 
 ## Benchmarks
 
-See [BENCHMARKS.md](benchmarks/BENCHMARKS.md) for more details.
+See [BENCHMARKS.md](benchmarks/README.md) for more details.
 
 tl;dr: Snowflake IDs have a negligible performance impact compared to database-backed IDs.
 
 ## Requirements
 
-- Ruby >= 3.2
-- rustc >= 1.81.0
-- cargo >= 1.81.0
+- Ruby >= 3.3
+- rustc / cargo >= 1.81.0 (development uses the toolchain pinned in `mise.toml`)
 - Mise
 
 ## Development

data/lib/snowflaked/model_extensions.rb

@@ -6,7 +6,7 @@ module Snowflaked
 
     included do
       class_attribute :_snowflake_attributes, instance_writer: false, default: [:id]
-      after_initialize :_generate_snowflake_ids, if: :new_record?
+      before_validation :_generate_snowflake_ids, on: :create
     end
 
     class_methods do
@@ -20,14 +20,14 @@ module Snowflaked
       def _snowflake_columns_from_comments
         return @_snowflake_columns_from_comments if defined?(@_snowflake_columns_from_comments)
 
-        @_snowflake_columns_from_comments = if table_exists?
-          columns.filter_map { |col| col.name.to_sym if col.comment == Snowflaked::SchemaDefinitions::COMMENT }
-        else
-          []
-        end
+        return [] unless table_exists?
+
+        @_snowflake_columns_from_comments = columns.filter_map { |col| col.name.to_sym if col.comment == Snowflaked::SchemaDefinitions::COMMENT }
       end
 
       def _snowflake_attributes_with_columns
+        return _snowflake_attributes unless table_exists?
+
         @_snowflake_attributes_with_columns ||= (_snowflake_attributes | _snowflake_columns_from_comments)
       end
     end
@@ -35,10 +35,10 @@ module Snowflaked
     private
 
     def _generate_snowflake_ids
-      attributes_to_generate = self.class._snowflake_attributes_with_columns
-      return if attributes_to_generate.empty?
+      attributes = self.class._snowflake_attributes_with_columns
+      return if attributes.empty?
 
-      attributes_to_generate.each do |attribute|
+      attributes.each do |attribute|
         next if self[attribute].present?
 
         self[attribute] = Snowflaked.id

data/lib/snowflaked/railtie.rb

@@ -42,10 +42,9 @@ module Snowflaked
     end
 
     initializer "snowflaked.model_extensions", after: "active_record.initialize_database" do
-      ActiveSupport.on_load(:active_record) do
-        require "snowflaked/model_extensions"
-        ActiveRecord::Base.include(Snowflaked::ModelExtensions)
-      end
+      require "snowflaked/model_extensions"
+
+      ActiveSupport.on_load(:active_record) { include Snowflaked::ModelExtensions }
     end
   end
 end

data/lib/snowflaked/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Snowflaked
-  VERSION = "0.1.4"
+  VERSION = "0.3.0"
 end

data/lib/snowflaked.rb

@@ -16,42 +16,81 @@ require_relative "snowflaked/railtie" if defined?(Rails::Railtie)
 
 module Snowflaked
   MAX_MACHINE_ID = 1023
+  DEFAULT_EPOCH = Time.utc(2024, 1, 1).freeze
 
   class Error < StandardError; end
   class ConfigurationError < Error; end
 
   class Configuration
-    attr_accessor :machine_id, :epoch
+    attr_reader :machine_id, :epoch
 
     def initialize
       @machine_id = nil
-      @epoch      = nil
+      @epoch      = DEFAULT_EPOCH
+      @sealed     = false
+    end
+
+    def machine_id=(value)
+      raise_if_sealed!(:machine_id)
+
+      @machine_id           = value.nil? ? nil : checked_machine_id(value)
+      @machine_id_value     = nil
+      @machine_id_value_pid = nil
+    end
+
+    def epoch=(value)
+      raise_if_sealed!(:epoch)
+
+      @epoch    = value
+      @epoch_ms = nil
+    end
+
+    def seal!
+      @sealed = true
     end
 
     def machine_id_value
-      id = @machine_id || default_machine_id
-      id % (MAX_MACHINE_ID + 1)
+      if @machine_id_value_pid != Process.pid
+        @machine_id_value     = resolve_machine_id
+        @machine_id_value_pid = Process.pid
+      end
+
+      @machine_id_value
     end
 
     def epoch_ms
       return nil unless @epoch
 
-      (@epoch.to_f * 1000).to_i
+      @epoch_ms ||= (@epoch.to_r * 1000).to_i
     end
 
     private
 
-    def default_machine_id
-      env_machine_id || hostname_pid_hash
+    # Resolution order: explicit config, then env vars, then an auto fallback.
+    # Explicit and env values are range-checked; the fallback is always valid.
+    def resolve_machine_id
+      return @machine_id unless @machine_id.nil?
+
+      env = ENV["SNOWFLAKED_MACHINE_ID"] || ENV.fetch("MACHINE_ID", nil)
+      return checked_machine_id(env) if env
+
+      # Unique-enough per process without coordination: varies by host and by
+      # pid, so forked workers each get a different id. % keeps it in range.
+      (Socket.gethostname.hash ^ Process.pid) % (MAX_MACHINE_ID + 1)
     end
 
-    def env_machine_id
-      id = ENV["SNOWFLAKED_MACHINE_ID"] || ENV.fetch("MACHINE_ID", nil)
-      id&.to_i
+    # Coerce to Integer and ensure it fits in 0..MAX_MACHINE_ID, else raise.
+    def checked_machine_id(value)
+      id = Integer(value, exception: false)
+      return id if id&.between?(0, MAX_MACHINE_ID)
+
+      raise ConfigurationError, "machine_id must be an integer between 0 and #{MAX_MACHINE_ID}, got #{value.inspect}"
     end
 
-    def hostname_pid_hash
-      (Socket.gethostname.hash ^ Process.pid) % (MAX_MACHINE_ID + 1)
+    def raise_if_sealed!(attribute)
+      return unless @sealed
+
+      raise ConfigurationError, "#{attribute} cannot be changed after Snowflaked has been configured"
     end
   end
 
@@ -78,30 +117,39 @@ module Snowflaked
     end
 
     def timestamp(id)
-      time_ms = Native.timestamp_ms(id)
-      Time.at(time_ms / 1000, (time_ms % 1000) * 1000, :usec)
+      ensure_initialized!
+      seconds, milliseconds = Native.timestamp_ms(id).divmod(1000)
+
+      if defined?(Time.zone) && Time.zone
+        Time.zone.at(seconds, milliseconds * 1000, :usec)
+      else
+        Time.at(seconds, milliseconds * 1000, :usec).utc
+      end
     end
 
-    def machine_id(id)
-      ensure_initialized!
+    def machine_id(id) # rubocop:disable Rails/Delegate
       Native.machine_id(id)
     end
 
     def timestamp_ms(id)
+      ensure_initialized!
       Native.timestamp_ms(id)
     end
 
-    def sequence(id)
+    def sequence(id) # rubocop:disable Rails/Delegate
       Native.sequence(id)
     end
 
     private
 
     def ensure_initialized!
-      return if Native.initialized?
+      return if @native_initialized_pid == Process.pid
 
       config = configuration
+      config.seal!
+
       Native.init_generator(config.machine_id_value, config.epoch_ms)
+      @native_initialized_pid = Process.pid
     end
   end
 end

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: snowflaked
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.3.0
 platform: arm-linux
 authors:
 - Luiz Eduardo Kowalski
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-01-14 00:00:00.000000000 Z
-dependencies: []
+date: 2026-07-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.0'
 description: A Ruby gem for generating Twitter Snowflake IDs using a high-performance
   Rust backend. Thread-safe with configurable machine ID and custom epoch support.
 email: 
@@ -20,7 +34,6 @@ files:
 - LICENSE.txt
 - README.md
 - lib/snowflaked.rb
-- lib/snowflaked/3.2/snowflaked.so
 - lib/snowflaked/3.3/snowflaked.so
 - lib/snowflaked/3.4/snowflaked.so
 - lib/snowflaked/4.0/snowflaked.so
@@ -47,7 +60,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.2'
+      version: '3.3'
   - - "<"
     - !ruby/object:Gem::Version
       version: 4.1.dev