@dracoonghost/trndup-sdk 1.3.25 → 1.4.0

package/dist/index.js

@@ -83,19 +83,27 @@ var TrndUpClient = class {
       () => controller.abort(),
       timeout ?? this.config.timeout
     );
+    const startTime = Date.now();
     try {
       if (this.config.debug) {
-        console.log(`[TrndUp SDK] ${method} ${url}`, { body, headers: requestHeaders });
+        this.logRequest(method, url, body);
       }
       const response = await fetch(url, {
         ...init,
         signal: signal ?? controller.signal
       });
       clearTimeout(timeoutId);
-      return await this.handleResponse(response, path);
+      const result = await this.handleResponse(response, path);
+      if (this.config.debug) {
+        this.logResponse(method, path, response.status, result, startTime);
+      }
+      return result;
     } catch (error) {
       clearTimeout(timeoutId);
       if (error instanceof TrndUpApiError) {
+        if (this.config.debug) {
+          this.logError(method, path, error, startTime);
+        }
         throw error;
       }
       const networkError = new TrndUpNetworkError(
@@ -103,11 +111,56 @@ var TrndUpClient = class {
         path
       );
       if (this.config.debug) {
-        console.error("[TrndUp SDK] Network error:", networkError);
+        this.logError(method, path, networkError, startTime);
       }
       throw networkError;
     }
   }
