@memberjunction/actions-bizapps-social 2.61.0

package/dist/providers/tiktok/actions/get-account-analytics.action.js

@@ -0,0 +1,242 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetAccountAnalyticsAction = void 0;
+const global_1 = require("@memberjunction/global");
+const tiktok_base_action_1 = require("../tiktok-base.action");
+/**
+ * Action to get analytics for a TikTok account
+ */
+let GetAccountAnalyticsAction = class GetAccountAnalyticsAction extends tiktok_base_action_1.TikTokBaseAction {
+    /**
+     * Get account-level analytics from TikTok
+     */
+    async InternalRunAction(params) {
+        const { Params } = params;
+        try {
+            // Initialize OAuth
+            const companyIntegrationId = this.getParamValue(Params, 'CompanyIntegrationID');
+            if (!companyIntegrationId) {
+                throw new Error('CompanyIntegrationID is required');
+            }
+            await this.initializeOAuth(companyIntegrationId);
+            // Extract parameters
+            const dateRange = this.getParamValue(Params, 'DateRange') || '30d';
+            const includeVideoStats = this.getParamValue(Params, 'IncludeVideoStats') !== false;
+            const includeAudienceData = this.getParamValue(Params, 'IncludeAudienceData') !== false;
+            // Get current user info
+            const userInfo = await this.getCurrentUser();
+            // Get user's videos for aggregate stats
+            let videoStats = null;
+            if (includeVideoStats) {
+                const videos = await this.getUserVideos();
+                // Calculate video statistics
+                videoStats = {
+                    totalVideos: videos.length,
+                    totalViews: videos.reduce((sum, v) => sum + v.view_count, 0),
+                    totalLikes: videos.reduce((sum, v) => sum + v.like_count, 0),
+                    totalComments: videos.reduce((sum, v) => sum + v.comment_count, 0),
+                    totalShares: videos.reduce((sum, v) => sum + v.share_count, 0),
+                    averageViewsPerVideo: videos.length > 0
+                        ? Math.round(videos.reduce((sum, v) => sum + v.view_count, 0) / videos.length)
+                        : 0,
+                    averageEngagementRate: videos.length > 0
+                        ? this.calculateAverageEngagementRate(videos)
+                        : 0,
+                    topVideos: videos
+                        .sort((a, b) => b.view_count - a.view_count)
+                        .slice(0, 5)
+                        .map(v => ({
+                        id: v.id,
+                        title: v.title,
+                        views: v.view_count,
+                        likes: v.like_count,
+                        url: v.share_url
+                    }))
+                };
+            }
+            // Build account analytics
+            const accountAnalytics = {
+                accountInfo: {
+                    userId: userInfo.open_id,
+                    username: userInfo.display_name,
+                    isVerified: userInfo.is_verified,
+                    profileUrl: userInfo.profile_deep_link,
+                    avatarUrl: userInfo.avatar_url,
+                    bio: userInfo.bio_description
+                },
+                metrics: {
+                    followers: userInfo.follower_count,
+                    following: userInfo.following_count,
+                    totalLikes: userInfo.likes_count,
+                    engagementRate: this.calculateAccountEngagementRate(userInfo, videoStats),
+                    growthRate: null // Would need historical data
+                },
+                videoStats,
+                dateRange,
+                generatedAt: new Date()
+            };
+            // Build audience data if requested (placeholder - TikTok API limitations)
+            let audienceData = null;
+            if (includeAudienceData) {
+                audienceData = {
+                    demographics: {
+                        message: 'Detailed audience demographics require TikTok For Business account'
+                    },
+                    topCountries: [],
+                    topCities: [],
+                    ageGroups: [],
+                    genderSplit: {}
+                };
+            }
+            // Create summary
+            const summary = {
+                accountLevel: {
+                    followers: userInfo.follower_count,
+                    engagement: accountAnalytics.metrics.engagementRate,
+                    verified: userInfo.is_verified
+                },
+                contentPerformance: videoStats ? {
+                    totalContent: videoStats.totalVideos,
+                    totalReach: videoStats.totalViews,
+                    avgEngagement: videoStats.averageEngagementRate
+                } : null,
+                recommendations: this.generateRecommendations(accountAnalytics)
+            };
+            // Update output parameters
+            const outputParams = [...Params];
+            const analyticsParam = outputParams.find(p => p.Name === 'AccountAnalytics');
+            if (analyticsParam)
+                analyticsParam.Value = accountAnalytics;
+            const audienceParam = outputParams.find(p => p.Name === 'AudienceData');
+            if (audienceParam)
+                audienceParam.Value = audienceData;
+            const summaryParam = outputParams.find(p => p.Name === 'Summary');
+            if (summaryParam)
+                summaryParam.Value = summary;
+            return {
+                Success: true,
+                ResultCode: 'SUCCESS',
+                Message: `Successfully retrieved analytics for TikTok account @${userInfo.display_name}`,
+                Params: outputParams
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
+            return {
+                Success: false,
+                ResultCode: this.isAuthError(error) ? 'INVALID_TOKEN' : 'ERROR',
+                Message: `Failed to get TikTok account analytics: ${errorMessage}`,
+                Params
+            };
+        }
+    }
+    /**
+     * Calculate average engagement rate for videos
+     */
+    calculateAverageEngagementRate(videos) {
+        if (videos.length === 0)
+            return 0;
+        const totalEngagements = videos.reduce((sum, v) => sum + v.like_count + v.comment_count + v.share_count, 0);
+        const totalViews = videos.reduce((sum, v) => sum + v.view_count, 0);
+        return totalViews > 0
+            ? parseFloat(((totalEngagements / totalViews) * 100).toFixed(2))
+            : 0;
+    }
+    /**
+     * Calculate account-level engagement rate
+     */
+    calculateAccountEngagementRate(user, videoStats) {
+        if (!videoStats || !user.follower_count)
+            return 0;
+        const avgEngagementsPerVideo = videoStats.totalVideos > 0
+            ? (videoStats.totalLikes + videoStats.totalComments + videoStats.totalShares) / videoStats.totalVideos
+            : 0;
+        return parseFloat(((avgEngagementsPerVideo / user.follower_count) * 100).toFixed(2));
+    }
+    /**
+     * Generate recommendations based on analytics
+     */
+    generateRecommendations(analytics) {
+        const recommendations = [];
+        // Engagement rate recommendations
+        if (analytics.metrics.engagementRate < 1) {
+            recommendations.push('Consider improving content quality to boost engagement rate above 1%');
+        }
+        else if (analytics.metrics.engagementRate > 5) {
+            recommendations.push('Excellent engagement rate! Consider posting more frequently to capitalize on audience interest');
+        }
+        // Follower recommendations
+        if (analytics.accountInfo.followers < 1000) {
+            recommendations.push('Focus on consistent posting and trending hashtags to grow your follower base');
+        }
+        // Video performance recommendations
+        if (analytics.videoStats) {
+            if (analytics.videoStats.averageViewsPerVideo < analytics.accountInfo.followers) {
+                recommendations.push('Your videos are reaching less than your follower count. Try posting at peak times');
+            }
+            if (analytics.videoStats.totalVideos < 10) {
+                recommendations.push('Post more videos to build a stronger content library');
+            }
+        }
+        // Verification recommendation
+        if (!analytics.accountInfo.isVerified && analytics.accountInfo.followers > 10000) {
+            recommendations.push('Consider applying for TikTok verification to build trust with your audience');
+        }
+        return recommendations;
+    }
+    /**
+     * Define the parameters this action expects
+     */
+    get Params() {
+        return [
+            ...this.commonSocialParams,
+            {
+                Name: 'DateRange',
+                Type: 'Input',
+                Value: '30d'
+            },
+            {
+                Name: 'IncludeVideoStats',
+                Type: 'Input',
+                Value: true
+            },
+            {
+                Name: 'IncludeAudienceData',
+                Type: 'Input',
+                Value: true
+            },
+            {
+                Name: 'AccountAnalytics',
+                Type: 'Output',
+                Value: null
+            },
+            {
+                Name: 'AudienceData',
+                Type: 'Output',
+                Value: null
+            },
+            {
+                Name: 'Summary',
+                Type: 'Output',
+                Value: null
+            }
+        ];
+    }
+    /**
+     * Metadata about this action
+     */
+    get Description() {
+        return 'Retrieves comprehensive analytics for a TikTok account including followers, engagement rates, and content performance';
+    }
+};
+exports.GetAccountAnalyticsAction = GetAccountAnalyticsAction;
+exports.GetAccountAnalyticsAction = GetAccountAnalyticsAction = __decorate([
+    (0, global_1.RegisterClass)(tiktok_base_action_1.TikTokBaseAction, 'GetAccountAnalyticsAction')
+], GetAccountAnalyticsAction);
+//# sourceMappingURL=get-account-analytics.action.js.map

package/dist/providers/tiktok/actions/get-account-analytics.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-account-analytics.action.js","sourceRoot":"","sources":["../../../../src/providers/tiktok/actions/get-account-analytics.action.ts"],"names":[],"mappings":"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"}

package/dist/providers/tiktok/actions/get-comments.action.d.ts

@@ -0,0 +1,44 @@
+import { TikTokBaseAction } from '../tiktok-base.action';
+import { ActionParam, ActionResultSimple, RunActionParams } from '@memberjunction/actions-base';
+/**
+ * Action to get comments from TikTok videos
+ */
+export declare class GetCommentsAction extends TikTokBaseAction {
+    /**
+     * Get comments from TikTok videos
+     */
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+    /**
+     * Simple sentiment analysis
+     */
+    private analyzeSentiment;
+    /**
+     * Check if comment contains a question
+     */
+    private containsQuestion;
+    /**
+     * Calculate sentiment breakdown
+     */
+    private calculateSentimentBreakdown;
+    /**
+     * Identify notable comments
+     */
+    private identifyNotableComments;
+    /**
+     * Get top commenters
+     */
+    private getTopCommenters;
+    /**
+     * Analyze time distribution of comments
+     */
+    private analyzeTimeDistribution;
+    /**
+     * Define the parameters this action expects
+     */
+    get Params(): ActionParam[];
+    /**
+     * Metadata about this action
+     */
+    get Description(): string;
+}
+//# sourceMappingURL=get-comments.action.d.ts.map

package/dist/providers/tiktok/actions/get-comments.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-comments.action.d.ts","sourceRoot":"","sources":["../../../../src/providers/tiktok/actions/get-comments.action.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAmBhG;;GAEG;AACH,qBACa,iBAAkB,SAAQ,gBAAgB;IAEnD;;OAEG;cACa,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAuHvF;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAexB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAKxB;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAcnC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAoC/B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAuBxB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAqB/B;;OAEG;IACH,IAAW,MAAM,IAAI,WAAW,EAAE,CAuCjC;IAED;;OAEG;IACH,IAAW,WAAW,IAAI,MAAM,CAE/B;CACJ"}

package/dist/providers/tiktok/actions/get-comments.action.js

@@ -0,0 +1,290 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetCommentsAction = void 0;
+const global_1 = require("@memberjunction/global");
+const tiktok_base_action_1 = require("../tiktok-base.action");
+/**
+ * Action to get comments from TikTok videos
+ */
+let GetCommentsAction = class GetCommentsAction extends tiktok_base_action_1.TikTokBaseAction {
+    /**
+     * Get comments from TikTok videos
+     */
+    async InternalRunAction(params) {
+        const { Params } = params;
+        try {
+            // Initialize OAuth
+            const companyIntegrationId = this.getParamValue(Params, 'CompanyIntegrationID');
+            if (!companyIntegrationId) {
+                throw new Error('CompanyIntegrationID is required');
+            }
+            await this.initializeOAuth(companyIntegrationId);
+            // Extract parameters
+            const videoId = this.getParamValue(Params, 'VideoID');
+            const maxComments = this.getParamValue(Params, 'MaxComments') || 100;
+            const includeReplies = this.getParamValue(Params, 'IncludeReplies') !== false;
+            const sortBy = this.getParamValue(Params, 'SortBy') || 'time'; // time or likes
+            if (!videoId) {
+                throw new Error('VideoID is required');
+            }
+            // Get comments from TikTok API
+            const response = await this.makeTikTokRequest(`/v2/video/comment/list/`, 'GET', undefined, {
+                video_id: videoId,
+                max_count: Math.min(maxComments, 100), // API limit
+                sort_by: sortBy
+            });
+            const comments = response.data?.comments || [];
+            // Process comments
+            const processedComments = comments.map(comment => ({
+                id: comment.comment_id,
+                text: comment.text,
+                author: {
+                    id: comment.user.open_id,
+                    username: comment.user.display_name,
+                    avatarUrl: comment.user.avatar_url
+                },
+                createdAt: new Date(comment.create_time * 1000),
+                likes: comment.like_count,
+                replies: comment.reply_count,
+                isReply: !!comment.parent_comment_id,
+                parentCommentId: comment.parent_comment_id,
+                sentiment: this.analyzeSentiment(comment.text),
+                containsQuestion: this.containsQuestion(comment.text),
+                length: comment.text.length
+            }));
+            // Separate top-level comments and replies
+            const topLevelComments = processedComments.filter(c => !c.isReply);
+            const replies = processedComments.filter(c => c.isReply);
+            // Calculate engagement metrics
+            const engagementMetrics = {
+                totalComments: comments.length,
+                topLevelComments: topLevelComments.length,
+                totalReplies: replies.length,
+                averageLikes: comments.length > 0
+                    ? Math.round(comments.reduce((sum, c) => sum + c.like_count, 0) / comments.length)
+                    : 0,
+                mostLikedComment: processedComments.length > 0
+                    ? processedComments.reduce((max, c) => c.likes > max.likes ? c : max)
+                    : null,
+                sentimentBreakdown: this.calculateSentimentBreakdown(processedComments),
+                questionsCount: processedComments.filter(c => c.containsQuestion).length,
+                averageCommentLength: processedComments.length > 0
+                    ? Math.round(processedComments.reduce((sum, c) => sum + c.length, 0) / processedComments.length)
+                    : 0
+            };
+            // Identify notable comments (high engagement, questions, etc.)
+            const notableComments = this.identifyNotableComments(processedComments);
+            // Create summary
+            const summary = {
+                videoId,
+                totalCommentsRetrieved: processedComments.length,
+                hasMoreComments: response.data?.has_more || false,
+                engagementMetrics,
+                notableComments,
+                topCommenters: this.getTopCommenters(processedComments),
+                timeDistribution: this.analyzeTimeDistribution(processedComments)
+            };
+            // Update output parameters
+            const outputParams = [...Params];
+            const commentsParam = outputParams.find(p => p.Name === 'Comments');
+            if (commentsParam)
+                commentsParam.Value = includeReplies ? processedComments : topLevelComments;
+            const summaryParam = outputParams.find(p => p.Name === 'Summary');
+            if (summaryParam)
+                summaryParam.Value = summary;
+            const rawDataParam = outputParams.find(p => p.Name === 'RawData');
+            if (rawDataParam)
+                rawDataParam.Value = comments;
+            return {
+                Success: true,
+                ResultCode: 'SUCCESS',
+                Message: `Retrieved ${processedComments.length} comments from TikTok video`,
+                Params: outputParams
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
+            return {
+                Success: false,
+                ResultCode: this.isAuthError(error) ? 'INVALID_TOKEN' : 'ERROR',
+                Message: `Failed to get TikTok comments: ${errorMessage}`,
+                Params
+            };
+        }
+    }
+    /**
+     * Simple sentiment analysis
+     */
+    analyzeSentiment(text) {
+        const lowerText = text.toLowerCase();
+        // Positive indicators
+        const positiveWords = ['love', 'amazing', 'great', 'awesome', 'fantastic', 'excellent', 'good', '❤️', '😍', '🔥', '👏', '💯'];
+        const negativeWords = ['hate', 'terrible', 'awful', 'bad', 'worst', 'disappointing', 'trash', '👎', '😠', '😡'];
+        const positiveScore = positiveWords.filter(word => lowerText.includes(word)).length;
+        const negativeScore = negativeWords.filter(word => lowerText.includes(word)).length;
+        if (positiveScore > negativeScore)
+            return 'positive';
+        if (negativeScore > positiveScore)
+            return 'negative';
+        return 'neutral';
+    }
+    /**
+     * Check if comment contains a question
+     */
+    containsQuestion(text) {
+        return text.includes('?') ||
+            /\b(what|when|where|who|why|how|is|are|can|could|would|should)\b/i.test(text);
+    }
+    /**
+     * Calculate sentiment breakdown
+     */
+    calculateSentimentBreakdown(comments) {
+        const breakdown = {
+            positive: 0,
+            negative: 0,
+            neutral: 0
+        };
+        comments.forEach(comment => {
+            breakdown[comment.sentiment]++;
+        });
+        return breakdown;
+    }
+    /**
+     * Identify notable comments
+     */
+    identifyNotableComments(comments) {
+        const notable = [];
+        // High engagement comments
+        const avgLikes = comments.length > 0
+            ? comments.reduce((sum, c) => sum + c.likes, 0) / comments.length
+            : 0;
+        comments.forEach(comment => {
+            const reasons = [];
+            if (comment.likes > avgLikes * 2) {
+                reasons.push('high_engagement');
+            }
+            if (comment.containsQuestion) {
+                reasons.push('contains_question');
+            }
+            if (comment.replies > 5) {
+                reasons.push('many_replies');
+            }
+            if (comment.text.length > 200) {
+                reasons.push('detailed_feedback');
+            }
+            if (reasons.length > 0) {
+                notable.push({
+                    ...comment,
+                    notableReasons: reasons
+                });
+            }
+        });
+        // Return top 10 notable comments
+        return notable.sort((a, b) => b.likes - a.likes).slice(0, 10);
+    }
+    /**
+     * Get top commenters
+     */
+    getTopCommenters(comments) {
+        const commenterMap = new Map();
+        comments.forEach(comment => {
+            const key = comment.author.id;
+            if (!commenterMap.has(key)) {
+                commenterMap.set(key, {
+                    ...comment.author,
+                    commentCount: 0,
+                    totalLikes: 0
+                });
+            }
+            const commenter = commenterMap.get(key);
+            commenter.commentCount++;
+            commenter.totalLikes += comment.likes;
+        });
+        return Array.from(commenterMap.values())
+            .sort((a, b) => b.commentCount - a.commentCount)
+            .slice(0, 5);
+    }
+    /**
+     * Analyze time distribution of comments
+     */
+    analyzeTimeDistribution(comments) {
+        if (comments.length === 0)
+            return null;
+        const now = new Date();
+        const hourBuckets = {};
+        comments.forEach(comment => {
+            const hoursSincePost = Math.floor((now.getTime() - comment.createdAt.getTime()) / (1000 * 60 * 60));
+            let bucket;
+            if (hoursSincePost < 1)
+                bucket = '< 1 hour';
+            else if (hoursSincePost < 24)
+                bucket = '1-24 hours';
+            else if (hoursSincePost < 168)
+                bucket = '1-7 days';
+            else
+                bucket = '> 7 days';
+            hourBuckets[bucket] = (hourBuckets[bucket] || 0) + 1;
+        });
+        return hourBuckets;
+    }
+    /**
+     * Define the parameters this action expects
+     */
+    get Params() {
+        return [
+            ...this.commonSocialParams,
+            {
+                Name: 'VideoID',
+                Type: 'Input',
+                Value: null
+            },
+            {
+                Name: 'MaxComments',
+                Type: 'Input',
+                Value: 100
+            },
+            {
+                Name: 'IncludeReplies',
+                Type: 'Input',
+                Value: true
+            },
+            {
+                Name: 'SortBy',
+                Type: 'Input',
+                Value: 'time'
+            },
+            {
+                Name: 'Comments',
+                Type: 'Output',
+                Value: null
+            },
+            {
+                Name: 'Summary',
+                Type: 'Output',
+                Value: null
+            },
+            {
+                Name: 'RawData',
+                Type: 'Output',
+                Value: null
+            }
+        ];
+    }
+    /**
+     * Metadata about this action
+     */
+    get Description() {
+        return 'Retrieves and analyzes comments from TikTok videos including sentiment, engagement metrics, and notable comments';
+    }
+};
+exports.GetCommentsAction = GetCommentsAction;
+exports.GetCommentsAction = GetCommentsAction = __decorate([
+    (0, global_1.RegisterClass)(tiktok_base_action_1.TikTokBaseAction, 'GetCommentsAction')
+], GetCommentsAction);
+//# sourceMappingURL=get-comments.action.js.map

package/dist/providers/tiktok/actions/get-comments.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-comments.action.js","sourceRoot":"","sources":["../../../../src/providers/tiktok/actions/get-comments.action.ts"],"names":[],"mappings":"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"}

package/dist/providers/tiktok/actions/get-trending-hashtags.action.d.ts

@@ -0,0 +1,48 @@
+import { TikTokBaseAction } from '../tiktok-base.action';
+import { ActionParam, ActionResultSimple, RunActionParams } from '@memberjunction/actions-base';
+/**
+ * Action to get trending hashtags on TikTok
+ */
+export declare class GetTrendingHashtagsAction extends TikTokBaseAction {
+    /**
+     * Get trending hashtags from TikTok
+     */
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+    /**
+     * Analyze hashtags from user's videos
+     */
+    private analyzeHashtagsFromVideos;
+    /**
+     * Calculate hashtag performance score
+     */
+    private calculateHashtagScore;
+    /**
+     * Calculate trend direction
+     */
+    private calculateTrend;
+    /**
+     * Generate hashtag recommendations based on category and country
+     */
+    private generateHashtagRecommendations;
+    /**
+     * Get general trending topics
+     */
+    private getGeneralTrendingTopics;
+    /**
+     * Generate hashtag strategy
+     */
+    private generateHashtagStrategy;
+    /**
+     * Identify best performing category
+     */
+    private identifyBestCategory;
+    /**
+     * Define the parameters this action expects
+     */
+    get Params(): ActionParam[];
+    /**
+     * Metadata about this action
+     */
+    get Description(): string;
+}
+//# sourceMappingURL=get-trending-hashtags.action.d.ts.map

package/dist/providers/tiktok/actions/get-trending-hashtags.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-trending-hashtags.action.d.ts","sourceRoot":"","sources":["../../../../src/providers/tiktok/actions/get-trending-hashtags.action.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEhG;;GAEG;AACH,qBACa,yBAA0B,SAAQ,gBAAgB;IAE3D;;OAEG;cACa,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAsFvF;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAkDjC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAY7B;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;OAEG;IACH,OAAO,CAAC,8BAA8B;IAgCtC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAUhC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAwB/B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA2B5B;;OAEG;IACH,IAAW,MAAM,IAAI,WAAW,EAAE,CAuCjC;IAED;;OAEG;IACH,IAAW,WAAW,IAAI,MAAM,CAE/B;CACJ"}