configdirector-server-sdk 0.1.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.
Files changed (162) hide show
  1. checksums.yaml +7 -0
  2. data/.yardopts +2 -0
  3. data/CHANGELOG.md +254 -0
  4. data/LICENSE +21 -0
  5. data/README.md +230 -0
  6. data/lib/configdirector/client_hooks.rb +46 -0
  7. data/lib/configdirector/config_director_client.rb +322 -0
  8. data/lib/configdirector/config_evaluated_event.rb +10 -0
  9. data/lib/configdirector/config_evaluation.rb +51 -0
  10. data/lib/configdirector/config_state.rb +39 -0
  11. data/lib/configdirector/configs_updated_event.rb +23 -0
  12. data/lib/configdirector/connection_error_event.rb +11 -0
  13. data/lib/configdirector/connection_options.rb +60 -0
  14. data/lib/configdirector/context.rb +53 -0
  15. data/lib/configdirector/errors.rb +29 -0
  16. data/lib/configdirector/internal/client/client_connection.rb +119 -0
  17. data/lib/configdirector/internal/client/client_factory.rb +104 -0
  18. data/lib/configdirector/internal/client/client_options_validation.rb +53 -0
  19. data/lib/configdirector/internal/client/config_read.rb +31 -0
  20. data/lib/configdirector/internal/client/config_reader.rb +55 -0
  21. data/lib/configdirector/internal/client/connection_intake.rb +59 -0
  22. data/lib/configdirector/internal/client/connection_options_validation.rb +94 -0
  23. data/lib/configdirector/internal/client/context_admission.rb +48 -0
  24. data/lib/configdirector/internal/client/context_attributes.rb +78 -0
  25. data/lib/configdirector/internal/client/context_kind.rb +24 -0
  26. data/lib/configdirector/internal/client/evaluated_read.rb +9 -0
  27. data/lib/configdirector/internal/client/event_handlers.rb +114 -0
  28. data/lib/configdirector/internal/client/event_tracking.rb +39 -0
  29. data/lib/configdirector/internal/client/live_client_connections.rb +58 -0
  30. data/lib/configdirector/internal/client/number_of_seconds.rb +21 -0
  31. data/lib/configdirector/internal/client/registrations.rb +43 -0
  32. data/lib/configdirector/internal/client/restart_in_forked_processes.rb +25 -0
  33. data/lib/configdirector/internal/client/served_configs.rb +83 -0
  34. data/lib/configdirector/internal/client/serving_state.rb +102 -0
  35. data/lib/configdirector/internal/client/watches.rb +51 -0
  36. data/lib/configdirector/internal/client/what_follows_a_fork.rb +24 -0
  37. data/lib/configdirector/internal/connection/condition_parser.rb +74 -0
  38. data/lib/configdirector/internal/connection/config_definition.rb +37 -0
  39. data/lib/configdirector/internal/connection/http_session.rb +15 -0
  40. data/lib/configdirector/internal/connection/in_memory_connection.rb +134 -0
  41. data/lib/configdirector/internal/connection/json_post_request.rb +24 -0
  42. data/lib/configdirector/internal/connection/not_a_server_sdk_payload.rb +9 -0
  43. data/lib/configdirector/internal/connection/offline_mode_connection.rb +96 -0
  44. data/lib/configdirector/internal/connection/offline_values_file.rb +49 -0
  45. data/lib/configdirector/internal/connection/payloads_delivered_in_turn.rb +46 -0
  46. data/lib/configdirector/internal/connection/polling_interval.rb +21 -0
  47. data/lib/configdirector/internal/connection/request_deadline.rb +45 -0
  48. data/lib/configdirector/internal/connection/retry_after_header.rb +24 -0
  49. data/lib/configdirector/internal/connection/server_sdk_payload.rb +37 -0
  50. data/lib/configdirector/internal/connection/server_sdk_payload_parser.rb +89 -0
  51. data/lib/configdirector/internal/connection/targeting_rules_parser.rb +70 -0
  52. data/lib/configdirector/internal/connection/test_client_initializations.rb +111 -0
  53. data/lib/configdirector/internal/connection/test_client_values.rb +53 -0
  54. data/lib/configdirector/internal/connection/unreadable_definition.rb +9 -0
  55. data/lib/configdirector/internal/connection/wire_fields.rb +59 -0
  56. data/lib/configdirector/internal/evaluation/array_comparison.rb +25 -0
  57. data/lib/configdirector/internal/evaluation/assigned_percentage.rb +21 -0
  58. data/lib/configdirector/internal/evaluation/attribute_condition.rb +48 -0
  59. data/lib/configdirector/internal/evaluation/config_evaluator.rb +29 -0
  60. data/lib/configdirector/internal/evaluation/datetime_comparison.rb +93 -0
  61. data/lib/configdirector/internal/evaluation/evaluation_context.rb +17 -0
  62. data/lib/configdirector/internal/evaluation/number_comparison.rb +119 -0
  63. data/lib/configdirector/internal/evaluation/rapidhash.rb +124 -0
  64. data/lib/configdirector/internal/evaluation/rollout_share.rb +9 -0
  65. data/lib/configdirector/internal/evaluation/rule.rb +70 -0
  66. data/lib/configdirector/internal/evaluation/scalar_text.rb +70 -0
  67. data/lib/configdirector/internal/evaluation/segment.rb +17 -0
  68. data/lib/configdirector/internal/evaluation/segment_condition.rb +26 -0
  69. data/lib/configdirector/internal/evaluation/semver_comparison.rb +49 -0
  70. data/lib/configdirector/internal/evaluation/served_value.rb +9 -0
  71. data/lib/configdirector/internal/evaluation/share.rb +9 -0
  72. data/lib/configdirector/internal/evaluation/targeting_rules.rb +18 -0
  73. data/lib/configdirector/internal/evaluation/text_comparison.rb +32 -0
  74. data/lib/configdirector/internal/evaluation/trait_pointer.rb +42 -0
  75. data/lib/configdirector/internal/evaluation.rb +21 -0
  76. data/lib/configdirector/internal/identity/sdk_identity.rb +39 -0
  77. data/lib/configdirector/internal/identity/wrapper.rb +48 -0
  78. data/lib/configdirector/internal/logging/client_log.rb +37 -0
  79. data/lib/configdirector/internal/logging/default_logger.rb +34 -0
  80. data/lib/configdirector/internal/polling/poll_answer.rb +111 -0
  81. data/lib/configdirector/internal/polling/poll_request.rb +106 -0
  82. data/lib/configdirector/internal/polling/poll_timing.rb +25 -0
  83. data/lib/configdirector/internal/polling/polling_endpoint.rb +36 -0
  84. data/lib/configdirector/internal/polling/polling_mode_connection.rb +53 -0
  85. data/lib/configdirector/internal/polling/polling_session.rb +99 -0
  86. data/lib/configdirector/internal/polling/polling_transport.rb +74 -0
  87. data/lib/configdirector/internal/polling/refusal_detail.rb +36 -0
  88. data/lib/configdirector/internal/server_sent_events/event_stream_limit_exceeded.rb +9 -0
  89. data/lib/configdirector/internal/server_sent_events/event_stream_parser.rb +95 -0
  90. data/lib/configdirector/internal/server_sent_events/server_sent_event.rb +9 -0
  91. data/lib/configdirector/internal/stoppable_thread.rb +69 -0
  92. data/lib/configdirector/internal/streaming/heartbeats.rb +51 -0
  93. data/lib/configdirector/internal/streaming/reconnecting_stream.rb +82 -0
  94. data/lib/configdirector/internal/streaming/reconnection_delay.rb +29 -0
  95. data/lib/configdirector/internal/streaming/stream_connection.rb +86 -0
  96. data/lib/configdirector/internal/streaming/stream_end.rb +69 -0
  97. data/lib/configdirector/internal/streaming/stream_endpoint.rb +43 -0
  98. data/lib/configdirector/internal/streaming/stream_timing.rb +33 -0
  99. data/lib/configdirector/internal/streaming/streaming_mode_connection.rb +60 -0
  100. data/lib/configdirector/internal/streaming/streaming_transport.rb +42 -0
  101. data/lib/configdirector/internal/telemetry/aggregated_wire_entries.rb +26 -0
  102. data/lib/configdirector/internal/telemetry/collected_telemetry.rb +98 -0
  103. data/lib/configdirector/internal/telemetry/compact_json_text.rb +64 -0
  104. data/lib/configdirector/internal/telemetry/discarded_telemetry.rb +31 -0
  105. data/lib/configdirector/internal/telemetry/event_reporter.rb +47 -0
  106. data/lib/configdirector/internal/telemetry/invalid_context_submissions.rb +76 -0
  107. data/lib/configdirector/internal/telemetry/report_answer.rb +31 -0
  108. data/lib/configdirector/internal/telemetry/report_schedule.rb +66 -0
  109. data/lib/configdirector/internal/telemetry/report_timing.rb +20 -0
  110. data/lib/configdirector/internal/telemetry/reported_context.rb +28 -0
  111. data/lib/configdirector/internal/telemetry/reported_details.rb +71 -0
  112. data/lib/configdirector/internal/telemetry/reported_evaluation.rb +82 -0
  113. data/lib/configdirector/internal/telemetry/reported_telemetry.rb +127 -0
  114. data/lib/configdirector/internal/telemetry/reported_text.rb +13 -0
  115. data/lib/configdirector/internal/telemetry/reported_time.rb +13 -0
  116. data/lib/configdirector/internal/telemetry/reported_value.rb +35 -0
  117. data/lib/configdirector/internal/telemetry/telemetry_endpoint.rb +54 -0
  118. data/lib/configdirector/internal/telemetry/telemetry_report.rb +50 -0
  119. data/lib/configdirector/internal/telemetry/test_client_telemetry.rb +37 -0
  120. data/lib/configdirector/internal/telemetry/tracked_event_admission.rb +72 -0
  121. data/lib/configdirector/internal/telemetry/tracked_event_entry.rb +27 -0
  122. data/lib/configdirector/internal/telemetry/tracked_event_queue.rb +47 -0
  123. data/lib/configdirector/internal/telemetry/tracked_event_warning.rb +28 -0
  124. data/lib/configdirector/internal/telemetry/value_id.rb +23 -0
  125. data/lib/configdirector/internal/telemetry/written_json.rb +9 -0
  126. data/lib/configdirector/internal/unchangeable_copy.rb +38 -0
  127. data/lib/configdirector/internal/value/encoded_native_value.rb +45 -0
  128. data/lib/configdirector/internal/value/hash_keys.rb +34 -0
  129. data/lib/configdirector/internal/value/in_code_default_value.rb +33 -0
  130. data/lib/configdirector/internal/value/json_contents.rb +81 -0
  131. data/lib/configdirector/internal/value/json_position.rb +27 -0
  132. data/lib/configdirector/internal/value/native_values.rb +41 -0
  133. data/lib/configdirector/internal/value/parsed_json.rb +79 -0
  134. data/lib/configdirector/internal/value/plain_decimal_text.rb +36 -0
  135. data/lib/configdirector/internal/value/served_text.rb +76 -0
  136. data/lib/configdirector/internal/value/typed_value.rb +9 -0
  137. data/lib/configdirector/internal/value/unservable_value.rb +9 -0
  138. data/lib/configdirector/internal/value/utf8_text.rb +19 -0
  139. data/lib/configdirector/internal.rb +9 -0
  140. data/lib/configdirector/metadata.rb +26 -0
  141. data/lib/configdirector/subscription.rb +34 -0
  142. data/lib/configdirector/telemetry_options.rb +28 -0
  143. data/lib/configdirector/testing/test_client.rb +122 -0
  144. data/lib/configdirector/testing/tracked_event.rb +46 -0
  145. data/lib/configdirector/testing.rb +44 -0
  146. data/lib/configdirector/variation.rb +21 -0
  147. data/lib/configdirector/version.rb +7 -0
  148. data/lib/configdirector-server-sdk.rb +3 -0
  149. data/lib/configdirector.rb +164 -0
  150. data/sig/configdirector/internal/client.rbs +518 -0
  151. data/sig/configdirector/internal/connection.rbs +389 -0
  152. data/sig/configdirector/internal/evaluation.rbs +364 -0
  153. data/sig/configdirector/internal/identity.rbs +51 -0
  154. data/sig/configdirector/internal/logging.rbs +33 -0
  155. data/sig/configdirector/internal/polling.rbs +240 -0
  156. data/sig/configdirector/internal/server_sent_events.rbs +51 -0
  157. data/sig/configdirector/internal/streaming.rbs +266 -0
  158. data/sig/configdirector/internal/telemetry.rbs +556 -0
  159. data/sig/configdirector/internal/value.rbs +159 -0
  160. data/sig/configdirector/testing.rbs +70 -0
  161. data/sig/configdirector.rbs +465 -0
  162. metadata +231 -0
