The best way to control Claude Code, Codex and more from any computer or phone

main
ts 155 lines 6.1 KB
Raw
1 import * as Config from "@effect/ai-codegen/Config"
2 import type { DiscoveredProvider } from "@effect/ai-codegen/Discovery"
3 import * as Generator from "@effect/ai-codegen/Generator"
4 import * as OpenApiGenerator from "@effect/openapi-generator/OpenApiGenerator"
5 import * as NodeServices from "@effect/platform-node/NodeServices"
6 import { assert, describe, it } from "@effect/vitest"
7 import * as Effect from "effect/Effect"
8 import * as Layer from "effect/Layer"
9 import * as Path from "effect/Path"
10 import * as TestConsole from "effect/testing/TestConsole"
11
12 const TestLayer = Generator.layer.pipe(
13 Layer.provide(Layer.succeed(OpenApiGenerator.OpenApiGenerator, {
14 generate: (spec) => Effect.succeed(JSON.stringify(spec))
15 })),
16 Layer.provideMerge(NodeServices.layer)
17 )
18
19 const provider = (
20 fields: Omit<ConstructorParameters<typeof Config.CodegenConfig>[0], "spec" | "output">
21 ): DiscoveredProvider => ({
22 name: "test",
23 packagePath: "/providers/test",
24 config: new Config.CodegenConfig({ spec: "spec.json", output: "Generated.ts", ...fields }),
25 specSource: Config.SpecSource.File("spec.json"),
26 outputPath: "Generated.ts"
27 })
28
29 const generateWithPatch = Effect.fnUntraced(function*(patch: string) {
30 const generator = yield* Generator.CodeGenerator
31 const output = yield* generator.generate(provider({ patches: [patch] }), {
32 openapi: "3.1.0",
33 info: { title: "Before", version: "1.0.0" },
34 paths: {}
35 })
36 return JSON.parse(output)
37 })
38
39 describe("CodeGenerator patch inputs", () => {
40 it.effect("accepts inline patches with leading whitespace", () =>
41 Effect.gen(function*() {
42 const result = yield* generateWithPatch(
43 " \n[{\"op\":\"replace\",\"path\":\"/info/title\",\"value\":\"After\"}]"
44 )
45 assert.deepStrictEqual(result, {
46 openapi: "3.1.0",
47 info: { title: "After", version: "1.0.0" },
48 paths: {}
49 })
50 }).pipe(Effect.provide(TestLayer)))
51
52 it.effect("accepts absolute paths with leading whitespace", () =>
53 Effect.gen(function*() {
54 const path = yield* Path.Path
55 const patch = path.join(
56 import.meta.dirname,
57 "../../openapi-generator/test/fixtures/patches/valid-replace.json"
58 )
59 const result = yield* generateWithPatch(` ${patch}`)
60 assert.deepStrictEqual(result, {
61 openapi: "3.1.0",
62 info: { title: "Updated API Title", version: "1.0.0" },
63 paths: {}
64 })
65 }).pipe(Effect.provide(TestLayer)))
66 })
67
68 describe("CodeGenerator warnings", () => {
69 it.effect("reports OpenAPI generator warnings to stderr without changing the generated code", () =>
70 Effect.gen(function*() {
71 const generator = yield* Generator.CodeGenerator
72 const output = yield* generator.generate(provider({ patches: ["[]"] }), {
73 openapi: "3.1.0",
74 info: { title: "Test", version: "1.0.0" },
75 paths: {}
76 })
77 assert.strictEqual(output, "export const Generated = 1")
78 assert.deepStrictEqual(yield* TestConsole.errorLines, [
79 "WARNING [cookie-parameter-dropped] GET /items (listItems): Cookie parameter \"session\" was dropped."
80 ])
81 }).pipe(Effect.provide(
82 Generator.layer.pipe(
83 Layer.provide(Layer.succeed(OpenApiGenerator.OpenApiGenerator, {
84 generate: (_spec, options) => {
85 options.onWarning?.({
86 code: "cookie-parameter-dropped",
87 message: "Cookie parameter \"session\" was dropped.",
88 path: "/items",
89 method: "get",
90 operationId: "listItems"
91 })
92 return Effect.succeed("export const Generated = 1")
93 }
94 })),
95 Layer.provideMerge(Layer.mergeAll(NodeServices.layer, TestConsole.layer))
96 )
97 )))
98 })
99
100 describe("CodeGenerator includePaths", () => {
101 it.effect("keeps paths matching a prefix after applying patches", () =>
102 Effect.gen(function*() {
103 const generator = yield* Generator.CodeGenerator
104 // The patch targets an excluded path, so it only applies if filtering runs afterwards
105 const patch = "[{\"op\":\"replace\",\"path\":\"/paths/~1v1~1models/get\",\"value\":{}}]"
106 const output = yield* generator.generate(provider({ patches: [patch], includePaths: ["/v1/messages"] }), {
107 openapi: "3.1.0",
108 info: { title: "API", version: "1.0.0" },
109 paths: {
110 "/v1/messages?beta=true": { post: {} },
111 "/v1/messages/batches/{id}": { get: {} },
112 "/v1/models": { get: { operationId: "models" } }
113 }
114 })
115 assert.deepStrictEqual(JSON.parse(output).paths, {
116 "/v1/messages?beta=true": { post: {} },
117 "/v1/messages/batches/{id}": { get: {} }
118 })
119 }).pipe(Effect.provide(TestLayer)))
120 })
121
122 describe("CodeGenerator collapseErrorResponses", () => {
123 it.effect("replaces explicit error responses with one 4XX response using the shared envelope", () =>
124 Effect.gen(function*() {
125 const generator = yield* Generator.CodeGenerator
126 const envelope = { "application/json": { schema: { $ref: "#/components/schemas/ErrorResponse" } } }
127 const output = yield* generator.generate(provider({ collapseErrorResponses: true }), {
128 openapi: "3.1.0",
129 info: { title: "API", version: "1.0.0" },
130 paths: {
131 "/v1/messages": {
132 post: {
133 responses: {
134 "200": { description: "OK" },
135 // Statuses narrowed inline, as in the Anthropic spec, must not leak into the result
136 "429": {
137 description: "Rate limited",
138 content: {
139 "application/json": {
140 schema: { type: "object", properties: { error: { type: "object" } } }
141 }
142 }
143 },
144 "401": { description: "Unauthorized", content: envelope },
145 "500": { description: "Internal error", content: envelope }
146 }
147 }
148 }
149 }
150 })
151 const { responses } = JSON.parse(output).paths["/v1/messages"].post
152 assert.deepStrictEqual(Object.keys(responses), ["200", "4XX"])
153 assert.deepStrictEqual(responses["4XX"].content, envelope)
154 }).pipe(Effect.provide(TestLayer)))
155 })