@gpc-cli/plugin-ci 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 GPC Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+import * as _gpc_cli_plugin_sdk from '@gpc-cli/plugin-sdk';
+
+declare const PLUGIN_CI_VERSION = "0.8.0";
+interface CIEnvironment {
+    /** Whether we're running in a CI environment */
+    isCI: boolean;
+    /** CI provider name (if detected) */
+    provider?: string;
+    /** Build number or run ID */
+    buildId?: string;
+    /** Branch name */
+    branch?: string;
+    /** Commit SHA */
+    commitSha?: string;
+    /** Whether GitHub Actions step summary is available */
+    hasStepSummary: boolean;
+}
+declare function detectCIEnvironment(): CIEnvironment;
+declare function writeStepSummary(markdown: string): Promise<void>;
+declare const ciPlugin: _gpc_cli_plugin_sdk.GpcPlugin;
+
+export { type CIEnvironment, PLUGIN_CI_VERSION, ciPlugin, detectCIEnvironment, writeStepSummary };

package/dist/index.js

@@ -0,0 +1,120 @@
+// src/index.ts
+import { definePlugin } from "@gpc-cli/plugin-sdk";
+import { appendFile } from "fs/promises";
+var PLUGIN_CI_VERSION = "0.8.0";
+function detectCIEnvironment() {
+  const env = process.env;
+  if (env["GITHUB_ACTIONS"] === "true") {
+    return {
+      isCI: true,
+      provider: "github-actions",
+      buildId: env["GITHUB_RUN_ID"],
+      branch: env["GITHUB_REF_NAME"],
+      commitSha: env["GITHUB_SHA"],
+      hasStepSummary: !!env["GITHUB_STEP_SUMMARY"]
+    };
+  }
+  if (env["GITLAB_CI"] === "true") {
+    return {
+      isCI: true,
+      provider: "gitlab-ci",
+      buildId: env["CI_JOB_ID"],
+      branch: env["CI_COMMIT_BRANCH"],
+      commitSha: env["CI_COMMIT_SHA"],
+      hasStepSummary: false
+    };
+  }
+  if (env["JENKINS_URL"]) {
+    return {
+      isCI: true,
+      provider: "jenkins",
+      buildId: env["BUILD_NUMBER"],
+      branch: env["BRANCH_NAME"],
+      commitSha: env["GIT_COMMIT"],
+      hasStepSummary: false
+    };
+  }
+  if (env["CIRCLECI"] === "true") {
+    return {
+      isCI: true,
+      provider: "circleci",
+      buildId: env["CIRCLE_BUILD_NUM"],
+      branch: env["CIRCLE_BRANCH"],
+      commitSha: env["CIRCLE_SHA1"],
+      hasStepSummary: false
+    };
+  }
+  if (env["BITRISE_IO"] === "true") {
+    return {
+      isCI: true,
+      provider: "bitrise",
+      buildId: env["BITRISE_BUILD_NUMBER"],
+      branch: env["BITRISE_GIT_BRANCH"],
+      commitSha: env["BITRISE_GIT_COMMIT"],
+      hasStepSummary: false
+    };
+  }
+  if (env["CI"] === "true" || env["CI"] === "1") {
+    return {
+      isCI: true,
+      provider: "unknown",
+      hasStepSummary: false
+    };
+  }
+  return { isCI: false, hasStepSummary: false };
+}
+async function writeStepSummary(markdown) {
+  const summaryPath = process.env["GITHUB_STEP_SUMMARY"];
+  if (!summaryPath) return;
+  await appendFile(summaryPath, markdown + "\n");
+}
+function formatCommandSummary(event, result) {
+  const status = result.success ? "\u2705" : "\u274C";
+  const lines = [
+    `### ${status} \`gpc ${event.command}\``,
+    "",
+    `| Field | Value |`,
+    `|-------|-------|`,
+    `| App | \`${event.app ?? "N/A"}\` |`,
+    `| Duration | ${result.durationMs}ms |`,
+    `| Exit Code | ${result.exitCode} |`
+  ];
+  return lines.join("\n");
+}
+function formatErrorSummary(event, error) {
+  const lines = [
+    `### \u274C \`gpc ${event.command}\` failed`,
+    "",
+    `| Field | Value |`,
+    `|-------|-------|`,
+    `| App | \`${event.app ?? "N/A"}\` |`,
+    `| Error Code | \`${error.code}\` |`,
+    `| Message | ${error.message} |`
+  ];
+  return lines.join("\n");
+}
+var ciPlugin = definePlugin({
+  name: "@gpc-cli/plugin-ci",
+  version: PLUGIN_CI_VERSION,
+  register(hooks) {
+    const ci = detectCIEnvironment();
+    if (!ci.isCI) return;
+    hooks.afterCommand(async (event, result) => {
+      if (ci.hasStepSummary) {
+        await writeStepSummary(formatCommandSummary(event, result));
+      }
+    });
+    hooks.onError(async (event, error) => {
+      if (ci.hasStepSummary) {
+        await writeStepSummary(formatErrorSummary(event, error));
+      }
+    });
+  }
+});
+export {
+  PLUGIN_CI_VERSION,
+  ciPlugin,
+  detectCIEnvironment,
+  writeStepSummary
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { definePlugin } from \"@gpc-cli/plugin-sdk\";\nimport type { CommandEvent, CommandResult, PluginError } from \"@gpc-cli/plugin-sdk\";\n\nexport const PLUGIN_CI_VERSION = \"0.8.0\";\n\n// ---------------------------------------------------------------------------\n// CI environment detection\n// ---------------------------------------------------------------------------\n\nexport interface CIEnvironment {\n  /** Whether we're running in a CI environment */\n  isCI: boolean;\n\n  /** CI provider name (if detected) */\n  provider?: string;\n\n  /** Build number or run ID */\n  buildId?: string;\n\n  /** Branch name */\n  branch?: string;\n\n  /** Commit SHA */\n  commitSha?: string;\n\n  /** Whether GitHub Actions step summary is available */\n  hasStepSummary: boolean;\n}\n\nexport function detectCIEnvironment(): CIEnvironment {\n  const env = process.env;\n\n  // GitHub Actions\n  if (env[\"GITHUB_ACTIONS\"] === \"true\") {\n    return {\n      isCI: true,\n      provider: \"github-actions\",\n      buildId: env[\"GITHUB_RUN_ID\"],\n      branch: env[\"GITHUB_REF_NAME\"],\n      commitSha: env[\"GITHUB_SHA\"],\n      hasStepSummary: !!env[\"GITHUB_STEP_SUMMARY\"],\n    };\n  }\n\n  // GitLab CI\n  if (env[\"GITLAB_CI\"] === \"true\") {\n    return {\n      isCI: true,\n      provider: \"gitlab-ci\",\n      buildId: env[\"CI_JOB_ID\"],\n      branch: env[\"CI_COMMIT_BRANCH\"],\n      commitSha: env[\"CI_COMMIT_SHA\"],\n      hasStepSummary: false,\n    };\n  }\n\n  // Jenkins\n  if (env[\"JENKINS_URL\"]) {\n    return {\n      isCI: true,\n      provider: \"jenkins\",\n      buildId: env[\"BUILD_NUMBER\"],\n      branch: env[\"BRANCH_NAME\"],\n      commitSha: env[\"GIT_COMMIT\"],\n      hasStepSummary: false,\n    };\n  }\n\n  // CircleCI\n  if (env[\"CIRCLECI\"] === \"true\") {\n    return {\n      isCI: true,\n      provider: \"circleci\",\n      buildId: env[\"CIRCLE_BUILD_NUM\"],\n      branch: env[\"CIRCLE_BRANCH\"],\n      commitSha: env[\"CIRCLE_SHA1\"],\n      hasStepSummary: false,\n    };\n  }\n\n  // Bitrise\n  if (env[\"BITRISE_IO\"] === \"true\") {\n    return {\n      isCI: true,\n      provider: \"bitrise\",\n      buildId: env[\"BITRISE_BUILD_NUMBER\"],\n      branch: env[\"BITRISE_GIT_BRANCH\"],\n      commitSha: env[\"BITRISE_GIT_COMMIT\"],\n      hasStepSummary: false,\n    };\n  }\n\n  // Generic CI detection\n  if (env[\"CI\"] === \"true\" || env[\"CI\"] === \"1\") {\n    return {\n      isCI: true,\n      provider: \"unknown\",\n      hasStepSummary: false,\n    };\n  }\n\n  return { isCI: false, hasStepSummary: false };\n}\n\n// ---------------------------------------------------------------------------\n// GitHub Actions step summary\n// ---------------------------------------------------------------------------\n\nimport { appendFile } from \"node:fs/promises\";\n\nexport async function writeStepSummary(markdown: string): Promise<void> {\n  const summaryPath = process.env[\"GITHUB_STEP_SUMMARY\"];\n  if (!summaryPath) return;\n  await appendFile(summaryPath, markdown + \"\\n\");\n}\n\nfunction formatCommandSummary(event: CommandEvent, result: CommandResult): string {\n  const status = result.success ? \"✅\" : \"❌\";\n  const lines = [\n    `### ${status} \\`gpc ${event.command}\\``,\n    \"\",\n    `| Field | Value |`,\n    `|-------|-------|`,\n    `| App | \\`${event.app ?? \"N/A\"}\\` |`,\n    `| Duration | ${result.durationMs}ms |`,\n    `| Exit Code | ${result.exitCode} |`,\n  ];\n  return lines.join(\"\\n\");\n}\n\nfunction formatErrorSummary(event: CommandEvent, error: PluginError): string {\n  const lines = [\n    `### ❌ \\`gpc ${event.command}\\` failed`,\n    \"\",\n    `| Field | Value |`,\n    `|-------|-------|`,\n    `| App | \\`${event.app ?? \"N/A\"}\\` |`,\n    `| Error Code | \\`${error.code}\\` |`,\n    `| Message | ${error.message} |`,\n  ];\n  return lines.join(\"\\n\");\n}\n\n// ---------------------------------------------------------------------------\n// Plugin definition\n// ---------------------------------------------------------------------------\n\nexport const ciPlugin = definePlugin({\n  name: \"@gpc-cli/plugin-ci\",\n  version: PLUGIN_CI_VERSION,\n\n  register(hooks) {\n    const ci = detectCIEnvironment();\n\n    // Only activate hooks when running in CI\n    if (!ci.isCI) return;\n\n    hooks.afterCommand(async (event: CommandEvent, result: CommandResult) => {\n      if (ci.hasStepSummary) {\n        await writeStepSummary(formatCommandSummary(event, result));\n      }\n    });\n\n    hooks.onError(async (event: CommandEvent, error: PluginError) => {\n      if (ci.hasStepSummary) {\n        await writeStepSummary(formatErrorSummary(event, error));\n      }\n    });\n  },\n});\n"],"mappings":";AAAA,SAAS,oBAAoB;AA4G7B,SAAS,kBAAkB;AAzGpB,IAAM,oBAAoB;AA0B1B,SAAS,sBAAqC;AACnD,QAAM,MAAM,QAAQ;AAGpB,MAAI,IAAI,gBAAgB,MAAM,QAAQ;AACpC,WAAO;AAAA,MACL,MAAM;AAAA,MACN,UAAU;AAAA,MACV,SAAS,IAAI,eAAe;AAAA,MAC5B,QAAQ,IAAI,iBAAiB;AAAA,MAC7B,WAAW,IAAI,YAAY;AAAA,MAC3B,gBAAgB,CAAC,CAAC,IAAI,qBAAqB;AAAA,IAC7C;AAAA,EACF;AAGA,MAAI,IAAI,WAAW,MAAM,QAAQ;AAC/B,WAAO;AAAA,MACL,MAAM;AAAA,MACN,UAAU;AAAA,MACV,SAAS,IAAI,WAAW;AAAA,MACxB,QAAQ,IAAI,kBAAkB;AAAA,MAC9B,WAAW,IAAI,eAAe;AAAA,MAC9B,gBAAgB;AAAA,IAClB;AAAA,EACF;AAGA,MAAI,IAAI,aAAa,GAAG;AACtB,WAAO;AAAA,MACL,MAAM;AAAA,MACN,UAAU;AAAA,MACV,SAAS,IAAI,cAAc;AAAA,MAC3B,QAAQ,IAAI,aAAa;AAAA,MACzB,WAAW,IAAI,YAAY;AAAA,MAC3B,gBAAgB;AAAA,IAClB;AAAA,EACF;AAGA,MAAI,IAAI,UAAU,MAAM,QAAQ;AAC9B,WAAO;AAAA,MACL,MAAM;AAAA,MACN,UAAU;AAAA,MACV,SAAS,IAAI,kBAAkB;AAAA,MAC/B,QAAQ,IAAI,eAAe;AAAA,MAC3B,WAAW,IAAI,aAAa;AAAA,MAC5B,gBAAgB;AAAA,IAClB;AAAA,EACF;AAGA,MAAI,IAAI,YAAY,MAAM,QAAQ;AAChC,WAAO;AAAA,MACL,MAAM;AAAA,MACN,UAAU;AAAA,MACV,SAAS,IAAI,sBAAsB;AAAA,MACnC,QAAQ,IAAI,oBAAoB;AAAA,MAChC,WAAW,IAAI,oBAAoB;AAAA,MACnC,gBAAgB;AAAA,IAClB;AAAA,EACF;AAGA,MAAI,IAAI,IAAI,MAAM,UAAU,IAAI,IAAI,MAAM,KAAK;AAC7C,WAAO;AAAA,MACL,MAAM;AAAA,MACN,UAAU;AAAA,MACV,gBAAgB;AAAA,IAClB;AAAA,EACF;AAEA,SAAO,EAAE,MAAM,OAAO,gBAAgB,MAAM;AAC9C;AAQA,eAAsB,iBAAiB,UAAiC;AACtE,QAAM,cAAc,QAAQ,IAAI,qBAAqB;AACrD,MAAI,CAAC,YAAa;AAClB,QAAM,WAAW,aAAa,WAAW,IAAI;AAC/C;AAEA,SAAS,qBAAqB,OAAqB,QAA+B;AAChF,QAAM,SAAS,OAAO,UAAU,WAAM;AACtC,QAAM,QAAQ;AAAA,IACZ,OAAO,MAAM,UAAU,MAAM,OAAO;AAAA,IACpC;AAAA,IACA;AAAA,IACA;AAAA,IACA,aAAa,MAAM,OAAO,KAAK;AAAA,IAC/B,gBAAgB,OAAO,UAAU;AAAA,IACjC,iBAAiB,OAAO,QAAQ;AAAA,EAClC;AACA,SAAO,MAAM,KAAK,IAAI;AACxB;AAEA,SAAS,mBAAmB,OAAqB,OAA4B;AAC3E,QAAM,QAAQ;AAAA,IACZ,oBAAe,MAAM,OAAO;AAAA,IAC5B;AAAA,IACA;AAAA,IACA;AAAA,IACA,aAAa,MAAM,OAAO,KAAK;AAAA,IAC/B,oBAAoB,MAAM,IAAI;AAAA,IAC9B,eAAe,MAAM,OAAO;AAAA,EAC9B;AACA,SAAO,MAAM,KAAK,IAAI;AACxB;AAMO,IAAM,WAAW,aAAa;AAAA,EACnC,MAAM;AAAA,EACN,SAAS;AAAA,EAET,SAAS,OAAO;AACd,UAAM,KAAK,oBAAoB;AAG/B,QAAI,CAAC,GAAG,KAAM;AAEd,UAAM,aAAa,OAAO,OAAqB,WAA0B;AACvE,UAAI,GAAG,gBAAgB;AACrB,cAAM,iBAAiB,qBAAqB,OAAO,MAAM,CAAC;AAAA,MAC5D;AAAA,IACF,CAAC;AAED,UAAM,QAAQ,OAAO,OAAqB,UAAuB;AAC/D,UAAI,GAAG,gBAAgB;AACrB,cAAM,iBAAiB,mBAAmB,OAAO,KAAK,CAAC;AAAA,MACzD;AAAA,IACF,CAAC;AAAA,EACH;AACF,CAAC;","names":[]}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@gpc-cli/plugin-ci",
+  "version": "0.1.0",
+  "description": "CI/CD helpers for GPC",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@gpc-cli/plugin-sdk": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.5"
+  },
+  "keywords": [
+    "google-play",
+    "ci",
+    "plugin"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}