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

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

@@ -0,0 +1,40 @@
+import { type AbsoluteMobileUpdateFile, type AbsoluteMobileUpdateManifest } from './updateProtocol';
+export type AbsoluteMobileUpdateClientConfig = {
+    appId: string;
+    channel: string;
+    currentReleaseId: string;
+    installationId: string;
+    manifestUrl: string;
+    runtimeFingerprint: string;
+};
+export type AbsoluteMobileUpdateStore = {
+    abort(releaseId: string): Promise<void>;
+    activate(releaseId: string): Promise<void>;
+    begin(manifest: AbsoluteMobileUpdateManifest): Promise<void>;
+    commit(manifest: AbsoluteMobileUpdateManifest): Promise<void>;
+    write(file: AbsoluteMobileUpdateFile, contents: Uint8Array): Promise<void>;
+};
+export type AbsoluteMobileUpdateVerifier = {
+    digest(contents: Uint8Array): Promise<string>;
+    verify(manifest: AbsoluteMobileUpdateManifest): Promise<boolean>;
+};
+export type AbsoluteMobileUpdateClientOptions = {
+    config: AbsoluteMobileUpdateClientConfig;
+    fetch?: typeof globalThis.fetch;
+    store: AbsoluteMobileUpdateStore;
+    verifier: AbsoluteMobileUpdateVerifier;
+};
+export type AbsoluteMobileUpdateCheckResult = {
+    kind: 'current';
+} | {
+    kind: 'downloaded';
+    manifest: AbsoluteMobileUpdateManifest;
+} | {
+    kind: 'update-available';
+    manifest: AbsoluteMobileUpdateManifest;
+};
+export declare const createAbsoluteMobileUpdateClient: (options: AbsoluteMobileUpdateClientOptions) => {
+    check: (download?: boolean) => Promise<AbsoluteMobileUpdateCheckResult>;
+    activate: (releaseId: string) => Promise<void>;
+    download: () => Promise<AbsoluteMobileUpdateCheckResult>;
+};

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

@@ -0,0 +1,51 @@
+export declare const ABSOLUTE_MOBILE_UPDATE_FORMAT: 1;
+export declare const ABSOLUTE_MOBILE_UPDATE_MAX_FILE_BYTES: number;
+export declare const ABSOLUTE_MOBILE_UPDATE_MAX_FILES = 10000;
+export declare const ABSOLUTE_MOBILE_UPDATE_MAX_TOTAL_BYTES: number;
+export declare const ABSOLUTE_MOBILE_UPDATE_SIGNATURE_ALGORITHM: "ecdsa-p256-sha256";
+export type AbsoluteMobileUpdateClassification = 'bug-fix' | 'content' | 'security';
+export type AbsoluteMobileUpdateFile = {
+    bytes: number;
+    path: string;
+    sha256: string;
+};
+export type AbsoluteMobileUnsignedUpdateManifest = {
+    appId: string;
+    channel: string;
+    classification: AbsoluteMobileUpdateClassification;
+    createdAt: string;
+    files: AbsoluteMobileUpdateFile[];
+    format: typeof ABSOLUTE_MOBILE_UPDATE_FORMAT;
+    /** A content identity for the complete update, excluding its signature. */
+    releaseId: string;
+    /** Locks an update to the native plugins, bridge, Auth, and local-data ABI. */
+    runtimeFingerprint: string;
+    /** Store-policy attestation. Feature/primary-purpose changes require a store build. */
+    withinSubmittedPurpose: true;
+};
+export type AbsoluteMobileUpdateManifest = AbsoluteMobileUnsignedUpdateManifest & {
+    signature: {
+        algorithm: typeof ABSOLUTE_MOBILE_UPDATE_SIGNATURE_ALGORITHM;
+        keyId: string;
+        value: string;
+    };
+};
+export declare const absoluteMobileUpdateSigningPayload: (manifest: AbsoluteMobileUnsignedUpdateManifest) => Uint8Array<ArrayBuffer>;
+export declare const canonicalizeAbsoluteMobileUpdate: (value: unknown) => string;
+export declare const normalizeAbsoluteMobileUpdatePath: (value: unknown) => string;
+export declare const parseAbsoluteMobileUnsignedUpdateManifest: (value: unknown) => AbsoluteMobileUnsignedUpdateManifest;
+export declare const parseAbsoluteMobileUpdateManifest: (value: unknown) => AbsoluteMobileUpdateManifest;
+export declare const unsignedAbsoluteMobileUpdate: (manifest: AbsoluteMobileUpdateManifest) => {
+    appId: string;
+    channel: string;
+    classification: AbsoluteMobileUpdateClassification;
+    createdAt: string;
+    files: AbsoluteMobileUpdateFile[];
+    format: typeof ABSOLUTE_MOBILE_UPDATE_FORMAT;
+    /** A content identity for the complete update, excluding its signature. */
+    releaseId: string;
+    /** Locks an update to the native plugins, bridge, Auth, and local-data ABI. */
+    runtimeFingerprint: string;
+    /** Store-policy attestation. Feature/primary-purpose changes require a store build. */
+    withinSubmittedPurpose: true;
+};

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

