@thrillee/aegischat 0.1.0

package/src/hooks/useFileUpload.ts

@@ -0,0 +1,25 @@
+// ============================================================================
+// AegisChat React SDK - useFileUpload Hook
+// ============================================================================
+
+import { useState } from 'react';
+import type { FileAttachment, UploadProgress } from '../types';
+
+export interface UseFileUploadOptions {
+  channelId: string;
+}
+
+export interface UseFileUploadReturn {
+  uploadProgress: UploadProgress[];
+  upload: (file: File) => Promise<FileAttachment | null>;
+}
+
+export function useFileUpload(_options: UseFileUploadOptions): UseFileUploadReturn {
+  const [uploadProgress, setUploadProgress] = useState<UploadProgress[]>([]);
+
+  const upload = async (_file: File): Promise<FileAttachment | null> => null;
+
+  return { uploadProgress, upload };
+}
+
+export default useFileUpload;

package/src/hooks/useMentions.ts

@@ -0,0 +1,36 @@
+// ============================================================================
+// AegisChat React SDK - useMentions Hook
+// ============================================================================
+
+export interface UseMentionsOptions {}
+
+export interface UseMentionsReturn {
+  parseMentions: (content: string) => string[];
+  highlightMentions: (content: string) => string;
+  isUserMentioned: (content: string, userId: string) => boolean;
+}
+
+export function useMentions(_options: UseMentionsOptions = {}): UseMentionsReturn {
+  const parseMentions = (content: string): string[] => {
+    const mentionRegex = /@\[([^\]]+)\]\(([^)]+)\)/g;
+    const mentions: string[] = [];
+    let match;
+    while ((match = mentionRegex.exec(content)) !== null) {
+      mentions.push(match[2]);
+    }
+    return mentions;
+  };
+
+  const highlightMentions = (content: string): string => {
+    return content.replace(/@\[([^\]]+)\]\(([^)]+)\)/g, '<span class="mention">@$1</span>');
+  };
+
+  const isUserMentioned = (content: string, userId: string): boolean => {
+    const mentions = parseMentions(content);
+    return mentions.includes(userId);
+  };
+
+  return { parseMentions, highlightMentions, isUserMentioned };
+}
+
+export default useMentions;

package/src/hooks/useMessages.ts

@@ -0,0 +1,37 @@
+// ============================================================================
+// AegisChat React SDK - useMessages Hook
+// ============================================================================
+
+import { useCallback, useState } from 'react';
+import { messagesApi } from '../services/api';
+import type { Message, MessagesResponse } from '../types';
+
+export interface UseMessagesOptions {
+  channelId: string;
+}
+
+export interface UseMessagesReturn {
+  messages: Message[];
+  isLoading: boolean;
+  hasMore: boolean;
+  sendMessage: (params: { content: string; type?: string; metadata?: Record<string, unknown> }) => Promise<void>;
+  loadMore: () => Promise<void>;
+}
+
+export function useMessages(_options: UseMessagesOptions): UseMessagesReturn {
+  const [messages, setMessages] = useState<Message[]>([]);
+  const [isLoading, setIsLoading] = useState(false);
+  const [hasMore, setHasMore] = useState(true);
+
+  const sendMessage = useCallback(async (params: { content: string; type?: string; metadata?: Record<string, unknown> }) => {
+    // Implementation would go here
+  }, []);
+
+  const loadMore = useCallback(async () => {
+    // Implementation would go here
+  }, []);
+
+  return { messages, isLoading, hasMore, sendMessage, loadMore };
+}
+
+export default useMessages;

package/src/hooks/useReactions.ts

@@ -0,0 +1,28 @@
+// ============================================================================
+// AegisChat React SDK - useReactions Hook
+// ============================================================================
+
+import { useState } from 'react';
+import type { ReactionSummary } from '../types';
+
+export interface UseReactionsOptions {
+  channelId: string;
+  messageId: string;
+}
+
+export interface UseReactionsReturn {
+  reactions: ReactionSummary[];
+  addReaction: (emoji: string) => Promise<void>;
+  removeReaction: (emoji: string) => Promise<void>;
+}
+
+export function useReactions(_options: UseReactionsOptions): UseReactionsReturn {
+  const [reactions, setReactions] = useState<ReactionSummary[]>([]);
+
+  const addReaction = async (_emoji: string) => {};
+  const removeReaction = async (_emoji: string) => {};
+
+  return { reactions, addReaction, removeReaction };
+}
+
+export default useReactions;

package/src/hooks/useTypingIndicator.ts

