@ir-kit/kit 0.0.0-stage → 1.0.0

package/dist/sdk/kotlin/ir/operation/response.js

@@ -0,0 +1,43 @@
+import { synthName } from "../../../../codegen/index.js";
+import { classifyReturnShape } from "../../../../openapi/index.js";
+import { ktProp, ktRef, ktSealedClass, ktSealedSubclass, ktUnit, } from "../../ast/index.js";
+import { schemaToType } from "../type/index.js";
+export function returnTypeFor(op, ctx) {
+    const shape = classifyReturnShape(op);
+    switch (shape.kind) {
+        case "void":
+            return { type: ktUnit, cases: [] };
+        case "single":
+            return { type: schemaToType(shape.schema, ctx), cases: [] };
+        case "multi": {
+            const sealedName = ctx.names.claim(`synth:${ctx.ownerName}/response`, synthName(ctx.ownerName, ["response"]));
+            const cases = shape.cases.map(({ statusCode, schema }) => {
+                const caseName = `Status${statusCode}`;
+                if (!schema)
+                    return { statusCode, caseName };
+                const payloadType = schemaToType(schema, {
+                    ...ctx,
+                    propPath: ["response", statusCode],
+                });
+                return { statusCode, caseName, payloadType };
+            });
+            ctx.emit(ktSealedClass({
+                name: sealedName,
+                subclasses: cases.map((c) => c.payloadType
+                    ? ktSealedSubclass({
+                        variant: "class",
+                        name: c.caseName,
+                        properties: [
+                            ktProp({
+                                name: "value",
+                                type: c.payloadType,
+                            }),
+                        ],
+                    })
+                    : ktSealedSubclass({ variant: "object", name: c.caseName })),
+            }));
+            return { type: ktRef(sealedName), cases, sealedName };
+        }
+    }
+}
+//# sourceMappingURL=response.js.map

package/dist/sdk/kotlin/ir/operation/response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../../../../../src/sdk/kotlin/ir/operation/response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAEnE,OAAO,EAEL,MAAM,EACN,KAAK,EACL,aAAa,EACb,gBAAgB,EAChB,MAAM,GACP,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAgBhD,MAAM,UAAU,aAAa,CAAC,EAAgB,EAAE,GAAY;IAC1D,MAAM,KAAK,GAAG,mBAAmB,CAAC,EAAE,CAAC,CAAC;IACtC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,MAAM;YACT,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QACrC,KAAK,QAAQ;YACX,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QAC9D,KAAK,OAAO,EAAE,CAAC;YACb,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAChC,SAAS,GAAG,CAAC,SAAS,WAAW,EACjC,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,CAAC,CACvC,CAAC;YACF,MAAM,KAAK,GAAmB,KAAK,CAAC,KAAK,CAAC,GAAG,CAC3C,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE;gBACzB,MAAM,QAAQ,GAAG,SAAS,UAAU,EAAE,CAAC;gBACvC,IAAI,CAAC,MAAM;oBAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;gBAC7C,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,EAAE;oBACvC,GAAG,GAAG;oBACN,QAAQ,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC;iBACnC,CAAC,CAAC;gBACH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;YAC/C,CAAC,CACF,CAAC;YACF,GAAG,CAAC,IAAI,CACN,aAAa,CAAC;gBACZ,IAAI,EAAE,UAAU;gBAChB,UAAU,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC1B,CAAC,CAAC,WAAW;oBACX,CAAC,CAAC,gBAAgB,CAAC;wBACf,OAAO,EAAE,OAAO;wBAChB,IAAI,EAAE,CAAC,CAAC,QAAQ;wBAChB,UAAU,EAAE;4BACV,MAAM,CAAC;gCACL,IAAI,EAAE,OAAO;gCACb,IAAI,EAAE,CAAC,CAAC,WAAW;6BACpB,CAAC;yBACH;qBACF,CAAC;oBACJ,CAAC,CAAC,gBAAgB,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAC9D;aACF,CAAC,CACH,CAAC;YACF,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;QACxD,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/sdk/kotlin/ir/operation/signature.d.ts

