refactor(shared): update utilities, API layer, and types

src/shared/types/common.ts

@@ -1,4 +1,14 @@
+/**
+ * Standard API response wrapper
+ *
+ * Encapsulates response data with HTTP status code
+ * for consistent error handling across API calls.
+ *
+ * @template T - Type of the response data
+ */
 export interface ApiResponse<T> {
+    /** Response payload data */
     data: T;
+    /** HTTP status code */
     status: number;
 }