refactor(openapi): move generated artifacts into workspace package

Author: skulidropek

bun.lock

@@ -10,6 +10,7 @@
     "packages/container",
     "packages/docker-git-session-sync",
     "packages/lib",
+    "packages/openapi",
     "packages/terminal"
   ],
   "scripts": {
@@ -20,7 +21,7 @@
     "api:dev": "bun run --filter @effect-template/api dev",
     "api:test": "bun run --filter @effect-template/api test",
     "api:typecheck": "bun run --filter @effect-template/api typecheck",
-    "check": "bun run --filter @prover-coder-ai/docker-git-session-sync check && bun run --filter @prover-coder-ai/docker-git-terminal check && bun run --filter @prover-coder-ai/docker-git check && bun run --filter @effect-template/lib typecheck",
+    "check": "bun run --filter @prover-coder-ai/docker-git-session-sync check && bun run --filter @prover-coder-ai/docker-git-terminal check && bun run --filter @prover-coder-ai/docker-git-openapi check && bun run --filter @prover-coder-ai/docker-git check && bun run --filter @effect-template/lib typecheck",
     "check:dist-deps-prune": "bun node_modules/@prover-coder-ai/dist-deps-prune/dist/main.js scan --package ./packages/app/package.json --prune-dev true --silent",
     "changeset": "changeset",
     "changeset-publish": "bun -e \"if (!process.env.NPM_TOKEN) { console.log('Skipping publish: NPM_TOKEN is not set'); process.exit(0); }\" && changeset publish",
@@ -42,14 +43,14 @@
     "dev": "bun run --cwd packages/app dev",
     "web:dev": "bun run --cwd packages/app dev:web",
     "web:build": "bun run --cwd packages/app build:web",
-    "web:generate-api": "bun run --cwd packages/app generate:api",
+    "web:generate-api": "bun run --cwd packages/openapi generate",
     "web:preview": "bun run --cwd packages/app preview:web",
     "web:serve": "bun run --cwd packages/app serve:web",
     "lint": "bun run --filter @prover-coder-ai/docker-git-terminal lint && bun run --filter @prover-coder-ai/docker-git lint && bun run --filter @effect-template/lib lint",
     "lint:tests": "bun run --filter @prover-coder-ai/docker-git lint:tests",
     "lint:effect": "bun run --filter @prover-coder-ai/docker-git-session-sync lint:effect && bun run --filter @prover-coder-ai/docker-git-terminal lint:effect && bun run --filter @prover-coder-ai/docker-git lint:effect && bun run --filter @prover-coder-ai/docker-git-container lint:effect && bun run --filter @effect-template/lib lint:effect && bun run --filter @effect-template/api lint:effect",
     "test": "bun run --filter @prover-coder-ai/docker-git-session-sync test && bun run --filter @prover-coder-ai/docker-git-terminal test && bun run --filter @prover-coder-ai/docker-git test && bun run --filter @effect-template/lib test",
-    "typecheck": "bun run --filter @prover-coder-ai/docker-git-session-sync typecheck && bun run --filter @prover-coder-ai/docker-git-terminal typecheck && bun run --filter @prover-coder-ai/docker-git typecheck && bun run --filter @effect-template/lib typecheck",
+    "typecheck": "bun run --filter @prover-coder-ai/docker-git-session-sync typecheck && bun run --filter @prover-coder-ai/docker-git-terminal typecheck && bun run --filter @prover-coder-ai/docker-git-openapi typecheck && bun run --filter @prover-coder-ai/docker-git typecheck && bun run --filter @effect-template/lib typecheck",
     "start": "bun run --cwd packages/app build:docker-git && bun ./packages/app/dist/src/docker-git/main.js"
   },
   "devDependencies": {

package.json

@@ -7,7 +7,7 @@
 	},
 	"files": {
 		"ignoreUnknown": false,
-		"includes": ["**", "!src/web/generated/**"]
+		"includes": ["**"]
 	},
 	"assist": {
 		"enabled": false

packages/app/biome.json

@@ -304,5 +304,5 @@ export default defineConfig(
   },
 
   // 4) Глобальные игноры
-  { ignores: ['dist/**', 'build/**', 'coverage/**', '**/dist/**', 'src/web/generated/**'] },
+  { ignores: ['dist/**', 'build/**', 'coverage/**', '**/dist/**'] },
 );

