refactor(openapi): use openapi-effect client

Author: skulidropek

bun.lock

@@ -782,8 +782,8 @@ export const DockerGitApi = HttpApi.make("docker-git")
 // CHANGE: derive Swagger/OpenAPI from the Effect HttpApi contract.
 // WHY: frontend clients must be generated from one typed REST contract.
 // QUOTE(ТЗ): "Надо сделать REST API нормальный на базе Effect и использовать Swagger."
-// REF: user-message-2026-06-18-openapi-fetch
-// SOURCE: https://openapi-ts.dev/openapi-fetch/
+// REF: user-message-2026-06-19-openapi-effect
+// SOURCE: https://github.com/ProverCoderAI/openapi-effect
 // FORMAT THEOREM: forall endpoint e in DockerGitApi, e is represented in buildDockerGitOpenApi().paths.
 // PURITY: CORE
 // EFFECT: none

packages/api/src/api/openapi.ts

@@ -317,7 +317,7 @@ const textResponse = (data: string, contentType: string, status = 200) =>
 // CHANGE: expose browser-readable Swagger UI for the Effect REST contract.
 // WHY: generated clients and humans must inspect the same OpenAPI document.
 // QUOTE(ТЗ): "использовать Swagger"
-// REF: user-message-2026-06-18-openapi-fetch
+// REF: user-message-2026-06-19-openapi-effect
 // SOURCE: n/a
 // FORMAT THEOREM: docsPath(d) = p -> openApiPath(d) = sibling(p, "openapi.json")
 // PURITY: CORE

packages/api/src/http.ts

@@ -1,5 +1,6 @@
 import type { Effect } from "effect"
 
