@classytic/social 0.1.0

package/dist/base-Bw7e52V8.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-Bw7e52V8.mjs","names":[],"sources":["../src/base.ts"],"sourcesContent":["/**\n * Platform Provider Base Class\n * =============================\n * Abstract base class for social media platform integrations.\n *\n * All platform providers (YouTube, TikTok, Instagram, etc.) must extend this class\n * and implement the required methods.\n */\n\nimport type { z } from 'zod';\n\n// ---------------------------------------------------------------------------\n// Credential Schema (for UI form rendering)\n// ---------------------------------------------------------------------------\n\nexport type CredentialFieldType = 'text' | 'password' | 'url' | 'select' | 'textarea';\n\nexport interface CredentialField {\n  name: string;\n  displayName: string;\n  type: CredentialFieldType;\n  required: boolean;\n  placeholder?: string;\n  description?: string;\n  options?: { label: string; value: string }[];\n}\n\n// ---------------------------------------------------------------------------\n// Auth\n// ---------------------------------------------------------------------------\n\nexport interface AuthUrlOptions {\n  /** Per-request environment override (affects scopes for providers that support it) */\n  environment?: 'sandbox' | 'production';\n}\n\nexport type AuthType = 'oauth2' | 'token' | 'api_key';\n\n// ---------------------------------------------------------------------------\n// Provider Metadata\n// ---------------------------------------------------------------------------\n\nexport interface SetupGuideStep {\n  step: number;\n  title: string;\n  description: string;\n}\n\nexport interface ProviderMetadata {\n  name: string;\n  displayName: string;\n  authType: string;\n  icon: string;\n  brandColor: string | null;\n  description: string;\n  scopes: string[];\n  scopeDescriptions: Record<string, string>;\n  setupGuide: SetupGuideStep[];\n  supportsScheduling: boolean;\n  /** Whether this provider supports sandbox/production environment modes */\n  supportsEnvironment: boolean;\n  redirectUriPattern: string | null;\n  credentialSchema: CredentialField[];\n}\n\n// ---------------------------------------------------------------------------\n// Account Info\n// ---------------------------------------------------------------------------\n\nexport interface AccountInfo {\n  id: string;\n  name: string;\n  email?: string;\n  profileImage?: string | null;\n  /** Platform-specific extra fields (username, bio, etc.) */\n  [key: string]: unknown;\n}\n\n// ---------------------------------------------------------------------------\n// OAuth Tokens\n// ---------------------------------------------------------------------------\n\nexport interface OAuthTokens {\n  access_token: string;\n  refresh_token?: string;\n  expires_in?: number;\n  token_type?: string;\n  scope?: string;\n  /** Platform-specific extra token fields (open_id, refresh_token_expires_in, etc.) */\n  [key: string]: unknown;\n}\n\n// ---------------------------------------------------------------------------\n// Upload (base contracts — providers extend these)\n// ---------------------------------------------------------------------------\n\nexport type PrivacyLevel = 'public' | 'private' | 'unlisted';\n\nexport interface UploadParams {\n  filePath?: string;\n  videoUrl?: string;\n  title?: string;\n  description?: string;\n  caption?: string;\n  tags?: string[];\n  privacy?: PrivacyLevel;\n  categoryId?: string;\n  credentials: Record<string, string>;\n  tokens: OAuthTokens;\n  scheduledAt?: string | Date;\n  onProgress?: (progress: number) => void;\n}\n\nexport interface UploadResult {\n  platformVideoId?: string;\n  platformPostId?: string;\n  platformUrl?: string | null;\n  status: string;\n  scheduledAt?: string | Date | null;\n  uploadedAt?: Date;\n  metadata?: Record<string, unknown>;\n}\n\n// ---------------------------------------------------------------------------\n// Validation & Testing\n// ---------------------------------------------------------------------------\n\nexport interface ValidationResult {\n  valid: boolean;\n  errors: string[];\n}\n\nexport type TestStatus = 'OK' | 'Error' | 'Pending' | 'Warning';\n\nexport interface TestResult {\n  status: TestStatus;\n  message?: string;\n  data?: Record<string, unknown>;\n  authUrl?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Provider Config\n// ---------------------------------------------------------------------------\n\nexport type ProviderEnvironment = 'sandbox' | 'production';\n\nexport interface ProviderConfig {\n  port?: number;\n  redirectUri?: string;\n  /** Provider environment — controls scope selection and API behavior */\n  environment?: ProviderEnvironment;\n}\n\nexport class PlatformProvider {\n  public name: string;\n  public displayName: string;\n  public config: ProviderConfig;\n  public authType: string;\n\n  constructor(config: ProviderConfig = {}) {\n    this.name = '';\n    this.displayName = '';\n    this.config = config;\n    this.authType = 'oauth2'; // 'oauth2' | 'api_key' | 'token'\n  }\n\n  /**\n   * Get OAuth authorization URL\n   * @param state - State parameter for CSRF protection\n   * @param credData - Decrypted credential data (client ID, redirect URI, etc.)\n   * @returns Authorization URL\n   */\n  getAuthUrl(state: string, credData?: Record<string, any>, options?: AuthUrlOptions): string {\n    throw new Error(`${this.name}: getAuthUrl() not implemented`);\n  }\n\n  /**\n   * Exchange authorization code for access token\n   * @param code - Authorization code from OAuth callback\n   * @param credData - Decrypted credential data\n   * @returns Token data { access_token, refresh_token, expires_in, ... }\n   */\n  async exchangeCode(code: string, credData?: Record<string, any>, state?: string): Promise<OAuthTokens> {\n    throw new Error(`${this.name}: exchangeCode() not implemented`);\n  }\n\n  /**\n   * Refresh access token using refresh token\n   * @param refreshToken - Refresh token\n   * @param credData - Decrypted credential data\n   * @returns New token data\n   */\n  async refreshToken(refreshToken: string, credData?: Record<string, any>): Promise<OAuthTokens> {\n    throw new Error(`${this.name}: refreshToken() not implemented`);\n  }\n\n  /**\n   * Get account information using access token\n   * @param accessToken - Access token\n   * @param credData - Decrypted credential data\n   * @returns Account info { id, name, email, profileImage, ... }\n   */\n  async getAccountInfo(accessToken: string, credData?: Record<string, any>): Promise<AccountInfo> {\n    throw new Error(`${this.name}: getAccountInfo() not implemented`);\n  }\n\n  /**\n   * Revoke an OAuth access token. Forces the provider to show a fresh consent\n   * screen on next authorization (ensures newly enabled scopes are granted).\n   * Default: no-op. Override in providers that support token revocation.\n   */\n  async revokeToken(accessToken: string, credData?: Record<string, any>): Promise<void> {\n    // No-op by default — not all providers support revocation\n  }\n\n  /**\n   * Test credential validity\n   * @param credentialData - Decrypted credential data\n   * @returns Test result { status: 'OK' | 'Error', message, ... }\n   */\n  async testCredential(credentialData: Record<string, any>): Promise<TestResult> {\n    throw new Error(`${this.name}: testCredential() not implemented`);\n  }\n\n  /**\n   * Upload video to platform.\n   * Each provider defines its own parameter type — the base accepts any shape.\n   * @param params - Platform-specific upload parameters\n   * @returns Upload result\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  async uploadVideo(params: any): Promise<UploadResult> {\n    throw new Error(`${this.name}: uploadVideo() not implemented`);\n  }\n\n  /**\n   * Upload photo(s) to platform.\n   * Each provider defines its own parameter type.\n   * @param params - Platform-specific upload parameters\n   * @returns Upload result\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  async uploadPhoto(params: any): Promise<UploadResult> {\n    throw new Error(`${this.name}: uploadPhoto() not implemented`);\n  }\n\n  /**\n   * Upload carousel (multi-media) post.\n   * Each provider defines its own parameter type.\n   * @param params - Platform-specific carousel parameters\n   * @returns Upload result\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  async uploadCarousel(params: any): Promise<UploadResult> {\n    throw new Error(`${this.name}: uploadCarousel() not implemented`);\n  }\n\n  /**\n   * Send a message via the platform (Telegram, WhatsApp)\n   * @param args - Platform-specific arguments\n   */\n  async sendMessage(...args: unknown[]): Promise<unknown> {\n    throw new Error(`${this.name}: sendMessage() not implemented`);\n  }\n\n  /**\n   * Delete/unpublish a post from the platform\n   * @param args - Platform-specific arguments (token, postId, etc.)\n   */\n  async deletePost(...args: unknown[]): Promise<unknown> {\n    throw new Error(`${this.name}: deletePost() not implemented`);\n  }\n\n  /**\n   * Delete a message (Telegram-specific)\n   * @param botToken - Bot token\n   * @param chatId - Chat ID\n   * @param messageId - Message ID\n   */\n  async deleteMessage(botToken: string, chatId: string | number, messageId: string | number): Promise<unknown> {\n    throw new Error(`${this.name}: deleteMessage() not implemented`);\n  }\n\n  /**\n   * Get credential schema for UI form rendering.\n   *\n   * Default implementation derives fields from the zod schema returned by\n   * `getCredentialZodSchema()`. Providers may override either method —\n   * overriding `getCredentialZodSchema()` is preferred so consumers also get\n   * runtime validation, JSON Schema generation, and TypeScript inference.\n   */\n  getCredentialSchema(): CredentialField[] {\n    const zodSchema = this.getCredentialZodSchema();\n    if (!zodSchema) return [];\n    return deriveCredentialFields(zodSchema);\n  }\n\n  /**\n   * Return the zod schema for this provider's credentials. Providers should\n   * override this to enable runtime validation and form schema derivation.\n   *\n   * @returns A zod object schema, or `null` if the provider doesn't expose\n   *   credentials via this interface yet.\n   */\n  getCredentialZodSchema(): z.ZodType | null {\n    return null;\n  }\n\n  /**\n   * Get provider metadata for frontend display and dynamic form rendering.\n   * Subclasses should override to provide platform-specific details.\n   *\n   * @returns Provider metadata\n   */\n  getMetadata(): ProviderMetadata {\n    return {\n      name: this.name,\n      displayName: this.displayName,\n      authType: this.authType,\n      icon: this.name,\n      brandColor: null,\n      description: '',\n      scopes: [],\n      scopeDescriptions: {},\n      setupGuide: [],\n      supportsScheduling: false,\n      supportsEnvironment: false,\n      redirectUriPattern: `/api/oauth/${this.name}/callback`,\n      credentialSchema: this.getCredentialSchema(),\n    };\n  }\n\n  /**\n   * Validate credential data using the provider's zod schema if available,\n   * falling back to a presence check on the UI schema.\n   */\n  validateCredentials(data: Record<string, any>): ValidationResult {\n    const zodSchema = this.getCredentialZodSchema();\n    if (zodSchema) {\n      const result = zodSchema.safeParse(data);\n      if (result.success) return { valid: true, errors: [] };\n      return {\n        valid: false,\n        errors: result.error.issues.map(issue => {\n          const path = issue.path.length ? issue.path.join('.') + ': ' : '';\n          return `${path}${issue.message}`;\n        }),\n      };\n    }\n\n    const schema = this.getCredentialSchema();\n    const errors: string[] = [];\n    for (const field of schema) {\n      if (field.required && !data[field.name]) {\n        errors.push(`${field.displayName || field.name} is required`);\n      }\n    }\n    return { valid: errors.length === 0, errors };\n  }\n}\n\n// ─── Helpers ────────────────────────────────────────────────────────────────\n\nconst SECRET_NAME = /token|secret|password|key|credential/i;\n\n/**\n * Derive UI form fields from a zod object schema. Heuristics:\n * - secret-named fields → `password`\n * - z.url() → `url`\n * - z.enum([...]) → `select`\n * - everything else → `text`\n */\nexport function deriveCredentialFields(schema: z.ZodType): CredentialField[] {\n  // Defensively unwrap to a ZodObject. Non-objects yield an empty list.\n  const def = (schema as { def?: { type?: string; shape?: Record<string, z.ZodType> } }).def;\n  if (!def || def.type !== 'object' || !def.shape) return [];\n  const out: CredentialField[] = [];\n  for (const [name, fieldSchema] of Object.entries(def.shape)) {\n    const inner = unwrap(fieldSchema);\n    const innerDef = (inner as { def?: { type?: string; format?: string; entries?: Record<string, string> } }).def;\n    let type: CredentialField['type'] = 'text';\n    let options: CredentialField['options'];\n\n    if (SECRET_NAME.test(name)) {\n      type = 'password';\n    } else if (innerDef?.type === 'url' || innerDef?.format === 'url') {\n      type = 'url';\n    } else if (innerDef?.type === 'enum' && innerDef.entries) {\n      type = 'select';\n      options = Object.values(innerDef.entries).map(v => ({ label: String(v), value: String(v) }));\n    }\n\n    out.push({\n      name,\n      displayName: humanize(name),\n      type,\n      required: !isOptional(fieldSchema),\n      description: (fieldSchema as { description?: string }).description,\n      options,\n    });\n  }\n  return out;\n}\n\nfunction unwrap(t: z.ZodType): z.ZodType {\n  let cur: z.ZodType = t;\n  for (let i = 0; i < 8; i++) {\n    const def = (cur as { def?: { type?: string; innerType?: z.ZodType } }).def;\n    if (!def?.innerType) return cur;\n    if (def.type === 'optional' || def.type === 'nullable' || def.type === 'default') {\n      cur = def.innerType;\n      continue;\n    }\n    return cur;\n  }\n  return cur;\n}\n\nfunction isOptional(t: z.ZodType): boolean {\n  const def = (t as { def?: { type?: string } }).def;\n  return def?.type === 'optional' || def?.type === 'default' || def?.type === 'nullable';\n}\n\nfunction humanize(name: string): string {\n  return name\n    .replace(/([A-Z])/g, ' $1')\n    .replace(/^./, c => c.toUpperCase())\n    .replace(/\\bId\\b/g, 'ID')\n    .replace(/\\bUrl\\b/g, 'URL')\n    .trim();\n}\n"],"mappings":"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"}

