ad2app-lib 1.0.0

package/src/types/I_TikTokPost.ts

@@ -0,0 +1,64 @@
+import { IsString } from "class-validator";
+import { I_Tag } from "./I_Tag";
+
+export class I_TikTokPost {
+  url: string;
+  description: string;
+  likes: number;
+  views: number;
+  comments: I_TikTokComment[];
+  commentsAmount: number;
+  commentsSentimentRatio: number;
+  shares: number;
+  bookmarks: number;
+  isAd: number;
+  VQScore: number;
+  uploadedAt: Date | null;
+  tags: I_Tag[];
+  bitrateInfo: { QualityType: number; CodecType: string; GearName: string }[];
+  pinned: boolean;
+  statisticsHistory: {
+    date: Date;
+    commentsAmount: number;
+    views: number;
+    likes: number;
+    shares: number;
+    bookmarks: number;
+  }[];
+
+  constructor(data?: Partial<I_TikTokPost>) {
+    this.url = data?.url ?? "";
+    this.description = data?.description ?? "";
+    this.likes = data?.likes ?? -1;
+    this.views = data?.views ?? -1;
+    this.comments = data?.comments ?? [];
+    this.commentsAmount = data?.commentsAmount ?? -1;
+    this.commentsSentimentRatio = data?.commentsSentimentRatio ?? null;
+    this.shares = data?.shares ?? 0;
+    this.bookmarks = data?.bookmarks ?? -1;
+    this.isAd = data?.isAd ?? 0;
+    this.VQScore = data?.VQScore ?? 0;
+    this.uploadedAt = data?.uploadedAt ? new Date(data.uploadedAt) : null;
+    this.tags = data?.tags ?? [];
+    this.bitrateInfo = data?.bitrateInfo ?? [];
+    this.pinned = data?.pinned ?? false;
+    this.statisticsHistory = data?.statisticsHistory ?? [];
+  }
+}
+
+export class I_TikTokComment {
+  comment_language: string;
+  text: string;
+  create_time: string;
+  user: {
+    unique_id: string;
+  };
+}
+export class I_TikTokUserPostsRaport {
+  data: I_TikTokPost[];
+}
+
+export class I_GetTikTokPostsDTO {
+  @IsString()
+  handle: string;
+}

package/src/types/I_TikTokReport.ts

@@ -0,0 +1,20 @@
+import { I_Influencer } from "./I_Influencer";
+import { I_TikTokPost } from "./I_TikTokPost";
+
+export class I_TikTokReport {
+  influencerId: number;
+  data: I_TikTokPost[];
+  ad_mean_views: number;
+  mean_views: number;
+  updatedAt: Date;
+  influencer: I_Influencer;
+
+  constructor(data?: I_TikTokReport) {
+    this.influencerId = data?.influencerId ?? null;
+    this.data = data?.data ?? [];
+    this.ad_mean_views = data?.ad_mean_views ?? null;
+    this.mean_views = data?.mean_views ?? null;
+    this.updatedAt = data?.updatedAt ?? null;
+    this.influencer = data?.influencer ?? null;
+  }
+}

package/src/types/I_TikTokUser.ts