@@ -0,0 +1,28 @@
+// ============================================================================
+// AegisChat React SDK - useTypingIndicator Hook
+// ============================================================================
+
+import { useCallback, useState } from 'react';
+import type { TypingUser } from '../types';
+
+export interface UseTypingIndicatorOptions {
+  channelId: string;
+  ws?: WebSocket | null;
+}
+
+export interface UseTypingIndicatorReturn {
+  typingUsers: TypingUser[];
+  startTyping: () => void;
+  stopTyping: () => void;
+}
+
+export function useTypingIndicator(_options: UseTypingIndicatorOptions): UseTypingIndicatorReturn {
+  const [typingUsers, setTypingUsers] = useState<TypingUser[]>([]);
+
+  const startTyping = useCallback(() => {}, []);
+  const stopTyping = useCallback(() => {}, []);
+
+  return { typingUsers, startTyping, stopTyping };
+}
+
+export default useTypingIndicator;

package/src/index.ts

@@ -0,0 +1,68 @@
+// ============================================================================
+// AegisChat React SDK - Main Entry Point
+// ============================================================================
+
+export { useChat } from './hooks/useChat';
+export type { UseChatOptions, UseChatReturn } from './hooks/useChat';
+
+export { useAutoRead } from './hooks/useAutoRead';
+export type { UseAutoReadOptions, UseAutoReadReturn } from './hooks/useAutoRead';
+
+export { useChannels } from './hooks/useChannels';
+export type { UseChannelsOptions, UseChannelsReturn } from './hooks/useChannels';
+
+export { useMessages } from './hooks/useMessages';
+export type { UseMessagesOptions, UseMessagesReturn } from './hooks/useMessages';
+
+export { useTypingIndicator } from './hooks/useTypingIndicator';
+export type { UseTypingIndicatorOptions } from './hooks/useTypingIndicator';
+
+export { useReactions } from './hooks/useReactions';
+export type { UseReactionsOptions } from './hooks/useReactions';
+
+export { useFileUpload } from './hooks/useFileUpload';
+export type { UseFileUploadOptions } from './hooks/useFileUpload';
+
+export { useMentions } from './hooks/useMentions';
+export type { UseMentionsOptions } from './hooks/useMentions';
+
+export {
+  chatApi,
+  channelsApi,
+  messagesApi,
+  reactionsApi,
+  filesApi,
+  usersApi,
+  configureApiClient,
+} from './services/api';
+
+export type {
+  AegisConfig,
+  ChatSession,
+  ChatConnectParams,
+  UserSummary,
+  UserStatus,
+  Channel,
+  ChannelListItem,
+  ChannelType,
+  Message,
+  MessageSummary,
+  MessageType,
+  MessageStatus,
+  MessageMetadata,
+  FileAttachment,
+  TypingUser,
+  TypingEvent,
+  ReactionSummary,
+  ReactionEvent,
+  UploadProgress,
+  WebSocketMessage,
+  WebSocketStatus,
+  ApiResponse,
+  ApiError,
+  PaginationParams,
+  PaginationMeta,
+  PaginatedResponse,
+  MessagesResponse,
+  ChannelsResponse,
+} from './types';

package/src/services/api.ts

