@stackframe/stack 2.6.19 → 2.6.20

package/dist/lib/cookie.d.mts

@@ -1,10 +1,26 @@
 type SetCookieOptions = {
     maxAge?: number;
+    noOpIfServerComponent?: boolean;
 };
-declare function getCookie(name: string): string | null;
-declare function setOrDeleteCookie(name: string, value: string | null, options?: SetCookieOptions): void;
-declare function deleteCookie(name: string): void;
-declare function setCookie(name: string, value: string, options?: SetCookieOptions): void;
+type DeleteCookieOptions = {
+    noOpIfServerComponent?: boolean;
+};
+type CookieHelper = {
+    get: (name: string) => string | null;
+    set: (name: string, value: string, options: SetCookieOptions) => void;
+    setOrDelete: (name: string, value: string | null, options: SetCookieOptions & DeleteCookieOptions) => void;
+    delete: (name: string, options: DeleteCookieOptions) => void;
+};
+declare function createCookieHelper(): Promise<CookieHelper>;
+declare function createBrowserCookieHelper(): CookieHelper;
+declare function getCookieClient(name: string): string | null;
+declare function getCookie(name: string): Promise<string | null>;
+declare function setOrDeleteCookieClient(name: string, value: string | null, options?: SetCookieOptions & DeleteCookieOptions): void;
+declare function setOrDeleteCookie(name: string, value: string | null, options?: SetCookieOptions & DeleteCookieOptions): Promise<void>;
+declare function deleteCookieClient(name: string, options?: DeleteCookieOptions): void;
+declare function deleteCookie(name: string, options?: DeleteCookieOptions): Promise<void>;
+declare function setCookieClient(name: string, value: string, options?: SetCookieOptions): void;
+declare function setCookie(name: string, value: string, options?: SetCookieOptions): Promise<void>;
 declare function saveVerifierAndState(): Promise<{
     codeChallenge: string;
     state: string;
@@ -13,4 +29,4 @@ declare function consumeVerifierAndStateCookie(state: string): {
     codeVerifier: string;
 } | null;
 
-export { consumeVerifierAndStateCookie, deleteCookie, getCookie, saveVerifierAndState, setCookie, setOrDeleteCookie };
+export { type CookieHelper, consumeVerifierAndStateCookie, createBrowserCookieHelper, createCookieHelper, deleteCookie, deleteCookieClient, getCookie, getCookieClient, saveVerifierAndState, setCookie, setCookieClient, setOrDeleteCookie, setOrDeleteCookieClient };

package/dist/lib/cookie.d.ts

@@ -1,10 +1,26 @@
 type SetCookieOptions = {
     maxAge?: number;
+    noOpIfServerComponent?: boolean;
 };
-declare function getCookie(name: string): string | null;
-declare function setOrDeleteCookie(name: string, value: string | null, options?: SetCookieOptions): void;
-declare function deleteCookie(name: string): void;
-declare function setCookie(name: string, value: string, options?: SetCookieOptions): void;
+type DeleteCookieOptions = {
+    noOpIfServerComponent?: boolean;
+};
+type CookieHelper = {
+    get: (name: string) => string | null;
+    set: (name: string, value: string, options: SetCookieOptions) => void;
+    setOrDelete: (name: string, value: string | null, options: SetCookieOptions & DeleteCookieOptions) => void;
+    delete: (name: string, options: DeleteCookieOptions) => void;
+};
+declare function createCookieHelper(): Promise<CookieHelper>;
+declare function createBrowserCookieHelper(): CookieHelper;
+declare function getCookieClient(name: string): string | null;
+declare function getCookie(name: string): Promise<string | null>;
+declare function setOrDeleteCookieClient(name: string, value: string | null, options?: SetCookieOptions & DeleteCookieOptions): void;
+declare function setOrDeleteCookie(name: string, value: string | null, options?: SetCookieOptions & DeleteCookieOptions): Promise<void>;
+declare function deleteCookieClient(name: string, options?: DeleteCookieOptions): void;
+declare function deleteCookie(name: string, options?: DeleteCookieOptions): Promise<void>;
+declare function setCookieClient(name: string, value: string, options?: SetCookieOptions): void;
+declare function setCookie(name: string, value: string, options?: SetCookieOptions): Promise<void>;
 declare function saveVerifierAndState(): Promise<{
     codeChallenge: string;
     state: string;
@@ -13,4 +29,4 @@ declare function consumeVerifierAndStateCookie(state: string): {
     codeVerifier: string;
 } | null;
 
-export { consumeVerifierAndStateCookie, deleteCookie, getCookie, saveVerifierAndState, setCookie, setOrDeleteCookie };
+export { type CookieHelper, consumeVerifierAndStateCookie, createBrowserCookieHelper, createCookieHelper, deleteCookie, deleteCookieClient, getCookie, getCookieClient, saveVerifierAndState, setCookie, setCookieClient, setOrDeleteCookie, setOrDeleteCookieClient };

package/dist/lib/cookie.js

@@ -31,14 +31,22 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var cookie_exports = {};
 __export(cookie_exports, {
   consumeVerifierAndStateCookie: () => consumeVerifierAndStateCookie,
+  createBrowserCookieHelper: () => createBrowserCookieHelper,
+  createCookieHelper: () => createCookieHelper,
   deleteCookie: () => deleteCookie,
+  deleteCookieClient: () => deleteCookieClient,
   getCookie: () => getCookie,
+  getCookieClient: () => getCookieClient,
   saveVerifierAndState: () => saveVerifierAndState,
   setCookie: () => setCookie,
-  setOrDeleteCookie: () => setOrDeleteCookie
+  setCookieClient: () => setCookieClient,
+  setOrDeleteCookie: () => setOrDeleteCookie,
+  setOrDeleteCookieClient: () => setOrDeleteCookieClient
 });
 module.exports = __toCommonJS(cookie_exports);
 var import_force_react_server = require("@stackframe/stack-sc/force-react-server");
+var import_env = require("@stackframe/stack-shared/dist/utils/env");
+var import_errors = require("@stackframe/stack-shared/dist/utils/errors");
 var import_js_cookie = __toESM(require("js-cookie"));
 
 // ../../node_modules/.pnpm/oauth4webapi@2.10.4/node_modules/oauth4webapi/build/index.js
@@ -169,70 +177,140 @@ var skipStateCheck = Symbol();
 var expectNoState = Symbol();
 
 // src/lib/cookie.ts
-function getCookie(name) {
-  if (typeof window !== "undefined") {
-    import_js_cookie.default.set("stack-is-https", "true", { secure: true });
-    return import_js_cookie.default.get(name) ?? null;
-  } else {
-    try {
-      (0, import_force_react_server.cookies)().set("stack-is-https", "true", { secure: true });
-    } catch (e) {
-      if (typeof e === "object" && e !== null && "message" in e && typeof e.message === "string" && e.message.includes("Cookies can only be modified in a Server Action or Route Handler")) {
-      } else {
-        throw e;
-      }
-    }
-    return (0, import_force_react_server.cookies)().get(name)?.value ?? null;
+function ensureClient() {
+  if (!(0, import_env.isBrowserLike)()) {
+    throw new Error("cookieClient functions can only be called in a browser environment, yet window is undefined");
   }
 }
-function setOrDeleteCookie(name, value, options = {}) {
-  if (value === null) {
-    deleteCookie(name);
+async function createCookieHelper() {
+  if ((0, import_env.isBrowserLike)()) {
+    return createBrowserCookieHelper();
   } else {
-    setCookie(name, value, options);
+    return createNextCookieHelper(
+      await (0, import_force_react_server.cookies)(),
+      await (0, import_force_react_server.headers)()
+    );
   }
 }
-function deleteCookie(name) {
-  if (typeof window !== "undefined") {
-    import_js_cookie.default.remove(name);
+function createBrowserCookieHelper() {
+  return {
+    get: getCookieClient,
+    set: setCookieClient,
+    setOrDelete: setOrDeleteCookieClient,
+    delete: deleteCookieClient
+  };
+}
+function handleCookieError(e, options) {
+  if (e instanceof Error && e.message.includes("Cookies can only be modified in")) {
+    if (options.noOpIfServerComponent) {
+    } else {
+      throw new import_errors.StackAssertionError("Attempted to set cookie in server component. Pass { noOpIfServerComponent: true } in the options of Stack's cookie functions if this is intentional and you want to ignore this error. Read more: https://nextjs.org/docs/app/api-reference/functions/cookies#options");
+    }
   } else {
-    (0, import_force_react_server.cookies)().delete(name);
+    throw e;
   }
 }
-function setCookie(name, value, options = {}) {
-  if (typeof window !== "undefined") {
-    import_js_cookie.default.set(name, value, {
-      secure: window.location.protocol === "https:",
-      expires: options.maxAge === void 0 ? void 0 : new Date(Date.now() + options.maxAge * 1e3)
-    });
-  } else {
-    let isSecureCookie = !!(0, import_force_react_server.cookies)().get("stack-is-https");
-    if ((0, import_force_react_server.headers)().get("x-forwarded-proto") === "https") {
-      isSecureCookie = true;
+function createNextCookieHelper(rscCookiesAwaited, rscHeadersAwaited) {
+  const cookieHelper = {
+    get: (name) => {
+      try {
+        rscCookiesAwaited.set("stack-is-https", "true", { secure: true });
+      } catch (e) {
+        if (typeof e === "object" && e !== null && "message" in e && typeof e.message === "string" && e.message.includes("Cookies can only be modified in a Server Action or Route Handler")) {
+        } else {
+          throw e;
+        }
+      }
+      return rscCookiesAwaited.get(name)?.value ?? null;
+    },
+    set: (name, value, options) => {
+      let isSecureCookie = !!rscCookiesAwaited.get("stack-is-https");
+      if (rscHeadersAwaited.get("x-forwarded-proto") === "https") {
+        isSecureCookie = true;
+      }
+      try {
+        rscCookiesAwaited.set(name, value, {
+          secure: isSecureCookie,
+          maxAge: options.maxAge
+        });
+      } catch (e) {
+        handleCookieError(e, options);
+      }
+    },
+    setOrDelete(name, value, options = {}) {
+      if (value === null) {
+        this.delete(name, options);
+      } else {
+        this.set(name, value, options);
+      }
+    },
+    delete(name, options = {}) {
+      try {
+        rscCookiesAwaited.delete(name);
+      } catch (e) {
+        handleCookieError(e, options);
+      }
     }
-    (0, import_force_react_server.cookies)().set(name, value, {
-      secure: isSecureCookie,
-      maxAge: options.maxAge
-    });
+  };
+  return cookieHelper;
+}
+function getCookieClient(name) {
+  ensureClient();
+  import_js_cookie.default.set("stack-is-https", "true", { secure: true });
+  return import_js_cookie.default.get(name) ?? null;
+}
+async function getCookie(name) {
+  const cookieHelper = await createCookieHelper();
+  return cookieHelper.get(name);
+}
+function setOrDeleteCookieClient(name, value, options = {}) {
+  ensureClient();
+  if (value === null) {
+    deleteCookieClient(name, options);
+  } else {
+    setCookieClient(name, value, options);
   }
 }
+async function setOrDeleteCookie(name, value, options = {}) {
+  const cookieHelper = await createCookieHelper();
+  cookieHelper.setOrDelete(name, value, options);
+}
+function deleteCookieClient(name, options = {}) {
+  ensureClient();
+  import_js_cookie.default.remove(name);
+}
+async function deleteCookie(name, options = {}) {
+  const cookieHelper = await createCookieHelper();
+  cookieHelper.delete(name, options);
+}
+function setCookieClient(name, value, options = {}) {
+  ensureClient();
+  import_js_cookie.default.set(name, value, {
+    expires: options.maxAge === void 0 ? void 0 : new Date(Date.now() + options.maxAge * 1e3)
+  });
+}
+async function setCookie(name, value, options = {}) {
+  const cookieHelper = await createCookieHelper();
+  cookieHelper.set(name, value, options);
+}
 async function saveVerifierAndState() {
   const codeVerifier = generateRandomCodeVerifier();
   const codeChallenge = await calculatePKCECodeChallenge(codeVerifier);
   const state = generateRandomState();
-  setCookie("stack-oauth-outer-" + state, codeVerifier, { maxAge: 60 * 60 });
+  await setCookie("stack-oauth-outer-" + state, codeVerifier, { maxAge: 60 * 60 });
   return {
     codeChallenge,
     state
   };
 }
 function consumeVerifierAndStateCookie(state) {
+  ensureClient();
   const cookieName = "stack-oauth-outer-" + state;
-  const codeVerifier = getCookie(cookieName);
+  const codeVerifier = getCookieClient(cookieName);
   if (!codeVerifier) {
     return null;
   }
-  deleteCookie(cookieName);
+  deleteCookieClient(cookieName);
   return {
     codeVerifier
   };
@@ -240,10 +318,16 @@ function consumeVerifierAndStateCookie(state) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   consumeVerifierAndStateCookie,
+  createBrowserCookieHelper,
+  createCookieHelper,
   deleteCookie,
+  deleteCookieClient,
   getCookie,
+  getCookieClient,
   saveVerifierAndState,
   setCookie,
-  setOrDeleteCookie
+  setCookieClient,
+  setOrDeleteCookie,
+  setOrDeleteCookieClient
 });
 //# sourceMappingURL=cookie.js.map