@addn/sdk 1.0.0

package/src/types/customer.types.ts

@@ -0,0 +1,25 @@
+export interface Customer {
+  id: string;
+  organization_id: string;
+  name: string;
+  brand_name?: string;
+  email?: string;
+  phone?: string;
+  website?: string;
+  logo_url?: string;
+  notes?: string;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface CreateCustomerPayload {
+  name: string;
+  brand_name?: string;
+  email?: string;
+  phone?: string;
+  website?: string;
+  logo_url?: string;
+  notes?: string;
+}
+
+export interface UpdateCustomerPayload extends Partial<CreateCustomerPayload> {}

package/src/types/index.ts

@@ -0,0 +1,682 @@
+// ============================================================================
+// ADDN SDK - Centralized Domain Interfaces & Data Transfer Objects (DTOs)
+// ============================================================================
+
+// ----------------------------------------------------------------------------
+// 1. Core API Envelopes & Utility Types
+// ----------------------------------------------------------------------------
+export interface ApiResponse<T = any> {
+  success: boolean;
+  message?: string;
+  data: T;
+  code?: string;
+  details?: any;
+}
+
+export interface PaginatedMeta {
+  total: number;
+  page: number;
+  limit: number;
+  pages: number;
+}
+
+export interface PaginatedResponse<T = any> {
+  success: boolean;
+  message?: string;
+  data: T[];
+  meta: PaginatedMeta;
+}
+
+export interface ValidationErrorDetail {
+  field: string;
+  message: string;
+  type?: string;
+}
+
+// ----------------------------------------------------------------------------
+// 2. Authentication & User Profile Domain
+// ----------------------------------------------------------------------------
+export interface UserProfile {
+  id: string;
+  _id?: string;
+  email: string;
+  full_name: string;
+  role?: "admin" | "org_admin" | "member" | "viewer" | string;
+  avatar_url?: string | null;
+  is_active: boolean;
+  is_superuser?: boolean;
+  organization_id?: string | null;
+  org_id?: string | null;
+  org_name?: string | null;
+  organization?: any;
+  organization_role?: 'owner' | 'admin' | 'member' | string;
+  has_pending_join_request?: boolean;
+  onboarding_completed: boolean;
+  created_at?: string;
+  updated_at?: string;
+}
+
+export interface LoginPayload {
+  email?: string;
+  username?: string;
+  password: string;
+}
+
+export interface RegisterPayload {
+  email: string;
+  password: string;
+  full_name: string;
+  organization_name?: string;
+}
+
+export type SignUpPayload = RegisterPayload;
+
+export interface ResetPasswordPayload {
+  token: string;
+  new_password: string;
+}
+
+export interface AuthTokenResponse {
+  access_token: string;
+  refresh_token: string;
+  token_type: string;
+  expires_in?: number;
+  user: UserProfile;
+}
+
+export interface AuthResponse {
+  success: boolean;
+  message?: string;
+  data?: {
+    access_token: string;
+    refresh_token: string;
+    token_type: string;
+    user: UserProfile;
+  };
+  access_token?: string;
+  refresh_token?: string;
+  user?: UserProfile;
+}
+
+export interface PasswordResetRequestPayload {
+  email: string;
+}
+
+export interface PasswordResetConfirmPayload {
+  token: string;
+  new_password: string;
+}
+
+export interface MetaLoginPayload {
+  code: string;
+  redirect_uri: string;
+}
+
+// ----------------------------------------------------------------------------
+// 3. Organization & Workspace Domain
+// ----------------------------------------------------------------------------
+export interface Organization {
+  id: string;
+  _id?: string;
+  name: string;
+  slug?: string;
+  invite_code?: string;
+  join_code?: string;
+  logo_url?: string | null;
+  owner_id?: string;
+  created_by?: string;
+  member_count?: number;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface OrganizationMember {
+  id?: string;
+  user_id: string;
+  email: string;
+  full_name: string;
+  role: 'owner' | 'admin' | 'member' | 'org_admin' | 'viewer' | string;
+  designation?: string;
+  joined_at: string;
+  is_active?: boolean;
+}
+
+export type Member = OrganizationMember;
+
+export interface OrgJoinRequest {
+  id: string;
+  user_id: string;
+  user_email?: string;
+  user_full_name?: string;
+  email?: string;
+  full_name?: string;
+  organization_id: string;
+  org_name?: string;
+  status: 'pending' | 'approved' | 'rejected';
+  created_at: string;
+}
+
+export interface CreateOrgPayload {
+  name: string;
+}
+
+export interface InviteMemberPayload {
+  email: string;
+  role: "org_admin" | "member" | "viewer";
+}
+
+// ----------------------------------------------------------------------------
+// 4. Customer CRM Domain
+// ----------------------------------------------------------------------------
+export interface Customer {
+  id: string;
+  _id?: string;
+  organization_id: string;
+  name: string;
+  brand_name?: string;
+  email?: string;
+  phone?: string;
+  website?: string;
+  logo_url?: string;
+  notes?: string;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface CreateCustomerPayload {
+  name: string;
+  brand_name?: string;
+  email?: string;
+  phone?: string;
+  website?: string;
+  logo_url?: string;
+  notes?: string;
+}
+
+export interface UpdateCustomerPayload extends Partial<CreateCustomerPayload> {}
+
+// ----------------------------------------------------------------------------
+// 5. Projects Domain
+// ----------------------------------------------------------------------------
+export interface ProjectMember {
+  user_id: string;
+  full_name: string;
+  email: string;
+  role: 'editor' | 'viewer' | 'commenter' | string;
+  designation?: string;
+}
+
+export interface ProjectAccount {
+  account_id: string;
+  username: string;
+  platform: string;
+  account_name?: string;
+  profile_picture_url?: string;
+}
+
+export interface Project {
+  id: string;
+  _id?: string;
+  organization_id: string;
+  customer_id?: string | null;
+  name: string;
+  description?: string;
+  client_email?: string;
+  client_phone?: string;
+  brand_details?: string;
+  niche?: string;
+  target_audience?: string;
+  status: 'draft' | 'active' | 'completed' | 'archived' | 'cancelled';
+  start_date?: string;
+  end_date?: string;
+  members?: ProjectMember[];
+  accounts?: ProjectAccount[];
+  plans_count?: number;
+  posts_count?: number;
+  created_by: string;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface CreateProjectPayload {
+  name: string;
+  customer_id?: string;
+  description?: string;
+  client_email?: string;
+  client_phone?: string;
+  brand_details?: string;
+  niche?: string;
+  target_audience?: string;
+  start_date?: string;
+  end_date?: string;
+}
+
+export interface UpdateProjectPayload extends Partial<CreateProjectPayload> {
+  status?: 'draft' | 'active' | 'completed' | 'archived' | 'cancelled';
+}
+
+// ----------------------------------------------------------------------------
+// 6. Content Plans & AI Generator Domain
+// ----------------------------------------------------------------------------
+export type ContentPlanStatus = 'draft' | 'in_review' | 'changes_requested' | 'approved' | 'cancelled' | 'already_scheduled';
+export type ContentFormat = 'post' | 'reel' | 'story' | 'carousel' | 'video' | 'other';
+export type AclRole = 'editor' | 'viewer' | 'commenter';
+
+export interface AccessControlEntry {
+  user_id: string;
+  role: AclRole;
+  is_locked?: boolean;
+}
+
+export interface ApproverEntry {
+  user_id: string;
+  status: string;
+  note?: string;
+  decided_at?: string;
+}
+
+export interface PostItem {
+  id: string;
+  title: string;
+  caption?: string;
+  media_urls?: string[];
+  post_type: "reel" | "carousel" | "single_image" | "story" | string;
+  scheduled_at?: string;
+  status: "draft" | "pending_approval" | "approved" | "rejected" | "published" | string;
+  rejection_reason?: string;
+}
+
+export interface ContentPlan {
+  _id: string;
+  id: string;
+  organization_id: string;
+  project_id: string | null;
+  created_by: string;
+  title: string;
+  status: ContentPlanStatus;
+  content_type: ContentFormat;
+  platform: string;
+  objective?: string;
+  target_audience?: string;
+  content_pillar?: string;
+  core_idea?: string;
+  hook?: string;
+  key_message?: string;
+  call_to_action?: string;
+  visual_direction?: string;
+  script?: string;
+  caption?: string;
+  hashtags?: string;
+  reference_links?: string[];
+  asset_links?: string[];
+  instagram_account_id?: string;
+  due_date?: string;
+  require_client_approval: boolean;
+  access_control: AccessControlEntry[];
+  approvers: ApproverEntry[];
+  computed_user_role?: AclRole;
+  permissions?: {
+    can_edit?: boolean;
+    can_review?: boolean;
+    can_handoff?: boolean;
+    can_approve_directly?: boolean;
+  };
+  scheduling_item_id?: string | null;
+  internal_notes?: string;
+  posts?: PostItem[];
+  created_at: string;
+  updated_at: string;
+}
+
+export interface CreateContentPlanPayload {
+  title?: string;
+  project_id?: string;
+  content_type?: ContentFormat;
+  platform?: string;
+  objective?: string;
+  core_idea?: string;
+  target_audience?: string;
+  content_pillar?: string;
+  hook?: string;
+  key_message?: string;
+  call_to_action?: string;
+  script?: string;
+  caption?: string;
+  hashtags?: string;
+  visual_direction?: string;
+  instagram_account_id?: string;
+  access_control?: AccessControlEntry[];
+  internal_notes?: string;
+  posts?: Partial<PostItem>[];
+}
+
+export interface UpdateContentPlanPayload extends Partial<CreateContentPlanPayload> {
+  status?: ContentPlanStatus;
+}
+
+// ----------------------------------------------------------------------------
+// 7. Post Scheduling & Public Approval Domain
+// ----------------------------------------------------------------------------
+export interface ScheduledPost {
+  id: string;
+  post_id: string;
+  account_id: string;
+  platform: "instagram" | "facebook" | "linkedin" | string;
+  caption: string;
+  media_urls: string[];
+  scheduled_time: string;
+  status: "scheduled" | "processing" | "published" | "failed";
+  error_message?: string;
+  approval_token?: string;
+}
+
+export interface PublicApprovalView {
+  token: string;
+  project_name: string;
+  posts: Array<{
+    id: string;
+    title: string;
+    caption: string;
+    media_urls: string[];
+    post_type: string;
+    status: string;
+  }>;
+}
+
+export interface SubmitApprovalPayload {
+  token: string;
+  post_id: string;
+  action: "approve" | "reject";
+  comment?: string;
+}
+
+// ----------------------------------------------------------------------------
+// 8. Social Media Accounts Domain
+// ----------------------------------------------------------------------------
+export interface ConnectedAccount {
+  id: string;
+  _id?: string;
+  organization_id: string;
+  platform: 'instagram' | 'facebook' | 'linkedin' | string;
+  account_name?: string;
+  username: string;
+  name?: string;
+  account_id?: string;
+  profile_picture_url?: string;
+  status?: 'active' | 'token_expired' | 'error' | string;
+  is_active?: boolean;
+  token_expires_at?: string;
+  connected_at?: string;
+  created_at?: string;
+}
+
+export type SocialAccount = ConnectedAccount;
+
+export interface ConnectAccountPayload {
+  access_token?: string;
+  auth_code?: string;
+  redirect_uri?: string;
+  platform: 'instagram' | 'facebook' | 'linkedin' | string;
+}
+
+export interface DevConnectPayload {
+  username: string;
+  account_id?: string;
+  instagram_account_id?: string;
+  facebook_page_id?: string;
+  access_token?: string;
+  platform?: string;
+}
+
+// ----------------------------------------------------------------------------
+// 9. Analytics & Insights Domain
+// ----------------------------------------------------------------------------
+export interface InsightValue {
+  value: number;
+  end_time?: string;
+}
+
+export interface InsightMetric {
+  name: string;
+  period: string;
+  total_value?: { value: number };
+  values?: InsightValue[];
+}
+
+export interface WeeklyBestTime {
+  day: string;
+  full_day: string;
+  best_time_slot: string;
+  level: 'PEAK' | 'HIGH' | 'MODERATE';
+  is_best_overall: boolean;
+}
+
+export interface MediaMetrics {
+  id: string;
+  media_type: string;
+  like_count: number;
+  comments_count: number;
+  engagement_score: number;
+  timestamp: string;
+  thumbnail_url?: string;
+  permalink: string;
+}
+
+export interface TopComment {
+  id: string;
+  text: string;
+  username: string;
+  like_count: number;
+  timestamp: string;
+}
+
+export interface InstagramAnalyticsData {
+  profile: {
+    id: string;
+    username: string;
+    name: string;
+    profile_picture_url: string;
+    followers_count: number;
+    follows_count: number;
+    media_count: number;
+  };
+  insights: InsightMetric[];
+  historical_trend: {
+    day: string;
+    reach: number;
+    impressions: number;
+    engagement: number;
+    followers: number;
+    follower_growth: number;
+  }[];
+  real_media_metrics: {
+    total_likes: number;
+    total_comments: number;
+    total_shares: number;
+    total_saves: number;
+    recent_posts_analyzed: number;
+    real_engagement: number;
+  };
+  smart_scheduling_insights: {
+    best_day: string;
+    best_time_slot: string;
+    confidence_score: number;
+    recommendation: string;
+    weekly_best_times: WeeklyBestTime[];
+  };
+  top_content: {
+    top_posts: MediaMetrics[];
+    top_reel?: MediaMetrics;
+    top_carousel?: MediaMetrics;
+    top_comments: TopComment[];
+  };
+}
+
+export interface AnalyticsSummary {
+  total_posts: number;
+  total_reach: number;
+  total_engagement: number;
+  average_engagement_rate: number;
+  metrics: InsightMetric[];
+}
+
+// ----------------------------------------------------------------------------
+// 10. Notifications Domain
+// ----------------------------------------------------------------------------
+export interface NotificationItem {
+  id: string;
+  _id?: string;
+  user_id: string;
+  title: string;
+  message: string;
+  type: "info" | "success" | "warning" | "error" | "approval_request" | string;
+  is_read: boolean;
+  link?: string;
+  created_at: string;
+}
+
+export interface NotificationListResponse {
+  notifications: NotificationItem[];
+  unread_count: number;
+}
+
+// ----------------------------------------------------------------------------
+// 11. Storage & Media Asset Domain
+// ----------------------------------------------------------------------------
+export interface MediaAsset {
+  id: string;
+  asset_id: string;
+  filename: string;
+  original_name: string;
+  mime_type: string;
+  media_type: 'image' | 'video' | 'audio' | 'other';
+  file_size: number;
+  storage_path: string;
+  url: string;
+  organization_id: string;
+  project_id?: string;
+  uploaded_by: string;
+  created_at: string;
+}
+
+export interface UploadFileResponse {
+  file_id: string;
+  url: string;
+  filename: string;
+  size_bytes: number;
+  mime_type: string;
+}
+
+export interface PresignedUploadResponse {
+  upload_url: string;
+  presigned_url: string;
+  asset_id: string;
+  storage_path: string;
+  download_url: string;
+  url: string;
+}
+
+// ----------------------------------------------------------------------------
+// 12. Subscriptions & Billing Domain
+// ----------------------------------------------------------------------------
+export interface PlanLimits {
+  schedules_per_day: number | null;
+  schedules_total: number | null;
+  upload_bytes_per_day: number;
+  content_plans_per_day: number | null;
+  ai_plans_per_day: number;
+  captions_per_day: number;
+  campaigns_total: number | null;
+  connected_accounts: number;
+}
+
+export interface SubscriptionPlan {
+  id: string;
+  tier: string;
+  name: string;
+  billing_cycle: "monthly" | "yearly";
+  price_inr: number;
+  price_display: string;
+  price_monthly?: number;
+  price_yearly?: number;
+  features?: string[];
+  max_projects?: number;
+  max_members?: number;
+  max_social_accounts?: number;
+  limits: PlanLimits;
+  razorpay_plan_id?: string;
+  is_active: boolean;
+  sort_order: number;
+}
+
+export interface PaymentRecord {
+  provider_payment_id: string;
+  amount_inr: number;
+  provider?: string;
+  status: string;
+  paid_at: string;
+}
+
+export interface CurrentSubscription {
+  id: string;
+  organization_id: string;
+  organization_name?: string;
+  user_id: string;
+  plan_id: string;
+  tier: string;
+  status: "active" | "trial" | "past_due" | "expired" | "cancelled" | "pending_payment";
+  payment_provider: string;
+  provider_subscription_id: string | null;
+  trial_started_at: string | null;
+  trial_ends_at: string | null;
+  current_period_start: string | null;
+  current_period_end: string | null;
+  cancel_at_period_end: boolean;
+  cancelled_at: string | null;
+  payment_history?: PaymentRecord[];
+  created_at: string;
+  updated_at: string;
+}
+
+export interface UsageStats {
+  schedules_today: number;
+  schedules_total: number;
+  content_plans_today: number;
+  ai_plans_today: number;
+  captions_today: number;
+  upload_bytes_today: number;
+  campaigns_total: number;
+  connected_accounts: number;
+}
+
+export interface QuotaStatus {
+  tier: string;
+  status: string;
+  trial_ends_at: string | null;
+  current_period_end: string | null;
+  limits: PlanLimits;
+  usage: UsageStats;
+  projects_used?: number;
+  projects_limit?: number;
+  members_used?: number;
+  members_limit?: number;
+  accounts_used?: number;
+  accounts_limit?: number;
+  can_create_project?: boolean;
+  can_invite_member?: boolean;
+  can_connect_account?: boolean;
+}
+
+export interface UserSubscription extends CurrentSubscription {}
+
+export interface RazorpayCreateResult {
+  subscription_id: string;
+  razorpay_subscription_id: string;
+  razorpay_key_id: string;
+}
+
+export interface RazorpayVerifyResult {
+  status: string;
+  message: string;
+  subscription_id: string;
+}

package/src/types/notification.types.ts

@@ -0,0 +1,10 @@
+export interface NotificationItem {
+  id: string;
+  user_id: string;
+  title: string;
+  message: string;
+  type: "info" | "success" | "warning" | "error" | "approval_request";
+  is_read: boolean;
+  link?: string;
+  created_at: string;
+}