@@ -0,0 +1,38 @@
+import type { Namespace } from "../../../../codegen/index.js";
+import type { IR } from "../../../../ir/index.js";
+import type { HttpMethod } from "../../../../openapi/index.js";
+import { type LocatedParam } from "../../../../openapi/index.js";
+import { type KtFunParam, type KtType } from "../../ast/index.js";
+import type { TypeCtx } from "../type/index.js";
+export interface OperationSignature {
+    name: string;
+    ownerName: string;
+    params: ReadonlyArray<KtFunParam>;
+    returnType: KtType;
+    doc: string;
+    locatedParams: ReadonlyArray<LocatedParam>;
+    op: IR.Operation;
+    method: HttpMethod;
+    pathStr: string;
+    securitySchemeNames: ReadonlyArray<string>;
+    responseCases: ReadonlyArray<ResponseCase>;
+    sealedName?: string;
+}
+/**
+ * One arm of a multi-2xx sum-type return. Populated by `returnTypeFor`
+ * when an op declares more than one 2xx response code; the impl
+ * dispatches on `response.code` to decode the matching payload type
+ * into the matching sealed-subclass. `payloadType` is `undefined` for
+ * empty bodies (e.g. 204).
+ */
+export interface ResponseCase {
+    statusCode: string;
+    caseName: string;
+    payloadType?: KtType;
+}
+/**
+ * One source of truth for `params + returnType + doc` so the interface
+ * declaration and the impl class share the same signature shape.
+ */
+export declare function operationSignature(op: IR.Operation, method: HttpMethod, pathStr: string, emit: TypeCtx["emit"], names: Namespace): OperationSignature;
+//# sourceMappingURL=signature.d.ts.map

package/dist/sdk/kotlin/ir/operation/signature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature.d.ts","sourceRoot":"","sources":["../../../../../src/sdk/kotlin/ir/operation/signature.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAEL,KAAK,YAAY,EAElB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,KAAK,UAAU,EACf,KAAK,MAAM,EAGZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAKhD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IAC3C,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC3C,aAAa,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,EAAE,CAAC,SAAS,EAChB,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,EACrB,KAAK,EAAE,SAAS,GACf,kBAAkB,CA+BpB"}

package/dist/sdk/kotlin/ir/operation/signature.js

@@ -0,0 +1,54 @@
+import { camel, pascal } from "../../../../codegen/index.js";
+import { deriveBaseName, operationDocLine, } from "../../../../openapi/index.js";
+import { ktFunParam, ktRef, } from "../../ast/index.js";
+import { buildBodyParams } from "./body.js";
+import { buildNonBodyParams } from "./params.js";
+import { returnTypeFor } from "./response.js";
+/**
+ * One source of truth for `params + returnType + doc` so the interface
+ * declaration and the impl class share the same signature shape.
+ */
+export function operationSignature(op, method, pathStr, emit, names) {
+    const name = deriveBaseName(op, method, pathStr);
+    const ownerName = pascal(name);
+    const ctx = { emit, names, ownerName, propPath: [] };
+    const { params: nonBody, located } = buildNonBodyParams(op, ctx);
+    const bodyParams = op.body ? buildBodyParams(op.body, ctx) : [];
+    const params = [...nonBody, ...bodyParams, optionsParam()];
+    const { type: returnType, cases: responseCases, sealedName, } = returnTypeFor(op, {
+        ...ctx,
+        propPath: ["response"],
+    });
+    return {
+        name: camel(name),
+        ownerName,
+        params,
+        returnType,
+        sealedName,
+        doc: operationDocLine(method, pathStr),
+        locatedParams: located,
+        op,
+        method,
+        pathStr,
+        securitySchemeNames: op.securitySchemes,
+        responseCases,
+    };
+}
+/**
+ * The trailing `options: RequestOptions` param every emitted method
+ * takes. Mirrors hey-api's TS SDK per-call options pattern — caller
+ * can override `client`, `baseUrl`, `headers`, or pass extra
+ * `requestInterceptors` for one call.
+ *
+ * No default value: Kotlin forbids defaults on `override` methods, so
+ * the impl class can't carry one. Callers who don't need overrides
+ * reach for the no-options convenience overload emitted alongside as a
+ * top-level extension fun.
+ */
+function optionsParam() {
+    return ktFunParam({
+        name: "options",
+        type: ktRef("RequestOptions"),
+    });
+}
+//# sourceMappingURL=signature.js.map

