akanjs 3.0.0-beta.20 → 3.0.0-beta.22

package/README.ko.md

@@ -199,7 +199,6 @@ UI barrel import를 leaf import로 다시 써서 클라이언트 번들을 작
 특수 public surface:
 
 - `akanjs/ui/styles.css`
-- `akanjs/capacitor.base.config`
 - `akanjs/server/rsc-worker`
 - `akanjs/package.json`
 

package/README.md

@@ -197,7 +197,6 @@ frontend build to rewrite UI barrel imports into leaf imports.
 Special public surfaces:
 
 - `akanjs/ui/styles.css`
-- `akanjs/capacitor.base.config`
 - `akanjs/server/rsc-worker`
 - `akanjs/package.json`
 

package/base/baseEnv.ts

@@ -111,6 +111,26 @@ export const resetEnvCache = () => {
   cachedEnv = undefined;
 };
 
+const csrServerUrl = (): URL | null => {
+  const value = process.env.AKAN_PUBLIC_SERVER_URL;
+  if (!value) return null;
+  const url = new URL(value);
+  if (url.protocol !== "http:" && url.protocol !== "https:")
+    throw new Error(`AKAN_PUBLIC_SERVER_URL must be an http(s) URL, got "${value}".`);
+  return url;
+};
+
+const nativeDevGatewayOrigin = (): string | null =>
+  (globalThis as { __AKAN_NATIVE_DEV__?: { gateway?: string } }).__AKAN_NATIVE_DEV__?.gateway
+    ? `${window.location.protocol}//${window.location.host}`
+    : null;
+
+const nativeDevServerUrl = (operationMode: BaseEnv["operationMode"]): URL | null => {
+  const platform = (globalThis as { __AKAN_NATIVE__?: { platform?: string } }).__AKAN_NATIVE__?.platform;
+  if (operationMode !== "local" || !platform || platform === "web") return null;
+  return new URL(`http://localhost:${process.env.AKAN_PUBLIC_SERVER_PORT ?? "8282"}`);
+};
+
 const missingPublicEnv = (key: string) =>
   `getEnv() cannot run at build time: akan build does not inject ${key}. Call it from a runtime function instead of at module scope (e.g. env(() => getEnv()) in adapt(), a method body, or a default thunk).`;
 
