@featurevisor/sdk 1.35.2 → 2.0.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 (86) hide show
  1. package/CHANGELOG.md +8 -0
  2. package/README.md +2 -381
  3. package/coverage/clover.xml +707 -643
  4. package/coverage/coverage-final.json +11 -9
  5. package/coverage/lcov-report/{segments.ts.html → bucketer.ts.html} +155 -77
  6. package/coverage/lcov-report/child.ts.html +940 -0
  7. package/coverage/lcov-report/conditions.ts.html +107 -158
  8. package/coverage/lcov-report/datafileReader.ts.html +763 -103
  9. package/coverage/lcov-report/emitter.ts.html +77 -59
  10. package/coverage/lcov-report/evaluate.ts.html +689 -416
  11. package/coverage/lcov-report/events.ts.html +334 -0
  12. package/coverage/lcov-report/helpers.ts.html +184 -0
  13. package/coverage/lcov-report/{feature.ts.html → hooks.ts.html} +90 -237
  14. package/coverage/lcov-report/index.html +119 -89
  15. package/coverage/lcov-report/instance.ts.html +341 -773
  16. package/coverage/lcov-report/logger.ts.html +64 -64
  17. package/coverage/lcov.info +1433 -1223
  18. package/dist/bucketer.d.ts +11 -0
  19. package/dist/child.d.ts +26 -0
  20. package/dist/compareVersions.d.ts +4 -0
  21. package/dist/conditions.d.ts +4 -4
  22. package/dist/datafileReader.d.ts +26 -6
  23. package/dist/emitter.d.ts +8 -9
  24. package/dist/evaluate.d.ts +31 -29
  25. package/dist/events.d.ts +5 -0
  26. package/dist/helpers.d.ts +5 -0
  27. package/dist/hooks.d.ts +45 -0
  28. package/dist/index.d.ts +3 -2
  29. package/dist/index.js +1 -1
  30. package/dist/index.js.map +1 -1
  31. package/dist/index.mjs +1 -1
  32. package/dist/index.mjs.gz +0 -0
  33. package/dist/index.mjs.map +1 -1
  34. package/dist/instance.d.ts +40 -72
  35. package/dist/logger.d.ts +6 -5
  36. package/dist/murmurhash.d.ts +1 -0
  37. package/jest.config.js +2 -0
  38. package/lib/bucketer.d.ts +11 -0
  39. package/lib/child.d.ts +26 -0
  40. package/lib/compareVersions.d.ts +4 -0
  41. package/lib/conditions.d.ts +4 -4
  42. package/lib/datafileReader.d.ts +26 -6
  43. package/lib/emitter.d.ts +8 -9
  44. package/lib/evaluate.d.ts +31 -29
  45. package/lib/events.d.ts +5 -0
  46. package/lib/helpers.d.ts +5 -0
  47. package/lib/hooks.d.ts +45 -0
  48. package/lib/index.d.ts +3 -2
  49. package/lib/instance.d.ts +40 -72
  50. package/lib/logger.d.ts +6 -5
  51. package/lib/murmurhash.d.ts +1 -0
  52. package/package.json +3 -5
  53. package/src/bucketer.spec.ts +165 -0
  54. package/src/bucketer.ts +84 -0
  55. package/src/child.spec.ts +267 -0
  56. package/src/child.ts +285 -0
  57. package/src/compareVersions.ts +93 -0
  58. package/src/conditions.spec.ts +563 -353
  59. package/src/conditions.ts +46 -63
  60. package/src/datafileReader.spec.ts +396 -84
  61. package/src/datafileReader.ts +280 -60
  62. package/src/emitter.spec.ts +27 -86
  63. package/src/emitter.ts +38 -32
  64. package/src/evaluate.ts +349 -258
  65. package/src/events.spec.ts +154 -0
  66. package/src/events.ts +83 -0
  67. package/src/helpers.ts +33 -0
  68. package/src/hooks.ts +88 -0
  69. package/src/index.ts +3 -2
  70. package/src/instance.spec.ts +305 -489
  71. package/src/instance.ts +247 -391
  72. package/src/logger.spec.ts +212 -134
  73. package/src/logger.ts +36 -36
  74. package/src/murmurhash.ts +71 -0
  75. package/coverage/lcov-report/bucket.ts.html +0 -502
  76. package/dist/bucket.d.ts +0 -30
  77. package/dist/feature.d.ts +0 -16
  78. package/dist/segments.d.ts +0 -5
  79. package/lib/bucket.d.ts +0 -30
  80. package/lib/feature.d.ts +0 -16
  81. package/lib/segments.d.ts +0 -5
  82. package/src/bucket.spec.ts +0 -37
  83. package/src/bucket.ts +0 -139
  84. package/src/feature.ts +0 -137
  85. package/src/segments.spec.ts +0 -468
  86. package/src/segments.ts +0 -58
