@lovrozagar/honey 0.1.0 → 0.2.0

package/src/codegen-go.ts

@@ -47,7 +47,16 @@ let runtimeCache: Map<string, string> | null = null
 export function loadGoRuntimeTemplates(): Map<string, string> {
 	if (runtimeCache) return runtimeCache
 
-	const names = ["result.go", "errors.go", "runtime.go", "invalidation.go", "sse.go", "ws.go", "transport.go", "realtime.go"]
+	const names = [
+		"result.go",
+		"errors.go",
+		"runtime.go",
+		"invalidation.go",
+		"sse.go",
+		"ws.go",
+		"transport.go",
+		"realtime.go",
+	]
 	const cache = new Map<string, string>()
 	for (const name of names) {
 		const filePath = fileURLToPath(new URL(`./client-go/${name}`, import.meta.url))
@@ -304,14 +313,7 @@ function buildGoTypes(spec: OpenApiSpec): string {
 
 function buildGoMod(modulePath?: string): string {
 	const mod = modulePath ?? "example.com/sdk"
-	return [
-		`module ${mod}`,
-		``,
-		`go 1.23`,
-		``,
-		`require nhooyr.io/websocket v1.8.17`,
-		``,
-	].join("\n")
+	return [`module ${mod}`, ``, `go 1.23`, ``, `require nhooyr.io/websocket v1.8.17`, ``].join("\n")
 }
 
 /* ── buildGoDoc ── */
@@ -366,10 +368,7 @@ type MethodInfo = {
 }
 
 /** Build a MethodInfo from an IROperation + the raw spec op object. */
-function methodInfoFromIROp(
-	irOp: IROperation,
-	rawOp: Record<string, unknown>,
-): MethodInfo {
+function methodInfoFromIROp(irOp: IROperation, rawOp: Record<string, unknown>): MethodInfo {
 	const segments = irOp.id.split(".")
 	const isTopLevel = segments.length === 1
 	const resource = segments[0] ?? irOp.id
@@ -401,10 +400,7 @@ function methodInfoFromIROp(
 }
 
 /** Walk the IR tree and collect all MethodInfos, pairing with raw spec ops. */
-function collectMethodsFromIR(
-	ns: IRNamespace,
-	spec: OpenApiSpec,
-): MethodInfo[] {
+function collectMethodsFromIR(ns: IRNamespace, spec: OpenApiSpec): MethodInfo[] {
 	const rawOpById = new Map<string, Record<string, unknown>>()
 	for (const [, pathMethods] of Object.entries(spec.paths ?? {})) {
 		for (const [, operation] of Object.entries(pathMethods)) {
@@ -473,16 +469,17 @@ function buildGoClient(spec: OpenApiSpec, options: GoSDKOptions): string {
 	body.push(`var invalidationMap = map[string]map[string]serviceEntry{`)
 	for (const [resource, actions] of Object.entries(serviceMap).sort(([a], [b]) => a.localeCompare(b))) {
 		body.push(`\t"${resource}": {`)
-		for (const [action, entry] of Object.entries(actions as Record<string, Record<string, unknown>>).sort(([a], [b]) => a.localeCompare(b))) {
+		for (const [action, entry] of Object.entries(actions as Record<string, Record<string, unknown>>).sort(([a], [b]) =>
+			a.localeCompare(b),
+		)) {
 			const inv = entry.invalidate as string[] | undefined
-			const invStr = inv && inv.length > 0
-				? `[]string{${inv.map((s) => JSON.stringify(s)).join(", ")}}`
-				: `nil`
+			const invStr = inv && inv.length > 0 ? `[]string{${inv.map((s) => JSON.stringify(s)).join(", ")}}` : `nil`
 			const params = entry.params as string[] | undefined
-			const paramsStr = params && params.length > 0
-				? `[]string{${params.map((s) => JSON.stringify(s)).join(", ")}}`
-				: `nil`
-			body.push(`\t\t"${action}": {Method: ${JSON.stringify(String(entry.method))}, Path: ${JSON.stringify(String(entry.path))}, Params: ${paramsStr}, SSE: ${entry.sse === true}, WS: ${entry.ws === true}, Invalidate: ${invStr}},`)
+			const paramsStr =
+				params && params.length > 0 ? `[]string{${params.map((s) => JSON.stringify(s)).join(", ")}}` : `nil`
+			body.push(
+				`\t\t"${action}": {Method: ${JSON.stringify(String(entry.method))}, Path: ${JSON.stringify(String(entry.path))}, Params: ${paramsStr}, SSE: ${entry.sse === true}, WS: ${entry.ws === true}, Invalidate: ${invStr}},`,
+			)
 		}
 		body.push(`\t},`)
 	}
@@ -570,7 +567,11 @@ function buildGoClient(spec: OpenApiSpec, options: GoSDKOptions): string {
 
 		/* direct methods on this struct */
 		for (const [, op] of methodsOf(ns)) {
-			const raw = (methods.find((m) => m.opId === op.id)) ?? (() => { throw new Error(`missing MethodInfo for ${op.id}`) })()
+			const raw =
+				methods.find((m) => m.opId === op.id) ??
+				(() => {
+					throw new Error(`missing MethodInfo for ${op.id}`)
+				})()
 			body.push(...emitMethod(raw, recvName, `*${structName}`, throwOnError))
 		}
 
@@ -613,9 +614,7 @@ function buildGoClient(spec: OpenApiSpec, options: GoSDKOptions): string {
 		{ line: `var _ = sync.Mutex{}`, symbol: "sync." },
 		{ line: `var _ = time.Second`, symbol: "time." },
 	]
-	const suppressionLines = suppressions
-		.filter((s) => !bodyStr.includes(s.symbol))
-		.map((s) => s.line)
+	const suppressionLines = suppressions.filter((s) => !bodyStr.includes(s.symbol)).map((s) => s.line)
 
 	const out: string[] = []
 	/* blank line after generator header detaches it from package-doc on pkg.go.dev */
@@ -772,16 +771,19 @@ function emitMethod(m: MethodInfo, recv: string, recvType: string, throwOnError:
 			for (const qp of sseQueryParams) {
 				const fieldName = goPascal(qp.name)
 				if (qp.required) {
-					l.push(`\t\tif opts != nil { q.Set(${JSON.stringify(qp.name)}, ${qpStringExpr(`opts.${fieldName}`, qp.schema)}) }`)
+					l.push(
+						`\t\tif opts != nil { q.Set(${JSON.stringify(qp.name)}, ${qpStringExpr(`opts.${fieldName}`, qp.schema)}) }`,
+					)
 				} else {
-					l.push(`\t\tif opts != nil && opts.${fieldName} != nil { q.Set(${JSON.stringify(qp.name)}, ${qpStringExpr(`*opts.${fieldName}`, qp.schema)}) }`)
+					l.push(
+						`\t\tif opts != nil && opts.${fieldName} != nil { q.Set(${JSON.stringify(qp.name)}, ${qpStringExpr(`*opts.${fieldName}`, qp.schema)}) }`,
+					)
 				}
 			}
 		}
 		const urlExpr = pathToGoExpr(pathStr)
-		const sseURLExpr = sseQueryParams.length > 0
-			? `${cfgAccess}.BaseURL+${urlExpr}+"?"+q.Encode()`
-			: `${cfgAccess}.BaseURL+${urlExpr}`
+		const sseURLExpr =
+			sseQueryParams.length > 0 ? `${cfgAccess}.BaseURL+${urlExpr}+"?"+q.Encode()` : `${cfgAccess}.BaseURL+${urlExpr}`
 		l.push(`\t\tcallHeaders := map[string]string{"Accept": "text/event-stream"}`)
 		l.push(`\t\tif opts != nil && opts.LastEventID != "" {`)
 		l.push(`\t\t\tcallHeaders["Last-Event-ID"] = opts.LastEventID`)
@@ -793,7 +795,9 @@ function emitMethod(m: MethodInfo, recv: string, recvType: string, throwOnError:
 		l.push(`\t\tif err != nil { yield(SSEEvent{}, err); return }`)
 		l.push(`\t\tfor k, v := range ${cfgAccess}.Headers { req.Header.Set(k, v) }`)
 		l.push(`\t\tfor k, v := range callHeaders { req.Header.Set(k, v) }`)
-		l.push(`\t\tif ${cfgAccess}.BearerToken != "" { req.Header.Set(${cfgAccess}.AuthHeaderName, ${cfgAccess}.AuthHeaderPrefix+${cfgAccess}.BearerToken) }`)
+		l.push(
+			`\t\tif ${cfgAccess}.BearerToken != "" { req.Header.Set(${cfgAccess}.AuthHeaderName, ${cfgAccess}.AuthHeaderPrefix+${cfgAccess}.BearerToken) }`,
+		)
 		l.push(`\t\tresp, err := ${cfgAccess}.HTTPClient.Do(req)`)
 		l.push(`\t\tif err != nil { yield(SSEEvent{}, err); return }`)
 		l.push(`\t\tfor ev, err := range parseSSEStream(ctx, resp) {`)
@@ -812,9 +816,13 @@ function emitMethod(m: MethodInfo, recv: string, recvType: string, throwOnError:
 			if (qp.name === "reconnect_token") continue
 			const fieldName = goPascal(qp.name)
 			if (qp.required) {
-				l.push(`\tif opts != nil { q.Set(${JSON.stringify(qp.name)}, ${qpStringExpr(`opts.${fieldName}`, qp.schema)}) }`)
+				l.push(
+					`\tif opts != nil { q.Set(${JSON.stringify(qp.name)}, ${qpStringExpr(`opts.${fieldName}`, qp.schema)}) }`,
+				)
 			} else {
-				l.push(`\tif opts != nil && opts.${fieldName} != nil { q.Set(${JSON.stringify(qp.name)}, ${qpStringExpr(`*opts.${fieldName}`, qp.schema)}) }`)
+				l.push(
+					`\tif opts != nil && opts.${fieldName} != nil { q.Set(${JSON.stringify(qp.name)}, ${qpStringExpr(`*opts.${fieldName}`, qp.schema)}) }`,
+				)
 			}
 		}
 		l.push(`\tif opts != nil && opts.ReconnectToken != "" { q.Set("reconnect_token", opts.ReconnectToken) }`)
@@ -841,7 +849,9 @@ function emitMethod(m: MethodInfo, recv: string, recvType: string, throwOnError:
 		if (qp.required) {
 			l.push(`\tif opts != nil { q.Set(${JSON.stringify(qp.name)}, ${qpStringExpr(`opts.${fieldName}`, qp.schema)}) }`)
 		} else {
-			l.push(`\tif opts != nil && opts.${fieldName} != nil { q.Set(${JSON.stringify(qp.name)}, ${qpStringExpr(`*opts.${fieldName}`, qp.schema)}) }`)
+			l.push(
+				`\tif opts != nil && opts.${fieldName} != nil { q.Set(${JSON.stringify(qp.name)}, ${qpStringExpr(`*opts.${fieldName}`, qp.schema)}) }`,
+			)
 		}
 	}
 
@@ -881,21 +891,26 @@ function emitMethod(m: MethodInfo, recv: string, recvType: string, throwOnError:
 	 * so consumer can flip cfg.Invalidation on/off without regen; tracker's
 	 * BuildRequestMeta short-circuits to nil when disabled. */
 	const hasInvalidate = Array.isArray(m.op["x-invalidate"]) && (m.op["x-invalidate"] as unknown[]).length > 0
-	const pathParamsMapExpr = m.pathParams.length > 0
-		? `map[string]string{${m.pathParams.map((p) => `${JSON.stringify(p)}: ${p}`).join(", ")}}`
-		: `map[string]string(nil)`
+	const pathParamsMapExpr =
+		m.pathParams.length > 0
+			? `map[string]string{${m.pathParams.map((p) => `${JSON.stringify(p)}: ${p}`).join(", ")}}`
+			: `map[string]string(nil)`
 	if (hasInvalidate) {
 		l.push(`\t_pathParamsMap := ${pathParamsMapExpr}`)
 		l.push(`\t_concretePath, _ := interpolatePath(${JSON.stringify(pathStr)}, _pathParamsMap)`)
 		l.push(`\t_concreteSelector := ${JSON.stringify(`${httpMethodStr} `)} + _concretePath`)
 		l.push(`\tvar _requestMeta *RequestMeta`)
-		l.push(`\tif ${staleAccess} != nil { _requestMeta = ${staleAccess}.BuildRequestMeta(_concreteSelector, _concretePath, ${JSON.stringify(httpMethodStr)}) }`)
+		l.push(
+			`\tif ${staleAccess} != nil { _requestMeta = ${staleAccess}.BuildRequestMeta(_concreteSelector, _concretePath, ${JSON.stringify(httpMethodStr)}) }`,
+		)
 	}
 
 	const resultBind = m.responseType === "" ? "_, err" : "result, err"
 	const operationStr = JSON.stringify(`${httpMethodStr} ${pathStr}`)
 	const requestMetaArg = hasInvalidate ? "_requestMeta" : "nil"
-	l.push(`\t${resultBind} := doRequest(ctx, ${cfgAccess}, "${httpMethodStr}", ${urlExpr}, q, ${bodyArg}, ${bodyReaderArg}, ${contentTypeArg}, callHeaders, ${operationStr}, ${requestMetaArg})`)
+	l.push(
+		`\t${resultBind} := doRequest(ctx, ${cfgAccess}, "${httpMethodStr}", ${urlExpr}, q, ${bodyArg}, ${bodyReaderArg}, ${contentTypeArg}, callHeaders, ${operationStr}, ${requestMetaArg})`,
+	)
 	l.push(`\tif err != nil {`)
 
 	if (throwOnError) {
@@ -912,7 +927,9 @@ function emitMethod(m: MethodInfo, recv: string, recvType: string, throwOnError:
 			l.push(`\t\tif apiErr, ok := err.(APIError); ok {`)
 			l.push(`\t\t\treturn SDKResult[${m.responseType}]{Err: apiErr, Status: 0, Response: nil}, nil`)
 			l.push(`\t\t}`)
-			l.push(`\t\treturn SDKResult[${m.responseType}]{Err: &StatusError{StatusCode: 0, Message: err.Error()}, Status: 0, Response: nil}, nil`)
+			l.push(
+				`\t\treturn SDKResult[${m.responseType}]{Err: &StatusError{StatusCode: 0, Message: err.Error()}, Status: 0, Response: nil}, nil`,
+			)
 		} else {
 			l.push(`\t\treturn err`)
 		}
@@ -925,9 +942,13 @@ function emitMethod(m: MethodInfo, recv: string, recvType: string, throwOnError:
 	 * mutation completed (seq-bounded to avoid clobbering newer invalidations). */
 	if (hasInvalidate) {
 		l.push(`\tif ${staleAccess} != nil {`)
-		l.push(`\t\t${staleAccess}.MarkStale(invalidationMap["${m.resource}"]["${m.action}"].Invalidate, _pathParamsMap, _concreteSelector)`)
+		l.push(
+			`\t\t${staleAccess}.MarkStale(invalidationMap["${m.resource}"]["${m.action}"].Invalidate, _pathParamsMap, _concreteSelector)`,
+		)
 		l.push(`\t\tif _requestMeta != nil && _requestMeta.IsStale {`)
-		l.push(`\t\t\t${staleAccess}.ClearStale(_concreteSelector, _concretePath, ${JSON.stringify(httpMethodStr)}, _requestMeta.SeqSnapshot)`)
+		l.push(
+			`\t\t\t${staleAccess}.ClearStale(_concreteSelector, _concretePath, ${JSON.stringify(httpMethodStr)}, _requestMeta.SeqSnapshot)`,
+		)
 		l.push(`\t\t}`)
 		l.push(`\t}`)
 	}
@@ -949,7 +970,9 @@ function emitMethod(m: MethodInfo, recv: string, recvType: string, throwOnError:
 		l.push(`\tvar out ${m.responseType}`)
 		l.push(`\tif len(result.body) > 0 {`)
 		l.push(`\t\tif err := json.Unmarshal(result.body, &out); err != nil {`)
-		l.push(`\t\t\treturn SDKResult[${m.responseType}]{Err: &StatusError{StatusCode: result.status, Body: result.body, Response: result.resp, Message: err.Error()}, Status: result.status, Response: result.resp}, nil`)
+		l.push(
+			`\t\t\treturn SDKResult[${m.responseType}]{Err: &StatusError{StatusCode: result.status, Body: result.body, Response: result.resp, Message: err.Error()}, Status: result.status, Response: result.resp}, nil`,
+		)
 		l.push(`\t\t}`)
 		l.push(`\t}`)
 		l.push(`\treturn SDKResult[${m.responseType}]{Data: &out, Status: result.status, Response: result.resp}, nil`)
@@ -966,10 +989,7 @@ function emitMethod(m: MethodInfo, recv: string, recvType: string, throwOnError:
  * Generates a complete Go SDK module from an OpenAPI 3.1 spec.
  * Returns a file map (filename → content) ready to write to disk as a Go module.
  */
-export function generateGoSDK(
-	spec: Record<string, unknown>,
-	options: GoSDKOptions = {},
-): GeneratedGoSDK {
+export function generateGoSDK(spec: Record<string, unknown>, options: GoSDKOptions = {}): GeneratedGoSDK {
 	const resolved = resolveRefs(spec as Parameters<typeof resolveRefs>[0]) as unknown as OpenApiSpec
 
 	const { serviceMap } = collectSDKMethods(spec as Parameters<typeof resolveRefs>[0])

package/src/codegen-ir.ts

@@ -48,7 +48,7 @@ export type IRBody =
 			contentType: "multipart/form-data"
 			parts: IRMultipartPart[]
 			required: boolean
-		}
+	  }
 
 export type IRResponse = {
 	status: string /* "200" | "204" | "default" | ... — preserved verbatim */
@@ -81,9 +81,7 @@ export type IROperation = {
 	extensions: IROperationExtensions
 }
 
-export type IRTreeEntry =
-	| { kind: "method"; op: IROperation }
-	| { kind: "namespace"; ns: IRNamespace }
+export type IRTreeEntry = { kind: "method"; op: IROperation } | { kind: "namespace"; ns: IRNamespace }
 
 export type IRNamespace = {
 	entries: Map<string, IRTreeEntry>
@@ -132,7 +130,7 @@ export function buildResourceTree(operations: IROperation[]): IRNamespace {
 				if (existing.kind === "method") {
 					throw new Error(
 						`operationId conflict: "${existing.op.id}" is callable but also a namespace prefix of "${op.id}".\n` +
-						`Rename one. Suggested: "${existing.op.id}" → "${existing.op.id}One" or drop "${op.id}".`,
+							`Rename one. Suggested: "${existing.op.id}" → "${existing.op.id}One" or drop "${op.id}".`,
 					)
 				}
 				cur = existing.ns
@@ -149,7 +147,7 @@ export function buildResourceTree(operations: IROperation[]): IRNamespace {
 			const otherId = firstDescendantId(existing.ns)
 			throw new Error(
 				`operationId conflict: "${op.id}" is callable but also a namespace prefix of "${otherId}".\n` +
-				`Rename one. Suggested: "${op.id}" → "${op.id}One" or drop "${otherId}".`,
+					`Rename one. Suggested: "${op.id}" → "${op.id}One" or drop "${otherId}".`,
 			)
 		}
 		cur.entries.set(leafName, { kind: "method", op })
@@ -281,7 +279,10 @@ export function schemaToIR(schema: Record<string, unknown> | undefined): IRSchem
 		if (isStringEnum(schema)) return { enum: enumVals, kind: "scalar", type: "string" }
 		if (isIntEnum(schema)) return { enum: enumVals, kind: "scalar", type: "integer" }
 		/* mixed enum (string + number values) — emit as union of const literals */
-		if (enumVals.length > 0 && enumVals.every((v) => typeof v === "string" || typeof v === "number" || typeof v === "boolean")) {
+		if (
+			enumVals.length > 0 &&
+			enumVals.every((v) => typeof v === "string" || typeof v === "number" || typeof v === "boolean")
+		) {
 			return { kind: "union", variants: enumVals.map((v) => ({ kind: "const" as const, value: v })) }
 		}
 	}
@@ -299,11 +300,7 @@ export function schemaToIR(schema: Record<string, unknown> | undefined): IRSchem
 		return { items, kind: "array" }
 	}
 
-	if (
-		schema.type === "object" ||
-		schema.properties !== undefined ||
-		schema.additionalProperties !== undefined
-	) {
+	if (schema.type === "object" || schema.properties !== undefined || schema.additionalProperties !== undefined) {
 		const props = (schema.properties ?? {}) as Record<string, Record<string, unknown>>
 		const requiredKeys = new Set((schema.required as string[] | undefined) ?? [])
 		const fields: IRField[] = Object.entries(props).map(([name, propSchema]) => {
@@ -363,28 +360,20 @@ function hasBinaryMultipartPart(mediaType: Record<string, unknown> | undefined):
 }
 
 /** Normalise a multipart/form-data object schema into typed parts. */
-function extractMultipartParts(
-	mediaType: Record<string, unknown> | undefined,
-): IRMultipartPart[] {
+function extractMultipartParts(mediaType: Record<string, unknown> | undefined): IRMultipartPart[] {
 	const schema = mediaType?.schema as Record<string, unknown> | undefined
 	const props = schema?.properties as Record<string, Record<string, unknown>> | undefined
 	if (!props) return []
 	const parts: IRMultipartPart[] = []
 	for (const [name, propSchema] of Object.entries(props)) {
 		const ir = schemaToIR(propSchema)
-		const isBinary =
-			ir.kind === "binary" || (ir.kind === "array" && ir.items.kind === "binary")
+		const isBinary = ir.kind === "binary" || (ir.kind === "array" && ir.items.kind === "binary")
 		parts.push({ name, schema: ir, type: isBinary ? "file" : "text" })
 	}
 	return parts
 }
 
-function buildOperation(
-	id: string,
-	method: string,
-	path: string,
-	op: Record<string, unknown>,
-): IROperation {
+function buildOperation(id: string, method: string, path: string, op: Record<string, unknown>): IROperation {
 	const upperMethod = method.toUpperCase()
 
 	const declaredParams = (op.parameters as Record<string, unknown>[] | undefined) ?? []
@@ -396,7 +385,9 @@ function buildOperation(
 	for (const p of declaredParams) {
 		const pIn = p.in as string
 		const pName = p.name as string
-		const pSchema = p.schema ? schemaToIR(p.schema as Record<string, unknown>) : { kind: "scalar" as const, type: "string" as const }
+		const pSchema = p.schema
+			? schemaToIR(p.schema as Record<string, unknown>)
+			: { kind: "scalar" as const, type: "string" as const }
 		const param: IRParam = { name: pName, schema: pSchema }
 		if (typeof p.description === "string") param.description = p.description
 		if (pIn === "path") {
@@ -458,9 +449,7 @@ function buildOperation(
 				/* SSE detected by response content-type, not a request extension */
 				if (firstCt === "text/event-stream") extensions.sse = true
 				const mediaType = content[firstCt]
-				const respSchema = mediaType?.schema
-					? schemaToIR(mediaType.schema as Record<string, unknown>)
-					: undefined
+				const respSchema = mediaType?.schema ? schemaToIR(mediaType.schema as Record<string, unknown>) : undefined
 				const resp: IRResponse = { contentType: firstCt, status }
 				if (respSchema !== undefined) resp.schema = respSchema
 				responses[status] = resp

package/src/codegen-loaders.ts

@@ -9,13 +9,11 @@ export async function loadToJSONSchema(): Promise<
 	if (toJSONSchemaLoaded) return toJSONSchemaFn
 	toJSONSchemaLoaded = true
 	try {
-		const id = "zod"
-		const zod = await import(id)
+		/* opaque specifier — a plain `const id = "zod"` is constant-folded by rollup/esbuild,
+		   which pulls the whole optional dependency into webworker-target bundles */
+		const zod = await import(["z", "od"].join(""))
 		if (typeof zod.toJSONSchema === "function") {
-			toJSONSchemaFn = zod.toJSONSchema as (
-				schema: unknown,
-				opts?: { io?: "input" | "output" },
-			) => unknown
+			toJSONSchemaFn = zod.toJSONSchema as (schema: unknown, opts?: { io?: "input" | "output" }) => unknown
 		}
 	} catch {
 		/* zod not available */
@@ -30,8 +28,7 @@ export async function loadEffectJsonSchema(): Promise<((schema: unknown) => unkn
 	if (effectLoaded) return effectJsonSchemaFn
 	effectLoaded = true
 	try {
-		const id = "effect"
-		const effect = await import(id)
+		const effect = await import(["eff", "ect"].join(""))
 		if (effect.JSONSchema && typeof effect.JSONSchema.make === "function") {
 			effectJsonSchemaFn = effect.JSONSchema.make as (schema: unknown) => unknown
 		}

package/src/codegen-mcp.ts

@@ -71,10 +71,7 @@ function toSnakeCase(id: string): string {
 		.toLowerCase()
 }
 
-function resolveSchema(
-	spec: SpecRecord,
-	schema: SpecRecord | undefined,
-): SpecRecord | undefined {
+function resolveSchema(spec: SpecRecord, schema: SpecRecord | undefined): SpecRecord | undefined {
 	if (!schema) return undefined
 	if (!schema.$ref) return schema
 	const ref = schema.$ref as string
@@ -108,9 +105,7 @@ function deepResolveSchema(
 			out[k] = v
 		} else if (Array.isArray(v)) {
 			out[k] = v.map((item) =>
-				item !== null && typeof item === "object"
-					? deepResolveSchema(spec, item as SpecRecord, seen)
-					: item,
+				item !== null && typeof item === "object" ? deepResolveSchema(spec, item as SpecRecord, seen) : item,
 			)
 		} else if (typeof v === "object") {
 			out[k] = deepResolveSchema(spec, v as SpecRecord, seen)
@@ -169,12 +164,7 @@ function emptyParamGroup(): ParamGroup {
 	return { props: {}, required: [] }
 }
 
-function assignGroup(
-	properties: SpecRecord,
-	required: string[],
-	key: string,
-	group: ParamGroup,
-): void {
+function assignGroup(properties: SpecRecord, required: string[], key: string, group: ParamGroup): void {
 	if (Object.keys(group.props).length === 0) return
 	const out: SpecRecord = { properties: group.props, type: "object" }
 	if (group.required.length > 0) {
@@ -184,10 +174,7 @@ function assignGroup(
 	properties[key] = out
 }
 
-function buildToolInputSchema(
-	op: MCPOp,
-	spec: OpenApiSpecInput,
-): SpecRecord {
+function buildToolInputSchema(op: MCPOp, spec: OpenApiSpecInput): SpecRecord {
 	const properties: SpecRecord = {}
 	const required: string[] = []
 	const specRec = spec as unknown as SpecRecord
@@ -220,11 +207,7 @@ function buildToolInputSchema(
 	return schema
 }
 
-function buildToolsGen(
-	ops: MCPOp[],
-	spec: OpenApiSpecInput,
-	projectName: string,
-): string {
+function buildToolsGen(ops: MCPOp[], spec: OpenApiSpecInput, projectName: string): string {
 	const l: string[] = []
 	l.push(`/* Generated by honey codegen-mcp.ts — do not edit by hand. */`)
 	l.push(``)
@@ -254,7 +237,9 @@ function buildToolsGen(
 		l.push(`\t\t\thandler: async (args) => {`)
 		l.push(`\t\t\t\tconst method = ${callExpr}`)
 		l.push(`\t\t\t\tif (typeof method !== "function") {`)
-		l.push(`\t\t\t\t\treturn { content: [{ type: "text", text: JSON.stringify({ message: "SDK missing method ${op.operationId}" }) }], isError: true }`)
+		l.push(
+			`\t\t\t\t\treturn { content: [{ type: "text", text: JSON.stringify({ message: "SDK missing method ${op.operationId}" }) }], isError: true }`,
+		)
 		l.push(`\t\t\t\t}`)
 		l.push(`\t\t\t\tconst result = await method.call(sdk, args)`)
 		l.push(`\t\t\t\treturn { content: [{ type: "text", text: JSON.stringify(result) }] }`)
@@ -331,10 +316,7 @@ function buildTsconfig(): string {
 	)
 }
 
-export function generateMCPServer(
-	spec: OpenApiSpecInput,
-	options: MCPOptions,
-): MCPResult {
+export function generateMCPServer(spec: OpenApiSpecInput, options: MCPOptions): MCPResult {
 	toIR(spec)
 	const { projectName, sdkClassName, sdkPackageName } = options
 	const version = options.version ?? "0.1.0"

package/src/codegen-python.ts

@@ -53,7 +53,15 @@ interface ParamInfo {
 }
 
 const PYTHON_FUTURE = "from __future__ import annotations"
-const STATIC_FILE_NAMES = ["_runtime.py", "_errors.py", "_invalidation.py", "_sse.py", "_ws.py", "_transport.py", "_realtime.py"] as const
+const STATIC_FILE_NAMES = [
+	"_runtime.py",
+	"_errors.py",
+	"_invalidation.py",
+	"_sse.py",
+	"_ws.py",
+	"_transport.py",
+	"_realtime.py",
+] as const
 const RUNTIME_TEMPLATE_CACHE = new Map<string, string>()
 const WS_EXTENSION = "x-websocket"
 const REALTIME_EXTENSION = "x-realtime"
@@ -100,10 +108,7 @@ function resolveSchema(
 	return cur as Record<string, unknown> | undefined
 }
 
-function getSuccessType(
-	spec: Record<string, unknown>,
-	operation: Record<string, unknown>,
-): string {
+function getSuccessType(spec: Record<string, unknown>, operation: Record<string, unknown>): string {
 	const responses = operation.responses as Record<string, Record<string, unknown>> | undefined
 	if (!responses) return "None"
 	const successCodes = ["200", "201", "202", "204"]
@@ -193,7 +198,12 @@ function collectOperations(spec: Record<string, unknown>): OperationInfo[] {
 				isWS: !isRealtime && operation[WS_EXTENSION] === true,
 				method: httpMethod.toUpperCase(),
 				operationId,
-				parameters: rawParams as Array<{ in: string; name: string; required: boolean; schema: Record<string, unknown> }>,
+				parameters: rawParams as Array<{
+					in: string
+					name: string
+					required: boolean
+					schema: Record<string, unknown>
+				}>,
 				path,
 				pathParams,
 				queryParams,
@@ -207,10 +217,12 @@ function collectOperations(spec: Record<string, unknown>): OperationInfo[] {
 }
 
 function nestedClassName(path: string[]): string {
-	const pascal = path.map((seg) => {
-		const safe = pyIdent(seg)
-		return safe.charAt(0).toUpperCase() + safe.slice(1)
-	}).join("")
+	const pascal = path
+		.map((seg) => {
+			const safe = pyIdent(seg)
+			return safe.charAt(0).toUpperCase() + safe.slice(1)
+		})
+		.join("")
 	return `_${pascal}Resource`
 }
 
@@ -392,10 +404,7 @@ function buildUrlLine(op: OperationInfo, isTopLevel: boolean): string {
 
 function buildResponseLines(throwOnError: boolean): string[] {
 	if (throwOnError) {
-		return [
-			`        _raise_for_status(_response)`,
-			`        return _parse_body(_response)`,
-		]
+		return [`        _raise_for_status(_response)`, `        return _parse_body(_response)`]
 	}
 	return [
 		`        _body = _parse_body(_response)`,
@@ -461,7 +470,9 @@ function buildAsyncMethodBody(op: OperationInfo, throwOnError: boolean, isTopLev
 	} else if (op.isWS) {
 		lines.push(`        _headers = _build_headers(${configRef}, extra=None)`)
 	} else if (op.bodyIsStream) {
-		lines.push(`        _headers = _build_headers(${configRef}, extra={"Content-Type": "application/octet-stream", **(headers or {})})`)
+		lines.push(
+			`        _headers = _build_headers(${configRef}, extra={"Content-Type": "application/octet-stream", **(headers or {})})`,
+		)
 	} else {
 		lines.push(`        _headers = _build_headers(${configRef}, extra=headers)`)
 	}
@@ -585,7 +596,8 @@ function buildSyncMethodBody(op: OperationInfo, throwOnError: boolean, isTopLeve
 
 function buildPyTypes(spec: Record<string, unknown>): string {
 	const schemas = (spec.components as Record<string, unknown> | undefined)?.schemas as
-		Record<string, Record<string, unknown>> | undefined
+		| Record<string, Record<string, unknown>>
+		| undefined
 
 	const body: string[] = []
 	const allNames: string[] = []
@@ -656,13 +668,13 @@ function buildPyClient(
 	const { opsByOpId, topLevel, tree } = collectSDKMethods(spec)
 
 	const schemas = (spec.components as Record<string, unknown> | undefined)?.schemas as
-		Record<string, Record<string, unknown>> | undefined
+		| Record<string, Record<string, unknown>>
+		| undefined
 	const schemaNames = schemas ? Object.keys(schemas) : []
 
 	const body: string[] = []
 
-	const invEntries = Object.entries(serviceMap)
-		.filter(([, v]) => v.invalidate && v.invalidate.length > 0)
+	const invEntries = Object.entries(serviceMap).filter(([, v]) => v.invalidate && v.invalidate.length > 0)
 
 	body.push("_INVALIDATION_MAP: dict[str, dict[str, Any]] = {")
 	for (const [opId, entry] of invEntries) {
@@ -779,7 +791,7 @@ function buildPyClient(
 	}
 	body.push("")
 	body.push("    def is_stale(self, method: str, path: str) -> bool:")
-	body.push("        \"\"\"Returns True when (method, path) sits inside an active stale window.\"\"\"")
+	body.push('        """Returns True when (method, path) sits inside an active stale window."""')
 	body.push("        return self._stale_tracker.is_stale(method, path)")
 	body.push("")
 
@@ -816,7 +828,7 @@ function buildPyClient(
 	}
 	body.push("")
 	body.push("    async def is_stale(self, method: str, path: str) -> bool:")
-	body.push("        \"\"\"Returns True when (method, path) sits inside an active stale window.\"\"\"")
+	body.push('        """Returns True when (method, path) sits inside an active stale window."""')
 	body.push("        return await self._stale_tracker.is_stale(method, path)")
 	body.push("")
 
@@ -845,7 +857,17 @@ function buildPyClient(
 	if (typingUsed.length > 0) imports.push(`from typing import ${typingUsed.join(", ")}`)
 
 	const runtimeUsed: string[] = []
-	for (const sym of ["ClientConfig", "InvalidationConfig", "SDKResult", "_build_headers", "_build_url", "_do_request_async", "_do_request_sync", "_parse_body", "_raise_for_status"]) {
+	for (const sym of [
+		"ClientConfig",
+		"InvalidationConfig",
+		"SDKResult",
+		"_build_headers",
+		"_build_url",
+		"_do_request_async",
+		"_do_request_sync",
+		"_parse_body",
+		"_raise_for_status",
+	]) {
 		if (new RegExp(`\\b${sym}\\b`).test(bodyText)) runtimeUsed.push(sym)
 	}
 	if (runtimeUsed.length > 0) {
@@ -972,7 +994,8 @@ function buildPyInit(spec: Record<string, unknown>): string {
 	l.push(")")
 
 	const schemas = (spec.components as Record<string, unknown> | undefined)?.schemas as
-		Record<string, Record<string, unknown>> | undefined
+		| Record<string, Record<string, unknown>>
+		| undefined
 	const schemaNames = schemas ? Object.keys(schemas).sort() : []
 	if (schemaNames.length > 0) {
 		l.push("from .types import (")
@@ -1007,10 +1030,7 @@ function buildServiceMap(spec: Record<string, unknown>): Record<string, ServiceM
 	return result
 }
 
-export function generatePythonSDK(
-	spec: Record<string, unknown>,
-	options: PySDKOptions = {},
-): PySDKResult {
+export function generatePythonSDK(spec: Record<string, unknown>, options: PySDKOptions = {}): PySDKResult {
 	const templates = loadPythonRuntimeTemplates()
 	const serviceMap = buildServiceMap(spec)