@olastudio/social-media-sdk 0.1.0

package/dist/providers/instagram/index.js

@@ -0,0 +1,26 @@
+'use strict';
+
+var chunk7QAMNVQU_js = require('../../chunk-7QAMNVQU.js');
+require('../../chunk-ER5A6TIL.js');
+require('../../chunk-HPLIHYLQ.js');
+
+
+
+Object.defineProperty(exports, "InstagramAPI", {
+  enumerable: true,
+  get: function () { return chunk7QAMNVQU_js.InstagramAPI; }
+});
+Object.defineProperty(exports, "InstagramAuth", {
+  enumerable: true,
+  get: function () { return chunk7QAMNVQU_js.InstagramAuth; }
+});
+Object.defineProperty(exports, "InstagramProvider", {
+  enumerable: true,
+  get: function () { return chunk7QAMNVQU_js.InstagramProvider; }
+});
+Object.defineProperty(exports, "InstagramScopes", {
+  enumerable: true,
+  get: function () { return chunk7QAMNVQU_js.InstagramScopes; }
+});
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/providers/instagram/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/providers/instagram/index.mjs

@@ -0,0 +1,5 @@
+export { InstagramAPI, InstagramAuth, InstagramProvider, InstagramScopes } from '../../chunk-QZHJXRRW.mjs';
+import '../../chunk-H5GAC4UG.mjs';
+import '../../chunk-36RADUUO.mjs';
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/providers/instagram/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.mjs"}

package/dist/providers/tiktok/index.d.mts

