@ir-kit/spec-convert 0.2.1 → 0.3.0

package/README.md

@@ -29,15 +29,37 @@ if (result.output.kind === "document") {
 
 ## Registered converters
 
-| From     | →   | To                             |
-| -------- | --- | ------------------------------ |
-| openapi3 | →   | json-schema, postman, typespec |
-| postman  | →   | openapi3                       |
-| proto    | →   | openapi3                       |
-| typespec | →   | openapi3, json-schema, proto   |
+| From     | →   | To                                    |
+| -------- | --- | ------------------------------------- |
+| openapi3 | →   | json-schema, postman, proto, typespec |
+| postman  | →   | openapi3                              |
+| proto    | →   | openapi3                              |
+| typespec | →   | openapi3, json-schema, proto          |
 
 Any combination not in this table is resolved automatically by chaining edges through the graph — e.g. `postman → typespec` runs `postman → openapi3 → typespec`.
 
+## OpenAPI → proto
+
+`openapi3 → proto` writes one proto3 file. Pass `upstream: { package: "acme.v1" }` to set the package; it defaults to the snake_cased `info.title`.
+
+| OpenAPI                                         | Protobuf                                                                      |
+| ----------------------------------------------- | ----------------------------------------------------------------------------- |
+| component object schema                         | `message`; non-required scalar and enum fields are `optional`                 |
+| `allOf` of objects                              | one `message` with the merged properties                                      |
+| `oneOf` / `anyOf`                               | `message` with a `oneof variant`                                              |
+| string `enum`                                   | `enum` with a `<NAME>_UNSPECIFIED = 0` value first                            |
+| integer `enum`                                  | `int32` / `int64`                                                             |
+| `array` / `additionalProperties`                | `repeated` / `map<string, T>`; nested ones are boxed in a single-field message |
+| `string` + `date-time`, `binary`/`byte`         | `google.protobuf.Timestamp`, `bytes`                                          |
+| untyped schema, mixed enum                      | `google.protobuf.Value`                                                       |
+| `$ref` to an array, map or scalar component     | the referenced type, inlined (proto has no aliases)                           |
+| operation                                       | `rpc` in a `<FirstTag>Service`, commented with its summary and `METHOD /path` |
+| parameters + request body                       | `<Rpc>Request` with one field per parameter plus `body`                       |
+| 2xx response                                    | the referenced message, or `<Rpc>Response`; several 2xx become a `oneof`     |
+| no parameters / no response body                | `google.protobuf.Empty`                                                       |
+
+Property names become snake_case fields with `json_name` set to the original key. HTTP bindings (`google.api.http`), security schemes and error responses are not emitted. The proto JSON mapping of enums and `oneof`s differs from the OpenAPI JSON for the same data. The output uses proto3 `optional`, which needs protoc 3.15+.
+
 ## API
 
 | Export                                             | Description                                                   |
@@ -59,5 +81,5 @@ See [`@ir-kit/cli`](../../cli) for full flags.
 
 ## Limitations
 
-- `openapi3 → proto` (and any `→ proto` chain through TypeSpec) is currently unsupported: the protobuf emitter requires `@field` numbers and `@TypeSpec.Protobuf.package` decorators that don't survive the OpenAPI → TypeSpec hop. Direct `proto → openapi3` works.
+- `typespec → proto` only accepts TypeSpec written for `@typespec/protobuf`, so no route passes through it; `openapi3 → proto` uses its own converter.
 - AsyncAPI 3 outputs are not yet registered — `asyncapi3` works as a load target via `@ir-kit/spec-loader`, but not yet as a convert target.

package/dist/converters/openapi3-to-proto/allof.d.ts

@@ -0,0 +1,11 @@
+type Json = Record<string, unknown>;
+/**
+ * Rewrite every `allOf` whose members are all objects (inline or via a
+ * local `$ref`) into one object schema carrying the members' combined
+ * properties. Protobuf has no inheritance, so a message must list every
+ * inherited field itself. Mutates `doc`; `allOf`s that mix in unions or
+ * non-object types are left alone.
+ */
+export declare function mergeObjectAllOf(doc: Json): void;
+export {};
+//# sourceMappingURL=allof.d.ts.map

package/dist/converters/openapi3-to-proto/allof.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"allof.d.ts","sourceRoot":"","sources":["../../../src/converters/openapi3-to-proto/allof.ts"],"names":[],"mappings":"AAAA,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAUpC;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,IAAI,GAAG,IAAI,CAiGhD"}