@@ -0,0 +1,108 @@
+import { IsNotEmpty, IsOptional, IsString } from "class-validator";
+
+import { I_TikTokPost } from "./I_TikTokPost";
+
+export class I_TikTokUser {
+  avatarUrl?: string;
+  handle: string;
+  bio: string;
+  followerCount: number;
+  followingCount: number;
+  likes: number;
+  languages: string[];
+  nationality: string;
+  ftc: boolean;
+  secret: boolean;
+  ttSeller: boolean;
+  relation: number;
+  openFavorite: boolean;
+  isADVirtual: boolean;
+  downloadSetting: number;
+  commentSetting: number;
+  verified: boolean;
+  tiktoks: I_TikTokPost[];
+  following: I_TikTokUser[];
+  followers: I_TikTokUser[];
+  updatedAt: Date;
+  statisticsHistory: {
+    date: Date;
+    followerCount: number;
+    followingCount: number;
+    likes: number;
+  }[];
+
+  constructor(data?: Partial<I_TikTokUser>) {
+    this.avatarUrl = data?.avatarUrl ?? "";
+    this.handle = data?.handle ?? "";
+    this.bio = data?.bio ?? "";
+    this.followerCount = data?.followerCount ?? 0;
+    this.followingCount = data?.followingCount ?? 0;
+    this.likes = data?.likes ?? 0;
+    this.languages = data?.languages ?? [];
+    this.nationality = data?.nationality ?? "";
+    this.ftc = data?.ftc ?? false;
+    this.secret = data?.secret ?? false;
+    this.ttSeller = data?.ttSeller ?? false;
+    this.relation = data?.relation ?? 0;
+    this.openFavorite = data?.openFavorite ?? false;
+    this.isADVirtual = data?.isADVirtual ?? false;
+    this.downloadSetting = data?.downloadSetting ?? 0;
+    this.commentSetting = data?.commentSetting ?? 0;
+    this.verified = data?.verified ?? false;
+    this.tiktoks = data?.tiktoks ?? [];
+    this.following = data?.following ?? [];
+    this.followers = data?.followers ?? [];
+    this.updatedAt = data?.updatedAt ?? new Date();
+    this.statisticsHistory = data?.statisticsHistory ?? [];
+  }
+}
+
+export class I_SearchTikTokUserDTO {
+  @IsOptional()
+  handle: string;
+
+  @IsOptional()
+  followers_from: number;
+
+  @IsOptional()
+  verified: boolean;
+
+  @IsString({ each: true })
+  @IsOptional()
+  languages: string[];
+
+  constructor(data?: Partial<I_SearchTikTokUserDTO>) {
+    this.followers_from = data?.followers_from || 0;
+    this.verified = !!data?.verified;
+    this.languages = data?.languages || [];
+    this.handle = data?.handle || "";
+  }
+}
+
+export class I_TikTokUserCreateDTO {
+  @IsString()
+  handle: string;
+
+  constructor(data?: Partial<I_TikTokUserCreateDTO>) {
+    this.handle = data?.handle || "";
+  }
+}
+
+export class I_TikTokUserGetDTO {
+  @IsNotEmpty()
+  handle: string;
+}
+
+export class I_TikTokUserGetManyDTO {
+  @IsNotEmpty()
+  handles: string[];
+}
+
+export class I_TikTokUserCalculatePostCommentsSentimentDTO {
+  @IsNotEmpty()
+  handle: string;
+
+  category?: string;
+
+  instructions?: string;
+}

package/src/types/I_User.ts

@@ -0,0 +1,57 @@
+import { IsNotEmpty } from "class-validator";
+import { I_Influencer } from "./I_Influencer";
+
+export class I_User {
+  id: string;
+  email: string;
+  password: string;
+  role: UserRoles;
+  influencer?: I_Influencer;
+}
+
+export class I_SignedUser extends I_User {
+  accessToken: string;
+}
+
+export enum UserRoles {
+  ADMIN = "ADMIN",
+  INFLUENCER = "INFLUENCER",
+  AGENT = "AGENT",
+}
+
+export class I_UserCreateDTO {
+  @IsNotEmpty()
+  password: string;
+
+  @IsNotEmpty()
+  email: string;
+}
+
+export class I_UserSignInDTO {
+  @IsNotEmpty()
+  password: string;
+
+  @IsNotEmpty()
+  email: string;
+}
+
+export class I_UserSignUpDTO {
+  @IsNotEmpty()
+  username: string;
+
+  @IsNotEmpty()
+  password: string;
+
+  @IsNotEmpty()
+  email: string;
+}
+
+export class I_UserFindOneDTO {
+  @IsNotEmpty()
+  email: string;
+}
+
+export class I_UserAuthenticateDTO {
+  @IsNotEmpty()
+  accessToken: string;
+}

package/src/types/I_UserTikTokStatistic.ts

@@ -0,0 +1,25 @@
+export class I_UserTikTokStatistic {
+  url: string;
+  isAd: number;
+  views: number;
+  commentsAmount: number;
+  likes: number;
+  uploadedAt: Date;
+  VQScore: number;
+  shares: number;
+
+  constructor(
+    data?: Partial<I_UserTikTokStatistic> & {
+      isAd?: number;
+    }
+  ) {
+    this.isAd = data?.isAd;
+    this.views = data?.views || 0;
+    this.likes = data?.likes || 0;
+    this.commentsAmount = data?.commentsAmount || 0;
+    this.uploadedAt = data?.uploadedAt || new Date();
+    this.url = data?.url || "";
+    this.VQScore = data?.VQScore || 0;
+    this.shares = data?.shares || 0;
+  }
+}

package/src/types/T_FetchStatus.ts

@@ -0,0 +1 @@
+export type T_FetchStatus = "initial" | "loading" | "succeeded" | "failed";

package/src/types/global.ts

@@ -0,0 +1,10 @@
+export type Timespan = {
+  from: Date;
+  to: Date;
+};
+
+export type FetchParams<T> = {
+  params?: {};
+  query?: T;
+  body?: T;
+};

package/src/types/index.ts

