feat(chat): add promotional external entry flow

src/lib/navigation/__tests__/external_entry.test.ts

@@ -2,46 +2,60 @@ import { describe, expect, it } from "vitest";
 
 import { ROUTES } from "@/router/routes";
 
-import { resolveExternalEntryTarget } from "../external_entry";
+import {
+  resolveExternalEntryPromotionType,
+  resolveExternalEntryTarget,
+} from "../external_entry";
 
 describe("external entry navigation", () => {
   it("defaults to chat", () => {
     expect(resolveExternalEntryTarget({})).toBe(ROUTES.chat);
   });
 
-  it("resolves supported target aliases", () => {
+  it("resolves only canonical targets", () => {
     expect(resolveExternalEntryTarget({ target: "chat" })).toBe(ROUTES.chat);
     expect(resolveExternalEntryTarget({ target: "tip" })).toBe(ROUTES.tip);
-    expect(resolveExternalEntryTarget({ target: "coffee" })).toBe(ROUTES.tip);
     expect(resolveExternalEntryTarget({ target: "private-room" })).toBe(
       ROUTES.privateRoom,
     );
+  });
+
+  it("rejects removed aliases and unsupported targets", () => {
+    expect(resolveExternalEntryTarget({ target: "tips" })).toBe(ROUTES.chat);
+    expect(resolveExternalEntryTarget({ target: "coffee" })).toBe(ROUTES.chat);
     expect(resolveExternalEntryTarget({ target: "private_room" })).toBe(
-      ROUTES.privateRoom,
-    );
-  });
-
-  it("prefers safe explicit redirect routes over target aliases", () => {
-    expect(
-      resolveExternalEntryTarget({
-        target: "chat",
-        redirect: ROUTES.tip,
-      }),
-    ).toBe(ROUTES.tip);
-  });
-
-  it("rejects unsupported and external redirect routes", () => {
-    expect(
-      resolveExternalEntryTarget({
-        redirect: "https://example.com/chat",
-        target: "unknown",
-      }),
-    ).toBe(ROUTES.chat);
-    expect(resolveExternalEntryTarget({ redirect: "//example.com" })).toBe(
-      ROUTES.chat,
-    );
-    expect(resolveExternalEntryTarget({ redirect: "/sidebar" })).toBe(
       ROUTES.chat,
     );
+    expect(resolveExternalEntryTarget({ target: "/tip" })).toBe(ROUTES.chat);
+    expect(resolveExternalEntryTarget({ target: "sidebar" })).toBe(ROUTES.chat);
+  });
+});
+
+describe("external entry promotion", () => {
+  it("accepts only explicit promotion mode and supported message types", () => {
+    expect(
+      resolveExternalEntryPromotionType({
+        mode: "promotion",
+        promotionType: "voice",
+      }),
+    ).toBe("voice");
+    expect(
+      resolveExternalEntryPromotionType({
+        mode: "promotion",
+        promotionType: "image",
+      }),
+    ).toBe("image");
+    expect(
+      resolveExternalEntryPromotionType({
+        mode: "normal",
+        promotionType: "private",
+      }),
+    ).toBeNull();
+    expect(
+      resolveExternalEntryPromotionType({
+        mode: "promotion",
+        promotionType: "video",
+      }),
+    ).toBeNull();
   });
 });