@dracoonghost/trndup-sdk 1.3.18 → 1.3.19

package/dist/index.d.mts

@@ -1023,6 +1023,61 @@ declare namespace Insights {
         data: OptimalVideoLengthData;
         _meta: InsightMeta;
     };
+    /** Consistency status levels */
+    type ConsistencyStatus = 'excellent' | 'good' | 'needs_improvement' | 'poor' | 'inactive';
+    /** Monthly upload breakdown */
+    interface MonthlyUploadData {
+        month: string;
+        uploads: number;
+        avgGap: number | null;
+    }
+    /** Upload consistency insight data */
+    interface UploadConsistencyData {
+        /** Period analyzed */
+        period: {
+            start: string;
+            end: string;
+            days: number;
+        };
+        /** Overall consistency score (0-100) */
+        consistencyScore: number;
+        /** Status label */
+        status: ConsistencyStatus;
+        /** Key metrics */
+        metrics: {
+            totalUploads: number;
+            avgDaysBetweenUploads: number;
+            uploadVariance: number;
+            daysSinceLastUpload: number;
+            lastUploadDate: string | null;
+        };
+        /** Upload pattern analysis */
+        pattern: {
+            isRegular: boolean;
+            typicalGap: string;
+            longestStreak: number;
+            currentStreak: number;
+            trend: 'increasing' | 'stable' | 'decreasing';
+            trendDescription: string;
+        };
+        /** Monthly breakdown */
+        monthlyBreakdown: MonthlyUploadData[];
+        /** Frequency recommendation */
+        recommendation: {
+            suggested: string;
+            current: string;
+            reason: string;
+        };
+        /** Human-readable summary */
+        insight: string;
+        /** Actionable recommendations */
+        recommendations: string[];
+    }
+    type UploadConsistencyResponse = (InsufficientDataResponse) | {
+        hasData: true;
+        data: UploadConsistencyData;
+        _meta: InsightMeta;
+    };
     interface AllInsightsData {
         bestPerformingVideo: BestPerformingVideoResponse;
         contentDecay: ContentDecayResponse;
@@ -1031,6 +1086,7 @@ declare namespace Insights {
         fadingHits: FadingHitsResponse;
         audienceFatigue: AudienceFatigueResponse;
         optimalLength: OptimalVideoLengthResponse;
+        uploadConsistency: UploadConsistencyResponse;
     }
     interface AllInsightsResponse {
         data: AllInsightsData;
@@ -1761,6 +1817,40 @@ declare class InsightsModule {
      * GET /v1/insights/youtube/optimal-length
      */
     getYouTubeOptimalLength(): Promise<Insights.OptimalVideoLengthResponse>;
+    /**
+     * Analyze your upload schedule consistency
+     *
+     * Measures how regularly you upload and provides recommendations
+     * for maintaining a consistent schedule that helps algorithm performance.
+     *
+     * @example
+     * ```typescript
+     * const result = await client.insights.getYouTubeUploadConsistency();
+     *
+     * if (result.hasData) {
+     *   console.log(`Consistency Score: ${result.data.consistencyScore}/100`);
+     *   console.log(`Status: ${result.data.status}`);
+     *   console.log(`Avg gap: ${result.data.metrics.avgDaysBetweenUploads} days`);
+     *   console.log(`Days since last upload: ${result.data.metrics.daysSinceLastUpload}`);
+     *
+     *   // Pattern analysis
+     *   console.log(`Pattern: ${result.data.pattern.typicalGap}`);
+     *   console.log(`Trend: ${result.data.pattern.trendDescription}`);
+     *
+     *   // Recommendation
+     *   console.log(`Current: ${result.data.recommendation.current}`);
+     *   console.log(`Suggested: ${result.data.recommendation.suggested}`);
+     *
+     *   // Monthly breakdown
+     *   for (const month of result.data.monthlyBreakdown) {
+     *     console.log(`${month.month}: ${month.uploads} uploads`);
+     *   }
+     * }
+     * ```
+     *
+     * GET /v1/insights/youtube/upload-consistency
+     */
+    getYouTubeUploadConsistency(): Promise<Insights.UploadConsistencyResponse>;
     /**
      * Get all YouTube insights in one call
      *
@@ -1783,8 +1873,8 @@ declare class InsightsModule {
      *   console.log(`Fatigue: ${all.data.audienceFatigue.data.fatigueLevel}`);
      * }
      *
-     * if (all.data.optimalLength.hasData) {
-     *   console.log(`Optimal Length: ${all.data.optimalLength.data.optimalLength.bucket}`);
+     * if (all.data.uploadConsistency.hasData) {
+     *   console.log(`Consistency: ${all.data.uploadConsistency.data.consistencyScore}/100`);
      * }
      * ```
      *

package/dist/index.d.ts

@@ -1023,6 +1023,61 @@ declare namespace Insights {
         data: OptimalVideoLengthData;
         _meta: InsightMeta;
     };
+    /** Consistency status levels */
+    type ConsistencyStatus = 'excellent' | 'good' | 'needs_improvement' | 'poor' | 'inactive';
+    /** Monthly upload breakdown */
+    interface MonthlyUploadData {
+        month: string;
+        uploads: number;
+        avgGap: number | null;
+    }
+    /** Upload consistency insight data */
+    interface UploadConsistencyData {
+        /** Period analyzed */
+        period: {
+            start: string;
+            end: string;
+            days: number;
+        };
+        /** Overall consistency score (0-100) */
+        consistencyScore: number;
+        /** Status label */
+        status: ConsistencyStatus;
+        /** Key metrics */
+        metrics: {
+            totalUploads: number;
+            avgDaysBetweenUploads: number;
+            uploadVariance: number;
+            daysSinceLastUpload: number;
+            lastUploadDate: string | null;
+        };
+        /** Upload pattern analysis */
+        pattern: {
+            isRegular: boolean;
+            typicalGap: string;
+            longestStreak: number;
+            currentStreak: number;
+            trend: 'increasing' | 'stable' | 'decreasing';
+            trendDescription: string;
+        };
+        /** Monthly breakdown */
+        monthlyBreakdown: MonthlyUploadData[];
+        /** Frequency recommendation */
+        recommendation: {
+            suggested: string;
+            current: string;
+            reason: string;
+        };
+        /** Human-readable summary */
+        insight: string;
+        /** Actionable recommendations */
+        recommendations: string[];
+    }
+    type UploadConsistencyResponse = (InsufficientDataResponse) | {
+        hasData: true;
+        data: UploadConsistencyData;
+        _meta: InsightMeta;
+    };
     interface AllInsightsData {
         bestPerformingVideo: BestPerformingVideoResponse;
         contentDecay: ContentDecayResponse;
@@ -1031,6 +1086,7 @@ declare namespace Insights {
         fadingHits: FadingHitsResponse;
         audienceFatigue: AudienceFatigueResponse;
         optimalLength: OptimalVideoLengthResponse;
+        uploadConsistency: UploadConsistencyResponse;
     }
     interface AllInsightsResponse {
         data: AllInsightsData;
@@ -1761,6 +1817,40 @@ declare class InsightsModule {
      * GET /v1/insights/youtube/optimal-length
      */
     getYouTubeOptimalLength(): Promise<Insights.OptimalVideoLengthResponse>;
+    /**
+     * Analyze your upload schedule consistency
+     *
+     * Measures how regularly you upload and provides recommendations
+     * for maintaining a consistent schedule that helps algorithm performance.
+     *
+     * @example
+     * ```typescript
+     * const result = await client.insights.getYouTubeUploadConsistency();
+     *
+     * if (result.hasData) {
+     *   console.log(`Consistency Score: ${result.data.consistencyScore}/100`);
+     *   console.log(`Status: ${result.data.status}`);
+     *   console.log(`Avg gap: ${result.data.metrics.avgDaysBetweenUploads} days`);
+     *   console.log(`Days since last upload: ${result.data.metrics.daysSinceLastUpload}`);
+     *
+     *   // Pattern analysis
+     *   console.log(`Pattern: ${result.data.pattern.typicalGap}`);
+     *   console.log(`Trend: ${result.data.pattern.trendDescription}`);
+     *
+     *   // Recommendation
+     *   console.log(`Current: ${result.data.recommendation.current}`);
+     *   console.log(`Suggested: ${result.data.recommendation.suggested}`);
+     *
+     *   // Monthly breakdown
+     *   for (const month of result.data.monthlyBreakdown) {
+     *     console.log(`${month.month}: ${month.uploads} uploads`);
+     *   }
+     * }
+     * ```
+     *
+     * GET /v1/insights/youtube/upload-consistency
+     */
+    getYouTubeUploadConsistency(): Promise<Insights.UploadConsistencyResponse>;
     /**
      * Get all YouTube insights in one call
      *
@@ -1783,8 +1873,8 @@ declare class InsightsModule {
      *   console.log(`Fatigue: ${all.data.audienceFatigue.data.fatigueLevel}`);
      * }
      *
-     * if (all.data.optimalLength.hasData) {
-     *   console.log(`Optimal Length: ${all.data.optimalLength.data.optimalLength.bucket}`);
+     * if (all.data.uploadConsistency.hasData) {
+     *   console.log(`Consistency: ${all.data.uploadConsistency.data.consistencyScore}/100`);
      * }
      * ```
      *

package/dist/index.js

@@ -859,6 +859,47 @@ var InsightsModule = class {
     );
   }
   // =========================================================================
+  // YOUTUBE UPLOAD CONSISTENCY
+  // =========================================================================
+  /**
+   * Analyze your upload schedule consistency
+   * 
+   * Measures how regularly you upload and provides recommendations
+   * for maintaining a consistent schedule that helps algorithm performance.
+   * 
+   * @example
+   * ```typescript
+   * const result = await client.insights.getYouTubeUploadConsistency();
+   * 
+   * if (result.hasData) {
+   *   console.log(`Consistency Score: ${result.data.consistencyScore}/100`);
+   *   console.log(`Status: ${result.data.status}`);
+   *   console.log(`Avg gap: ${result.data.metrics.avgDaysBetweenUploads} days`);
+   *   console.log(`Days since last upload: ${result.data.metrics.daysSinceLastUpload}`);
+   *   
+   *   // Pattern analysis
+   *   console.log(`Pattern: ${result.data.pattern.typicalGap}`);
+   *   console.log(`Trend: ${result.data.pattern.trendDescription}`);
+   *   
+   *   // Recommendation
+   *   console.log(`Current: ${result.data.recommendation.current}`);
+   *   console.log(`Suggested: ${result.data.recommendation.suggested}`);
+   *   
+   *   // Monthly breakdown
+   *   for (const month of result.data.monthlyBreakdown) {
+   *     console.log(`${month.month}: ${month.uploads} uploads`);
+   *   }
+   * }
+   * ```
+   * 
+   * GET /v1/insights/youtube/upload-consistency
+   */
+  async getYouTubeUploadConsistency() {
+    return this.client.get(
+      "/v1/insights/youtube/upload-consistency"
+    );
+  }
+  // =========================================================================
   // YOUTUBE ALL INSIGHTS
   // =========================================================================
   /**
@@ -883,8 +924,8 @@ var InsightsModule = class {
    *   console.log(`Fatigue: ${all.data.audienceFatigue.data.fatigueLevel}`);
    * }
    * 
-   * if (all.data.optimalLength.hasData) {
-   *   console.log(`Optimal Length: ${all.data.optimalLength.data.optimalLength.bucket}`);
+   * if (all.data.uploadConsistency.hasData) {
+   *   console.log(`Consistency: ${all.data.uploadConsistency.data.consistencyScore}/100`);
    * }
    * ```
    *