kappmaker 1.1.0 → 1.2.0

package/dist/services/gpc-monetization.service.js

@@ -0,0 +1,244 @@
+import { logger } from '../utils/logger.js';
+import { apiRequest } from './gpc.service.js';
+/**
+ * Convert a human-readable price like "6.99" into the Google Play money
+ * representation: { currencyCode, units, nanos }. Nanos are billionths,
+ * so "6.99" becomes { units: "6", nanos: 990000000 }.
+ */
+export function priceToMoney(price, currencyCode) {
+    const [wholeRaw, fractionRaw = ''] = price.trim().split('.');
+    const whole = wholeRaw.replace(/^-/, '') || '0';
+    // Pad or truncate fractional part to 9 digits (nanos)
+    const fractionPadded = (fractionRaw + '000000000').slice(0, 9);
+    const nanos = Number(fractionPadded) || 0;
+    return {
+        currencyCode,
+        units: whole,
+        nanos: price.startsWith('-') ? -nanos : nanos,
+    };
+}
+function buildRegionalConfigs(prices) {
+    const out = {};
+    for (const p of prices) {
+        out[p.region_code] = {
+            newSubscriberAvailability: true,
+            price: priceToMoney(p.price, p.currency_code),
+        };
+    }
+    return out;
+}
+export async function listSubscriptions(packageName) {
+    const result = await apiRequest({
+        method: 'GET',
+        path: `/applications/${encodeURIComponent(packageName)}/subscriptions`,
+        label: 'Looking up existing subscriptions',
+        allowFailure: true,
+    });
+    if (!result.ok || !result.data?.subscriptions)
+        return new Set();
+    return new Set(result.data.subscriptions.map((s) => s.productId));
+}
+export async function setupSubscriptions(packageName, subscriptions, playDefaultLanguage) {
+    if (subscriptions.length === 0) {
+        logger.info('No subscriptions configured, skipping.');
+        return;
+    }
+    const existing = await listSubscriptions(packageName);
+    for (const sub of subscriptions) {
+        if (existing.has(sub.product_id)) {
+            logger.info(`Subscription "${sub.product_id}" already exists, skipping create.`);
+            // Still (best-effort) try to activate any base plans that aren't active.
+            for (const basePlan of sub.base_plans) {
+                await activateBasePlan(packageName, sub.product_id, basePlan.base_plan_id);
+            }
+            continue;
+        }
+        await createSubscriptionWithBasePlans(packageName, sub, playDefaultLanguage);
+    }
+}
+// Google Play's new monetization API ties pricing regions to a "regionsVersion"
+// — bump this constant if Google publishes a newer region catalog.
+const REGIONS_VERSION = '2022/02';
+async function createSubscriptionWithBasePlans(packageName, sub, playDefaultLanguage) {
+    // Play rejects subscriptions that don't have a listing in the app's current
+    // default language. If the config's listings don't cover it, clone the first
+    // entry with the Play default language tacked on.
+    const listings = [...sub.listings];
+    const hasDefault = listings.some((l) => l.locale === playDefaultLanguage);
+    if (!hasDefault && listings.length > 0) {
+        const first = listings[0];
+        listings.unshift({
+            locale: playDefaultLanguage,
+            title: first.title,
+            description: first.description,
+            benefits: first.benefits,
+        });
+        logger.info(`Cloned "${first.locale}" listing to "${playDefaultLanguage}" (Play default language).`);
+    }
+    // Create subscription + base plans in a single call. The new monetization API
+    // requires productId and regionsVersion.version as QUERY PARAMETERS (not body)
+    // — passing productId in the body triggers "Product ID must be specified".
+    const body = {
+        packageName,
+        productId: sub.product_id,
+        listings: listings.map((l) => ({
+            languageCode: l.locale,
+            title: l.title,
+            description: l.description ?? '',
+            benefits: l.benefits ?? [],
+        })),
+        basePlans: sub.base_plans.map((bp) => buildBasePlanBody(bp)),
+    };
+    const result = await apiRequest({
+        method: 'POST',
+        path: `/applications/${encodeURIComponent(packageName)}/subscriptions`,
+        query: {
+            productId: sub.product_id,
+            'regionsVersion.version': REGIONS_VERSION,
+        },
+        body,
+        label: `Creating subscription: ${sub.product_id}`,
+        allowFailure: true,
+    });
+    if (!result.ok) {
+        logger.warn(`Could not create subscription ${sub.product_id}. Skipping its base plans.`);
+        return;
+    }
+    // 2. Activate each base plan so it's available to buyers
+    for (const basePlan of sub.base_plans) {
+        await activateBasePlan(packageName, sub.product_id, basePlan.base_plan_id);
+    }
+}
+function buildBasePlanBody(basePlan) {
+    const body = {
+        basePlanId: basePlan.base_plan_id,
+        state: 'DRAFT', // activated in a separate call
+        autoRenewingBasePlanType: {
+            billingPeriodDuration: basePlan.billing_period,
+            resubscribeState: 'RESUBSCRIBE_STATE_ACTIVE',
+            ...(basePlan.grace_period ? { gracePeriodDuration: basePlan.grace_period } : {}),
+        },
+        regionalConfigs: Object.entries(buildRegionalConfigs(basePlan.regional_configs)).map(([region, cfg]) => ({
+            regionCode: region,
+            newSubscriberAvailability: cfg.newSubscriberAvailability,
+            price: cfg.price,
+        })),
+    };
+    return body;
+}
+export async function activateBasePlan(packageName, productId, basePlanId) {
+    await apiRequest({
+        method: 'POST',
+        path: `/applications/${encodeURIComponent(packageName)}/subscriptions/${encodeURIComponent(productId)}/basePlans/${encodeURIComponent(basePlanId)}:activate`,
+        body: {},
+        label: `Activating base plan ${productId}/${basePlanId}`,
+        allowFailure: true,
+    });
+}
+export async function listInAppProducts(packageName) {
+    const existing = new Set();
+    let pageToken;
+    do {
+        const result = await apiRequest({
+            method: 'GET',
+            path: `/applications/${encodeURIComponent(packageName)}/oneTimeProducts`,
+            query: pageToken ? { pageToken } : undefined,
+            label: 'Looking up existing one-time products',
+            allowFailure: true,
+        });
+        if (!result.ok)
+            return existing;
+        for (const p of result.data?.oneTimeProducts ?? []) {
+            existing.add(p.productId);
+        }
+        pageToken = result.data?.nextPageToken;
+    } while (pageToken);
+    return existing;
+}
+export async function setupInAppProducts(packageName, products) {
+    if (products.length === 0) {
+        logger.info('No one-time in-app products configured, skipping.');
+        return;
+    }
+    const existing = await listInAppProducts(packageName);
+    for (const product of products) {
+        if (existing.has(product.sku)) {
+            logger.info(`One-time product "${product.sku}" already exists, skipping.`);
+            continue;
+        }
+        await createInAppProduct(packageName, product);
+    }
+}
+async function createInAppProduct(packageName, product) {
+    const listings = product.listings.map((loc) => ({
+        languageCode: loc.locale,
+        title: loc.title,
+        description: loc.description ?? '',
+    }));
+    // Build one purchase option with regional pricing from the config.
+    // We default to a single "default" purchase option covering the base price
+    // and any per-region overrides the user supplied.
+    const allPrices = [product.default_price, ...(product.prices ?? [])];
+    // Dedupe by region — if the user listed the same region twice, last wins.
+    const byRegion = new Map();
+    for (const p of allPrices)
+        byRegion.set(p.region_code, p);
+    const regionalPricingAndAvailabilityConfigs = Array.from(byRegion.values()).map((p) => ({
+        regionCode: p.region_code,
+        price: priceToMoney(p.price, p.currency_code),
+        availability: 'AVAILABLE',
+    }));
+    const body = {
+        packageName,
+        productId: product.sku,
+        listings,
+        purchaseOptions: [
+            {
+                purchaseOptionId: 'default',
+                buyOption: { legacyCompatible: true },
+                regionalPricingAndAvailabilityConfigs,
+            },
+        ],
+    };
+    // Note: patch path is lowercase `onetimeproducts` even though list/get use
+    // camelCase `oneTimeProducts`. Matches Google's v3 discovery document.
+    const result = await apiRequest({
+        method: 'PATCH',
+        path: `/applications/${encodeURIComponent(packageName)}/onetimeproducts/${encodeURIComponent(product.sku)}`,
+        query: {
+            allowMissing: 'true',
+            'regionsVersion.version': REGIONS_VERSION,
+            updateMask: 'listings,purchaseOptions',
+        },
+        body,
+        label: `Creating one-time product: ${product.sku}`,
+        allowFailure: true,
+    });
+    if (!result.ok) {
+        logger.warn(`Could not create one-time product ${product.sku}.`);
+        return;
+    }
+    // New purchase options land in DRAFT state — activate so buyers can see it.
+    await activatePurchaseOption(packageName, product.sku, 'default');
+}
+async function activatePurchaseOption(packageName, productId, purchaseOptionId) {
+    await apiRequest({
+        method: 'POST',
+        path: `/applications/${encodeURIComponent(packageName)}/oneTimeProducts/${encodeURIComponent(productId)}/purchaseOptions:batchUpdateStates`,
+        body: {
+            requests: [
+                {
+                    activatePurchaseOptionRequest: {
+                        packageName,
+                        productId,
+                        purchaseOptionId,
+                        latencyTolerance: 'PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE',
+                    },
+                },
+            ],
+        },
+        label: `Activating purchase option ${productId}/${purchaseOptionId}`,
+        allowFailure: true,
+    });
+}
+//# sourceMappingURL=gpc-monetization.service.js.map

