ad2app-lib 1.0.11 → 1.1.0

package/src/types/scheduling/I_SchedulingConnectedAccount.ts

@@ -0,0 +1,80 @@
+/**
+ * Scheduling domain — Connected Account DTOs
+ *
+ * Represents a social-media account that a user has connected via OAuth
+ * through the Late API integration layer.
+ */
+
+// ── SchedulingConnectedAccountDTO ────────────────────────────────────────────
+
+/**
+ * Response DTO for a single connected social account.
+ * Returned in list form by GET /social/accounts.
+ */
+export class SchedulingConnectedAccountDTO {
+  /** Internal (Late) account identifier */
+  id: string;
+  platform: string;
+  username: string;
+  display_name?: string;
+  avatar_url?: string;
+
+  constructor(data: SchedulingConnectedAccountDTO) {
+    this.id = data.id;
+    this.platform = data.platform;
+    this.username = data.username;
+    this.display_name = data.display_name;
+    this.avatar_url = data.avatar_url;
+  }
+}
+
+// ── SchedulingConnectAccountResultDTO ────────────────────────────────────────
+
+/**
+ * Response DTO returned after initiating an OAuth account connection.
+ * The client should redirect the user to the returned URL.
+ */
+export class SchedulingConnectAccountResultDTO {
+  /** OAuth redirect URL the client must navigate to */
+  url: string;
+  platform: string;
+
+  constructor(data: SchedulingConnectAccountResultDTO) {
+    this.url = data.url;
+    this.platform = data.platform;
+  }
+}
+
+// ── SchedulingPinterestBoardDTO ───────────────────────────────────────────────
+
+/**
+ * A Pinterest board that the connected account has access to.
+ * Returned by GET /social/accounts/pinterest-boards.
+ */
+export class SchedulingPinterestBoardDTO {
+  id: string;
+  name: string;
+
+  constructor(data: SchedulingPinterestBoardDTO) {
+    this.id = data.id;
+    this.name = data.name;
+  }
+}
+
+// ── SchedulingAccountFollowerStatDTO ─────────────────────────────────────────
+
+/**
+ * Latest follower count for a single platform.
+ * Returned by GET /social/accounts/follower-stats.
+ */
+export class SchedulingAccountFollowerStatDTO {
+  platform: string;
+  followers: number;
+  date: string;
+
+  constructor(data: SchedulingAccountFollowerStatDTO) {
+    this.platform = data.platform;
+    this.followers = data.followers;
+    this.date = data.date;
+  }
+}

package/src/types/scheduling/I_SchedulingInbox.ts

@@ -0,0 +1,118 @@
+/**
+ * Scheduling domain — Inbox DTOs
+ *
+ * Covers direct-message conversations and post comments received through
+ * the connected social accounts.
+ */
+
+// ── SchedulingInboxConversationDTO ────────────────────────────────────────────
+
+/**
+ * A DM conversation (thread) entry.
+ * Returned by GET /social/inbox/messages.
+ */
+export class SchedulingInboxConversationDTO {
+  id: string;
+  platform: string;
+  accountId: string;
+  senderId: string;
+  senderName: string;
+  senderAvatarUrl?: string;
+  snippet: string;
+  receivedAt: string;
+  isUnread: boolean;
+
+  constructor(data: SchedulingInboxConversationDTO) {
+    this.id = data.id;
+    this.platform = data.platform;
+    this.accountId = data.accountId;
+    this.senderId = data.senderId;
+    this.senderName = data.senderName;
+    this.senderAvatarUrl = data.senderAvatarUrl;
+    this.snippet = data.snippet;
+    this.receivedAt = data.receivedAt;
+    this.isUnread = data.isUnread;
+  }
+}
+
+// ── SchedulingInboxPostWithCommentsDTO ────────────────────────────────────────
+
+/**
+ * A published post that has comments attached.
+ * Returned by GET /social/inbox/comments.
+ */
+export class SchedulingInboxPostWithCommentsDTO {
+  postId: string;
+  platform: string;
+  accountId: string;
+  contentSnippet: string;
+  publishedAt: string;
+  commentCount: number;
+  thumbnailUrl?: string;
+
+  constructor(data: SchedulingInboxPostWithCommentsDTO) {
+    this.postId = data.postId;
+    this.platform = data.platform;
+    this.accountId = data.accountId;
+    this.contentSnippet = data.contentSnippet;
+    this.publishedAt = data.publishedAt;
+    this.commentCount = data.commentCount;
+    this.thumbnailUrl = data.thumbnailUrl;
+  }
+}
+
+// ── SchedulingInboxCommentDTO ─────────────────────────────────────────────────
+
+/**
+ * A single comment (or nested reply) on a post.
+ * Returned by GET /social/inbox/comments/:postId/thread.
+ */
+export class SchedulingInboxCommentDTO {
+  id: string;
+  authorName: string;
+  authorAvatarUrl?: string;
+  text: string;
+  createdAt: string;
+  replies?: SchedulingInboxCommentDTO[];
+
+  constructor(data: SchedulingInboxCommentDTO) {
+    this.id = data.id;
+    this.authorName = data.authorName;
+    this.authorAvatarUrl = data.authorAvatarUrl;
+    this.text = data.text;
+    this.createdAt = data.createdAt;
+    this.replies = data.replies;
+  }
+}
+
+// ── SchedulingSendMessageDTO ──────────────────────────────────────────────────
+
+/** Input DTO for sending a DM reply. */
+export class SchedulingSendMessageDTO {
+  accountId: string;
+  conversationId: string;
+  text: string;
+
+  constructor(data: SchedulingSendMessageDTO) {
+    this.accountId = data.accountId;
+    this.conversationId = data.conversationId;
+    this.text = data.text;
+  }
+}
+
+// ── SchedulingReplyToCommentDTO ───────────────────────────────────────────────
+
+/** Input DTO for replying to a comment. */
+export class SchedulingReplyToCommentDTO {
+  postId: string;
+  accountId: string;
+  text: string;
+  commentId?: string;
+
+  constructor(data: SchedulingReplyToCommentDTO) {
+    this.postId = data.postId;
+    this.accountId = data.accountId;
+    this.text = data.text;
+    this.commentId = data.commentId;
+  }
+}

