@stackframe/tanstack-start 0.0.1 → 2.8.91

package/dist/esm/lib/stack-app/apps/implementations/common.d.ts

@@ -0,0 +1,66 @@
+import { AsyncCache } from "@stackframe/stack-shared/dist/utils/caches";
+import { Result } from "@stackframe/stack-shared/dist/utils/results";
+import { InternalSession } from "@stackframe/stack-shared/dist/sessions";
+import { Store } from "@stackframe/stack-shared/dist/utils/stores";
+import { HandlerUrlOptions, ResolvedHandlerUrls, stackAppInternalsSymbol } from "../../common";
+
+//#region src/lib/stack-app/apps/implementations/common.d.ts
+declare const clientVersion = "STACK_COMPILE_TIME_CLIENT_PACKAGE_VERSION_SENTINEL";
+declare const createCache: <D extends any[], T>(fetcher: (dependencies: D) => Promise<T>) => AsyncCache<D, Result<T>>;
+declare const createCacheBySession: <D extends any[], T>(fetcher: (session: InternalSession, extraDependencies: D) => Promise<T>) => AsyncCache<[InternalSession, ...D], Result<T>>;
+type AppLike = {
+  [stackAppInternalsSymbol]: {
+    getConstructorOptions: () => any;
+  };
+};
+declare function resolveConstructorOptions<T extends {
+  inheritsFrom?: AppLike;
+}>(options: T): T & {
+  inheritsFrom?: undefined;
+};
+declare function getUrls(partial: HandlerUrlOptions, options: {
+  projectId: string;
+}): ResolvedHandlerUrls;
+declare function getDefaultProjectId(): string;
+declare function getDefaultPublishableClientKey(): string | undefined;
+declare function getDefaultSecretServerKey(): string;
+declare function getDefaultSuperSecretAdminKey(): string;
+declare function getDefaultExtraRequestHeaders(): any;
+/**
+ * Returns the base URL for the Stack API.
+ *
+ * The URL can be specified in several ways, in order of precedence:
+ * 1. Directly through userSpecifiedBaseUrl parameter as string or browser/server object
+ * 2. Through environment variables:
+ *    - Browser: NEXT_PUBLIC_BROWSER_STACK_API_URL
+ *    - Server: NEXT_PUBLIC_SERVER_STACK_API_URL
+ *    - Fallback: NEXT_PUBLIC_STACK_API_URL or NEXT_PUBLIC_STACK_URL
+ * 3. Default base URL if none of the above are specified
+ *
+ * The function also ensures the URL doesn't end with a trailing slash
+ * by removing it if present.
+ *
+ * @param userSpecifiedBaseUrl - Optional URL override as string or {browser, server} object
+ * @returns The configured base URL without trailing slash
+
+ */
+declare function getBaseUrl(userSpecifiedBaseUrl: string | {
+  browser: string;
+  server: string;
+} | undefined): string;
+declare const defaultBaseUrl = "https://api.stack-auth.com";
+declare const defaultAnalyticsBaseUrl = "https://r.stack-auth.com";
+declare function getAnalyticsBaseUrl(regularBaseUrl: string): string;
+declare function resolveApiUrls(userExplicitBaseUrl: string | {
+  browser: string;
+  server: string;
+} | undefined): () => string[];
+type TokenObject = {
+  accessToken: string | null;
+  refreshToken: string | null;
+};
+declare function createEmptyTokenStore(): Store<TokenObject>;
+declare function useAsyncCache<D extends any[], T>(cache: AsyncCache<D, Result<T>>, dependencies: D, caller: string): T;
+//#endregion
+export { TokenObject, clientVersion, createCache, createCacheBySession, createEmptyTokenStore, defaultAnalyticsBaseUrl, defaultBaseUrl, getAnalyticsBaseUrl, getBaseUrl, getDefaultExtraRequestHeaders, getDefaultProjectId, getDefaultPublishableClientKey, getDefaultSecretServerKey, getDefaultSuperSecretAdminKey, getUrls, resolveApiUrls, resolveConstructorOptions, useAsyncCache };
+//# sourceMappingURL=common.d.ts.map

package/dist/esm/lib/stack-app/apps/implementations/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","names":[],"sources":["../../../../../../src/lib/stack-app/apps/implementations/common.ts"],"mappings":";;;;;;;cAqBa,aAAA;AAAA,cAYA,WAAA,uBAAmC,OAAA,GAAU,YAAA,EAAc,CAAA,KAAM,OAAA,CAAQ,CAAA,MAAE,UAAA,CAAA,CAAA,EAAA,MAAA,CAAA,CAAA;AAAA,cAO3E,oBAAA,uBAA4C,OAAA,GAAU,OAAA,EAAS,eAAA,EAAiB,iBAAA,EAAmB,CAAA,KAAM,OAAA,CAAQ,CAAA,MAAE,UAAA,EAAA,eAAA,KAAA,CAAA,GAAA,MAAA,CAAA,CAAA;AAAA,KAa3H,OAAA;EAAA,CAAa,uBAAA;IAA4B,qBAAA;EAAA;AAAA;AAAA,iBAC9B,yBAAA;EAAsC,YAAA,GAAe,OAAA;AAAA,EAAA,CAAW,OAAA,EAAS,CAAA,GAAI,CAAA;EAAM,YAAA;AAAA;AAAA,iBAOnF,OAAA,CAAQ,OAAA,EAAS,iBAAA,EAAmB,OAAA;EAAW,SAAA;AAAA,IAAsB,mBAAA;AAAA,iBAOrE,mBAAA,CAAA;AAAA,iBAIA,8BAAA,CAAA;AAAA,iBAIA,yBAAA,CAAA;AAAA,iBAIA,6BAAA,CAAA;AAAA,iBAIA,6BAAA,CAAA;;;;;;;;;;;;AA5ChB;;;;;;;iBAkEgB,UAAA,CAAW,oBAAA;EAAiC,OAAA;EAAiB,MAAA;AAAA;AAAA,cAwBhE,cAAA;AAAA,cACA,uBAAA;AAAA,iBAEG,mBAAA,CAAoB,cAAA;AAAA,iBA0BpB,cAAA,CAAe,mBAAA;EAAgC,OAAA;EAAiB,MAAA;AAAA;AAAA,KAcpE,WAAA;EACV,WAAA;EACA,YAAA;AAAA;AAAA,iBAGc,qBAAA,CAAA,GAAqB,KAAA,CAAA,WAAA;AAAA,iBASrB,aAAA,oBAAA,CAAkC,KAAA,EAAO,UAAA,CAAW,CAAA,EAAG,MAAA,CAAO,CAAA,IAAK,YAAA,EAAc,CAAA,EAAG,MAAA,WAAiB,CAAA"}

package/dist/esm/lib/stack-app/apps/implementations/common.js