packages/app/eslint.config.mts

@@ -18,7 +18,7 @@
     "build:app": "vite build --ssr src/app/main.ts",
     "build:web": "vite build --config vite.web.config.ts",
     "build:web:strict": "bun ../../scripts/ci/check-web-build-output.mjs",
-    "generate:api": "bun ../../scripts/write-openapi.ts && openapi-typescript ../../packages/api/openapi.json -o src/web/generated/openapi-paths.ts",
+    "generate:api": "bun run --cwd ../openapi generate",
     "prepack": "bun run build:docker-git",
     "dev": "vite build --watch --ssr src/app/main.ts",
     "dev:web": "vite --config vite.web.config.ts",
@@ -96,6 +96,7 @@
     "@eslint/compat": "2.1.0",
     "@eslint/eslintrc": "3.3.5",
     "@eslint/js": "10.0.1",
+    "@prover-coder-ai/docker-git-openapi": "workspace:*",
     "@prover-coder-ai/docker-git-terminal": "workspace:*",
     "@prover-coder-ai/eslint-plugin-suggest-members": "^0.0.26",
     "@ton-ai-core/vibecode-linter": "^1.0.11",
@@ -120,7 +121,6 @@
     "fast-check": "4.8.0",
     "globals": "^17.6.0",
     "jscpd": "^5.0.10",
-    "openapi-typescript": "^7.13.0",
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.61.1",
     "vite": "^8.0.16",

packages/app/package.json

@@ -1,11 +1,11 @@
 import * as ParseResult from "@effect/schema/ParseResult"
 import type * as Schema from "@effect/schema/Schema"
 import * as TreeFormatter from "@effect/schema/TreeFormatter"
+import type { paths } from "@prover-coder-ai/docker-git-openapi"
 import { Effect, Either, Option } from "effect"
 import createClient, { type Client, type Middleware } from "openapi-fetch"
 
 import { resolveApiBaseUrl } from "./api-http.js"
-import type { paths } from "./generated/openapi-paths.js"
 
 type DockerGitOpenApiClient = Client<paths>
 

packages/app/src/web/openapi-client.ts

@@ -0,0 +1,32 @@
+{
+  "name": "@prover-coder-ai/docker-git-openapi",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Generated docker-git OpenAPI artifacts",
+  "type": "module",
+  "packageManager": "bun@1.3.11",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts"
+    },
+    "./openapi-paths": {
+      "types": "./src/openapi-paths.ts"
+    },
+    "./openapi.json": "./openapi.json"
+  },
+  "scripts": {
+    "check": "bun run typecheck",
+    "generate": "bun ../../scripts/write-openapi.ts && openapi-typescript openapi.json -o src/openapi-paths.ts",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  },
+  "devDependencies": {
+    "openapi-typescript": "^7.13.0",
+    "typescript": "^6.0.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ProverCoderAI/docker-git.git"
+  },
+  "license": "MIT"
+}

packages/api/openapi.json packages/openapi/openapi.jsonpackages/api/openapi.json renamed to packages/openapi/openapi.json

@@ -0,0 +1,14 @@
+/**
+ * Generated OpenAPI path map for the docker-git JSON REST API.
+ *
+ * @returns Type-only exports consumed by typed OpenAPI clients.
+ *
+ * @pure true
+ * @effect none
+ * @invariant all exported types are derived from packages/openapi/openapi.json.
+ * @precondition run `bun run --cwd packages/openapi generate` after changing the source HttpApi contract.
+ * @postcondition consumers depend on this package instead of importing generated files from app internals.
+ * @complexity O(1)/O(1)
+ * @throws Never - type-only module.
+ */
+export type { components, operations, paths, webhooks } from "./openapi-paths.js"