operand-meta-sdk 1.2.1

package/src/error/operand-error.ts

@@ -0,0 +1,217 @@
+import { MetaError } from "../interfaces/meta-response";
+import { AxiosError } from "axios";
+
+export class OperandError {
+  private message_private: string;
+  private code_private: number;
+
+  parseMetaError(...data: any) {
+    const { error, message } = data[0];
+
+    console.log({ error: error?.response?.data || error });
+
+    if (error instanceof AxiosError) {
+      const data = error.response?.data as MetaError;
+
+      if (!data || !data.error) {
+        this.message_private = "Unknown error occurred";
+        this.code_private = 500;
+        return;
+      }
+
+      switch (data.error.code) {
+        // Authentication Errors
+        case 190:
+          this.message_private = "Access token has expired";
+          this.code_private = data.error.code;
+          break;
+        case 102:
+          this.message_private = "Session has expired";
+          this.code_private = data.error.code;
+          break;
+        case 104:
+          this.message_private = "Unsupported version";
+          this.code_private = data.error.code;
+          break;
+        case 2:
+          this.message_private = "Service temporarily unavailable";
+          this.code_private = data.error.code;
+          break;
+
+        // Permission Errors
+        case 10:
+          this.message_private = "Application does not have permission";
+          this.code_private = data.error.code;
+          break;
+        case 200:
+          this.message_private = "Access to this resource not allowed";
+          this.code_private = data.error.code;
+          break;
+        case 210:
+          this.message_private = "User not visible";
+          this.code_private = data.error.code;
+          break;
+
+        // Rate Limit Errors
+        case 4:
+          this.message_private = "Application request limit reached";
+          this.code_private = data.error.code;
+          break;
+        case 17:
+          this.message_private = "User request limit reached";
+          this.code_private = data.error.code;
+          break;
+        case 32:
+          this.message_private = "Page request limit reached";
+          this.code_private = data.error.code;
+          break;
+
+        // Publication Errors - Facebook
+        case 100:
+          this.message_private = "Invalid parameter";
+          this.code_private = data.error.code;
+          break;
+        case 1487851:
+          this.message_private = "Too many URLs in the post message";
+          this.code_private = data.error.code;
+          break;
+        case 368:
+          this.message_private =
+            "The action attempted has been deemed abusive or is otherwise disallowed";
+          this.code_private = data.error.code;
+          break;
+        case 506:
+          this.message_private = "Duplicate post content";
+          this.code_private = data.error.code;
+          break;
+        case 1000:
+          this.message_private =
+            "Application does not have permission for this action";
+          this.code_private = data.error.code;
+          break;
+        case 1297001:
+          this.message_private = "Content type is not supported";
+          this.code_private = data.error.code;
+          break;
+        case 324:
+          this.message_private = "Missing or invalid image file";
+          this.code_private = data.error.code;
+          break;
+        case 500:
+          this.message_private = "Service error. Try again later.";
+          this.code_private = data.error.code;
+          break;
+        case 1157:
+          this.message_private = "Unsupported post request";
+          this.code_private = data.error.code;
+          break;
+        case 36:
+          this.message_private = "Upload request limit reached";
+          this.code_private = data.error.code;
+          break;
+
+        // Publication Errors - Instagram
+        case 9007:
+          this.message_private =
+            "The media is not ready for publishing, please wait for a moment";
+          this.code_private = data.error.code;
+          break;
+        case 9008:
+          this.message_private = "The image aspect ratio is too wide";
+          this.code_private = data.error.code;
+          break;
+        case 10901:
+          this.message_private = "Video too long for Instagram";
+          this.code_private = data.error.code;
+          break;
+        case 352:
+          this.message_private = "Instagram account not eligible";
+          this.code_private = data.error.code;
+          break;
+        case 24:
+          this.message_private =
+            "Error attaching Instagram accounts (permissions or rate limit issue)";
+          this.code_private = data.error.code;
+          break;
+        case 10900:
+          this.message_private =
+            "Instagram media post not allowing tagged users";
+          this.code_private = data.error.code;
+          break;
+        case 9001:
+          this.message_private =
+            "Instagram account already has the maximum number of posts in progress";
+          this.code_private = data.error.code;
+          break;
+        case 10902:
+          this.message_private = "Instagram media type not supported";
+          this.code_private = data.error.code;
+          break;
+        case 2207:
+          this.message_private = "Invalid Instagram media URL or ID";
+          this.code_private = data.error.code;
+          break;
+        case 2500:
+          this.message_private = "Too many hashtags in the Instagram post";
+          this.code_private = data.error.code;
+          break;
+
+        // Content Policy Errors
+        case 369:
+          this.message_private =
+            "Invalid content: does not meet community standards";
+          this.code_private = data.error.code;
+          break;
+        case 370:
+          this.message_private =
+            "Restricted content: does not meet ad policies";
+          this.code_private = data.error.code;
+          break;
+        case 372:
+          this.message_private = "Content contains prohibited terms";
+          this.code_private = data.error.code;
+          break;
+
+        // Business Errors
+        case 33:
+          this.message_private = "Business request limit reached";
+          this.code_private = data.error.code;
+          break;
+        case 803:
+          this.message_private = "Ad account cannot be used";
+          this.code_private = data.error.code;
+          break;
+
+        default:
+          this.message_private =
+            data.error.message || "Error communicating with the target";
+          this.code_private = data.error.code || 500;
+      }
+    } else if (error instanceof OperandError) {
+      this.message_private = error.message;
+      this.code_private = error.code;
+    } else {
+      this.message_private = message || "Unknown error occurred";
+      this.code_private = 500;
+    }
+  }
+
+  constructor(...data: any) {
+    this.parseMetaError(...data);
+
+    console.error(
+      JSON.stringify({
+        message: this.message,
+        code: this.code,
+      }),
+    );
+  }
+
+  get message() {
+    return this.message_private;
+  }
+
+  get code() {
+    return this.code_private;
+  }
+}

