@gpc-cli/core

Business logic and command orchestration for GPC — the complete CLI for Google Play.

Need to integrate Play operations into your own tools or services? Use @gpc-cli/core to call GPC commands programmatically — same logic the CLI uses, no terminal required.

Install

npm install @gpc-cli/core

Usage

import {
  uploadRelease,
  promoteRelease,
  getVitalsOverview,
  listReviews,
  analyzeBundle,
  formatOutput,
} from "@gpc-cli/core";

// Upload a release
const result = await uploadRelease(context, {
  file: "app.aab",
  track: "internal",
});

// Promote between tracks
await promoteRelease(context, {
  from: "internal",
  to: "production",
  rollout: 0.1,
});

// Check vitals
const vitals = await getVitalsOverview(context);
console.log(formatOutput(vitals, "table"));

// Analyze bundle size
const analysis = await analyzeBundle("./app.aab");

Command Groups

Utilities

• Output formatting — formatOutput(), detectOutputFormat(), redactSensitive()
• Error hierarchy — GpcError, ConfigError, ApiError, NetworkError with exit codes
• Audit logging — initAudit(), writeAuditLog() for write operation tracking
• Path safety — safePath(), safePathWithin() for path traversal prevention
• Plugin management — PluginManager, discoverPlugins(), scaffoldPlugin()

Documentation

• Full documentation
• Architecture

Licensing

Free to use. Source code is on GitHub at yasserstudio/gpc.