package/dist/base-DBtKFiSX.d.mts

@@ -0,0 +1,226 @@
+import { z } from "zod";
+
+//#region src/base.d.ts
+type CredentialFieldType = 'text' | 'password' | 'url' | 'select' | 'textarea';
+interface CredentialField {
+  name: string;
+  displayName: string;
+  type: CredentialFieldType;
+  required: boolean;
+  placeholder?: string;
+  description?: string;
+  options?: {
+    label: string;
+    value: string;
+  }[];
+}
+interface AuthUrlOptions {
+  /** Per-request environment override (affects scopes for providers that support it) */
+  environment?: 'sandbox' | 'production';
+}
+type AuthType = 'oauth2' | 'token' | 'api_key';
+interface SetupGuideStep {
+  step: number;
+  title: string;
+  description: string;
+}
+interface ProviderMetadata {
+  name: string;
+  displayName: string;
+  authType: string;
+  icon: string;
+  brandColor: string | null;
+  description: string;
+  scopes: string[];
+  scopeDescriptions: Record<string, string>;
+  setupGuide: SetupGuideStep[];
+  supportsScheduling: boolean;
+  /** Whether this provider supports sandbox/production environment modes */
+  supportsEnvironment: boolean;
+  redirectUriPattern: string | null;
+  credentialSchema: CredentialField[];
+}
+interface AccountInfo {
+  id: string;
+  name: string;
+  email?: string;
+  profileImage?: string | null;
+  /** Platform-specific extra fields (username, bio, etc.) */
+  [key: string]: unknown;
+}
+interface OAuthTokens {
+  access_token: string;
+  refresh_token?: string;
+  expires_in?: number;
+  token_type?: string;
+  scope?: string;
+  /** Platform-specific extra token fields (open_id, refresh_token_expires_in, etc.) */
+  [key: string]: unknown;
+}
+type PrivacyLevel = 'public' | 'private' | 'unlisted';
+interface UploadParams {
+  filePath?: string;
+  videoUrl?: string;
+  title?: string;
+  description?: string;
+  caption?: string;
+  tags?: string[];
+  privacy?: PrivacyLevel;
+  categoryId?: string;
+  credentials: Record<string, string>;
+  tokens: OAuthTokens;
+  scheduledAt?: string | Date;
+  onProgress?: (progress: number) => void;
+}
+interface UploadResult {
+  platformVideoId?: string;
+  platformPostId?: string;
+  platformUrl?: string | null;
+  status: string;
+  scheduledAt?: string | Date | null;
+  uploadedAt?: Date;
+  metadata?: Record<string, unknown>;
+}
+interface ValidationResult {
+  valid: boolean;
+  errors: string[];
+}
+type TestStatus = 'OK' | 'Error' | 'Pending' | 'Warning';
+interface TestResult {
+  status: TestStatus;
+  message?: string;
+  data?: Record<string, unknown>;
+  authUrl?: string;
+}
+type ProviderEnvironment = 'sandbox' | 'production';
+interface ProviderConfig {
+  port?: number;
+  redirectUri?: string;
+  /** Provider environment — controls scope selection and API behavior */
+  environment?: ProviderEnvironment;
+}
+declare class PlatformProvider {
+  name: string;
+  displayName: string;
+  config: ProviderConfig;
+  authType: string;
+  constructor(config?: ProviderConfig);
+  /**
+   * Get OAuth authorization URL
+   * @param state - State parameter for CSRF protection
+   * @param credData - Decrypted credential data (client ID, redirect URI, etc.)
+   * @returns Authorization URL
+   */
+  getAuthUrl(state: string, credData?: Record<string, any>, options?: AuthUrlOptions): string;
+  /**
+   * Exchange authorization code for access token
+   * @param code - Authorization code from OAuth callback
+   * @param credData - Decrypted credential data
+   * @returns Token data { access_token, refresh_token, expires_in, ... }
+   */
+  exchangeCode(code: string, credData?: Record<string, any>, state?: string): Promise<OAuthTokens>;
+  /**
+   * Refresh access token using refresh token
+   * @param refreshToken - Refresh token
+   * @param credData - Decrypted credential data
+   * @returns New token data
+   */
+  refreshToken(refreshToken: string, credData?: Record<string, any>): Promise<OAuthTokens>;
+  /**
+   * Get account information using access token
+   * @param accessToken - Access token
+   * @param credData - Decrypted credential data
+   * @returns Account info { id, name, email, profileImage, ... }
+   */
+  getAccountInfo(accessToken: string, credData?: Record<string, any>): Promise<AccountInfo>;
+  /**
+   * Revoke an OAuth access token. Forces the provider to show a fresh consent
+   * screen on next authorization (ensures newly enabled scopes are granted).
+   * Default: no-op. Override in providers that support token revocation.
+   */
+  revokeToken(accessToken: string, credData?: Record<string, any>): Promise<void>;
+  /**
+   * Test credential validity
+   * @param credentialData - Decrypted credential data
+   * @returns Test result { status: 'OK' | 'Error', message, ... }
+   */
+  testCredential(credentialData: Record<string, any>): Promise<TestResult>;
+  /**
+   * Upload video to platform.
+   * Each provider defines its own parameter type — the base accepts any shape.
+   * @param params - Platform-specific upload parameters
+   * @returns Upload result
+   */
+  uploadVideo(params: any): Promise<UploadResult>;
+  /**
+   * Upload photo(s) to platform.
+   * Each provider defines its own parameter type.
+   * @param params - Platform-specific upload parameters
+   * @returns Upload result
+   */
+  uploadPhoto(params: any): Promise<UploadResult>;
+  /**
+   * Upload carousel (multi-media) post.
+   * Each provider defines its own parameter type.
+   * @param params - Platform-specific carousel parameters
+   * @returns Upload result
+   */
+  uploadCarousel(params: any): Promise<UploadResult>;
+  /**
+   * Send a message via the platform (Telegram, WhatsApp)
+   * @param args - Platform-specific arguments
+   */
+  sendMessage(...args: unknown[]): Promise<unknown>;
+  /**
+   * Delete/unpublish a post from the platform
+   * @param args - Platform-specific arguments (token, postId, etc.)
+   */
+  deletePost(...args: unknown[]): Promise<unknown>;
+  /**
+   * Delete a message (Telegram-specific)
+   * @param botToken - Bot token
+   * @param chatId - Chat ID
+   * @param messageId - Message ID
+   */
+  deleteMessage(botToken: string, chatId: string | number, messageId: string | number): Promise<unknown>;
+  /**
+   * Get credential schema for UI form rendering.
+   *
+   * Default implementation derives fields from the zod schema returned by
+   * `getCredentialZodSchema()`. Providers may override either method —
+   * overriding `getCredentialZodSchema()` is preferred so consumers also get
+   * runtime validation, JSON Schema generation, and TypeScript inference.
+   */
+  getCredentialSchema(): CredentialField[];
+  /**
+   * Return the zod schema for this provider's credentials. Providers should
+   * override this to enable runtime validation and form schema derivation.
+   *
+   * @returns A zod object schema, or `null` if the provider doesn't expose
+   *   credentials via this interface yet.
+   */
+  getCredentialZodSchema(): z.ZodType | null;
+  /**
+   * Get provider metadata for frontend display and dynamic form rendering.
+   * Subclasses should override to provide platform-specific details.
+   *
+   * @returns Provider metadata
+   */
+  getMetadata(): ProviderMetadata;
+  /**
+   * Validate credential data using the provider's zod schema if available,
+   * falling back to a presence check on the UI schema.
+   */
+  validateCredentials(data: Record<string, any>): ValidationResult;
+}
+/**
+ * Derive UI form fields from a zod object schema. Heuristics:
+ * - secret-named fields → `password`
+ * - z.url() → `url`
+ * - z.enum([...]) → `select`
+ * - everything else → `text`
+ */
+declare function deriveCredentialFields(schema: z.ZodType): CredentialField[];
+//#endregion
+export { ValidationResult as _, CredentialFieldType as a, PrivacyLevel as c, ProviderMetadata as d, SetupGuideStep as f, UploadResult as g, UploadParams as h, CredentialField as i, ProviderConfig as l, TestStatus as m, AuthType as n, OAuthTokens as o, TestResult as p, AuthUrlOptions as r, PlatformProvider as s, AccountInfo as t, ProviderEnvironment as u, deriveCredentialFields as v };
+//# sourceMappingURL=base-DBtKFiSX.d.mts.map

