arky-sdk 0.3.70 → 0.3.71

package/dist/index.cjs

@@ -1188,6 +1188,135 @@ var createDatabaseApi = (apiConfig) => {
   };
 };
 
+// src/api/featureFlags.ts
+var createFeatureFlagsApi = (apiConfig) => {
+  return {
+    /**
+     * Create a new feature flag
+     */
+    async createFlag(params, options) {
+      return apiConfig.httpClient.post(
+        `/v1/businesses/${apiConfig.businessId}/feature-flags`,
+        params,
+        options
+      );
+    },
+    /**
+     * Get a feature flag by ID
+     */
+    async getFlag(params, options) {
+      return apiConfig.httpClient.get(
+        `/v1/businesses/${apiConfig.businessId}/feature-flags/${params.id}`,
+        options
+      );
+    },
+    /**
+     * List all feature flags for the business
+     */
+    async getFlags(params, options) {
+      return apiConfig.httpClient.get(
+        `/v1/businesses/${apiConfig.businessId}/feature-flags`,
+        {
+          ...options,
+          params
+        }
+      );
+    },
+    /**
+     * Update a feature flag
+     */
+    async updateFlag(params, options) {
+      const { id, ...body } = params;
+      return apiConfig.httpClient.put(
+        `/v1/businesses/${apiConfig.businessId}/feature-flags/${id}`,
+        body,
+        options
+      );
+    },
+    /**
+     * Delete a feature flag
+     */
+    async deleteFlag(params, options) {
+      return apiConfig.httpClient.delete(
+        `/v1/businesses/${apiConfig.businessId}/feature-flags/${params.id}`,
+        options
+      );
+    },
+    /**
+     * Get experiment results for a feature flag
+     */
+    async getResults(params, options) {
+      return apiConfig.httpClient.get(
+        `/v1/businesses/${apiConfig.businessId}/feature-flags/${params.id}/results`,
+        options
+      );
+    },
+    /**
+     * Get the variant assignment for the current user
+     * This is the main method for feature flag evaluation
+     */
+    async getVariant(params, options) {
+      return apiConfig.httpClient.get(
+        `/v1/businesses/${apiConfig.businessId}/feature-flags/key/${params.flagKey}/variant`,
+        options
+      );
+    },
+    /**
+     * Track a conversion event for A/B testing
+     */
+    async trackEvent(params, options) {
+      return apiConfig.httpClient.post(
+        `/v1/businesses/${apiConfig.businessId}/feature-flags/track`,
+        params,
+        options
+      );
+    },
+    // ===== CONVENIENCE METHODS =====
+    /**
+     * Check if a feature is enabled (returns true if variant is not 'control')
+     * Convenience method for simple on/off flags
+     */
+    async isEnabled(flagKey) {
+      try {
+        const response = await this.getVariant({ flagKey });
+        return response.variantKey !== "control";
+      } catch {
+        return false;
+      }
+    },
+    /**
+     * Get variant with payload, returning a default if flag not found
+     * Useful for getting configuration values from variants
+     */
+    async getVariantWithDefault(flagKey, defaultValue) {
+      try {
+        const response = await this.getVariant({ flagKey });
+        return {
+          variantKey: response.variantKey,
+          payload: response.payload ?? defaultValue
+        };
+      } catch {
+        return {
+          variantKey: "control",
+          payload: defaultValue
+        };
+      }
+    },
+    /**
+     * Activate a draft flag
+     */
+    async activateFlag(id) {
+      return this.updateFlag({ id, status: "ACTIVE" });
+    },
+    /**
+     * Archive an active flag
+     */
+    async archiveFlag(id) {
+      return this.updateFlag({ id, status: "ARCHIVED" });
+    }
+  };
+};
+
 // src/utils/currency.ts
 function getCurrencySymbol(currency) {
   const currencySymbols = {
@@ -1580,6 +1709,7 @@ function createArkySDK(config) {
     eshop: createEshopApi(apiConfig),
     reservation: createReservationApi(apiConfig),
     database: createDatabaseApi(apiConfig),
+    featureFlags: createFeatureFlagsApi(apiConfig),
     setBusinessId: (businessId) => {
       apiConfig.businessId = businessId;
     },