1# Integration Patterns
2 
3## Enable Argo + Tiered Cache
4 
5```typescript
6async function enableOptimalPerformance(client: Cloudflare, zoneId: string) {
7  await Promise.all([
8    client.argo.smartRouting.edit({ zone_id: zoneId, value: 'on' }),
9    client.argo.tieredCaching.edit({ zone_id: zoneId, value: 'on' }),
10  ]);
11}
12```
13 
14**Flow:** Visitor → Edge (Lower-Tier) → [Cache Miss] → Upper-Tier → [Cache Miss + Argo] → Origin
15 
16**Impact:** Argo ~30% latency reduction + Tiered Cache 50-80% origin offload
17 
18## Usage Analytics (GraphQL)
19 
20```graphql
21query ArgoAnalytics($zoneTag: string!) {
22  viewer {
23    zones(filter: { zoneTag: $zoneTag }) {
24      httpRequestsAdaptiveGroups(limit: 1000) {
25        sum { argoBytes, bytes }
26      }
27    }
28  }
29}
30```
31 
32**Billing:** ~$0.10/GB. DDoS-mitigated and WAF-blocked traffic NOT charged.
33 
34## Spectrum TCP Integration
35 
36Enable Argo for non-HTTP traffic (databases, game servers, IoT):
37 
38```typescript
39// Update existing app
40await client.spectrum.apps.update(appId, { zone_id: zoneId, argo_smart_routing: true });
41 
42// Create new app with Argo
43await client.spectrum.apps.create({
44  zone_id: zoneId,
45  dns: { type: 'CNAME', name: 'tcp.example.com' },
46  origin_direct: ['tcp://origin.example.com:3306'],
47  protocol: 'tcp/3306',
48  argo_smart_routing: true,
49});
50```
51 
52**Use cases:** MySQL/PostgreSQL (3306/5432), game servers, MQTT (1883), SSH (22)
53 
54## Pre-Flight Validation
55 
56```typescript
57async function validateArgoEligibility(client: Cloudflare, zoneId: string) {
58  const status = await client.argo.smartRouting.get({ zone_id: zoneId });
59  const zone = await client.zones.get({ zone_id: zoneId });
60  
61  const issues: string[] = [];
62  if (!status.editable) issues.push('Zone not editable');
63  if (['free', 'pro'].includes(zone.plan.legacy_id)) issues.push('Requires Business+ plan');
64  if (zone.status !== 'active') issues.push('Zone not active');
65  
66  return { canEnable: issues.length === 0, issues };
67}
68```
69 
70## Post-Enable Verification
71 
72```typescript
73async function verifyArgoEnabled(client: Cloudflare, zoneId: string): Promise<boolean> {
74  await new Promise(r => setTimeout(r, 2000)); // Wait for propagation
75  const status = await client.argo.smartRouting.get({ zone_id: zoneId });
76  return status.value === 'on';
77}
78```
79 
80## Full Setup Pattern
81 
82```typescript
83async function setupArgo(client: Cloudflare, zoneId: string) {
84  // 1. Validate
85  const { canEnable, issues } = await validateArgoEligibility(client, zoneId);
86  if (!canEnable) throw new Error(issues.join(', '));
87  
88  // 2. Enable both features
89  await Promise.all([
90    client.argo.smartRouting.edit({ zone_id: zoneId, value: 'on' }),
91    client.argo.tieredCaching.edit({ zone_id: zoneId, value: 'on' }),
92  ]);
93  
94  // 3. Verify
95  const [argo, cache] = await Promise.all([
96    client.argo.smartRouting.get({ zone_id: zoneId }),
97    client.argo.tieredCaching.get({ zone_id: zoneId }),
98  ]);
99  
100  return { argo: argo.value === 'on', tieredCache: cache.value === 'on' };
101}
102```
103 
104**When to combine:** High-traffic sites (>1TB/mo), global users, cacheable content.
105