package/coverage/lcov-report/bucket.ts.html DELETED
@@ -1,502 +0,0 @@
1
-
2
- <!doctype html>
3
- <html lang="en">
4
-
5
- <head>
6
- <title>Code coverage report for bucket.ts</title>
7
- <meta charset="utf-8" />
8
- <link rel="stylesheet" href="prettify.css" />
9
- <link rel="stylesheet" href="base.css" />
10
- <link rel="shortcut icon" type="image/x-icon" href="favicon.png" />
11
- <meta name="viewport" content="width=device-width, initial-scale=1" />
12
- <style type='text/css'>
13
- .coverage-summary .sorter {
14
- background-image: url(sort-arrow-sprite.png);
15
- }
16
- </style>
17
- </head>
18
-
19
- <body>
20
- <div class='wrapper'>
21
- <div class='pad1'>
22
- <h1><a href="index.html">All files</a> bucket.ts</h1>
23
- <div class='clearfix'>
24
-
25
- <div class='fl pad1y space-right2'>
26
- <span class="strong">95.45% </span>
27
- <span class="quiet">Statements</span>
28
- <span class='fraction'>42/44</span>
29
- </div>
30
-
31
-
32
- <div class='fl pad1y space-right2'>
33
- <span class="strong">88.23% </span>
34
- <span class="quiet">Branches</span>
35
- <span class='fraction'>15/17</span>
36
- </div>
37
-
38
-
39
- <div class='fl pad1y space-right2'>
40
- <span class="strong">100% </span>
41
- <span class="quiet">Functions</span>
42
- <span class='fraction'>4/4</span>
43
- </div>
44
-
45
-
46
- <div class='fl pad1y space-right2'>
47
- <span class="strong">95.45% </span>
48
- <span class="quiet">Lines</span>
49
- <span class='fraction'>42/44</span>
50
- </div>
51
-
52
-
53
- </div>
54
- <p class="quiet">
55
- Press <em>n</em> or <em>j</em> to go to the next uncovered block, <em>b</em>, <em>p</em> or <em>k</em> for the previous block.
56
- </p>
57
- <template id="filterTemplate">
58
- <div class="quiet">
59
- Filter:
60
- <input oninput="onInput()" type="search" id="fileSearch">
61
- </div>
62
- </template>
63
- </div>
64
- <div class='status-line high'></div>
65
- <pre><table class="coverage">
66
- <tr><td class="line-count quiet"><a name='L1'></a><a href='#L1'>1</a>
67
- <a name='L2'></a><a href='#L2'>2</a>
68
- <a name='L3'></a><a href='#L3'>3</a>
69
- <a name='L4'></a><a href='#L4'>4</a>
70
- <a name='L5'></a><a href='#L5'>5</a>
71
- <a name='L6'></a><a href='#L6'>6</a>
72
- <a name='L7'></a><a href='#L7'>7</a>
73
- <a name='L8'></a><a href='#L8'>8</a>
74
- <a name='L9'></a><a href='#L9'>9</a>
75
- <a name='L10'></a><a href='#L10'>10</a>
76
- <a name='L11'></a><a href='#L11'>11</a>
77
- <a name='L12'></a><a href='#L12'>12</a>
78
- <a name='L13'></a><a href='#L13'>13</a>
79
- <a name='L14'></a><a href='#L14'>14</a>
80
- <a name='L15'></a><a href='#L15'>15</a>
81
- <a name='L16'></a><a href='#L16'>16</a>
82
- <a name='L17'></a><a href='#L17'>17</a>
83
- <a name='L18'></a><a href='#L18'>18</a>
84
- <a name='L19'></a><a href='#L19'>19</a>
85
- <a name='L20'></a><a href='#L20'>20</a>
86
- <a name='L21'></a><a href='#L21'>21</a>
87
- <a name='L22'></a><a href='#L22'>22</a>
88
- <a name='L23'></a><a href='#L23'>23</a>
89
- <a name='L24'></a><a href='#L24'>24</a>
90
- <a name='L25'></a><a href='#L25'>25</a>
91
- <a name='L26'></a><a href='#L26'>26</a>
92
- <a name='L27'></a><a href='#L27'>27</a>
93
- <a name='L28'></a><a href='#L28'>28</a>
94
- <a name='L29'></a><a href='#L29'>29</a>
95
- <a name='L30'></a><a href='#L30'>30</a>
96
- <a name='L31'></a><a href='#L31'>31</a>
97
- <a name='L32'></a><a href='#L32'>32</a>
98
- <a name='L33'></a><a href='#L33'>33</a>
99
- <a name='L34'></a><a href='#L34'>34</a>
100
- <a name='L35'></a><a href='#L35'>35</a>
101
- <a name='L36'></a><a href='#L36'>36</a>
102
- <a name='L37'></a><a href='#L37'>37</a>
103
- <a name='L38'></a><a href='#L38'>38</a>
104
- <a name='L39'></a><a href='#L39'>39</a>
105
- <a name='L40'></a><a href='#L40'>40</a>
106
- <a name='L41'></a><a href='#L41'>41</a>
107
- <a name='L42'></a><a href='#L42'>42</a>
108
- <a name='L43'></a><a href='#L43'>43</a>
109
- <a name='L44'></a><a href='#L44'>44</a>
110
- <a name='L45'></a><a href='#L45'>45</a>
111
- <a name='L46'></a><a href='#L46'>46</a>
112
- <a name='L47'></a><a href='#L47'>47</a>
113
- <a name='L48'></a><a href='#L48'>48</a>
114
- <a name='L49'></a><a href='#L49'>49</a>
115
- <a name='L50'></a><a href='#L50'>50</a>
116
- <a name='L51'></a><a href='#L51'>51</a>
117
- <a name='L52'></a><a href='#L52'>52</a>
118
- <a name='L53'></a><a href='#L53'>53</a>
119
- <a name='L54'></a><a href='#L54'>54</a>
120
- <a name='L55'></a><a href='#L55'>55</a>
121
- <a name='L56'></a><a href='#L56'>56</a>
122
- <a name='L57'></a><a href='#L57'>57</a>
123
- <a name='L58'></a><a href='#L58'>58</a>
124
- <a name='L59'></a><a href='#L59'>59</a>
125
- <a name='L60'></a><a href='#L60'>60</a>
126
- <a name='L61'></a><a href='#L61'>61</a>
127
- <a name='L62'></a><a href='#L62'>62</a>
128
- <a name='L63'></a><a href='#L63'>63</a>
129
- <a name='L64'></a><a href='#L64'>64</a>
130
- <a name='L65'></a><a href='#L65'>65</a>
131
- <a name='L66'></a><a href='#L66'>66</a>
132
- <a name='L67'></a><a href='#L67'>67</a>
133
- <a name='L68'></a><a href='#L68'>68</a>
134
- <a name='L69'></a><a href='#L69'>69</a>
135
- <a name='L70'></a><a href='#L70'>70</a>
136
- <a name='L71'></a><a href='#L71'>71</a>
137
- <a name='L72'></a><a href='#L72'>72</a>
138
- <a name='L73'></a><a href='#L73'>73</a>
139
- <a name='L74'></a><a href='#L74'>74</a>
140
- <a name='L75'></a><a href='#L75'>75</a>
141
- <a name='L76'></a><a href='#L76'>76</a>
142
- <a name='L77'></a><a href='#L77'>77</a>
143
- <a name='L78'></a><a href='#L78'>78</a>
144
- <a name='L79'></a><a href='#L79'>79</a>
145
- <a name='L80'></a><a href='#L80'>80</a>
146
- <a name='L81'></a><a href='#L81'>81</a>
147
- <a name='L82'></a><a href='#L82'>82</a>
148
- <a name='L83'></a><a href='#L83'>83</a>
149
- <a name='L84'></a><a href='#L84'>84</a>
150
- <a name='L85'></a><a href='#L85'>85</a>
151
- <a name='L86'></a><a href='#L86'>86</a>
152
- <a name='L87'></a><a href='#L87'>87</a>
153
- <a name='L88'></a><a href='#L88'>88</a>
154
- <a name='L89'></a><a href='#L89'>89</a>
155
- <a name='L90'></a><a href='#L90'>90</a>
156
- <a name='L91'></a><a href='#L91'>91</a>
157
- <a name='L92'></a><a href='#L92'>92</a>
158
- <a name='L93'></a><a href='#L93'>93</a>
159
- <a name='L94'></a><a href='#L94'>94</a>
160
- <a name='L95'></a><a href='#L95'>95</a>
161
- <a name='L96'></a><a href='#L96'>96</a>
162
- <a name='L97'></a><a href='#L97'>97</a>
163
- <a name='L98'></a><a href='#L98'>98</a>
164
- <a name='L99'></a><a href='#L99'>99</a>
165
- <a name='L100'></a><a href='#L100'>100</a>
166
- <a name='L101'></a><a href='#L101'>101</a>
167
- <a name='L102'></a><a href='#L102'>102</a>
168
- <a name='L103'></a><a href='#L103'>103</a>
169
- <a name='L104'></a><a href='#L104'>104</a>
170
- <a name='L105'></a><a href='#L105'>105</a>
171
- <a name='L106'></a><a href='#L106'>106</a>
172
- <a name='L107'></a><a href='#L107'>107</a>
173
- <a name='L108'></a><a href='#L108'>108</a>
174
- <a name='L109'></a><a href='#L109'>109</a>
175
- <a name='L110'></a><a href='#L110'>110</a>
176
- <a name='L111'></a><a href='#L111'>111</a>
177
- <a name='L112'></a><a href='#L112'>112</a>
178
- <a name='L113'></a><a href='#L113'>113</a>
179
- <a name='L114'></a><a href='#L114'>114</a>
180
- <a name='L115'></a><a href='#L115'>115</a>
181
- <a name='L116'></a><a href='#L116'>116</a>
182
- <a name='L117'></a><a href='#L117'>117</a>
183
- <a name='L118'></a><a href='#L118'>118</a>
184
- <a name='L119'></a><a href='#L119'>119</a>
185
- <a name='L120'></a><a href='#L120'>120</a>
186
- <a name='L121'></a><a href='#L121'>121</a>
187
- <a name='L122'></a><a href='#L122'>122</a>
188
- <a name='L123'></a><a href='#L123'>123</a>
189
- <a name='L124'></a><a href='#L124'>124</a>
190
- <a name='L125'></a><a href='#L125'>125</a>
191
- <a name='L126'></a><a href='#L126'>126</a>
192
- <a name='L127'></a><a href='#L127'>127</a>
193
- <a name='L128'></a><a href='#L128'>128</a>
194
- <a name='L129'></a><a href='#L129'>129</a>
195
- <a name='L130'></a><a href='#L130'>130</a>
196
- <a name='L131'></a><a href='#L131'>131</a>
197
- <a name='L132'></a><a href='#L132'>132</a>
198
- <a name='L133'></a><a href='#L133'>133</a>
199
- <a name='L134'></a><a href='#L134'>134</a>
200
- <a name='L135'></a><a href='#L135'>135</a>
201
- <a name='L136'></a><a href='#L136'>136</a>
202
- <a name='L137'></a><a href='#L137'>137</a>
203
- <a name='L138'></a><a href='#L138'>138</a>
204
- <a name='L139'></a><a href='#L139'>139</a>
205
- <a name='L140'></a><a href='#L140'>140</a></td><td class="line-coverage quiet"><span class="cline-any cline-yes">2x</span>
206
- <span class="cline-any cline-neutral">&nbsp;</span>
207
- <span class="cline-any cline-neutral">&nbsp;</span>
208
- <span class="cline-any cline-neutral">&nbsp;</span>
209
- <span class="cline-any cline-neutral">&nbsp;</span>
210
- <span class="cline-any cline-neutral">&nbsp;</span>
211
- <span class="cline-any cline-neutral">&nbsp;</span>
212
- <span class="cline-any cline-neutral">&nbsp;</span>
213
- <span class="cline-any cline-yes">2x</span>
214
- <span class="cline-any cline-yes">2x</span>
215
- <span class="cline-any cline-neutral">&nbsp;</span>
216
- <span class="cline-any cline-yes">2x</span>
217
- <span class="cline-any cline-neutral">&nbsp;</span>
218
- <span class="cline-any cline-yes">2x</span>
219
- <span class="cline-any cline-yes">105x</span>
220
- <span class="cline-any cline-yes">105x</span>
221
- <span class="cline-any cline-neutral">&nbsp;</span>
222
- <span class="cline-any cline-yes">105x</span>
223
- <span class="cline-any cline-neutral">&nbsp;</span>
224
- <span class="cline-any cline-neutral">&nbsp;</span>
225
- <span class="cline-any cline-neutral">&nbsp;</span>
226
- <span class="cline-any cline-neutral">&nbsp;</span>
227
- <span class="cline-any cline-neutral">&nbsp;</span>
228
- <span class="cline-any cline-neutral">&nbsp;</span>
229
- <span class="cline-any cline-neutral">&nbsp;</span>
230
- <span class="cline-any cline-neutral">&nbsp;</span>
231
- <span class="cline-any cline-neutral">&nbsp;</span>
232
- <span class="cline-any cline-neutral">&nbsp;</span>
233
- <span class="cline-any cline-neutral">&nbsp;</span>
234
- <span class="cline-any cline-neutral">&nbsp;</span>
235
- <span class="cline-any cline-neutral">&nbsp;</span>
236
- <span class="cline-any cline-neutral">&nbsp;</span>
237
- <span class="cline-any cline-neutral">&nbsp;</span>
238
- <span class="cline-any cline-neutral">&nbsp;</span>
239
- <span class="cline-any cline-neutral">&nbsp;</span>
240
- <span class="cline-any cline-neutral">&nbsp;</span>
241
- <span class="cline-any cline-neutral">&nbsp;</span>
242
- <span class="cline-any cline-yes">2x</span>
243
- <span class="cline-any cline-yes">95x</span>
244
- <span class="cline-any cline-neutral">&nbsp;</span>
245
- <span class="cline-any cline-yes">95x</span>
246
- <span class="cline-any cline-neutral">&nbsp;</span>
247
- <span class="cline-any cline-neutral">&nbsp;</span>
248
- <span class="cline-any cline-neutral">&nbsp;</span>
249
- <span class="cline-any cline-neutral">&nbsp;</span>
250
- <span class="cline-any cline-yes">95x</span>
251
- <span class="cline-any cline-yes">88x</span>
252
- <span class="cline-any cline-yes">88x</span>
253
- <span class="cline-any cline-yes">7x</span>
254
- <span class="cline-any cline-yes">2x</span>
255
- <span class="cline-any cline-yes">2x</span>
256
- <span class="cline-any cline-yes">5x</span>
257
- <span class="cline-any cline-yes">5x</span>
258
- <span class="cline-any cline-yes">5x</span>
259
- <span class="cline-any cline-neutral">&nbsp;</span>
260
- <span class="cline-any cline-no">&nbsp;</span>
261
- <span class="cline-any cline-neutral">&nbsp;</span>
262
- <span class="cline-any cline-no">&nbsp;</span>
263
- <span class="cline-any cline-neutral">&nbsp;</span>
264
- <span class="cline-any cline-neutral">&nbsp;</span>
265
- <span class="cline-any cline-yes">95x</span>
266
- <span class="cline-any cline-neutral">&nbsp;</span>
267
- <span class="cline-any cline-yes">95x</span>
268
- <span class="cline-any cline-yes">102x</span>
269
- <span class="cline-any cline-neutral">&nbsp;</span>
270
- <span class="cline-any cline-yes">102x</span>
271
- <span class="cline-any cline-yes">13x</span>
272
- <span class="cline-any cline-neutral">&nbsp;</span>
273
- <span class="cline-any cline-neutral">&nbsp;</span>
274
- <span class="cline-any cline-yes">89x</span>
275
- <span class="cline-any cline-yes">81x</span>
276
- <span class="cline-any cline-neutral">&nbsp;</span>
277
- <span class="cline-any cline-neutral">&nbsp;</span>
278
- <span class="cline-any cline-yes">8x</span>
279
- <span class="cline-any cline-yes">5x</span>
280
- <span class="cline-any cline-neutral">&nbsp;</span>
281
- <span class="cline-any cline-neutral">&nbsp;</span>
282
- <span class="cline-any cline-neutral">&nbsp;</span>
283
- <span class="cline-any cline-neutral">&nbsp;</span>
284
- <span class="cline-any cline-yes">95x</span>
285
- <span class="cline-any cline-neutral">&nbsp;</span>
286
- <span class="cline-any cline-yes">95x</span>
287
- <span class="cline-any cline-neutral">&nbsp;</span>
288
- <span class="cline-any cline-yes">95x</span>
289
- <span class="cline-any cline-yes">10x</span>
290
- <span class="cline-any cline-neutral">&nbsp;</span>
291
- <span class="cline-any cline-neutral">&nbsp;</span>
292
- <span class="cline-any cline-yes">85x</span>
293
- <span class="cline-any cline-neutral">&nbsp;</span>
294
- <span class="cline-any cline-neutral">&nbsp;</span>
295
- <span class="cline-any cline-neutral">&nbsp;</span>
296
- <span class="cline-any cline-neutral">&nbsp;</span>
297
- <span class="cline-any cline-neutral">&nbsp;</span>
298
- <span class="cline-any cline-neutral">&nbsp;</span>
299
- <span class="cline-any cline-neutral">&nbsp;</span>
300
- <span class="cline-any cline-neutral">&nbsp;</span>
301
- <span class="cline-any cline-neutral">&nbsp;</span>
302
- <span class="cline-any cline-neutral">&nbsp;</span>
303
- <span class="cline-any cline-neutral">&nbsp;</span>
304
- <span class="cline-any cline-neutral">&nbsp;</span>
305
- <span class="cline-any cline-neutral">&nbsp;</span>
306
- <span class="cline-any cline-neutral">&nbsp;</span>
307
- <span class="cline-any cline-neutral">&nbsp;</span>
308
- <span class="cline-any cline-neutral">&nbsp;</span>
309
- <span class="cline-any cline-neutral">&nbsp;</span>
310
- <span class="cline-any cline-neutral">&nbsp;</span>
311
- <span class="cline-any cline-neutral">&nbsp;</span>
312
- <span class="cline-any cline-neutral">&nbsp;</span>
313
- <span class="cline-any cline-neutral">&nbsp;</span>
314
- <span class="cline-any cline-neutral">&nbsp;</span>
315
- <span class="cline-any cline-neutral">&nbsp;</span>
316
- <span class="cline-any cline-neutral">&nbsp;</span>
317
- <span class="cline-any cline-neutral">&nbsp;</span>
318
- <span class="cline-any cline-yes">2x</span>
319
- <span class="cline-any cline-neutral">&nbsp;</span>
320
- <span class="cline-any cline-yes">95x</span>
321
- <span class="cline-any cline-yes">95x</span>
322
- <span class="cline-any cline-neutral">&nbsp;</span>
323
- <span class="cline-any cline-neutral">&nbsp;</span>
324
- <span class="cline-any cline-neutral">&nbsp;</span>
325
- <span class="cline-any cline-neutral">&nbsp;</span>
326
- <span class="cline-any cline-neutral">&nbsp;</span>
327
- <span class="cline-any cline-neutral">&nbsp;</span>
328
- <span class="cline-any cline-yes">95x</span>
329
- <span class="cline-any cline-neutral">&nbsp;</span>
330
- <span class="cline-any cline-yes">95x</span>
331
- <span class="cline-any cline-yes">2x</span>
332
- <span class="cline-any cline-neutral">&nbsp;</span>
333
- <span class="cline-any cline-yes">2x</span>
334
- <span class="cline-any cline-neutral">&nbsp;</span>
335
- <span class="cline-any cline-neutral">&nbsp;</span>
336
- <span class="cline-any cline-neutral">&nbsp;</span>
337
- <span class="cline-any cline-neutral">&nbsp;</span>
338
- <span class="cline-any cline-neutral">&nbsp;</span>
339
- <span class="cline-any cline-yes">93x</span>
340
- <span class="cline-any cline-neutral">&nbsp;</span>
341
- <span class="cline-any cline-neutral">&nbsp;</span>
342
- <span class="cline-any cline-neutral">&nbsp;</span>
343
- <span class="cline-any cline-neutral">&nbsp;</span>
344
- <span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">import * as murmurhash from "murmurhash";
345
- import { Feature, BucketKey, BucketValue, Context, AttributeValue } from "@featurevisor/types";
346
- &nbsp;
347
- import { Logger } from "./logger";
348
- &nbsp;
349
- /**
350
- * Generic hashing
351
- */
352
- const HASH_SEED = 1;
353
- const MAX_HASH_VALUE = Math.pow(2, 32);
354
- &nbsp;
355
- export const MAX_BUCKETED_NUMBER = 100000; // 100% * 1000 to include three decimal places in the same integer value
356
- &nbsp;
357
- export function getBucketedNumber(bucketKey: string): number {
358
- const hashValue = murmurhash.v3(bucketKey, HASH_SEED);
359
- const ratio = hashValue / MAX_HASH_VALUE;
360
- &nbsp;
361
- return Math.floor(ratio * MAX_BUCKETED_NUMBER);
362
- }
363
- &nbsp;
364
- /**
365
- * Feature specific bucketing
366
- */
367
- export type ConfigureBucketKey = (
368
- feature: Feature,
369
- context: Context,
370
- bucketKey: BucketKey,
371
- ) =&gt; BucketKey;
372
- &nbsp;
373
- export interface BucketKeyOptions {
374
- feature: Feature;
375
- context: Context;
376
- logger: Logger;
377
- bucketKeySeparator?: string;
378
- configureBucketKey?: ConfigureBucketKey;
379
- }
380
- &nbsp;
381
- export function getBucketKey(options: BucketKeyOptions): BucketKey {
382
- const { feature, context, logger, bucketKeySeparator = <span class="branch-0 cbranch-no" title="branch not covered" >".",</span> configureBucketKey } = options;
383
- &nbsp;
384
- const featureKey = feature.key;
385
- &nbsp;
386
- let type;
387
- let attributeKeys;
388
- &nbsp;
389
- if (typeof feature.bucketBy === "string") {
390
- type = "plain";
391
- attributeKeys = [feature.bucketBy];
392
- } else if (Array.isArray(feature.bucketBy)) {
393
- type = "and";
394
- attributeKeys = feature.bucketBy;
395
- } else if (typeof feature.bucketBy === "object" &amp;&amp; Array.isArray(feature.bucketBy.or)) {
396
- type = "or";
397
- attributeKeys = feature.bucketBy.or;
398
- } else <span class="missing-if-branch" title="else path not taken" >E</span>{
399
- <span class="cstat-no" title="statement not covered" > logger.error("invalid bucketBy", { featureKey, bucketBy: feature.bucketBy });</span>
400
- &nbsp;
401
- <span class="cstat-no" title="statement not covered" > throw new Error("invalid bucketBy");</span>
402
- }
403
- &nbsp;
404
- const bucketKey: AttributeValue[] = [];
405
- &nbsp;
406
- attributeKeys.forEach((attributeKey) =&gt; {
407
- const attributeValue = context[attributeKey];
408
- &nbsp;
409
- if (typeof attributeValue === "undefined") {
410
- return;
411
- }
412
- &nbsp;
413
- if (type === "plain" || type === "and") {
414
- bucketKey.push(attributeValue);
415
- } else {
416
- // or
417
- if (bucketKey.length === 0) {
418
- bucketKey.push(attributeValue);
419
- }
420
- }
421
- });
422
- &nbsp;
423
- bucketKey.push(featureKey);
424
- &nbsp;
425
- const result = bucketKey.join(bucketKeySeparator);
426
- &nbsp;
427
- if (configureBucketKey) {
428
- return configureBucketKey(feature, context, result);
429
- }
430
- &nbsp;
431
- return result;
432
- }
433
- &nbsp;
434
- export interface Bucket {
435
- bucketKey: BucketKey;
436
- bucketValue: BucketValue;
437
- }
438
- &nbsp;
439
- export type ConfigureBucketValue = (
440
- feature: Feature,
441
- context: Context,
442
- bucketValue: BucketValue,
443
- ) =&gt; BucketValue;
444
- &nbsp;
445
- export interface BucketValueOptions {
446
- // common with BucketKeyOptions
447
- feature: Feature;
448
- context: Context;
449
- logger: Logger;
450
- bucketKeySeparator?: string;
451
- configureBucketKey?: ConfigureBucketKey;
452
- &nbsp;
453
- // specific to BucketValueOptions
454
- configureBucketValue?: ConfigureBucketValue;
455
- }
456
- &nbsp;
457
- export function getBucket(options: BucketValueOptions): Bucket {
458
- const { feature, context, logger, bucketKeySeparator, configureBucketKey, configureBucketValue } =
459
- options;
460
- const bucketKey = getBucketKey({
461
- feature,
462
- context,
463
- logger,
464
- bucketKeySeparator,
465
- configureBucketKey,
466
- });
467
- const value = getBucketedNumber(bucketKey);
468
- &nbsp;
469
- if (configureBucketValue) {
470
- const configuredValue = configureBucketValue(feature, context, value);
471
- &nbsp;
472
- return {
473
- bucketKey,
474
- bucketValue: configuredValue,
475
- };
476
- }
477
- &nbsp;
478
- return {
479
- bucketKey,
480
- bucketValue: value,
481
- };
482
- }
483
- &nbsp;</pre></td></tr></table></pre>
484
-
485
- <div class='push'></div><!-- for sticky footer -->
486
- </div><!-- /wrapper -->
487
- <div class='footer quiet pad2 space-top1 center small'>
488
- Code coverage generated by
489
- <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
490
- at 2025-03-31T21:26:29.644Z
491
- </div>
492
- <script src="prettify.js"></script>
493
- <script>
494
- window.onload = function () {
495
- prettyPrint();
496
- };
497
- </script>
498
- <script src="sorter.js"></script>
499
- <script src="block-navigation.js"></script>
500
- </body>
501
- </html>
502
-
package/dist/bucket.d.ts DELETED
@@ -1,30 +0,0 @@
1
- import { Feature, BucketKey, BucketValue, Context } from "@featurevisor/types";
2
- import { Logger } from "./logger";
3
- export declare const MAX_BUCKETED_NUMBER = 100000;
4
- export declare function getBucketedNumber(bucketKey: string): number;
5
- /**
6
- * Feature specific bucketing
7
- */
8
- export type ConfigureBucketKey = (feature: Feature, context: Context, bucketKey: BucketKey) => BucketKey;
9
- export interface BucketKeyOptions {
10
- feature: Feature;
11
- context: Context;
12
- logger: Logger;
13
- bucketKeySeparator?: string;
14
- configureBucketKey?: ConfigureBucketKey;
15
- }
16
- export declare function getBucketKey(options: BucketKeyOptions): BucketKey;
17
- export interface Bucket {
18
- bucketKey: BucketKey;
19
- bucketValue: BucketValue;
20
- }
21
- export type ConfigureBucketValue = (feature: Feature, context: Context, bucketValue: BucketValue) => BucketValue;
22
- export interface BucketValueOptions {
23
- feature: Feature;
24
- context: Context;
25
- logger: Logger;
26
- bucketKeySeparator?: string;
27
- configureBucketKey?: ConfigureBucketKey;
28
- configureBucketValue?: ConfigureBucketValue;
29
- }
30
- export declare function getBucket(options: BucketValueOptions): Bucket;
package/dist/feature.d.ts DELETED
@@ -1,16 +0,0 @@
1
- import { Allocation, Context, Traffic, Feature, Force } from "@featurevisor/types";
2
- import { DatafileReader } from "./datafileReader";
3
- import { Logger } from "./logger";
4
- export declare function getMatchedAllocation(traffic: Traffic, bucketValue: number): Allocation | undefined;
5
- export declare function parseFromStringifiedSegments(value: any): any;
6
- export declare function getMatchedTraffic(traffic: Traffic[], context: Context, datafileReader: DatafileReader, logger: Logger): Traffic | undefined;
7
- export interface MatchedTrafficAndAllocation {
8
- matchedTraffic: Traffic | undefined;
9
- matchedAllocation: Allocation | undefined;
10
- }
11
- export declare function getMatchedTrafficAndAllocation(traffic: Traffic[], context: Context, bucketValue: number, datafileReader: DatafileReader, logger: Logger): MatchedTrafficAndAllocation;
12
- export interface ForceResult {
13
- force?: Force;
14
- forceIndex?: number;
15
- }
16
- export declare function findForceFromFeature(feature: Feature, context: Context, datafileReader: DatafileReader, logger: Logger): ForceResult;
package/dist/segments.d.ts DELETED
@@ -1,5 +0,0 @@
1
- import { Context, GroupSegment, Segment } from "@featurevisor/types";
2
- import { DatafileReader } from "./datafileReader";
3
- import { Logger } from "./logger";
4
- export declare function segmentIsMatched(segment: Segment, context: Context, logger: Logger): boolean;
5
- export declare function allGroupSegmentsAreMatched(groupSegments: GroupSegment | GroupSegment[] | "*", context: Context, datafileReader: DatafileReader, logger: Logger): boolean;
package/lib/bucket.d.ts DELETED
@@ -1,30 +0,0 @@
1
- import { Feature, BucketKey, BucketValue, Context } from "@featurevisor/types";
2
- import { Logger } from "./logger";
3
- export declare const MAX_BUCKETED_NUMBER = 100000;
4
- export declare function getBucketedNumber(bucketKey: string): number;
5
- /**
6
- * Feature specific bucketing
7
- */
8
- export type ConfigureBucketKey = (feature: Feature, context: Context, bucketKey: BucketKey) => BucketKey;
9
- export interface BucketKeyOptions {
10
- feature: Feature;
11
- context: Context;
12
- logger: Logger;
13
- bucketKeySeparator?: string;
14
- configureBucketKey?: ConfigureBucketKey;
15
- }
16
- export declare function getBucketKey(options: BucketKeyOptions): BucketKey;
17
- export interface Bucket {
18
- bucketKey: BucketKey;
19
- bucketValue: BucketValue;
20
- }
21
- export type ConfigureBucketValue = (feature: Feature, context: Context, bucketValue: BucketValue) => BucketValue;
22
- export interface BucketValueOptions {
23
- feature: Feature;
24
- context: Context;
25
- logger: Logger;
26
- bucketKeySeparator?: string;
27
- configureBucketKey?: ConfigureBucketKey;
28
- configureBucketValue?: ConfigureBucketValue;
29
- }
30
- export declare function getBucket(options: BucketValueOptions): Bucket;
package/lib/feature.d.ts DELETED
@@ -1,16 +0,0 @@
1
- import { Allocation, Context, Traffic, Feature, Force } from "@featurevisor/types";
2
- import { DatafileReader } from "./datafileReader";
3
- import { Logger } from "./logger";
4
- export declare function getMatchedAllocation(traffic: Traffic, bucketValue: number): Allocation | undefined;
5
- export declare function parseFromStringifiedSegments(value: any): any;
6
- export declare function getMatchedTraffic(traffic: Traffic[], context: Context, datafileReader: DatafileReader, logger: Logger): Traffic | undefined;
7
- export interface MatchedTrafficAndAllocation {
8
- matchedTraffic: Traffic | undefined;
9
- matchedAllocation: Allocation | undefined;
10
- }
11
- export declare function getMatchedTrafficAndAllocation(traffic: Traffic[], context: Context, bucketValue: number, datafileReader: DatafileReader, logger: Logger): MatchedTrafficAndAllocation;
12
- export interface ForceResult {
13
- force?: Force;
14
- forceIndex?: number;
15
- }
16
- export declare function findForceFromFeature(feature: Feature, context: Context, datafileReader: DatafileReader, logger: Logger): ForceResult;
package/lib/segments.d.ts DELETED
@@ -1,5 +0,0 @@
1
- import { Context, GroupSegment, Segment } from "@featurevisor/types";
2
- import { DatafileReader } from "./datafileReader";
3
- import { Logger } from "./logger";
4
- export declare function segmentIsMatched(segment: Segment, context: Context, logger: Logger): boolean;
5
- export declare function allGroupSegmentsAreMatched(groupSegments: GroupSegment | GroupSegment[] | "*", context: Context, datafileReader: DatafileReader, logger: Logger): boolean;
package/src/bucket.spec.ts DELETED
@@ -1,37 +0,0 @@
1
- import { getBucketedNumber, MAX_BUCKETED_NUMBER } from "./bucket";
2
-
3
- describe("sdk: Bucket", function () {
4
- it("should be a function", function () {
5
- expect(typeof getBucketedNumber).toEqual("function");
6
- });
7
-
8
- it("should return a number between 0 and 100000", function () {
9
- const keys = ["foo", "bar", "baz", "123adshlk348-93asdlk"];
10
-
11
- keys.forEach((key) => {
12
- const n = getBucketedNumber(key);
13
-
14
- expect(n >= 0).toEqual(true);
15
- expect(n <= MAX_BUCKETED_NUMBER).toEqual(true);
16
- });
17
- });
18
-
19
- // these assertions will be copied to unit tests of SDKs ported to other languages,
20
- // so we can keep consitent bucketing across all SDKs
21
- it("should return expected number for known keys", function () {
22
- const expectedResults = {
23
- foo: 20602,
24
- bar: 89144,
25
- "123.foo": 3151,
26
- "123.bar": 9710,
27
- "123.456.foo": 14432,
28
- "123.456.bar": 1982,
29
- };
30
-
31
- Object.keys(expectedResults).forEach((key) => {
32
- const n = getBucketedNumber(key);
33
-
34
- expect(n).toEqual(expectedResults[key]);
35
- });
36
- });
37
- });