package/dist/sdk/kotlin/ir/operation/signature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature.js","sourceRoot":"","sources":["../../../../../src/sdk/kotlin/ir/operation/signature.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAG7D,OAAO,EACL,cAAc,EAEd,gBAAgB,GACjB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAGL,UAAU,EACV,KAAK,GACN,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AA8B9C;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,EAAgB,EAChB,MAAkB,EAClB,OAAe,EACf,IAAqB,EACrB,KAAgB;IAEhB,MAAM,IAAI,GAAG,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,GAAG,GAAY,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAE9D,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,kBAAkB,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACjE,MAAM,UAAU,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,EAAE,GAAG,UAAU,EAAE,YAAY,EAAE,CAAC,CAAC;IAC3D,MAAM,EACJ,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,aAAa,EACpB,UAAU,GACX,GAAG,aAAa,CAAC,EAAE,EAAE;QACpB,GAAG,GAAG;QACN,QAAQ,EAAE,CAAC,UAAU,CAAC;KACvB,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC;QACjB,SAAS;QACT,MAAM;QACN,UAAU;QACV,UAAU;QACV,GAAG,EAAE,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC;QACtC,aAAa,EAAE,OAAO;QACtB,EAAE;QACF,MAAM;QACN,OAAO;QACP,mBAAmB,EAAE,EAAE,CAAC,eAAe;QACvC,aAAa;KACd,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,YAAY;IACnB,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,KAAK,CAAC,gBAAgB,CAAC;KAC9B,CAAC,CAAC;AACL,CAAC"}

package/dist/sdk/kotlin/ir/operations.d.ts

@@ -0,0 +1,42 @@
+import { type Namespace } from "../../../codegen/index.js";
+import type { IR } from "../../../ir/index.js";
+import { type KtDecl, type KtType } from "../ast/index.js";
+export interface OperationsOptions {
+    /** Default: `"Default"`. */
+    defaultTag?: string;
+    /** Default: `(tag) => `${PascalCase(tag)}Api``. */
+    interfaceName?: (tag: string) => string;
+    /** Default: `(interfaceName) => `OkHttp${interfaceName}``. */
+    clientClassName?: (interfaceName: string) => string;
+    /** Skip emitting the OkHttp impl class. Default: `false`. */
+    interfaceOnly?: boolean;
+    /**
+     * Emit the impl class as `open` instead of `final` so consumers can
+     * subclass and override individual methods. Default: `false`.
+     */
+    openImpl?: boolean;
+    /** Shared type-name owner; pass the one used for `schemasToDecls`. */
+    names?: Namespace;
+    /** Type aliases declared outside these operations (component schemas). */
+    aliases?: ReadonlyMap<string, KtType>;
+}
+export interface OperationsResult {
+    decls: KtDecl[];
+    /** True when at least one impl class needs the `MultipartFormBody`
+     *  helper. The orchestrator uses this to decide whether to emit the
+     *  runtime file. */
+    needsMultipart: boolean;
+    /** True when at least one op declares `security` requirements. The
+     *  orchestrator uses this to decide whether to emit `Auth.kt` /
+     *  `APIKeyLocation.kt` and the `auth` field on `APIClient`. */
+    needsAuth: boolean;
+}
+/**
+ * Translate `IR.Model.paths` into Kotlin interfaces (one per tag) and
+ * matching OkHttp + kotlinx-serialization impl classes. Inline body /
+ * response / param schemas are promoted to synthetic top-level decls
+ * in the same output array.
+ */
+export declare function operationsToDecls(paths: IR.Paths | undefined, opts?: OperationsOptions): OperationsResult;
+export declare function aliasesOf(decls: ReadonlyArray<KtDecl>): Array<[string, KtType]>;
+//# sourceMappingURL=operations.d.ts.map

package/dist/sdk/kotlin/ir/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../../../src/sdk/kotlin/ir/operations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAU,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,sBAAsB,CAAC;AAG/C,OAAO,EAEL,KAAK,MAAM,EAEX,KAAK,MAAM,EAWZ,MAAM,iBAAiB,CAAC;AAQzB,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IACxC,8DAA8D;IAC9D,eAAe,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,MAAM,CAAC;IACpD,6DAA6D;IAC7D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sEAAsE;IACtE,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;;wBAEoB;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB;;mEAE+D;IAC/D,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,SAAS,EAC3B,IAAI,GAAE,iBAAsB,GAC3B,gBAAgB,CAiDlB;AAiFD,wBAAgB,SAAS,CACvB,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,GAC3B,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAIzB"}

package/dist/sdk/kotlin/ir/operations.js