+import { dockerGitOpenApi } from "./api-http.js"
 import {
   type BaseCreateProjectBody,
   baseCreateProjectBody,
@@ -9,7 +10,6 @@ import {
 } from "./api-project-create-body.js"
 import { CreateProjectAcceptedResponseSchema } from "./api-schema.js"
 import type { CreateProjectAcceptedResponse } from "./api-schema.js"
-import { openApiJsonSchema } from "./openapi-client.js"
 
 type CreateProjectAcceptedBody = Readonly<
   & BaseCreateProjectBody
@@ -42,7 +42,7 @@ export const createProjectAcceptedBody = (draft: CreateProjectRequestDraft): Cre
 export const startCreateProject = (
   draft: CreateProjectRequestDraft
 ): Effect.Effect<CreateProjectAcceptedResponse, string> =>
-  openApiJsonSchema(CreateProjectAcceptedResponseSchema, (client) =>
+  dockerGitOpenApi.openApiJsonSchema(CreateProjectAcceptedResponseSchema, (client) =>
     client.POST("/projects", {
       body: createProjectAcceptedBody(draft)
     }))

packages/app/src/web/api-create-project.ts

@@ -1,5 +1,6 @@
 import { Effect } from "effect"
 
+import { dockerGitOpenApi } from "./api-http.js"
 import {
   ProjectDatabaseForwardResponseSchema,
   ProjectDatabaseForwardsResponseSchema,
@@ -8,15 +9,14 @@ import {
   ProjectDatabaseSessionResponseSchema
 } from "./api-schema.js"
 import type { ProjectDatabaseForward, ProjectDatabaseSession } from "./api-schema.js"
-import { openApiJsonSchema, openApiVoid } from "./openapi-client.js"
 
 export const projectDatabaseEditorUrl = (session: ProjectDatabaseSession): string => session.editorPath
 
 export const projectDatabaseExternalUrl = (forward: ProjectDatabaseForward): string =>
   `${forward.publicHost}:${forward.hostPort}`
 
 export const loadProjectDatabaseProfiles = (projectId: string) =>
-  openApiJsonSchema(
+  dockerGitOpenApi.openApiJsonSchema(
     ProjectDatabaseProfilesResponseSchema,
     (client) =>
       client.GET("/projects/{projectId}/databases/profiles", {
@@ -27,7 +27,7 @@ export const loadProjectDatabaseProfiles = (projectId: string) =>
   )
 
 export const loadProjectDatabaseForwards = (projectId: string) =>
-  openApiJsonSchema(
+  dockerGitOpenApi.openApiJsonSchema(
     ProjectDatabaseForwardsResponseSchema,
     (client) =>
       client.GET("/projects/{projectId}/databases/forwards", {
@@ -42,7 +42,7 @@ export const saveProjectDatabaseProfile = (
   connectionString: string,
   label: string | null
 ) =>
-  openApiJsonSchema(
+  dockerGitOpenApi.openApiJsonSchema(
     ProjectDatabaseProfileResponseSchema,
     (client) =>
       client.POST("/projects/{projectId}/databases/profiles", {
@@ -57,7 +57,7 @@ export const deleteProjectDatabaseProfile = (
   projectId: string,
   profileId: string
 ) =>
-  openApiVoid((client) =>
+  dockerGitOpenApi.openApiVoid((client) =>
     client.DELETE("/projects/{projectId}/databases/profiles/{profileId}", {
       params: { path: { profileId, projectId } }
     })
@@ -67,7 +67,7 @@ export const exposeProjectDatabaseProfile = (
   projectId: string,
   profileId: string
 ) =>
-  openApiJsonSchema(
+  dockerGitOpenApi.openApiJsonSchema(
     ProjectDatabaseForwardResponseSchema,
     (client) =>
       client.POST("/projects/{projectId}/databases/profiles/{profileId}/expose", {
@@ -81,14 +81,14 @@ export const deleteProjectDatabaseForward = (
   projectId: string,
   profileId: string
 ) =>
-  openApiVoid((client) =>
+  dockerGitOpenApi.openApiVoid((client) =>
     client.DELETE("/projects/{projectId}/databases/profiles/{profileId}/expose", {
       params: { path: { profileId, projectId } }
     })
   )
 
 export const loadProjectDatabaseSession = (projectId: string) =>
-  openApiJsonSchema(
+  dockerGitOpenApi.openApiJsonSchema(
     ProjectDatabaseSessionResponseSchema,
     (client) =>
       client.GET("/projects/{projectId}/databases/session", {
@@ -99,7 +99,7 @@ export const loadProjectDatabaseSession = (projectId: string) =>
   )
 
 export const openProjectDatabaseEditor = (projectId: string) =>
-  openApiJsonSchema(
+  dockerGitOpenApi.openApiJsonSchema(
     ProjectDatabaseSessionResponseSchema,
     (client) =>
       client.POST("/projects/{projectId}/databases/open", {
@@ -110,7 +110,7 @@ export const openProjectDatabaseEditor = (projectId: string) =>
   )
 
 export const restartProjectDatabaseEditor = (projectId: string) =>
-  openApiJsonSchema(
+  dockerGitOpenApi.openApiJsonSchema(
     ProjectDatabaseSessionResponseSchema,
     (client) =>
       client.POST("/projects/{projectId}/databases/restart", {

packages/app/src/web/api-database.ts

@@ -2,6 +2,7 @@ import { FetchHttpClient, HttpBody, HttpClient } from "@effect/platform"
 import * as ParseResult from "@effect/schema/ParseResult"
 import * as Schema from "@effect/schema/Schema"
 import * as TreeFormatter from "@effect/schema/TreeFormatter"
+import { createClient } from "@prover-coder-ai/docker-git-openapi"
 import { Effect, Either } from "effect"
 
 import { type JsonRequest, parseResponseBody, renderJsonPayload } from "../docker-git/api-json.js"
@@ -84,6 +85,21 @@ export const resolveApiBaseUrl = (): string => {
     : trimTrailingSlash(configured.trim())
 }
 
+/**
+ * Configured docker-git OpenAPI client for the web HTTP boundary.
+ *
+ * @pure false - binds the shared OpenAPI client to the app-specific base URL resolver.
+ * @effect none during construction; returned client methods perform HTTP IO when their Effects run.
+ * @invariant transport, error rendering, and schema decoding stay owned by the openapi package.
+ * @precondition resolveApiBaseUrl returns a valid docker-git API base URL for the current runtime.
+ * @postcondition app modules depend on one configured OpenAPI client instance.
+ * @complexity O(1)/O(1) for construction, excluding request execution.
+ * @throws Never.
+ */
+export const dockerGitOpenApi = createClient({
+  resolveBaseUrl: resolveApiBaseUrl
+})
+
 export const requestText = (
   method: ApiHttpMethod,
   path: string,