@@ -0,0 +1,31 @@
+export * from "./I_TikTokUser";
+export * from "./I_Queue";
+export * from "./I_Campaign";
+export * from "./I_Influencer";
+export * from "./I_InfluencersLists";
+export * from "./I_InfluencersCategories";
+export * from "./I_InfluencersProperties";
+export * from "./I_Item";
+export * from "./I_List";
+export * from "./I_PaginatedList";
+export * from "./I_Pagination";
+export * from "./I_TIkTokRaports";
+export * from "./I_Tag";
+export * from "./I_TikTokPost";
+export * from "./I_User";
+export * from "./I_UserTikTokStatistic";
+export * from "./I_ScrappingAccount";
+export * from "./global";
+export * from "./I_Scrappers";
+export * from "./I_ScrappingServiceMessages";
+export * from "./I_ScrappingMachine";
+export * from "./I_ScrappingMachineProcess";
+export * from "./T_FetchStatus";
+export * from "./I_ResponseMessage";
+export * from "./I_ScrapperLog";
+export * from "./I_CampaignGoal";
+export * from "./I_CampaignCollaborationMethod";
+export * from "./I_TikTokReport";
+export * from "./I_Offer";
+export * from "./I_CampaignDeadline";
+export * from "./I_Agency";

package/src/utils/array.ts

@@ -0,0 +1,15 @@
+export const safeguardArray = <T>(array: T[]) => [...(array || [])];
+
+export const uniqueArray = <T>(array: T[], element: T[]): T[] =>
+  Array.from(new Set([...safeguardArray(array), ...safeguardArray(element)]));
+
+export const replaceArrayItemBy = <T>(
+  array: T[],
+  updatedItem: T,
+  by: keyof T
+): T[] => {
+  const key = by;
+  return safeguardArray(array).map((item) =>
+    item?.[key] === updatedItem?.[key] ? updatedItem : item
+  );
+};

package/src/utils/cookies.ts

@@ -0,0 +1,16 @@
+// import Cookies from 'js-cookie';
+
+// export const setAuthTokenCookie = (token: string) => {
+//   Cookies.remove('authToken');
+//   const isSecure = window.location.protocol === 'https:';
+
+//   Cookies.set('authToken', token, {
+//     expires: 7,
+//     secure: isSecure,
+//     sameSite: isSecure ? 'None' : 'Strict',
+//   });
+// };
+
+// export const getAuthTokenCookie = () => {
+//   return Cookies.get('authToken');
+// };

package/src/utils/date.ts

@@ -0,0 +1,14 @@
+import { format, isBefore } from "date-fns";
+
+// TODO: Implement this eveywhere D	ate is applied in DB
+export const getTimestampWithMilliseconds = (date: Date = new Date()) => {
+  return new Date(format(date, "yyyy-MM-dd HH:mm:ss.SSS"));
+};
+
+export function isAtLeastOld(date: Date, maxAge: Date): boolean {
+  return isBefore(date, maxAge);
+}
+
+export const formatShort = (date: Date) => format(new Date(date), "yyyy-MM-dd");
+export const formatTime = (date: Date) => format(new Date(date), "HH:mm");
+export const formatFull = (date: Date) => format(new Date(date), "PPpp");

package/src/utils/index.ts

@@ -0,0 +1,6 @@
+export * from "./array";
+export * from "./date";
+export * from "./promise";
+export * from "./string";
+export * from "./variable";
+export * from "./types";

package/src/utils/promise.ts

@@ -0,0 +1,3 @@
+export async function wait(time = 1000) {
+  await new Promise((res) => setTimeout(res, time));
+}

package/src/utils/string.ts

@@ -0,0 +1 @@
+export const hasEmoji = (str: string) => /\p{Emoji}/u.test(str);

package/src/utils/types.ts

@@ -0,0 +1,9 @@
+type Prev = [never, 0, 1, 2, 3, 4, 5];
+
+export type DotNestedKeys<T, Depth extends number = 5> = [Depth] extends [never]
+  ? never
+  : {
+      [K in keyof T & string]: T[K] extends object
+        ? K | `${K}.${DotNestedKeys<T[K], Prev[Depth]>}`
+        : K;
+    }[keyof T & string];

package/src/utils/variable.ts

@@ -0,0 +1,7 @@
+export const getTargetValueOrNull = <T>(value: unknown, targetValue: T) => {
+  return (!!value && targetValue) || undefined;
+};
+
+export const getNumberOrUndefined = (value: unknown) => {
+  return value ? Number(value) : undefined;
+};

package/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "CommonJS",
+    "moduleResolution": "node",
+    "declaration": true,
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "allowSyntheticDefaultImports": true,
+    "esModuleInterop": true,
+    "outDir": "dist"
+  },
+  "include": ["src/**/*"]
+}