@@ -0,0 +1,121 @@
+import { pascal } from "../../../codegen/index.js";
+import { groupOperationsByTag } from "../../../openapi/index.js";
+import { isUnit, ktArg, ktCall, ktExprStmt, ktFun, ktIdent, ktInterface, ktMember, ktRef, ktReturn, ktTopLevelFun, } from "../ast/index.js";
+import { kotlinTypeIdent, newTypeNames } from "./identifiers.js";
+import { buildClientClass } from "./impl/index.js";
+import { operationSignature, } from "./operation/index.js";
+/**
+ * Translate `IR.Model.paths` into Kotlin interfaces (one per tag) and
+ * matching OkHttp + kotlinx-serialization impl classes. Inline body /
+ * response / param schemas are promoted to synthetic top-level decls
+ * in the same output array.
+ */
+export function operationsToDecls(paths, opts = {}) {
+    const defaultTag = opts.defaultTag ?? "Default";
+    const interfaceName = opts.interfaceName ?? ((tag) => kotlinTypeIdent(`${tag} Api`));
+    const clientClassName = opts.clientClassName ?? ((p) => `OkHttp${p}`);
+    const decls = [];
+    const emit = (d) => decls.push(d);
+    const names = opts.names ?? newTypeNames();
+    const byTag = groupOperationsByTag(paths, defaultTag, ({ pathStr, method, op }) => operationSignature(op, method, pathStr, emit, names));
+    let needsMultipart = false;
+    let needsAuth = false;
+    for (const [tag, sigs] of byTag) {
+        const ifaceName = interfaceName(tag);
+        const allSigs = sigs.flatMap((s) => [
+            s,
+            withResponseSignature(s),
+        ]);
+        decls.push(ktInterface({
+            name: ifaceName,
+            funs: allSigs.map(signatureToInterfaceFun),
+        }));
+        for (const sig of allSigs) {
+            decls.push(ktTopLevelFun(signatureToConvenienceFun(sig, ifaceName)));
+        }
+        if (sigs.some(hasSecurity))
+            needsAuth = true;
+        if (!opts.interfaceOnly) {
+            const result = buildClientClass(clientClassName(ifaceName), ifaceName, allSigs, {
+                open: opts.openImpl,
+                aliases: new Map([...(opts.aliases ?? []), ...aliasesOf(decls)]),
+            });
+            decls.push(result.class);
+            if (result.needsMultipart)
+                needsMultipart = true;
+        }
+    }
+    return { decls, needsMultipart, needsAuth };
+}
+/**
+ * Derive the `*WithResponse` companion of a signature: name suffix
+ * `WithResponse`, and return type wraps the original alongside
+ * OkHttp's `Response`. Void operations bundle to just `Response`
+ * (no payload to pair with).
+ */
+function withResponseSignature(sig) {
+    return {
+        ...sig,
+        name: `${sig.name}WithResponse`,
+        returnType: withResponseReturnType(sig.returnType),
+    };
+}
+function withResponseReturnType(t) {
+    const unit = isUnit(t);
+    return unit ? ktRef("Response") : ktRef("Pair", [t, ktRef("Response")]);
+}
+function hasSecurity(sig) {
+    return sig.securitySchemeNames.length > 0;
+}
+/**
+ * Strip defaults from interface-fun parameters. Kotlin allows defaults
+ * on interface methods, but the convention is to keep interface
+ * signatures lean and put defaults on the implementation; the
+ * convenience extension below provides the no-options overload.
+ */
+function signatureToInterfaceFun(sig) {
+    const ifaceParams = sig.params.map((p) => p.default === undefined ? p : { ...p, default: undefined });
+    return ktFun({
+        name: sig.name,
+        params: ifaceParams,
+        returnType: sig.returnType,
+        modifiers: ["suspend"],
+        doc: sig.doc,
+        // No body — interface requirement.
+    });
+}
+/**
+ * Convenience overload emitted as a top-level extension fun. Drops the
+ * trailing `options` param and forwards with `RequestOptions()` defaults.
+ *
+ * @example
+ * ```kotlin
+ * public suspend fun PetApi.getPetById(petId: Long): Pet {
+ *     return getPetById(petId = petId, options = RequestOptions())
+ * }
+ * ```
+ */
+function signatureToConvenienceFun(sig, receiverName) {
+    // Drop the trailing options param — that's the whole point of the overload.
+    const baseParams = sig.params.slice(0, -1).map((p) => 
+    // The convenience overload also drops defaults — when callers reach
+    // for it, they already opted into the no-options shape.
+    p.default === undefined ? p : { ...p, default: undefined });
+    const callArgs = baseParams.map((p) => ktArg(ktIdent(p.name), p.name));
+    callArgs.push(ktArg(ktCall(ktIdent("RequestOptions"), []), "options"));
+    const forwarded = ktCall(ktMember(ktIdent("this"), sig.name), callArgs);
+    const unit = isUnit(sig.returnType);
+    return ktFun({
+        name: sig.name,
+        params: baseParams,
+        returnType: sig.returnType,
+        modifiers: ["suspend"],
+        doc: sig.doc,
+        receiver: ktRef(receiverName),
+        body: [unit ? ktExprStmt(forwarded) : ktReturn(forwarded)],
+    });
+}
+export function aliasesOf(decls) {
+    return decls.flatMap((d) => d.aliasOf ? [[d.name, d.aliasOf]] : []);
+}
+//# sourceMappingURL=operations.js.map

