@classytic/social 0.1.0

package/dist/providers/youtube.d.mts

@@ -0,0 +1,153 @@
+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 { C as YouTubeSearchOrder, D as YouTubeVideoRating, E as YouTubeVideo, O as YouTubeVideoType, S as YouTubeSafeSearch, T as YouTubeUploadOptions, _ as YouTubeCategory, a as ListPlaylistItemsOptions, b as YouTubeLicense, c as ListPlaylistsResult, d as PlaylistItem, f as SearchVideosOptions, g as YouTubeAccountInfo, h as UpdateVideoParams, i as InitUploadSessionResult, l as ListVideosOptions, m as UpdatePlaylistParams, n as CreatePlaylistParams, o as ListPlaylistItemsResult, p as SearchVideosResult, r as InitUploadSessionParams, s as ListPlaylistsOptions, t as AddToPlaylistOptions, u as ListVideosResult, v as YouTubeCredentialData, w as YouTubeUploadMetadata, x as YouTubePlaylist, y as YouTubeCredentials } from "../types-D91N16Ym.mjs";
+import { z } from "zod";
+import { OAuth2Client } from "google-auth-library";
+
+//#region src/providers/youtube/index.d.ts
+declare class YouTubeProvider extends PlatformProvider {
+  defaultRedirectUri: string;
+  scopes: string[];
+  constructor(config?: ProviderConfig);
+  /**
+   * Create OAuth2 client with dynamic credentials
+   * @private
+   */
+  _createOAuthClient(clientId: string, clientSecret: string, redirectUri?: string): OAuth2Client;
+  /**
+   * Get OAuth authorization URL
+   * @param state - State parameter for CSRF protection
+   * @param credentials - OAuth credentials {clientId, clientSecret}
+   */
+  getAuthUrl(state: string, credentials?: YouTubeCredentials, _options?: AuthUrlOptions): string;
+  /**
+   * Exchange authorization code for tokens
+   * @param code - Authorization code
+   * @param credentials - OAuth credentials {clientId, clientSecret}
+   */
+  exchangeCode(code: string, credentials?: YouTubeCredentials): Promise<OAuthTokens>;
+  /**
+   * Refresh access token
+   * @param refreshToken - Refresh token
+   * @param credentials - OAuth credentials {clientId, clientSecret}
+   */
+  refreshToken(refreshToken: string, credentials?: YouTubeCredentials): Promise<OAuthTokens>;
+  /**
+   * Get account information
+   * @param accessToken - Access token
+   * @param credentials - OAuth credentials {clientId, clientSecret}
+   */
+  getAccountInfo(accessToken: string, credentials?: YouTubeCredentials): Promise<AccountInfo>;
+  /**
+   * Test credential validity
+   */
+  testCredential(credentialData: YouTubeCredentialData): Promise<TestResult>;
+  /**
+   * Build video metadata for YouTube uploads.
+   * Shared between initUploadSession() and uploadVideo().
+   *
+   * Supports all YouTube Data API v3 fields:
+   * - snippet: title, description, tags, categoryId, defaultLanguage
+   * - status: privacyStatus, publishAt, license, embeddable, publicStatsViewable, selfDeclaredMadeForKids
+   * - recordingDetails: recordingDate
+   */
+  private _buildVideoMetadata;
+  /**
+   * Initialize a resumable upload session (metadata only, no file).
+   * Returns a self-authenticating upload URI that the frontend can PUT to directly.
+   *
+   * Flow: Server calls this → returns uploadUri → Frontend PUTs file to uploadUri
+   * The upload URI is valid for ~24 hours and requires no additional auth.
+   */
+  initUploadSession(params: InitUploadSessionParams): Promise<InitUploadSessionResult>;
+  /**
+   * Upload video to YouTube (server-side).
+   *
+   * Supports two modes:
+   * - filePath: Read from local file (original behavior)
+   * - videoUrl: Stream-through from URL (no disk IO, for GCS-stored media)
+   */
+  uploadVideo(params: UploadParams): Promise<UploadResult>;
+  /**
+   * Parse a YouTube API video item into a normalized YouTubeVideo.
+   */
+  private _parseVideoItem;
+  /**
+   * Get a single video by ID.
+   *
+   * @param accessToken - OAuth access token
+   * @param videoId - YouTube video ID
+   * @param credentials - OAuth credentials { clientId, clientSecret }
+   * @returns Normalized video data with snippet, stats, and content details
+   */
+  getVideo(accessToken: string, videoId: string, credentials?: YouTubeCredentials): Promise<YouTubeVideo>;
+  /**
+   * List videos from the authenticated channel.
+   *
+   * Uses playlistItems.list on the channel's uploads playlist (1 quota unit per call)
+   * instead of search.list (100 quota units per call — avoid).
+   *
+   * For text search within videos use videos.list with a separate search flow.
+   */
+  listVideos(accessToken: string, credentials?: YouTubeCredentials, options?: ListVideosOptions): Promise<ListVideosResult>;
+  /**
+   * Update video metadata (title, description, tags, category, privacy).
+   *
+   * Only the fields provided in `params` are updated. Omitted fields are left unchanged.
+   * Note: You must have ownership of the video.
+   *
+   * @param accessToken - OAuth access token
+   * @param videoId - YouTube video ID to update
+   * @param params - Fields to update
+   * @param credentials - OAuth credentials { clientId, clientSecret }
+   */
+  updateVideo(accessToken: string, videoId: string, params: UpdateVideoParams, credentials?: YouTubeCredentials): Promise<YouTubeVideo>;
+  /**
+   * Delete a video by ID.
+   *
+   * @param accessToken - OAuth access token
+   * @param videoId - YouTube video ID to delete
+   * @param credentials - OAuth credentials { clientId, clientSecret }
+   */
+  deleteVideo(accessToken: string, videoId: string, credentials?: YouTubeCredentials): Promise<void>;
+  private _parsePlaylist;
+  private _parsePlaylistItem;
+  createPlaylist(accessToken: string, params: CreatePlaylistParams, credentials?: YouTubeCredentials): Promise<YouTubePlaylist>;
+  getPlaylist(accessToken: string, playlistId: string, credentials?: YouTubeCredentials): Promise<YouTubePlaylist>;
+  listPlaylists(accessToken: string, credentials?: YouTubeCredentials, options?: ListPlaylistsOptions): Promise<ListPlaylistsResult>;
+  updatePlaylist(accessToken: string, playlistId: string, params: UpdatePlaylistParams, credentials?: YouTubeCredentials): Promise<YouTubePlaylist>;
+  deletePlaylist(accessToken: string, playlistId: string, credentials?: YouTubeCredentials): Promise<void>;
+  addToPlaylist(accessToken: string, playlistId: string, videoId: string, credentials?: YouTubeCredentials, options?: AddToPlaylistOptions): Promise<PlaylistItem>;
+  removeFromPlaylist(accessToken: string, playlistItemId: string, credentials?: YouTubeCredentials): Promise<void>;
+  listPlaylistItems(accessToken: string, playlistId: string, credentials?: YouTubeCredentials, options?: ListPlaylistItemsOptions): Promise<ListPlaylistItemsResult>;
+  /**
+   * Search YouTube videos with comprehensive filters.
+   * Uses a 2-step approach: search.list → videos.list for full details.
+   */
+  searchVideos(accessToken: string, credentials?: YouTubeCredentials, options?: SearchVideosOptions): Promise<SearchVideosResult>;
+  /**
+   * Get available video categories for a region.
+   * @param regionCode - ISO 3166-1 alpha-2 country code (e.g. 'US', 'BD')
+   */
+  getVideoCategories(accessToken: string, regionCode: string, credentials?: YouTubeCredentials): Promise<YouTubeCategory[]>;
+  /**
+   * Rate a video (like, dislike, or remove rating).
+   */
+  rateVideo(accessToken: string, videoId: string, rating: YouTubeVideoRating, credentials?: YouTubeCredentials): Promise<void>;
+  /**
+   * Return the zod schema for runtime validation. Consumers can call
+   * `z.toJSONSchema(provider.getCredentialZodSchema())` to render UI forms
+   * or generate OpenAPI specs.
+   */
+  getCredentialZodSchema(): z.ZodType;
+  /**
+   * Get credential schema for UI (legacy CredentialField[] shape).
+   */
+  getCredentialSchema(): CredentialField[];
+  /**
+   * Get provider metadata for frontend display
+   */
+  getMetadata(): ProviderMetadata;
+}
+//#endregion
+export { type AddToPlaylistOptions, type CreatePlaylistParams, type InitUploadSessionParams, type InitUploadSessionResult, type ListPlaylistItemsOptions, type ListPlaylistItemsResult, type ListPlaylistsOptions, type ListPlaylistsResult, type ListVideosOptions, type ListVideosResult, type PlaylistItem, type SearchVideosOptions, type SearchVideosResult, type UpdatePlaylistParams, type UpdateVideoParams, type YouTubeAccountInfo, type YouTubeCategory, type YouTubeCredentialData, type YouTubeCredentials, type YouTubeLicense, type YouTubePlaylist, YouTubeProvider, type YouTubeSafeSearch, type YouTubeSearchOrder, type YouTubeUploadMetadata, type YouTubeUploadOptions, type YouTubeVideo, type YouTubeVideoRating, type YouTubeVideoType };
+//# sourceMappingURL=youtube.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"youtube.d.mts","names":[],"sources":["../../src/providers/youtube/index.ts"],"mappings":"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"}