export interface RemotePackage {
    packageHash: string;
    label: string;
    deploymentKey: string;
    releaseNotes: string | null;
    isMandatory: boolean;
    fullBundleUrl: string | null;
    patchUrl: string | null;
    fullBundleSize: number;
    patchSize: number | null;
    previouslyFailed: boolean;
}
export interface LocalPackage extends RemotePackage {
    installedAt: string;
    source: "patch" | "full_bundle";
}
export interface UpdateCheckBase {
    isStoreUpdateAvailable: boolean;
    latestBinaryVersion: string | null;
}
export type UpdateCheckResult = (UpdateCheckBase & {
    action: "up-to-date";
    remotePackage?: undefined;
}) | (UpdateCheckBase & {
    action: "ota-update";
    remotePackage: RemotePackage;
}) | (UpdateCheckBase & {
    action: "embedded-revert";
    remotePackage?: undefined;
});
export type EmbeddedRevertUpdate = Extract<UpdateCheckResult, {
    action: "embedded-revert";
}>;
export type InstallTarget = LocalPackage | EmbeddedRevertUpdate;
export declare const InstallMode: {
    readonly IMMEDIATE: "IMMEDIATE";
    readonly ON_NEXT_RESTART: "ON_NEXT_RESTART";
    readonly ON_NEXT_RESUME: "ON_NEXT_RESUME";
    readonly ON_NEXT_SUSPEND: "ON_NEXT_SUSPEND";
};
export type InstallMode = (typeof InstallMode)[keyof typeof InstallMode];
export declare const CheckFrequency: {
    readonly ON_APP_START: "ON_APP_START";
    readonly ON_APP_RESUME: "ON_APP_RESUME";
};
export type CheckFrequency = (typeof CheckFrequency)[keyof typeof CheckFrequency];
export interface WrapOptions extends SyncOptions {
    /** Check after mount, and optionally on foreground return. Defaults to ON_APP_START. */
    checkFrequency?: CheckFrequency;
}
export interface SyncOptions {
    installMode?: InstallMode;
    mandatoryInstallMode?: InstallMode;
    /** Minimum background duration in milliseconds for ON_NEXT_RESUME and ON_NEXT_SUSPEND. */
    minimumBackgroundDuration?: number;
}
export interface InstallOptions {
    installMode?: InstallMode;
    /** Minimum background duration in milliseconds for ON_NEXT_RESUME and ON_NEXT_SUSPEND. */
    minimumBackgroundDuration?: number;
}
export type SyncStatus = "idle" | "checking" | "downloading" | "installing" | "up-to-date" | "update-installed" | "embedded-revert-applied" | "sync-in-progress" | "error";
/**
 * Identity of the OTA package whose JS bundle is executing in this process.
 * Returned by `getRunningBundleUpdateMetadata()`; callers receive `null`
 * instead when the embedded binary bundle is running.
 */
export interface RunningBundleUpdateMetadata {
    /** Release label of the running OTA package as published by the server (e.g. "v3"). */
    label: string;
    /** Package hash of the running OTA package. */
    packageHash: string;
    /** Release notes captured at install time; `null` when the release was published without notes. */
    releaseNotes: string | null;
}
export interface UpdateMetadata {
    packageHash: string;
    /**
     * Binary version this package was installed under. `null` when the host
     * app's binary version has not yet been observed (no successful
     * `fetchManifest()` round-trip).
     */
    binaryVersion: string | null;
    deploymentKey: string;
    label: string;
    isMandatory: boolean;
    releaseNotes: string | null;
    installedAt: string;
    /** Artifact type persisted in packages/{hash}/update.json. */
    source: "patch" | "full_bundle";
    isFirstRun: boolean;
}
export interface DownloadProgress {
    totalBytes: number;
    receivedBytes: number;
}
export declare const CodemagicPatchErrorCode: {
    readonly NETWORK_ERROR: "NETWORK_ERROR";
    readonly INVALID_MANIFEST: "INVALID_MANIFEST";
    readonly SIGNATURE_MISMATCH: "SIGNATURE_MISMATCH";
    readonly INTEGRITY_ERROR: "INTEGRITY_ERROR";
    readonly DOWNLOAD_IN_PROGRESS: "DOWNLOAD_IN_PROGRESS";
    readonly SYNC_IN_PROGRESS: "SYNC_IN_PROGRESS";
    readonly NOT_DOWNLOADED: "NOT_DOWNLOADED";
    readonly INVALID_UPDATE_TARGET: "INVALID_UPDATE_TARGET";
};
export type CodemagicPatchErrorCodeType = (typeof CodemagicPatchErrorCode)[keyof typeof CodemagicPatchErrorCode];
export declare class CodemagicPatchError extends Error {
    readonly code: CodemagicPatchErrorCodeType;
    constructor(code: CodemagicPatchErrorCodeType, message: string);
}
export interface PreviousPackageInfo {
    release_label: string;
    package_hash: string;
    patch_url?: string;
    patch_size?: number;
    full_bundle_url: string;
    full_bundle_size: number;
    is_mandatory: boolean;
    release_notes?: string;
    rollout_percentage: number;
    signature?: string;
}
export interface ManifestResponse {
    target_package_hash: string | null;
    release_label?: string;
    patch_url?: string;
    patch_size?: number;
    full_bundle_url?: string;
    full_bundle_size?: number;
    is_mandatory?: boolean;
    release_notes?: string;
    rollout_percentage?: number;
    signature?: string;
    previous_package_info?: PreviousPackageInfo;
}
export interface MetaResponse {
    latest_binary_version: string;
}
export type MetricsEventName = "Downloaded" | "Ready" | "Applied" | "Failed" | "Active";
export interface EventEnvelope {
    event_id: string;
    event_name: MetricsEventName;
    emitted_at: string;
    device_id: string;
    deployment_key: string;
    binary_version: string | null;
    running_package_hash: string | null;
    target_package_hash: string | null;
    platform: string;
    attributes: Record<string, string>;
}
export interface RuntimeRemotePackage extends Omit<RemotePackage, "previouslyFailed"> {
    signature: string | null;
}
export interface RuntimePackage extends LocalPackage {
    binaryVersion: string | null;
    signatureVerified: boolean;
    successReportedAt: string | null;
    lastActiveReportedAt: string | null;
}
export interface FailedInstallState {
    packageHash: string;
    reason: string;
}
/**
 * Detail attached to a `Failed` event, serialized into `attributes.payload` as
 * a JSON string. One shape for every reason — PROTOCOL.md §Metric Event
 * `Failed` Payload is the contract.
 *
 * Mirrors `shared/src/failurePayload.ts`, which server and dashboard import.
 * The SDK ships as a standalone npm package with no workspace dependency, so
 * it cannot import that module; both answer to PROTOCOL.md, and a change to
 * one belongs in the other.
 */