package/dist/sdk/kotlin/ir/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../../../../src/sdk/kotlin/ir/operations.ts"],"names":[],"mappings":"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"}

package/dist/sdk/kotlin/ir/runtime/index.d.ts

@@ -0,0 +1,3 @@
+export type { RuntimeFile, RuntimeOpts } from "./templates.js";
+export { buildRuntimeFiles } from "./templates.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/sdk/kotlin/ir/runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/sdk/kotlin/ir/runtime/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/sdk/kotlin/ir/runtime/index.js

@@ -0,0 +1,2 @@
+export { buildRuntimeFiles } from "./templates.js";
+//# sourceMappingURL=index.js.map

package/dist/sdk/kotlin/ir/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/sdk/kotlin/ir/runtime/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/sdk/kotlin/ir/runtime/templates.d.ts

@@ -0,0 +1,11 @@
+export interface RuntimeOpts {
+    /** Ship the `multipart/form-data` helper. Set when at least one op has
+     *  a `multipart/form-data` body. */
+    hasMultipart: boolean;
+}
+export interface RuntimeFile {
+    name: string;
+    content: string;
+}
+export declare function buildRuntimeFiles(opts: RuntimeOpts, pkg: string): RuntimeFile[];
+//# sourceMappingURL=templates.d.ts.map

package/dist/sdk/kotlin/ir/runtime/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../../../src/sdk/kotlin/ir/runtime/templates.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,WAAW;IAC1B;wCACoC;IACpC,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAaD,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,MAAM,GACV,WAAW,EAAE,CAWf"}

package/dist/sdk/kotlin/ir/runtime/templates.js

@@ -0,0 +1,27 @@
+import { readFileSync } from "node:fs";
+/**
+ * Runtime helpers that ship into every generated SDK. They live as real,
+ * ktlint-clean Kotlin sources in `runtime/kotlin/` and
+ * are copied verbatim; only the package header is rewritten.
+ */
+const RUNTIME_DIR = new URL("../../../../../runtime/kotlin/", import.meta.url);
+const ALWAYS = [
+    "APIClient.kt",
+    "APIError.kt",
+    "APIInterceptors.kt",
+    "APIKeyLocation.kt",
+    "Auth.kt",
+    "QueryStyle.kt",
+    "RequestOptions.kt",
+    "URLEncoding.kt",
+];
+export function buildRuntimeFiles(opts, pkg) {
+    const names = opts.hasMultipart
+        ? [...ALWAYS, "MultipartFormBody.kt"]
+        : ALWAYS;
+    return names.map((name) => ({
+        name,
+        content: readFileSync(new URL(name, RUNTIME_DIR), "utf8").replace(/^package dev\.irkit\.runtime$/m, `package ${pkg}`),
+    }));
+}
+//# sourceMappingURL=templates.js.map

package/dist/sdk/kotlin/ir/runtime/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../../../../src/sdk/kotlin/ir/runtime/templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;GAIG;AACH,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,gCAAgC,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;AAa/E,MAAM,MAAM,GAAG;IACb,cAAc;IACd,aAAa;IACb,oBAAoB;IACpB,mBAAmB;IACnB,SAAS;IACT,eAAe;IACf,mBAAmB;IACnB,gBAAgB;CACjB,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAC/B,IAAiB,EACjB,GAAW;IAEX,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY;QAC7B,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,sBAAsB,CAAC;QACrC,CAAC,CAAC,MAAM,CAAC;IACX,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1B,IAAI;QACJ,OAAO,EAAE,YAAY,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,CAAC,OAAO,CAC/D,gCAAgC,EAChC,WAAW,GAAG,EAAE,CACjB;KACF,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/sdk/kotlin/ir/schema.d.ts