package/dist/services/gpc-monetization.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gpc-monetization.service.js","sourceRoot":"","sources":["../../src/services/gpc-monetization.service.ts"],"names":[],"mappings":"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"}

package/dist/services/gpc.service.d.ts

@@ -0,0 +1,87 @@
+import type { GooglePlayAppDetails, GooglePlayListing } from '../types/googleplay.js';
+export declare const PLAY_CONSOLE_URL = "https://play.google.com/console/u/0/developers";
+export declare function getAccessToken(): Promise<string>;
+export interface ApiRequestOptions {
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    path: string;
+    query?: Record<string, string | undefined>;
+    body?: unknown;
+    /** Swallow non-2xx responses and return null instead of exiting. */
+    allowFailure?: boolean;
+    label?: string;
+}
+export interface ApiResponse<T> {
+    ok: boolean;
+    status: number;
+    data: T | null;
+    error?: string;
+}
+export declare function apiRequest<T = unknown>(options: ApiRequestOptions): Promise<ApiResponse<T>>;
+/**
+ * Probe whether an app exists on Play Console WITHOUT starting an edit.
+ * Uses GET /subscriptions (the new monetization API) which is read-only and
+ * works on apps that have been migrated to the new publishing API. The older
+ * `/inappproducts` endpoint returns 403 "Please migrate to the new publishing
+ * API" for such apps, so we avoid it here.
+ *
+ * Returns true on 200, false on 404, exits fatal on any other error.
+ */
+export declare function checkAppExists(packageName: string): Promise<boolean>;
+export declare function validateServiceAccount(): Promise<void>;
+export interface AppEdit {
+    id: string;
+    expiryTimeSeconds?: string;
+}
+export declare function insertEdit(packageName: string): Promise<string>;
+export declare function commitEdit(packageName: string, editId: string): Promise<void>;
+export declare function deleteEdit(packageName: string, editId: string): Promise<void>;
+export interface PlayAppDetails {
+    defaultLanguage?: string;
+    contactWebsite?: string;
+    contactEmail?: string;
+    contactPhone?: string;
+}
+/**
+ * Read current app details (default language + contact info) inside an existing
+ * edit. Used to discover the app's actual default language before pushing
+ * subscriptions — Play rejects subscriptions that don't have a listing in that
+ * language, so the caller needs to ensure one exists.
+ */
+export declare function getEditDetails(packageName: string, editId: string): Promise<PlayAppDetails | null>;
+/**
+ * Probe Play Console for the app's current default language via a short-lived
+ * edit (insert → get details → delete). Returns null if the probe fails so
+ * callers can fall back to whatever default they had in their config.
+ */
+export declare function fetchDefaultLanguage(packageName: string): Promise<string | null>;
+export interface PlayAppState {
+    defaultLanguage: string | null;
+    hasUploadedBuild: boolean;
+    tracksWithReleases: string[];
+}
+/**
+ * One-shot probe that starts an edit, reads the details and tracks, and
+ * discards the edit — returns everything the orchestrator needs to know about
+ * the app's current state in a single transaction. Useful for pre-flight
+ * checks before monetization writes.
+ *
+ * Graceful: returns null if the probe fails (no network, restricted service
+ * account, etc.).
+ */
+export declare function fetchAppState(packageName: string): Promise<PlayAppState | null>;
+export declare function withEdit<T>(packageName: string, fn: (editId: string) => Promise<T>): Promise<T>;
+export declare function updateAppDetails(packageName: string, editId: string, defaultLanguage: string, details: GooglePlayAppDetails): Promise<void>;
+export declare function updateListing(packageName: string, editId: string, listing: GooglePlayListing): Promise<void>;
+/**
+ * Upload a Play Console Data Safety declaration. The API does NOT take
+ * structured JSON — it takes a JSON object with a single `safetyLabels` field
+ * whose value is the raw CSV content exported from Play Console:
+ *
+ *   POST /applications/{pkg}/dataSafety
+ *   body: { "safetyLabels": "<csv file contents as string>" }
+ *
+ * The CSV is app-specific (Google generates different question sets based on
+ * the app's category/permissions), so callers must provide the contents of a
+ * real CSV exported from this app's Play Console page.
+ */
+export declare function updateDataSafety(packageName: string, csvContents: string): Promise<void>;

