@anakonn/ankk 0.1.0-beta.0 → 0.1.0-beta.1

package/README.md

@@ -18,11 +18,38 @@ bun install -g @anakonn/ankk
 ankk --json health
 ```
 
+## Upgrade
+
+Global Bun installs can upgrade through the CLI:
+
+```bash
+ankk upgrade
+ankk upgrade --tag beta
+ankk upgrade --tag latest
+ankk upgrade --dry-run
+```
+
+The default tag follows the installed CLI version: prerelease builds upgrade
+from `beta`, and stable builds upgrade from `latest`.
+
 ## Publish
 
-Public npm publish runs only from the repository `main` branch. After `preview`
-is promoted to `main`, run the manual GitLab CI job `publish:cli:npm:beta` with
-a masked, protected `NPM_TOKEN` variable configured.
+Public npm publish runs from protected CLI release tags only. After `preview` is
+promoted to `main`, update `apps/cli/package.json` to the release version, merge
+that version to `main`, then push a matching tag:
+
+```bash
+git fetch origin main
+git switch main
+git pull --ff-only origin main
+git tag ankk-cli-v0.1.0-beta.1
+git push origin ankk-cli-v0.1.0-beta.1
+```
+
+The CI job `publish:cli:npm` validates that the tag version matches
+`apps/cli/package.json`, that the tag commit is contained in `origin/main`, and
+that the version is not already published. Pre-release versions publish with npm
+dist-tag `beta`; stable versions publish with `latest`.
 
 The current repository is hosted on self-managed GitLab. npm Trusted Publishing
 is preferred, but npm currently documents GitLab support for GitLab.com shared
@@ -35,6 +62,7 @@ npm token with the smallest practical scope:
 - Organization access: none unless npm requires it for the `@anakonn` scope.
 - Expiration: finite.
 - GitLab variable: `NPM_TOKEN`, masked and protected.
+- GitLab protected tag pattern: `ankk-cli-v*`.
 
 If this is the first ever publish and npm cannot scope a token to an
 unpublished package, publish `@anakonn/ankk` once manually with 2FA, then

package/dist/index.js

@@ -2154,6 +2154,57 @@ var {
   Option,
   Help
 } = import__.default;
+// package.json
+var package_default = {
+  name: "@anakonn/ankk",
+  version: "0.1.0-beta.1",
+  description: "Bun-first CLI for the ankk public API.",
+  private: false,
+  license: "UNLICENSED",
+  type: "module",
+  bin: {
+    ankk: "dist/index.js"
+  },
+  exports: "./dist/index.js",
+  files: [
+    "dist",
+    "README.md",
+    "package.json"
+  ],
+  publishConfig: {
+    access: "public",
+    registry: "https://registry.npmjs.org/"
+  },
+  engines: {
+    bun: ">=1.3.0"
+  },
+  scripts: {
+    build: "bun build src/entry/index.ts --target=bun --outdir=dist",
+    check: "tsc --noEmit",
+    "coverage:openapi": "bun src/coverage-check.ts",
+    dev: "bun run src/entry/index.ts",
+    format: "prettier --write .",
+    "generate:openapi": "bun run generate:openapi:snapshot && bun run generate:openapi:types && bun run generate:openapi:format",
+    "generate:openapi:format": "prettier --write src/generated/api-public-openapi.json src/generated/api-public-schema.ts",
+    "generate:openapi:live": "bun run src/entry/index.ts openapi pull && bun run generate:openapi:types && bun run generate:openapi:format",
+    "generate:openapi:snapshot": "bun ../../scripts/api-public/generate-openapi-snapshot.ts",
+    "generate:openapi:types": "openapi-typescript src/generated/api-public-openapi.json -o src/generated/api-public-schema.ts",
+    lint: "tsc --noEmit",
+    "pack:smoke": "bun run build && npm pack --dry-run",
+    prepack: "bun run build",
+    "smoke:dogfood": "bun src/dogfood-smoke.ts",
+    test: "bun test"
+  },
+  dependencies: {
+    commander: "^14.0.3",
+    "openapi-fetch": "^0.15.0",
+    zod: "^4.4.3"
+  },
+  devDependencies: {
+    "@repo/tsconfig": "workspace:*",
+    "openapi-typescript": "^7.10.1"
+  }
+};
 
 // ../../node_modules/.bun/openapi-fetch@0.15.2/node_modules/openapi-fetch/dist/index.mjs
 var PATH_PARAM_RE = /\{[^{}]+\}/g;
@@ -17031,8 +17082,14 @@ var writeError = (io, error51) => {
 };
 
 // src/program.ts
-var runCli = async ({ argv, env = process.env, fetch = globalThis.fetch, io = defaultIo }) => {
-  const program2 = createProgram({ env, fetch, io });
+var runCli = async ({
+  argv,
+  commandRunner = runProcess,
+  env = process.env,
+  fetch = globalThis.fetch,
+  io = defaultIo
+}) => {
+  const program2 = createProgram({ commandRunner, env, fetch, io });
   try {
     await program2.parseAsync(argv, { from: "user" });
     return 0;
@@ -17042,6 +17099,7 @@ var runCli = async ({ argv, env = process.env, fetch = globalThis.fetch, io = de
   }
 };
 var createProgram = ({
+  commandRunner = runProcess,
   env = process.env,
   fetch = globalThis.fetch,
   io = defaultIo
@@ -17056,6 +17114,15 @@ var createProgram = ({
     });
     writeOutput(context.io, context.outputMode, result, `${result.service}: ${result.status}`);
   });
+  program2.command("upgrade").description("Upgrade the ankk CLI global installation").option("--tag <tag>", "npm dist-tag to install (beta or latest)").option("--dry-run", "Print the upgrade command without running it").action(async (options) => {
+    const outputMode = program2.opts().json ? "json" : "human";
+    const result = await upgradeCli({
+      commandRunner,
+      dryRun: Boolean(options.dryRun),
+      tag: options.tag
+    });
+    writeOutput(io, outputMode, result, options.dryRun ? `Would run: ${result.command.join(" ")}` : `Upgraded ${result.package} via ${result.tag}`);
+  });
   const brands = program2.command("brands").description("Manage brands available to the API key");
   brands.command("list").description("List brands available to the API key").action(async () => {
     const context = await resolveCommandContext({ env, fetch, io, program: program2 });
@@ -17432,6 +17499,47 @@ var resolveCommandContext = async ({
   };
 };
 var safeDefaultConfigPath = (env) => defaultConfigPath({ env });
+var packageName = package_default.name;
+var packageVersion = package_default.version;
+var upgradeCli = async ({
+  commandRunner,
+  dryRun,
+  tag
+}) => {
+  const resolvedTag = resolveUpgradeTag(tag, packageVersion);
+  const command = ["bun", "install", "-g", `${packageName}@${resolvedTag}`];
+  const result = {
+    command,
+    current_version: packageVersion,
+    dry_run: dryRun,
+    package: packageName,
+    tag: resolvedTag
+  };
+  if (dryRun)
+    return result;
+  const exitCode = await commandRunner(command[0] ?? "bun", command.slice(1));
+  if (exitCode !== 0) {
+    throw new Error(`Upgrade command failed with exit code ${exitCode}.`);
+  }
+  return result;
+};
+var resolveUpgradeTag = (tag, currentVersion) => {
+  if (tag === undefined) {
+    return currentVersion.includes("-") ? "beta" : "latest";
+  }
+  if (tag === "beta" || tag === "latest") {
+    return tag;
+  }
+  throw new Error('Upgrade tag must be either "beta" or "latest".');
+};
+var runProcess = async (command, args) => {
+  const process3 = Bun.spawn([command, ...args], {
+    stderr: "inherit",
+    stdin: "inherit",
+    stdout: "inherit"
+  });
+  return process3.exited;
+};
 var withBrandRef = (command) => command.requiredOption("--brand-ref <brand_ref>", "Brand reference");
 var queryParams = (query) => ({
   query: Object.fromEntries(Object.entries(query).filter(([, value]) => value !== undefined))

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@anakonn/ankk",
-	"version": "0.1.0-beta.0",
+	"version": "0.1.0-beta.1",
 	"description": "Bun-first CLI for the ankk public API.",
 	"private": false,
 	"license": "UNLICENSED",