package/dist/converters/openapi3-to-proto/allof.js

@@ -0,0 +1,122 @@
+const isObject = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+/**
+ * Rewrite every `allOf` whose members are all objects (inline or via a
+ * local `$ref`) into one object schema carrying the members' combined
+ * properties. Protobuf has no inheritance, so a message must list every
+ * inherited field itself. Mutates `doc`; `allOf`s that mix in unions or
+ * non-object types are left alone.
+ */
+export function mergeObjectAllOf(doc) {
+    const resolve = (node) => {
+        let current = node;
+        for (let depth = 0; current && typeof current.$ref === "string"; depth++) {
+            if (depth > 32)
+                return undefined;
+            current = pointer(doc, current.$ref);
+        }
+        return current;
+    };
+    const flatten = (node, seen) => {
+        const target = resolve(node);
+        if (!target || seen.has(target))
+            return undefined;
+        if (target.oneOf || target.anyOf || target.not)
+            return undefined;
+        if (target.type !== undefined && target.type !== "object")
+            return undefined;
+        const nextSeen = new Set(seen).add(target);
+        const properties = {};
+        const required = new Set();
+        if (Array.isArray(target.allOf)) {
+            for (const member of target.allOf) {
+                if (!isObject(member))
+                    return undefined;
+                const flat = flatten(member, nextSeen);
+                if (!flat)
+                    return undefined;
+                mergeProperties(properties, flat.properties);
+                for (const r of flat.required)
+                    required.add(r);
+            }
+        }
+        if (isObject(target.properties))
+            mergeProperties(properties, target.properties);
+        if (Array.isArray(target.required)) {
+            for (const r of target.required) {
+                if (typeof r === "string")
+                    required.add(r);
+            }
+        }
+        return { properties, required: [...required] };
+    };
+    /** Inline object a merge can combine field by field. `$ref`s and
+     *  maps are left out: merging through a `$ref` can recurse forever,
+     *  and a map has no fields to combine. */
+    const isInlineObject = (node) => isObject(node) &&
+        node.$ref === undefined &&
+        isObject(node.properties) &&
+        (node.type === undefined || node.type === "object") &&
+        !node.allOf &&
+        !node.oneOf &&
+        !node.anyOf;
+    /** A property several members declare as an inline object keeps
+     *  every member's fields; otherwise the later declaration wins. */
+    function mergeProperties(into, from) {
+        for (const [key, schema] of Object.entries(from)) {
+            const prev = into[key];
+            into[key] =
+                prev !== schema && isInlineObject(prev) && isInlineObject(schema)
+                    ? mergeObjects(prev, schema)
+                    : schema;
+        }
+    }
+    function mergeObjects(a, b) {
+        const properties = { ...a.properties };
+        mergeProperties(properties, b.properties);
+        const required = new Set([a.required, b.required].flatMap((r) => (Array.isArray(r) ? r : [])));
+        const merged = { ...a, ...b, properties };
+        if (required.size > 0)
+            merged.required = [...required];
+        return merged;
+    }
+    const visited = new WeakSet();
+    const walk = (node) => {
+        if (typeof node !== "object" || node === null || visited.has(node))
+            return;
+        visited.add(node);
+        if (Array.isArray(node)) {
+            for (const item of node)
+                walk(item);
+            return;
+        }
+        const obj = node;
+        if (Array.isArray(obj.allOf) && obj.allOf.length > 0) {
+            const flat = flatten(obj, new Set());
+            if (flat && Object.keys(flat.properties).length > 0) {
+                delete obj.allOf;
+                obj.type = "object";
+                obj.properties = flat.properties;
+                if (flat.required.length > 0)
+                    obj.required = flat.required;
+                else
+                    delete obj.required;
+            }
+        }
+        for (const value of Object.values(obj))
+            walk(value);
+    };
+    walk(doc);
+}
+function pointer(doc, ref) {
+    if (!ref.startsWith("#/"))
+        return undefined;
+    let current = doc;
+    for (const raw of ref.slice(2).split("/")) {
+        const key = decodeURIComponent(raw).replace(/~1/g, "/").replace(/~0/g, "~");
+        if (!isObject(current))
+            return undefined;
+        current = current[key];
+    }
+    return isObject(current) ? current : undefined;
+}
+//# sourceMappingURL=allof.js.map