package/src/types/scheduling/I_SchedulingPost.ts

@@ -0,0 +1,156 @@
+/**
+ * Scheduling domain — Post / Content DTOs
+ *
+ * Covers content creation, scheduling metadata, per-platform status,
+ * and the media items attached to a post.
+ */
+
+// ── Enums ─────────────────────────────────────────────────────────────────────
+
+export enum SchedulingPostStatus {
+  DRAFT = 'draft',
+  SCHEDULED = 'scheduled',
+  PUBLISHED = 'published',
+  FAILED = 'failed',
+  PARTIAL = 'partial',
+}
+
+// ── Platform-status map ───────────────────────────────────────────────────────
+
+export type SchedulingPlatformStatusMap = Record<
+  string,
+  'scheduled' | 'published' | 'failed'
+>;
+
+// ── SchedulingPlatformTargetDTO ───────────────────────────────────────────────
+
+export class SchedulingPlatformTargetDTO {
+  platform: string;
+  accountId: string;
+
+  constructor(data?: Partial<SchedulingPlatformTargetDTO>) {
+    if (!data) return;
+    this.platform = data.platform;
+    this.accountId = data.accountId;
+  }
+}
+
+// ── SchedulingMediaItemDTO ────────────────────────────────────────────────────
+
+export class SchedulingMediaItemDTO {
+  type: 'image' | 'video';
+  url: string;
+
+  constructor(data?: Partial<SchedulingMediaItemDTO>) {
+    if (!data) return;
+    this.type = data.type;
+    this.url = data.url;
+  }
+}
+
+// ── SchedulingCreatePostDTO ───────────────────────────────────────────────────
+
+/** Input DTO for creating a new scheduled or immediate post. */
+export class SchedulingCreatePostDTO {
+  content: string;
+  platforms: SchedulingPlatformTargetDTO[];
+  scheduledAt?: string;
+  publishNow?: boolean;
+  mediaItems?: SchedulingMediaItemDTO[];
+  platformSpecificData?: Record<string, Record<string, unknown>>;
+
+  constructor(data?: Partial<SchedulingCreatePostDTO>) {
+    if (!data) return;
+    this.content = data.content;
+    this.platforms = data.platforms;
+    this.scheduledAt = data.scheduledAt;
+    this.publishNow = data.publishNow;
+    this.mediaItems = data.mediaItems;
+    this.platformSpecificData = data.platformSpecificData;
+  }
+}
+
+// ── SchedulingUpdatePostDTO ───────────────────────────────────────────────────
+
+/** Input DTO for updating an existing post's content or scheduled time. */
+export class SchedulingUpdatePostDTO {
+  content?: string;
+  scheduledAt?: string;
+
+  constructor(data?: Partial<SchedulingUpdatePostDTO>) {
+    if (!data) return;
+    this.content = data.content;
+    this.scheduledAt = data.scheduledAt;
+  }
+}
+
+// ── SchedulingPostDTO ─────────────────────────────────────────────────────────
+
+/** Response DTO representing a single post returned from the API. */
+export class SchedulingPostDTO {
+  id: string;
+  latePostId?: string;
+  platforms: string[];
+  platformStatuses: SchedulingPlatformStatusMap;
+  /** Per-platform URLs to the published post (e.g. { instagram: 'https://...' }). */
+  postUrls?: Record<string, string>;
+  scheduledAt?: string;
+  publishedAt?: string;
+  status: SchedulingPostStatus;
+  contentSnippet?: string;
+  createdAt: string;
+  updatedAt: string;
+
+  constructor(data: SchedulingPostDTO) {
+    this.id = data.id;
+    this.latePostId = data.latePostId;
+    this.platforms = data.platforms;
+    this.platformStatuses = data.platformStatuses;
+    this.postUrls = data.postUrls;
+    this.scheduledAt = data.scheduledAt;
+    this.publishedAt = data.publishedAt;
+    this.status = data.status;
+    this.contentSnippet = data.contentSnippet;
+    this.createdAt = data.createdAt;
+    this.updatedAt = data.updatedAt;
+  }
+}
+
+// ── SchedulingPostListParamsDTO ───────────────────────────────────────────────
+
+/** Query parameters for listing posts with optional filters. */
+export class SchedulingPostListParamsDTO {
+  fromDate?: string;
+  toDate?: string;
+  status?: string;
+  limit?: number;
+  offset?: number;
+
+  constructor(data: SchedulingPostListParamsDTO) {
+    this.fromDate = data.fromDate;
+    this.toDate = data.toDate;
+    this.status = data.status;
+    this.limit = data.limit;
+    this.offset = data.offset;
+  }
+}
+
+// ── SchedulingContentCalendarDTO ─────────────────────────────────────────────
+
+/**
+ * Response DTO for the content calendar view.
+ * Groups posts by ISO date string for visual rendering.
+ */
+export class SchedulingContentCalendarDTO {
+  /** ISO date → posts scheduled on that date */
+  postsByDate: Record<string, SchedulingPostDTO[]>;
+  /** ISO range covered by the calendar view */
+  fromDate: string;
+  toDate: string;
+
+  constructor(data: SchedulingContentCalendarDTO) {
+    this.postsByDate = data.postsByDate;
+    this.fromDate = data.fromDate;
+    this.toDate = data.toDate;
+  }
+}