@@ -0,0 +1,66 @@
+import { readAbsoluteMobileUpdate } from './updateSigning';
+export type AbsoluteMobileUpdatePublication = {
+    appId: string;
+    channel: string;
+    releaseId: string;
+    reused: boolean;
+    rollout: number;
+    stage: 'published';
+};
+export type AbsoluteMobileUpdatePromotion = {
+    appId: string;
+    channel: string;
+    releaseId: string;
+    rollout: number;
+    stage: 'promoted';
+};
+export type AbsoluteMobileUpdateRollback = {
+    appId: string;
+    channel: string;
+    releaseId?: string;
+    stage: 'rolled-back';
+};
+export type AbsoluteMobileUpdatePublisher = {
+    publishUpdate(options: {
+        manifest: Awaited<ReturnType<typeof readAbsoluteMobileUpdate>>;
+        releaseDirectory: string;
+        rollout: number;
+        signal?: AbortSignal;
+    }): Promise<AbsoluteMobileUpdatePublication>;
+    promoteUpdate(options: {
+        appId: string;
+        channel: string;
+        releaseId: string;
+        rollout: number;
+        signal?: AbortSignal;
+    }): Promise<AbsoluteMobileUpdatePromotion>;
+    rollbackUpdate(options: {
+        appId: string;
+        channel: string;
+        releaseId?: string;
+        signal?: AbortSignal;
+    }): Promise<AbsoluteMobileUpdateRollback>;
+};
+export declare const loadAbsoluteMobileUpdatePublisher: (projectRoot: string, requestedModulePath: string) => Promise<AbsoluteMobileUpdatePublisher>;
+export declare const promoteAbsoluteMobileUpdate: (options: {
+    appId: string;
+    channel: string;
+    publisher: AbsoluteMobileUpdatePublisher;
+    releaseId: string;
+    rollout: number;
+    signal?: AbortSignal;
+}) => Promise<AbsoluteMobileUpdatePromotion>;
+export declare const publishAbsoluteMobileUpdate: (options: {
+    projectRoot: string;
+    publisher: AbsoluteMobileUpdatePublisher;
+    releaseDirectory: string;
+    rollout: number;
+    signal?: AbortSignal;
+}) => Promise<AbsoluteMobileUpdatePublication>;
+export declare const rollbackAbsoluteMobileUpdate: (options: {
+    appId: string;
+    channel: string;
+    publisher: AbsoluteMobileUpdatePublisher;
+    releaseId?: string;
+    signal?: AbortSignal;
+}) => Promise<AbsoluteMobileUpdateRollback>;

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

@@ -0,0 +1,16 @@
+export type AbsoluteMobileUpdateRequestIdentity = {
+    appId: string;
+    channel: string;
+    currentReleaseId: string;
+    installationId: string;
+    runtimeFingerprint: string;
+};
+export type AbsoluteMobileUpdateRolloutOptions = {
+    appId: string;
+    channel: string;
+    installationId: string;
+    releaseId: string;
+    rollout: number;
+};
+export declare const isAbsoluteMobileUpdateRolloutMember: (options: AbsoluteMobileUpdateRolloutOptions) => boolean;
+export declare const parseAbsoluteMobileUpdateRequest: (request: Request) => AbsoluteMobileUpdateRequestIdentity;

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

@@ -0,0 +1,27 @@
+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_UPDATE_RUNTIME_FORMAT: 1;
+export type AbsoluteMobileUpdateRuntimeDescriptor = {
+    appId: string;
+    auth: AbsoluteMobileAuthManifest | null;
+    deepLinks: {
+        hosts: string[];
+        scheme?: string;
+    };
+    deviceCapabilities: AbsoluteDeviceCapabilityPlan;
+    engine: 'capacitor' | 'expo';
+    format: typeof ABSOLUTE_MOBILE_UPDATE_RUNTIME_FORMAT;
+    shellAbi: typeof ABSOLUTE_MOBILE_SHELL_ABI;
+    syncSchema: SyncLocalStoreSchemaBundle | null;
+    updates: NormalizedAbsoluteMobileConfig['updates'] | null;
+};
+export declare const createAbsoluteMobileUpdateRuntimeDescriptor: (options: {
+    auth?: AbsoluteMobileAuthManifest;
+    config: NormalizedAbsoluteMobileConfig;
+    deviceCapabilities: AbsoluteDeviceCapabilityPlan;
+    syncSchema?: SyncLocalStoreSchemaBundle;
+}) => AbsoluteMobileUpdateRuntimeDescriptor;
+export declare const fingerprintAbsoluteMobileUpdateRuntime: (descriptor: AbsoluteMobileUpdateRuntimeDescriptor) => string;

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

