clay-reliability-patterns

name	clay-reliability-patterns
description	Build fault-tolerant Clay integrations with circuit breakers, dead letter queues, and graceful degradation. Use when building production Clay pipelines that need resilience, implementing retry strategies, or adding fault tolerance to enrichment workflows. Trigger with phrases like "clay reliability", "clay circuit breaker", "clay resilience", "clay fallback", "clay fault tolerance", "clay dead letter queue".
allowed-tools	Read, Write, Edit, Bash(curl:*)
version	1.0.0
license	MIT
author	Jeremy Longshore <[e-mail]>
compatible-with	claude-code, codex, openclaw
tags	["saas","clay","clay-reliability"]

Clay Reliability Patterns

Overview

Production reliability patterns for Clay data enrichment pipelines. Clay's async enrichment model, credit-based billing, and dependency on 150+ external data providers require specific resilience strategies: credit budget circuit breakers, webhook delivery tracking, dead letter queues for failed batches, and graceful degradation when Clay is unavailable.

Prerequisites

• Clay integration in production or pre-production
• Redis or similar for state tracking
• Understanding of Clay's async enrichment model
• Monitoring infrastructure (see clay-observability)

Instructions

Step 1: Credit Budget Circuit Breaker

Stop processing when credit burn exceeds budget to prevent runaway costs:

// src/clay/circuit-breaker.ts
class CreditCircuitBreaker {
  private state: 'closed' | 'open' | 'half-open' = 'closed';
  private dailyCreditsUsed = 0;
  private failureCount = 0;
  private lastFailureAt: Date | null = null;
  private readonly cooldownMs: number;

  constructor(
    private dailyLimit: number,
    private failureThreshold: number = 5,
    cooldownMinutes: number = 15,
  ) {
    this.cooldownMs = cooldownMinutes *  * ;
  }

  (: ): { : ; ?:  } {
    
     (. === ) {
      
       (. && .() - ..() > .) {
        . = ;
        .();
      }  {
         { : , :  };
      }
    }

    
     (. + estimatedCredits > .) {
       { : , :  };
    }

     { :  };
  }

  () {
    . += creditsUsed;
     (. === ) {
      . = ;
      . = ;
      .();
    }
  }

  () {
    .++;
    . =  ();
     (. >= .) {
      . = ;
      .();
    }
  }

  () {
    . = ;
  }
}