@@ -0,0 +1,167 @@
+import { StackAssertionError, captureError, concatStacktraces, throwErr } from "@stackframe/stack-shared/dist/utils/errors";
+import { runAsynchronously } from "@stackframe/stack-shared/dist/utils/promises";
+import React, { useCallback } from "react";
+import { AsyncCache } from "@stackframe/stack-shared/dist/utils/caches";
+import { use } from "@stackframe/stack-shared/dist/utils/react";
+import { filterUndefined, omit } from "@stackframe/stack-shared/dist/utils/objects";
+import { getDefaultApiUrls } from "@stackframe/stack-shared/dist/utils/urls";
+import { Result } from "@stackframe/stack-shared/dist/utils/results";
+import { isBrowserLike } from "@stackframe/stack-shared/dist/utils/env";
+import { createGlobal, getGlobal } from "@stackframe/stack-shared/dist/utils/globals";
+import { stackAppInternalsSymbol } from "../../common.js";
+import { Store } from "@stackframe/stack-shared/dist/utils/stores";
+import { envVars } from "../../../env.js";
+import { resolveHandlerUrls } from "../../url-targets.js";
+
+//#region src/lib/stack-app/apps/implementations/common.ts
+const clientVersion = "js @stackframe/tanstack-start@2.8.91";
+if (clientVersion.startsWith("STACK_COMPILE_TIME")) throw new StackAssertionError("Client version was not replaced. Something went wrong during build!");
+const replaceStackPortPrefix = (input) => {
+	if (!input) return input;
+	const prefix = envVars.NEXT_PUBLIC_STACK_PORT_PREFIX;
+	return prefix ? input.replace(/\$\{NEXT_PUBLIC_STACK_PORT_PREFIX:-81\}/g, prefix) : input;
+};
+const createCache = (fetcher) => {
+	return new AsyncCache(async (dependencies) => await Result.fromThrowingAsync(async () => await fetcher(dependencies)), {});
+};
+const createCacheBySession = (fetcher) => {
+	return new AsyncCache(async ([session, ...extraDependencies]) => await Result.fromThrowingAsync(async () => await fetcher(session, extraDependencies)), { onSubscribe: ([session], refresh) => {
+		const handler = session.onInvalidate(() => refresh());
+		return () => handler.unsubscribe();
+	} });
+};
+function resolveConstructorOptions(options) {
+	return {
+		...options.inheritsFrom?.[stackAppInternalsSymbol].getConstructorOptions() ?? {},
+		...filterUndefined(omit(options, ["inheritsFrom"]))
+	};
+}
+function getUrls(partial, options) {
+	return resolveHandlerUrls({
+		urls: partial,
+		projectId: options.projectId
+	});
+}
+function getDefaultProjectId() {
+	return envVars.NEXT_PUBLIC_STACK_PROJECT_ID || envVars.STACK_PROJECT_ID || throwErr(/* @__PURE__ */ new Error("Welcome to Stack Auth! It seems that you haven't provided a project ID. Please create a project on the Stack dashboard at https://app.stack-auth.com and put it in the NEXT_PUBLIC_STACK_PROJECT_ID environment variable."));
+}
+function getDefaultPublishableClientKey() {
+	return envVars.NEXT_PUBLIC_STACK_PUBLISHABLE_CLIENT_KEY || envVars.STACK_PUBLISHABLE_CLIENT_KEY;
+}
+function getDefaultSecretServerKey() {
+	return envVars.STACK_SECRET_SERVER_KEY || throwErr(/* @__PURE__ */ new Error("No secret server key provided. Please copy your key from the Stack dashboard and put it in the STACK_SECRET_SERVER_KEY environment variable."));
+}
+function getDefaultSuperSecretAdminKey() {
+	return envVars.STACK_SUPER_SECRET_ADMIN_KEY || throwErr(/* @__PURE__ */ new Error("No super secret admin key provided. Please copy your key from the Stack dashboard and put it in the STACK_SUPER_SECRET_ADMIN_KEY environment variable."));
+}
+function getDefaultExtraRequestHeaders() {
+	return JSON.parse(envVars.NEXT_PUBLIC_STACK_EXTRA_REQUEST_HEADERS || envVars.STACK_EXTRA_REQUEST_HEADERS || "{}");
+}
+/**
+* Returns the base URL for the Stack API.
+*
+* The URL can be specified in several ways, in order of precedence:
+* 1. Directly through userSpecifiedBaseUrl parameter as string or browser/server object
+* 2. Through environment variables:
+*    - Browser: NEXT_PUBLIC_BROWSER_STACK_API_URL
+*    - Server: NEXT_PUBLIC_SERVER_STACK_API_URL
+*    - Fallback: NEXT_PUBLIC_STACK_API_URL or NEXT_PUBLIC_STACK_URL
+* 3. Default base URL if none of the above are specified
+*
+* The function also ensures the URL doesn't end with a trailing slash
+* by removing it if present.
+*
+* @param userSpecifiedBaseUrl - Optional URL override as string or {browser, server} object
+* @returns The configured base URL without trailing slash
+
+*/
+function getBaseUrl(userSpecifiedBaseUrl) {
+	let url;
+	if (userSpecifiedBaseUrl) if (typeof userSpecifiedBaseUrl === "string") url = userSpecifiedBaseUrl;
+	else if (isBrowserLike()) url = userSpecifiedBaseUrl.browser;
+	else url = userSpecifiedBaseUrl.server;
+	else {
+		if (isBrowserLike()) url = envVars.NEXT_PUBLIC_BROWSER_STACK_API_URL || envVars.NEXT_PUBLIC_STACK_API_URL_BROWSER || envVars.STACK_API_URL_BROWSER;
+		else url = envVars.NEXT_PUBLIC_SERVER_STACK_API_URL || envVars.NEXT_PUBLIC_STACK_API_URL_SERVER || envVars.STACK_API_URL_SERVER;
+		url = url || envVars.NEXT_PUBLIC_STACK_API_URL || envVars.STACK_API_URL || envVars.NEXT_PUBLIC_STACK_URL || defaultBaseUrl;
+	}
+	return replaceStackPortPrefix(url.endsWith("/") ? url.slice(0, -1) : url);
+}
+const defaultBaseUrl = "https://api.stack-auth.com";
+const defaultAnalyticsBaseUrl = "https://r.stack-auth.com";
+function getAnalyticsBaseUrl(regularBaseUrl) {
+	return regularBaseUrl === defaultBaseUrl ? defaultAnalyticsBaseUrl : regularBaseUrl;
+}
+function fetchBackendUrlsInBackground(primaryBaseUrl) {
+	createGlobal("__stack-fetch-backend-urls-started", () => {
+		runAsynchronously(async () => {
+			try {
+				const res = await fetch(`${primaryBaseUrl}/api/v1/internal/backend-urls`);
+				if (!res.ok) return;
+				const data = await res.json();
+				if (!Array.isArray(data.urls) || !data.urls.every((u) => typeof u === "string")) return;
+				createGlobal("__stack-fetched-backend-urls", () => data.urls);
+			} catch (e) {
+				captureError("fetch-backend-urls-in-background", e);
+			}
+		});
+		return true;
+	});
+}
+function resolveApiUrls(userExplicitBaseUrl) {
+	return () => {
+		if (userExplicitBaseUrl != null) return [getBaseUrl(userExplicitBaseUrl)];
+		const primary = getBaseUrl(void 0);
+		fetchBackendUrlsInBackground(primary);
+		return getGlobal("__stack-fetched-backend-urls") ?? getDefaultApiUrls(primary);
+	};
+}
+function createEmptyTokenStore() {
+	return new Store({
+		refreshToken: null,
+		accessToken: null
+	});
+}
+const cachePromiseByHookId = /* @__PURE__ */ new Map();
+function useAsyncCache(cache, dependencies, caller) {
+	if (!isBrowserLike()) {
+		const result = use(cache.getOrWait(dependencies, "read-write"));
+		if (result.status === "error") throw result.error;
+		return result.data;
+	}
+	const asyncCacheHooks = getGlobal("use-async-cache-execution-hooks") ?? [];
+	for (const hook of asyncCacheHooks) hook({
+		cache,
+		caller,
+		dependencies
+	});
+	const id = React.useId();
+	React.useEffect(() => {
+		cachePromiseByHookId.delete(id);
+	}, [...dependencies, id]);
+	const subscribe = useCallback((cb) => {
+		const { unsubscribe } = cache.onStateChange(dependencies, () => {
+			cachePromiseByHookId.delete(id);
+			cb();
+		});
+		return unsubscribe;
+	}, [cache, ...dependencies]);
+	const getSnapshot = useCallback(() => {
+		if (!cachePromiseByHookId.has(id)) cachePromiseByHookId.set(id, cache.getOrWait(dependencies, "read-write"));
+		return cachePromiseByHookId.get(id);
+	}, [cache, ...dependencies]);
+	const result = use(React.useSyncExternalStore(subscribe, getSnapshot, getSnapshot));
+	if (result.status === "error") {
+		const error = result.error;
+		if (error instanceof Error && !error.__stackHasConcatenatedStacktraces) {
+			concatStacktraces(error, /* @__PURE__ */ new Error());
+			error.__stackHasConcatenatedStacktraces = true;
+		}
+		throw error;
+	}
+	return result.data;
+}
+
+//#endregion
+export { clientVersion, createCache, createCacheBySession, createEmptyTokenStore, defaultAnalyticsBaseUrl, defaultBaseUrl, getAnalyticsBaseUrl, getBaseUrl, getDefaultExtraRequestHeaders, getDefaultProjectId, getDefaultPublishableClientKey, getDefaultSecretServerKey, getDefaultSuperSecretAdminKey, getUrls, resolveApiUrls, resolveConstructorOptions, useAsyncCache };
+//# sourceMappingURL=common.js.map