package/dist/converters/openapi3-to-proto/allof.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"allof.js","sourceRoot":"","sources":["../../../src/converters/openapi3-to-proto/allof.ts"],"names":[],"mappings":"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"}

package/dist/converters/openapi3-to-proto/ast.d.ts

@@ -0,0 +1,69 @@
+export type ProtoScalar = "double" | "float" | "int32" | "int64" | "uint32" | "uint64" | "bool" | "string" | "bytes";
+export type ProtoType = {
+    kind: "scalar";
+    name: ProtoScalar;
+} | {
+    kind: "named";
+    name: string;
+    isEnum: boolean;
+    import?: string;
+} | {
+    kind: "repeated";
+    elem: ProtoType;
+} | {
+    kind: "map";
+    value: ProtoType;
+};
+export interface ProtoField {
+    name: string;
+    number: number;
+    type: ProtoType;
+    optional?: boolean;
+    jsonName?: string;
+    deprecated?: boolean;
+    comment?: string;
+}
+export interface ProtoOneof {
+    name: string;
+    fields: ProtoField[];
+}
+export interface ProtoMessage {
+    kind: "message";
+    name: string;
+    fields: ProtoField[];
+    oneofs: ProtoOneof[];
+    comment?: string;
+}
+export interface ProtoEnum {
+    kind: "enum";
+    name: string;
+    values: Array<{
+        name: string;
+        number: number;
+    }>;
+    comment?: string;
+}
+export type ProtoDecl = ProtoMessage | ProtoEnum;
+export interface ProtoRpc {
+    name: string;
+    request: ProtoType;
+    response: ProtoType;
+    deprecated?: boolean;
+    comment?: string;
+}
+export interface ProtoService {
+    name: string;
+    rpcs: ProtoRpc[];
+    comment?: string;
+}
+export interface ProtoFile {
+    package: string;
+    decls: ProtoDecl[];
+    services: ProtoService[];
+}
+export declare const scalar: (name: ProtoScalar) => ProtoType;
+export declare const protoValue: ProtoType;
+export declare const protoEmpty: ProtoType;
+export declare const protoTimestamp: ProtoType;
+export declare const isMessageType: (t: ProtoType) => boolean;
+//# sourceMappingURL=ast.d.ts.map

package/dist/converters/openapi3-to-proto/ast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.d.ts","sourceRoot":"","sources":["../../../src/converters/openapi3-to-proto/ast.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GACnB,QAAQ,GACR,OAAO,GACP,OAAO,GACP,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,OAAO,CAAC;AAEZ,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,WAAW,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AAEtC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC;AAEjD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,SAAS,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,eAAO,MAAM,MAAM,GAAI,MAAM,WAAW,KAAG,SAGzC,CAAC;AASH,eAAO,MAAM,UAAU,WAA+B,CAAC;AACvD,eAAO,MAAM,UAAU,WAA8B,CAAC;AACtD,eAAO,MAAM,cAAc,WAAsC,CAAC;AAElE,eAAO,MAAM,aAAa,GAAI,GAAG,SAAS,KAAG,OACZ,CAAC"}

package/dist/converters/openapi3-to-proto/ast.js

@@ -0,0 +1,15 @@
+export const scalar = (name) => ({
+    kind: "scalar",
+    name,
+});
+const wellKnown = (name, file) => ({
+    kind: "named",
+    name: `google.protobuf.${name}`,
+    isEnum: false,
+    import: `google/protobuf/${file}.proto`,
+});
+export const protoValue = wellKnown("Value", "struct");
+export const protoEmpty = wellKnown("Empty", "empty");
+export const protoTimestamp = wellKnown("Timestamp", "timestamp");
+export const isMessageType = (t) => t.kind === "named" && !t.isEnum;
+//# sourceMappingURL=ast.js.map

