@absolutejs/deploy 0.22.0 → 0.23.0

package/README.md

@@ -48,6 +48,37 @@ both publication and promotion for intentionally non-publishable local-testing
 artifacts. The registry uses the structural BlobStore shape, so Deploy does not
 take a runtime dependency on `@absolutejs/blob` or a cloud SDK.
 
+### Google Play distribution (0.23.0)
+
+`@absolutejs/deploy/google-play` composes the native registry with Google Play.
+The same BlobStore persists stage receipts before external effects, allowing a
+retry to reuse an unexpired edit or resumable upload and to reconcile a commit
+whose successful response was lost.
+
+```ts
+import { createGooglePlayReleasePublisher } from '@absolutejs/deploy/google-play';
+
+export default createGooglePlayReleasePublisher({
+  receiptStore: store,
+  registry: releases
+});
+```
+
+AbsoluteJS supplies the requested track and rollout intent when the developer
+runs `absolute mobile publish android --play-track internal`. Google
+Application Default Credentials must have Android Publisher access to the app.
+Before Gradle runs, the publisher inspects Play's existing bundles and returns
+the next version code. It persists that allocation by application and complete
+build identity, so retries and promotion to another track reuse the same code.
+AbsoluteJS injects it into the AAB and the publisher verifies the upload response
+returned that exact code. Serialize publication jobs for one application because
+Google Play provides monotonic version codes but no reservation operation.
+The default commit behavior is `ERROR_IF_IN_REVIEW`; opting into cancellation
+of an existing review must therefore be explicit. Production staged rollouts
+use `status: 'inProgress'` with `0 < userFraction < 1`; subsequent calls for the
+same release can increase the fraction, halt or resume it, or mark it completed
+without uploading the AAB again.
+
 ## Infrastructure providers (0.14.0)
 
 Control planes use the normalized `InfrastructureProvider` contract from

package/dist/googlePlay.d.ts