package/dist/base-DBtKFiSX.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-DBtKFiSX.d.mts","names":[],"sources":["../src/base.ts"],"mappings":";;;KAeY,mBAAA;AAAA,UAEK,eAAA;EACf,IAAA;EACA,WAAA;EACA,IAAA,EAAM,mBAAA;EACN,QAAA;EACA,WAAA;EACA,WAAA;EACA,OAAA;IAAY,KAAA;IAAe,KAAA;EAAA;AAAA;AAAA,UAOZ,cAAA;EAPiB;EAShC,WAAA;AAAA;AAAA,KAGU,QAAA;AAAA,UAMK,cAAA;EACf,IAAA;EACA,KAAA;EACA,WAAA;AAAA;AAAA,UAGe,gBAAA;EACf,IAAA;EACA,WAAA;EACA,QAAA;EACA,IAAA;EACA,UAAA;EACA,WAAA;EACA,MAAA;EACA,iBAAA,EAAmB,MAAA;EACnB,UAAA,EAAY,cAAA;EACZ,kBAAA;EAVe;EAYf,mBAAA;EACA,kBAAA;EACA,gBAAA,EAAkB,eAAA;AAAA;AAAA,UAOH,WAAA;EACf,EAAA;EACA,IAAA;EACA,KAAA;EACA,YAAA;EAtBA;EAAA,CAwBC,GAAA;AAAA;AAAA,UAOc,WAAA;EACf,YAAA;EACA,aAAA;EACA,UAAA;EACA,UAAA;EACA,KAAA;EA7BA;EAAA,CA+BC,GAAA;AAAA;AAAA,KAOS,YAAA;AAAA,UAEK,YAAA;EACf,QAAA;EACA,QAAA;EACA,KAAA;EACA,WAAA;EACA,OAAA;EACA,IAAA;EACA,OAAA,GAAU,YAAA;EACV,UAAA;EACA,WAAA,EAAa,MAAA;EACb,MAAA,EAAQ,WAAA;EACR,WAAA,YAAuB,IAAA;EACvB,UAAA,IAAc,QAAA;AAAA;AAAA,UAGC,YAAA;EACf,eAAA;EACA,cAAA;EACA,WAAA;EACA,MAAA;EACA,WAAA,YAAuB,IAAA;EACvB,UAAA,GAAa,IAAA;EACb,QAAA,GAAW,MAAA;AAAA;AAAA,UAOI,gBAAA;EACf,KAAA;EACA,MAAA;AAAA;AAAA,KAGU,UAAA;AAAA,UAEK,UAAA;EACf,MAAA,EAAQ,UAAA;EACR,OAAA;EACA,IAAA,GAAO,MAAA;EACP,OAAA;AAAA;AAAA,KAOU,mBAAA;AAAA,UAEK,cAAA;EACf,IAAA;EACA,WAAA;EAxC2B;EA0C3B,WAAA,GAAc,mBAAA;AAAA;AAAA,cAGH,gBAAA;EACJ,IAAA;EACA,WAAA;EACA,MAAA,EAAQ,cAAA;EACR,QAAA;cAEK,MAAA,GAAQ,cAAA;EAvDV;;;;;;EAoEV,UAAA,CAAW,KAAA,UAAe,QAAA,GAAW,MAAA,eAAqB,OAAA,GAAU,cAAA;EAhE7C;;;;;AAIzB;EAsEQ,YAAA,CAAa,IAAA,UAAc,QAAA,GAAW,MAAA,eAAqB,KAAA,YAAiB,OAAA,CAAQ,WAAA;;;;;;;EAUpF,YAAA,CAAa,YAAA,UAAsB,QAAA,GAAW,MAAA,gBAAsB,OAAA,CAAQ,WAAA;EA9ElF;;;;;;EAwFM,cAAA,CAAe,WAAA,UAAqB,QAAA,GAAW,MAAA,gBAAsB,OAAA,CAAQ,WAAA;EAnFnF;;;;AAOF;EAqFQ,WAAA,CAAY,WAAA,UAAqB,QAAA,GAAW,MAAA,gBAAsB,OAAA;;;;AAhF1E;;EAyFQ,cAAA,CAAe,cAAA,EAAgB,MAAA,gBAAsB,OAAA,CAAQ,UAAA;EAzF/C;;AAEtB;;;;EAkGQ,WAAA,CAAY,MAAA,QAAc,OAAA,CAAQ,YAAA;EAjGhC;;;;;;EA4GF,WAAA,CAAY,MAAA,QAAc,OAAA,CAAQ,YAAA;EAlG9B;;;;;AAEZ;EA2GQ,cAAA,CAAe,MAAA,QAAc,OAAA,CAAQ,YAAA;;;;;EAQrC,WAAA,CAAA,GAAe,IAAA,cAAkB,OAAA;EA/GzB;;;AAGhB;EAoHQ,UAAA,CAAA,GAAc,IAAA,cAAkB,OAAA;;;;;;;EAUhC,aAAA,CAAc,QAAA,UAAkB,MAAA,mBAAyB,SAAA,oBAA6B,OAAA;EAjGV;;;;;;;;EA6GlF,mBAAA,CAAA,GAAuB,eAAA;EAvEc;;;;;;;EAoFrC,sBAAA,CAAA,GAA0B,CAAA,CAAE,OAAA;EAnDO;;;;;;EA6DnC,WAAA,CAAA,GAAe,gBAAA;EAsBW;;;;EAA1B,mBAAA,CAAoB,IAAA,EAAM,MAAA,gBAAsB,gBAAA;AAAA;;;;;;;;iBAoClC,sBAAA,CAAuB,MAAA,EAAQ,CAAA,CAAE,OAAA,GAAU,eAAA"}