package/dist/converters/openapi3-to-proto/ast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.js","sourceRoot":"","sources":["../../../src/converters/openapi3-to-proto/ast.ts"],"names":[],"mappings":"AAqEA,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,IAAiB,EAAa,EAAE,CAAC,CAAC;IACvD,IAAI,EAAE,QAAQ;IACd,IAAI;CACL,CAAC,CAAC;AAEH,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,IAAY,EAAa,EAAE,CAAC,CAAC;IAC5D,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,mBAAmB,IAAI,EAAE;IAC/B,MAAM,EAAE,KAAK;IACb,MAAM,EAAE,mBAAmB,IAAI,QAAQ;CACxC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AACvD,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AACtD,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;AAElE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAY,EAAW,EAAE,CACrD,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC"}

package/dist/converters/openapi3-to-proto/index.d.ts

@@ -0,0 +1,12 @@
+export interface OpenAPIToProtoOptions {
+    /** Protobuf package. Defaults to the snake_cased `info.title`. */
+    package?: string;
+}
+/**
+ * Build a proto3 file from an OpenAPI document: one message or enum per
+ * component schema, and one gRPC service per operation tag with an RPC
+ * per operation. Each RPC's request message holds the operation's
+ * parameters plus a `body` field; its response is the 2xx schema.
+ */
+export declare function openAPIToProto(document: Record<string, unknown>, options?: OpenAPIToProtoOptions): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/converters/openapi3-to-proto/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/converters/openapi3-to-proto/index.ts"],"names":[],"mappings":"AA6BA,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,GAAE,qBAA0B,GAClC,MAAM,CAkDR"}

package/dist/converters/openapi3-to-proto/index.js

