Restructure code and documentation

frontend/src/core/config.ts

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview Application configuration constants
+ * @description Contains all configuration values used throughout the application
+ * @author Cursor
+ * @version 1.0.0
+ */
+
+/**
+ * Base API endpoint for all backend requests
+ * @constant
+ */
+export const API_BASE_URL = `${location.host || "https://fromchat.toolbox-io.ru"}/api`;
+
+/**
+ * Full API URL including hostname and port for WebSocket connections
+ * @constant
+ */
+export const API_WS_BASE_URL = `${location.host || "fromchat.toolbox-io.ru"}/api`;
+
+/**
+ * Application name displayed in UI and document title
+ * @constant
+ */
+export const PRODUCT_NAME = "FromChat";

frontend/src/core/init.ts

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview Application initialization logic
+ * @description Handles initial application setup and state
+ * @author FromChat Team
+ * @version 1.0.0
+ */
+
+import { showLogin } from "../navigation";
+import { PRODUCT_NAME } from "./config";
+
+showLogin();
+document.getElementById("productname")!.textContent = PRODUCT_NAME;
+document.title = PRODUCT_NAME;

frontend/src/core/types.ts

@@ -0,0 +1,191 @@
+/**
+ * @fileoverview Global TypeScript type definitions
+ * @description Contains all type definitions used throughout the application
+ * @author Cursor
+ * @version 1.0.0
+ */
+
+/**
+ * HTTP headers object type
+ * @typedef {Object.<string, string>} Headers
+ */
+export type Headers = {[x: string]: string}
+
+/**
+ * API error response structure
+ * @interface ErrorResponse
+ * @property {string} message - Error message from the server
+ */
+export interface ErrorResponse {
+    message: string;
+}
+
+/**
+ * 2D coordinate structure
+ * @interface Size2D
+ * @property {number} x - X coordinate
+ * @property {number} y - Y coordinate
+ */
+export interface Size2D {
+    x: number;
+    y: number;
+}
+
+// App types
+
+/**
+ * Chat message structure
+ * @interface Message
+ * @property {number} id - Unique message identifier
+ * @property {string} username - Username of the message sender
+ * @property {string} content - Message content
+ * @property {boolean} is_read - Whether the message has been read
+ * @property {boolean} is_edited - Whether the message has been edited
+ * @property {string} timestamp - ISO timestamp of the message
+ * @property {string} [profile_picture] - URL to sender's profile picture
+ * @property {Message} [reply_to] - The message this is replying to
+ */
+export interface Message {
+    id: number;
+    username: string;
+    content: string;
+    is_read: boolean;
+    is_edited: boolean;
+    timestamp: string;
+    profile_picture?: string;
+    reply_to?: Message;
+}
+
+/**
+ * Collection of messages
+ * @interface Messages
+ * @property {Message[]} messages - Array of message objects
+ */
+export interface Messages {
+    messages: Message[];
+}
+
+/**
+ * User information structure
+ * @interface User
+ * @property {number} id - Unique user identifier
+ * @property {string} created_at - ISO timestamp of account creation
+ * @property {string} last_seen - ISO timestamp of last activity
+ * @property {boolean} online - Whether the user is currently online
+ * @property {string} username - Username
+ * @property {string} [bio] - User biography
+ */
+export interface User {
+    id: number;
+    created_at: string;
+    last_seen: string;
+    online: boolean;
+    username: string;
+    admin?: boolean;
+    bio?: string;
+}
+
+/**
+ * User profile response structure
+ * @interface UserProfile
+ * @property {number} id - Unique user identifier
+ * @property {string} username - Username
+ * @property {string} [profile_picture] - URL to user's profile picture
+ * @property {string} [bio] - User biography
+ * @property {boolean} online - Whether the user is currently online
+ * @property {string} last_seen - ISO timestamp of last activity
+ * @property {string} created_at - ISO timestamp of account creation
+ */
+export interface UserProfile {
+    id: number;
+    username: string;
+    profile_picture?: string;
+    bio?: string;
+    online: boolean;
+    last_seen: string;
+    created_at: string;
+}
+
+// ----------
+// API models
+// ----------
+
+// Requests
+
+/**
+ * Login request structure
+ * @interface LoginRequest
+ * @property {string} username - Username for authentication
+ * @property {string} password - Password for authentication
+ */
+export interface LoginRequest {
+    username: string;
+    password: string;
+}
+
+/**
+ * Registration request structure
+ * @interface RegisterRequest
+ * @property {string} username - Desired username
+ * @property {string} password - Desired password
+ * @property {string} confirm_password - Password confirmation
+ */
+export interface RegisterRequest {
+    username: string;
+    password: string;
+    confirm_password: string;
+}
+
+// Responses
+
+/**
+ * Login response structure
+ * @interface LoginResponse
+ * @property {User} user - User information
+ * @property {string} token - JWT authentication token
+ */
+export interface LoginResponse {
+    user: User;
+    token: string;
+}
+
+// ---------------
+// WebSocket types
+// ---------------
+
+/**
+ * WebSocket message structure
+ * @interface WebSocketMessage
+ * @property {string} type - Message type identifier
+ * @property {WebSocketCredentials} [credentials] - Authentication credentials
+ * @property {any} [data] - Message payload data
+ * @property {WebSocketError} [error] - Error information if applicable
+ */
+export interface WebSocketMessage {
+    type: string;
+    credentials?: WebSocketCredentials;
+    data?: any;
+    error?: WebSocketError;
+}
+
+/**
+ * WebSocket error structure
+ * @interface WebSocketError
+ * @property {number} code - Error code
+ * @property {string} detail - Error detail message
+ */
+export interface WebSocketError {
+    code: number;
+    detail: string;
+}
+
+/**
+ * WebSocket authentication credentials
+ * @interface WebSocketCredentials
+ * @property {string} scheme - Authentication scheme (e.g., "Bearer")
+ * @property {string} credentials - Authentication token or credentials
+ */
+export interface WebSocketCredentials {
+    scheme: string;
+    credentials: string;
+}