refactor(chat): reorganize helper functions and update imports

src/stores/chat/__tests__/chat-helpers.test.ts

@@ -7,7 +7,7 @@ import {
   countLockedHistoryMessages,
   localMessagesToUi,
   sendResponseToUiMessage,
-} from "@/stores/chat/chat-machine.helpers";
+} from "@/stores/chat/helper";
 
 function makeResponse(
   overrides: Partial<Parameters<typeof ChatSendResponse.from>[0]> = {},

src/stores/chat/__tests__/chat-machine.test-utils.ts

@@ -10,7 +10,7 @@ import type { ChatEvent } from "@/stores/chat/chat-events";
 import type {
   UnlockMessageOutput as MachineUnlockMessageOutput,
   UnlockMessageRequest,
-} from "@/stores/chat/chat-machine.helpers";
+} from "@/stores/chat/helper/unlock";
 
 export interface SendMessageHttpOutput {
   response: ChatSendResponse;

src/stores/chat/__tests__/chat-promotion.test.ts

@@ -6,7 +6,7 @@ import {
   appendPromotionMessage,
   applyPromotionUnlockOutput,
   createChatPromotionState,
-} from "@/stores/chat/chat-promotion";
+} from "@/stores/chat/helper/promotion";
 
 const promotion: PendingChatPromotion = {
   promotionType: "image",

src/stores/chat/chat-context.tsx

@@ -6,7 +6,7 @@ import type { SnapshotFrom } from "xstate";
 
 import { chatMachine } from "./chat-machine";
 import type { ChatEvent, ChatState as MachineContext } from "./chat-machine";
-import { appendPromotionMessage } from "./chat-promotion";
+import { appendPromotionMessage } from "./helper/promotion";
 
 /**
  * 对外暴露的 State 形状

src/stores/chat/chat-events.ts

@@ -57,6 +57,6 @@ export type ChatEvent =
   | { type: "ChatQueuedSendStarted" }
   | {
       type: "ChatQueuedHttpDone";
-      output: import("./chat-machine.helpers").HttpSendOutput;
+      output: import("./helper/send-state").HttpSendOutput;
     }
   | { type: "ChatQueuedSendError"; content: string; errorMessage: string };

src/stores/chat/chat-history-sync.ts

@@ -5,10 +5,8 @@ import { Logger } from "@/utils/logger";
 import { Result } from "@/utils/result";
 import { todayString } from "@/utils/date";
 
-import {
+import { CHAT_HISTORY_LIMIT } from "./helper/history";
-  CHAT_HISTORY_LIMIT,
+import { localMessagesToUi } from "./helper/message-mappers";
-  localMessagesToUi,
-} from "./chat-machine.helpers";
 
 const log = new Logger("StoresChatChatHistorySync");
 

src/stores/chat/chat-state.ts

@@ -2,7 +2,7 @@ import type { UiMessage } from "@/data/dto/chat";
 import type { PendingChatUnlockKind } from "@/lib/navigation/chat_unlock_session";
 import type { ChatLockType } from "@/data/schemas/chat";
 import type { PendingChatPromotion } from "@/data/storage/navigation";
-import type { ChatPromotionState } from "./chat-promotion";
+import type { ChatPromotionState } from "./helper/promotion";
 
 export type ChatUpgradeReason = "insufficient_credits";
 

src/stores/chat/helper/history.ts

@@ -1,15 +1,10 @@
 import type { UiMessage } from "@/data/dto/chat";
 
-import type { ChatState } from "./chat-state";
+import type { ChatState } from "../chat-state";
 
 // The initial history request remains bounded even though pagination is disabled.
 export const CHAT_HISTORY_LIMIT = 50;
 
-export * from "./chat-message-mappers";
-export * from "./chat-promotion";
-export * from "./chat-send-state";
-export * from "./chat-unlock-helpers";
-
 export function applyHistoryLoadedOutput(
   output: {
     messages: UiMessage[];

src/stores/chat/helper/index.ts

@@ -0,0 +1,5 @@
+export * from "./history";
+export * from "./message-mappers";
+export * from "./promotion";
+export * from "./send-state";
+export * from "./unlock";

src/stores/chat/helper/promotion.ts

@@ -5,7 +5,7 @@ import { todayString } from "@/utils/date";
 import {
   applySingleUnlockOutput,
   type UnlockMessageOutput,
-} from "./chat-unlock-helpers";
+} from "./unlock";
 
 const PROMOTION_COPY = {
   voice: "I left a voice message for you. Unlock it to listen.",

src/stores/chat/helper/send-state.ts

@@ -1,6 +1,6 @@
 import { type ChatSendResponse, type UiMessage } from "@/data/dto/chat";
 
-import type { ChatState, ChatUpgradeReason } from "./chat-state";
+import type { ChatState, ChatUpgradeReason } from "../chat-state";
 
 export type HttpSendOutput = {
   response: ChatSendResponse;

src/stores/chat/index.ts

@@ -4,6 +4,6 @@
 
 export * from "./chat-context";
 export * from "./chat-events";
-export * from "./chat-machine.helpers";
+export * from "./helper";
 export * from "./chat-machine";
 export * from "./chat-state";

src/stores/chat/machine/actors/send.ts

@@ -9,7 +9,7 @@ import { Logger } from "@/utils/logger";
 import { Result } from "@/utils/result";
 
 import type { ChatEvent } from "../../chat-events";
-import { sendResponseToUiMessage } from "../../chat-machine.helpers";
+import { sendResponseToUiMessage } from "../../helper/message-mappers";
 
 const log = new Logger("StoresChatChatSendFlow");
 

src/stores/chat/machine/actors/unlock.ts

@@ -9,7 +9,7 @@ import { readAndSyncHistory } from "../../chat-history-sync";
 import {
   type UnlockMessageRequest,
   type UnlockMessageOutput,
-} from "../../chat-machine.helpers";
+} from "../../helper/unlock";
 
 const log = new Logger("StoresChatChatUnlockFlow");
 

src/stores/chat/machine/history-flow.ts

@@ -1,9 +1,11 @@
 import {
   applyHistoryLoadedOutput,
   applyNetworkHistoryLoadedOutput,
+} from "../helper/history";
+import {
   countLockedHistoryMessages,
   shouldPromptUnlockHistory,
-} from "../chat-machine.helpers";
+} from "../helper/unlock";
 import { baseChatMachineSetup } from "./setup";
 
 const applyLocalHistoryLoadedAction = baseChatMachineSetup.assign(

src/stores/chat/machine/send-flow.ts

@@ -8,7 +8,7 @@ import {
   beginPendingReply,
   finishPendingReply,
   type HttpSendOutput,
-} from "../chat-machine.helpers";
+} from "../helper/send-state";
 import { historyMachineSetup } from "./history-flow";
 import { createChatActorActionSetup } from "./setup";
 

src/stores/chat/machine/session-flow.ts

@@ -1,7 +1,5 @@
-import {
+import { createChatPromotionState } from "../helper/promotion";
-  createChatPromotionState,
+import { shouldPromptUnlockHistory } from "../helper/unlock";
-  shouldPromptUnlockHistory,
-} from "../chat-machine.helpers";
 import { initialState } from "../chat-state";
 import {
   guestInitializingState,

src/stores/chat/machine/unlock-flow.ts

@@ -1,11 +1,11 @@
 import { type DoneActorEvent } from "xstate";
 
+import { applyPromotionUnlockOutput } from "../helper/promotion";
 import {
-  applyPromotionUnlockOutput,
   applySingleUnlockOutput,
   countLockedHistoryMessages,
   type UnlockMessageOutput,
-} from "../chat-machine.helpers";
+} from "../helper/unlock";
 import type { UnlockHistoryOutput } from "./actors/unlock";
 import { sendMachineSetup } from "./send-flow";
 import { createChatActorActionSetup } from "./setup";