package/dist/esm/lib/stack-app/apps/implementations/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","names":[],"sources":["../../../../../../src/lib/stack-app/apps/implementations/common.ts"],"sourcesContent":["\n//===========================================\n// THIS FILE IS AUTO-GENERATED FROM TEMPLATE. DO NOT EDIT IT DIRECTLY, INSTEAD EDIT THE CORRESPONDING FILE IN packages/template\n//===========================================\nimport { InternalSession } from \"@stackframe/stack-shared/dist/sessions\";\nimport { AsyncCache } from \"@stackframe/stack-shared/dist/utils/caches\";\nimport { isBrowserLike } from \"@stackframe/stack-shared/dist/utils/env\";\nimport { StackAssertionError, captureError, concatStacktraces, throwErr } from \"@stackframe/stack-shared/dist/utils/errors\";\nimport { createGlobal, getGlobal } from \"@stackframe/stack-shared/dist/utils/globals\";\nimport { runAsynchronously } from \"@stackframe/stack-shared/dist/utils/promises\";\nimport { filterUndefined, omit } from \"@stackframe/stack-shared/dist/utils/objects\";\nimport { ReactPromise } from \"@stackframe/stack-shared/dist/utils/promises\";\nimport { suspendIfSsr, use } from \"@stackframe/stack-shared/dist/utils/react\";\nimport { Result } from \"@stackframe/stack-shared/dist/utils/results\";\nimport { Store } from \"@stackframe/stack-shared/dist/utils/stores\";\nimport { getDefaultApiUrls } from \"@stackframe/stack-shared/dist/utils/urls\";\nimport React, { useCallback } from \"react\"; // THIS_LINE_PLATFORM react-like\nimport { envVars } from \"../../../env\";\nimport { HandlerUrlOptions, ResolvedHandlerUrls, stackAppInternalsSymbol } from \"../../common\";\nimport { resolveHandlerUrls } from \"../../url-targets\";\n\nexport const clientVersion = \"STACK_COMPILE_TIME_CLIENT_PACKAGE_VERSION_SENTINEL\";\nif (clientVersion.startsWith(\"STACK_COMPILE_TIME\")) {\n  throw new StackAssertionError(\"Client version was not replaced. Something went wrong during build!\");\n}\n\nconst replaceStackPortPrefix = <T extends string | undefined>(input: T): T => {\n  if (!input) return input;\n  const prefix = envVars.NEXT_PUBLIC_STACK_PORT_PREFIX;\n  return prefix ? input.replace(/\\$\\{NEXT_PUBLIC_STACK_PORT_PREFIX:-81\\}/g, prefix) as T : input;\n};\n\n\nexport const createCache = <D extends any[], T>(fetcher: (dependencies: D) => Promise<T>) => {\n  return new AsyncCache<D, Result<T>>(\n    async (dependencies) => await Result.fromThrowingAsync(async () => await fetcher(dependencies)),\n    {},\n  );\n};\n\nexport const createCacheBySession = <D extends any[], T>(fetcher: (session: InternalSession, extraDependencies: D) => Promise<T> ) => {\n  return new AsyncCache<[InternalSession, ...D], Result<T>>(\n    async ([session, ...extraDependencies]) => await Result.fromThrowingAsync(async () => await fetcher(session, extraDependencies)),\n    {\n      onSubscribe: ([session], refresh) => {\n        const handler = session.onInvalidate(() => refresh());\n        return () => handler.unsubscribe();\n      },\n    },\n  );\n};\n\n\ntype AppLike = { [stackAppInternalsSymbol]: { getConstructorOptions: () => any } };\nexport function resolveConstructorOptions<T extends { inheritsFrom?: AppLike }>(options: T): T & { inheritsFrom?: undefined } {\n  return {\n    ...options.inheritsFrom?.[stackAppInternalsSymbol].getConstructorOptions() ?? {},\n    ...filterUndefined(omit(options, [\"inheritsFrom\"])),\n  };\n}\n\nexport function getUrls(partial: HandlerUrlOptions, options: { projectId: string }): ResolvedHandlerUrls {\n  return resolveHandlerUrls({\n    urls: partial,\n    projectId: options.projectId,\n  });\n}\n\nexport function getDefaultProjectId() {\n  return envVars.NEXT_PUBLIC_STACK_PROJECT_ID || envVars.STACK_PROJECT_ID || throwErr(new Error(\"Welcome to Stack Auth! It seems that you haven't provided a project ID. Please create a project on the Stack dashboard at https://app.stack-auth.com and put it in the NEXT_PUBLIC_STACK_PROJECT_ID environment variable.\"));\n}\n\nexport function getDefaultPublishableClientKey() {\n  return envVars.NEXT_PUBLIC_STACK_PUBLISHABLE_CLIENT_KEY || envVars.STACK_PUBLISHABLE_CLIENT_KEY;\n}\n\nexport function getDefaultSecretServerKey() {\n  return envVars.STACK_SECRET_SERVER_KEY || throwErr(new Error(\"No secret server key provided. Please copy your key from the Stack dashboard and put it in the STACK_SECRET_SERVER_KEY environment variable.\"));\n}\n\nexport function getDefaultSuperSecretAdminKey() {\n  return envVars.STACK_SUPER_SECRET_ADMIN_KEY || throwErr(new Error(\"No super secret admin key provided. Please copy your key from the Stack dashboard and put it in the STACK_SUPER_SECRET_ADMIN_KEY environment variable.\"));\n}\n\nexport function getDefaultExtraRequestHeaders() {\n  return JSON.parse(envVars.NEXT_PUBLIC_STACK_EXTRA_REQUEST_HEADERS || envVars.STACK_EXTRA_REQUEST_HEADERS || '{}');\n}\n\n/**\n * Returns the base URL for the Stack API.\n *\n * The URL can be specified in several ways, in order of precedence:\n * 1. Directly through userSpecifiedBaseUrl parameter as string or browser/server object\n * 2. Through environment variables:\n *    - Browser: NEXT_PUBLIC_BROWSER_STACK_API_URL\n *    - Server: NEXT_PUBLIC_SERVER_STACK_API_URL\n *    - Fallback: NEXT_PUBLIC_STACK_API_URL or NEXT_PUBLIC_STACK_URL\n * 3. Default base URL if none of the above are specified\n *\n * The function also ensures the URL doesn't end with a trailing slash\n * by removing it if present.\n *\n * @param userSpecifiedBaseUrl - Optional URL override as string or {browser, server} object\n * @returns The configured base URL without trailing slash\n\n */\nexport function getBaseUrl(userSpecifiedBaseUrl: string | { browser: string, server: string } | undefined) {\n  let url;\n  if (userSpecifiedBaseUrl) {\n    if (typeof userSpecifiedBaseUrl === \"string\") {\n      url = userSpecifiedBaseUrl;\n    } else {\n      if (isBrowserLike()) {\n        url = userSpecifiedBaseUrl.browser;\n      } else {\n        url = userSpecifiedBaseUrl.server;\n      }\n    }\n  } else {\n    // note: NEXT_PUBLIC_BROWSER_STACK_API_URL was renamed to NEXT_PUBLIC_STACK_API_URL_BROWSER, and NEXT_PUBLIC_STACK_URL to NEXT_PUBLIC_STACK_API_URL\n    if (isBrowserLike()) {\n      url = envVars.NEXT_PUBLIC_BROWSER_STACK_API_URL || envVars.NEXT_PUBLIC_STACK_API_URL_BROWSER || envVars.STACK_API_URL_BROWSER;\n    } else {\n      url = envVars.NEXT_PUBLIC_SERVER_STACK_API_URL || envVars.NEXT_PUBLIC_STACK_API_URL_SERVER || envVars.STACK_API_URL_SERVER;\n    }\n    url = url || envVars.NEXT_PUBLIC_STACK_API_URL || envVars.STACK_API_URL || envVars.NEXT_PUBLIC_STACK_URL || defaultBaseUrl;\n  }\n\n  return replaceStackPortPrefix(url.endsWith('/') ? url.slice(0, -1) : url);\n}\nexport const defaultBaseUrl = \"https://api.stack-auth.com\";\nexport const defaultAnalyticsBaseUrl = \"https://r.stack-auth.com\";\n\nexport function getAnalyticsBaseUrl(regularBaseUrl: string): string {\n  return regularBaseUrl === defaultBaseUrl ? defaultAnalyticsBaseUrl : regularBaseUrl;\n}\n\n\nfunction fetchBackendUrlsInBackground(primaryBaseUrl: string): void {\n  createGlobal('__stack-fetch-backend-urls-started', () => {\n    runAsynchronously(async () => {\n      try {\n        const res = await fetch(`${primaryBaseUrl}/api/v1/internal/backend-urls`);\n        if (!res.ok) {\n          return;\n        }\n        const data = await res.json();\n        if (!Array.isArray(data.urls) || !data.urls.every((u: unknown) => typeof u === 'string')) {\n          return;\n        }\n        createGlobal('__stack-fetched-backend-urls', () => data.urls as string[]);\n      } catch (e) {\n        captureError('fetch-backend-urls-in-background', e);\n      }\n    });\n    return true;\n  });\n}\n\nexport function resolveApiUrls(userExplicitBaseUrl: string | { browser: string, server: string } | undefined): () => string[] {\n  return () => {\n    if (userExplicitBaseUrl != null) {\n      return [getBaseUrl(userExplicitBaseUrl)];\n    }\n    const primary = getBaseUrl(undefined);\n    // Always try to fetch server-configured URLs (supports custom domains via\n    // STACK_BACKEND_URLS_CONFIG). Hardcoded fallbacks are used as a default\n    // until the background fetch completes.\n    fetchBackendUrlsInBackground(primary);\n    return getGlobal('__stack-fetched-backend-urls') ?? getDefaultApiUrls(primary);\n  };\n}\n\nexport type TokenObject = {\n  accessToken: string | null,\n  refreshToken: string | null,\n};\n\nexport function createEmptyTokenStore() {\n  return new Store<TokenObject>({\n    refreshToken: null,\n    accessToken: null,\n  });\n}\n\n\nconst cachePromiseByHookId = new Map<string, ReactPromise<Result<unknown>>>();\nexport function useAsyncCache<D extends any[], T>(cache: AsyncCache<D, Result<T>>, dependencies: D, caller: string): T {\n  // we explicitly don't want to run this hook in SSR\n  if (!isBrowserLike()) {\n    const result = use(cache.getOrWait(dependencies, \"read-write\"));\n    if (result.status === \"error\") {\n      throw result.error;\n    }\n    return result.data;\n  }\n\n  // on the dashboard, we do some perf monitoring for pre-fetching which should hook right in here\n  const asyncCacheHooks: any[] = getGlobal(\"use-async-cache-execution-hooks\") ?? [];\n  for (const hook of asyncCacheHooks) {\n    hook({ cache, caller, dependencies });\n  }\n\n  const id = React.useId();\n\n  // whenever the dependencies change, we need to refresh the promise cache\n  React.useEffect(() => {\n    cachePromiseByHookId.delete(id);\n  }, [...dependencies, id]);\n\n  const subscribe = useCallback((cb: () => void) => {\n    const { unsubscribe } = cache.onStateChange(dependencies, () => {\n      cachePromiseByHookId.delete(id);\n      cb();\n    });\n    return unsubscribe;\n  }, [cache, ...dependencies]);\n  const getSnapshot = useCallback(() => {\n    // React checks whether a promise passed to `use` is still the same as the previous one by comparing the reference.\n    // If we didn't cache here, this wouldn't work because the promise would be recreated every time the value changes.\n    if (!cachePromiseByHookId.has(id)) {\n      cachePromiseByHookId.set(id, cache.getOrWait(dependencies, \"read-write\"));\n    }\n    return cachePromiseByHookId.get(id) as ReactPromise<Result<T>>;\n  }, [cache, ...dependencies]);\n\n  // note: we must use React.useSyncExternalStore instead of importing the function directly, as it will otherwise\n  // throw an error on Next.js (\"can't import useSyncExternalStore from the server\")\n  const promise = React.useSyncExternalStore(\n    subscribe,\n    getSnapshot,\n    getSnapshot,\n  );\n\n  const result = use(promise);\n  if (result.status === \"error\") {\n    const error = result.error;\n    if (error instanceof Error && !(error as any).__stackHasConcatenatedStacktraces) {\n      concatStacktraces(error, new Error());\n      (error as any).__stackHasConcatenatedStacktraces = true;\n    }\n    throw error;\n  }\n  return result.data;\n}\n"],"mappings":"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"}