package/src/index.ts

@@ -0,0 +1,21 @@
+import { MetaAuth } from "./modules/auth/meta-auth";
+import { MetaPage } from "./modules/meta-page";
+import { MetaIng } from "./modules/meta-ing";
+import { MetaMkt } from "./modules/meta-mkt";
+import { OperandError } from "./error/operand-error";
+import * as IMetaAuth from "./interfaces/meta-auth";
+import * as IMetaPage from "./interfaces/page-publish";
+import * as IMetaIng from "./interfaces/ing-publish";
+import * as IMetaResponse from "./interfaces/meta-response";
+
+export {
+  MetaAuth,
+  MetaPage,
+  MetaIng,
+  MetaMkt,
+  OperandError,
+  IMetaAuth,
+  IMetaPage,
+  IMetaIng,
+  IMetaResponse,
+};

package/src/interfaces/ing-publish.ts

@@ -0,0 +1,58 @@
+import { ConstructorMain } from "./meta";
+
+export interface ConstructorIng extends ConstructorMain {
+  ingId: string;
+  typeToken?: "fb" | "ig";
+}
+
+export type PhotoMediaItem = {
+  mediaType: "photo";
+  source: "url";
+  value: string;
+};
+
+export type VideoMediaItem = {
+  mediaType: "video";
+  source: "url" | "path";
+  value: string;
+};
+
+export type Medias = PhotoMediaItem | VideoMediaItem;
+
+export interface UserTag {
+  username: string;
+  x?: number;
+  y?: number;
+}
+
+export type CreatePost = {
+  medias: Medias[];
+  caption?: string;
+  coverUrl?: string;
+  thumbOffset?: number;
+  userTags?: UserTag[];
+  collaborators?: string[];
+};
+
+export type CreatePhotoStory = Medias & { userTags?: UserTag[] };
+
+export type CreateVideoStory = Medias & { userTags?: UserTag[] };
+
+export type CreateStories = Medias & { userTags?: UserTag[] };
+
+export interface IIngPublish {
+  createPost(data: CreatePost): Promise<string>;
+  createStories(data: CreateStories): Promise<string>;
+  getLinkPost(id: string): Promise<string>;
+}
+
+export interface saveMediaInMetaIngContainer {
+  value: string;
+  to: "REELS" | "STORIES" | "FEED";
+  isCarouselItem?: boolean;
+  caption?: string;
+  coverUrl?: string;
+  thumbOffset?: number;
+  userTags?: UserTag[];
+  collaborators?: string[];
+}

