@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,340 +0,0 @@
1
- var __defProp = Object.defineProperty;
2
- var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
3
- var __getOwnPropNames = Object.getOwnPropertyNames;
4
- var __hasOwnProp = Object.prototype.hasOwnProperty;
5
- var __export = (target, all) => {
6
- for (var name in all)
7
- __defProp(target, name, { get: all[name], enumerable: true });
8
- };
9
- var __copyProps = (to, from, except, desc) => {
10
- if (from && typeof from === "object" || typeof from === "function") {
11
- for (let key of __getOwnPropNames(from))
12
- if (!__hasOwnProp.call(to, key) && key !== except)
13
- __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
14
- }
15
- return to;
16
- };
17
- var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
18
- var DnsService_exports = {};
19
- __export(DnsService_exports, {
20
- DnsService: () => DnsService
21
- });
22
- module.exports = __toCommonJS(DnsService_exports);
23
- var import_BaseService = require("./BaseService.js");
24
- class DnsService extends import_BaseService.BaseService {
25
- // ==================== DNS METHODS ====================
26
- async createDnsRecord(domain, options = {}) {
27
- this._requireReady("createDnsRecord");
28
- if (!domain) {
29
- throw new Error("Domain is required");
30
- }
31
- try {
32
- const response = await this._request("/dns/records", {
33
- method: "POST",
34
- body: JSON.stringify({ domain, ...options }),
35
- methodName: "createDnsRecord"
36
- });
37
- if (response.success) {
38
- return response.data;
39
- }
40
- throw new Error(response.message);
41
- } catch (error) {
42
- throw new Error(`Failed to create DNS record: ${error.message}`, { cause: error });
43
- }
44
- }
45
- async getDnsRecord(domain) {
46
- this._requireReady("getDnsRecord");
47
- if (!domain) {
48
- throw new Error("Domain is required");
49
- }
50
- try {
51
- const response = await this._request(`/dns/records/${domain}`, {
52
- method: "GET",
53
- methodName: "getDnsRecord"
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 DNS record: ${error.message}`, { cause: error });
61
- }
62
- }
63
- async getCustomHost(hostname) {
64
- this._requireReady("getCustomHost");
65
- if (!hostname) {
66
- throw new Error("Hostname is required");
67
- }
68
- try {
69
- const response = await this._request(`/dns/custom-hosts/${encodeURIComponent(hostname)}`, {
70
- method: "GET",
71
- methodName: "getCustomHost"
72
- });
73
- if (response.success) {
74
- return response.data;
75
- }
76
- throw new Error(response.message);
77
- } catch (error) {
78
- throw new Error(`Failed to get custom host: ${error.message}`, { cause: error });
79
- }
80
- }
81
- async removeDnsRecord(domain) {
82
- this._requireReady("removeDnsRecord");
83
- if (!domain) {
84
- throw new Error("Domain is required");
85
- }
86
- try {
87
- const response = await this._request(`/dns/records/${domain}`, {
88
- method: "DELETE",
89
- methodName: "removeDnsRecord"
90
- });
91
- if (response.success) {
92
- return response.data;
93
- }
94
- throw new Error(response.message);
95
- } catch (error) {
96
- throw new Error(`Failed to remove DNS record: ${error.message}`, { cause: error });
97
- }
98
- }
99
- // customDomains could be a string or an array of strings
100
- async addProjectCustomDomains(projectId, customDomains, options = {}) {
101
- this._requireReady("addProjectCustomDomains");
102
- if (!projectId) {
103
- throw new Error("Project ID is required");
104
- }
105
- if (!customDomains || Array.isArray(customDomains) && !customDomains.length) {
106
- throw new Error(
107
- "customDomains is required and must be a non-empty string or array"
108
- );
109
- }
110
- const { envKey, headers } = options;
111
- try {
112
- const response = await this._request(`/projects/${projectId}/domains`, {
113
- method: "PATCH",
114
- body: JSON.stringify({
115
- customDomains,
116
- ...envKey ? { envKey } : {}
117
- }),
118
- ...headers ? { headers } : {},
119
- methodName: "addProjectCustomDomains"
120
- });
121
- if (response.success) {
122
- return response.data;
123
- }
124
- throw new Error(response.message);
125
- } catch (error) {
126
- throw new Error(
127
- `Failed to update project custom domains: ${error.message}`,
128
- { cause: error }
129
- );
130
- }
131
- }
132
- // ==================== DNS HELPER METHODS ====================
133
- /**
134
- * Helper method to validate domain format
135
- */
136
- validateDomain(domain) {
137
- if (!domain || typeof domain !== "string") {
138
- return {
139
- isValid: false,
140
- error: "Domain must be a non-empty string"
141
- };
142
- }
143
- 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;
144
- if (!domainRegex.test(domain)) {
145
- return {
146
- isValid: false,
147
- error: "Invalid domain format"
148
- };
149
- }
150
- const tldRegex = /\.[a-zA-Z]{2,}$/u;
151
- if (!tldRegex.test(domain)) {
152
- return {
153
- isValid: false,
154
- error: "Domain must have a valid top-level domain"
155
- };
156
- }
157
- return {
158
- isValid: true,
159
- error: null
160
- };
161
- }
162
- /**
163
- * Helper method to create DNS record with validation
164
- */
165
- async createDnsRecordWithValidation(domain, options = {}) {
166
- const validation = this.validateDomain(domain);
167
- if (!validation.isValid) {
168
- throw new Error(validation.error);
169
- }
170
- return await this.createDnsRecord(domain, options);
171
- }
172
- /**
173
- * Helper method to get DNS record with validation
174
- */
175
- async getDnsRecordWithValidation(domain) {
176
- const validation = this.validateDomain(domain);
177
- if (!validation.isValid) {
178
- throw new Error(validation.error);
179
- }
180
- return await this.getDnsRecord(domain);
181
- }
182
- /**
183
- * Helper method to remove DNS record with validation
184
- */
185
- async removeDnsRecordWithValidation(domain) {
186
- const validation = this.validateDomain(domain);
187
- if (!validation.isValid) {
188
- throw new Error(validation.error);
189
- }
190
- return await this.removeDnsRecord(domain);
191
- }
192
- /**
193
- * Helper method to add project custom domains with validation
194
- */
195
- async addProjectCustomDomainsWithValidation(projectId, customDomains, options = {}) {
196
- if (!projectId || typeof projectId !== "string") {
197
- throw new Error("Project ID must be a valid string");
198
- }
199
- if (!customDomains) {
200
- throw new Error("Custom domains are required");
201
- }
202
- const domainsArray = Array.isArray(customDomains) ? customDomains : [customDomains];
203
- if (domainsArray.length === 0) {
204
- throw new Error("At least one custom domain is required");
205
- }
206
- for (const domain of domainsArray) {
207
- const validation = this.validateDomain(domain);
208
- if (!validation.isValid) {
209
- throw new Error(`Invalid domain '${domain}': ${validation.error}`);
210
- }
211
- }
212
- return await this.addProjectCustomDomains(projectId, customDomains, options);
213
- }
214
- /**
215
- * Helper method to check if domain is available
216
- */
217
- async isDomainAvailable(domain) {
218
- try {
219
- await this.getDnsRecord(domain);
220
- return false;
221
- } catch (error) {
222
- if (error.message.includes("not found") || error.message.includes("404")) {
223
- return true;
224
- }
225
- throw error;
226
- }
227
- }
228
- /**
229
- * Helper method to get domain status
230
- */
231
- async getDomainStatus(domain) {
232
- try {
233
- const record = await this.getDnsRecord(domain);
234
- return {
235
- exists: true,
236
- active: record.active || false,
237
- verified: record.verified || false,
238
- record
239
- };
240
- } catch (error) {
241
- if (error.message.includes("not found") || error.message.includes("404")) {
242
- return {
243
- exists: false,
244
- active: false,
245
- verified: false,
246
- error: "Domain not found"
247
- };
248
- }
249
- throw error;
250
- }
251
- }
252
- /**
253
- * Helper method to verify domain ownership
254
- */
255
- async verifyDomainOwnership(domain) {
256
- try {
257
- const record = await this.getDnsRecord(domain);
258
- if (!record.verified) {
259
- return {
260
- verified: false,
261
- needsVerification: true,
262
- verificationMethod: record.verificationMethod || "dns",
263
- verificationRecord: record.verificationRecord
264
- };
265
- }
266
- return {
267
- verified: true,
268
- needsVerification: false
269
- };
270
- } catch (error) {
271
- throw new Error(`Failed to verify domain ownership: ${error.message}`, { cause: error });
272
- }
273
- }
274
- /**
275
- * Helper method to get project domains
276
- */
277
- async getProjectDomains(projectId) {
278
- this._requireReady("getProjectDomains");
279
- if (!projectId) {
280
- throw new Error("Project ID is required");
281
- }
282
- try {
283
- const response = await this._request(`/projects/${projectId}/domains`, {
284
- method: "GET",
285
- methodName: "getProjectDomains"
286
- });
287
- if (response.success) {
288
- return response.data;
289
- }
290
- throw new Error(response.message);
291
- } catch (error) {
292
- throw new Error(`Failed to get project domains: ${error.message}`, { cause: error });
293
- }
294
- }
295
- /**
296
- * Helper method to remove project custom domain
297
- */
298
- async removeProjectCustomDomain(projectId, domain) {
299
- this._requireReady("removeProjectCustomDomain");
300
- if (!projectId) {
301
- throw new Error("Project ID is required");
302
- }
303
- if (!domain) {
304
- throw new Error("Domain is required");
305
- }
306
- try {
307
- const response = await this._request(`/projects/${projectId}/domains/${encodeURIComponent(domain)}`, {
308
- method: "DELETE",
309
- methodName: "removeProjectCustomDomain"
310
- });
311
- if (response.success) {
312
- return response.data;
313
- }
314
- throw new Error(response.message);
315
- } catch (error) {
316
- throw new Error(`Failed to remove project custom domain: ${error.message}`, { cause: error });
317
- }
318
- }
319
- /**
320
- * Helper method to format domain for display
321
- */
322
- formatDomain(domain) {
323
- if (!domain) {
324
- return "";
325
- }
326
- const cleanDomain = domain.replace(/^https?:\/\//u, "");
327
- return cleanDomain.replace(/\/$/u, "");
328
- }
329
- /**
330
- * Helper method to extract domain from URL
331
- */
332
- extractDomainFromUrl(url) {
333
- try {
334
- const urlObj = new URL(url);
335
- return urlObj.hostname;
336
- } catch {
337
- return null;
338
- }
339
- }
340
- }
@@ -1,175 +0,0 @@
1
- var __defProp = Object.defineProperty;
2
- var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
3
- var __getOwnPropNames = Object.getOwnPropertyNames;
4
- var __hasOwnProp = Object.prototype.hasOwnProperty;
5
- var __export = (target, all) => {
6
- for (var name in all)
7
- __defProp(target, name, { get: all[name], enumerable: true });
8
- };
9
- var __copyProps = (to, from, except, desc) => {
10
- if (from && typeof from === "object" || typeof from === "function") {
11
- for (let key of __getOwnPropNames(from))
12
- if (!__hasOwnProp.call(to, key) && key !== except)
13
- __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
14
- }
15
- return to;
16
- };
17
- var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
18
- var FeatureFlagService_exports = {};
19
- __export(FeatureFlagService_exports, {
20
- FeatureFlagService: () => FeatureFlagService
21
- });
22
- module.exports = __toCommonJS(FeatureFlagService_exports);
23
- var import_BaseService = require("./BaseService.js");
24
- function normalizeKeysParam(keys) {
25
- if (!keys) {
26
- return null;
27
- }
28
- if (Array.isArray(keys)) {
29
- const flattened = keys.flatMap((k) => String(k).split(","));
30
- const cleaned2 = flattened.map((s) => s.trim()).filter(Boolean);
31
- return cleaned2.length ? cleaned2.join(",") : null;
32
- }
33
- const cleaned = String(keys).split(",").map((s) => s.trim()).filter(Boolean);
34
- return cleaned.length ? cleaned.join(",") : null;
35
- }
36
- class FeatureFlagService extends import_BaseService.BaseService {
37
- // ==================== USER FEATURE FLAGS (optional auth) ====================
38
- /**
39
- * Evaluate feature flags for the current user (or anonymous).
40
- * @param {Object} [params]
41
- * @param {string[]|string} [params.keys] Optional subset of keys (array or comma-separated string)
42
- * @returns {Promise<{flags: Record<string, {enabled: boolean, variant: string|null, payload: any}>}>}
43
- */
44
- async getFeatureFlags(params = {}) {
45
- this._requireReady("getFeatureFlags");
46
- const { keys } = params || {};
47
- const queryParams = new URLSearchParams();
48
- const keysParam = normalizeKeysParam(keys);
49
- if (keysParam) {
50
- queryParams.append("keys", keysParam);
51
- }
52
- const queryString = queryParams.toString();
53
- const url = `/feature-flags${queryString ? `?${queryString}` : ""}`;
54
- try {
55
- const response = await this._request(url, {
56
- method: "GET",
57
- methodName: "getFeatureFlags"
58
- });
59
- if (response.success) {
60
- return response.data;
61
- }
62
- throw new Error(response.message);
63
- } catch (error) {
64
- throw new Error(`Failed to get feature flags: ${error.message}`, { cause: error });
65
- }
66
- }
67
- /**
68
- * Evaluate a single feature flag for the current user (or anonymous).
69
- */
70
- async getFeatureFlag(key) {
71
- this._requireReady("getFeatureFlag");
72
- if (!key) {
73
- throw new Error("Feature flag key is required");
74
- }
75
- try {
76
- const response = await this._request(`/feature-flags/${encodeURIComponent(String(key))}`, {
77
- method: "GET",
78
- methodName: "getFeatureFlag"
79
- });
80
- if (response.success) {
81
- return response.data;
82
- }
83
- throw new Error(response.message);
84
- } catch (error) {
85
- throw new Error(`Failed to get feature flag: ${error.message}`, { cause: error });
86
- }
87
- }
88
- // ==================== ADMIN FEATURE FLAGS (admin only) ====================
89
- async getAdminFeatureFlags(params = {}) {
90
- this._requireReady("getAdminFeatureFlags");
91
- const { includeArchived = true } = params || {};
92
- const queryParams = new URLSearchParams();
93
- if (includeArchived === false) {
94
- queryParams.append("includeArchived", "false");
95
- }
96
- const queryString = queryParams.toString();
97
- const url = `/admin/feature-flags${queryString ? `?${queryString}` : ""}`;
98
- try {
99
- const response = await this._request(url, {
100
- method: "GET",
101
- methodName: "getAdminFeatureFlags"
102
- });
103
- if (response.success) {
104
- return response.data;
105
- }
106
- throw new Error(response.message);
107
- } catch (error) {
108
- throw new Error(`Failed to get admin feature flags: ${error.message}`, {
109
- cause: error
110
- });
111
- }
112
- }
113
- async createFeatureFlag(flagData) {
114
- this._requireReady("createFeatureFlag");
115
- if (!flagData || typeof flagData !== "object") {
116
- throw new Error("Feature flag data is required");
117
- }
118
- if (!flagData.key) {
119
- throw new Error("Feature flag key is required");
120
- }
121
- try {
122
- const response = await this._request("/admin/feature-flags", {
123
- method: "POST",
124
- body: JSON.stringify(flagData),
125
- methodName: "createFeatureFlag"
126
- });
127
- if (response.success) {
128
- return response.data;
129
- }
130
- throw new Error(response.message);
131
- } catch (error) {
132
- throw new Error(`Failed to create feature flag: ${error.message}`, { cause: error });
133
- }
134
- }
135
- async updateFeatureFlag(id, patch) {
136
- this._requireReady("updateFeatureFlag");
137
- if (!id) {
138
- throw new Error("Feature flag id is required");
139
- }
140
- if (!patch || typeof patch !== "object") {
141
- throw new Error("Feature flag patch is required");
142
- }
143
- try {
144
- const response = await this._request(`/admin/feature-flags/${encodeURIComponent(String(id))}`, {
145
- method: "PATCH",
146
- body: JSON.stringify(patch),
147
- methodName: "updateFeatureFlag"
148
- });
149
- if (response.success) {
150
- return response.data;
151
- }
152
- throw new Error(response.message);
153
- } catch (error) {
154
- throw new Error(`Failed to update feature flag: ${error.message}`, { cause: error });
155
- }
156
- }
157
- async archiveFeatureFlag(id) {
158
- this._requireReady("archiveFeatureFlag");
159
- if (!id) {
160
- throw new Error("Feature flag id is required");
161
- }
162
- try {
163
- const response = await this._request(`/admin/feature-flags/${encodeURIComponent(String(id))}`, {
164
- method: "DELETE",
165
- methodName: "archiveFeatureFlag"
166
- });
167
- if (response.success) {
168
- return response.data;
169
- }
170
- throw new Error(response.message);
171
- } catch (error) {
172
- throw new Error(`Failed to archive feature flag: ${error.message}`, { cause: error });
173
- }
174
- }
175
- }