confeature 0.1.1 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 526cadeccff8c73783cedea06b2913852c5d3dc1def25e1849226acc810ff7c8
4
- data.tar.gz: e4d743d9078e1d9bdf06b4a758938dee26e62a147c5121abf08dde83833db062
3
+ metadata.gz: 57fa6c073285f7f43ad8a9e6f199dfa7482531d5b78e029ebd2061ca1843e9d2
4
+ data.tar.gz: ec65482ac991726d70bd1c3f9c57a191558ccc298dd92f78ccf5de17b394b09a
5
5
  SHA512:
6
- metadata.gz: 6524aa693004bb6459f5a87a2524a295b7a4c100e05a8d420570e01fa6b2853c586ca3bc2534f7216fb046a5cfa3778fc83e6ef6fe09625bc5ad3921d77eca35
7
- data.tar.gz: 2474b277f34cdeffe9554153ac44e72bf94c92b9816ce18bddb0d31e8644d6cd6c00a8dc8ea22e722de3f11e526164fd5e2a40baf5c4f3e2644a8ff5f564f863
6
+ metadata.gz: b11dde30f59288c34034559132c71f96c77e4ff17de3508b70d28ecf53f53e4846f31077d21f86c023417f23037ebb64fa6d40040110812a9b3eb8454ab20976
7
+ data.tar.gz: 4a1a975b930eae3c9e0d6176c0862300f8b3ab376288257050ac9276502458662e8282c58abaa88b904afbe54e8158ae56450bb4858c2f8559c22a0d08e109c9
@@ -10,6 +10,7 @@ require_relative "segments"
10
10
  require_relative "prerequisites"
11
11
  require_relative "eval_log"
12
12
  require_relative "eval_logger"
13
+ require_relative "provider_user"
13
14
 
14
15
  module Confeature
15
16
  module Internal
@@ -414,12 +415,8 @@ module Confeature
414
415
  end
415
416
 
416
417
  attr_name = ctx.setting["a"]
417
- if attr_name.nil?
418
- attr_name = IDENTIFIER_ATTRIBUTE
419
- attr_value = user_identifier(ctx.user)
420
- else
421
- attr_value = get_user_attribute(ctx.user, attr_name)
422
- end
418
+ attr_name = IDENTIFIER_ATTRIBUTE if attr_name.nil?
419
+ attr_value = get_user_attribute(ctx.user, attr_name)
423
420
  if attr_value.nil?
424
421
  ctx.state.eval_error ||= missing_user_attribute_error(attr_name)
425
422
  ctx.log.user_object_attribute_is_missing_for_percentage(ctx.key, attr_name)
@@ -855,7 +852,10 @@ module Confeature
855
852
 
856
853
  def user_identifier(user)
857
854
  id = user.identifier
858
- id.nil? ? "" : id
855
+ case user
856
+ when ProviderUser then id
857
+ else id.nil? ? "" : id
858
+ end
859
859
  end
860
860
 
861
861
  def boolean?(value)
@@ -31,6 +31,12 @@ module Confeature
31
31
  module_function
32
32
 
33
33
  def evaluate_sync(flag_overrides, key, default_value)
34
+ outcome = evaluate_sync_details(flag_overrides, key, default_value)
35
+ outcome.pop if outcome.length > 2
36
+ outcome
37
+ end
38
+
39
+ def evaluate_sync_details(flag_overrides, key, default_value)
34
40
  # Branch 1: no overrides configured → caller falls through.
35
41
  return [false, nil] if flag_overrides.nil?
36
42
 
@@ -51,11 +57,11 @@ module Confeature
51
57
 
52
58
  # Branch 4: key absent → return default.
53
59
  raw = overrides_map[key]
54
- return [true, default_value] if raw.nil?
60
+ return [true, default_value, "KEY_NOT_FOUND"] if raw.nil?
55
61
 
56
62
  # Branch 5: override slot empty → return default.
57
63
  candidate = raw.picked
58
- return [true, default_value] if candidate.nil?
64
+ return [true, default_value, "MALFORMED_VALUE"] if candidate.nil?
59
65
 
60
66
  # Branch 6: TYPE_MISMATCH — primitive types diverge → return default.
61
67
  # A `nil` default_value intentionally bypasses the check (matches
