@symbo.ls/sdk 2.34.35 → 3.1.2

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 (187) hide show
  1. package/README.md +2 -143
  2. package/dist/cjs/config/environment.js +30 -98
  3. package/dist/cjs/index.js +24 -144
  4. package/dist/cjs/services/AIService.js +155 -0
  5. package/dist/cjs/services/AuthService.js +305 -738
  6. package/dist/cjs/services/BaseService.js +6 -158
  7. package/dist/cjs/services/BasedService.js +1185 -0
  8. package/dist/cjs/services/CoreService.js +1751 -0
  9. package/dist/cjs/services/SocketIOService.js +307 -0
  10. package/dist/cjs/services/SocketService.js +161 -0
  11. package/dist/cjs/services/SymstoryService.js +571 -0
  12. package/dist/cjs/services/index.js +16 -64
  13. package/dist/cjs/utils/TokenManager.js +30 -78
  14. package/dist/cjs/utils/basedQuerys.js +181 -0
  15. package/dist/cjs/utils/services.js +103 -301
  16. package/dist/cjs/utils/symstoryClient.js +259 -0
  17. package/dist/cjs/utils/validation.js +3 -0
  18. package/dist/esm/config/environment.js +30 -98
  19. package/dist/esm/index.js +8797 -49416
  20. package/dist/esm/services/AIService.js +185 -0
  21. package/dist/esm/services/AuthService.js +386 -1493
  22. package/dist/esm/services/BaseService.js +6 -757
  23. package/dist/esm/services/BasedService.js +5278 -0
  24. package/dist/esm/services/CoreService.js +2264 -0
  25. package/dist/esm/services/SocketIOService.js +470 -0
  26. package/dist/esm/services/SocketService.js +191 -0
  27. package/dist/esm/services/SymstoryService.js +7041 -0
  28. package/dist/esm/services/index.js +8690 -49015
  29. package/dist/esm/utils/TokenManager.js +30 -78
  30. package/dist/esm/utils/basedQuerys.js +163 -0
  31. package/dist/esm/utils/services.js +103 -301
  32. package/dist/esm/utils/symstoryClient.js +370 -0
  33. package/dist/esm/utils/validation.js +7 -4
  34. package/dist/node/config/environment.js +30 -98
  35. package/dist/node/index.js +32 -175
  36. package/dist/node/services/AIService.js +136 -0
  37. package/dist/node/services/AuthService.js +310 -742
  38. package/dist/node/services/BaseService.js +6 -148
  39. package/dist/node/services/BasedService.js +1156 -0
  40. package/dist/node/services/CoreService.js +1722 -0
  41. package/dist/node/services/SocketIOService.js +278 -0
  42. package/dist/node/services/SocketService.js +142 -0
  43. package/dist/node/services/SymstoryService.js +542 -0
  44. package/dist/node/services/index.js +16 -64
  45. package/dist/node/utils/TokenManager.js +30 -78
  46. package/dist/node/utils/basedQuerys.js +162 -0
  47. package/dist/node/utils/services.js +103 -301
  48. package/dist/node/utils/symstoryClient.js +230 -0
  49. package/dist/node/utils/validation.js +3 -0
  50. package/package.json +16 -35
  51. package/src/config/environment.js +28 -99
  52. package/src/index.js +36 -181
  53. package/src/services/AIService.js +150 -0
  54. package/src/services/AuthService.js +328 -874
  55. package/src/services/BaseService.js +6 -166
  56. package/src/services/BasedService.js +1301 -0
  57. package/src/services/CoreService.js +1943 -0
  58. package/src/services/SocketIOService.js +334 -0
  59. package/src/services/SocketService.js +168 -0
  60. package/src/services/SymstoryService.js +649 -0
  61. package/src/services/index.js +13 -80
  62. package/src/utils/TokenManager.js +33 -88
  63. package/src/utils/basedQuerys.js +164 -0
  64. package/src/utils/services.js +107 -326
  65. package/src/utils/symstoryClient.js +252 -0
  66. package/src/utils/validation.js +3 -0
  67. package/dist/cjs/services/AdminService.js +0 -351
  68. package/dist/cjs/services/BranchService.js +0 -484
  69. package/dist/cjs/services/CollabService.js +0 -743
  70. package/dist/cjs/services/DnsService.js +0 -340
  71. package/dist/cjs/services/FeatureFlagService.js +0 -175
  72. package/dist/cjs/services/FileService.js +0 -201
  73. package/dist/cjs/services/IntegrationService.js +0 -538
  74. package/dist/cjs/services/MetricsService.js +0 -62
  75. package/dist/cjs/services/PaymentService.js +0 -271
  76. package/dist/cjs/services/PlanService.js +0 -426
  77. package/dist/cjs/services/ProjectService.js +0 -1207
  78. package/dist/cjs/services/PullRequestService.js +0 -503
  79. package/dist/cjs/services/ScreenshotService.js +0 -304
  80. package/dist/cjs/services/SubscriptionService.js +0 -396
  81. package/dist/cjs/services/TrackingService.js +0 -661
  82. package/dist/cjs/services/WaitlistService.js +0 -148
  83. package/dist/cjs/state/RootStateManager.js +0 -65
  84. package/dist/cjs/state/rootEventBus.js +0 -74
  85. package/dist/cjs/utils/CollabClient.js +0 -223
  86. package/dist/cjs/utils/changePreprocessor.js +0 -199
  87. package/dist/cjs/utils/jsonDiff.js +0 -145
  88. package/dist/cjs/utils/ordering.js +0 -309
  89. package/dist/esm/services/AdminService.js +0 -1132
  90. package/dist/esm/services/BranchService.js +0 -1265
  91. package/dist/esm/services/CollabService.js +0 -26838
  92. package/dist/esm/services/DnsService.js +0 -1121
  93. package/dist/esm/services/FeatureFlagService.js +0 -956
  94. package/dist/esm/services/FileService.js +0 -982
  95. package/dist/esm/services/IntegrationService.js +0 -1319
  96. package/dist/esm/services/MetricsService.js +0 -843
  97. package/dist/esm/services/PaymentService.js +0 -1052
  98. package/dist/esm/services/PlanService.js +0 -1207
  99. package/dist/esm/services/ProjectService.js +0 -2526
  100. package/dist/esm/services/PullRequestService.js +0 -1284
  101. package/dist/esm/services/ScreenshotService.js +0 -1085
  102. package/dist/esm/services/SubscriptionService.js +0 -1177
  103. package/dist/esm/services/TrackingService.js +0 -18343
  104. package/dist/esm/services/WaitlistService.js +0 -929
  105. package/dist/esm/state/RootStateManager.js +0 -90
  106. package/dist/esm/state/rootEventBus.js +0 -56
  107. package/dist/esm/utils/CollabClient.js +0 -18901
  108. package/dist/esm/utils/changePreprocessor.js +0 -542
  109. package/dist/esm/utils/jsonDiff.js +0 -7011
  110. package/dist/esm/utils/ordering.js +0 -291
  111. package/dist/node/services/AdminService.js +0 -332
  112. package/dist/node/services/BranchService.js +0 -465
  113. package/dist/node/services/CollabService.js +0 -724
  114. package/dist/node/services/DnsService.js +0 -321
  115. package/dist/node/services/FeatureFlagService.js +0 -156
  116. package/dist/node/services/FileService.js +0 -182
  117. package/dist/node/services/IntegrationService.js +0 -519
  118. package/dist/node/services/MetricsService.js +0 -43
  119. package/dist/node/services/PaymentService.js +0 -252
  120. package/dist/node/services/PlanService.js +0 -407
  121. package/dist/node/services/ProjectService.js +0 -1188
  122. package/dist/node/services/PullRequestService.js +0 -484
  123. package/dist/node/services/ScreenshotService.js +0 -285
  124. package/dist/node/services/SubscriptionService.js +0 -377
  125. package/dist/node/services/TrackingService.js +0 -632
  126. package/dist/node/services/WaitlistService.js +0 -129
  127. package/dist/node/state/RootStateManager.js +0 -36
  128. package/dist/node/state/rootEventBus.js +0 -55
  129. package/dist/node/utils/CollabClient.js +0 -194
  130. package/dist/node/utils/changePreprocessor.js +0 -180
  131. package/dist/node/utils/jsonDiff.js +0 -116
  132. package/dist/node/utils/ordering.js +0 -290
  133. package/src/services/AdminService.js +0 -374
  134. package/src/services/BranchService.js +0 -536
  135. package/src/services/CollabService.js +0 -900
  136. package/src/services/DnsService.js +0 -366
  137. package/src/services/FeatureFlagService.js +0 -174
  138. package/src/services/FileService.js +0 -213
  139. package/src/services/IntegrationService.js +0 -548
  140. package/src/services/MetricsService.js +0 -40
  141. package/src/services/PaymentService.js +0 -287
  142. package/src/services/PlanService.js +0 -468
  143. package/src/services/ProjectService.js +0 -1366
  144. package/src/services/PullRequestService.js +0 -537
  145. package/src/services/ScreenshotService.js +0 -258
  146. package/src/services/SubscriptionService.js +0 -425
  147. package/src/services/TrackingService.js +0 -853
  148. package/src/services/WaitlistService.js +0 -130
  149. package/src/services/tests/BranchService/createBranch.test.js +0 -153
  150. package/src/services/tests/BranchService/deleteBranch.test.js +0 -173
  151. package/src/services/tests/BranchService/getBranchChanges.test.js +0 -146
  152. package/src/services/tests/BranchService/listBranches.test.js +0 -87
  153. package/src/services/tests/BranchService/mergeBranch.test.js +0 -210
  154. package/src/services/tests/BranchService/publishVersion.test.js +0 -183
  155. package/src/services/tests/BranchService/renameBranch.test.js +0 -240
  156. package/src/services/tests/BranchService/resetBranch.test.js +0 -152
  157. package/src/services/tests/FeatureFlagService/adminFeatureFlags.test.js +0 -67
  158. package/src/services/tests/FeatureFlagService/getFeatureFlags.test.js +0 -75
  159. package/src/services/tests/FileService/createFileFormData.test.js +0 -74
  160. package/src/services/tests/FileService/getFileUrl.test.js +0 -69
  161. package/src/services/tests/FileService/updateProjectIcon.test.js +0 -109
  162. package/src/services/tests/FileService/uploadDocument.test.js +0 -36
  163. package/src/services/tests/FileService/uploadFile.test.js +0 -78
  164. package/src/services/tests/FileService/uploadFileWithValidation.test.js +0 -114
  165. package/src/services/tests/FileService/uploadImage.test.js +0 -36
  166. package/src/services/tests/FileService/uploadMultipleFiles.test.js +0 -111
  167. package/src/services/tests/FileService/validateFile.test.js +0 -63
  168. package/src/services/tests/PlanService/createPlan.test.js +0 -104
  169. package/src/services/tests/PlanService/createPlanWithValidation.test.js +0 -523
  170. package/src/services/tests/PlanService/deletePlan.test.js +0 -92
  171. package/src/services/tests/PlanService/getActivePlans.test.js +0 -123
  172. package/src/services/tests/PlanService/getAdminPlans.test.js +0 -84
  173. package/src/services/tests/PlanService/getPlan.test.js +0 -50
  174. package/src/services/tests/PlanService/getPlanByKey.test.js +0 -109
  175. package/src/services/tests/PlanService/getPlanWithValidation.test.js +0 -85
  176. package/src/services/tests/PlanService/getPlans.test.js +0 -53
  177. package/src/services/tests/PlanService/getPlansByPriceRange.test.js +0 -109
  178. package/src/services/tests/PlanService/getPlansWithValidation.test.js +0 -48
  179. package/src/services/tests/PlanService/initializePlans.test.js +0 -75
  180. package/src/services/tests/PlanService/updatePlan.test.js +0 -111
  181. package/src/services/tests/PlanService/updatePlanWithValidation.test.js +0 -556
  182. package/src/state/RootStateManager.js +0 -76
  183. package/src/state/rootEventBus.js +0 -67
  184. package/src/utils/CollabClient.js +0 -248
  185. package/src/utils/changePreprocessor.js +0 -239
  186. package/src/utils/jsonDiff.js +0 -144
  187. package/src/utils/ordering.js +0 -271