@@ -0,0 +1,370 @@
+// ============================================================================
+// AegisChat React SDK - API Service
+// ============================================================================
+
+import type {
+  ApiResponse,
+  ChatSession,
+  ChatConnectParams,
+  Channel,
+  ChannelListItem,
+  Message,
+  MessagesResponse,
+  UserSummary,
+  ReactionSummary,
+  FileAttachment,
+  UploadUrlResponse,
+} from '../types';
+
+let baseUrl = '';
+let getAccessToken: () => Promise<string> | string = () => '';
+let onUnauthorized: (() => void) | undefined;
+
+export function configureApiClient(config: {
+  baseUrl: string;
+  getAccessToken: () => Promise<string> | string;
+  onUnauthorized?: () => void;
+}): void {
+  baseUrl = config.baseUrl;
+  getAccessToken = config.getAccessToken;
+  onUnauthorized = config.onUnauthorized;
+}
+
+async function fetchWithAuth<T>(
+  path: string,
+  options: RequestInit = {}
+): Promise<T> {
+  const token = await (typeof getAccessToken === 'function' 
+    ? getAccessToken() 
+    : getAccessToken);
+
+  const response = await fetch(`${baseUrl}${path}`, {
+    ...options,
+    headers: {
+      'Content-Type': 'application/json',
+      Authorization: `Bearer ${token}`,
+      ...options.headers,
+    },
+  });
+
+  if (response.status === 401) {
+    onUnauthorized?.();
+    throw new Error('Unauthorized');
+  }
+
+  if (!response.ok) {
+    const error = await response.json().catch(() => ({}));
+    throw new Error(error.message || `HTTP ${response.status}`);
+  }
+
+  return response.json();
+}
+
+export const chatApi = {
+  /**
+   * Connect to chat session
+   */
+  async connect(
+    params: ChatConnectParams,
+    signal?: AbortSignal
+  ): Promise<ApiResponse<ChatSession>> {
+    return fetchWithAuth('/api/v1/chat/connect', {
+      method: 'POST',
+      body: JSON.stringify(params),
+      signal,
+    });
+  },
+
+  /**
+   * Refresh access token
+   */
+  async refreshToken(
+    refreshToken: string,
+    signal?: AbortSignal
+  ): Promise<ApiResponse<{ access_token: string; expires_in: number }>> {
+    return fetchWithAuth('/api/v1/chat/refresh', {
+      method: 'POST',
+      body: JSON.stringify({ refresh_token: refreshToken }),
+      signal,
+    });
+  },
+};
+
+export const channelsApi = {
+  /**
+   * List channels
+   */
+  async list(
+    options: { type?: string; limit?: number } = {},
+    signal?: AbortSignal
+  ): Promise<ApiResponse<{ channels: ChannelListItem[] }>> {
+    const params = new URLSearchParams();
+    if (options.type) params.append('type', options.type);
+    if (options.limit) params.append('limit', String(options.limit));
+    const query = params.toString() ? `?${params.toString()}` : '';
+    return fetchWithAuth(`/api/v1/channels${query}`, { signal });
+  },
+
+  /**
+   * Get channel by ID
+   */
+  async get(channelId: string, signal?: AbortSignal): Promise<ApiResponse<Channel>> {
+    return fetchWithAuth(`/api/v1/channels/${channelId}`, { signal });
+  },
+
+  /**
+   * Get or create DM channel
+   */
+  async getOrCreateDM(
+    userId: string,
+    signal?: AbortSignal
+  ): Promise<ApiResponse<Channel>> {
+    return fetchWithAuth('/api/v1/channels/dm', {
+      method: 'POST',
+      body: JSON.stringify({ user_id: userId }),
+      signal,
+    });
+  },
+
+  /**
+   * Create channel
+   */
+  async create(
+    data: { name: string; type?: string; description?: string; metadata?: Record<string, unknown> },
+    signal?: AbortSignal
+  ): Promise<ApiResponse<Channel>> {
+    return fetchWithAuth('/api/v1/channels', {
+      method: 'POST',
+      body: JSON.stringify(data),
+      signal,
+    });
+  },
+
+  /**
+   * Mark channel as read
+   */
+  async markAsRead(
+    channelId: string,
+    signal?: AbortSignal
+  ): Promise<ApiResponse<{ unread_count: number }>> {
+    return fetchWithAuth(`/api/v1/channels/${channelId}/read`, {
+      method: 'POST',
+      signal,
+    });
+  },
+
+  /**
+   * Get channel members
+   */
+  async getMembers(
+    channelId: string,
+    signal?: AbortSignal
+  ): Promise<ApiResponse<{ members: UserSummary[] }>> {
+    return fetchWithAuth(`/api/v1/channels/${channelId}/members`, { signal });
+  },
+
+  /**
+   * Update channel
+   */
+  async update(
+    channelId: string,
+    data: { name?: string; description?: string; metadata?: Record<string, unknown> },
+    signal?: AbortSignal
+  ): Promise<ApiResponse<Channel>> {
+    return fetchWithAuth(`/api/v1/channels/${channelId}`, {
+      method: 'PATCH',
+      body: JSON.stringify(data),
+      signal,
+    });
+  },
+};
+
+export const messagesApi = {
+  /**
+   * List messages in a channel
+   */
+  async list(
+    channelId: string,
+    options: { limit?: number; before?: string } = {},
+    signal?: AbortSignal
+  ): Promise<ApiResponse<MessagesResponse>> {
+    const params = new URLSearchParams();
+    if (options.limit) params.append('limit', String(options.limit));
+    if (options.before) params.append('before', options.before);
+    const query = params.toString() ? `?${params.toString()}` : '';
+    return fetchWithAuth(`/api/v1/channels/${channelId}/messages${query}`, { signal });
+  },
+
+  /**
+   * Send a message
+   */
+  async send(
+    channelId: string,
+    data: { content: string; type?: string; parent_id?: string; metadata?: Record<string, unknown>; file_ids?: string[] },
+    signal?: AbortSignal
+  ): Promise<ApiResponse<Message>> {
+    return fetchWithAuth(`/api/v1/channels/${channelId}/messages`, {
+      method: 'POST',
+      body: JSON.stringify(data),
+      signal,
+    });
+  },
+
+  /**
+   * Update a message
+   */
+  async update(
+    channelId: string,
+    messageId: string,
+    data: { content?: string; metadata?: Record<string, unknown> },
+    signal?: AbortSignal
+  ): Promise<ApiResponse<Message>> {
+    return fetchWithAuth(`/api/v1/channels/${channelId}/messages/${messageId}`, {
+      method: 'PATCH',
+      body: JSON.stringify(data),
+      signal,
+    });
+  },
+
+  /**
+   * Delete a message
+   */
+  async delete(
+    channelId: string,
+    messageId: string,
+    signal?: AbortSignal
+  ): Promise<ApiResponse<{ success: boolean }>> {
+    return fetchWithAuth(`/api/v1/channels/${channelId}/messages/${messageId}`, {
+      method: 'DELETE',
+      signal,
+    });
+  },
+
+  /**
+   * Mark messages as delivered
+   */
+  async markDelivered(
+    channelId: string,
+    signal?: AbortSignal
+  ): Promise<ApiResponse<{ success: boolean }>> {
+    return fetchWithAuth(`/api/v1/channels/${channelId}/messages/delivered`, {
+      method: 'POST',
+      signal,
+    });
+  },
+
+  /**
+   * Mark messages as read
+   */
+  async markRead(
+    channelId: string,
+    signal?: AbortSignal
+  ): Promise<ApiResponse<{ success: boolean }>> {
+    return fetchWithAuth(`/api/v1/channels/${channelId}/messages/read`, {
+      method: 'POST',
+      signal,
+    });
+  },
+};
+
+export const reactionsApi = {
+  /**
+   * Add reaction to a message
+   */
+  async add(
+    channelId: string,
+    messageId: string,
+    emoji: string,
+    signal?: AbortSignal
+  ): Promise<ApiResponse<{ reactions: ReactionSummary[] }>> {
+    return fetchWithAuth(`/api/v1/channels/${channelId}/messages/${messageId}/reactions`, {
+      method: 'POST',
+      body: JSON.stringify({ emoji }),
+      signal,
+    });
+  },
+
+  /**
+   * Remove reaction from a message
+   */
+  async remove(
+    channelId: string,
+    messageId: string,
+    emoji: string,
+    signal?: AbortSignal
+  ): Promise<ApiResponse<{ reactions: ReactionSummary[] }>> {
+    return fetchWithAuth(
+      `/api/v1/channels/${channelId}/messages/${messageId}/reactions/${encodeURIComponent(emoji)}`,
+      { method: 'DELETE', signal }
+    );
+  },
+};
+
+export const filesApi = {
+  /**
+   * Get upload URL
+   */
+  async getUploadUrl(
+    data: { file_name: string; file_type: string; file_size: number },
+    signal?: AbortSignal
+  ): Promise<ApiResponse<UploadUrlResponse>> {
+    return fetchWithAuth('/api/v1/files/upload-url', {
+      method: 'POST',
+      body: JSON.stringify(data),
+      signal,
+    });
+  },
+
+  /**
+   * Confirm file upload
+   */
+  async confirm(
+    fileId: string,
+    signal?: AbortSignal
+  ): Promise<ApiResponse<{ file: FileAttachment }>> {
+    return fetchWithAuth('/api/v1/files', {
+      method: 'POST',
+      body: JSON.stringify({ file_id: fileId }),
+      signal,
+    });
+  },
+
+  /**
+   * Get download URL
+   */
+  async getDownloadUrl(
+    fileId: string,
+    signal?: AbortSignal
+  ): Promise<ApiResponse<{ url: string; expires_at: string }>> {
+    return fetchWithAuth(`/api/v1/files/${fileId}/download`, { signal });
+  },
+};
+
+export const usersApi = {
+  /**
+   * Search users
+   */
+  async search(
+    query: string,
+    signal?: AbortSignal
+  ): Promise<ApiResponse<{ users: UserSummary[] }>> {
+    return fetchWithAuth(`/api/v1/users/search?q=${encodeURIComponent(query)}`, { signal });
+  },
+
+  /**
+   * Get user by ID
+   */
+  async get(userId: string, signal?: AbortSignal): Promise<ApiResponse<UserSummary>> {
+    return fetchWithAuth(`/api/v1/users/${userId}`, { signal });
+  },
+};
+
+export default {
+  chatApi,
+  channelsApi,
+  messagesApi,
+  reactionsApi,
+  filesApi,
+  usersApi,
+  configureApiClient,
+};