@@ -0,0 +1,15 @@
+import type { Namespace } from "../../../codegen/index.js";
+import type { IR } from "../../../ir/index.js";
+import { type KtDecl } from "../ast/index.js";
+/**
+ * Translate `IR.Model.components.schemas` into Kotlin decls.
+ *
+ *  - object schemas with properties → `@Serializable` data class
+ *  - enum schemas → `enum class(val raw: String)` (or `typealias = Int`
+ *    for integer enums; kotlinx can't round-trip integer enums)
+ *  - object schemas with only `additionalProperties` → typealias to
+ *    `Map<String, V>`
+ *  - everything else → typealias to the dispatcher's resolved type
+ */
+export declare function schemasToDecls(schemas: Record<string, IR.Schema>, names?: Namespace): KtDecl[];
+//# sourceMappingURL=schema.d.ts.map

package/dist/sdk/kotlin/ir/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/sdk/kotlin/ir/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,sBAAsB,CAAC;AAG/C,OAAO,EACL,KAAK,MAAM,EAMZ,MAAM,iBAAiB,CAAC;AAIzB;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAClC,KAAK,GAAE,SAA0B,GAChC,MAAM,EAAE,CAgCV"}

package/dist/sdk/kotlin/ir/schema.js

@@ -0,0 +1,43 @@
+import { classifyComponents } from "../../../openapi/index.js";
+import { ktJsonElement, ktMap, ktRef, ktString, ktTypeAlias, } from "../ast/index.js";
+import { newTypeNames } from "./identifiers.js";
+import { buildEnumFromIR, buildStruct, schemaToType } from "./type/index.js";
+/**
+ * Translate `IR.Model.components.schemas` into Kotlin decls.
+ *
+ *  - object schemas with properties → `@Serializable` data class
+ *  - enum schemas → `enum class(val raw: String)` (or `typealias = Int`
+ *    for integer enums; kotlinx can't round-trip integer enums)
+ *  - object schemas with only `additionalProperties` → typealias to
+ *    `Map<String, V>`
+ *  - everything else → typealias to the dispatcher's resolved type
+ */
+export function schemasToDecls(schemas, names = newTypeNames()) {
+    const decls = [];
+    const emit = (d) => decls.push(d);
+    for (const { name, schema, shape } of classifyComponents(schemas, names)) {
+        const ctx = () => ({ emit, names, ownerName: name, propPath: [] });
+        switch (shape.kind) {
+            case "ref":
+                decls.push(ktTypeAlias({ name, type: ktRef(shape.target) }));
+                break;
+            case "enum":
+                buildEnumFromIR(name, schema, emit, names);
+                break;
+            case "struct":
+                decls.push(buildStruct(name, schema, { emit, names }));
+                break;
+            case "map":
+                decls.push(ktTypeAlias({
+                    name,
+                    type: ktMap(ktString, shape.value ? schemaToType(shape.value, ctx()) : ktJsonElement),
+                }));
+                break;
+            case "type":
+                decls.push(ktTypeAlias({ name, type: schemaToType(schema, ctx()) }));
+                break;
+        }
+    }
+    return decls;
+}
+//# sourceMappingURL=schema.js.map

package/dist/sdk/kotlin/ir/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../src/sdk/kotlin/ir/schema.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,OAAO,EAEL,aAAa,EACb,KAAK,EACL,KAAK,EACL,QAAQ,EACR,WAAW,GACZ,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE7E;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAkC,EAClC,KAAK,GAAc,YAAY,EAAE;IAEjC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1C,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC;QACzE,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;QACnE,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,KAAK;gBACR,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC7D,MAAM;YACR,KAAK,MAAM;gBACT,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;gBAC3C,MAAM;YACR,KAAK,QAAQ;gBACX,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;gBACvD,MAAM;YACR,KAAK,KAAK;gBACR,KAAK,CAAC,IAAI,CACR,WAAW,CAAC;oBACV,IAAI;oBACJ,IAAI,EAAE,KAAK,CACT,QAAQ,EACR,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,CAC/D;iBACF,CAAC,CACH,CAAC;gBACF,MAAM;YACR,KAAK,MAAM;gBACT,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;gBACrE,MAAM;QACV,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/sdk/kotlin/ir/type/context.d.ts

