arky-sdk 0.3.70 → 0.3.71

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { UpdateUserProfileParams, RequestOptions, DeleteUserParams, AddPhoneNumberParams, PhoneNumberConfirmParams, GetMeParams, SearchUsersParams, SetRoleParams, LoginUserParams, RegisterUserParams, LogoutParams, ConfirmUserParams, GetLoginUrlParams, ForgotPasswordParams, ResetForgotPasswordParams, ResetPasswordParams, UserSubscribeParams, CreateBusinessParams, UpdateBusinessParams, DeleteBusinessParams, GetBusinessParams, GetBusinessesParams, GetBusinessParentsParams, TriggerBuildsParams, GetSubscriptionPlansParams, GetSubscriptionParams, SubscribeParams, CreatePortalSessionParams, InviteUserParams, HandleInvitationParams, TestWebhookParams, GetBusinessMediaParams2, SetProviderScheduleParams, ProcessRefundParams, UploadBusinessMediaParams, DeleteBusinessMediaParams, GetBusinessMediaParams, UpdateMediaParams, CreateRoleParams, UpdateRoleParams, DeleteRoleParams, GetRoleParams, GetRolesParams, TrackEmailOpenParams, GetDeliveryStatsParams, CreatePromoCodeParams, UpdatePromoCodeParams, DeletePromoCodeParams, GetPromoCodeParams, GetPromoCodesParams, GetAnalyticsParams, CreateCollectionParams, UpdateCollectionParams, DeleteCollectionParams, GetCollectionParams, GetCollectionsParams, GenerateBlocksParams, GetEntriesParams, CreateEntryParams, UpdateEntryParams, DeleteCollectionEntryParams, GetCollectionEntryParams, SendEntryParams, GetVariableMetadataParams, GetCollectionSubscribersParams, CreateProductParams, UpdateProductParams, DeleteProductParams, GetProductParams, GetProductsParams, CreateOrderParams, UpdateOrderParams, GetOrderParams, GetOrdersParams, UpdateOrderStatusParams, UpdateOrderPaymentStatusParams, GetQuoteParams, CheckoutParams, CreateReservationParams, UpdateReservationParams, ReservationCheckoutParams, GetReservationParams, SearchReservationsParams, SearchMyReservationsParams, GetReservationQuoteParams, CreateServiceParams, UpdateServiceParams, DeleteServiceParams, GetServiceParams, GetServicesParams, GetAvailableSlotsParams, CreateProviderParams, UpdateProviderParams, DeleteProviderParams, GetProviderParams, GetProvidersParams, GetBusinessServiceWorkingTimeParams } from './types.cjs';
+import { UpdateUserProfileParams, RequestOptions, DeleteUserParams, AddPhoneNumberParams, PhoneNumberConfirmParams, GetMeParams, SearchUsersParams, SetRoleParams, LoginUserParams, RegisterUserParams, LogoutParams, ConfirmUserParams, GetLoginUrlParams, ForgotPasswordParams, ResetForgotPasswordParams, ResetPasswordParams, UserSubscribeParams, CreateBusinessParams, UpdateBusinessParams, DeleteBusinessParams, GetBusinessParams, GetBusinessesParams, GetBusinessParentsParams, TriggerBuildsParams, GetSubscriptionPlansParams, GetSubscriptionParams, SubscribeParams, CreatePortalSessionParams, InviteUserParams, HandleInvitationParams, TestWebhookParams, GetBusinessMediaParams2, SetProviderScheduleParams, ProcessRefundParams, UploadBusinessMediaParams, DeleteBusinessMediaParams, GetBusinessMediaParams, UpdateMediaParams, CreateRoleParams, UpdateRoleParams, DeleteRoleParams, GetRoleParams, GetRolesParams, TrackEmailOpenParams, GetDeliveryStatsParams, CreatePromoCodeParams, UpdatePromoCodeParams, DeletePromoCodeParams, GetPromoCodeParams, GetPromoCodesParams, GetAnalyticsParams, CreateCollectionParams, UpdateCollectionParams, DeleteCollectionParams, GetCollectionParams, GetCollectionsParams, GenerateBlocksParams, GetEntriesParams, CreateEntryParams, UpdateEntryParams, DeleteCollectionEntryParams, GetCollectionEntryParams, SendEntryParams, GetVariableMetadataParams, GetCollectionSubscribersParams, CreateProductParams, UpdateProductParams, DeleteProductParams, GetProductParams, GetProductsParams, CreateOrderParams, UpdateOrderParams, GetOrderParams, GetOrdersParams, UpdateOrderStatusParams, UpdateOrderPaymentStatusParams, GetQuoteParams, CheckoutParams, CreateReservationParams, UpdateReservationParams, ReservationCheckoutParams, GetReservationParams, SearchReservationsParams, SearchMyReservationsParams, GetReservationQuoteParams, CreateServiceParams, UpdateServiceParams, DeleteServiceParams, GetServiceParams, GetServicesParams, GetAvailableSlotsParams, CreateProviderParams, UpdateProviderParams, DeleteProviderParams, GetProviderParams, GetProvidersParams, GetBusinessServiceWorkingTimeParams, CreateFeatureFlagParams, FeatureFlag, GetFeatureFlagParams, GetFeatureFlagsParams, UpdateFeatureFlagParams, DeleteFeatureFlagParams, GetFeatureFlagResultsParams, FlagResults, GetVariantParams, GetVariantResponse, TrackEventParams, TrackEventResponse } from './types.cjs';
 export { ApiResponse, Block, Business, EshopCartItem, EshopStoreState, Price, ReservationCartItem, ReservationStoreState } from './types.cjs';
 import { g as getBlockLabel, a as getBlockTextValue, f as formatBlockValue, p as prepareBlocksForSubmission, e as extractBlockValues, b as getMarketPrice, c as getPriceAmount, d as formatPayment, h as formatMinor, i as createPaymentForCheckout, j as getCurrencySymbol, v as validatePhoneNumber, k as findTimeZone, s as slugify, l as humanize, m as categorify, n as formatDate, o as getSvgContentForAstro, q as fetchSvgContent, r as injectSvgIntoElement } from './svg-3F_m7296.cjs';
 
