@dracoonghost/trndup-sdk 1.3.26 → 1.4.0

package/dist/index.js

@@ -1218,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",
@@ -1245,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";