package/src/types/scheduling/I_SchedulingProUpgrade.ts

@@ -0,0 +1,78 @@
+/**
+ * Scheduling domain — Pro Upgrade / Subscription DTOs
+ *
+ * Covers subscription tier state, Stripe checkout flows,
+ * and the customer portal redirect.
+ */
+
+// ── SchedulingSubscriptionTier ────────────────────────────────────────────────
+
+export type SchedulingSubscriptionTier = 'free' | 'pro';
+
+// ── SchedulingSubscriptionStatus ─────────────────────────────────────────────
+
+export type SchedulingSubscriptionStatus = 'active' | 'canceled' | 'expired';
+
+// ── SchedulingSubscriptionInfoDTO ────────────────────────────────────────────
+
+/**
+ * Current subscription state for the authenticated user.
+ * Returned by GET /social/subscription.
+ */
+export class SchedulingSubscriptionInfoDTO {
+  tier: SchedulingSubscriptionTier;
+  status: SchedulingSubscriptionStatus;
+  expiresAt: string | null;
+
+  constructor(data: SchedulingSubscriptionInfoDTO) {
+    this.tier = data.tier;
+    this.status = data.status;
+    this.expiresAt = data.expiresAt;
+  }
+}
+
+// ── SchedulingCheckoutSessionResultDTO ───────────────────────────────────────
+
+/**
+ * Response DTO for POST /social/subscription/checkout.
+ * The client should redirect to the returned URL to complete payment.
+ */
+export class SchedulingCheckoutSessionResultDTO {
+  url: string;
+
+  constructor(data: SchedulingCheckoutSessionResultDTO) {
+    this.url = data.url;
+  }
+}
+
+// ── SchedulingPortalSessionResultDTO ─────────────────────────────────────────
+
+/**
+ * Response DTO for POST /social/subscription/portal.
+ * The client should redirect to the returned URL to manage billing.
+ */
+export class SchedulingPortalSessionResultDTO {
+  url: string;
+
+  constructor(data: SchedulingPortalSessionResultDTO) {
+    this.url = data.url;
+  }
+}
+
+// ── SchedulingProUpgradeDTO ───────────────────────────────────────────────────
+
+/**
+ * Aggregated Pro-upgrade context DTO.
+ * Combines subscription info with action URLs for UI display.
+ */
+export class SchedulingProUpgradeDTO {
+  subscriptionInfo: SchedulingSubscriptionInfoDTO;
+  checkoutUrl?: string;
+  portalUrl?: string;
+
+  constructor(data: SchedulingProUpgradeDTO) {
+    this.subscriptionInfo = data.subscriptionInfo;
+    this.checkoutUrl = data.checkoutUrl;
+    this.portalUrl = data.portalUrl;
+  }
+}

package/src/types/scheduling/index.ts

@@ -0,0 +1,12 @@
+/**
+ * Scheduling domain — barrel export
+ *
+ * All scheduling DTOs are available from 'ad2app-lib/types' via:
+ *   import { SchedulingPostDTO, SchedulingAnalyticsKpiDTO, ... } from 'ad2app-lib/types';
+ */
+
+export * from './I_SchedulingPost';
+export * from './I_SchedulingAnalytics';
+export * from './I_SchedulingConnectedAccount';
+export * from './I_SchedulingInbox';
+export * from './I_SchedulingProUpgrade';