@absolutejs/absolute 0.20.0-beta.65 → 0.20.0-beta.67

package/dist/cli/index.js

@@ -818,6 +818,30 @@ var APP_ID_PATTERN, SCHEME_PATTERN, APPLE_APP_ID_PREFIX_PATTERN, CERTIFICATE_FIN
     throw new TypeError("mobile.ios.version must contain one to three dot-separated integer components, for example 1.4.0.");
   }
   return normalized;
+}, normalizeObservability = (config, productionOrigin) => {
+  if (!config.observability)
+    return;
+  const project = requireText(config.observability.project, "mobile.observability.project");
+  if (project.length > 255)
+    throw new TypeError("mobile.observability.project must not exceed 255 characters.");
+  const environment = config.observability.environment?.trim();
+  if (environment !== undefined && (!environment || environment.length > 64))
+    throw new TypeError("mobile.observability.environment must contain 1 through 64 characters.");
+  const sampleRate = config.observability.sampleRate ?? 1;
+  if (!Number.isFinite(sampleRate) || sampleRate < 0 || sampleRate > 1)
+    throw new TypeError("mobile.observability.sampleRate must be between 0 and 1.");
+  const route = config.observability.route ?? "/api/observability/errors";
+  if (!route.startsWith("/") || route.startsWith("//"))
+    throw new TypeError("mobile.observability.route must be a root-relative trusted-server path.");
+  const endpoint = new URL(route, `${productionOrigin}/`);
+  if (endpoint.origin !== productionOrigin || endpoint.username || endpoint.password || endpoint.hash || endpoint.search)
+    throw new TypeError("mobile.observability.route must remain on productionOrigin and cannot contain credentials, a query, or a fragment.");
+  return {
+    endpoint: endpoint.href,
+    ...environment ? { environment } : {},
+    project,
+    sampleRate
+  };
 }, normalizeCertificateFingerprints = (values) => [
   ...new Set((values ?? []).map((value) => requireText(value, "mobile.deepLinks.android.sha256CertificateFingerprints").replaceAll(":", "").toUpperCase()).map((value) => {
     if (!CERTIFICATE_FINGERPRINT_PATTERN.test(value)) {
@@ -972,6 +996,7 @@ var APP_ID_PATTERN, SCHEME_PATTERN, APPLE_APP_ID_PREFIX_PATTERN, CERTIFICATE_FIN
     throw new TypeError("mobile.deepLinks.scheme is not a valid URL scheme.");
   }
   const updates = normalizeUpdates(config, productionOrigin, projectRoot);
+  const observability = normalizeObservability(config, productionOrigin);
   return {
     androidCertificateFingerprints: normalizeCertificateFingerprints(config.deepLinks?.android?.sha256CertificateFingerprints),
     appId,
@@ -986,6 +1011,7 @@ var APP_ID_PATTERN, SCHEME_PATTERN, APPLE_APP_ID_PREFIX_PATTERN, CERTIFICATE_FIN
     ...config.engine === "expo" ? { expoSdkVersion: config.expo?.sdkVersion ?? 57 } : {},
     iosVersion: normalizeIosVersion(config.ios?.version),
     nativeProjectDirectory: resolveProjectPath(projectRoot, config.nativeProject?.directory ?? (config.engine === "expo" ? ".absolutejs/mobile/expo" : "mobile"), "mobile.nativeProject.directory"),
+    ...observability ? { observability } : {},
     platforms: normalizePlatforms(config.platforms),
     productionOrigin,
     pushAndroidGoogleServicesFile: resolveProjectPath(projectRoot, config.pushNotifications?.android?.googleServicesFile ?? "google-services.json", "mobile.pushNotifications.android.googleServicesFile"),
@@ -1969,6 +1995,14 @@ var EXPO_GENERATED_HEADER = `// Generated by AbsoluteJS. Edit absolute.config.ts
   });
   return {
     appBuild: requireManifestString(value.appBuild, "appBuild"),
+    ...isRecord(value.observability) && typeof value.observability.endpoint === "string" && typeof value.observability.project === "string" && typeof value.observability.sampleRate === "number" ? {
+      observability: {
+        endpoint: value.observability.endpoint,
+        ...typeof value.observability.environment === "string" ? { environment: value.observability.environment } : {},
+        project: value.observability.project,
+        sampleRate: value.observability.sampleRate
+      }
+    } : {},
     pages,
     productionOrigin: requireManifestString(value.productionOrigin, "productionOrigin"),
     routes,
@@ -2740,7 +2774,7 @@ export function AbsoluteWebHost() {
 
 const styles = StyleSheet.create({ loading: { alignItems: 'center', flex: 1, justifyContent: 'center' }, web: { flex: 1 } });
 `;
-}, webRouteSource, catchAllRouteSource, nativeRouteRuntimeSource = (auth) => `${EXPO_GENERATED_HEADER}import { useLocalSearchParams, usePathname } from 'expo-router';
+}, webRouteSource, catchAllRouteSource, nativeRouteRuntimeSource = (auth) => `${EXPO_GENERATED_HEADER}import { type ErrorBoundaryProps, useLocalSearchParams, usePathname } from 'expo-router';
 import { type ComponentType, useEffect, useMemo, useState } from 'react';
 import { ActivityIndicator, Platform, Pressable, StyleSheet, Text, View } from 'react-native';
 import { ABSOLUTE_MOBILE_MANIFEST } from './webAssets';
@@ -2767,6 +2801,47 @@ type NativeRouteState<PageProps> =
 
 const isRecord = (value: unknown): value is Record<string, unknown> =>
 	typeof value === 'object' && value !== null && !Array.isArray(value);
+const redactErrorText = (value: string) => value
+	.replace(/\\b(Bearer)\\s+[A-Za-z0-9._~+/-]+=*/gi, '$1 [REDACTED]')
+	.replace(/([?&](?:access_token|api_?key|authorization|code|id_token|password|refresh_token|secret|token)=)[^&#\\s]*/gi, '$1[REDACTED]')
+	.replace(/\\b((?:access_?token|api_?key|authorization|client_?secret|cookie|id_?token|password|passwd|refresh_?token|secret|token)\\s*[:=]\\s*)[^,\\s;]+/gi, '$1[REDACTED]')
+	.replace(/\\beyJ[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+\\b/g, '[REDACTED]');
+const captureNativeException = (value: unknown, context: { bundle?: string | undefined; contract?: string | undefined; pageId?: string | undefined; phase: string; route: string }) => {
+	const manifest = ABSOLUTE_MOBILE_MANIFEST;
+	const config = manifest?.observability;
+	if (!manifest || !config || config.sampleRate === 0 || config.sampleRate < 1 && Math.random() >= config.sampleRate) return;
+	const error = value instanceof Error ? value : new Error(String(value));
+	const event = {
+		level: 'error',
+		message: redactErrorText(error.message),
+		name: error.name,
+		...(error.stack ? { stack: redactErrorText(error.stack) } : {}),
+		tags: {
+			absoluteMobile: 'true',
+			mobileAppBuild: manifest.appBuild,
+			mobileEngine: 'expo',
+			mobileFailurePhase: context.phase,
+			mobileManifestFormat: '1',
+			mobilePlatform: Platform.OS,
+			mobileRoute: context.route,
+			mobileRuntime: manifest.runtime,
+			...(context.bundle ? { mobilePageBundle: context.bundle } : {}),
+			...(context.contract ? { mobilePageContract: context.contract } : {}),
+			...(context.pageId ? { mobilePageId: context.pageId } : {})
+		}
+	};
+	void fetch(config.endpoint, {
+		body: JSON.stringify({
+			...(config.environment ? { environment: config.environment } : {}),
+			events: [event],
+			project: config.project,
+			release: manifest.appBuild,
+			v: 1
+		}),
+		headers: { 'content-type': 'application/json' },
+		method: 'POST'
+	}).catch(() => undefined);
+};
 const routeSegmentPattern = (segment: string) => {
 	if (segment === '*') return '.*';
 	if (segment.startsWith(':') && segment.endsWith('?')) return '[^/]*';
@@ -2794,6 +2869,17 @@ const productionPage = (pathname: string) => {
 	if (!page) throw new Error('The embedded AbsoluteJS page contract is incomplete.');
 	return page;
 };
+export const createAbsoluteNativeRouteErrorBoundary = (pattern: string) => {
+	return function AbsoluteNativeRouteErrorBoundary({ error, retry }: ErrorBoundaryProps) {
+		const pathname = usePathname() || '/';
+		useEffect(() => {
+			let page: ReturnType<typeof productionPage> | undefined;
+			try { if (ABSOLUTE_MOBILE_MANIFEST) page = productionPage(pathname); } catch {}
+			captureNativeException(error, { bundle: page?.bundleHash, contract: page?.contract, pageId: page?.pageId, phase: 'native-route-render', route: pattern });
+		}, [error, pathname]);
+		return <View style={styles.center}><Text accessibilityRole="alert" style={styles.error}>This screen stopped unexpectedly.</Text><Pressable accessibilityRole="button" onPress={() => { void retry(); }} style={styles.button}><Text>Try again</Text></Pressable></View>;
+	};
+};
 const createDataRequest = (path: string) => {
 	const development = typeof DEV_ORIGIN === 'string' && DEV_ORIGIN.length > 0;
 	const origin = development ? DEV_ORIGIN : ABSOLUTE_MOBILE_MANIFEST?.productionOrigin;
@@ -2846,7 +2932,14 @@ export const createAbsoluteNativeRoute = <
 			setState({ kind: 'loading' });
 			void requestData<PageProps>(requestPath, controller.signal).then(
 				pageProps => { if (!controller.signal.aborted) setState({ kind: 'ready', pageProps }); },
-				() => { if (!controller.signal.aborted) setState({ kind: 'error' }); }
+				error => {
+					if (!controller.signal.aborted) {
+						let page: ReturnType<typeof productionPage> | undefined;
+						try { if (ABSOLUTE_MOBILE_MANIFEST) page = productionPage(pathname); } catch {}
+						captureNativeException(error, { bundle: page?.bundleHash, contract: page?.contract, pageId: page?.pageId, phase: 'native-route-load', route: pattern });
+						setState({ kind: 'error' });
+					}
+				}
 			);
 			return () => controller.abort();
 		}, [requestPath, revision]);
@@ -2864,8 +2957,9 @@ const styles = StyleSheet.create({
 	error: { color: '#b91c1c', fontSize: 16, textAlign: 'center' }
 });
 `, nativeWrapperSource = (wrapper, module, runtime, route) => `${EXPO_GENERATED_HEADER}import ApplicationNativeRoute from ${JSON.stringify(portableRelative(dirname4(wrapper), module).replace(/\.(?:[cm]?[jt]sx?)$/u, ""))};
-import { createAbsoluteNativeRoute } from ${JSON.stringify(portableRelative(dirname4(wrapper), runtime).replace(/\.(?:[cm]?[jt]sx?)$/u, ""))};
+import { createAbsoluteNativeRoute, createAbsoluteNativeRouteErrorBoundary } from ${JSON.stringify(portableRelative(dirname4(wrapper), runtime).replace(/\.(?:[cm]?[jt]sx?)$/u, ""))};
 
+export const ErrorBoundary = createAbsoluteNativeRouteErrorBoundary(${JSON.stringify(route)});
 export default createAbsoluteNativeRoute(ApplicationNativeRoute, ${JSON.stringify(route)});
 `, expoTsConfig = (projectRoot, project, auth, sync) => ({
   compilerOptions: {
@@ -2930,6 +3024,7 @@ export default createAbsoluteNativeRoute(ApplicationNativeRoute, ${JSON.stringif
 }, jsonSource = (value) => `${JSON.stringify(value, null, "\t")}
 `, nativeDataManifestTypeSource = `type AbsoluteMobileManifest = {
 	appBuild: string;
+	observability?: { endpoint: string; environment?: string; project: string; sampleRate: number };
 	pages: readonly { bundleHash: string; contract: string; pageId: string }[];
 	productionOrigin: string;
 	routes: readonly { method: 'GET'; pageId: string; pattern: string }[];
@@ -9496,7 +9591,9 @@ const absoluteMobilePushCapability = absoluteDeviceCapability${pushIndex}(absolu
   const baseAdapterModule = capacitor ? await resolveProjectImport(projectRoot, "@absolutejs/devices-capacitor") : shellExpoDevicesModule();
   const adapterImport = capacitor ? `import { installCapacitorDeviceAdapterIfNative } from ${JSON.stringify(baseAdapterModule)};` : `import { createAbsoluteExpoBridgeFetch, installAbsoluteExpoWebDeviceAdapter } from ${JSON.stringify(baseAdapterModule)};`;
   const adapterInstall = capacitor ? `installCapacitorDeviceAdapterIfNative({ storagePrefix: ${JSON.stringify(storagePrefix)}${capabilityOptions ? `, ${capabilityOptions}` : ""} });` : `installAbsoluteExpoWebDeviceAdapter(${JSON.stringify(deviceCapabilities.capabilities)});`;
-  const shellOptionProperties = [];
+  const shellOptionProperties = [
+    `engine: ${JSON.stringify(engine)}`
+  ];
   if (push) {
     shellOptionProperties.push("createAuth: (config, options) => createAbsoluteMobileShellAuth(config, options)", "beforeSignOut: absoluteMobilePush.beforeSignOut", "connectPush: (auth) => absoluteMobilePush.connect(auth, absoluteMobilePushCapability)");
   } else if (auth)
@@ -9516,6 +9613,7 @@ void startAbsoluteMobileShell(${shellOptions});
 `);
   const build = await Bun.build({
     entrypoints: [entryPath],
+    external: ["web-vitals", "web-vitals/*"],
     minify: true,
     outdir: staging,
     target: "browser"
@@ -9575,6 +9673,40 @@ void startAbsoluteMobileShell(${shellOptions});
     localBundlePath,
     ...localStylePath ? { localStylePath } : {}
   };
+}, materializeAbsoluteMobileSourcemaps = async (pages, appBuild, projectRoot) => {
+  const safeLeaf = (value, field) => {
+    if (value === "." || value === ".." || !/^[A-Za-z0-9._-]+$/u.test(value))
+      throw new TypeError(`${field} is not a safe source-map key.`);
+    return value;
+  };
+  const release = safeLeaf(appBuild, "Mobile app build");
+  const privateRoot = join21(projectRoot, "sourcemaps");
+  const releaseRoot = join21(privateRoot, "mobile", release);
+  const copied = [];
+  const available = pages.flatMap((page) => {
+    const source = join21(privateRoot, `${basename8(page.bundlePath)}.map`);
+    return existsSync10(source) ? [{ page, source }] : [];
+  });
+  if (available.length > 0)
+    await mkdir9(releaseRoot, { recursive: true });
+  await Promise.all(available.map(async ({ page, source }) => {
+    const extension = extname5(page.bundlePath) || ".js";
+    if (!/^\.[a-z0-9]+$/iu.test(extension))
+      throw new TypeError("Mobile page extension is not a safe source-map key.");
+    const bundleHash = safeLeaf(page.bundleHash, "Mobile page bundle hash");
+    const file = `${bundleHash}${extension}.map`;
+    await copyFile4(source, join21(releaseRoot, file));
+    copied.push({ bundleHash, file, pageId: page.pageId });
+  }));
+  if (copied.length > 0) {
+    await writeFile8(join21(releaseRoot, "manifest.json"), `${JSON.stringify({
+      appBuild,
+      format: 1,
+      pages: copied.sort((left, right) => left.pageId.localeCompare(right.pageId))
+    }, null, "\t")}
+`);
+  }
+  return copied.length;
 }, absoluteClientImports = async (sourcePath, buildDirectory) => {
   const source = await readFile10(sourcePath, "utf8");
   const extension = extname5(sourcePath).toLowerCase();
@@ -9650,6 +9782,7 @@ void startAbsoluteMobileShell(${shellOptions});
       productionOrigin: options.config.productionOrigin,
       routes: options.artifact.routes,
       runtime: options.artifact.runtime,
+      ...options.config.observability ? { observability: options.config.observability } : {},
       ...options.config.updates ? { updates: options.config.updates } : {},
       ...options.sync ? {
         sync: {
@@ -9673,6 +9806,7 @@ void startAbsoluteMobileShell(${shellOptions});
       buildShellBootstrap(staging, options.auth !== undefined, options.auth !== undefined && options.sync === true, `absolutejs.${options.auth?.clientId ?? options.config.appId}.`, options.config.engine, options.config.engine === "capacitor" && options.config.updates !== undefined, options.deviceCapabilities, options.projectRoot)
     ]);
     await installBundle(staging, destination);
+    await materializeAbsoluteMobileSourcemaps(options.artifact.pages, options.artifact.appBuild, options.projectRoot);
     return manifest;
   } catch (error) {
     await rm7(staging, { force: true, recursive: true });
@@ -22660,7 +22794,16 @@ var ABSOLUTE_MOBILE_INSPECTION_FORMAT = 1, MOBILE_PACKAGE_NAMES, isObject3 = (va
       iosVersion: config.iosVersion,
       nativeProjectDirectory: portablePath2(projectRoot, config.nativeProjectDirectory),
       platforms: config.platforms,
-      productionOrigin: config.productionOrigin
+      productionOrigin: config.productionOrigin,
+      ...config.observability ? {
+        observability: {
+          enabled: true,
+          endpoint: config.observability.endpoint,
+          environment: config.observability.environment,
+          project: config.observability.project,
+          sampleRate: config.observability.sampleRate
+        }
+      } : {}
     },
     format: ABSOLUTE_MOBILE_INSPECTION_FORMAT,
     nativeProjects: await Promise.all(config.platforms.map(async (platform6) => {