confeature 0.0.0 → 0.1.0

data/lib/confeature/user.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+# SPDX-License-Identifier: MIT
+
+module Confeature
+  # Targeting context for flag evaluation.
+  #
+  # Field names mirror the upstream `configcat` gem's `User` 1:1
+  # (Constitution Principle II). The evaluator consumes `identifier`,
+  # `email`, `country`, and typed `custom` attributes.
+  #
+  # `custom` accepts TYPED values, matching the upstream `configcat`
+  # gem's `User` (which stores `custom` verbatim — no stringification).
+  # A value may be a `String`, `Integer`, `Float`, `Time`/`DateTime`,
+  # `true`/`false`, or `Array<String>`. The evaluator converts each
+  # non-string value per ConfigCat's documented comparator semantics
+  # (number → invariant decimal string, date → Unix epoch seconds,
+  # string array → JSON). Keys are coerced to `String`; values pass
+  # through verbatim so the evaluator can apply type-specific
+  # conversions (string values behave byte-identically to before).
+  class User
+    attr_reader :identifier, :email, :country, :custom
+
+    # @param identifier [String] Stable user identifier (required, empty allowed).
+    # @param email [String, nil] Optional contact email.
+    # @param country [String, nil] Optional ISO country code or country tag.
+    # @param custom [Hash{String => Object}, nil] Optional map of typed custom
+    #   attributes (String / Integer / Float / Time / DateTime / boolean /
+    #   Array<String>). Values are NOT stringified — they pass through verbatim
+    #   to the evaluator (matches the upstream `configcat` gem 1:1).
+    def initialize(identifier:, email: nil, country: nil, custom: nil)
+      @identifier = identifier
+      @email = email
+      @country = country
+      @custom = custom.nil? ? nil : custom.transform_keys(&:to_s).freeze
+      freeze
+    end
+
+    def ==(other)
+      other.is_a?(User) &&
+        identifier == other.identifier &&
+        email == other.email &&
+        country == other.country &&
+        custom == other.custom
+    end
+    alias eql? ==
+
+    def hash
+      [identifier, email, country, custom].hash
+    end
+  end
+end

data/lib/confeature/version.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+# SPDX-License-Identifier: MIT
+
+module Confeature
+  # Public SDK version, surfaced as both `Confeature::VERSION` and the
+  # `version` field on the gemspec. The major version tracks the
+  # Confeature API contract major version this SDK implements
+  # (Constitution Principle VI).
+  VERSION = "0.1.0"
+end

data/lib/confeature.rb

@@ -1 +1,39 @@
-# Placeholder: the Confeature Ruby SDK is not released yet.
+# frozen_string_literal: true
+
+# SPDX-License-Identifier: MIT
+
+# Top-level barrel for the Confeature Ruby SDK.
+#
+# The public API surface mirrors the upstream `configcat` gem 1:1
+# (Constitution Principle II): a customer that already uses ConfigCat
+# in Ruby can migrate by changing the require name and the SDK key
+# value.
+
+require_relative "confeature/version"
+require_relative "confeature/user"
+require_relative "confeature/log_level"
+require_relative "confeature/logger"
+require_relative "confeature/polling_mode"
+require_relative "confeature/flag_overrides"
+require_relative "confeature/evaluation_details"
+require_relative "confeature/snapshot"
+require_relative "confeature/client"
+
+# Re-export internal SDK-key helpers at the top level for unit tests
+# and parity-corpus verification. These live under `Confeature::` and
+# delegate to `Confeature::Internal::SdkKey`.
+require_relative "confeature/internal/sdk_key"
+
+module Confeature
+  def self.derive_cache_key(sdk_key)
+    Internal::SdkKey.derive_cache_key(sdk_key)
+  end
+
+  def self.redact_sdk_key(sdk_key)
+    Internal::SdkKey.redact(sdk_key)
+  end
+
+  def self.valid_confeature_key_format?(sdk_key)
+    Internal::SdkKey.valid_confeature_key_format?(sdk_key)
+  end
+end

metadata

@@ -1,15 +1,50 @@
 --- !ruby/object:Gem::Specification
 name: confeature
 version: !ruby/object:Gem::Version
-  version: 0.0.0
+  version: 0.1.0
 platform: ruby
 authors:
 - MakerLabs
+autorequire:
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
-dependencies: []
-description: The first real release is coming; do not depend on 0.0.0.
+date: 2026-10-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.6'
+description: |
+  Confeature is an open-source feature-flag service that mirrors the ConfigCat
+  API surface 1:1 (Constitution Principle II). The `confeature` gem is the
+  Ruby SDK: same public class names, same option keywords, same polling
+  modes, same flag-override semantics as `configcat`. Migrate by renaming the
+  gem and swapping the SDK key.
+email:
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -17,12 +52,39 @@ files:
 - LICENSE
 - README.md
 - lib/confeature.rb
+- lib/confeature/client.rb
+- lib/confeature/evaluation_details.rb
+- lib/confeature/flag_overrides.rb
+- lib/confeature/hooks.rb
+- lib/confeature/internal/cache.rb
+- lib/confeature/internal/comparators.rb
+- lib/confeature/internal/config_fetcher.rb
+- lib/confeature/internal/eval_log.rb
+- lib/confeature/internal/eval_logger.rb
+- lib/confeature/internal/evaluator.rb
+- lib/confeature/internal/hashing.rb
+- lib/confeature/internal/override_eval.rb
+- lib/confeature/internal/poll_service.rb
+- lib/confeature/internal/prerequisites.rb
+- lib/confeature/internal/sdk_key.rb
+- lib/confeature/internal/segments.rb
+- lib/confeature/internal/semver.rb
+- lib/confeature/log_level.rb
+- lib/confeature/logger.rb
+- lib/confeature/polling_mode.rb
+- lib/confeature/snapshot.rb
+- lib/confeature/user.rb
+- lib/confeature/version.rb
 homepage: https://confeature.io
 licenses:
 - MIT
 metadata:
+  homepage_uri: https://confeature.io
   source_code_uri: https://github.com/confeature/sdks
+  bug_tracker_uri: https://github.com/confeature/sdks/issues
+  documentation_uri: https://docs.confeature.io/sdks/ruby/
   rubygems_mfa_required: 'true'
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -30,14 +92,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.7'
+      version: '3.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.11
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
-summary: Name reserved for the Confeature Ruby SDK (ConfigCat-compatible).
+summary: Ruby SDK for Confeature — drop-in compatible with ConfigCat's configcat gem.
 test_files: []