@@ -0,0 +1,173 @@
+import { pascal } from "@ir-kit/codegen-core";
+import { classifyBody, classifyEnumLiterals, classifyReturnShape, collectLocatedParams, deriveBaseName, extractEnumValues, fromHeyApi, iterateObjectProperties, iterOperations, operationDocLine, schemaTypeName, } from "@ir-kit/openapi";
+import { parseSpec } from "@ir-kit/openapi-tools";
+import { mergeObjectAllOf } from "./allof.js";
+import { isMessageType, protoEmpty, } from "./ast.js";
+import { newTypeNames, packageIdent } from "./names.js";
+import { createProtoOps } from "./ops.js";
+import { printProtoFile } from "./print.js";
+/**
+ * Build a proto3 file from an OpenAPI document: one message or enum per
+ * component schema, and one gRPC service per operation tag with an RPC
+ * per operation. Each RPC's request message holds the operation's
+ * parameters plus a `body` field; its response is the 2xx schema.
+ */
+export function openAPIToProto(document, options = {}) {
+    const doc = structuredClone(document);
+    mergeObjectAllOf(doc);
+    const ir = parseSpec(doc);
+    const info = isRecord(doc.info) ? doc.info : {};
+    const title = typeof info.title === "string" ? info.title : undefined;
+    const pkg = options.package ?? packageIdent(title);
+    if (!/^[A-Za-z_][A-Za-z0-9_]*(\.[A-Za-z_][A-Za-z0-9_]*)*$/.test(pkg)) {
+        throw new Error(`openapi3→proto: invalid package name "${pkg}"`);
+    }
+    const state = {
+        names: newTypeNames(),
+        enumValues: new Set(),
+        enums: new Set(),
+        aliases: new Map(),
+        decls: [],
+    };
+    const ops = createProtoOps(state);
+    const components = Object.entries(ir.components?.schemas ?? {}).map(([raw, hey]) => ({
+        name: schemaTypeName(state.names, raw),
+        schema: fromHeyApi(hey),
+    }));
+    // Classify every component before generating any of them, so forward
+    // references know whether they point at an enum or an inlined alias.
+    for (const { name, schema } of components) {
+        if (isStringEnum(schema))
+            state.enums.add(name);
+        else if (!ops.isMessageShape(schema))
+            state.aliases.set(name, schema);
+    }
+    for (const { name, schema } of components) {
+        if (isStringEnum(schema)) {
+            ops.emitStringEnum(name, extractEnumValues(schema), (d) => state.decls.push({ ...d, comment: schema.description }), state.names);
+        }
+        else if (state.aliases.has(name)) {
+            ops.refType(name);
+        }
+        else {
+            state.decls.push(namedMessage(ops, name, schema));
+        }
+    }
+    const services = buildServices(ir.paths, ops, state, title);
+    const file = { package: pkg, decls: state.decls, services };
+    return printProtoFile(file);
+}
+function buildServices(paths, ops, state, title) {
+    const services = new Map();
+    const rpcNames = new Map();
+    for (const { pathStr, method, op } of iterOperations(paths)) {
+        const tag = op.tags?.[0];
+        const serviceName = state.names.claim(`service:${tag ?? ""}`, `${tag ?? title ?? "Api"}Service`);
+        let service = services.get(serviceName);
+        if (!service) {
+            service = { name: serviceName, rpcs: [] };
+            services.set(serviceName, service);
+            rpcNames.set(serviceName, newTypeNames());
+        }
+        const opKey = `${method} ${pathStr}`;
+        const rpc = rpcNames
+            .get(serviceName)
+            .claim(opKey, deriveBaseName(op, method, pathStr));
+        const properties = collectLocatedParams(op).map(({ param }) => {
+            const schema = fromHeyApi(param.schema);
+            return {
+                jsonKey: param.name,
+                schema: {
+                    ...schema,
+                    description: param.description ?? schema.description,
+                    deprecated: param.deprecated ?? schema.deprecated,
+                },
+                required: param.required ?? false,
+                isBinary: false,
+                propPathSegment: pascal(param.name),
+            };
+        });
+        if (op.body) {
+            const body = classifyBody(op.body);
+            properties.push({
+                jsonKey: "body",
+                schema: body.shape.kind === "opaque"
+                    ? { type: "string", format: "binary" }
+                    : body.schema,
+                required: op.body.required ?? false,
+                isBinary: body.shape.kind === "opaque",
+                propPathSegment: "Body",
+            });
+        }
+        let request = protoEmpty;
+        if (properties.length > 0) {
+            const name = state.names.claim(`rpc:${opKey}:request`, `${rpc}Request`);
+            state.decls.push(ops.message(name, properties));
+            request = ops.refType(name);
+        }
+        service.rpcs.push({
+            name: rpc,
+            request,
+            response: responseType(op, opKey, rpc, ops, state),
+            deprecated: op.deprecated,
+            comment: [op.summary, op.description, operationDocLine(method, pathStr)]
+                .filter((s) => Boolean(s?.trim()))
+                .join("\n\n"),
+        });
+    }
+    return [...services.values()];
+}
+function responseType(op, opKey, rpc, ops, state) {
+    const shape = classifyReturnShape(op);
+    const claim = () => state.names.claim(`rpc:${opKey}:response`, `${rpc}Response`);
+    let schema;
+    if (shape.kind === "single")
+        schema = shape.schema;
+    if (shape.kind === "multi") {
+        const bodies = shape.cases.filter((c) => c.schema !== undefined);
+        const distinct = new Set(bodies.map((c) => JSON.stringify(c.schema)));
+        const hasEmpty = bodies.length < shape.cases.length;
+        if (distinct.size === 1 && !hasEmpty)
+            schema = bodies[0].schema;
+        else if (distinct.size > 0) {
+            // One branch per status code, so callers can tell 200 from 202 or
+            // a 204 with no body.
+            const name = claim();
+            state.decls.push(ops.oneofMessage(name, shape.cases.map((c) => ({
+                schema: c.schema,
+                label: `status_${c.statusCode}`,
+            }))));
+            return ops.refType(name);
+        }
+    }
+    if (!schema)
+        return protoEmpty;
+    if (schema.$ref) {
+        const target = ops.dispatch(schema, ops.ctx(rpc));
+        if (isMessageType(target))
+            return target;
+    }
+    const name = claim();
+    state.decls.push(ops.isMessageShape(schema)
+        ? namedMessage(ops, name, schema)
+        : ops.wrapperMessage(name, ops.dispatch(schema, ops.ctx(name, ["Value"]))));
+    return ops.refType(name);
+}
+/** Message declared under `name` for an object or multi-branch union. */
+function namedMessage(ops, name, schema) {
+    if (schema.type === "object" && !schema.oneOf && !schema.anyOf) {
+        return ops.message(name, Array.from(iterateObjectProperties(schema)), schema.description);
+    }
+    return ops.unionMessage(name, schema);
+}
+function isStringEnum(schema) {
+    const values = extractEnumValues(schema);
+    return (!schema.$ref &&
+        values !== undefined &&
+        values.length > 0 &&
+        classifyEnumLiterals(values.filter((v) => typeof v === "string" ||
+            typeof v === "number" ||
+            typeof v === "boolean")) === "string");
+}
+const isRecord = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+//# sourceMappingURL=index.js.map

