feat(tip): support tiered coffee gifts

src/lib/navigation/external_entry.ts

@@ -5,6 +5,11 @@ import { UserStorage } from "@/data/storage/user/user_storage";
 import type { PendingChatPromotionType } from "@/data/storage/navigation";
 import type { LoginStatus } from "@/data/dto/auth";
 import { ROUTES } from "@/router/routes";
+import {
+  buildTipCoffeePath,
+  DEFAULT_TIP_COFFEE_TYPE,
+  resolveTipCoffeeType,
+} from "@/lib/tip/tip_coffee";
 
 export type ExternalEntryTarget =
   | typeof ROUTES.chat
@@ -22,6 +27,10 @@ export interface ExternalEntryTargetInput {
   target?: string | null;
 }
 
+export interface ExternalEntryDestinationInput extends ExternalEntryTargetInput {
+  coffeeType?: string | null;
+}
+
 export interface ExternalEntryPromotionInput {
   mode?: string | null;
   promotionType?: string | null;
@@ -77,6 +86,18 @@ export function resolveExternalEntryTarget({
   return resolveTarget(target) ?? ROUTES.chat;
 }
 
+export function resolveExternalEntryDestination({
+  target,
+  coffeeType,
+}: ExternalEntryDestinationInput): string {
+  const resolvedTarget = resolveExternalEntryTarget({ target });
+  if (resolvedTarget !== ROUTES.tip) return resolvedTarget;
+
+  return buildTipCoffeePath(
+    resolveTipCoffeeType(coffeeType) ?? DEFAULT_TIP_COFFEE_TYPE,
+  );
+}
+
 export async function persistExternalEntryPayload({
   deviceId,
   asid,