@@ -0,0 +1,4 @@
+import type { TypeCtx as IRTypeCtx } from "../../../../openapi/index.js";
+import type { KtDecl } from "../../ast/index.js";
+export type TypeCtx = IRTypeCtx<KtDecl>;
+//# sourceMappingURL=context.d.ts.map

package/dist/sdk/kotlin/ir/type/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../../src/sdk/kotlin/ir/type/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC"}

package/dist/sdk/kotlin/ir/type/context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context.js.map

package/dist/sdk/kotlin/ir/type/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../../../src/sdk/kotlin/ir/type/context.ts"],"names":[],"mappings":""}

package/dist/sdk/kotlin/ir/type/index.d.ts

@@ -0,0 +1,18 @@
+import type { Namespace } from "../../../../codegen/index.js";
+import { type Schema } from "../../../../openapi/index.js";
+import type { KtDecl } from "../../ast/index.js";
+import { type KtType } from "../../ast/index.js";
+import type { TypeCtx } from "./context.js";
+export type { TypeCtx } from "./context.js";
+/**
+ * Top-level dispatch from canonical {@link Schema} to a `KtType`.
+ * Side-effects: inline objects / enums get promoted to top-level decls
+ * via `ctx.emit`.
+ */
+export declare function schemaToType(schema: Schema, ctx: TypeCtx): KtType;
+export declare function buildStruct(name: string, schema: Schema, ctx: {
+    emit: (d: KtDecl) => void;
+    names: Namespace;
+}): KtDecl;
+export declare function buildEnumFromIR(name: string, schema: Schema, emit: (d: KtDecl) => void, names: Namespace): KtType;
+//# sourceMappingURL=index.d.ts.map

package/dist/sdk/kotlin/ir/type/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/sdk/kotlin/ir/type/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAGL,KAAK,MAAM,EAEZ,MAAM,8BAA8B,CAAC;AAGtC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,KAAK,MAAM,EAAsB,MAAM,oBAAoB,CAAC;AAErE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,CAEjE;AAED,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,GAAG,EAAE;IAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GACnD,MAAM,CAUR;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,EACzB,KAAK,EAAE,SAAS,GACf,MAAM,CAQR"}

package/dist/sdk/kotlin/ir/type/index.js

@@ -0,0 +1,28 @@
+import { enumType, iterateObjectProperties, schemaToType as sharedSchemaToType, } from "../../../../openapi/index.js";
+import { getEnumLiterals } from "../../../../schema/index.js";
+import { ktRef, ktTypeAlias } from "../../ast/index.js";
+import { ktOps } from "../type-ops.js";
+/**
+ * Top-level dispatch from canonical {@link Schema} to a `KtType`.
+ * Side-effects: inline objects / enums get promoted to top-level decls
+ * via `ctx.emit`.
+ */
+export function schemaToType(schema, ctx) {
+    return sharedSchemaToType(schema, ctx, ktOps);
+}
+export function buildStruct(name, schema, ctx) {
+    const properties = Array.from(iterateObjectProperties(schema));
+    const dispatch = (s, c) => sharedSchemaToType(s, c, ktOps);
+    return ktOps.buildStructDecl(name, properties, { emit: ctx.emit, names: ctx.names, ownerName: name, propPath: [] }, dispatch);
+}
+export function buildEnumFromIR(name, schema, emit, names) {
+    const { type, named } = enumType(name, getEnumLiterals(schema), ktOps, {
+        emit,
+        names,
+    });
+    if (named)
+        return type;
+    emit(ktTypeAlias({ name, type }));
+    return ktRef(name);
+}
+//# sourceMappingURL=index.js.map

package/dist/sdk/kotlin/ir/type/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/sdk/kotlin/ir/type/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,QAAQ,EACR,uBAAuB,EAEvB,YAAY,IAAI,kBAAkB,GACnC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAG9D,OAAO,EAAe,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAKvC;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,GAAY;IACvD,OAAO,kBAAkB,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,IAAY,EACZ,MAAc,EACd,GAAoD;IAEpD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAE,CAAU,EAAU,EAAE,CACjD,kBAAkB,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;IAClC,OAAO,KAAK,CAAC,eAAe,CAC1B,IAAI,EACJ,UAAU,EACV,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,EACnE,QAAQ,CACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,MAAc,EACd,IAAyB,EACzB,KAAgB;IAEhB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE;QACrE,IAAI;QACJ,KAAK;KACN,CAAC,CAAC;IACH,IAAI,KAAK;QAAE,OAAO,IAAI,CAAC;IACvB,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAClC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC"}