@@ -0,0 +1,20 @@
+import { type AbsoluteMobileUpdateClassification } from './updateProtocol';
+export type BuildAbsoluteMobileUpdateOptions = {
+    appId: string;
+    bundleDirectory: string;
+    channel: string;
+    classification: AbsoluteMobileUpdateClassification;
+    createdAt?: Date;
+    keyId: string;
+    outputDirectory: string;
+    privateKey: string | Buffer;
+    runtimeFingerprint: string;
+};
+export declare const buildAbsoluteMobileUpdate: (options: BuildAbsoluteMobileUpdateOptions) => Promise<{
+    manifest: import("./updateProtocol").AbsoluteMobileUpdateManifest;
+    manifestPath: string;
+    outputDirectory: string;
+}>;
+export declare const copyAbsoluteMobileUpdateFile: (updateDirectory: string, path: string, destination: string) => Promise<void>;
+export declare const readAbsoluteMobileUpdate: (directory: string) => Promise<import("./updateProtocol").AbsoluteMobileUpdateManifest>;
+export declare const verifyAbsoluteMobileUpdateSignature: (manifestValue: unknown, publicKey: string | Buffer) => import("./updateProtocol").AbsoluteMobileUpdateManifest;

package/dist/types/build.d.ts

@@ -55,6 +55,15 @@ type MobileSharedConfig = {
         /** Deployed AbsoluteJS origin used for page envelopes and API calls. */
         productionOrigin: string;
     };
+    /** Signed over-the-air web-bundle updates. Native capability changes still require a store build. */
+    updates?: {
+        /** Release channel. Defaults to `production`. */
+        channel?: string;
+        /** Exact signed-manifest URL. Defaults to the AbsoluteJS production origin. */
+        manifestUrl?: string;
+        /** ECDSA P-256 SPKI public keys, encoded as base64 DER and keyed by rotation ID. */
+        publicKeys: Readonly<Record<string, string>>;
+    };
     /** Capacitor webDir output. Defaults to `.absolutejs/mobile/web`. */
     bundleDirectory?: string;
     nativeProject?: {

package/package.json

@@ -14,6 +14,7 @@
 		"@absolutejs/http": "0.0.1",
 		"@absolutejs/pwa": "0.14.0",
 		"@capacitor/browser": "8.0.4",
+		"@capacitor/filesystem": "8.1.3",
 		"@capacitor/keyboard": "8.0.5",
 		"@capacitor/network": "8.0.1",
 		"@capacitor/preferences": "8.0.1",
@@ -54,7 +55,6 @@
 		"@capacitor/clipboard": "8.0.1",
 		"@capacitor/core": "8.5.0",
 		"@capacitor/file-viewer": "2.0.2",
-		"@capacitor/filesystem": "8.1.3",
 		"@capacitor/geolocation": "8.2.2",
 		"@capacitor/haptics": "8.0.2",
 		"@capacitor/ios": "8.5.0",
@@ -293,12 +293,12 @@
 	"main": "./dist/index.js",
 	"name": "@absolutejs/absolute",
 	"optionalDependencies": {
-		"@absolutejs/native-darwin-arm64": "0.20.0-beta.59",
-		"@absolutejs/native-darwin-x64": "0.20.0-beta.59",
-		"@absolutejs/native-linux-arm64": "0.20.0-beta.59",
-		"@absolutejs/native-linux-x64": "0.20.0-beta.59",
-		"@absolutejs/native-windows-arm64": "0.20.0-beta.59",
-		"@absolutejs/native-windows-x64": "0.20.0-beta.59"
+		"@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"
 	},
 	"overrides": {
 		"@sinclair/typebox": "0.34.52",
@@ -514,7 +514,7 @@
 			]
 		}
 	},
-	"version": "0.20.0-beta.59",
+	"version": "0.20.0-beta.60",
 	"workspaces": [
 		"tests/fixtures/*",
 		"tests/fixtures/_packages/*"