package/dist/converters/openapi3-to-proto/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/converters/openapi3-to-proto/index.ts"],"names":[],"mappings":"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"}

package/dist/converters/openapi3-to-proto/names.d.ts

@@ -0,0 +1,13 @@
+import { Namespace } from "@ir-kit/codegen-core";
+/** `PetStatus` → `PET_STATUS`, `in-progress` → `IN_PROGRESS`. */
+export declare function upperSnake(s: string): string;
+/** Field names: `petId` → `pet_id`, never starting with a digit. */
+export declare function fieldIdent(s: string): string;
+/** protoc's default JSON name for a field: `pet_id` → `petId`. */
+export declare function defaultJsonName(field: string): string;
+export declare function typeIdent(s: string): string;
+export declare function packageIdent(title: string | undefined): string;
+/** Message, enum and service names share one package scope. */
+export declare function newTypeNames(): Namespace;
+export declare function newFieldNames(): Namespace;
+//# sourceMappingURL=names.d.ts.map

package/dist/converters/openapi3-to-proto/names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.d.ts","sourceRoot":"","sources":["../../../src/converters/openapi3-to-proto/names.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAU,MAAM,sBAAsB,CAAC;AAEzD,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,oEAAoE;AACpE,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAG5C;AAED,kEAAkE;AAClE,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAG3C;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAG9D;AAED,+DAA+D;AAC/D,wBAAgB,YAAY,IAAI,SAAS,CAExC;AAED,wBAAgB,aAAa,IAAI,SAAS,CAKzC"}

package/dist/converters/openapi3-to-proto/names.js

@@ -0,0 +1,40 @@
+import { Namespace, pascal } from "@ir-kit/codegen-core";
+/** `PetStatus` → `PET_STATUS`, `in-progress` → `IN_PROGRESS`. */
+export function upperSnake(s) {
+    return snakeWords(s).toUpperCase();
+}
+/** Field names: `petId` → `pet_id`, never starting with a digit. */
+export function fieldIdent(s) {
+    const snake = snakeWords(s).toLowerCase() || "field";
+    return /^[0-9]/.test(snake) ? `f_${snake}` : snake;
+}
+/** protoc's default JSON name for a field: `pet_id` → `petId`. */
+export function defaultJsonName(field) {
+    return field.replace(/_+([a-z0-9])/g, (_, c) => c.toUpperCase());
+}
+export function typeIdent(s) {
+    const p = pascal(s) || "Empty";
+    return /^[0-9]/.test(p) ? `X${p}` : p;
+}
+export function packageIdent(title) {
+    const snake = fieldIdent(title ?? "");
+    return snake === "field" ? "api" : snake.replace(/^f_/, "api_");
+}
+/** Message, enum and service names share one package scope. */
+export function newTypeNames() {
+    return new Namespace({ normalize: typeIdent, foldCase: true });
+}
+export function newFieldNames() {
+    return new Namespace({
+        normalize: fieldIdent,
+        disambiguate: (b, n) => `${b}_${n}`,
+    });
+}
+function snakeWords(s) {
+    return s
+        .replace(/([a-z0-9])([A-Z])/g, "$1_$2")
+        .replace(/([A-Z]+)([A-Z][a-z])/g, "$1_$2")
+        .replace(/[^A-Za-z0-9]+/g, "_")
+        .replace(/^_+|_+$/g, "");
+}
+//# sourceMappingURL=names.js.map

package/dist/converters/openapi3-to-proto/names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.js","sourceRoot":"","sources":["../../../src/converters/openapi3-to-proto/names.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEzD,iEAAiE;AACjE,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;AACrC,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,OAAO,CAAC;IACrD,OAAO,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AACrD,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,CAAS;IACjC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC;IAC/B,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAyB;IACpD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IACtC,OAAO,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAClE,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,SAAS,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,SAAS,CAAC;QACnB,SAAS,EAAE,UAAU;QACrB,YAAY,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;KACpC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,UAAU,CAAC,CAAS;IAC3B,OAAO,CAAC;SACL,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,OAAO,CAAC,uBAAuB,EAAE,OAAO,CAAC;SACzC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC;SAC9B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC"}

