@anakonn/ankk 0.1.0-beta.0 → 0.1.1

package/README.md

@@ -18,11 +18,28 @@ bun install -g @anakonn/ankk
 ankk --json health
 ```
 
+## Upgrade
+
+Global Bun installs can upgrade through the CLI:
+
+```bash
+ankk upgrade
+ankk upgrade --dry-run
+```
+
+The CLI uses the `latest` npm dist-tag. Release versions use three-part numeric
+SemVer such as `0.1.1`.
+
 ## 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 automatically when CLI-related changes reach the
+repository `main` branch. Before merging CLI changes to `main`, update
+`apps/cli/package.json` to the release version.
+
+The CI job `publish:cli:npm` validates that `apps/cli/package.json` uses
+three-part numeric SemVer, that the version is not already published, and then
+publishes with npm dist-tag `latest`. If the version was already published, the
+job fails so the missing version bump is visible.
 
 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,10 +52,11 @@ 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 branch: `main`.
 
 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
-replace CI with a package-scoped token for later beta publishes.
+replace CI with a package-scoped token for later publishes.
 
 When publishing moves to a supported Trusted Publishing runner, configure npm
 Trusted Publisher with:

package/dist/index.js

@@ -2154,6 +2154,57 @@ var {
   Option,
   Help
 } = import__.default;
+// package.json
+var package_default = {
+  name: "@anakonn/ankk",
+  version: "0.1.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,14 @@ var createProgram = ({
     });
     writeOutput(context.io, context.outputMode, result, `${result.service}: ${result.status}`);
   });
+  program2.command("upgrade").description("Upgrade the ankk CLI global installation").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)
+    });
+    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 +17498,33 @@ var resolveCommandContext = async ({
   };
 };
 var safeDefaultConfigPath = (env) => defaultConfigPath({ env });
+var packageName = package_default.name;
+var packageVersion = package_default.version;
+var upgradeCli = async ({ commandRunner, dryRun }) => {
+  const command = ["bun", "install", "-g", `${packageName}@latest`];
+  const result = {
+    command,
+    current_version: packageVersion,
+    dry_run: dryRun,
+    package: packageName,
+    tag: "latest"
+  };
+  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 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.1",
 	"description": "Bun-first CLI for the ankk public API.",
 	"private": false,
 	"license": "UNLICENSED",