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

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

@@ -0,0 +1,47 @@
+export type AbsoluteAndroidInstalledApp = {
+    appId: string;
+    dataDirectory?: string;
+    firstInstallTime?: string;
+    lastUpdateTime?: string;
+    uid?: string;
+    versionCode?: number;
+    versionName?: string;
+};
+export type AbsoluteAndroidUpgradeState = {
+    authCredential: boolean;
+    pendingOperations: boolean;
+    syncDatabase: boolean;
+};
+export type AbsoluteAndroidCompatibilityMatrix = {
+    nPlusOne: 'compatible' | 'upgrade-required';
+    nPlusTwo: 'compatible' | 'upgrade-required';
+    nPlusThree: 'compatible' | 'upgrade-required';
+    rollback: 'compatible' | 'failed';
+};
+export type AbsoluteAndroidUpgradeConformanceResult = {
+    after: AbsoluteAndroidInstalledApp;
+    before: AbsoluteAndroidInstalledApp;
+    compatibility?: AbsoluteAndroidCompatibilityMatrix;
+    durationMs: number;
+    installMs: number;
+    outcome: 'fail' | 'pass';
+    state: AbsoluteAndroidUpgradeState;
+};
+export type AbsoluteAndroidUpgradeCommandResult = {
+    exitCode: number;
+    stderr: string;
+    stdout: string;
+};
+export type RunAbsoluteAndroidUpgradeConformanceOptions = {
+    adb: string;
+    afterInstall?: (installed: AbsoluteAndroidInstalledApp) => Promise<void>;
+    apkPath: string;
+    appId: string;
+    compatibility?: AbsoluteAndroidCompatibilityMatrix;
+    run?: (command: string[]) => Promise<AbsoluteAndroidUpgradeCommandResult>;
+    serial: string;
+    verifyState: () => Promise<AbsoluteAndroidUpgradeState>;
+};
+export declare const inspectAbsoluteAndroidInstalledApp: (adb: string, serial: string, appId: string, run?: (command: string[]) => Promise<AbsoluteAndroidUpgradeCommandResult>) => Promise<AbsoluteAndroidInstalledApp>;
+export declare const parseAbsoluteAndroidInstalledApp: (appId: string, output: string) => AbsoluteAndroidInstalledApp | null;
+export declare const runAbsoluteAndroidUpgradeConformance: (options: RunAbsoluteAndroidUpgradeConformanceOptions) => Promise<AbsoluteAndroidUpgradeConformanceResult>;

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