package/src/interfaces/meta-auth.ts

@@ -0,0 +1,52 @@
+export type ApiVersion =
+  | "v17.0"
+  | "v18.0"
+  | "v19.0"
+  | "v20.0"
+  | "v21.0"
+  | "v22.0"
+  | "v23.0";
+
+export type CreateMetaAuth = {
+  client_id: string;
+  client_secret: string;
+  redirect_uri?: string;
+  apiVersion: ApiVersion;
+  code: string;
+};
+
+export type FieldsPage = Array<
+  | "id"
+  | "name"
+  | "about"
+  | "category"
+  | "category_list"
+  | "location"
+  | "fan_count"
+  | "access_token"
+  | "tasks"
+  | "picture"
+  | "cover"
+  | "photos"
+  | "videos"
+  | "engagement"
+  | "is_published"
+  | "is_verified"
+  | "verification_status"
+  | "website"
+  | "emails"
+  | "phone"
+  | "instagram_business_account"
+  | "hours"
+  | "created_time"
+  | "bio"
+  | "link"
+  | "business"
+  | string
+>;
+
+export type GetAccounts = {
+  fields: FieldsPage;
+  accessToken: string;
+  apiVersion: ApiVersion;
+};

package/src/interfaces/meta-mkt.ts

@@ -0,0 +1,5 @@
+import { ConstructorMain } from "./meta";
+
+export interface ConstructorMkt extends ConstructorMain {
+  adAAccountId: string;
+}

package/src/interfaces/meta-response.ts