package/dist/esm/lib/stack-app/apps/implementations/event-tracker.d.ts

@@ -0,0 +1,42 @@
+import { Result } from "@stackframe/stack-shared/dist/utils/results";
+
+//#region src/lib/stack-app/apps/implementations/event-tracker.d.ts
+type EventTrackerDeps = {
+  projectId: string;
+  sendBatch: (body: string, options: {
+    keepalive: boolean;
+  }) => Promise<Result<Response, Error>>;
+};
+declare class EventTracker {
+  private _started;
+  private _cancelled;
+  private _detachListeners;
+  private _flushTimer;
+  private _events;
+  private _approxBytes;
+  private _lastUrl;
+  private readonly _sessionReplaySegmentId;
+  private readonly _deps;
+  private _originalPushState;
+  private _originalReplaceState;
+  constructor(deps: EventTrackerDeps);
+  start(): void;
+  stop(): void;
+  clearBuffer(): void;
+  private _pushEvent;
+  private _capturePageView;
+  private _setupPageViewCapture;
+  private readonly _onPopState;
+  private _buildSelector;
+  private _findNearestAnchorHref;
+  private readonly _onClickCapture;
+  private _setupClickCapture;
+  private readonly _onPageHide;
+  private _setupPageHideListeners;
+  private _teardown;
+  private _flush;
+  private _tick;
+}
+//#endregion
+export { EventTracker, EventTrackerDeps };
+//# sourceMappingURL=event-tracker.d.ts.map