@@ -1,366 +0,0 @@
1
- import { BaseService } from './BaseService.js'
2
-
3
- export class DnsService extends BaseService {
4
- // ==================== DNS METHODS ====================
5
-
6
- async createDnsRecord (domain, options = {}) {
7
- this._requireReady('createDnsRecord')
8
- if (!domain) {
9
- throw new Error('Domain is required')
10
- }
11
- try {
12
- const response = await this._request('/dns/records', {
13
- method: 'POST',
14
- body: JSON.stringify({ domain, ...options }),
15
- methodName: 'createDnsRecord'
16
- })
17
- if (response.success) {
18
- return response.data
19
- }
20
- throw new Error(response.message)
21
- } catch (error) {
22
- throw new Error(`Failed to create DNS record: ${error.message}`, { cause: error })
23
- }
24
- }
25
-
26
- async getDnsRecord (domain) {
27
- this._requireReady('getDnsRecord')
28
- if (!domain) {
29
- throw new Error('Domain is required')
30
- }
31
- try {
32
- const response = await this._request(`/dns/records/${domain}`, {
33
- method: 'GET',
34
- methodName: 'getDnsRecord'
35
- })
36
- if (response.success) {
37
- return response.data
38
- }
39
- throw new Error(response.message)
40
- } catch (error) {
41
- throw new Error(`Failed to get DNS record: ${error.message}`, { cause: error })
42
- }
43
- }
44
-
45
- async getCustomHost (hostname) {
46
- this._requireReady('getCustomHost')
47
- if (!hostname) {
48
- throw new Error('Hostname is required')
49
- }
50
- try {
51
- const response = await this._request(`/dns/custom-hosts/${encodeURIComponent(hostname)}`, {
52
- method: 'GET',
53
- methodName: 'getCustomHost'
54
- })
55
- if (response.success) {
56
- return response.data
57
- }
58
- throw new Error(response.message)
59
- } catch (error) {
60
- throw new Error(`Failed to get custom host: ${error.message}`, { cause: error })
61
- }
62
- }
63
-
64
- async removeDnsRecord (domain) {
65
- this._requireReady('removeDnsRecord')
66
- if (!domain) {
67
- throw new Error('Domain is required')
68
- }
69
- try {
70
- const response = await this._request(`/dns/records/${domain}`, {
71
- method: 'DELETE',
72
- methodName: 'removeDnsRecord'
73
- })
74
- if (response.success) {
75
- return response.data
76
- }
77
- throw new Error(response.message)
78
- } catch (error) {
79
- throw new Error(`Failed to remove DNS record: ${error.message}`, { cause: error })
80
- }
81
- }
82
-
83
- // customDomains could be a string or an array of strings
84
- async addProjectCustomDomains (projectId, customDomains, options = {}) {
85
- this._requireReady('addProjectCustomDomains')
86
- if (!projectId) {
87
- throw new Error('Project ID is required')
88
- }
89
- if (
90
- !customDomains ||
91
- (Array.isArray(customDomains) && !customDomains.length)
92
- ) {
93
- throw new Error(
94
- 'customDomains is required and must be a non-empty string or array'
95
- )
96
- }
97
-
98
- const { envKey, headers } = options
99
-
100
- try {
101
- const response = await this._request(`/projects/${projectId}/domains`, {
102
- method: 'PATCH',
103
- body: JSON.stringify({
104
- customDomains,
105
- ...(envKey ? { envKey } : {})
106
- }),
107
- ...(headers ? { headers } : {}),
108
- methodName: 'addProjectCustomDomains'
109
- })
110
- if (response.success) {
111
- return response.data
112
- }
113
- throw new Error(response.message)
114
- } catch (error) {
115
- throw new Error(
116
- `Failed to update project custom domains: ${error.message}`, { cause: error }
117
- )
118
- }
119
- }
120
-
121
- // ==================== DNS HELPER METHODS ====================
122
-
123
- /**
124
- * Helper method to validate domain format
125
- */
126
- validateDomain (domain) {
127
- if (!domain || typeof domain !== 'string') {
128
- return {
129
- isValid: false,
130
- error: 'Domain must be a non-empty string'
131
- }
132
- }
133
-
134
- // Basic domain validation regex
135
- const domainRegex = /^[a-zA-Z0-9](?:(?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)?(?:\.[a-zA-Z0-9](?:(?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)?)*$/u
136
-
137
- if (!domainRegex.test(domain)) {
138
- return {
139
- isValid: false,
140
- error: 'Invalid domain format'
141
- }
142
- }
143
-
144
- // Check for valid TLD
145
- const tldRegex = /\.[a-zA-Z]{2,}$/u
146
- if (!tldRegex.test(domain)) {
147
- return {
148
- isValid: false,
149
- error: 'Domain must have a valid top-level domain'
150
- }
151
- }
152
-
153
- return {
154
- isValid: true,
155
- error: null
156
- }
157
- }
158
-
159
- /**
160
- * Helper method to create DNS record with validation
161
- */
162
- async createDnsRecordWithValidation (domain, options = {}) {
163
- const validation = this.validateDomain(domain)
164
- if (!validation.isValid) {
165
- throw new Error(validation.error)
166
- }
167
-
168
- return await this.createDnsRecord(domain, options)
169
- }
170
-
171
- /**
172
- * Helper method to get DNS record with validation
173
- */
174
- async getDnsRecordWithValidation (domain) {
175
- const validation = this.validateDomain(domain)
176
- if (!validation.isValid) {
177
- throw new Error(validation.error)
178
- }
179
-
180
- return await this.getDnsRecord(domain)
181
- }
182
-
183
- /**
184
- * Helper method to remove DNS record with validation
185
- */
186
- async removeDnsRecordWithValidation (domain) {
187
- const validation = this.validateDomain(domain)
188
- if (!validation.isValid) {
189
- throw new Error(validation.error)
190
- }
191
-
192
- return await this.removeDnsRecord(domain)
193
- }
194
-
195
- /**
196
- * Helper method to add project custom domains with validation
197
- */
198
- async addProjectCustomDomainsWithValidation (projectId, customDomains, options = {}) {
199
- if (!projectId || typeof projectId !== 'string') {
200
- throw new Error('Project ID must be a valid string')
201
- }
202
-
203
- if (!customDomains) {
204
- throw new Error('Custom domains are required')
205
- }
206
-
207
- // Handle both string and array inputs
208
- const domainsArray = Array.isArray(customDomains) ? customDomains : [customDomains]
209
-
210
- if (domainsArray.length === 0) {
211
- throw new Error('At least one custom domain is required')
212
- }
213
-
214
- // Validate each domain
215
- for (const domain of domainsArray) {
216
- const validation = this.validateDomain(domain)
217
- if (!validation.isValid) {
218
- throw new Error(`Invalid domain '${domain}': ${validation.error}`)
219
- }
220
- }
221
-
222
- return await this.addProjectCustomDomains(projectId, customDomains, options)
223
- }
224
-
225
- /**
226
- * Helper method to check if domain is available
227
- */
228
- async isDomainAvailable (domain) {
229
- try {
230
- await this.getDnsRecord(domain)
231
- return false // Domain exists
232
- } catch (error) {
233
- if (error.message.includes('not found') || error.message.includes('404')) {
234
- return true // Domain is available
235
- }
236
- throw error // Other error occurred
237
- }
238
- }
239
-
240
- /**
241
- * Helper method to get domain status
242
- */
243
- async getDomainStatus (domain) {
244
- try {
245
- const record = await this.getDnsRecord(domain)
246
- return {
247
- exists: true,
248
- active: record.active || false,
249
- verified: record.verified || false,
250
- record
251
- }
252
- } catch (error) {
253
- if (error.message.includes('not found') || error.message.includes('404')) {
254
- return {
255
- exists: false,
256
- active: false,
257
- verified: false,
258
- error: 'Domain not found'
259
- }
260
- }
261
- throw error
262
- }
263
- }
264
-
265
- /**
266
- * Helper method to verify domain ownership
267
- */
268
- async verifyDomainOwnership (domain) {
269
- try {
270
- const record = await this.getDnsRecord(domain)
271
-
272
- if (!record.verified) {
273
- // Domain needs verification
274
- return {
275
- verified: false,
276
- needsVerification: true,
277
- verificationMethod: record.verificationMethod || 'dns',
278
- verificationRecord: record.verificationRecord
279
- }
280
- }
281
-
282
- return {
283
- verified: true,
284
- needsVerification: false
285
- }
286
- } catch (error) {
287
- throw new Error(`Failed to verify domain ownership: ${error.message}`, { cause: error })
288
- }
289
- }
290
-
291
- /**
292
- * Helper method to get project domains
293
- */
294
- async getProjectDomains (projectId) {
295
- this._requireReady('getProjectDomains')
296
- if (!projectId) {
297
- throw new Error('Project ID is required')
298
- }
299
-
300
- try {
301
- const response = await this._request(`/projects/${projectId}/domains`, {
302
- method: 'GET',
303
- methodName: 'getProjectDomains'
304
- })
305
- if (response.success) {
306
- return response.data
307
- }
308
- throw new Error(response.message)
309
- } catch (error) {
310
- throw new Error(`Failed to get project domains: ${error.message}`, { cause: error })
311
- }
312
- }
313
-
314
- /**
315
- * Helper method to remove project custom domain
316
- */
317
- async removeProjectCustomDomain (projectId, domain) {
318
- this._requireReady('removeProjectCustomDomain')
319
- if (!projectId) {
320
- throw new Error('Project ID is required')
321
- }
322
- if (!domain) {
323
- throw new Error('Domain is required')
324
- }
325
-
326
- try {
327
- const response = await this._request(`/projects/${projectId}/domains/${encodeURIComponent(domain)}`, {
328
- method: 'DELETE',
329
- methodName: 'removeProjectCustomDomain'
330
- })
331
- if (response.success) {
332
- return response.data
333
- }
334
- throw new Error(response.message)
335
- } catch (error) {
336
- throw new Error(`Failed to remove project custom domain: ${error.message}`, { cause: error })
337
- }
338
- }
339
-
340
- /**
341
- * Helper method to format domain for display
342
- */
343
- formatDomain (domain) {
344
- if (!domain) {
345
- return ''
346
- }
347
-
348
- // Remove protocol if present
349
- const cleanDomain = domain.replace(/^https?:\/\//u, '')
350
-
351
- // Remove trailing slash
352
- return cleanDomain.replace(/\/$/u, '')
353
- }
354
-
355
- /**
356
- * Helper method to extract domain from URL
357
- */
358
- extractDomainFromUrl (url) {
359
- try {
360
- const urlObj = new URL(url)
361
- return urlObj.hostname
362
- } catch {
363
- return null
364
- }
365
- }
366
- }
@@ -1,174 +0,0 @@
1
- import { BaseService } from './BaseService.js'
2
-
3
- function normalizeKeysParam (keys) {
4
- if (!keys) { return null }
5
- if (Array.isArray(keys)) {
6
- const flattened = keys.flatMap(k => String(k).split(','))
7
- const cleaned = flattened.map(s => s.trim()).filter(Boolean)
8
- return cleaned.length ? cleaned.join(',') : null
9
- }
10
- const cleaned = String(keys)
11
- .split(',')
12
- .map(s => s.trim())
13
- .filter(Boolean)
14
- return cleaned.length ? cleaned.join(',') : null
15
- }
16
-
17
- export class FeatureFlagService extends BaseService {
18
- // ==================== USER FEATURE FLAGS (optional auth) ====================
19
-
20
- /**
21
- * Evaluate feature flags for the current user (or anonymous).
22
- * @param {Object} [params]
23
- * @param {string[]|string} [params.keys] Optional subset of keys (array or comma-separated string)
24
- * @returns {Promise<{flags: Record<string, {enabled: boolean, variant: string|null, payload: any}>}>}
25
- */
26
- async getFeatureFlags (params = {}) {
27
- this._requireReady('getFeatureFlags')
28
- const { keys } = params || {}
29
-
30
- const queryParams = new URLSearchParams()
31
- const keysParam = normalizeKeysParam(keys)
32
- if (keysParam) {
33
- queryParams.append('keys', keysParam)
34
- }
35
-
36
- const queryString = queryParams.toString()
37
- const url = `/feature-flags${queryString ? `?${queryString}` : ''}`
38
-
39
- try {
40
- const response = await this._request(url, {
41
- method: 'GET',
42
- methodName: 'getFeatureFlags'
43
- })
44
- if (response.success) {
45
- return response.data
46
- }
47
- throw new Error(response.message)
48
- } catch (error) {
49
- throw new Error(`Failed to get feature flags: ${error.message}`, { cause: error })
50
- }
51
- }
52
-
53
- /**
54
- * Evaluate a single feature flag for the current user (or anonymous).
55
- */
56
- async getFeatureFlag (key) {
57
- this._requireReady('getFeatureFlag')
58
- if (!key) {
59
- throw new Error('Feature flag key is required')
60
- }
61
-
62
- try {
63
- const response = await this._request(`/feature-flags/${encodeURIComponent(String(key))}`, {
64
- method: 'GET',
65
- methodName: 'getFeatureFlag'
66
- })
67
- if (response.success) {
68
- return response.data
69
- }
70
- throw new Error(response.message)
71
- } catch (error) {
72
- throw new Error(`Failed to get feature flag: ${error.message}`, { cause: error })
73
- }
74
- }
75
-
76
- // ==================== ADMIN FEATURE FLAGS (admin only) ====================
77
-
78
- async getAdminFeatureFlags (params = {}) {
79
- this._requireReady('getAdminFeatureFlags')
80
- const { includeArchived = true } = params || {}
81
-
82
- const queryParams = new URLSearchParams()
83
- if (includeArchived === false) {
84
- queryParams.append('includeArchived', 'false')
85
- }
86
-
87
- const queryString = queryParams.toString()
88
- const url = `/admin/feature-flags${queryString ? `?${queryString}` : ''}`
89
-
90
- try {
91
- const response = await this._request(url, {
92
- method: 'GET',
93
- methodName: 'getAdminFeatureFlags'
94
- })
95
- if (response.success) {
96
- return response.data
97
- }
98
- throw new Error(response.message)
99
- } catch (error) {
100
- throw new Error(`Failed to get admin feature flags: ${error.message}`, {
101
- cause: error
102
- })
103
- }
104
- }
105
-
106
- async createFeatureFlag (flagData) {
107
- this._requireReady('createFeatureFlag')
108
- if (!flagData || typeof flagData !== 'object') {
109
- throw new Error('Feature flag data is required')
110
- }
111
- if (!flagData.key) {
112
- throw new Error('Feature flag key is required')
113
- }
114
-
115
- try {
116
- const response = await this._request('/admin/feature-flags', {
117
- method: 'POST',
118
- body: JSON.stringify(flagData),
119
- methodName: 'createFeatureFlag'
120
- })
121
- if (response.success) {
122
- return response.data
123
- }
124
- throw new Error(response.message)
125
- } catch (error) {
126
- throw new Error(`Failed to create feature flag: ${error.message}`, { cause: error })
127
- }
128
- }
129
-
130
- async updateFeatureFlag (id, patch) {
131
- this._requireReady('updateFeatureFlag')
132
- if (!id) {
133
- throw new Error('Feature flag id is required')
134
- }
135
- if (!patch || typeof patch !== 'object') {
136
- throw new Error('Feature flag patch is required')
137
- }
138
-
139
- try {
140
- const response = await this._request(`/admin/feature-flags/${encodeURIComponent(String(id))}`, {
141
- method: 'PATCH',
142
- body: JSON.stringify(patch),
143
- methodName: 'updateFeatureFlag'
144
- })
145
- if (response.success) {
146
- return response.data
147
- }
148
- throw new Error(response.message)
149
- } catch (error) {
150
- throw new Error(`Failed to update feature flag: ${error.message}`, { cause: error })
151
- }
152
- }
153
-
154
- async archiveFeatureFlag (id) {
155
- this._requireReady('archiveFeatureFlag')
156
- if (!id) {
157
- throw new Error('Feature flag id is required')
158
- }
159
-
160
- try {
161
- const response = await this._request(`/admin/feature-flags/${encodeURIComponent(String(id))}`, {
162
- method: 'DELETE',
163
- methodName: 'archiveFeatureFlag'
164
- })
165
- if (response.success) {
166
- return response.data
167
- }
168
- throw new Error(response.message)
169
- } catch (error) {
170
- throw new Error(`Failed to archive feature flag: ${error.message}`, { cause: error })
171
- }
172
- }
173
- }
174
-