@symbo.ls/sdk 2.34.34 → 3.1.1

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 +13 -315
  2. package/dist/cjs/config/environment.js +50 -124
  3. package/dist/cjs/index.js +22 -169
  4. package/dist/cjs/services/AIService.js +155 -0
  5. package/dist/cjs/services/AuthService.js +277 -751
  6. package/dist/cjs/services/BaseService.js +6 -158
  7. package/dist/cjs/services/BasedService.js +679 -0
  8. package/dist/cjs/services/SocketIOService.js +309 -0
  9. package/dist/cjs/services/SocketService.js +161 -0
  10. package/dist/cjs/services/SymstoryService.js +485 -0
  11. package/dist/cjs/services/index.js +16 -64
  12. package/dist/cjs/utils/basedQuerys.js +61 -0
  13. package/dist/cjs/utils/permission.js +4 -4
  14. package/dist/cjs/utils/services.js +80 -301
  15. package/dist/cjs/utils/symstoryClient.js +228 -0
  16. package/dist/cjs/utils/validation.js +3 -0
  17. package/dist/esm/config/environment.js +50 -124
  18. package/dist/esm/index.js +11282 -49789
  19. package/dist/esm/services/AIService.js +185 -0
  20. package/dist/esm/services/AuthService.js +358 -1506
  21. package/dist/esm/services/BaseService.js +6 -757
  22. package/dist/esm/services/BasedService.js +4651 -0
  23. package/dist/esm/services/SocketIOService.js +467 -0
  24. package/dist/esm/services/SocketService.js +191 -0
  25. package/dist/esm/services/SymstoryService.js +6849 -0
  26. package/dist/esm/services/index.js +11188 -49352
  27. package/dist/esm/utils/basedQuerys.js +43 -0
  28. package/dist/esm/utils/permission.js +4 -4
  29. package/dist/esm/utils/services.js +80 -301
  30. package/dist/esm/utils/symstoryClient.js +334 -0
  31. package/dist/esm/utils/validation.js +26 -93
  32. package/dist/node/config/environment.js +50 -124
  33. package/dist/node/index.js +26 -202
  34. package/dist/node/services/AIService.js +136 -0
  35. package/dist/node/services/AuthService.js +278 -751
  36. package/dist/node/services/BaseService.js +6 -148
  37. package/dist/node/services/BasedService.js +650 -0
  38. package/dist/node/services/SocketIOService.js +280 -0
  39. package/dist/node/services/SocketService.js +142 -0
  40. package/dist/node/services/SymstoryService.js +456 -0
  41. package/dist/node/services/index.js +16 -64
  42. package/dist/node/utils/basedQuerys.js +42 -0
  43. package/dist/node/utils/permission.js +4 -4
  44. package/dist/node/utils/services.js +80 -301
  45. package/dist/node/utils/symstoryClient.js +199 -0
  46. package/dist/node/utils/validation.js +3 -0
  47. package/package.json +21 -43
  48. package/src/config/environment.js +50 -126
  49. package/src/index.js +24 -208
  50. package/src/services/AIService.js +150 -0
  51. package/src/services/AuthService.js +298 -893
  52. package/src/services/BaseService.js +6 -166
  53. package/src/services/BasedService.js +722 -0
  54. package/src/services/SocketIOService.js +356 -0
  55. package/src/services/SocketService.js +168 -0
  56. package/src/services/SymstoryService.js +563 -0
  57. package/src/services/index.js +13 -80
  58. package/src/utils/basedQuerys.js +41 -0
  59. package/src/utils/permission.js +4 -4
  60. package/src/utils/services.js +83 -325
  61. package/src/utils/symstoryClient.js +218 -0
  62. package/src/utils/validation.js +3 -0
  63. package/dist/cjs/services/AdminService.js +0 -351
  64. package/dist/cjs/services/BranchService.js +0 -484
  65. package/dist/cjs/services/CollabService.js +0 -743
  66. package/dist/cjs/services/DnsService.js +0 -340
  67. package/dist/cjs/services/FeatureFlagService.js +0 -175
  68. package/dist/cjs/services/FileService.js +0 -201
  69. package/dist/cjs/services/IntegrationService.js +0 -538
  70. package/dist/cjs/services/MetricsService.js +0 -62
  71. package/dist/cjs/services/PaymentService.js +0 -271
  72. package/dist/cjs/services/PlanService.js +0 -426
  73. package/dist/cjs/services/ProjectService.js +0 -1207
  74. package/dist/cjs/services/PullRequestService.js +0 -503
  75. package/dist/cjs/services/ScreenshotService.js +0 -304
  76. package/dist/cjs/services/SubscriptionService.js +0 -396
  77. package/dist/cjs/services/TrackingService.js +0 -661
  78. package/dist/cjs/services/WaitlistService.js +0 -148
  79. package/dist/cjs/state/RootStateManager.js +0 -65
  80. package/dist/cjs/state/rootEventBus.js +0 -74
  81. package/dist/cjs/utils/CollabClient.js +0 -223
  82. package/dist/cjs/utils/TokenManager.js +0 -422
  83. package/dist/cjs/utils/changePreprocessor.js +0 -199
  84. package/dist/cjs/utils/jsonDiff.js +0 -145
  85. package/dist/cjs/utils/ordering.js +0 -309
  86. package/dist/esm/services/AdminService.js +0 -1132
  87. package/dist/esm/services/BranchService.js +0 -1265
  88. package/dist/esm/services/CollabService.js +0 -26838
  89. package/dist/esm/services/DnsService.js +0 -1121
  90. package/dist/esm/services/FeatureFlagService.js +0 -956
  91. package/dist/esm/services/FileService.js +0 -982
  92. package/dist/esm/services/IntegrationService.js +0 -1319
  93. package/dist/esm/services/MetricsService.js +0 -843
  94. package/dist/esm/services/PaymentService.js +0 -1052
  95. package/dist/esm/services/PlanService.js +0 -1207
  96. package/dist/esm/services/ProjectService.js +0 -2526
  97. package/dist/esm/services/PullRequestService.js +0 -1284
  98. package/dist/esm/services/ScreenshotService.js +0 -1085
  99. package/dist/esm/services/SubscriptionService.js +0 -1177
  100. package/dist/esm/services/TrackingService.js +0 -18343
  101. package/dist/esm/services/WaitlistService.js +0 -929
  102. package/dist/esm/state/RootStateManager.js +0 -90
  103. package/dist/esm/state/rootEventBus.js +0 -56
  104. package/dist/esm/utils/CollabClient.js +0 -18901
  105. package/dist/esm/utils/TokenManager.js +0 -408
  106. package/dist/esm/utils/changePreprocessor.js +0 -542
  107. package/dist/esm/utils/jsonDiff.js +0 -7011
  108. package/dist/esm/utils/ordering.js +0 -291
  109. package/dist/node/services/AdminService.js +0 -332
  110. package/dist/node/services/BranchService.js +0 -465
  111. package/dist/node/services/CollabService.js +0 -724
  112. package/dist/node/services/DnsService.js +0 -321
  113. package/dist/node/services/FeatureFlagService.js +0 -156
  114. package/dist/node/services/FileService.js +0 -182
  115. package/dist/node/services/IntegrationService.js +0 -519
  116. package/dist/node/services/MetricsService.js +0 -43
  117. package/dist/node/services/PaymentService.js +0 -252
  118. package/dist/node/services/PlanService.js +0 -407
  119. package/dist/node/services/ProjectService.js +0 -1188
  120. package/dist/node/services/PullRequestService.js +0 -484
  121. package/dist/node/services/ScreenshotService.js +0 -285
  122. package/dist/node/services/SubscriptionService.js +0 -377
  123. package/dist/node/services/TrackingService.js +0 -632
  124. package/dist/node/services/WaitlistService.js +0 -129
  125. package/dist/node/state/RootStateManager.js +0 -36
  126. package/dist/node/state/rootEventBus.js +0 -55
  127. package/dist/node/utils/CollabClient.js +0 -194
  128. package/dist/node/utils/TokenManager.js +0 -403
  129. package/dist/node/utils/changePreprocessor.js +0 -180
  130. package/dist/node/utils/jsonDiff.js +0 -116
  131. package/dist/node/utils/ordering.js +0 -290
  132. package/src/services/AdminService.js +0 -374
  133. package/src/services/BranchService.js +0 -536
  134. package/src/services/CollabService.js +0 -900
  135. package/src/services/DnsService.js +0 -366
  136. package/src/services/FeatureFlagService.js +0 -174
  137. package/src/services/FileService.js +0 -213
  138. package/src/services/IntegrationService.js +0 -548
  139. package/src/services/MetricsService.js +0 -40
  140. package/src/services/PaymentService.js +0 -287
  141. package/src/services/PlanService.js +0 -468
  142. package/src/services/ProjectService.js +0 -1366
  143. package/src/services/PullRequestService.js +0 -537
  144. package/src/services/ScreenshotService.js +0 -258
  145. package/src/services/SubscriptionService.js +0 -425
  146. package/src/services/TrackingService.js +0 -853
  147. package/src/services/WaitlistService.js +0 -130
  148. package/src/services/tests/BranchService/createBranch.test.js +0 -153
  149. package/src/services/tests/BranchService/deleteBranch.test.js +0 -173
  150. package/src/services/tests/BranchService/getBranchChanges.test.js +0 -146
  151. package/src/services/tests/BranchService/listBranches.test.js +0 -87
  152. package/src/services/tests/BranchService/mergeBranch.test.js +0 -210
  153. package/src/services/tests/BranchService/publishVersion.test.js +0 -183
  154. package/src/services/tests/BranchService/renameBranch.test.js +0 -240
  155. package/src/services/tests/BranchService/resetBranch.test.js +0 -152
  156. package/src/services/tests/FeatureFlagService/adminFeatureFlags.test.js +0 -67
  157. package/src/services/tests/FeatureFlagService/getFeatureFlags.test.js +0 -75
  158. package/src/services/tests/FileService/createFileFormData.test.js +0 -74
  159. package/src/services/tests/FileService/getFileUrl.test.js +0 -69
  160. package/src/services/tests/FileService/updateProjectIcon.test.js +0 -109
  161. package/src/services/tests/FileService/uploadDocument.test.js +0 -36
  162. package/src/services/tests/FileService/uploadFile.test.js +0 -78
  163. package/src/services/tests/FileService/uploadFileWithValidation.test.js +0 -114
  164. package/src/services/tests/FileService/uploadImage.test.js +0 -36
  165. package/src/services/tests/FileService/uploadMultipleFiles.test.js +0 -111
  166. package/src/services/tests/FileService/validateFile.test.js +0 -63
  167. package/src/services/tests/PlanService/createPlan.test.js +0 -104
  168. package/src/services/tests/PlanService/createPlanWithValidation.test.js +0 -523
  169. package/src/services/tests/PlanService/deletePlan.test.js +0 -92
  170. package/src/services/tests/PlanService/getActivePlans.test.js +0 -123
  171. package/src/services/tests/PlanService/getAdminPlans.test.js +0 -84
  172. package/src/services/tests/PlanService/getPlan.test.js +0 -50
  173. package/src/services/tests/PlanService/getPlanByKey.test.js +0 -109
  174. package/src/services/tests/PlanService/getPlanWithValidation.test.js +0 -85
  175. package/src/services/tests/PlanService/getPlans.test.js +0 -53
  176. package/src/services/tests/PlanService/getPlansByPriceRange.test.js +0 -109
  177. package/src/services/tests/PlanService/getPlansWithValidation.test.js +0 -48
  178. package/src/services/tests/PlanService/initializePlans.test.js +0 -75
  179. package/src/services/tests/PlanService/updatePlan.test.js +0 -111
  180. package/src/services/tests/PlanService/updatePlanWithValidation.test.js +0 -556
  181. package/src/state/RootStateManager.js +0 -76
  182. package/src/state/rootEventBus.js +0 -67
  183. package/src/utils/CollabClient.js +0 -248
  184. package/src/utils/TokenManager.js +0 -479
  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
-