@@ -66,7 +72,7 @@ module Confeature
66
72
  # mismatch.
67
73
  if !default_value.nil? && !boolean_kind_match?(candidate, default_value) &&
68
74
  candidate.class != default_value.class
69
- return [true, default_value]
75
+ return [true, default_value, "TYPE_MISMATCH"]
70
76
  end
71
77
 
72
78
  # Branch 7: happy path — typed override value.
@@ -0,0 +1,64 @@
1
+ # frozen_string_literal: true
2
+
3
+ # SPDX-License-Identifier: MIT
4
+
5
+ require_relative "../evaluation_details"
6
+ require_relative "evaluator"
7
+ require_relative "override_eval"
8
+ require_relative "provider_user"
9
+
10
+ module Confeature
11
+ module Internal
12
+ module ProviderEvaluation
13
+ FLAG_TYPES = {
14
+ boolean: [TrueClass, FalseClass].freeze,
15
+ string: [String].freeze,
16
+ integer: [Integer].freeze,
17
+ float: [Float].freeze,
18
+ number: [Integer, Float].freeze
19
+ }.freeze
20
+
21
+ module_function
22
+
23
+ def evaluate(client, key, fallback, flag_type:, **attributes)
24
+ return EvaluationDetails.from_error(key, fallback, error: "TYPE_MISMATCH") unless FLAG_TYPES.key?(flag_type)
25
+
26
+ client.get_value_details(key, fallback, ProviderUser.new(flag_type: flag_type, **attributes))
27
+ rescue StandardError
28
+ # Exceptions can include caller context or transport data.
29
+ EvaluationDetails.from_error(key, fallback, error: "EVAL_EXCEPTION")
30
+ end
31
+
32
+ def resolve(key, fallback, user, config:, local_overrides:)
33
+ # Let the native evaluator determine the stored type from one read.
34
+ # OpenFeature's number method accepts both numeric types independently
35
+ # of the type of its fallback.
36
+ result =
37
+ if local_overrides.nil?
38
+ Evaluator.evaluate(config, key, nil, user)
39
+ else
40
+ resolve_override(local_overrides, key, user)
41
+ end
42
+ error = result.error || type_error(result.value, user.flag_type)
43
+ return result if error.nil?
44
+
45
+ Evaluator::EvaluationResult.new(value: fallback, error: error)
46
+ end
47
+
48
+ def resolve_override(overrides, key, user)
49
+ found, result = OverrideEval.evaluate_full_config_override_details_sync(overrides, key, nil, user)
50
+ return result if found
51
+
52
+ matched, value, error = OverrideEval.evaluate_sync_details(overrides, key, nil)
53
+ Evaluator::EvaluationResult.new(value: value, error: matched ? error : "NO_CONFIG")
54
+ end
55
+
56
+ def type_error(value, flag_type)
57
+ return "TYPE_MISMATCH" unless FLAG_TYPES.fetch(flag_type).any? { |type| value.is_a?(type) }
58
+ return "MALFORMED_VALUE" if value.is_a?(Float) && !value.finite?
59
+
60
+ nil
61
+ end
62
+ end
63
+ end
64
+ end
@@ -0,0 +1,19 @@
1
+ # frozen_string_literal: true
2
+
3
+ # SPDX-License-Identifier: MIT
4
+
5
+ require_relative "../user"
6
+
7
+ module Confeature
8
+ module Internal
9
+ # The companion supplies its own targeting context on every evaluation.
10
+ class ProviderUser < User
11
+ attr_reader :flag_type
12
+
13
+ def initialize(flag_type:, **attributes)
14
+ @flag_type = flag_type
15
+ super(**attributes)
16
+ end
17
+ end
18
+ end
19
+ end
@@ -5,6 +5,7 @@
5
5
  require_relative "evaluation_details"
6
6
  require_relative "internal/evaluator"
7
7
  require_relative "internal/override_eval"
8
+ require_relative "internal/provider_evaluation"
8
9
 
9
10
  module Confeature
10
11
  # Immutable view of the last-fetched config + a reference to overrides.
@@ -72,10 +73,28 @@ module Confeature
72
73
  # `EvaluationResult.error` string propagates verbatim into the
73
74
  # envelope's `error` field.
74
75
  def get_value_details(key, default, user = nil)