@@ -25,6 +25,7 @@ export type AbsoluteAndroidWebViewSession = {
     screenshot: (path: string) => Promise<string>;
     serial: string;
     socket: string;
+    tap: (x: number, y: number) => Promise<void>;
     target: CdpTarget;
     waitFor: <T>(expression: string, options?: {
         timeoutMs?: number;

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

@@ -1,2 +1,4 @@
 export * from './client';
 export * from './pageProtocol';
+export * from './syncRemediation';
+export * from './uiPrimitives';

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

@@ -1,23 +1,41 @@
 import type { NormalizedAbsoluteMobileConfig } from './config';
 import type { AbsoluteMobileCompatibilityArtifact } from './releaseArtifact';
 import type { AbsoluteMobileAuthManifest } from './nativeAuth';
+import type { SyncLocalStoreSchemaBundle } from '@absolutejs/sync/client';
+import type { AbsoluteDeviceCapabilityPlan } from './deviceCapabilities';
 export type AbsoluteCapacitorBundleOptions = {
     artifact: AbsoluteMobileCompatibilityArtifact;
     auth?: AbsoluteMobileAuthManifest;
     buildDirectory: string;
     config: NormalizedAbsoluteMobileConfig;
+    deviceCapabilities: AbsoluteDeviceCapabilityPlan;
+    projectRoot: string;
+    runtimeFingerprint: string;
     sync?: boolean;
+    syncSchema?: SyncLocalStoreSchemaBundle;
 };
 export declare const materializeAbsoluteCapacitorWebBundle: (options: AbsoluteCapacitorBundleOptions) => Promise<{
     sync?: {
+        background: {
+            endpoint: string;
+            intervalMinutes: number;
+        };
         socketTickets: true;
+        storageSchema: SyncLocalStoreSchemaBundle;
+    } | undefined;
+    updates?: {
+        channel: string;
+        manifestUrl: string;
+        publicKeys: Record<string, string>;
     } | undefined;
     appId: string;
     appName: string;
     deepLinkHosts: string[];
     deepLinkScheme: string | undefined;
+    deviceCapabilities: string[];
     entry: string;
     format: 1;
+    nativeRuntime: string;
     pages: {
         localStylePath?: string | undefined;
         localBundlePath: string;

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

@@ -0,0 +1,26 @@
+import type { NormalizedAbsoluteMobileConfig } from './config';
+export declare const ABSOLUTE_MOBILE_CI_WORKFLOW_FORMAT: 1;
+export type AbsoluteMobileGithubWorkflowOptions = {
+    config: NormalizedAbsoluteMobileConfig;
+    configPath?: string;
+    force?: boolean;
+    includePublishing?: boolean;
+    outputPath?: string;
+    projectRoot: string;
+    registryModule?: string;
+    secretEnvironment?: readonly string[];
+    serverEntry?: string;
+};
+export type AbsoluteMobileGithubWorkflowResult = {
+    changed: boolean;
+    format: typeof ABSOLUTE_MOBILE_CI_WORKFLOW_FORMAT;
+    path: string;
+    platforms: ('android' | 'ios')[];
+    publishing: boolean;
+    requiredSecrets: string[];
+};
+export declare const createAbsoluteMobileGithubWorkflow: (options: AbsoluteMobileGithubWorkflowOptions) => {
+    requiredSecrets: string[];
+    workflow: string;
+};
+export declare const writeAbsoluteMobileGithubWorkflow: (options: AbsoluteMobileGithubWorkflowOptions) => Promise<AbsoluteMobileGithubWorkflowResult>;

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

@@ -7,11 +7,19 @@ export type NormalizedAbsoluteMobileConfig = {
     bundleDirectory: string;
     deepLinkHosts: string[];
     deepLinkScheme?: string;
-    engine: 'capacitor';
+    engine: 'capacitor' | 'expo';
     entry: string;
+    expoNativeRoutes: Record<string, string>;
+    expoSdkVersion?: 57;
     iosVersion?: string;
     nativeProjectDirectory: string;
     platforms: MobilePlatform[];
     productionOrigin: string;
+    pushAndroidGoogleServicesFile: string;
+    updates?: {
+        channel: string;
+        manifestUrl: string;
+        publicKeys: Record<string, string>;
+    };
 };
 export declare const normalizeAbsoluteMobileConfig: (config: MobileConfig, projectRoot: string) => NormalizedAbsoluteMobileConfig;

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

@@ -0,0 +1,3 @@
+import type { MobileConfig } from '../../types/build';
+export declare const absoluteNativeDevAdapterSource: (projectRoot: string, mobile: MobileConfig, resolveModule?: (specifier: string) => string, expoAdapterModule?: string, expoAuthModule?: string, expoSyncModule?: string) => string;
+export declare const buildAbsoluteNativeDevAdapter: (projectRoot: string, mobile: MobileConfig) => Promise<string>;

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

@@ -0,0 +1,49 @@
+export type AbsoluteDeviceCapabilityProvider = {
+    factory: string;
+    module: string;
+    plugins?: string[];
+    native?: {
+        android?: {
+            permissions: string[];
+        };
+        ios?: {
+            privacyAccessedApis?: Partial<Record<AbsoluteIosPrivacyAccessedApi, string[]>>;
+            pushNotifications?: true;
+            systemBars?: true;
+            usageDescriptions?: AbsoluteIosUsageDescription[];
+        };
+    };
+    packages: string[];
+};
+export type AbsoluteIosUsageDescription = 'camera' | 'location-always' | 'location-when-in-use' | 'photo-library' | 'photo-library-add';
+export type AbsoluteIosPrivacyAccessedApi = 'NSPrivacyAccessedAPICategoryFileTimestamp';
+export type AbsoluteDeviceCapabilityPlan = {
+    capabilities: string[];
+    providers: Record<string, AbsoluteDeviceCapabilityProvider>;
+    requiredPackages: string[];
+};
+export declare const ABSOLUTE_MOBILE_SHELL_DEVICE_CAPABILITIES: readonly ["keyboard", "systemBars"];
+export type AbsoluteDeviceProvider = 'capacitor' | 'expo';
+export declare const absoluteDeviceNativeRequirements: (plan: AbsoluteDeviceCapabilityPlan) => {
+    androidPermissions: string[];
+    iosPrivacyAccessedApis: {
+        api: "NSPrivacyAccessedAPICategoryFileTimestamp";
+        reasons: string[];
+    }[];
+    iosPushNotifications: boolean;
+    iosSystemBars: boolean;
+    iosUsageDescriptions: AbsoluteIosUsageDescription[];
+};
+export declare const loadAbsoluteDeviceCapabilityProviders: (projectRoot: string, provider?: AbsoluteDeviceProvider) => {
+    [k: string]: AbsoluteDeviceCapabilityProvider;
+};
+export declare const assertAbsoluteDeviceCapabilityPackages: (projectRoot: string, plan: AbsoluteDeviceCapabilityPlan) => void;
+export declare const directAbsoluteProjectPackages: (projectRoot: string) => Set<string>;
+export declare const discoverAbsoluteDeviceCapabilities: (projectRoot: string, providers?: {
+    [k: string]: AbsoluteDeviceCapabilityProvider;
+}) => string[];
+export declare const missingAbsoluteDeviceCapabilityPackages: (plan: AbsoluteDeviceCapabilityPlan, directPackages: ReadonlySet<string>) => string[];
+/** Framework-agnostic capability discovery used by web/PWA builds. This does
+ * not load a native provider manifest, so Web Push never requires Capacitor. */
+export declare const projectImportsAbsoluteDeviceCapability: (projectRoot: string, capability: string) => boolean;
+export declare const resolveAbsoluteDeviceCapabilityPlan: (projectRoot: string, provider?: AbsoluteDeviceProvider) => AbsoluteDeviceCapabilityPlan;

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

@@ -0,0 +1,91 @@
+export declare const ABSOLUTE_EXPO_BRIDGE_FORMAT: 3;
+export declare const ABSOLUTE_EXPO_BRIDGE_MAX_BYTES: number;
+export declare const ABSOLUTE_EXPO_BRIDGE_METHODS: readonly ["devices.platform.getInfo", "devices.lifecycle.getState", "devices.links.getLaunchUrl", "devices.links.openExternal", "devices.network.getStatus", "devices.storage.clear", "devices.storage.get", "devices.storage.keys", "devices.storage.remove", "devices.storage.set", "devices.back.capability", "devices.clipboard.capability", "devices.clipboard.readText", "devices.clipboard.writeText", "devices.share.capability", "devices.share.share", "devices.haptics.capability", "devices.haptics.impact", "devices.haptics.notification", "devices.haptics.selectionChanged", "devices.haptics.vibrate", "devices.keyboard.capability", "devices.keyboard.dismiss", "devices.keyboard.getState", "devices.systemBars.capability", "devices.systemBars.setAppearance", "devices.systemBars.setVisible", "devices.camera.capability", "devices.camera.queryPermission", "devices.camera.requestPermission", "devices.camera.takePhoto", "devices.photos.capability", "devices.photos.pick", "devices.location.capability", "devices.location.current", "devices.location.queryPermission", "devices.location.requestPermission", "devices.location.watch.start", "devices.location.watch.stop", "devices.localNotifications.capability", "devices.localNotifications.queryPermission", "devices.localNotifications.requestPermission", "devices.localNotifications.schedule", "devices.localNotifications.pending", "devices.localNotifications.cancel", "devices.pushNotifications.capability", "devices.pushNotifications.queryPermission", "devices.pushNotifications.requestPermission", "devices.pushNotifications.enable", "devices.pushNotifications.disable", "devices.documents.capability", "devices.documents.pick", "devices.transfer.read", "devices.transfer.close", "devices.upload.begin", "devices.upload.write", "devices.documents.export", "devices.documents.open", "http.fetch", "auth.signIn", "auth.signOut", "auth.status", "sync.store.begin", "sync.store.deleteNamespace", "sync.store.end", "sync.store.schema", "sync.tx.deleteCollection", "sync.tx.deleteMutation", "sync.tx.getCollection", "sync.tx.getInstallationId", "sync.tx.getMutation", "sync.tx.listCollections", "sync.tx.listMutations", "sync.tx.putCollection", "sync.tx.putMutation", "sync.tx.setInstallationId", "sync.socket.close", "sync.socket.open", "sync.socket.sendChunk"];
+export type AbsoluteExpoBridgeMethod = (typeof ABSOLUTE_EXPO_BRIDGE_METHODS)[number];
+export type AbsoluteExpoBridgeRequest = {
+    format: typeof ABSOLUTE_EXPO_BRIDGE_FORMAT;
+    id: string;
+    kind: 'request';
+    method: AbsoluteExpoBridgeMethod;
+    params: Record<string, unknown>;
+    path: string;
+};
+export type AbsoluteExpoBridgeResponse = {
+    format: typeof ABSOLUTE_EXPO_BRIDGE_FORMAT;
+    id: string;
+    kind: 'response';
+    result?: unknown;
+    error?: {
+        code: string;
+        message: string;
+    };
+};
+export type AbsoluteExpoBridgeEvent = {
+    format: typeof ABSOLUTE_EXPO_BRIDGE_FORMAT;
+    kind: 'event';
+    event: 'ready' | 'navigation' | 'auth.principal' | 'sync.socket' | 'sync.wake';
+    path: string;
+    payload?: Record<string, unknown>;
+};
+export type AbsoluteExpoBridgeMessage = AbsoluteExpoBridgeEvent | AbsoluteExpoBridgeRequest | AbsoluteExpoBridgeResponse;
+export declare const createAbsoluteExpoBridgeError: (id: string, code: string, message: string) => {
+    error: {
+        code: string;
+        message: string;
+    };
+    format: 3;
+    id: string;
+    kind: "response";
+    result?: undefined;
+} | {
+    format: 3;
+    id: string;
+    kind: "response";
+    result: unknown;
+    error?: undefined;
+};
+export declare const createAbsoluteExpoBridgeResponse: (id: string, result: unknown) => {
+    error: {
+        code: string;
+        message: string;
+    };
+    format: 3;
+    id: string;
+    kind: "response";
+    result?: undefined;
+} | {
+    format: 3;
+    id: string;
+    kind: "response";
+    result: unknown;
+    error?: undefined;
+};
+export declare const parseAbsoluteExpoBridgeMessage: (source: string) => {
+    format: 3;
+    id: string;
+    kind: "request";
+    method: "devices.platform.getInfo" | "devices.lifecycle.getState" | "devices.links.getLaunchUrl" | "devices.links.openExternal" | "devices.network.getStatus" | "devices.storage.clear" | "devices.storage.get" | "devices.storage.keys" | "devices.storage.remove" | "devices.storage.set" | "devices.back.capability" | "devices.clipboard.capability" | "devices.clipboard.readText" | "devices.clipboard.writeText" | "devices.share.capability" | "devices.share.share" | "devices.haptics.capability" | "devices.haptics.impact" | "devices.haptics.notification" | "devices.haptics.selectionChanged" | "devices.haptics.vibrate" | "devices.keyboard.capability" | "devices.keyboard.dismiss" | "devices.keyboard.getState" | "devices.systemBars.capability" | "devices.systemBars.setAppearance" | "devices.systemBars.setVisible" | "devices.camera.capability" | "devices.camera.queryPermission" | "devices.camera.requestPermission" | "devices.camera.takePhoto" | "devices.photos.capability" | "devices.photos.pick" | "devices.location.capability" | "devices.location.current" | "devices.location.queryPermission" | "devices.location.requestPermission" | "devices.location.watch.start" | "devices.location.watch.stop" | "devices.localNotifications.capability" | "devices.localNotifications.queryPermission" | "devices.localNotifications.requestPermission" | "devices.localNotifications.schedule" | "devices.localNotifications.pending" | "devices.localNotifications.cancel" | "devices.pushNotifications.capability" | "devices.pushNotifications.queryPermission" | "devices.pushNotifications.requestPermission" | "devices.pushNotifications.enable" | "devices.pushNotifications.disable" | "devices.documents.capability" | "devices.documents.pick" | "devices.transfer.read" | "devices.transfer.close" | "devices.upload.begin" | "devices.upload.write" | "devices.documents.export" | "devices.documents.open" | "http.fetch" | "auth.signIn" | "auth.signOut" | "auth.status" | "sync.store.begin" | "sync.store.deleteNamespace" | "sync.store.end" | "sync.store.schema" | "sync.tx.deleteCollection" | "sync.tx.deleteMutation" | "sync.tx.getCollection" | "sync.tx.getInstallationId" | "sync.tx.getMutation" | "sync.tx.listCollections" | "sync.tx.listMutations" | "sync.tx.putCollection" | "sync.tx.putMutation" | "sync.tx.setInstallationId" | "sync.socket.close" | "sync.socket.open" | "sync.socket.sendChunk";
+    params: Record<string, unknown>;
+    path: string;
+} | {
+    error: {
+        code: string;
+        message: string;
+    };
+    format: 3;
+    id: string;
+    kind: "response";
+    result?: undefined;
+} | {
+    format: 3;
+    id: string;
+    kind: "response";
+    result: unknown;
+    error?: undefined;
+} | {
+    payload?: Record<string, unknown> | undefined;
+    event: string;
+    format: 3;
+    kind: "event";
+    path: string;
+};

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

@@ -0,0 +1,56 @@
+import { spawn } from 'node:child_process';
+import type { NormalizedAbsoluteMobileConfig } from './config';
+import { startAbsoluteIosCaEnrollmentServer } from './iosPhysicalDeviceTransport';
+export type AbsoluteExpoDevPlatform = 'android' | 'ios';
+export type AbsoluteExpoDevState = 'building-android' | 'building-ios' | 'closed' | 'enrolling-trust' | 'failed' | 'preparing-native' | 'ready' | 'starting-metro';
+export type AbsoluteExpoDevCommand = {
+    args: string[];
+    env: Record<string, string>;
+    platform?: AbsoluteExpoDevPlatform;
+    role: 'metro' | 'native-build' | 'native-prepare';
+};
+export type AbsoluteExpoDevPlan = {
+    commands: AbsoluteExpoDevCommand[];
+    metroPort: number;
+    project: string;
+};
+export type PlanAbsoluteExpoDevOptions = {
+    androidDevice?: string;
+    androidOrigin?: string;
+    certificateAuthorityPath?: string;
+    iosDevice?: string;
+    iosOrigin?: string;
+    metroHost?: string;
+    metroPort: number;
+    /** The caller owns Metro, for example through a Remote Mac tunnel. */
+    metro?: 'external' | 'managed';
+    platforms: AbsoluteExpoDevPlatform[];
+};
+export type AbsoluteExpoDevPhaseTiming = {
+    durationMs: number;
+    phase: AbsoluteExpoDevState;
+};
+export type StartAbsoluteExpoDevOptions = PlanAbsoluteExpoDevOptions & {
+    config: NormalizedAbsoluteMobileConfig;
+    executable?: string;
+    log?: (message: string) => void;
+    onPhaseTiming?: (timing: AbsoluteExpoDevPhaseTiming) => void;
+    onStateChange?: (state: AbsoluteExpoDevState) => void;
+    signal?: AbortSignal;
+    spawnProcess?: typeof spawn;
+    startCaEnrollmentServer?: typeof startAbsoluteIosCaEnrollmentServer;
+};
+export type AbsoluteExpoDevSession = {
+    close: () => Promise<void>;
+    metroPort: number;
+    platforms: AbsoluteExpoDevPlatform[];
+    timings: Partial<Record<AbsoluteExpoDevState, number>>;
+};
+export declare const absoluteExpoExecutable: (project: string) => Promise<string>;
+export declare const planAbsoluteExpoDevSession: (config: NormalizedAbsoluteMobileConfig, options: PlanAbsoluteExpoDevOptions) => AbsoluteExpoDevPlan;
+export declare const startAbsoluteExpoDevSession: (options: StartAbsoluteExpoDevOptions) => Promise<{
+    metroPort: number;
+    platforms: AbsoluteExpoDevPlatform[];
+    timings: Partial<Record<AbsoluteExpoDevState, number>>;
+    close: () => Promise<void>;
+}>;

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

@@ -0,0 +1,16 @@
+import type { NormalizedAbsoluteMobileConfig } from './config';
+export type WriteAbsoluteExpoProjectOptions = {
+    force?: boolean;
+    projectRoot: string;
+};
+export declare const writeAbsoluteExpoProject: (config: NormalizedAbsoluteMobileConfig, options: WriteAbsoluteExpoProjectOptions) => Promise<{
+    changed: number;
+    path: string;
+    written: string[];
+}>;
+export declare const syncAbsoluteExpoWebAssets: (config: NormalizedAbsoluteMobileConfig) => Promise<{
+    appBuild: string;
+    assets: number;
+    bundleId: string;
+    path: string;
+}>;

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

@@ -1,26 +1,49 @@
 export * from './artifactStore';
+export * from './adaptiveShell';
 export * from './androidRelease';
+export * from './androidUpgradeConformance';
 export * from './iosRelease';
 export * from './iosConformance';
 export * from './iosSimulatorController';
+export * from './iosPhysicalDeviceTransport';
 export * from './iosNativeWatcher';
 export * from './remoteMacProtocol';
+export * from './iosDeviceAcceptance';
 export * from './associationFiles';
 export * from './buildMetadata';
 export * from './buildPipeline';
 export * from './buildRelease';
 export * from './capacitorBundle';
+export * from './syncSchema';
+export * from './syncRemediation';
+export * from './deviceCapabilities';
+export * from './expoBridge';
+export * from './expoDevController';
+export * from './expoProject';
 export * from './capacitorProject';
 export * from './config';
 export * from './client';
+export * from './ciWorkflow';
 export * from './compatibilityDispatcher';
 export * from './materializedBundle';
+export * from './mobilePreview';
 export * from './nativeDeepLinks';
+export * from './nativeDeviceCapabilities';
 export * from './nativeAuth';
+export * from './nativeRoute';
+export * from './nativeUpdates';
 export * from './pageProtocol';
 export * from './producerContext';
 export * from './releaseArtifact';
 export * from './releasePublisher';
 export * from './routeMetadataTransform';
 export * from './routeMatcher';
+export * from './shellHttp';
 export * from './transport';
+export * from './uiPrimitives';
+export * from './updateClient';
+export * from './updateProtocol';
+export * from './updatePublisher';
+export * from './updateRuntime';
+export * from './updateRollout';
+export * from './updateSigning';

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

@@ -0,0 +1,32 @@
+export type AbsoluteIosDeviceAcceptanceResult = {
+    hmrConnected: true;
+    installed: true;
+    relaunchMs: number;
+};
+type CommandResult = {
+    exitCode: number;
+    stderr: string;
+    stdout: string;
+};
+export declare const absoluteIosDeviceAcceptanceCommands: (options: {
+    appId: string;
+    device: string;
+    xcrun?: string;
+}) => {
+    apps: string[];
+    details: string[];
+    launch: string[];
+};
+/**
+ * Validate and relaunch a physical iOS app without retaining device inventory,
+ * signing output, or console output in the acceptance result.
+ */
+export declare const testAbsoluteIosPhysicalDevice: (options: {
+    appId: string;
+    capture: (command: string[]) => Promise<CommandResult>;
+    device: string;
+    now?: () => number;
+    waitForHmr: () => Promise<void>;
+    xcrun?: string;
+}) => Promise<AbsoluteIosDeviceAcceptanceResult>;
+export {};

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

@@ -0,0 +1,16 @@
+export type AbsoluteIosCloseableServer = {
+    close: () => Promise<void>;
+};
+export type AbsoluteIosCaEnrollmentServer = AbsoluteIosCloseableServer & {
+    url: string;
+};
+export declare const normalizeAbsoluteIosDeviceHost: (value: string) => string;
+export declare const normalizeAbsoluteIosDeviceIdentifier: (value: string) => string;
+export declare const startAbsoluteIosCaEnrollmentServer: (options: {
+    certificateAuthorityPath: string;
+    displayHost: string;
+}) => Promise<AbsoluteIosCaEnrollmentServer>;
+export declare const startAbsoluteIosTcpRelay: (options: {
+    listenPort: number;
+    targetPort: number;
+}) => Promise<AbsoluteIosCloseableServer>;

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

@@ -7,7 +7,7 @@ export type AbsoluteIosReleaseMetadata = {
     artifact: 'App.ipa';
     buildNumber?: number;
     bytes: number;
-    engine: 'capacitor';
+    engine: 'capacitor' | 'expo';
     format: typeof ABSOLUTE_IOS_RELEASE_FORMAT;
     marketingVersion: string;
     platform: 'ios';
@@ -30,14 +30,54 @@ export type BuildAbsoluteIosReleaseOptions = {
     allowUnsigned?: boolean;
     capture?: (command: string[], options?: CommandOptions) => CommandResult;
     config: NormalizedAbsoluteMobileConfig;
+    developmentTeam?: string;
+    env?: Record<string, string | undefined>;
     host?: AbsoluteMobileHost;
     outputDirectory?: string;
     prepareBuildNumber?: (buildIdentity: string) => Promise<number>;
     projectRoot: string;
     run?: (command: string[], options?: CommandOptions) => Promise<number>;
     buildNumber?: number;
+    scheme?: string;
+    workspacePath?: string;
+};
+type InstallAbsoluteIosReleaseOptions = {
+    artifactPath: string;
+    metadata: unknown;
+    outputDirectory?: string;
+    projectRoot: string;
 };
-export declare const fingerprintAbsoluteIosNativeProject: (nativeDirectory: string) => Promise<string>;
+export declare const fingerprintAbsoluteIosNativeProject: (nativeDirectory: string, options?: {
+    includePublicBundle?: boolean;
+}) => Promise<string>;
+export declare const resolveAbsoluteIosXcodeProject: (nativeDirectory: string, options?: {
+    scheme?: string;
+    workspacePath?: string;
+}) => Promise<{
+    scheme: string;
+    workspacePath: string;
+}>;
+export declare const requireAbsoluteIosReleaseMetadata: (value: unknown) => {
+    bytes: number;
+    engine: "capacitor" | "expo";
+    format: 1;
+    marketingVersion: string;
+    platform: "ios";
+    releaseId: string;
+    runtime: string;
+    sha256: string;
+    signed: boolean;
+    type: "ipa";
+    buildNumber?: number | undefined;
+    appBuild: string;
+    appId: string;
+    artifact: "App.ipa";
+};
+/** Import an IPA produced by a trusted AbsoluteJS build host.
+ *
+ * The artifact is hashed and sized locally before it enters the immutable
+ * release store. Remote metadata is never trusted as proof of its contents.
+ */
 export declare const buildAbsoluteIosRelease: (options: BuildAbsoluteIosReleaseOptions) => Promise<{
     artifactPath: string;
     metadata: {
@@ -52,7 +92,27 @@ export declare const buildAbsoluteIosRelease: (options: BuildAbsoluteIosReleaseO
         appId: string;
         platform: "ios";
         buildNumber?: number | undefined;
-        engine: "capacitor";
+        engine: "capacitor" | "expo";
+        marketingVersion: string;
+        signed: boolean;
+    };
+    releaseRoot: string;
+}>;
+export declare const installAbsoluteIosRelease: (options: InstallAbsoluteIosReleaseOptions) => Promise<{
+    artifactPath: string;
+    metadata: {
+        artifact: "App.ipa";
+        sha256: string;
+        type: "ipa";
+        format: typeof ABSOLUTE_IOS_RELEASE_FORMAT;
+        bytes: number;
+        runtime: string;
+        releaseId: string;
+        appBuild: string;
+        appId: string;
+        platform: "ios";
+        buildNumber?: number | undefined;
+        engine: "capacitor" | "expo";
         marketingVersion: string;
         signed: boolean;
     };

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

@@ -1,4 +1,5 @@
 import type { NormalizedAbsoluteMobileConfig } from './config';
+import { type AbsoluteIosCaEnrollmentServer } from './iosPhysicalDeviceTransport';
 export declare const ABSOLUTE_IOS_SIMULATOR_NAME = "AbsoluteJS iPhone";
 export type AbsoluteIosCommandOptions = {
     cwd?: string;
@@ -10,7 +11,7 @@ export type AbsoluteIosCommandResult = {
     stderr: string;
     stdout: string;
 };
-export type AbsoluteIosDevState = 'booting' | 'building' | 'checking-native' | 'closed' | 'closing' | 'configuring' | 'connecting' | 'failed' | 'installing' | 'launching' | 'ready' | 'streaming-logs' | 'syncing';
+export type AbsoluteIosDevState = 'booting' | 'building' | 'checking-native' | 'closed' | 'closing' | 'configuring' | 'connecting' | 'enrolling-trust' | 'failed' | 'installing' | 'launching' | 'ready' | 'streaming-logs' | 'syncing';
 export type AbsoluteIosNativeLogEntry = {
     level: 'debug' | 'error' | 'fault' | 'info' | 'notice';
     message: string;
@@ -35,6 +36,7 @@ export type AbsoluteIosDevSession = {
     screenshot: (destination: string) => Promise<string>;
     startedSimulator: boolean;
     state: AbsoluteIosDevState;
+    targetKind: 'device' | 'simulator';
     timings: Record<string, number>;
     udid: string;
 };
@@ -47,9 +49,17 @@ export type PrepareAbsoluteIosDevOptions = {
     createNativeProject: boolean;
     projectRoot: string;
     run?: (command: string[], options?: AbsoluteIosCommandOptions) => Promise<number>;
+    target?: 'device' | 'simulator';
 };
 export type StartAbsoluteIosDevOptions = {
+    /** CA certificate installed into this simulator's trusted root store. */
+    certificateAuthorityPath?: string;
     capture?: (command: string[], options?: AbsoluteIosCommandOptions) => AbsoluteIosCommandResult;
+    /** Xcode device identifier or name. Omit to use the managed Simulator. */
+    deviceIdentifier?: string;
+    /** Launch the locally embedded production web bundle. `port` remains the
+     * configured backend port and no temporary development URL is projected. */
+    embeddedBundle?: boolean;
     https?: boolean;
     log?: (message: string) => void;
     nativeLog?: (entry: AbsoluteIosNativeLogEntry) => void;
@@ -58,10 +68,16 @@ export type StartAbsoluteIosDevOptions = {
     port: number;
     project: AbsoluteIosDevProject;
     run?: (command: string[], options?: AbsoluteIosCommandOptions) => Promise<number>;
+    /** Hostname or LAN address embedded into a physical-device dev URL. */
+    serverHost?: string;
     signal?: AbortSignal;
     sleep?: (milliseconds: number) => Promise<void>;
     spawn?: (command: string[], options?: AbsoluteIosCommandOptions) => void;
     startNativeLogs?: (command: string[], options: AbsoluteIosCommandOptions, onLine: (line: string) => void) => AbsoluteIosLogStream;
+    startCaEnrollmentServer?: (options: {
+        certificateAuthorityPath: string;
+        displayHost: string;
+    }) => Promise<AbsoluteIosCaEnrollmentServer>;
 };
 export declare const parseIosDeviceTypes: (source: string) => {
     identifier: string;
@@ -81,7 +97,9 @@ export declare const parseIosSimulators: (source: string) => {
     udid: string;
 }[];
 export declare const repairAbsoluteIosDevSession: (projectRoot: string) => Promise<boolean>;
-export declare const fingerprintAbsoluteIosDevProject: (project: Pick<AbsoluteIosDevProject, "nativeDirectory">) => Promise<string>;
+export declare const fingerprintAbsoluteIosDevProject: (project: Pick<AbsoluteIosDevProject, "nativeDirectory">, options?: {
+    includePublicBundle?: boolean;
+}) => Promise<string>;
 export declare const parseAbsoluteIosLogLine: (line: string) => AbsoluteIosNativeLogEntry | null;
 export declare const redactAbsoluteIosLog: (value: string) => string;
 export declare const prepareAbsoluteIosDevProject: (config: NormalizedAbsoluteMobileConfig, options: PrepareAbsoluteIosDevOptions) => Promise<AbsoluteIosDevProject>;