@@ -158,7 +178,14 @@ export const getEnv = (): ClientEnv => {
         ? "http:"
         : "https:";
   const clientHttpUri = `${clientHttpProtocol}//${clientHost}${clientPort === 443 ? "" : `:${clientPort}`}`;
+  const csrClient = side === "client" && renderMode === "csr";
+  const pageOrigin = csrClient && !process.env.AKAN_PUBLIC_SERVER_URL ? nativeDevGatewayOrigin() : null;
+  const serverUrl = csrClient && !pageOrigin ? (csrServerUrl() ?? nativeDevServerUrl(operationMode)) : null;
+  
+  const hostFromPage =
+    side === "client" && !serverUrl && (!!pageOrigin || operationMode === "local" || renderMode !== "csr");
   const serverHost =
+    (pageOrigin ? window.location.hostname : serverUrl?.hostname) ??
     process.env.SERVER_HOST ??
     (operationMode === "local"
       ? typeof window === "undefined"
@@ -174,9 +201,14 @@ export const getEnv = (): ClientEnv => {
   const serverPort =
     side === "server"
       ? parseInt(process.env.AKAN_PUBLIC_SERVER_PORT ?? selfServerPort ?? "8282")
-      : parseInt(window.location.port || (window.location.protocol === "https:" ? "443" : "80"));
+      : serverUrl
+        ? parseInt(serverUrl.port || (serverUrl.protocol === "https:" ? "443" : "80"))
+        : hostFromPage
+          ? parseInt(window.location.port || (window.location.protocol === "https:" ? "443" : "80"))
+          : 443;
 
   const serverHttpProtocol: "http:" | "https:" =
+    ((pageOrigin ? window.location.protocol : serverUrl?.protocol) as "http:" | "https:" | undefined) ??
     (process.env.SERVER_HTTP_PROTOCOL as "http:" | "https:" | undefined) ??
     (operationMode === "local"
       ? side === "client"
@@ -189,9 +221,14 @@ export const getEnv = (): ClientEnv => {
           : ("http:" as const));
   const apiPrefix = getApiPrefix();
   const wsPrefix = getWsPrefix();
-  const serverHttpUri = `${serverHttpProtocol}//${serverHost}${serverPort === 443 ? "" : `:${serverPort}`}${apiPrefix}`;
+  
+  const serverHttpUri = pageOrigin
+    ? `${pageOrigin}${apiPrefix}`
+    : `${serverHttpProtocol}//${serverHost}${serverPort === 443 ? "" : `:${serverPort}`}${apiPrefix}`;
   const serverWsProtocol = serverHttpProtocol === "http:" ? "ws:" : "wss:";
-  const serverWsUri = `${serverWsProtocol}//${serverHost}${serverPort === 443 ? "" : `:${serverPort}`}`;
+  const serverWsUri = pageOrigin
+    ? pageOrigin.replace(/^http/, "ws")
+    : `${serverWsProtocol}//${serverHost}${serverPort === 443 ? "" : `:${serverPort}`}`;
 
   const env: ClientEnv = {
     ...baseEnv,

package/client/cookie.ts

@@ -9,8 +9,7 @@ import {
 } from "akanjs/common";
 import type { Account } from "akanjs/fetch";
 import { parseCookieHeader, cookies as serverCookies, headers as serverHeaders } from "akanjs/fetch";
-import { loadCapacitorCore } from "./capacitor";
-import { storage } from "./storage";
+import { secretStorage } from "./storage";
 import { fetch } from "./useClient";
 
 interface CookieOptions {
@@ -19,8 +18,28 @@ interface CookieOptions {
   secure?: boolean;
 }
 
+const isCsrClient = () => {
+  const env = getEnv();
+  return env.side === "client" && env.renderMode === "csr";
+};
+
+const cookieJarKey = "akan:cookies";
+const pageKeepsCookies = () => (globalThis as { location?: Location }).location?.protocol !== "app:";
+const readCookieJar = (): Record<string, string> => {
+  try {
+    return JSON.parse(localStorage.getItem(cookieJarKey) ?? "{}") as Record<string, string>;
+  } catch {
+    return {};
+  }
+};
+const writeCookieJar = (jar: Record<string, string>) => {
+  localStorage.setItem(cookieJarKey, JSON.stringify(jar));
+};
+
 export const cookies = (): Map<string, { name: string; value: string }> => {
   if (getEnv().side === "server") return serverCookies();
+  if (!pageKeepsCookies())
+    return new Map(Object.entries(readCookieJar()).map(([name, value]) => [name, { name, value }]));
   return parseCookieHeader(document.cookie);
 };
 
@@ -29,18 +48,17 @@ export const setCookie = (
   value: string,
   options: CookieOptions = { path: "/", sameSite: "none", secure: true },
 ) => {
-  const env = getEnv();
-  if (env.side === "server") return;
+  if (getEnv().side === "server") return;
+  if (!pageKeepsCookies()) {
+    writeCookieJar({ ...readCookieJar(), [key]: value });
+    return;
+  }
   const encoded = `${key}=${value}`;
   const path = options.path ? `; path=${options.path}` : "";
   const sameSite = options.sameSite ? `; SameSite=${options.sameSite}` : "";
   const secure = options.secure ? "; Secure" : "";
   
   document.cookie = `${encoded}${path}${sameSite}${secure}`;
-  if (env.renderMode !== "csr") return;
-  void loadCapacitorCore()
-    .then(({ CapacitorCookies }) => CapacitorCookies.setCookie({ key, value, path: options.path }))
-    .catch(() => undefined);
 };
 
 /** Reads through `cookies()` on both sides: a hand-rolled `split("=")` cuts base64 padding and skips the `j:` form. */
@@ -49,6 +67,11 @@ export const getCookie = (key: string): string | undefined => cookies().get(key)
 export const removeCookie = (key: string, options: { path: string } = { path: "/" }) => {
   
   if (getEnv().side === "server") return;
+  if (!pageKeepsCookies()) {
+    const { [key]: _removed, ...rest } = readCookieJar();
+    writeCookieJar(rest);
+    return;
+  }
   
   document.cookie = `${key}=; expires=Thu, 01 Jan 1970 00:00:00 UTC; path=${options.path};`;
 };
@@ -63,19 +86,31 @@ export const getHeader = (key: string): string | undefined => {
 
 export { authTokenKey };
 
-/** The auth token this app holds in the cookie jar, under the app-scoped key or a legacy global one. */
-export const getAuthToken = (): string | undefined => readAuthToken(getCookie);
+const sentAuthToken = (): string | undefined => {
+  try {
+    return (fetch.instance as { jwt?: string | null } | undefined)?.jwt ?? undefined;
+  } catch {
+    
+    return undefined;
+  }
+};
 
-/** The auth token this app holds in client storage — localStorage under SSR, Capacitor Preferences on CSR. */
+/** The auth token this app holds: on a CSR client the one `fetch` sends first, since a native shell's page keeps no
+ * session cookie; then the cookie jar, under the app-scoped key or a legacy global one. */
+export const getAuthToken = (): string | undefined =>
+  (isCsrClient() ? sentAuthToken() : undefined) ?? readAuthToken(getCookie);
+
+/** The auth token this app holds in client storage — the OS credential store in a native app, localStorage elsewhere. */
 export const getStoredAuthToken = async (): Promise<string | undefined> => {
-  const scoped = await storage.getItem(authTokenKey());
+  const scoped = await secretStorage.getItem(authTokenKey());
   if (scoped) return scoped;
-  const legacy = await storage.getItem(legacyAuthTokenKey);
+  const legacy = await secretStorage.getItem(legacyAuthTokenKey);
   return legacy && isOwnAuthToken(legacy) ? legacy : undefined;
 };
 
 /** The current JWT's account when minted for this app and environment. Reads only the two credentials the server
- * honours — the app-scoped auth cookie and `Authorization: Bearer` — so the two never disagree on who is signed in. */
+ * honours — the app-scoped auth cookie (a CSR client's bearer token) and `Authorization: Bearer` — so the two never
+ * disagree on who is signed in. */
 export const getAccount = <AddData = unknown>(): Account<AddData> => {
   const jwt = getAuthToken() ?? getHeader("authorization")?.replace(/^Bearer\s+/i, "");
   const defaultAccount = { appName: getEnv().appName, environment: getEnv().environment } as Account<AddData>;
@@ -90,14 +125,15 @@ export interface GetOption {
 interface SetAuthOption {
   jwt: string;
 }
-/** Sets the active auth token on fetch, cookie storage, and client storage. */
+/** Sets the active auth token on fetch, the cookie jar (except on a CSR client), and client storage. */
 export const setAuth = ({ jwt }: SetAuthOption) => {
   fetch.setJwt(jwt);
-  setCookie(authTokenKey(), jwt);
-  void storage.setItem(authTokenKey(), jwt);
+  
+  if (!isCsrClient()) setCookie(authTokenKey(), jwt);
+  void secretStorage.setItem(authTokenKey(), jwt);
   
   removeCookie(legacyAuthTokenKey);
-  void storage.removeItem(legacyAuthTokenKey);
+  void secretStorage.removeItem(legacyAuthTokenKey);
 };
 
 interface InitAuthOption {
@@ -121,6 +157,6 @@ export const resetAuth = () => {
   fetch.setJwt(null);
   removeCookie(authTokenKey());
   removeCookie(legacyAuthTokenKey);
-  void storage.removeItem(authTokenKey());
-  void storage.removeItem(legacyAuthTokenKey);
+  void secretStorage.removeItem(authTokenKey());
+  void secretStorage.removeItem(legacyAuthTokenKey);
 };

package/client/csrTypes.ts

@@ -288,7 +288,16 @@ export type UseCsrTransition = CsrTransitionStyles & {
 };
 
 export type CsrContextType = RouteState & UseCsrTransition;
-export const csrContext = sharedContext<CsrContextType>("csr", {} as unknown as CsrContextType);
+
+export const csrContext = sharedContext<CsrContextType>("csr", {
+  history: { current: null },
+  topSafeAreaRef: { current: null },
+  bottomSafeAreaRef: { current: null },
+  prevPageContentRef: { current: null },
+  pageContentRef: { current: null },
+  frameRootRef: { current: null },
+  onBack: { current: {} },
+} as unknown as CsrContextType);
 export const useCsr = () => {
   const contextValues = useContext(csrContext);
   return contextValues;

package/client/device.ts

@@ -1,16 +1,10 @@
 "use client";
 import type { RefObject } from "react";
-import type {
-  CapacitorDeviceInfo,
-  CapacitorHapticsModule,
-  CapacitorKeyboardInfo,
-  CapacitorKeyboardModule,
-} from "./capacitor";
-
-type DeviceInfo = CapacitorDeviceInfo;
-type Keyboard = CapacitorKeyboardModule["Keyboard"];
-type Haptics = CapacitorHapticsModule["Haptics"];
-type ImpactStyle = CapacitorHapticsModule["ImpactStyle"];
+import { readCssSafeAreaInsets } from "./frameConfig";
+import type { DeviceInfo } from "./native";
+
+type NativeModule = typeof import("./native");
+type NativeControls = Pick<NativeModule, "haptics" | "keyboard">;
 type ProcessEnvLike = { env?: Record<string, string | undefined> };
 type DebugPayload = Record<string, unknown>;
 
@@ -47,37 +41,25 @@ interface DeviceInitOption {
   info: DeviceInfo;
   topSafeArea: number;
   bottomSafeArea: number;
-  keyboard: Keyboard;
-  haptics: Haptics;
-  impactStyle: ImpactStyle;
+  /** The shell's keyboard and haptics; a page outside a native shell has neither. */
+  native: NativeControls | null;
 }
 
-const noopKeyboard: Keyboard = {
-  show: async () => undefined,
-  hide: async () => undefined,
-  addListener: async () => undefined,
-  removeAllListeners: async () => undefined,
-};
-
-const noopHaptics: Haptics = {
-  vibrate: async () => undefined,
-  impact: async () => undefined,
-  selectionStart: async () => undefined,
-  selectionChanged: async () => undefined,
-  selectionEnd: async () => undefined,
-};
-
-const noopImpactStyle: ImpactStyle = {
-  Light: "light",
-  Medium: "medium",
-  Heavy: "heavy",
+const webDeviceInfo: DeviceInfo = {
+  platform: "web",
+  model: "",
+  manufacturer: "unknown",
+  osName: "unknown",
+  osVersion: "",
+  isVirtual: false,
+  webViewVersion: null,
 };
 
 const getRenderMode = () => globalWithProcess.process?.env?.AKAN_PUBLIC_RENDER_ENV ?? "csr";
 
 const getBrowserLanguage = () => globalThis.navigator?.language?.split("-")[0] ?? "en";
 
-const isNativeTarget = () => {
+export const isNativeTarget = () => {
   if (typeof window === "undefined") return false;
   return Boolean((window as typeof window & { __AKAN_MOBILE_TARGET__?: unknown }).__AKAN_MOBILE_TARGET__);
 };
@@ -103,12 +85,10 @@ const createWebDevice = ({
   const pathname = typeof window === "undefined" ? "" : window.location.pathname;
   return new Device({
     lang: lang ?? langInPath(pathname, supportLanguages) ?? getBrowserLanguage(),
-    info: { platform: "web", isVirtual: false, osVersion: "" },
+    info: webDeviceInfo,
     topSafeArea: 0,
     bottomSafeArea: 0,
-    keyboard: noopKeyboard,
-    haptics: noopHaptics,
-    impactStyle: noopImpactStyle,
+    native: null,
   });
 };
 
@@ -126,31 +106,21 @@ export class Device {
       Device.instance = createWebDevice({ lang, supportLanguages });
       return Device.instance;
     }
-    const { loadCapacitorDevice, loadCapacitorHaptics, loadCapacitorKeyboard, loadCapacitorSafeArea } = await import(
-      "./capacitor"
-    );
-    const [{ Device: CapacitorDevice }, { Keyboard }, { Haptics, ImpactStyle }, { SafeArea }] = await Promise.all([
-      loadCapacitorDevice(),
-      loadCapacitorKeyboard(),
-      loadCapacitorHaptics(),
-      loadCapacitorSafeArea(),
-    ]);
-    const [
-      info,
-      { value: languageCode },
-      {
-        insets: { top: topSafeArea, bottom: bottomSafeArea },
-      },
-    ] = await Promise.all([CapacitorDevice.getInfo(), CapacitorDevice.getLanguageCode(), SafeArea.getSafeAreaInsets()]);
-    if (info.platform === "ios") await Keyboard.setResizeMode?.({ mode: "none" });
+    const native = await import("./native");
+    
+    if (!native.isNativeApp()) {
+      Device.instance = createWebDevice({ lang, supportLanguages });
+      return Device.instance;
+    }
+    const [info, { code: languageCode }] = await Promise.all([native.device.getInfo(), native.device.getLanguage()]);
+    
+    const { top: topSafeArea, bottom: bottomSafeArea } = readCssSafeAreaInsets();
     Device.instance = new Device({
       lang: lang ?? langInPath(window.location.pathname, supportLanguages) ?? languageCode,
       info,
       topSafeArea,
       bottomSafeArea,
-      keyboard: Keyboard,
-      haptics: Haptics,
-      impactStyle: ImpactStyle,
+      native: { keyboard: native.keyboard, haptics: native.haptics },
     });
     return Device.instance;
   }
@@ -164,33 +134,26 @@ export class Device {
   topSafeArea: number;
   bottomSafeArea: number;
   isMobile = isMobileDevice();
-  #keyboard: DeviceInitOption["keyboard"];
-  #haptics: DeviceInitOption["haptics"];
-  #impactStyle: DeviceInitOption["impactStyle"];
+  #native: NativeControls | null;
+  #stopKeyboardListeners: (() => void)[] = [];
   #pageContentRef: RefObject<HTMLDivElement | null> | null = null;
 
-  constructor({ lang, info, topSafeArea, bottomSafeArea, keyboard, haptics, impactStyle }: DeviceInitOption) {
+  constructor({ lang, info, topSafeArea, bottomSafeArea, native }: DeviceInitOption) {
     this.info = info;
     this.lang = lang;
     this.topSafeArea = topSafeArea;
     this.bottomSafeArea = bottomSafeArea;
-    this.#keyboard = keyboard;
-    this.#haptics = haptics;
-    this.#impactStyle = impactStyle;
+    this.#native = native;
   }
   setPageContentRef(pageContentRef: RefObject<HTMLDivElement | null>) {
     this.#pageContentRef = pageContentRef;
   }
-  async showKeyboard() {
-    if (this.info.platform === "web") return;
-    await this.#keyboard.show();
-  }
   async hideKeyboard() {
-    if (this.info.platform === "web") return;
-    await this.#keyboard.hide();
+    await this.#native?.keyboard.hide();
   }
   listenKeyboardChanged(onKeyboardChanged: (height: number) => void) {
-    if (this.info.platform === "web") return;
+    const keyboard = this.#native?.keyboard;
+    if (!keyboard) return;
     let currentHeight = 0;
     const emitKeyboardHeight = (event: string, height: number) => {
       debugFrame("keyboard.event", { event, height, previousHeight: currentHeight });
@@ -198,33 +161,22 @@ export class Device {
       currentHeight = height;
       onKeyboardChanged(height);
     };
-    for (const event of ["keyboardWillShow", "keyboardDidShow"])
-      void this.#keyboard.addListener(event, (keyboard: CapacitorKeyboardInfo) => {
-        emitKeyboardHeight(event, keyboard.keyboardHeight);
-      });
-    for (const event of ["keyboardWillHide", "keyboardDidHide"])
-      void this.#keyboard.addListener(event, () => {
-        emitKeyboardHeight(event, 0);
-      });
+    this.#stopKeyboardListeners.push(
+      ...(["willShow", "didShow", "willHide", "didHide"] as const).map((event) =>
+        keyboard.listen(event, ({ height }) => {
+          emitKeyboardHeight(event, height);
+        }),
+      ),
+    );
   }
   unlistenKeyboardChanged() {
-    if (this.info.platform === "web") return;
-    void this.#keyboard.removeAllListeners();
+    for (const stop of this.#stopKeyboardListeners.splice(0)) stop();
   }
   async vibrate(type: "light" | "medium" | "heavy" | number = "medium") {
-    if (typeof type === "number") {
-      await this.#haptics.vibrate({ duration: type });
-      return;
-    }
-    const handleImpact = {
-      light: () => this.#haptics.impact({ style: this.#impactStyle.Light }),
-      medium: () => this.#haptics.impact({ style: this.#impactStyle.Medium }),
-      heavy: () => this.#haptics.impact({ style: this.#impactStyle.Heavy }),
-      selectionStart: () => this.#haptics.selectionStart(),
-      selectionChanged: () => this.#haptics.selectionChanged(),
-      selectionEnd: () => this.#haptics.selectionEnd(),
-    };
-    await handleImpact[type]();
+    const haptics = this.#native?.haptics;
+    if (!haptics) return;
+    if (typeof type === "number") await haptics.vibrate({ duration: type });
+    else await haptics.impact({ style: type });
   }
   getScrollTop() {
     if (this.info.platform === "web") return window.scrollY;

package/client/frameConfig.ts

@@ -238,8 +238,8 @@ export function readCssSafeAreaInsets(): SafeAreaInsets {
   if (typeof window === "undefined") return { top: 0, bottom: 0 };
   const style = window.getComputedStyle?.(document.documentElement);
   return {
-    top: readCssPixel(style?.getPropertyValue("--safe-area-inset-top")) || readCssEnvProbe("top"),
-    bottom: readCssPixel(style?.getPropertyValue("--safe-area-inset-bottom")) || readCssEnvProbe("bottom"),
+    top: readCssPixel(style?.getPropertyValue("--akan-native-safe-area-top")) || readCssEnvProbe("top"),
+    bottom: readCssPixel(style?.getPropertyValue("--akan-native-safe-area-bottom")) || readCssEnvProbe("bottom"),
   };
 }
 

package/client/native.ts

@@ -0,0 +1,46 @@
+import { isNative, platform } from "../vendor/@akanjs/native/packages/core/src/index.ts";
+import { browser } from "../vendor/@akanjs/native/plugins/browser/src/index.ts";
+import { opener } from "../vendor/@akanjs/native/plugins/opener/src/index.ts";
+
+export { AkanNativeError, fileBlob, releaseFile } from "../vendor/@akanjs/native/packages/core/src/index.ts";
+export { app } from "../vendor/@akanjs/native/plugins/app/src/index.ts";
+export { appState } from "../vendor/@akanjs/native/plugins/app-state/src/index.ts";
+export type { Photo } from "../vendor/@akanjs/native/plugins/camera/src/index.ts";
+export type { Contact } from "../vendor/@akanjs/native/plugins/contacts/src/index.ts";
+export type { DeviceInfo } from "../vendor/@akanjs/native/plugins/device/src/index.ts";
+export { device } from "../vendor/@akanjs/native/plugins/device/src/index.ts";
+export { dialog } from "../vendor/@akanjs/native/plugins/dialog/src/index.ts";
+export type { Position } from "../vendor/@akanjs/native/plugins/geolocation/src/index.ts";
+export { haptics } from "../vendor/@akanjs/native/plugins/haptics/src/index.ts";
+export type { IapProduct, IapTransaction } from "../vendor/@akanjs/native/plugins/iap/src/index.ts";
+export { keyboard } from "../vendor/@akanjs/native/plugins/keyboard/src/index.ts";
+export { preferences } from "../vendor/@akanjs/native/plugins/preferences/src/index.ts";
+export type {
+  PushAction,
+  PushMessage,
+  PushPermissionState,
+  PushToken as NativePushToken,
+} from "../vendor/@akanjs/native/plugins/push/src/index.ts";
+export { push } from "../vendor/@akanjs/native/plugins/push/src/index.ts";
+export { secureStorage } from "../vendor/@akanjs/native/plugins/secure-storage/src/index.ts";
+export { browser, opener };
+
+export const loadCamera = () => import("../vendor/@akanjs/native/plugins/camera/src/index.ts");
+export const loadContacts = () => import("../vendor/@akanjs/native/plugins/contacts/src/index.ts");
+export const loadGeolocation = () => import("../vendor/@akanjs/native/plugins/geolocation/src/index.ts");
+export const loadIap = () => import("../vendor/@akanjs/native/plugins/iap/src/index.ts");
+
+/** Inside an iOS or Android shell of the native runtime; a mobile target opened in a browser is not. */
+export const isNativeApp = () => isNative && (platform === "ios" || platform === "android");
+
+export const nativePlatform = () => (isNativeApp() ? (platform as "ios" | "android") : null);
+
+/** http(s) in the in-app browser, anything else (mailto:, tel:) in the app the system picks. */
+export const openExternalUrl = async (url: string) => {
+  if (!isNativeApp()) {
+    window.open(url, "_blank", "noopener,noreferrer");
+    return;
+  }
+  if (/^https?:/i.test(url)) await browser.open({ url });
+  else await opener.openUrl({ url });
+};

package/client/router.ts

@@ -111,6 +111,8 @@ export const normalizeDeepLinkHref = (
   href: string,
   origin = globalThis.window?.location?.origin ?? "http://localhost",
 ) => {
+  
+  if (href.startsWith("/") && !href.startsWith("//")) return normalizeRoutePath(href) ?? "/";
   const url = new URL(href, origin);
   if (url.protocol === "http:" || url.protocol === "https:") return `${url.pathname}${url.search}${url.hash}`;
   const hostPath = url.hostname ? `/${url.hostname}` : "";
@@ -317,10 +319,18 @@ class Router {
       .map((_, index) => `/${segments.slice(0, index + 1).join("/")}`)
       .filter((candidate) => this.#routePaths.has(candidate));
   }
+  
+  #routePathOfLink(path: string) {
+    const segments = path.split("/").filter(Boolean);
+    if (segments[0] && (parseAkanI18nEnv().locales as readonly string[]).includes(segments[0])) segments.shift();
+    if (this.#prefix && segments[0] === this.#prefix) segments.shift();
+    return segments.length ? `/${segments.join("/")}` : "/";
+  }
   resolveDeepLinkStack(href: string) {
     this.#checkInitialized();
     const normalizedHref = normalizeDeepLinkHref(href);
-    const { path, search, hash } = splitHref(normalizedHref);
+    const { path: linkPath, search, hash } = splitHref(normalizedHref);
+    const path = this.#routePathOfLink(linkPath);
     if (this.#routePaths.size > 0 && !this.#routePaths.has(path)) {
       Logger.info(`[router] deep link target '${path}' was not found in route manifest.`);
       return [];

package/client/rscNavigation.ts

@@ -1,6 +1,7 @@
 declare global {
   var __AKAN_RSC_CLEAR_CACHE__: (() => void) | undefined;
   var __AKAN_RSC_IS_FROM_CACHE__: (() => boolean) | undefined;
+  var __AKAN_RSC_REFRESH__: ((options?: { buildId?: number }) => Promise<void>) | undefined;
   var __AKAN_RSC_NAVIGATE__:
     | ((href: string, options?: { replace?: boolean; scrollToTop?: boolean }) => Promise<void>)
     | undefined;
@@ -20,6 +21,10 @@ export const navigateRsc = (href: string, options?: { replace?: boolean; scrollT
   return globalThis.__AKAN_RSC_NAVIGATE__?.(href, options);
 };
 
+export const refreshRsc = () => {
+  return globalThis.__AKAN_RSC_REFRESH__?.();
+};
+
 export const useRscNavigation = () => ({
   clearCache: clearRscNavigationCache,
   isFromCache: isRscNavigationFromCache,