@absolutejs/absolute 0.20.0-beta.60 → 0.20.0-beta.62

package/dist/mobile/shellUpdate.js

@@ -1,6 +1,7 @@
 // src/mobile/shellUpdate.ts
 import { Directory, Filesystem } from "@capacitor/filesystem";
 import { Preferences } from "@capacitor/preferences";
+import { registerPlugin } from "@capacitor/core";
 
 // src/mobile/updateProtocol.ts
 var ABSOLUTE_MOBILE_UPDATE_FORMAT = 1;
@@ -238,6 +239,8 @@ var createAbsoluteMobileUpdateClient = (options) => {
       throw new TypeError("Mobile update signature verification failed.");
     if (manifest.releaseId === options.config.currentReleaseId)
       return { kind: "current" };
+    if (options.config.blockedReleaseIds?.includes(manifest.releaseId))
+      return { kind: "quarantined", releaseId: manifest.releaseId };
     if (!download)
       return { kind: "update-available", manifest };
     await options.store.begin(manifest);
@@ -260,7 +263,10 @@ var createAbsoluteMobileUpdateClient = (options) => {
 // src/mobile/shellUpdate.ts
 var STATE_KEY = "absolute.mobile.update.state.v1";
 var INSTALLATION_KEY = "absolute.mobile.update.installation.v1";
+var RESULT_KEY = Symbol.for("absolutejs.mobile.update.result");
+var RESULTS_KEY = Symbol.for("absolutejs.mobile.update.results");
 var ROOT = "NoCloud/ionic_built_snapshots";
+var watchdog = registerPlugin("AbsoluteMobileUpdateWatchdog");
 var base64Bytes = (value) => Uint8Array.from(atob(value), (character) => character.charCodeAt(0));
 var arrayBuffer = (value) => new Uint8Array(value).buffer;
 var bytesBase64 = (value) => {
@@ -283,10 +289,35 @@ var readState = async () => {
       const candidate = Reflect.get(parsed, key);
       return typeof candidate === "string" ? candidate : undefined;
     };
+    const number = (key) => {
+      const candidate = Reflect.get(parsed, key);
+      return typeof candidate === "number" && Number.isFinite(candidate) ? candidate : undefined;
+    };
+    const recoveryValue = Reflect.get(parsed, "recovery");
+    const quarantineValue = Reflect.get(parsed, "quarantinedReleases");
+    const quarantinedReleases = Array.isArray(quarantineValue) ? [
+      ...new Set(quarantineValue.filter((candidateRelease) => typeof candidateRelease === "string" && /^amu_[a-f0-9]{64}$/u.test(candidateRelease)))
+    ].slice(-8) : [];
+    const recovery = typeof recoveryValue === "object" && recoveryValue !== null ? {
+      durationMs: Reflect.get(recoveryValue, "durationMs"),
+      reason: Reflect.get(recoveryValue, "reason"),
+      releaseId: Reflect.get(recoveryValue, "releaseId")
+    } : undefined;
+    let validRecovery;
+    if (recovery && typeof recovery.durationMs === "number" && Number.isFinite(recovery.durationMs) && recovery.durationMs >= 0 && (recovery.reason === "boot-interrupted" || recovery.reason === "boot-timeout") && typeof recovery.releaseId === "string")
+      validRecovery = {
+        durationMs: recovery.durationMs,
+        reason: recovery.reason,
+        releaseId: recovery.releaseId
+      };
     return {
       ...text("activeRelease") ? { activeRelease: text("activeRelease") } : {},
       ...text("pendingRelease") ? { pendingRelease: text("pendingRelease") } : {},
-      ...text("readyRelease") ? { readyRelease: text("readyRelease") } : {}
+      ...number("pendingStartedAt") === undefined ? {} : { pendingStartedAt: number("pendingStartedAt") },
+      ...text("previousPath") ? { previousPath: text("previousPath") } : {},
+      ...quarantinedReleases.length > 0 ? { quarantinedReleases } : {},
+      ...text("readyRelease") ? { readyRelease: text("readyRelease") } : {},
+      ...validRecovery ? { recovery: validRecovery } : {}
     };
   } catch {
     return {};
@@ -336,18 +367,39 @@ var createStore = () => {
       await removeRelease(releaseId);
       const state = await readState();
       if (state.readyRelease === releaseId || state.pendingRelease === releaseId)
-        await writeState({ activeRelease: state.activeRelease });
+        await writeState({
+          activeRelease: state.activeRelease,
+          quarantinedReleases: state.quarantinedReleases,
+          recovery: state.recovery
+        });
     },
     activate: async (releaseId) => {
       const state = await readState();
       if (state.readyRelease !== releaseId)
         throw new TypeError("Mobile update is not committed and ready to activate.");
       const path = await releaseNativePath(releaseId);
+      const previousPath = await currentServerBasePath();
       await writeState({
         activeRelease: state.activeRelease,
-        pendingRelease: releaseId
+        pendingRelease: releaseId,
+        pendingStartedAt: Date.now(),
+        previousPath,
+        quarantinedReleases: state.quarantinedReleases
       });
-      webView().setServerBasePath(path);
+      try {
+        await watchdog.arm({ releaseId });
+        webView().setServerBasePath(path);
+      } catch (error) {
+        await watchdog.confirm({ releaseId }).catch(() => {
+          return;
+        });
+        await removeRelease(releaseId);
+        await writeState({
+          activeRelease: state.activeRelease,
+          quarantinedReleases: state.quarantinedReleases
+        });
+        throw error;
+      }
     },
     begin: async (manifest) => {
       await removeRelease(manifest.releaseId);
@@ -364,6 +416,7 @@ var createStore = () => {
       const state = await readState();
       await writeState({
         activeRelease: state.activeRelease,
+        quarantinedReleases: state.quarantinedReleases,
         readyRelease: manifest.releaseId
       });
       staging = undefined;
@@ -397,7 +450,16 @@ var createVerifier = (publicKeys) => ({
     }
   }
 });
-var emitUpdateResult = (detail) => dispatchEvent(new CustomEvent("absolute:mobile-update", { detail }));
+var emitUpdateResult = (detail) => {
+  Reflect.set(globalThis, RESULT_KEY, detail);
+  const existing = Reflect.get(globalThis, RESULTS_KEY);
+  const results = Array.isArray(existing) ? existing : [];
+  results.push(detail);
+  if (results.length > 8)
+    results.splice(0, results.length - 8);
+  Reflect.set(globalThis, RESULTS_KEY, results);
+  dispatchEvent(new CustomEvent("absolute:mobile-update", { detail }));
+};
 var removePriorRelease = async (prior, active) => {
   if (prior && prior !== active)
     await removeRelease(prior);
@@ -416,18 +478,34 @@ var reconcilePendingRelease = async (store, state) => {
   webView().persistServerBasePath();
   const next = { activeRelease: state.pendingRelease };
   await writeState(next);
+  await watchdog.confirm({ releaseId: state.pendingRelease });
   await removePriorRelease(state.activeRelease, next.activeRelease);
   emitUpdateResult({ kind: "activated", releaseId: next.activeRelease });
   return next;
 };
+var consumeNativeRecovery = async (state) => {
+  if (!state.recovery)
+    return state;
+  const { recovery, ...next } = state;
+  emitUpdateResult({
+    durationMs: Math.round(recovery.durationMs),
+    kind: "rolled-back",
+    reason: recovery.reason,
+    releaseId: recovery.releaseId
+  });
+  await writeState(next);
+  return next;
+};
 var installAbsoluteMobileShellUpdates = async (manifest) => {
   if (!manifest.updates)
     return;
   const store = createStore();
-  const state = await reconcilePendingRelease(store, await readState());
+  const recovered = await consumeNativeRecovery(await readState());
+  const state = await reconcilePendingRelease(store, recovered);
   const client = createAbsoluteMobileUpdateClient({
     config: {
       appId: manifest.appId,
+      blockedReleaseIds: state.quarantinedReleases ?? [],
       channel: manifest.updates.channel,
       currentReleaseId: state.activeRelease ?? `embedded:${manifest.appBuild}`,
       installationId: await installationId(),
@@ -446,7 +524,16 @@ var installAbsoluteMobileShellUpdates = async (manifest) => {
     });
     await client.activate(result.manifest.releaseId);
   };
-  client.download().then(activateDownloaded).catch((error) => {
+  client.download().then((result) => {
+    if (result.kind === "quarantined") {
+      emitUpdateResult({
+        kind: "quarantined",
+        releaseId: result.releaseId
+      });
+      return;
+    }
+    return activateDownloaded(result);
+  }).catch((error) => {
     console.error("[Absolute Mobile] Update failed:", error);
     emitUpdateResult({ kind: "failed" });
   });

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

@@ -24,6 +24,7 @@ export declare const materializeAbsoluteCapacitorWebBundle: (options: AbsoluteCa
         storageSchema: SyncLocalStoreSchemaBundle;
     } | undefined;
     updates?: {
+        bootTimeoutMs: number;
         channel: string;
         manifestUrl: string;
         publicKeys: Record<string, string>;

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

@@ -17,6 +17,7 @@ export type NormalizedAbsoluteMobileConfig = {
     productionOrigin: string;
     pushAndroidGoogleServicesFile: string;
     updates?: {
+        bootTimeoutMs: number;
         channel: string;
         manifestUrl: string;
         publicKeys: Record<string, string>;

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

@@ -24,6 +24,7 @@ export type AbsoluteMobileClientManifest = {
     routes: AbsoluteMobileCompatibilityRoute[];
     runtime: string;
     updates?: {
+        bootTimeoutMs: number;
         channel: string;
         manifestUrl: string;
         publicKeys: Record<string, string>;

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

@@ -1,6 +1,7 @@
 import { type AbsoluteMobileUpdateFile, type AbsoluteMobileUpdateManifest } from './updateProtocol';
 export type AbsoluteMobileUpdateClientConfig = {
     appId: string;
+    blockedReleaseIds?: readonly string[];
     channel: string;
     currentReleaseId: string;
     installationId: string;
@@ -29,6 +30,9 @@ export type AbsoluteMobileUpdateCheckResult = {
 } | {
     kind: 'downloaded';
     manifest: AbsoluteMobileUpdateManifest;
+} | {
+    kind: 'quarantined';
+    releaseId: string;
 } | {
     kind: 'update-available';
     manifest: AbsoluteMobileUpdateManifest;

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

@@ -2,7 +2,7 @@ import type { AbsoluteDeviceCapabilityPlan } from './deviceCapabilities';
 import type { NormalizedAbsoluteMobileConfig } from './config';
 import type { AbsoluteMobileAuthManifest } from './nativeAuth';
 import type { SyncLocalStoreSchemaBundle } from '@absolutejs/sync/client';
-export declare const ABSOLUTE_MOBILE_SHELL_ABI: 1;
+export declare const ABSOLUTE_MOBILE_SHELL_ABI: 2;
 export declare const ABSOLUTE_MOBILE_UPDATE_RUNTIME_FORMAT: 1;
 export type AbsoluteMobileUpdateRuntimeDescriptor = {
     appId: string;

package/dist/types/build.d.ts

@@ -57,6 +57,8 @@ type MobileSharedConfig = {
     };
     /** Signed over-the-air web-bundle updates. Native capability changes still require a store build. */
     updates?: {
+        /** Maximum time an activated bundle may take to render its first page before native rollback. Defaults to 20 seconds. */
+        bootTimeoutMs?: number;
         /** Release channel. Defaults to `production`. */
         channel?: string;
         /** Exact signed-manifest URL. Defaults to the AbsoluteJS production origin. */

package/package.json

@@ -293,12 +293,12 @@
 	"main": "./dist/index.js",
 	"name": "@absolutejs/absolute",
 	"optionalDependencies": {
-		"@absolutejs/native-darwin-arm64": "0.20.0-beta.60",
-		"@absolutejs/native-darwin-x64": "0.20.0-beta.60",
-		"@absolutejs/native-linux-arm64": "0.20.0-beta.60",
-		"@absolutejs/native-linux-x64": "0.20.0-beta.60",
-		"@absolutejs/native-windows-arm64": "0.20.0-beta.60",
-		"@absolutejs/native-windows-x64": "0.20.0-beta.60"
+		"@absolutejs/native-darwin-arm64": "0.20.0-beta.62",
+		"@absolutejs/native-darwin-x64": "0.20.0-beta.62",
+		"@absolutejs/native-linux-arm64": "0.20.0-beta.62",
+		"@absolutejs/native-linux-x64": "0.20.0-beta.62",
+		"@absolutejs/native-windows-arm64": "0.20.0-beta.62",
+		"@absolutejs/native-windows-x64": "0.20.0-beta.62"
 	},
 	"overrides": {
 		"@sinclair/typebox": "0.34.52",
@@ -460,6 +460,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: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",
 		"test:native:ios:bundle": "ABSOLUTE_TEST_NATIVE_IOS=1 bun test tests/native/ios-embedded-bundle-conformance.test.ts",
@@ -514,7 +515,7 @@
 			]
 		}
 	},
-	"version": "0.20.0-beta.60",
+	"version": "0.20.0-beta.62",
 	"workspaces": [
 		"tests/fixtures/*",
 		"tests/fixtures/_packages/*"