@absolutejs/absolute 0.20.0-beta.91 → 0.20.0-beta.93

package/dist/src/dev/clientManager.d.ts

@@ -17,10 +17,10 @@ export type HMRState = {
     dependencyGraph: DependencyGraph;
     isRebuilding: boolean;
     rebuildQueue: Set<string>;
-    rebuildTimeout: NodeJS.Timeout | null;
+    rebuildTimeout: ReturnType<typeof setTimeout> | null;
     pendingBundleRebuilds: Set<'angular' | 'svelte' | 'vue'>;
     fileChangeQueue: Map<string, string[]>;
-    debounceTimeout: NodeJS.Timeout | null;
+    debounceTimeout: ReturnType<typeof setTimeout> | null;
     fileHashes: Map<string, number>;
     watchers: FSWatcher[];
     moduleVersions: ModuleVersions;

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

@@ -19,11 +19,13 @@ export type AbsoluteAndroidRouteCheck = {
     title: string;
     url: string;
 };
-export declare const absoluteAndroidDevelopmentUrl: (port: number, route: string, https?: boolean) => string;
+export declare const absoluteAndroidDevelopmentUrl: (port: number, route: string, https?: boolean, target?: Extract<HMRClientTarget, `${string}-android`>) => string;
 export declare const inspectAbsoluteAndroidRoute: (session: AbsoluteAndroidWebViewSession, options: {
     https?: boolean;
+    navigation?: "devtools" | "in-page" | "none";
     port: number;
     route: string;
+    target?: Extract<HMRClientTarget, `${string}-android`>;
     timeoutMs?: number;
 }) => Promise<{
     route: string;
@@ -38,5 +40,6 @@ export declare const inspectAbsoluteAndroidRoute: (session: AbsoluteAndroidWebVi
 export declare const waitForAbsoluteAndroidHmrApply: (session: AbsoluteAndroidWebViewSession, options: {
     afterUpdateId?: number;
     kind?: HMRApplyKind;
+    target?: Extract<HMRClientTarget, `${string}-android`>;
     timeoutMs?: number;
 }) => Promise<AbsoluteAndroidHmrApply>;

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

@@ -52,6 +52,7 @@ export type AbsoluteExpoDevSession = {
     close: () => Promise<void>;
     metroPort: number;
     platforms: AbsoluteExpoDevPlatform[];
+    rebuild: () => Promise<AbsoluteExpoDevSession>;
     timings: Partial<Record<AbsoluteExpoDevState, number>>;
 };
 export type InstallAbsoluteExpoAndroidReleaseOptions = {
@@ -96,9 +97,4 @@ export declare const planAbsoluteExpoDevSession: (config: NormalizedAbsoluteMobi
 export declare const installAbsoluteExpoAndroidRelease: (options: InstallAbsoluteExpoAndroidReleaseOptions) => Promise<AbsoluteExpoAndroidReleaseInstallation>;
 export declare const installAbsoluteExpoIosRelease: (options: InstallAbsoluteExpoIosReleaseOptions) => Promise<AbsoluteExpoIosReleaseInstallation>;
 export declare const parseBootedAbsoluteExpoIosSimulators: (source: string) => string[];
-export declare const startAbsoluteExpoDevSession: (options: StartAbsoluteExpoDevOptions) => Promise<{
-    metroPort: number;
-    platforms: AbsoluteExpoDevPlatform[];
-    timings: Partial<Record<AbsoluteExpoDevState, number>>;
-    close: () => Promise<void>;
-}>;
+export declare const startAbsoluteExpoDevSession: (options: StartAbsoluteExpoDevOptions) => Promise<AbsoluteExpoDevSession>;

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

@@ -1,3 +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\tcrashForTesting(options: { testId: string }): Promise<boolean>;\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};\nexport const crashAbsoluteExpoNativeObservabilityForTesting = (testId: string) => native.crashForTesting({ testId });\n";
+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\tcrashForTesting(options: { testId: string }): Promise<boolean>;\n\tenqueueForTesting(options: { testId: string }): Promise<boolean>;\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};\nexport const crashAbsoluteExpoNativeObservabilityForTesting = (testId: string) => native.crashForTesting({ testId });\nexport const enqueueAbsoluteExpoNativeObservabilityForTesting = async (testId: string) => {\n\tawait drain();\n\tconst enqueued = await native.enqueueForTesting({ testId });\n\tawait drain();\n\treturn enqueued;\n};\n";
 export declare const absoluteExpoNativeObservabilityFiles: (project: string) => Map<string, string>;
 export declare const absoluteExpoNativeObservabilityPaths: (project: string) => string[];

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

@@ -0,0 +1,21 @@
+export type AbsoluteExpoNativeChange = {
+    afterFingerprint: string;
+    beforeFingerprint: string;
+    paths: string[];
+    rootInputChanged: boolean;
+};
+export type AbsoluteExpoNativeWatcher = {
+    close: () => void;
+};
+export type AbsoluteExpoNativeWatcherOptions = {
+    debounceMs?: number;
+    expoProjectDirectory: string;
+    onChange: (change: AbsoluteExpoNativeChange) => Promise<void>;
+    onError?: (error: unknown) => void;
+    projectRoot: string;
+    signal?: AbortSignal;
+};
+declare const fingerprintAbsoluteExpoNativeInputs: (options: Pick<AbsoluteExpoNativeWatcherOptions, "expoProjectDirectory" | "projectRoot">) => Promise<string>;
+declare const isAbsoluteExpoNativeRootInput: (path: string) => boolean;
+declare const createAbsoluteExpoNativeWatcher: (options: AbsoluteExpoNativeWatcherOptions) => Promise<AbsoluteExpoNativeWatcher>;
+export { createAbsoluteExpoNativeWatcher, fingerprintAbsoluteExpoNativeInputs, isAbsoluteExpoNativeRootInput };

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

@@ -21,6 +21,7 @@ export * from './deviceCapabilities';
 export * from './expoBridge';
 export * from './expoCodeSigning';
 export * from './expoDevController';
+export * from './expoNativeWatcher';
 export * from './expoProject';
 export * from './expoNativeObservability';
 export * from './expoUpdate';

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

@@ -180,15 +180,12 @@ export declare const acquireAbsoluteRemoteMacReleaseLease: (project: AbsoluteRem
     staleSeconds?: number;
     transport?: Pick<AbsoluteRemoteMacTransport, "capture">;
 }) => Promise<AbsoluteRemoteMacLease>;
-declare const inspectAbsoluteRemoteMacWorkspace: (profile: AbsoluteRemoteMacProfile, transport?: Pick<AbsoluteRemoteMacTransport, "capture">) => Promise<AbsoluteRemoteMacWorkspaceInspection>;
-/** Remove only abandoned staging directories. Project dependency/native caches,
- * immutable releases, and active leases are deliberately retained.
- */
 declare const cleanAbsoluteRemoteMacWorkspace: (profile: AbsoluteRemoteMacProfile, transport?: Pick<AbsoluteRemoteMacTransport, "capture">) => Promise<{
     profile: string;
     removed: number;
     workspaceRoot: string;
 }>;
+declare const inspectAbsoluteRemoteMacWorkspace: (profile: AbsoluteRemoteMacProfile, transport?: Pick<AbsoluteRemoteMacTransport, "capture">) => Promise<AbsoluteRemoteMacWorkspaceInspection>;
 export { cleanAbsoluteRemoteMacWorkspace, inspectAbsoluteRemoteMacWorkspace };
 export declare const installAbsoluteRemoteMacAgent: (project: AbsoluteRemoteIosDevProject) => Promise<{
     remotePath: string;

package/dist/src/utils/unrefTimer.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Detach a Bun/Node timer without assuming the DOM or server timer type wins
+ * in a mixed-runtime TypeScript program. Browser numeric handles are a no-op.
+ */
+export declare const unrefTimer: (timer: unknown) => void;

package/package.json

@@ -12,7 +12,7 @@
 		"@absolutejs/deploy": "0.25.14",
 		"@absolutejs/devices": "0.7.0",
 		"@absolutejs/devices-capacitor": "0.8.0",
-		"@absolutejs/devices-expo": "0.0.2",
+		"@absolutejs/devices-expo": "0.0.3",
 		"@absolutejs/http": "0.0.1",
 		"@absolutejs/pwa": "0.14.0",
 		"@capacitor/browser": "8.0.4",
@@ -472,9 +472,12 @@
 		"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:expo:android:hmr": "ABSOLUTE_TEST_NATIVE_EXPO_HMR_PLATFORM=android bun test tests/native/expo-hmr-conformance.test.ts",
 		"test:native:expo:android:observability": "ABSOLUTE_TEST_NATIVE_EXPO_ANDROID=1 bun test tests/native/expo-android-observability-conformance.test.ts",
 		"test:native:expo:android:updates": "ABSOLUTE_TEST_NATIVE_EXPO_ANDROID_UPDATES=1 bun test tests/native/expo-android-update-conformance.test.ts",
 		"test:native:expo:android:upgrade": "ABSOLUTE_TEST_NATIVE_EXPO_ANDROID_UPGRADE=1 bun test tests/native/expo-android-upgrade-conformance.test.ts",
+		"test:native:expo:ios:hmr": "ABSOLUTE_TEST_NATIVE_EXPO_HMR_PLATFORM=ios bun test tests/native/expo-hmr-conformance.test.ts",
+		"test:native:expo:ios:observability": "ABSOLUTE_TEST_NATIVE_EXPO_IOS_OBSERVABILITY=1 bun test tests/native/expo-ios-observability-conformance.test.ts",
 		"test:native:expo:ios:updates": "ABSOLUTE_TEST_NATIVE_EXPO_IOS_UPDATES=1 bun test tests/native/expo-ios-update-conformance.test.ts",
 		"test:native:expo:ios:upgrade": "ABSOLUTE_TEST_NATIVE_EXPO_IOS_UPGRADE=1 bun test tests/native/expo-ios-upgrade-conformance.test.ts",
 		"test:native:ios": "bun run test:native:ios:lifecycle && bun run test:native:ios:bundle",
@@ -530,7 +533,7 @@
 			]
 		}
 	},
-	"version": "0.20.0-beta.91",
+	"version": "0.20.0-beta.93",
 	"workspaces": [
 		"tests/fixtures/*",
 		"tests/fixtures/_packages/*"