@armoyu/core 1.0.0

package/src/models/index.ts

@@ -0,0 +1,37 @@
+export * from './auth/User';
+export * from './auth/Role';
+export * from './auth/Session';
+export * from './social/Post';
+export * from './social/Comment';
+export * from './social/Story';
+export * from './social/Chat';
+export * from './social/ChatMessage';
+export * from './social/Notification';
+export * from './social/NotificationSender';
+export * from './social/Note';
+export * from './social/Leaderboard';
+export * from './community/Group';
+export * from './community/Giveaway';
+export * from './community/Forum';
+export * from './community/Workplace';
+export * from './community/Event';
+export * from './community/Station';
+export * from './community/Survey';
+export * from './community/SurveyAnswer';
+export * from './community/School';
+export * from './community/Faculty';
+export * from './community/Classroom';
+export * from './community/SchoolTeam';
+export * from './community/Team';
+export * from './store/StoreItem';
+export * from './shop/Product';
+export * from './shop/Order';
+export * from './shop/CartItem';
+export * from './core/PlatformStats';
+export * from './core/SystemSettings';
+export * from './social/SupportTicket';
+export * from './content/Game';
+export * from './content/Media';
+export * from './content/Mod';
+export * from './content/News';
+export * from './content/Project';

package/src/models/shop/CartItem.ts

@@ -0,0 +1,31 @@
+import { Product } from './Product';
+
+export class CartItem {
+  id: string; // Internal unique ID for the cart item
+  product: Product;
+  quantity: number;
+  addedAt: number;
+
+  constructor(data: Partial<CartItem>) {
+    this.product = data.product || new Product({});
+    this.id = data.id || `cart_${this.product.id}_${Date.now()}`;
+    this.quantity = data.quantity || 1;
+    this.addedAt = data.addedAt || Date.now();
+  }
+
+  /**
+   * Calculate total price for this item based on quantity and display price.
+   */
+  getTotalPrice(): number {
+    return this.product.getDisplayPrice() * this.quantity;
+  }
+
+  static fromJSON(json: any): CartItem {
+    return new CartItem({
+      id: json.id || '',
+      product: json.product ? Product.fromJSON(json.product) : undefined,
+      quantity: json.quantity || 1,
+      addedAt: json.addedAt || Date.now()
+    });
+  }
+}

package/src/models/shop/Order.ts

@@ -0,0 +1,48 @@
+import { CartItem } from './CartItem';
+
+export type OrderStatus = 'pending' | 'completed' | 'canceled' | 'shipped';
+
+export class Order {
+  id: string;
+  items: CartItem[];
+  total: number;
+  status: OrderStatus;
+  createdAt: number;
+  paymentMethod: 'credit_card' | 'armoyu_coin' | 'paypal';
+
+  constructor(data: Partial<Order>) {
+    this.id = data.id || '';
+    this.items = data.items || [];
+    this.total = data.total || 0;
+    this.status = data.status || 'pending';
+    this.createdAt = data.createdAt || Date.now();
+    this.paymentMethod = data.paymentMethod || 'credit_card';
+  }
+
+  /**
+   * Static factory to create an Order instance from JSON.
+   */
+  static fromJSON(json: any): Order {
+    return new Order({
+      id: json.id || '',
+      items: Array.isArray(json.items) ? json.items.map((i: any) => CartItem.fromJSON(i)) : [],
+      total: json.total || json.total_amount || 0,
+      status: (json.status || 'pending') as OrderStatus,
+      createdAt: json.createdAt || json.created_at || Date.now(),
+      paymentMethod: (json.paymentMethod || json.payment_method || 'credit_card') as 'credit_card' | 'armoyu_coin' | 'paypal'
+    });
+  }
+
+  /**
+   * Returns a user-friendly status name in Turkish.
+   */
+  getStatusLabel(): string {
+    switch (this.status) {
+      case 'pending': return 'Hazırlanıyor';
+      case 'completed': return 'Tamamlandı';
+      case 'shipped': return 'Kargoya Verildi';
+      case 'canceled': return 'İptal Edildi';
+      default: return this.status;
+    }
+  }
+}

package/src/models/shop/Product.ts