package/dist/esm/lib/stack-app/apps/implementations/event-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-tracker.d.ts","names":[],"sources":["../../../../../../src/lib/stack-app/apps/implementations/event-tracker.ts"],"mappings":";;;KAiCY,gBAAA;EACV,SAAA;EACA,SAAA,GAAY,IAAA,UAAc,OAAA;IAAW,SAAA;EAAA,MAAyB,OAAA,CAAQ,MAAA,CAAO,QAAA,EAAU,KAAA;AAAA;AAAA,cAS5E,YAAA;EAAA,QACH,QAAA;EAAA,QACA,UAAA;EAAA,QACA,gBAAA;EAAA,QACA,WAAA;EAAA,QACA,OAAA;EAAA,QACA,YAAA;EAAA,QACA,QAAA;EAAA,iBACS,uBAAA;EAAA,iBACA,KAAA;EAAA,QAET,kBAAA;EAAA,QACA,qBAAA;cAEI,IAAA,EAAM,gBAAA;EAKlB,KAAA,CAAA;EAqBA,IAAA,CAAA;EAUA,WAAA,CAAA;EAAA,QAKQ,UAAA;EAAA,QAQA,gBAAA;EAAA,QA2BA,qBAAA;EAAA,iBA4BS,WAAA;EAAA,QAIT,cAAA;EAAA,QA0BA,sBAAA;EAAA,iBAWS,eAAA;EAAA,QAsBT,kBAAA;EAAA,iBAIS,WAAA;EAAA,QAIT,uBAAA;EAAA,QASA,SAAA;EAAA,QA0BM,MAAA;EAAA,QA+BN,KAAA;AAAA"}

package/dist/esm/lib/stack-app/apps/implementations/event-tracker.js

