@plyaz/api 1.6.8 → 1.7.1

package/dist/index.cjs

@@ -9148,6 +9148,9 @@ var UnifiedDebugger = class _UnifiedDebugger {
   performanceMode = "minimal";
   trackAllProperties = true;
   // If false, uses TRACKED_PROPERTIES filter
+  // Debug report control - disabled by default, enable via config:
+  // createApiClient({ debugEvents: { comprehensiveReport: true } })
+  comprehensiveReportEnabled = false;
   // Tracking configuration from API config
   trackingConfig = {};
   // Configurable limits
@@ -9576,8 +9579,14 @@ var UnifiedDebugger = class _UnifiedDebugger {
   }
   /**
    * Log comprehensive report to console
+   *
+   * Controlled via API config: debugEvents.comprehensiveReport = true
+   * Or programmatically via setComprehensiveReportEnabled(true)
    */
   async logComprehensiveReport() {
+    if (!this.comprehensiveReportEnabled) {
+      return;
+    }
     try {
       const presetReport = this.getPresetChangeReport();
       if (presetReport) {
@@ -9599,6 +9608,20 @@ var UnifiedDebugger = class _UnifiedDebugger {
       throw error;
     }
   }
+  /**
+   * Enable or disable comprehensive debug report logging
+   *
+   * Typically configured via API config: debugEvents.comprehensiveReport
+   */
+  setComprehensiveReportEnabled(enabled) {
+    this.comprehensiveReportEnabled = enabled;
+  }
+  /**
+   * Get current comprehensive report enabled state
+   */
+  getComprehensiveReportEnabled() {
+    return this.comprehensiveReportEnabled;
+  }
   /**
    * Get debug report (alias for generateDebugReport for API consistency)
    */
@@ -16174,6 +16197,11 @@ var ClientEventManager = class _ClientEventManager {
       this.config.configOverride.eventScopes ??= [...api.EVENT_SCOPES];
     }
     eventManager.setEventScopes(this.config.configOverride.eventScopes);
+    if (this.config.debugEvents?.comprehensiveReport !== void 0) {
+      getUnifiedDebugger().setComprehensiveReportEnabled(
+        this.config.debugEvents.comprehensiveReport
+      );
+    }
     this.setupEventHandlers();
   }
   static {
@@ -16817,6 +16845,7 @@ var ClientEventManager = class _ClientEventManager {
   /**
    * Start monitoring
    */
+  // eslint-disable-next-line complexity
   startMonitoring() {
     if (this.monitoringState.monitoring) return;
     this.monitoringState.monitoring = true;
@@ -16831,6 +16860,9 @@ var ClientEventManager = class _ClientEventManager {
       const id = setInterval(() => this.getDebugInfo(), interval);
       this.monitoringState.intervals.push(id);
     }
+    if (debugConfig?.comprehensiveReport !== void 0) {
+      getUnifiedDebugger().setComprehensiveReportEnabled(debugConfig.comprehensiveReport);
+    }
   }
   /**
    * Stop monitoring
@@ -17220,6 +17252,24 @@ var unifiedStrategies = {
     // Wait for network/resources
     performance: "offline"
     // Offline-first, maximum caching
+  },
+  /**
+   * Mutation: POST/PUT/DELETE operations (uploads, creates, updates, deletes)
+   * - NO caching (mutations should never be cached)
+   * - Standard retry for actual failures
+   * - NO polling (critical! - polling causes duplicate mutations)
+   * - Realtime performance (immediate response)
+   *
+   * Use this for any data-modifying operation to prevent duplicate requests.
+   */
+  mutation: {
+    cache: "none",
+    // Never cache mutations
+    retry: "standard",
+    // Standard retry for actual failures (not successes)
+    // NO polling - this is critical! Polling would re-execute the mutation
+    performance: "realtime"
+    // Immediate response, no batching
   }
 };
 function applyUnifiedStrategy(strategyName) {
@@ -25633,7 +25683,7 @@ __name(useCampaignParticipants, "useCampaignParticipants");
 // src/api/services/campaigns/POST/createCampaign.ts
 async function createCampaign(data, options) {
   const client = options?.apiClient ?? getDefaultApiClient();
-  const serviceDefaults = { unifiedStrategy: "realtime" };
+  const serviceDefaults = { unifiedStrategy: "mutation" };
   const mergedConfig = mergeConfigs(serviceDefaults, options?.apiConfig ?? {});
   const updateOptions = {
     strategy: "temporary",
@@ -25657,7 +25707,7 @@ async function joinCampaign(campaignId, options) {
       api.API_ERROR_CODES.REQUIRED_FIELD_MISSING
     );
   }
-  const serviceDefaults = { unifiedStrategy: "realtime" };
+  const serviceDefaults = { unifiedStrategy: "mutation" };
   const mergedConfig = mergeConfigs(serviceDefaults, options?.apiConfig ?? {});
   const updateOptions = {
     strategy: "temporary",
@@ -25681,7 +25731,7 @@ async function leaveCampaign(campaignId, options) {
       api.API_ERROR_CODES.REQUIRED_FIELD_MISSING
     );
   }
-  const serviceDefaults = { unifiedStrategy: "realtime" };
+  const serviceDefaults = { unifiedStrategy: "mutation" };
   const mergedConfig = mergeConfigs(serviceDefaults, options?.apiConfig ?? {});
   const updateOptions = {
     strategy: "temporary",
@@ -25763,7 +25813,7 @@ async function updateCampaign(campaignId, data, options) {
       api.API_ERROR_CODES.REQUIRED_FIELD_MISSING
     );
   }
-  const serviceDefaults = { unifiedStrategy: "realtime" };
+  const serviceDefaults = { unifiedStrategy: "mutation" };
   const mergedConfig = mergeConfigs(serviceDefaults, options?.apiConfig ?? {});
   const updateOptions = {
     strategy: "temporary",
@@ -25808,7 +25858,7 @@ async function deleteCampaign(campaignId, options) {
       api.API_ERROR_CODES.REQUIRED_FIELD_MISSING
     );
   }
-  const serviceDefaults = { unifiedStrategy: "realtime" };
+  const serviceDefaults = { unifiedStrategy: "mutation" };
   const mergedConfig = mergeConfigs(serviceDefaults, options?.apiConfig ?? {});
   const updateOptions = {
     strategy: "temporary",
@@ -25894,7 +25944,7 @@ async function checkFeatureFlagEnabled(payload, options) {
       api.API_ERROR_CODES.REQUIRED_FIELD_MISSING
     );
   }
-  const serviceDefaults = { unifiedStrategy: "realtime" };
+  const serviceDefaults = { unifiedStrategy: "mutation" };
   const mergedConfig = mergeConfigs(serviceDefaults, options?.apiConfig ?? {});
   const updateOptions = {
     strategy: "temporary",
@@ -25919,7 +25969,7 @@ async function evaluateFeatureFlag(payload, options) {
       api.API_ERROR_CODES.REQUIRED_FIELD_MISSING
     );
   }
-  const serviceDefaults = { unifiedStrategy: "realtime" };
+  const serviceDefaults = { unifiedStrategy: "mutation" };
   const mergedConfig = mergeConfigs(serviceDefaults, options?.apiConfig ?? {});
   const updateOptions = {
     strategy: "temporary",
@@ -25956,7 +26006,7 @@ __name(evaluateAllFeatureFlags, "evaluateAllFeatureFlags");
 // src/api/services/featureFlags/POST/createFeatureFlag.ts
 async function createFeatureFlag(data, options) {
   const client = options?.apiClient ?? getDefaultApiClient();
-  const serviceDefaults = { unifiedStrategy: "realtime" };
+  const serviceDefaults = { unifiedStrategy: "mutation" };
   const mergedConfig = mergeConfigs(serviceDefaults, options?.apiConfig ?? {});
   const updateOptions = {
     strategy: "temporary",
@@ -25980,7 +26030,7 @@ async function setFeatureFlagOverride(payload, options) {
       api.API_ERROR_CODES.REQUIRED_FIELD_MISSING
     );
   }
-  const serviceDefaults = { unifiedStrategy: "realtime" };
+  const serviceDefaults = { unifiedStrategy: "mutation" };
   const mergedConfig = mergeConfigs(serviceDefaults, options?.apiConfig ?? {});
   const updateOptions = {
     strategy: "temporary",
@@ -25999,7 +26049,7 @@ __name(setFeatureFlagOverride, "setFeatureFlagOverride");
 // src/api/services/featureFlags/POST/refreshFeatureFlagCache.ts
 async function refreshFeatureFlagCache(options) {
   const client = options?.apiClient ?? getDefaultApiClient();
-  const serviceDefaults = { unifiedStrategy: "realtime" };
+  const serviceDefaults = { unifiedStrategy: "mutation" };
   const mergedConfig = mergeConfigs(serviceDefaults, options?.apiConfig ?? {});
   const updateOptions = {
     strategy: "temporary",
@@ -26043,7 +26093,7 @@ async function updateFeatureFlag(payload, options) {
       api.API_ERROR_CODES.REQUIRED_FIELD_MISSING
     );
   }
-  const serviceDefaults = { unifiedStrategy: "realtime" };
+  const serviceDefaults = { unifiedStrategy: "mutation" };
   const mergedConfig = mergeConfigs(serviceDefaults, options?.apiConfig ?? {});
   const updateOptions = {
     strategy: "temporary",
@@ -26079,7 +26129,7 @@ async function deleteFeatureFlag(key, options) {
       api.API_ERROR_CODES.REQUIRED_FIELD_MISSING
     );
   }
-  const serviceDefaults = { unifiedStrategy: "realtime" };
+  const serviceDefaults = { unifiedStrategy: "mutation" };
   const mergedConfig = mergeConfigs(serviceDefaults, options?.apiConfig ?? {});
   const updateOptions = {
     strategy: "temporary",
@@ -26103,7 +26153,7 @@ async function removeFeatureFlagOverride(key, options) {
       api.API_ERROR_CODES.REQUIRED_FIELD_MISSING
     );
   }
-  const serviceDefaults = { unifiedStrategy: "realtime" };
+  const serviceDefaults = { unifiedStrategy: "mutation" };
   const mergedConfig = mergeConfigs(serviceDefaults, options?.apiConfig ?? {});
   const updateOptions = {
     strategy: "temporary",
@@ -26927,7 +26977,7 @@ __name(useGetSignedUrl, "useGetSignedUrl");
 async function uploadFile(data, options) {
   const client = options?.apiClient ?? getDefaultApiClient();
   const serviceDefaults = {
-    unifiedStrategy: "realtime",
+    unifiedStrategy: "mutation",
     timeout: 6e4
     // 60 seconds for uploads
   };
@@ -26949,7 +26999,7 @@ __name(uploadFile, "uploadFile");
 async function uploadFiles(data, options) {
   const client = options?.apiClient ?? getDefaultApiClient();
   const serviceDefaults = {
-    unifiedStrategy: "realtime",
+    unifiedStrategy: "mutation",
     timeout: 12e4
     // 2 minutes for bulk uploads
   };
@@ -26971,7 +27021,7 @@ __name(uploadFiles, "uploadFiles");
 async function generateDocument(data, options) {
   const client = options?.apiClient ?? getDefaultApiClient();
   const serviceDefaults = {
-    unifiedStrategy: "realtime",
+    unifiedStrategy: "mutation",
     timeout: 3e4
     // 30 seconds for document generation
   };
@@ -27031,7 +27081,7 @@ async function deleteFile(request, options) {
       api.API_ERROR_CODES.REQUIRED_FIELD_MISSING
     );
   }
-  const serviceDefaults = { unifiedStrategy: "realtime" };
+  const serviceDefaults = { unifiedStrategy: "mutation" };
   const mergedConfig = mergeConfigs(serviceDefaults, options?.apiConfig ?? {});
   const updateOptions = {
     strategy: "temporary",