@@ -0,0 +1,61 @@
+export class Product {
+  id: string;
+  name: string;
+  description: string;
+  price: number;
+  discountPrice?: number;
+  image: string;
+  category: string;
+  stock: number;
+  tags?: string[];
+  isFeatured: boolean = false;
+  badge?: string;
+
+  constructor(data: Partial<Product>) {
+    this.id = data.id || '';
+    this.name = data.name || '';
+    this.description = data.description || '';
+    this.price = data.price || 0;
+    this.discountPrice = data.discountPrice;
+    this.image = data.image || '';
+    this.category = data.category || '';
+    this.stock = data.stock || 0;
+    this.tags = data.tags || [];
+    this.isFeatured = data.isFeatured || false;
+    this.badge = data.badge;
+  }
+
+  /**
+   * Helper to get the display price (discounted if available)
+   */
+  getDisplayPrice(): number {
+    return this.discountPrice && this.discountPrice < this.price 
+      ? this.discountPrice 
+      : this.price;
+  }
+
+  static fromJSON(json: any): Product {
+    const parsePrice = (p: any): number => {
+      if (typeof p === 'number') return p;
+      if (typeof p === 'string') {
+        const cleaned = p.replace(/[₺,]/g, '').replace(' ', '');
+        return parseFloat(cleaned) || 0;
+      }
+      return 0;
+    };
+
+    return new Product({
+      id: json.id || '',
+      name: json.name || json.product_name || '',
+      description: json.description || json.desc || '',
+      price: parsePrice(json.price),
+      discountPrice: json.discountPrice !== undefined ? parsePrice(json.discountPrice) : undefined,
+      image: json.image || json.img_url || '',
+      category: json.category || 'Genel',
+      stock: json.stock || 0,
+      tags: json.tags || [],
+      isFeatured: json.isFeatured || json.is_featured || false,
+      badge: json.badge
+    });
+  }
+}

package/src/models/social/Chat.ts

