@absolutejs/absolute 0.20.0-beta.84 → 0.20.0-beta.86

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

@@ -36,6 +36,11 @@ export type NormalizedAbsoluteMobileConfig = {
     };
     updateServer?: {
         autoMount: boolean;
+        health?: {
+            failureRate: number;
+            minimumReports: number;
+            secretEnv: string;
+        };
         expoCodeSigningKeys: Record<string, {
             certificatePem: string;
             privateKeyEnv: string;

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

@@ -13,8 +13,16 @@ export type AbsoluteMobileUpdateStore = {
     activate(releaseId: string): Promise<void>;
     begin(manifest: AbsoluteMobileUpdateManifest): Promise<void>;
     commit(manifest: AbsoluteMobileUpdateManifest): Promise<void>;
+    /** Append a response chunk to persistent staging at the expected offset. */
+    appendPartial?(file: AbsoluteMobileUpdateFile, contents: Uint8Array, offset: number): Promise<void>;
+    /** Return an unverified, incomplete download from persistent staging. */
+    readPartial?(file: AbsoluteMobileUpdateFile): Promise<Uint8Array | null>;
     /** Return a locally cached candidate for this exact path, when available. */
     readReusable?(file: AbsoluteMobileUpdateFile): Promise<Uint8Array | null>;
+    /** Return an unverified completed file from a prior staging attempt. */
+    readStaged?(file: AbsoluteMobileUpdateFile): Promise<Uint8Array | null>;
+    /** End this attempt without deleting persistent staging. */
+    suspend?(releaseId: string): Promise<void>;
     write(file: AbsoluteMobileUpdateFile, contents: Uint8Array): Promise<void>;
 };
 export type AbsoluteMobileUpdateVerifier = {
@@ -23,33 +31,58 @@ export type AbsoluteMobileUpdateVerifier = {
 };
 export type AbsoluteMobileUpdateClientOptions = {
     config: AbsoluteMobileUpdateClientConfig;
+    /** Maximum parallel asset requests. Network conditions may reduce this. */
+    concurrency?: number;
     fetch?: typeof globalThis.fetch;
+    onProgress?: (progress: AbsoluteMobileUpdateProgress) => void;
     store: AbsoluteMobileUpdateStore;
     verifier: AbsoluteMobileUpdateVerifier;
 };
 export type AbsoluteMobileUpdateCheckResult = {
     kind: 'current';
 } | {
+    healthToken?: string;
     kind: 'downloaded';
     manifest: AbsoluteMobileUpdateManifest;
     transfer: AbsoluteMobileUpdateTransfer;
 } | {
+    healthToken?: string;
     kind: 'quarantined';
     releaseId: string;
 } | {
+    healthToken?: string;
     kind: 'update-available';
     manifest: AbsoluteMobileUpdateManifest;
 };
+export type AbsoluteMobileUpdateHealthKind = 'activated' | 'downloaded' | 'download-failed' | 'quarantined' | 'rolled-back';
+export type AbsoluteMobileUpdateHealthEvidence = {
+    healthToken: string;
+    kind: AbsoluteMobileUpdateHealthKind;
+    reason?: 'boot-interrupted' | 'boot-timeout';
+    releaseId: string;
+    transfer?: Pick<AbsoluteMobileUpdateTransfer, 'avoidedBytes' | 'downloadedBytes' | 'durationMs' | 'resumedBytes' | 'reusedBytes' | 'throughputBytesPerSecond'>;
+};
 export type AbsoluteMobileUpdateTransfer = {
+    avoidedBytes: number;
+    completedFiles: number;
     downloadedBytes: number;
     downloadedFiles: number;
+    durationMs: number;
+    resumedBytes: number;
+    resumedFiles: number;
     reusedBytes: number;
     reusedFiles: number;
+    throughputBytesPerSecond: number;
     totalBytes: number;
     totalFiles: number;
 };
+export type AbsoluteMobileUpdateProgress = AbsoluteMobileUpdateTransfer & {
+    kind: 'download-progress';
+};
+export declare const reportAbsoluteMobileUpdateHealth: (config: AbsoluteMobileUpdateClientConfig, input: AbsoluteMobileUpdateHealthEvidence, request?: typeof globalThis.fetch) => Promise<void>;
 export declare const createAbsoluteMobileUpdateClient: (options: AbsoluteMobileUpdateClientOptions) => {
     check: (download?: boolean) => Promise<AbsoluteMobileUpdateCheckResult>;
     activate: (releaseId: string) => Promise<void>;
     download: () => Promise<AbsoluteMobileUpdateCheckResult>;
+    report: (input: AbsoluteMobileUpdateHealthEvidence) => Promise<void>;
 };

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

@@ -1,4 +1,4 @@
-import type { MobileUpdatePruneOptions, MobileUpdatePruneResult, MobileUpdateRetentionOptions, MobileUpdateStorageReport } from '@absolutejs/deploy/mobile-update';
+import type { MobileUpdateHealthReport, MobileUpdatePruneOptions, MobileUpdatePruneResult, MobileUpdateRetentionOptions, MobileUpdateStorageReport } from '@absolutejs/deploy/mobile-update';
 import { readAbsoluteMobileUpdate } from './updateSigning';
 export type AbsoluteMobileUpdatePublication = {
     appId: string;
@@ -26,6 +26,11 @@ export type AbsoluteMobileUpdateRollback = {
     stage: 'rolled-back';
 };
 export type AbsoluteMobileUpdatePublisher = {
+    inspectUpdateHealth?: (options: {
+        appId: string;
+        channel: string;
+        releaseId?: string;
+    }) => Promise<MobileUpdateHealthReport | null>;
     inspectUpdateStorage?: (options: MobileUpdateRetentionOptions) => Promise<MobileUpdateStorageReport>;
     pruneUpdates?: (options: MobileUpdatePruneOptions) => Promise<MobileUpdatePruneResult>;
     publishUpdate(options: {
@@ -48,6 +53,12 @@ export type AbsoluteMobileUpdatePublisher = {
         signal?: AbortSignal;
     }): Promise<AbsoluteMobileUpdateRollback>;
 };
+export declare const inspectAbsoluteMobileUpdateHealth: (options: {
+    appId: string;
+    channel: string;
+    publisher: AbsoluteMobileUpdatePublisher;
+    releaseId?: string;
+}) => Promise<MobileUpdateHealthReport | null>;
 export declare const inspectAbsoluteMobileUpdateStorage: (options: {
     appId: string;
     minAgeMs?: number;

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

@@ -22,11 +22,21 @@ export declare const createAbsoluteMobileUpdateServerPlugin: (config: Normalized
 }, import("elysia/types").DefaultMetadata, {}, import("elysia/types").DefaultEphemeral, import("elysia/types").DefaultEphemeral>>;
 export declare const inspectAbsoluteMobileUpdateServer: (config: NormalizedAbsoluteMobileConfig, projectRoot: string) => Promise<AbsoluteMobileUpdateServerMetadata | undefined>;
 export declare const renderAbsoluteMobileUpdateRegistry: (options: {
+    health?: {
+        failureRate: number;
+        minimumReports: number;
+        secretEnv: string;
+    };
     publicKeys: Readonly<Record<string, string>>;
     storage: "local" | "s3";
 }) => string;
 export declare const writeAbsoluteMobileUpdateRegistry: (options: {
     force?: boolean;
+    health?: {
+        failureRate: number;
+        minimumReports: number;
+        secretEnv: string;
+    };
     modulePath?: string;
     projectRoot: string;
     publicKeys: Readonly<Record<string, string>>;

package/dist/types/build.d.ts

@@ -111,6 +111,15 @@ type MobileSharedConfig = {
         server?: {
             /** Mount the update endpoint in the AbsoluteJS runtime. Defaults to true. */
             autoMount?: boolean;
+            /** Anonymous fleet-health receipts and automatic rollout protection. Enabled by default. */
+            health?: false | {
+                /** Failure fraction that pauses a promotion. Defaults to 0.2. */
+                failureRate?: number;
+                /** Terminal activation/rollback sample required before pausing. Defaults to 20. */
+                minimumReports?: number;
+                /** Trusted-server secret environment variable. */
+                secretEnv?: string;
+            };
             /** Project-relative registry module. Defaults to `mobile.update.ts`. */
             registry?: string;
             /** Environment variable containing the Expo RSA private key PEM. */

package/package.json

@@ -9,7 +9,7 @@
 	"dependencies": {
 		"@absolutejs/auth": ">=0.75.0 <0.77.0",
 		"@absolutejs/beacon": ">=0.7.0-beta.4 <0.8.0",
-		"@absolutejs/deploy": "0.25.8",
+		"@absolutejs/deploy": "0.25.11",
 		"@absolutejs/devices": "0.7.0",
 		"@absolutejs/devices-capacitor": "0.8.0",
 		"@absolutejs/devices-expo": "0.0.2",
@@ -523,7 +523,7 @@
 			]
 		}
 	},
-	"version": "0.20.0-beta.84",
+	"version": "0.20.0-beta.86",
 	"workspaces": [
 		"tests/fixtures/*",
 		"tests/fixtures/_packages/*"