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

package/dist/mobile/shellBootstrap.js

@@ -6710,6 +6710,141 @@ var installAbsoluteMobileShellObservability = (manifest, engine, fetch2 = global
   };
 };
 
+// src/mobile/shellNativeObservability.ts
+import { Capacitor, registerPlugin } from "@capacitor/core";
+var MAX_REPORTS = 8;
+var MAX_DETAIL_BYTES = 64 * 1024;
+var MAX_STRING_LENGTH = 8 * 1024;
+var MAX_REDACTION_DEPTH = 8;
+var REPORT_ID = /^[A-Za-z0-9._:-]{1,128}$/u;
+var REPORT_KINDS = new Set([
+  "anr",
+  "app-launch",
+  "cpu-exception",
+  "crash",
+  "disk-write-exception",
+  "hang",
+  "initialization-failure",
+  "low-memory",
+  "native-crash",
+  "resource-exhaustion",
+  "signal"
+]);
+var nativeObservability = registerPlugin("AbsoluteMobileObservability");
+var isRecord3 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var redactText = (value) => value.slice(0, MAX_STRING_LENGTH).replace(/\b(Bearer)\s+[A-Za-z0-9._~+/-]+=*/giu, "$1 [REDACTED]").replace(/([?&](?:access_token|api_?key|authorization|code|id_token|password|refresh_token|secret|token)=)[^&#\s]*/giu, "$1[REDACTED]").replace(/\b((?:access_?token|api_?key|authorization|client_?secret|cookie|id_?token|password|passwd|refresh_?token|secret|token)\s*[:=]\s*)[^,\s;]+/giu, "$1[REDACTED]").replace(/\beyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\b/gu, "[REDACTED]");
+var redactValue2 = (value, depth = 0) => {
+  if (depth >= MAX_REDACTION_DEPTH)
+    return "[TRUNCATED]";
+  if (typeof value === "string")
+    return redactText(value);
+  if (value === null || typeof value === "number" || typeof value === "boolean")
+    return value;
+  if (Array.isArray(value))
+    return value.slice(0, 64).map((entry) => redactValue2(entry, depth + 1));
+  if (!isRecord3(value))
+    return String(value).slice(0, MAX_STRING_LENGTH);
+  return Object.fromEntries(Object.entries(value).slice(0, 128).map(([key, entry]) => [
+    key,
+    /(?:authorization|cookie|password|secret|token)/iu.test(key) ? "[REDACTED]" : redactValue2(entry, depth + 1)
+  ]));
+};
+var parseReport = (value) => {
+  if (!isRecord3(value) || !isRecord3(value.details))
+    return;
+  if (typeof value.id !== "string" || !REPORT_ID.test(value.id))
+    return;
+  if (typeof value.kind !== "string" || !REPORT_KINDS.has(value.kind))
+    return;
+  if (typeof value.occurredAt !== "number" || !Number.isFinite(value.occurredAt) || value.occurredAt <= 0)
+    return;
+  if (value.platform !== "android" && value.platform !== "ios")
+    return;
+  const details = redactValue2(value.details);
+  if (!isRecord3(details))
+    return;
+  if (new TextEncoder().encode(JSON.stringify(details)).byteLength > MAX_DETAIL_BYTES)
+    return;
+  return {
+    details,
+    id: value.id,
+    kind: value.kind,
+    occurredAt: value.occurredAt,
+    platform: value.platform
+  };
+};
+var sampled = (id, sampleRate) => {
+  if (sampleRate >= 1)
+    return true;
+  let hash = 2166136261;
+  for (const character of id) {
+    hash ^= character.codePointAt(0) ?? 0;
+    hash = Math.imul(hash, 16777619);
+  }
+  return (hash >>> 0) / 4294967296 < sampleRate;
+};
+var reportEvent = (report, manifest) => ({
+  at: report.occurredAt,
+  extra: {
+    nativeDiagnostic: report.details,
+    nativeDiagnosticId: report.id
+  },
+  groupingKey: `absolute-native:${report.platform}:${report.kind}`,
+  level: [
+    "app-launch",
+    "cpu-exception",
+    "disk-write-exception",
+    "low-memory",
+    "resource-exhaustion",
+    "signal"
+  ].includes(report.kind) ? "warning" : "error",
+  message: `Native process diagnostic — ${report.kind}`,
+  name: "AbsoluteMobileNativeDiagnostic",
+  tags: {
+    absoluteMobile: "true",
+    mobileAppBuild: manifest.appBuild,
+    mobileFailurePhase: "native-process",
+    mobileManifestFormat: String(manifest.format),
+    mobileNativeRuntime: manifest.nativeRuntime,
+    mobilePlatform: report.platform,
+    mobileRuntime: manifest.runtime
+  }
+});
+var drainAbsoluteMobileNativeObservability = async (manifest, fetch2, options = {}) => {
+  const config = manifest.observability;
+  if (!config || !(options.native ?? Capacitor.isNativePlatform()))
+    return 0;
+  const plugin = options.plugin ?? nativeObservability;
+  const pending = await plugin.pending();
+  const reports = pending.reports.slice(0, MAX_REPORTS).map(parseReport).filter((report) => report !== undefined);
+  const discarded = reports.filter((report) => !sampled(report.id, config.sampleRate));
+  if (discarded.length > 0)
+    await plugin.acknowledge({
+      ids: discarded.map(({ id }) => id)
+    });
+  const selected = reports.filter((report) => sampled(report.id, config.sampleRate));
+  if (selected.length === 0)
+    return 0;
+  const envelope = {
+    ...config.environment ? { environment: config.environment } : {},
+    events: selected.map((report) => reportEvent(report, manifest)),
+    project: config.project,
+    release: manifest.appBuild,
+    v: 1
+  };
+  const response = await fetch2(config.endpoint, {
+    body: JSON.stringify(envelope),
+    headers: { "content-type": "application/json" },
+    method: "POST"
+  });
+  if (!response.ok)
+    return 0;
+  await plugin.acknowledge({
+    ids: selected.map(({ id }) => id)
+  });
+  return selected.length;
+};
+
 // src/mobile/shellBootstrap.ts
 var MANIFEST_PATH = "./absolute-mobile-manifest.json";
 var STATUS_ID = "absolute-mobile-status";
@@ -6956,6 +7091,23 @@ var startAbsoluteMobileShell = async (options = {}) => {
   }) : undefined;
   const applicationFetch = auth?.fetch ?? options.createFetch?.(manifest) ?? globalThis.fetch;
   const observability = installAbsoluteMobileShellObservability(manifest, options.engine ?? "capacitor", applicationFetch);
+  if ((options.engine ?? "capacitor") === "capacitor") {
+    let nativeObservabilityDrain;
+    const drainNativeObservability = () => {
+      nativeObservabilityDrain ??= drainAbsoluteMobileNativeObservability(manifest, applicationFetch).catch(() => 0).finally(() => {
+        nativeObservabilityDrain = undefined;
+      });
+      return nativeObservabilityDrain;
+    };
+    drainNativeObservability();
+    addEventListener("online", () => void drainNativeObservability());
+    App.addListener("appStateChange", ({ isActive }) => {
+      if (isActive)
+        drainNativeObservability();
+    }).catch(() => {
+      return;
+    });
+  }
   installAbsoluteMobileShellHttp(manifest.productionOrigin, applicationFetch);
   if (auth)
     options.connectPush?.(auth);

package/dist/src/mobile/expoNativeObservability.d.ts

@@ -0,0 +1,3 @@
+export declare const expoNativeObservabilityRuntimeSource = "// Generated by AbsoluteJS. Edit absolute.config.ts, then run absolute mobile sync.\nimport { requireNativeModule } from 'expo';\nimport { AppState, Platform } from 'react-native';\nimport { ABSOLUTE_MOBILE_MANIFEST } from './webAssets';\n\ntype NativeObservabilityModule = {\n\tacknowledge(options: { ids: string[] }): Promise<void>;\n\tpending(): Promise<{ reports: unknown[] }>;\n};\ntype NativeReport = { details: Record<string, unknown>; id: string; kind: string; occurredAt: number; platform: 'android' | 'ios' };\nconst native = requireNativeModule<NativeObservabilityModule>('AbsoluteMobileObservability');\nconst KINDS = new Set(['anr', 'app-launch', 'cpu-exception', 'crash', 'disk-write-exception', 'hang', 'initialization-failure', 'low-memory', 'native-crash', 'resource-exhaustion', 'signal']);\nconst ID = /^[A-Za-z0-9._:-]{1,128}$/;\nconst isRecord = (value: unknown): value is Record<string, unknown> => typeof value === 'object' && value !== null && !Array.isArray(value);\nconst redactText = (value: string) => value.slice(0, 8192)\n\t.replace(/\\b(Bearer)\\s+[A-Za-z0-9._~+/-]+=*/gi, '$1 [REDACTED]')\n\t.replace(/([?&](?:access_token|api_?key|authorization|code|id_token|password|refresh_token|secret|token)=)[^&#\\s]*/gi, '$1[REDACTED]')\n\t.replace(/\\b((?:access_?token|api_?key|authorization|client_?secret|cookie|id_?token|password|passwd|refresh_?token|secret|token)\\s*[:=]\\s*)[^,\\s;]+/gi, '$1[REDACTED]')\n\t.replace(/\\beyJ[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+\\b/g, '[REDACTED]');\nconst redact = (value: unknown, depth = 0): unknown => {\n\tif (depth >= 8) return '[TRUNCATED]';\n\tif (typeof value === 'string') return redactText(value);\n\tif (value === null || typeof value === 'number' || typeof value === 'boolean') return value;\n\tif (Array.isArray(value)) return value.slice(0, 64).map(entry => redact(entry, depth + 1));\n\tif (!isRecord(value)) return String(value).slice(0, 8192);\n\treturn Object.fromEntries(Object.entries(value).slice(0, 128).map(([key, entry]) => [key, /(?:authorization|cookie|password|secret|token)/i.test(key) ? '[REDACTED]' : redact(entry, depth + 1)]));\n};\nconst parse = (value: unknown): NativeReport | undefined => {\n\tif (!isRecord(value) || !isRecord(value.details) || typeof value.id !== 'string' || !ID.test(value.id) || typeof value.kind !== 'string' || !KINDS.has(value.kind) || typeof value.occurredAt !== 'number' || !Number.isFinite(value.occurredAt) || value.occurredAt <= 0 || value.platform !== 'android' && value.platform !== 'ios') return;\n\tconst details = redact(value.details);\n\tif (!isRecord(details) || new TextEncoder().encode(JSON.stringify(details)).byteLength > 64 * 1024) return;\n\treturn { details, id: value.id, kind: value.kind, occurredAt: value.occurredAt, platform: value.platform };\n};\nconst sampled = (id: string, rate: number) => {\n\tif (rate >= 1) return true;\n\tlet hash = 2166136261;\n\tfor (const character of id) { hash ^= character.codePointAt(0) ?? 0; hash = Math.imul(hash, 16777619); }\n\treturn (hash >>> 0) / 4294967296 < rate;\n};\nlet drainPromise: Promise<void> | undefined;\nlet started = false;\nconst drain = () => {\n\tdrainPromise ??= (async () => {\n\t\tconst manifest = ABSOLUTE_MOBILE_MANIFEST;\n\t\tconst config = manifest?.observability;\n\t\tif (!manifest || !config || Platform.OS !== 'android' && Platform.OS !== 'ios') return;\n\t\tconst reports = (await native.pending()).reports.slice(0, 8).map(parse).filter((report): report is NativeReport => report !== undefined);\n\t\tconst discarded = reports.filter(report => !sampled(report.id, config.sampleRate));\n\t\tif (discarded.length) await native.acknowledge({ ids: discarded.map(report => report.id) });\n\t\tconst selected = reports.filter(report => sampled(report.id, config.sampleRate));\n\t\tif (!selected.length) return;\n\t\tconst response = await fetch(config.endpoint, {\n\t\t\tbody: JSON.stringify({ ...(config.environment ? { environment: config.environment } : {}), events: selected.map(report => ({ at: report.occurredAt, extra: { nativeDiagnostic: report.details, nativeDiagnosticId: report.id }, groupingKey: 'absolute-native:' + report.platform + ':' + report.kind, level: ['app-launch', 'cpu-exception', 'disk-write-exception', 'low-memory', 'resource-exhaustion', 'signal'].includes(report.kind) ? 'warning' : 'error', message: 'Native process diagnostic \u2014 ' + report.kind, name: 'AbsoluteMobileNativeDiagnostic', tags: { absoluteMobile: 'true', mobileAppBuild: manifest.appBuild, mobileEngine: 'expo', mobileFailurePhase: 'native-process', mobileManifestFormat: '1', mobileNativeRuntime: 'expo', mobilePlatform: report.platform, mobileRuntime: manifest.runtime } })), project: config.project, release: manifest.appBuild, v: 1 }),\n\t\t\theaders: { 'content-type': 'application/json' },\n\t\t\tmethod: 'POST'\n\t\t});\n\t\tif (response.ok) await native.acknowledge({ ids: selected.map(report => report.id) });\n\t})().catch(() => undefined).finally(() => { drainPromise = undefined; });\n\treturn drainPromise;\n};\nexport const startAbsoluteExpoNativeObservability = () => {\n\tif (!started) {\n\t\tstarted = true;\n\t\tAppState.addEventListener('change', state => { if (state === 'active') void drain(); });\n\t}\n\treturn drain();\n};\n";
+export declare const absoluteExpoNativeObservabilityFiles: (project: string) => Map<string, string>;
+export declare const absoluteExpoNativeObservabilityPaths: (project: string) => string[];

package/dist/src/mobile/index.d.ts

@@ -21,6 +21,7 @@ export * from './expoBridge';
 export * from './expoCodeSigning';
 export * from './expoDevController';
 export * from './expoProject';
+export * from './expoNativeObservability';
 export * from './expoUpdate';
 export * from './capacitorProject';
 export * from './config';
@@ -34,6 +35,7 @@ export * from './nativeDeviceCapabilities';
 export * from './nativeAuth';
 export * from './nativeRoute';
 export * from './nativeUpdates';
+export * from './nativeObservability';
 export * from './pageProtocol';
 export * from './producerContext';
 export * from './releaseArtifact';
@@ -41,6 +43,7 @@ export * from './releasePublisher';
 export * from './routeMetadataTransform';
 export * from './routeMatcher';
 export * from './shellHttp';
+export * from './shellNativeObservability';
 export * from './shellObservability';
 export * from './transport';
 export * from './uiPrimitives';

package/dist/src/mobile/nativeObservability.d.ts

@@ -0,0 +1,4 @@
+import type { NormalizedAbsoluteMobileConfig } from './config';
+export declare const applyAbsoluteNativeObservability: (config: NormalizedAbsoluteMobileConfig, platforms?: import("..").MobilePlatform[]) => Promise<{
+    changed: boolean;
+}>;

package/dist/src/mobile/shellNativeObservability.d.ts

@@ -0,0 +1,21 @@
+import type { AbsoluteMobileClientManifest, AbsoluteMobileFetch } from './transport';
+export type AbsoluteMobileNativeDiagnostic = {
+    details: Record<string, unknown>;
+    id: string;
+    kind: string;
+    occurredAt: number;
+    platform: 'android' | 'ios';
+};
+export type AbsoluteMobileNativeObservabilityPlugin = {
+    acknowledge(options: {
+        ids: string[];
+    }): Promise<void>;
+    pending(): Promise<{
+        reports: unknown[];
+    }>;
+};
+export type AbsoluteMobileNativeObservabilityDrainOptions = {
+    native?: boolean;
+    plugin?: AbsoluteMobileNativeObservabilityPlugin;
+};
+export declare const drainAbsoluteMobileNativeObservability: (manifest: AbsoluteMobileClientManifest, fetch: AbsoluteMobileFetch, options?: AbsoluteMobileNativeObservabilityDrainOptions) => Promise<number>;

package/package.json

@@ -296,12 +296,12 @@
 	"main": "./dist/index.js",
 	"name": "@absolutejs/absolute",
 	"optionalDependencies": {
-		"@absolutejs/native-darwin-arm64": "0.20.0-beta.67",
-		"@absolutejs/native-darwin-x64": "0.20.0-beta.67",
-		"@absolutejs/native-linux-arm64": "0.20.0-beta.67",
-		"@absolutejs/native-linux-x64": "0.20.0-beta.67",
-		"@absolutejs/native-windows-arm64": "0.20.0-beta.67",
-		"@absolutejs/native-windows-x64": "0.20.0-beta.67"
+		"@absolutejs/native-darwin-arm64": "0.20.0-beta.69",
+		"@absolutejs/native-darwin-x64": "0.20.0-beta.69",
+		"@absolutejs/native-linux-arm64": "0.20.0-beta.69",
+		"@absolutejs/native-linux-x64": "0.20.0-beta.69",
+		"@absolutejs/native-windows-arm64": "0.20.0-beta.69",
+		"@absolutejs/native-windows-x64": "0.20.0-beta.69"
 	},
 	"overrides": {
 		"@sinclair/typebox": "0.34.52",
@@ -463,6 +463,7 @@
 		"test:native:android:bundle": "ABSOLUTE_TEST_NATIVE_ANDROID=1 bun test tests/native/android-embedded-bundle-conformance.test.ts",
 		"test:native:android:hmr": "ABSOLUTE_TEST_NATIVE_ANDROID=1 bun test tests/native/android-hmr-conformance.test.ts",
 		"test:native:android:lifecycle": "ABSOLUTE_TEST_NATIVE_ANDROID=1 bun test tests/native/android-lifecycle-conformance.test.ts",
+		"test:native:android:observability": "ABSOLUTE_TEST_NATIVE_ANDROID=1 bun test tests/native/android-embedded-bundle-conformance.test.ts -t 'native process crash'",
 		"test:native:android:updates": "ABSOLUTE_TEST_NATIVE_ANDROID=1 bun test tests/native/android-embedded-bundle-conformance.test.ts -t 'signed web updates'",
 		"test:native:android:upgrade": "ABSOLUTE_TEST_NATIVE_ANDROID=1 bun test tests/native/android-embedded-bundle-conformance.test.ts -t 'installed APK upgrade'",
 		"test:native:ios": "bun run test:native:ios:lifecycle && bun run test:native:ios:bundle",
@@ -519,7 +520,7 @@
 			]
 		}
 	},
-	"version": "0.20.0-beta.67",
+	"version": "0.20.0-beta.69",
 	"workspaces": [
 		"tests/fixtures/*",
 		"tests/fixtures/_packages/*"