@classytic/social 0.1.0

package/dist/providers/facebook.mjs

@@ -0,0 +1,450 @@
+import { t as PlatformProvider } from "../base-Bw7e52V8.mjs";
+import { t as SocialError } from "../errors-Cm6LeKf7.mjs";
+import { a as parseGraphError, c as META_GRAPH_VERSION, l as META_GRAPH_VIDEO_BASE, n as metaExchangeLongLived, o as META_AUTH_URL, r as metaRefreshLongLivedFacebook, s as META_GRAPH_BASE } from "../meta-D3vcJU1c.mjs";
+import { t as httpRequest } from "../http-DpcLSR1M.mjs";
+import { t as FacebookCredentialsSchema } from "../facebook-l_4CghaA.mjs";
+
+//#region src/providers/facebook/index.ts
+/**
+* Facebook Pages Platform Provider
+* =================================
+* Facebook Page integration via Meta Graph API v25.0.
+*
+* Features:
+* - OAuth2 via Facebook Login dialog
+* - Two-step token exchange (short-lived -> long-lived, 60 days)
+* - Facebook Page discovery and page-level access tokens
+* - Text post publishing
+* - Link/article sharing
+* - Photo post publishing (via URL)
+* - Video post publishing (via URL, uses graph-video.facebook.com)
+* - Scheduled post publishing
+* - Post management (get, update, delete)
+* - Page insights/analytics
+* - Credential validation
+*
+* Facebook Page API Quirks:
+* - User tokens vs Page tokens: user token grants access to /me/accounts;
+*   each page in the response includes its own page-specific access_token
+* - Page tokens never expire if derived from a long-lived user token
+* - Video uploads use graph-video.facebook.com (not graph.facebook.com)
+* - Scheduled posts: set published=false + scheduled_publish_time (Unix epoch, 10 min-6 months)
+* - Photos accept URLs or binary upload (we use URL-based for simplicity, matching Instagram pattern)
+* - Webhook signature validation uses SHA256 HMAC of app secret
+*
+* @see https://developers.facebook.com/docs/pages-api
+* @see https://developers.facebook.com/docs/graph-api/reference/page/feed
+* @see https://developers.facebook.com/docs/video-api/guides/publishing
+*/
+const GRAPH_API_VERSION = META_GRAPH_VERSION;
+const FB_AUTH_URL = META_AUTH_URL;
+const GRAPH_API_BASE = META_GRAPH_BASE;
+const GRAPH_VIDEO_BASE = META_GRAPH_VIDEO_BASE;
+var FacebookProvider = class extends PlatformProvider {
+	defaultRedirectUri;
+	scopes;
+	constructor(cfg = {}) {
+		super(cfg);
+		this.name = "facebook";
+		this.displayName = "Facebook Pages";
+		this.authType = "oauth2";
+		this.defaultRedirectUri = cfg.redirectUri || `http://localhost:${cfg.port || 8060}/api/oauth/facebook/callback`;
+		this.scopes = [
+			"business_management",
+			"pages_show_list",
+			"pages_read_engagement",
+			"pages_manage_posts",
+			"pages_read_user_content"
+		];
+	}
+	/**
+	* Unified Graph API request — used by all GET / POST / DELETE call sites.
+	* Delegates to the shared `httpRequest` helper for retry, timeout, and 429 handling.
+	*
+	* @param method  HTTP method
+	* @param path    Graph API path (e.g. `/me/accounts`)
+	* @param accessToken  Access token (sent as `access_token` query for GET/DELETE; body field for POST)
+	* @param body    POST body (merged with `access_token`); ignored for GET/DELETE
+	* @param query   Extra query params for GET
+	* @param baseUrl Optional base URL override (video uploads use graph-video.facebook.com)
+	*/
+	async _graph(method, path, accessToken, body, query, baseUrl = GRAPH_API_BASE) {
+		const isWriteWithBody = method === "POST" && body !== void 0;
+		return (await httpRequest("facebook", {
+			method,
+			url: `${baseUrl}${path}`,
+			query: !isWriteWithBody ? {
+				access_token: accessToken,
+				...query ?? {}
+			} : query,
+			json: isWriteWithBody ? {
+				...body,
+				access_token: accessToken
+			} : void 0,
+			timeout: 6e4,
+			retry: { attempts: 2 },
+			parseError: parseGraphError
+		})).data;
+	}
+	async _graphGet(path, accessToken, params = {}) {
+		return this._graph("GET", path, accessToken, void 0, params);
+	}
+	async _graphPost(path, body, accessToken, baseUrl = GRAPH_API_BASE) {
+		return this._graph("POST", path, accessToken, body, void 0, baseUrl);
+	}
+	async _graphDelete(path, accessToken) {
+		return this._graph("DELETE", path, accessToken);
+	}
+	/**
+	* Get Facebook OAuth authorization URL
+	*/
+	getAuthUrl(state, credentials = {}, _options) {
+		return `${FB_AUTH_URL}?${new URLSearchParams({
+			client_id: credentials.appId,
+			redirect_uri: credentials.redirectUri || this.defaultRedirectUri,
+			scope: this.scopes.join(","),
+			response_type: "code",
+			state
+		}).toString()}`;
+	}
+	/**
+	* Exchange authorization code for tokens (two-step).
+	*
+	* Step 1: code → short-lived token (1 hour)
+	* Step 2: short-lived → long-lived token (60 days)
+	*/
+	async exchangeCode(code, credentials = {}) {
+		return metaExchangeLongLived("facebook", {
+			graphVersion: GRAPH_API_VERSION,
+			clientId: credentials.appId,
+			clientSecret: credentials.appSecret,
+			redirectUri: credentials.redirectUri || this.defaultRedirectUri,
+			code
+		});
+	}
+	/**
+	* Refresh long-lived user token. Facebook long-lived tokens can be refreshed
+	* before expiry by re-exchanging them via `fb_exchange_token`.
+	*/
+	async refreshToken(refreshToken, credentials = {}) {
+		return metaRefreshLongLivedFacebook({
+			graphVersion: GRAPH_API_VERSION,
+			clientId: credentials.appId,
+			clientSecret: credentials.appSecret,
+			refreshToken
+		});
+	}
+	/**
+	* Get user's Facebook Pages with page-level access tokens
+	* Each page has its own never-expiring token (when derived from long-lived user token)
+	*
+	* @param userAccessToken - Long-lived user access token
+	* @returns List of pages with { id, name, access_token, category, ... }
+	*/
+	async getPages(userAccessToken) {
+		return (await this._graphGet("/me/accounts", userAccessToken, { fields: "id,name,access_token,category,picture{url},fan_count,followers_count" })).data || [];
+	}
+	/**
+	* Get account information -- returns the first managed page
+	*/
+	async getAccountInfo(accessToken) {
+		const pages = await this.getPages(accessToken);
+		if (!pages.length) throw new SocialError("facebook", "No Facebook Pages found. Your account must manage at least one Facebook Page.");
+		const page = pages[0];
+		return {
+			id: page.id,
+			name: page.name,
+			profileImage: page.picture?.data?.url || null,
+			category: page.category,
+			fanCount: page.fan_count,
+			pageAccessToken: page.access_token,
+			pageId: page.id,
+			pages: pages.map((p) => ({
+				id: p.id,
+				name: p.name,
+				category: p.category,
+				profileImage: p.picture?.data?.url || null
+			}))
+		};
+	}
+	/**
+	* Test credential validity
+	*/
+	async testCredential(credentialData) {
+		try {
+			if (credentialData.oauthTokenData) {
+				const tokenData = typeof credentialData.oauthTokenData === "string" ? JSON.parse(credentialData.oauthTokenData) : credentialData.oauthTokenData;
+				const accountInfo = await this.getAccountInfo(tokenData.access_token);
+				return {
+					status: "OK",
+					message: `Connected — managing ${accountInfo.pages.length} page(s)`,
+					data: {
+						channelId: accountInfo.id,
+						channelTitle: accountInfo.name,
+						profileImage: accountInfo.profileImage,
+						pages: accountInfo.pages
+					}
+				};
+			}
+			if (!credentialData.appId || !credentialData.appSecret) return {
+				status: "Error",
+				message: "Meta App ID and App Secret are required"
+			};
+			return {
+				status: "Pending",
+				message: "Credential needs OAuth authorization. Click \"Connect Account\" to link your Facebook."
+			};
+		} catch (error) {
+			return {
+				status: "Error",
+				message: error.message || "Failed to validate Facebook credential"
+			};
+		}
+	}
+	/**
+	* Get the page-level access token for a specific page
+	* Page tokens derived from long-lived user tokens never expire.
+	*
+	* @param userAccessToken - Long-lived user access token
+	* @param pageId - Facebook Page ID
+	* @returns Page access token
+	*/
+	async getPageAccessToken(userAccessToken, pageId) {
+		const page = (await this.getPages(userAccessToken)).find((p) => p.id === pageId);
+		if (!page) throw new SocialError("facebook", `Page ${pageId} not found or you don't have admin access. Check your page permissions.`);
+		return page.access_token;
+	}
+	/**
+	* Publish a text post to a Facebook Page
+	* @param pageAccessToken - Page-level access token
+	* @param pageId - Facebook Page ID
+	* @param message - Post text
+	* @param options
+	*/
+	async createPost(pageAccessToken, pageId, message, options = {}) {
+		const body = { message };
+		if (options.scheduledAt) {
+			const publishTime = Math.floor(new Date(options.scheduledAt).getTime() / 1e3);
+			body.published = false;
+			body.scheduled_publish_time = publishTime;
+		}
+		return {
+			postId: (await this._graphPost(`/${pageId}/feed`, body, pageAccessToken)).id,
+			status: options.scheduledAt ? "scheduled" : "published",
+			scheduledAt: options.scheduledAt ? new Date(options.scheduledAt) : null
+		};
+	}
+	/**
+	* Publish a link/article share to a Facebook Page
+	* @param pageAccessToken
+	* @param pageId
+	* @param link - URL to share
+	* @param options
+	*/
+	async createLinkPost(pageAccessToken, pageId, link, options = {}) {
+		const body = { link };
+		if (options.message) body.message = options.message;
+		if (options.scheduledAt) {
+			const publishTime = Math.floor(new Date(options.scheduledAt).getTime() / 1e3);
+			body.published = false;
+			body.scheduled_publish_time = publishTime;
+		}
+		return {
+			postId: (await this._graphPost(`/${pageId}/feed`, body, pageAccessToken)).id,
+			status: options.scheduledAt ? "scheduled" : "published"
+		};
+	}
+	/**
+	* Publish a photo to a Facebook Page (via public URL)
+	* @param pageAccessToken
+	* @param pageId
+	* @param photoUrl - Publicly accessible photo URL
+	* @param options
+	*/
+	async createPhotoPost(pageAccessToken, pageId, photoUrl, options = {}) {
+		const body = { url: photoUrl };
+		if (options.caption) body.message = options.caption;
+		if (options.scheduledAt) {
+			const publishTime = Math.floor(new Date(options.scheduledAt).getTime() / 1e3);
+			body.published = false;
+			body.scheduled_publish_time = publishTime;
+		}
+		const data = await this._graphPost(`/${pageId}/photos`, body, pageAccessToken);
+		return {
+			postId: data.post_id || data.id,
+			photoId: data.id,
+			status: options.scheduledAt ? "scheduled" : "published"
+		};
+	}
+	/**
+	* Upload a video to a Facebook Page (via public URL)
+	* Uses graph-video.facebook.com for video uploads.
+	*/
+	async uploadVideo(params) {
+		const { videoUrl, title = "", description = "", tokens, scheduledAt, onProgress } = params;
+		const pageAccessToken = tokens.pageAccessToken || tokens.access_token;
+		const pageId = tokens.pageId;
+		if (!pageId) throw new SocialError("facebook", "Page ID is required. Select a page from your connected pages.");
+		if (!videoUrl) throw new SocialError("facebook", "Video URL is required. Facebook accepts public URLs for video uploads.");
+		const body = {
+			file_url: videoUrl,
+			title: title.substring(0, 255),
+			description: description.substring(0, 5e3)
+		};
+		if (scheduledAt) {
+			const publishTime = Math.floor(new Date(scheduledAt).getTime() / 1e3);
+			body.published = false;
+			body.scheduled_publish_time = publishTime;
+		}
+		if (onProgress) onProgress(10);
+		const data = await this._graphPost(`/${pageId}/videos`, body, pageAccessToken, GRAPH_VIDEO_BASE);
+		if (onProgress) onProgress(100);
+		return {
+			platformVideoId: data.id,
+			platformUrl: `https://www.facebook.com/${pageId}/videos/${data.id}/`,
+			status: scheduledAt ? "scheduled" : "published",
+			uploadedAt: /* @__PURE__ */ new Date(),
+			scheduledAt: scheduledAt ? new Date(scheduledAt) : null,
+			metadata: {
+				pageId,
+				videoId: data.id,
+				title
+			}
+		};
+	}
+	/**
+	* Get a post by ID
+	* @param pageAccessToken
+	* @param postId
+	* @param fields - Comma-separated fields
+	*/
+	async getPost(pageAccessToken, postId, fields = "id,message,created_time,permalink_url,shares,likes.summary(true),comments.summary(true)") {
+		return this._graphGet(`/${postId}`, pageAccessToken, { fields });
+	}
+	/**
+	* Update a post's message
+	* @param pageAccessToken
+	* @param postId
+	* @param message - New message text
+	*/
+	async updatePost(pageAccessToken, postId, message) {
+		return this._graphPost(`/${postId}`, { message }, pageAccessToken);
+	}
+	/**
+	* Delete a post
+	* @param pageAccessToken
+	* @param postId
+	*/
+	async deletePost(pageAccessToken, postId) {
+		return this._graphDelete(`/${postId}`, pageAccessToken);
+	}
+	/**
+	* Get page feed (recent posts)
+	* @param pageAccessToken
+	* @param pageId
+	* @param limit
+	*/
+	async getPageFeed(pageAccessToken, pageId, limit = 25) {
+		return this._graphGet(`/${pageId}/feed`, pageAccessToken, {
+			fields: "id,message,created_time,permalink_url,type,shares",
+			limit: String(limit)
+		});
+	}
+	/**
+	* Get page insights (basic analytics)
+	* @param pageAccessToken
+	* @param pageId
+	* @param period - 'day' | 'week' | 'days_28'
+	*/
+	async getPageInsights(pageAccessToken, pageId, period = "day") {
+		return this._graphGet(`/${pageId}/insights`, pageAccessToken, {
+			metric: "page_impressions,page_engaged_users,page_post_engagements,page_fan_adds",
+			period
+		});
+	}
+	getCredentialZodSchema() {
+		return FacebookCredentialsSchema;
+	}
+	getCredentialSchema() {
+		return [{
+			name: "appId",
+			displayName: "Meta App ID",
+			type: "text",
+			required: true,
+			description: "App ID from Meta Developer Portal (developers.facebook.com)"
+		}, {
+			name: "appSecret",
+			displayName: "Meta App Secret",
+			type: "password",
+			required: true,
+			description: "App Secret from Meta Developer Portal"
+		}];
+	}
+	getMetadata() {
+		return {
+			name: this.name,
+			displayName: this.displayName,
+			authType: this.authType,
+			icon: "facebook",
+			brandColor: "#1877F2",
+			description: "Publish posts, photos, and videos to Facebook Pages",
+			scopes: this.scopes,
+			scopeDescriptions: {
+				pages_show_list: "View the list of Facebook Pages you manage",
+				pages_read_engagement: "Read engagement metrics from your pages",
+				pages_manage_posts: "Create, edit, and delete posts on your pages",
+				pages_read_user_content: "Read user-generated content on your pages"
+			},
+			supportsScheduling: true,
+			supportsEnvironment: false,
+			setupGuide: [
+				{
+					step: 1,
+					title: "Create Meta Developer Account",
+					description: "Go to developers.facebook.com and create an account or log in"
+				},
+				{
+					step: 2,
+					title: "Create a New App",
+					description: "Click \"My Apps\" → \"Create App\". Enter your app name and email. On the use case step, filter by \"Content management\" and select \"Manage everything on your Page\""
+				},
+				{
+					step: 3,
+					title: "Connect Business Portfolio",
+					description: "Select or create a Business Portfolio when prompted. Click \"Create App\" to proceed to the dashboard"
+				},
+				{
+					step: 4,
+					title: "Set Redirect URI",
+					description: `Go to "Facebook Login" → "Settings" in the left sidebar. Add this as a Valid OAuth Redirect URI: ${this.defaultRedirectUri}`
+				},
+				{
+					step: 5,
+					title: "Configure App Settings",
+					description: "Go to Settings → Basic. Add your App Domain and a Privacy Policy URL. Copy your App ID and App Secret and paste them above"
+				},
+				{
+					step: 6,
+					title: "Add Permissions",
+					description: "Click \"Customize\" on your use case → \"Permissions and features\". pages_show_list, business_management, and public_profile are pre-added. Click \"+ Add\" for: pages_manage_posts, pages_read_engagement, pages_read_user_content, pages_manage_engagement, read_insights"
+				},
+				{
+					step: 7,
+					title: "Go Live",
+					description: "Switch app to \"Live\" mode. For development, Standard Access works with app role users. For production, request Advanced Access via App Review"
+				},
+				{
+					step: 8,
+					title: "Page Admin Required",
+					description: "You must be an admin of the Facebook Page(s) you want to post to. The page will be auto-discovered during authorization"
+				}
+			],
+			redirectUriPattern: this.defaultRedirectUri,
+			credentialSchema: this.getCredentialSchema()
+		};
+	}
+};
+
+//#endregion
+export { FacebookProvider };
+//# sourceMappingURL=facebook.mjs.map