package/dist/converters/openapi3-to-proto/ops.d.ts

@@ -0,0 +1,40 @@
+import { type Namespace } from "@ir-kit/codegen-core";
+import { type ObjectProperty, type Schema, type SchemaToTypeOps, type TypeCtx } from "@ir-kit/openapi";
+import { type ProtoDecl, type ProtoMessage, type ProtoType } from "./ast.js";
+export interface ProtoState {
+    names: Namespace;
+    /** Enum value names are package-scoped (C++ scoping rules). */
+    enumValues: Set<string>;
+    /** Names declared (or about to be declared) as enums. */
+    enums: Set<string>;
+    /** Component schemas that don't declare a message or enum of their
+     *  own (`$ref`s, arrays, maps, scalars). Proto has no type aliases, so
+     *  each reference is replaced by the aliased type. */
+    aliases: Map<string, Schema>;
+    decls: ProtoDecl[];
+}
+export type ProtoCtx = TypeCtx<ProtoDecl>;
+export interface ProtoOps extends SchemaToTypeOps<ProtoType, ProtoDecl> {
+    dispatch(schema: Schema, ctx: ProtoCtx): ProtoType;
+    ctx(ownerName: string, propPath?: ReadonlyArray<string>): ProtoCtx;
+    /** Message with one field per property. */
+    message(name: string, properties: ReadonlyArray<ObjectProperty>, comment?: string): ProtoMessage;
+    /** Message holding a `oneof` with one field per union branch. */
+    unionMessage(name: string, schema: Schema): ProtoMessage;
+    /** Message holding a `oneof` with the given branches. */
+    oneofMessage(name: string, branches: ReadonlyArray<OneofBranch>, comment?: string): ProtoMessage;
+    /** Message wrapping a single value of any type in field `value`. */
+    wrapperMessage(name: string, type: ProtoType): ProtoMessage;
+    /** Schema that becomes its own message when given a name: a plain
+     *  object or a multi-branch union. */
+    isMessageShape(schema: Schema): boolean;
+}
+/** A `oneof` branch. `label` names its field and synthesized type
+ *  (otherwise it's named after its type); no `schema` means an empty
+ *  result (`google.protobuf.Empty`). */
+export interface OneofBranch {
+    schema?: Schema;
+    label?: string;
+}
+export declare function createProtoOps(state: ProtoState): ProtoOps;
+//# sourceMappingURL=ops.d.ts.map

package/dist/converters/openapi3-to-proto/ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ops.d.ts","sourceRoot":"","sources":["../../../src/converters/openapi3-to-proto/ops.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAU,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAML,KAAK,cAAc,EACnB,KAAK,MAAM,EACX,KAAK,eAAe,EAGpB,KAAK,OAAO,EACb,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,KAAK,SAAS,EAEd,KAAK,YAAY,EACjB,KAAK,SAAS,EAKf,MAAM,UAAU,CAAC;AASlB,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,SAAS,CAAC;IACjB,+DAA+D;IAC/D,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACxB,yDAAyD;IACzD,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnB;;0DAEsD;IACtD,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAED,MAAM,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;AAE1C,MAAM,WAAW,QAAS,SAAQ,eAAe,CAAC,SAAS,EAAE,SAAS,CAAC;IACrE,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,SAAS,CAAC;IACnD,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC;IACnE,2CAA2C;IAC3C,OAAO,CACL,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,aAAa,CAAC,cAAc,CAAC,EACzC,OAAO,CAAC,EAAE,MAAM,GACf,YAAY,CAAC;IAChB,iEAAiE;IACjE,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAAC;IACzD,yDAAyD;IACzD,YAAY,CACV,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,aAAa,CAAC,WAAW,CAAC,EACpC,OAAO,CAAC,EAAE,MAAM,GACf,YAAY,CAAC;IAChB,oEAAoE;IACpE,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,YAAY,CAAC;IAC5D;0CACsC;IACtC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;CACzC;AAED;;wCAEwC;AACxC,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,QAAQ,CAuO1D"}