export interface MetricsFailurePayload {
    /**
     * The failure's machine-readable discriminator, and the key every
     * server-side and dashboard breakdown groups on. For `network` this is the
     * HTTP status of the failed response as a decimal string, or `"0"` when no
     * response was received.
     */
    code?: string;
    /**
     * Failure text relayed from whatever reported it. Never composed by the SDK;
     * omitted when nothing could be relayed.
     */
    message?: string;
    /**
     * Android `ApplicationExitInfo` reason for the previous process. Android
     * API 30+ only — absent on iOS and older Android.
     */
    android_previous_process_exit?: string;
}
export interface MetricsEvent {
    name: string;
    packageHash?: string;
    deliveryType?: "patch" | "full_bundle";
    deploymentKey?: string;
    binaryVersion?: string | null;
    runningPackageHash?: string | null;
    status?: string;
    reason?: string;
    failureSubtype?: string;
    payload?: MetricsFailurePayload;
    at: string;
}
export interface RuntimeState {
    /**
     * Host app binary version reported by native `fetchManifest()` context.
     * `null` until the first successful manifest fetch (or when native could
     * not determine the binary version for the current process).
     */
    binaryVersion: string | null;
    deploymentKey: string;
    deviceId: string;
    /**
     * Why the previous process ended (Android 11+; null elsewhere). Read once at
     * hydration from the native boot snapshot and carried on every `Failed`
     * payload.
     */
    androidPreviousProcessExit: string | null;
    remotePackage: RuntimeRemotePackage | null;
    latestBinaryVersion: string | null;
    storeUpdateAvailable: boolean;
    /**
     * Package currently executing in this process. Decided at hydration from
     * `bootSource` and held immutable for the rest of the process lifetime —
     * activations only ever reassign this once at the moment a pending package
     * takes effect. May alias `pendingPackage` (pre-notify) or `confirmedPackage`
     * (post-notify / steady state). `null` when the embedded bundle is active.
     */
    runningPackage: RuntimePackage | null;
    /**
     * Last package confirmed via `notifyAppReady()`. Mirrors `state.json.current`.
     */
    confirmedPackage: RuntimePackage | null;
    previousPackage: RuntimePackage | null;
    pendingPackage: RuntimePackage | null;
    pendingEmbeddedRevert: boolean;
    pendingInstallMode: InstallMode | null;
    pendingMinimumBackgroundDuration: number;
    lastBackgroundedAtMs: number | null;
    suspendActivationTimer: ReturnType<typeof setTimeout> | null;
    blockedActivation: boolean;
    failedInstall: FailedInstallState | null;
    downloadedPackages: Map<string, RuntimeRemotePackage>;
    lastUpdateCheckResult: UpdateCheckResult | null;
    hydrated: boolean;
    hydrationPromise: Promise<void> | null;
    /**
     * In-flight `notifyAppReady()` run. Concurrent callers (direct and via
     * `sync()`) await this same promise so Applied / Active are emitted once.
     */
    appReadyPromise: Promise<void> | null;
    publicKeyConfigured: boolean;
    syncInProgress: boolean;
    downloadInProgress: boolean;
    restartSuppressed: boolean;
    lastSyncStatus: SyncStatus;
    lastSyncError: string | null;
    clockMs: number | null;
    events: MetricsEvent[];
    bridgeReloadCount: number;
    /**
     * Last observed AppState ("active" / "background" / "inactive" / …). Lives
     * inside `RuntimeState` so the test reset path can clear it via the same
     * `Object.assign(state, createInitialRuntimeState())` without needing a
     * dedicated test-only helper.
     */
    lastAppState: string;
}
export type BootSource = "embedded" | "current" | "pending";
export declare const CODEMAGIC_PATCH_ROOT = "codemagic-patch";
export declare const PACKAGES_DIR = "codemagic-patch/packages";
export declare const STATE_DIR = "codemagic-patch/state";
export declare const DOWNLOADS_DIR = "codemagic-patch/downloads";
export declare const TMP_DIR = "codemagic-patch/tmp";
export declare const EVENTS_DIR = "codemagic-patch/events";
//# sourceMappingURL=types.d.ts.map