@orangecheck/auth-client 2.17.2 → 2.18.0

package/dist/index.d.mts

@@ -31,6 +31,7 @@ interface OcSessionState {
     status: OcSessionStatus;
     account: OcAccount | null;
     roster: OcAccountSummary[];
+    tabPinned: boolean;
     error: Error | null;
     refresh: () => Promise<void>;
     signOut: (opts?: {
@@ -152,6 +153,20 @@ interface OcLinkedIdentitiesProps {
 }
 declare function OcLinkedIdentities({ authOrigin, className, onChange, }: OcLinkedIdentitiesProps): React.ReactElement;
 
+declare const TAB_SESSION_HEADER = "x-oc-tab-session";
+declare const TAB_SESSION_STORAGE_KEY = "oc_tab_session";
+declare const TAB_ADOPT_HASH = "#oc-adopt";
+interface OcTabSession {
+    token: string;
+    didOc: string;
+}
+declare function readTabSession(): OcTabSession | null;
+declare function writeTabSession(session: OcTabSession): void;
+declare function clearTabSession(): void;
+declare function tabSessionHeader(): Record<string, string>;
+declare function installTabFetchInterceptor(authOrigin: string): () => void;
+declare function consumeTabAdoptMarker(): boolean;
+
 interface WebAuthnCredentialPublic {
     id: string;
     label: string;
@@ -234,4 +249,4 @@ declare function handleSudoRequired(body: {
     returnTo?: string;
 }): boolean;
 
-export { DEFAULT_CONFIG, DISPLAY_IDENTITY_KINDS, type DisplayIdentity, type DisplayIdentityKind, type OcAccount, OcAccountChip, type OcAccountChipProps, OcAccountPill, type OcAccountPillProps, type OcAccountSummary, OcAddressInput, type OcAddressInputProps, type OcAuthConfig, OcLinkedIdentities, type OcLinkedIdentitiesProps, type OcLinkedIdentity, OcSessionProvider, type OcSessionState, type OcSessionStatus, OcSignIn, OcSignInButton, type OcSignInButtonProps, type OcSignInProps, type OcSignOutScope, type RedirectToSudoArgs, type UseOcAddressSuggestionOptions, type UseOcAddressSuggestionReturn, type UseStepUpAuthReturn, type UseWebAuthnListReturn, type UseWebAuthnRegisterReturn, type WebAuthnAssertionStatus, type WebAuthnCredentialPublic, type WebAuthnListStatus, type WebAuthnRegisterResult, type WebAuthnRegisterStatus, type WebAuthnRemoveResult, type WebAuthnRenameResult, type WebAuthnStepUpResult, buildAddAccountUrl, buildSignInUrl, fetchOcLinkedIdentities, handleSudoRequired, redirectToSudo, useOcAddressSuggestion, useOcSession, useOptionalOcSession, useStepUpAuth, useWebAuthnList, useWebAuthnRegister };
+export { DEFAULT_CONFIG, DISPLAY_IDENTITY_KINDS, type DisplayIdentity, type DisplayIdentityKind, type OcAccount, OcAccountChip, type OcAccountChipProps, OcAccountPill, type OcAccountPillProps, type OcAccountSummary, OcAddressInput, type OcAddressInputProps, type OcAuthConfig, OcLinkedIdentities, type OcLinkedIdentitiesProps, type OcLinkedIdentity, OcSessionProvider, type OcSessionState, type OcSessionStatus, OcSignIn, OcSignInButton, type OcSignInButtonProps, type OcSignInProps, type OcSignOutScope, type OcTabSession, type RedirectToSudoArgs, TAB_ADOPT_HASH, TAB_SESSION_HEADER, TAB_SESSION_STORAGE_KEY, type UseOcAddressSuggestionOptions, type UseOcAddressSuggestionReturn, type UseStepUpAuthReturn, type UseWebAuthnListReturn, type UseWebAuthnRegisterReturn, type WebAuthnAssertionStatus, type WebAuthnCredentialPublic, type WebAuthnListStatus, type WebAuthnRegisterResult, type WebAuthnRegisterStatus, type WebAuthnRemoveResult, type WebAuthnRenameResult, type WebAuthnStepUpResult, buildAddAccountUrl, buildSignInUrl, clearTabSession, consumeTabAdoptMarker, fetchOcLinkedIdentities, handleSudoRequired, installTabFetchInterceptor, readTabSession, redirectToSudo, tabSessionHeader, useOcAddressSuggestion, useOcSession, useOptionalOcSession, useStepUpAuth, useWebAuthnList, useWebAuthnRegister, writeTabSession };

package/dist/index.d.ts

@@ -31,6 +31,7 @@ interface OcSessionState {
     status: OcSessionStatus;
     account: OcAccount | null;
     roster: OcAccountSummary[];
+    tabPinned: boolean;
     error: Error | null;
     refresh: () => Promise<void>;
     signOut: (opts?: {
@@ -152,6 +153,20 @@ interface OcLinkedIdentitiesProps {
 }
 declare function OcLinkedIdentities({ authOrigin, className, onChange, }: OcLinkedIdentitiesProps): React.ReactElement;
 
+declare const TAB_SESSION_HEADER = "x-oc-tab-session";
+declare const TAB_SESSION_STORAGE_KEY = "oc_tab_session";
+declare const TAB_ADOPT_HASH = "#oc-adopt";
+interface OcTabSession {
+    token: string;
+    didOc: string;
+}
+declare function readTabSession(): OcTabSession | null;
+declare function writeTabSession(session: OcTabSession): void;
+declare function clearTabSession(): void;
+declare function tabSessionHeader(): Record<string, string>;
+declare function installTabFetchInterceptor(authOrigin: string): () => void;
+declare function consumeTabAdoptMarker(): boolean;
+
 interface WebAuthnCredentialPublic {
     id: string;
     label: string;
@@ -234,4 +249,4 @@ declare function handleSudoRequired(body: {
     returnTo?: string;
 }): boolean;
 
-export { DEFAULT_CONFIG, DISPLAY_IDENTITY_KINDS, type DisplayIdentity, type DisplayIdentityKind, type OcAccount, OcAccountChip, type OcAccountChipProps, OcAccountPill, type OcAccountPillProps, type OcAccountSummary, OcAddressInput, type OcAddressInputProps, type OcAuthConfig, OcLinkedIdentities, type OcLinkedIdentitiesProps, type OcLinkedIdentity, OcSessionProvider, type OcSessionState, type OcSessionStatus, OcSignIn, OcSignInButton, type OcSignInButtonProps, type OcSignInProps, type OcSignOutScope, type RedirectToSudoArgs, type UseOcAddressSuggestionOptions, type UseOcAddressSuggestionReturn, type UseStepUpAuthReturn, type UseWebAuthnListReturn, type UseWebAuthnRegisterReturn, type WebAuthnAssertionStatus, type WebAuthnCredentialPublic, type WebAuthnListStatus, type WebAuthnRegisterResult, type WebAuthnRegisterStatus, type WebAuthnRemoveResult, type WebAuthnRenameResult, type WebAuthnStepUpResult, buildAddAccountUrl, buildSignInUrl, fetchOcLinkedIdentities, handleSudoRequired, redirectToSudo, useOcAddressSuggestion, useOcSession, useOptionalOcSession, useStepUpAuth, useWebAuthnList, useWebAuthnRegister };
+export { DEFAULT_CONFIG, DISPLAY_IDENTITY_KINDS, type DisplayIdentity, type DisplayIdentityKind, type OcAccount, OcAccountChip, type OcAccountChipProps, OcAccountPill, type OcAccountPillProps, type OcAccountSummary, OcAddressInput, type OcAddressInputProps, type OcAuthConfig, OcLinkedIdentities, type OcLinkedIdentitiesProps, type OcLinkedIdentity, OcSessionProvider, type OcSessionState, type OcSessionStatus, OcSignIn, OcSignInButton, type OcSignInButtonProps, type OcSignInProps, type OcSignOutScope, type OcTabSession, type RedirectToSudoArgs, TAB_ADOPT_HASH, TAB_SESSION_HEADER, TAB_SESSION_STORAGE_KEY, type UseOcAddressSuggestionOptions, type UseOcAddressSuggestionReturn, type UseStepUpAuthReturn, type UseWebAuthnListReturn, type UseWebAuthnRegisterReturn, type WebAuthnAssertionStatus, type WebAuthnCredentialPublic, type WebAuthnListStatus, type WebAuthnRegisterResult, type WebAuthnRegisterStatus, type WebAuthnRemoveResult, type WebAuthnRenameResult, type WebAuthnStepUpResult, buildAddAccountUrl, buildSignInUrl, clearTabSession, consumeTabAdoptMarker, fetchOcLinkedIdentities, handleSudoRequired, installTabFetchInterceptor, readTabSession, redirectToSudo, tabSessionHeader, useOcAddressSuggestion, useOcSession, useOptionalOcSession, useStepUpAuth, useWebAuthnList, useWebAuthnRegister, writeTabSession };

package/dist/index.js

@@ -49,6 +49,91 @@ function buildAddAccountUrl(cfg, returnTo) {
   u.searchParams.set("add", "1");
   return u.toString();
 }
+
+// src/tab-session.ts
+var TAB_SESSION_HEADER = "x-oc-tab-session";
+var TAB_SESSION_STORAGE_KEY = "oc_tab_session";
+var TAB_ADOPT_HASH = "#oc-adopt";
+function readTabSession() {
+  if (typeof window === "undefined") return null;
+  try {
+    const raw = window.sessionStorage.getItem(TAB_SESSION_STORAGE_KEY);
+    if (!raw) return null;
+    const parsed = JSON.parse(raw);
+    if (typeof parsed.token !== "string" || parsed.token.length === 0) return null;
+    if (typeof parsed.didOc !== "string" || parsed.didOc.length === 0) return null;
+    return { token: parsed.token, didOc: parsed.didOc };
+  } catch {
+    return null;
+  }
+}
+function writeTabSession(session) {
+  if (typeof window === "undefined") return;
+  try {
+    window.sessionStorage.setItem(TAB_SESSION_STORAGE_KEY, JSON.stringify(session));
+  } catch {
+  }
+}
+function clearTabSession() {
+  if (typeof window === "undefined") return;
+  try {
+    window.sessionStorage.removeItem(TAB_SESSION_STORAGE_KEY);
+  } catch {
+  }
+}
+function tabSessionHeader() {
+  const pin = readTabSession();
+  return pin ? { [TAB_SESSION_HEADER]: pin.token } : {};
+}
+function isPinnableUrl(url, authOrigin) {
+  if (typeof window === "undefined") return false;
+  try {
+    const u = new URL(url, window.location.href);
+    return u.origin === window.location.origin || u.origin === authOrigin;
+  } catch {
+    return false;
+  }
+}
+function installTabFetchInterceptor(authOrigin) {
+  if (typeof window === "undefined") return () => {
+  };
+  const original = window.fetch;
+  const wrapped = (input, init) => {
+    try {
+      const pin = readTabSession();
+      if (pin) {
+        const url = typeof input === "string" ? input : input instanceof URL ? input.href : input.url;
+        if (isPinnableUrl(url, authOrigin)) {
+          const headers = new Headers(
+            init?.headers ?? (input instanceof Request ? input.headers : void 0)
+          );
+          if (!headers.has("authorization") && !headers.has(TAB_SESSION_HEADER)) {
+            headers.set(TAB_SESSION_HEADER, pin.token);
+            init = { ...init, headers };
+          }
+        }
+      }
+    } catch {
+    }
+    return original.call(window, input, init);
+  };
+  window.fetch = wrapped;
+  return () => {
+    if (window.fetch === wrapped) window.fetch = original;
+  };
+}
+function consumeTabAdoptMarker() {
+  if (typeof window === "undefined") return false;
+  if (!window.location.hash.includes(TAB_ADOPT_HASH.slice(1))) return false;
+  clearTabSession();
+  try {
+    const url = new URL(window.location.href);
+    url.hash = "";
+    window.history.replaceState(window.history.state, "", url.toString());
+  } catch {
+  }
+  return true;
+}
 var SessionContext = React3__namespace.createContext(null);
 function normalizeDisplayIdentity(raw, didOc) {
   const di = raw.display_identity ?? raw.displayIdentity;
@@ -75,7 +160,7 @@ async function fetchHostRoster(cfg) {
     const res = await fetch(`${cfg.authOrigin}${cfg.mePath}`, {
       method: "GET",
       credentials: "include",
-      headers: { Accept: "application/json" }
+      headers: { Accept: "application/json", ...tabSessionHeader() }
     });
     if (!res.ok) return [];
     const body = await res.json();
@@ -112,14 +197,50 @@ function OcSessionProvider({
   const [roster, setRoster] = React3__namespace.useState([]);
   const [status, setStatus] = React3__namespace.useState("loading");
   const [error, setError] = React3__namespace.useState(null);
+  const [tabPinned, setTabPinned] = React3__namespace.useState(false);
+  const pinInFlightRef = React3__namespace.useRef(false);
+  const pinThisTab = React3__namespace.useCallback(
+    async (didOc) => {
+      if (pinInFlightRef.current || readTabSession()) return;
+      pinInFlightRef.current = true;
+      try {
+        const res = await fetch(`${cfg.authOrigin}/api/auth/tab`, {
+          method: "POST",
+          credentials: "include",
+          headers: { Accept: "application/json" }
+        });
+        if (!res.ok) return;
+        const body = await res.json();
+        if (body.ok && typeof body.token === "string" && body.account?.did_oc === didOc) {
+          writeTabSession({ token: body.token, didOc });
+          setTabPinned(true);
+        }
+      } catch {
+      } finally {
+        pinInFlightRef.current = false;
+      }
+    },
+    [cfg.authOrigin]
+  );
   const refresh = React3__namespace.useCallback(async () => {
     if (typeof window === "undefined") return;
     try {
-      const res = await fetch(cfg.mePath, {
+      let pin = readTabSession();
+      let res = await fetch(cfg.mePath, {
         method: "GET",
         credentials: "include",
-        headers: { Accept: "application/json" }
+        headers: { Accept: "application/json", ...tabSessionHeader() }
       });
+      if (res.status === 401 && pin) {
+        clearTabSession();
+        pin = null;
+        setTabPinned(false);
+        res = await fetch(cfg.mePath, {
+          method: "GET",
+          credentials: "include",
+          headers: { Accept: "application/json" }
+        });
+      }
       if (res.status === 401) {
         setAccount(null);
         setRoster([]);
@@ -134,11 +255,17 @@ function OcSessionProvider({
       }
       const body = await res.json();
       const acct = normalizeAccount(body.account);
+      if (acct && pin && acct.didOc !== pin.didOc) {
+        clearTabSession();
+        pin = null;
+      }
+      setTabPinned(pin !== null);
       const rosterEntries = Array.isArray(body.roster) ? body.roster.map(normalizeRosterEntry).filter((r) => r !== null) : [];
       setAccount(acct);
       setRoster(rosterEntries);
       setStatus(acct ? "authenticated" : "anonymous");
       setError(null);
+      if (acct && !pin) void pinThisTab(acct.didOc);
       const currentOrigin = typeof window !== "undefined" ? window.location.origin : null;
       if (acct && rosterEntries.length === 0 && currentOrigin !== null && !cfg.authOrigin.startsWith(currentOrigin)) {
         const peers = await fetchHostRoster(cfg);
@@ -148,10 +275,12 @@ function OcSessionProvider({
       setStatus("error");
       setError(err instanceof Error ? err : new Error(String(err)));
     }
-  }, [cfg]);
+  }, [cfg, pinThisTab]);
   React3__namespace.useEffect(() => {
+    consumeTabAdoptMarker();
     void refresh();
   }, [refresh]);
+  React3__namespace.useEffect(() => installTabFetchInterceptor(cfg.authOrigin), [cfg.authOrigin]);
   const signOut = React3__namespace.useCallback(
     async (opts) => {
       const scope = opts?.scope ?? "all";
@@ -161,6 +290,10 @@ function OcSessionProvider({
         const res = await fetch(url.toString(), {
           method: "POST",
           credentials: "include",
+          // Per-tab · carry the pin so scope='current' signs out
+          // the account THIS tab is operating as, not whichever
+          // account the shared cookie happens to point at.
+          headers: { ...tabSessionHeader() },
           // `keepalive` lets the logout round-trip complete even if
           // the caller hard-navigates away in the same tick (e.g.
           // `<OcAccountMenu>` redirects home immediately on sign-out).
@@ -168,11 +301,15 @@ function OcSessionProvider({
           // and the `.ochk.io` cookie may never get cleared.
           keepalive: true
         });
+        clearTabSession();
+        setTabPinned(false);
         if (scope === "current" && res.ok) {
           await refresh();
           return;
         }
       } catch {
+        clearTabSession();
+        setTabPinned(false);
       }
       setAccount(null);
       setRoster([]);
@@ -186,7 +323,7 @@ function OcSessionProvider({
       const res = await fetch(`${cfg.authOrigin}/api/auth/switch`, {
         method: "POST",
         credentials: "include",
-        headers: { "Content-Type": "application/json" },
+        headers: { "Content-Type": "application/json", ...tabSessionHeader() },
         body: JSON.stringify({ did_oc: didOc })
       });
       if (!res.ok) {
@@ -198,6 +335,14 @@ function OcSessionProvider({
         }
         throw new Error(`[@orangecheck/auth-client] switchAccount failed: ${reason}`);
       }
+      try {
+        const body = await res.json();
+        if (typeof body.token === "string" && body.account?.did_oc) {
+          writeTabSession({ token: body.token, didOc: body.account.did_oc });
+          setTabPinned(true);
+        }
+      } catch {
+      }
       await refresh();
     },
     [cfg.authOrigin, refresh]
@@ -215,7 +360,7 @@ function OcSessionProvider({
       const res = await fetch(`${cfg.authOrigin}/api/auth/account`, {
         method: "PATCH",
         credentials: "include",
-        headers: { "Content-Type": "application/json" },
+        headers: { "Content-Type": "application/json", ...tabSessionHeader() },
         body: JSON.stringify({ display_identity: kind })
       });
       if (!res.ok) {
@@ -227,6 +372,14 @@ function OcSessionProvider({
         }
         throw new Error(`[@orangecheck/auth-client] setDisplayIdentity failed: ${reason}`);
       }
+      try {
+        const body = await res.json();
+        const pin = readTabSession();
+        if (pin && typeof body.token === "string" && body.account?.did_oc === pin.didOc) {
+          writeTabSession({ token: body.token, didOc: pin.didOc });
+        }
+      } catch {
+      }
       await refresh();
     },
     [cfg.authOrigin, refresh]
@@ -237,6 +390,7 @@ function OcSessionProvider({
       status,
       account,
       roster,
+      tabPinned,
       error,
       refresh,
       signOut,
@@ -249,6 +403,7 @@ function OcSessionProvider({
     status,
     account,
     roster,
+    tabPinned,
     error,
     refresh,
     signOut,
@@ -1774,6 +1929,18 @@ function safeReturnTo(input) {
   if (!candidate.startsWith("/") || candidate.startsWith("//")) return "/";
   return candidate;
 }
+function familyReturnTarget(input) {
+  if (typeof input !== "string" || input.length === 0) return void 0;
+  if (input.startsWith("/") && !input.startsWith("//")) return input;
+  try {
+    const u = new URL(input);
+    if (u.protocol !== "https:") return void 0;
+    const host = u.hostname.toLowerCase();
+    if (host === "ochk.io" || host.endsWith(".ochk.io")) return u.toString();
+  } catch {
+  }
+  return void 0;
+}
 function hardNavigate(target) {
   if (typeof window === "undefined") return;
   window.location.assign(target);
@@ -1792,7 +1959,20 @@ function OcSignIn({
 }) {
   const walletEnabled = paths?.wallet ?? true;
   const emailEnabled = paths?.email ?? true;
-  const safeReturn = safeReturnTo(returnTo);
+  const [resolvedReturn, setResolvedReturn] = React3__namespace.useState(
+    () => familyReturnTarget(returnTo) ?? safeReturnTo(returnTo)
+  );
+  React3__namespace.useEffect(() => {
+    const fromProp = familyReturnTarget(returnTo);
+    if (fromProp) {
+      setResolvedReturn(fromProp);
+      return;
+    }
+    if (typeof window === "undefined") return;
+    const q = new URLSearchParams(window.location.search);
+    const fromQuery = familyReturnTarget(q.get("return_to")) ?? familyReturnTarget(q.get("next"));
+    setResolvedReturn(fromQuery ?? "/");
+  }, [returnTo]);
   const [addMode, setAddMode] = React3__namespace.useState(Boolean(addProp));
   React3__namespace.useEffect(() => {
     if (typeof window === "undefined") return;
@@ -1816,18 +1996,20 @@ function OcSignIn({
     async (account) => {
       if (resolveReturnTo) {
         try {
-          hardNavigate(safeReturnTo(await resolveReturnTo(account)));
+          const resolved = familyReturnTarget(await resolveReturnTo(account));
+          hardNavigate(resolved ?? resolvedReturn);
           return;
         } catch {
         }
       }
-      hardNavigate(safeReturn);
+      hardNavigate(resolvedReturn);
     },
-    [resolveReturnTo, safeReturn]
+    [resolveReturnTo, resolvedReturn]
   );
   const handleSuccess = React3__namespace.useCallback(
     async (account, token, via) => {
       const proceed = () => {
+        clearTabSession();
         if (onSuccess) onSuccess(account, token);
         else void navigate(account);
       };
@@ -1992,7 +2174,7 @@ function OcSignIn({
         }
       )
     ] }),
-    /* @__PURE__ */ jsxRuntime.jsx(ProviderSignIn, { authOrigin, returnTo: safeReturn }),
+    /* @__PURE__ */ jsxRuntime.jsx(ProviderSignIn, { authOrigin, returnTo: resolvedReturn, add: addMode }),
     linkPrompt && /* @__PURE__ */ jsxRuntime.jsxs("label", { "data-oc-signin-linkalso": "", style: linkAlsoStyle, children: [
       /* @__PURE__ */ jsxRuntime.jsx(
         "input",
@@ -2062,7 +2244,8 @@ function ProviderIcon({ id }) {
 }
 function ProviderSignIn({
   authOrigin,
-  returnTo
+  returnTo,
+  add
 }) {
   const [providers, setProviders] = React3__namespace.useState([]);
   const [origin, setOrigin] = React3__namespace.useState("");
@@ -2078,7 +2261,7 @@ function ProviderSignIn({
     };
   }, [authOrigin]);
   if (providers.length === 0) return null;
-  const providerReturnTo = origin ? `${origin}${returnTo}` : returnTo;
+  const providerReturnTo = returnTo.startsWith("/") ? origin ? `${origin}${returnTo}` : returnTo : returnTo;
   const line = { flex: 1, height: 1, background: "var(--border, #27272a)" };
   return /* @__PURE__ */ jsxRuntime.jsxs("div", { "data-oc-signin-providers": "", style: { marginTop: 20 }, children: [
     /* @__PURE__ */ jsxRuntime.jsxs(
@@ -2107,7 +2290,7 @@ function ProviderSignIn({
       {
         href: `${authOrigin}/api/auth/${p.id}/start?return_to=${encodeURIComponent(
           providerReturnTo
-        )}`,
+        )}${add ? "&add=1" : ""}`,
         "data-oc-signin-provider": p.id,
         style: {
           display: "flex",
@@ -2797,16 +2980,25 @@ exports.OcLinkedIdentities = OcLinkedIdentities;
 exports.OcSessionProvider = OcSessionProvider;
 exports.OcSignIn = OcSignIn;
 exports.OcSignInButton = OcSignInButton;
+exports.TAB_ADOPT_HASH = TAB_ADOPT_HASH;
+exports.TAB_SESSION_HEADER = TAB_SESSION_HEADER;
+exports.TAB_SESSION_STORAGE_KEY = TAB_SESSION_STORAGE_KEY;
 exports.buildAddAccountUrl = buildAddAccountUrl;
 exports.buildSignInUrl = buildSignInUrl;
+exports.clearTabSession = clearTabSession;
+exports.consumeTabAdoptMarker = consumeTabAdoptMarker;
 exports.fetchOcLinkedIdentities = fetchOcLinkedIdentities;
 exports.handleSudoRequired = handleSudoRequired;
+exports.installTabFetchInterceptor = installTabFetchInterceptor;
+exports.readTabSession = readTabSession;
 exports.redirectToSudo = redirectToSudo;
+exports.tabSessionHeader = tabSessionHeader;
 exports.useOcAddressSuggestion = useOcAddressSuggestion;
 exports.useOcSession = useOcSession;
 exports.useOptionalOcSession = useOptionalOcSession;
 exports.useStepUpAuth = useStepUpAuth;
 exports.useWebAuthnList = useWebAuthnList;
 exports.useWebAuthnRegister = useWebAuthnRegister;
+exports.writeTabSession = writeTabSession;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map