@classytic/social 0.1.0

package/dist/facebook-l_4CghaA.mjs

@@ -0,0 +1,95 @@
+import { t as __exportAll } from "./chunk-DQk6qfdC.mjs";
+import { i as OAuthTokensSchema, r as NonEmptyString } from "./shared-Fvc6xQku.mjs";
+import { z } from "zod";
+
+//#region src/schemas/facebook.ts
+/**
+* Facebook Pages zod v4 schemas.
+*/
+var facebook_exports = /* @__PURE__ */ __exportAll({
+	FacebookCreateLinkPostSchema: () => FacebookCreateLinkPostSchema,
+	FacebookCreatePhotoPostSchema: () => FacebookCreatePhotoPostSchema,
+	FacebookCreatePostSchema: () => FacebookCreatePostSchema,
+	FacebookCredentialDataSchema: () => FacebookCredentialDataSchema,
+	FacebookCredentialsSchema: () => FacebookCredentialsSchema,
+	FacebookFeedSchema: () => FacebookFeedSchema,
+	FacebookInsightsPeriod: () => FacebookInsightsPeriod,
+	FacebookVideoUploadSchema: () => FacebookVideoUploadSchema,
+	facebookCapabilities: () => facebookCapabilities,
+	facebookInfo: () => facebookInfo
+});
+const FacebookCredentialsSchema = z.object({
+	appId: NonEmptyString.describe("Facebook app ID"),
+	appSecret: NonEmptyString.describe("Facebook app secret"),
+	redirectUri: z.url().optional()
+});
+const FacebookCredentialDataSchema = FacebookCredentialsSchema.extend({ oauthTokenData: z.union([z.string(), OAuthTokensSchema]).optional() });
+const ScheduledAt = z.union([z.iso.datetime(), z.date()]).optional().describe("Schedule publication time (10 minutes – 6 months in the future)");
+const FacebookCreatePostSchema = z.object({
+	message: z.string().min(1).max(63206),
+	scheduledAt: ScheduledAt
+});
+const FacebookCreateLinkPostSchema = z.object({
+	link: z.url(),
+	message: z.string().max(63206).optional(),
+	scheduledAt: ScheduledAt
+});
+const FacebookCreatePhotoPostSchema = z.object({
+	photoUrl: z.url(),
+	caption: z.string().max(63206).optional(),
+	scheduledAt: ScheduledAt
+});
+const FacebookVideoUploadSchema = z.object({
+	videoUrl: z.url(),
+	title: z.string().max(255).optional(),
+	description: z.string().max(63206).optional(),
+	scheduledAt: ScheduledAt
+});
+const FacebookFeedSchema = z.object({
+	limit: z.number().int().min(1).max(100).optional().default(25),
+	cursor: z.string().optional()
+});
+const FacebookInsightsPeriod = z.enum([
+	"day",
+	"week",
+	"days_28"
+]);
+const facebookCapabilities = {
+	auth: "oauth2",
+	posting: true,
+	upload: true,
+	messaging: false,
+	scheduling: true,
+	deletion: true,
+	listing: true,
+	analytics: true,
+	environments: false,
+	pkce: false
+};
+const facebookInfo = {
+	name: "facebook",
+	displayName: "Facebook Pages",
+	scopes: [
+		"business_management",
+		"pages_show_list",
+		"pages_read_engagement",
+		"pages_manage_posts",
+		"pages_read_user_content"
+	],
+	fileLimits: {
+		photo: { maxSizeBytes: 4 * 1024 * 1024 * 1024 },
+		video: {
+			maxSizeBytes: 10 * 1024 ** 3,
+			maxDurationSec: 4 * 3600
+		}
+	},
+	scheduling: {
+		minMinutes: 10,
+		maxDays: 180
+	},
+	docsUrl: "https://developers.facebook.com/docs/pages-api"
+};
+
+//#endregion
+export { facebook_exports as i, facebookCapabilities as n, facebookInfo as r, FacebookCredentialsSchema as t };
+//# sourceMappingURL=facebook-l_4CghaA.mjs.map

package/dist/facebook-l_4CghaA.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"facebook-l_4CghaA.mjs","names":[],"sources":["../src/schemas/facebook.ts"],"sourcesContent":["/**\n * Facebook Pages zod v4 schemas.\n */\n\nimport { z } from 'zod';\nimport type { ProviderCapabilities } from '../common/contracts.js';\nimport { NonEmptyString, OAuthTokensSchema } from './shared.js';\n\n// ─── Credentials ────────────────────────────────────────────────────────────\n\nexport const FacebookCredentialsSchema = z.object({\n  appId: NonEmptyString.describe('Facebook app ID'),\n  appSecret: NonEmptyString.describe('Facebook app secret'),\n  redirectUri: z.url().optional(),\n});\nexport type FacebookCredentialsInput = z.infer<typeof FacebookCredentialsSchema>;\n\nexport const FacebookCredentialDataSchema = FacebookCredentialsSchema.extend({\n  oauthTokenData: z.union([z.string(), OAuthTokensSchema]).optional(),\n});\n\n// ─── Post creation ──────────────────────────────────────────────────────────\n\nconst ScheduledAt = z.union([z.iso.datetime(), z.date()]).optional()\n  .describe('Schedule publication time (10 minutes – 6 months in the future)');\n\nexport const FacebookCreatePostSchema = z.object({\n  message: z.string().min(1).max(63206),\n  scheduledAt: ScheduledAt,\n});\n\nexport const FacebookCreateLinkPostSchema = z.object({\n  link: z.url(),\n  message: z.string().max(63206).optional(),\n  scheduledAt: ScheduledAt,\n});\n\nexport const FacebookCreatePhotoPostSchema = z.object({\n  photoUrl: z.url(),\n  caption: z.string().max(63206).optional(),\n  scheduledAt: ScheduledAt,\n});\n\nexport const FacebookVideoUploadSchema = z.object({\n  videoUrl: z.url(),\n  title: z.string().max(255).optional(),\n  description: z.string().max(63206).optional(),\n  scheduledAt: ScheduledAt,\n});\n\n// ─── List / read ────────────────────────────────────────────────────────────\n\nexport const FacebookFeedSchema = z.object({\n  limit: z.number().int().min(1).max(100).optional().default(25),\n  cursor: z.string().optional(),\n});\n\nexport const FacebookInsightsPeriod = z.enum(['day', 'week', 'days_28']);\n\n// ─── Capabilities ───────────────────────────────────────────────────────────\n\nexport const facebookCapabilities: ProviderCapabilities = {\n  auth: 'oauth2',\n  posting: true,\n  upload: true,\n  messaging: false,\n  scheduling: true,\n  deletion: true,\n  listing: true,\n  analytics: true,\n  environments: false,\n  pkce: false,\n};\n\nexport const facebookInfo = {\n  name: 'facebook' as const,\n  displayName: 'Facebook Pages',\n  scopes: [\n    'business_management',\n    'pages_show_list',\n    'pages_read_engagement',\n    'pages_manage_posts',\n    'pages_read_user_content',\n  ],\n  fileLimits: {\n    photo: { maxSizeBytes: 4 * 1024 * 1024 * 1024 },\n    video: { maxSizeBytes: 10 * 1024 ** 3, maxDurationSec: 4 * 3600 },\n  },\n  scheduling: { minMinutes: 10, maxDays: 6 * 30 },\n  docsUrl: 'https://developers.facebook.com/docs/pages-api',\n} as const;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAUA,MAAa,4BAA4B,EAAE,OAAO;CAChD,OAAO,eAAe,SAAS,kBAAkB;CACjD,WAAW,eAAe,SAAS,sBAAsB;CACzD,aAAa,EAAE,KAAK,CAAC,UAAU;CAChC,CAAC;AAGF,MAAa,+BAA+B,0BAA0B,OAAO,EAC3E,gBAAgB,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CAAC,UAAU,EACpE,CAAC;AAIF,MAAM,cAAc,EAAE,MAAM,CAAC,EAAE,IAAI,UAAU,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,CACjE,SAAS,kEAAkE;AAE9E,MAAa,2BAA2B,EAAE,OAAO;CAC/C,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,MAAM;CACrC,aAAa;CACd,CAAC;AAEF,MAAa,+BAA+B,EAAE,OAAO;CACnD,MAAM,EAAE,KAAK;CACb,SAAS,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,UAAU;CACzC,aAAa;CACd,CAAC;AAEF,MAAa,gCAAgC,EAAE,OAAO;CACpD,UAAU,EAAE,KAAK;CACjB,SAAS,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,UAAU;CACzC,aAAa;CACd,CAAC;AAEF,MAAa,4BAA4B,EAAE,OAAO;CAChD,UAAU,EAAE,KAAK;CACjB,OAAO,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,UAAU;CACrC,aAAa,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,UAAU;CAC7C,aAAa;CACd,CAAC;AAIF,MAAa,qBAAqB,EAAE,OAAO;CACzC,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,GAAG;CAC9D,QAAQ,EAAE,QAAQ,CAAC,UAAU;CAC9B,CAAC;AAEF,MAAa,yBAAyB,EAAE,KAAK;CAAC;CAAO;CAAQ;CAAU,CAAC;AAIxE,MAAa,uBAA6C;CACxD,MAAM;CACN,SAAS;CACT,QAAQ;CACR,WAAW;CACX,YAAY;CACZ,UAAU;CACV,SAAS;CACT,WAAW;CACX,cAAc;CACd,MAAM;CACP;AAED,MAAa,eAAe;CAC1B,MAAM;CACN,aAAa;CACb,QAAQ;EACN;EACA;EACA;EACA;EACA;EACD;CACD,YAAY;EACV,OAAO,EAAE,cAAc,IAAI,OAAO,OAAO,MAAM;EAC/C,OAAO;GAAE,cAAc,KAAK,QAAQ;GAAG,gBAAgB,IAAI;GAAM;EAClE;CACD,YAAY;EAAE,YAAY;EAAI,SAAS;EAAQ;CAC/C,SAAS;CACV"}

