Track HiveGrid Cloud planning reference

hivegrid-cloud/packages/api-client-ts/scripts/generate-spec.ts

@@ -0,0 +1,64 @@
+#!/usr/bin/env tsx
+/**
+ * generate-spec — capture the boilerplate's OpenAPI document into a local file.
+ *
+ * Invokes the headless `createOpenApiDocument` factory from `@toolctrl/api` and
+ * writes the result to `packages/api-client-ts/openapi.json`. This file feeds
+ * `@hey-api/openapi-ts` (see `openapi-ts.config.ts`) which then regenerates
+ * `src/generated/`.
+ *
+ * Usage:
+ *   pnpm --filter @toolctrl/api-client-ts generate-spec
+ *   pnpm --filter @toolctrl/api-client-ts generate-spec -- --check
+ *
+ * `--check` re-runs the generation and exits non-zero if the on-disk
+ * `openapi.json` would change — useful as a CI drift gate.
+ *
+ * Refs: docs/improvement-plan/08-mobile-cli-storybook-sdk/ts-sdk.md
+ */
+
+import { writeFileSync, readFileSync, existsSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+import { createOpenApiDocument } from "@toolctrl/api/openapi";
+
+const here = dirname(fileURLToPath(import.meta.url));
+const outputPath = resolve(here, "..", "openapi.json");
+
+function buildSpec(): string {
+  const document = createOpenApiDocument({
+    routing: {
+      protocol: "https",
+      apiHost: "api.toolctrl.de",
+    } as never,
+  });
+  return `${JSON.stringify(document, null, 2)}\n`;
+}
+
+function main(): void {
+  const checkMode = process.argv.includes("--check");
+  const next = buildSpec();
+
+  if (checkMode) {
+    if (!existsSync(outputPath)) {
+      process.stderr.write(`openapi.json missing at ${outputPath} — run \`pnpm --filter @toolctrl/api-client-ts generate-spec\`.\n`);
+      process.exit(1);
+    }
+    const current = readFileSync(outputPath, "utf8");
+    if (current !== next) {
+      process.stderr.write(
+        `openapi.json is stale — the upstream OpenAPI document has changed.\n` +
+          `Run \`pnpm --filter @toolctrl/api-client-ts generate:all\` and commit the result.\n`,
+      );
+      process.exit(2);
+    }
+    process.stdout.write("openapi.json is in sync with the upstream document.\n");
+    return;
+  }
+
+  writeFileSync(outputPath, next, "utf8");
+  process.stdout.write(`Wrote ${outputPath} (${(next.length / 1024).toFixed(1)} KiB)\n`);
+}
+
+main();