Merge pull request #126 from lcomplete/dev

feat: Add i18n multi-language support and enhance Twitter settings

Author: lcomplete

.github/copilot-instructions.md

@@ -38,13 +38,16 @@
     "cors": "^2.8.5",
     "date-fns": "^2.29.3",
     "formik": "^2.2.9",
+    "i18next": "23.16.8",
+    "i18next-browser-languagedetector": "7.2.2",
     "moment": "^2.29.4",
     "notistack": "^2.0.8",
     "postcss": "^8.4.14",
     "react": "^18.2.0",
     "react-beautiful-dnd": "^13.1.1",
     "react-date-range": "^1.4.0",
     "react-dom": "^18.2.0",
+    "react-i18next": "14.1.3",
     "react-intersection-observer": "^9.4.0",
     "react-markdown": "^10.1.0",
     "react-photo-view": "^1.2.3",

app/client/package.json

@@ -83,20 +83,58 @@ type ApiResult<T> = {
   data: T;
 };
 
+type ErrorResponse = {
+  message?: string;
+  error?: {
+    message?: string;
+  };
+};
+
+function redirectToSignIn() {
+  const from = `${globalThis.location.pathname}${globalThis.location.search}`;
+  globalThis.location.href = `/signin?from=${encodeURIComponent(from)}`;
+}
+
+function normalizeApiError(error: unknown, fallbackMessage: string): Error {
+  if (axios.isAxiosError(error)) {
+    if (error.response?.status === 401) {
+      redirectToSignIn();
+      return new Error("Unauthorized");
+    }
+    const responseData = error.response?.data as ErrorResponse | undefined;
+    return new Error(
+      responseData?.message ||
+      responseData?.error?.message ||
+      error.message ||
+      fallbackMessage
+    );
+  }
+
+  if (error instanceof Error) {
+    return error;
+  }
+
+  return new Error(fallbackMessage);
+}
+
 /**
  * Filter pages with pagination for batch operations.
  */
 export async function filterPages(
   query: BatchFilterQuery
 ): Promise<BatchFilterResult> {
-  const res = await axios.post<ApiResult<BatchFilterResult>>(
-    "/api/page/batch/filter",
-    query
-  );
-  if (res.data.code !== 0) {
-    throw new Error(res.data.message || "Failed to filter pages.");
+  try {
+    const res = await axios.post<ApiResult<BatchFilterResult>>(
+      "/api/page/batch/filter",
+      query
+    );
+    if (res.data.code !== 0) {
+      throw new Error(res.data.message || "Failed to filter pages.");
+    }
+    return res.data.data;
+  } catch (error) {
+    throw normalizeApiError(error, "Failed to filter pages.");
   }
-  return res.data.data;
 }
 
 /**
@@ -105,21 +143,22 @@ export async function filterPages(
 export async function batchMoveToCollection(
   request: BatchMoveRequest
 ): Promise<BatchMoveResult> {
-  const res = await axios.post<ApiResult<BatchMoveResult>>(
-    "/api/page/batch/moveToCollection",
-    request
-  );
-  if (res.data.code !== 0) {
-    throw new Error(res.data.message || "Failed to move pages.");
+  try {
+    const res = await axios.post<ApiResult<BatchMoveResult>>(
+      "/api/page/batch/moveToCollection",
+      request
+    );
+    if (res.data.code !== 0) {
+      throw new Error(res.data.message || "Failed to move pages.");
+    }
+    return res.data.data;
+  } catch (error) {
+    throw normalizeApiError(error, "Failed to move pages.");
   }
-  return res.data.data;
 }
 
 /**
- * Collected time mode options with labels for UI.
+ * Collected time mode values for UI.
  */
-export const COLLECTED_AT_MODE_OPTIONS: { value: CollectedAtMode; label: string }[] = [
-  { value: "KEEP", label: "Keep Original" },
-  { value: "USE_PUBLISH_TIME", label: "Use Publish Time" },
-];
+export const COLLECTED_AT_MODES: CollectedAtMode[] = ["KEEP", "USE_PUBLISH_TIME"];
 

app/client/src/api/batchOrganize.ts

@@ -56,6 +56,13 @@ interface BatchPageItemListProps {
   readonly selectAll?: boolean;
   /** Callback when an item's selection changes */
   readonly onSelectItem?: (id: number, selected: boolean) => void;
+  /** Optional translated labels */
+  readonly labels?: {
+    openOriginal?: string;
+    author?: string;
+    collected?: string;
+    published?: string;
+  };
 }
 
 export default function BatchPageItemList({
@@ -64,6 +71,7 @@ export default function BatchPageItemList({
   selectedIds = new Set(),
   selectAll = false,
   onSelectItem,
+  labels,
 }: BatchPageItemListProps) {
   return (
     <Box className="space-y-2">
@@ -102,7 +110,7 @@ export default function BatchPageItemList({
                 >
                   {title}
                 </a>
-                <Tooltip title="Open original URL">
+                <Tooltip title={labels?.openOriginal || "Open original URL"}>
                   <IconButton
                     size="small"
                     href={item.url}
@@ -122,9 +130,9 @@ export default function BatchPageItemList({
 
               {/* Metadata */}
               <Box className="text-xs text-gray-400 mt-1 flex gap-4 flex-wrap">
-                {item.author && <span>Author: {item.author}</span>}
-                {item.collectedAt && <span>Collected: <SmartMoment dt={item.collectedAt} /></span>}
-                {pubTime && <span>Published: <SmartMoment dt={pubTime} /></span>}
+                {item.author && <span>{labels?.author || "Author"}: {item.author}</span>}
+                {item.collectedAt && <span>{labels?.collected || "Collected"}: <SmartMoment dt={item.collectedAt} /></span>}
+                {pubTime && <span>{labels?.published || "Published"}: <SmartMoment dt={pubTime} /></span>}
               </Box>
             </Box>
           </Box>