@@ -0,0 +1,211 @@
+import { runAsynchronously } from "@stackframe/stack-shared/dist/utils/promises";
+import { isBrowserLike } from "@stackframe/stack-shared/dist/utils/env";
+import { generateUuid } from "./session-replay.js";
+
+//#region src/lib/stack-app/apps/implementations/event-tracker.ts
+const FLUSH_INTERVAL_MS = 1e4;
+const MAX_EVENTS_PER_BATCH = 50;
+const MAX_APPROX_BYTES_PER_BATCH = 64e3;
+function hasScreenDimensions(value) {
+	if (value == null || typeof value !== "object") return false;
+	if (!("width" in value) || !("height" in value)) return false;
+	return typeof value.width === "number" && typeof value.height === "number";
+}
+function hasHistoryMethods(value) {
+	if (value == null || typeof value !== "object") return false;
+	if (!("pushState" in value) || !("replaceState" in value)) return false;
+	return typeof value.pushState === "function" && typeof value.replaceState === "function";
+}
+var EventTracker = class {
+	constructor(deps) {
+		this._started = false;
+		this._cancelled = false;
+		this._detachListeners = null;
+		this._flushTimer = null;
+		this._events = [];
+		this._approxBytes = 0;
+		this._lastUrl = null;
+		this._originalPushState = null;
+		this._originalReplaceState = null;
+		this._onPopState = () => {
+			this._capturePageView("pop");
+		};
+		this._onClickCapture = (event) => {
+			const target = event.target;
+			if (!(target instanceof Element)) return;
+			this._pushEvent({
+				event_type: "$click",
+				event_at_ms: Date.now(),
+				data: {
+					tag_name: target.tagName.toLowerCase(),
+					text: target.textContent.trim().substring(0, 200),
+					href: this._findNearestAnchorHref(target),
+					selector: this._buildSelector(target),
+					x: event.clientX,
+					y: event.clientY,
+					page_x: event.pageX,
+					page_y: event.pageY,
+					viewport_width: window.innerWidth,
+					viewport_height: window.innerHeight
+				}
+			});
+		};
+		this._onPageHide = () => {
+			runAsynchronously(() => this._flush({ keepalive: true }));
+		};
+		this._deps = deps;
+		this._sessionReplaySegmentId = generateUuid();
+	}
+	start() {
+		if (this._started) return;
+		if (!isBrowserLike()) return;
+		if (typeof window.addEventListener !== "function" || typeof window.removeEventListener !== "function" || typeof document.addEventListener !== "function" || typeof document.removeEventListener !== "function" || !hasScreenDimensions(window.screen)) return;
+		this._started = true;
+		this._setupPageViewCapture();
+		this._setupClickCapture();
+		this._setupPageHideListeners();
+		this._flushTimer = setInterval(() => this._tick(), FLUSH_INTERVAL_MS);
+	}
+	stop() {
+		this._cancelled = true;
+		if (this._flushTimer !== null) {
+			clearInterval(this._flushTimer);
+			this._flushTimer = null;
+		}
+		runAsynchronously(() => this._flush({ keepalive: true }));
+		this._teardown();
+	}
+	clearBuffer() {
+		this._events = [];
+		this._approxBytes = 0;
+	}
+	_pushEvent(event) {
+		this._events.push(event);
+		this._approxBytes += JSON.stringify(event).length;
+		if (this._events.length >= MAX_EVENTS_PER_BATCH || this._approxBytes >= MAX_APPROX_BYTES_PER_BATCH) runAsynchronously(() => this._flush({ keepalive: false }));
+	}
+	_capturePageView(entryType) {
+		const screenObject = window.screen;
+		if (!hasScreenDimensions(screenObject)) return;
+		const url = window.location.href;
+		if (url === this._lastUrl && entryType !== "initial") return;
+		this._lastUrl = url;
+		this._pushEvent({
+			event_type: "$page-view",
+			event_at_ms: Date.now(),
+			data: {
+				url,
+				path: window.location.pathname,
+				referrer: document.referrer,
+				title: document.title,
+				entry_type: entryType,
+				viewport_width: window.innerWidth,
+				viewport_height: window.innerHeight,
+				screen_width: screenObject.width,
+				screen_height: screenObject.height
+			}
+		});
+	}
+	_setupPageViewCapture() {
+		this._capturePageView("initial");
+		const historyObject = window.history;
+		if (!hasHistoryMethods(historyObject)) return;
+		const originalPushState = historyObject.pushState;
+		const originalReplaceState = historyObject.replaceState;
+		this._originalPushState = (...args) => originalPushState.apply(historyObject, args);
+		historyObject.pushState = (...args) => {
+			this._originalPushState(...args);
+			this._capturePageView("push");
+		};
+		this._originalReplaceState = (...args) => originalReplaceState.apply(historyObject, args);
+		historyObject.replaceState = (...args) => {
+			this._originalReplaceState(...args);
+			this._capturePageView("replace");
+		};
+		window.addEventListener("popstate", this._onPopState);
+	}
+	_buildSelector(element) {
+		const parts = [];
+		let current = element;
+		let depth = 0;
+		while (current && depth < 5) {
+			let part = current.tagName.toLowerCase();
+			if (current.id) {
+				part += `#${current.id}`;
+				parts.unshift(part);
+				break;
+			}
+			if (current.className && typeof current.className === "string") {
+				const classes = current.className.trim().split(/\s+/).filter(Boolean);
+				if (classes.length > 0) part += `.${classes.join(".")}`;
+			}
+			parts.unshift(part);
+			current = current.parentElement;
+			depth++;
+		}
+		return parts.join(" > ");
+	}
+	_findNearestAnchorHref(element) {
+		let current = element;
+		while (current) {
+			if (current.tagName === "A" && current.hasAttribute("href")) return current.getAttribute("href");
+			current = current.parentElement;
+		}
+		return null;
+	}
+	_setupClickCapture() {
+		document.addEventListener("click", this._onClickCapture, { capture: true });
+	}
+	_setupPageHideListeners() {
+		window.addEventListener("pagehide", this._onPageHide);
+		document.addEventListener("visibilitychange", this._onPageHide);
+		this._detachListeners = () => {
+			window.removeEventListener("pagehide", this._onPageHide);
+			document.removeEventListener("visibilitychange", this._onPageHide);
+		};
+	}
+	_teardown() {
+		if (this._detachListeners) {
+			this._detachListeners();
+			this._detachListeners = null;
+		}
+		const historyObject = window.history;
+		if (hasHistoryMethods(historyObject)) {
+			if (this._originalPushState) historyObject.pushState = this._originalPushState;
+			if (this._originalReplaceState) historyObject.replaceState = this._originalReplaceState;
+		}
+		this._originalPushState = null;
+		this._originalReplaceState = null;
+		window.removeEventListener("popstate", this._onPopState);
+		document.removeEventListener("click", this._onClickCapture, { capture: true });
+		this._events = [];
+		this._approxBytes = 0;
+	}
+	async _flush(options) {
+		if (this._events.length === 0) return;
+		const nowMs = Date.now();
+		const batchId = generateUuid();
+		const payload = {
+			session_replay_segment_id: this._sessionReplaySegmentId,
+			batch_id: batchId,
+			sent_at_ms: nowMs,
+			events: this._events
+		};
+		this._events = [];
+		this._approxBytes = 0;
+		const res = await this._deps.sendBatch(JSON.stringify(payload), { keepalive: options.keepalive });
+		if (res.status === "error") {
+			console.warn("EventTracker flush failed:", res.error);
+			return;
+		}
+		if (!res.data.ok) console.warn("EventTracker flush failed:", res.data.status, await res.data.text());
+	}
+	_tick() {
+		if (this._cancelled) return;
+		if (this._events.length > 0) runAsynchronously(() => this._flush({ keepalive: false }));
+	}
+};
+
+//#endregion
+export { EventTracker };
+//# sourceMappingURL=event-tracker.js.map