+  // =============================================================================
+  // LOGGING HELPERS
+  // =============================================================================
+  logRequest(method, url, body) {
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString().split("T")[1].slice(0, 12);
+    const bodyPreview = body ? this.truncateObject(body, 200) : void 0;
+    console.log(
+      `\x1B[36m[${timestamp}]\x1B[0m \x1B[33m\u2192 ${method}\x1B[0m ${url}` + (bodyPreview ? `
+  \x1B[90mbody:\x1B[0m ${bodyPreview}` : "")
+    );
+  }
+  logResponse(method, path, status, data, startTime) {
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString().split("T")[1].slice(0, 12);
+    const duration = Date.now() - startTime;
+    const statusColor = status >= 200 && status < 300 ? "\x1B[32m" : "\x1B[31m";
+    const dataPreview = this.truncateObject(data, 300);
+    console.log(
+      `\x1B[36m[${timestamp}]\x1B[0m ${statusColor}\u2190 ${status}\x1B[0m ${method} ${path} \x1B[90m(${duration}ms)\x1B[0m
+  \x1B[90mdata:\x1B[0m ${dataPreview}`
+    );
+  }
+  logError(method, path, error, startTime) {
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString().split("T")[1].slice(0, 12);
+    const duration = Date.now() - startTime;
+    if (error instanceof TrndUpApiError) {
+      console.log(
+        `\x1B[36m[${timestamp}]\x1B[0m \x1B[31m\u2715 ${error.status}\x1B[0m ${method} ${path} \x1B[90m(${duration}ms)\x1B[0m
+  \x1B[31merror:\x1B[0m ${error.code || "UNKNOWN"} - ${error.message}`
+      );
+    } else {
+      console.log(
+        `\x1B[36m[${timestamp}]\x1B[0m \x1B[31m\u2715 NETWORK\x1B[0m ${method} ${path} \x1B[90m(${duration}ms)\x1B[0m
+  \x1B[31merror:\x1B[0m ${error.message}`
+      );
+    }
+  }
+  truncateObject(obj, maxLength) {
+    try {
+      const str = JSON.stringify(obj);
+      if (str.length <= maxLength) return str;
+      return str.slice(0, maxLength) + "...";
+    } catch {
+      return "[Unable to serialize]";
+    }
+  }
   buildUrl(path, params) {
     const url = new URL(`${this.config.baseUrl}${path}`);
     if (params) {
@@ -164,9 +217,6 @@ var TrndUpClient = class {
       if (apiError.isAuthError() && this.config.onAuthFailure) {
         await this.config.onAuthFailure();
       }
-      if (this.config.debug) {
-        console.error("[TrndUp SDK] API error:", apiError);
-      }
       throw apiError;
     }
     if (isJson) {
@@ -1168,6 +1218,133 @@ var ActivityModule = class {
   }
 };
 
+// modules/trends.ts
+var TrendsModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * List trending topics with optional filters
+   * 
+   * @param params - Filter and pagination options
+   * @returns Paginated list of trends sorted by relevance
+   * 
+   * @example
+   * ```typescript
+   * // Get top trends
+   * const trends = await sdk.trends.list();
+   * 
+   * // Filter by category
+   * const sportsTrends = await sdk.trends.list({ category: 'SPORTS' });
+   * 
+   * // Filter by velocity
+   * const viralTrends = await sdk.trends.list({ velocity: 'VIRAL' });
+   * 
+   * // Paginate
+   * const page2 = await sdk.trends.list({ limit: 20, offset: 20 });
+   * ```
+   */
+  async list(params = {}) {
+    const queryParams = {};
+    if (params.category) queryParams.category = params.category;
+    if (params.velocity) queryParams.velocity = params.velocity;
+    if (params.status) queryParams.status = params.status;
+    if (params.platform) queryParams.platform = params.platform;
+    if (params.limit) queryParams.limit = params.limit;
+    if (params.offset) queryParams.offset = params.offset;
+    return this.client.get("/v1/trends", queryParams);
+  }
+  /**
+   * Get full details of a specific trend
+   * 
+   * @param trendId - The unique trend ID
+   * @returns Full trend details including content ideas and examples
+   * 
+   * @example
+   * ```typescript
+   * const trend = await sdk.trends.getById('trend_123');
+   * console.log(trend.contentIdeas);
+   * console.log(trend.topExamples);
+   * ```
+   */
+  async getById(trendId) {
+    return this.client.get(`/v1/trends/${trendId}`);
+  }
+  /**
+   * Get all categories with trend counts
+   * 
+   * @returns List of categories and their trend counts
+   * 
+   * @example
+   * ```typescript
+   * const categories = await sdk.trends.getCategories();
+   * // [{ category: 'SPORTS', count: 15 }, { category: 'TECH', count: 12 }, ...]
+   * ```
+   */
+  async getCategories() {
+    return this.client.get("/v1/trends/meta/categories");
+  }
+  /**
+   * Get all platforms with trend counts
+   * 
+   * @returns List of platforms and their trend counts
+   * 
+   * @example
+   * ```typescript
+   * const platforms = await sdk.trends.getPlatforms();
+   * // [{ platform: 'YouTube', count: 25 }, { platform: 'Instagram', count: 18 }, ...]
+   * ```
+   */
+  async getPlatforms() {
+    return this.client.get("/v1/trends/meta/platforms");
+  }
+  /**
+   * Get sync status information
+   * 
+   * @returns Current sync status and statistics
+   * 
+   * @example
+   * ```typescript
+   * const status = await sdk.trends.getSyncStatus();
+   * console.log(status.lastSyncedAt);
+   * console.log(status.totalTrends);
+   * ```
+   */
+  async getSyncStatus() {
+    return this.client.get("/v1/trends/meta/sync-status");
+  }
+  /**
+   * Get viral trends (velocity = VIRAL)
+   * Convenience method for filtering viral trends
+   * 
+   * @param limit - Max results (default: 10)
+   * @returns List of viral trends
+   */
+  async getViral(limit = 10) {
+    return this.list({ velocity: "VIRAL", limit });
+  }
+  /**
+   * Get peaking trends (status = PEAKING)
+   * Convenience method for filtering trends at peak
+   * 
+   * @param limit - Max results (default: 10)
+   * @returns List of peaking trends
+   */
+  async getPeaking(limit = 10) {
+    return this.list({ status: "PEAKING", limit });
+  }
+  /**
+   * Get trends for a specific platform
+   * 
+   * @param platform - Platform name (e.g., 'YouTube', 'Instagram')
+   * @param limit - Max results (default: 20)
+   * @returns List of trends for the platform
+   */
+  async getByPlatform(platform, limit = 20) {
+    return this.list({ platform, limit });
+  }
+};
+
 // types.ts
 var YOUTUBE_SCOPES = [
   "openid",
@@ -1195,6 +1372,7 @@ var TrndUpSDK = class extends TrndUpClient {
     this.social = new SocialModule(this);
     this.insights = new InsightsModule(this);
     this.activity = new ActivityModule(this);
+    this.trends = new TrendsModule(this);
   }
 };
 var SDK_VERSION = "1.0.0";