@jammysunshine/astrology-api-client 1.0.0

package/src/utils/RequestBatcher.js

@@ -0,0 +1,28 @@
+const { v4: uuid } = require('uuid');
+
+/**
+ * Request Batcher for aggregating independent calls (SDK Sec 9.B)
+ */
+class RequestBatcher {
+  constructor(apiClient) {
+    this.apiClient = apiClient;
+  }
+
+  async batch(calls) {
+    const payload = {
+      requestId: uuid(),
+      timestamp: new Date().toISOString(),
+      isBatch: true,
+      requests: calls.map(c => ({
+        service: c.service,
+        method: c.method,
+        params: c.params
+      }))
+    };
+
+    const result = await this.apiClient._executeRequest('gateway', 'batch', payload);
+    return result.results;
+  }
+}
+
+module.exports = RequestBatcher;

package/src/utils/ResponseDetective.js

@@ -0,0 +1,24 @@
+/**
+ * Detects response types: JSON, Text (AI), or Binary (Charts/PDFs)
+ */
+class ResponseDetective {
+  static detect(response) {
+    const contentType = response.headers['content-type'] || '';
+    
+    if (contentType.includes('application/json')) {
+      return 'JSON';
+    }
+    
+    if (contentType.includes('image/') || contentType.includes('application/pdf')) {
+      return 'BINARY';
+    }
+    
+    if (contentType.includes('text/plain')) {
+      return 'TEXT';
+    }
+
+    return 'UNKNOWN';
+  }
+}
+
+module.exports = ResponseDetective;

package/src/utils/formatter.js

@@ -0,0 +1,43 @@
+/**
+ * Shared SDK Formatter for consistent cross-platform data structures (SDK Sec 11.C)
+ */
+class SDKFormatter {
+  /**
+   * Structures chat responses consistently across WhatsApp and Mobile UIs
+   */
+  static formatChatResponse(data) {
+    return {
+      text: data.summary || data.text || data.interpretation || '',
+      buttons: (data.suggestions || []).map(s => ({
+        id: s.id || s.action,
+        title: s.label || s.title || s.text
+      })).slice(0, 3), // Standard Meta Button Limit
+      list: (data.options || []).map(o => ({
+        id: o.id || o.value,
+        title: o.label || o.title,
+        description: o.description || o.desc
+      })).slice(0, 10), // Standard Meta List Limit
+      metadata: data.metadata || {}
+    };
+  }
+
+  static formatMessage(data) {
+    // Shared structure for chat-like responses
+    return {
+      text: data.summary || data.text || '',
+      metadata: data.metadata || {},
+      actions: data.suggestions || []
+    };
+  }
+
+  static wrapBinary(buffer, type) {
+    return {
+      type: 'BINARY',
+      buffer,
+      contentType: type,
+      length: buffer.byteLength
+    };
+  }
+}
+
+module.exports = SDKFormatter;

package/src/utils/retry.js

@@ -0,0 +1,34 @@
+/**
+ * Exponential Backoff Retry Utility
+ */
+async function retry(fn, options = {}) {
+  const {
+    maxAttempts = 3,
+    initialDelay = 500,
+    maxDelay = 2000,
+    shouldRetry = (err) => !err.code || err.code === 'TIMEOUT' || err.code === 'ECONNRESET'
+  } = options;
+
+  let attempt = 1;
+  let delay = initialDelay;
+
+  while (attempt <= maxAttempts) {
+    try {
+      return await fn();
+    } catch (error) {
+      if (attempt >= maxAttempts || !shouldRetry(error)) {
+        throw error;
+      }
+
+      console.warn(`Attempt ${attempt} failed. Retrying in ${delay}ms...`);
+      await new Promise(resolve => setTimeout(resolve, delay));
+      
+      attempt++;
+      // SDK Sec 7.B: Exponential backoff (500ms -> 1s -> 2s)
+      delay = Math.pow(2, attempt - 1) * initialDelay;
+      delay = Math.min(delay, maxDelay);
+    }
+  }
+}
+
+module.exports = retry;