package/dist/providers/facebook.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"facebook.mjs","names":[],"sources":["../../src/providers/facebook/index.ts"],"sourcesContent":["/**\n * Facebook Pages Platform Provider\n * =================================\n * Facebook Page integration via Meta Graph API v25.0.\n *\n * Features:\n * - OAuth2 via Facebook Login dialog\n * - Two-step token exchange (short-lived -> long-lived, 60 days)\n * - Facebook Page discovery and page-level access tokens\n * - Text post publishing\n * - Link/article sharing\n * - Photo post publishing (via URL)\n * - Video post publishing (via URL, uses graph-video.facebook.com)\n * - Scheduled post publishing\n * - Post management (get, update, delete)\n * - Page insights/analytics\n * - Credential validation\n *\n * Facebook Page API Quirks:\n * - User tokens vs Page tokens: user token grants access to /me/accounts;\n *   each page in the response includes its own page-specific access_token\n * - Page tokens never expire if derived from a long-lived user token\n * - Video uploads use graph-video.facebook.com (not graph.facebook.com)\n * - Scheduled posts: set published=false + scheduled_publish_time (Unix epoch, 10 min-6 months)\n * - Photos accept URLs or binary upload (we use URL-based for simplicity, matching Instagram pattern)\n * - Webhook signature validation uses SHA256 HMAC of app secret\n *\n * @see https://developers.facebook.com/docs/pages-api\n * @see https://developers.facebook.com/docs/graph-api/reference/page/feed\n * @see https://developers.facebook.com/docs/video-api/guides/publishing\n */\n\nimport {\n  PlatformProvider,\n  type AuthUrlOptions,\n  type CredentialField,\n  type ProviderMetadata,\n  type UploadResult,\n  type OAuthTokens,\n  type ProviderConfig,\n} from '../../base.js';\nimport { SocialError } from '../../errors.js';\nimport { FacebookCredentialsSchema } from '../../schemas/facebook.js';\nimport { httpRequest } from '../../common/http.js';\nimport { META_GRAPH_VERSION, META_GRAPH_BASE, META_GRAPH_VIDEO_BASE, META_AUTH_URL, META_TOKEN_URL } from '../../common/meta.js';\nimport {\n  metaExchangeLongLived,\n  metaRefreshLongLivedFacebook,\n  parseGraphError,\n} from '../../common/oauth/index.js';\nimport type { z } from 'zod';\nimport type {\n  FacebookCredentials,\n  FacebookPage,\n  FacebookAccountInfo,\n  FacebookTestResult,\n  FacebookUploadParams,\n  CreatePostOptions,\n  CreatePostResult,\n  CreateLinkPostOptions,\n  CreateLinkPostResult,\n  CreatePhotoPostOptions,\n  CreatePhotoPostResult,\n  GraphApiErrorResponse,\n  FacebookCredentialData,\n  FacebookPost,\n  FacebookInsightsPeriod,\n} from './types.js';\n\nexport type {\n  FacebookCredentials,\n  FacebookCredentialData,\n  FacebookPage,\n  FacebookAccountInfo,\n  FacebookTestResult,\n  FacebookUploadParams,\n  CreatePostOptions,\n  CreatePostResult,\n  CreateLinkPostOptions,\n  CreateLinkPostResult,\n  CreatePhotoPostOptions,\n  CreatePhotoPostResult,\n  FacebookPost,\n  FacebookInsightsPeriod,\n  GraphApiErrorResponse,\n} from './types.js';\n\n// --- Graph API Endpoints (version in src/common/meta.ts) ---\n\nconst GRAPH_API_VERSION = META_GRAPH_VERSION;\nconst FB_AUTH_URL = META_AUTH_URL;\nconst FB_TOKEN_URL = META_TOKEN_URL;\nconst GRAPH_API_BASE = META_GRAPH_BASE;\nconst GRAPH_VIDEO_BASE = META_GRAPH_VIDEO_BASE;\n\n// --- Provider ---\n\nexport class FacebookProvider extends PlatformProvider {\n  public defaultRedirectUri: string;\n  public scopes: string[];\n\n  constructor(cfg: ProviderConfig = {}) {\n    super(cfg);\n    this.name = 'facebook';\n    this.displayName = 'Facebook Pages';\n    this.authType = 'oauth2';\n\n    this.defaultRedirectUri =\n      cfg.redirectUri ||\n      `http://localhost:${cfg.port || 8060}/api/oauth/facebook/callback`;\n\n    this.scopes = [\n      'business_management',\n      'pages_show_list',\n      'pages_read_engagement',\n      'pages_manage_posts',\n      'pages_read_user_content',\n    ];\n  }\n\n  // --- API Helper ---\n\n  /**\n   * Unified Graph API request — used by all GET / POST / DELETE call sites.\n   * Delegates to the shared `httpRequest` helper for retry, timeout, and 429 handling.\n   *\n   * @param method  HTTP method\n   * @param path    Graph API path (e.g. `/me/accounts`)\n   * @param accessToken  Access token (sent as `access_token` query for GET/DELETE; body field for POST)\n   * @param body    POST body (merged with `access_token`); ignored for GET/DELETE\n   * @param query   Extra query params for GET\n   * @param baseUrl Optional base URL override (video uploads use graph-video.facebook.com)\n   */\n  private async _graph<T = any>(\n    method: 'GET' | 'POST' | 'DELETE',\n    path: string,\n    accessToken: string,\n    body?: Record<string, any>,\n    query?: Record<string, string>,\n    baseUrl: string = GRAPH_API_BASE,\n  ): Promise<T> {\n    const isWriteWithBody = method === 'POST' && body !== undefined;\n    const result = await httpRequest<T>('facebook', {\n      method,\n      url: `${baseUrl}${path}`,\n      query: !isWriteWithBody ? { access_token: accessToken, ...(query ?? {}) } : query,\n      json: isWriteWithBody ? { ...body, access_token: accessToken } : undefined,\n      timeout: 60_000,\n      retry: { attempts: 2 },\n      parseError: parseGraphError,\n    });\n    return result.data;\n  }\n\n  // Backward-compatible shims so existing call sites work unchanged.\n  private async _graphGet(path: string, accessToken: string, params: Record<string, string> = {}): Promise<any> {\n    return this._graph('GET', path, accessToken, undefined, params);\n  }\n  private async _graphPost(path: string, body: Record<string, any>, accessToken: string, baseUrl: string = GRAPH_API_BASE): Promise<any> {\n    return this._graph('POST', path, accessToken, body, undefined, baseUrl);\n  }\n  private async _graphDelete(path: string, accessToken: string): Promise<any> {\n    return this._graph('DELETE', path, accessToken);\n  }\n\n  // --- OAuth ---\n\n  /**\n   * Get Facebook OAuth authorization URL\n   */\n  getAuthUrl(state: string, credentials: Partial<FacebookCredentials> = {}, _options?: AuthUrlOptions): string {\n    const params = new URLSearchParams({\n      client_id: credentials.appId!,\n      redirect_uri: credentials.redirectUri || this.defaultRedirectUri,\n      scope: this.scopes.join(','),\n      response_type: 'code',\n      state,\n    });\n\n    return `${FB_AUTH_URL}?${params.toString()}`;\n  }\n\n  /**\n   * Exchange authorization code for tokens (two-step).\n   *\n   * Step 1: code → short-lived token (1 hour)\n   * Step 2: short-lived → long-lived token (60 days)\n   */\n  async exchangeCode(code: string, credentials: Partial<FacebookCredentials> = {}): Promise<OAuthTokens> {\n    return metaExchangeLongLived('facebook', {\n      graphVersion: GRAPH_API_VERSION,\n      clientId: credentials.appId!,\n      clientSecret: credentials.appSecret!,\n      redirectUri: credentials.redirectUri || this.defaultRedirectUri,\n      code,\n    });\n  }\n\n  /**\n   * Refresh long-lived user token. Facebook long-lived tokens can be refreshed\n   * before expiry by re-exchanging them via `fb_exchange_token`.\n   */\n  async refreshToken(refreshToken: string, credentials: Partial<FacebookCredentials> = {}): Promise<OAuthTokens> {\n    return metaRefreshLongLivedFacebook({\n      graphVersion: GRAPH_API_VERSION,\n      clientId: credentials.appId!,\n      clientSecret: credentials.appSecret!,\n      refreshToken,\n    });\n  }\n\n  // --- Account & Page Info ---\n\n  /**\n   * Get user's Facebook Pages with page-level access tokens\n   * Each page has its own never-expiring token (when derived from long-lived user token)\n   *\n   * @param userAccessToken - Long-lived user access token\n   * @returns List of pages with { id, name, access_token, category, ... }\n   */\n  async getPages(userAccessToken: string): Promise<FacebookPage[]> {\n    const data = await this._graphGet(\n      '/me/accounts',\n      userAccessToken,\n      { fields: 'id,name,access_token,category,picture{url},fan_count,followers_count' },\n    );\n    return data.data || [];\n  }\n\n  /**\n   * Get account information -- returns the first managed page\n   */\n  async getAccountInfo(accessToken: string): Promise<FacebookAccountInfo> {\n    const pages = await this.getPages(accessToken);\n\n    if (!pages.length) {\n      throw new SocialError(\n        'facebook',\n        'No Facebook Pages found. Your account must manage at least one Facebook Page.',\n      );\n    }\n\n    const page = pages[0];\n    return {\n      id: page.id,\n      name: page.name,\n      profileImage: page.picture?.data?.url || null,\n      category: page.category,\n      fanCount: page.fan_count,\n      pageAccessToken: page.access_token,\n      pageId: page.id,\n      pages: pages.map(p => ({\n        id: p.id,\n        name: p.name,\n        category: p.category,\n        profileImage: p.picture?.data?.url || null,\n      })),\n    };\n  }\n\n  /**\n   * Test credential validity\n   */\n  async testCredential(credentialData: Record<string, any>): Promise<FacebookTestResult> {\n    try {\n      if (credentialData.oauthTokenData) {\n        const tokenData = typeof credentialData.oauthTokenData === 'string'\n          ? JSON.parse(credentialData.oauthTokenData)\n          : credentialData.oauthTokenData;\n        const accountInfo = await this.getAccountInfo(tokenData.access_token);\n\n        return {\n          status: 'OK',\n          message: `Connected — managing ${accountInfo.pages.length} page(s)`,\n          data: {\n            channelId: accountInfo.id,\n            channelTitle: accountInfo.name,\n            profileImage: accountInfo.profileImage,\n            pages: accountInfo.pages,\n          },\n        };\n      }\n\n      if (!credentialData.appId || !credentialData.appSecret) {\n        return {\n          status: 'Error',\n          message: 'Meta App ID and App Secret are required',\n        };\n      }\n\n      return {\n        status: 'Pending',\n        message: 'Credential needs OAuth authorization. Click \"Connect Account\" to link your Facebook.',\n      };\n    } catch (error: any) {\n      return {\n        status: 'Error',\n        message: error.message || 'Failed to validate Facebook credential',\n      };\n    }\n  }\n\n  // --- Page Token Resolution ---\n\n  /**\n   * Get the page-level access token for a specific page\n   * Page tokens derived from long-lived user tokens never expire.\n   *\n   * @param userAccessToken - Long-lived user access token\n   * @param pageId - Facebook Page ID\n   * @returns Page access token\n   */\n  async getPageAccessToken(userAccessToken: string, pageId: string): Promise<string> {\n    const pages = await this.getPages(userAccessToken);\n    const page = pages.find(p => p.id === pageId);\n\n    if (!page) {\n      throw new SocialError(\n        'facebook',\n        `Page ${pageId} not found or you don't have admin access. Check your page permissions.`,\n      );\n    }\n\n    return page.access_token;\n  }\n\n  // --- Content Publishing ---\n\n  /**\n   * Publish a text post to a Facebook Page\n   * @param pageAccessToken - Page-level access token\n   * @param pageId - Facebook Page ID\n   * @param message - Post text\n   * @param options\n   */\n  async createPost(\n    pageAccessToken: string,\n    pageId: string,\n    message: string,\n    options: CreatePostOptions = {},\n  ): Promise<CreatePostResult> {\n    const body: Record<string, any> = { message };\n\n    if (options.scheduledAt) {\n      const publishTime = Math.floor(new Date(options.scheduledAt).getTime() / 1000);\n      body.published = false;\n      body.scheduled_publish_time = publishTime;\n    }\n\n    const data = await this._graphPost(`/${pageId}/feed`, body, pageAccessToken);\n\n    return {\n      postId: data.id,\n      status: options.scheduledAt ? 'scheduled' : 'published',\n      scheduledAt: options.scheduledAt ? new Date(options.scheduledAt) : null,\n    };\n  }\n\n  /**\n   * Publish a link/article share to a Facebook Page\n   * @param pageAccessToken\n   * @param pageId\n   * @param link - URL to share\n   * @param options\n   */\n  async createLinkPost(\n    pageAccessToken: string,\n    pageId: string,\n    link: string,\n    options: CreateLinkPostOptions = {},\n  ): Promise<CreateLinkPostResult> {\n    const body: Record<string, any> = { link };\n    if (options.message) body.message = options.message;\n\n    if (options.scheduledAt) {\n      const publishTime = Math.floor(new Date(options.scheduledAt).getTime() / 1000);\n      body.published = false;\n      body.scheduled_publish_time = publishTime;\n    }\n\n    const data = await this._graphPost(`/${pageId}/feed`, body, pageAccessToken);\n\n    return {\n      postId: data.id,\n      status: options.scheduledAt ? 'scheduled' : 'published',\n    };\n  }\n\n  /**\n   * Publish a photo to a Facebook Page (via public URL)\n   * @param pageAccessToken\n   * @param pageId\n   * @param photoUrl - Publicly accessible photo URL\n   * @param options\n   */\n  async createPhotoPost(\n    pageAccessToken: string,\n    pageId: string,\n    photoUrl: string,\n    options: CreatePhotoPostOptions = {},\n  ): Promise<CreatePhotoPostResult> {\n    const body: Record<string, any> = { url: photoUrl };\n    if (options.caption) body.message = options.caption;\n\n    if (options.scheduledAt) {\n      const publishTime = Math.floor(new Date(options.scheduledAt).getTime() / 1000);\n      body.published = false;\n      body.scheduled_publish_time = publishTime;\n    }\n\n    const data = await this._graphPost(`/${pageId}/photos`, body, pageAccessToken);\n\n    return {\n      postId: data.post_id || data.id,\n      photoId: data.id,\n      status: options.scheduledAt ? 'scheduled' : 'published',\n    };\n  }\n\n  /**\n   * Upload a video to a Facebook Page (via public URL)\n   * Uses graph-video.facebook.com for video uploads.\n   */\n  async uploadVideo(params: FacebookUploadParams): Promise<UploadResult> {\n    const {\n      videoUrl,\n      title = '',\n      description = '',\n      tokens,\n      scheduledAt,\n      onProgress,\n    } = params;\n\n    const pageAccessToken = tokens.pageAccessToken || tokens.access_token;\n    const pageId = tokens.pageId;\n\n    if (!pageId) {\n      throw new SocialError('facebook', 'Page ID is required. Select a page from your connected pages.');\n    }\n\n    if (!videoUrl) {\n      throw new SocialError('facebook', 'Video URL is required. Facebook accepts public URLs for video uploads.');\n    }\n\n    const body: Record<string, any> = {\n      file_url: videoUrl,\n      title: title.substring(0, 255),\n      description: description.substring(0, 5000),\n    };\n\n    if (scheduledAt) {\n      const publishTime = Math.floor(new Date(scheduledAt).getTime() / 1000);\n      body.published = false;\n      body.scheduled_publish_time = publishTime;\n    }\n\n    if (onProgress) onProgress(10);\n\n    // Video uploads use graph-video.facebook.com\n    const data = await this._graphPost(\n      `/${pageId}/videos`,\n      body,\n      pageAccessToken,\n      GRAPH_VIDEO_BASE,\n    );\n\n    if (onProgress) onProgress(100);\n\n    return {\n      platformVideoId: data.id,\n      platformUrl: `https://www.facebook.com/${pageId}/videos/${data.id}/`,\n      status: scheduledAt ? 'scheduled' : 'published',\n      uploadedAt: new Date(),\n      scheduledAt: scheduledAt ? new Date(scheduledAt) : null,\n      metadata: {\n        pageId,\n        videoId: data.id,\n        title,\n      },\n    };\n  }\n\n  // --- Post Management ---\n\n  /**\n   * Get a post by ID\n   * @param pageAccessToken\n   * @param postId\n   * @param fields - Comma-separated fields\n   */\n  async getPost(\n    pageAccessToken: string,\n    postId: string,\n    fields: string = 'id,message,created_time,permalink_url,shares,likes.summary(true),comments.summary(true)',\n  ): Promise<any> {\n    return this._graphGet(`/${postId}`, pageAccessToken, { fields });\n  }\n\n  /**\n   * Update a post's message\n   * @param pageAccessToken\n   * @param postId\n   * @param message - New message text\n   */\n  async updatePost(pageAccessToken: string, postId: string, message: string): Promise<any> {\n    return this._graphPost(`/${postId}`, { message }, pageAccessToken);\n  }\n\n  /**\n   * Delete a post\n   * @param pageAccessToken\n   * @param postId\n   */\n  async deletePost(pageAccessToken: string, postId: string): Promise<any> {\n    return this._graphDelete(`/${postId}`, pageAccessToken);\n  }\n\n  /**\n   * Get page feed (recent posts)\n   * @param pageAccessToken\n   * @param pageId\n   * @param limit\n   */\n  async getPageFeed(pageAccessToken: string, pageId: string, limit: number = 25): Promise<any> {\n    return this._graphGet(\n      `/${pageId}/feed`,\n      pageAccessToken,\n      { fields: 'id,message,created_time,permalink_url,type,shares', limit: String(limit) },\n    );\n  }\n\n  /**\n   * Get page insights (basic analytics)\n   * @param pageAccessToken\n   * @param pageId\n   * @param period - 'day' | 'week' | 'days_28'\n   */\n  async getPageInsights(\n    pageAccessToken: string,\n    pageId: string,\n    period: 'day' | 'week' | 'days_28' = 'day',\n  ): Promise<any> {\n    return this._graphGet(\n      `/${pageId}/insights`,\n      pageAccessToken,\n      {\n        metric: 'page_impressions,page_engaged_users,page_post_engagements,page_fan_adds',\n        period,\n      },\n    );\n  }\n\n  // --- Schema & Metadata ---\n\n  getCredentialZodSchema(): z.ZodType {\n    return FacebookCredentialsSchema;\n  }\n\n  getCredentialSchema(): CredentialField[] {\n    return [\n      {\n        name: 'appId',\n        displayName: 'Meta App ID',\n        type: 'text',\n        required: true,\n        description: 'App ID from Meta Developer Portal (developers.facebook.com)',\n      },\n      {\n        name: 'appSecret',\n        displayName: 'Meta App Secret',\n        type: 'password',\n        required: true,\n        description: 'App Secret from Meta Developer Portal',\n      },\n    ];\n  }\n\n  getMetadata(): ProviderMetadata {\n    return {\n      name: this.name,\n      displayName: this.displayName,\n      authType: this.authType,\n      icon: 'facebook',\n      brandColor: '#1877F2',\n      description: 'Publish posts, photos, and videos to Facebook Pages',\n      scopes: this.scopes,\n      scopeDescriptions: {\n        pages_show_list: 'View the list of Facebook Pages you manage',\n        pages_read_engagement: 'Read engagement metrics from your pages',\n        pages_manage_posts: 'Create, edit, and delete posts on your pages',\n        pages_read_user_content: 'Read user-generated content on your pages',\n      },\n      supportsScheduling: true,\n      supportsEnvironment: false,\n      setupGuide: [\n        { step: 1, title: 'Create Meta Developer Account', description: 'Go to developers.facebook.com and create an account or log in' },\n        { step: 2, title: 'Create a New App', description: 'Click \"My Apps\" → \"Create App\". Enter your app name and email. On the use case step, filter by \"Content management\" and select \"Manage everything on your Page\"' },\n        { step: 3, title: 'Connect Business Portfolio', description: 'Select or create a Business Portfolio when prompted. Click \"Create App\" to proceed to the dashboard' },\n        { step: 4, title: 'Set Redirect URI', description: `Go to \"Facebook Login\" → \"Settings\" in the left sidebar. Add this as a Valid OAuth Redirect URI: ${this.defaultRedirectUri}` },\n        { step: 5, title: 'Configure App Settings', description: 'Go to Settings → Basic. Add your App Domain and a Privacy Policy URL. Copy your App ID and App Secret and paste them above' },\n        { step: 6, title: 'Add Permissions', description: 'Click \"Customize\" on your use case → \"Permissions and features\". pages_show_list, business_management, and public_profile are pre-added. Click \"+ Add\" for: pages_manage_posts, pages_read_engagement, pages_read_user_content, pages_manage_engagement, read_insights' },\n        { step: 7, title: 'Go Live', description: 'Switch app to \"Live\" mode. For development, Standard Access works with app role users. For production, request Advanced Access via App Review' },\n        { step: 8, title: 'Page Admin Required', description: 'You must be an admin of the Facebook Page(s) you want to post to. The page will be auto-discovered during authorization' },\n      ],\n      redirectUriPattern: this.defaultRedirectUri,\n      credentialSchema: this.getCredentialSchema(),\n    };\n  }\n}\n"],"mappings":"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"}

