@plyaz/api 1.6.8 → 1.7.1

package/dist/index.mjs

@@ -9132,6 +9132,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
@@ -9560,8 +9563,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) {
@@ -9583,6 +9592,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)
    */
@@ -16158,6 +16181,11 @@ var ClientEventManager = class _ClientEventManager {
       this.config.configOverride.eventScopes ??= [...EVENT_SCOPES$1];
     }
     eventManager.setEventScopes(this.config.configOverride.eventScopes);
+    if (this.config.debugEvents?.comprehensiveReport !== void 0) {
+      getUnifiedDebugger().setComprehensiveReportEnabled(
+        this.config.debugEvents.comprehensiveReport
+      );
+    }
     this.setupEventHandlers();
   }
   static {
@@ -16801,6 +16829,7 @@ var ClientEventManager = class _ClientEventManager {
   /**
    * Start monitoring
    */
+  // eslint-disable-next-line complexity
   startMonitoring() {
     if (this.monitoringState.monitoring) return;
     this.monitoringState.monitoring = true;
@@ -16815,6 +16844,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
@@ -17204,6 +17236,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) {
@@ -25617,7 +25667,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",
@@ -25641,7 +25691,7 @@ async function joinCampaign(campaignId, options) {
       API_ERROR_CODES.REQUIRED_FIELD_MISSING
     );
   }
-  const serviceDefaults = { unifiedStrategy: "realtime" };
+  const serviceDefaults = { unifiedStrategy: "mutation" };
   const mergedConfig = mergeConfigs(serviceDefaults, options?.apiConfig ?? {});
   const updateOptions = {
     strategy: "temporary",
@@ -25665,7 +25715,7 @@ async function leaveCampaign(campaignId, options) {
       API_ERROR_CODES.REQUIRED_FIELD_MISSING
     );
   }
-  const serviceDefaults = { unifiedStrategy: "realtime" };
+  const serviceDefaults = { unifiedStrategy: "mutation" };
   const mergedConfig = mergeConfigs(serviceDefaults, options?.apiConfig ?? {});
   const updateOptions = {
     strategy: "temporary",
@@ -25747,7 +25797,7 @@ async function updateCampaign(campaignId, data, options) {
       API_ERROR_CODES.REQUIRED_FIELD_MISSING
     );
   }
-  const serviceDefaults = { unifiedStrategy: "realtime" };
+  const serviceDefaults = { unifiedStrategy: "mutation" };
   const mergedConfig = mergeConfigs(serviceDefaults, options?.apiConfig ?? {});
   const updateOptions = {
     strategy: "temporary",
@@ -25792,7 +25842,7 @@ async function deleteCampaign(campaignId, options) {
       API_ERROR_CODES.REQUIRED_FIELD_MISSING
     );
   }
-  const serviceDefaults = { unifiedStrategy: "realtime" };
+  const serviceDefaults = { unifiedStrategy: "mutation" };
   const mergedConfig = mergeConfigs(serviceDefaults, options?.apiConfig ?? {});
   const updateOptions = {
     strategy: "temporary",
@@ -25878,7 +25928,7 @@ async function checkFeatureFlagEnabled(payload, options) {
       API_ERROR_CODES.REQUIRED_FIELD_MISSING
     );
   }
-  const serviceDefaults = { unifiedStrategy: "realtime" };
+  const serviceDefaults = { unifiedStrategy: "mutation" };
   const mergedConfig = mergeConfigs(serviceDefaults, options?.apiConfig ?? {});
   const updateOptions = {
     strategy: "temporary",
@@ -25903,7 +25953,7 @@ async function evaluateFeatureFlag(payload, options) {
       API_ERROR_CODES.REQUIRED_FIELD_MISSING
     );
   }
-  const serviceDefaults = { unifiedStrategy: "realtime" };
+  const serviceDefaults = { unifiedStrategy: "mutation" };
   const mergedConfig = mergeConfigs(serviceDefaults, options?.apiConfig ?? {});
   const updateOptions = {
     strategy: "temporary",
@@ -25940,7 +25990,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",
@@ -25964,7 +26014,7 @@ async function setFeatureFlagOverride(payload, options) {
       API_ERROR_CODES.REQUIRED_FIELD_MISSING
     );
   }
-  const serviceDefaults = { unifiedStrategy: "realtime" };
+  const serviceDefaults = { unifiedStrategy: "mutation" };
   const mergedConfig = mergeConfigs(serviceDefaults, options?.apiConfig ?? {});
   const updateOptions = {
     strategy: "temporary",
@@ -25983,7 +26033,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",
@@ -26027,7 +26077,7 @@ async function updateFeatureFlag(payload, options) {
       API_ERROR_CODES.REQUIRED_FIELD_MISSING
     );
   }
-  const serviceDefaults = { unifiedStrategy: "realtime" };
+  const serviceDefaults = { unifiedStrategy: "mutation" };
   const mergedConfig = mergeConfigs(serviceDefaults, options?.apiConfig ?? {});
   const updateOptions = {
     strategy: "temporary",
@@ -26063,7 +26113,7 @@ async function deleteFeatureFlag(key, options) {
       API_ERROR_CODES.REQUIRED_FIELD_MISSING
     );
   }
-  const serviceDefaults = { unifiedStrategy: "realtime" };
+  const serviceDefaults = { unifiedStrategy: "mutation" };
   const mergedConfig = mergeConfigs(serviceDefaults, options?.apiConfig ?? {});
   const updateOptions = {
     strategy: "temporary",
@@ -26087,7 +26137,7 @@ async function removeFeatureFlagOverride(key, options) {
       API_ERROR_CODES.REQUIRED_FIELD_MISSING
     );
   }
-  const serviceDefaults = { unifiedStrategy: "realtime" };
+  const serviceDefaults = { unifiedStrategy: "mutation" };
   const mergedConfig = mergeConfigs(serviceDefaults, options?.apiConfig ?? {});
   const updateOptions = {
     strategy: "temporary",
@@ -26911,7 +26961,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
   };
@@ -26933,7 +26983,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
   };
@@ -26955,7 +27005,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
   };
@@ -27015,7 +27065,7 @@ async function deleteFile(request, options) {
       API_ERROR_CODES.REQUIRED_FIELD_MISSING
     );
   }
-  const serviceDefaults = { unifiedStrategy: "realtime" };
+  const serviceDefaults = { unifiedStrategy: "mutation" };
   const mergedConfig = mergeConfigs(serviceDefaults, options?.apiConfig ?? {});
   const updateOptions = {
     strategy: "temporary",