package/dist/esm/lib/stack-app/apps/implementations/event-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-tracker.js","names":[],"sources":["../../../../../../src/lib/stack-app/apps/implementations/event-tracker.ts"],"sourcesContent":["\n//===========================================\n// THIS FILE IS AUTO-GENERATED FROM TEMPLATE. DO NOT EDIT IT DIRECTLY, INSTEAD EDIT THE CORRESPONDING FILE IN packages/template\n//===========================================\nimport { isBrowserLike } from \"@stackframe/stack-shared/dist/utils/env\";\nimport { runAsynchronously } from \"@stackframe/stack-shared/dist/utils/promises\";\nimport { Result } from \"@stackframe/stack-shared/dist/utils/results\";\nimport { generateUuid } from \"./session-replay\";\n\nconst FLUSH_INTERVAL_MS = 10_000;\nconst MAX_EVENTS_PER_BATCH = 50;\nconst MAX_APPROX_BYTES_PER_BATCH = 64_000;\n\nfunction hasScreenDimensions(value: unknown): value is { width: number, height: number } {\n  if (value == null || typeof value !== \"object\") {\n    return false;\n  }\n  if (!(\"width\" in value) || !(\"height\" in value)) {\n    return false;\n  }\n  return typeof value.width === \"number\" && typeof value.height === \"number\";\n}\n\nfunction hasHistoryMethods(value: unknown): value is { pushState: History[\"pushState\"], replaceState: History[\"replaceState\"] } {\n  if (value == null || typeof value !== \"object\") {\n    return false;\n  }\n  if (!(\"pushState\" in value) || !(\"replaceState\" in value)) {\n    return false;\n  }\n  return typeof value.pushState === \"function\" && typeof value.replaceState === \"function\";\n}\n\nexport type EventTrackerDeps = {\n  projectId: string,\n  sendBatch: (body: string, options: { keepalive: boolean }) => Promise<Result<Response, Error>>,\n};\n\ntype TrackedEvent = {\n  event_type: \"$page-view\" | \"$click\",\n  event_at_ms: number,\n  data: Record<string, unknown>,\n};\n\nexport class EventTracker {\n  private _started = false;\n  private _cancelled = false;\n  private _detachListeners: (() => void) | null = null;\n  private _flushTimer: ReturnType<typeof setInterval> | null = null;\n  private _events: TrackedEvent[] = [];\n  private _approxBytes = 0;\n  private _lastUrl: string | null = null;\n  private readonly _sessionReplaySegmentId: string;\n  private readonly _deps: EventTrackerDeps;\n\n  private _originalPushState: History[\"pushState\"] | null = null;\n  private _originalReplaceState: History[\"replaceState\"] | null = null;\n\n  constructor(deps: EventTrackerDeps) {\n    this._deps = deps;\n    this._sessionReplaySegmentId = generateUuid();\n  }\n\n  start() {\n    if (this._started) return;\n    if (!isBrowserLike()) return;\n    if (\n      typeof window.addEventListener !== \"function\"\n      || typeof window.removeEventListener !== \"function\"\n      || typeof document.addEventListener !== \"function\"\n      || typeof document.removeEventListener !== \"function\"\n      || !hasScreenDimensions(window.screen)\n    ) {\n      return;\n    }\n    this._started = true;\n\n    this._setupPageViewCapture();\n    this._setupClickCapture();\n    this._setupPageHideListeners();\n\n    this._flushTimer = setInterval(() => this._tick(), FLUSH_INTERVAL_MS);\n  }\n\n  stop() {\n    this._cancelled = true;\n    if (this._flushTimer !== null) {\n      clearInterval(this._flushTimer);\n      this._flushTimer = null;\n    }\n    runAsynchronously(() => this._flush({ keepalive: true }));\n    this._teardown();\n  }\n\n  clearBuffer() {\n    this._events = [];\n    this._approxBytes = 0;\n  }\n\n  private _pushEvent(event: TrackedEvent) {\n    this._events.push(event);\n    this._approxBytes += JSON.stringify(event).length;\n    if (this._events.length >= MAX_EVENTS_PER_BATCH || this._approxBytes >= MAX_APPROX_BYTES_PER_BATCH) {\n      runAsynchronously(() => this._flush({ keepalive: false }));\n    }\n  }\n\n  private _capturePageView(entryType: \"initial\" | \"push\" | \"replace\" | \"pop\") {\n    const screenObject = window.screen;\n    if (!hasScreenDimensions(screenObject)) {\n      return;\n    }\n\n    const url = window.location.href;\n    if (url === this._lastUrl && entryType !== \"initial\") return;\n    this._lastUrl = url;\n\n    this._pushEvent({\n      event_type: \"$page-view\",\n      event_at_ms: Date.now(),\n      data: {\n        url,\n        path: window.location.pathname,\n        referrer: document.referrer,\n        title: document.title,\n        entry_type: entryType,\n        viewport_width: window.innerWidth,\n        viewport_height: window.innerHeight,\n        screen_width: screenObject.width,\n        screen_height: screenObject.height,\n      },\n    });\n  }\n\n  private _setupPageViewCapture() {\n    // Fire initial page-view\n    this._capturePageView(\"initial\");\n    const historyObject = window.history;\n    if (!hasHistoryMethods(historyObject)) {\n      return;\n    }\n    const originalPushState = historyObject.pushState;\n    const originalReplaceState = historyObject.replaceState;\n\n    // Monkey-patch history.pushState\n    this._originalPushState = (...args: Parameters<History[\"pushState\"]>) => originalPushState.apply(historyObject, args);\n    historyObject.pushState = (...args: Parameters<History[\"pushState\"]>) => {\n      this._originalPushState!(...args);\n      this._capturePageView(\"push\");\n    };\n\n    // Monkey-patch history.replaceState\n    this._originalReplaceState = (...args: Parameters<History[\"replaceState\"]>) => originalReplaceState.apply(historyObject, args);\n    historyObject.replaceState = (...args: Parameters<History[\"replaceState\"]>) => {\n      this._originalReplaceState!(...args);\n      this._capturePageView(\"replace\");\n    };\n\n    // Listen for popstate (back/forward navigation)\n    window.addEventListener(\"popstate\", this._onPopState);\n  }\n\n  private readonly _onPopState = () => {\n    this._capturePageView(\"pop\");\n  };\n\n  private _buildSelector(element: Element): string {\n    const parts: string[] = [];\n    let current: Element | null = element;\n    let depth = 0;\n\n    while (current && depth < 5) {\n      let part = current.tagName.toLowerCase();\n      if (current.id) {\n        part += `#${current.id}`;\n        parts.unshift(part);\n        break;\n      }\n      if (current.className && typeof current.className === \"string\") {\n        const classes = current.className.trim().split(/\\s+/).filter(Boolean);\n        if (classes.length > 0) {\n          part += `.${classes.join(\".\")}`;\n        }\n      }\n      parts.unshift(part);\n      current = current.parentElement;\n      depth++;\n    }\n\n    return parts.join(\" > \");\n  }\n\n  private _findNearestAnchorHref(element: Element): string | null {\n    let current: Element | null = element;\n    while (current) {\n      if (current.tagName === \"A\" && current.hasAttribute(\"href\")) {\n        return current.getAttribute(\"href\");\n      }\n      current = current.parentElement;\n    }\n    return null;\n  }\n\n  private readonly _onClickCapture = (event: MouseEvent) => {\n    const target = event.target;\n    if (!(target instanceof Element)) return;\n\n    this._pushEvent({\n      event_type: \"$click\",\n      event_at_ms: Date.now(),\n      data: {\n        tag_name: target.tagName.toLowerCase(),\n        text: target.textContent.trim().substring(0, 200),\n        href: this._findNearestAnchorHref(target),\n        selector: this._buildSelector(target),\n        x: event.clientX,\n        y: event.clientY,\n        page_x: event.pageX,\n        page_y: event.pageY,\n        viewport_width: window.innerWidth,\n        viewport_height: window.innerHeight,\n      },\n    });\n  };\n\n  private _setupClickCapture() {\n    document.addEventListener(\"click\", this._onClickCapture, { capture: true });\n  }\n\n  private readonly _onPageHide = () => {\n    runAsynchronously(() => this._flush({ keepalive: true }));\n  };\n\n  private _setupPageHideListeners() {\n    window.addEventListener(\"pagehide\", this._onPageHide);\n    document.addEventListener(\"visibilitychange\", this._onPageHide);\n    this._detachListeners = () => {\n      window.removeEventListener(\"pagehide\", this._onPageHide);\n      document.removeEventListener(\"visibilitychange\", this._onPageHide);\n    };\n  }\n\n  private _teardown() {\n    if (this._detachListeners) {\n      this._detachListeners();\n      this._detachListeners = null;\n    }\n\n    // Restore history methods\n    const historyObject = window.history;\n    if (hasHistoryMethods(historyObject)) {\n      if (this._originalPushState) {\n        historyObject.pushState = this._originalPushState;\n      }\n      if (this._originalReplaceState) {\n        historyObject.replaceState = this._originalReplaceState;\n      }\n    }\n    this._originalPushState = null;\n    this._originalReplaceState = null;\n\n    window.removeEventListener(\"popstate\", this._onPopState);\n    document.removeEventListener(\"click\", this._onClickCapture, { capture: true });\n\n    this._events = [];\n    this._approxBytes = 0;\n  }\n\n  private async _flush(options: { keepalive: boolean }) {\n    if (this._events.length === 0) return;\n\n    const nowMs = Date.now();\n\n    const batchId = generateUuid();\n    const payload = {\n      session_replay_segment_id: this._sessionReplaySegmentId,\n      batch_id: batchId,\n      sent_at_ms: nowMs,\n      events: this._events,\n    };\n\n    this._events = [];\n    this._approxBytes = 0;\n\n    const res = await this._deps.sendBatch(\n      JSON.stringify(payload),\n      { keepalive: options.keepalive },\n    );\n\n    if (res.status === \"error\") {\n      console.warn(\"EventTracker flush failed:\", res.error);\n      return;\n    }\n\n    if (!res.data.ok) {\n      console.warn(\"EventTracker flush failed:\", res.data.status, await res.data.text());\n    }\n  }\n\n  private _tick() {\n    if (this._cancelled) return;\n    if (this._events.length > 0) {\n      runAsynchronously(() => this._flush({ keepalive: false }));\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/esm/lib/stack-app/apps/implementations/event-tracker.test.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/esm/lib/stack-app/apps/implementations/event-tracker.test.js