package/dist/providers/instagram.d.mts

@@ -0,0 +1,122 @@
+import { d as ProviderMetadata, g as UploadResult, i as CredentialField, l as ProviderConfig, o as OAuthTokens, r as AuthUrlOptions, s as PlatformProvider } from "../base-DBtKFiSX.mjs";
+import { _ as MediaInsights, a as InstagramCredentialData, c as InstagramSetupStep, d as InstagramUploadCarouselParams, f as InstagramUploadPhotoParams, g as ListMediaResult, h as ListMediaOptions, i as InstagramAccountInfo, l as InstagramTestResult, m as InstagramUserTag, n as ContainerStatus, o as InstagramMedia, p as InstagramUploadVideoParams, r as ContainerStatusCode, s as InstagramMediaType, t as CarouselItem, u as InstagramTokens } from "../types-hriBJTsU.mjs";
+import { z } from "zod";
+
+//#region src/providers/instagram/index.d.ts
+declare class InstagramProvider extends PlatformProvider {
+  private defaultRedirectUri;
+  private scopes;
+  constructor(cfg?: ProviderConfig);
+  /**
+   * Get Facebook OAuth authorization URL
+   * Instagram uses Facebook's OAuth dialog for authorization
+   */
+  getAuthUrl(state: string, credentials?: Record<string, any>, _options?: AuthUrlOptions): string;
+  /**
+   * Exchange authorization code for tokens (two-step).
+   *
+   * Step 1: code → short-lived token (1 hour)
+   * Step 2: short-lived → long-lived token (60 days)
+   */
+  exchangeCode(code: string, credentials?: Record<string, any>): Promise<OAuthTokens>;
+  /**
+   * Refresh long-lived token. Instagram uses the access token itself as the
+   * refresh credential (must be ≥24h old, not yet expired) and hits the
+   * `graph.instagram.com` refresh endpoint.
+   */
+  refreshToken(refreshToken: string): Promise<OAuthTokens>;
+  /**
+   * Get Instagram Business Account info
+   *
+   * Flow:
+   * 1. Get user's Facebook Pages via /me/accounts
+   * 2. For first page, get linked instagram_business_account
+   * 3. Get IG profile details
+   */
+  getAccountInfo(accessToken: string): Promise<InstagramAccountInfo>;
+  /**
+   * Test credential validity
+   */
+  testCredential(credentialData: InstagramCredentialData): Promise<InstagramTestResult>;
+  /**
+   * Upload a video as a Reel to Instagram
+   *
+   * Instagram requires publicly accessible video URLs (no binary upload).
+   * Flow: create container → poll status → publish
+   *
+   * @param params
+   * @param params.videoUrl - Publicly accessible video URL (required)
+   * @param params.title - Used as caption
+   * @param params.description - Appended to caption if title is empty
+   * @param params.tokens - { access_token, ig_user_id }
+   * @param params.onProgress - Progress callback
+   */
+  uploadVideo(params: InstagramUploadVideoParams): Promise<UploadResult>;
+  /**
+   * Create a single photo post on Instagram
+   *
+   * @param params
+   * @param params.imageUrl - Publicly accessible image URL
+   * @param params.caption - Post caption (max 2200 chars)
+   * @param params.tokens - { access_token, ig_user_id }
+   */
+  uploadPhoto(params: InstagramUploadPhotoParams): Promise<{
+    mediaId: string;
+    status: string;
+  }>;
+  /**
+   * Create a carousel post on Instagram
+   *
+   * @param params
+   * @param params.items - 2-10 media items with type ('IMAGE'|'VIDEO') and url
+   * @param params.caption - Post caption (max 2200 chars)
+   * @param params.tokens - { access_token, ig_user_id }
+   */
+  uploadCarousel(params: InstagramUploadCarouselParams): Promise<{
+    mediaId: string;
+    status: string;
+  }>;
+  /**
+   * Get a single media object by ID
+   *
+   * @param accessToken - Valid access token
+   * @param mediaId - Instagram media ID
+   */
+  getMedia(accessToken: string, mediaId: string): Promise<InstagramMedia>;
+  /**
+   * List media for an Instagram user
+   *
+   * @param accessToken - Valid access token
+   * @param userId - IG user ID (if omitted, fetched via getAccountInfo)
+   * @param options - Pagination options (limit, after, before)
+   */
+  listMedia(accessToken: string, userId?: string, options?: ListMediaOptions): Promise<ListMediaResult>;
+  /**
+   * Get insights for a specific media object
+   *
+   * @param accessToken - Valid access token
+   * @param mediaId - Instagram media ID
+   */
+  getMediaInsights(accessToken: string, mediaId: string): Promise<MediaInsights>;
+  getCredentialZodSchema(): z.ZodType;
+  getCredentialSchema(): CredentialField[];
+  getMetadata(): ProviderMetadata;
+  /**
+   * Make a GET request to the Graph API
+   * @private
+   */
+  private _graphGet;
+  /**
+   * Make a POST request to the Graph API
+   * @private
+   */
+  private _graphPost;
+  /**
+   * Poll container status until FINISHED, ERROR, or timeout
+   * @private
+   */
+  private _pollContainerStatus;
+}
+//#endregion
+export { type CarouselItem, type ContainerStatus, type ContainerStatusCode, type InstagramAccountInfo, type InstagramCredentialData, type InstagramMedia, type InstagramMediaType, InstagramProvider, type InstagramSetupStep, type InstagramTestResult, type InstagramTokens, type InstagramUploadCarouselParams, type InstagramUploadPhotoParams, type InstagramUploadVideoParams, type InstagramUserTag, type ListMediaOptions, type ListMediaResult, type MediaInsights };
+//# sourceMappingURL=instagram.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"instagram.d.mts","names":[],"sources":["../../src/providers/instagram/index.ts"],"mappings":";;;;;cA0Fa,iBAAA,SAA0B,gBAAA;EAAA,QAC7B,kBAAA;EAAA,QACA,MAAA;cAEI,GAAA,GAAK,cAAA;EAkc6C;;;;EAxa9D,UAAA,CAAW,KAAA,UAAe,WAAA,GAAa,MAAA,eAA0B,QAAA,GAAW,cAAA;EA9BvB;;;;;;EAgD/C,YAAA,CAAa,IAAA,UAAc,WAAA,GAAa,MAAA,gBAA2B,OAAA,CAAQ,WAAA;EA5CrE;;;;;EA2DN,YAAA,CAAa,YAAA,WAAuB,OAAA,CAAQ,WAAA;EAjCe;;;;;;;;EA+C3D,cAAA,CAAe,WAAA,WAAsB,OAAA,CAAQ,oBAAA;EAdT;;;EAmEpC,cAAA,CAAe,cAAA,EAAgB,uBAAA,GAA0B,OAAA,CAAQ,mBAAA;EArD5B;;;;;;;;;;;;;EA0GrC,WAAA,CAAY,MAAA,EAAQ,0BAAA,GAA6B,OAAA,CAAQ,YAAA;EAmF7C;;;;;;;;EAAZ,WAAA,CAAY,MAAA,EAAQ,0BAAA,GAA6B,OAAA;IAAU,OAAA;IAAiB,MAAA;EAAA;EAmH9C;;;;;;;;EAnE9B,cAAA,CAAe,MAAA,EAAQ,6BAAA,GAAgC,OAAA;IAAU,OAAA;IAAiB,MAAA;EAAA;EA4I5C;;;;;;EAzEtC,QAAA,CAAS,WAAA,UAAqB,OAAA,WAAkB,OAAA,CAAQ,cAAA;EAgHvC;;;;;;;EAjFjB,SAAA,CAAU,WAAA,UAAqB,MAAA,WAAiB,OAAA,GAAS,gBAAA,GAAwB,OAAA,CAAQ,eAAA;;;;;;;EA0CzF,gBAAA,CAAiB,WAAA,UAAqB,OAAA,WAAkB,OAAA,CAAQ,aAAA;EAmCtE,sBAAA,CAAA,GAA0B,CAAA,CAAE,OAAA;EAI5B,mBAAA,CAAA,GAAuB,eAAA;EAmBvB,WAAA,CAAA,GAAe,gBAAA;;;;;UAuED,SAAA;;;;;UAkBA,UAAA;;;;;UAgBA,oBAAA;AAAA"}