package/dist/chunk-DQk6qfdC.mjs

@@ -0,0 +1,18 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) {
+		__defProp(target, name, {
+			get: all[name],
+			enumerable: true
+		});
+	}
+	if (!no_symbols) {
+		__defProp(target, Symbol.toStringTag, { value: "Module" });
+	}
+	return target;
+};
+
+//#endregion
+export { __exportAll as t };

package/dist/client/index.d.mts

@@ -0,0 +1,44 @@
+import { A as WhatsAppClientConfig, C as SocialClientOptions, D as UnifiedMedia, 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 { a as ProviderCapabilities } from "../contracts-Cdwa4zlg.mjs";
+
+//#region src/client/index.d.ts
+declare class SocialClient {
+  readonly youtube?: YouTubeClient;
+  readonly twitter?: TwitterClient;
+  readonly facebook?: FacebookClient;
+  readonly instagram?: InstagramClient;
+  readonly linkedin?: LinkedInClient;
+  readonly reddit?: RedditClient;
+  readonly tiktok?: TikTokClient;
+  readonly telegram?: TelegramClient;
+  readonly whatsapp?: WhatsAppClient;
+  constructor(config: ProviderConfigMap, opts?: SocialClientOptions);
+  /** Convenience factory — equivalent to `new SocialClient(...)`. */
+  static create(config: ProviderConfigMap, opts?: SocialClientOptions): SocialClient;
+  /** Names of platforms with credentials configured. */
+  enabledPlatforms(): ProviderName[];
+  /** Capability metadata for a platform. */
+  capabilities(platform: ProviderName): ProviderCapabilities | undefined;
+  /**
+   * Publish to one or more text-friendly platforms.
+   *
+   * Defaults to all configured platforms whose capabilities include `posting`.
+   * Each platform fan-out is independent — failures don't block others.
+   */
+  post(input: MultiPostInput): Promise<MultiPostResult>;
+  /**
+   * Upload a video to one or more video platforms (YouTube, TikTok, Instagram).
+   */
+  upload(input: MultiUploadInput): Promise<MultiPostResult>;
+  /**
+   * Send a message via Telegram or WhatsApp.
+   */
+  message(input: MessageInput): Promise<MessageResult>;
+  private postOne;
+  private uploadOne;
+  private postingTargets;
+  private uploadTargets;
+}
+//#endregion
+export { FacebookClient, type FacebookClientConfig, InstagramClient, type InstagramClientConfig, LinkedInClient, type LinkedInClientConfig, type MessageInput, type MessageResult, type MultiPostInput, type MultiPostResult, type MultiUploadInput, type PostResult, type ProviderConfigMap, type ProviderName, RedditClient, type RedditClientConfig, SocialClient, type SocialClientOptions, TelegramClient, type TelegramClientConfig, TikTokClient, type TikTokClientConfig, TwitterClient, type TwitterClientConfig, type UnifiedMedia, type UnifiedPostInput, type UnifiedUploadInput, WhatsAppClient, type WhatsAppClientConfig, YouTubeClient, type YouTubeClientConfig, fromEnv };
+//# sourceMappingURL=index.d.mts.map

package/dist/client/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/client/index.ts"],"mappings":";;;;cA2Ca,YAAA;EAAA,SACF,OAAA,GAAU,aAAA;EAAA,SACV,OAAA,GAAU,aAAA;EAAA,SACV,QAAA,GAAW,cAAA;EAAA,SACX,SAAA,GAAY,eAAA;EAAA,SACZ,QAAA,GAAW,cAAA;EAAA,SACX,MAAA,GAAS,YAAA;EAAA,SACT,MAAA,GAAS,YAAA;EAAA,SACT,QAAA,GAAW,cAAA;EAAA,SACX,QAAA,GAAW,cAAA;cAER,MAAA,EAAQ,iBAAA,EAAmB,IAAA,GAAM,mBAAA;EARzB;EAAA,OAqBb,MAAA,CAAO,MAAA,EAAQ,iBAAA,EAAmB,IAAA,GAAO,mBAAA,GAAsB,YAAA;EApBjD;EAyBrB,gBAAA,CAAA,GAAoB,YAAA;EAxBA;EAuCpB,YAAA,CAAa,QAAA,EAAU,YAAA,GAAe,oBAAA;EAtCpB;;;;;;EAgDZ,IAAA,CAAK,KAAA,EAAO,cAAA,GAAiB,OAAA,CAAQ,eAAA;;;;EASrC,MAAA,CAAO,KAAA,EAAO,gBAAA,GAAmB,OAAA,CAAQ,eAAA;EApDR;;;EA6DjC,OAAA,CAAQ,KAAA,EAAO,YAAA,GAAe,OAAA,CAAQ,aAAA;EAAA,QAY9B,OAAA;EAAA,QAWA,SAAA;EAAA,QAeN,cAAA;EAAA,QAIA,aAAA;AAAA"}

package/dist/client/index.mjs

@@ -0,0 +1,154 @@
+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 { allCapabilities } from "../schemas/index.mjs";
+
+//#region src/client/index.ts
+/**
+* SocialClient — the unified façade.
+*
+* Wraps every provider with bound credentials and exposes:
+*   - `client.<platform>` — strongly typed sub-client per platform
+*   - `client.post(input)` — fan out to all configured posting platforms
+*   - `client.upload(input)` — fan out to all configured upload platforms
+*   - `client.message(input)` — send via Telegram or WhatsApp
+*
+* Construction:
+*   const client = SocialClient.create({
+*     twitter: { clientId, clientSecret, tokens },
+*     telegram: { botToken, chatId: '@my-channel' },
+*   });
+*
+*   await client.post({ text: 'Hello' });           // → all configured posters
+*   await client.twitter!.post({ text: 'Tweet' });  // → just Twitter
+*/
+var SocialClient = class SocialClient {
+	youtube;
+	twitter;
+	facebook;
+	instagram;
+	linkedin;
+	reddit;
+	tiktok;
+	telegram;
+	whatsapp;
+	constructor(config, opts = {}) {
+		if (config.youtube) this.youtube = new YouTubeClient(config.youtube, opts);
+		if (config.twitter) this.twitter = new TwitterClient(config.twitter, opts);
+		if (config.facebook) this.facebook = new FacebookClient(config.facebook, opts);
+		if (config.instagram) this.instagram = new InstagramClient(config.instagram, opts);
+		if (config.linkedin) this.linkedin = new LinkedInClient(config.linkedin, opts);
+		if (config.reddit) this.reddit = new RedditClient(config.reddit, opts);
+		if (config.tiktok) this.tiktok = new TikTokClient(config.tiktok, opts);
+		if (config.telegram) this.telegram = new TelegramClient(config.telegram, opts);
+		if (config.whatsapp) this.whatsapp = new WhatsAppClient(config.whatsapp, opts);
+	}
+	/** Convenience factory — equivalent to `new SocialClient(...)`. */
+	static create(config, opts) {
+		return new SocialClient(config, opts);
+	}
+	/** Names of platforms with credentials configured. */
+	enabledPlatforms() {
+		const names = [];
+		if (this.youtube) names.push("youtube");
+		if (this.twitter) names.push("twitter");
+		if (this.facebook) names.push("facebook");
+		if (this.instagram) names.push("instagram");
+		if (this.linkedin) names.push("linkedin");
+		if (this.reddit) names.push("reddit");
+		if (this.tiktok) names.push("tiktok");
+		if (this.telegram) names.push("telegram");
+		if (this.whatsapp) names.push("whatsapp");
+		return names;
+	}
+	/** Capability metadata for a platform. */
+	capabilities(platform) {
+		return allCapabilities[platform];
+	}
+	/**
+	* Publish to one or more text-friendly platforms.
+	*
+	* Defaults to all configured platforms whose capabilities include `posting`.
+	* Each platform fan-out is independent — failures don't block others.
+	*/
+	async post(input) {
+		const targets = (input.platforms ?? this.postingTargets()).filter((p) => allCapabilities[p]?.posting);
+		const results = await Promise.all(targets.map((p) => this.postOne(p, input)));
+		return {
+			results,
+			allOk: results.every((r) => r.ok)
+		};
+	}
+	/**
+	* Upload a video to one or more video platforms (YouTube, TikTok, Instagram).
+	*/
+	async upload(input) {
+		const targets = (input.platforms ?? this.uploadTargets()).filter((p) => allCapabilities[p]?.upload);
+		const results = await Promise.all(targets.map((p) => this.uploadOne(p, input)));
+		return {
+			results,
+			allOk: results.every((r) => r.ok)
+		};
+	}
+	/**
+	* Send a message via Telegram or WhatsApp.
+	*/
+	async message(input) {
+		if (input.platform === "telegram") {
+			if (!this.telegram) throw new Error("Telegram is not configured");
+			return this.telegram.send(input.text, input.to);
+		}
+		if (!this.whatsapp) throw new Error("WhatsApp is not configured");
+		if (input.to === void 0) throw new Error("WhatsApp messages require `to` (E.164 phone number)");
+		return this.whatsapp.send(input.text, String(input.to));
+	}
+	async postOne(platform, input) {
+		switch (platform) {
+			case "twitter": return this.twitter ? this.twitter.post(input) : notConfigured(platform);
+			case "facebook": return this.facebook ? this.facebook.post(input) : notConfigured(platform);
+			case "linkedin": return this.linkedin ? this.linkedin.post(input) : notConfigured(platform);
+			case "instagram": return this.instagram ? this.instagram.post(input) : notConfigured(platform);
+			case "reddit": return this.reddit ? this.reddit.post(input) : notConfigured(platform);
+			default: return {
+				platform,
+				ok: false,
+				error: { message: `${platform} does not support post()` }
+			};
+		}
+	}
+	async uploadOne(platform, input) {
+		switch (platform) {
+			case "youtube": return this.youtube ? this.youtube.upload(input) : notConfigured(platform);
+			case "tiktok": return this.tiktok ? this.tiktok.upload(input) : notConfigured(platform);
+			case "instagram":
+				if (!this.instagram) return notConfigured("instagram");
+				return this.instagram.post({
+					text: input.caption ?? input.description,
+					media: input.videoUrl ? [{
+						type: "video",
+						url: input.videoUrl
+					}] : []
+				});
+			default: return {
+				platform,
+				ok: false,
+				error: { message: `${platform} does not support upload()` }
+			};
+		}
+	}
+	postingTargets() {
+		return this.enabledPlatforms().filter((p) => allCapabilities[p]?.posting);
+	}
+	uploadTargets() {
+		return this.enabledPlatforms().filter((p) => allCapabilities[p]?.upload);
+	}
+};
+function notConfigured(platform) {
+	return {
+		platform,
+		ok: false,
+		error: { message: `${platform} is not configured on this client` }
+	};
+}
+
+//#endregion
+export { FacebookClient, InstagramClient, LinkedInClient, RedditClient, SocialClient, TelegramClient, TikTokClient, TwitterClient, WhatsAppClient, YouTubeClient, fromEnv };
+//# sourceMappingURL=index.mjs.map

package/dist/client/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/client/index.ts"],"sourcesContent":["/**\n * SocialClient — the unified façade.\n *\n * Wraps every provider with bound credentials and exposes:\n *   - `client.<platform>` — strongly typed sub-client per platform\n *   - `client.post(input)` — fan out to all configured posting platforms\n *   - `client.upload(input)` — fan out to all configured upload platforms\n *   - `client.message(input)` — send via Telegram or WhatsApp\n *\n * Construction:\n *   const client = SocialClient.create({\n *     twitter: { clientId, clientSecret, tokens },\n *     telegram: { botToken, chatId: '@my-channel' },\n *   });\n *\n *   await client.post({ text: 'Hello' });           // → all configured posters\n *   await client.twitter!.post({ text: 'Tweet' });  // → just Twitter\n */\n\nimport { TwitterClient } from './twitter.js';\nimport { FacebookClient } from './facebook.js';\nimport { LinkedInClient } from './linkedin.js';\nimport { RedditClient } from './reddit.js';\nimport { InstagramClient } from './instagram.js';\nimport { YouTubeClient } from './youtube.js';\nimport { TikTokClient } from './tiktok.js';\nimport { TelegramClient } from './telegram.js';\nimport { WhatsAppClient } from './whatsapp.js';\n\nimport { allCapabilities } from '../schemas/index.js';\nimport type { ProviderCapabilities } from '../common/contracts.js';\n\nimport type {\n  ProviderConfigMap,\n  ProviderName,\n  SocialClientOptions,\n  MultiPostInput,\n  MultiUploadInput,\n  MultiPostResult,\n  MessageInput,\n  MessageResult,\n} from './types.js';\n\nexport class SocialClient {\n  readonly youtube?: YouTubeClient;\n  readonly twitter?: TwitterClient;\n  readonly facebook?: FacebookClient;\n  readonly instagram?: InstagramClient;\n  readonly linkedin?: LinkedInClient;\n  readonly reddit?: RedditClient;\n  readonly tiktok?: TikTokClient;\n  readonly telegram?: TelegramClient;\n  readonly whatsapp?: WhatsAppClient;\n\n  constructor(config: ProviderConfigMap, opts: SocialClientOptions = {}) {\n    if (config.youtube) this.youtube = new YouTubeClient(config.youtube, opts);\n    if (config.twitter) this.twitter = new TwitterClient(config.twitter, opts);\n    if (config.facebook) this.facebook = new FacebookClient(config.facebook, opts);\n    if (config.instagram) this.instagram = new InstagramClient(config.instagram, opts);\n    if (config.linkedin) this.linkedin = new LinkedInClient(config.linkedin, opts);\n    if (config.reddit) this.reddit = new RedditClient(config.reddit, opts);\n    if (config.tiktok) this.tiktok = new TikTokClient(config.tiktok, opts);\n    if (config.telegram) this.telegram = new TelegramClient(config.telegram, opts);\n    if (config.whatsapp) this.whatsapp = new WhatsAppClient(config.whatsapp, opts);\n  }\n\n  /** Convenience factory — equivalent to `new SocialClient(...)`. */\n  static create(config: ProviderConfigMap, opts?: SocialClientOptions): SocialClient {\n    return new SocialClient(config, opts);\n  }\n\n  /** Names of platforms with credentials configured. */\n  enabledPlatforms(): ProviderName[] {\n    const names: ProviderName[] = [];\n    if (this.youtube) names.push('youtube');\n    if (this.twitter) names.push('twitter');\n    if (this.facebook) names.push('facebook');\n    if (this.instagram) names.push('instagram');\n    if (this.linkedin) names.push('linkedin');\n    if (this.reddit) names.push('reddit');\n    if (this.tiktok) names.push('tiktok');\n    if (this.telegram) names.push('telegram');\n    if (this.whatsapp) names.push('whatsapp');\n    return names;\n  }\n\n  /** Capability metadata for a platform. */\n  capabilities(platform: ProviderName): ProviderCapabilities | undefined {\n    return allCapabilities[platform];\n  }\n\n  /**\n   * Publish to one or more text-friendly platforms.\n   *\n   * Defaults to all configured platforms whose capabilities include `posting`.\n   * Each platform fan-out is independent — failures don't block others.\n   */\n  async post(input: MultiPostInput): Promise<MultiPostResult> {\n    const targets = (input.platforms ?? this.postingTargets()).filter(p => allCapabilities[p]?.posting);\n    const results = await Promise.all(targets.map(p => this.postOne(p, input)));\n    return { results, allOk: results.every(r => r.ok) };\n  }\n\n  /**\n   * Upload a video to one or more video platforms (YouTube, TikTok, Instagram).\n   */\n  async upload(input: MultiUploadInput): Promise<MultiPostResult> {\n    const targets = (input.platforms ?? this.uploadTargets()).filter(p => allCapabilities[p]?.upload);\n    const results = await Promise.all(targets.map(p => this.uploadOne(p, input)));\n    return { results, allOk: results.every(r => r.ok) };\n  }\n\n  /**\n   * Send a message via Telegram or WhatsApp.\n   */\n  async message(input: MessageInput): Promise<MessageResult> {\n    if (input.platform === 'telegram') {\n      if (!this.telegram) throw new Error('Telegram is not configured');\n      return this.telegram.send(input.text, input.to);\n    }\n    if (!this.whatsapp) throw new Error('WhatsApp is not configured');\n    if (input.to === undefined) throw new Error('WhatsApp messages require `to` (E.164 phone number)');\n    return this.whatsapp.send(input.text, String(input.to));\n  }\n\n  // ─── Internal ───────────────────────────────────────────────────────\n\n  private async postOne(platform: ProviderName, input: MultiPostInput): Promise<MultiPostResult['results'][number]> {\n    switch (platform) {\n      case 'twitter':   return this.twitter   ? this.twitter.post(input)   : notConfigured(platform);\n      case 'facebook':  return this.facebook  ? this.facebook.post(input)  : notConfigured(platform);\n      case 'linkedin':  return this.linkedin  ? this.linkedin.post(input)  : notConfigured(platform);\n      case 'instagram': return this.instagram ? this.instagram.post(input) : notConfigured(platform);\n      case 'reddit':    return this.reddit    ? this.reddit.post(input)    : notConfigured(platform);\n      default:          return { platform, ok: false, error: { message: `${platform} does not support post()` } };\n    }\n  }\n\n  private async uploadOne(platform: ProviderName, input: MultiUploadInput): Promise<MultiPostResult['results'][number]> {\n    switch (platform) {\n      case 'youtube':   return this.youtube   ? this.youtube.upload(input)  : notConfigured(platform);\n      case 'tiktok':    return this.tiktok    ? this.tiktok.upload(input)   : notConfigured(platform);\n      case 'instagram': {\n        if (!this.instagram) return notConfigured('instagram');\n        return this.instagram.post({\n          text: input.caption ?? input.description,\n          media: input.videoUrl ? [{ type: 'video', url: input.videoUrl }] : [],\n        });\n      }\n      default: return { platform, ok: false, error: { message: `${platform} does not support upload()` } };\n    }\n  }\n\n  private postingTargets(): ProviderName[] {\n    return this.enabledPlatforms().filter(p => allCapabilities[p]?.posting);\n  }\n\n  private uploadTargets(): ProviderName[] {\n    return this.enabledPlatforms().filter(p => allCapabilities[p]?.upload);\n  }\n}\n\nfunction notConfigured(platform: ProviderName): MultiPostResult['results'][number] {\n  return { platform, ok: false, error: { message: `${platform} is not configured on this client` } };\n}\n\n// Re-export everything useful from this subpath\nexport type {\n  ProviderConfigMap,\n  ProviderName,\n  SocialClientOptions,\n  MultiPostInput,\n  MultiPostResult,\n  MultiUploadInput,\n  UnifiedPostInput,\n  UnifiedUploadInput,\n  UnifiedMedia,\n  PostResult,\n  MessageInput,\n  MessageResult,\n  YouTubeClientConfig,\n  TwitterClientConfig,\n  FacebookClientConfig,\n  InstagramClientConfig,\n  LinkedInClientConfig,\n  RedditClientConfig,\n  TikTokClientConfig,\n  TelegramClientConfig,\n  WhatsAppClientConfig,\n} from './types.js';\n\nexport { TwitterClient } from './twitter.js';\nexport { FacebookClient } from './facebook.js';\nexport { LinkedInClient } from './linkedin.js';\nexport { RedditClient } from './reddit.js';\nexport { InstagramClient } from './instagram.js';\nexport { YouTubeClient } from './youtube.js';\nexport { TikTokClient } from './tiktok.js';\nexport { TelegramClient } from './telegram.js';\nexport { WhatsAppClient } from './whatsapp.js';\n\nexport { fromEnv } from './env.js';\n"],"mappings":"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"}

package/dist/common/index.d.mts

@@ -0,0 +1,3 @@
+import { a as ProviderCapabilities, c as UnifiedPostInput, d as isPostingProvider, f as isUploadingProvider, i as ProviderAuth, l as UploadingProvider, n as MessagingProvider, o as UnifiedMedia, r as PostingProvider, s as UnifiedPost, t as ListPostsOptions, u as isMessagingProvider } from "../contracts-Cdwa4zlg.mjs";
+import { C as HttpMethod, D as RetryConfig, E as ParseError, F as META_TOKEN_URL, M as META_GRAPH_BASE, N as META_GRAPH_VERSION, O as httpRequest, P as META_GRAPH_VIDEO_BASE, S as generateCodeVerifier, T as HttpResponse, _ as buildAuthUrl, a as Page, b as PkceStore, c as paginate, d as metaExchangeLongLived, f as metaRefreshLongLivedFacebook, g as OAuth2RefreshParams, h as OAuth2ExchangeParams, i as pollUntilComplete, j as META_AUTH_URL, l as IG_REFRESH_URL, m as parseGraphError, n as redactSecrets, o as PaginateOptions, p as metaRefreshLongLivedInstagram, r as PollOptions, s as PaginatedIterable, t as assertPublicHttpUrl, u as MetaExchangeParams, v as oauth2ExchangeCode, w as HttpRequestOptions, x as generateCodeChallenge, y as oauth2RefreshToken } from "../security-BXhfebWm.mjs";
+export { type HttpMethod, type HttpRequestOptions, type HttpResponse, IG_REFRESH_URL, type ListPostsOptions, META_AUTH_URL, META_GRAPH_BASE, META_GRAPH_VERSION, META_GRAPH_VIDEO_BASE, META_TOKEN_URL, type MessagingProvider, type MetaExchangeParams, type OAuth2ExchangeParams, type OAuth2RefreshParams, type Page, type PaginateOptions, type PaginatedIterable, type ParseError, PkceStore, type PollOptions, type PostingProvider, type ProviderAuth, type ProviderCapabilities, type RetryConfig, type UnifiedMedia, type UnifiedPost, type UnifiedPostInput, type UploadingProvider, assertPublicHttpUrl, buildAuthUrl, generateCodeChallenge, generateCodeVerifier, httpRequest, isMessagingProvider, isPostingProvider, isUploadingProvider, metaExchangeLongLived, metaRefreshLongLivedFacebook, metaRefreshLongLivedInstagram, oauth2ExchangeCode, oauth2RefreshToken, paginate, parseGraphError, pollUntilComplete, redactSecrets };

package/dist/common/index.mjs

@@ -0,0 +1,7 @@
+import { a as parseGraphError, c as META_GRAPH_VERSION, i as metaRefreshLongLivedInstagram, l as META_GRAPH_VIDEO_BASE, n as metaExchangeLongLived, o as META_AUTH_URL, r as metaRefreshLongLivedFacebook, s as META_GRAPH_BASE, t as IG_REFRESH_URL, u as META_TOKEN_URL } 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";
+
+export { IG_REFRESH_URL, META_AUTH_URL, META_GRAPH_BASE, META_GRAPH_VERSION, META_GRAPH_VIDEO_BASE, META_TOKEN_URL, PkceStore, assertPublicHttpUrl, buildAuthUrl, generateCodeChallenge, generateCodeVerifier, httpRequest, isMessagingProvider, isPostingProvider, isUploadingProvider, metaExchangeLongLived, metaRefreshLongLivedFacebook, metaRefreshLongLivedInstagram, oauth2ExchangeCode, oauth2RefreshToken, paginate, parseGraphError, pollUntilComplete, redactSecrets };