@@ -0,0 +1,346 @@
+/**
+ * TikTok API Constants
+ */
+/**
+ * TikTok API Version
+ * @see https://developers.tiktok.com/doc/about-tiktok-api-versions
+ */
+declare const TIKTOK_API_VERSION: "v2";
+/**
+ * TikTok API Base URL
+ */
+declare const TIKTOK_API_BASE_URL: "https://open.tiktokapis.com/v2";
+/**
+ * TikTok OAuth URLs
+ */
+declare const TIKTOK_OAUTH_AUTHORIZATION_URL: "https://www.tiktok.com/v2/auth/authorize/";
+declare const TIKTOK_OAUTH_TOKEN_URL: "https://open.tiktokapis.com/v2/oauth/token/";
+declare const TIKTOK_OAUTH_REVOKE_URL: "https://open.tiktokapis.com/v2/oauth/revoke/";
+/**
+ * TikTok OAuth Scopes
+ * @see https://developers.tiktok.com/doc/tiktok-api-scopes
+ */
+declare const TikTokScopes: {
+    readonly USER_INFO_BASIC: "user.info.basic";
+    readonly USER_INFO_PROFILE: "user.info.profile";
+    readonly USER_INFO_STATS: "user.info.stats";
+    readonly VIDEO_LIST: "video.list";
+    readonly VIDEO_PUBLISH: "video.publish";
+    readonly VIDEO_UPLOAD: "video.upload";
+};
+type TikTokScope = typeof TikTokScopes[keyof typeof TikTokScopes];
+/**
+ * Default scopes for TikTok connection
+ */
+declare const TIKTOK_DEFAULT_SCOPES: TikTokScope[];
+
+/**
+ * TikTok Types - Type definitions for TikTok API
+ */
+
+/**
+ * TikTok Provider configuration
+ */
+interface TikTokConfig {
+    clientKey: string;
+    clientSecret?: string;
+    redirectUri?: string;
+    scopes?: TikTokScope[];
+}
+/**
+ * TikTok OAuth token response
+ */
+interface TikTokTokenResponse {
+    access_token: string;
+    expires_in: number;
+    open_id: string;
+    refresh_expires_in: number;
+    refresh_token: string;
+    scope: string;
+    token_type: string;
+}
+/**
+ * TikTok user info response
+ */
+interface TikTokUserInfo {
+    open_id: string;
+    union_id?: string;
+    avatar_url?: string;
+    avatar_url_100?: string;
+    avatar_large_url?: string;
+    display_name?: string;
+    username?: string;
+    bio_description?: string;
+    profile_deep_link?: string;
+    is_verified?: boolean;
+    follower_count?: number;
+    following_count?: number;
+    likes_count?: number;
+    video_count?: number;
+}
+/**
+ * TikTok API response wrapper
+ */
+interface TikTokAPIResponse<T> {
+    data: T;
+    error: {
+        code: string;
+        message: string;
+        log_id: string;
+    } | null;
+}
+/**
+ * TikTok video info
+ */
+interface TikTokVideo {
+    id: string;
+    create_time: number;
+    cover_image_url?: string;
+    share_url?: string;
+    video_description?: string;
+    duration?: number;
+    height?: number;
+    width?: number;
+    title?: string;
+    embed_html?: string;
+    embed_link?: string;
+    like_count?: number;
+    comment_count?: number;
+    share_count?: number;
+    view_count?: number;
+}
+/**
+ * TikTok video list response
+ */
+interface TikTokVideoListResponse {
+    videos: TikTokVideo[];
+    cursor: number;
+    has_more: boolean;
+}
+/**
+ * TikTok upload init response
+ */
+interface TikTokUploadInitResponse {
+    publish_id: string;
+    upload_url: string;
+}
+/**
+ * TikTok publish status
+ */
+type TikTokPublishStatus = 'PROCESSING_UPLOAD' | 'PROCESSING_DOWNLOAD' | 'SEND_TO_USER_INBOX' | 'PUBLISH_COMPLETE' | 'FAILED';
+/**
+ * TikTok publish status response
+ */
+interface TikTokPublishStatusResponse {
+    status: TikTokPublishStatus;
+    fail_reason?: string;
+    publicaly_available_post_id?: string[];
+    uploaded_bytes?: number;
+}
+/**
+ * TikTok error response
+ */
+interface TikTokErrorResponse {
+    error: {
+        code: string;
+        message: string;
+        log_id: string;
+    };
+}
+/**
+ * TikTok account insights (aggregated from user info and videos)
+ */
+interface TikTokAccountInsights {
+    followerCount: number;
+    followingCount: number;
+    likesCount: number;
+    videoCount: number;
+    totalViews: number;
+    totalComments: number;
+    totalShares: number;
+    averageEngagementRate: number;
+}
+/**
+ * TikTok video insights
+ */
+interface TikTokVideoInsights {
+    videoId: string;
+    viewCount: number;
+    likeCount: number;
+    commentCount: number;
+    shareCount: number;
+    engagementRate: number;
+    createTime: number;
+}
+/**
+ * TikTok insights response (unified format similar to Instagram/Facebook)
+ */
+interface TikTokInsights {
+    data: Array<{
+        name: string;
+        period: string;
+        values: Array<{
+            value: number;
+            end_time?: string;
+        }>;
+        title?: string;
+        description?: string;
+    }>;
+}
+/**
+ * TikTok insights params
+ */
+interface TikTokInsightsParams {
+    metric: string[];
+    dateRange?: {
+        start: number;
+        end: number;
+    };
+}
+
+/**
+ * TikTok API - API client for TikTok endpoints
+ */
+
+/**
+ * TikTok API client
+ */
+declare class TikTokAPI {
+    private _config;
+    private accessToken?;
+    constructor(config: TikTokConfig, accessToken?: string);
+    /**
+     * Set access token
+     */
+    setAccessToken(accessToken: string): void;
+    /**
+     * Get current access token
+     */
+    getAccessToken(): string | undefined;
+    /**
+     * Make authenticated API request
+     */
+    private request;
+    /**
+     * Get user info
+     * @see https://developers.tiktok.com/doc/tiktok-api-v2-get-user-info
+     */
+    getUserInfo(fields?: string[]): Promise<TikTokUserInfo>;
+    /**
+     * Get user's videos
+     * @see https://developers.tiktok.com/doc/tiktok-api-v2-video-list
+     */
+    getVideoList(options?: {
+        cursor?: number;
+        maxCount?: number;
+        fields?: string[];
+    }): Promise<TikTokVideoListResponse>;
+    /**
+     * Initialize direct video upload
+     * @see https://developers.tiktok.com/doc/tiktok-api-v2-post-publish-video-init
+     */
+    initVideoUpload(options: {
+        sourceInfo: {
+            source: 'FILE_UPLOAD' | 'PULL_FROM_URL';
+            videoSize?: number;
+            chunkSize?: number;
+            totalChunkCount?: number;
+            videoUrl?: string;
+        };
+        postInfo?: {
+            title?: string;
+            privacyLevel?: 'PUBLIC_TO_EVERYONE' | 'MUTUAL_FOLLOW_FRIENDS' | 'SELF_ONLY';
+            disableDuet?: boolean;
+            disableStitch?: boolean;
+            disableComment?: boolean;
+            videoCoverTimestampMs?: number;
+        };
+    }): Promise<TikTokUploadInitResponse>;
+    /**
+     * Get publish status
+     * @see https://developers.tiktok.com/doc/tiktok-api-v2-post-publish-status-fetch
+     */
+    getPublishStatus(publishId: string): Promise<TikTokPublishStatusResponse>;
+    /**
+     * Get account insights (aggregated from user info and recent videos)
+     * TikTok doesn't have a dedicated insights API like Instagram/Facebook,
+     * so we compute metrics from user info and video stats
+     */
+    getAccountInsights(): Promise<TikTokAccountInsights>;
+    /**
+     * Get insights for a specific video
+     */
+    getVideoInsights(videoId: string): Promise<TikTokVideoInsights | null>;
+    /**
+     * Get insights for multiple videos
+     */
+    getVideosInsights(maxCount?: number): Promise<TikTokVideoInsights[]>;
+    /**
+     * Get formatted insights (unified format similar to Instagram/Facebook)
+     * This allows for easier aggregation across platforms
+     */
+    getInsights(params: TikTokInsightsParams): Promise<TikTokInsights>;
+}
+
+/**
+ * TikTok Auth - Authentication utilities
+ */
+
+/**
+ * TikTok Auth class for OAuth operations
+ */
+declare class TikTokAuth {
+    private config;
+    constructor(config: TikTokConfig);
+    /**
+     * Build authorization URL for OAuth flow
+     */
+    getAuthorizationUrl(options?: {
+        redirectUri?: string;
+        scopes?: TikTokScope[];
+        state?: string;
+    }): string;
+    /**
+     * Exchange authorization code for access token
+     * NOTE: This should be done server-side to protect client_secret
+     */
+    exchangeCodeForToken(code: string, redirectUri?: string): Promise<TikTokTokenResponse>;
+    /**
+     * Refresh access token using refresh token
+     * NOTE: This should be done server-side to protect client_secret
+     */
+    refreshToken(refreshToken: string): Promise<TikTokTokenResponse>;
+    /**
+     * Revoke access token
+     */
+    revokeToken(accessToken: string): Promise<void>;
+}
+
+/**
+ * TikTok Provider - Main TikTok provider
+ */
+
+/**
+ * TikTok provider that encapsulates Auth and API
+ */
+declare class TikTokProvider {
+    readonly name: "tiktok";
+    auth: TikTokAuth;
+    api: TikTokAPI;
+    config: TikTokConfig;
+    constructor(config: TikTokConfig);
+    /**
+     * Create new API instance with access token
+     */
+    createAPIClient(accessToken: string): TikTokAPI;
+    /**
+     * Update access token of existing API client
+     */
+    setAccessToken(accessToken: string): void;
+    /**
+     * Get current access token
+     */
+    getAccessToken(): string | undefined;
+}
+
+export { TIKTOK_API_BASE_URL, TIKTOK_API_VERSION, TIKTOK_DEFAULT_SCOPES, TIKTOK_OAUTH_AUTHORIZATION_URL, TIKTOK_OAUTH_REVOKE_URL, TIKTOK_OAUTH_TOKEN_URL, TikTokAPI, type TikTokAPIResponse, type TikTokAccountInsights, TikTokAuth, type TikTokConfig, type TikTokErrorResponse, type TikTokInsights, type TikTokInsightsParams, TikTokProvider, type TikTokPublishStatus, type TikTokPublishStatusResponse, type TikTokScope, TikTokScopes, type TikTokTokenResponse, type TikTokUploadInitResponse, type TikTokUserInfo, type TikTokVideo, type TikTokVideoInsights, type TikTokVideoListResponse };