@@ -0,0 +1,87 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { Result } from "@stackframe/stack-shared/dist/utils/results";
+import { EventTracker } from "./event-tracker.js";
+
+//#region src/lib/stack-app/apps/implementations/event-tracker.test.ts
+// @vitest-environment jsdom
+async function advancePastFlush() {
+	await vi.advanceTimersByTimeAsync(1e4);
+	await Promise.resolve();
+}
+function getSentEventTypes(sentBodies) {
+	const [body] = sentBodies;
+	const payload = JSON.parse(body);
+	if (typeof payload !== "object" || payload === null || !("events" in payload) || !Array.isArray(payload.events)) throw new Error("Expected analytics batch payload to include an events array.");
+	return payload.events.map((event) => event.event_type);
+}
+describe("EventTracker", () => {
+	afterEach(() => {
+		vi.useRealTimers();
+	});
+	it("captures events when browser globals are exposed as accessor descriptors", async () => {
+		vi.useFakeTimers();
+		document.body.innerHTML = "<button>Open project</button>";
+		const screenDescriptor = Object.getOwnPropertyDescriptor(window, "screen");
+		const historyDescriptor = Object.getOwnPropertyDescriptor(window, "history");
+		expect(screenDescriptor?.value).toBeUndefined();
+		expect(historyDescriptor?.value).toBeUndefined();
+		expect(screenDescriptor?.get).toBeTypeOf("function");
+		expect(historyDescriptor?.get).toBeTypeOf("function");
+		const sentBodies = [];
+		const tracker = new EventTracker({
+			projectId: "internal",
+			sendBatch: async (body) => {
+				sentBodies.push(body);
+				return Result.ok(new Response());
+			}
+		});
+		try {
+			tracker.start();
+			document.querySelector("button")?.dispatchEvent(new MouseEvent("click", {
+				bubbles: true,
+				clientX: 12,
+				clientY: 34
+			}));
+			await advancePastFlush();
+			expect(getSentEventTypes(sentBodies)).toMatchInlineSnapshot(`
+        [
+          "$page-view",
+          "$click",
+        ]
+      `);
+		} finally {
+			tracker.stop();
+		}
+	});
+	it("captures client-side navigations when history is exposed as an accessor descriptor", async () => {
+		vi.useFakeTimers();
+		const historyDescriptor = Object.getOwnPropertyDescriptor(window, "history");
+		expect(historyDescriptor?.value).toBeUndefined();
+		expect(historyDescriptor?.get).toBeTypeOf("function");
+		const sentBodies = [];
+		const tracker = new EventTracker({
+			projectId: "internal",
+			sendBatch: async (body) => {
+				sentBodies.push(body);
+				return Result.ok(new Response());
+			}
+		});
+		try {
+			tracker.start();
+			window.history.pushState({}, "", "/projects/test-project");
+			await advancePastFlush();
+			expect(getSentEventTypes(sentBodies)).toMatchInlineSnapshot(`
+        [
+          "$page-view",
+          "$page-view",
+        ]
+      `);
+		} finally {
+			tracker.stop();
+		}
+	});
+});
+
+//#endregion
+export {  };
+//# sourceMappingURL=event-tracker.test.js.map