package/dist/services/gpc.service.js

@@ -0,0 +1,338 @@
+import fs from 'fs-extra';
+import path from 'node:path';
+import { createSign } from 'node:crypto';
+import ora from 'ora';
+import { logger } from '../utils/logger.js';
+import { loadConfig } from '../utils/config.js';
+// ── Constants ────────────────────────────────────────────────────────
+const API_BASE = 'https://androidpublisher.googleapis.com/androidpublisher/v3';
+const TOKEN_URL = 'https://oauth2.googleapis.com/token';
+const SCOPE = 'https://www.googleapis.com/auth/androidpublisher';
+export const PLAY_CONSOLE_URL = 'https://play.google.com/console/u/0/developers';
+let cachedToken = null;
+async function loadServiceAccount() {
+    const config = await loadConfig();
+    const resolved = path.resolve(config.googleServiceAccountPath.startsWith('~')
+        ? config.googleServiceAccountPath.replace(/^~/, process.env.HOME ?? '')
+        : config.googleServiceAccountPath);
+    if (!(await fs.pathExists(resolved))) {
+        logger.fatal(`Google service account file not found: ${resolved}`);
+        logger.info('Set it with: kappmaker config set googleServiceAccountPath <path-to-json>');
+        logger.info('Create one at: https://console.cloud.google.com/iam-admin/serviceaccounts');
+        process.exit(1);
+    }
+    const sa = await fs.readJson(resolved);
+    if (!sa.client_email || !sa.private_key) {
+        logger.fatal(`Invalid service account JSON at ${resolved}: missing client_email or private_key`);
+        process.exit(1);
+    }
+    return sa;
+}
+function base64Url(input) {
+    return Buffer.from(input).toString('base64url');
+}
+function buildJwt(sa) {
+    const now = Math.floor(Date.now() / 1000);
+    const header = { alg: 'RS256', typ: 'JWT' };
+    const claim = {
+        iss: sa.client_email,
+        scope: SCOPE,
+        aud: sa.token_uri ?? TOKEN_URL,
+        exp: now + 3600,
+        iat: now,
+    };
+    const unsigned = `${base64Url(JSON.stringify(header))}.${base64Url(JSON.stringify(claim))}`;
+    const signer = createSign('RSA-SHA256');
+    signer.update(unsigned);
+    const signature = signer.sign(sa.private_key).toString('base64url');
+    return `${unsigned}.${signature}`;
+}
+export async function getAccessToken() {
+    if (cachedToken && cachedToken.expiresAt > Date.now() + 60_000) {
+        return cachedToken.token;
+    }
+    const sa = await loadServiceAccount();
+    const jwt = buildJwt(sa);
+    const response = await fetch(TOKEN_URL, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+        body: new URLSearchParams({
+            grant_type: 'urn:ietf:params:oauth:grant-type:jwt-bearer',
+            assertion: jwt,
+        }),
+    });
+    if (!response.ok) {
+        const body = await response.text();
+        logger.fatal(`Failed to obtain Google access token: ${response.status} ${body}`);
+        process.exit(1);
+    }
+    const data = await response.json();
+    cachedToken = {
+        token: data.access_token,
+        expiresAt: Date.now() + data.expires_in * 1000,
+    };
+    return data.access_token;
+}
+export async function apiRequest(options) {
+    const token = await getAccessToken();
+    const label = options.label ?? `${options.method} ${options.path}`;
+    const spinner = ora({ text: label, indent: 4 }).start();
+    const url = new URL(`${API_BASE}${options.path}`);
+    if (options.query) {
+        for (const [k, v] of Object.entries(options.query)) {
+            if (v !== undefined)
+                url.searchParams.set(k, v);
+        }
+    }
+    try {
+        const response = await fetch(url.toString(), {
+            method: options.method,
+            headers: {
+                Authorization: `Bearer ${token}`,
+                ...(options.body !== undefined ? { 'Content-Type': 'application/json' } : {}),
+            },
+            body: options.body !== undefined ? JSON.stringify(options.body) : undefined,
+        });
+        const text = await response.text();
+        let data = null;
+        if (text) {
+            try {
+                data = JSON.parse(text);
+            }
+            catch {
+                data = null;
+            }
+        }
+        if (!response.ok) {
+            spinner.fail(label);
+            const message = data?.error?.message ?? text ?? response.statusText;
+            if (options.allowFailure) {
+                logger.warn(`${label}: ${response.status} ${message}`);
+                return { ok: false, status: response.status, data, error: message };
+            }
+            logger.error(`${label}: ${response.status} ${message}`);
+            process.exit(1);
+        }
+        spinner.succeed(label);
+        return { ok: true, status: response.status, data };
+    }
+    catch (error) {
+        spinner.fail(label);
+        const message = error instanceof Error ? error.message : String(error);
+        if (options.allowFailure) {
+            logger.warn(`${label}: ${message}`);
+            return { ok: false, status: 0, data: null, error: message };
+        }
+        logger.error(message);
+        process.exit(1);
+    }
+}
+// ── App existence probe (side-effect-free) ──────────────────────────
+/**
+ * Probe whether an app exists on Play Console WITHOUT starting an edit.
+ * Uses GET /subscriptions (the new monetization API) which is read-only and
+ * works on apps that have been migrated to the new publishing API. The older
+ * `/inappproducts` endpoint returns 403 "Please migrate to the new publishing
+ * API" for such apps, so we avoid it here.
+ *
+ * Returns true on 200, false on 404, exits fatal on any other error.
+ */
+export async function checkAppExists(packageName) {
+    const result = await apiRequest({
+        method: 'GET',
+        path: `/applications/${encodeURIComponent(packageName)}/subscriptions`,
+        label: `Checking ${packageName} on Play Console`,
+        allowFailure: true,
+    });
+    if (result.ok)
+        return true;
+    if (result.status === 404)
+        return false;
+    logger.fatal(`Play Console probe failed: ${result.status} ${result.error ?? ''}`);
+    process.exit(1);
+}
+// ── Validation ───────────────────────────────────────────────────────
+export async function validateServiceAccount() {
+    await loadServiceAccount(); // throws fatal if missing/invalid
+    try {
+        await getAccessToken();
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.fatal(`Unable to authenticate with Google Play: ${message}`);
+        process.exit(1);
+    }
+}
+export async function insertEdit(packageName) {
+    const result = await apiRequest({
+        method: 'POST',
+        path: `/applications/${encodeURIComponent(packageName)}/edits`,
+        body: {},
+        label: `Starting Play Console edit for ${packageName}`,
+        allowFailure: true,
+    });
+    if (!result.ok) {
+        if (result.status === 404) {
+            logger.fatal(`App "${packageName}" not found on Google Play Console.`);
+            logger.info('Apps must be created manually in Play Console before configuring them.');
+            logger.info(`Create it at: ${PLAY_CONSOLE_URL}`);
+            logger.info('Then rerun this command.');
+            process.exit(1);
+        }
+        logger.fatal(`Failed to start Play Console edit: ${result.error ?? 'unknown error'}`);
+        process.exit(1);
+    }
+    if (!result.data?.id) {
+        logger.fatal('Play Console edit created but no id returned.');
+        process.exit(1);
+    }
+    return result.data.id;
+}
+export async function commitEdit(packageName, editId) {
+    await apiRequest({
+        method: 'POST',
+        path: `/applications/${encodeURIComponent(packageName)}/edits/${editId}:commit`,
+        label: 'Committing Play Console edit',
+        allowFailure: true,
+    });
+}
+export async function deleteEdit(packageName, editId) {
+    await apiRequest({
+        method: 'DELETE',
+        path: `/applications/${encodeURIComponent(packageName)}/edits/${editId}`,
+        label: 'Discarding Play Console edit',
+        allowFailure: true,
+    });
+}
+/**
+ * Read current app details (default language + contact info) inside an existing
+ * edit. Used to discover the app's actual default language before pushing
+ * subscriptions — Play rejects subscriptions that don't have a listing in that
+ * language, so the caller needs to ensure one exists.
+ */
+export async function getEditDetails(packageName, editId) {
+    const result = await apiRequest({
+        method: 'GET',
+        path: `/applications/${encodeURIComponent(packageName)}/edits/${editId}/details`,
+        label: 'Fetching current app details',
+        allowFailure: true,
+    });
+    return result.ok ? (result.data ?? null) : null;
+}
+/**
+ * Probe Play Console for the app's current default language via a short-lived
+ * edit (insert → get details → delete). Returns null if the probe fails so
+ * callers can fall back to whatever default they had in their config.
+ */
+export async function fetchDefaultLanguage(packageName) {
+    const state = await fetchAppState(packageName);
+    return state?.defaultLanguage ?? null;
+}
+/**
+ * One-shot probe that starts an edit, reads the details and tracks, and
+ * discards the edit — returns everything the orchestrator needs to know about
+ * the app's current state in a single transaction. Useful for pre-flight
+ * checks before monetization writes.
+ *
+ * Graceful: returns null if the probe fails (no network, restricted service
+ * account, etc.).
+ */
+export async function fetchAppState(packageName) {
+    let editId = null;
+    try {
+        editId = await insertEdit(packageName);
+        const details = await getEditDetails(packageName, editId);
+        const tracksResult = await apiRequest({
+            method: 'GET',
+            path: `/applications/${encodeURIComponent(packageName)}/edits/${editId}/tracks`,
+            label: 'Fetching tracks and releases',
+            allowFailure: true,
+        });
+        const tracksWithReleases = [];
+        if (tracksResult.ok && tracksResult.data?.tracks) {
+            for (const track of tracksResult.data.tracks) {
+                const hasRelease = (track.releases ?? []).some((r) => (r.versionCodes?.length ?? 0) > 0);
+                if (hasRelease && track.track)
+                    tracksWithReleases.push(track.track);
+            }
+        }
+        return {
+            defaultLanguage: details?.defaultLanguage ?? null,
+            hasUploadedBuild: tracksWithReleases.length > 0,
+            tracksWithReleases,
+        };
+    }
+    catch {
+        return null;
+    }
+    finally {
+        if (editId) {
+            await deleteEdit(packageName, editId);
+        }
+    }
+}
+export async function withEdit(packageName, fn) {
+    const editId = await insertEdit(packageName);
+    const result = await fn(editId);
+    await commitEdit(packageName, editId);
+    return result;
+}
+// ── App details ──────────────────────────────────────────────────────
+export async function updateAppDetails(packageName, editId, defaultLanguage, details) {
+    const body = { defaultLanguage };
+    if (details.contact_website)
+        body.contactWebsite = details.contact_website;
+    if (details.contact_email)
+        body.contactEmail = details.contact_email;
+    if (details.contact_phone)
+        body.contactPhone = details.contact_phone;
+    await apiRequest({
+        method: 'PUT',
+        path: `/applications/${encodeURIComponent(packageName)}/edits/${editId}/details`,
+        body,
+        label: 'Updating app details (default language + contact)',
+        allowFailure: true,
+    });
+}
+// ── Store listings ───────────────────────────────────────────────────
+export async function updateListing(packageName, editId, listing) {
+    const body = { language: listing.locale };
+    if (listing.title)
+        body.title = listing.title;
+    if (listing.short_description)
+        body.shortDescription = listing.short_description;
+    if (listing.full_description)
+        body.fullDescription = listing.full_description;
+    if (listing.video)
+        body.video = listing.video;
+    await apiRequest({
+        method: 'PUT',
+        path: `/applications/${encodeURIComponent(packageName)}/edits/${editId}/listings/${encodeURIComponent(listing.locale)}`,
+        body,
+        label: `Updating listing (${listing.locale})`,
+        allowFailure: true,
+    });
+}
+// ── Data safety (standalone, not inside edit) ────────────────────────
+/**
+ * Upload a Play Console Data Safety declaration. The API does NOT take
+ * structured JSON — it takes a JSON object with a single `safetyLabels` field
+ * whose value is the raw CSV content exported from Play Console:
+ *
+ *   POST /applications/{pkg}/dataSafety
+ *   body: { "safetyLabels": "<csv file contents as string>" }
+ *
+ * The CSV is app-specific (Google generates different question sets based on
+ * the app's category/permissions), so callers must provide the contents of a
+ * real CSV exported from this app's Play Console page.
+ */
+export async function updateDataSafety(packageName, csvContents) {
+    await apiRequest({
+        method: 'POST',
+        path: `/applications/${encodeURIComponent(packageName)}/dataSafety`,
+        body: { safetyLabels: csvContents },
+        label: 'Updating data safety declaration',
+        allowFailure: true,
+    });
+}
+//# sourceMappingURL=gpc.service.js.map