@@ -0,0 +1,172 @@
+import type { NativeReleaseBlobStore, NativeReleasePublication, NativeReleaseRegistry } from "./nativeRelease";
+declare const RECEIPT_FORMAT: 1;
+export type GooglePlayReleaseStatus = "completed" | "draft" | "halted" | "inProgress";
+export type GooglePlayReviewBehavior = "CANCEL_IN_REVIEW_AND_SUBMIT" | "ERROR_IF_IN_REVIEW";
+export type GooglePlayReleaseTarget = {
+    changesNotSentForReview?: boolean;
+    inAppUpdatePriority?: number;
+    name?: string;
+    releaseNotes?: readonly {
+        language: string;
+        text: string;
+    }[];
+    reviewBehavior?: GooglePlayReviewBehavior;
+    status?: GooglePlayReleaseStatus;
+    track: string;
+    userFraction?: number;
+};
+export type GooglePlayReleaseIntent = {
+    changesNotSentForReview: boolean;
+    inAppUpdatePriority: number;
+    name?: string;
+    releaseNotes: Array<{
+        language: string;
+        text: string;
+    }>;
+    reviewBehavior: GooglePlayReviewBehavior;
+    status: GooglePlayReleaseStatus;
+    track: string;
+    userFraction?: number;
+};
+export type GooglePlayReleaseReceipt = {
+    editExpiresAt?: string;
+    editId?: string;
+    format: typeof RECEIPT_FORMAT;
+    intent: GooglePlayReleaseIntent;
+    packageName: string;
+    provider: "google-play";
+    releaseId: string;
+    sha256: string;
+    stage: "committed" | "editing" | "uploading" | "commit-pending";
+    updatedAt: string;
+    uploadSession?: string;
+    versionCode?: string;
+};
+export type GooglePlayBundle = {
+    sha1?: string;
+    sha256?: string;
+    versionCode: number;
+};
+export type GooglePlayTrackRelease = {
+    inAppUpdatePriority?: number;
+    name?: string;
+    releaseNotes?: Array<{
+        language: string;
+        text: string;
+    }>;
+    status?: GooglePlayReleaseStatus;
+    userFraction?: number;
+    versionCodes?: string[];
+};
+export type GooglePlayTrack = {
+    releases?: GooglePlayTrackRelease[];
+    track?: string;
+};
+export type GooglePlayEdit = {
+    expiryTimeSeconds?: string;
+    id: string;
+};
+export type GooglePlayClient = {
+    commitEdit: (options: {
+        changesNotSentForReview: boolean;
+        editId: string;
+        packageName: string;
+        reviewBehavior: GooglePlayReviewBehavior;
+        signal?: AbortSignal;
+    }) => Promise<void>;
+    deleteEdit: (options: {
+        editId: string;
+        packageName: string;
+        signal?: AbortSignal;
+    }) => Promise<void>;
+    getEdit: (options: {
+        editId: string;
+        packageName: string;
+        signal?: AbortSignal;
+    }) => Promise<GooglePlayEdit | null>;
+    getTrack: (options: {
+        editId: string;
+        packageName: string;
+        signal?: AbortSignal;
+        track: string;
+    }) => Promise<GooglePlayTrack>;
+    insertEdit: (options: {
+        packageName: string;
+        signal?: AbortSignal;
+    }) => Promise<GooglePlayEdit>;
+    listBundles: (options: {
+        editId: string;
+        packageName: string;
+        signal?: AbortSignal;
+    }) => Promise<GooglePlayBundle[]>;
+    startBundleUpload: (options: {
+        bytes: number;
+        editId: string;
+        packageName: string;
+        signal?: AbortSignal;
+    }) => Promise<string>;
+    updateTrack: (options: {
+        editId: string;
+        packageName: string;
+        signal?: AbortSignal;
+        track: GooglePlayTrack;
+        trackName: string;
+    }) => Promise<GooglePlayTrack>;
+    uploadBundle: (options: {
+        artifactPath: string;
+        bytes: number;
+        sessionUrl: string;
+        signal?: AbortSignal;
+    }) => Promise<GooglePlayBundle>;
+    validateEdit: (options: {
+        editId: string;
+        packageName: string;
+        signal?: AbortSignal;
+    }) => Promise<void>;
+};
+export type GooglePlayReleasePublisherOptions = {
+    client?: GooglePlayClient;
+    clock?: () => Date;
+    receiptPrefix?: string;
+    receiptStore: NativeReleaseBlobStore;
+    registry: NativeReleaseRegistry;
+    target?: GooglePlayReleaseTarget;
+};
+export type GooglePlayNativeReleasePublication = NativeReleasePublication & {
+    googlePlay?: {
+        receipt: GooglePlayReleaseReceipt;
+        reused: boolean;
+    };
+};
+export type GooglePlayNativeReleasePublisher = {
+    prepareAndroidRelease: (options: {
+        buildIdentity: string;
+        googlePlay?: GooglePlayReleaseTarget;
+        packageName: string;
+        signal?: AbortSignal;
+    }) => Promise<{
+        versionCode?: number;
+    }>;
+    publish: (options: {
+        allowUnsigned?: boolean;
+        channel?: string;
+        googlePlay?: GooglePlayReleaseTarget;
+        releaseRoot: string;
+        signal?: AbortSignal;
+    }) => Promise<GooglePlayNativeReleasePublication>;
+};
+export declare class GooglePlayReleaseError extends Error {
+    readonly status?: number;
+    constructor(message: string, status?: number);
+}
+export type GooglePlayAuth = {
+    getClient: () => Promise<{
+        getRequestHeaders: (url?: string | URL) => Promise<Headers | Record<string, string>>;
+    }>;
+};
+export declare const createGooglePlayClient: (dependencies?: {
+    auth?: GooglePlayAuth;
+    fetch?: typeof fetch;
+}) => GooglePlayClient;
+export declare const createGooglePlayReleasePublisher: (options: GooglePlayReleasePublisherOptions) => GooglePlayNativeReleasePublisher;
+export {};