@@ -0,0 +1,364 @@
1
+ module ConfigDirector
2
+ module Internal
3
+ module Evaluation
4
+ type json_value = String | Integer | Float | bool | nil | Array[json_value] | Hash[String, json_value]
5
+
6
+ type segments = Hash[String, Segment]
7
+
8
+ type served_by = :matching_rule | :default_targeting_rule | :default_targeting_rule_after_skipped_rollout
9
+
10
+ type fall_through = :not_matched | :rollout_skipped_no_identifier
11
+
12
+ interface _Condition
13
+ def holds_for?: (EvaluationContext context, segments segments) -> bool
14
+
15
+ def uses_any_segment_of?: (Array[String] segment_ids) -> bool
16
+ end
17
+
18
+ class EvaluationContext < Data
19
+ USER_CONTEXT_KIND: String
20
+
21
+ attr_reader identifier: String?
22
+ attr_reader kind: String?
23
+ attr_reader name: String?
24
+ attr_reader traits: Hash[String, json_value]
25
+ attr_reader app_name: String?
26
+ attr_reader app_version: String?
27
+
28
+ def self.new: (
29
+ identifier: String?,
30
+ kind: String?,
31
+ name: String?,
32
+ traits: Hash[String, json_value],
33
+ app_name: String?,
34
+ app_version: String?
35
+ ) -> instance
36
+
37
+ def effective_kind: () -> String
38
+ end
39
+
40
+ class AttributeCondition < Data
41
+ attr_reader attribute: String
42
+ attr_reader trait: String?
43
+ attr_reader operator: String
44
+ attr_reader target_type: String
45
+ attr_reader target_values: Array[String]
46
+
47
+ def self.new: (
48
+ attribute: String,
49
+ trait: String?,
50
+ operator: String,
51
+ target_type: String,
52
+ target_values: Array[String]
53
+ ) -> instance
54
+
55
+ def holds_for?: (EvaluationContext context, segments _segments) -> bool
56
+
57
+ def uses_any_segment_of?: (Array[String] _segment_ids) -> bool
58
+
59
+ private
60
+
61
+ def trait_of: (EvaluationContext context) -> json_value
62
+
63
+ def value_matches?: (json_value value) -> bool
64
+ end
65
+
66
+ class SegmentCondition < Data
67
+ attr_reader operator: String
68
+ attr_reader segment_id: String
69
+
70
+ def self.new: (operator: String, segment_id: String) -> instance
71
+
72
+ def holds_for?: (EvaluationContext context, segments segments) -> bool
73
+
74
+ def uses_any_segment_of?: (Array[String] segment_ids) -> bool
75
+ end
76
+
77
+ class Segment < Data
78
+ attr_reader condition_groups: Array[Array[AttributeCondition]]
79
+
80
+ def self.new: (condition_groups: Array[Array[AttributeCondition]]) -> instance
81
+
82
+ def contains?: (EvaluationContext context) -> bool
83
+ end
84
+
85
+ class Share < Data
86
+ attr_reader id: String
87
+ attr_reader percentage: Float
88
+ attr_reader value: String?
89
+ attr_reader value_id: String?
90
+ attr_reader variation_id: String?
91
+
92
+ def self.new: (
93
+ id: String,
94
+ percentage: Float,
95
+ value: String?,
96
+ value_id: String?,
97
+ variation_id: String?
98
+ ) -> instance
99
+ end
100
+
101
+ class RolloutShare < Data
102
+ attr_reader rule_id: String
103
+ attr_reader share_id: String
104
+
105
+ def self.new: (rule_id: String, share_id: String) -> instance
106
+ end
107
+
108
+ class ServedValue < Data
109
+ attr_reader value: String
110
+ attr_reader value_id: String?
111
+ attr_reader variation_id: String?
112
+ attr_reader rollout_share: RolloutShare?
113
+ attr_reader served_by: served_by
114
+
115
+ def self.new: (
116
+ value: String,
117
+ value_id: String?,
118
+ variation_id: String?,
119
+ rollout_share: RolloutShare?,
120
+ served_by: served_by
121
+ ) -> instance
122
+ end
123
+
124
+ class Rule < Data
125
+ attr_reader id: String
126
+ attr_reader order: Integer?
127
+ attr_reader type: String
128
+ attr_reader target: String
129
+ attr_reader value: String?
130
+ attr_reader value_id: String?
131
+ attr_reader variation_id: String?
132
+ attr_reader conditions: Array[_Condition]
133
+ attr_reader shares: Array[Share]?
134
+
135
+ def self.new: (
136
+ id: String,
137
+ order: Integer?,
138
+ type: String,
139
+ target: String,
140
+ value: String?,
141
+ value_id: String?,
142
+ variation_id: String?,
143
+ conditions: Array[_Condition],
144
+ shares: Array[Share]?
145
+ ) -> instance
146
+
147
+ def serve: (String config_id, EvaluationContext context, segments segments) -> (ServedValue | fall_through)
148
+
149
+ def uses_any_segment_of?: (Array[String] segment_ids) -> bool
150
+
151
+ private
152
+
153
+ def serve_when_every_condition_holds: (
154
+ String config_id,
155
+ EvaluationContext context,
156
+ segments segments
157
+ ) -> (ServedValue | fall_through)
158
+
159
+ def serve_value: () -> (ServedValue | fall_through)
160
+
161
+ def serve_from_rollout: (String config_id, EvaluationContext context) -> (ServedValue | fall_through)
162
+
163
+ def share_covering: (Array[Share] rollout_shares, Float assigned_percentage) -> Share?
164
+
165
+ def serve_share: (Share share, String share_value) -> ServedValue
166
+ end
167
+
168
+ class TargetingRules < Data
169
+ attr_reader default_value: String
170
+ attr_reader default_value_id: String?
171
+ attr_reader default_variation_id: String?
172
+ attr_reader rules: Array[Rule]
173
+
174
+ def self.new: (
175
+ default_value: String,
176
+ default_value_id: String?,
177
+ default_variation_id: String?,
178
+ rules: Array[Rule]
179
+ ) -> instance
180
+
181
+ def default_targeting_rule_value: (a_rollout_was_skipped: bool) -> ServedValue
182
+ end
183
+
184
+ module ConfigEvaluator
185
+ def self.evaluate: (
186
+ String config_id,
187
+ TargetingRules targeting_rules,
188
+ EvaluationContext context,
189
+ segments segments
190
+ ) -> ServedValue
191
+
192
+ private def self.in_evaluation_order: (Array[Rule] rules) -> Array[Rule]
193
+ end
194
+
195
+ module ScalarText
196
+ LAST_POINT_POSITION_SPELLED_OUT: Integer
197
+ FIRST_POINT_POSITION_SPELLED_OUT: Integer
198
+
199
+ def self.of: (json_value value) -> String?
200
+
201
+ private def self.of_float: (Float number) -> String
202
+
203
+ private def self.of_positive_float: (Float number) -> String
204
+
205
+ private def self.shortest_digits_and_point_position: (Float number) -> [String, Integer]
206
+
207
+ private def self.leading_zeros_of: (String text) -> String
208
+
209
+ private def self.exponent_form: (String digits, Integer exponent) -> String
210
+ end
211
+
212
+ module TextComparison
213
+ type operator = ^(String text, Array[String] targets) -> bool
214
+
215
+ EQUALS_THE_FIRST_TARGET: operator
216
+ DIFFERS_FROM_THE_FIRST_TARGET: operator
217
+ NEVER_MATCHES: operator
218
+ OPERATORS: Hash[String, operator]
219
+
220
+ def self.matches?: (String text, String operator, Array[String] targets) -> bool
221
+ end
222
+
223
+ module NumberComparison
224
+ class NumberOperator < Data
225
+ attr_reader holds: ^(Float number, Float target) -> bool
226
+ attr_reader holds_for_an_unparseable_value: bool
227
+
228
+ def self.new: (holds: ^(Float number, Float target) -> bool, holds_for_an_unparseable_value: bool) -> instance
229
+ end
230
+
231
+ EQUALS: NumberOperator
232
+ DOES_NOT_EQUAL: NumberOperator
233
+
234
+ type rounding = :overflows | :underflows | :fits
235
+
236
+ OPERATORS: Hash[String, NumberOperator]
237
+ DECIMAL_LITERAL: Regexp
238
+ ROUNDS_TO_INFINITY_FROM: Integer
239
+ ROUNDS_TO_ZERO_UP_TO: Rational
240
+ LARGEST_FLOAT_DECIMAL_EXPONENT: Integer
241
+ SMALLEST_FLOAT_DECIMAL_EXPONENT: Integer
242
+
243
+ def self.matches?: (json_value value, String operator, Array[String] targets) -> bool
244
+
245
+ private def self.finite_number_of: (json_value value) -> Float?
246
+
247
+ def self.finite_number_in: (String text) -> Float?
248
+
249
+ private def self.decimal_parts_of: (String text) -> [String, String, Integer]?
250
+
251
+ private def self.rounding_of: (String significant_digits, Integer power_of_ten) -> rounding
252
+
253
+ private def self.rounding_near_the_largest_float: (String significant_digits, Integer power_of_ten) -> rounding
254
+
255
+ private def self.rounding_near_the_smallest_float: (String significant_digits, Integer power_of_ten) -> rounding
256
+
257
+ private def self.exact_value: (String significant_digits, Integer power_of_ten) -> Numeric
258
+ end
259
+
260
+ module SemverComparison
261
+ type version = [Integer, Integer, Integer]
262
+
263
+ type operator = ^(version? version, Array[String] targets) -> bool
264
+
265
+ VERSION_IN_TEXT: Regexp
266
+ NEVER_MATCHES: operator
267
+ OPERATORS: Hash[String, operator]
268
+
269
+ def self.matches?: (String text, String operator, Array[String] targets) -> bool
270
+
271
+ private def self.version_in: (String text) -> version?
272
+
273
+ private def self.ordering: (version? version, String? target_text) -> Integer?
274
+
275
+ private def self.equals_any?: (version? version, Array[String] targets) -> bool
276
+ end
277
+
278
+ module DatetimeComparison
279
+ ECMASCRIPT_DATE_TIME: Regexp
280
+ DAYS_IN_MONTH_OF_A_COMMON_YEAR: Array[Integer]
281
+
282
+ def self.matches?: (String text, String operator, Array[String] targets) -> bool
283
+
284
+ private def self.milliseconds_since_epoch_of: (String text) -> Integer?
285
+
286
+ private def self.possible_calendar_fields_of: (MatchData match) -> [Integer, Integer, Integer, Integer, Integer, Integer]?
287
+
288
+ private def self.milliseconds_read_as_utc: (
289
+ [Integer, Integer, Integer, Integer, Integer, Integer] calendar_fields,
290
+ String? fraction
291
+ ) -> Integer
292
+
293
+ private def self.offset_minutes_of: (String? offset) -> Integer?
294
+
295
+ private def self.possible_date?: (Integer year, Integer month, Integer day) -> bool
296
+
297
+ private def self.possible_time?: (Integer hour, Integer minute, Integer second) -> bool
298
+
299
+ private def self.days_in_month: (Integer year, Integer month) -> Integer
300
+
301
+ private def self.leap_year?: (Integer year) -> bool
302
+ end
303
+
304
+ module ArrayComparison
305
+ def self.matches?: (json_value value, String operator, Array[String] targets) -> bool
306
+
307
+ private def self.contains_any?: (Array[json_value] elements, Array[String] targets) -> bool
308
+ end
309
+
310
+ module TraitPointer
311
+ INVALID_ESCAPE: Regexp
312
+ ESCAPE: Regexp
313
+ DECODED_ESCAPES: Hash[String, String]
314
+ ARRAY_INDEX: Regexp
315
+
316
+ def self.value_at: (String pointer, json_value traits) -> json_value
317
+
318
+ private def self.member_of: (json_value container, String token) -> json_value
319
+
320
+ private def self.element_of: (Array[json_value] elements, String token) -> json_value
321
+ end
322
+
323
+ module Rapidhash
324
+ LOW_64_BITS: Integer
325
+ SECRET: Array[Integer]
326
+ SHORT_MESSAGE_LENGTH: Integer
327
+ BLOCK_LENGTH: Integer
328
+ LANE_COUNT: Integer
329
+ REMAINDER_PAIR_SECRETS: Array[Integer]
330
+
331
+ def self.of: (String message, Integer seed) -> Integer
332
+
333
+ private def self.short_message_words: (String message, Integer length, Integer seed) -> [Integer, Integer, Integer, Integer]
334
+
335
+ private def self.tiny_message_words: (String message, Integer length) -> [Integer, Integer]
336
+
337
+ private def self.long_message_words: (String message, Integer length, Integer seed) -> [Integer, Integer, Integer, Integer]
338
+
339
+ private def self.blocks: (String message, Integer length, Integer seed) -> [Integer, Integer]
340
+
341
+ private def self.mix_block: (String message, Integer offset, Array[Integer] lanes) -> Array[Integer]
342
+
343
+ private def self.remainder_pairs: (String message, Integer offset, Integer length, Integer seed) -> Integer
344
+
345
+ private def self.mix: (Integer multiplicand, Integer multiplier) -> Integer
346
+
347
+ private def self.finish: (Integer first_word, Integer second_word, Integer last_block_length) -> Integer
348
+
349
+ private def self.read64: (String message, Integer offset) -> Integer
350
+
351
+ private def self.read32: (String message, Integer offset) -> Integer
352
+
353
+ private def self.read8: (String message, Integer offset) -> Integer
354
+ end
355
+
356
+ module AssignedPercentage
357
+ SEED: Integer
358
+ REACHABLE_TENTHS_OF_A_PERCENT: Integer
359
+
360
+ def self.of: (String config_id, String identifier, String context_kind) -> Float
361
+ end
362
+ end
363
+ end
364
+ end
@@ -0,0 +1,51 @@
1
+ module ConfigDirector
2
+ module Internal
3
+ module Identity
4
+ class SdkIdentity
5
+ @sdk_name: String
6
+ @sdk_version: String
7
+
8
+ def self.of_the_server_sdk: () -> SdkIdentity
9
+
10
+ def self.of_the_wrapper: (untyped wrapper) -> SdkIdentity
11
+
12
+ private def self.new: (String sdk_name, String sdk_version) -> instance
13
+
14
+ def initialize: (String sdk_name, String sdk_version) -> void
15
+
16
+ def user_agent: () -> String
17
+
18
+ def meta_context_of_an_application_with: (Metadata metadata) -> Hash[Symbol, String]
19
+ end
20
+
21
+ class Wrapper
22
+ VERSION_WITHOUT_THE_GEM_OF_THE_WRAPPER: String
23
+ OPENFEATURE_SERVER_PROVIDER: Wrapper
24
+
25
+ @name_of_the_version_constant_of_its_gem: String
26
+
27
+ attr_reader sdk_name: String
28
+
29
+ private def self.new: (String sdk_name, String name_of_the_version_constant_of_its_gem) -> instance
30
+
31
+ def initialize: (String sdk_name, String name_of_the_version_constant_of_its_gem) -> void
32
+
33
+ def create_client: (
34
+ ?String? server_sdk_key,
35
+ ?metadata: Metadata?,
36
+ ?connection: ConnectionOptions?,
37
+ ?logger: (_Logger & Object)?,
38
+ ?log_level: (Integer | Symbol | String)?,
39
+ ?telemetry: TelemetryOptions?,
40
+ ?hooks: ClientHooks?
41
+ ) -> ConfigDirectorClient
42
+
43
+ def version_of_its_gem: () -> String
44
+
45
+ private
46
+
47
+ def gem_loaded?: () -> bool
48
+ end
49
+ end
50
+ end
51
+ end
@@ -0,0 +1,33 @@
1
+ module ConfigDirector
2
+ module Internal
3
+ module Logging
4
+ module DefaultLogger
5
+ LINE_PREFIX: String
6
+ LINE_FORMAT: ^(String severity, Time time, untyped program_name, untyped message) -> String
7
+ LOGGER_LEVELS: Range[Integer]
8
+
9
+ def self.writing_from: (untyped log_level) -> Logger
10
+
11
+ private def self.invalid: (untyped log_level) -> ConfigDirectorValidationError
12
+ end
13
+
14
+ class ClientLog
15
+ @logger: _Logger
16
+ @line_prefix: String
17
+ @writes_debug_lines: _LogLevelCheck
18
+
19
+ def initialize: (_Logger & Object logger, ?component: String) -> void
20
+
21
+ def debug: () { () -> String } -> void
22
+
23
+ def info: (String line) -> void
24
+
25
+ def warn: (String line) -> void
26
+
27
+ def error: (String line) -> void
28
+
29
+ def ignoring_errors_from: (String source) { () -> untyped } -> void
30
+ end
31
+ end
32
+ end
33
+ end
@@ -0,0 +1,240 @@
1
+ module ConfigDirector
2
+ module Internal
3
+ module Polling
4
+ class PollTiming < Data
5
+ attr_reader seconds_between_polls: seconds
6
+ attr_reader seconds_a_poll_may_take: seconds
7
+ attr_reader pause_before_the_next_poll: ^(seconds seconds) -> void
8
+ attr_reader monotonic_seconds: ^() -> Float
9
+
10
+ def self.new: (
11
+ seconds_between_polls: seconds,
12
+ seconds_a_poll_may_take: seconds,
13
+ pause_before_the_next_poll: ^(seconds seconds) -> void,
14
+ monotonic_seconds: ^() -> Float
15
+ ) -> instance
16
+
17
+ def self.on_the_clock_of_the_process: (
18
+ seconds_between_polls: seconds,
19
+ seconds_a_poll_may_take: seconds
20
+ ) -> PollTiming
21
+ end
22
+
23
+ module RefusalDetail
24
+ MAXIMUM_BYTES: Integer
25
+
26
+ def self.of: (String answer_body, server_sdk_key_to_hide: String) -> String
27
+
28
+ private def self.written_forms_of: (String server_sdk_key) -> Array[String]
29
+ end
30
+
31
+ type poll_answer_kind = :payload
32
+ | :unchanged
33
+ | :unanswered
34
+ | :timed_out
35
+ | :refused
36
+ | :throttled
37
+ | :unreadable
38
+ | :refused_unrecoverably
39
+
40
+ class PollAnswer < Data
41
+ WHAT_FOLLOWS_BY_KIND: Hash[Symbol, Symbol]
42
+ SENT_AGAIN_AT_ONCE_BY_KIND: Hash[Symbol, bool]
43
+ LONGEST_WAIT_THE_SERVER_CAN_ASK_FOR_SECONDS: Integer
44
+
45
+ attr_reader kind: poll_answer_kind
46
+ attr_reader payload_text: String?
47
+ attr_reader timestamp: String?
48
+ attr_reader failure_message: String?
49
+ attr_reader status: Integer?
50
+ attr_reader seconds_named_by_retry_after: seconds?
51
+
52
+ def self.new: (
53
+ kind: poll_answer_kind,
54
+ payload_text: String?,
55
+ timestamp: String?,
56
+ failure_message: String?,
57
+ status: Integer?,
58
+ seconds_named_by_retry_after: seconds?
59
+ ) -> instance
60
+
61
+ def self.payload: (String payload_text, timestamp: String?) -> PollAnswer
62
+
63
+ def self.unchanged: () -> PollAnswer
64
+
65
+ def self.unanswered: (String cause) -> PollAnswer
66
+
67
+ def self.timed_out: (String description_of_the_deadline_having_passed) -> PollAnswer
68
+
69
+ def self.refused: (Integer status) -> PollAnswer
70
+
71
+ def self.throttled: (Integer status, seconds? seconds_named_by_retry_after) -> PollAnswer
72
+
73
+ def self.refused_unrecoverably: (Integer status, detail: String) -> PollAnswer
74
+
75
+ def self.unreadable: (String cause) -> PollAnswer
76
+
77
+ private def self.failed: (
78
+ poll_answer_kind kind,
79
+ String failure_message,
80
+ ?status: Integer?,
81
+ ?seconds_named_by_retry_after: seconds?
82
+ ) -> PollAnswer
83
+
84
+ def what_follows: () -> Symbol
85
+
86
+ def sent_again_at_once?: () -> bool
87
+
88
+ def seconds_before_the_next_poll: (seconds seconds_between_polls) -> seconds
89
+ end
90
+
91
+ class PollingEndpoint
92
+ @poll_uri: URI::Generic
93
+ @server_sdk_key: String
94
+ @sdk_identity: Identity::SdkIdentity
95
+ @meta_context: Hash[Symbol, String]
96
+
97
+ def initialize: (
98
+ url: String,
99
+ server_sdk_key: String,
100
+ metadata: Metadata,
101
+ sdk_identity: Identity::SdkIdentity
102
+ ) -> void
103
+
104
+ def http_session: () -> Net::HTTP
105
+
106
+ def json_post_of_a_poll: (session_id: String, last_update_timestamp: String?) -> Net::HTTP::Post
107
+
108
+ def refusal_detail_in: (String answer_body) -> String
109
+ end
110
+
111
+ class PollRequest
112
+ MAXIMUM_BODY_MEBIBYTES: Integer
113
+ MAXIMUM_BODY_BYTES: Integer
114
+ PAYLOAD_STATUS: Integer
115
+ SUCCESS_STATUSES: Range[Integer]
116
+ TOO_MANY_REQUESTS_STATUS: Integer
117
+ CLIENT_ERROR_STATUSES: Range[Integer]
118
+
119
+ @endpoint: PollingEndpoint
120
+ @session_id: String
121
+ @last_update_timestamp: String?
122
+ @deadline: Connection::RequestDeadline
123
+ @http_session: Net::HTTP
124
+ @body_text_read: String
125
+
126
+ def initialize: (
127
+ endpoint: PollingEndpoint,
128
+ session_id: String,
129
+ last_update_timestamp: String?,
130
+ deadline: Connection::RequestDeadline
131
+ ) -> void
132
+
133
+ def answer: () -> PollAnswer
134
+
135
+ private
136
+
137
+ def response_to_the_post: () -> Net::HTTPResponse
138
+
139
+ def response_read_until_over_the_limit: () -> Net::HTTPResponse
140
+
141
+ def json_post: () -> Net::HTTP::Post
142
+
143
+ def body_text_read_until_over_the_limit: (Net::HTTPResponse response) -> String
144
+
145
+ def answer_in: (Net::HTTPResponse response) -> PollAnswer
146
+
147
+ def answer_holding_the_payload: () -> PollAnswer
148
+
149
+ def retry_after_seconds_in: (Net::HTTPResponse response) -> seconds?
150
+
151
+ def refusal_detail: () -> String
152
+ end
153
+
154
+ class PollingSession
155
+ @endpoint: PollingEndpoint
156
+ @timing: PollTiming
157
+ @log: Logging::ClientLog
158
+ @session_id: String
159
+ @last_update_timestamp: String?
160
+ @seconds_before_the_next_poll: seconds
161
+
162
+ def initialize: (
163
+ endpoint: PollingEndpoint,
164
+ timing: PollTiming,
165
+ log: Logging::ClientLog,
166
+ ?last_update_timestamp: String?
167
+ ) -> void
168
+
169
+ def poll: (
170
+ report_unrecoverable_error: ^(ConfigDirectorConnectionError unrecoverable_error) -> void
171
+ ) { (String payload_text) -> void } -> Symbol
172
+
173
+ def session_of_a_forked_process: () -> PollingSession
174
+
175
+ def poll_at_once_and_on_every_interval: (
176
+ report_unrecoverable_error: ^(ConfigDirectorConnectionError unrecoverable_error) -> void
177
+ ) { (String payload_text) -> void } -> void
178
+
179
+ def poll_on_every_interval: (
180
+ report_unrecoverable_error: ^(ConfigDirectorConnectionError unrecoverable_error) -> void
181
+ ) { (String payload_text) -> void } -> void
182
+
183
+ private
184
+
185
+ def answer_retried_once_when_unanswered: () -> PollAnswer
186
+
187
+ def answer_before: (Connection::RequestDeadline deadline) -> PollAnswer
188
+
189
+ def deliver: (PollAnswer answer) { (String payload_text) -> void } -> Symbol
190
+
191
+ def log_the_failure_of: (PollAnswer answer) -> void
192
+
193
+ def log_and_report_the_unrecoverable_error_of: (
194
+ PollAnswer answer,
195
+ ^(ConfigDirectorConnectionError unrecoverable_error) -> void report_unrecoverable_error
196
+ ) -> void
197
+ end
198
+
199
+ class PollingTransport
200
+ SECONDS_CLOSE_WAITS_FOR_THE_THREAD: Integer
201
+
202
+ @session: PollingSession
203
+ @lock: Thread::Mutex
204
+ @closed: bool
205
+ @polling_thread: StoppableThread?
206
+
207
+ def initialize: (endpoint: PollingEndpoint, timing: PollTiming, logger: _Logger & Object) -> void
208
+
209
+ def open: (
210
+ report_unrecoverable_error: ^(ConfigDirectorConnectionError unrecoverable_error) -> void
211
+ ) { (String payload_text) -> void } -> Symbol
212
+
213
+ def restart_in_a_forked_process: (
214
+ report_unrecoverable_error: ^(ConfigDirectorConnectionError unrecoverable_error) -> void
215
+ ) { (String payload_text) -> void } -> void
216
+
217
+ def close: () -> void
218
+
219
+ private
220
+
221
+ def poll_on_every_interval_unless_closed: (
222
+ report_unrecoverable_error: ^(ConfigDirectorConnectionError unrecoverable_error) -> void
223
+ ) { (String payload_text) -> void } -> void
224
+
225
+ def start_the_polling_thread_unless_closed: () { () -> void } -> void
226
+ end
227
+
228
+ class PollingModeConnection
229
+ include Connection::_Connection
230
+ extend Connection::_ConnectionOfAMode
231
+
232
+ OPENING_BY_WHAT_FOLLOWS_THE_FIRST_POLL: Hash[Symbol, Symbol]
233
+
234
+ @transport: PollingTransport
235
+
236
+ def initialize: (PollingTransport transport) -> void
237
+ end
238
+ end
239
+ end
240
+ end