package/dist/sdk/kotlin/ir/type/primitive.d.ts

@@ -0,0 +1,4 @@
+import type { Schema } from "../../../../openapi/index.js";
+import { type KtType } from "../../ast/index.js";
+export declare function typeForPrimitive(s: Schema): KtType | undefined;
+//# sourceMappingURL=primitive.d.ts.map

package/dist/sdk/kotlin/ir/type/primitive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitive.d.ts","sourceRoot":"","sources":["../../../../../src/sdk/kotlin/ir/type/primitive.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAE3D,OAAO,EACL,KAAK,MAAM,EASZ,MAAM,oBAAoB,CAAC;AA8B5B,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAiB9D"}

package/dist/sdk/kotlin/ir/type/primitive.js

@@ -0,0 +1,48 @@
+import { ktBoolean, ktByteArray, ktDouble, ktFloat, ktInt, ktLong, ktRef, ktString, } from "../../ast/index.js";
+/**
+ * OpenAPI string `format` → Kotlin / kotlinx-datetime / `String` type.
+ * Unknown formats fall back to `String`.
+ *
+ *  - `date-time`        → `Instant` (kotlinx-datetime, built-in
+ *                        `@Serializable` serializer).
+ *  - `date`             → `LocalDate` (kotlinx-datetime, same).
+ *  - `uuid` / `uri` / `url` → `String`. kotlinx-serialization has no
+ *                        built-in `UUID` / `URL` serializers, so wire
+ *                        compat wins over type safety. Consumers who
+ *                        want `java.util.UUID` can layer a custom
+ *                        `@Contextual` serializer on top of the field.
+ *  - `binary` / `byte`  → `ByteArray` (matches multipart field handling).
+ */
+function typeForStringFormat(format) {
+    switch (format) {
+        case "date-time":
+            return ktRef("Instant");
+        case "date":
+            return ktRef("LocalDate");
+        case "binary":
+        case "byte":
+            return ktByteArray;
+        default:
+            return ktString;
+    }
+}
+export function typeForPrimitive(s) {
+    const t = Array.isArray(s.type)
+        ? s.type.find((x) => x !== "null")
+        : s.type;
+    switch (t) {
+        case "string":
+            return typeForStringFormat(s.format);
+        case "integer":
+            if (s.format === "int64")
+                return ktLong;
+            return ktInt;
+        case "number":
+            return s.format === "float" ? ktFloat : ktDouble;
+        case "boolean":
+            return ktBoolean;
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=primitive.js.map

package/dist/sdk/kotlin/ir/type/primitive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitive.js","sourceRoot":"","sources":["../../../../../src/sdk/kotlin/ir/type/primitive.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,SAAS,EACT,WAAW,EACX,QAAQ,EACR,OAAO,EACP,KAAK,EACL,MAAM,EACN,KAAK,EACL,QAAQ,GACT,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;;;;;GAaG;AACH,SAAS,mBAAmB,CAAC,MAA0B;IACrD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,WAAW;YACd,OAAO,KAAK,CAAC,SAAS,CAAC,CAAC;QAC1B,KAAK,MAAM;YACT,OAAO,KAAK,CAAC,WAAW,CAAC,CAAC;QAC5B,KAAK,QAAQ,CAAC;QACd,KAAK,MAAM;YACT,OAAO,WAAW,CAAC;QACrB;YACE,OAAO,QAAQ,CAAC;IACpB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,CAAS;IACxC,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7B,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC;QAC1C,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACX,QAAQ,CAAC,EAAE,CAAC;QACV,KAAK,QAAQ;YACX,OAAO,mBAAmB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACvC,KAAK,SAAS;YACZ,IAAI,CAAC,CAAC,MAAM,KAAK,OAAO;gBAAE,OAAO,MAAM,CAAC;YACxC,OAAO,KAAK,CAAC;QACf,KAAK,QAAQ;YACX,OAAO,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;QACnD,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC"}