@@ -182,6 +182,27 @@ declare function createArkySDK(config: HttpClientConfig & {
         deleteData(params: DeleteDataParams, options?: RequestOptions): Promise<void>;
         runScript(params: RunScriptParams, options?: RequestOptions): Promise<RunScriptResponse>;
     };
+    featureFlags: {
+        createFlag(params: CreateFeatureFlagParams, options?: RequestOptions<FeatureFlag>): Promise<FeatureFlag>;
+        getFlag(params: GetFeatureFlagParams, options?: RequestOptions<FeatureFlag>): Promise<FeatureFlag>;
+        getFlags(params?: GetFeatureFlagsParams, options?: RequestOptions<FeatureFlag[]>): Promise<FeatureFlag[]>;
+        updateFlag(params: UpdateFeatureFlagParams, options?: RequestOptions<FeatureFlag>): Promise<FeatureFlag>;
+        deleteFlag(params: DeleteFeatureFlagParams, options?: RequestOptions<{
+            deleted: boolean;
+        }>): Promise<{
+            deleted: boolean;
+        }>;
+        getResults(params: GetFeatureFlagResultsParams, options?: RequestOptions<FlagResults>): Promise<FlagResults>;
+        getVariant(params: GetVariantParams, options?: RequestOptions<GetVariantResponse>): Promise<GetVariantResponse>;
+        trackEvent(params: TrackEventParams, options?: RequestOptions<TrackEventResponse>): Promise<TrackEventResponse>;
+        isEnabled(flagKey: string): Promise<boolean>;
+        getVariantWithDefault<T = any>(flagKey: string, defaultValue: T): Promise<{
+            variantKey: string;
+            payload: T;
+        }>;
+        activateFlag(id: string): Promise<FeatureFlag>;
+        archiveFlag(id: string): Promise<FeatureFlag>;
+    };
     setBusinessId: (businessId: string) => void;
     getBusinessId: () => string;
     setMarket: (market: string) => void;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { UpdateUserProfileParams, RequestOptions, DeleteUserParams, AddPhoneNumberParams, PhoneNumberConfirmParams, GetMeParams, SearchUsersParams, SetRoleParams, LoginUserParams, RegisterUserParams, LogoutParams, ConfirmUserParams, GetLoginUrlParams, ForgotPasswordParams, ResetForgotPasswordParams, ResetPasswordParams, UserSubscribeParams, CreateBusinessParams, UpdateBusinessParams, DeleteBusinessParams, GetBusinessParams, GetBusinessesParams, GetBusinessParentsParams, TriggerBuildsParams, GetSubscriptionPlansParams, GetSubscriptionParams, SubscribeParams, CreatePortalSessionParams, InviteUserParams, HandleInvitationParams, TestWebhookParams, GetBusinessMediaParams2, SetProviderScheduleParams, ProcessRefundParams, UploadBusinessMediaParams, DeleteBusinessMediaParams, GetBusinessMediaParams, UpdateMediaParams, CreateRoleParams, UpdateRoleParams, DeleteRoleParams, GetRoleParams, GetRolesParams, TrackEmailOpenParams, GetDeliveryStatsParams, CreatePromoCodeParams, UpdatePromoCodeParams, DeletePromoCodeParams, GetPromoCodeParams, GetPromoCodesParams, GetAnalyticsParams, CreateCollectionParams, UpdateCollectionParams, DeleteCollectionParams, GetCollectionParams, GetCollectionsParams, GenerateBlocksParams, GetEntriesParams, CreateEntryParams, UpdateEntryParams, DeleteCollectionEntryParams, GetCollectionEntryParams, SendEntryParams, GetVariableMetadataParams, GetCollectionSubscribersParams, CreateProductParams, UpdateProductParams, DeleteProductParams, GetProductParams, GetProductsParams, CreateOrderParams, UpdateOrderParams, GetOrderParams, GetOrdersParams, UpdateOrderStatusParams, UpdateOrderPaymentStatusParams, GetQuoteParams, CheckoutParams, CreateReservationParams, UpdateReservationParams, ReservationCheckoutParams, GetReservationParams, SearchReservationsParams, SearchMyReservationsParams, GetReservationQuoteParams, CreateServiceParams, UpdateServiceParams, DeleteServiceParams, GetServiceParams, GetServicesParams, GetAvailableSlotsParams, CreateProviderParams, UpdateProviderParams, DeleteProviderParams, GetProviderParams, GetProvidersParams, GetBusinessServiceWorkingTimeParams } from './types.js';
+import { UpdateUserProfileParams, RequestOptions, DeleteUserParams, AddPhoneNumberParams, PhoneNumberConfirmParams, GetMeParams, SearchUsersParams, SetRoleParams, LoginUserParams, RegisterUserParams, LogoutParams, ConfirmUserParams, GetLoginUrlParams, ForgotPasswordParams, ResetForgotPasswordParams, ResetPasswordParams, UserSubscribeParams, CreateBusinessParams, UpdateBusinessParams, DeleteBusinessParams, GetBusinessParams, GetBusinessesParams, GetBusinessParentsParams, TriggerBuildsParams, GetSubscriptionPlansParams, GetSubscriptionParams, SubscribeParams, CreatePortalSessionParams, InviteUserParams, HandleInvitationParams, TestWebhookParams, GetBusinessMediaParams2, SetProviderScheduleParams, ProcessRefundParams, UploadBusinessMediaParams, DeleteBusinessMediaParams, GetBusinessMediaParams, UpdateMediaParams, CreateRoleParams, UpdateRoleParams, DeleteRoleParams, GetRoleParams, GetRolesParams, TrackEmailOpenParams, GetDeliveryStatsParams, CreatePromoCodeParams, UpdatePromoCodeParams, DeletePromoCodeParams, GetPromoCodeParams, GetPromoCodesParams, GetAnalyticsParams, CreateCollectionParams, UpdateCollectionParams, DeleteCollectionParams, GetCollectionParams, GetCollectionsParams, GenerateBlocksParams, GetEntriesParams, CreateEntryParams, UpdateEntryParams, DeleteCollectionEntryParams, GetCollectionEntryParams, SendEntryParams, GetVariableMetadataParams, GetCollectionSubscribersParams, CreateProductParams, UpdateProductParams, DeleteProductParams, GetProductParams, GetProductsParams, CreateOrderParams, UpdateOrderParams, GetOrderParams, GetOrdersParams, UpdateOrderStatusParams, UpdateOrderPaymentStatusParams, GetQuoteParams, CheckoutParams, CreateReservationParams, UpdateReservationParams, ReservationCheckoutParams, GetReservationParams, SearchReservationsParams, SearchMyReservationsParams, GetReservationQuoteParams, CreateServiceParams, UpdateServiceParams, DeleteServiceParams, GetServiceParams, GetServicesParams, GetAvailableSlotsParams, CreateProviderParams, UpdateProviderParams, DeleteProviderParams, GetProviderParams, GetProvidersParams, GetBusinessServiceWorkingTimeParams, CreateFeatureFlagParams, FeatureFlag, GetFeatureFlagParams, GetFeatureFlagsParams, UpdateFeatureFlagParams, DeleteFeatureFlagParams, GetFeatureFlagResultsParams, FlagResults, GetVariantParams, GetVariantResponse, TrackEventParams, TrackEventResponse } from './types.js';
 export { ApiResponse, Block, Business, EshopCartItem, EshopStoreState, Price, ReservationCartItem, ReservationStoreState } from './types.js';
 import { g as getBlockLabel, a as getBlockTextValue, f as formatBlockValue, p as prepareBlocksForSubmission, e as extractBlockValues, b as getMarketPrice, c as getPriceAmount, d as formatPayment, h as formatMinor, i as createPaymentForCheckout, j as getCurrencySymbol, v as validatePhoneNumber, k as findTimeZone, s as slugify, l as humanize, m as categorify, n as formatDate, o as getSvgContentForAstro, q as fetchSvgContent, r as injectSvgIntoElement } from './svg-4hIdMU6f.js';
 
@@ -182,6 +182,27 @@ declare function createArkySDK(config: HttpClientConfig & {
         deleteData(params: DeleteDataParams, options?: RequestOptions): Promise<void>;
         runScript(params: RunScriptParams, options?: RequestOptions): Promise<RunScriptResponse>;
     };
+    featureFlags: {
+        createFlag(params: CreateFeatureFlagParams, options?: RequestOptions<FeatureFlag>): Promise<FeatureFlag>;
+        getFlag(params: GetFeatureFlagParams, options?: RequestOptions<FeatureFlag>): Promise<FeatureFlag>;
+        getFlags(params?: GetFeatureFlagsParams, options?: RequestOptions<FeatureFlag[]>): Promise<FeatureFlag[]>;
+        updateFlag(params: UpdateFeatureFlagParams, options?: RequestOptions<FeatureFlag>): Promise<FeatureFlag>;
+        deleteFlag(params: DeleteFeatureFlagParams, options?: RequestOptions<{
+            deleted: boolean;
+        }>): Promise<{
+            deleted: boolean;
+        }>;
+        getResults(params: GetFeatureFlagResultsParams, options?: RequestOptions<FlagResults>): Promise<FlagResults>;
+        getVariant(params: GetVariantParams, options?: RequestOptions<GetVariantResponse>): Promise<GetVariantResponse>;
+        trackEvent(params: TrackEventParams, options?: RequestOptions<TrackEventResponse>): Promise<TrackEventResponse>;
+        isEnabled(flagKey: string): Promise<boolean>;
+        getVariantWithDefault<T = any>(flagKey: string, defaultValue: T): Promise<{
+            variantKey: string;
+            payload: T;
+        }>;
+        activateFlag(id: string): Promise<FeatureFlag>;
+        archiveFlag(id: string): Promise<FeatureFlag>;
+    };
     setBusinessId: (businessId: string) => void;
     getBusinessId: () => string;
     setMarket: (market: string) => void;

package/dist/index.js

@@ -1186,6 +1186,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 = {
@@ -1578,6 +1707,7 @@ function createArkySDK(config) {
     eshop: createEshopApi(apiConfig),
     reservation: createReservationApi(apiConfig),
     database: createDatabaseApi(apiConfig),
+    featureFlags: createFeatureFlagsApi(apiConfig),
     setBusinessId: (businessId) => {
       apiConfig.businessId = businessId;
     },