75
- effective_user = user || @default_user
76
- return local_only_details(key, default, effective_user) if local_only?
76
+ case user
77
+ when Internal::ProviderUser
78
+ provider_details(key, default, user)
79
+ else
80
+ effective_user = user || @default_user
81
+ return local_only_details(key, default, effective_user) if local_only?
82
+
83
+ result = Internal::Evaluator.evaluate(@config, key, default, effective_user)
84
+ details_from_result(key, result, effective_user)
85
+ end
86
+ end
87
+
88
+ private
89
+
90
+ def provider_details(key, default, user)
91
+ result = Internal::ProviderEvaluation.resolve(
92
+ key, default, user, config: @config, local_overrides: (local_only? ? @flag_overrides : nil)
93
+ )
94
+ details_from_result(key, result, nil)
95
+ end
77
96
 
78
- result = Internal::Evaluator.evaluate(@config, key, default, effective_user)
97
+ def details_from_result(key, result, effective_user)
79
98
  matched_rule = result.matched_targeting_rule && TargetingRule.new(result.matched_targeting_rule)
80
99
  matched_option = result.matched_percentage_option && PercentageOption.new(result.matched_percentage_option)
81
100
  EvaluationDetails.new(
@@ -91,8 +110,6 @@ module Confeature
91
110
  )
92
111
  end
93
112
 
94
- private
95
-
96
113
  def local_only?
97
114
  return false if @flag_overrides.nil?
98
115
 
@@ -108,21 +125,7 @@ module Confeature
108
125
  found_full, result = Internal::OverrideEval.evaluate_full_config_override_details_sync(
109
126
  @flag_overrides, key, default, effective_user
110
127
  )
111
- if found_full
112
- matched_rule = result.matched_targeting_rule && TargetingRule.new(result.matched_targeting_rule)
113
- matched_option = result.matched_percentage_option && PercentageOption.new(result.matched_percentage_option)
114
- return EvaluationDetails.new(
115
- key: key,
116
- value: result.value,
117
- variation_id: result.variation_id,
118
- user: effective_user,
119
- is_default_value: !result.error.nil?,
120
- error: result.error,
121
- fetch_time: @fetch_time,
122
- matched_targeting_rule: matched_rule,
123
- matched_percentage_option: matched_option
124
- )
125
- end
128
+ return details_from_result(key, result, effective_user) if found_full
126
129
 
127
130
  found, value = Internal::OverrideEval.evaluate_sync(@flag_overrides, key, default)
128
131
  data_source = @flag_overrides.data_source
@@ -7,5 +7,5 @@ module Confeature
7
7
  # `version` field on the gemspec. The major version tracks the
8
8
  # Confeature API contract major version this SDK implements
9
9
  # (Constitution Principle VI).
10
- VERSION = "0.1.1"
10
+ VERSION = "0.2.0"
11
11
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: confeature
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.1.1
4
+ version: 0.2.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - MakerLabs
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2026-11-18 00:00:00.000000000 Z
11
+ date: 2026-11-22 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: base64
@@ -39,11 +39,9 @@ dependencies:
39
39
  - !ruby/object:Gem::Version
40
40
  version: '1.6'
41
41
  description: |
42
- Confeature is an open-source feature-flag service that mirrors the ConfigCat
43
- API surface 1:1 (Constitution Principle II). The `confeature` gem is the
44
- Ruby SDK: same public class names, same option keywords, same polling
45
- modes, same flag-override semantics as `configcat`. Migrate by renaming the
46
- gem and swapping the SDK key.
42
+ The `confeature` gem is the MIT-licensed Ruby SDK for Confeature's
43
+ feature-flag service. It supports ConfigCat-style evaluation, polling
44
+ and flag overrides.
47
45
  email:
48
46
  executables: []
49
47
  extensions: []
@@ -66,6 +64,8 @@ files:
66
64
  - lib/confeature/internal/override_eval.rb
67
65
  - lib/confeature/internal/poll_service.rb
68
66
  - lib/confeature/internal/prerequisites.rb
67
+ - lib/confeature/internal/provider_evaluation.rb
68
+ - lib/confeature/internal/provider_user.rb
69
69
  - lib/confeature/internal/sdk_key.rb
70
70
  - lib/confeature/internal/segments.rb
71
71
  - lib/confeature/internal/semver.rb