@@ -0,0 +1,319 @@
+export interface PagePost {
+  created_time: string;
+  message: string;
+  id: string;
+}
+
+export interface PaginationCursors {
+  before?: string;
+  after?: string;
+}
+
+export interface PaginationInfo {
+  cursors: PaginationCursors;
+  next?: string;
+}
+
+export interface GetPagePostsResponse {
+  data: PagePost[];
+  paging: PaginationInfo;
+}
+
+export interface CreatePagePostResponse {
+  id: string;
+  post_id?: string;
+}
+
+export interface UpdatePagePostResponse {
+  success: boolean;
+}
+
+export interface DeletePagePostResponse {
+  success: boolean;
+}
+
+export interface SaveMediaStorageResponse {
+  id: string;
+}
+
+export interface CreatePhotoStoriesResponse {
+  success: boolean;
+  post_id: string;
+}
+
+export interface CreateAccessTokenResponse {
+  access_token: string;
+  token_type: string;
+}
+
+export interface FacebookPage {
+  id: string;
+  name?: string;
+  about?: string;
+  category?: string;
+  category_list?: Array<{ id: string; name: string }>;
+  location?: {
+    city?: string;
+    country?: string;
+    latitude?: number;
+    longitude?: number;
+    street?: string;
+    zip?: string;
+  };
+  fan_count?: number;
+  access_token?: string;
+  tasks?: string[];
+  picture?: {
+    data: {
+      url: string;
+      width?: number;
+      height?: number;
+      is_silhouette?: boolean;
+    };
+  };
+  cover?: {
+    id: string;
+    source: string;
+    offset_y?: number;
+    offset_x?: number;
+  };
+  photos?: {
+    data: Array<{
+      id: string;
+      name?: string;
+      created_time?: string;
+      picture?: string;
+    }>;
+  };
+  videos?: {
+    data: Array<{
+      id: string;
+      title?: string;
+      description?: string;
+      picture?: string;
+      source?: string;
+    }>;
+  };
+  engagement?: {
+    count?: number;
+    social_sentence?: string;
+  };
+  is_published?: boolean;
+  is_verified?: boolean;
+  verification_status?: string;
+  website?: string;
+  emails?: string[];
+  phone?: string;
+  instagram_business_account?: {
+    id: string;
+    username: string;
+    name?: string;
+    picture?: string;
+  };
+  hours?: {
+    monday?: string;
+    tuesday?: string;
+    wednesday?: string;
+    thursday?: string;
+    friday?: string;
+    saturday?: string;
+    sunday?: string;
+  };
+  created_time?: string;
+  bio?: string;
+  link?: string;
+  business?: {
+    id: string;
+    name: string;
+    owned_ad_accounts?: {
+      id: string;
+      account_id: string;
+      name: string;
+      account_status?: number;
+    };
+  };
+}
+
+export interface InstagramAccount {
+  id: string;
+  username: string;
+  name: string;
+  followers_count: number;
+  picture?: string;
+}
+
+export interface FacebookAdAccount {
+  data: Array<{
+    account_id: string;
+    id: string;
+  }>;
+  paging: PaginationInfo;
+}
+
+export interface GetPageAccountsResponse {
+  data: Array<FacebookPage>;
+  paging: { cursors: PaginationCursors };
+}
+
+export interface CreateStartVideoUploadResponse {
+  video_id: string;
+  upload_url: string;
+}
+
+export interface CreateLoadingVideoUploadResponse {
+  success: boolean;
+}
+
+export interface CreateFinishVideoUploadResponse {
+  success: boolean;
+  message: string;
+  post_id: string;
+}
+
+export interface GetStatusMediaContainerDownloadResponse {
+  status_code: "FINISHED" | "ERROR" | "EXPIRED" | "IN_PROGRESS" | "PUBLISHED";
+  id: string;
+}
+
+export interface PostMediaContainerReelsResponse {
+  id: string;
+  uri: string;
+}
+
+export interface GetFollowersCountResponseCurrent {
+  followers_count: number;
+  id: string;
+}
+
+export interface Insights<T> {
+  name: string;
+  period: string;
+  values: T;
+  title: string;
+  description: string;
+  id: string;
+  total_value?: {
+    value: number;
+  };
+}
+
+export interface GetInsightsResponse {
+  data: Insights<
+    {
+      value: number;
+      end_time?: string;
+    }[]
+  >[];
+  paging: {
+    previous: string;
+  };
+}
+
+export interface GetInsightsPageFollowersAndUnFollowersResponse {
+  data: Insights<
+    {
+      value: {
+        follows: 100;
+        unfollows: 50;
+      };
+      end_time?: string;
+    }[]
+  >[];
+  paging: {
+    previous: string;
+  };
+}
+
+export interface GetInsightsPageActionsPostReactionsTotalResponse {
+  data: Insights<
+    {
+      value: {
+        like?: number;
+        love?: number;
+        wow?: number;
+        haha?: number;
+        sorry?: number;
+        anger?: number;
+      };
+      end_time?: string;
+    }[]
+  >[];
+  paging: {
+    previous: string;
+  };
+}
+
+export interface PostComment {
+  id: string;
+  message: string;
+  created_time: string;
+  from: {
+    id: string;
+    name: string;
+  };
+}
+
+export interface GetPostCommentsResponse {
+  data: PostComment[];
+  paging: PaginationInfo;
+}
+
+export interface AdMetrics {
+  reach: string;
+  date_start: string;
+  date_stop: string;
+  publisher_platform: string;
+}
+
+export interface AdMetricsResponse {
+  data: AdMetrics[];
+  paging?: PaginationInfo;
+}
+
+export interface GetStoriesPageResponse {
+  data: {
+    post_id: string;
+    status: string;
+    creation_time: string;
+    media_type: string;
+    media_id: string;
+    url: string;
+  }[];
+}
+
+export interface MetaError {
+  error: {
+    message: string;
+    type: string;
+    code: number;
+    fbtrace_id: string;
+  };
+}
+
+export interface GetAlongTokenMetaResponse {
+  access_token: string;
+  token_type: "bearer";
+  expires_in: number;
+}
+
+export interface BusinessDiscovery {
+  followers_count: number;
+  media_count: number;
+  picture: string;
+  id: string;
+}
+
+export interface GetInstagramDiscoveryResponse {
+  business_discovery: BusinessDiscovery;
+  id: string;
+}
+
+export interface GetInsightsAccountsEngagedResponse {
+  data: Insights<{
+    value: null;
+  }>[];
+  paging: {
+    previous: string;
+    next: string;
+  };
+}

package/src/interfaces/meta.ts

@@ -0,0 +1,7 @@
+import { ApiVersion } from "./meta-auth";
+
+export type ConstructorMain = {
+  pageAccessToken: string;
+  apiVersion: ApiVersion;
+  isInstagramApi?: boolean;
+};