package/dist/http-DpcLSR1M.mjs

@@ -0,0 +1,197 @@
+import { t as SocialError } from "./errors-Cm6LeKf7.mjs";
+
+//#region src/common/http.ts
+/**
+* Shared HTTP client for all providers.
+*
+* Centralizes:
+* - Timeouts (AbortController)
+* - Retry with exponential backoff and Retry-After honoring
+* - 429 / 5xx detection
+* - JSON / form-urlencoded / multipart bodies
+* - Structured errors via SocialError
+*
+* All provider _api helpers should delegate to this module.
+*/
+const DEFAULT_TIMEOUT = 3e4;
+const DEFAULT_RETRY_STATUSES = [
+	429,
+	502,
+	503,
+	504
+];
+function buildUrl(url, query) {
+	if (!query) return url;
+	const params = new URLSearchParams();
+	for (const [k, v] of Object.entries(query)) {
+		if (v === void 0 || v === null) continue;
+		params.append(k, String(v));
+	}
+	const qs = params.toString();
+	if (!qs) return url;
+	return url + (url.includes("?") ? "&" : "?") + qs;
+}
+function parseRetryAfter(headers) {
+	const ra = headers?.get?.("retry-after");
+	if (!ra) return null;
+	const seconds = Number(ra);
+	if (Number.isFinite(seconds)) return Math.max(0, seconds);
+	const dateMs = Date.parse(ra);
+	if (!Number.isNaN(dateMs)) return Math.max(0, Math.ceil((dateMs - Date.now()) / 1e3));
+	return null;
+}
+function backoffDelay(attempt, base, max, retryAfter) {
+	if (retryAfter !== null) return Math.min(max, retryAfter * 1e3);
+	const exp = Math.min(max, base * 2 ** attempt);
+	return Math.floor(Math.random() * exp);
+}
+async function readResponseBody(response) {
+	const contentType = response.headers?.get?.("content-type") || "";
+	if (response.status === 204) return null;
+	if (!contentType || contentType.includes("application/json")) try {
+		if (typeof response.json === "function") return await response.json();
+	} catch {
+		return null;
+	}
+	if (typeof response.text !== "function") return null;
+	const text = await response.text();
+	if (!text) return null;
+	try {
+		return JSON.parse(text);
+	} catch {
+		return text;
+	}
+}
+function buildBody(opts) {
+	const headers = {};
+	if (opts.json !== void 0) {
+		headers["Content-Type"] = "application/json";
+		return {
+			body: JSON.stringify(opts.json),
+			headers
+		};
+	}
+	if (opts.form !== void 0) return {
+		body: opts.form,
+		headers
+	};
+	if (opts.urlencoded !== void 0) {
+		headers["Content-Type"] = "application/x-www-form-urlencoded";
+		return {
+			body: opts.urlencoded instanceof URLSearchParams ? opts.urlencoded.toString() : new URLSearchParams(opts.urlencoded).toString(),
+			headers
+		};
+	}
+	if (opts.binary !== void 0) return {
+		body: opts.binary instanceof Uint8Array ? opts.binary : opts.binary instanceof ArrayBuffer ? new Uint8Array(opts.binary) : new Uint8Array(opts.binary),
+		headers
+	};
+	if (opts.text !== void 0) {
+		headers["Content-Type"] = "text/plain";
+		return {
+			body: opts.text,
+			headers
+		};
+	}
+	return {
+		body: void 0,
+		headers
+	};
+}
+/**
+* Core request function. Throws SocialError on failure. Returns parsed body on success.
+*
+* @param provider — provider name used for error attribution
+* @param opts — request options
+*/
+async function httpRequest(provider, opts) {
+	const method = opts.method ?? "GET";
+	const url = buildUrl(opts.url, opts.query);
+	const timeout = opts.timeout ?? DEFAULT_TIMEOUT;
+	const retry = opts.retry ?? { attempts: 0 };
+	const retryStatuses = retry.on ?? DEFAULT_RETRY_STATUSES;
+	const baseDelay = retry.baseDelayMs ?? 500;
+	const maxDelay = retry.maxDelayMs ?? 3e4;
+	const { body, headers: bodyHeaders } = buildBody(opts);
+	const headers = {
+		Accept: "application/json",
+		...bodyHeaders,
+		...opts.headers ?? {}
+	};
+	if (opts.bearer) headers.Authorization = `Bearer ${opts.bearer}`;
+	let lastError = null;
+	const totalAttempts = retry.attempts + 1;
+	for (let attempt = 0; attempt < totalAttempts; attempt++) {
+		const controller = new AbortController();
+		const timer = timeout > 0 ? setTimeout(() => controller.abort(), timeout) : null;
+		const callerAbort = () => controller.abort();
+		if (opts.signal) if (opts.signal.aborted) controller.abort();
+		else opts.signal.addEventListener("abort", callerAbort, { once: true });
+		let response;
+		try {
+			response = await fetch(url, {
+				method,
+				headers,
+				body,
+				signal: controller.signal
+			});
+		} catch (err) {
+			if (timer) clearTimeout(timer);
+			opts.signal?.removeEventListener("abort", callerAbort);
+			const isTimeout = err.name === "AbortError" && !opts.signal?.aborted;
+			lastError = new SocialError(provider, isTimeout ? `Request timed out after ${timeout}ms` : `Network error: ${err.message}`, {
+				statusCode: isTimeout ? 504 : 502,
+				retryable: true,
+				originalError: err
+			});
+			if (attempt < totalAttempts - 1) {
+				await sleep(backoffDelay(attempt, baseDelay, maxDelay, null));
+				continue;
+			}
+			throw lastError;
+		} finally {
+			if (timer) clearTimeout(timer);
+			opts.signal?.removeEventListener("abort", callerAbort);
+		}
+		const status = response.status ?? 200;
+		const responseHeaders = response.headers ?? new Headers();
+		if (response.ok ?? (status >= 200 && status < 300)) return {
+			data: await readResponseBody(response),
+			status,
+			headers: responseHeaders
+		};
+		const raw = await readResponseBody(response);
+		const retryAfter = parseRetryAfter(responseHeaders);
+		if (retryStatuses.includes(status) && attempt < totalAttempts - 1) {
+			await sleep(backoffDelay(attempt, baseDelay, maxDelay, retryAfter));
+			continue;
+		}
+		const parsed = opts.parseError?.(raw, status, responseHeaders);
+		const isRetryable = status === 429 || status >= 500;
+		throw new SocialError(provider, parsed?.message ?? defaultErrorMessage(status, raw), {
+			statusCode: status >= 400 && status < 500 ? status : 502,
+			errorCode: parsed?.errorCode ?? null,
+			hint: parsed?.hint ?? null,
+			retryable: parsed?.retryable ?? isRetryable,
+			retryAfter: parsed?.retryAfter ?? retryAfter,
+			...parsed?.extras ?? {}
+		});
+	}
+	throw lastError ?? new SocialError(provider, "Unknown HTTP error");
+}
+function defaultErrorMessage(status, raw) {
+	if (raw && typeof raw === "object") {
+		const r = raw;
+		const msg = r.message ?? r.error_description ?? r.detail ?? r.error;
+		if (typeof msg === "string") return msg;
+	}
+	if (typeof raw === "string" && raw.trim()) return raw;
+	return `HTTP ${status}`;
+}
+function sleep(ms) {
+	return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+//#endregion
+export { httpRequest as t };
+//# sourceMappingURL=http-DpcLSR1M.mjs.map

package/dist/http-DpcLSR1M.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-DpcLSR1M.mjs","names":[],"sources":["../src/common/http.ts"],"sourcesContent":["/**\n * Shared HTTP client for all providers.\n *\n * Centralizes:\n * - Timeouts (AbortController)\n * - Retry with exponential backoff and Retry-After honoring\n * - 429 / 5xx detection\n * - JSON / form-urlencoded / multipart bodies\n * - Structured errors via SocialError\n *\n * All provider _api helpers should delegate to this module.\n */\n\nimport { SocialError } from '../errors.js';\n\nexport type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';\n\nexport type ParseError<E> = (raw: unknown, status: number, headers: Headers) => {\n  message: string;\n  errorCode?: string | number | null;\n  hint?: string | null;\n  retryable?: boolean | null;\n  retryAfter?: number | null;\n  extras?: Record<string, unknown>;\n} | null;\n\nexport interface RetryConfig {\n  /** Max retry attempts (in addition to the initial request). Default 0. */\n  attempts: number;\n  /** HTTP status codes that should trigger a retry. Default [429, 502, 503, 504]. */\n  on?: number[];\n  /** Base delay in ms before exponential backoff. Default 500. */\n  baseDelayMs?: number;\n  /** Cap on backoff delay. Default 30_000. */\n  maxDelayMs?: number;\n}\n\nexport interface HttpRequestOptions<E = unknown> {\n  method?: HttpMethod;\n  url: string;\n  query?: Record<string, string | number | boolean | undefined | null>;\n  /** JSON body. Mutually exclusive with `form`, `urlencoded`, `binary`, `text`. */\n  json?: unknown;\n  /** multipart/form-data body. */\n  form?: FormData;\n  /** application/x-www-form-urlencoded body. */\n  urlencoded?: URLSearchParams | Record<string, string>;\n  /** Raw binary body. */\n  binary?: ArrayBuffer | Uint8Array | Buffer;\n  /** Raw text body. */\n  text?: string;\n  headers?: Record<string, string>;\n  /** Convenience: sets `Authorization: Bearer <token>`. */\n  bearer?: string;\n  /** Request timeout in ms. Default 30_000. Use 0 to disable. */\n  timeout?: number;\n  /** Retry policy. Default no retries. */\n  retry?: RetryConfig;\n  /** Provider-specific error parser invoked when the response is not OK. */\n  parseError?: ParseError<E>;\n  /** AbortSignal for caller-driven cancellation. */\n  signal?: AbortSignal;\n}\n\nexport interface HttpResponse<T> {\n  data: T;\n  status: number;\n  headers: Headers;\n}\n\nconst DEFAULT_TIMEOUT = 30_000;\nconst DEFAULT_RETRY_STATUSES = [429, 502, 503, 504];\n\nfunction buildUrl(url: string, query?: HttpRequestOptions['query']): string {\n  if (!query) return url;\n  const params = new URLSearchParams();\n  for (const [k, v] of Object.entries(query)) {\n    if (v === undefined || v === null) continue;\n    params.append(k, String(v));\n  }\n  const qs = params.toString();\n  if (!qs) return url;\n  return url + (url.includes('?') ? '&' : '?') + qs;\n}\n\nfunction parseRetryAfter(headers: Headers): number | null {\n  const ra = headers?.get?.('retry-after');\n  if (!ra) return null;\n  const seconds = Number(ra);\n  if (Number.isFinite(seconds)) return Math.max(0, seconds);\n  // HTTP-date format\n  const dateMs = Date.parse(ra);\n  if (!Number.isNaN(dateMs)) {\n    return Math.max(0, Math.ceil((dateMs - Date.now()) / 1000));\n  }\n  return null;\n}\n\nfunction backoffDelay(attempt: number, base: number, max: number, retryAfter: number | null): number {\n  if (retryAfter !== null) return Math.min(max, retryAfter * 1000);\n  // Exponential backoff with full jitter\n  const exp = Math.min(max, base * 2 ** attempt);\n  return Math.floor(Math.random() * exp);\n}\n\nasync function readResponseBody(response: Response): Promise<unknown> {\n  // Defensive against test fixtures with partial Response shapes.\n  const contentType = response.headers?.get?.('content-type') || '';\n  if (response.status === 204) return null;\n  if (!contentType || contentType.includes('application/json')) {\n    try {\n      if (typeof response.json === 'function') return await response.json();\n    } catch {\n      return null;\n    }\n  }\n  // Fall back to text for non-JSON responses (LinkedIn binary uploads, errors with HTML, etc.)\n  if (typeof response.text !== 'function') return null;\n  const text = await response.text();\n  if (!text) return null;\n  try {\n    return JSON.parse(text);\n  } catch {\n    return text;\n  }\n}\n\ntype RequestBody = NonNullable<RequestInit['body']>;\n\nfunction buildBody(opts: HttpRequestOptions): {\n  body: RequestBody | undefined;\n  headers: Record<string, string>;\n} {\n  const headers: Record<string, string> = {};\n  if (opts.json !== undefined) {\n    headers['Content-Type'] = 'application/json';\n    return { body: JSON.stringify(opts.json), headers };\n  }\n  if (opts.form !== undefined) {\n    return { body: opts.form, headers };\n  }\n  if (opts.urlencoded !== undefined) {\n    headers['Content-Type'] = 'application/x-www-form-urlencoded';\n    const body = opts.urlencoded instanceof URLSearchParams\n      ? opts.urlencoded.toString()\n      : new URLSearchParams(opts.urlencoded).toString();\n    return { body, headers };\n  }\n  if (opts.binary !== undefined) {\n    const body: RequestBody = opts.binary instanceof Uint8Array\n      ? opts.binary\n      : opts.binary instanceof ArrayBuffer\n        ? new Uint8Array(opts.binary)\n        : new Uint8Array(opts.binary as Uint8Array);\n    return { body, headers };\n  }\n  if (opts.text !== undefined) {\n    headers['Content-Type'] = 'text/plain';\n    return { body: opts.text, headers };\n  }\n  return { body: undefined, headers };\n}\n\n/**\n * Core request function. Throws SocialError on failure. Returns parsed body on success.\n *\n * @param provider — provider name used for error attribution\n * @param opts — request options\n */\nexport async function httpRequest<T = unknown, E = unknown>(\n  provider: string,\n  opts: HttpRequestOptions<E>,\n): Promise<HttpResponse<T>> {\n  const method = opts.method ?? 'GET';\n  const url = buildUrl(opts.url, opts.query);\n  const timeout = opts.timeout ?? DEFAULT_TIMEOUT;\n  const retry = opts.retry ?? { attempts: 0 };\n  const retryStatuses = retry.on ?? DEFAULT_RETRY_STATUSES;\n  const baseDelay = retry.baseDelayMs ?? 500;\n  const maxDelay = retry.maxDelayMs ?? 30_000;\n\n  const { body, headers: bodyHeaders } = buildBody(opts);\n  const headers: Record<string, string> = {\n    Accept: 'application/json',\n    ...bodyHeaders,\n    ...(opts.headers ?? {}),\n  };\n  if (opts.bearer) headers.Authorization = `Bearer ${opts.bearer}`;\n\n  let lastError: SocialError | null = null;\n  const totalAttempts = retry.attempts + 1;\n\n  for (let attempt = 0; attempt < totalAttempts; attempt++) {\n    const controller = new AbortController();\n    const timer = timeout > 0 ? setTimeout(() => controller.abort(), timeout) : null;\n\n    // Combine caller-supplied signal with timeout signal\n    const callerAbort = () => controller.abort();\n    if (opts.signal) {\n      if (opts.signal.aborted) controller.abort();\n      else opts.signal.addEventListener('abort', callerAbort, { once: true });\n    }\n\n    let response: Response;\n    try {\n      response = await fetch(url, {\n        method,\n        headers,\n        body,\n        signal: controller.signal,\n      });\n    } catch (err) {\n      if (timer) clearTimeout(timer);\n      opts.signal?.removeEventListener('abort', callerAbort);\n\n      const isAbort = (err as Error).name === 'AbortError';\n      const isTimeout = isAbort && !opts.signal?.aborted;\n      lastError = new SocialError(provider, isTimeout ? `Request timed out after ${timeout}ms` : `Network error: ${(err as Error).message}`, {\n        statusCode: isTimeout ? 504 : 502,\n        retryable: true,\n        originalError: err as Error,\n      });\n      // Retry on network errors / timeouts if we have attempts left\n      if (attempt < totalAttempts - 1) {\n        await sleep(backoffDelay(attempt, baseDelay, maxDelay, null));\n        continue;\n      }\n      throw lastError;\n    } finally {\n      if (timer) clearTimeout(timer);\n      opts.signal?.removeEventListener('abort', callerAbort);\n    }\n\n    // Defensive against partial test fixtures: treat undefined `ok` as ok if\n    // status is missing or 2xx; treat undefined headers as empty Headers.\n    const status = response.status ?? 200;\n    const responseHeaders = response.headers ?? new Headers();\n    const isOk = response.ok ?? (status >= 200 && status < 300);\n\n    if (isOk) {\n      const data = await readResponseBody(response) as T;\n      return { data, status, headers: responseHeaders };\n    }\n\n    // Non-OK response — read body and decide whether to retry / throw\n    const raw = await readResponseBody(response);\n    const retryAfter = parseRetryAfter(responseHeaders);\n    const shouldRetry = retryStatuses.includes(status) && attempt < totalAttempts - 1;\n\n    if (shouldRetry) {\n      await sleep(backoffDelay(attempt, baseDelay, maxDelay, retryAfter));\n      continue;\n    }\n\n    // Build SocialError with optional provider-specific parser\n    const parsed = opts.parseError?.(raw, status, responseHeaders);\n    const isRetryable = status === 429 || status >= 500;\n    throw new SocialError(provider, parsed?.message ?? defaultErrorMessage(status, raw), {\n      statusCode: status >= 400 && status < 500 ? status : 502,\n      errorCode: parsed?.errorCode ?? null,\n      hint: parsed?.hint ?? null,\n      retryable: parsed?.retryable ?? isRetryable,\n      retryAfter: parsed?.retryAfter ?? retryAfter,\n      ...(parsed?.extras ?? {}),\n    });\n  }\n\n  // Unreachable, but required for control-flow analysis\n  throw lastError ?? new SocialError(provider, 'Unknown HTTP error');\n}\n\nfunction defaultErrorMessage(status: number, raw: unknown): string {\n  if (raw && typeof raw === 'object') {\n    const r = raw as Record<string, unknown>;\n    const msg = r.message ?? r.error_description ?? r.detail ?? r.error;\n    if (typeof msg === 'string') return msg;\n  }\n  if (typeof raw === 'string' && raw.trim()) return raw;\n  return `HTTP ${status}`;\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise(resolve => setTimeout(resolve, ms));\n}\n\n// Re-export error type for convenience\nexport { SocialError };\n"],"mappings":"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"}

package/dist/index.d.mts

@@ -0,0 +1,42 @@
+import { _ as ValidationResult, a as CredentialFieldType, c as PrivacyLevel, d as ProviderMetadata, f as SetupGuideStep, g as UploadResult, h as UploadParams, i as CredentialField, l as ProviderConfig, m as TestStatus, n as AuthType, o as OAuthTokens, p as TestResult, r as AuthUrlOptions, s as PlatformProvider, t as AccountInfo, u as ProviderEnvironment, v as deriveCredentialFields } from "./base-DBtKFiSX.mjs";
+import { TwitterProvider } from "./providers/twitter.mjs";
+import { A as WhatsAppClientConfig, C as SocialClientOptions, E as TwitterClientConfig, O as UnifiedPostInput, S as RedditClientConfig, T as TikTokClientConfig, _ as MultiPostResult, a as YouTubeClient, b as ProviderConfigMap, c as LinkedInClient, d as FacebookClientConfig, f as InstagramClientConfig, g as MultiPostInput, h as MessageResult, i as TikTokClient, j as YouTubeClientConfig, k as UnifiedUploadInput, l as FacebookClient, m as MessageInput, n as WhatsAppClient, o as InstagramClient, p as LinkedInClientConfig, r as TelegramClient, s as RedditClient, t as fromEnv, u as TwitterClient, v as MultiUploadInput, w as TelegramClientConfig, x as ProviderName, y as PostResult } from "./env-DxOZHf0p.mjs";
+import { FacebookProvider } from "./providers/facebook.mjs";
+import { LinkedInProvider } from "./providers/linkedin.mjs";
+import { RedditProvider } from "./providers/reddit.mjs";
+import { InstagramProvider } from "./providers/instagram.mjs";
+import { YouTubeProvider } from "./providers/youtube.mjs";
+import { TikTokProvider } from "./providers/tiktok.mjs";
+import { TelegramProvider } from "./providers/telegram.mjs";
+import { WhatsAppProvider } from "./providers/whatsapp.mjs";
+import { a as ProviderCapabilities, c as UnifiedPostInput$1, d as isPostingProvider, f as isUploadingProvider, i as ProviderAuth, l as UploadingProvider, n as MessagingProvider, o as UnifiedMedia, r as PostingProvider, s as UnifiedPost, u as isMessagingProvider } from "./contracts-Cdwa4zlg.mjs";
+import { SocialClient } from "./client/index.mjs";
+import { A as SocialErrorOptions, D as RetryConfig, O as httpRequest, S as generateCodeVerifier, T as HttpResponse, _ as buildAuthUrl, a as Page, b as PkceStore, c as paginate, d as metaExchangeLongLived, f as metaRefreshLongLivedFacebook, i as pollUntilComplete, k as SocialError, n as redactSecrets, p as metaRefreshLongLivedInstagram, r as PollOptions, s as PaginatedIterable, t as assertPublicHttpUrl, v as oauth2ExchangeCode, w as HttpRequestOptions, x as generateCodeChallenge, y as oauth2RefreshToken } from "./security-BXhfebWm.mjs";
+
+//#region src/registry.d.ts
+interface RegistryConfig {
+  /** Server port for default redirect URI construction */
+  port?: number;
+  /** Per-provider redirect URI overrides */
+  redirectUris?: Partial<Record<string, string>>;
+  /** Provider environment — 'sandbox' for dev/testing, 'production' for audited/live apps */
+  environment?: 'sandbox' | 'production';
+}
+interface ProviderRegistry {
+  /** Get a provider by platform name */
+  getProvider(name: string): PlatformProvider | null;
+  /** Get metadata for all registered providers */
+  getAllProviders(): ProviderMetadata[];
+  /** Check if a provider is registered */
+  hasProvider(name: string): boolean;
+  /** Get list of registered provider names */
+  getProviderNames(): string[];
+}
+/**
+ * Create a new provider registry with all 9 providers.
+ * Providers are dynamically imported in parallel for fast startup.
+ */
+declare function createRegistry(config?: RegistryConfig): Promise<ProviderRegistry>;
+//#endregion
+export { type AccountInfo, type AuthType, type AuthUrlOptions, type UnifiedPostInput as ClientPostInput, type CredentialField, type CredentialFieldType, FacebookClient, type FacebookClientConfig, FacebookProvider, type HttpRequestOptions, type HttpResponse, InstagramClient, type InstagramClientConfig, InstagramProvider, LinkedInClient, type LinkedInClientConfig, LinkedInProvider, type MessageInput, type MessageResult, type MessagingProvider, type MultiPostInput, type MultiPostResult, type MultiUploadInput, type OAuthTokens, type Page, type PaginatedIterable, PkceStore, PlatformProvider, type PollOptions, type PostResult, type PostingProvider, type PrivacyLevel, type ProviderAuth, type ProviderCapabilities, type ProviderConfig, type ProviderConfigMap, type ProviderEnvironment, type ProviderMetadata, type ProviderName, type ProviderRegistry, RedditClient, type RedditClientConfig, RedditProvider, type RegistryConfig, type RetryConfig, type SetupGuideStep, SocialClient, type SocialClientOptions, SocialError, type SocialErrorOptions, TelegramClient, type TelegramClientConfig, TelegramProvider, type TestResult, type TestStatus, TikTokClient, type TikTokClientConfig, TikTokProvider, TwitterClient, type TwitterClientConfig, TwitterProvider, type UnifiedMedia, type UnifiedPost, type UnifiedPostInput$1 as UnifiedPostInput, type UnifiedUploadInput, type UploadParams, type UploadResult, type UploadingProvider, type ValidationResult, WhatsAppClient, type WhatsAppClientConfig, WhatsAppProvider, YouTubeClient, type YouTubeClientConfig, YouTubeProvider, assertPublicHttpUrl, buildAuthUrl, createRegistry, deriveCredentialFields, fromEnv, generateCodeChallenge, generateCodeVerifier, httpRequest, isMessagingProvider, isPostingProvider, isUploadingProvider, metaExchangeLongLived, metaRefreshLongLivedFacebook, metaRefreshLongLivedInstagram, oauth2ExchangeCode, oauth2RefreshToken, paginate, pollUntilComplete, redactSecrets };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/registry.ts"],"mappings":";;;;;;;;;;;;;;;;UAgBiB,cAAA;;EAEf,IAAA;EAF6B;EAI7B,YAAA,GAAe,OAAA,CAAQ,MAAA;EAAD;EAEtB,WAAA;AAAA;AAAA,UAGe,gBAAA;EALQ;EAOvB,WAAA,CAAY,IAAA,WAAe,gBAAA;EALhB;EAOX,eAAA,IAAmB,gBAAA;EAJJ;EAMf,WAAA,CAAY,IAAA;;EAEZ,gBAAA;AAAA;;;;;iBASoB,cAAA,CAAe,MAAA,GAAQ,cAAA,GAAsB,OAAA,CAAQ,gBAAA"}

package/dist/index.mjs

@@ -0,0 +1,71 @@
+import { n as deriveCredentialFields, t as PlatformProvider } from "./base-Bw7e52V8.mjs";
+import { t as SocialError } from "./errors-Cm6LeKf7.mjs";
+import { i as metaRefreshLongLivedInstagram, n as metaExchangeLongLived, r as metaRefreshLongLivedFacebook } from "./meta-D3vcJU1c.mjs";
+import { t as httpRequest } from "./http-DpcLSR1M.mjs";
+import { n as generateCodeChallenge, r as generateCodeVerifier, t as PkceStore } from "./pkce-jq5II68b.mjs";
+import { a as redactSecrets, c as oauth2ExchangeCode, i as assertPublicHttpUrl, l as oauth2RefreshToken, n as isPostingProvider, o as paginate, r as isUploadingProvider, s as buildAuthUrl, t as isMessagingProvider } from "./contracts-lCa069IK.mjs";
+import { t as pollUntilComplete } from "./polling-DZ1apXtA.mjs";
+import { TwitterProvider } from "./providers/twitter.mjs";
+import { a as YouTubeClient, c as LinkedInClient, i as TikTokClient, l as FacebookClient, n as WhatsAppClient, o as InstagramClient, r as TelegramClient, s as RedditClient, t as fromEnv, u as TwitterClient } from "./env-Bl0cwwjC.mjs";
+import { FacebookProvider } from "./providers/facebook.mjs";
+import { LinkedInProvider } from "./providers/linkedin.mjs";
+import { RedditProvider } from "./providers/reddit.mjs";
+import { InstagramProvider } from "./providers/instagram.mjs";
+import { YouTubeProvider } from "./providers/youtube.mjs";
+import { TikTokProvider } from "./providers/tiktok.mjs";
+import { TelegramProvider } from "./providers/telegram.mjs";
+import { WhatsAppProvider } from "./providers/whatsapp.mjs";
+import { SocialClient } from "./client/index.mjs";
+
+//#region src/registry.ts
+/**
+* Create a new provider registry with all 9 providers.
+* Providers are dynamically imported in parallel for fast startup.
+*/
+async function createRegistry(config = {}) {
+	const providers = /* @__PURE__ */ new Map();
+	const [{ YouTubeProvider }, { TikTokProvider }, { InstagramProvider }, { WhatsAppProvider }, { TelegramProvider }, { LinkedInProvider }, { FacebookProvider }, { TwitterProvider }, { RedditProvider }] = await Promise.all([
+		import("./providers/youtube.mjs"),
+		import("./providers/tiktok.mjs"),
+		import("./providers/instagram.mjs"),
+		import("./providers/whatsapp.mjs"),
+		import("./providers/telegram.mjs"),
+		import("./providers/linkedin.mjs"),
+		import("./providers/facebook.mjs"),
+		import("./providers/twitter.mjs"),
+		import("./providers/reddit.mjs")
+	]);
+	const { port, redirectUris = {}, environment } = config;
+	const providerConfig = (name) => ({
+		port,
+		redirectUri: redirectUris[name],
+		environment
+	});
+	providers.set("youtube", new YouTubeProvider(providerConfig("youtube")));
+	providers.set("tiktok", new TikTokProvider(providerConfig("tiktok")));
+	providers.set("instagram", new InstagramProvider(providerConfig("instagram")));
+	providers.set("whatsapp", new WhatsAppProvider(providerConfig("whatsapp")));
+	providers.set("telegram", new TelegramProvider(providerConfig("telegram")));
+	providers.set("linkedin", new LinkedInProvider(providerConfig("linkedin")));
+	providers.set("facebook", new FacebookProvider(providerConfig("facebook")));
+	providers.set("twitter", new TwitterProvider(providerConfig("twitter")));
+	providers.set("reddit", new RedditProvider(providerConfig("reddit")));
+	return {
+		getProvider(name) {
+			return providers.get(name) ?? null;
+		},
+		getAllProviders() {
+			return Array.from(providers.values()).map((p) => p.getMetadata());
+		},
+		hasProvider(name) {
+			return providers.has(name);
+		},
+		getProviderNames() {
+			return Array.from(providers.keys());
+		}
+	};
+}
+
+//#endregion
+export { FacebookClient, FacebookProvider, InstagramClient, InstagramProvider, LinkedInClient, LinkedInProvider, PkceStore, PlatformProvider, RedditClient, RedditProvider, SocialClient, SocialError, TelegramClient, TelegramProvider, TikTokClient, TikTokProvider, TwitterClient, TwitterProvider, WhatsAppClient, WhatsAppProvider, YouTubeClient, YouTubeProvider, assertPublicHttpUrl, buildAuthUrl, createRegistry, deriveCredentialFields, fromEnv, generateCodeChallenge, generateCodeVerifier, httpRequest, isMessagingProvider, isPostingProvider, isUploadingProvider, metaExchangeLongLived, metaRefreshLongLivedFacebook, metaRefreshLongLivedInstagram, oauth2ExchangeCode, oauth2RefreshToken, paginate, pollUntilComplete, redactSecrets };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/registry.ts"],"sourcesContent":["/**\n * Provider Registry Factory\n * =========================\n * Creates a registry of social media provider instances.\n * Factory pattern (not module-level singleton) for testability.\n *\n * Usage:\n *   import { createRegistry } from '@classytic/social';\n *\n *   const registry = await createRegistry({ port: 8060 });\n *   const yt = registry.getProvider('youtube');\n *   await yt.uploadVideo({ ... });\n */\n\nimport type { PlatformProvider, ProviderConfig, ProviderMetadata } from './base.js';\n\nexport interface RegistryConfig {\n  /** Server port for default redirect URI construction */\n  port?: number;\n  /** Per-provider redirect URI overrides */\n  redirectUris?: Partial<Record<string, string>>;\n  /** Provider environment — 'sandbox' for dev/testing, 'production' for audited/live apps */\n  environment?: 'sandbox' | 'production';\n}\n\nexport interface ProviderRegistry {\n  /** Get a provider by platform name */\n  getProvider(name: string): PlatformProvider | null;\n  /** Get metadata for all registered providers */\n  getAllProviders(): ProviderMetadata[];\n  /** Check if a provider is registered */\n  hasProvider(name: string): boolean;\n  /** Get list of registered provider names */\n  getProviderNames(): string[];\n}\n\nconst PROVIDER_NAMES = ['youtube', 'tiktok', 'instagram', 'whatsapp', 'telegram', 'linkedin', 'facebook', 'twitter', 'reddit'] as const;\n\n/**\n * Create a new provider registry with all 9 providers.\n * Providers are dynamically imported in parallel for fast startup.\n */\nexport async function createRegistry(config: RegistryConfig = {}): Promise<ProviderRegistry> {\n  const providers = new Map<string, PlatformProvider>();\n\n  // Dynamic import all providers in parallel\n  const [\n    { YouTubeProvider },\n    { TikTokProvider },\n    { InstagramProvider },\n    { WhatsAppProvider },\n    { TelegramProvider },\n    { LinkedInProvider },\n    { FacebookProvider },\n    { TwitterProvider },\n    { RedditProvider },\n  ] = await Promise.all([\n    import('./providers/youtube/index.js'),\n    import('./providers/tiktok/index.js'),\n    import('./providers/instagram/index.js'),\n    import('./providers/whatsapp/index.js'),\n    import('./providers/telegram/index.js'),\n    import('./providers/linkedin/index.js'),\n    import('./providers/facebook/index.js'),\n    import('./providers/twitter/index.js'),\n    import('./providers/reddit/index.js'),\n  ]);\n\n  const { port, redirectUris = {}, environment } = config;\n\n  // Build per-provider config\n  const providerConfig = (name: string): ProviderConfig => ({\n    port,\n    redirectUri: redirectUris[name],\n    environment,\n  });\n\n  // Register all providers\n  providers.set('youtube', new YouTubeProvider(providerConfig('youtube')));\n  providers.set('tiktok', new TikTokProvider(providerConfig('tiktok')));\n  providers.set('instagram', new InstagramProvider(providerConfig('instagram')));\n  providers.set('whatsapp', new WhatsAppProvider(providerConfig('whatsapp')));\n  providers.set('telegram', new TelegramProvider(providerConfig('telegram')));\n  providers.set('linkedin', new LinkedInProvider(providerConfig('linkedin')));\n  providers.set('facebook', new FacebookProvider(providerConfig('facebook')));\n  providers.set('twitter', new TwitterProvider(providerConfig('twitter')));\n  providers.set('reddit', new RedditProvider(providerConfig('reddit')));\n\n  return {\n    getProvider(name: string): PlatformProvider | null {\n      return providers.get(name) ?? null;\n    },\n\n    getAllProviders(): ProviderMetadata[] {\n      return Array.from(providers.values()).map(p => p.getMetadata());\n    },\n\n    hasProvider(name: string): boolean {\n      return providers.has(name);\n    },\n\n    getProviderNames(): string[] {\n      return Array.from(providers.keys());\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AA0CA,eAAsB,eAAe,SAAyB,EAAE,EAA6B;CAC3F,MAAM,4BAAY,IAAI,KAA+B;CAGrD,MAAM,CACJ,EAAE,mBACF,EAAE,kBACF,EAAE,qBACF,EAAE,oBACF,EAAE,oBACF,EAAE,oBACF,EAAE,oBACF,EAAE,mBACF,EAAE,oBACA,MAAM,QAAQ,IAAI;EACpB,OAAO;EACP,OAAO;EACP,OAAO;EACP,OAAO;EACP,OAAO;EACP,OAAO;EACP,OAAO;EACP,OAAO;EACP,OAAO;EACR,CAAC;CAEF,MAAM,EAAE,MAAM,eAAe,EAAE,EAAE,gBAAgB;CAGjD,MAAM,kBAAkB,UAAkC;EACxD;EACA,aAAa,aAAa;EAC1B;EACD;AAGD,WAAU,IAAI,WAAW,IAAI,gBAAgB,eAAe,UAAU,CAAC,CAAC;AACxE,WAAU,IAAI,UAAU,IAAI,eAAe,eAAe,SAAS,CAAC,CAAC;AACrE,WAAU,IAAI,aAAa,IAAI,kBAAkB,eAAe,YAAY,CAAC,CAAC;AAC9E,WAAU,IAAI,YAAY,IAAI,iBAAiB,eAAe,WAAW,CAAC,CAAC;AAC3E,WAAU,IAAI,YAAY,IAAI,iBAAiB,eAAe,WAAW,CAAC,CAAC;AAC3E,WAAU,IAAI,YAAY,IAAI,iBAAiB,eAAe,WAAW,CAAC,CAAC;AAC3E,WAAU,IAAI,YAAY,IAAI,iBAAiB,eAAe,WAAW,CAAC,CAAC;AAC3E,WAAU,IAAI,WAAW,IAAI,gBAAgB,eAAe,UAAU,CAAC,CAAC;AACxE,WAAU,IAAI,UAAU,IAAI,eAAe,eAAe,SAAS,CAAC,CAAC;AAErE,QAAO;EACL,YAAY,MAAuC;AACjD,UAAO,UAAU,IAAI,KAAK,IAAI;;EAGhC,kBAAsC;AACpC,UAAO,MAAM,KAAK,UAAU,QAAQ,CAAC,CAAC,KAAI,MAAK,EAAE,aAAa,CAAC;;EAGjE,YAAY,MAAuB;AACjC,UAAO,UAAU,IAAI,KAAK;;EAG5B,mBAA6B;AAC3B,UAAO,MAAM,KAAK,UAAU,MAAM,CAAC;;EAEtC"}

package/dist/instagram-BGaeUFU2.mjs

@@ -0,0 +1,90 @@
+import { t as __exportAll } from "./chunk-DQk6qfdC.mjs";
+import { i as OAuthTokensSchema, r as NonEmptyString } from "./shared-Fvc6xQku.mjs";
+import { z } from "zod";
+
+//#region src/schemas/instagram.ts
+/**
+* Instagram zod v4 schemas.
+*/
+var instagram_exports = /* @__PURE__ */ __exportAll({
+	InstagramCarouselItemSchema: () => InstagramCarouselItemSchema,
+	InstagramCarouselUploadSchema: () => InstagramCarouselUploadSchema,
+	InstagramCredentialDataSchema: () => InstagramCredentialDataSchema,
+	InstagramCredentialsSchema: () => InstagramCredentialsSchema,
+	InstagramListMediaSchema: () => InstagramListMediaSchema,
+	InstagramPhotoUploadSchema: () => InstagramPhotoUploadSchema,
+	InstagramVideoUploadSchema: () => InstagramVideoUploadSchema,
+	instagramCapabilities: () => instagramCapabilities,
+	instagramInfo: () => instagramInfo
+});
+const InstagramCredentialsSchema = z.object({
+	appId: NonEmptyString.describe("Meta app ID"),
+	appSecret: NonEmptyString.describe("Meta app secret"),
+	redirectUri: z.url().optional()
+});
+const InstagramCredentialDataSchema = InstagramCredentialsSchema.extend({ oauthTokenData: z.union([z.string(), OAuthTokensSchema]).optional() });
+const InstagramVideoUploadSchema = z.object({
+	videoUrl: z.url().describe("Public URL of an MP4 video (≤100MB, ≤90s for Reels)"),
+	caption: z.string().max(2200).optional(),
+	thumbOffset: z.number().int().nonnegative().optional().describe("Thumbnail offset in milliseconds"),
+	shareToFeed: z.boolean().optional().default(true),
+	igUserId: z.string().optional()
+});
+const InstagramPhotoUploadSchema = z.object({
+	imageUrl: z.url().describe("Public URL of a JPEG image (≤8MB)"),
+	caption: z.string().max(2200).optional(),
+	igUserId: z.string().optional()
+});
+const InstagramCarouselItemSchema = z.object({
+	type: z.enum(["IMAGE", "VIDEO"]),
+	url: z.url()
+});
+const InstagramCarouselUploadSchema = z.object({
+	items: z.array(InstagramCarouselItemSchema).min(2).max(10),
+	caption: z.string().max(2200).optional(),
+	igUserId: z.string().optional()
+});
+const InstagramListMediaSchema = z.object({
+	limit: z.number().int().min(1).max(100).optional().default(25),
+	cursor: z.string().optional()
+});
+const instagramCapabilities = {
+	auth: "oauth2",
+	posting: true,
+	upload: true,
+	messaging: false,
+	scheduling: false,
+	deletion: false,
+	listing: true,
+	analytics: true,
+	environments: false,
+	pkce: false
+};
+const instagramInfo = {
+	name: "instagram",
+	displayName: "Instagram",
+	scopes: [
+		"business_management",
+		"instagram_basic",
+		"instagram_content_publish",
+		"pages_show_list",
+		"pages_read_engagement"
+	],
+	rateLimits: { per24h: 25 },
+	fileLimits: {
+		photo: { maxSizeBytes: 8 * 1024 * 1024 },
+		video: {
+			maxSizeBytes: 100 * 1024 * 1024,
+			maxDurationSec: 90
+		},
+		carousel: {
+			minItems: 2,
+			maxItems: 10
+		}
+	},
+	docsUrl: "https://developers.facebook.com/docs/instagram-api"
+};
+
+//#endregion
+export { instagram_exports as i, instagramCapabilities as n, instagramInfo as r, InstagramCredentialsSchema as t };
+//# sourceMappingURL=instagram-BGaeUFU2.mjs.map

package/dist/instagram-BGaeUFU2.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"instagram-BGaeUFU2.mjs","names":[],"sources":["../src/schemas/instagram.ts"],"sourcesContent":["/**\n * Instagram zod v4 schemas.\n */\n\nimport { z } from 'zod';\nimport type { ProviderCapabilities } from '../common/contracts.js';\nimport { NonEmptyString, OAuthTokensSchema } from './shared.js';\n\n// ─── Credentials ────────────────────────────────────────────────────────────\n\nexport const InstagramCredentialsSchema = z.object({\n  appId: NonEmptyString.describe('Meta app ID'),\n  appSecret: NonEmptyString.describe('Meta app secret'),\n  redirectUri: z.url().optional(),\n});\nexport type InstagramCredentialsInput = z.infer<typeof InstagramCredentialsSchema>;\n\nexport const InstagramCredentialDataSchema = InstagramCredentialsSchema.extend({\n  oauthTokenData: z.union([z.string(), OAuthTokensSchema]).optional(),\n});\n\n// ─── Upload params ──────────────────────────────────────────────────────────\n\nexport const InstagramVideoUploadSchema = z.object({\n  videoUrl: z.url().describe('Public URL of an MP4 video (≤100MB, ≤90s for Reels)'),\n  caption: z.string().max(2200).optional(),\n  thumbOffset: z.number().int().nonnegative().optional().describe('Thumbnail offset in milliseconds'),\n  shareToFeed: z.boolean().optional().default(true),\n  igUserId: z.string().optional(),\n});\n\nexport const InstagramPhotoUploadSchema = z.object({\n  imageUrl: z.url().describe('Public URL of a JPEG image (≤8MB)'),\n  caption: z.string().max(2200).optional(),\n  igUserId: z.string().optional(),\n});\n\nexport const InstagramCarouselItemSchema = z.object({\n  type: z.enum(['IMAGE', 'VIDEO']),\n  url: z.url(),\n});\n\nexport const InstagramCarouselUploadSchema = z.object({\n  items: z.array(InstagramCarouselItemSchema).min(2).max(10),\n  caption: z.string().max(2200).optional(),\n  igUserId: z.string().optional(),\n});\n\n// ─── List options ───────────────────────────────────────────────────────────\n\nexport const InstagramListMediaSchema = z.object({\n  limit: z.number().int().min(1).max(100).optional().default(25),\n  cursor: z.string().optional(),\n});\n\n// ─── Capabilities ───────────────────────────────────────────────────────────\n\nexport const instagramCapabilities: ProviderCapabilities = {\n  auth: 'oauth2',\n  posting: true,\n  upload: true,\n  messaging: false,\n  scheduling: false,\n  deletion: false,\n  listing: true,\n  analytics: true,\n  environments: false,\n  pkce: false,\n};\n\nexport const instagramInfo = {\n  name: 'instagram' as const,\n  displayName: 'Instagram',\n  scopes: [\n    'business_management',\n    'instagram_basic',\n    'instagram_content_publish',\n    'pages_show_list',\n    'pages_read_engagement',\n  ],\n  rateLimits: { per24h: 25 },\n  fileLimits: {\n    photo: { maxSizeBytes: 8 * 1024 * 1024 },\n    video: { maxSizeBytes: 100 * 1024 * 1024, maxDurationSec: 90 },\n    carousel: { minItems: 2, maxItems: 10 },\n  },\n  docsUrl: 'https://developers.facebook.com/docs/instagram-api',\n} as const;\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAUA,MAAa,6BAA6B,EAAE,OAAO;CACjD,OAAO,eAAe,SAAS,cAAc;CAC7C,WAAW,eAAe,SAAS,kBAAkB;CACrD,aAAa,EAAE,KAAK,CAAC,UAAU;CAChC,CAAC;AAGF,MAAa,gCAAgC,2BAA2B,OAAO,EAC7E,gBAAgB,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CAAC,UAAU,EACpE,CAAC;AAIF,MAAa,6BAA6B,EAAE,OAAO;CACjD,UAAU,EAAE,KAAK,CAAC,SAAS,sDAAsD;CACjF,SAAS,EAAE,QAAQ,CAAC,IAAI,KAAK,CAAC,UAAU;CACxC,aAAa,EAAE,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC,UAAU,CAAC,SAAS,mCAAmC;CACnG,aAAa,EAAE,SAAS,CAAC,UAAU,CAAC,QAAQ,KAAK;CACjD,UAAU,EAAE,QAAQ,CAAC,UAAU;CAChC,CAAC;AAEF,MAAa,6BAA6B,EAAE,OAAO;CACjD,UAAU,EAAE,KAAK,CAAC,SAAS,oCAAoC;CAC/D,SAAS,EAAE,QAAQ,CAAC,IAAI,KAAK,CAAC,UAAU;CACxC,UAAU,EAAE,QAAQ,CAAC,UAAU;CAChC,CAAC;AAEF,MAAa,8BAA8B,EAAE,OAAO;CAClD,MAAM,EAAE,KAAK,CAAC,SAAS,QAAQ,CAAC;CAChC,KAAK,EAAE,KAAK;CACb,CAAC;AAEF,MAAa,gCAAgC,EAAE,OAAO;CACpD,OAAO,EAAE,MAAM,4BAA4B,CAAC,IAAI,EAAE,CAAC,IAAI,GAAG;CAC1D,SAAS,EAAE,QAAQ,CAAC,IAAI,KAAK,CAAC,UAAU;CACxC,UAAU,EAAE,QAAQ,CAAC,UAAU;CAChC,CAAC;AAIF,MAAa,2BAA2B,EAAE,OAAO;CAC/C,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,GAAG;CAC9D,QAAQ,EAAE,QAAQ,CAAC,UAAU;CAC9B,CAAC;AAIF,MAAa,wBAA8C;CACzD,MAAM;CACN,SAAS;CACT,QAAQ;CACR,WAAW;CACX,YAAY;CACZ,UAAU;CACV,SAAS;CACT,WAAW;CACX,cAAc;CACd,MAAM;CACP;AAED,MAAa,gBAAgB;CAC3B,MAAM;CACN,aAAa;CACb,QAAQ;EACN;EACA;EACA;EACA;EACA;EACD;CACD,YAAY,EAAE,QAAQ,IAAI;CAC1B,YAAY;EACV,OAAO,EAAE,cAAc,IAAI,OAAO,MAAM;EACxC,OAAO;GAAE,cAAc,MAAM,OAAO;GAAM,gBAAgB;GAAI;EAC9D,UAAU;GAAE,UAAU;GAAG,UAAU;GAAI;EACxC;CACD,SAAS;CACV"}