@classytic/social 0.1.0

package/dist/providers/tiktok.d.mts

@@ -0,0 +1,116 @@
+import { d as ProviderMetadata, g as UploadResult, h as UploadParams, i as CredentialField, l as ProviderConfig, o as OAuthTokens, p as TestResult, r as AuthUrlOptions, s as PlatformProvider, t as AccountInfo } from "../base-DBtKFiSX.mjs";
+import { a as TikTokCredentials, c as TikTokPrivacyLevel, d as TikTokTokenData, f as TikTokUploadPhotoParams, i as TikTokCredentialData, l as TikTokPublishStatus, m as TikTokVideo, n as ListTikTokVideosResult, o as TikTokPostInfo, p as TikTokUploadSource, r as TikTokAccountInfo, s as TikTokPrivacy, t as ListTikTokVideosOptions, u as TikTokPublishStatusResponse } from "../types-DfjDgEoJ.mjs";
+import { z } from "zod";
+
+//#region src/providers/tiktok/index.d.ts
+declare class TikTokProvider extends PlatformProvider {
+  defaultRedirectUri: string;
+  scopes: string[];
+  /**
+   * PKCE verifier store keyed by `state`. TTL'd to 10 minutes; entries are
+   * single-use. For multi-instance deployments, persist verifiers alongside
+   * `state` (session/Redis) and pass them back via `exchangeCode(code, creds, state)`.
+   */
+  private codeVerifiers;
+  constructor(cfg?: ProviderConfig);
+  /**
+   * Get TikTok OAuth authorization URL
+   * Quirk: uses `client_key` (not `client_id`), comma-separated scopes
+   *
+   * @param options.environment - Both sandbox and production request the same scopes.
+   *   Sandbox apps with "Direct Post" enabled support video.publish for test users.
+   */
+  getAuthUrl(state: string, credentials?: Record<string, any>, options?: AuthUrlOptions): string;
+  /**
+   * Exchange authorization code for tokens
+   * Quirk: form-urlencoded body with client_key/client_secret (not Basic auth)
+   */
+  exchangeCode(code: string, credentials?: Record<string, any>, state?: string): Promise<OAuthTokens>;
+  /**
+   * Refresh access token
+   */
+  refreshToken(refreshToken: string, credentials?: Record<string, any>): Promise<OAuthTokens>;
+  /**
+   * Revoke TikTok access token.
+   * Forces fresh consent screen on next authorization — ensures newly
+   * enabled scopes (e.g. video.publish after enabling Direct Post) are granted.
+   */
+  revokeToken(accessToken: string, credData?: Record<string, any>): Promise<void>;
+  /**
+   * Get TikTok user profile
+   * Quirk: requires explicit `fields` query param
+   */
+  getAccountInfo(accessToken: string): Promise<AccountInfo>;
+  /**
+   * Test credential validity
+   */
+  testCredential(credentialData: Record<string, any>): Promise<TestResult>;
+  /**
+   * Upload video to TikTok
+   *
+   * Smart mode selection:
+   * - videoUrl → tries PULL_FROM_URL first (zero server load, TikTok fetches directly)
+   *   → falls back to FILE_UPLOAD if domain not verified (url_ownership_unverified)
+   * - filePath → always FILE_UPLOAD (local file, no URL to pull from)
+   *
+   * FILE_UPLOAD uses stream-through: fetch(url) → pipe to TikTok (no server buffering).
+   */
+  uploadVideo(params: UploadParams): Promise<UploadResult>;
+  /**
+   * Attempt PULL_FROM_URL upload. Returns result on success, null if domain not verified.
+   * Throws on any other error.
+   */
+  private _tryPullFromUrl;
+  /**
+   * FILE_UPLOAD with stream-through (fetch URL → pipe to TikTok, or local file → stream).
+   */
+  private _uploadViaFile;
+  /**
+   * Create a photo post on TikTok
+   * TikTok-specific — not in the base class.
+   *
+   * Restrictions:
+   * - Only JPG/JPEG/WEBP (no PNG)
+   * - Max 35 images per post
+   * - Images must be publicly accessible URLs
+   *
+   * @param params
+   * @param params.imageUrls - Array of public image URLs
+   * @param params.title - Post title (max 150 chars)
+   * @param params.privacy - 'public' | 'private' | 'followers' | 'friends'
+   * @param params.tokens - { access_token }
+   */
+  uploadPhoto(params: TikTokUploadPhotoParams): Promise<UploadResult>;
+  /**
+   * List videos for the authenticated user (cursor-based pagination).
+   * Requires scope: `video.list`
+   *
+   * @param accessToken - OAuth access token
+   * @param options.maxCount - Number of videos per page (1-20, default 20)
+   * @param options.cursor - Pagination cursor from a previous response
+   */
+  listVideos(accessToken: string, options?: ListTikTokVideosOptions): Promise<ListTikTokVideosResult>;
+  /**
+   * Query specific videos by their IDs.
+   *
+   * @param accessToken - OAuth access token
+   * @param videoIds - Array of TikTok video IDs to fetch
+   */
+  getVideos(accessToken: string, videoIds: string[]): Promise<TikTokVideo[]>;
+  getCredentialZodSchema(): z.ZodType;
+  getCredentialSchema(): CredentialField[];
+  getMetadata(): ProviderMetadata;
+  /**
+   * Parse a raw TikTok video API item into a normalized TikTokVideo object.
+   * @private
+   */
+  private _parseVideoItem;
+  /**
+   * Poll TikTok publish status until complete or failed
+   * @private
+   */
+  _pollPublishStatus(accessToken: string, publishId: string, maxAttempts?: number, intervalMs?: number): Promise<any>;
+}
+//#endregion
+export { type ListTikTokVideosOptions, type ListTikTokVideosResult, type TikTokAccountInfo, type TikTokCredentialData, type TikTokCredentials, type TikTokPostInfo, type TikTokPrivacy, type TikTokPrivacyLevel, TikTokProvider, type TikTokPublishStatus, type TikTokPublishStatusResponse, type TikTokTokenData, type TikTokUploadPhotoParams, type TikTokUploadSource, type TikTokVideo };
+//# sourceMappingURL=tiktok.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tiktok.d.mts","names":[],"sources":["../../src/providers/tiktok/index.ts"],"mappings":";;;;;cA8Ga,cAAA,SAAuB,gBAAA;EAC3B,kBAAA;EACA,MAAA;EA0QkC;;;;;EAAA,QApQjC,aAAA;cAEI,GAAA,GAAK,cAAA;EA2nBiD;;;;;;;EAlmBlE,UAAA,CAAW,KAAA,UAAe,WAAA,GAAa,MAAA,eAA0B,OAAA,GAAU,cAAA;EAnCzB;;;;EA2D5C,YAAA,CAAa,IAAA,UAAc,WAAA,GAAa,MAAA,eAA0B,KAAA,YAAiB,OAAA,CAAQ,WAAA;;;;EA+D3F,YAAA,CAAa,YAAA,UAAsB,WAAA,GAAa,MAAA,gBAA2B,OAAA,CAAQ,WAAA;EAvF9E;;;;;EA2HL,WAAA,CAAY,WAAA,UAAqB,QAAA,GAAW,MAAA,gBAAsB,OAAA;EAnGrD;;;;EA6Hb,cAAA,CAAe,WAAA,WAAsB,OAAA,CAAQ,WAAA;EA7H8C;;;EA+J3F,cAAA,CAAe,cAAA,EAAgB,MAAA,gBAAsB,OAAA,CAAQ,UAAA;EAhG1B;;;;;;;;;;EAkJnC,WAAA,CAAY,MAAA,EAAQ,YAAA,GAAe,OAAA,CAAQ,YAAA;EApFE;;;;EAAA,QA4JrC,eAAA;EA1HqD;;;EAAA,QAmLrD,cAAA;EAjI2B;;;;;;;;;;;;;;;EAiQnC,WAAA,CAAY,MAAA,EAAQ,uBAAA,GAA0B,OAAA,CAAQ,YAAA;EAwH5C;;;;;;;;EA7CV,UAAA,CAAW,WAAA,UAAqB,OAAA,GAAU,uBAAA,GAA0B,OAAA,CAAQ,sBAAA;EA4GlF;;;;;;EA/DM,SAAA,CAAU,WAAA,UAAqB,QAAA,aAAqB,OAAA,CAAQ,WAAA;EAwClE,sBAAA,CAAA,GAA0B,CAAA,CAAE,OAAA;EAI5B,mBAAA,CAAA,GAAuB,eAAA;EAmBvB,WAAA,CAAA,GAAe,gBAAA;EAoF+G;;;;EAAA,QApBtH,eAAA;;;;;EAoBF,kBAAA,CAAmB,WAAA,UAAqB,SAAA,UAAmB,WAAA,WAA0B,UAAA,YAA4B,OAAA;AAAA"}