@@ -0,0 +1,47 @@
+import { User } from '../auth/User';
+import { ChatMessage } from './ChatMessage';
+
+/**
+ * Represents a Chat conversation or summary.
+ */
+export class Chat {
+  id: string = '';
+  participants: User[] = [];
+  name: string = '';
+  avatar: string = '';
+  lastMessage: ChatMessage | null = null;
+  time: string = '';
+  unreadCount: number = 0;
+  isOnline: boolean = false;
+  lastSeen: string = '';
+  updatedAt: number = 0;
+  isGroup: boolean = false;
+  isFavorite: boolean = false;
+  messages: ChatMessage[] = [];
+
+  constructor(data: Partial<Chat>) {
+    Object.assign(this, data);
+  }
+
+  /**
+   * Instantiates a Chat object from a JSON object.
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  static fromJSON(json: Record<string, any>): Chat {
+    return new Chat({
+      id: json.id || '',
+      participants: Array.isArray(json.participants) ? json.participants.map((p: Record<string, any>) => User.fromJSON(p)) : [],
+      name: json.name || '',
+      avatar: json.avatar || '',
+      lastMessage: json.lastMessage ? ChatMessage.fromJSON(json.lastMessage) : (json.last_message ? ChatMessage.fromJSON(json.last_message) : null),
+      time: json.time || '',
+      unreadCount: json.unreadCount || json.unread_count || 0,
+      isOnline: json.isOnline || json.is_online || false,
+      lastSeen: json.lastSeen || json.last_seen || '',
+      updatedAt: json.updatedAt || json.updated_at || 0,
+      isGroup: json.isGroup || json.is_group || false,
+      isFavorite: json.isFavorite || json.is_favorite || false,
+      messages: Array.isArray(json.messages) ? json.messages.map((m: any) => ChatMessage.fromJSON(m)) : [],
+    });
+  }
+}

package/src/models/social/ChatMessage.ts

@@ -0,0 +1,30 @@
+import { User } from '../auth/User';
+
+/**
+ * Represents a single message in a Chat.
+ */
+export class ChatMessage {
+  id: string = '';
+  sender: User | null = null;
+  content: string = '';
+  timestamp: string = '';
+  isSystem: boolean = false;
+
+  constructor(data: Partial<ChatMessage>) {
+    Object.assign(this, data);
+  }
+
+  /**
+   * Instantiates a ChatMessage object from a JSON object.
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  static fromJSON(json: Record<string, any>): ChatMessage {
+    return new ChatMessage({
+      id: json.id || '',
+      sender: json.sender ? User.fromJSON(json.sender) : (json.sender_name ? new User({ displayName: json.sender_name }) : null),
+      content: json.content || json.text || '',
+      timestamp: json.timestamp || json.time || '',
+      isSystem: json.isSystem || json.is_system || false,
+    });
+  }
+}

package/src/models/social/Comment.ts

@@ -0,0 +1,38 @@
+import { User } from '../auth/User';
+
+/**
+ * Represents a Comment (Yorum) in the aramizdakioyuncu.com platform.
+ */
+export class Comment {
+  id: string = '';
+  author: User | null = null;
+  text: string = '';
+  date: string = '';
+  replies: Comment[] = [];
+
+  constructor(data: Partial<Comment>) {
+    Object.assign(this, data);
+  }
+
+  /**
+   * Adds a reply to the comment.
+   */
+  addReply(reply: Comment): void {
+    this.replies.push(reply);
+  }
+
+  /**
+   * Instantiates a Comment object from a JSON object.
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  static fromJSON(json: Record<string, any>): Comment {
+    return new Comment({
+      id: json.id || '',
+      author: json.user ? User.fromJSON(json.user) : (json.author_name ? new User({ displayName: json.author_name }) : null),
+      text: json.text || json.comment || '',
+      date: json.date || json.created_at || '',
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      replies: Array.isArray(json.replies) ? json.replies.map((r: any) => Comment.fromJSON(r)) : [],
+    });
+  }
+}

package/src/models/social/Group.ts

@@ -0,0 +1,63 @@
+import { User } from '../auth/User';
+
+/**
+ * Represents a Group/Community/Guild in the aramizdakioyuncu.com platform.
+ */
+export class Group {
+  id: string = '';
+  name: string = '';
+  shortName: string = '';
+  slug: string = '';
+  description: string = '';
+  avatar: string = ''; // Keep for backward compatibility
+  logo: string = '';
+  banner: string = '';
+  coverImage: string = ''; // Keep for backward compatibility
+  memberCount: number = 0;
+  isPrivate: boolean = false;
+  category: string = '';
+  tag: string = '';
+  recruitment: string = 'Açık';
+  date: string = '';
+  owner: User | null = null;
+  moderators: User[] = [];
+  members: User[] = [];
+  permissions: string[] = [];
+
+  constructor(data: Partial<Group>) {
+    Object.assign(this, data);
+    if (!this.slug && this.name) {
+      this.slug = this.name.toLowerCase().replace(/\s+/g, '-').replace(/[^a-z0-9-]/g, '');
+    }
+    if (!this.logo && this.avatar) this.logo = this.avatar;
+    if (!this.banner && this.coverImage) this.banner = this.coverImage;
+  }
+
+  /**
+   * Instantiates a Group object from a JSON object.
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  static fromJSON(json: Record<string, any>): Group {
+    return new Group({
+      id: json.id || '',
+      name: json.name || '',
+      shortName: json.shortName || json.tag || '',
+      slug: json.slug || '',
+      description: json.description || '',
+      avatar: json.avatar || '',
+      logo: json.logo || json.avatar || '',
+      banner: json.banner || json.coverImage || json.cover_image || '',
+      coverImage: json.coverImage || json.cover_image || '',
+      memberCount: json.memberCount || json.member_count || 0,
+      isPrivate: json.isPrivate || json.is_private || false,
+      category: json.category || '',
+      tag: json.tag || '',
+      recruitment: json.recruitment || 'Açık',
+      date: json.date || '',
+      owner: json.owner ? User.fromJSON(json.owner) : null,
+      moderators: Array.isArray(json.moderators) ? json.moderators.map((m: any) => User.fromJSON(m)) : [],
+      members: Array.isArray(json.members) ? json.members.map((m: any) => User.fromJSON(m)) : [],
+      permissions: Array.isArray(json.permissions) ? json.permissions : [],
+    });
+  }
+}

package/src/models/social/Leaderboard.ts

@@ -0,0 +1,57 @@
+import { User } from '../auth/User';
+
+/**
+ * Represents an entry in a leaderboard/ranking list.
+ */
+export class LeaderboardEntry {
+  displayName: string = '';
+  username: string = '';
+  score: string = '';
+  avatar: string = '';
+
+  constructor(data: Partial<LeaderboardEntry>) {
+    Object.assign(this, data);
+  }
+}
+
+/**
+ * Utility class to manage and generate various leaderboards across the platform.
+ */
+export class Leaderboard {
+  /**
+   * Generates a level-based ranking from a list of users.
+   */
+  static getLevelRankings(users: User[], limit: number = 5): LeaderboardEntry[] {
+    return [...users]
+      .sort((a, b) => (b.level || 0) - (a.level || 0) || (b.xp || 0) - (a.xp || 0))
+      .slice(0, limit)
+      .map(user => new LeaderboardEntry({
+        displayName: user.displayName || user.username,
+        username: user.username,
+        score: `LVL ${user.level || 1}`,
+        avatar: user.avatar
+      }));
+  }
+
+  /**
+   * Generates a popularity-based ranking from a list of users.
+   */
+  static getPopularityRankings(users: User[], limit: number = 5): LeaderboardEntry[] {
+    return [...users]
+      .sort((a, b) => (b.popScore || 0) - (a.popScore || 0))
+      .slice(0, limit)
+      .map(user => {
+        const score = user.popScore || 0;
+        const formattedScore = score >= 1000 
+          ? (score / 1000).toFixed(1) + 'k' 
+          : score.toString();
+          
+        return new LeaderboardEntry({
+          displayName: user.displayName || user.username,
+          username: user.username,
+          score: formattedScore,
+          avatar: user.avatar
+        });
+      });
+  }
+}

package/src/models/social/Note.ts

@@ -0,0 +1,28 @@
+import { User } from '../auth/User';
+
+/**
+ * Represents a "Note" (Instagram-style status bubble) in the aramizdakioyuncu.com platform.
+ */
+export class Note {
+  id: string = '';
+  user: User | null = null;
+  note: string = '';
+  isMe: boolean = false;
+
+  constructor(data: Partial<Note>) {
+    Object.assign(this, data);
+  }
+
+  /**
+   * Instantiates a Note object from a JSON object.
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  static fromJSON(json: Record<string, any>): Note {
+    return new Note({
+      id: json.id || '',
+      user: json.user ? User.fromJSON(json.user) : null,
+      note: json.note || '',
+      isMe: json.isMe || false,
+    });
+  }
+}

package/src/models/social/Notification.ts

@@ -0,0 +1,99 @@
+import { User } from '../auth/User';
+import { Group } from '../community/Group';
+import { Post } from './Post';
+import { NotificationSender, NotificationType, NotificationCategory } from './NotificationSender';
+
+/**
+ * Represents a Notification in the aramizdakioyuncu.com platform.
+ */
+export class Notification {
+  id: string = '';
+  type: NotificationType = 'SYSTEM_ALERT';
+  category: NotificationCategory = 'SYSTEM';
+  title: string = '';
+  message: string = '';
+  context: string = ''; // Detailed context (snippet of comment, etc)
+  sender?: NotificationSender;
+  link: string = '';
+  isRead: boolean = false;
+  isClickable: boolean = true; // New property
+  createdAt: string = '';
+
+  // Direct Associated IDs (Legacy supporting)
+  postId?: string;
+  commentId?: string;
+  eventId?: string;
+  groupId?: string;
+
+  // Rich Objects (OO approach)
+  group?: Group;
+  post?: Post;
+  // event?: Event; // Add when Event is ready
+
+  constructor(data: Partial<Notification>) {
+    Object.assign(this, data);
+    
+    // 1. Sync from Post object if exists
+    if (this.post) {
+      this.postId = this.post.id;
+      if (!this.context) {
+        // Create context snippet from post content
+        this.context = this.post.content.length > 50 
+          ? this.post.content.substring(0, 47) + '...'
+          : this.post.content;
+      }
+    }
+
+    // 2. Auto-generate link from objects (OO)
+    if (!this.link) {
+      if (this.group) {
+        this.link = this.group.getGroupUrl();
+      } else if (this.groupId) {
+        // Fallback for ID strings
+        const targetSlug = this.groupId.toLowerCase().replace(/\s+/g, '-');
+        this.link = `/gruplar/${targetSlug}`;
+      } else if (this.postId) {
+        this.link = `/?post=${this.postId}`; 
+      } else if (this.sender?.url) {
+        this.link = this.sender.url;
+      }
+    }
+
+    // 3. Sync title/metadata if missing but object exists
+    if (!this.title && this.group && this.type === 'GROUP_INVITE') {
+      this.title = 'Grup Daveti';
+      this.message = `${this.group.name} grubuna davet edildin.`;
+    }
+
+    // Default to system sender if not provided for system notifications
+    if (this.category === 'SYSTEM') {
+      if (!this.sender) this.sender = NotificationSender.system();
+      this.isClickable = false;
+      this.link = ''; // System messages shouldn't have links usually
+    }
+  }
+
+  /**
+   * Instantiates a Notification object from a JSON object.
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  static fromJSON(json: Record<string, any>): Notification {
+    return new Notification({
+      id: json.id || '',
+      type: json.type || 'SYSTEM_ALERT',
+      category: json.category || 'SYSTEM',
+      title: json.title || '',
+      message: json.message || '',
+      context: json.context || '',
+      sender: json.sender ? new NotificationSender(json.sender) : undefined,
+      link: json.link || '',
+      isRead: json.isRead || false,
+      createdAt: json.createdAt || json.created_at || '',
+      postId: json.postId || json.post_id,
+      commentId: json.commentId || json.comment_id,
+      eventId: json.eventId || json.event_id,
+      groupId: json.groupId || json.group_id,
+      group: json.group ? Group.fromJSON(json.group) : undefined,
+    });
+  }
+}

package/src/models/social/NotificationSender.ts

@@ -0,0 +1,36 @@
+export type NotificationType = 
+  | 'POST_LIKE' | 'POST_COMMENT' | 'POST_MENTION' 
+  | 'GROUP_INVITE' | 'GROUP_JOIN_REQUEST' | 'GROUP_ANNOUNCEMENT'
+  | 'EVENT_INVITE' | 'EVENT_REMINDER'
+  | 'FRIEND_REQUEST' | 'FRIEND_ACCEPT'
+  | 'SYSTEM_ALERT' | 'SYSTEM_UPDATE';
+
+export type NotificationCategory = 'SOCIAL' | 'GROUP' | 'EVENT' | 'SYSTEM';
+export type SenderType = 'USER' | 'GROUP' | 'SYSTEM';
+
+/**
+ * Interface representing a standardized sender for notifications.
+ */
+export class NotificationSender {
+  id: string = '';
+  name: string = '';
+  avatar: string = '';
+  type: SenderType = 'SYSTEM';
+  url?: string;
+
+  constructor(data: Partial<NotificationSender>) {
+    Object.assign(this, data);
+  }
+
+  /**
+   * Helper to create a system sender.
+   */
+  static system(): NotificationSender {
+    return new NotificationSender({
+      id: 'system',
+      name: 'ARMOYU',
+      avatar: 'https://armoyu.com/assets/img/armoyu_logo.png',
+      type: 'SYSTEM'
+    });
+  }
+}

package/src/models/social/Post.ts

@@ -0,0 +1,75 @@
+import { User } from '../auth/User';
+
+export interface PostMedia {
+  type: 'image' | 'video';
+  url: string;
+}
+
+export interface PostStats {
+  likes: number;
+  comments: number;
+  reposts: number;
+  shares: number;
+}
+
+export interface PostComment {
+  id: string;
+  author: User;
+  content: string;
+  createdAt: string;
+  likes?: number;
+  replies?: PostComment[];
+}
+
+/**
+ * Represents a Post (Gönderi/Paylaşım) in the aramizdakioyuncu.com platform.
+ */
+export class Post {
+  id: string = '';
+  author: User | null = null;
+  content: string = '';
+  media: PostMedia[] = [];
+  createdAt: string = '';
+  stats: PostStats = { likes: 0, comments: 0, reposts: 0, shares: 0 };
+  hashtags: string[] = [];
+  isPending: boolean = false;
+  repostOf?: Post; // Original post if this is a repost
+
+  // Real-time Lists
+  likeList: User[] = [];
+  repostList: User[] = [];
+  commentList: PostComment[] = [];
+
+  constructor(data: Partial<Post>) {
+    Object.assign(this, data);
+  }
+
+  /**
+   * Instantiates a Post object from a JSON object.
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  static fromJSON(json: Record<string, any>): Post {
+    return new Post({
+      id: json.id || '',
+      author: json.author ? User.fromJSON(json.author) : null,
+      content: json.content || '',
+      media: Array.isArray(json.media) ? json.media : (json.imageUrl ? [{ type: 'image', url: json.imageUrl }] : []),
+      createdAt: json.createdAt || json.created_at || '',
+      stats: json.stats || {
+        likes: json.likeCount || 0,
+        comments: json.commentCount || 0,
+        reposts: json.repostCount || 0,
+        shares: json.shareCount || 0,
+      },
+      hashtags: json.hashtags || [],
+      likeList: Array.isArray(json.likeList) ? json.likeList.map(User.fromJSON) : [],
+      repostList: Array.isArray(json.repostList) ? json.repostList.map(User.fromJSON) : [],
+      commentList: Array.isArray(json.commentList) ? json.commentList.map((c: any) => ({
+        ...c,
+        author: User.fromJSON(c.author),
+        replies: Array.isArray(c.replies) ? c.replies.map((r: any) => ({ ...r, author: User.fromJSON(r.author) })) : []
+      })) : [],
+      repostOf: json.repostOf ? Post.fromJSON(json.repostOf) : undefined
+    });
+  }
+}